From 9da00eb782ab4028709c2589996b8399deb9beeb Mon Sep 17 00:00:00 2001 From: donghyeon-ka Date: Wed, 23 Sep 2026 17:27:09 +0900 Subject: [PATCH] =?UTF-8?q?refactor:=20=EB=A6=AC=ED=8E=99=ED=86=A0?= =?UTF-8?q?=EB=A7=81=20=EC=A7=84=ED=96=89=EC=A4=91=20=EC=9D=98=EC=A1=B4?= =?UTF-8?q?=EC=84=B1=20gradle=EC=9D=80=20=EC=96=87=EA=B2=8C=20=EC=9C=A0?= =?UTF-8?q?=EC=A7=80,=20=EA=B0=81=20=EB=AA=A8=EB=93=88=EC=97=90=EC=84=9C?= =?UTF-8?q?=20=EC=B2=98=EB=A6=AC=ED=95=98=EA=B3=A0=20=EC=9E=88=EB=8A=94=20?= =?UTF-8?q?=EB=B6=80=EB=B6=84=EC=97=90=20=EB=8C=80=ED=95=B4=EC=84=9C=20?= =?UTF-8?q?=EB=A6=AC=ED=8E=99=ED=86=A0=EB=A7=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/workflows/ci-quality-gates.yml | 42 +- .github/workflows/fileserver-pr.yml | 2 +- .github/workflows/integration-main.yml | 76 + .github/workflows/release.yml | 19 +- AGENTS.md | 41 +- CLAUDE.md | 25 +- README.md | 23 +- docker-compose.infra.yml | 20 +- .../ADR-JPA-006-canonical-technical-audit.md | 18 +- docs/adr/ADR-WS-003-stomp-and-broker-relay.md | 2 +- docs/architecture/graphql-api-surface.txt | 9 +- docs/architecture/jpa-adopter-api-surface.txt | 23 + .../object-storage/batch-a-checkpoint.md | 4 +- .../object-storage/batch-b-checkpoint.md | 4 +- .../object-storage/batch-c-progress.md | 4 +- .../object-storage/batch-d-checkpoint.md | 4 +- .../batch-e-pause-checkpoint.md | 5 +- docs/httpclient/release-checklist.md | 2 +- docs/httpclient/repository-adaptation.md | 6 +- docs/jpa/batch-write-guide.md | 64 + docs/jpa/repository-adaptation.md | 2 +- docs/jpa/support-matrix.md | 1 - docs/messaging/configuration-reference.md | 8 + docs/messaging/migration-guide.md | 17 +- docs/messaging/outbox-inbox.md | 16 + docs/messaging/support-matrix.md | 31 +- docs/mongo/persistence-profile.example.yml | 27 + docs/mongodb/repository-adaptation.md | 14 +- .../adr/NOTIF-ADR-005-canonical-namespace.md | 2 +- docs/notification/api-surface-snapshot.txt | 50 +- docs/notification/configuration-reference.md | 57 +- docs/notification/evidence-manifest.json | 7 +- docs/notification/migration-guide.md | 7 +- docs/notification/module-mapping.md | 22 +- docs/notification/support-matrix.md | 19 + docs/objectstorage/env-fields.yaml | 149 ++ docs/observability/log-fields.md | 67 + docs/registries/capabilities.yaml | 1 - docs/registries/env-keys.yaml | 1396 ++++++++-- docs/registries/error-codes.yaml | 314 +-- docs/registries/headers.yaml | 42 +- docs/registries/mdc-keys.yaml | 1 - docs/registries/metrics.yaml | 7 +- docs/registries/secrets-classification.yaml | 56 +- .../2026-08-14-jpa-module-code-review.md | 11 +- ...2026-08-14-messaging-module-code-review.md | 5 +- .../2026-08-14-mongodb-module-code-review.md | 3 +- ...2026-09-18-app-bootstrap-review-closure.md | 96 + .../2026-09-18-techlead-review/00-overview.md | 687 +++++ .../2026-09-18-techlead-review/01-core.md | 1084 ++++++++ .../02-inbound-web.md | 1650 ++++++++++++ .../03-inbound-realtime.md | 1229 +++++++++ .../04-inbound-graphql.md | 1136 ++++++++ .../05-persistence-jpa.md | 1550 +++++++++++ .../06-persistence-mongo.md | 686 +++++ .../07-cache-redis.md | 1399 ++++++++++ .../08-httpclient-objectstorage.md | 742 ++++++ .../09-notification-fileserver.md | 1765 +++++++++++++ .../10-messaging.md | 1606 ++++++++++++ .../11-grpc-platform.md | 1206 +++++++++ .../12-bootstrap-sample.md | 997 +++++++ .../13-build-dependency-ci.md | 1849 +++++++++++++ .../evidence/README.md | 17 + .../evidence/diffstat.txt | 225 ++ .../evidence/status.txt | 316 +++ .../evidence/untracked-files.txt | 175 ++ .../evidence/untracked-wc.txt | 176 ++ ...2026-09-19-app-bootstrap-review-closure.md | 69 + .../2026-09-19-review-remediation-master.md | 2298 +++++++++++++++++ docs/runbooks/auth-token-malformed.md | 2 +- docs/runbooks/auth-token-missing.md | 2 +- .../runbooks/authz-insufficient-permission.md | 2 +- docs/storage-capability-boundary.md | 31 + docs/study/postgresql-jpa-walkthrough.ko.md | 2 +- .../plans/2026-07-20-harness-policy-engine.md | 8 +- ...n-outbox-failure-reporting-harness-free.md | 2 +- ...25-application-outbox-failure-reporting.md | 13 +- .../2026-07-25-ci-control-plane-recovery.md | 2 +- ...026-07-25-harness-free-mode-b-amendment.md | 4 +- ...-07-25-harness-free-quality-security-ci.md | 2 +- ...7-25-module-gradle-hygiene-harness-free.md | 2 +- .../2026-07-28-jpa-production-capability.md | 11 +- ...-28-messaging-first-r2-polling-producer.md | 27 +- ...7-28-notification-production-capability.md | 30 +- ...-28-objectstorage-production-capability.md | 16 +- ...-redis-production-capability-completion.md | 9 +- ...-conditional-inbound-transport-boundary.md | 2 +- ...-p2-verification-governance-refactoring.md | 14 +- ...26-08-02-warning-zero-build-refactoring.md | 8 +- ...-five-adapter-runtime-remediation-index.md | 5 +- .../plans/2026-08-15-wave1-activation-ssot.md | 2 +- .../2026-08-15-wave6-final-qualification.md | 15 +- ...6-09-18-bootstrap-structured-log-fields.md | 12 + ...18-bootstrap-structured-runtime-logging.md | 11 + ...nt-composition-reachability-remediation.md | 46 + ...client-capability-composition-ownership.md | 15 + ...18-jpa-capability-composition-ownership.md | 26 + .../2026-09-18-jpa-runtime-master-switch.md | 11 + ...9-18-mongo-health-composition-ownership.md | 14 + ...cation-capability-composition-ownership.md | 25 + ...026-09-18-outbox-transport-only-cutover.md | 9 +- ...8-outbox-v2-canonical-storage-alignment.md | 35 + ...outbox-v2-one-record-publication-policy.md | 23 + ...resql-idempotency-composition-ownership.md | 14 + ...-09-18-runtime-environment-tracing-ssot.md | 14 + ...2026-09-18-secret-source-port-ownership.md | 15 + ...09-18-startup-failure-log-context-state.md | 12 + ...-architecture-phase2-provider-ownership.md | 40 + ...2026-09-18-test-taxonomy-ssot-alignment.md | 14 + ...-09-19-build-release-review-remediation.md | 75 + ...apability-dependency-validation-context.md | 12 + ...-19-env-contract-verifier-truth-surface.md | 14 + ...19-fileserver-composition-decomposition.md | 13 + ...r-verification-read-failure-remediation.md | 12 + ...mongo-client-runtime-review-remediation.md | 15 + ...6-09-19-multi-instance-runtime-contract.md | 12 + ...26-09-19-prod-secret-consumer-alignment.md | 13 + ...6-09-19-runtime-profile-access-boundary.md | 13 + .../2026-09-19-startup-order-contract.md | 9 + ...26-09-19-test-support-ownership-closure.md | 9 + .../2026-08-15-wave6-final/task1-check.log | 2 +- .../2026-08-15-wave6-final/task1-compile.log | 2 +- .../2026-08-15-wave6-final/task1-test.log | 2 +- ...ication-outbox-failure-reporting-design.md | 2 +- ...026-07-25-harness-free-mode-b-amendment.md | 2 +- ...2026-07-25-module-gradle-hygiene-design.md | 2 +- ...dule-gradle-hygiene-harness-free-design.md | 2 +- ...7-26-redis-production-capability-design.md | 2 +- ...httpclient-production-capability-design.md | 2 +- ...-messaging-production-capability-design.md | 6 +- ...tification-production-capability-design.md | 4 +- ...ectstorage-production-capability-design.md | 10 +- ...de-test-architecture-environment-design.md | 2 +- ...ional-inbound-transport-boundary-design.md | 4 +- .../2026-08-02-warning-zero-build-design.md | 4 +- .../2026-08-07-fileserver-platform-design.md | 6 +- .../2026-08-08-httpclient-platform-design.md | 8 +- ...apter-runtime-remediation-review-design.md | 4 +- ...6-08-30-grpc-platform-adaptation-design.md | 2 +- ...6-09-18-bootstrap-structured-log-fields.md | 39 + ...18-bootstrap-structured-runtime-logging.md | 53 + ...-18-configuration-namespace-disposition.md | 43 + ...nt-composition-reachability-remediation.md | 231 ++ ...client-capability-composition-ownership.md | 39 + ...18-jpa-capability-composition-ownership.md | 66 + .../2026-09-18-jpa-runtime-master-switch.md | 42 + ...9-18-mongo-health-composition-ownership.md | 50 + ...cation-capability-composition-ownership.md | 63 + ...18-outbox-transport-only-cutover-design.md | 15 + ...8-outbox-v2-canonical-storage-alignment.md | 158 ++ ...outbox-v2-one-record-publication-policy.md | 105 + ...resql-idempotency-composition-ownership.md | 52 + ...-09-18-runtime-environment-tracing-ssot.md | 59 + ...2026-09-18-secret-source-port-ownership.md | 64 + ...09-18-startup-failure-log-context-state.md | 46 + ...-architecture-phase2-provider-ownership.md | 51 + ...2026-09-18-test-taxonomy-ssot-alignment.md | 74 + ...build-release-review-remediation-design.md | 50 + ...apability-dependency-validation-context.md | 54 + ...-19-env-contract-verifier-truth-surface.md | 76 + ...19-fileserver-composition-decomposition.md | 114 + ...r-verification-read-failure-remediation.md | 45 + ...mongo-client-runtime-review-remediation.md | 81 + ...6-09-19-multi-instance-runtime-contract.md | 82 + ...26-09-19-prod-secret-consumer-alignment.md | 59 + ...6-09-19-runtime-profile-access-boundary.md | 58 + .../2026-09-19-startup-order-contract.md | 43 + ...26-09-19-test-support-ownership-closure.md | 37 + docs/testing/TESTING_STRATEGY.md | 310 +-- ...ound-http-api-execution-platform-design.md | 6 +- docs/web/repository-adaptation.md | 26 +- docs/websocket/runbook.md | 5 + renovate.json | 28 +- scripts/run-compose-runtime-smoke.sh | 3 +- scripts/verify-mongodb-platform.sh | 2 +- src/.env.example | 102 +- src/Dockerfile | 1 + src/README.md | 67 +- src/adapter/inbound/graphql/CLAUDE.md | 50 +- src/adapter/inbound/graphql/README.md | 29 +- src/adapter/inbound/graphql/build.gradle | 17 +- src/adapter/inbound/graphql/gradle.lockfile | 254 +- .../websocket/GraphQlWebSocketAdmission.java | 71 - .../GraphQlWebSocketConnectionId.java | 30 - .../GraphQlWebSocketHandlerFactory.java | 102 - .../websocket/GraphQlWebSocketLifecycle.java | 115 - .../websocket/GraphQlWebSocketProperties.java | 50 - .../websocket/GraphQlWebSocketProtocol.java | 27 - .../GraphQlWebSocketProtocolException.java | 20 - ...aphQlOffAutoConfigurationImportFilter.java | 18 +- .../GraphQlPlatformActuatorEndpoint.java | 3 +- .../GraphQlPlatformAutoConfiguration.java | 18 +- .../GraphQlPlatformConfigurationReport.java | 3 +- .../GraphQlPlatformSettings.java | 10 +- .../GraphQlPlatformStartupValidator.java | 12 +- .../graphql/error/GraphQlErrorCode.java | 72 +- .../error/GraphQlRequestErrorMapper.java | 4 +- .../GraphQlSubscriptionExceptionResolver.java | 4 +- .../graphql/error/GraphQlWireError.java | 2 +- .../moduleboundary/GraphQlAdvancedModule.java | 4 +- .../GraphQlPlatformRejectionMapper.java | 16 +- .../GraphQlPlatformWebInterceptor.java | 6 + .../GraphQlAuthorizationInterceptor.java | 4 +- .../GraphqlHttpBoundaryQualificationTest.java | 0 .../GraphQlPlatformExecutionPathTest.java | 0 .../graphql-platform/platform.graphqls | 0 .../qualification.graphqls | 0 .../advanced/TransportHandlerFactoryTest.java | 84 +- .../GraphQlWebSocketProtocolTest.java | 124 - .../GraphQlDeploymentModeContractTest.java | 4 +- .../GraphQlPlatformAutoConfigurationTest.java | 4 +- .../GraphQlPlatformStartupValidatorTest.java | 11 +- .../GraphQlPolicyRequestPathTest.java | 33 +- .../error/GraphQlErrorCodeCatalogTest.java | 72 + src/adapter/inbound/grpc/CLAUDE.md | 19 + src/adapter/inbound/grpc/README.md | 20 +- src/adapter/inbound/grpc/build.gradle | 13 +- .../inbound/grpc/GrpcExposedService.java | 19 + .../inbound/grpc/GrpcServerConfig.java | 8 +- .../inbound/grpc/GrpcServerRunner.java | 18 +- .../inbound/grpc/GrpcP1BoundaryWireTest.java | 1 + .../inbound/grpc/GrpcSafeActivationTest.java | 1 + .../grpc/GrpcServerRunnerBootTest.java | 35 + src/adapter/inbound/web/CLAUDE.md | 6 +- src/adapter/inbound/web/README.md | 25 +- src/adapter/inbound/web/build.gradle | 63 +- src/adapter/inbound/web/gradle.lockfile | 294 +-- .../web/advanced/WebAdvancedFeature.java | 104 +- .../web/advanced/WebAdvancedFeatureFlags.java | 47 - .../mvc/MvcJsonSequenceConfiguration.java | 27 + .../MvcStreamingExecutorConfiguration.java | 65 +- .../mvc/MvcStreamingSupportConfiguration.java | 32 + .../virtualthread/VirtualThreadProfile.java | 5 - .../inbound/web/auth/JwtDecoderConfig.java | 28 +- .../web/auth/SecurityErrorClassifier.java | 29 +- .../web/config/PresentationWebConfig.java | 4 +- .../web/core/OwnsAbsoluteWebRoute.java | 17 + .../inbound/web/core/WebRequestId.java | 3 + .../adapter/inbound/web/core/WebTraceId.java | 3 + .../admin/FileserverAdminController.java | 2 + .../controller/FileDownloadController.java | 35 +- .../controller/FileUploadController.java | 21 +- .../draft12/Draft12UploadController.java | 6 +- .../fileserver/dto/UploadedFileResponse.java | 2 +- .../http}/DefaultHttpRangeResolver.java | 52 +- .../http/HttpConditionalRequest.java} | 23 +- .../http/HttpContentDispositionFactory.java} | 29 +- .../fileserver/http/HttpDownloadDecision.java | 61 + .../fileserver/http/HttpDownloadOutcome.java | 9 + .../fileserver/http/HttpDownloadPlanner.java | 122 + .../fileserver/http/HttpDownloadPolicy.java | 16 + .../HttpRangeNotSatisfiableException.java | 28 + .../web/fileserver/http/HttpRangePolicy.java | 32 + .../fileserver/http/HttpRangeResolver.java | 6 + .../fileserver/http/HttpResolvedRanges.java} | 17 +- .../http/MvcConditionalRequestFactory.java | 17 +- .../http/MvcDownloadResponseWriter.java | 57 +- .../lifecycle/FileLifecycleController.java | 26 +- .../nginx/NginxDownloadStrategy.java | 11 +- .../problem/FileserverProblemHeaders.java | 4 +- .../reactive/FileDownloadHandler.java | 39 +- .../reactive/FileUploadHandler.java | 4 +- .../FileserverReactiveConfiguration.java | 4 +- .../ReactiveDownloadResponseWriter.java | 53 +- .../web/fileserver/tus/TusController.java | 6 +- .../web/filter/RequestLoggingFilter.java | 18 +- .../adapter/inbound/web/http/ApiHeaders.java | 3 +- .../inbound/web/http/WebSuccessResponse.java | 11 +- .../DeterministicCommandEncoder.java | 74 - .../idempotency/FingerprintHeaderPolicy.java | 102 - .../web/idempotency/IdempotencyAdmission.java | 85 - .../web/idempotency/IdempotencyKey.java | 33 - .../idempotency/IdempotencyKeySupport.java | 66 - .../idempotency/IdempotencyResponsePlan.java | 97 - .../SemanticRequestFingerprintFactory.java | 94 - .../web/idempotency/WebIdempotencyGate.java | 180 -- .../web/moduleboundary/WebStableModule.java | 45 +- .../WebMvcPlatformAutoConfiguration.java | 50 +- .../autoconfigure/WebMvcPlatformSettings.java | 7 +- .../WebMvcPlatformStartupCheck.java | 59 + .../error/WebMvcProblemExceptionHandler.java | 20 +- .../web/mvc/filter/WebMvcRequestIdFilter.java | 6 +- .../idempotency/IdempotentResponseWriter.java | 84 - .../idempotency/WebMvcIdempotentInvoker.java | 108 - .../operation/OperationHttpController.java | 2 + .../callback/CallbackRequestFactory.java | 15 +- .../NotificationCallbackMvcController.java | 7 +- .../callback/ProviderCallbackHttpRequest.java | 95 + .../callback/ProviderCallbackIngress.java | 16 + .../CallbackWebFluxConfiguration.java | 4 +- .../NotificationCallbackWebFluxHandler.java | 6 +- .../operationasync/OperationQueryService.java | 12 +- .../web/ratelimit/RateLimitWebConfig.java | 7 +- .../WebFluxPlatformAutoConfiguration.java | 17 +- .../error/WebFluxProblemExceptionHandler.java | 19 +- .../idempotency/WebFluxIdempotentInvoker.java | 168 -- .../ReactiveOperationHttpController.java | 2 + .../performance/TomcatLoadAndShutdownIT.java | 0 .../web/testkit/budget/TomcatWebBudgetIT.java | 0 .../contract/TomcatContractRecordingIT.java | 0 .../fault/CommitThenConnectionResetIT.java | 0 .../web/testkit/mvc/TomcatWebContractIT.java | 0 .../operation/TomcatOperationHttpIT.java | 0 .../web/testkit/order/MvcPipelineOrderIT.java | 0 .../testkit/throttle/TomcatWebThrottleIT.java | 0 .../mvc/MvcAdvancedConfigurationTest.java | 21 +- .../release/WebAdvancedReleaseTest.java | 49 +- .../release/WebAdvancedRollbackIT.java | 26 +- .../web/auth/JwtDecoderConfigTest.java | 17 +- .../web/auth/SecurityErrorClassifierTest.java | 33 +- .../web/config/PresentationWebConfigTest.java | 63 + .../FileDownloadControllerContractTest.java | 1 + .../HttpContentDispositionFactoryTest.java} | 37 +- .../http/HttpDownloadPlannerTest.java | 210 ++ .../http/HttpRangeResolverTest.java | 101 + .../nginx/NginxDownloadDelegationTest.java | 1 + .../FileserverProblemHeaderParityTest.java | 4 +- .../ReactiveFileserverContractTest.java | 6 +- .../FileserverHardeningContractTest.java | 1 + .../testkit/RecordingAdminService.java | 1 - .../testkit/RecordingFinalizeService.java | 1 - .../testkit/RecordingUploadService.java | 1 - .../testkit/StubDownloadService.java | 49 +- .../web/filter/RequestLoggingFilterTest.java | 46 +- .../IdempotencyKeySupportTest.java | 80 - ...SemanticRequestFingerprintFactoryTest.java | 140 - .../idempotency/WebIdempotencyGateTest.java | 343 --- .../WebMvcPlatformAutoConfigurationTest.java | 6 +- .../WebMvcPlatformStartupCheckTest.java | 22 + ...ProblemExceptionHandlerActivationTest.java | 48 + .../WebMvcIdempotentInvokerTest.java | 288 --- ...NotificationCallbackMvcControllerTest.java | 267 +- .../EdgeRateLimitTransportBridgeTest.java | 2 +- .../ratelimit/RateLimitInterceptorTest.java | 2 +- .../web/ratelimit/RateLimitWebConfigTest.java | 37 +- .../arch/WebArchitectureRulesTest.java | 4 +- .../WebFluxIdempotentInvokerTest.java | 268 -- .../resources/application-web-contract.yaml | 19 - .../testkit/arch/WebArchitectureRules.java | 36 +- .../testkit/arch/WebControllerPredicates.java | 29 + .../testkit/contract/WebContractFixture.java | 3 +- .../testkit/fault/FaultFixtureController.java | 92 +- .../fault/FaultFixtureIdempotency.java | 52 + .../fault/HttpResponseLossFixture.java | 3 +- .../IdempotencyResponseLossContract.java | 8 +- .../fault/ReactiveFaultFixtureController.java | 93 +- .../testkit/fault/ResponseLossFixture.java | 3 +- .../operation/OperationFixtureSupport.java | 26 + .../resources/application-web-contract.yaml | 0 .../resources/application-web-contract.yaml | 19 - src/adapter/inbound/websocket/CLAUDE.md | 86 +- src/adapter/inbound/websocket/README.md | 2 +- src/adapter/inbound/websocket/build.gradle | 15 +- src/adapter/inbound/websocket/gradle.lockfile | 238 +- .../advanced/WebSocketAdvancedCapability.java | 24 +- .../advanced/resume/ResumeTokenOutcome.java | 21 +- .../advanced/resume/ResumeTokenPayload.java | 6 +- .../advanced/sockjs/SockJsConfiguration.java | 27 +- .../AdvancedStompSafetyConfiguration.java | 35 + .../stomp/StompBrokerExclusivity.java | 4 +- .../advanced/stomp/StompConfiguration.java | 2 +- .../stomp/StompDefaultsConfiguration.java | 12 +- .../RabbitBrokerRelayConfiguration.java | 12 +- .../WebSocketPlatformSafetyConfiguration.java | 95 + .../config/WebSocketPlatformSettings.java | 2 +- .../core/WebSocketSubprotocolName.java | 2 +- .../moduleboundary/WebSocketModulePurity.java | 13 +- .../websocket/outbound/OutboundQueue.java | 50 +- .../outbound/SerializedOutboundWriter.java | 9 + .../WebSocketRollingRestartScenario.java | 17 +- .../servlet/PlatformWebSocketHandler.java | 21 +- .../websocket/stomp/WebSocketConfig.java | 4 +- .../websocket/stomp/WebSocketProperties.java | 4 +- .../resources/nginx/nginx-no-upgrade.conf | 2 +- .../resources/nginx/nginx.conf | 4 +- .../runtime/TomcatWebSocketAbuseIT.java | 0 .../runtime/TomcatWebSocketRuntimeIT.java | 0 .../WebSocketBoundaryQualificationTest.java | 8 +- .../advanced/resume/ResumeTokenTest.java | 18 - .../WebSocketEnvironmentBindingTest.java | 54 + ...SocketPlatformSafetyConfigurationTest.java | 167 ++ .../moduleboundary/WebSocketBuildModel.java | 5 +- .../websocket/outbound/OutboundQueueTest.java | 11 +- .../SerializedOutboundWriterTest.java | 36 + .../WebSocketProtocolProfileTest.java | 4 +- .../WebSocketRollingRestartScenarioTest.java | 31 +- ...tformWebSocketHandlerBackpressureTest.java | 97 + .../stomp/WebSocketPropertiesTest.java | 30 +- src/adapter/outbound/cache-redis/CLAUDE.md | 60 +- src/adapter/outbound/cache-redis/README.md | 436 +--- src/adapter/outbound/cache-redis/build.gradle | 28 +- .../redis/RedisSemanticFailureLogger.java | 40 + .../cache/redis/cache/CacheEnvelope.java | 73 +- .../cache/redis/cache/CacheScripts.java | 88 + .../redis/cache/RedisCacheRegionAdapter.java | 110 +- .../redis/idempotency/IdempotencyScripts.java | 37 +- .../RedisIdempotencyStoreAdapter.java | 13 +- .../cache/redis/lease/LeaseScripts.java | 4 +- .../lease/RedisDistributedLeaseAdapter.java | 12 +- .../redis/ratelimit/RateLimitScripts.java | 71 +- .../ratelimit/RedisEdgeRateLimitAdapter.java | 8 +- .../redis/LiveRedisSemanticPortsTest.java | 69 + .../cache/redis/cache/CacheEnvelopeTest.java | 92 + .../cache/RedisCacheRegionAdapterTest.java | 84 +- ...potencyScriptsConcurrencyContractTest.java | 29 + .../RedisIdempotencyStoreAdapterTest.java | 7 +- .../RedisDistributedLeaseAdapterTest.java | 29 +- .../RedisEdgeRateLimitAdapterTest.java | 22 +- .../RedisServerTimeScriptContractTest.java | 41 + .../redis/sdk/RedisSdkModuleBoundaryTest.java | 71 +- .../redis/sdk/RedisSupportMatrixTest.java | 34 +- .../config/RedisScriptLaneCapacityTest.java | 67 + .../sdk/config/RedisStartupProbeTest.java | 8 +- .../InMemoryRedisCommandGateway.java | 37 +- src/adapter/outbound/fileserver/CLAUDE.md | 18 +- src/adapter/outbound/fileserver/README.md | 11 +- src/adapter/outbound/fileserver/build.gradle | 1 + .../outbound/fileserver/FileExportConfig.java | 2 + .../fileserver/FileserverR2Config.java | 1 + .../FilesystemCsvExportAdapter.java | 32 +- .../local/AtomicMoveContentPublisher.java | 7 +- .../local/ContentPublishVerification.java | 47 +- .../platform/local/LocalAppendEngine.java | 9 + .../local/LocalBlockingContentStore.java | 11 +- .../MetadataPointerContentPublisher.java | 2 +- .../platform/local/SecureDirectoryWalk.java | 73 +- .../MicrometerFileserverMetrics.java | 10 +- .../LocalVerificationContentReader.java | 19 +- .../verification/ScriptableContentPolicy.java | 2 +- .../VerificationContentReader.java | 5 +- .../fileserver/FilePublicationConfigTest.java | 2 + .../fileserver/FileserverR2ConfigTest.java | 8 +- .../FilesystemCsvExportAdapterTest.java | 6 +- .../platform/local/LocalAppendEngineTest.java | 34 + .../local/SecureDirectoryWalkTest.java | 49 + .../LocalVerificationContentReaderTest.java | 92 + .../ScriptableContentPolicyTest.java | 46 + src/adapter/outbound/httpclient/CLAUDE.md | 27 +- src/adapter/outbound/httpclient/build.gradle | 36 +- .../outbound/httpclient/gradle.lockfile | 406 +-- .../FailureInjectionContractTest.java | 105 + .../httpclient/testkit/ToxiproxyFixture.java | 5 + .../auth/ProxyCredentialProvider.java | 36 - .../DynamicTargetAutoConfiguration.java | 2 +- .../HttpClientActuatorEndpoint.java | 2 +- ...ClientAuthenticationAutoConfiguration.java | 39 +- .../HttpClientEnvironmentKeys.java | 6 +- ...HttpClientManagementAutoConfiguration.java | 2 +- ...ttpClientObservationAutoConfiguration.java | 2 +- .../HttpClientPlatformAutoConfiguration.java | 2 +- .../HttpClientPlatformSettings.java | 13 +- .../HttpClientPlatformSettingsBinder.java | 4 +- .../HttpClientProfileAutoConfiguration.java | 16 +- .../HttpClientProfileFactory.java | 2 +- ...HttpClientResilienceAutoConfiguration.java | 2 +- .../HttpClientSecurityAutoConfiguration.java | 2 +- .../HttpClientStartupValidator.java | 51 +- .../HttpClientTransportAutoConfiguration.java | 5 +- .../HttpServiceClientAutoConfiguration.java | 2 +- .../dynamic/DefaultDynamicTargetGateway.java | 6 +- .../dynamic/ValidatedDnsResolver.java | 17 +- .../reactor/ReactorHttpClientFactory.java | 10 +- .../ReactorNettyTransportProvider.java | 13 +- .../ValidatedAddressResolverGroup.java | 58 - .../ReactiveAttemptResiliencePipeline.java | 108 + .../resilience/ResilienceRegistry.java | 18 +- .../restclient/BlockingAttemptExecutor.java | 124 +- .../restclient/RestClientResponseReader.java | 19 +- .../httpclient/security/HeaderPolicy.java | 1 + .../security/PlatformHeaderPropagation.java | 46 + .../security/TrustedTargetPolicy.java | 1 + .../webclient/DefaultReactiveHttpGateway.java | 30 + .../webclient/DefaultReactiveSseGateway.java | 59 +- .../webclient/ReactiveAttemptExecutor.java | 108 +- .../webclient/ReactiveClientRuntime.java | 9 + .../webclient/WebClientRuntimeFactory.java | 14 + ...ot.autoconfigure.AutoConfiguration.imports | 1 + .../HttpClientAutoConfigurationTest.java | 17 +- .../HttpClientPlatformActivationTest.java | 70 +- .../HttpClientPlatformEnvManifestTest.java | 6 +- .../HttpClientPlatformSettingsTest.java | 2 +- .../ReactiveAuthenticationContractTest.java | 34 +- .../UnsafeStartupConfigurationTest.java | 2 +- .../FailureInjectionContractTest.java | 86 - .../NegotiatedProtocolContractTest.java | 3 +- .../dynamic/DnsPinningSocketPathTest.java | 53 + .../dynamic/DynamicTargetSecurityTest.java | 5 +- .../ResilienceRegistryDefaultsTest.java | 15 + .../DefaultGenericHttpGatewayTest.java | 68 + .../testkit/ForwardProxyContractTest.java | 66 +- .../webclient/BlockHoundEventLoopTest.java | 30 + .../DefaultReactiveHttpGatewayTest.java | 73 + .../observation/SensitiveValueRedactor.java | 0 .../httpclient/testkit/ProxyFixture.java | 60 + .../testkit/ReactiveTestGateways.java | 5 +- .../httpclient/testkit/TestGateways.java | 22 +- src/adapter/outbound/identifier/build.gradle | 1 + .../outbound/messaging-kafka/build.gradle | 11 + .../outbound/messaging-kafka/gradle.lockfile | 157 ++ .../messaging/kafka/BrokerAddress.java | 0 .../messaging/kafka/KafkaAdapterConfig.java | 0 .../messaging/kafka/KafkaAdapterSettings.java | 0 .../messaging/kafka/KafkaMessageBroker.java | 0 .../outbound/messaging/kafka/KafkaSender.java | 0 .../kafka/KafkaSenderAutoConfiguration.java | 0 ...cyKafkaMessagingRootAutoConfiguration.java | 17 + ...ot.autoconfigure.AutoConfiguration.imports | 1 + .../messaging/kafka/BrokerAddressTest.java | 0 .../kafka/KafkaAdapterSettingsTest.java | 0 ...aSenderAutoConfigurationOwnershipTest.java | 5 +- src/adapter/outbound/messaging/build.gradle | 8 +- .../outbound/messaging/gradle.lockfile | 23 +- .../MessagingBridgeRootAutoConfiguration.java | 8 +- ...agingOffAutoConfigurationImportFilter.java | 4 +- .../outbox/OutboxMessagePublishAdapter.java | 16 +- ...toConfigurationImportFilterParityTest.java | 44 + .../OutboxMessagePublishAdapterTest.java | 12 +- src/adapter/outbound/notification/README.md | 13 +- .../outbound/notification/build.gradle | 4 + .../outbound/notification/gradle.lockfile | 3 + .../NotificationRoutesSettings.java | 6 +- .../catalog/CompiledNotificationBinding.java | 151 -- .../catalog/NotificationBindingCompiler.java | 516 ---- .../NotificationCanonicalRouteCatalog.java | 124 - .../catalog/NotificationCatalogException.java | 70 - .../NotificationCutoverRouteCatalog.java | 151 -- .../catalog/NotificationPlanAdapter.java | 86 - .../NotificationProviderCapabilityCard.java | 99 - ...ionProviderCapabilityDescriptorSource.java | 43 - .../NotificationProviderDescriptor.java | 41 - .../NotificationProviderRuntimeProfile.java | 45 - .../catalog/NotificationRouteDescriptor.java | 93 - .../NotificationTemplateDescriptor.java | 81 - .../core/FailOpenNotificationProvider.java | 4 +- .../core/NotificationProvider.java | 8 +- .../notification/core/RoutingNotifier.java | 34 +- .../email/google/GoogleEmailProvider.java | 8 +- .../autoconfigure/AssembledProvider.java | 2 +- .../NotificationCallbackProviderConfig.java | 73 + .../NotificationHealthEndpoint.java | 4 +- .../NotificationObservationContext.java | 4 +- .../NotificationObservationConvention.java | 4 +- ...NotificationPlatformAutoConfiguration.java | 128 +- .../NotificationPlatformCodecConfig.java | 5 +- .../NotificationPlatformCoreConfig.java | 106 + .../NotificationPlatformDispatchConfig.java | 158 ++ ...tificationPlatformObservabilityConfig.java | 18 +- .../NotificationPlatformPolicyConfig.java | 4 +- .../NotificationPlatformProviderConfig.java | 38 +- .../NotificationPlatformRegistriesConfig.java | 40 +- .../NotificationPlatformRuntimeConfig.java | 6 +- .../NotificationPlatformSecretsConfig.java | 42 +- .../NotificationPlatformSettings.java | 154 +- .../NotificationPlatformWorkerConfig.java | 4 +- .../NotificationProviderAssembly.java | 94 +- .../NotificationSesProviderConfig.java | 26 + .../NotificationSmtpProviderConfig.java | 112 +- .../NotificationSmtpSettings.java | 33 +- .../ProviderCallbackAssembler.java | 26 + .../SesProviderCallbackAssembler.java | 35 + .../SesProviderRuntimeAssembler.java | 129 + .../SmtpProviderRuntimeAssembler.java | 16 +- .../platform/callback/CallbackLimits.java | 14 +- .../callback/CallbackVerificationResult.java | 8 +- .../MapProviderCallbackAdapterRegistry.java | 3 - .../callback/ProviderCallbackAdapter.java | 15 + .../ProviderCallbackAdapterRegistry.java | 13 + .../ProviderCallbackVerificationRequest.java} | 41 +- .../platform/callback/VerifiedCallback.java | 15 + .../NotificationDispatchProperties.java | 1 + .../http/JdkNotificationHttpGateway.java | 15 +- .../provider/ses/SesCallbackAdapter.java | 12 +- .../provider/ses/SesEventNormalizer.java | 4 +- .../provider/ses/SesSuppressionUpdater.java | 2 +- .../twilio/TwilioCallbackAdapter.java | 12 +- .../twilio/TwilioStatusNormalizer.java | 4 +- .../AesGcmCallbackPayloadProtection.java | 2 +- .../security/AesGcmContactPointProtector.java | 5 + .../template/PlaceholderTemplateEngine.java | 5 +- .../platform/template/TemplateSlotPolicy.java | 139 +- .../provider/AttemptCorrelationId.java | 34 - .../InlineNotificationAttemptAdapter.java | 54 - ...NotificationAdmissionReadinessAdapter.java | 163 -- .../provider/NotificationAttemptContext.java | 54 - .../NotificationProviderAttemptAdapter.java | 363 --- .../NotificationProviderAttemptClient.java | 104 - .../NotificationProviderRateAdmission.java | 35 - .../NotificationProviderReadinessProbe.java | 12 - ...NotificationProviderReadinessSnapshot.java | 42 - ...icationProviderSecretMaterialProvider.java | 10 - .../NotificationReconciliationAdapter.java | 151 -- .../NotificationSecretMaterialHandle.java | 93 - .../provider/PreparedNotificationAttempt.java | 31 - .../provider/ProviderMessageReference.java | 15 - .../provider/ReconciliationLookupMode.java | 9 - .../slack/webhook/SlackWebhookProvider.java | 8 +- .../template/LocalEmailRenderer.java | 473 ---- .../template/NotificationTemplateCatalog.java | 253 -- .../NotificationTemplateManifest.java | 175 -- .../NotificationTemplateRenderer.java | 10 - .../template/RenderedNotification.java | 112 - .../template/SlackBlockKitRenderer.java | 124 - .../template/TemplateRenderingException.java | 15 - ...ot.autoconfigure.AutoConfiguration.imports | 1 + .../NotificationBindingCompilerTest.java | 489 ---- ...NotificationCanonicalRouteCatalogTest.java | 54 - .../NotificationCutoverRouteCatalogTest.java | 123 - .../core/NotificationAdapterTest.java | 18 +- .../core/RoutingNotifierTest.java | 84 +- ...ficationLegacyNamespaceRetirementTest.java | 20 +- .../NotificationModeSsotTest.java | 3 +- .../NotificationObservationTest.java | 2 +- ...NotificationPayloadAtRestContractTest.java | 4 +- ...ficationPlatformCoreConfigurationTest.java | 207 ++ ...tificationPlatformImportCoverageTest.java} | 31 +- .../NotificationPlatformReachabilityTest.java | 54 + .../NotificationPlatformSettingsTest.java | 36 +- .../NotificationProviderAssemblyTest.java | 121 +- .../NotificationSecretsValidationTest.java | 6 +- ...icationSmtpTransportConfigurationTest.java | 96 + .../NotificationWorkerLifecycleTest.java | 2 +- .../SesProviderRuntimeAssemblerTest.java | 107 + .../dispatch/ReconciliationJobWorkerTest.java | 4 +- .../ApnsNotificationProviderAdapterTest.java | 2 +- ...dkNotificationHttpGatewaySecurityTest.java | 27 + .../SesNotificationProviderAdapterTest.java | 2 +- .../TwilioCallbackAndProjectionTest.java | 9 +- .../twilio/TwilioCallbackContractTest.java | 15 +- .../twilio/TwilioSmsProviderAdapterTest.java | 2 +- ...ebhookNotificationProviderAdapterTest.java | 2 +- .../webpush/WebPushProviderAdapterTest.java | 2 +- .../AesGcmContactPointProtectorTest.java | 21 + .../BothEnginesHonourSlotModeTest.java | 2 +- .../template/SlotAwareRenderingTest.java | 39 + .../platform/testkit/CallbackContract.java | 16 +- .../platform/testkit/ContractAdapters.java | 10 +- .../InlineNotificationAttemptAdapterTest.java | 55 - ...ficationAdmissionReadinessAdapterTest.java | 195 -- ...tificationProviderAttemptContractTest.java | 402 --- ...NotificationReconciliationAdapterTest.java | 194 -- .../NotificationSecretMaterialHandleTest.java | 38 - .../NotificationTemplateRendererTest.java | 390 --- src/adapter/outbound/objectstorage/README.md | 3 + .../outbound/objectstorage/build.gradle | 37 +- .../outbound/objectstorage/gradle.lockfile | 345 +-- .../S3ObjectStorageAdapterIT.java | 0 .../MinioManagedObjectContractTest.java | 0 .../MinioManagedObjectFaultTest.java | 0 .../minio-provider-evidence.json | 25 + .../config/ObjectStorageBindingCompiler.java | 38 +- .../ObjectStorageScanMaintenanceConfig.java | 1 + .../direct/DirectGrantReplayCache.java | 65 + .../direct/DirectTransferCoordinator.java | 15 +- .../LocalDevObjectControlStore.java | 12 +- .../ObjectStorageDeploymentReadiness.java | 26 + .../ObjectStorageCapabilityConfigTest.java | 133 +- .../config/ObjectStorageEnvManifestTest.java | 134 + ...bjectStorageScanMaintenanceConfigTest.java | 13 + .../direct/DirectGrantReplayCacheTest.java | 67 + .../MinioDirectTransferContractTest.java | 0 .../MinioDirectTransferFaultTest.java | 0 .../ObjectStorageReadinessRegistryTest.java | 3 +- .../s3/S3ProviderCompositionTest.java | 26 +- .../outbound/persistence-jpa/CLAUDE.md | 48 +- .../outbound/persistence-jpa/README.md | 22 +- .../outbound/persistence-jpa/build.gradle | 21 +- .../api/PersistenceOperationName.java | 3 +- .../CheckConstraintViolationException.java | 2 +- .../persistence/api/error/ConstraintCode.java | 3 +- .../api/error/ConstraintViolationDetails.java | 4 +- .../error/ForeignKeyViolationException.java | 2 +- .../api/error/JpaFailureContext.java | 4 +- .../api/error/JpaPersistenceException.java | 4 +- .../NotNullConstraintViolationException.java | 2 +- ...TransactionCompletionUnknownException.java | 4 +- .../UniqueConstraintViolationException.java | 2 +- .../persistence/auditing/AuditMetadata.java | 90 - .../auditing/JpaAuditingConfiguration.java | 48 - .../auditing/JpaAuditorProvider.java | 51 - .../JpaObservabilityAutoConfiguration.java | 7 +- .../JpaTransactionAutoConfiguration.java | 6 +- .../PersistenceJpaAutoConfiguration.java | 29 + .../PersistenceJpaRuntimeConfig.java | 77 + .../PostgreSqlIdempotencyStoreConfig.java | 21 + .../config/JpaAdapterComponentsConfig.java | 2 + .../envers/HibernateEnversHistoryReader.java | 40 +- .../fileserver/FileEntityMapper.java | 15 +- .../fileserver/JpaFileMetadataStore.java | 2 +- .../fileserver/JpaUploadSessionStore.java | 12 +- .../persistence/h2/H2FailureTranslator.java | 63 + .../persistence/h2/H2PersistenceConfig.java | 6 + .../HibernateBatchConfigurationGuard.java | 29 + .../batch/HibernateJpaBatchExecutor.java | 89 +- .../idempotency/IdempotencyReaper.java | 3 +- .../idempotency/IdempotencyStoreAdapter.java | 3 +- .../liveevent/JpaLiveEventReplayAdapter.java | 60 +- .../liveevent/LiveEventJpaRepository.java | 10 - .../NotificationSchemaActivation.java | 8 +- .../NotificationJpaPersistenceFacade.java | 8 +- .../platform/AdminAuditJpaRepository.java | 41 +- .../AdminOperationResultPayloadCodec.java | 143 + .../platform/ConsentJpaRepository.java | 7 +- .../platform/ContactPointJpaRepository.java | 7 +- .../DeduplicationClaimJpaRepository.java | 4 +- .../platform/JdbcReconciliationJobStore.java | 10 +- .../platform/JpaAdminOperationStore.java | 33 +- .../platform/JpaDeliveryAttemptStore.java | 34 +- .../platform/JpaProviderEventLedger.java | 4 +- .../platform/JpaTemplateRegistry.java | 27 +- .../platform/PreferenceJpaRepository.java | 7 +- .../platform/RecipientClaimSql.java | 2 +- .../RecipientDeliveryJpaRepository.java | 28 +- .../platform/SuppressionJpaRepository.java | 9 +- .../TemplateVersionJpaRepository.java | 28 +- .../inbox/InboxItemJpaRepository.java | 7 +- .../platform/inbox/JpaNotificationInbox.java | 12 +- .../DurableOperationStoreAdapter.java | 28 +- .../persistence/outbox/OutboxReaper.java | 2 + .../outbox/OutboxStoreAdapter.java | 15 + .../PostgreSqlSqlStateErrorMapping.java | 1 + .../PostgreSqlOwnerSafeIdempotencyStore.java | 4 +- .../PostgreSqlSameStoreInboxAdapter.java | 33 +- .../outbox/CanonicalOutboxEventRowMapper.java | 130 + ...ostgreSqlImmutableOutboxAppendAdapter.java | 122 +- .../PostgreSqlPollingDeliveryAdapter.java | 78 +- .../transaction/DefaultJpaRetryPolicy.java | 6 - .../FullTransactionRetryCoordinator.java | 20 +- .../transaction/SpringTransactionPort.java | 29 +- ...ot.autoconfigure.AutoConfiguration.imports | 2 + .../V2__widen_canonical_event_id.sql | 13 + .../V1__initialize_or_adopt.sql | 59 +- .../V2__canonical_envelope_alignment.sql | 159 ++ ...tbox_canonical_transport_compatibility.sql | 22 +- ..._validate_outbox_canonical_constraints.sql | 24 + .../V15__live_event_stream_position.sql | 22 + .../V9__widen_capability_schema_stream.sql | 9 +- .../liveevent/LiveEventLogContractTest.java | 114 +- .../AdminOperationClaimContractTest.java | 41 + .../ProjectionFactDurabilityContractTest.java | 26 +- .../RecipientClaimContractTest.java | 34 +- .../platform/EnversHistoryContractTest.java | 5 + .../platform/JpaAuditingContractTest.java | 62 - .../CanonicalOutboxV2TestFixture.java | 84 + .../LegacyOutboxDrainContractTest.java | 142 + .../LegacyOutboxIntegrationSupport.java} | 39 +- ...tgreSqlDistributedLockIntegrationTest.java | 149 ++ ...ileserverMetadataStoreIntegrationTest.java | 18 +- ...lFileserverReclamationIntegrationTest.java | 7 +- ...dempotencyUniqueScopeIntegrationTest.java} | 62 +- ...igrationCompatibilityIntegrationTest.java} | 62 +- ...boxAppendTransactionalIntegrationTest.java | 73 + ...OutboxConcurrentRelayIntegrationTest.java} | 36 +- ...acyOutboxRowLifecycleIntegrationTest.java} | 66 +- .../PostgreSqlMigrationIntegrationTest.java | 39 +- ...icationPersistenceUnitIntegrationTest.java | 73 + ...ficationSchemaManifestIntegrationTest.java | 63 +- .../PostgreSqlOptionalStreamLifecycle.java | 83 +- ...ostgreSqlOutboxPollingIntegrationTest.java | 130 +- ...ostgreSqlOutboxStorageIntegrationTest.java | 202 +- .../PostgreSqlTransactionIntegrationTest.java | 2 +- .../persistence/JpaModuleBoundaryTest.java | 30 +- .../error/JpaPersistenceExceptionTest.java | 32 + .../auditing/AuditingCandidateStatusTest.java | 85 - .../PersistenceJpaAutoConfigurationTest.java | 84 + .../PersistenceJpaRuntimeConfigTest.java | 181 ++ .../PostgreSqlIdempotencyStoreConfigTest.java | 36 + .../JpaAdapterComponentsConfigTest.java | 21 + .../PersistenceEntityScanCoverageTest.java | 15 + .../h2/H2FailureTranslatorTest.java | 51 + .../HibernateBatchConfigurationGuardTest.java | 20 + .../batch/HibernateJpaBatchExecutorTest.java | 76 + .../IdempotencyActivationContractTest.java | 22 + ...aLiveEventReplayAdapterActivationTest.java | 93 + .../DistributedLockPersistenceConfigTest.java | 48 + .../OutboxStorageMigrationSafetyTest.java | 57 + ...stgreSqlConstraintMigrationSafetyTest.java | 78 + ...ficationSchemaActivationLifecycleTest.java | 31 + .../NotificationRepositorySurfaceTest.java | 59 +- .../platform/RecipientClaimSqlTest.java | 14 + .../OutboxMasterSwitchWiringContractTest.java | 28 + .../outbox/OutboxReaperWiringTest.java | 29 +- .../outbox/OutboxStoreAdapterTest.java | 36 + .../PostgreSqlSqlStateErrorMappingTest.java | 13 +- .../PostgreSqlInboxTransitionDigestTest.java | 14 + .../PostgreSqlOutboxTransitionDigestTest.java | 14 + .../testkit/JpaAuditMechanismRuleTest.java | 11 +- .../testkit/JpaReleaseRenderingTest.java | 3 +- .../DefaultJpaRetryPolicyTest.java | 22 - .../PersistenceTransactionOwnershipTest.java | 66 + .../testkit/arch/JpaArchitectureRules.java | 3 +- .../testkit/arch/JpaAuditMechanismRule.java | 46 +- .../arch/TenantScopedRepositoryPredicate.java | 17 +- .../PostgreSqlContractExtension.java | 70 - .../outbound/persistence-mongo/CLAUDE.md | 24 +- .../outbound/persistence-mongo/README.md | 72 +- .../outbound/persistence-mongo/build.gradle | 64 +- .../persistence-mongo/gradle.lockfile | 293 +-- .../MongoPlatformHealthConfiguration.java | 20 + .../mongo/MongoPlatformHealthContributor.java | 23 + .../mongo/MongoRootAutoConfiguration.java | 3 +- .../MongoPlatformHealthIndicator.java | 27 +- .../autoconfigure/MongoPlatformSettings.java | 13 +- .../autoconfigure/MongoTopologyProbe.java | 137 +- .../MongoChangeStreamSubscription.java | 5 + .../SpringReactiveChangeStreamSource.java | 5 + .../client/MongoClientSettingsFactory.java | 65 +- ...rofileClientSettingsAutoConfiguration.java | 90 + .../geo/SpringMongoGeospatialOperations.java | 6 +- .../DefaultMongoImperativeExecutor.java | 25 +- .../MongoPlatformCollectionAccess.java | 4 + .../imperative/atomic/AtomicUpdateResult.java | 22 +- .../atomic/MongoAtomicOperationsTemplate.java | 24 +- .../imperative/bulk/MongoBulkExecutor.java | 41 +- .../flamingock/FlamingockLedgerAdapter.java | 40 +- .../cursor/MongoReactiveCursorPublisher.java | 24 +- .../validation/MongoValidatorApplyPolicy.java | 16 +- ...ot.autoconfigure.AutoConfiguration.imports | 1 + .../MongoVersionCompatibilityLaneTest.java | 0 .../failure/MongoNetworkFaultLaneTest.java | 0 .../migration/MongoMigrationLaneTest.java | 0 .../MongoSingleReplicaSetContainerTest.java | 0 .../rs/MongoThreeNodeReplicaSetTest.java | 0 .../MongoSecurityIntegrationLaneTest.java | 0 .../mongo/security/MongoTlsLaneTest.java | 11 +- .../atlas/MongoAtlasLocalContainer.java | 0 .../failover/MongoProxiedReplicaSetNode.java | 0 .../failover/MongoThreeNodeReplicaSet.java | 0 .../ToxiproxyMongoNetworkFaultController.java | 0 ...MongoAuthenticatedReplicaSetContainer.java | 0 .../testkit/rs/MongoReplicaSetFixture.java | 0 .../rs/MongoSingleReplicaSetContainer.java | 0 .../rs/MongoTlsReplicaSetContainer.java | 35 +- .../mongo/MongoNamespaceContractTest.java | 21 + .../MongoPlatformHealthContributorTest.java | 64 + .../architecture/MongoModuleBoundaryTest.java | 7 +- ...oPlatformHealthMeasuresTheClusterTest.java | 16 + .../MongoReactiveWiringTest.java | 8 +- .../MongoStartupValidationTest.java | 17 +- .../ReactiveWiringCarriesTheContextTest.java | 3 +- .../MongoClientSettingsFactoryTest.java | 27 + ...leClientSettingsAutoConfigurationTest.java | 165 ++ ...ltMongoImperativeExecutorDeadlineTest.java | 86 + .../MongoAtomicOperationsTemplateTest.java | 6 + .../FlamingockMongoMigrationAdapterTest.java | 20 + ...ctiveBinderCarriesRuntimeContractTest.java | 7 +- .../cursor/MongoCursorQueryIsolationTest.java | 23 + .../testkit/compat/MongoVersionMatrix.java | 3 +- .../outbound/redis-runtime/build.gradle | 15 + .../outbound/redis-runtime/gradle.lockfile | 164 ++ .../redis/sdk/api/RedisDeploymentMode.java | 0 .../cache/redis/sdk/api/RedisVersion.java | 0 .../redis/sdk/api/command/CommandAccess.java | 0 .../redis/sdk/api/command/CommandId.java | 0 .../redis/sdk/api/command/CommandSupport.java | 0 .../cache/redis/sdk/api/command/KeySpec.java | 0 .../sdk/api/command/PersistentKeyPermit.java | 0 .../api/command/RedisCommandDescriptor.java | 0 .../redis/sdk/api/command/RedisRiskLevel.java | 0 .../redis/sdk/api/command/TimeoutProfile.java | 0 .../error/RedisCommandRejectedException.java | 0 .../sdk/api/error/RedisFailureMetadata.java | 0 .../api/error/RedisOperationException.java | 0 .../redis/sdk/api/key/RedisKeyRules.java | 0 .../redis/sdk/api/key/RedisNamespace.java | 0 .../sdk/api/operations/BitFieldOverflow.java | 0 .../api/operations/BitFieldSubcommand.java | 0 .../sdk/api/operations/BitmapOperation.java | 0 .../redis/sdk/api/operations/Distance.java | 0 .../sdk/api/operations/DistanceUnit.java | 0 .../redis/sdk/api/operations/Expiration.java | 0 .../api/operations/ExpirationCondition.java | 0 .../redis/sdk/api/operations/GeoPoint.java | 0 .../sdk/api/operations/GeoSearchRequest.java | 0 .../redis/sdk/api/operations/LexRange.java | 0 .../redis/sdk/api/operations/ListSide.java | 0 .../redis/sdk/api/operations/LongRange.java | 0 .../redis/sdk/api/operations/PageRequest.java | 0 .../redis/sdk/api/operations/ScoreRange.java | 0 .../sdk/api/operations/SortDirection.java | 0 .../api/operations/SortedSetAddOptions.java | 0 .../api/operations/StreamAppendOptions.java | 0 .../api/operations/StreamDeletionOutcome.java | 0 .../api/operations/StreamDeletionPolicy.java | 0 .../redis/sdk/api/operations/StreamId.java | 0 .../sdk/api/operations/StreamTrimPolicy.java | 0 .../sdk/cluster/RedisSlotCalculator.java | 0 .../sdk/config/RedisCorrectnessRoles.java | 0 .../sdk/config/RedisCredentialResolver.java | 0 .../sdk/config/RedisHealthContributor.java | 0 .../sdk/config/RedisSdkAutoConfiguration.java | 2 +- .../redis/sdk/config/RedisSdkSettings.java | 32 +- .../connection/RedisConnectionKind.java | 0 .../connection/RedisCredentialRole.java | 0 .../sdk/lettuce/connection/RedisLease.java | 0 .../connection/RedisRuntimeClient.java | 0 .../lettuce/connection/RedisRuntimeOwner.java | 0 .../RedisTopologyClientFactory.java | 0 .../sdk/lettuce/operations/GeoSearchHit.java | 0 .../sdk/lettuce/operations/HashScanPage.java | 0 .../sdk/lettuce/operations/KeyScanPage.java | 0 .../sdk/lettuce/operations/KeyedElement.java | 0 .../LettuceRedisCommandGateway.java | 0 .../lettuce/operations/MemberScanPage.java | 0 .../operations/RedisCommandGateway.java | 0 .../operations/RedisPubSubGateway.java | 0 .../lettuce/operations/ScoredMemberPage.java | 0 .../lettuce/operations/StreamClaimPage.java | 0 .../sdk/lettuce/operations/StreamEntry.java | 0 .../operations/StreamPendingEntry.java | 0 .../operations/StreamPendingOverview.java | 0 .../sdk/lettuce/operations/WritePresence.java | 0 ...ot.autoconfigure.AutoConfiguration.imports | 0 src/adapter/outbound/redis-sdk/build.gradle | 13 + .../outbound/redis-sdk/gradle.lockfile | 163 ++ .../cache/redis/sdk/admin/ClientSummary.java | 0 .../admin/LettuceRedisAdminOperations.java | 0 .../redis/sdk/admin/RedisAdminOperations.java | 0 .../cache/redis/sdk/admin/SlowLogEntry.java | 0 .../sdk/api/ReactiveRedisOperations.java | 0 .../redis/sdk/api/RedisCapabilities.java | 0 .../cache/redis/sdk/api/RedisCapability.java | 0 .../cache/redis/sdk/api/RedisOperations.java | 0 .../cache/redis/sdk/api/codec/RedisCodec.java | 0 .../redis/sdk/api/codec/RedisEnvelope.java | 0 .../sdk/api/codec/RedisPayloadCodec.java | 0 .../api/command/AdvancedOperationPermit.java | 0 .../redis/sdk/api/command/MultiKeyPermit.java | 0 .../sdk/api/command/OperationBudget.java | 0 .../sdk/api/command/RedisPermitVerifier.java | 0 .../sdk/api/command/RedisPolicyAuthority.java | 0 .../api/error/RedisAccessDeniedException.java | 0 .../RedisAmbiguousExecutionException.java | 0 .../sdk/api/error/RedisBusyException.java | 0 .../RedisCapabilityUnavailableException.java | 0 .../api/error/RedisConnectionException.java | 0 .../api/error/RedisCrossSlotException.java | 0 .../error/RedisDataTypeMismatchException.java | 0 .../sdk/api/error/RedisNoScriptException.java | 0 .../api/error/RedisRedirectionException.java | 0 .../error/RedisSerializationException.java | 0 .../sdk/api/error/RedisTimeoutException.java | 0 .../cache/redis/sdk/api/key/BitmapKey.java | 0 .../cache/redis/sdk/api/key/GeoKey.java | 0 .../cache/redis/sdk/api/key/HashKey.java | 0 .../redis/sdk/api/key/HyperLogLogKey.java | 0 .../cache/redis/sdk/api/key/ListKey.java | 0 .../redis/sdk/api/key/QualifiedRedisKey.java | 0 .../cache/redis/sdk/api/key/RedisKeyName.java | 0 .../redis/sdk/api/key/RedisKeyRenderer.java | 0 .../cache/redis/sdk/api/key/RedisSlotTag.java | 0 .../redis/sdk/api/key/RedisTypedKey.java | 0 .../cache/redis/sdk/api/key/SetKey.java | 0 .../cache/redis/sdk/api/key/SortedSetKey.java | 0 .../cache/redis/sdk/api/key/StreamKey.java | 0 .../redis/sdk/api/key/TypedRedisKeys.java | 0 .../cache/redis/sdk/api/key/ValueKey.java | 0 .../sdk/api/operations/BatchItemResult.java | 0 .../sdk/api/operations/BatchOptions.java | 0 .../sdk/api/operations/BitFieldResult.java | 0 .../redis/sdk/api/operations/ClaimResult.java | 0 .../sdk/api/operations/ExpirationResult.java | 0 .../operations/ExpirationUpdatePolicy.java | 0 .../redis/sdk/api/operations/GeoLocation.java | 0 .../sdk/api/operations/GeoSearchResult.java | 0 .../redis/sdk/api/operations/KeyedValue.java | 0 .../sdk/api/operations/PendingQuery.java | 0 .../sdk/api/operations/PendingRecord.java | 0 .../sdk/api/operations/PendingSummary.java | 0 .../sdk/api/operations/PubSubChannel.java | 0 .../sdk/api/operations/PubSubPattern.java | 0 .../redis/sdk/api/operations/RankRange.java | 0 .../redis/sdk/api/operations/RedisBatch.java | 0 .../api/operations/RedisBatchOperations.java | 0 .../sdk/api/operations/RedisBatchResult.java | 0 .../operations/RedisBitFieldOperations.java | 0 .../api/operations/RedisBitmapOperations.java | 0 .../RedisBlockingListOperations.java | 0 .../RedisBlockingStreamOperations.java | 0 .../sdk/api/operations/RedisDataType.java | 0 .../api/operations/RedisGeoOperations.java | 0 .../RedisHashFieldExpirationOperations.java | 0 .../api/operations/RedisHashOperations.java | 0 .../RedisHyperLogLogOperations.java | 0 .../api/operations/RedisKeyOperations.java | 0 .../api/operations/RedisListOperations.java | 0 .../api/operations/RedisMessageHandler.java | 0 .../api/operations/RedisPubSubOperations.java | 0 .../api/operations/RedisSetOperations.java | 0 .../RedisShardedPubSubOperations.java | 0 .../operations/RedisSortedSetOperations.java | 0 .../RedisStreamDeletionOperations.java | 0 .../api/operations/RedisStreamOperations.java | 0 .../api/operations/RedisValueOperations.java | 0 .../redis/sdk/api/operations/RenameMode.java | 0 .../redis/sdk/api/operations/ScanPage.java | 0 .../redis/sdk/api/operations/ScanRequest.java | 0 .../redis/sdk/api/operations/ScoredValue.java | 0 .../api/operations/ShardedPubSubChannel.java | 0 .../sdk/api/operations/StreamConsumer.java | 0 .../redis/sdk/api/operations/StreamGroup.java | 0 .../redis/sdk/api/operations/StreamRange.java | 0 .../sdk/api/operations/StreamReadOffset.java | 0 .../sdk/api/operations/StreamRecord.java | 0 .../sdk/api/operations/Subscription.java | 0 .../ReactiveRedisBatchOperations.java | 0 .../ReactiveRedisBitFieldOperations.java | 0 .../ReactiveRedisBitmapOperations.java | 0 .../ReactiveRedisBlockingListOperations.java | 0 ...ReactiveRedisBlockingStreamOperations.java | 0 .../reactive/ReactiveRedisGeoOperations.java | 0 ...iveRedisHashFieldExpirationOperations.java | 0 .../reactive/ReactiveRedisHashOperations.java | 0 .../ReactiveRedisHyperLogLogOperations.java | 0 .../reactive/ReactiveRedisKeyOperations.java | 0 .../reactive/ReactiveRedisListOperations.java | 0 .../ReactiveRedisPubSubOperations.java | 0 .../reactive/ReactiveRedisSetOperations.java | 0 .../ReactiveRedisShardedPubSubOperations.java | 0 .../ReactiveRedisSortedSetOperations.java | 0 .../ReactiveRedisStreamOperations.java | 0 .../ReactiveRedisValueOperations.java | 0 .../redis/sdk/cluster/ClusterRedirect.java | 0 .../redis/sdk/cluster/ClusterScanCursor.java | 0 .../sdk/cluster/ClusterTopologyObserver.java | 0 .../redis/sdk/cluster/SameSlotValidator.java | 0 .../config/ConfiguredRedisPermitVerifier.java | 0 .../ConfiguredRedisPolicyAuthority.java | 0 .../GrantedAdvancedOperationPermit.java | 0 .../sdk/config/GrantedMultiKeyPermit.java | 0 .../config/GrantedPersistentKeyPermit.java | 0 .../sdk/config/RedisCapabilityProbe.java | 4 +- .../redis/sdk/config/RedisStartupProbe.java | 30 +- .../extensions/ExtensionCommandRunner.java | 0 .../redis/sdk/extensions/json/JsonPath.java | 0 .../json/LettuceRedisJsonOperations.java | 0 .../extensions/json/RedisJsonOperations.java | 0 .../LettuceRedisProbabilisticOperations.java | 0 .../RedisProbabilisticOperations.java | 0 .../search/LettuceRedisSearchOperations.java | 0 .../search/RedisSearchOperations.java | 0 .../sdk/extensions/search/SearchField.java | 0 .../extensions/search/SearchFieldType.java | 0 .../sdk/extensions/search/SearchHit.java | 0 .../sdk/extensions/search/SearchIndex.java | 0 .../sdk/extensions/search/SearchQuery.java | 0 .../LettuceRedisTimeSeriesOperations.java | 0 .../timeseries/RedisTimeSeriesOperations.java | 0 .../timeseries/TimeSeriesAggregation.java | 0 .../timeseries/TimeSeriesSample.java | 0 .../sdk/lettuce/codec/ByteArrayCodec.java | 0 .../redis/sdk/lettuce/codec/DoubleCodec.java | 0 .../lettuce/codec/JsonEnvelopeFraming.java | 0 .../redis/sdk/lettuce/codec/LongCodec.java | 0 .../sdk/lettuce/codec/RedisCodecRegistry.java | 0 .../sdk/lettuce/codec/Utf8StringCodec.java | 0 .../sdk/lettuce/codec/VersionedJsonCodec.java | 0 .../sdk/lettuce/command/CommandAdmission.java | 0 .../command/CommandExecutionContext.java | 0 .../lettuce/command/CommandPolicyGuard.java | 0 .../sdk/lettuce/command/CommandRequest.java | 0 .../lettuce/command/ExecutionCertainty.java | 0 .../command/LettuceExceptionTranslator.java | 0 .../command/QueueingRedisCommandExecutor.java | 0 .../command/ReactiveRedisCommandExecutor.java | 0 .../lettuce/command/RedisCommandCatalog.java | 0 .../command/RedisCommandMetadataDiff.java | 0 .../lettuce/command/RedisCommandPolicy.java | 0 .../command/RedisCommandPolicyLoader.java | 0 .../command/RedisServerCommandMetadata.java | 0 .../command/SyncRedisCommandExecutor.java | 0 .../connection/RedisConnectionLease.java | 0 .../connection/RedisConnectionRegistry.java | 0 .../connection/SentinelFailoverObserver.java | 0 .../observability/NoThrowObservationSink.java | 0 .../observability/RedisObservation.java | 0 .../operations/AtomicCounterScripts.java | 0 .../lettuce/operations/BatchExecution.java | 0 .../operations/BitmapOperationRequests.java | 0 .../operations/GeoOperationRequests.java | 0 .../operations/HashOperationRequests.java | 0 .../HyperLogLogOperationRequests.java | 0 .../operations/KeyOperationRequests.java | 0 .../LettuceReactiveRedisBatchOperations.java | 0 ...ettuceReactiveRedisBitFieldOperations.java | 0 .../LettuceReactiveRedisBitmapOperations.java | 0 ...ceReactiveRedisBlockingListOperations.java | 0 ...ReactiveRedisBlockingStreamOperations.java | 0 .../LettuceReactiveRedisGeoOperations.java | 0 ...iveRedisHashFieldExpirationOperations.java | 0 .../LettuceReactiveRedisHashOperations.java | 0 ...uceReactiveRedisHyperLogLogOperations.java | 0 .../LettuceReactiveRedisKeyOperations.java | 0 .../LettuceReactiveRedisListOperations.java | 0 .../LettuceReactiveRedisPubSubOperations.java | 0 .../LettuceReactiveRedisSetOperations.java | 0 ...eReactiveRedisShardedPubSubOperations.java | 0 ...ttuceReactiveRedisSortedSetOperations.java | 0 .../LettuceReactiveRedisStreamOperations.java | 0 .../LettuceReactiveRedisValueOperations.java | 0 .../lettuce/operations/LettuceRedisBatch.java | 0 .../LettuceRedisBatchOperations.java | 0 .../LettuceRedisBitFieldOperations.java | 0 .../LettuceRedisBitmapOperations.java | 0 .../LettuceRedisBlockingListOperations.java | 0 .../LettuceRedisBlockingStreamOperations.java | 0 .../operations/LettuceRedisGeoOperations.java | 0 ...uceRedisHashFieldExpirationOperations.java | 0 .../LettuceRedisHashOperations.java | 0 .../LettuceRedisHyperLogLogOperations.java | 0 .../operations/LettuceRedisKeyOperations.java | 0 .../LettuceRedisListOperations.java | 0 .../LettuceRedisPubSubOperations.java | 0 .../operations/LettuceRedisSetOperations.java | 0 .../LettuceRedisShardedPubSubOperations.java | 0 .../LettuceRedisSortedSetOperations.java | 0 .../LettuceRedisStreamDeletionOperations.java | 0 .../LettuceRedisStreamOperations.java | 0 .../LettuceRedisValueOperations.java | 0 .../operations/ListOperationRequests.java | 0 .../lettuce/operations/LiveSubscription.java | 0 .../operations/PubSubOperationRequests.java | 0 .../operations/RedisOperationContext.java | 0 .../operations/RedisOperationLimits.java | 0 .../operations/SetOperationRequests.java | 0 .../SortedSetOperationRequests.java | 0 .../operations/StreamOperationRequests.java | 0 .../lettuce/operations/SubscriptionFlux.java | 0 .../operations/ValueOperationRequests.java | 0 .../LettuceRedisFunctionOperations.java | 0 .../LettuceRedisScriptOperations.java | 0 .../LettuceRedisTransactionOperations.java | 0 .../sdk/programmability/QueuedReply.java | 0 .../sdk/programmability/RedisArgument.java | 0 .../RedisFunctionOperations.java | 0 .../programmability/RedisResultDecoder.java | 0 .../RedisScriptOperations.java | 0 .../programmability/RedisScriptRegistry.java | 0 .../RedisTransactionCallback.java | 0 .../RedisTransactionOperations.java | 0 .../RedisTransactionQueue.java | 0 .../RedisTransactionRunner.java | 0 .../RegisteredRedisFunction.java | 0 .../RegisteredRedisScript.java | 0 .../programmability/TransactionOptions.java | 0 .../programmability/TransactionResult.java | 0 .../redis/sdk/raw/ApprovedRawCommand.java | 0 .../redis/sdk/raw/LettuceRedisRawGateway.java | 0 .../redis/sdk/raw/RawCommandApprovals.java | 0 .../redis/sdk/raw/RawCommandPolicyToken.java | 0 .../cache/redis/sdk/raw/RawMovableKeys.java | 0 .../cache/redis/sdk/raw/RawReplyDecoder.java | 0 .../cache/redis/sdk/raw/RedisRawGateway.java | 0 .../redis-sdk/redis-command-policy.yml | 0 src/adapter/outbound/support/build.gradle | 1 + .../CapabilityStartupValidationException.java | 30 + .../support}/EnvironmentSecretSource.java | 13 +- .../support}/StrictSettingsBinder.java | 5 +- ...abilityStartupValidationExceptionTest.java | 18 + .../support/EnvironmentSecretSourceTest.java | 27 + src/app-bootstrap/CLAUDE.md | 10 +- src/app-bootstrap/README.md | 69 +- src/app-bootstrap/build.gradle | 49 +- src/app-bootstrap/gradle.lockfile | 290 ++- .../ApplicationBoundaryArchitectureTest.java | 98 + .../ArchRuleDiscoveryContractTest.java | 4 + .../ArchitectureViolationFixtureTest.java | 3 +- .../CleanArchitectureRuleSupport.java | 16 +- ...mpositionRootBoundaryArchitectureTest.java | 8 +- .../DisabledAdapterArchitectureTest.java | 72 +- ...FileserverCompositionArchitectureTest.java | 52 + .../ForbiddenApiArchitectureTest.java | 2 +- .../RuntimeProfileAccessArchitectureTest.java | 32 + ...tartupFailureContractArchitectureTest.java | 15 +- ...onditionalTransportBuildContractTest.java} | 23 +- .../DistributedLockProviderContractTest.java | 454 ---- ...FileserverCompositionIntegrationTest.java} | 74 +- ...jectStorageCompositionIntegrationTest.java | 90 + ...OutboxAppendTransactionalContractTest.java | 124 - .../integration/outbox/package-info.java | 16 - .../bootstrap/integration/package-info.java | 17 +- .../bootstrap/CaSkeletonApplication.java | 9 +- .../activation/AdapterActivationEndpoint.java | 5 +- ...abilityDependencyEnvironmentValidator.java | 12 +- .../CapabilityDependencyStartupCheck.java | 12 +- .../CapabilityDependencyValidator.java | 120 +- .../RuntimeEnvironmentProfileValidator.java | 10 +- .../BootstrapClockAutoConfiguration.java | 25 + .../fileserver/FileserverCleanupWorker.java | 19 +- .../FileserverCorePolicyConfiguration.java | 44 + ...eserverDownloadLifecycleConfiguration.java | 64 + .../FileserverHttpDownloadConfiguration.java | 72 + ...leserverLocalStorageCoreConfiguration.java | 111 + ...serverMaintenanceServiceConfiguration.java | 106 + .../fileserver/FileserverMetricsSupport.java | 22 + .../FileserverNginxConfiguration.java | 37 + .../FileserverObservabilityConfiguration.java | 52 + .../FileserverPlatformAutoConfiguration.java | 289 +-- .../FileserverPlatformSettingsBinder.java | 2 +- .../FileserverProtocolConfiguration.java | 73 + .../FileserverSecurityConfiguration.java | 3 +- .../FileserverServiceConfiguration.java | 317 +-- .../FileserverStartupConfiguration.java | 5 +- .../FileserverStorageConfiguration.java | 290 +-- ...FileserverStorageGatewayConfiguration.java | 66 + ...eserverStorageOperationsConfiguration.java | 56 + .../FileserverUploadServiceConfiguration.java | 147 ++ .../FileserverVerificationConfiguration.java | 73 + .../FileserverWebAssemblyConfiguration.java | 38 + .../idempotency/IdempotencyConfig.java | 13 +- .../IdempotencyProviderSelectionConfig.java | 6 +- .../IdempotencyProviderSettings.java | 2 +- .../PostgreSqlIdempotencyProviderConfig.java | 31 +- .../jpa/DataSourceRequirement.java | 13 +- .../jpa/JpaDangerousConfigurationGuard.java | 9 +- .../JpaOffAutoConfigurationImportFilter.java | 3 +- .../jpa/JpaPlatformAutoConfiguration.java | 12 +- .../JpaPlatformRuntimeAutoConfiguration.java | 119 +- .../autoconfigure/jpa/JpaSafetySettings.java | 7 +- .../jpa}/MigrationStartupConfig.java | 5 +- .../PersistenceJpaRootAutoConfiguration.java | 91 +- .../lock/DistributedLockConfig.java | 4 +- .../lock/MeteredDistributedLockPort.java | 4 + .../mongo/MongoPlatformHealthConfig.java | 37 - .../mongo/MongoPlatformHealthContributor.java | 47 - ...licationCompositionAutoConfiguration.java} | 171 +- .../NotificationRootAutoConfiguration.java | 55 - .../ProviderCallbackIngressBridge.java | 95 + ...anonicalTransportRequirementValidator.java | 35 +- .../autoconfigure/outbox/OutboxConfig.java | 10 +- .../outbox/OutboxRelayScheduler.java | 5 + .../redis/RedisActivationValidator.java | 23 + .../autoconfigure/redis/RedisCacheConfig.java | 4 +- .../redis/RedisCapabilityConfig.java | 22 +- .../redis/RedisCapabilitySettings.java | 11 +- .../autoconfigure/redis/RedisKeys.java | 4 +- .../redis/RedisRateLimitConfig.java | 5 +- .../redis/RedisSemanticScriptAclProbe.java | 80 + .../autoconfigure/tracing/TracingConfig.java | 30 +- .../tracing/TracingSampleRateResolver.java | 79 +- ...acingSamplingEnvironmentPostProcessor.java | 7 +- ...ResolvedProfileLoggingContextListener.java | 12 +- .../StartupFailureSpringBootLogFilter.java | 2 +- .../runtime/JpaSchemaSafetyValidator.java | 4 +- .../PersistenceVendorProdSafetyValidator.java | 4 +- .../PostgreSqlTransportSecurityValidator.java | 3 +- .../runtime/RuntimeProfileSnapshot.java | 48 + .../runtime/RuntimeSafetyConfig.java | 4 +- .../bootstrap/runtime/SecretSource.java | 18 - .../bootstrap/runtime/SecretSourceConfig.java | 6 +- .../runtime/SecretSourceFactory.java | 8 +- .../runtime/SecretSourceStrategy.java | 2 +- .../runtime/SecretSourceValidator.java | 66 +- .../runtime/StartupSafetyValidator.java | 76 +- .../startup/FlywayProdSafetyValidator.java | 5 +- .../StartupFailureExceptionReporter.java | 8 + .../startup/StartupFailureLogState.java | 25 +- .../settings/RuntimeSafetySettings.java | 12 +- ...ot.autoconfigure.AutoConfiguration.imports | 9 +- .../src/main/resources/application-local.yml | 8 +- .../src/main/resources/application.yml | 2 +- .../main/resources/config/capabilities.yml | 16 +- .../src/main/resources/config/fileserver.yml | 11 - .../src/main/resources/config/graphql.yml | 12 + .../src/main/resources/config/httpclient.yml | 5 + .../src/main/resources/config/messaging.yml | 3 + .../main/resources/config/notification.yml | 57 +- .../main/resources/config/observability.yml | 10 +- .../src/main/resources/config/persistence.yml | 45 +- .../src/main/resources/config/ratelimit.yml | 3 - .../src/main/resources/config/redis.yml | 4 - .../src/main/resources/config/runtime.yml | 27 - .../src/main/resources/config/security.yml | 6 +- .../src/main/resources/config/server.yml | 2 +- .../src/main/resources/logback-spring.xml | 16 +- .../AdapterActivationInventory.java | 0 ...strapCapabilityReachabilitySystemTest.java | 183 ++ .../FiveAdapterOffInventoryTest.java | 2 +- .../activation/ShippedCompositionHarness.java | 65 + .../outbound/DisabledAdapterSentinelTest.java | 6 +- .../OptionalAdapterBeanGatingTest.java | 10 +- .../CapabilityDependencyValidatorTest.java | 98 +- .../MasterSwitchRegistryContractTest.java | 4 +- .../ShippedRuntimeFacadePresenceTest.java | 2 +- .../BootstrapClockAutoConfigurationTest.java | 66 + .../fileserver/FileserverAssemblyFixture.java | 14 +- ...leserverPlatformAutoConfigurationTest.java | 14 +- .../IdempotencyProviderCompositionTest.java | 19 +- .../IdempotencyProviderScanCollisionTest.java | 28 +- .../IdempotencyProviderSettingsTest.java | 15 + ...empotencyShippedAutoConfigurationTest.java | 48 + .../CapabilityEntityScanRegistrationTest.java | 71 +- .../jpa/DataSourceRequirementTest.java | 28 + .../jpa/JpaPlatformAutoConfigurationTest.java | 24 +- ...aPlatformRuntimeAutoConfigurationTest.java | 295 +-- ...eJpaRootAutoConfigurationOrderingTest.java | 23 + .../lock/DistributedLockConfigTest.java | 46 + .../MongoPlatformHealthContributorTest.java | 29 - .../NotificationAutoConfigurationTest.java | 192 +- .../NotificationPlatformReachabilityTest.java | 89 - .../ProviderCallbackIngressBridgeTest.java | 276 ++ ...tboxCanonicalTransportCompositionTest.java | 20 +- ...icalTransportRequirementValidatorTest.java | 21 +- .../redis/RedisActivationValidatorTest.java | 19 + .../redis/RedisCapabilityCompositionTest.java | 15 +- .../RedisSemanticScriptAclProbeTest.java | 137 + .../tracing/TracingActivationContextTest.java | 13 + .../TracingSampleRateResolverTest.java | 18 +- ...gSamplingEnvironmentPostProcessorTest.java | 9 + ...toConfigurationReachabilityParityTest.java | 193 ++ ...lityAutoConfigurationReachabilityTest.java | 47 + ...nalTransportQualificationContractTest.java | 14 + .../DeveloperExperienceContractTest.java | 51 + .../DistributedTracingContractTest.java | 15 +- .../EnvProfileMatrixContractTest.java | 82 +- .../ErrorCodeRegistryMappingTest.java | 4 +- .../HeaderRegistryRuntimeAlignmentTest.java | 80 + .../MongoShippedCompositionContractTest.java | 27 + ...apterConditionalExecutionContractTest.java | 4 +- .../PiiTokenBodyForbiddenContractTest.java | 30 +- .../ProfileSeparationContractTest.java | 4 +- .../RuntimeProfileLoggingContractTest.java | 25 + .../contract/SecretReloadContractTest.java | 8 +- .../MessagingMembershipQualificationTest.java | 129 +- .../EnabledIfEmailNotificationConfigured.java | 10 +- .../EnabledIfSlackNotificationConfigured.java | 13 +- ...StartupFailureSpringBootLogFilterTest.java | 32 +- ...BootstrapStructuredRuntimeLoggingTest.java | 158 ++ .../OperationalContractRuntimeTest.java | 54 +- .../runtime/RuntimeProfileSnapshotTest.java | 59 + .../bootstrap/runtime/SecretSourceTest.java | 26 +- .../runtime/SecretSourceValidatorTest.java | 30 +- .../runtime/StartupSafetyValidatorTest.java | 142 +- .../FlywayProdSafetyValidatorTest.java | 2 +- .../startup/MigrationStartupRunnerTest.java | 4 +- .../StartupFailureExceptionReporterTest.java | 11 + .../startup/StartupFailureExceptionTest.java | 2 +- .../startup/StartupOrderContractTest.java | 94 + .../JacksonDeserializationPolicyTest.java | 2 +- .../JacksonSerializationPolicyTest.java | 2 +- .../WebJsonMapperCompositionTest.java | 42 + .../src/test/resources/application-test.yml | 2 - src/application-core/CLAUDE.md | 28 +- src/application-core/build.gradle | 3 +- src/application-core/gradle.lockfile | 54 +- .../application/cache/CacheAsideExecutor.java | 10 +- .../cache/CacheRefreshCoordinationPort.java | 4 - .../DisabledCacheRefreshCoordinationPort.java | 5 - .../application/fileexport/ExportedFile.java | 25 +- .../fileexport/FileExportPort.java | 38 +- .../error/RangeNotSatisfiableException.java | 34 - .../transfer/ConditionalRequestEvaluator.java | 13 - .../DefaultConditionalRequestEvaluator.java | 127 - .../api/transfer/DownloadDecision.java | 51 - .../api/transfer/FileRepresentation.java | 23 - .../api/transfer/HttpRangeResolver.java | 13 - .../fileserver/api/transfer/RangeBudget.java | 48 - .../api/transfer/UploadProtocol.java | 16 - .../download/DownloadDescriptor.java | 62 - .../fileserver/download/DownloadPolicy.java | 27 - .../fileserver/download/DownloadRequest.java | 26 - .../application/lease/LeaseWatchdog.java | 4 + .../application/notification/Channel.java | 13 - ...estProviderCallbackApplicationUseCase.java | 164 -- .../callback/ProviderCallbackAdapter.java | 18 - .../ProviderCallbackAdapterRegistry.java | 13 - .../platform/callback/VerifiedCallback.java | 15 - .../in/IngestProviderCallbackCommand.java | 18 - .../in/IngestProviderCallbackUseCase.java | 42 - .../outbound/SecretSourcePort.java | 21 + .../outbox/v2/ClaimedOutboxDelivery.java | 31 +- .../outbox/v2/NewOutboxEventV2.java | 110 +- .../v2/OutboxPublicationAdmissionPort.java | 15 + .../outbox/v2/OutboxV2RetryPolicy.java | 134 + .../v2/PublishNextOutboxDeliveryCommand.java | 17 + .../v2/PublishNextOutboxDeliveryResult.java | 58 + .../v2/PublishNextOutboxDeliveryUseCase.java | 242 ++ .../IrreversibleSideEffectContext.java | 43 - .../cache/CacheAsideExecutorTest.java | 1 + .../CacheRefreshCoordinationContractTest.java | 1 - .../ConditionalRequestEvaluatorTest.java | 213 -- .../api/transfer/HttpRangeResolverTest.java | 107 - .../DownloadApplicationServiceTest.java | 218 -- .../idempotency/IdempotencyScopeTest.java | 2 +- .../application/lease/LeaseWatchdogTest.java | 1 + .../CallbackIngestionAtomicityTest.java | 302 --- .../v2/OutboxDeliveryV2ContractTest.java | 23 + .../outbox/v2/OutboxV2ContractTest.java | 109 +- .../testsupport/CompiledPackageScanner.java | 66 + .../testkit/LegacyOutboxAppendContract.java | 100 + src/application-fileserver/build.gradle | 10 + src/application-fileserver/gradle.lockfile | 84 + .../fileserver/admin/AdminAuditPort.java | 0 .../fileserver/admin/AdminAuditRecord.java | 0 .../admin/ContentReferenceLedger.java | 0 .../admin/DefaultFileserverAdminService.java | 0 .../admin/FileserverAdminService.java | 0 .../fileserver/admin/ForceDeleteCommand.java | 0 .../admin/IncompleteUploadView.java | 0 .../fileserver/admin/OrphanObject.java | 0 .../admin/OrphanReconcileCommand.java | 0 .../admin/OrphanReconcileReport.java | 0 .../fileserver/admin/OrphanScanPort.java | 0 .../admin/RuntimeCapabilityReport.java | 0 .../fileserver/admin/StorageHealthPort.java | 0 .../fileserver/admin/StorageHealthReport.java | 0 .../application/fileserver/api/ByteRange.java | 0 .../fileserver/api/ContentKey.java | 0 .../api/DefaultFileStateMachine.java | 0 .../application/fileserver/api/FileId.java | 0 .../application/fileserver/api/FileState.java | 0 .../fileserver/api/FileStateMachine.java | 0 .../fileserver/api/StorageNamespace.java | 0 .../application/fileserver/api/UploadId.java | 0 .../fileserver/api/content/AppendResult.java | 0 .../api/content/AsyncContentStore.java | 0 .../api/content/BlockingContentStore.java | 0 .../content/CapacityAwareContentStore.java | 0 .../api/content/ContentMetadata.java | 0 .../api/content/ContentStoreCapabilities.java | 0 .../api/content/CopyCapableContentStore.java | 0 .../api/content/CopyPrecondition.java | 0 .../api/content/CreateContentCommand.java | 0 .../content/DelegatedDownloadDescriptor.java | 0 .../api/content/DelegatedDownloadStore.java | 0 .../api/content/DeletePrecondition.java | 0 .../fileserver/api/content/DeleteResult.java | 0 .../api/content/FinalizeContentCommand.java | 0 .../fileserver/api/content/PublishMode.java | 0 .../api/content/StorageCapacity.java | 0 .../fileserver/api/content/StoredContent.java | 0 .../fileserver/api/content/UploadHandle.java | 0 .../fileserver/api/content/WriteFence.java | 0 .../error/AmbiguousCompletionException.java | 0 .../AtomicPublishUnsupportedException.java | 0 .../ConcurrentFileModificationException.java | 0 .../api/error/FileAccessDeniedException.java | 0 .../api/error/FileAlreadyExistsException.java | 0 .../api/error/FileNotFoundException.java | 0 .../api/error/FileNotReadyException.java | 0 .../api/error/FileTooLargeException.java | 0 .../api/error/FileserverErrorCode.java | 0 .../api/error/FileserverException.java | 0 .../api/error/FileserverFailureContext.java | 0 .../api/error/IntegrityMismatchException.java | 0 .../api/error/InvalidPathException.java | 0 .../api/error/MalformedRequestException.java | 6 +- .../api/error/MalwareDetectedException.java | 0 .../api/error/PartialWriteException.java | 0 .../error/PathOutsideNamespaceException.java | 0 .../api/error/QuotaExceededException.java | 0 .../api/error/StorageFullException.java | 0 .../error/StorageUnavailableException.java | 0 .../TransferAdmissionRejectedException.java | 0 .../api/error/TransferTimeoutException.java | 0 .../error/UnsupportedMediaTypeException.java | 0 .../api/error/UploadExpiredException.java | 0 .../error/UploadOffsetMismatchException.java | 0 .../api/metadata/FileDescriptor.java | 8 +- .../api/metadata/FileMetadataStore.java | 0 .../api/metadata/FileQuotaService.java | 0 .../fileserver/api/metadata/FileRecord.java | 3 - .../api/metadata/FileRecordDraft.java | 0 .../api/metadata/FileRecordMutation.java | 40 +- .../api/metadata/FileRecoveryQuery.java | 0 .../api/metadata/QuotaReservation.java | 0 .../api/metadata/QuotaReservationStatus.java | 0 .../fileserver/api/metadata/QuotaScope.java | 0 .../api/metadata/UploadSession.java | 6 +- .../api/metadata/UploadSessionDraft.java | 6 +- .../api/metadata/UploadSessionStore.java | 0 .../fileserver/api/metadata/WriterLease.java | 0 .../api/security/FileAccessPolicy.java | 11 +- .../api/security/FileAccessSubject.java | 0 .../api/security/FileOperation.java | 0 .../fileserver/api/security/FileVerifier.java | 0 .../api/security/OriginalFilenamePolicy.java | 0 .../api/security/RequestContext.java | 0 .../api/security/SanitizedFilename.java | 0 .../api/security/VerificationRequest.java | 0 .../api/security/VerificationResult.java | 0 .../api/security/VerificationVerdict.java | 0 .../api/transfer/FileRepresentation.java | 26 + .../fileserver/api/transfer/UploadMode.java | 14 + .../cleanup/CleanupBatchResult.java | 0 .../cleanup/CleanupContentGateway.java | 0 .../fileserver/cleanup/CleanupItem.java | 0 .../fileserver/cleanup/CleanupQueue.java | 0 .../fileserver/cleanup/CleanupRequest.java | 0 .../fileserver/cleanup/CleanupService.java | 0 .../fileserver/cleanup/CleanupType.java | 0 .../cleanup/DefaultCleanupService.java | 0 .../cleanup/QuotaReclaimGateway.java | 0 .../DefaultWriterLeaseCoordinator.java | 0 .../fileserver/concurrency/LeaseFence.java | 0 .../concurrency/LeaseHeartbeat.java | 0 .../concurrency/WriterLeaseCoordinator.java | 0 .../DefaultDownloadApplicationService.java | 92 +- .../download/DownloadApplicationService.java | 0 .../download/DownloadContentGateway.java | 0 .../download/DownloadDescriptor.java | 27 + .../fileserver/download/DownloadRequest.java | 16 + .../download/ZeroCopyDownloadGateway.java | 0 .../download/ZeroCopyTransferResult.java | 0 .../lifecycle/CopyContentGateway.java | 0 .../fileserver/lifecycle/CopyFileCommand.java | 9 +- .../DefaultFileLifecycleService.java | 32 +- .../fileserver/lifecycle/DeleteOutcome.java | 0 .../lifecycle/FileLifecycleService.java | 4 +- .../observability/FileserverAuditEvent.java | 0 .../observability/FileserverAuditPort.java | 0 .../observability/FileserverMetricsPort.java | 6 +- .../observability/FileserverSpans.java | 0 .../observability/NoopFileserverMetrics.java | 6 +- .../observability/SafeFileFingerprint.java | 0 .../fileserver/observability/SizeBucket.java | 0 .../observability/TransferDirection.java | 0 .../DefaultTransferAdmissionController.java | 31 +- .../fileserver/quota/StorageUsageProbe.java | 0 .../quota/TransferAdmissionController.java | 0 .../quota/TransferAdmissionProperties.java | 0 .../fileserver/quota/TransferPermit.java | 0 .../DefaultFileReconciliationService.java | 1 - .../recovery/FileReconciliationService.java | 0 .../fileserver/recovery/ProbeOutcome.java | 0 .../recovery/ReconciliationContentProbe.java | 0 .../recovery/ReconciliationResult.java | 0 .../recovery/ReconciliationStatus.java | 0 .../fileserver/recovery/RecoveryQueue.java | 0 .../recovery/StagingUploadLocator.java | 0 .../fileserver/upload/AppendUploadResult.java | 0 .../upload/CreateUploadRequest.java | 6 +- .../upload/DefaultFinalizeUploadService.java | 24 +- .../DefaultSingleShotUploadService.java | 0 .../DefaultUploadApplicationService.java | 30 +- .../upload/FileVerificationService.java | 0 .../fileserver/upload/FileView.java | 0 .../FileserverCompensationTransaction.java | 60 + .../upload/FinalizeUploadRequest.java | 0 .../upload/FinalizeUploadService.java | 0 .../fileserver/upload/QuotaCommitGateway.java | 0 .../upload/SingleShotUploadService.java | 0 .../upload/UploadApplicationService.java | 0 .../upload/UploadContentGateway.java | 0 .../upload/UploadIdentifierFactory.java | 0 .../fileserver/upload/UploadPolicy.java | 0 .../fileserver/upload/UploadSessionView.java | 0 .../upload/UploadStorageGateway.java | 0 .../admin/FileserverAdminServiceTest.java | 0 .../fileserver/api/FileStateMachineTest.java | 0 .../fileserver/api/ValueObjectTest.java | 0 .../ContentStoreApiArchitectureTest.java | 0 .../api/error/FileserverExceptionTest.java | 8 - .../metadata/MetadataPortContractTest.java | 9 +- .../security/OriginalFilenamePolicyTest.java | Bin .../cleanup/CleanupServiceTest.java | 12 +- .../MultiInstanceWriterLeaseTest.java | 4 +- .../DownloadApplicationServiceTest.java | 109 + .../lifecycle/FileLifecycleServiceTest.java | 2 +- .../FileserverObservabilityTest.java | 4 +- .../TransferAdmissionControllerTest.java | 34 + .../FileReconciliationServiceTest.java | 1 - .../testkit/DirectTransactions.java | 12 +- .../fileserver/testkit/FakeAdminPorts.java | 0 .../testkit/FakeCleanupContentGateway.java | 0 .../testkit/FakeCopyContentGateway.java | 0 .../testkit/FakeDownloadContentGateway.java | 0 .../testkit/FakeFileAccessPolicy.java | 0 .../testkit/FakeFileQuotaService.java | 0 .../testkit/FakeQuotaCommitGateway.java | 0 .../FakeReconciliationContentProbe.java | 0 .../testkit/FakeUploadContentGateway.java | 0 .../testkit/FakeUploadStorageGateway.java | 0 .../testkit/FileserverFixtures.java | 4 +- .../testkit/InMemoryCleanupQueue.java | 0 .../testkit/InMemoryFileMetadataStore.java | 3 - .../testkit/InMemoryRecoveryQueue.java | 0 .../testkit/InMemoryUploadSessionStore.java | 6 +- .../fileserver/testkit/ReadyFileFixture.java | 6 +- .../testkit/RecordingQuotaReclaimGateway.java | 0 .../SequentialUploadIdentifierFactory.java | 0 .../DefaultSingleShotUploadServiceTest.java | 143 + ...FileserverCompensationTransactionTest.java | 122 + .../upload/FinalizeUploadServiceTest.java | 8 +- .../upload/UploadApplicationServiceTest.java | 14 +- src/application-notification/build.gradle | 9 + src/application-notification/gradle.lockfile | 84 + .../ApplyNotificationReceiptCommand.java | 0 .../ApplyNotificationReceiptResult.java | 0 .../ApplyNotificationReceiptUseCase.java | 0 .../notification/ConsentCheckMode.java | 0 .../notification/EmailRecipientReference.java | 0 ...ializeNotificationWriterFencesCommand.java | 0 ...lizeNotificationWriterFencesOperation.java | 0 ...tializeNotificationWriterFencesResult.java | 0 ...ializeNotificationWriterFencesUseCase.java | 0 .../InlineNotificationAttemptPort.java | 0 .../NormalizedNotificationReceiptCommand.java | 0 .../notification/Notification.java | 0 .../NotificationAdmissionClass.java | 0 .../NotificationAdmissionGateCommand.java | 0 .../NotificationAdmissionGateUseCase.java | 0 .../NotificationAdmissionReadinessPort.java | 0 .../NotificationAppendResult.java | 0 .../NotificationApplicationException.java | 0 .../notification/NotificationAttemptId.java | 0 ...NotificationCanonicalWriterFenceGuard.java | 0 .../NotificationCanonicalWriterFencePort.java | 0 .../NotificationCanonicalWriterRouteSet.java | 0 ...ationCapabilityCompatibilityValidator.java | 0 .../notification/NotificationChannel.java | 0 .../notification/NotificationDeliveryId.java | 0 .../NotificationDeliveryStorePort.java | 0 .../NotificationDispatchCommand.java | 0 .../NotificationDispatchResult.java | 0 .../NotificationDispatchUseCase.java | 0 .../NotificationEvidenceTrustSnapshot.java | 0 .../notification/NotificationFaultScope.java | 0 .../notification/NotificationFrozenPlan.java | 0 .../NotificationIntentAppendPort.java | 0 .../notification/NotificationIntentDraft.java | 0 .../notification/NotificationIntentId.java | 0 .../notification/NotificationKindId.java | 0 .../notification/NotificationKindPolicy.java | 0 ...NotificationLegacyWriterPermitCommand.java | 0 .../NotificationLegacyWriterPermitResult.java | 0 ...NotificationLegacyWriterPermitUseCase.java | 0 .../NotificationMaintenanceCommand.java | 0 .../NotificationMaintenanceResult.java | 0 .../NotificationMaintenanceStorePort.java | 0 .../NotificationMaintenanceUseCase.java | 0 .../notification/NotificationMode.java | 0 .../NotificationOperationsSnapshot.java | 0 .../NotificationOperationsSnapshotPort.java | 0 .../NotificationOperationsSnapshotQuery.java | 0 ...NotificationOperationsSnapshotUseCase.java | 0 .../notification/NotificationPlanPort.java | 0 .../NotificationPlanningResult.java | 0 .../notification/NotificationPort.java | 4 +- .../NotificationProviderAttemptPort.java | 0 ...ificationProviderCapabilityDescriptor.java | 0 .../notification/NotificationReasonCode.java | 0 .../NotificationReceiptEventId.java | 0 .../notification/NotificationReceiptFact.java | 0 ...ionReceiptIngressCapabilityDescriptor.java | 0 .../NotificationReceiptProjection.java | 0 .../NotificationReceiptStorePort.java | 0 .../NotificationRecipientReference.java | 0 .../NotificationReconciliationPort.java | 0 .../NotificationRequestResult.java | 0 .../notification/NotificationRouteId.java | 0 .../NotificationRouteStrategy.java | 0 .../NotificationSignedEvidenceHeader.java | 0 ...NotificationStoreCapabilityDescriptor.java | 0 .../NotificationTechnicalSuppressionPort.java | 0 .../NotificationTemplateParameters.java | 0 .../notification/NotificationTemplateRef.java | 0 .../NotificationTemplateValue.java | 0 .../NotificationWriterCutoverPort.java | 0 .../NotificationWriterInventoryEvidence.java | 0 ...onWriterInventoryEvidenceVerifierPort.java | 0 .../NotificationWriterOwnership.java | 0 ...cationWriterQuiescenceAttestationPort.java | 0 .../NotificationWriterRouteSet.java | 0 .../notification/ProviderAttemptOutcome.java | 0 ...econcileNotificationDeliveriesCommand.java | 0 ...ReconcileNotificationDeliveriesResult.java | 0 ...econcileNotificationDeliveriesUseCase.java | 0 ...ionWriterQuiescenceAttestationCommand.java | 0 ...nWriterQuiescenceAttestationOperation.java | 0 ...tionWriterQuiescenceAttestationResult.java | 0 ...ionWriterQuiescenceAttestationUseCase.java | 0 .../notification/RetryDisposition.java | 0 ...edNotificationWriterInventoryManifest.java | 0 ...dNotificationWriterQuiescenceManifest.java | 0 .../notification/SlackAudienceReference.java | 0 .../notification/SubmissionCertainty.java | 0 ...tchNotificationWriterOwnershipCommand.java | 0 ...hNotificationWriterOwnershipOperation.java | 0 ...itchNotificationWriterOwnershipResult.java | 0 ...tchNotificationWriterOwnershipUseCase.java | 0 .../notification/TargetAttemptOutcome.java | 0 ...piredNotificationWriterPermitsCommand.java | 0 ...redNotificationWriterPermitsOperation.java | 0 ...xpiredNotificationWriterPermitsResult.java | 0 ...piredNotificationWriterPermitsUseCase.java | 0 .../admin/AdminAccessDeniedException.java | 0 .../platform/admin/AdminActor.java | 0 .../admin/AdminAuthorizationGuard.java | 9 +- .../platform/admin/AdminOperationClaim.java | 0 .../AdminOperationCommandFingerprint.java | 89 + .../AdminOperationConflictException.java | 11 + .../admin/AdminOperationExecutor.java | 44 + .../AdminOperationInProgressException.java | 11 + .../platform/admin/AdminOperationResult.java | 0 .../admin/AdminOperationStorePort.java | 0 ...uplicateRiskApprovalRequiredException.java | 0 .../platform/admin/DuplicateRiskGuard.java | 0 .../NotificationAdminApplicationService.java | 171 +- .../admin/NotificationAdminAuthority.java | 0 .../admin/NotificationAdminService.java | 0 .../admin/ProviderRuntimeControlPort.java | 0 .../platform/admin/ReconcileCommand.java | 0 .../platform/admin/RedriveCommand.java | 0 .../admin/SetProviderStateCommand.java | 0 .../platform/admin/SuppressCommand.java | 0 .../platform/api/CallbackIngestionResult.java | 0 .../platform/api/CancelCommand.java | 0 .../platform/api/CancelResult.java | 0 .../api/ChannelPreferenceOverride.java | 0 .../platform/api/CollapseScope.java | 0 .../platform/api/CollapseSpec.java | 0 .../platform/api/ContactPointId.java | 0 .../platform/api/ContactPointSelector.java | 0 .../platform/api/CorrelationId.java | 0 .../platform/api/DeduplicationAction.java | 0 .../platform/api/DeduplicationSpec.java | 0 .../platform/api/DeliveryAttemptId.java | 0 .../platform/api/EncodedNotificationPlan.java | 0 .../platform/api/IdempotencyKey.java | 0 .../platform/api}/NormalizedEventType.java | 2 +- .../api}/NormalizedProviderEvent.java | 2 +- .../platform/api/NotificationAcceptance.java | 0 .../platform/api/NotificationId.java | 0 .../api/NotificationOrchestrator.java | 0 .../platform/api/NotificationPlan.java | 0 .../platform/api/NotificationReceipt.java | 0 .../platform/api/NotificationSnapshot.java | 0 .../platform/api/NotificationVariable.java | 0 .../platform/api/ProviderEventId.java | 0 .../notification/platform/api/ProviderId.java | 0 .../platform/api/ProviderProfileId.java | 0 .../platform/api/RecipientDeliveryId.java | 0 .../platform/api/RecipientSpec.java | 0 .../platform/api/RequestStatus.java | 0 .../platform/api/TemplateSelection.java | 0 .../notification/platform/api/TenantId.java | 0 .../api/content/AttachmentDisposition.java | 0 .../platform/api/content/AttachmentRef.java | 0 .../platform/api/content/EmailContent.java | 0 .../platform/api/content/EmailOptions.java | 0 .../platform/api/content/InAppAction.java | 0 .../platform/api/content/InAppContent.java | 0 .../api/content/MobilePushContent.java | 0 .../api/content/NotificationContent.java | 0 .../api/content/PushPresentation.java | 0 .../platform/api/content/SmsContent.java | 0 .../platform/api/content/SmsOptions.java | 0 .../platform/api/content/WebPushContent.java | 0 .../platform/api/content/WebPushOptions.java | 0 .../api/delivery/AttemptConfirmation.java | 0 .../api/delivery/DeliveryOutcome.java | 0 .../platform/api/delivery/EvidenceLevel.java | 0 .../api/delivery/RecipientDeliveryState.java | 0 .../api/delivery/SubmissionOutcome.java | 0 .../error/AmbiguousSubmissionException.java | 0 .../error/AttachmentIntegrityException.java | 0 .../error/AttachmentUnavailableException.java | 0 .../error/CallbackProjectionException.java | 0 .../error/CallbackValidationException.java | 0 .../platform/api/error/FailureCategory.java | 0 .../error/IdempotencyConflictException.java | 0 .../error/InvalidContactPointException.java | 0 .../error/NotificationCapacityException.java | 0 .../api/error/NotificationException.java | 0 .../error/NotificationExpiredException.java | 0 .../api/error/NotificationFailureCode.java | 2 + .../error/NotificationFailureDescriptor.java | 0 .../NotificationSuppressedException.java | 0 .../NotificationValidationException.java | 0 .../ProviderAuthenticationException.java | 0 .../error/ProviderAuthorizationException.java | 0 .../error/ProviderConfigurationException.java | 0 .../error/ProviderPayloadLimitException.java | 0 .../api/error/ProviderPermanentException.java | 0 .../api/error/ProviderRejectedException.java | 0 .../api/error/ProviderThrottledException.java | 0 .../api/error/ProviderTransientException.java | 0 .../error/ProviderUnavailableException.java | 0 .../api/error/ReconciliationException.java | 0 .../api/error/TemplateNotFoundException.java | 0 .../api/error/TemplateRenderingException.java | 0 .../TemplateVariableValidationException.java | 0 .../platform/api/routing/Channel.java | 0 .../api/routing/DeliveryStrategy.java | 0 .../platform/api/routing/ExplicitChannel.java | 0 .../platform/api/routing/OrderedFallback.java | 0 .../platform/callback/AppendEventResult.java | 0 .../CallbackPayloadProtectionPort.java | 2 + .../callback/DeliveryAttemptResolverPort.java | 0 .../callback/DeliveryAttemptSnapshot.java | 0 .../platform/callback/DeliveryProjection.java | 0 .../callback/DeliveryProjectionStorePort.java | 0 .../platform/callback/EngagementFacts.java | 0 ...estProviderCallbackApplicationUseCase.java | 89 + .../callback/NotificationSideEffectPort.java | 0 .../platform/callback/ProjectionResult.java | 0 .../platform/callback/ProjectionStatus.java | 0 .../callback/ProviderEventLedger.java | 0 .../ProviderEventProjectionService.java | 0 .../callback/ProviderEventProjector.java | 0 .../ProviderEventProjectorRegistry.java | 0 .../callback/ProviderEventRecord.java | 1 + .../callback/ProviderEventRecordId.java | 0 .../callback/ProviderEventSource.java | 0 .../callback/ProviderRequestIdHash.java | 0 .../callback/StandardDeliveryProjector.java | 0 .../platform/callback/SuppressionFacts.java | 0 .../callback/VerifiedProviderEvent.java | 1 + .../platform/contact/ApnsDeviceToken.java | 0 .../platform/contact/ApnsEnvironment.java | 0 .../platform/contact/ContactPointStatus.java | 0 .../platform/contact/ContactPointType.java | 0 .../platform/contact/ContactPointValue.java | 0 .../platform/contact/EmailAddress.java | 0 .../platform/contact/FcmInstallationId.java | 0 .../platform/contact/InAppRecipientRef.java | 0 .../contact/LegacyFcmRegistrationToken.java | 0 .../platform/contact/MobilePushTarget.java | 0 .../platform/contact/PhoneNumber.java | 0 .../contact/WebPushSubscriptionValue.java | 0 .../AcceptNotificationApplicationUseCase.java | 91 +- .../ApplicationReceiptServiceImpl.java | 4 +- .../dispatch/AttachmentIntegrityGuard.java | 0 .../CancelNotificationApplicationUseCase.java | 0 .../CanonicalNotificationPlanEncoder.java | Bin .../CanonicalNotificationPlanWriter.java | 0 .../platform/dispatch/ContactPointRecord.java | 0 .../dispatch/ContactPointStorePort.java | 0 .../dispatch/DeliveryAttemptFactory.java | 0 .../dispatch/DeliveryAttemptRecord.java | 0 .../dispatch/DeliveryAttemptStorePort.java | 0 .../dispatch/DispatchGuardOutcome.java | 0 .../dispatch/DispatchOutcomeRecorder.java | 0 .../platform/dispatch/DispatchPipeline.java | 0 .../DuplicateIdempotencyKeyException.java | 0 .../GetNotificationApplicationUseCase.java | 0 .../platform/dispatch/MessageDigestPort.java | 0 .../dispatch/NotificationDispatchService.java | 39 +- .../dispatch/NotificationIdGeneratorPort.java | 0 .../NotificationRequestInsertOutcome.java | 0 .../dispatch/NotificationRequestRecord.java | 0 .../NotificationRequestStatusPolicy.java | 0 .../NotificationRequestStorePort.java | 0 .../NotificationRoutePlannerPort.java | 0 .../NotificationRoutingPlanCodecPort.java | 0 .../NotificationSubmissionService.java | 0 .../NotificationVariablesCodecPort.java | 0 .../platform/dispatch/PolicyRoutePlanner.java | 0 .../dispatch/ProviderDispatchGatewayPort.java | 0 .../dispatch/ProviderProfileCatalogPort.java | 0 .../dispatch/ProviderRequestIdHasherPort.java | 0 ...otificationTemplateApplicationUseCase.java | 0 .../dispatch/RecipientDeliveryRecord.java | 0 .../dispatch/RecipientDeliveryStorePort.java | 0 .../platform/dispatch/RecipientLease.java | 0 .../dispatch/RecipientLeaseStorePort.java | 0 .../dispatch/ReconciliationGatewayPort.java | 0 .../platform/dispatch/ReconciliationJob.java | 0 .../dispatch/ReconciliationJobStorePort.java | 0 .../dispatch/ReconciliationService.java | 0 .../platform/dispatch/RequestFingerprint.java | 0 ...cheduleNotificationApplicationUseCase.java | 0 .../SubmitNotificationApplicationUseCase.java | 0 .../dispatch/SyntheticEventFingerprint.java | 2 +- .../dispatch/TemplateRendererRegistry.java | 0 .../platform/dispatch/TenantContextPort.java | 0 .../platform/email/EmailNotification.java | 3 +- .../platform/email/EmailNotifier.java | 0 .../inbox/CreateInboxItemCommand.java | 0 .../platform/inbox/InboxContentCodecPort.java | 0 .../platform/inbox/InboxCursor.java | 0 .../platform/inbox/InboxItem.java | 0 .../platform/inbox/InboxItemCreated.java | 0 .../platform/inbox/InboxItemId.java | 0 .../platform/inbox/InboxItemState.java | 0 .../platform/inbox/InboxMutationResult.java | 0 .../platform/inbox/InboxPage.java | 0 .../platform/inbox/InboxPrincipal.java | 0 .../platform/inbox/InboxQuery.java | 0 .../platform/inbox/MarkAllReadCommand.java | 0 .../platform/inbox/NotificationInbox.java | 0 .../inbox/NotificationInboxSignalPort.java | 0 .../observation/CardinalityGuard.java | 0 .../IllegalMetricTagException.java | 0 .../observation/NotificationAuditEvent.java | 0 .../observation/NotificationAuditPort.java | 0 .../observation/NotificationMetricName.java | 0 .../observation/NotificationMetricsPort.java | 0 .../NotificationSecurityAuditPort.java | 0 .../observation/NotificationServingState.java | 0 .../NotificationServingStatePort.java | 0 .../observation/SensitiveValueDetector.java | 0 ...ompositeNotificationEligibilityPolicy.java | 0 .../platform/policy/ConsentRecord.java | 0 .../platform/policy/ConsentStorePort.java | 0 .../platform/policy/DeduplicationResult.java | 0 .../platform/policy/DeduplicationService.java | 0 .../policy/DeduplicationStorePort.java | 0 .../DefaultNotificationRetryPolicy.java | 0 .../platform/policy/EligibilityResult.java | 0 .../platform/policy/JitterSource.java | 0 .../platform/policy/NotificationContext.java | 0 .../policy/NotificationEligibilityPolicy.java | 0 .../policy/NotificationRetryPolicy.java | 0 .../platform/policy/PreferenceRecord.java | 0 .../platform/policy/PreferenceStorePort.java | 0 .../platform/policy/RecipientIdentity.java | 0 .../platform/policy/RetryBackoff.java | 0 .../platform/policy/RetryBudget.java | 0 .../platform/policy/RetryContext.java | 0 .../platform/policy/RetryDecision.java | 0 .../platform/policy/RouteCandidate.java | 0 .../platform/policy/RoutingContext.java | 0 .../platform/policy/RoutingDecision.java | 0 .../policy/RoutingDecisionEngine.java | 0 .../platform/policy/SuppressionEntry.java | 0 .../platform/policy/SuppressionId.java | 0 .../platform/policy/SuppressionReason.java | 0 .../platform/policy/SuppressionScope.java | 0 .../platform/policy/SuppressionSource.java | 0 .../platform/policy/SuppressionStorePort.java | 0 .../port/in/AcceptNotificationCommand.java | 0 .../port/in/AcceptNotificationUseCase.java | 0 .../port/in/CancelNotificationCommand.java | 0 .../port/in/CancelNotificationUseCase.java | 0 .../port/in/GetNotificationQuery.java | 0 .../port/in/GetNotificationUseCase.java | 0 .../in/IngestProviderCallbackCommand.java | 74 + .../in/IngestProviderCallbackUseCase.java | 18 + .../PublishNotificationTemplateCommand.java | 0 .../PublishNotificationTemplateUseCase.java | 0 .../port/in/ScheduleNotificationCommand.java | 0 .../port/in/ScheduleNotificationUseCase.java | 0 .../port/in/SubmitNotificationCommand.java | 0 .../port/in/SubmitNotificationUseCase.java | 0 .../provider/AttachmentAccessContext.java | 0 .../platform/provider/AttachmentResolver.java | 0 .../BatchNotificationProviderAdapter.java | 0 .../platform/provider/CollapseCapability.java | 0 .../platform/provider/EvidenceCertainty.java | 0 .../platform/provider/EvidenceFact.java | 0 .../provider/NotificationProviderAdapter.java | 0 .../ProviderCallNotStartedException.java | 0 .../provider/ProviderCapabilities.java | 0 .../provider/ProviderCollapseMapping.java | 0 .../provider/ProviderExecutionEvidence.java | 0 .../platform/provider/ProviderFailure.java | 0 .../provider/ProviderProfileSnapshot.java | 0 .../provider/ProviderRuntimeState.java | 0 .../platform/provider/ProviderSubmission.java | 0 .../provider/ProviderSubmissionResult.java | 0 .../provider/ReconciliationCapability.java | 0 .../provider/ReconciliationResult.java | 2 +- .../platform/provider/ResolvedAttachment.java | 0 .../platform/provider/TraceContext.java | 0 .../platform/push/ApplicationIdentity.java | 0 .../platform/push/ApplicationReceipt.java | 0 .../push/ApplicationReceiptService.java | 0 .../platform/push/MobilePushNotification.java | 3 +- .../platform/push/MobilePushNotifier.java | 0 .../push/ReceiptAuthorizationException.java | 0 .../platform/push/ReceiptKind.java | 0 .../platform/push/ReceiptResult.java | 0 .../platform/security/AccessContext.java | 0 .../security/ContactPointProtector.java | 0 .../NotificationPayloadProtection.java | 0 ...otificationPayloadUnreadableException.java | 0 .../security/NotificationRedactor.java | 0 .../security/ProtectedContactPoint.java | 0 .../security/SafeDiagnosticContext.java | 0 .../platform/security/SecretKeyMaterial.java | 0 .../security/SecretMaterialProvider.java | 0 .../platform/security/SecretPurpose.java | 0 .../security/SensitiveValueClassifier.java | 0 .../platform/security/SensitiveValueKind.java | 0 .../UnsafeDiagnosticFieldException.java | 0 .../platform/sms/E164PhoneNumberParser.java | 0 .../platform/sms/GsmAlphabet.java | 0 .../sms/InvalidPhoneNumberException.java | 0 .../platform/sms/SmsEncoding.java | 0 .../platform/sms/SmsEstimate.java | 0 .../platform/sms/SmsNotification.java | 3 +- .../platform/sms/SmsNotifier.java | 0 .../platform/sms/SmsSegmentEstimator.java | 0 .../NotificationTemplateRenderer.java | 0 .../template/NotificationTemplateVersion.java | 0 .../platform/template/RenderCommand.java | 7 +- .../template/RenderedNotificationContent.java | 0 .../template/TemplateContentCodecPort.java | 0 .../template/TemplateContentDefinition.java | 0 .../platform/template/TemplateRegistry.java | 0 .../platform/template/TemplateSlot.java | 0 .../platform/template/TemplateStatus.java | 0 .../template/TemplateVariableValidator.java | 7 +- .../TemplateVersionConflictException.java | 0 .../platform/template/VariableSchema.java | 0 .../platform/webpush/WebPushNotification.java | 3 +- .../platform/webpush/WebPushNotifier.java | 0 ...zeNotificationWriterFencesUseCaseTest.java | 0 .../NotificationAdmissionGateUseCaseTest.java | 0 ...ficationCanonicalWriterFenceGuardTest.java | 0 ...nCapabilityCompatibilityValidatorTest.java | 0 .../NotificationDispatchUseCaseTest.java | 0 .../NotificationKindPolicyTest.java | 0 ...ficationLegacyWriterPermitUseCaseTest.java | 0 .../NotificationMaintenanceUseCaseTest.java | 0 ...ficationOperationsSnapshotUseCaseTest.java | 0 .../NotificationPlanningBoundaryTest.java | 0 .../NotificationPortBoundaryTest.java | 0 .../NotificationPortContractTest.java | 23 +- .../NotificationReceiptReducerTest.java | 0 .../NotificationRequestResultTest.java | 0 .../NotificationTestFixtures.java | 0 .../NotificationValueContractTest.java | 0 ...cileNotificationDeliveriesUseCaseTest.java | 0 ...riterQuiescenceAttestationUseCaseTest.java | 0 ...otificationWriterOwnershipUseCaseTest.java | 0 ...dNotificationWriterPermitsUseCaseTest.java | 0 .../admin/AdminAuthorizationGuardTest.java | 49 + .../AdminOperationCommandFingerprintTest.java | 51 + .../admin/AdminOperationExecutorTest.java | 166 ++ .../admin/DuplicateRiskGuardTest.java | 79 + ...tificationAdminApplicationServiceTest.java | 182 ++ .../platform/api/NotificationPlanTest.java | 0 .../platform/api/PublicApiBoundaryTest.java | 0 .../platform/api/PublicApiIsTypedTest.java | 64 +- .../NotificationContentContractTest.java | 0 .../api/delivery/EvidenceModelTest.java | 0 .../api/error/NotificationExceptionTest.java | 0 .../platform/callback/CallbackFixtures.java | 2 + .../CallbackIngestionAtomicityTest.java | 193 ++ .../callback/ProjectionMergeContractTest.java | 1 + .../callback/ProviderEventLateMatchTest.java | 1 + .../contact/ContactPointTypeTest.java | 0 ...eptNotificationApplicationUseCaseTest.java | 177 ++ .../ApplicationReceiptServiceImplTest.java | 87 + .../AttachmentIntegrityGuardTest.java | 0 .../dispatch/CanonicalPlanEncodingTest.java | 0 .../dispatch/DeliveryAttemptFactoryTest.java | 115 + .../dispatch/DispatchOutcomeRecorderTest.java | 342 +++ .../dispatch/DispatchPipelineTest.java | 164 ++ .../NotificationApplicationUseCasesTest.java | 111 + .../NotificationDispatchServiceTest.java | 333 +++ .../dispatch/NotificationPlatformNoops.java | 214 ++ .../NotificationSubmissionServiceTest.java | 0 .../platform/dispatch/PlatformFakes.java | 0 .../dispatch/PreferredOrderRoutingTest.java | 0 ...icationTemplateApplicationUseCaseTest.java | 76 + .../dispatch/ReconciliationServiceTest.java | 83 + .../dispatch/RequestFingerprintTest.java | 0 .../SyntheticEventFingerprintTest.java | 4 +- .../observation/BoundedObservabilityTest.java | 0 .../NotificationObservabilityTest.java | 0 .../policy/DeduplicationAndCollapseTest.java | 0 .../policy/NotificationEligibilityTest.java | 0 .../policy/NotificationRetryPolicyTest.java | 0 .../platform/policy/PolicyFixtures.java | 0 .../policy/RoutingDecisionEngineTest.java | 0 .../PreDispatchFailureEvidenceTest.java | 0 .../provider/ProviderSpiContractTest.java | 0 .../security/NotificationRedactionTest.java | 0 .../platform/sms/SmsSegmentEstimatorTest.java | 0 .../template/InMemoryTemplateRegistry.java | 0 .../TemplateRegistryContractTest.java | 0 .../testsupport/CompiledPackageScanner.java | 66 + src/application-objectstorage/build.gradle | 11 + src/application-objectstorage/gradle.lockfile | 89 + .../content/CancellationView.java | 0 .../content/ObjectChunkReadException.java | 0 .../content/ObjectChunkSink.java | 0 .../content/ObjectChunkSource.java | 0 .../content/ObjectChunkWriteException.java | 0 .../content/ObjectContentConsumer.java | 0 .../ObjectContentConsumptionException.java | 0 .../content/ObjectContentProducer.java | 0 .../ObjectContentProductionContext.java | 0 .../ObjectContentProductionException.java | 0 .../content/ObjectContentReadContext.java | 0 .../identity/DirectTransferSessionId.java | 0 .../identity/MultipartPartNumber.java | 0 .../identity/ObjectDestinationId.java | 0 .../objectstorage/identity/ObjectId.java | 0 .../identity/ObjectIdentitySupport.java | 0 .../identity/ObjectOperationEpoch.java | 0 .../identity/ObjectOperationId.java | 0 .../identity/ObjectOperationKey.java | 0 .../identity/ObjectReference.java | 0 .../identity/ObjectStageHandle.java | 0 .../identity/ObjectVersionToken.java | 0 .../identity/PartReceiptToken.java | 0 .../model/DirectDownloadGrant.java | 0 .../model/DirectUploadCompletionReceipt.java | 0 .../model/DirectUploadGrant.java | 0 .../objectstorage/model/MultipartReceipt.java | 0 .../objectstorage/model/MultipartSession.java | 0 .../model/ObjectCapabilityRequirement.java | 0 .../model/ObjectContentIdentity.java | 0 .../objectstorage/model/ObjectDescriptor.java | 0 .../objectstorage/model/ObjectDigest.java | 0 .../model/ObjectDigestAlgorithm.java | 0 .../model/ObjectDigestVerification.java | 0 .../model/ObjectEncryptionRequirement.java | 0 .../model/ObjectHandoffReceipt.java | 0 .../objectstorage/model/ObjectMediaType.java | 0 .../model/ObjectModelSupport.java | 0 .../model/ObjectMutationOutcome.java | 0 .../model/ObjectMutationReceipt.java | 0 .../model/ObjectOperationError.java | 0 .../model/ObjectOperationResolution.java | 0 .../model/ObjectPublicationRequirement.java | 0 .../model/ObjectPublicationState.java | 0 .../model/ObjectPublishReceipt.java | 0 .../objectstorage/model/ObjectReadRange.java | 0 .../model/ObjectReadReceipt.java | 0 .../model/ObjectRetentionRequirement.java | 0 .../model/ObjectScanReadReceipt.java | 0 .../objectstorage/model/ObjectScanState.java | 0 .../model/ObjectStageReceipt.java | 0 .../model/ObjectVerificationReceipt.java | 0 .../objectstorage/model/PartUploadGrant.java | 0 .../port/DirectMultipartUploadPort.java | 0 .../port/DirectObjectDownloadGrantPort.java | 0 .../port/DirectObjectUploadPort.java | 0 .../port/ManagedObjectPublicationPort.java | 0 .../port/ObjectInspectionPort.java | 0 .../port/ObjectOperationResolutionPort.java | 0 .../port/ObjectPublicationHandoffPort.java | 0 .../port/ObjectPurgeMaintenancePort.java | 0 .../port/ObjectRetirementPort.java | 0 .../port/ObjectScanMaintenancePort.java | 0 .../port/ObjectTransferPort.java | 0 .../port/StagedObjectPublicationPort.java | 0 .../request/DirectDownloadGrantRequest.java | 0 .../DirectUploadCompletionRequest.java | 0 .../request/DirectUploadGrantRequest.java | 0 .../request/MultipartAbortRequest.java | 0 .../request/MultipartCompleteRequest.java | 0 .../request/MultipartPartAcknowledgement.java | 0 .../request/MultipartStartRequest.java | 0 .../request/ObjectAbortAuthorization.java | 0 .../request/ObjectAbortRequest.java | 0 .../request/ObjectFinalizeRequest.java | 0 .../request/ObjectHandoffClaimRequest.java | 0 .../request/ObjectHandoffReleaseRequest.java | 0 .../request/ObjectHandoffRenewRequest.java | 0 .../request/ObjectPublishRequest.java | 0 .../request/ObjectPurgeRequest.java | 0 .../request/ObjectReadRequest.java | 0 .../request/ObjectRequestSupport.java | 0 .../request/ObjectRetireRequest.java | 0 .../request/ObjectScanReadRequest.java | 0 .../request/ObjectScanVerdictRequest.java | 0 .../request/ObjectStageRequest.java | 0 .../request/ObjectVerifyRequest.java | 0 .../request/PartUploadGrantRequest.java | 0 .../storage/ObjectStoragePort.java | 0 .../application/storage/StoredObject.java | 0 .../LegacyObjectAdoptionApproval.java | 0 ...acyObjectAdoptionApprovalVerifierPort.java | 0 .../migration/LegacyObjectAdoptionPort.java | 0 .../LegacyObjectAdoptionReceipt.java | 0 .../LegacyObjectAdoptionRequest.java | 0 .../migration/LegacyObjectLocator.java | 0 .../ObjectContentContractTest.java | 0 ...ObjectStorageArchitectureContractTest.java | 25 +- .../ObjectStorageIdentityContractTest.java | 0 .../ObjectStoragePortContractTest.java | 0 .../ObjectStorageValueContractTest.java | 0 .../testsupport/CompiledPackageScanner.java | 66 + src/build-logic/README.md | 16 +- ...nditionalTransportQualificationPlugin.java | 7 +- .../architecture/ArchitectureModuleRule.java | 6 +- .../architecture/ArchitecturePlugin.java | 190 +- ...fyApplicationCoreDependencyPurityTask.java | 4 +- ...rifyCleanArchitectureDependenciesTask.java | 27 +- .../AuxiliarySourceSetExtension.java | 9 +- .../buildlogic/jpa/JpaTestLanesPlugin.java | 18 + ...portQualificationPluginFunctionalTest.java | 4 +- ...ectureResolvedClasspathFunctionalTest.java | 167 ++ .../AuxiliarySourceSetConventionTest.java | 37 + .../jpa/JpaTestLanesPluginFunctionalTest.java | 44 +- .../config/ConfigContractPlugin.java | 36 +- .../config/EnvContractVerifier.java | 41 +- .../buildtools/config/VerifyEnvKeysTask.java | 7 +- .../VerifyOperationalErrorRegistryTask.java | 156 ++ .../jpa/JpaAdopterApiSurfaceVerifier.java | 57 + .../buildtools/jpa/JpaEvidencePlugin.java | 26 +- .../jpa/JpaQualificationPlugin.java | 130 +- .../jpa/JpaSqlConstructionSafetyResult.java | 9 - .../jpa/SetConfigParameterBindingResult.java | 9 + ...=> SetConfigParameterBindingVerifier.java} | 10 +- .../jpa/VerifyJpaAdopterApiSurfaceTask.java | 36 + ... VerifySetConfigParameterBindingTask.java} | 12 +- ...ifyMessagingCertificationEvidenceTask.java | 26 +- .../MongoIntegrationLaneTagVerifier.java | 43 + .../buildtools/mongo/MongoJUnitXml.java | 9 +- .../mongo/MongoReleaseContractLaneResult.java | 5 +- .../MongoReleaseContractLaneVerifier.java | 47 +- .../mongo/MongoVerificationPlugin.java | 31 +- .../VerifyMongoIntegrationLaneTagsTask.java | 30 + .../VerifyMongoReleaseContractLanesTask.java | 2 + .../VerifyMongoTestLaneDisjointnessTask.java | 9 +- .../NotificationApiSurfacePlugin.java | 2 +- .../notification/NotificationClaim.java | 9 +- .../NotificationEvidenceVerifier.java | 163 +- .../VerifyNotificationEvidenceTask.java | 6 +- .../NotificationConfigurationVerifier.java | 43 +- .../config/EnvContractVerifierTest.java | 84 +- .../config/VerifyEnvKeysTaskTypeTest.java | 6 + .../jpa/JpaAdopterApiSurfaceVerifierTest.java | 38 + ...etConfigParameterBindingVerifierTest.java} | 8 +- .../MongoIntegrationLaneTagVerifierTest.java | 46 + .../MongoReleaseContractLaneVerifierTest.java | 51 +- .../NotificationEvidenceVerifierTest.java | 15 +- ...NotificationConfigurationVerifierTest.java | 59 +- src/build.gradle | 10 +- src/config/architecture/README.md | 13 + src/config/architecture/modules.json | 152 +- src/config/checkstyle/checkstyle.xml | 1 - src/config/jpa/readiness-cards.yaml | 2 +- .../messaging/release-profile-assertions.yaml | 5 + .../runtime/compose-profile-contracts.json | 115 +- src/domain-core/README.md | 6 +- .../domain/identifier/ResourceId.java | 8 +- .../domain/DomainCoreContractTest.java | 47 + .../GrpcIntegrationBridgePolicy.java | 2 +- .../GrpcIntegrationInboundGateway.java | 2 +- .../GrpcIntegrationOutboundGateway.java | 2 +- .../reactor/ReactiveGrpcServerAdapter.java | 2 +- .../GrpcIntegrationBridgePolicyTest.java | 14 +- .../GrpcKotlinCompatibilityGateTest.java | 2 +- .../compat/GrpcReactorContextBridgeTest.java | 12 +- .../diagnostics/GrpcDiagnosticsRedactor.java | 23 +- .../GrpcChannelDiagnosticsPolicyTest.java | 6 + .../resilience/GrpcHedgingEligibility.java | 6 +- .../GrpcHedgingEligibilityTest.java | 8 +- src/grpc/CLAUDE.md | 26 +- .../grpc/client/GrpcClientCallContext.java | 4 +- .../grpc/client/GrpcClientMetadataPolicy.java | 4 +- .../grpc/client/GrpcStubPolicyApplier.java | 6 +- .../client/GrpcClientMetadataPolicyTest.java | 8 +- .../grpc/client/GrpcTypedStubFactoryTest.java | 6 +- .../{ => api}/context/GrpcClientIdentity.java | 2 +- .../{ => api}/context/GrpcMetadataBudget.java | 2 +- .../{ => api}/context/GrpcMetadataKey.java | 2 +- .../{ => api}/context/GrpcRequestContext.java | 6 +- .../deadline/GrpcCancellationToken.java | 2 +- .../deadline/GrpcDeadlineBudget.java | 2 +- .../GrpcDeadlineExceededException.java | 6 +- .../deadline/GrpcDeadlineProfile.java | 2 +- .../error/GrpcCompletionOutcome.java | 2 +- .../{ => api}/error/GrpcFailureCategory.java | 2 +- .../{ => api}/error/GrpcFailureContext.java | 2 +- .../error/GrpcPlatformException.java | 2 +- .../ledger/GrpcOperationIdentity.java | 2 +- .../{ => api}/ledger/GrpcOperationLedger.java | 2 +- .../ledger/GrpcOperationLedgerRecord.java | 2 +- .../ledger/GrpcOperationLedgerState.java | 2 +- .../{ => api}/policy/GrpcMethodPolicy.java | 4 +- .../policy/GrpcMethodPolicyCatalog.java | 2 +- .../policy/RpcIdempotencyProfile.java | 2 +- .../{ => api}/policy/WaitForReadyPolicy.java | 2 +- .../context/GrpcMetadataBudgetTest.java | 8 +- .../deadline/GrpcDeadlineBudgetTest.java | 2 +- .../error/GrpcFailureContextTest.java | 2 +- .../policy/GrpcMethodPolicyCatalogTest.java | 4 +- .../core/GrpcStableModuleCatalogTest.java | 30 + .../observability/GrpcRpcObservation.java | 2 +- .../GrpcMetricCardinalityPolicyTest.java | 2 +- .../grpc-operation-ledger-jpa/build.gradle | 24 +- .../grpc-operation-ledger-jpa/gradle.lockfile | 117 +- .../ledger/GrpcOperationLedgerPostgresIT.java | 159 ++ .../ledger/GrpcOperationLedgerEntity.java | 4 + .../ledger/GrpcOperationLedgerRepository.java | 58 +- .../grpc/ledger/JpaGrpcOperationLedger.java | 34 +- .../GrpcOperationLedgerRepositoryTest.java | 52 +- .../grpc/context/GrpcContextSnapshot.java | 7 +- .../deadline/GrpcCancellationCoordinator.java | 2 + .../grpc/deadline/GrpcDeadlineCalculator.java | 5 +- .../deadline/GrpcDeadlinePolicyValidator.java | 4 +- .../grpc/error/GrpcErrorMapper.java | 4 + .../grpc/error/GrpcStatusMapping.java | 2 + .../GrpcIdempotencyInterceptor.java | 12 +- .../idempotency/GrpcOperationStatusQuery.java | 8 +- .../grpc/idempotency/GrpcOutcomeReplay.java | 46 +- .../grpc/resilience/GrpcRetryCoordinator.java | 4 +- .../grpc/resilience/GrpcRetryEligibility.java | 4 +- .../grpc/resilience/GrpcRetryOwner.java | 2 +- .../GrpcRetryOwnershipValidator.java | 6 +- .../resilience/GrpcServiceConfigPolicy.java | 4 +- .../resilience/GrpcWaitForReadyProfile.java | 2 +- .../resilience/GrpcWaitForReadyValidator.java | 4 +- .../streaming/GrpcSerializedStreamWriter.java | 38 +- .../grpc/streaming/GrpcStreamAdmission.java | 18 +- ...or.java => GrpcValidationInterceptor.java} | 4 +- .../grpc/context/GrpcContextBinderTest.java | 10 +- .../GrpcCancellationCoordinatorTest.java | 2 + .../deadline/GrpcDeadlineCalculatorTest.java | 7 +- .../grpc/error/GrpcErrorMapperTest.java | 5 + .../GrpcCompletionReconcilerTest.java | 6 +- .../GrpcIdempotencyInterceptorTest.java | 12 +- .../GrpcOutcomeReplayBoundTest.java | 24 + .../idempotency/InMemoryOperationLedger.java | 8 +- .../resilience/GrpcRetryEligibilityTest.java | 10 +- .../GrpcRetryOwnershipValidatorTest.java | 16 +- .../GrpcWaitForReadyValidatorTest.java | 10 +- .../GrpcSerializedStreamWriterTest.java | 51 + .../GrpcStreamAdmissionConcurrencyTest.java | 48 + ...ava => GrpcValidationInterceptorTest.java} | 20 +- .../hyeonworks/grpc/common/v1/error.proto | 7 +- .../server/GrpcApplicationInvocation.java | 2 +- .../grpc/server/GrpcServiceAdapter.java | 4 +- .../GrpcApplicationBoundaryRulesTest.java | 2 +- .../grpc/server/GrpcServiceAdapterTest.java | 20 +- .../grpc-spring-boot-starter/build.gradle | 2 +- .../grpc-spring-boot-starter/gradle.lockfile | 11 +- .../boot/GrpcPlatformAutoConfiguration.java | 44 +- .../grpc/boot/GrpcPlatformProperties.java | 12 - .../boot/GrpcPlatformStartupValidator.java | 18 +- ...cPlatformAutoConfigurationContextTest.java | 75 + .../GrpcPlatformStartupValidatorTest.java | 10 +- .../grpc/testkit/GrpcUnaryContractResult.java | 2 +- .../testkit/GrpcUnaryReliabilityContract.java | 2 +- .../grpc/testkit/GrpcUnaryScenario.java | 4 +- .../grpc/testkit/fault/GrpcFaultResult.java | 2 +- .../grpc/testkit/fault/GrpcFaultScenario.java | 4 +- .../GrpcTransportEvidenceClassifier.java | 2 +- .../testkit/netty/GrpcTlsTestMaterial.java | 23 +- .../testkit/GrpcPackageOwnershipTest.java | 56 + .../GrpcTransportEvidenceClassifierTest.java | 208 +- .../GrpcUnaryReliabilityContractTest.java | 10 +- src/messaging/CLAUDE.md | 9 + .../runtime/DestructiveMessagingAdmin.java | 4 +- .../admin/runtime/ReplayService.java | 20 +- .../admin/runtime/ApprovalForgeryTest.java | 12 + .../admin/runtime/ReplayServiceTest.java | 77 + .../build.gradle | 21 +- .../gradle.lockfile | 112 +- .../messaging/inbox/InboxPostgresIT.java | 2 +- ...g_inbox.sql => V1101__messaging_inbox.sql} | 0 .../build.gradle | 1 - .../kafka/share/KafkaShareGroupRegistrar.java | 46 +- .../share/KafkaShareProfileValidatorTest.java | 23 +- src/messaging/messaging-kafka/build.gradle | 36 +- src/messaging/messaging-kafka/gradle.lockfile | 138 +- .../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/KafkaConsumerRegistrar.java | 54 +- .../kafka/KafkaSecurityConfigurer.java | 9 +- .../kafka/KafkaConsumerRegistrarTest.java | 107 +- .../messaging/kafka/KafkaContractHarness.java | 0 .../messaging/kafka/KafkaFixtureProfiles.java | 0 .../messaging-nats-experimental/build.gradle | 1 - .../gradle.lockfile | 2 - .../build.gradle | 21 +- .../gradle.lockfile | 122 +- .../AdminOperationJournalPostgresIT.java | 2 +- .../messaging/outbox/OutboxPostgresIT.java | 6 +- .../outbox/JdbcOutboxRepository.java | 21 +- ...outbox.sql => V1001__messaging_outbox.sql} | 0 ...V1002__messaging_outbox_lease_fencing.sql} | 0 ...03__messaging_admin_operation_journal.sql} | 0 ...__messaging_outbox_canonical_metadata.sql} | 0 .../outbox/OutboxOperationsTest.java | 33 +- .../messaging/outbox/OutboxRelayTest.java | 22 +- .../policy/DestinationProfileValidator.java | 7 + .../policy/MessagingAdmissionController.java | 46 +- .../DestinationProfileValidatorTest.java | 67 +- .../build.gradle | 1 - .../gradle.lockfile | 16 +- src/messaging/messaging-rabbit/build.gradle | 20 +- .../messaging-rabbit/gradle.lockfile | 148 +- .../messaging/rabbit/RabbitBrokerIT.java | 0 .../rabbit/RabbitFixtureProfiles.java | 0 .../rabbit/RabbitMessagingTransport.java | 42 +- .../RabbitPublishFailureClassifier.java | 30 +- .../rabbit/RabbitProfileValidatorTest.java | 116 - .../messaging/rabbit/RabbitRuntimeTest.java | 32 + .../rabbit/RabbitTopologyAndBatchTest.java | 33 + .../rabbit/RabbitProfileFixtures.java | 118 + .../reliability/OutboxRepository.java | 35 - .../OutboxRepositoryApiSafetyTest.java | 24 + .../messaging-schema-protobuf/build.gradle | 2 +- .../messaging-schema-protobuf/gradle.lockfile | 3 +- .../build.gradle | 13 + .../gradle.lockfile | 115 + .../KafkaMessagingAutoConfiguration.java | 29 +- .../build.gradle | 12 + .../gradle.lockfile | 124 + .../RabbitMessagingAutoConfiguration.java | 30 +- .../messaging-spring-boot-starter/README.md | 57 +- .../build.gradle | 26 +- .../gradle.lockfile | 188 +- ...ssagingLiveRoundTripQualificationTest.java | 4 +- .../CompiledMessagingConfiguration.java | 32 +- .../DefaultBatchMessagePublisher.java | 38 +- .../MessagingAdminAutoConfiguration.java | 5 +- .../MessagingConfigurationCompiler.java | 84 +- .../MessagingConfigurationKeyValidator.java | 7 + .../MessagingCoreAutoConfiguration.java | 78 +- ...essagingPlatformRootAutoConfiguration.java | 3 +- .../MessagingProviderSelection.java | 8 +- .../autoconfigure/BatchPublisherTest.java | 12 + .../MessagingAutoConfigurationTest.java | 86 +- .../MessagingConfigurationBindingTest.java | 36 +- .../MessagingMigrationNamespaceTest.java | 79 + .../MessagingOutboxRelayLifecycleTest.java | 20 - .../MessagingStarterOffContractTest.java | 47 +- .../build.gradle | 1 - .../gradle.lockfile | 12 +- .../SpringCloudStreamPublisherBridge.java | 9 +- .../testkit/BrokerCertificationEvidence.java | 6 +- .../testkit/BrokerFailureMatrix.java | 20 + .../messaging/testkit/CertifiedEvidence.java | 15 + .../testkit/CompatibilityMatrix.java | 3 +- .../testkit/CompatibilityMatrixTest.java | 26 +- src/optional-platforms/build.gradle | 11 + .../settings-gradle.lockfile | 4 + src/sample-portfolio/README.md | 16 +- src/sample-portfolio/build.gradle | 67 +- src/sample-portfolio/gradle.lockfile | 589 ++--- ...UploadIntentRepositoryIntegrationTest.java | 0 ...osterRepositoryAdapterIntegrationTest.java | 0 ...rkLogRepositoryAdapterIntegrationTest.java | 0 .../SampleMigrationStreamIsolationTest.java | 81 + ...eIdempotencyRotationQualificationTest.java | 0 ...osterImageRetirementQualificationTest.java | 0 ...sterImageV8MigrationQualificationTest.java | 0 .../portfolio/SamplePortfolioApplication.java | 7 +- .../web/controller/WorkLogController.java | 18 +- .../event/PosterEventPublisher.java | 2 - .../PosterImagePublicationEventPublisher.java | 2 - .../poster/ArchivePosterUseCase.java | 2 - .../poster/CreatePosterUseCase.java | 2 - .../poster/DeletePosterUseCase.java | 4 - .../application/poster/GetPosterUseCase.java | 2 - .../poster/ListPostersUseCase.java | 2 - .../poster/PublishPosterUseCase.java | 2 - .../poster/UpdatePosterUseCase.java | 2 - .../worklog/BatchCreateWorkLogsUseCase.java | 2 - .../worklog/CreateWorkLogUseCase.java | 2 - .../worklog/DeleteWorkLogUseCase.java | 2 - .../worklog/GetRepoStatsUseCase.java | 2 - .../worklog/GetWorkLogUseCase.java | 2 - .../ListRecentWorkLogSummariesUseCase.java | 2 - .../worklog/ListWorkLogsUseCase.java | 2 - .../worklog/UpdateWorkLogUseCase.java | 2 - .../SampleApplicationUseCaseConfig.java | 162 ++ .../SamplePostgreSqlPersistenceConfig.java | 49 +- .../scan/TestEnclosedConfigurationFilter.java | 29 - .../src/main/resources/application.yml | 23 +- .../SampleApplicationContextTest.java | 32 +- .../resources/application-test.yml | 3 +- .../controller/WorkLogControllerWireTest.java | 15 - ...PolymorphicTypeValidatorAllowlistTest.java | 2 +- .../web/dto/response/BulkEnvelopeTest.java | 2 +- .../VirtualThreadMdcPropagationTest.java | 2 +- .../architecture/SampleArchitectureTest.java | 70 + ...SamplePostgreSqlPersistenceConfigTest.java | 24 + .../SamplePublicAccessSecurityConfigTest.java | 15 +- .../portfolio/domain/worklog/PeriodTest.java | 2 +- .../SamplePortfolioTestApplication.java | 0 .../testinfra/PostgreSqlTestContainer.java | 0 .../contract/OpenApiDriftContractTest.java | 2 +- .../web/date/DateHeaderContractTest.java | 0 .../web/filter/VirtualThreadMdcE2ETest.java | 10 +- .../web/openapi/OpenApiSnapshotTest.java | 0 .../openapi/worklogs-openapi-snapshot.json | 16 - src/shared-contract/build.gradle | 18 - .../shared/activation/MasterSwitch.java | 17 +- .../shared/error/OperationalError.java | 1 + .../shared/ratelimit/RateLimitDecision.java | 2 +- .../shared/runtime/RuntimeEnvironment.java | 8 +- .../activation/MasterSwitchParserTest.java | 21 +- ...eRateLimitProviderNeutralContractTest.java | 0 .../ratelimit/RateLimitContractTest.java | 6 +- 2485 files changed, 56091 insertions(+), 23550 deletions(-) create mode 100644 docs/architecture/jpa-adopter-api-surface.txt create mode 100644 docs/jpa/batch-write-guide.md create mode 100644 docs/mongo/persistence-profile.example.yml create mode 100644 docs/objectstorage/env-fields.yaml create mode 100644 docs/observability/log-fields.md create mode 100644 docs/reviews/2026-09-18-app-bootstrap-review-closure.md create mode 100644 docs/reviews/2026-09-18-techlead-review/00-overview.md create mode 100644 docs/reviews/2026-09-18-techlead-review/01-core.md create mode 100644 docs/reviews/2026-09-18-techlead-review/02-inbound-web.md create mode 100644 docs/reviews/2026-09-18-techlead-review/03-inbound-realtime.md create mode 100644 docs/reviews/2026-09-18-techlead-review/04-inbound-graphql.md create mode 100644 docs/reviews/2026-09-18-techlead-review/05-persistence-jpa.md create mode 100644 docs/reviews/2026-09-18-techlead-review/06-persistence-mongo.md create mode 100644 docs/reviews/2026-09-18-techlead-review/07-cache-redis.md create mode 100644 docs/reviews/2026-09-18-techlead-review/08-httpclient-objectstorage.md create mode 100644 docs/reviews/2026-09-18-techlead-review/09-notification-fileserver.md create mode 100644 docs/reviews/2026-09-18-techlead-review/10-messaging.md create mode 100644 docs/reviews/2026-09-18-techlead-review/11-grpc-platform.md create mode 100644 docs/reviews/2026-09-18-techlead-review/12-bootstrap-sample.md create mode 100644 docs/reviews/2026-09-18-techlead-review/13-build-dependency-ci.md create mode 100644 docs/reviews/2026-09-18-techlead-review/evidence/README.md create mode 100644 docs/reviews/2026-09-18-techlead-review/evidence/diffstat.txt create mode 100644 docs/reviews/2026-09-18-techlead-review/evidence/status.txt create mode 100644 docs/reviews/2026-09-18-techlead-review/evidence/untracked-files.txt create mode 100644 docs/reviews/2026-09-18-techlead-review/evidence/untracked-wc.txt create mode 100644 docs/reviews/2026-09-19-app-bootstrap-review-closure.md create mode 100644 docs/reviews/2026-09-19-review-remediation-master.md create mode 100644 docs/storage-capability-boundary.md create mode 100644 docs/superpowers/plans/2026-09-18-bootstrap-structured-log-fields.md create mode 100644 docs/superpowers/plans/2026-09-18-bootstrap-structured-runtime-logging.md create mode 100644 docs/superpowers/plans/2026-09-18-deployment-composition-reachability-remediation.md create mode 100644 docs/superpowers/plans/2026-09-18-httpclient-capability-composition-ownership.md create mode 100644 docs/superpowers/plans/2026-09-18-jpa-capability-composition-ownership.md create mode 100644 docs/superpowers/plans/2026-09-18-jpa-runtime-master-switch.md create mode 100644 docs/superpowers/plans/2026-09-18-mongo-health-composition-ownership.md create mode 100644 docs/superpowers/plans/2026-09-18-notification-capability-composition-ownership.md create mode 100644 docs/superpowers/plans/2026-09-18-outbox-v2-canonical-storage-alignment.md create mode 100644 docs/superpowers/plans/2026-09-18-outbox-v2-one-record-publication-policy.md create mode 100644 docs/superpowers/plans/2026-09-18-postgresql-idempotency-composition-ownership.md create mode 100644 docs/superpowers/plans/2026-09-18-runtime-environment-tracing-ssot.md create mode 100644 docs/superpowers/plans/2026-09-18-secret-source-port-ownership.md create mode 100644 docs/superpowers/plans/2026-09-18-startup-failure-log-context-state.md create mode 100644 docs/superpowers/plans/2026-09-18-test-architecture-phase2-provider-ownership.md create mode 100644 docs/superpowers/plans/2026-09-18-test-taxonomy-ssot-alignment.md create mode 100644 docs/superpowers/plans/2026-09-19-build-release-review-remediation.md create mode 100644 docs/superpowers/plans/2026-09-19-capability-dependency-validation-context.md create mode 100644 docs/superpowers/plans/2026-09-19-env-contract-verifier-truth-surface.md create mode 100644 docs/superpowers/plans/2026-09-19-fileserver-composition-decomposition.md create mode 100644 docs/superpowers/plans/2026-09-19-fileserver-verification-read-failure-remediation.md create mode 100644 docs/superpowers/plans/2026-09-19-mongo-client-runtime-review-remediation.md create mode 100644 docs/superpowers/plans/2026-09-19-multi-instance-runtime-contract.md create mode 100644 docs/superpowers/plans/2026-09-19-prod-secret-consumer-alignment.md create mode 100644 docs/superpowers/plans/2026-09-19-runtime-profile-access-boundary.md create mode 100644 docs/superpowers/plans/2026-09-19-startup-order-contract.md create mode 100644 docs/superpowers/plans/2026-09-19-test-support-ownership-closure.md create mode 100644 docs/superpowers/specs/2026-09-18-bootstrap-structured-log-fields.md create mode 100644 docs/superpowers/specs/2026-09-18-bootstrap-structured-runtime-logging.md create mode 100644 docs/superpowers/specs/2026-09-18-configuration-namespace-disposition.md create mode 100644 docs/superpowers/specs/2026-09-18-deployment-composition-reachability-remediation.md create mode 100644 docs/superpowers/specs/2026-09-18-httpclient-capability-composition-ownership.md create mode 100644 docs/superpowers/specs/2026-09-18-jpa-capability-composition-ownership.md create mode 100644 docs/superpowers/specs/2026-09-18-jpa-runtime-master-switch.md create mode 100644 docs/superpowers/specs/2026-09-18-mongo-health-composition-ownership.md create mode 100644 docs/superpowers/specs/2026-09-18-notification-capability-composition-ownership.md create mode 100644 docs/superpowers/specs/2026-09-18-outbox-v2-canonical-storage-alignment.md create mode 100644 docs/superpowers/specs/2026-09-18-outbox-v2-one-record-publication-policy.md create mode 100644 docs/superpowers/specs/2026-09-18-postgresql-idempotency-composition-ownership.md create mode 100644 docs/superpowers/specs/2026-09-18-runtime-environment-tracing-ssot.md create mode 100644 docs/superpowers/specs/2026-09-18-secret-source-port-ownership.md create mode 100644 docs/superpowers/specs/2026-09-18-startup-failure-log-context-state.md create mode 100644 docs/superpowers/specs/2026-09-18-test-architecture-phase2-provider-ownership.md create mode 100644 docs/superpowers/specs/2026-09-18-test-taxonomy-ssot-alignment.md create mode 100644 docs/superpowers/specs/2026-09-19-build-release-review-remediation-design.md create mode 100644 docs/superpowers/specs/2026-09-19-capability-dependency-validation-context.md create mode 100644 docs/superpowers/specs/2026-09-19-env-contract-verifier-truth-surface.md create mode 100644 docs/superpowers/specs/2026-09-19-fileserver-composition-decomposition.md create mode 100644 docs/superpowers/specs/2026-09-19-fileserver-verification-read-failure-remediation.md create mode 100644 docs/superpowers/specs/2026-09-19-mongo-client-runtime-review-remediation.md create mode 100644 docs/superpowers/specs/2026-09-19-multi-instance-runtime-contract.md create mode 100644 docs/superpowers/specs/2026-09-19-prod-secret-consumer-alignment.md create mode 100644 docs/superpowers/specs/2026-09-19-runtime-profile-access-boundary.md create mode 100644 docs/superpowers/specs/2026-09-19-startup-order-contract.md create mode 100644 docs/superpowers/specs/2026-09-19-test-support-ownership-closure.md delete mode 100644 src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/advanced/websocket/GraphQlWebSocketAdmission.java delete mode 100644 src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/advanced/websocket/GraphQlWebSocketConnectionId.java delete mode 100644 src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/advanced/websocket/GraphQlWebSocketHandlerFactory.java delete mode 100644 src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/advanced/websocket/GraphQlWebSocketLifecycle.java delete mode 100644 src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/advanced/websocket/GraphQlWebSocketProperties.java delete mode 100644 src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/advanced/websocket/GraphQlWebSocketProtocol.java delete mode 100644 src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/advanced/websocket/GraphQlWebSocketProtocolException.java rename src/adapter/inbound/graphql/src/{test => systemTest}/java/dev/caskeleton/adapter/inbound/graphql/GraphqlHttpBoundaryQualificationTest.java (100%) rename src/adapter/inbound/graphql/src/{test => systemTest}/java/dev/caskeleton/adapter/inbound/graphql/runtime/GraphQlPlatformExecutionPathTest.java (100%) rename src/adapter/inbound/graphql/src/{test => systemTest}/resources/graphql-platform/platform.graphqls (100%) rename src/adapter/inbound/graphql/src/{test => systemTest}/resources/graphql-qualification/qualification.graphqls (100%) delete mode 100644 src/adapter/inbound/graphql/src/test/java/dev/caskeleton/adapter/inbound/graphql/advanced/websocket/GraphQlWebSocketProtocolTest.java create mode 100644 src/adapter/inbound/graphql/src/test/java/dev/caskeleton/adapter/inbound/graphql/error/GraphQlErrorCodeCatalogTest.java create mode 100644 src/adapter/inbound/grpc/src/main/java/dev/caskeleton/adapter/inbound/grpc/GrpcExposedService.java delete mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/advanced/WebAdvancedFeatureFlags.java create mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/advanced/mvc/MvcJsonSequenceConfiguration.java create mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/advanced/mvc/MvcStreamingSupportConfiguration.java create mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/core/OwnsAbsoluteWebRoute.java rename src/{application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer => adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/fileserver/http}/DefaultHttpRangeResolver.java (60%) rename src/{application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/ConditionalRequest.java => adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/fileserver/http/HttpConditionalRequest.java} (61%) rename src/{application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/ContentDispositionFactory.java => adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/fileserver/http/HttpContentDispositionFactory.java} (67%) create mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/fileserver/http/HttpDownloadDecision.java create mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/fileserver/http/HttpDownloadOutcome.java create mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/fileserver/http/HttpDownloadPlanner.java create mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/fileserver/http/HttpDownloadPolicy.java create mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/fileserver/http/HttpRangeNotSatisfiableException.java create mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/fileserver/http/HttpRangePolicy.java create mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/fileserver/http/HttpRangeResolver.java rename src/{application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/ResolvedRanges.java => adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/fileserver/http/HttpResolvedRanges.java} (50%) delete mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/idempotency/DeterministicCommandEncoder.java delete mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/idempotency/FingerprintHeaderPolicy.java delete mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/idempotency/IdempotencyAdmission.java delete mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/idempotency/IdempotencyKey.java delete mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/idempotency/IdempotencyKeySupport.java delete mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/idempotency/IdempotencyResponsePlan.java delete mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/idempotency/SemanticRequestFingerprintFactory.java delete mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/idempotency/WebIdempotencyGate.java create mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/autoconfigure/WebMvcPlatformStartupCheck.java delete mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/idempotency/IdempotentResponseWriter.java delete mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/mvc/idempotency/WebMvcIdempotentInvoker.java create mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/notification/platform/callback/ProviderCallbackHttpRequest.java create mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/notification/platform/callback/ProviderCallbackIngress.java delete mode 100644 src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/webflux/idempotency/WebFluxIdempotentInvoker.java rename src/adapter/inbound/web/src/{test => performanceTest}/java/dev/caskeleton/adapter/inbound/web/testkit/performance/TomcatLoadAndShutdownIT.java (100%) rename src/adapter/inbound/web/src/{test => systemTest}/java/dev/caskeleton/adapter/inbound/web/testkit/budget/TomcatWebBudgetIT.java (100%) rename src/adapter/inbound/web/src/{test => systemTest}/java/dev/caskeleton/adapter/inbound/web/testkit/contract/TomcatContractRecordingIT.java (100%) rename src/adapter/inbound/web/src/{test => systemTest}/java/dev/caskeleton/adapter/inbound/web/testkit/fault/CommitThenConnectionResetIT.java (100%) rename src/adapter/inbound/web/src/{test => systemTest}/java/dev/caskeleton/adapter/inbound/web/testkit/mvc/TomcatWebContractIT.java (100%) rename src/adapter/inbound/web/src/{test => systemTest}/java/dev/caskeleton/adapter/inbound/web/testkit/operation/TomcatOperationHttpIT.java (100%) rename src/adapter/inbound/web/src/{test => systemTest}/java/dev/caskeleton/adapter/inbound/web/testkit/order/MvcPipelineOrderIT.java (100%) rename src/adapter/inbound/web/src/{test => systemTest}/java/dev/caskeleton/adapter/inbound/web/testkit/throttle/TomcatWebThrottleIT.java (100%) create mode 100644 src/adapter/inbound/web/src/test/java/dev/caskeleton/adapter/inbound/web/config/PresentationWebConfigTest.java rename src/{application-core/src/test/java/dev/caskeleton/application/fileserver/api/transfer/ContentDispositionFactoryTest.java => adapter/inbound/web/src/test/java/dev/caskeleton/adapter/inbound/web/fileserver/http/HttpContentDispositionFactoryTest.java} (56%) create mode 100644 src/adapter/inbound/web/src/test/java/dev/caskeleton/adapter/inbound/web/fileserver/http/HttpDownloadPlannerTest.java create mode 100644 src/adapter/inbound/web/src/test/java/dev/caskeleton/adapter/inbound/web/fileserver/http/HttpRangeResolverTest.java delete mode 100644 src/adapter/inbound/web/src/test/java/dev/caskeleton/adapter/inbound/web/idempotency/IdempotencyKeySupportTest.java delete mode 100644 src/adapter/inbound/web/src/test/java/dev/caskeleton/adapter/inbound/web/idempotency/SemanticRequestFingerprintFactoryTest.java delete mode 100644 src/adapter/inbound/web/src/test/java/dev/caskeleton/adapter/inbound/web/idempotency/WebIdempotencyGateTest.java create mode 100644 src/adapter/inbound/web/src/test/java/dev/caskeleton/adapter/inbound/web/mvc/autoconfigure/WebMvcPlatformStartupCheckTest.java create mode 100644 src/adapter/inbound/web/src/test/java/dev/caskeleton/adapter/inbound/web/mvc/error/WebMvcProblemExceptionHandlerActivationTest.java delete mode 100644 src/adapter/inbound/web/src/test/java/dev/caskeleton/adapter/inbound/web/mvc/idempotency/WebMvcIdempotentInvokerTest.java delete mode 100644 src/adapter/inbound/web/src/test/java/dev/caskeleton/adapter/inbound/web/webflux/idempotency/WebFluxIdempotentInvokerTest.java delete mode 100644 src/adapter/inbound/web/src/test/resources/application-web-contract.yaml create mode 100644 src/adapter/inbound/web/src/testFixtures/java/dev/caskeleton/adapter/inbound/web/testkit/arch/WebControllerPredicates.java create mode 100644 src/adapter/inbound/web/src/testFixtures/java/dev/caskeleton/adapter/inbound/web/testkit/fault/FaultFixtureIdempotency.java rename src/adapter/inbound/web/src/{jettyCompatTest => testFixtures}/resources/application-web-contract.yaml (100%) delete mode 100644 src/adapter/inbound/web/src/webfluxContractTest/resources/application-web-contract.yaml create mode 100644 src/adapter/inbound/websocket/src/main/java/dev/caskeleton/adapter/inbound/websocket/advanced/stomp/AdvancedStompSafetyConfiguration.java create mode 100644 src/adapter/inbound/websocket/src/main/java/dev/caskeleton/adapter/inbound/websocket/config/WebSocketPlatformSafetyConfiguration.java rename src/adapter/inbound/websocket/src/{test => systemTest}/java/dev/caskeleton/adapter/inbound/websocket/runtime/TomcatWebSocketAbuseIT.java (100%) rename src/adapter/inbound/websocket/src/{test => systemTest}/java/dev/caskeleton/adapter/inbound/websocket/runtime/TomcatWebSocketRuntimeIT.java (100%) rename src/adapter/inbound/websocket/src/{test => systemTest}/java/dev/caskeleton/adapter/inbound/websocket/stomp/WebSocketBoundaryQualificationTest.java (98%) create mode 100644 src/adapter/inbound/websocket/src/test/java/dev/caskeleton/adapter/inbound/websocket/config/WebSocketEnvironmentBindingTest.java create mode 100644 src/adapter/inbound/websocket/src/test/java/dev/caskeleton/adapter/inbound/websocket/config/WebSocketPlatformSafetyConfigurationTest.java create mode 100644 src/adapter/inbound/websocket/src/test/java/dev/caskeleton/adapter/inbound/websocket/servlet/PlatformWebSocketHandlerBackpressureTest.java create mode 100644 src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/RedisSemanticFailureLogger.java create mode 100644 src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/cache/CacheScripts.java create mode 100644 src/adapter/outbound/cache-redis/src/test/java/dev/caskeleton/adapter/outbound/cache/redis/cache/CacheEnvelopeTest.java create mode 100644 src/adapter/outbound/cache-redis/src/test/java/dev/caskeleton/adapter/outbound/cache/redis/idempotency/IdempotencyScriptsConcurrencyContractTest.java create mode 100644 src/adapter/outbound/cache-redis/src/test/java/dev/caskeleton/adapter/outbound/cache/redis/ratelimit/RedisServerTimeScriptContractTest.java create mode 100644 src/adapter/outbound/cache-redis/src/test/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisScriptLaneCapacityTest.java create mode 100644 src/adapter/outbound/fileserver/src/test/java/dev/caskeleton/adapter/outbound/fileserver/platform/local/SecureDirectoryWalkTest.java create mode 100644 src/adapter/outbound/fileserver/src/test/java/dev/caskeleton/adapter/outbound/fileserver/platform/verification/LocalVerificationContentReaderTest.java create mode 100644 src/adapter/outbound/fileserver/src/test/java/dev/caskeleton/adapter/outbound/fileserver/platform/verification/ScriptableContentPolicyTest.java create mode 100644 src/adapter/outbound/httpclient/src/integrationTest/java/dev/caskeleton/adapter/outbound/httpclient/contract/FailureInjectionContractTest.java rename src/adapter/outbound/httpclient/src/{testFixtures => integrationTest}/java/dev/caskeleton/adapter/outbound/httpclient/testkit/ToxiproxyFixture.java (93%) delete mode 100644 src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/auth/ProxyCredentialProvider.java rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/DynamicTargetAutoConfiguration.java (98%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/HttpClientActuatorEndpoint.java (97%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/HttpClientAuthenticationAutoConfiguration.java (73%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/HttpClientEnvironmentKeys.java (97%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/HttpClientManagementAutoConfiguration.java (92%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/HttpClientObservationAutoConfiguration.java (95%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/HttpClientPlatformAutoConfiguration.java (97%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/HttpClientPlatformSettings.java (95%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/HttpClientPlatformSettingsBinder.java (91%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/HttpClientProfileAutoConfiguration.java (89%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/HttpClientProfileFactory.java (99%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/HttpClientResilienceAutoConfiguration.java (94%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/HttpClientSecurityAutoConfiguration.java (94%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/HttpClientStartupValidator.java (71%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/HttpClientTransportAutoConfiguration.java (97%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/HttpServiceClientAutoConfiguration.java (98%) delete mode 100644 src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/reactor/ValidatedAddressResolverGroup.java create mode 100644 src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/resilience/ReactiveAttemptResiliencePipeline.java create mode 100644 src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/security/PlatformHeaderPropagation.java create mode 100644 src/adapter/outbound/httpclient/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports rename src/{app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/HttpClientAutoConfigurationTest.java (88%) rename src/{app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/HttpClientPlatformActivationTest.java (79%) rename src/{app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/HttpClientPlatformEnvManifestTest.java (97%) rename src/{app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/HttpClientPlatformSettingsTest.java (98%) rename src/{app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/ReactiveAuthenticationContractTest.java (81%) rename src/{app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient => adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure}/UnsafeStartupConfigurationTest.java (98%) delete mode 100644 src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/contract/FailureInjectionContractTest.java create mode 100644 src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/dynamic/DnsPinningSocketPathTest.java create mode 100644 src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/resilience/ResilienceRegistryDefaultsTest.java rename src/adapter/outbound/httpclient/src/{main => testFixtures}/java/dev/caskeleton/adapter/outbound/httpclient/observation/SensitiveValueRedactor.java (100%) create mode 100644 src/adapter/outbound/messaging-kafka/build.gradle create mode 100644 src/adapter/outbound/messaging-kafka/gradle.lockfile rename src/adapter/outbound/{messaging => messaging-kafka}/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/BrokerAddress.java (100%) rename src/adapter/outbound/{messaging => messaging-kafka}/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaAdapterConfig.java (100%) rename src/adapter/outbound/{messaging => messaging-kafka}/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaAdapterSettings.java (100%) rename src/adapter/outbound/{messaging => messaging-kafka}/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaMessageBroker.java (100%) rename src/adapter/outbound/{messaging => messaging-kafka}/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaSender.java (100%) rename src/adapter/outbound/{messaging => messaging-kafka}/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaSenderAutoConfiguration.java (100%) create mode 100644 src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/LegacyKafkaMessagingRootAutoConfiguration.java create mode 100644 src/adapter/outbound/messaging-kafka/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports rename src/adapter/outbound/{messaging => messaging-kafka}/src/test/java/dev/caskeleton/adapter/outbound/messaging/kafka/BrokerAddressTest.java (100%) rename src/adapter/outbound/{messaging => messaging-kafka}/src/test/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaAdapterSettingsTest.java (100%) rename src/adapter/outbound/{messaging => messaging-kafka}/src/test/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaSenderAutoConfigurationOwnershipTest.java (64%) create mode 100644 src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/autoconfigure/MessagingOffAutoConfigurationImportFilterParityTest.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/CompiledNotificationBinding.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationBindingCompiler.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationCanonicalRouteCatalog.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationCatalogException.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationCutoverRouteCatalog.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationPlanAdapter.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationProviderCapabilityCard.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationProviderCapabilityDescriptorSource.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationProviderDescriptor.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationProviderRuntimeProfile.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationRouteDescriptor.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationTemplateDescriptor.java create mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationCallbackProviderConfig.java rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/observation => adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure}/NotificationHealthEndpoint.java (95%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/observation => adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure}/NotificationObservationContext.java (96%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/observation => adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure}/NotificationObservationConvention.java (97%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification => adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure}/NotificationPlatformCodecConfig.java (96%) create mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformCoreConfig.java create mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformDispatchConfig.java rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification => adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure}/NotificationPlatformObservabilityConfig.java (89%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification => adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure}/NotificationPlatformPolicyConfig.java (98%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification => adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure}/NotificationPlatformProviderConfig.java (82%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification => adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure}/NotificationPlatformRegistriesConfig.java (50%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification => adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure}/NotificationPlatformRuntimeConfig.java (90%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification => adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure}/NotificationPlatformSecretsConfig.java (90%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification => adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure}/NotificationPlatformWorkerConfig.java (98%) create mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationSesProviderConfig.java create mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/ProviderCallbackAssembler.java create mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/SesProviderCallbackAssembler.java create mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/SesProviderRuntimeAssembler.java rename src/{application-core/src/main/java/dev/caskeleton/application => adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound}/notification/platform/callback/CallbackLimits.java (53%) rename src/{application-core/src/main/java/dev/caskeleton/application => adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound}/notification/platform/callback/CallbackVerificationResult.java (79%) create mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/ProviderCallbackAdapter.java create mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/ProviderCallbackAdapterRegistry.java rename src/{application-core/src/main/java/dev/caskeleton/application/notification/platform/api/CallbackRequest.java => adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/ProviderCallbackVerificationRequest.java} (68%) create mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/VerifiedCallback.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/AttemptCorrelationId.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/InlineNotificationAttemptAdapter.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationAdmissionReadinessAdapter.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationAttemptContext.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderAttemptAdapter.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderAttemptClient.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderRateAdmission.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderReadinessProbe.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderReadinessSnapshot.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderSecretMaterialProvider.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationReconciliationAdapter.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationSecretMaterialHandle.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/PreparedNotificationAttempt.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/ProviderMessageReference.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/ReconciliationLookupMode.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/LocalEmailRenderer.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/NotificationTemplateCatalog.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/NotificationTemplateManifest.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/NotificationTemplateRenderer.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/RenderedNotification.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/SlackBlockKitRenderer.java delete mode 100644 src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/TemplateRenderingException.java create mode 100644 src/adapter/outbound/notification/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports delete mode 100644 src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationBindingCompilerTest.java delete mode 100644 src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationCanonicalRouteCatalogTest.java delete mode 100644 src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationCutoverRouteCatalogTest.java rename src/{app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification => adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure}/NotificationLegacyNamespaceRetirementTest.java (87%) rename src/{app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification => adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure}/NotificationModeSsotTest.java (96%) rename src/{app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/observation => adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure}/NotificationObservationTest.java (99%) rename src/{app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification => adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure}/NotificationPayloadAtRestContractTest.java (98%) create mode 100644 src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformCoreConfigurationTest.java rename src/{app-bootstrap/src/test/java/dev/caskeleton/bootstrap/activation/NotificationRootImportCoverageTest.java => adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformImportCoverageTest.java} (65%) create mode 100644 src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformReachabilityTest.java rename src/{app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification => adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure}/NotificationSecretsValidationTest.java (98%) create mode 100644 src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationSmtpTransportConfigurationTest.java rename src/{app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification => adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure}/NotificationWorkerLifecycleTest.java (98%) create mode 100644 src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/SesProviderRuntimeAssemblerTest.java create mode 100644 src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/http/JdkNotificationHttpGatewaySecurityTest.java delete mode 100644 src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/provider/InlineNotificationAttemptAdapterTest.java delete mode 100644 src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationAdmissionReadinessAdapterTest.java delete mode 100644 src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderAttemptContractTest.java delete mode 100644 src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationReconciliationAdapterTest.java delete mode 100644 src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationSecretMaterialHandleTest.java delete mode 100644 src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/template/NotificationTemplateRendererTest.java rename src/adapter/outbound/objectstorage/src/{test => integrationTest}/java/dev/caskeleton/adapter/outbound/objectstorage/S3ObjectStorageAdapterIT.java (100%) rename src/adapter/outbound/objectstorage/src/{objectStorageMinioContractTest => integrationTest}/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/MinioManagedObjectContractTest.java (100%) rename src/adapter/outbound/objectstorage/src/{objectStorageMinioFaultTest => integrationTest}/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/MinioManagedObjectFaultTest.java (100%) create mode 100644 src/adapter/outbound/objectstorage/src/integrationTest/resources/object-storage/minio-provider-evidence.json create mode 100644 src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/direct/DirectGrantReplayCache.java create mode 100644 src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/readiness/ObjectStorageDeploymentReadiness.java create mode 100644 src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageEnvManifestTest.java create mode 100644 src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/direct/DirectGrantReplayCacheTest.java rename src/adapter/outbound/objectstorage/src/{objectStorageMinioContractTest => test}/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/MinioDirectTransferContractTest.java (100%) rename src/adapter/outbound/objectstorage/src/{objectStorageMinioFaultTest => test}/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/MinioDirectTransferFaultTest.java (100%) delete mode 100644 src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/auditing/AuditMetadata.java delete mode 100644 src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/auditing/JpaAuditingConfiguration.java delete mode 100644 src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/auditing/JpaAuditorProvider.java rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa => adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure}/JpaObservabilityAutoConfiguration.java (94%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa => adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure}/JpaTransactionAutoConfiguration.java (97%) create mode 100644 src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PersistenceJpaAutoConfiguration.java create mode 100644 src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PersistenceJpaRuntimeConfig.java create mode 100644 src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PostgreSqlIdempotencyStoreConfig.java create mode 100644 src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/h2/H2FailureTranslator.java create mode 100644 src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/AdminOperationResultPayloadCodec.java create mode 100644 src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/outbox/CanonicalOutboxEventRowMapper.java create mode 100644 src/adapter/outbound/persistence-jpa/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports create mode 100644 src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/jpa/outbox-polling/V2__widen_canonical_event_id.sql create mode 100644 src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/jpa/outbox-storage/V2__canonical_envelope_alignment.sql create mode 100644 src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/postgresql/V14__validate_outbox_canonical_constraints.sql create mode 100644 src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/postgresql/V15__live_event_stream_position.sql delete mode 100644 src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/platform/JpaAuditingContractTest.java create mode 100644 src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/CanonicalOutboxV2TestFixture.java create mode 100644 src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/LegacyOutboxDrainContractTest.java rename src/{app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/outbox/OutboxContainerTestSupport.java => adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/LegacyOutboxIntegrationSupport.java} (87%) create mode 100644 src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlDistributedLockIntegrationTest.java rename src/{app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/IdempotencyUniqueScopeContractTest.java => adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlIdempotencyUniqueScopeIntegrationTest.java} (75%) rename src/{app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/FlywayMigrationCompatibilityContractTest.java => adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlIntLockMigrationCompatibilityIntegrationTest.java} (67%) create mode 100644 src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlLegacyOutboxAppendTransactionalIntegrationTest.java rename src/{app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/outbox/OutboxPublisherLeaderElectionContractTest.java => adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlLegacyOutboxConcurrentRelayIntegrationTest.java} (83%) rename src/{app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/outbox/OutboxRowLifecycleContractTest.java => adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlLegacyOutboxRowLifecycleIntegrationTest.java} (92%) delete mode 100644 src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/auditing/AuditingCandidateStatusTest.java create mode 100644 src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PersistenceJpaAutoConfigurationTest.java create mode 100644 src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PersistenceJpaRuntimeConfigTest.java create mode 100644 src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PostgreSqlIdempotencyStoreConfigTest.java create mode 100644 src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/config/JpaAdapterComponentsConfigTest.java create mode 100644 src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/h2/H2FailureTranslatorTest.java create mode 100644 src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/hibernate/batch/HibernateJpaBatchExecutorTest.java create mode 100644 src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/idempotency/IdempotencyActivationContractTest.java create mode 100644 src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/liveevent/JpaLiveEventReplayAdapterActivationTest.java create mode 100644 src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/lock/DistributedLockPersistenceConfigTest.java create mode 100644 src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/migration/OutboxStorageMigrationSafetyTest.java create mode 100644 src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/migration/PostgreSqlConstraintMigrationSafetyTest.java create mode 100644 src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/notification/configuration/NotificationSchemaActivationLifecycleTest.java create mode 100644 src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/RecipientClaimSqlTest.java create mode 100644 src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxMasterSwitchWiringContractTest.java create mode 100644 src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/postgresql/inbox/PostgreSqlInboxTransitionDigestTest.java create mode 100644 src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/postgresql/outbox/PostgreSqlOutboxTransitionDigestTest.java create mode 100644 src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/transaction/PersistenceTransactionOwnershipTest.java delete mode 100644 src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/postgresql/PostgreSqlContractExtension.java create mode 100644 src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/MongoPlatformHealthConfiguration.java create mode 100644 src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/MongoPlatformHealthContributor.java create mode 100644 src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/client/MongoProfileClientSettingsAutoConfiguration.java rename src/adapter/outbound/persistence-mongo/src/{test => mongoIntegrationTest}/java/dev/caskeleton/adapter/outbound/mongo/compat/MongoVersionCompatibilityLaneTest.java (100%) rename src/adapter/outbound/persistence-mongo/src/{test => mongoIntegrationTest}/java/dev/caskeleton/adapter/outbound/mongo/failure/MongoNetworkFaultLaneTest.java (100%) rename src/adapter/outbound/persistence-mongo/src/{test => mongoIntegrationTest}/java/dev/caskeleton/adapter/outbound/mongo/migration/MongoMigrationLaneTest.java (100%) rename src/adapter/outbound/persistence-mongo/src/{test => mongoIntegrationTest}/java/dev/caskeleton/adapter/outbound/mongo/rs/MongoSingleReplicaSetContainerTest.java (100%) rename src/adapter/outbound/persistence-mongo/src/{test => mongoIntegrationTest}/java/dev/caskeleton/adapter/outbound/mongo/rs/MongoThreeNodeReplicaSetTest.java (100%) rename src/adapter/outbound/persistence-mongo/src/{test => mongoIntegrationTest}/java/dev/caskeleton/adapter/outbound/mongo/security/MongoSecurityIntegrationLaneTest.java (100%) rename src/adapter/outbound/persistence-mongo/src/{test => mongoIntegrationTest}/java/dev/caskeleton/adapter/outbound/mongo/security/MongoTlsLaneTest.java (94%) rename src/adapter/outbound/persistence-mongo/src/{testFixtures => mongoProviderTestkit}/java/dev/caskeleton/adapter/outbound/mongo/testkit/atlas/MongoAtlasLocalContainer.java (100%) rename src/adapter/outbound/persistence-mongo/src/{testFixtures => mongoProviderTestkit}/java/dev/caskeleton/adapter/outbound/mongo/testkit/failover/MongoProxiedReplicaSetNode.java (100%) rename src/adapter/outbound/persistence-mongo/src/{testFixtures => mongoProviderTestkit}/java/dev/caskeleton/adapter/outbound/mongo/testkit/failover/MongoThreeNodeReplicaSet.java (100%) rename src/adapter/outbound/persistence-mongo/src/{testFixtures => mongoProviderTestkit}/java/dev/caskeleton/adapter/outbound/mongo/testkit/failover/ToxiproxyMongoNetworkFaultController.java (100%) rename src/adapter/outbound/persistence-mongo/src/{testFixtures => mongoProviderTestkit}/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoAuthenticatedReplicaSetContainer.java (100%) rename src/adapter/outbound/persistence-mongo/src/{testFixtures => mongoProviderTestkit}/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoReplicaSetFixture.java (100%) rename src/adapter/outbound/persistence-mongo/src/{testFixtures => mongoProviderTestkit}/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoSingleReplicaSetContainer.java (100%) rename src/adapter/outbound/persistence-mongo/src/{testFixtures => mongoProviderTestkit}/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoTlsReplicaSetContainer.java (88%) create mode 100644 src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/MongoPlatformHealthContributorTest.java create mode 100644 src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/client/MongoProfileClientSettingsAutoConfigurationTest.java create mode 100644 src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/imperative/DefaultMongoImperativeExecutorDeadlineTest.java create mode 100644 src/adapter/outbound/redis-runtime/build.gradle create mode 100644 src/adapter/outbound/redis-runtime/gradle.lockfile rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisDeploymentMode.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisVersion.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/CommandAccess.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/CommandId.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/CommandSupport.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/KeySpec.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/PersistentKeyPermit.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/RedisCommandDescriptor.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/RedisRiskLevel.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/TimeoutProfile.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisCommandRejectedException.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisFailureMetadata.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisOperationException.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisKeyRules.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisNamespace.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BitFieldOverflow.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BitFieldSubcommand.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BitmapOperation.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/Distance.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/DistanceUnit.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/Expiration.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ExpirationCondition.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/GeoPoint.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/GeoSearchRequest.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/LexRange.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ListSide.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/LongRange.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PageRequest.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ScoreRange.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/SortDirection.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/SortedSetAddOptions.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamAppendOptions.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamDeletionOutcome.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamDeletionPolicy.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamId.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamTrimPolicy.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/RedisSlotCalculator.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisCorrectnessRoles.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisCredentialResolver.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisHealthContributor.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisSdkAutoConfiguration.java (99%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisSdkSettings.java (97%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisConnectionKind.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisCredentialRole.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisLease.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisRuntimeClient.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisRuntimeOwner.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisTopologyClientFactory.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/GeoSearchHit.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/HashScanPage.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/KeyScanPage.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/KeyedElement.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisCommandGateway.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/MemberScanPage.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisCommandGateway.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisPubSubGateway.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/ScoredMemberPage.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamClaimPage.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamEntry.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamPendingEntry.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamPendingOverview.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/WritePresence.java (100%) rename src/adapter/outbound/{cache-redis => redis-runtime}/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports (100%) create mode 100644 src/adapter/outbound/redis-sdk/build.gradle create mode 100644 src/adapter/outbound/redis-sdk/gradle.lockfile rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/admin/ClientSummary.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/admin/LettuceRedisAdminOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/admin/RedisAdminOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/admin/SlowLogEntry.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/ReactiveRedisOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisCapabilities.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisCapability.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/codec/RedisCodec.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/codec/RedisEnvelope.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/codec/RedisPayloadCodec.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/AdvancedOperationPermit.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/MultiKeyPermit.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/OperationBudget.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/RedisPermitVerifier.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/RedisPolicyAuthority.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisAccessDeniedException.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisAmbiguousExecutionException.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisBusyException.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisCapabilityUnavailableException.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisConnectionException.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisCrossSlotException.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisDataTypeMismatchException.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisNoScriptException.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisRedirectionException.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisSerializationException.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisTimeoutException.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/BitmapKey.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/GeoKey.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/HashKey.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/HyperLogLogKey.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/ListKey.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/QualifiedRedisKey.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisKeyName.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisKeyRenderer.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisSlotTag.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisTypedKey.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/SetKey.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/SortedSetKey.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/StreamKey.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/TypedRedisKeys.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/ValueKey.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BatchItemResult.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BatchOptions.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BitFieldResult.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ClaimResult.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ExpirationResult.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ExpirationUpdatePolicy.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/GeoLocation.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/GeoSearchResult.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/KeyedValue.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PendingQuery.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PendingRecord.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PendingSummary.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PubSubChannel.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PubSubPattern.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RankRange.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBatch.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBatchOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBatchResult.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBitFieldOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBitmapOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBlockingListOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBlockingStreamOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisDataType.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisGeoOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisHashFieldExpirationOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisHashOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisHyperLogLogOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisKeyOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisListOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisMessageHandler.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisPubSubOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisSetOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisShardedPubSubOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisSortedSetOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisStreamDeletionOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisStreamOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisValueOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RenameMode.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ScanPage.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ScanRequest.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ScoredValue.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ShardedPubSubChannel.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamConsumer.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamGroup.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamRange.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamReadOffset.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamRecord.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/Subscription.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBatchOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBitFieldOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBitmapOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBlockingListOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBlockingStreamOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisGeoOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisHashFieldExpirationOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisHashOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisHyperLogLogOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisKeyOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisListOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisPubSubOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisSetOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisShardedPubSubOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisSortedSetOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisStreamOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisValueOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/ClusterRedirect.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/ClusterScanCursor.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/ClusterTopologyObserver.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/SameSlotValidator.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/ConfiguredRedisPermitVerifier.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/ConfiguredRedisPolicyAuthority.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/GrantedAdvancedOperationPermit.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/GrantedMultiKeyPermit.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/GrantedPersistentKeyPermit.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisCapabilityProbe.java (98%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisStartupProbe.java (83%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/ExtensionCommandRunner.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/json/JsonPath.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/json/LettuceRedisJsonOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/json/RedisJsonOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/probabilistic/LettuceRedisProbabilisticOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/probabilistic/RedisProbabilisticOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/LettuceRedisSearchOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/RedisSearchOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchField.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchFieldType.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchHit.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchIndex.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchQuery.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/timeseries/LettuceRedisTimeSeriesOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/timeseries/RedisTimeSeriesOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/timeseries/TimeSeriesAggregation.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/timeseries/TimeSeriesSample.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/ByteArrayCodec.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/DoubleCodec.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/JsonEnvelopeFraming.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/LongCodec.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/RedisCodecRegistry.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/Utf8StringCodec.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/VersionedJsonCodec.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/CommandAdmission.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/CommandExecutionContext.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/CommandPolicyGuard.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/CommandRequest.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/ExecutionCertainty.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/LettuceExceptionTranslator.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/QueueingRedisCommandExecutor.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/ReactiveRedisCommandExecutor.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisCommandCatalog.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisCommandMetadataDiff.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisCommandPolicy.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisCommandPolicyLoader.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisServerCommandMetadata.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/SyncRedisCommandExecutor.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisConnectionLease.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisConnectionRegistry.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/SentinelFailoverObserver.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/observability/NoThrowObservationSink.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/observability/RedisObservation.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/AtomicCounterScripts.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/BatchExecution.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/BitmapOperationRequests.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/GeoOperationRequests.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/HashOperationRequests.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/HyperLogLogOperationRequests.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/KeyOperationRequests.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBatchOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBitFieldOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBitmapOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBlockingListOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBlockingStreamOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisGeoOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisHashFieldExpirationOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisHashOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisHyperLogLogOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisKeyOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisListOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisPubSubOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisSetOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisShardedPubSubOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisSortedSetOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisStreamOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisValueOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBatch.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBatchOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBitFieldOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBitmapOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBlockingListOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBlockingStreamOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisGeoOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisHashFieldExpirationOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisHashOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisHyperLogLogOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisKeyOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisListOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisPubSubOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisSetOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisShardedPubSubOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisSortedSetOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisStreamDeletionOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisStreamOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisValueOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/ListOperationRequests.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LiveSubscription.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/PubSubOperationRequests.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisOperationContext.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisOperationLimits.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/SetOperationRequests.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/SortedSetOperationRequests.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamOperationRequests.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/SubscriptionFlux.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/ValueOperationRequests.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/LettuceRedisFunctionOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/LettuceRedisScriptOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/LettuceRedisTransactionOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/QueuedReply.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisArgument.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisFunctionOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisResultDecoder.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisScriptOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisScriptRegistry.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisTransactionCallback.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisTransactionOperations.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisTransactionQueue.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisTransactionRunner.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RegisteredRedisFunction.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RegisteredRedisScript.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/TransactionOptions.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/TransactionResult.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/ApprovedRawCommand.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/LettuceRedisRawGateway.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RawCommandApprovals.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RawCommandPolicyToken.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RawMovableKeys.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RawReplyDecoder.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RedisRawGateway.java (100%) rename src/adapter/outbound/{cache-redis => redis-sdk}/src/main/resources/redis-sdk/redis-command-policy.yml (100%) create mode 100644 src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/CapabilityStartupValidationException.java rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime => adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support}/EnvironmentSecretSource.java (59%) rename src/{app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure => adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support}/StrictSettingsBinder.java (95%) create mode 100644 src/adapter/outbound/support/src/test/java/dev/caskeleton/adapter/outbound/support/CapabilityStartupValidationExceptionTest.java create mode 100644 src/adapter/outbound/support/src/test/java/dev/caskeleton/adapter/outbound/support/EnvironmentSecretSourceTest.java create mode 100644 src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/FileserverCompositionArchitectureTest.java create mode 100644 src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/RuntimeProfileAccessArchitectureTest.java rename src/app-bootstrap/src/{conditionalTransportTest/java/dev/caskeleton/bootstrap/transport/ConditionalTransportCompositionContractTest.java => conditionalTransportBuildContractTest/java/dev/caskeleton/bootstrap/transport/ConditionalTransportBuildContractTest.java} (81%) delete mode 100644 src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/DistributedLockProviderContractTest.java rename src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/fileserver/{FileserverRoundTripContractTest.java => FileserverCompositionIntegrationTest.java} (86%) create mode 100644 src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/objectstorage/ObjectStorageCompositionIntegrationTest.java delete mode 100644 src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/outbox/OutboxAppendTransactionalContractTest.java delete mode 100644 src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/outbox/package-info.java create mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/common/BootstrapClockAutoConfiguration.java create mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverCorePolicyConfiguration.java create mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverDownloadLifecycleConfiguration.java create mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverHttpDownloadConfiguration.java create mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverLocalStorageCoreConfiguration.java create mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverMaintenanceServiceConfiguration.java create mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverMetricsSupport.java create mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverNginxConfiguration.java create mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverObservabilityConfiguration.java create mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverProtocolConfiguration.java create mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverStorageGatewayConfiguration.java create mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverStorageOperationsConfiguration.java create mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverUploadServiceConfiguration.java create mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverVerificationConfiguration.java create mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverWebAssemblyConfiguration.java rename src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/{runtime/startup => autoconfigure/jpa}/MigrationStartupConfig.java (86%) delete mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/mongo/MongoPlatformHealthConfig.java delete mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/mongo/MongoPlatformHealthContributor.java rename src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/{NotificationPlatformDispatchConfig.java => NotificationApplicationCompositionAutoConfiguration.java} (70%) delete mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationRootAutoConfiguration.java create mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/ProviderCallbackIngressBridge.java create mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisSemanticScriptAclProbe.java create mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/RuntimeProfileSnapshot.java delete mode 100644 src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/SecretSource.java rename src/app-bootstrap/src/{test => systemTest}/java/dev/caskeleton/bootstrap/activation/AdapterActivationInventory.java (100%) create mode 100644 src/app-bootstrap/src/systemTest/java/dev/caskeleton/bootstrap/activation/BootstrapCapabilityReachabilitySystemTest.java create mode 100644 src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/common/BootstrapClockAutoConfigurationTest.java create mode 100644 src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderSettingsTest.java create mode 100644 src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyShippedAutoConfigurationTest.java create mode 100644 src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/jpa/DataSourceRequirementTest.java create mode 100644 src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/jpa/PersistenceJpaRootAutoConfigurationOrderingTest.java create mode 100644 src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/lock/DistributedLockConfigTest.java delete mode 100644 src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/mongo/MongoPlatformHealthContributorTest.java delete mode 100644 src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformReachabilityTest.java create mode 100644 src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/ProviderCallbackIngressBridgeTest.java create mode 100644 src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisSemanticScriptAclProbeTest.java create mode 100644 src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/AutoConfigurationReachabilityParityTest.java create mode 100644 src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/BootstrapCapabilityAutoConfigurationReachabilityTest.java create mode 100644 src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/HeaderRegistryRuntimeAlignmentTest.java create mode 100644 src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/MongoShippedCompositionContractTest.java create mode 100644 src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/RuntimeProfileLoggingContractTest.java create mode 100644 src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/BootstrapStructuredRuntimeLoggingTest.java create mode 100644 src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/RuntimeProfileSnapshotTest.java create mode 100644 src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/startup/StartupOrderContractTest.java create mode 100644 src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/settings/WebJsonMapperCompositionTest.java delete mode 100644 src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/RangeNotSatisfiableException.java delete mode 100644 src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/ConditionalRequestEvaluator.java delete mode 100644 src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/DefaultConditionalRequestEvaluator.java delete mode 100644 src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/DownloadDecision.java delete mode 100644 src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/FileRepresentation.java delete mode 100644 src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/HttpRangeResolver.java delete mode 100644 src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/RangeBudget.java delete mode 100644 src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/UploadProtocol.java delete mode 100644 src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/DownloadDescriptor.java delete mode 100644 src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/DownloadPolicy.java delete mode 100644 src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/DownloadRequest.java delete mode 100644 src/application-core/src/main/java/dev/caskeleton/application/notification/Channel.java delete mode 100644 src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/IngestProviderCallbackApplicationUseCase.java delete mode 100644 src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderCallbackAdapter.java delete mode 100644 src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderCallbackAdapterRegistry.java delete mode 100644 src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/VerifiedCallback.java delete mode 100644 src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/IngestProviderCallbackCommand.java delete mode 100644 src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/IngestProviderCallbackUseCase.java create mode 100644 src/application-core/src/main/java/dev/caskeleton/application/outbound/SecretSourcePort.java create mode 100644 src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/OutboxPublicationAdmissionPort.java create mode 100644 src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/OutboxV2RetryPolicy.java create mode 100644 src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/PublishNextOutboxDeliveryCommand.java create mode 100644 src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/PublishNextOutboxDeliveryResult.java create mode 100644 src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/PublishNextOutboxDeliveryUseCase.java delete mode 100644 src/application-core/src/main/java/dev/caskeleton/application/transaction/IrreversibleSideEffectContext.java delete mode 100644 src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/transfer/ConditionalRequestEvaluatorTest.java delete mode 100644 src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/transfer/HttpRangeResolverTest.java delete mode 100644 src/application-core/src/test/java/dev/caskeleton/application/fileserver/download/DownloadApplicationServiceTest.java delete mode 100644 src/application-core/src/test/java/dev/caskeleton/application/notification/platform/callback/CallbackIngestionAtomicityTest.java create mode 100644 src/application-core/src/test/java/dev/caskeleton/application/testsupport/CompiledPackageScanner.java create mode 100644 src/application-core/src/testFixtures/java/dev/caskeleton/application/outbox/testkit/LegacyOutboxAppendContract.java create mode 100644 src/application-fileserver/build.gradle create mode 100644 src/application-fileserver/gradle.lockfile rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/admin/AdminAuditPort.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/admin/AdminAuditRecord.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/admin/ContentReferenceLedger.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/admin/DefaultFileserverAdminService.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/admin/FileserverAdminService.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/admin/ForceDeleteCommand.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/admin/IncompleteUploadView.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/admin/OrphanObject.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/admin/OrphanReconcileCommand.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/admin/OrphanReconcileReport.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/admin/OrphanScanPort.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/admin/RuntimeCapabilityReport.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/admin/StorageHealthPort.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/admin/StorageHealthReport.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/ByteRange.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/ContentKey.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/DefaultFileStateMachine.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/FileId.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/FileState.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/FileStateMachine.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/StorageNamespace.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/UploadId.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/content/AppendResult.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/content/AsyncContentStore.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/content/BlockingContentStore.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/content/CapacityAwareContentStore.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/content/ContentMetadata.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/content/ContentStoreCapabilities.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/content/CopyCapableContentStore.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/content/CopyPrecondition.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/content/CreateContentCommand.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/content/DelegatedDownloadDescriptor.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/content/DelegatedDownloadStore.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/content/DeletePrecondition.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/content/DeleteResult.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/content/FinalizeContentCommand.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/content/PublishMode.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/content/StorageCapacity.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/content/StoredContent.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/content/UploadHandle.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/content/WriteFence.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/AmbiguousCompletionException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/AtomicPublishUnsupportedException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/ConcurrentFileModificationException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/FileAccessDeniedException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/FileAlreadyExistsException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/FileNotFoundException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/FileNotReadyException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/FileTooLargeException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/FileserverErrorCode.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/FileserverException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/FileserverFailureContext.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/IntegrityMismatchException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/InvalidPathException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/MalformedRequestException.java (79%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/MalwareDetectedException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/PartialWriteException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/PathOutsideNamespaceException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/QuotaExceededException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/StorageFullException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/StorageUnavailableException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/TransferAdmissionRejectedException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/TransferTimeoutException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/UnsupportedMediaTypeException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/UploadExpiredException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/error/UploadOffsetMismatchException.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileDescriptor.java (76%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileMetadataStore.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileQuotaService.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecord.java (95%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecordDraft.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecordMutation.java (62%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecoveryQuery.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/metadata/QuotaReservation.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/metadata/QuotaReservationStatus.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/metadata/QuotaScope.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/metadata/UploadSession.java (96%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/metadata/UploadSessionDraft.java (89%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/metadata/UploadSessionStore.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/metadata/WriterLease.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/security/FileAccessPolicy.java (52%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/security/FileAccessSubject.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/security/FileOperation.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/security/FileVerifier.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/security/OriginalFilenamePolicy.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/security/RequestContext.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/security/SanitizedFilename.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/security/VerificationRequest.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/security/VerificationResult.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/api/security/VerificationVerdict.java (100%) create mode 100644 src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/transfer/FileRepresentation.java create mode 100644 src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/transfer/UploadMode.java rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupBatchResult.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupContentGateway.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupItem.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupQueue.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupRequest.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupService.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupType.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/cleanup/DefaultCleanupService.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/cleanup/QuotaReclaimGateway.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/concurrency/DefaultWriterLeaseCoordinator.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/concurrency/LeaseFence.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/concurrency/LeaseHeartbeat.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/concurrency/WriterLeaseCoordinator.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/download/DefaultDownloadApplicationService.java (58%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/download/DownloadApplicationService.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/download/DownloadContentGateway.java (100%) create mode 100644 src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/download/DownloadDescriptor.java create mode 100644 src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/download/DownloadRequest.java rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/download/ZeroCopyDownloadGateway.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/download/ZeroCopyTransferResult.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/lifecycle/CopyContentGateway.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/lifecycle/CopyFileCommand.java (67%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/lifecycle/DefaultFileLifecycleService.java (90%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/lifecycle/DeleteOutcome.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/lifecycle/FileLifecycleService.java (86%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverAuditEvent.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverAuditPort.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverMetricsPort.java (93%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverSpans.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/observability/NoopFileserverMetrics.java (93%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/observability/SafeFileFingerprint.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/observability/SizeBucket.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/observability/TransferDirection.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/quota/DefaultTransferAdmissionController.java (82%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/quota/StorageUsageProbe.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/quota/TransferAdmissionController.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/quota/TransferAdmissionProperties.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/quota/TransferPermit.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/recovery/DefaultFileReconciliationService.java (99%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/recovery/FileReconciliationService.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/recovery/ProbeOutcome.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/recovery/ReconciliationContentProbe.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/recovery/ReconciliationResult.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/recovery/ReconciliationStatus.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/recovery/RecoveryQueue.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/recovery/StagingUploadLocator.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/upload/AppendUploadResult.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/upload/CreateUploadRequest.java (92%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultFinalizeUploadService.java (96%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultSingleShotUploadService.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultUploadApplicationService.java (95%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/upload/FileVerificationService.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/upload/FileView.java (100%) create mode 100644 src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/FileserverCompensationTransaction.java rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/upload/FinalizeUploadRequest.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/upload/FinalizeUploadService.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/upload/QuotaCommitGateway.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/upload/SingleShotUploadService.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/upload/UploadApplicationService.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/upload/UploadContentGateway.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/upload/UploadIdentifierFactory.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/upload/UploadPolicy.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/upload/UploadSessionView.java (100%) rename src/{application-core => application-fileserver}/src/main/java/dev/caskeleton/application/fileserver/upload/UploadStorageGateway.java (100%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/admin/FileserverAdminServiceTest.java (100%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/api/FileStateMachineTest.java (100%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/api/ValueObjectTest.java (100%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/api/content/ContentStoreApiArchitectureTest.java (100%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/api/error/FileserverExceptionTest.java (94%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/api/metadata/MetadataPortContractTest.java (95%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/api/security/OriginalFilenamePolicyTest.java (100%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/cleanup/CleanupServiceTest.java (98%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/concurrency/MultiInstanceWriterLeaseTest.java (99%) create mode 100644 src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/download/DownloadApplicationServiceTest.java rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/lifecycle/FileLifecycleServiceTest.java (99%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/observability/FileserverObservabilityTest.java (97%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/quota/TransferAdmissionControllerTest.java (84%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/recovery/FileReconciliationServiceTest.java (99%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/testkit/DirectTransactions.java (72%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeAdminPorts.java (100%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeCleanupContentGateway.java (100%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeCopyContentGateway.java (100%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeDownloadContentGateway.java (100%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeFileAccessPolicy.java (100%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeFileQuotaService.java (100%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeQuotaCommitGateway.java (100%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeReconciliationContentProbe.java (100%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeUploadContentGateway.java (100%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeUploadStorageGateway.java (100%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/testkit/FileserverFixtures.java (98%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryCleanupQueue.java (100%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryFileMetadataStore.java (98%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryRecoveryQueue.java (100%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryUploadSessionStore.java (98%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/testkit/ReadyFileFixture.java (94%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/testkit/RecordingQuotaReclaimGateway.java (100%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/testkit/SequentialUploadIdentifierFactory.java (100%) create mode 100644 src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/upload/DefaultSingleShotUploadServiceTest.java create mode 100644 src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/upload/FileserverCompensationTransactionTest.java rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/upload/FinalizeUploadServiceTest.java (96%) rename src/{application-core => application-fileserver}/src/test/java/dev/caskeleton/application/fileserver/upload/UploadApplicationServiceTest.java (96%) create mode 100644 src/application-notification/build.gradle create mode 100644 src/application-notification/gradle.lockfile rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/ApplyNotificationReceiptCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/ApplyNotificationReceiptResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/ApplyNotificationReceiptUseCase.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/ConsentCheckMode.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/EmailRecipientReference.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesOperation.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesUseCase.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/InlineNotificationAttemptPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NormalizedNotificationReceiptCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/Notification.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationAdmissionClass.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationAdmissionGateCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationAdmissionGateUseCase.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationAdmissionReadinessPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationAppendResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationApplicationException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationAttemptId.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationCanonicalWriterFenceGuard.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationCanonicalWriterFencePort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationCanonicalWriterRouteSet.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationCapabilityCompatibilityValidator.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationChannel.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationDeliveryId.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationDeliveryStorePort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationDispatchCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationDispatchResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationDispatchUseCase.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationEvidenceTrustSnapshot.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationFaultScope.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationFrozenPlan.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationIntentAppendPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationIntentDraft.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationIntentId.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationKindId.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationKindPolicy.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationLegacyWriterPermitCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationLegacyWriterPermitResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationLegacyWriterPermitUseCase.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationMaintenanceCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationMaintenanceResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationMaintenanceStorePort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationMaintenanceUseCase.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationMode.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationOperationsSnapshot.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationOperationsSnapshotPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationOperationsSnapshotQuery.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationOperationsSnapshotUseCase.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationPlanPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationPlanningResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationPort.java (85%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationProviderAttemptPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationProviderCapabilityDescriptor.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationReasonCode.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationReceiptEventId.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationReceiptFact.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationReceiptIngressCapabilityDescriptor.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationReceiptProjection.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationReceiptStorePort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationRecipientReference.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationReconciliationPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationRequestResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationRouteId.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationRouteStrategy.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationSignedEvidenceHeader.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationStoreCapabilityDescriptor.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationTechnicalSuppressionPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationTemplateParameters.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationTemplateRef.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationTemplateValue.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationWriterCutoverPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationWriterInventoryEvidence.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationWriterInventoryEvidenceVerifierPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationWriterOwnership.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationWriterQuiescenceAttestationPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/NotificationWriterRouteSet.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/ProviderAttemptOutcome.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/ReconcileNotificationDeliveriesCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/ReconcileNotificationDeliveriesResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/ReconcileNotificationDeliveriesUseCase.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationOperation.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationUseCase.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/RetryDisposition.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/SignedNotificationWriterInventoryManifest.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/SignedNotificationWriterQuiescenceManifest.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/SlackAudienceReference.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/SubmissionCertainty.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipOperation.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipUseCase.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/TargetAttemptOutcome.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsOperation.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsUseCase.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminAccessDeniedException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminActor.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminAuthorizationGuard.java (73%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationClaim.java (100%) create mode 100644 src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationCommandFingerprint.java create mode 100644 src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationConflictException.java create mode 100644 src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationExecutor.java create mode 100644 src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationInProgressException.java rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationStorePort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/admin/DuplicateRiskApprovalRequiredException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/admin/DuplicateRiskGuard.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminApplicationService.java (74%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminAuthority.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminService.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/admin/ProviderRuntimeControlPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/admin/ReconcileCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/admin/RedriveCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/admin/SetProviderStateCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/admin/SuppressCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/CallbackIngestionResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/CancelCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/CancelResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/ChannelPreferenceOverride.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/CollapseScope.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/CollapseSpec.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/ContactPointId.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/ContactPointSelector.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/CorrelationId.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/DeduplicationAction.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/DeduplicationSpec.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/DeliveryAttemptId.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/EncodedNotificationPlan.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/IdempotencyKey.java (100%) rename src/{application-core/src/main/java/dev/caskeleton/application/notification/platform/callback => application-notification/src/main/java/dev/caskeleton/application/notification/platform/api}/NormalizedEventType.java (88%) rename src/{application-core/src/main/java/dev/caskeleton/application/notification/platform/callback => application-notification/src/main/java/dev/caskeleton/application/notification/platform/api}/NormalizedProviderEvent.java (95%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationAcceptance.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationId.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationOrchestrator.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationPlan.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationReceipt.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationSnapshot.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationVariable.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/ProviderEventId.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/ProviderId.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/ProviderProfileId.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/RecipientDeliveryId.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/RecipientSpec.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/RequestStatus.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/TemplateSelection.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/TenantId.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/content/AttachmentDisposition.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/content/AttachmentRef.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/content/EmailContent.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/content/EmailOptions.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/content/InAppAction.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/content/InAppContent.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/content/MobilePushContent.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/content/NotificationContent.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/content/PushPresentation.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/content/SmsContent.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/content/SmsOptions.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/content/WebPushContent.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/content/WebPushOptions.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/AttemptConfirmation.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/DeliveryOutcome.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/EvidenceLevel.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/RecipientDeliveryState.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/SubmissionOutcome.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/AmbiguousSubmissionException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/AttachmentIntegrityException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/AttachmentUnavailableException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/CallbackProjectionException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/CallbackValidationException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/FailureCategory.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/IdempotencyConflictException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/InvalidContactPointException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationCapacityException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationExpiredException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationFailureCode.java (97%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationFailureDescriptor.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationSuppressedException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationValidationException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderAuthenticationException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderAuthorizationException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderConfigurationException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderPayloadLimitException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderPermanentException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderRejectedException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderThrottledException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderTransientException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderUnavailableException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/ReconciliationException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/TemplateNotFoundException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/TemplateRenderingException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/error/TemplateVariableValidationException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/routing/Channel.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/routing/DeliveryStrategy.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/routing/ExplicitChannel.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/api/routing/OrderedFallback.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/callback/AppendEventResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/callback/CallbackPayloadProtectionPort.java (88%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/callback/DeliveryAttemptResolverPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/callback/DeliveryAttemptSnapshot.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/callback/DeliveryProjection.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/callback/DeliveryProjectionStorePort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/callback/EngagementFacts.java (100%) create mode 100644 src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/IngestProviderCallbackApplicationUseCase.java rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/callback/NotificationSideEffectPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/callback/ProjectionResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/callback/ProjectionStatus.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventLedger.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventProjectionService.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventProjector.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventProjectorRegistry.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventRecord.java (95%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventRecordId.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventSource.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderRequestIdHash.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/callback/StandardDeliveryProjector.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/callback/SuppressionFacts.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/callback/VerifiedProviderEvent.java (97%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/contact/ApnsDeviceToken.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/contact/ApnsEnvironment.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/contact/ContactPointStatus.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/contact/ContactPointType.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/contact/ContactPointValue.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/contact/EmailAddress.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/contact/FcmInstallationId.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/contact/InAppRecipientRef.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/contact/LegacyFcmRegistrationToken.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/contact/MobilePushTarget.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/contact/PhoneNumber.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/contact/WebPushSubscriptionValue.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/AcceptNotificationApplicationUseCase.java (78%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ApplicationReceiptServiceImpl.java (96%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/AttachmentIntegrityGuard.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/CancelNotificationApplicationUseCase.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/CanonicalNotificationPlanEncoder.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/CanonicalNotificationPlanWriter.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ContactPointRecord.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ContactPointStorePort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DeliveryAttemptFactory.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DeliveryAttemptRecord.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DeliveryAttemptStorePort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DispatchGuardOutcome.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DispatchOutcomeRecorder.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DispatchPipeline.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DuplicateIdempotencyKeyException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/GetNotificationApplicationUseCase.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/MessageDigestPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationDispatchService.java (92%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationIdGeneratorPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRequestInsertOutcome.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRequestRecord.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRequestStatusPolicy.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRequestStorePort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRoutePlannerPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRoutingPlanCodecPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationSubmissionService.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationVariablesCodecPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/PolicyRoutePlanner.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ProviderDispatchGatewayPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ProviderProfileCatalogPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ProviderRequestIdHasherPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/PublishNotificationTemplateApplicationUseCase.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RecipientDeliveryRecord.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RecipientDeliveryStorePort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RecipientLease.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RecipientLeaseStorePort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationGatewayPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationJob.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationJobStorePort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationService.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RequestFingerprint.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ScheduleNotificationApplicationUseCase.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/SubmitNotificationApplicationUseCase.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/SyntheticEventFingerprint.java (98%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/TemplateRendererRegistry.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/dispatch/TenantContextPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/email/EmailNotification.java (90%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/email/EmailNotifier.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/inbox/CreateInboxItemCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxContentCodecPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxCursor.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxItem.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxItemCreated.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxItemId.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxItemState.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxMutationResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxPage.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxPrincipal.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxQuery.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/inbox/MarkAllReadCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/inbox/NotificationInbox.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/inbox/NotificationInboxSignalPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/observation/CardinalityGuard.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/observation/IllegalMetricTagException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationAuditEvent.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationAuditPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationMetricName.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationMetricsPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationSecurityAuditPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationServingState.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationServingStatePort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/observation/SensitiveValueDetector.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/CompositeNotificationEligibilityPolicy.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/ConsentRecord.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/ConsentStorePort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/DeduplicationResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/DeduplicationService.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/DeduplicationStorePort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/DefaultNotificationRetryPolicy.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/EligibilityResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/JitterSource.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/NotificationContext.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/NotificationEligibilityPolicy.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/NotificationRetryPolicy.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/PreferenceRecord.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/PreferenceStorePort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/RecipientIdentity.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/RetryBackoff.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/RetryBudget.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/RetryContext.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/RetryDecision.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/RouteCandidate.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/RoutingContext.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/RoutingDecision.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/RoutingDecisionEngine.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionEntry.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionId.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionReason.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionScope.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionSource.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionStorePort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/port/in/AcceptNotificationCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/port/in/AcceptNotificationUseCase.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/port/in/CancelNotificationCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/port/in/CancelNotificationUseCase.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/port/in/GetNotificationQuery.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/port/in/GetNotificationUseCase.java (100%) create mode 100644 src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/IngestProviderCallbackCommand.java create mode 100644 src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/IngestProviderCallbackUseCase.java rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/port/in/PublishNotificationTemplateCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/port/in/PublishNotificationTemplateUseCase.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/port/in/ScheduleNotificationCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/port/in/ScheduleNotificationUseCase.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/port/in/SubmitNotificationCommand.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/port/in/SubmitNotificationUseCase.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/provider/AttachmentAccessContext.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/provider/AttachmentResolver.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/provider/BatchNotificationProviderAdapter.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/provider/CollapseCapability.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/provider/EvidenceCertainty.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/provider/EvidenceFact.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/provider/NotificationProviderAdapter.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderCallNotStartedException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderCapabilities.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderCollapseMapping.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderExecutionEvidence.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderFailure.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderProfileSnapshot.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderRuntimeState.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderSubmission.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderSubmissionResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/provider/ReconciliationCapability.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/provider/ReconciliationResult.java (92%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/provider/ResolvedAttachment.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/provider/TraceContext.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/push/ApplicationIdentity.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/push/ApplicationReceipt.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/push/ApplicationReceiptService.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/push/MobilePushNotification.java (90%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/push/MobilePushNotifier.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/push/ReceiptAuthorizationException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/push/ReceiptKind.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/push/ReceiptResult.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/security/AccessContext.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/security/ContactPointProtector.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/security/NotificationPayloadProtection.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/security/NotificationPayloadUnreadableException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/security/NotificationRedactor.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/security/ProtectedContactPoint.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/security/SafeDiagnosticContext.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/security/SecretKeyMaterial.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/security/SecretMaterialProvider.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/security/SecretPurpose.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/security/SensitiveValueClassifier.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/security/SensitiveValueKind.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/security/UnsafeDiagnosticFieldException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/sms/E164PhoneNumberParser.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/sms/GsmAlphabet.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/sms/InvalidPhoneNumberException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsEncoding.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsEstimate.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsNotification.java (90%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsNotifier.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsSegmentEstimator.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/template/NotificationTemplateRenderer.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/template/NotificationTemplateVersion.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/template/RenderCommand.java (77%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/template/RenderedNotificationContent.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateContentCodecPort.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateContentDefinition.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateRegistry.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateSlot.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateStatus.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateVariableValidator.java (50%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateVersionConflictException.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/template/VariableSchema.java (100%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/webpush/WebPushNotification.java (90%) rename src/{application-core => application-notification}/src/main/java/dev/caskeleton/application/notification/platform/webpush/WebPushNotifier.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesUseCaseTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/NotificationAdmissionGateUseCaseTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/NotificationCanonicalWriterFenceGuardTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/NotificationCapabilityCompatibilityValidatorTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/NotificationDispatchUseCaseTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/NotificationKindPolicyTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/NotificationLegacyWriterPermitUseCaseTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/NotificationMaintenanceUseCaseTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/NotificationOperationsSnapshotUseCaseTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/NotificationPlanningBoundaryTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/NotificationPortBoundaryTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/NotificationPortContractTest.java (76%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/NotificationReceiptReducerTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/NotificationRequestResultTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/NotificationTestFixtures.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/NotificationValueContractTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/ReconcileNotificationDeliveriesUseCaseTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationUseCaseTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipUseCaseTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsUseCaseTest.java (100%) create mode 100644 src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/admin/AdminAuthorizationGuardTest.java create mode 100644 src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/admin/AdminOperationCommandFingerprintTest.java create mode 100644 src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/admin/AdminOperationExecutorTest.java create mode 100644 src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/admin/DuplicateRiskGuardTest.java create mode 100644 src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminApplicationServiceTest.java rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/api/NotificationPlanTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/api/PublicApiBoundaryTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/api/PublicApiIsTypedTest.java (67%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/api/content/NotificationContentContractTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/api/delivery/EvidenceModelTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/api/error/NotificationExceptionTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/callback/CallbackFixtures.java (95%) create mode 100644 src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/callback/CallbackIngestionAtomicityTest.java rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/callback/ProjectionMergeContractTest.java (98%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/callback/ProviderEventLateMatchTest.java (99%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/contact/ContactPointTypeTest.java (100%) create mode 100644 src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/AcceptNotificationApplicationUseCaseTest.java create mode 100644 src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/ApplicationReceiptServiceImplTest.java rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/dispatch/AttachmentIntegrityGuardTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/dispatch/CanonicalPlanEncodingTest.java (100%) create mode 100644 src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/DeliveryAttemptFactoryTest.java create mode 100644 src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/DispatchOutcomeRecorderTest.java create mode 100644 src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/DispatchPipelineTest.java create mode 100644 src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/NotificationApplicationUseCasesTest.java create mode 100644 src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/NotificationDispatchServiceTest.java create mode 100644 src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/NotificationPlatformNoops.java rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/dispatch/NotificationSubmissionServiceTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/dispatch/PlatformFakes.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/dispatch/PreferredOrderRoutingTest.java (100%) create mode 100644 src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/PublishNotificationTemplateApplicationUseCaseTest.java create mode 100644 src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationServiceTest.java rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/dispatch/RequestFingerprintTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/dispatch/SyntheticEventFingerprintTest.java (97%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/observation/BoundedObservabilityTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/observation/NotificationObservabilityTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/policy/DeduplicationAndCollapseTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/policy/NotificationEligibilityTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/policy/NotificationRetryPolicyTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/policy/PolicyFixtures.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/policy/RoutingDecisionEngineTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/provider/PreDispatchFailureEvidenceTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/provider/ProviderSpiContractTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/security/NotificationRedactionTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/sms/SmsSegmentEstimatorTest.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/template/InMemoryTemplateRegistry.java (100%) rename src/{application-core => application-notification}/src/test/java/dev/caskeleton/application/notification/platform/template/TemplateRegistryContractTest.java (100%) create mode 100644 src/application-notification/src/test/java/dev/caskeleton/application/testsupport/CompiledPackageScanner.java create mode 100644 src/application-objectstorage/build.gradle create mode 100644 src/application-objectstorage/gradle.lockfile rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/content/CancellationView.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectChunkReadException.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectChunkSink.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectChunkSource.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectChunkWriteException.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentConsumer.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentConsumptionException.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentProducer.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentProductionContext.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentProductionException.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentReadContext.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/identity/DirectTransferSessionId.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/identity/MultipartPartNumber.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectDestinationId.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectId.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectIdentitySupport.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectOperationEpoch.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectOperationId.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectOperationKey.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectReference.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectStageHandle.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectVersionToken.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/identity/PartReceiptToken.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/DirectDownloadGrant.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/DirectUploadCompletionReceipt.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/DirectUploadGrant.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/MultipartReceipt.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/MultipartSession.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectCapabilityRequirement.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectContentIdentity.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectDescriptor.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectDigest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectDigestAlgorithm.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectDigestVerification.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectEncryptionRequirement.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectHandoffReceipt.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectMediaType.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectModelSupport.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectMutationOutcome.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectMutationReceipt.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectOperationError.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectOperationResolution.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectPublicationRequirement.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectPublicationState.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectPublishReceipt.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectReadRange.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectReadReceipt.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectRetentionRequirement.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectScanReadReceipt.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectScanState.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectStageReceipt.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectVerificationReceipt.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/model/PartUploadGrant.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/port/DirectMultipartUploadPort.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/port/DirectObjectDownloadGrantPort.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/port/DirectObjectUploadPort.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/port/ManagedObjectPublicationPort.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectInspectionPort.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectOperationResolutionPort.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectPublicationHandoffPort.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectPurgeMaintenancePort.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectRetirementPort.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectScanMaintenancePort.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectTransferPort.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/port/StagedObjectPublicationPort.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/DirectDownloadGrantRequest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/DirectUploadCompletionRequest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/DirectUploadGrantRequest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/MultipartAbortRequest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/MultipartCompleteRequest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/MultipartPartAcknowledgement.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/MultipartStartRequest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectAbortAuthorization.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectAbortRequest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectFinalizeRequest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectHandoffClaimRequest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectHandoffReleaseRequest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectHandoffRenewRequest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectPublishRequest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectPurgeRequest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectReadRequest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectRequestSupport.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectRetireRequest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectScanReadRequest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectScanVerdictRequest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectStageRequest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectVerifyRequest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/objectstorage/request/PartUploadGrantRequest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/storage/ObjectStoragePort.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/storage/StoredObject.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionApproval.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionApprovalVerifierPort.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionPort.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionReceipt.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionRequest.java (100%) rename src/{application-core => application-objectstorage}/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectLocator.java (100%) rename src/{application-core => application-objectstorage}/src/test/java/dev/caskeleton/application/objectstorage/ObjectContentContractTest.java (100%) rename src/{application-core => application-objectstorage}/src/test/java/dev/caskeleton/application/objectstorage/ObjectStorageArchitectureContractTest.java (88%) rename src/{application-core => application-objectstorage}/src/test/java/dev/caskeleton/application/objectstorage/ObjectStorageIdentityContractTest.java (100%) rename src/{application-core => application-objectstorage}/src/test/java/dev/caskeleton/application/objectstorage/ObjectStoragePortContractTest.java (100%) rename src/{application-core => application-objectstorage}/src/test/java/dev/caskeleton/application/objectstorage/ObjectStorageValueContractTest.java (100%) create mode 100644 src/application-objectstorage/src/test/java/dev/caskeleton/application/testsupport/CompiledPackageScanner.java create mode 100644 src/build-logic/src/test/java/dev/caskeleton/buildlogic/architecture/CleanArchitectureResolvedClasspathFunctionalTest.java create mode 100644 src/build-tools/src/main/java/dev/caskeleton/buildtools/config/VerifyOperationalErrorRegistryTask.java create mode 100644 src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/JpaAdopterApiSurfaceVerifier.java delete mode 100644 src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/JpaSqlConstructionSafetyResult.java create mode 100644 src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/SetConfigParameterBindingResult.java rename src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/{JpaSqlConstructionSafetyVerifier.java => SetConfigParameterBindingVerifier.java} (81%) create mode 100644 src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/VerifyJpaAdopterApiSurfaceTask.java rename src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/{VerifyJpaSqlConstructionSafetyTask.java => VerifySetConfigParameterBindingTask.java} (65%) create mode 100644 src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/MongoIntegrationLaneTagVerifier.java create mode 100644 src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/VerifyMongoIntegrationLaneTagsTask.java create mode 100644 src/build-tools/src/test/java/dev/caskeleton/buildtools/jpa/JpaAdopterApiSurfaceVerifierTest.java rename src/build-tools/src/test/java/dev/caskeleton/buildtools/jpa/{JpaSqlConstructionSafetyVerifierTest.java => SetConfigParameterBindingVerifierTest.java} (81%) create mode 100644 src/build-tools/src/test/java/dev/caskeleton/buildtools/mongo/MongoIntegrationLaneTagVerifierTest.java create mode 100644 src/config/architecture/README.md create mode 100644 src/domain-core/src/test/java/dev/caskeleton/domain/DomainCoreContractTest.java rename src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/{ => api}/context/GrpcClientIdentity.java (98%) rename src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/{ => api}/context/GrpcMetadataBudget.java (98%) rename src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/{ => api}/context/GrpcMetadataKey.java (98%) rename src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/{ => api}/context/GrpcRequestContext.java (95%) rename src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/{ => api}/deadline/GrpcCancellationToken.java (98%) rename src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/{ => api}/deadline/GrpcDeadlineBudget.java (98%) rename src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/{ => api}/deadline/GrpcDeadlineExceededException.java (83%) rename src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/{ => api}/deadline/GrpcDeadlineProfile.java (98%) rename src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/{ => api}/error/GrpcCompletionOutcome.java (98%) rename src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/{ => api}/error/GrpcFailureCategory.java (98%) rename src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/{ => api}/error/GrpcFailureContext.java (98%) rename src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/{ => api}/error/GrpcPlatformException.java (97%) rename src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/{ => api}/ledger/GrpcOperationIdentity.java (97%) rename src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/{ => api}/ledger/GrpcOperationLedger.java (98%) rename src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/{ => api}/ledger/GrpcOperationLedgerRecord.java (98%) rename src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/{ => api}/ledger/GrpcOperationLedgerState.java (95%) rename src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/{ => api}/policy/GrpcMethodPolicy.java (97%) rename src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/{ => api}/policy/GrpcMethodPolicyCatalog.java (99%) rename src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/{ => api}/policy/RpcIdempotencyProfile.java (98%) rename src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/{ => api}/policy/WaitForReadyPolicy.java (95%) rename src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/{ => api}/context/GrpcMetadataBudgetTest.java (96%) rename src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/{ => api}/deadline/GrpcDeadlineBudgetTest.java (99%) rename src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/{ => api}/error/GrpcFailureContextTest.java (99%) rename src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/{ => api}/policy/GrpcMethodPolicyCatalogTest.java (98%) create mode 100644 src/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerPostgresIT.java rename src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/validation/{ProtovalidateGrpcInterceptor.java => GrpcValidationInterceptor.java} (97%) create mode 100644 src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/idempotency/GrpcOutcomeReplayBoundTest.java create mode 100644 src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/streaming/GrpcStreamAdmissionConcurrencyTest.java rename src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/validation/{ProtovalidateGrpcInterceptorTest.java => GrpcValidationInterceptorTest.java} (92%) create mode 100644 src/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfigurationContextTest.java create mode 100644 src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcPackageOwnershipTest.java create mode 100644 src/messaging/messaging-admin-runtime/src/test/java/dev/caskeleton/messaging/admin/runtime/ReplayServiceTest.java rename src/messaging/messaging-inbox-jdbc-postgresql/src/{test => integrationTest}/java/dev/caskeleton/messaging/inbox/InboxPostgresIT.java (98%) rename src/messaging/messaging-inbox-jdbc-postgresql/src/main/resources/db/migration/messaging/{V2__messaging_inbox.sql => V1101__messaging_inbox.sql} (100%) rename src/messaging/messaging-kafka/src/{test => integrationTest}/java/dev/caskeleton/messaging/kafka/KafkaAmbiguityChaosIT.java (100%) rename src/messaging/messaging-kafka/src/{test => integrationTest}/java/dev/caskeleton/messaging/kafka/KafkaBrokerCertificationIT.java (100%) rename src/messaging/messaging-kafka/src/{test => integrationTest}/java/dev/caskeleton/messaging/kafka/KafkaBrokerIT.java (100%) rename src/messaging/messaging-kafka/src/{test => integrationTest}/java/dev/caskeleton/messaging/kafka/KafkaConsumerSettlementIT.java (100%) rename src/messaging/messaging-kafka/src/{test => integrationTest}/java/dev/caskeleton/messaging/kafka/KafkaContainerFixture.java (100%) rename src/messaging/messaging-kafka/src/{test => integrationTest}/java/dev/caskeleton/messaging/kafka/KafkaContainerSmokeTest.java (100%) rename src/messaging/messaging-kafka/src/{test => integrationTest}/java/dev/caskeleton/messaging/kafka/KafkaReadCommittedIT.java (100%) rename src/messaging/messaging-kafka/src/{test => integrationTest}/java/dev/caskeleton/messaging/kafka/KafkaTopologyValidationIT.java (100%) rename src/messaging/messaging-kafka/src/{test => integrationTest}/java/dev/caskeleton/messaging/kafka/KafkaTransactionFencingIT.java (100%) rename src/messaging/messaging-kafka/src/{test => integrationTest}/java/dev/caskeleton/messaging/kafka/KafkaTransactionFixtures.java (100%) rename src/messaging/messaging-kafka/src/{test => integrationTest}/java/dev/caskeleton/messaging/kafka/KafkaTransactionIT.java (100%) rename src/messaging/messaging-kafka/src/{test => testFixtures}/java/dev/caskeleton/messaging/kafka/KafkaContractHarness.java (100%) rename src/messaging/messaging-kafka/src/{test => testFixtures}/java/dev/caskeleton/messaging/kafka/KafkaFixtureProfiles.java (100%) rename src/messaging/messaging-outbox-jdbc-postgresql/src/{test => integrationTest}/java/dev/caskeleton/messaging/outbox/AdminOperationJournalPostgresIT.java (99%) rename src/messaging/messaging-outbox-jdbc-postgresql/src/{test => integrationTest}/java/dev/caskeleton/messaging/outbox/OutboxPostgresIT.java (99%) rename src/messaging/messaging-outbox-jdbc-postgresql/src/main/resources/db/migration/messaging/{V1__messaging_outbox.sql => V1001__messaging_outbox.sql} (100%) rename src/messaging/messaging-outbox-jdbc-postgresql/src/main/resources/db/migration/messaging/{V2__messaging_outbox_lease_fencing.sql => V1002__messaging_outbox_lease_fencing.sql} (100%) rename src/messaging/messaging-outbox-jdbc-postgresql/src/main/resources/db/migration/messaging/{V3__messaging_admin_operation_journal.sql => V1003__messaging_admin_operation_journal.sql} (100%) rename src/messaging/messaging-outbox-jdbc-postgresql/src/main/resources/db/migration/messaging/{V4__messaging_outbox_canonical_metadata.sql => V1004__messaging_outbox_canonical_metadata.sql} (100%) rename src/messaging/messaging-rabbit/src/{test => integrationTest}/java/dev/caskeleton/messaging/rabbit/RabbitBrokerIT.java (100%) rename src/messaging/messaging-rabbit/src/{test => integrationTest}/java/dev/caskeleton/messaging/rabbit/RabbitFixtureProfiles.java (100%) create mode 100644 src/messaging/messaging-rabbit/src/testFixtures/java/dev/caskeleton/messaging/rabbit/RabbitProfileFixtures.java create mode 100644 src/messaging/messaging-reliability-api/src/test/java/dev/caskeleton/messaging/reliability/OutboxRepositoryApiSafetyTest.java create mode 100644 src/messaging/messaging-spring-boot-starter-kafka/build.gradle create mode 100644 src/messaging/messaging-spring-boot-starter-kafka/gradle.lockfile rename src/messaging/{messaging-spring-boot-starter => messaging-spring-boot-starter-kafka}/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaMessagingAutoConfiguration.java (86%) create mode 100644 src/messaging/messaging-spring-boot-starter-rabbit/build.gradle create mode 100644 src/messaging/messaging-spring-boot-starter-rabbit/gradle.lockfile rename src/messaging/{messaging-spring-boot-starter => messaging-spring-boot-starter-rabbit}/src/main/java/dev/caskeleton/messaging/autoconfigure/RabbitMessagingAutoConfiguration.java (75%) rename src/messaging/messaging-spring-boot-starter/src/{test => integrationTest}/java/dev/caskeleton/messaging/autoconfigure/MessagingLiveRoundTripQualificationTest.java (98%) create mode 100644 src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingMigrationNamespaceTest.java create mode 100644 src/optional-platforms/settings-gradle.lockfile rename src/sample-portfolio/src/{test => integrationTest}/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterImageUploadIntentRepositoryIntegrationTest.java (100%) rename src/sample-portfolio/src/{test => integrationTest}/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterRepositoryAdapterIntegrationTest.java (100%) rename src/sample-portfolio/src/{test => integrationTest}/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogRepositoryAdapterIntegrationTest.java (100%) create mode 100644 src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SampleMigrationStreamIsolationTest.java rename src/sample-portfolio/src/{posterImageMigrationTest => integrationTest}/java/dev/caskeleton/sample/portfolio/qualification/PosterImageIdempotencyRotationQualificationTest.java (100%) rename src/sample-portfolio/src/{posterImageMigrationTest => integrationTest}/java/dev/caskeleton/sample/portfolio/qualification/PosterImageRetirementQualificationTest.java (100%) rename src/sample-portfolio/src/{posterImageMigrationTest => integrationTest}/java/dev/caskeleton/sample/portfolio/qualification/PosterImageV8MigrationQualificationTest.java (100%) create 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/scan/TestEnclosedConfigurationFilter.java rename src/sample-portfolio/src/{test => systemTest}/java/dev/caskeleton/sample/portfolio/SampleApplicationContextTest.java (72%) rename src/sample-portfolio/src/{test => systemTest}/resources/application-test.yml (98%) create mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/architecture/SampleArchitectureTest.java create mode 100644 src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SamplePostgreSqlPersistenceConfigTest.java rename src/sample-portfolio/src/{test => testFixtures}/java/dev/caskeleton/sample/portfolio/SamplePortfolioTestApplication.java (100%) rename src/sample-portfolio/src/{test => testFixtures}/java/dev/caskeleton/sample/portfolio/testinfra/PostgreSqlTestContainer.java (100%) rename src/sample-portfolio/src/{test => webSystemTest}/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/contract/OpenApiDriftContractTest.java (99%) rename src/sample-portfolio/src/{test => webSystemTest}/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/date/DateHeaderContractTest.java (100%) rename src/sample-portfolio/src/{test => webSystemTest}/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/filter/VirtualThreadMdcE2ETest.java (93%) rename src/sample-portfolio/src/{test => webSystemTest}/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/openapi/OpenApiSnapshotTest.java (100%) rename src/sample-portfolio/src/{test => webSystemTest}/resources/openapi/worklogs-openapi-snapshot.json (96%) rename src/shared-contract/src/{edgeRateLimitContractTest => test}/java/dev/caskeleton/shared/ratelimit/EdgeRateLimitProviderNeutralContractTest.java (100%) diff --git a/.github/workflows/ci-quality-gates.yml b/.github/workflows/ci-quality-gates.yml index ff49de59..c6bf601a 100644 --- a/.github/workflows/ci-quality-gates.yml +++ b/.github/workflows/ci-quality-gates.yml @@ -43,6 +43,15 @@ jobs: exit 1 fi - uses: ./.github/actions/setup-gradle-java + - name: Export the live Gradle verification task map + working-directory: src + run: ./gradlew tasks --group verification --console=plain > ../verification-tasks.txt + - name: Upload the Gradle verification task map + uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # actions/upload-artifact@v7.0.1 + with: + name: gradle-verification-task-map + path: verification-tasks.txt + if-no-files-found: error # `ci`, not `check`. A leaf's `check` is that leaf's — compile, its tests, Spotless, Checkstyle # and Error Prone — and the repository-wide gates are named tasks of their own: # ci = every leaf check + architectureCheck + qualityCheck + configContractCheck + qualificationCheck @@ -60,6 +69,8 @@ jobs: - name: Qualify opt-in inbound transports without skips working-directory: src run: ./gradlew :conditionalTransportQualification --stacktrace + - name: Verify Compose profile contracts render exactly as declared + run: bash scripts/verify-compose-profile-contracts.sh build-logic: # Included-build tests are independent of the main project task graph. Running them as a @@ -72,6 +83,29 @@ jobs: working-directory: src run: ./gradlew -p build-logic test --stacktrace + build-tools: + # build-tools is an included build, so its verifier tests are not reached by the main :ci task. + # These tests protect env/JPA/messaging/Mongo/notification evidence parsers; a broken verifier + # must fail the pull-request gate rather than silently bless bad evidence. + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # actions/checkout@v4.2.2 + - uses: ./.github/actions/setup-gradle-java + - name: Test the build-time verifier plugins + working-directory: src + run: ./gradlew -p build-tools test --stacktrace + + 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 + - name: Verify the standalone sample application + working-directory: src + run: ./gradlew :sample-portfolio:check --stacktrace + redis-sdk: # Milestone A of the Redis wrapper/typed API plan: policy catalog, typed API parity, permit # provenance, connection isolation, and the executor guard. There is no real-server lane yet. @@ -83,7 +117,7 @@ jobs: # `configContractCheck`, which the quality-gates job covers. uses: ./.github/workflows/_reusable-gradle.yml with: - tasks: ":shared-contract:edgeRateLimitContractTest" + tasks: ":shared-contract:test --tests '*EdgeRateLimitProviderNeutralContractTest'" optional-platforms: runs-on: ubuntu-latest @@ -156,6 +190,8 @@ jobs: needs: - quality-gates - build-logic + - build-tools + - sample-portfolio - redis-sdk - jpa-candidate-evidence - optional-platforms @@ -169,6 +205,8 @@ jobs: env: QUALITY_RESULT: ${{ needs.quality-gates.result }} BUILD_LOGIC_RESULT: ${{ needs.build-logic.result }} + BUILD_TOOLS_RESULT: ${{ needs.build-tools.result }} + SAMPLE_RESULT: ${{ needs.sample-portfolio.result }} REDIS_RESULT: ${{ needs.redis-sdk.result }} JPA_CANDIDATE_RESULT: ${{ needs.jpa-candidate-evidence.result }} OPTIONAL_PLATFORMS_RESULT: ${{ needs.optional-platforms.result }} @@ -178,6 +216,8 @@ jobs: for result in \ "${QUALITY_RESULT}" \ "${BUILD_LOGIC_RESULT}" \ + "${BUILD_TOOLS_RESULT}" \ + "${SAMPLE_RESULT}" \ "${REDIS_RESULT}" \ "${JPA_CANDIDATE_RESULT}" \ "${OPTIONAL_PLATFORMS_RESULT}" \ diff --git a/.github/workflows/fileserver-pr.yml b/.github/workflows/fileserver-pr.yml index 2181300b..a404aefe 100644 --- a/.github/workflows/fileserver-pr.yml +++ b/.github/workflows/fileserver-pr.yml @@ -50,7 +50,7 @@ jobs: run: >- ./gradlew :application-core:test - :app-bootstrap:test --tests 'dev.caskeleton.bootstrap.architecture.*' --tests '*Fileserver*' + :app-bootstrap:architectureTest --tests '*Fileserver*' --stacktrace diff --git a/.github/workflows/integration-main.yml b/.github/workflows/integration-main.yml index 747005f8..8f07fab8 100644 --- a/.github/workflows/integration-main.yml +++ b/.github/workflows/integration-main.yml @@ -230,3 +230,79 @@ jobs: - name: Run the real-PostgreSQL integration contracts working-directory: src run: ./gradlew :app-bootstrap:integrationTest --stacktrace + + # Container contracts moved out of the default `test` source sets must remain executed after the + # ownership split. One step per lane keeps a failure attributable to the capability that broke. + moved-container-contracts: + runs-on: ubuntu-latest + timeout-minutes: 90 + env: + TESTCONTAINERS_REUSE_ENABLE: "false" + steps: + - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # actions/checkout@v4.2.2 + - uses: ./.github/actions/setup-gradle-java + - name: RabbitMQ transport contract + working-directory: src + run: ./gradlew :messaging:messaging-rabbit:integrationTest --stacktrace + - name: Inbox PostgreSQL contract + working-directory: src + run: ./gradlew :messaging:messaging-inbox-jdbc-postgresql:integrationTest --stacktrace + - name: Outbox PostgreSQL contract + working-directory: src + run: ./gradlew :messaging:messaging-outbox-jdbc-postgresql:integrationTest --stacktrace + - name: Messaging starter Kafka round trip + working-directory: src + run: ./gradlew :messaging:messaging-spring-boot-starter:integrationTest --stacktrace + - name: Object storage MinIO contract + working-directory: src + run: ./gradlew :adapter:outbound:objectstorage:integrationTest --stacktrace + - name: Standalone sample PostgreSQL contract + working-directory: src + run: ./gradlew :sample-portfolio:integrationTest --stacktrace + + # These six PostgreSQL contracts moved from app-bootstrap into persistence-jpa. They are named + # directly instead of relying on readiness-card membership: provider ownership and evidence + # grading are different questions, and CI execution must not disappear when a card changes. + jpa-provider-ownership-contracts: + runs-on: ubuntu-latest + timeout-minutes: 90 + env: + TESTCONTAINERS_REUSE_ENABLE: "false" + steps: + - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # actions/checkout@v4.2.2 + - uses: ./.github/actions/setup-gradle-java + - name: Distributed lock contract + working-directory: src + run: ./gradlew :adapter:outbound:persistence-jpa:postgresqlDistributedLockIntegrationTest --stacktrace + - name: Idempotency unique-scope contract + working-directory: src + run: ./gradlew :adapter:outbound:persistence-jpa:postgresqlIdempotencyUniqueScopeIntegrationTest --stacktrace + - name: Integer lock migration compatibility + working-directory: src + run: ./gradlew :adapter:outbound:persistence-jpa:postgresqlIntLockMigrationCompatibilityIntegrationTest --stacktrace + - name: Legacy outbox transactional append + working-directory: src + run: ./gradlew :adapter:outbound:persistence-jpa:postgresqlLegacyOutboxAppendTransactionalIntegrationTest --stacktrace + - name: Legacy outbox concurrent relay + working-directory: src + run: ./gradlew :adapter:outbound:persistence-jpa:postgresqlLegacyOutboxConcurrentRelayIntegrationTest --stacktrace + - name: Legacy outbox row lifecycle + working-directory: src + run: ./gradlew :adapter:outbound:persistence-jpa:postgresqlLegacyOutboxRowLifecycleIntegrationTest --stacktrace + + # Dynamic half of the compose-profile contract. All 15 blocking lanes run on main/nightly; a + # partial lane run is reproduction only and cannot satisfy this job. + compose-runtime-smoke: + runs-on: ubuntu-latest + timeout-minutes: 180 + steps: + - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # actions/checkout@v4.2.2 + - name: Run every blocking Compose runtime lane + run: bash scripts/run-compose-runtime-smoke.sh --matrix src/config/runtime/compose-profile-contracts.json + - name: Publish sanitized runtime-smoke evidence + if: always() + uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # actions/upload-artifact@v4.6.2 + with: + name: compose-runtime-smoke-evidence + path: src/app-bootstrap/build/evidence/runtime-smoke + if-no-files-found: warn diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 07b4b992..86569a83 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -46,25 +46,18 @@ concurrency: cancel-in-progress: false jobs: - # The architecture-wide verification, once. Each of the four release workflows this file replaces - # ran `verifyCleanArchitectureDependencies` on its own runner, and three of them also ran the - # bootstrap architecture suite; the answers were identical because the input was one commit. + # The repository release contract, once. releaseCheck contains the PR gate plus provenance, + # stale-archive hygiene and the public path snapshot, so those tasks are no longer merely + # registered/documented — the tag workflow executes them before any image can publish. architecture-and-surface: runs-on: ubuntu-latest - timeout-minutes: 45 + timeout-minutes: 90 steps: - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # actions/checkout@v4.2.2 - uses: ./.github/actions/setup-gradle-java - - name: Verify architecture boundaries and the published surfaces + - name: Run the repository release contract working-directory: src - run: >- - ./gradlew - :verifyCleanArchitectureDependencies - :verifyPublicPathSnapshot - :app-bootstrap:verifyEnvKeys - :app-bootstrap:test --tests 'dev.caskeleton.bootstrap.architecture.*' - - --stacktrace + run: ./gradlew :releaseCheck --stacktrace # Every web lane that `check` cannot reach. webCrossStackParityTest depends on `test`, # webJettyCompatTest and webFluxContractTest, so naming it runs all four — which is what diff --git a/AGENTS.md b/AGENTS.md index a8071a88..70d13656 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,7 +2,7 @@ ## 프로젝트 정체성 -이 저장소는 단순한 예제 블로그 애플리케이션이 아니라, Java 21 + Spring Boot 4.0.0 + Gradle 멀티모듈 기반의 Clean Architecture 템플릿이다. +이 저장소는 단순한 예제 블로그 애플리케이션이 아니라, Java 21 + 버전 카탈로그에 고정된 Spring Boot 4.x + Gradle 멀티모듈 기반의 Clean Architecture 템플릿이다. 기본 패키지는 `dev.caskeleton`이며, 예시 도메인은 production 모듈이 아니라 `sample-portfolio` 모듈(WorkLog 엔지니어링 작업 기록 게시판)에 격리한다. 새 프로젝트를 시작할 때는 도메인 이름, 패키지, 엔티티, 유스케이스를 교체할 수 있지만, 모듈 경계와 의존성 방향은 유지해야 한다. @@ -12,7 +12,7 @@ 동작하는 코드라도 HARD-STOP 조건을 하나라도 위반하면 완료된 작업이 아니다. -다음 HARD-STOP 8개 항목이 이 저장소의 정본(canonical) 로컬 정책 권위이자 SSOT다. +다음 HARD-STOP 7개 항목이 이 저장소의 정본(canonical) 로컬 정책 권위이자 SSOT다. 1. `domain-core`가 framework, transport, database, cloud 의존성을 가진다. 2. controller가 repository, Spring Data interface, persistence entity를 직접 사용한다. @@ -21,7 +21,6 @@ 5. 프로젝트 의존성이 `src/config/architecture/modules.json` 또는 Gradle 의존성 검증을 위반한다. 6. 관련 검증 없이, 또는 실행하지 못한 이유를 밝히지 않고 완료를 주장한다. 7. 결론의 범위와 위험에 맞는 증거 없이 repository/corpus 전체 결론을 내린다. -8. 의미 있는 작업을 필수 LLM Wiki capture 또는 명시한 capture 차단 사유 없이 종료한다. root `CLAUDE.md`는 이 목록의 동기화된 요약이다. 두 문서가 어긋나면 이 `AGENTS.md` 목록이 우선한다. 자동 강제 범위는 아래 Gradle 정책 권위와 ArchUnit/Test가 담당한다. @@ -50,12 +49,12 @@ root `CLAUDE.md`는 이 목록의 동기화된 요약이다. 두 문서가 어 ## Gradle 정책 권위 - `src/config/architecture/modules.json`: 등록된 모든 leaf의 ID, repository-relative 소스 경로, - Gradle path, 허용 production project dependency edge, 두 composition root의 실제 runtime - membership. leaf 목록과 그 개수의 SSOT는 registry다. 문서는 개수를 복제하지 않는다 — + Gradle path, 허용 production project dependency edge. runtime membership은 실제 resolved + runtimeClasspath에서 검증하며 registry에 별도 membership 목록을 복제하지 않는다. leaf 목록과 그 개수의 SSOT는 registry다. 문서는 개수를 복제하지 않는다 — 산문에 적힌 숫자는 leaf가 추가되는 순간 drift하기 때문이다. 이제 이걸 강제하는 태스크는 없다: `verifyDocumentedLeafCount`는 삭제됐다. 문서에 적힌 수가 틀린 것은 결함이지만 빌드를 실패시킬 사유는 아니고, 그 태스크는 모든 `CLAUDE.md`와 `build.gradle`을 정규식으로 훑는 파서였다. -- `src/settings.gradle`: 16줄. `ca.architecture-registry` 설정 플러그인이 registry를 읽어 +- `src/settings.gradle`: `ca.architecture-registry` 설정 플러그인이 registry를 읽어 project를 include/mapping 한다. registry가 project 목록이 될 수 없는 경우(중복 ID, 저장소 밖 경로, 없는 디렉터리)만 여기서 실패한다. 허용되지 않는 edge 같은 아키텍처 규칙은 `verifyCleanArchitectureDependencies`가 답한다 — settings에서 죽으면 실행할 수 있는 태스크가 @@ -73,31 +72,6 @@ root `CLAUDE.md`는 이 목록의 동기화된 요약이다. 두 문서가 어 commit 정책은 모든 플랫폼에서 `human-only`이며 agent는 stage/commit/amend/push하지 않는다. -## LLM Wiki 캡처 워크플로우 - -구현, 아키텍처, 빌드, 테스트, 런타임, 문서 워크플로우 변경처럼 의미 있는 작업을 끝낸 뒤에는 최종 응답 전에 LLM Wiki 기록을 갱신한다. - -기준 vault: - -```text -/home/donghyeon/workspace/ai-tool/llm-wiki-private/ -``` - -에이전트는 해당 vault의 `AGENTS.md`, `CLAUDE.md`, `rules/`, `.agents/`, `.claude/`, `.codex/` 지침을 확인한 뒤 작성한다. - -필수 순서: - -1. `/home/donghyeon/workspace/ai-tool/llm-wiki-private/raw/branch-notes/.md`를 생성하거나 갱신한다. -2. 구현 내용, 변경 파일, 의사결정, 검증 명령, 실패/차단 사항, 증거 등급을 branch-note에 기록한다. -3. 실제로 파생 자료가 있으면 다음 raw 문서를 생성하거나 갱신한다. - - `raw/errors/`: 오류, 실패한 테스트, 샌드박스/도구 문제, 재발 가능한 트러블슈팅 - - `raw/interviews/`: 이 작업에서 정직하게 뽑을 수 있는 면접 질문 - - `raw/blog-topics/`: 채용공고가 아닌 구현·설계·트러블슈팅 기반 블로그 글감 -4. 파생 문서는 `## Parent`에서 branch-note로 upward link하고, branch-note의 `## Cluster / 묶음`에는 파생 문서 wikilink를 되돌려 적는다. -5. canonical 추출 요청이 없는 한 `wiki/blog/`, `wiki/interview/`, `wiki/portfolio/`, `wiki/concepts/`, `wiki/projects/`를 바로 만들지 않는다. - -파생 문서가 필요 없을 때도 그냥 생략하지 말고, branch-note의 cluster 섹션에 "없음" 또는 "추출할 별도 글감 없음"처럼 판단 결과를 남긴다. - ## 강제 수준 이 문서는 에이전트와 개발자가 따라야 할 작업 규칙을 정의하지만, 그 자체로 빌드나 테스트를 실패시키는 자동 강제 장치는 아니다. @@ -159,8 +133,6 @@ Gradle 의존성 검증도 같은 registry를 읽는다. root 문서나 기억 8. 외부 연동은 registry가 가리키는 `adapter:outbound:*` leaf에서 port 구현으로 추가한다. 9. endpoint는 마지막에 해당 `adapter:inbound:*` leaf에서 얇게 연결한다. 10. focused test를 먼저 돌리고, 가능한 경우 전체 Gradle test를 돌린다. -11. LLM Wiki branch-note와 필요한 파생 raw 문서를 갱신한다. -12. 완료 응답에는 변경 파일, 검증 결과, Wiki capture 결과를 포함한다. ## 테스트 전략 @@ -187,7 +159,7 @@ cd src ./gradlew check # 모든 leaf의 check ./gradlew architectureCheck # 의존 방향·런타임 멤버십·application-core 순수성 ./gradlew qualityCheck # SpotBugs + FindSecBugs (leaf check에는 없다) -./gradlew ci # PR 게이트 = 위 셋 + configContractCheck +./gradlew ci # PR 게이트 = leaf check + architecture + quality + config + qualification ./gradlew verifyPublicPathSnapshot ./gradlew :app-bootstrap:verifyEnvKeys ``` @@ -256,7 +228,6 @@ cd src - 핵심 변경 내용 - 실행한 검증 명령 - 실패하거나 실행하지 못한 검증 -- LLM Wiki branch-note와 파생 문서 캡처 결과 - 남은 위험 또는 후속 작업 짧은 작업이라도 검증 여부는 생략하지 않는다. diff --git a/CLAUDE.md b/CLAUDE.md index c4ba1b09..4fb22433 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -4,7 +4,7 @@ Repository guidance for the Java 21 + Spring Boot 4.0.8 Clean Architecture templ ## Prime Directive -Preserve architecture before optimizing for speed. The following eight HARD-STOP conditions are a +Preserve architecture before optimizing for speed. The following seven HARD-STOP conditions are a synchronized summary of the canonical local policy in `AGENTS.md`: 1. `domain-core` gains framework, transport, database, or cloud dependencies. @@ -15,7 +15,6 @@ synchronized summary of the canonical local policy in `AGENTS.md`: gate. 6. Completion is claimed without the relevant verification or a named reason it could not run. 7. A repository/corpus conclusion is made without evidence proportional to its scope and risk. -8. Non-trivial work closes without the required LLM Wiki capture or a reported capture block. If this summary drifts from `AGENTS.md`, `AGENTS.md` wins and this summary must be resynchronized. @@ -66,14 +65,14 @@ that the exception is stated rather than inferred from a directory. It is a vend own `*-api` leaves are its ports, its broker leaves are its adapters, its starter is its composition root — and the messaging module review (`docs/reviews/2026-08-14-messaging-module-code-review.md` MSG-023 §6.2) chose that layout deliberately over folding it into `adapter:outbound:*`. This -application is supposed to reach it the way it reaches any library: through an application-owned port -satisfied by an anti-corruption bridge in `adapter:outbound:messaging`. That bridge does not exist -yet (MSG-015), so today the composition root wires the starter directly; `src/messaging/CLAUDE.md` -holds the detail. +application reaches it through the application-owned anti-corruption bridge in +`adapter:outbound:messaging` (MSG-015). The canonical bridge exists; legacy outbox/realtime cutover +still has explicitly documented seams in `src/messaging/CLAUDE.md`. Never infer an individual leaf's Gradle path, allowed dependency, or test command from this table. -Read its `gradle_path`, `allowed_dependencies`, and `runtime_memberships` from -`src/config/architecture/modules.json`; derive the focused test from that Gradle path. +Read its `gradle_path` and `allowed_dependencies` from `src/config/architecture/modules.json`; runtime +composition is established by actual Gradle dependencies/auto-configuration, not a registry +`runtime_memberships` field that does not exist. ## Layer workflow @@ -107,7 +106,7 @@ Architecture-wide commands: ```bash ./gradlew architectureCheck --console=plain -./gradlew :app-bootstrap:test --tests 'dev.caskeleton.bootstrap.architecture.*' --console=plain +./gradlew :app-bootstrap:architectureTest --console=plain ./gradlew verifyPublicPathSnapshot --console=plain ./gradlew :app-bootstrap:verifyEnvKeys --console=plain ``` @@ -116,7 +115,7 @@ A leaf's `check` covers that leaf only — compile, its tests, Spotless, Checkst Repository-wide questions have their own names: `architectureCheck` (dependency direction, runtime membership, application-core purity, Git-carryable sources), `qualityCheck` (SpotBugs, FindSecBugs), `configContractCheck` (the environment contract), `integrationCheck` (the declared strict test -lanes). `ci` is check + architectureCheck + qualityCheck + configContractCheck; `releaseCheck` adds +lanes). `ci` is leaf checks + architectureCheck + qualityCheck + configContractCheck + qualificationCheck; `releaseCheck` adds provenance, archive hygiene and the public-path snapshot. Use public-path and env-key checks only when their surfaces changed. Full `test`, `check` or `ci` @@ -133,9 +132,3 @@ Citation verification is profile-based: none for `review-lite`, blocking citatio `review-standard`, and all material citations for `audit-deep`/`regulated`. Durable reports are triggered by high risk, at least 3 blocking findings, an architecture decision, explicit user request, or the regulated profile. Otherwise a concise result is allowed. - -## LLM Wiki capture - -For non-trivial implementation or workflow changes, use the exact vault path and capture sequence in -`AGENTS.md`. If the controller explicitly excludes wiki writes for a dispatched task, report the -handoff instead of writing outside scope. diff --git a/README.md b/README.md index cd6cc1c4..6ff9d533 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # ca-skeleton — Clean Architecture Spring Boot 템플릿 -ca-skeleton은 Java 21, Spring Boot 4.0.0, Gradle 멀티모듈 기반의 Clean Architecture 백엔드 템플릿입니다. fork해서 도메인·패키지·엔티티·유스케이스만 교체하면 새 서비스를 시작할 수 있고, 모듈 경계와 의존 방향은 그대로 유지합니다. 기본 패키지는 `dev.caskeleton`이며, 예시 도메인은 production 모듈이 아니라 `sample-portfolio` 모듈(WorkLog 작업 기록 게시판)에 격리합니다. +ca-skeleton은 Java 21과 버전 카탈로그에 고정된 Spring Boot 4.x, Gradle 멀티모듈 기반의 Clean Architecture 백엔드 템플릿입니다. fork해서 도메인·패키지·엔티티·유스케이스만 교체하면 새 서비스를 시작할 수 있고, 모듈 경계와 의존 방향은 그대로 유지합니다. 기본 패키지는 `dev.caskeleton`이며, 예시 도메인은 production 모듈이 아니라 `sample-portfolio` 모듈(WorkLog 작업 기록 게시판)에 격리합니다. 이 문서는 전체 구조와 첫 실행만 다룹니다. 모듈별 상세 규칙과 설계 근거는 각 모듈의 README와 `CLAUDE.md`가, 빌드·환경 변수 상세는 [src/README.md](src/README.md)가 소유합니다. @@ -28,7 +28,7 @@ family 수준의 책임은 다음과 같습니다. | `app-bootstrap` | Spring Boot entrypoint와 composition root | | `sample-portfolio` | WorkLog 예시 도메인(fixture/reference). production이 의존하지 않음 | -정확한 19개 leaf 목록과 각 leaf의 Gradle path·소스 경로·허용 production 의존 edge는 +등록된 leaf 목록과 각 leaf의 Gradle path·소스 경로·허용 production 의존 edge는 [src/config/architecture/modules.json](src/config/architecture/modules.json)이 SSOT입니다. focused test는 해당 Gradle path에서 `./gradlew :test --console=plain` 형태로 파생하며, root 문서나 기억에서 개별 leaf edge를 추론하지 않습니다. @@ -54,7 +54,7 @@ curl -fsS http://localhost:8080/api/healthcheck docker compose -f docker-compose.yml -f docker-compose.local.yml down ``` -`src/.env`는 커밋된 안전 기본값이라 별도 `.env.example`을 만들지 않습니다. 전체 환경 변수 목록과 조정 시점은 [src/README.md](src/README.md)와 [docs/registries/env-keys.yaml](docs/registries/env-keys.yaml)에 있습니다. +`src/.env.example`은 배포 환경 변수의 추적 가능한 복사/검증 계약이고 `src/.env`는 로컬 실행 입력입니다. 전체 환경 변수 목록과 조정 시점은 [src/README.md](src/README.md)와 [docs/registries/env-keys.yaml](docs/registries/env-keys.yaml)에 있습니다. ### 프로파일별 데이터스토어 @@ -98,7 +98,7 @@ cd src ```bash cd src ./gradlew :app-bootstrap:test -./gradlew :app-bootstrap:sampleOffTest +./gradlew :sample-portfolio:check ./gradlew architectureCheck ``` @@ -117,7 +117,7 @@ cd src - 비즈니스 정책은 mapper·filter·config·settings·controller에 두지 않습니다. - 새 외부 시스템 연동은 domain/application port와 adapter 모듈로 표현합니다. -이 규칙은 두 축으로 자동 강제합니다. ArchUnit `CleanArchitectureTest`가 컴파일된 소스 의존성을, +이 규칙은 두 축으로 자동 강제합니다. `:app-bootstrap:architectureTest`의 분할된 ArchUnit 규칙들이 컴파일된 소스 의존성을, `verifyCleanArchitectureDependencies` 게이트가 JSON registry의 허용 Gradle project edge를 검사합니다. @@ -142,7 +142,6 @@ Markdown 명령 파서였고, 그 결과 "README에 무엇을 쓸 수 있는가" cd src ./gradlew :grpc:grpc-testkit:grpcPerformanceTest ./gradlew :sample-portfolio:openapiCheckSnapshot -PapproveOpenApiChange -./gradlew :app-bootstrap:sampleOffCompile ``` - `grpcPerformanceTest` — latency percentile·saturation·drain budget을 **측정**한다. 공유 CI @@ -152,17 +151,13 @@ cd src `OpenApiDriftContractTest`는 `:sample-portfolio:test`의 일부이고, 그건 `check` 안이며 stage 1에서 실행된다. 이 태스크의 고유한 역할은 `-PapproveOpenApiChange`로 **커밋된 스냅샷을 다시 만드는 것** — 의도된 API 변경을 사람이 승인하는 지점이다. 자동으로 돌리면 승인이 승인이 아니게 된다. -- `sampleOffCompile` — `sampleOffTest` 소스셋을 **컴파일만** 한다. CI가 돌리는 - `:app-bootstrap:sampleOffTest`(stage 1, `ci-quality-gates.yml`의 `sample-off` 잡)는 같은 소스셋을 - 컴파일한 뒤 실행까지 하므로, CI에 따로 넣으면 진부분집합을 한 번 더 도는 것이다. 남겨 둔 이유는 - sample 제거 작업 중 테스트를 기다리지 않고 컴파일만 빠르게 확인하는 로컬 루프가 실재하기 때문이다. + ## 더 알아보기 - 빌드·검증 게이트·환경 변수 상세: [src/README.md](src/README.md) -- 모듈 레지스트리(19개 leaf SSOT): [src/config/architecture/modules.json](src/config/architecture/modules.json) +- 모듈 레지스트리(등록 leaf SSOT): [src/config/architecture/modules.json](src/config/architecture/modules.json) - 에이전트·기여자 작업 규칙: [AGENTS.md](AGENTS.md) · [CLAUDE.md](CLAUDE.md) -- 빌드·릴리스 공급망 파이프라인은 현재 Mode B 복구 범위에 포함되지 않았다. 현재 저장소가 - 제공하는 canonical workflow는 품질·의존성 취약점·링크 검사이며, release/publish 자동화는 별도 - 설계와 권한 검토 후 추가한다. +- release/publish 자동화는 `.github/workflows/release.yml`이 소유하며, release provenance·SBOM· + 이미지 build/push를 해당 workflow의 명시적 권한과 게이트 아래에서 수행합니다. - 모듈별 설계 결정: [domain-core](src/domain-core/README.md) · [application-core](src/application-core/README.md) · [adapter:inbound:web](src/adapter/inbound/web/README.md) · [adapter:outbound:persistence-jpa](src/adapter/outbound/persistence-jpa/README.md) · [shared-contract](src/shared-contract/README.md) · [app-bootstrap](src/app-bootstrap/README.md) diff --git a/docker-compose.infra.yml b/docker-compose.infra.yml index 68a998e5..ccf966a8 100644 --- a/docker-compose.infra.yml +++ b/docker-compose.infra.yml @@ -56,7 +56,7 @@ services: profiles: - local-mongo - all-adapters - image: mongo:7 + image: mongo:8.0.16 command: ["mongod", "--replSet", "rs0", "--bind_ip_all"] volumes: - type: volume @@ -75,7 +75,7 @@ services: profiles: - local-mongo - all-adapters - image: mongo:7 + image: mongo:8.0.16 depends_on: mongo: condition: service_healthy @@ -122,6 +122,22 @@ services: retries: 12 start_period: 30s + # ---- Redis — local compose contract for the shipped Redis runtime ---------------- + redis: + profiles: + - local-redis + - all-adapters + image: redis:7.4 + command: ["redis-server", "--appendonly", "no", "--save", ""] + networks: + - caskeleton-infra + healthcheck: + test: ["CMD", "redis-cli", "ping"] + interval: 5s + timeout: 3s + retries: 12 + start_period: 5s + # ---- Mailpit — the reference SMTP provider for notification serving ---------- mailpit: profiles: diff --git a/docs/adr/ADR-JPA-006-canonical-technical-audit.md b/docs/adr/ADR-JPA-006-canonical-technical-audit.md index b26bd9a8..cf3bd995 100644 --- a/docs/adr/ADR-JPA-006-canonical-technical-audit.md +++ b/docs/adr/ADR-JPA-006-canonical-technical-audit.md @@ -1,4 +1,4 @@ -# ADR-JPA-006 — `audit` is the canonical technical audit model; `auditing` stays a frozen candidate +# ADR-JPA-006 — `audit` is the sole technical audit model - Status: Accepted - Date: 2026-08-24 @@ -24,17 +24,15 @@ first, and column names, actor lengths and capture lifecycles then diverge per t ## Decision -`audit/AuditableEntity` is canonical. `auditing` stays in the tree as a candidate and is excluded -from the Stable capability report. +`audit/AuditableEntity` is canonical and the unused `auditing/*` implementation is removed. -The candidate is not deleted and not promoted. Deleting it would discard a working Spring Data -integration that a deployment preferring declarative auditing would want. Promoting it would mean -either renaming `modified_*` to `updated_*` and widening the actor column — a schema migration of -every audited table to gain nothing a caller asked for — or moving the sample entities onto -`modified_*`, which is the same migration in the other direction. +Keeping a complete, incompatible implementation as a dormant candidate created exactly the +ambiguity the review warned about: a new entity could choose a package by autocomplete and silently +change column names, actor bounds and capture lifecycle. A future move to Spring Data auditing is a +migration of the canonical model, not activation of a second model that has drifted beside it. -Neither is worth doing now. What the divergence actually needed was not consolidation but a rule -that an entity cannot straddle the two, and that rule is cheaper than either migration. +That future migration must preserve `created_*`/`updated_*`, the 256-character actor contract, +`AuditContextPort`, and the shared `Clock`; listener wiring and entity conversion land atomically. ## Consequences diff --git a/docs/adr/ADR-WS-003-stomp-and-broker-relay.md b/docs/adr/ADR-WS-003-stomp-and-broker-relay.md index b95a44db..c0b0d684 100644 --- a/docs/adr/ADR-WS-003-stomp-and-broker-relay.md +++ b/docs/adr/ADR-WS-003-stomp-and-broker-relay.md @@ -10,7 +10,7 @@ Advanced Tasks 9–13 add STOMP 1.2 alongside the platform's own protocol, plus relay and cross-node user destinations. This leaf already ships an older STOMP-over-SockJS channel (`stomp`, gated on -`ca-skeleton.websocket.enabled`). Two `@EnableWebSocketMessageBroker` configurations in one context +`app.websocket.enabled`). Two `@EnableWebSocketMessageBroker` configurations in one context do not conflict loudly — both contribute a configurer, both call `configureMessageBroker`, and the broker that results is whichever ran last. Nothing errors and nothing logs. diff --git a/docs/architecture/graphql-api-surface.txt b/docs/architecture/graphql-api-surface.txt index efe00c39..e61fafc6 100644 --- a/docs/architecture/graphql-api-surface.txt +++ b/docs/architecture/graphql-api-surface.txt @@ -5,7 +5,7 @@ # split into capability artifacts. # Update only after review with: # ./gradlew :adapter:inbound:graphql:updateGraphQlApiSurface -PapproveGraphQlApiSurfaceChange -# types: 408 +# types: 401 dev.caskeleton.adapter.inbound.graphql.HealthGraphqlController dev.caskeleton.adapter.inbound.graphql.advanced.admin.GraphQlAdminPrincipal dev.caskeleton.adapter.inbound.graphql.advanced.admin.GraphQlPersistedOperationAdminAuthorization @@ -141,13 +141,6 @@ dev.caskeleton.adapter.inbound.graphql.advanced.subscription.GraphQlSubscription dev.caskeleton.adapter.inbound.graphql.advanced.subscription.GraphQlSubscriptionSource dev.caskeleton.adapter.inbound.graphql.advanced.subscription.GraphQlSubscriptionState dev.caskeleton.adapter.inbound.graphql.advanced.subscription.GraphQlSubscriptionTermination -dev.caskeleton.adapter.inbound.graphql.advanced.websocket.GraphQlWebSocketAdmission -dev.caskeleton.adapter.inbound.graphql.advanced.websocket.GraphQlWebSocketConnectionId -dev.caskeleton.adapter.inbound.graphql.advanced.websocket.GraphQlWebSocketHandlerFactory -dev.caskeleton.adapter.inbound.graphql.advanced.websocket.GraphQlWebSocketLifecycle -dev.caskeleton.adapter.inbound.graphql.advanced.websocket.GraphQlWebSocketProperties -dev.caskeleton.adapter.inbound.graphql.advanced.websocket.GraphQlWebSocketProtocol -dev.caskeleton.adapter.inbound.graphql.advanced.websocket.GraphQlWebSocketProtocolException dev.caskeleton.adapter.inbound.graphql.api.GraphQlClientProfile dev.caskeleton.adapter.inbound.graphql.api.GraphQlClientProfileName dev.caskeleton.adapter.inbound.graphql.api.GraphQlOperationId diff --git a/docs/architecture/jpa-adopter-api-surface.txt b/docs/architecture/jpa-adopter-api-surface.txt new file mode 100644 index 00000000..af9027c6 --- /dev/null +++ b/docs/architecture/jpa-adopter-api-surface.txt @@ -0,0 +1,23 @@ +# Supported production adopter surface for the JPA persistence leaf. +# Language-level public implementation types are not compatibility promises. +# Adding an import outside this list requires an explicit review of the adopter contract. +dev.caskeleton.adapter.outbound.persistence.api.capability.CapabilitySupport +dev.caskeleton.adapter.outbound.persistence.api.capability.JpaCapability +dev.caskeleton.adapter.outbound.persistence.audit.AuditContextPort +dev.caskeleton.adapter.outbound.persistence.audit.AuditableEntity +dev.caskeleton.adapter.outbound.persistence.config.PersistenceJpaConfig +dev.caskeleton.adapter.outbound.persistence.config.PersistenceVendorSettings +dev.caskeleton.adapter.outbound.persistence.failure.SqlStateErrorMapping +dev.caskeleton.adapter.outbound.persistence.fileserver.FileserverSchemaActivation +dev.caskeleton.adapter.outbound.persistence.hibernate.HibernateProviderPolicy +dev.caskeleton.adapter.outbound.persistence.idempotency.IdempotencyClaimRepository +dev.caskeleton.adapter.outbound.persistence.migration.FlywaySchemaPolicy +dev.caskeleton.adapter.outbound.persistence.outbox.OutboxClaimRepository +dev.caskeleton.adapter.outbound.persistence.postgresql.PostgreSqlIdempotencyClaimRepository +dev.caskeleton.adapter.outbound.persistence.postgresql.PostgreSqlLocalTimeoutConfigurer +dev.caskeleton.adapter.outbound.persistence.postgresql.PostgreSqlOutboxClaimRepository +dev.caskeleton.adapter.outbound.persistence.postgresql.PostgreSqlPersistenceConfig +dev.caskeleton.adapter.outbound.persistence.postgresql.PostgreSqlSqlStateErrorMapping +dev.caskeleton.adapter.outbound.persistence.security.DatabasePrivilegeReport +dev.caskeleton.adapter.outbound.persistence.security.PostgreSqlRuntimeRoleVerifier +dev.caskeleton.adapter.outbound.persistence.transaction.TransactionLocalTimeoutConfigurer diff --git a/docs/evidence/object-storage/batch-a-checkpoint.md b/docs/evidence/object-storage/batch-a-checkpoint.md index 39a7f5ac..b350ee16 100644 --- a/docs/evidence/object-storage/batch-a-checkpoint.md +++ b/docs/evidence/object-storage/batch-a-checkpoint.md @@ -62,12 +62,10 @@ All commands ran from `src/` and completed with `BUILD SUCCESSFUL`: The final combined legacy focused suites completed in 27 seconds. Deprecation-for-removal warnings are expected evidence that legacy consumers remain visible; they are not suppressed. -## LLM Wiki capture +## documentation update The canonical vault required by repository policy, -`/home/donghyeon/workspace/ai-tool/llm-wiki-private/`, and its parent `/home/donghyeon/workspace/ai-tool/` do not exist in this environment. Therefore the required -`raw/branch-notes/codex-objectstorage-production-capability.md` could not be created or updated. No similarly named non-canonical clone was used. This exact access block is recorded in both the plan and design headers and here at the Batch A boundary. diff --git a/docs/evidence/object-storage/batch-b-checkpoint.md b/docs/evidence/object-storage/batch-b-checkpoint.md index 9042f72a..b7113d20 100644 --- a/docs/evidence/object-storage/batch-b-checkpoint.md +++ b/docs/evidence/object-storage/batch-b-checkpoint.md @@ -86,12 +86,10 @@ RED/fix cycles: The final combined application/objectstorage checkpoint completed in 23 seconds. The focused Clean Architecture suite and dependency verification also passed. -## LLM Wiki capture +## documentation update The canonical vault required by repository policy, -`/home/donghyeon/workspace/ai-tool/llm-wiki-private/`, and its parent `/home/donghyeon/workspace/ai-tool/` do not exist in this environment. Therefore the required -`raw/branch-notes/codex-objectstorage-production-capability.md` and any derived raw documents could not be created or updated. No similarly named non-canonical clone was used. This exact access block is recorded in the plan/design status and at this Batch B boundary. diff --git a/docs/evidence/object-storage/batch-c-progress.md b/docs/evidence/object-storage/batch-c-progress.md index 5ed46ef8..0a632d8d 100644 --- a/docs/evidence/object-storage/batch-c-progress.md +++ b/docs/evidence/object-storage/batch-c-progress.md @@ -67,11 +67,9 @@ bash ../.github/scripts/verify-gate-matrix.sh The gate matrix reports 22 gates: 21 verified and the protected AWS qualification gate explicitly `delegated-pending`. -## LLM Wiki capture +## documentation update -The canonical vault `/home/donghyeon/workspace/ai-tool/llm-wiki-private/` and its parent `/home/donghyeon/workspace/ai-tool/` do not exist in this environment. The required -`raw/branch-notes/codex-objectstorage-production-capability.md` and derived raw documents could not be created or updated. No similarly named non-canonical clone was used. ## Remaining risks diff --git a/docs/evidence/object-storage/batch-d-checkpoint.md b/docs/evidence/object-storage/batch-d-checkpoint.md index a4fb95fe..baa85bb2 100644 --- a/docs/evidence/object-storage/batch-d-checkpoint.md +++ b/docs/evidence/object-storage/batch-d-checkpoint.md @@ -96,9 +96,7 @@ Tasks 20–24 remain blocked until the user explicitly approves scanner ownershi first publication profile, the additive asynchronous API/status contract, and digest transport. No scan/publication/sample endpoint implementation was started. -## LLM Wiki capture +## documentation update -The canonical vault `/home/donghyeon/workspace/ai-tool/llm-wiki-private/` and its parent `/home/donghyeon/workspace/ai-tool/` do not exist in this environment. The required -`raw/branch-notes/codex-objectstorage-production-capability.md` and derived raw documents could not be created or updated. No similarly named non-canonical clone was used. diff --git a/docs/evidence/object-storage/batch-e-pause-checkpoint.md b/docs/evidence/object-storage/batch-e-pause-checkpoint.md index 06c1598f..914522cb 100644 --- a/docs/evidence/object-storage/batch-e-pause-checkpoint.md +++ b/docs/evidence/object-storage/batch-e-pause-checkpoint.md @@ -85,10 +85,7 @@ deletion of its Poster row. - No readiness card was promoted. Local/MinIO ceilings and unsupported conditional behavior remain unchanged. -## Wiki capture +## documentation update At this isolated-branch checkpoint, the then-selected private vault -`/home/donghyeon/workspace/ai-tool/llm-wiki-private/` was absent, so capture was blocked. The final main integration was later captured in the user-designated public vault at -`raw/branch-notes/chore-main-worktree-capability-integration.md`, with the derived error note -`raw/errors/multi-worktree-contract-drift-2026-07-31.md`. diff --git a/docs/httpclient/release-checklist.md b/docs/httpclient/release-checklist.md index 2c301cfe..f2bec408 100644 --- a/docs/httpclient/release-checklist.md +++ b/docs/httpclient/release-checklist.md @@ -16,7 +16,7 @@ cd src ./gradlew :adapter:outbound:httpclient:httpClientPerformanceTest \ -Pperformance.assertions.enabled=true --console=plain ./gradlew verifyCleanArchitectureDependencies --console=plain -./gradlew :app-bootstrap:test --tests '*CleanArchitectureTest' --console=plain +./gradlew :app-bootstrap:architectureTest --console=plain python3 ../scripts/verify-httpclient-docs.py ``` diff --git a/docs/httpclient/repository-adaptation.md b/docs/httpclient/repository-adaptation.md index 87e2194f..39b74f9d 100644 --- a/docs/httpclient/repository-adaptation.md +++ b/docs/httpclient/repository-adaptation.md @@ -26,8 +26,8 @@ Therefore the design's 19 library modules become **package boundaries inside the | Design module | Repository home | Reason | |---|---|---| -| `httpclient-spring-boot-starter` | `:app-bootstrap` (`dev.caskeleton.bootstrap.autoconfigure.httpclient`) | This repository's composition root owns wiring and canonical activation; an adapter leaf must not auto-configure itself. | -| `httpclient-testkit` | `:adapter:outbound:httpclient` `src/testkit/java/**/testkit` | The design forbids production modules depending on the testkit; a source set whose dependencies are declared only on the test configurations gives the same guarantee without a new Gradle project. It is its own source set rather than part of `test` because three lanes consume it — `test`, `httpClientPerformanceTest` and `jmh` — and reaching into `sourceSets.test.output` from `jmh` compiled under Gradle but could not be modelled by an IDE, which classifies a source set as test source only when a `Test` task runs its output and forbids main source from reading test source. `PlatformClasses` excludes the source set's output so the boundary rules keep meaning production classes. | +| `httpclient-spring-boot-starter` | `:adapter:outbound:httpclient` (`dev.caskeleton.adapter.outbound.httpclient.autoconfigure`) | Capability-specific Spring composition is owned with the reusable HTTP client platform; `app-bootstrap` only selects/includes the capability and runtime activation remains `app.httpclient.enabled`. | +| `httpclient-testkit` | `:adapter:outbound:httpclient` `src/testFixtures/java/**/testkit` | The design forbids production modules depending on the testkit. Gradle `testFixtures` publishes the reusable test support only to test consumers; ordinary tests, integration/performance lanes, and JMH opt into that surface explicitly without exposing it to production. `PlatformClasses` excludes test-fixture output so the boundary rules keep meaning production classes. | The package boundary is enforced by ArchUnit rules (`PublicApiArchitectureTest`, `HttpClientModuleBoundaryTest`) that reproduce the design's module dependency table. @@ -55,7 +55,7 @@ Root package: `io.backend.skeleton.httpclient` → `dev.caskeleton.adapter.outbo | `httpclient-resttemplate-migration` | `…httpclient.migration` | `…outbound.httpclient.migration` | | `httpclient-spring7-service-groups` | `…httpclient.spring7` | `…outbound.httpclient.spring7` | | `httpclient-jetty-http3-experimental` | `…httpclient.http3` | `…outbound.httpclient.http3` | -| `httpclient-spring-boot-starter` | `…httpclient.autoconfigure` | `dev.caskeleton.bootstrap.autoconfigure.httpclient` | +| `httpclient-spring-boot-starter` | `…httpclient.autoconfigure` | `dev.caskeleton.adapter.outbound.httpclient.autoconfigure` | | `httpclient-testkit` | `…httpclient.testkit` | `…outbound.httpclient.testkit` (`testkit` source set) | ## 3. Other deliberate substitutions diff --git a/docs/jpa/batch-write-guide.md b/docs/jpa/batch-write-guide.md new file mode 100644 index 00000000..2cf65e28 --- /dev/null +++ b/docs/jpa/batch-write-guide.md @@ -0,0 +1,64 @@ +# JPA batch write configuration + +`HibernateJpaBatchExecutor` is an advanced opt-in. The template does not enable Hibernate batch +write settings globally because statistics and statement reordering add runtime cost even in +applications that never perform bulk writes. + +## What the executor owns + +A `JpaBatchProfile` owns the JDBC batch size for one batch run. Before the first item is written, +the executor applies `profile.jdbcBatchSize()` to the current Hibernate `Session`. The previous +Session value is restored in `finally`, including failed runs. + +The executor does **not** open a transaction. The application service must enter a +`TransactionPort.inWrite(...)` boundary first. + +## What the application must configure + +If a profile requests insert or update ordering, the matching Hibernate setting must already be +enabled on the SessionFactory: + +```yaml +spring: + jpa: + properties: + hibernate: + order_inserts: true + order_updates: true + generate_statistics: true +``` + +`hibernate.generate_statistics=true` is required because `BatchExecutionResult` reports measured +flush and prepared-statement deltas. A disabled statistics registry would turn those values into +convincing zeros. + +The `HibernateStatisticsCollector` must also receive an instrumented `JdbcBatchCounter`. +`HibernateStatisticsCollector.of(sessionFactory)` is intentionally insufficient for this executor: +Hibernate statistics do not expose actual JDBC batch executions. + +`hibernate.default_batch_fetch_size` is unrelated to this write executor. It affects association +fetching and belongs to query/fetch tuning instead. + +## Entity identifier constraint + +When `JpaBatchProfile.batchingRequired()` is true, an entity using +`GenerationType.IDENTITY` is rejected by `HibernateBatchConfigurationGuard`. Hibernate must issue +each INSERT immediately to obtain the generated identifier, so JDBC insert batching cannot satisfy +that profile. + +Prefer a sequence-based identifier when a workload requires insert batching. Keep the sequence +allocation size aligned with the database migration. + +## Failure behavior + +Configuration is checked before the persister receives the first item: + +- missing `hibernate.order_inserts=true` when the profile requests insert ordering: fail; +- missing `hibernate.order_updates=true` when the profile requests update ordering: fail; +- disabled Hibernate statistics: fail; +- missing JDBC batch instrumentation: fail; +- no caller-owned transaction: fail. + +These failures are deliberate. A batch API that silently degrades to one statement per row produces +correct data but false performance evidence, which is harder to detect than a startup or invocation +failure. diff --git a/docs/jpa/repository-adaptation.md b/docs/jpa/repository-adaptation.md index 9225777c..5a8896da 100644 --- a/docs/jpa/repository-adaptation.md +++ b/docs/jpa/repository-adaptation.md @@ -105,7 +105,7 @@ Docker-dependent lanes fail closed rather than skipping, matching the existing | 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". | -| `build-logic/src/test/kotlin/JpaModuleBoundaryTest.kt` | There is no `build-logic` project and no Kotlin source set; module boundaries are enforced by the registry itself | `verifyCleanArchitectureDependencies` plus `:app-bootstrap:test --tests '*CleanArchitectureTest'` assert the same property against `src/config/architecture/modules.json`, which is the authority the plan's test would have had to duplicate. | +| `build-logic/src/test/kotlin/JpaModuleBoundaryTest.kt` | There is no `build-logic` project and no Kotlin source set; module boundaries are enforced by the registry itself | `verifyCleanArchitectureDependencies` plus `:app-bootstrap:architectureTest` assert the same property against `src/config/architecture/modules.json`, which is the authority the plan's test would have had to duplicate. | | `PostgreSqlRuntimeRoleVerifierIntegrationTest` (Task 45) | The security lane is one suite in this leaf rather than a per-module `integrationTest` | `PostgreSqlSecurityContractTest` (tag `jpa-security`) exercises `PostgreSqlRuntimeRoleVerifier.verify` and `.requireSafe` against a real restricted role on a real server. | | `JpaSafetyProperties`, `JpaDataSourceProperties` | `NamingConventionTest` requires every `@ConfigurationProperties` type to end in `Settings` or `Policy` | Renamed to `JpaSafetySettings` and `JpaDataSourceSettings`. The bound property prefixes and every field are unchanged; only the class names move to this repository's convention. | diff --git a/docs/jpa/support-matrix.md b/docs/jpa/support-matrix.md index 799560ca..a22dd748 100644 --- a/docs/jpa/support-matrix.md +++ b/docs/jpa/support-matrix.md @@ -97,7 +97,6 @@ the difference visible instead of asserting a constant against itself. See | Hibernate second-level cache | Advanced | | Hibernate Envers | Advanced | | Technical auditing — `audit/AuditableEntity` | Stable (canonical) | -| Technical auditing — `auditing/AuditMetadata` | Candidate, not composed | | Multi-tenancy (column, RLS, schema, database) | Experimental | | Consistency-aware read replica | Experimental | diff --git a/docs/messaging/configuration-reference.md b/docs/messaging/configuration-reference.md index 6fa2a812..ea220b4a 100644 --- a/docs/messaging/configuration-reference.md +++ b/docs/messaging/configuration-reference.md @@ -90,6 +90,8 @@ app: order-events-dlq: broker: kafka-primary kind: WORK_QUEUE + guarantees: + delivery: AT_MOST_ONCE # terminal DLQ: another DLQ is not required physical: topic: order.events.v1.dlt schema: @@ -121,6 +123,12 @@ app: | metric dimension 상한 | 200 | cardinality 폭발 방지 | `schema.codec`은 `application/json`, `schema.compatibility`는 `BACKWARD_TRANSITIVE`, + +> **현재 강제 범위:** `schema.compatibility` 값은 현재 정책 선언이며 runtime/CI에서 schema registry를 +> 조회해 호환성을 차단하지 않는다. Avro 비교기는 독립 utility/test로만 존재한다. 따라서 이 값을 +> 설정했다고 breaking schema가 자동 거부된다고 해석하면 안 된다. 실제 registry gate가 wiring되기 +> 전까지 호환성은 adopter의 schema CI가 소유한다. + `guarantees.delivery`는 `AT_LEAST_ONCE`, `retry.mode`는 `NONE`이 기본값이다. 자동 retry가 기본으로 꺼져 있는 이유는 순서를 흐트러뜨리거나 비멱등 side effect를 두 번 실행하는 retry가 눈에 보이는 실패보다 나쁘기 때문이다. diff --git a/docs/messaging/migration-guide.md b/docs/messaging/migration-guide.md index 1b849a35..77aae880 100644 --- a/docs/messaging/migration-guide.md +++ b/docs/messaging/migration-guide.md @@ -88,10 +88,23 @@ consumer recovery가 동시에 나빠지고, 유계·검증 가능한 실패가 ## DB 마이그레이션 ```text -V1__messaging_outbox.sql -V2__messaging_inbox.sql +V1001__messaging_outbox.sql +V1002__messaging_outbox_lease_fencing.sql +V1003__messaging_admin_operation_journal.sql +V1004__messaging_outbox_canonical_metadata.sql +V1101__messaging_inbox.sql ``` +Messaging owns Flyway versions `1000..1999`. The starter assembles both JDBC reliability modules, +so their migrations deliberately share `classpath:db/migration/messaging` but must never reuse a +version. Keeping them in this reserved range also prevents collisions with the application's +ordinary `db/migration/postgresql` stream, whose low-numbered versions are independent. + +When adopting outbox/inbox persistence, add `classpath:db/migration/messaging` to the deployment's +Flyway locations together with its normal application migration location. Do not copy or renumber +these files into the application's low-numbered stream; the reserved range is the namespace +boundary. + Outbox row는 business transaction과 같은 transaction에서 쓴다. Inbox reservation은 handler side effect와 같은 transaction에서 쓴다. 별도 transaction이면 각 패턴이 닫으려던 창이 그대로 열려 있다. diff --git a/docs/messaging/outbox-inbox.md b/docs/messaging/outbox-inbox.md index e28bd94b..4dac3ee0 100644 --- a/docs/messaging/outbox-inbox.md +++ b/docs/messaging/outbox-inbox.md @@ -9,6 +9,22 @@ **둘 다 필요하다.** Outbox만으로는 exactly-once가 되지 않는다. +## 채택할 때 먼저 적용할 DB migration + +Outbox/Inbox JDBC 모듈의 DDL은 `classpath:db/migration/messaging`에 있다. Messaging은 +Flyway version `1000..1999`를 예약해서 애플리케이션의 일반적인 저번호 migration과 버전이 +겹치지 않게 한다. + +배포에서 이 JDBC 구현을 채택할 때는 기존 Flyway location에 다음 location을 **추가**한다. + +```text +classpath:db/migration/messaging +``` + +현재 순서는 `V1001..V1004`(outbox/admin)와 `V1101`(inbox)이다. starter 테스트가 두 JDBC +모듈을 실제 combined classpath로 올려 version 중복과 예약 대역 이탈을 검사한다. 개별 DDL의 +의미와 전환 순서는 [migration-guide.md](migration-guide.md)를 따른다. + ## Outbox business transaction과 **같은 transaction**에서 row를 쓴다. 둘 다 commit되거나 둘 다 안 된다. diff --git a/docs/messaging/support-matrix.md b/docs/messaging/support-matrix.md index 38622f17..563bd88a 100644 --- a/docs/messaging/support-matrix.md +++ b/docs/messaging/support-matrix.md @@ -20,18 +20,17 @@ > `FOR UPDATE SKIP LOCKED`, `ON CONFLICT`, `TIMESTAMPTZ`)이므로, 그 이름은 쓰지 않는 기술을 > 광고하고 vendor 중립 port(`messaging-reliability-api`)의 위치를 가렸다 (MSG-023). > -> 또한 registry의 messaging leaf는 모두 `runtime_memberships`가 비어 있다. 이는 **build-only / -> incubating** — 어느 composition root에도 편입되지 않았다는 뜻이며, 아래의 등급과는 다른 축이다. -> 등급은 "무엇이 증명되었는가", membership은 "무엇이 실행되는가"를 말한다. 애플리케이션에 배선하려면 -> registry를 먼저 바꾸고 `verifyRuntimeModuleMembership`을 통과시켜야 한다. 자세한 규칙은 -> `src/messaging/CLAUDE.md`가 소유한다. +> `modules.json`은 messaging leaf의 `gradle_path`와 허용 의존성을 관리하지만 +> `runtime_memberships` 필드는 없다. 실제 런타임 편입은 `app-bootstrap`의 Gradle 의존성과 starter / +> auto-configuration 경로가 결정한다. 아래 등급은 "무엇이 증명되었는가"를 말하며 런타임 편입 여부와 +> 같은 축이 아니다. 자세한 composition/cutover 상태는 `src/messaging/CLAUDE.md`가 소유한다. ## 브로커 등급 | 브로커 | 등급 | 인증 기준 | Stable 기능 | 제한 | |---|---|---|---|---| | Kafka | Stable | 4.1.x | producer idempotence, consumer group, batch, pause/resume, replay, transaction capability | Share Group은 Experimental | -| RabbitMQ | Experimental | 4.3.x | exchange/routing, publisher confirm, mandatory return, manual ACK, quorum queue, retry queue, DLQ | 장애 시나리오 레인 미실행 — 증거 없음. stream 및 특수 plugin 미지원 | +| RabbitMQ | Experimental | 4.3.x | exchange/routing, publisher confirm, mandatory return, manual ACK, quorum queue, retry queue, DLQ | **현재 starter에서 선택 불가** — production `RabbitChannelPublisher`/transport bridge가 없어 `app.messaging.broker=rabbit`은 startup에서 거부된다. 장애 시나리오 증거도 아직 없음 | | Pulsar | Experimental | 4.0 LTS + 4.2 | typed publish/consume, Shared, Key_Shared, schema | transaction 미승격, 기본 비활성 | | NATS JetStream | Experimental | 2.14.x | stream, durable consumer, explicit ACK, dedupe, replay | native DLQ 없음(플랫폼이 대행), 기본 비활성 | | Artemis/JMS | Extension | 범위 밖 | adapter SPI만 | 별도 ADR + Contract Suite 통과 필요 | @@ -153,3 +152,23 @@ delivery timeout으로 나타난다. 이를 `REJECTED`로 보고하는 것은 - 운영 application에서의 topology 파괴 작업 - 일반 애플리케이션에 raw broker client 반환 - DLQ publish 확인 전 source ACK + + +## R1 compiler status + +`adapter:outbound:messaging`의 contract/catalog/envelope compiler 군은 현재 **의도적으로 미배선**이다. +`DISABLED` + 빈 catalog/binding이 zero-resource 상태이며, 이 R1 compiler를 legacy +`MessagingConfig`에 연결해 Kafka ACK, wire compatibility, `ACTIVE_READY`, R2 qualification을 +주장하지 않는다. 코드는 다음 세대 계약을 보존하지만 현재 채택 경로가 아니며, 실제 활성화는 별도 R2 +composition/cutover에서 명시적으로 이뤄져야 한다. + + +### Optional mapping / bridge utilities + +- `messaging-cloudevents`는 starter runtime에 자동 편입되지 않는 **opt-in mapping utility**다. + 내부 envelope와 CloudEvent 객체 사이의 제한된 profile mapping을 제공하지만 binary/structured + CloudEvents wire mode 전체를 구현하거나 임의 CloudEvents producer와의 1.0 interoperability를 + 인증하지 않는다. +- `messaging-spring-cloud-stream-bridge`는 현재 `ChannelSend` seam과 publish-evidence 판단을 제공하는 + framework-neutral bridge contract다. Spring Cloud Stream `StreamBridge` dependency/auto-configuration은 + 제공하지 않으므로 shipped Spring Cloud Stream integration으로 분류하지 않는다. diff --git a/docs/mongo/persistence-profile.example.yml b/docs/mongo/persistence-profile.example.yml new file mode 100644 index 00000000..b277f475 --- /dev/null +++ b/docs/mongo/persistence-profile.example.yml @@ -0,0 +1,27 @@ +# Example only. This file is not loaded by Spring Boot. +# Copy the relevant block into deployment configuration and replace the secret reference. + +ca-skeleton: + persistence-mongo: + enabled: true + active-profile: primary + platform: + profiles: + primary: + uri-secret: secret://mongodb/primary + topology: REPLICA_SET + production: true + stable-api-strict: true + consistency-default: PRIMARY_MAJORITY + server-selection-timeout: 3s + connect-timeout: 2s + socket-read-timeout: 5s + operation-timeout: 3s + pool-min-size: 2 + pool-max-size: 40 + pool-max-wait-time: 500ms + uuid-representation: STANDARD + decimal-representation: DECIMAL128 + runtime-auto-create-indexes: false + tls-required: true + authentication-required: true diff --git a/docs/mongodb/repository-adaptation.md b/docs/mongodb/repository-adaptation.md index 553d48e4..de665c7f 100644 --- a/docs/mongodb/repository-adaptation.md +++ b/docs/mongodb/repository-adaptation.md @@ -90,7 +90,7 @@ otherwise. Being on the classpath is not being enabled. | Design assumption | Repository reality | Adaptation | |---|---|---| | Gradle Kotlin DSL under `modules/mongodb*` | Groovy DSL, root `build.gradle` conventions, `LockMode.STRICT` locking | Dependencies declared in `src/adapter/outbound/persistence-mongo/build.gradle`; `gradle.lockfile` regenerated. | -| `mongodb-spring-boot-starter` is a separate module the app depends on | `modules.json` gives `adapter-outbound-persistence-mongo` `runtime_memberships: []` and does **not** list it among `app-bootstrap`'s allowed dependencies | The `autoconfigure` package stays inside the leaf and registers through the leaf's own `META-INF/spring/…AutoConfiguration.imports`. This differs from the httpclient precedent, where the starter moved to `:app-bootstrap`; here the registry forbids that edge. | +| `mongodb-spring-boot-starter` is a separate module the app depends on | `modules.json` gives `adapter-outbound-persistence-mongo` an explicit project boundary; runtime membership is derived from resolved runtime classpaths rather than a per-leaf registry field | The `autoconfigure` package stays inside the leaf and registers through the leaf's own `META-INF/spring/…AutoConfiguration.imports`. This differs from the httpclient precedent; dependency and runtime-membership gates decide whether the leaf is actually composed. | | Spring Boot 4.1 / Spring Data MongoDB 5.1 baseline | Repository baseline is Spring Boot 4.0.8 / Spring Data MongoDB 5.0.x | The platform targets the Spring Data MongoDB **API surface** common to both; no 5.1-only type is referenced. The support matrix records the actual pinned versions. | | `MongoRetryScope` lives in `mongodb-transaction` | The `mongodb-spring-data` failure translator must classify retry scope, and it cannot depend on `mongodb-transaction` | `MongoRetryScope` lives in `…api.error` (core-api), which both packages already depend on. Same values, same meaning, one legal position in the DAG. | | `mongodb-migration-flamingock` depends on Flamingock | Adding an unvetted external dependency is out of scope for this task, and the design itself requires the public contract not to depend on Flamingock types | The adapter is provider-neutral: it consumes a platform-owned `FlamingockChangeUnitView`. Wiring an actual Flamingock distribution is a one-file change behind that view. | @@ -124,19 +124,17 @@ otherwise. Being on the classpath is not being enabled. ## 5. Verification -The two release-gate scripts (`scripts/verify-mongodb-platform.sh` and -`scripts/verify-mongodb-advanced.sh`) were removed on 2026-08-15. They wrapped the Gradle lanes below -and added two things Gradle does not do on its own: a lane that executed zero tests was reported as a -failure rather than counted as a pass, and a `promotion.json` recording the commit, server image and -contract-manifest hash. Neither exists until something replaces it, so a green run of the commands -below is weaker evidence than the gate was. +The release-gate scripts `scripts/verify-mongodb-platform.sh` and +`scripts/verify-mongodb-advanced.sh` are present and wrap the named Gradle lanes with no-skip evidence +and promotion metadata. Use them when producing release/promotion evidence; the focused commands +below remain useful for local diagnosis. From `src/`: ```bash ./gradlew :adapter:outbound:persistence-mongo:check --console=plain ./gradlew verifyCleanArchitectureDependencies --console=plain -./gradlew :app-bootstrap:test --tests '*CleanArchitectureTest' --console=plain +./gradlew :app-bootstrap:architectureTest --console=plain ``` The container-backed lanes the gate ran behind `MONGODB_DOCKER=1` — `mongoCompatibilityTest`, diff --git a/docs/notification/adr/NOTIF-ADR-005-canonical-namespace.md b/docs/notification/adr/NOTIF-ADR-005-canonical-namespace.md index a7b83d93..a3bf5c63 100644 --- a/docs/notification/adr/NOTIF-ADR-005-canonical-namespace.md +++ b/docs/notification/adr/NOTIF-ADR-005-canonical-namespace.md @@ -50,7 +50,7 @@ mapping 문서는 목록을 소유한다 — 목록을 두 곳에 복제하면 ## 강제 두 namespace 사이의 production dependency는 **0건**이며, 이것은 문서가 아니라 ArchUnit 규칙이 지킨다 -(`CleanArchitectureTest`의 `NOTIFICATION_R1_AND_PLATFORM_DO_NOT_DEPEND_ON_EACH_OTHER`). +(`ApplicationBoundaryArchitectureTest`의 `NOTIFICATION_R1_AND_PLATFORM_DO_NOT_DEPEND_ON_EACH_OTHER`). 변환이 필요해지면 `dev.caskeleton.application.notification.compatibility.r1` 한 패키지에만 두고, 그 패키지만 규칙에서 예외로 인정한다. 예외를 한 곳으로 모으는 것이 목적이다 — 두 모델이 서로를 아는 diff --git a/docs/notification/api-surface-snapshot.txt b/docs/notification/api-surface-snapshot.txt index 0dee0feb..5472b0df 100644 --- a/docs/notification/api-surface-snapshot.txt +++ b/docs/notification/api-surface-snapshot.txt @@ -3,18 +3,6 @@ # change: ./gradlew updateNotificationApiSurface -PapproveNotificationApiChange dev.caskeleton.adapter.outbound.notification.NotificationConfig dev.caskeleton.adapter.outbound.notification.NotificationRoutesSettings -dev.caskeleton.adapter.outbound.notification.catalog.CompiledNotificationBinding -dev.caskeleton.adapter.outbound.notification.catalog.NotificationBindingCompiler -dev.caskeleton.adapter.outbound.notification.catalog.NotificationCanonicalRouteCatalog -dev.caskeleton.adapter.outbound.notification.catalog.NotificationCatalogException -dev.caskeleton.adapter.outbound.notification.catalog.NotificationCutoverRouteCatalog -dev.caskeleton.adapter.outbound.notification.catalog.NotificationPlanAdapter -dev.caskeleton.adapter.outbound.notification.catalog.NotificationProviderCapabilityCard -dev.caskeleton.adapter.outbound.notification.catalog.NotificationProviderCapabilityDescriptorSource -dev.caskeleton.adapter.outbound.notification.catalog.NotificationProviderDescriptor -dev.caskeleton.adapter.outbound.notification.catalog.NotificationProviderRuntimeProfile -dev.caskeleton.adapter.outbound.notification.catalog.NotificationRouteDescriptor -dev.caskeleton.adapter.outbound.notification.catalog.NotificationTemplateDescriptor dev.caskeleton.adapter.outbound.notification.core.FailOpenNotificationProvider dev.caskeleton.adapter.outbound.notification.core.NotificationProvider dev.caskeleton.adapter.outbound.notification.core.RoutingNotifier @@ -32,8 +20,14 @@ dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.Notification dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.ProviderRuntimeAssembler dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.ProviderType dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.SmtpProviderRuntimeAssembler +dev.caskeleton.adapter.outbound.notification.platform.callback.CallbackLimits +dev.caskeleton.adapter.outbound.notification.platform.callback.CallbackVerificationResult dev.caskeleton.adapter.outbound.notification.platform.callback.MapProviderCallbackAdapterRegistry dev.caskeleton.adapter.outbound.notification.platform.callback.MapProviderEventProjectorRegistry +dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackAdapter +dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackAdapterRegistry +dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackVerificationRequest +dev.caskeleton.adapter.outbound.notification.platform.callback.VerifiedCallback dev.caskeleton.adapter.outbound.notification.platform.dispatch.AttemptPermit dev.caskeleton.adapter.outbound.notification.platform.dispatch.CapabilityReconciliationGateway dev.caskeleton.adapter.outbound.notification.platform.dispatch.ConfiguredProfileCatalog @@ -150,31 +144,9 @@ dev.caskeleton.adapter.outbound.notification.platform.template.TemplateSlotMode dev.caskeleton.adapter.outbound.notification.platform.template.TemplateSlotPolicy dev.caskeleton.adapter.outbound.notification.platform.template.ThymeleafNotificationRenderer dev.caskeleton.adapter.outbound.notification.platform.template.ThymeleafStringTemplateEngine -dev.caskeleton.adapter.outbound.notification.provider.AttemptCorrelationId -dev.caskeleton.adapter.outbound.notification.provider.InlineNotificationAttemptAdapter -dev.caskeleton.adapter.outbound.notification.provider.NotificationAdmissionReadinessAdapter -dev.caskeleton.adapter.outbound.notification.provider.NotificationAttemptContext -dev.caskeleton.adapter.outbound.notification.provider.NotificationProviderAttemptAdapter -dev.caskeleton.adapter.outbound.notification.provider.NotificationProviderAttemptClient -dev.caskeleton.adapter.outbound.notification.provider.NotificationProviderRateAdmission -dev.caskeleton.adapter.outbound.notification.provider.NotificationProviderReadinessProbe -dev.caskeleton.adapter.outbound.notification.provider.NotificationProviderReadinessSnapshot -dev.caskeleton.adapter.outbound.notification.provider.NotificationProviderSecretMaterialProvider -dev.caskeleton.adapter.outbound.notification.provider.NotificationReconciliationAdapter -dev.caskeleton.adapter.outbound.notification.provider.NotificationSecretMaterialHandle -dev.caskeleton.adapter.outbound.notification.provider.PreparedNotificationAttempt -dev.caskeleton.adapter.outbound.notification.provider.ProviderMessageReference -dev.caskeleton.adapter.outbound.notification.provider.ReconciliationLookupMode dev.caskeleton.adapter.outbound.notification.slack.webhook.SlackClient dev.caskeleton.adapter.outbound.notification.slack.webhook.SlackNotificationAdapterConfig dev.caskeleton.adapter.outbound.notification.slack.webhook.SlackWebhookProvider -dev.caskeleton.adapter.outbound.notification.template.LocalEmailRenderer -dev.caskeleton.adapter.outbound.notification.template.NotificationTemplateCatalog -dev.caskeleton.adapter.outbound.notification.template.NotificationTemplateManifest -dev.caskeleton.adapter.outbound.notification.template.NotificationTemplateRenderer -dev.caskeleton.adapter.outbound.notification.template.RenderedNotification -dev.caskeleton.adapter.outbound.notification.template.SlackBlockKitRenderer -dev.caskeleton.adapter.outbound.notification.template.TemplateRenderingException dev.caskeleton.application.notification.ApplyNotificationReceiptCommand dev.caskeleton.application.notification.ApplyNotificationReceiptResult dev.caskeleton.application.notification.ApplyNotificationReceiptUseCase @@ -292,7 +264,6 @@ dev.caskeleton.application.notification.platform.admin.RedriveCommand dev.caskeleton.application.notification.platform.admin.SetProviderStateCommand dev.caskeleton.application.notification.platform.admin.SuppressCommand dev.caskeleton.application.notification.platform.api.CallbackIngestionResult -dev.caskeleton.application.notification.platform.api.CallbackRequest dev.caskeleton.application.notification.platform.api.CancelCommand dev.caskeleton.application.notification.platform.api.CancelResult dev.caskeleton.application.notification.platform.api.ChannelPreferenceOverride @@ -306,6 +277,8 @@ dev.caskeleton.application.notification.platform.api.DeduplicationSpec dev.caskeleton.application.notification.platform.api.DeliveryAttemptId dev.caskeleton.application.notification.platform.api.EncodedNotificationPlan dev.caskeleton.application.notification.platform.api.IdempotencyKey +dev.caskeleton.application.notification.platform.api.NormalizedEventType +dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent dev.caskeleton.application.notification.platform.api.NotificationAcceptance dev.caskeleton.application.notification.platform.api.NotificationId dev.caskeleton.application.notification.platform.api.NotificationOrchestrator @@ -372,22 +345,16 @@ dev.caskeleton.application.notification.platform.api.routing.DeliveryStrategy dev.caskeleton.application.notification.platform.api.routing.ExplicitChannel dev.caskeleton.application.notification.platform.api.routing.OrderedFallback dev.caskeleton.application.notification.platform.callback.AppendEventResult -dev.caskeleton.application.notification.platform.callback.CallbackLimits dev.caskeleton.application.notification.platform.callback.CallbackPayloadProtectionPort -dev.caskeleton.application.notification.platform.callback.CallbackVerificationResult dev.caskeleton.application.notification.platform.callback.DeliveryAttemptResolverPort dev.caskeleton.application.notification.platform.callback.DeliveryAttemptSnapshot dev.caskeleton.application.notification.platform.callback.DeliveryProjection dev.caskeleton.application.notification.platform.callback.DeliveryProjectionStorePort dev.caskeleton.application.notification.platform.callback.EngagementFacts dev.caskeleton.application.notification.platform.callback.IngestProviderCallbackApplicationUseCase -dev.caskeleton.application.notification.platform.callback.NormalizedEventType -dev.caskeleton.application.notification.platform.callback.NormalizedProviderEvent dev.caskeleton.application.notification.platform.callback.NotificationSideEffectPort dev.caskeleton.application.notification.platform.callback.ProjectionResult dev.caskeleton.application.notification.platform.callback.ProjectionStatus -dev.caskeleton.application.notification.platform.callback.ProviderCallbackAdapter -dev.caskeleton.application.notification.platform.callback.ProviderCallbackAdapterRegistry dev.caskeleton.application.notification.platform.callback.ProviderEventLedger dev.caskeleton.application.notification.platform.callback.ProviderEventProjectionService dev.caskeleton.application.notification.platform.callback.ProviderEventProjector @@ -398,7 +365,6 @@ dev.caskeleton.application.notification.platform.callback.ProviderEventSource dev.caskeleton.application.notification.platform.callback.ProviderRequestIdHash dev.caskeleton.application.notification.platform.callback.StandardDeliveryProjector dev.caskeleton.application.notification.platform.callback.SuppressionFacts -dev.caskeleton.application.notification.platform.callback.VerifiedCallback dev.caskeleton.application.notification.platform.callback.VerifiedProviderEvent dev.caskeleton.application.notification.platform.contact.ApnsDeviceToken dev.caskeleton.application.notification.platform.contact.ApnsEnvironment diff --git a/docs/notification/configuration-reference.md b/docs/notification/configuration-reference.md index 9512ba13..b68c1664 100644 --- a/docs/notification/configuration-reference.md +++ b/docs/notification/configuration-reference.md @@ -54,9 +54,10 @@ nonce and tag. A larger configured value would pass every check above the databa ## Provider profiles -Profiles are a map under `providers`, keyed by profile id. There are no environment variables for -them, because the keys are deployment-chosen; supply them as YAML or as -`CA_SKELETON_NOTIFICATION_PLATFORM_PROVIDERS__`. +Profiles are a map under `providers`, keyed by profile id. Arbitrary deployment-chosen ids can be +supplied as YAML or through Spring relaxed binding (`CA_SKELETON_NOTIFICATION_PLATFORM_PROVIDERS__`). +The shipped reference profiles `smtp` and `ses` additionally expose explicit `APP_NOTIFICATION_PLATFORM_SMTP_*` +and `APP_NOTIFICATION_PLATFORM_SES_*` aliases so operators do not have to invent binding names. | Field | Meaning | |---|---| @@ -64,7 +65,7 @@ them, because the keys are deployment-chosen; supply them as YAML or as | `enabled` | A disabled profile is bound and validated but contributes no runtime | | `primary-for-channel` | Exactly one primary per channel | | `environment` | Required when enabled | -| `credential-profile` | Resolved through `SecretMaterialProvider`; never an inline secret | +| `credential-profile` | Provider credential key id resolved through `SecretMaterialProvider`; never inline secret material | | `topic` | APNs bundle id | | `vapid-public-key` | Web Push application server key | | `callback-signing-secret-ref` | Reference, not material | @@ -75,6 +76,41 @@ them, because the keys are deployment-chosen; supply them as YAML or as A profile pins provider type, environment, credential profile, timeouts, concurrency and rate limit. Sender identity and credential profile are separate concerns. +### SES profile fields + +An enabled SES profile adds a typed `ses` block: + +| Field | Meaning | +|---|---| +| `ses.endpoint` | SES API base URI; the mapper appends `/v2/email/outbound-emails` | +| `ses.region` | SigV4 region | +| `ses.sender-identity` | verified SES From identity | +| `ses.access-key-id` | AWS access key id; identifier only, not secret material | +| `ses.configuration-set` | optional SES configuration-set name | +| `credential-profile` | key id for the secret access-key material; generation 1 is activated at assembly | + +The shipped reference profile is `providers.ses` and is disabled by default. It is controlled by +`APP_NOTIFICATION_PLATFORM_SES_*`; its secret material comes from +`APP_NOTIFICATION_PLATFORM_PROVIDER_CREDENTIAL_KEY`, whose active key id must match +`APP_NOTIFICATION_PLATFORM_SES_CREDENTIAL_KEY_ID`. + +`type` is the closed **provider model**, not a promise that the shipped composition contains a +dispatch assembler for every value. Current shipped reachability is: + +| Provider type | Contract/adapter code | Shipped dispatch assembler | Shipped callback assembler | What happens when enabled for dispatch | +|---|---|---|---|---| +| `SMTP` | yes | **yes** | no | assembles when Spring Mail relay settings are complete | +| `SES` | yes | **yes** | **yes** | assembles an EMAIL runtime from the typed `ses` block; SNS callback verification remains available in `INGEST_ONLY` | +| `TWILIO` | yes | no | no | dispatch fails startup by profile name | +| `FCM` | yes | no | no | dispatch fails startup by profile name | +| `APNS` | yes | no | no | dispatch fails startup by profile name | +| `WEB_PUSH` | yes | no | no | dispatch fails startup by profile name | +| `WEBHOOK` | yes | no | no | dispatch fails startup by profile name | + +This distinction is deliberate: tested provider protocol code is not the same thing as a +composition-reachable provider. Adding a family to the shipped runtime requires a +`ProviderRuntimeAssembler` plus the settings/secret inputs that adapter actually needs. + ## SMTP relay The one provider profile the template ships, off. A deployment that wants the common case sets @@ -98,15 +134,16 @@ already owns them and a second spelling would be a second thing to keep in step. | Property | Environment variable | Default | Bound | |---|---|---|---| -| `smtp.tls-mode` | `APP_NOTIFICATION_PLATFORM_SMTP_TLS_MODE` | `STARTTLS_REQUIRED` | `STARTTLS_REQUIRED` or `IMPLICIT_TLS` | | `smtp.sender-identity` | `APP_NOTIFICATION_PLATFORM_SMTP_SENDER_IDENTITY` | `no-reply@example.invalid` | address | -| `smtp.connect-timeout` | `APP_NOTIFICATION_PLATFORM_SMTP_CONNECT_TIMEOUT` | `5s` | positive, finite | -| `smtp.read-timeout` | `APP_NOTIFICATION_PLATFORM_SMTP_READ_TIMEOUT` | `10s` | positive, finite | -| `smtp.write-timeout` | `APP_NOTIFICATION_PLATFORM_SMTP_WRITE_TIMEOUT` | `10s` | positive, finite | | `smtp.max-concurrency` | `APP_NOTIFICATION_PLATFORM_SMTP_DISPATCH_CONCURRENCY` | `4` | positive | -The TLS mode enum has no plaintext member. An unencrypted relay is refused by construction rather -than by a validator somebody has to remember to run. +SMTP transport configuration has one owner: Spring Mail. The actual `JavaMailSenderImpl` must use required STARTTLS (`mail.smtp.starttls.enable=true` plus `mail.smtp.starttls.required=true`) or implicit TLS (`mail.smtp.ssl.enable=true`). It must also have positive `mail.smtp.connectiontimeout`, `mail.smtp.timeout`, and `mail.smtp.writetimeout` values. SMTP assembly fails before serving traffic when those properties are absent or invalid. + +The native environment contract is `SPRING_MAIL_HOST`, `SPRING_MAIL_PORT`, optional +`SPRING_MAIL_USERNAME` / secret `SPRING_MAIL_PASSWORD`, plus the +`SPRING_MAIL_PROPERTIES_MAIL_SMTP_*` TLS and timeout keys listed in `.env.example`. These names stay +Spring-native because Spring Boot itself owns and consumes `spring.mail.*`; the notification module +does not create a second alias for the same relay. The default sender is an RFC 2606 reserved domain that resolves nowhere, so a deployment that forgot to set one produces a traceable bounce instead of mail apparently sent from an address it does not diff --git a/docs/notification/evidence-manifest.json b/docs/notification/evidence-manifest.json index edbb148a..d97dcedc 100644 --- a/docs/notification/evidence-manifest.json +++ b/docs/notification/evidence-manifest.json @@ -32,10 +32,13 @@ "callback-supported": { "requires": "signature verification, duplicate suppression, and an event that arrives before its attempt is stored", "status": "satisfied", - "lane": ":adapter:outbound:persistence-jpa:jpaPlatformContractTest", + "lanes": [ + ":adapter:outbound:persistence-jpa:jpaPlatformContractTest", + ":application-notification:test" + ], "evidence": [ "adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/notification/LateEventBindingContractTest.java", - "application-core/src/test/java/dev/caskeleton/application/notification/platform/callback/CallbackIngestionAtomicityTest.java" + "application-notification/src/test/java/dev/caskeleton/application/notification/platform/callback/CallbackIngestionAtomicityTest.java" ] }, "recoverable": { diff --git a/docs/notification/migration-guide.md b/docs/notification/migration-guide.md index 4269cbb4..7880e87e 100644 --- a/docs/notification/migration-guide.md +++ b/docs/notification/migration-guide.md @@ -37,8 +37,11 @@ R1 public type 100개를 어떻게 할 것인지 다루지 않았다. 그래서 문서 어디에도 답이 없었다. - **canonical은 `..notification.platform..`이다.** NOTIF-ADR-005가 근거와 함께 정한다. -- **R1은 남지만 새 production consumer를 받지 않는다.** 삭제 계획은 별개이며, R0 삭제와 함께 - 사라지지 않는다. +- **application R1 public contract는 남지만 새 production consumer를 받지 않는다.** 삭제 계획은 + 별개이며, R0 삭제와 함께 사라지지 않는다. +- R1을 따라 만들어졌지만 composition root에서 한 번도 조립되지 않았던 outbound adapter의 + `catalog/`, `provider/`, `template/` 실험 구현은 제거했다. 실제 runtime은 + `dev.caskeleton.adapter.outbound.notification.platform..`만 사용한다. - **전수 분류표는 `docs/notification/module-mapping.md`에 있다** (replace / bridge / retain / delete). - **두 namespace 간 production dependency는 0건이며 ArchUnit이 강제한다.** 변환이 필요하면 `dev.caskeleton.application.notification.compatibility.r1` 한 곳에만 둔다. diff --git a/docs/notification/module-mapping.md b/docs/notification/module-mapping.md index 166695c3..7b2e6515 100644 --- a/docs/notification/module-mapping.md +++ b/docs/notification/module-mapping.md @@ -51,7 +51,7 @@ that owns its responsibility. No public contract, evidence rule, or reliability | `notification-observability` (Micrometer impl) | `adapter:outbound:notification` | `…platform.observation` | | `notification-admin-runtime` | `adapter:outbound:notification` | `…platform.admin` | | `notification-reactor` | `adapter:outbound:notification` | `…platform.reactor` | -| `notification-spring-boot-starter` | `adapter:outbound:notification` (+ `app-bootstrap` wiring) | `…platform.autoconfigure` | +| `notification-spring-boot-starter` | `adapter:outbound:notification` | `…platform.autoconfigure` | | `notification-persistence-jpa` | `adapter:outbound:persistence-jpa` | `dev.caskeleton.adapter.outbound.persistence.notification.platform` | | `notification-inbox-jpa` | `adapter:outbound:persistence-jpa` | `…persistence.notification.platform.inbox` | | `notification-callback-mvc` | `adapter:inbound:web` | `dev.caskeleton.adapter.inbound.web.notification.platform.callback` | @@ -93,13 +93,31 @@ Two plan edges cannot be expressed as project edges in this repository, and are is therefore intentionally **not** executed by the agent; the working tree carries the change and the human owner commits. +## Runtime reachability after the R1 adapter cleanup + +The application R1 contract covered by NOTIF-ADR-005 is a separate question from the abandoned +outbound implementation that had been built around it. The latter is gone: the notification leaf no +longer contains top-level `catalog/`, `provider/`, or `template/` R1 adapter packages. They had no +production composition consumer and were proved only by their own fakes. + +The useful rendering invariant from that experiment was not discarded. R2 +`platform.template.TemplateSlotPolicy` now validates the final HTML against the reviewed tag and +attribute subset in addition to escaping substituted values. Active script markup, event-handler +attributes and non-HTTPS HTML links are refused. + +R2 provider protocol packages remain because they implement the canonical platform SPI and have +contract tests. Their presence does **not** make them shipped dispatch runtimes. Current composition +reachability is SMTP and SES for dispatch, with SES also available for callback ingestion; the remaining +provider packages are extension assets until a composition contributes a `ProviderRuntimeAssembler` +with the settings and secret sources that family requires. See `support-matrix.md` for the explicit table. + ## R1 public type disposition (NOTIF-ADR-005) NOTIF-ADR-005 makes `..notification.platform..` canonical and keeps the R1 namespace in place without new consumers. The ADR owns the rule; this table owns the list, so the two do not drift apart by being written twice. -`NOTIFICATION_R1_AND_PLATFORM_DO_NOT_DEPEND_ON_EACH_OTHER` in `CleanArchitectureTest` enforces the +`NOTIFICATION_R1_AND_PLATFORM_DO_NOT_DEPEND_ON_EACH_OTHER` in `ApplicationBoundaryArchitectureTest` enforces the boundary: production dependencies between the two namespaces are zero, and the only permitted exception is `dev.caskeleton.application.notification.compatibility.r1`. diff --git a/docs/notification/support-matrix.md b/docs/notification/support-matrix.md index d70d5de2..54dec6d3 100644 --- a/docs/notification/support-matrix.md +++ b/docs/notification/support-matrix.md @@ -24,6 +24,25 @@ against real PostgreSQL; the wire and the crash are not. That is what the grade | In-app inbox | Own database | Optional stable | `PERSISTED`, `SEEN`, `READ` | | Webhook | HTTP client platform | Extension | Whatever the receiving HTTP contract states | +## Shipped provider assembly reachability + +The grade above describes protocol/reliability evidence. It does **not** mean every reference +implementation is selectable in the default composition. Dispatch reachability is a separate axis: + +| Provider family | Dispatch assembler in shipped composition | Callback assembler | Current use | +|---|---|---|---| +| SMTP | **yes** | no | EMAIL dispatch reference family | +| SES | **yes** | **yes** | EMAIL dispatch + SNS callback ingestion; disabled reference profile ships in `config/notification.yml` | +| Twilio | no | no | contract implementation / extension wiring | +| FCM | no | no | contract implementation / extension wiring | +| APNs | no | no | contract implementation / extension wiring | +| Web Push | no | no | contract implementation / extension wiring | +| Webhook | no | no | extension wiring | + +An enabled dispatch profile with no assembler fails startup by profile/family; it never silently +assembles into an empty runtime. SMTP additionally names `spring.mail.host` when its shipped +assembler is absent because the relay was not configured. + ## What each grade requires | Grade | Requires | diff --git a/docs/objectstorage/env-fields.yaml b/docs/objectstorage/env-fields.yaml new file mode 100644 index 00000000..4101c498 --- /dev/null +++ b/docs/objectstorage/env-fields.yaml @@ -0,0 +1,149 @@ +# Object Storage capability — Spring field path to environment-variable template. +# +# SSOT for deployment-facing app.object-storage.* names. Map placeholders are symbolic: +# PROVIDER, DESTINATION and PROFILE are replaced by the configured map key. +# +# The Java records remain the type/default authority. ObjectStorageEnvManifestTest derives their +# field paths and fails when this manifest drifts. scan-maintenance.enabled is a conditional-only +# property and is therefore listed as an explicit extra. +fields: + - field: enabled + env: APP_OBJECT_STORAGE_ENABLED + - field: default-destination + env: APP_OBJECT_STORAGE_DEFAULT_DESTINATION + - field: providers[PROVIDER].type + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_TYPE + - field: providers[PROVIDER].version + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_VERSION + - field: providers[PROVIDER].root + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_ROOT + - field: providers[PROVIDER].maximum-object-bytes + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_MAXIMUM_OBJECT_BYTES + - field: providers[PROVIDER].chunk-bytes + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_CHUNK_BYTES + - field: providers[PROVIDER].s3.provider-version + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_PROVIDER_VERSION + - field: providers[PROVIDER].s3.bucket + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_BUCKET + - field: providers[PROVIDER].s3.region + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_REGION + - field: providers[PROVIDER].s3.expected-owner + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_EXPECTED_OWNER + - field: providers[PROVIDER].s3.deployment-identity + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_DEPLOYMENT_IDENTITY + - field: providers[PROVIDER].s3.endpoint-override + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_ENDPOINT_OVERRIDE + - field: providers[PROVIDER].s3.addressing + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_ADDRESSING + - field: providers[PROVIDER].s3.auto-create-bucket + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_AUTO_CREATE_BUCKET + - field: providers[PROVIDER].s3.public-acl + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_PUBLIC_ACL + - field: providers[PROVIDER].s3.credentials.mode + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CREDENTIALS_MODE + - field: providers[PROVIDER].s3.credentials.access-key-environment + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CREDENTIALS_ACCESS_KEY_ENVIRONMENT + - field: providers[PROVIDER].s3.credentials.secret-key-environment + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CREDENTIALS_SECRET_KEY_ENVIRONMENT + - field: providers[PROVIDER].s3.timeouts.api-call + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_TIMEOUTS_API_CALL + - field: providers[PROVIDER].s3.timeouts.api-attempt + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_TIMEOUTS_API_ATTEMPT + - field: providers[PROVIDER].s3.timeouts.connect + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_TIMEOUTS_CONNECT + - field: providers[PROVIDER].s3.timeouts.tls-negotiation + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_TIMEOUTS_TLS_NEGOTIATION + - field: providers[PROVIDER].s3.timeouts.acquire + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_TIMEOUTS_ACQUIRE + - field: providers[PROVIDER].s3.timeouts.read + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_TIMEOUTS_READ + - field: providers[PROVIDER].s3.timeouts.write + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_TIMEOUTS_WRITE + - field: providers[PROVIDER].s3.pool.maximum-concurrency + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_POOL_MAXIMUM_CONCURRENCY + - field: providers[PROVIDER].s3.pool.maximum-pending-acquires + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_POOL_MAXIMUM_PENDING_ACQUIRES + - field: providers[PROVIDER].s3.retry.maximum-attempts + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_RETRY_MAXIMUM_ATTEMPTS + - field: providers[PROVIDER].s3.retry.base-delay + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_RETRY_BASE_DELAY + - field: providers[PROVIDER].s3.retry.maximum-backoff + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_RETRY_MAXIMUM_BACKOFF + - field: providers[PROVIDER].s3.shutdown-grace + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_SHUTDOWN_GRACE + - field: providers[PROVIDER].s3.binding-revision + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_BINDING_REVISION + - field: providers[PROVIDER].s3.evidence-revision + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_EVIDENCE_REVISION + - field: providers[PROVIDER].s3.capability-profiles[PROFILE].status + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CAPABILITY_PROFILES_PROFILE_STATUS + - field: providers[PROVIDER].s3.capability-profiles[PROFILE].source + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CAPABILITY_PROFILES_PROFILE_SOURCE + - field: providers[PROVIDER].s3.capability-profiles[PROFILE].evidence-digest + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CAPABILITY_PROFILES_PROFILE_EVIDENCE_DIGEST + - field: providers[PROVIDER].s3.capability-profiles[PROFILE].observed-at + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CAPABILITY_PROFILES_PROFILE_OBSERVED_AT + - field: providers[PROVIDER].s3.capability-profiles[PROFILE].valid-until + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CAPABILITY_PROFILES_PROFILE_VALID_UNTIL + - field: providers[PROVIDER].s3.capability-profiles[PROFILE].provider-and-deployment-identity + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CAPABILITY_PROFILES_PROFILE_PROVIDER_AND_DEPLOYMENT_IDENTITY + - field: providers[PROVIDER].s3.capability-profiles[PROFILE].capabilities + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CAPABILITY_PROFILES_PROFILE_CAPABILITIES + - field: providers[PROVIDER].s3.capability-profiles[PROFILE].limitations + env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CAPABILITY_PROFILES_PROFILE_LIMITATIONS + - field: destinations[DESTINATION].provider-ref + env: APP_OBJECT_STORAGE_DESTINATIONS_DESTINATION_PROVIDER_REF + - field: destinations[DESTINATION].route-token + env: APP_OBJECT_STORAGE_DESTINATIONS_DESTINATION_ROUTE_TOKEN + - field: destinations[DESTINATION].binding-revision + env: APP_OBJECT_STORAGE_DESTINATIONS_DESTINATION_BINDING_REVISION + - field: destinations[DESTINATION].policy-revision + env: APP_OBJECT_STORAGE_DESTINATIONS_DESTINATION_POLICY_REVISION + - field: destinations[DESTINATION].publication-requirement + env: APP_OBJECT_STORAGE_DESTINATIONS_DESTINATION_PUBLICATION_REQUIREMENT + - field: destinations[DESTINATION].retention-requirement + env: APP_OBJECT_STORAGE_DESTINATIONS_DESTINATION_RETENTION_REQUIREMENT + - field: destinations[DESTINATION].encryption-requirement + env: APP_OBJECT_STORAGE_DESTINATIONS_DESTINATION_ENCRYPTION_REQUIREMENT + - field: destinations[DESTINATION].capability-requirements + env: APP_OBJECT_STORAGE_DESTINATIONS_DESTINATION_CAPABILITY_REQUIREMENTS + - field: destinations[DESTINATION].minimum-replay-horizon + env: APP_OBJECT_STORAGE_DESTINATIONS_DESTINATION_MINIMUM_REPLAY_HORIZON + - field: destinations[DESTINATION].operation-profile + env: APP_OBJECT_STORAGE_DESTINATIONS_DESTINATION_OPERATION_PROFILE + - field: legacy.enabled + env: APP_OBJECT_STORAGE_LEGACY_ENABLED + - field: legacy.backend + env: APP_OBJECT_STORAGE_LEGACY_BACKEND + - field: legacy.base-path + env: APP_OBJECT_STORAGE_LEGACY_BASE_PATH + - field: legacy.bucket + env: APP_OBJECT_STORAGE_LEGACY_BUCKET + - field: legacy.endpoint + env: APP_OBJECT_STORAGE_LEGACY_ENDPOINT + - field: legacy.region + env: APP_OBJECT_STORAGE_LEGACY_REGION + - field: legacy.access-key + env: APP_OBJECT_STORAGE_LEGACY_ACCESS_KEY + - field: legacy.secret-key + env: APP_OBJECT_STORAGE_LEGACY_SECRET_KEY + - field: legacy.path-style-access + env: APP_OBJECT_STORAGE_LEGACY_PATH_STYLE_ACCESS + - field: legacy.auto-create-bucket + env: APP_OBJECT_STORAGE_LEGACY_AUTO_CREATE_BUCKET + - field: legacy-adoption.enabled + env: APP_OBJECT_STORAGE_LEGACY_ADOPTION_ENABLED + - field: legacy-adoption.mode + env: APP_OBJECT_STORAGE_LEGACY_ADOPTION_MODE + - field: legacy-adoption.report-path + env: APP_OBJECT_STORAGE_LEGACY_ADOPTION_REPORT_PATH + - field: legacy-adoption.reviewed-manifest-path + env: APP_OBJECT_STORAGE_LEGACY_ADOPTION_REVIEWED_MANIFEST_PATH + - field: legacy-adoption.reviewed-manifest-sha256 + env: APP_OBJECT_STORAGE_LEGACY_ADOPTION_REVIEWED_MANIFEST_SHA256 + - field: legacy-adoption.batch-size + env: APP_OBJECT_STORAGE_LEGACY_ADOPTION_BATCH_SIZE + - field: legacy-adoption.operation-timeout + env: APP_OBJECT_STORAGE_LEGACY_ADOPTION_OPERATION_TIMEOUT + - field: scan-maintenance.enabled + env: APP_OBJECT_STORAGE_SCAN_MAINTENANCE_ENABLED diff --git a/docs/observability/log-fields.md b/docs/observability/log-fields.md new file mode 100644 index 00000000..e7177ec6 --- /dev/null +++ b/docs/observability/log-fields.md @@ -0,0 +1,67 @@ +# Structured log field dictionary + +This file is the naming SSOT for structured fields emitted by application/bootstrap runtime code. +A new field should be added here before it becomes a new search/filter dimension. + +The message text is for humans. These fields are the stable machine-query surface. + +## Startup and error classification + +| Field | Meaning | Cardinality expectation | +|---|---|---| +| `startup.phase` | Startup phase such as env-validation, migration or adapter-check | bounded | +| `error.code` | Stable error-code registry value | bounded | +| `error.category` | Stable error category | bounded | +| `error.root_cause.class` | Root exception class for startup failure diagnosis | bounded by codebase/dependencies | +| `error.root_cause.message` | Root exception message | unbounded; diagnosis only, not metric/tag material | + +Startup failures go through `StartupFailures`; callers do not construct their own startup error +classification. + +## Runtime warning and retry classification + +| Field | Meaning | Cardinality expectation | +|---|---|---| +| `warning.kind` | Stable warning shape, for example `meter-unavailable`, `setting-fallback`, `scheduled-task-failed`, `lease-expired-before-close` | bounded | +| `capability` | Capability that emitted the runtime event, for example `fileserver`, `outbox`, `distributed-lock` | bounded | +| `operation` | Bounded operation name such as `cleanup` or `relay` | bounded | +| `retry.disposition` | What the runtime will do after the event, for example `next-run` or `next-tick` | bounded | +| `meter` | Meter name or bounded meter operation that could not be updated | bounded by metrics registry | +| `env.key` | Configuration key involved in a fallback | bounded by env registry | +| `setting.rejected` | Rejected setting value rendered for diagnosis | potentially unbounded; never metric/tag material | +| `setting.applied` | Fallback value actually applied | bounded where possible | + +A retry disposition does not imply an `error.code`. Add an error code only when the failure is +actually classified by the error registry. + +## Fileserver cleanup + +| Field | Meaning | +|---|---| +| `cleanup.deleted` | Objects deleted in one bounded cleanup run | +| `cleanup.skipped_active_lease` | Items skipped because an active upload lease still owns them | +| `cleanup.skipped_state_changed` | Items skipped because state changed after queueing | +| `cleanup.failed` | Cleanup items that failed in the batch | +| `cleanup.reclaimed_bytes` | Bytes reclaimed in the batch | + +These are numeric event fields. They are not identity fields. + +## Background executor rejection + +| Field | Meaning | +|---|---| +| `executor_name` | Bounded executor identifier | +| `policy` | Rejection policy, currently `AbortPolicy` | +| `queue_size` | Queue size observed at rejection | + +Executor rejection also carries `error.code=JOB_EXECUTOR_REJECTED` and its `error.category`. + +## Cardinality and sensitive identifiers + +Do not promote arbitrary identifiers to structured fields merely because they are useful in one +incident. Examples include distributed-lock keys, object keys, raw user identifiers, request +payloads and secret values. + +The distributed-lock lease-expiry warning intentionally keeps the lock key only in human-readable +message text and does not emit `lock.key`. If a future operational requirement needs a searchable +lock identity, define a bounded/pseudonymized contract first instead of adding the raw key. diff --git a/docs/registries/capabilities.yaml b/docs/registries/capabilities.yaml index b3edb54a..2fc161d4 100644 --- a/docs/registries/capabilities.yaml +++ b/docs/registries/capabilities.yaml @@ -1,5 +1,4 @@ # Registry: Repository Access Capabilities -# SSOT: wiki/projects/ca-tmpl/registries/capabilities.yaml # Schema owner: feature-contract-registry-governance # Owner branch: feature-repository-access-permission-contract # Last updated: 2026-06-05 diff --git a/docs/registries/env-keys.yaml b/docs/registries/env-keys.yaml index 791c232a..c8372fa0 100644 --- a/docs/registries/env-keys.yaml +++ b/docs/registries/env-keys.yaml @@ -1,5 +1,4 @@ # Registry: Env Keys -# SSOT: wiki/projects/ca-tmpl/registries/env-keys.yaml # Schema owner: feature-contract-registry-governance # Owner branch: feature-env-driven-runtime-configuration # Last updated: 2026-07-28 @@ -39,7 +38,7 @@ env_keys: # APP_PROFILE intentionally removed (D6, 2026-06-06): profile = SPRING_PROFILES_ACTIVE # alone. A duplicate APP_PROFILE would only add information doubling + mismatch-fail - # cost. See branch note feature-env-driven-runtime-configuration Claims (wont-fix). + # cost. See design record feature-env-driven-runtime-configuration Claims (wont-fix). - name: APP_NAME # source: feature-env-driven-runtime-configuration 2026-05-22 @@ -116,10 +115,11 @@ env_keys: required_test: env-contract:server-shutdown-timeout-aligned - name: APP_SERVER_FORWARD_HEADERS_STRATEGY - # source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ unification - # (trust X-Forwarded-* when behind LB/proxy) + # source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ unification. + # Fail closed: forwarded headers are trusted only when a deployment opts in behind a + # sanitizing/trusted proxy. type: enum - default: framework + default: none allowed_values: [none, native, framework] classification: public-config required: false @@ -255,36 +255,6 @@ env_keys: compatibility_impact: behavior-change required_test: env-contract:server-error-message-policy - # === Error exposure / body logging (env-driven branch "Required config: error exposure, log") === - - - name: APP_ERROR_DETAIL_EXPOSURE_ENABLED - # source: feature-env-driven-runtime-configuration 2026-05-22 - # "prod profile에서 body logging과 internal error detail exposure는 기본 금지" - type: boolean - default: false - allowed_values: [true, false] - classification: public-config - required: true - reload_policy: restart-only - owner_branch: feature-env-driven-runtime-configuration - validation: prod_profile_must_be_false - compatibility_impact: behavior-change - required_test: env-contract:error-exposure-prod-safe - - - name: APP_LOG_BODY_CAPTURE_ENABLED - # source: feature-env-driven-runtime-configuration 2026-05-22 "prod profile에서 body logging ... 기본 금지" - # + feature-log-management-contract "request body capture filter — allowlist 없이는 capture 자체 금지" - type: boolean - default: false - allowed_values: [true, false] - classification: public-config - required: true - reload_policy: restart-only - owner_branch: feature-env-driven-runtime-configuration - validation: prod_profile_must_be_false - compatibility_impact: behavior-change - required_test: env-contract:body-logging-prod-safe - - name: APP_MULTI_INSTANCE_ENABLED # source: feature-env-driven-runtime-configuration D8 (2026-06-06) # When true, StartupSafetyValidator (SmartInitializingSingleton) requires the 5 @@ -362,6 +332,66 @@ env_keys: compatibility_impact: breaking required_test: secrets-contract:db-password-not-leaked + - name: APP_PERSISTENCE_VENDOR + # source: persistence vendor selector used by application-local.yml and bootRunH2. + # PostgreSQL is the shipped default; H2 is an explicit developer-only selection. + property: ca-skeleton.persistence.vendor + type: enum + default: postgresql + allowed_values: [postgresql, h2] + classification: public-config + required: false + reload_policy: restart-only + owner_branch: persistence-jpa-vendor-composition + validation: enum_strict + compatibility_impact: behavior-change + required_test: jpa-contract:local-vendor-parity + + - name: APP_REALTIME_REPLAY_ENABLED + property: ca-skeleton.realtime.replay.enabled + owner_module: adapter-outbound-persistence-jpa + type: boolean + default: false + allowed_values: [true, false] + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-22-persistence-jpa-review-remediation + validation: boolean_strict + compatibility_impact: additive + required_test: jpa-contract:realtime-replay-env + + - name: APP_REALTIME_REPLAY_RETENTION + property: ca-skeleton.realtime.replay.retention + owner_module: adapter-outbound-persistence-jpa + type: duration + default: 1h + allowed_values: null + classification: public-config + required: false + required_when: APP_REALTIME_REPLAY_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-22-persistence-jpa-review-remediation + validation: positive_duration + compatibility_impact: additive + required_test: jpa-contract:realtime-replay-env + + - name: APP_FLYWAY_ENABLED + # source: local PostgreSQL parity / explicit H2 developer lane. + # Local PostgreSQL runs migrations by default; bootRunH2 disables them because the migration + # tree is PostgreSQL-specific. + property: spring.flyway.enabled + type: boolean + default: true + allowed_values: [true, false] + classification: public-config + required: false + reload_policy: restart-only + owner_branch: persistence-jpa-vendor-composition + validation: boolean_strict + compatibility_impact: behavior-change + required_test: jpa-contract:local-flyway-parity + - name: APP_DATASOURCE_POOL_MAX_SIZE # source: feature-env-driven-runtime-configuration "datasource/pool env" # + feature-persistence-failure-baseline "Hikari metric 노출 기준" @@ -538,9 +568,9 @@ env_keys: - name: APP_TRACING_SAMPLE_RATE # source: feature-distributed-tracing-contract 2026-05-22 - # "trace sampling rate default = prod 1%, staging 10%, dev/local 100%" + # "trace sampling rate default = prod 1%, dev/local 100%" # D-1 ISSUE-1 fix (2026-06-16): blank = per-profile resolver 기본값 사용. - # TracingSampleRateResolver SSOT (prod=0.01/staging=0.10/dev·local=1.0). + # RuntimeEnvironment is the profile SSOT; resolver policy is prod=0.01, dev/local=1.0. # TracingSamplingEnvironmentPostProcessor bridges resolved rate to # management.tracing.sampling.probability. type: string @@ -783,7 +813,7 @@ env_keys: - name: APP_LOG_SAMPLING_RATE # source: feature-log-management-contract 2026-05-22 - # "log sampling(prod 10%) > trace sampling(prod 1%)" + Sampling Policy 표 (prod 10%, staging/dev/local 100%) + # "log sampling(prod 10%) > trace sampling(prod 1%)" + Sampling Policy 표 (prod 10%, dev/local 100%) type: string default: "1.0" allowed_values: null @@ -1156,67 +1186,6 @@ env_keys: compatibility_impact: behavior-change required_test: security-contract:jwt-audience-set - - name: APP_SECURITY_JWT_JWKS_URI - # source: feature-security-operational-baseline 2026-05-22 - # "JWKS refresh interval = 10분, on-demand refresh on unknown kid" - type: url - default: null - allowed_values: null - classification: public-config - required: true - reload_policy: restart-only - owner_branch: feature-security-operational-baseline - validation: url_required - compatibility_impact: behavior-change - required_test: security-contract:jwks-uri-resolvable - - - name: APP_SECURITY_JWT_CLOCK_SKEW - # source: feature-security-operational-baseline 2026-05-22 - # "JWT clock skew tolerance = 60s (Spring Security JwtTimestampValidator leeway)" - type: duration - default: 60s - allowed_values: null - classification: public-config - required: false - reload_policy: restart-only - owner_branch: feature-security-operational-baseline - validation: spring_duration_shorthand - compatibility_impact: behavior-change - required_test: security-contract:jwt-clock-skew-applied - - - name: APP_SECURITY_JWT_SIGNING_KEY - # source: feature-security-operational-baseline 2026-05-22 - # "JWT signing key rotation의 운영 관측 (JWKS refresh, kid mismatch 분류)" - # secret 분류 — owner: secrets-classification.yaml - type: string - default: null - allowed_values: null - classification: secret - required: false - reload_policy: restart-only - owner_branch: feature-secrets-config-source-contract - validation: must_not_be_local_dev_sentinel_in_prod - compatibility_impact: breaking - required_test: secrets-contract:jwt-signing-key-rotation-overlap - - # === Tenant context (feature-tenant-context-policy) === - - - name: APP_TENANT_ENABLED - # source: feature-tenant-context-policy 2026-05-22 - # "skeleton core는 multi-tenancy 미지원이 기본이며 tenant header는 기본 거부" - type: boolean - default: false - allowed_values: [true, false] - classification: public-config - required: false - reload_policy: restart-only - owner_branch: feature-tenant-context-policy - validation: boolean_strict - compatibility_impact: behavior-change - required_test: tenant-contract:disabled-rejects-header - - # === Rate limit / Idempotency (feature-rate-limit-idempotency-contract) === - - name: APP_RATE_LIMIT_ENABLED # Inbound enforcement stays disabled until an exact provider is selected. type: boolean @@ -1272,18 +1241,6 @@ env_keys: compatibility_impact: additive required_test: rate-limit-contract:provider-explicit - - name: APP_RATE_LIMIT_ROLE - type: enum - default: coordination - allowed_values: [coordination] - classification: public-config - required: false - reload_policy: restart-only - owner_branch: redis-distributed-rate-limit - validation: enum_strict - compatibility_impact: additive - required_test: rate-limit-contract:coordination-role-only - - name: APP_RATE_LIMIT_FAILURE_POLICY type: enum default: fail-closed @@ -1645,18 +1602,6 @@ env_keys: compatibility_impact: additive required_test: rate-limit-contract:cleanup-grace-bounded - - name: APP_RATE_LIMIT_MAXIMUM_CLOCK_REGRESSION - type: duration - default: 250ms - allowed_values: null - classification: public-config - required: false - reload_policy: restart-only - owner_branch: redis-distributed-rate-limit - validation: spring_duration_shorthand_non_negative_le_1h - compatibility_impact: additive - required_test: rate-limit-contract:clock-regression-bounded - - name: APP_IDEMPOTENCY_TTL # source: feature-rate-limit-idempotency-contract 2026-05-22 # "idempotency TTL default = 24h. long-running use case는 use case 선언으로 72h까지 override 가능" @@ -1672,11 +1617,10 @@ env_keys: required_test: idempotency-contract:ttl-applied - name: APP_IDEMPOTENCY_PROVIDER - # postgresql selects the owner-safe V2 store on the primary data source. It had no value here - # while the store, its schema stream and its integration suite all existed, so the capability - # could only be reached by constructing it in a test. + # postgresql selects the owner-safe V2 store on the primary data source. Provider selection is + # explicit and disabled by default; no implementation wins merely by being on the classpath. type: enum - default: jdbc + default: disabled allowed_values: [disabled, jdbc, redis, postgresql] classification: public-config required: false @@ -1687,6 +1631,9 @@ env_keys: required_test: redis-idempotency-contract:provider-exclusive - name: APP_IDEMPOTENCY_REDIS_KEY_HMAC_SECRET + # DEPRECATED 2026-09-22: the Redis idempotency adapter consumes caller-supplied scope digests and never read this secret. + deprecated_orphaned: true + removal_deadline: 2026-12-31 type: string default: null allowed_values: null @@ -1751,6 +1698,9 @@ env_keys: required_test: redis-lease-contract:provider-exclusive - name: APP_LEASE_REDIS_KEY_HMAC_SECRET + # DEPRECATED 2026-09-22: the Redis lease adapter consumes caller-supplied resource digests and never read this secret. + deprecated_orphaned: true + removal_deadline: 2026-12-31 type: string default: null allowed_values: null @@ -1894,31 +1844,14 @@ env_keys: required_test: redis-capability:lease-composition # --- Redis SDK typed settings (app.redis.*) ------------------------------- - # Bound only by RedisSdkAutoConfiguration, which exists only while APP_REDIS_ENABLED - # is true. They are deliberately absent from application.yml and src/.env: putting - # them there would make a Redis-free deployment carry Redis configuration, which is - # the defect the conditional composition root removes. :app-bootstrap:verifyEnvKeys checks them - # against spring-configuration-metadata.json instead. - - - name: APP_REDIS_ACKNOWLEDGED_WRITE_LOSS_ACCEPTED - # Declares that losing acknowledged writes is a deliberate trade. Leave false. - property: app.redis.acknowledged-write-loss-accepted - owner_module: adapter-outbound-cache-redis - type: boolean - default: false - allowed_values: [true, false] - classification: public-config - required: false - required_when: app.redis.enabled=true - reload_policy: restart-only - owner_branch: redis-optionality-and-composition - validation: boolean_strict - compatibility_impact: additive - required_test: redis-sdk:typed-settings-bound-and-validated + # Bound only by RedisSdkAutoConfiguration in adapter-outbound-redis-runtime while + # APP_REDIS_ENABLED is true. application.yml does not force these values into Redis-free + # deployments; src/.env.example merely documents explicit operator inputs. verifyEnvKeys checks + # the registry against the runtime module's configuration metadata. - name: APP_REDIS_ADMIN_CREDENTIAL_REFERENCE property: app.redis.admin.credential-reference - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: string default: null allowed_values: null @@ -1933,7 +1866,7 @@ env_keys: - name: APP_REDIS_ADMIN_ENABLED property: app.redis.admin.enabled - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: boolean default: false allowed_values: [true, false] @@ -1948,7 +1881,7 @@ env_keys: - name: APP_REDIS_ADVANCED_ENABLED property: app.redis.advanced.enabled - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: boolean default: false allowed_values: [true, false] @@ -1963,7 +1896,7 @@ env_keys: - name: APP_REDIS_ADVANCED_POLICIES property: app.redis.advanced.policies - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: csv default: "" allowed_values: null @@ -1979,7 +1912,7 @@ env_keys: - name: APP_REDIS_BLOCKING_MAX_BLOCK # Hard ceiling on a server-side block; zero would be unbounded. property: app.redis.blocking.max-block - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: duration default: "30s" allowed_values: null @@ -1994,7 +1927,7 @@ env_keys: - name: APP_REDIS_BLOCKING_MAX_CONNECTIONS property: app.redis.blocking.max-connections - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: integer default: 32 allowed_values: null @@ -2010,7 +1943,7 @@ env_keys: - name: APP_REDIS_DATABASE # Cluster supports database 0 only; a non-zero value fails startup there. property: app.redis.database - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: integer default: 0 allowed_values: null @@ -2025,7 +1958,7 @@ env_keys: - name: APP_REDIS_LIMITS_MAX_BATCH_COMMANDS property: app.redis.limits.max-batch-commands - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: integer default: 500 allowed_values: null @@ -2040,7 +1973,7 @@ env_keys: - name: APP_REDIS_LIMITS_MAX_BATCH_REPLY_BYTES property: app.redis.limits.max-batch-reply-bytes - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: integer default: 16777216 allowed_values: null @@ -2055,7 +1988,7 @@ env_keys: - name: APP_REDIS_LIMITS_MAX_BATCH_REQUEST_BYTES property: app.redis.limits.max-batch-request-bytes - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: integer default: 4194304 allowed_values: null @@ -2070,7 +2003,7 @@ env_keys: - name: APP_REDIS_LIMITS_MAX_BITMAP_OFFSET property: app.redis.limits.max-bitmap-offset - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: integer default: 10000000 allowed_values: null @@ -2085,7 +2018,7 @@ env_keys: - name: APP_REDIS_LIMITS_MAX_COLLECTION_ELEMENTS property: app.redis.limits.max-collection-elements - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: integer default: 1000 allowed_values: null @@ -2100,7 +2033,7 @@ env_keys: - name: APP_REDIS_LIMITS_MAX_HASH_FIELD_VALUE_BYTES property: app.redis.limits.max-hash-field-value-bytes - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: integer default: 524288 allowed_values: null @@ -2115,7 +2048,7 @@ env_keys: - name: APP_REDIS_LIMITS_MAX_KEY_BYTES property: app.redis.limits.max-key-bytes - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: integer default: 512 allowed_values: null @@ -2130,7 +2063,7 @@ env_keys: - name: APP_REDIS_LIMITS_MAX_SCAN_COUNT property: app.redis.limits.max-scan-count - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: integer default: 500 allowed_values: null @@ -2145,7 +2078,7 @@ env_keys: - name: APP_REDIS_LIMITS_MAX_STREAM_PAYLOAD_BYTES property: app.redis.limits.max-stream-payload-bytes - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: integer default: 262144 allowed_values: null @@ -2160,7 +2093,7 @@ env_keys: - name: APP_REDIS_LIMITS_MAX_VALUE_BYTES property: app.redis.limits.max-value-bytes - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: integer default: 1048576 allowed_values: null @@ -2175,7 +2108,7 @@ env_keys: - name: APP_REDIS_LIMITS_OFFLINE_QUEUE_COMMANDS property: app.redis.limits.offline-queue-commands - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: integer default: 1000 allowed_values: null @@ -2191,7 +2124,7 @@ env_keys: - name: APP_REDIS_MODE # standalone | sentinel | cluster. property: app.redis.mode - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: enum default: "standalone" allowed_values: [standalone, sentinel, cluster] @@ -2206,7 +2139,7 @@ env_keys: - name: APP_REDIS_NAMESPACE_DOMAIN property: app.redis.namespace.domain - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: string default: "shared" allowed_values: null @@ -2221,7 +2154,7 @@ env_keys: - name: APP_REDIS_NAMESPACE_ENVIRONMENT property: app.redis.namespace.environment - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: string default: "local" allowed_values: null @@ -2236,7 +2169,7 @@ env_keys: - name: APP_REDIS_NAMESPACE_SERVICE property: app.redis.namespace.service - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: string default: "sample-service" allowed_values: null @@ -2252,7 +2185,7 @@ env_keys: - name: APP_REDIS_NODES # CSV of host:port. Cluster and Sentinel take every seed node. property: app.redis.nodes - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: csv default: "localhost:6379" allowed_values: null @@ -2267,7 +2200,7 @@ env_keys: - name: APP_REDIS_RAW_CREDENTIAL_REFERENCE property: app.redis.raw.credential-reference - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: string default: null allowed_values: null @@ -2282,7 +2215,7 @@ env_keys: - name: APP_REDIS_RAW_ENABLED property: app.redis.raw.enabled - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: boolean default: false allowed_values: [true, false] @@ -2298,7 +2231,7 @@ env_keys: - name: APP_REDIS_RAW_POLICY_RESOURCE # Classpath resource listing every approved raw command. Absent resource fails startup. property: app.redis.raw.policy-resource - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: string default: "classpath:redis-sdk/raw-command-allowlist.yml" allowed_values: null @@ -2313,7 +2246,7 @@ env_keys: - name: APP_REDIS_TIMEOUT_ADMIN property: app.redis.timeout.admin - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: duration default: "3s" allowed_values: null @@ -2328,7 +2261,7 @@ env_keys: - name: APP_REDIS_TIMEOUT_BATCH property: app.redis.timeout.batch - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: duration default: "2s" allowed_values: null @@ -2343,7 +2276,7 @@ env_keys: - name: APP_REDIS_TIMEOUT_COLLECTION property: app.redis.timeout.collection - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: duration default: "2s" allowed_values: null @@ -2359,7 +2292,7 @@ env_keys: - name: APP_REDIS_TIMEOUT_FAST # Single-key command profile; above 5s produces a startup warning. property: app.redis.timeout.fast - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: duration default: "500ms" allowed_values: null @@ -2374,7 +2307,7 @@ env_keys: - name: APP_REDIS_TIMEOUT_SCRIPT property: app.redis.timeout.script - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: duration default: "1s" allowed_values: null @@ -2389,7 +2322,7 @@ env_keys: - name: APP_REDIS_TRANSACTION_MAX_CONNECTIONS property: app.redis.transaction.max-connections - owner_module: adapter-outbound-cache-redis + owner_module: adapter-outbound-redis-runtime type: integer default: 16 allowed_values: null @@ -2503,6 +2436,22 @@ env_keys: compatibility_impact: additive required_test: redis-sdk:runtime-composition-binds-and-validates + - name: APP_REDIS_CAPACITY_MAXIMUM_SCRIPT_CONNECTIONS + # Physical SCRIPT lane connections are bounded separately from the per-connection command queue. + property: app.redis.capacity.maximum-script-connections + owner_module: adapter-outbound-redis-runtime + type: integer + default: 8 + allowed_values: null + classification: public-config + required: false + required_when: app.redis.enabled=true + reload_policy: restart-only + owner_branch: 2026-09-20-cache-redis-review-remediation + validation: positive_integer + compatibility_impact: additive + required_test: redis-runtime:script-lane-physical-connections-bounded + - name: APP_REDIS_CAPACITY_MAXIMUM_REPLY_BYTES property: app.redis.capacity.maximum-reply-bytes owner_module: adapter-outbound-cache-redis @@ -3356,38 +3305,32 @@ env_keys: # === Notification adapters (feature-integration-adapter-templates) === - - name: APP_NOTIFICATION_SLACK_PROVIDER - # source: notification provider-SPI redesign 2026-06-16 — single active Slack provider - # selection (app.notification.slack.provider=, e.g. webhook); blank = Slack disabled. - # Replaces the former provider-binary APP_NOTIFICATION_SLACK_ENABLED. - type: string - default: null - allowed_values: null + - name: APP_NOTIFICATION_SLACK_WEBHOOK_ENABLED + # source: R0 Slack webhook provider gate; maps to app.notification.slack-webhook.enabled + type: boolean + default: false + allowed_values: [true, false] classification: public-config required: false reload_policy: restart-only owner_branch: feature-integration-adapter-templates - validation: none + validation: boolean compatibility_impact: behavior-change required_test: adapter-contract:notification-slack-provider-selection - - name: APP_NOTIFICATION_EMAIL_PROVIDER - # source: notification provider-SPI redesign 2026-06-16 — single active email provider - # selection (app.notification.email.provider=, e.g. google-email); blank = email disabled. - # Replaces the former provider-binary APP_NOTIFICATION_GOOGLE_EMAIL_ENABLED. - type: string - default: null - allowed_values: null + - name: APP_NOTIFICATION_GOOGLE_EMAIL_ENABLED + # source: R0 Google email provider gate; maps to app.notification.google-email.enabled + type: boolean + default: false + allowed_values: [true, false] classification: public-config required: false reload_policy: restart-only owner_branch: feature-integration-adapter-templates - validation: none + validation: boolean compatibility_impact: behavior-change required_test: adapter-contract:notification-email-provider-selection - # === Fileserver R2 local-persistent provider === - - name: APP_FILESERVER_ENABLED # source: Fileserver R2 control-plane/provider-selection design 2026-07-28. # Disabled is the shipped safe default. Enabling requires every local attestation @@ -4192,43 +4135,6 @@ env_keys: # === File / Upload (feature-file-resource-handling-contract) === - - name: APP_FILE_UPLOAD_MAX_SIZE - # source: feature-file-resource-handling-contract 2026-05-22 - # "Spring spring.servlet.multipart.max-file-size 10MB" - type: data_size - default: 10MB - allowed_values: null - classification: public-config - required: false - reload_policy: restart-only - owner_branch: feature-file-resource-handling-contract - validation: spring_data_size_le_10MB_by_default - compatibility_impact: behavior-change - required_test: file-contract:upload-size-enforced - - - name: APP_FILE_UPLOAD_GLOBAL_REQUEST_MAX_SIZE - # source: feature-file-resource-handling-contract 2026-05-22 - # "global request size 12MB" - type: data_size - default: 12MB - allowed_values: null - classification: public-config - required: false - reload_policy: restart-only - owner_branch: feature-file-resource-handling-contract - validation: spring_data_size - compatibility_impact: behavior-change - required_test: file-contract:global-request-size-enforced - - # === Runtime / Lifecycle (feature-runtime-health-lifecycle-contract + container-runtime) === - - # APP_SHUTDOWN_TIMEOUT superseded by APP_SERVER_SHUTDOWN_TIMEOUT (HTTP server section, - # owner feature-env-driven-runtime-configuration). The k8s terminationGracePeriod - # alignment requirement (feature-container-runtime-contract) now applies to - # APP_SERVER_SHUTDOWN_TIMEOUT. - - # === Async executor (feature-background-job-async-contract) === - - name: APP_ASYNC_EXECUTOR_CORE_SIZE # source: feature-background-job-async-contract 2026-05-22 # "executor pool sizing default = core=10, max=50, queue=200" @@ -4291,6 +4197,81 @@ env_keys: validation: boolean compatibility_impact: behavior-change required_test: adapter-contract:persistence-jpa-disabled-safe + - name: APP_JPA_HIBERNATE_BATCH_SIZE + property: spring.jpa.properties.hibernate.jdbc.batch_size + owner_module: adapter-outbound-persistence-jpa + type: integer + default: 0 + allowed_values: null + classification: public-config + required: false + required_when: APP_PERSISTENCE_JPA_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-22-persistence-jpa-review-remediation + validation: non_negative_integer + compatibility_impact: additive + required_test: jpa-contract:hibernate-runtime-settings + + - name: APP_JPA_HIBERNATE_ORDER_INSERTS + property: spring.jpa.properties.hibernate.order_inserts + owner_module: adapter-outbound-persistence-jpa + type: boolean + default: false + allowed_values: [true, false] + classification: public-config + required: false + required_when: APP_PERSISTENCE_JPA_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-22-persistence-jpa-review-remediation + validation: boolean_strict + compatibility_impact: additive + required_test: jpa-contract:hibernate-runtime-settings + + - name: APP_JPA_HIBERNATE_ORDER_UPDATES + property: spring.jpa.properties.hibernate.order_updates + owner_module: adapter-outbound-persistence-jpa + type: boolean + default: false + allowed_values: [true, false] + classification: public-config + required: false + required_when: APP_PERSISTENCE_JPA_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-22-persistence-jpa-review-remediation + validation: boolean_strict + compatibility_impact: additive + required_test: jpa-contract:hibernate-runtime-settings + + - name: APP_JPA_HIBERNATE_DEFAULT_BATCH_FETCH_SIZE + property: spring.jpa.properties.hibernate.default_batch_fetch_size + owner_module: adapter-outbound-persistence-jpa + type: integer + default: 0 + allowed_values: null + classification: public-config + required: false + required_when: APP_PERSISTENCE_JPA_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-22-persistence-jpa-review-remediation + validation: non_negative_integer + compatibility_impact: additive + required_test: jpa-contract:hibernate-runtime-settings + + - name: APP_JPA_HIBERNATE_GENERATE_STATISTICS + property: spring.jpa.properties.hibernate.generate_statistics + owner_module: adapter-outbound-persistence-jpa + type: boolean + default: false + allowed_values: [true, false] + classification: public-config + required: false + required_when: APP_PERSISTENCE_JPA_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-22-persistence-jpa-review-remediation + validation: boolean_strict + compatibility_impact: additive + required_test: jpa-contract:hibernate-runtime-settings + - name: APP_PERSISTENCE_MONGO_ENABLED # source: five-adapter-runtime-remediation §5.1 — master switch for MongoDB persistence. type: boolean @@ -4317,6 +4298,22 @@ env_keys: validation: nonblank-when-required compatibility_impact: behavior-change required_test: adapter-contract:persistence-mongo-active-profile + - name: SPRING_MONGODB_URI + # source: persistence-mongo techlead review C1. Spring Boot 4 consumes this native key as + # spring.mongodb.uri. It is one of two valid connection sources; the alternate is the selected + # typed profile's uri-secret resolved through MongoCredentialResolver. + type: string + default: null + allowed_values: null + classification: sensitive-config + required: false + required_when: ca-skeleton.persistence-mongo.enabled=true AND no active-profile uri-secret + reload_policy: restart-only + owner_branch: persistence-mongo-runtime-remediation + validation: mongodb_uri_when_selected_as_connection_source + compatibility_impact: additive + required_test: adapter-contract:persistence-mongo-connection-source + - name: APP_MESSAGING_ENABLED # source: five-adapter-runtime-remediation §5.1 — master switch for broker publication. # APP_MESSAGING_BROKER selects which transport and is no longer the de-facto switch. @@ -4330,6 +4327,305 @@ env_keys: validation: boolean compatibility_impact: behavior-change required_test: adapter-contract:messaging-disabled-safe + # === Optional WebSocket build-composition contract === + # These keys map directly to app.websocket.* when the websocket leaf is present in a chosen + # composition. The default bootJar does not contain that leaf; presence remains a build-time + # decision and these rows do not imply runtime membership. + + - name: APP_WEBSOCKET_ENABLED + property: app.websocket.enabled + owner_module: adapter-inbound-websocket + type: boolean + default: false + allowed_values: [true, false] + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-realtime-review-remediation + validation: boolean_strict + compatibility_impact: behavior-change + required_test: websocket-contract:canonical-property-namespace + + - name: APP_WEBSOCKET_ENDPOINT + property: app.websocket.endpoint + owner_module: adapter-inbound-websocket + type: string + default: /ws + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-realtime-review-remediation + validation: absolute_normalized_path + compatibility_impact: behavior-change + required_test: websocket-contract:canonical-property-namespace + + - name: APP_WEBSOCKET_ALLOWED_ORIGINS + property: app.websocket.allowed-origins + owner_module: adapter-inbound-websocket + type: csv + default: http://localhost:3000 + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-realtime-review-remediation + validation: explicit_http_origins + compatibility_impact: behavior-change + required_test: websocket-contract:canonical-property-namespace + + - name: APP_WEBSOCKET_BROADCAST_DESTINATION + property: app.websocket.broadcast-destination + owner_module: adapter-inbound-websocket + type: string + default: /topic/events + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-realtime-review-remediation + validation: normalized_topic_path + compatibility_impact: behavior-change + required_test: websocket-contract:canonical-property-namespace + + - name: APP_WEBSOCKET_PLATFORM_ENABLED + property: app.websocket.platform.enabled + owner_module: adapter-inbound-websocket + type: boolean + default: false + allowed_values: [true, false] + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-realtime-review-remediation + validation: boolean_strict + compatibility_impact: behavior-change + required_test: websocket-contract:canonical-property-namespace + + - name: APP_WEBSOCKET_PLATFORM_NODE_ID + property: app.websocket.platform.node-id + owner_module: adapter-inbound-websocket + type: string + default: local + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-realtime-review-remediation + validation: non_empty_string + compatibility_impact: behavior-change + required_test: websocket-contract:canonical-property-namespace + + - name: APP_WEBSOCKET_PLATFORM_ALLOWED_ORIGINS + property: app.websocket.platform.allowed-origins + owner_module: adapter-inbound-websocket + type: csv + default: "" + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-realtime-review-remediation + validation: explicit_http_origins_when_enabled + compatibility_impact: behavior-change + required_test: websocket-contract:canonical-property-namespace + + - name: APP_WEBSOCKET_PLATFORM_ALLOW_MISSING_ORIGIN + property: app.websocket.platform.allow-missing-origin + owner_module: adapter-inbound-websocket + type: boolean + default: false + allowed_values: [true, false] + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-realtime-review-remediation + validation: boolean_strict + compatibility_impact: behavior-change + required_test: websocket-contract:canonical-property-namespace + + - name: APP_WEBSOCKET_PLATFORM_MAX_FRAME_BYTES + property: app.websocket.platform.max-frame-bytes + owner_module: adapter-inbound-websocket + type: integer + default: 65536 + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-realtime-review-remediation + validation: positive_integer_with_platform_ceiling + compatibility_impact: behavior-change + required_test: websocket-contract:canonical-property-namespace + + - name: APP_WEBSOCKET_PLATFORM_MAX_MESSAGE_BYTES + property: app.websocket.platform.max-message-bytes + owner_module: adapter-inbound-websocket + type: integer + default: 524288 + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-realtime-review-remediation + validation: positive_integer_with_platform_ceiling + compatibility_impact: behavior-change + required_test: websocket-contract:canonical-property-namespace + + - name: APP_WEBSOCKET_PLATFORM_MAX_FRAGMENTS + property: app.websocket.platform.max-fragments + owner_module: adapter-inbound-websocket + type: integer + default: 16 + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-realtime-review-remediation + validation: positive_integer + compatibility_impact: behavior-change + required_test: websocket-contract:canonical-property-namespace + + - name: APP_WEBSOCKET_PLATFORM_MAX_BUFFERED_OUTBOUND_BYTES_PER_CONNECTION + property: app.websocket.platform.max-buffered-outbound-bytes-per-connection + owner_module: adapter-inbound-websocket + type: integer + default: 1048576 + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-realtime-review-remediation + validation: positive_integer_with_platform_ceiling + compatibility_impact: behavior-change + required_test: websocket-contract:canonical-property-namespace + + - name: APP_WEBSOCKET_PLATFORM_MAX_BUFFERED_OUTBOUND_BYTES_PER_NODE + property: app.websocket.platform.max-buffered-outbound-bytes-per-node + owner_module: adapter-inbound-websocket + type: integer + default: 67108864 + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-realtime-review-remediation + validation: positive_integer + compatibility_impact: behavior-change + required_test: websocket-contract:canonical-property-namespace + + - name: APP_WEBSOCKET_PLATFORM_MAX_CONNECTIONS_PER_ACTOR + property: app.websocket.platform.max-connections-per-actor + owner_module: adapter-inbound-websocket + type: integer + default: 4 + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-realtime-review-remediation + validation: positive_integer + compatibility_impact: behavior-change + required_test: websocket-contract:canonical-property-namespace + + - name: APP_WEBSOCKET_PLATFORM_PING_INTERVAL + property: app.websocket.platform.ping-interval + owner_module: adapter-inbound-websocket + type: duration + default: 15s + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-realtime-review-remediation + validation: positive_duration + compatibility_impact: behavior-change + required_test: websocket-contract:canonical-property-namespace + + - name: APP_WEBSOCKET_PLATFORM_IDLE_TIMEOUT + property: app.websocket.platform.idle-timeout + owner_module: adapter-inbound-websocket + type: duration + default: 45s + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-realtime-review-remediation + validation: positive_duration + compatibility_impact: behavior-change + required_test: websocket-contract:canonical-property-namespace + + - name: APP_WEBSOCKET_PLATFORM_MAX_CONNECTION_AGE + property: app.websocket.platform.max-connection-age + owner_module: adapter-inbound-websocket + type: duration + default: 4h + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-realtime-review-remediation + validation: positive_duration + compatibility_impact: behavior-change + required_test: websocket-contract:canonical-property-namespace + + - name: APP_WEBSOCKET_PLATFORM_TICKET_LIFETIME + property: app.websocket.platform.ticket-lifetime + owner_module: adapter-inbound-websocket + type: duration + default: 30s + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-realtime-review-remediation + validation: positive_duration + compatibility_impact: behavior-change + required_test: websocket-contract:canonical-property-namespace + + - name: APP_WEBSOCKET_ADVANCED_SOCKJS_ENABLED + property: app.websocket.advanced.sockjs.enabled + owner_module: adapter-inbound-websocket + type: boolean + default: false + allowed_values: [true, false] + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-realtime-review-remediation + validation: boolean_strict + compatibility_impact: behavior-change + required_test: websocket-contract:canonical-property-namespace + + - name: APP_WEBSOCKET_ADVANCED_STOMP_ENABLED + property: app.websocket.advanced.stomp.enabled + owner_module: adapter-inbound-websocket + type: boolean + default: false + allowed_values: [true, false] + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-realtime-review-remediation + validation: boolean_strict + compatibility_impact: behavior-change + required_test: websocket-contract:canonical-property-namespace + + - name: APP_WEBSOCKET_ADVANCED_STOMP_RELAY_ENABLED + property: app.websocket.advanced.stomp.relay.enabled + owner_module: adapter-inbound-websocket + type: boolean + default: false + allowed_values: [true, false] + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-realtime-review-remediation + validation: boolean_strict + compatibility_impact: behavior-change + required_test: websocket-contract:canonical-property-namespace + - name: APP_GRAPHQL_ENABLED # source: five-adapter-runtime-remediation §5.1 — master switch for the GraphQL transport. # false publishes no /graphql route, including the one Spring GraphQL would publish by itself. @@ -4359,6 +4655,156 @@ env_keys: validation: enum compatibility_impact: behavior-change required_test: adapter-contract:graphql-deployment-mode + - name: APP_GRAPHQL_EXECUTION_PROFILE + property: backend.graphql.execution-profile + owner_module: adapter-inbound-graphql + type: enum + default: BLOCKING_MVC + allowed_values: [BLOCKING_MVC, REACTIVE_WEBFLUX, MIXED_CONTROLLED] + classification: public-config + required: false + required_when: APP_GRAPHQL_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-graphql-review-remediation + validation: enum + compatibility_impact: additive + required_test: graphql-contract:wired-operator-settings + + - name: APP_GRAPHQL_VALIDATION_POLICY_VERSION + property: backend.graphql.validation-policy-version + owner_module: adapter-inbound-graphql + type: string + default: v1 + allowed_values: null + classification: public-config + required: false + required_when: APP_GRAPHQL_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-graphql-review-remediation + validation: non_empty_string + compatibility_impact: additive + required_test: graphql-contract:wired-operator-settings + + - name: APP_GRAPHQL_OBSERVED_OPERATION_NAMES + property: backend.graphql.observed-operation-names + owner_module: adapter-inbound-graphql + type: csv + default: "" + allowed_values: null + classification: public-config + required: false + required_when: APP_GRAPHQL_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-graphql-review-remediation + validation: csv + compatibility_impact: additive + required_test: graphql-contract:wired-operator-settings + + - name: APP_GRAPHQL_GRAPHIQL_ENABLED + property: backend.graphql.console.graphiql-enabled + owner_module: adapter-inbound-graphql + type: boolean + default: false + allowed_values: [true, false] + classification: public-config + required: false + required_when: APP_GRAPHQL_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-graphql-review-remediation + validation: boolean_strict + compatibility_impact: additive + required_test: graphql-contract:wired-operator-settings + + - name: APP_GRAPHQL_INTROSPECTION_ENABLED + property: backend.graphql.console.introspection-enabled + owner_module: adapter-inbound-graphql + type: boolean + default: false + allowed_values: [true, false] + classification: public-config + required: false + required_when: APP_GRAPHQL_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-graphql-review-remediation + validation: boolean_strict + compatibility_impact: additive + required_test: graphql-contract:wired-operator-settings + + - name: APP_GRAPHQL_MAXIMUM_PAGE_SIZE + property: backend.graphql.limits.maximum-page-size + owner_module: adapter-inbound-graphql + type: integer + default: 100 + allowed_values: null + classification: public-config + required: false + required_when: APP_GRAPHQL_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-graphql-review-remediation + validation: positive_integer + compatibility_impact: additive + required_test: graphql-contract:wired-operator-settings + + - name: APP_GRAPHQL_MAXIMUM_COMPLEXITY + property: backend.graphql.limits.maximum-complexity + owner_module: adapter-inbound-graphql + type: integer + default: 10000 + allowed_values: null + classification: public-config + required: false + required_when: APP_GRAPHQL_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-graphql-review-remediation + validation: positive_integer + compatibility_impact: additive + required_test: graphql-contract:wired-operator-settings + + - name: APP_GRAPHQL_PREPARSED_CACHE_ENTRIES + property: backend.graphql.limits.preparsed-cache-entries + owner_module: adapter-inbound-graphql + type: integer + default: 1000 + allowed_values: null + classification: public-config + required: false + required_when: APP_GRAPHQL_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-graphql-review-remediation + validation: positive_integer + compatibility_impact: additive + required_test: graphql-contract:wired-operator-settings + + - name: APP_GRAPHQL_PREPARSED_CACHE_WEIGHT + property: backend.graphql.limits.preparsed-cache-weight + owner_module: adapter-inbound-graphql + type: integer + default: 10000000 + allowed_values: null + classification: public-config + required: false + required_when: APP_GRAPHQL_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-graphql-review-remediation + validation: positive_integer + compatibility_impact: additive + required_test: graphql-contract:wired-operator-settings + + - name: APP_GRAPHQL_PREPARSED_CACHE_EXPIRE_AFTER_ACCESS + property: backend.graphql.limits.preparsed-cache-expire-after-access + owner_module: adapter-inbound-graphql + type: duration + default: 30m + allowed_values: null + classification: public-config + required: false + required_when: APP_GRAPHQL_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-20-inbound-graphql-review-remediation + validation: positive_duration + compatibility_impact: additive + required_test: graphql-contract:wired-operator-settings + - name: APP_OUTBOX_ENABLED # source: five-adapter-runtime-remediation §6.1 JPA-INT-004 — the outbox capability switch. # relay-enabled below only starts the scheduler; conflating the two meant a relay-off deployment @@ -4672,6 +5118,162 @@ env_keys: compatibility_impact: behavior-change required_test: adapter-contract:notification-secret-material-required + - name: APP_NOTIFICATION_PLATFORM_SES_ENABLED + # source: notification/fileserver H4-B — shipped SES dispatch assembler. + type: boolean + default: false + allowed_values: [true, false] + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-21-notification-review-remediation + validation: boolean + compatibility_impact: additive + required_test: adapter-contract:notification-ses-provider-assembled + + - name: APP_NOTIFICATION_PLATFORM_SES_PRIMARY + # source: notification/fileserver H4-B — shipped SES dispatch assembler. + type: boolean + default: false + allowed_values: [true, false] + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-21-notification-review-remediation + validation: boolean + compatibility_impact: additive + required_test: adapter-contract:notification-ses-provider-assembled + + - name: APP_NOTIFICATION_PLATFORM_SES_ENVIRONMENT + # source: notification/fileserver H4-B — shipped SES dispatch assembler. + type: string + default: PRODUCTION + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-21-notification-review-remediation + validation: non_blank + compatibility_impact: additive + required_test: adapter-contract:notification-ses-provider-assembled + + - name: APP_NOTIFICATION_PLATFORM_SES_CREDENTIAL_KEY_ID + # source: notification/fileserver H4-B — shipped SES dispatch assembler. + type: string + default: null + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-21-notification-review-remediation + validation: non_blank_when_ses_enabled + compatibility_impact: additive + required_test: adapter-contract:notification-ses-provider-assembled + + - name: APP_NOTIFICATION_PLATFORM_SES_TIMEOUT + # source: notification/fileserver H4-B — shipped SES dispatch assembler. + type: duration + default: 10s + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-21-notification-review-remediation + validation: positive_duration + compatibility_impact: additive + required_test: adapter-contract:notification-ses-provider-assembled + + - name: APP_NOTIFICATION_PLATFORM_SES_MAX_CONCURRENCY + # source: notification/fileserver H4-B — shipped SES dispatch assembler. + type: int + default: 8 + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-21-notification-review-remediation + validation: positive_int + compatibility_impact: additive + required_test: adapter-contract:notification-ses-provider-assembled + + - name: APP_NOTIFICATION_PLATFORM_SES_RATE_PER_SECOND + # source: notification/fileserver H4-B — shipped SES dispatch assembler. + type: int + default: 20 + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-21-notification-review-remediation + validation: positive_int + compatibility_impact: additive + required_test: adapter-contract:notification-ses-provider-assembled + + - name: APP_NOTIFICATION_PLATFORM_SES_ENDPOINT + # source: notification/fileserver H4-B — shipped SES dispatch assembler. + type: string + default: https://email.us-east-1.amazonaws.com + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-21-notification-review-remediation + validation: absolute_https_or_loopback_uri + compatibility_impact: additive + required_test: adapter-contract:notification-ses-provider-assembled + + - name: APP_NOTIFICATION_PLATFORM_SES_REGION + # source: notification/fileserver H4-B — shipped SES dispatch assembler. + type: string + default: us-east-1 + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-21-notification-review-remediation + validation: non_blank + compatibility_impact: additive + required_test: adapter-contract:notification-ses-provider-assembled + + - name: APP_NOTIFICATION_PLATFORM_SES_SENDER_IDENTITY + # source: notification/fileserver H4-B — shipped SES dispatch assembler. + type: string + default: null + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-21-notification-review-remediation + validation: email_address_when_ses_enabled + compatibility_impact: additive + required_test: adapter-contract:notification-ses-provider-assembled + + - name: APP_NOTIFICATION_PLATFORM_SES_ACCESS_KEY_ID + # source: notification/fileserver H4-B — shipped SES dispatch assembler. + type: string + default: null + allowed_values: null + classification: sensitive-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-21-notification-review-remediation + validation: non_blank_when_ses_enabled + compatibility_impact: additive + required_test: adapter-contract:notification-ses-provider-assembled + + - name: APP_NOTIFICATION_PLATFORM_SES_CONFIGURATION_SET + # source: notification/fileserver H4-B — shipped SES dispatch assembler. + type: string + default: null + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: 2026-09-21-notification-review-remediation + validation: optional_non_blank + compatibility_impact: additive + required_test: adapter-contract:notification-ses-provider-assembled + - name: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED # source: NTF-INT-001 — master switch of the shipped SMTP provider profile; false means assembly skips it entirely. type: boolean @@ -4763,19 +5365,6 @@ env_keys: compatibility_impact: behavior-change required_test: adapter-contract:notification-smtp-provider-assembled - - name: APP_NOTIFICATION_PLATFORM_SMTP_TLS_MODE - # source: NTF-INT-001 — transport security of the SMTP session; the type has no plaintext member. - type: enum - default: STARTTLS_REQUIRED - allowed_values: [STARTTLS_REQUIRED, IMPLICIT_TLS] - classification: public-config - required: false - reload_policy: restart-only - owner_branch: worktree-notification-platform - validation: enum_in_allowed_values - compatibility_impact: behavior-change - required_test: adapter-contract:notification-smtp-provider-assembled - - name: APP_NOTIFICATION_PLATFORM_SMTP_SENDER_IDENTITY # source: NTF-INT-001 — the envelope sender every message is sent as. type: string @@ -4789,45 +5378,6 @@ env_keys: compatibility_impact: behavior-change required_test: adapter-contract:notification-smtp-provider-assembled - - name: APP_NOTIFICATION_PLATFORM_SMTP_CONNECT_TIMEOUT - # source: NTF-INT-001 — how long a connection attempt to the relay may take. - type: duration - default: 5s - allowed_values: null - classification: public-config - required: false - reload_policy: restart-only - owner_branch: worktree-notification-platform - validation: duration_spring_shorthand - compatibility_impact: behavior-change - required_test: adapter-contract:notification-smtp-provider-assembled - - - name: APP_NOTIFICATION_PLATFORM_SMTP_READ_TIMEOUT - # source: NTF-INT-001 — how long a relay reply may take. - type: duration - default: 10s - allowed_values: null - classification: public-config - required: false - reload_policy: restart-only - owner_branch: worktree-notification-platform - validation: duration_spring_shorthand - compatibility_impact: behavior-change - required_test: adapter-contract:notification-smtp-provider-assembled - - - name: APP_NOTIFICATION_PLATFORM_SMTP_WRITE_TIMEOUT - # source: NTF-INT-001 — how long a write to the relay may take. - type: duration - default: 10s - allowed_values: null - classification: public-config - required: false - reload_policy: restart-only - owner_branch: worktree-notification-platform - validation: duration_spring_shorthand - compatibility_impact: behavior-change - required_test: adapter-contract:notification-smtp-provider-assembled - - name: APP_NOTIFICATION_PLATFORM_SMTP_DISPATCH_CONCURRENCY # source: NTF-INT-001 — size of the bounded executor SMTP sends run on. type: int @@ -4841,6 +5391,159 @@ env_keys: compatibility_impact: behavior-change required_test: adapter-contract:notification-smtp-provider-assembled + - name: SPRING_MAIL_HOST + # source: notification/fileserver techlead review H2 — native Spring Mail transport + # consumed by the JavaMailSender that the shipped SMTP assembler validates and uses. + property: spring.mail.host + owner_module: adapter-outbound-notification + type: string + default: null + allowed_values: null + classification: public-config + required: false + required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-21-notification-review-remediation + validation: non_blank_when_required + compatibility_impact: additive + required_test: adapter-contract:notification-smtp-transport + + - name: SPRING_MAIL_PORT + # source: notification/fileserver techlead review H2 — native Spring Mail transport + # consumed by the JavaMailSender that the shipped SMTP assembler validates and uses. + property: spring.mail.port + owner_module: adapter-outbound-notification + type: integer + default: null + allowed_values: null + classification: public-config + required: false + required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-21-notification-review-remediation + validation: integer_1_to_65535_when_required + compatibility_impact: additive + required_test: adapter-contract:notification-smtp-transport + + - name: SPRING_MAIL_USERNAME + # source: notification/fileserver techlead review H2 — native Spring Mail transport + # consumed by the JavaMailSender that the shipped SMTP assembler validates and uses. + property: spring.mail.username + owner_module: adapter-outbound-notification + type: string + default: null + allowed_values: null + classification: sensitive-config + required: false + required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-21-notification-review-remediation + validation: optional_non_blank + compatibility_impact: additive + required_test: adapter-contract:notification-smtp-transport + + - name: SPRING_MAIL_PASSWORD + # source: notification/fileserver techlead review H2 — native Spring Mail transport + # consumed by the JavaMailSender that the shipped SMTP assembler validates and uses. + property: spring.mail.password + owner_module: adapter-outbound-notification + type: string + default: null + allowed_values: null + classification: secret + required: false + required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-21-notification-review-remediation + validation: secret_when_configured + compatibility_impact: additive + required_test: adapter-contract:notification-smtp-transport + + - name: SPRING_MAIL_PROPERTIES_MAIL_SMTP_STARTTLS_ENABLE + # source: notification/fileserver techlead review H2 — native Spring Mail transport + # consumed by the JavaMailSender that the shipped SMTP assembler validates and uses. + property: spring.mail.properties.mail.smtp.starttls.enable + owner_module: adapter-outbound-notification + type: boolean + default: null + allowed_values: null + classification: public-config + required: false + required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-21-notification-review-remediation + validation: true_when_smtp_enabled_unless_implicit_tls + compatibility_impact: additive + required_test: adapter-contract:notification-smtp-transport + + - name: SPRING_MAIL_PROPERTIES_MAIL_SMTP_STARTTLS_REQUIRED + # source: notification/fileserver techlead review H2 — native Spring Mail transport + # consumed by the JavaMailSender that the shipped SMTP assembler validates and uses. + property: spring.mail.properties.mail.smtp.starttls.required + owner_module: adapter-outbound-notification + type: boolean + default: null + allowed_values: null + classification: public-config + required: false + required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-21-notification-review-remediation + validation: true_when_starttls_enabled + compatibility_impact: additive + required_test: adapter-contract:notification-smtp-transport + + - name: SPRING_MAIL_PROPERTIES_MAIL_SMTP_CONNECTIONTIMEOUT + # source: notification/fileserver techlead review H2 — native Spring Mail transport + # consumed by the JavaMailSender that the shipped SMTP assembler validates and uses. + property: spring.mail.properties.mail.smtp.connectiontimeout + owner_module: adapter-outbound-notification + type: integer + default: null + allowed_values: null + classification: public-config + required: false + required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-21-notification-review-remediation + validation: positive_millis_when_required + compatibility_impact: additive + required_test: adapter-contract:notification-smtp-transport + + - name: SPRING_MAIL_PROPERTIES_MAIL_SMTP_TIMEOUT + # source: notification/fileserver techlead review H2 — native Spring Mail transport + # consumed by the JavaMailSender that the shipped SMTP assembler validates and uses. + property: spring.mail.properties.mail.smtp.timeout + owner_module: adapter-outbound-notification + type: integer + default: null + allowed_values: null + classification: public-config + required: false + required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-21-notification-review-remediation + validation: positive_millis_when_required + compatibility_impact: additive + required_test: adapter-contract:notification-smtp-transport + + - name: SPRING_MAIL_PROPERTIES_MAIL_SMTP_WRITETIMEOUT + # source: notification/fileserver techlead review H2 — native Spring Mail transport + # consumed by the JavaMailSender that the shipped SMTP assembler validates and uses. + property: spring.mail.properties.mail.smtp.writetimeout + owner_module: adapter-outbound-notification + type: integer + default: null + allowed_values: null + classification: public-config + required: false + required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true + reload_policy: restart-only + owner_branch: 2026-09-21-notification-review-remediation + validation: positive_millis_when_required + compatibility_impact: additive + required_test: adapter-contract:notification-smtp-transport + - name: APP_OPENAPI_DOCS_ENABLED # source: five-adapter-runtime-remediation §9 — whether /v3/api-docs is served; application-prod.yml pins it false. Stated rather than defaulted because # SpringDoc warns on every startup until a deployment decides, and a warning on every start is @@ -4952,6 +5655,19 @@ env_keys: compatibility_impact: behavior-change required_test: adapter-contract:notification-retry-policy + - name: APP_NOTIFICATION_PLATFORM_ESTIMATED_DISPATCH_DURATION + # source: NTF-025 — dispatch latency estimate used by lease/retry planning + type: duration + default: 2s + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: worktree-notification-platform + validation: positive_duration + compatibility_impact: behavior-change + required_test: adapter-contract:notification-dispatch-bounds + - name: APP_NOTIFICATION_PLATFORM_MAX_QUEUE_AGE # source: NTF-025 — after this, a queued delivery expires rather than being sent late type: duration @@ -4978,6 +5694,112 @@ env_keys: compatibility_impact: behavior-change required_test: adapter-contract:notification-ambiguity + + + - name: APP_NOTIFICATION_PLATFORM_SHUTDOWN_GRACE + # source: NTF-025 — upper bound for worker drain during process termination + type: duration + default: 20s + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: worktree-notification-platform + validation: positive_duration + compatibility_impact: behavior-change + required_test: adapter-contract:notification-shutdown-grace + + - name: APP_NOTIFICATION_PLATFORM_MAX_BACKLOG_DEPTH + # source: NTF-OBS-001 — readiness threshold for due and unclaimed deliveries + type: integer + default: 100000 + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: worktree-notification-platform + validation: non_negative_integer + compatibility_impact: behavior-change + required_test: adapter-contract:notification-serving-thresholds + + - name: APP_NOTIFICATION_PLATFORM_MAX_OLDEST_DUE_AGE + # source: NTF-OBS-001 — readiness threshold for the oldest due delivery + type: duration + default: 10m + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: worktree-notification-platform + validation: non_negative_duration + compatibility_impact: behavior-change + required_test: adapter-contract:notification-serving-thresholds + + - name: APP_NOTIFICATION_PLATFORM_MAX_STUCK_LEASES + # source: NTF-OBS-001 — readiness threshold for expired/stuck delivery leases + type: integer + default: 50 + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: worktree-notification-platform + validation: non_negative_integer + compatibility_impact: behavior-change + required_test: adapter-contract:notification-serving-thresholds + + - name: APP_NOTIFICATION_PLATFORM_MAX_PENDING_PROJECTIONS + # source: NTF-OBS-001 — readiness threshold for unapplied provider-event projections + type: integer + default: 50000 + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: worktree-notification-platform + validation: non_negative_integer + compatibility_impact: behavior-change + required_test: adapter-contract:notification-serving-thresholds + + - name: APP_NOTIFICATION_PLATFORM_MAX_FAILED_PROJECTIONS + # source: NTF-OBS-001 — readiness threshold for failed provider-event projections + type: integer + default: 1000 + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: worktree-notification-platform + validation: non_negative_integer + compatibility_impact: behavior-change + required_test: adapter-contract:notification-serving-thresholds + + - name: APP_NOTIFICATION_PLATFORM_MAX_OLDEST_PENDING_PROJECTION_AGE + # source: NTF-OBS-001 — readiness threshold for the oldest pending projection + type: duration + default: 15m + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: worktree-notification-platform + validation: non_negative_duration + compatibility_impact: behavior-change + required_test: adapter-contract:notification-serving-thresholds + + - name: APP_NOTIFICATION_PLATFORM_MAX_OLDEST_RECONCILIATION_AGE + # source: NTF-OBS-001 — readiness threshold for the oldest unresolved reconciliation + type: duration + default: 30m + allowed_values: null + classification: public-config + required: false + reload_policy: restart-only + owner_branch: worktree-notification-platform + validation: non_negative_duration + compatibility_impact: behavior-change + required_test: adapter-contract:notification-serving-thresholds + - name: APP_NOTIFICATION_PLATFORM_CALLBACKS_ENABLED # source: NTF-025 — whether the platform exposes provider callback endpoints type: boolean diff --git a/docs/registries/error-codes.yaml b/docs/registries/error-codes.yaml index 06c865d4..fb0de684 100644 --- a/docs/registries/error-codes.yaml +++ b/docs/registries/error-codes.yaml @@ -1,9 +1,8 @@ # Registry: Error Codes -# SSOT: wiki/projects/ca-tmpl/registries/error-codes.yaml # Schema owner: feature-contract-registry-governance # Category enum owner: feature-operational-error-observability-foundation -# Last updated: 2026-05-22 -# Note: 이 파일은 Phase B 산출물. Phase C2(ca-tmpl 실 코드)에서 generated Java constants의 source. +# Last updated: 2026-09-21 +# Scope: skeleton-wide OperationalError SSOT. Product/fork ApiErrorCode enums own local registries/contracts. # # Schema (per row): # code: UPPER_SNAKE_CASE @@ -13,7 +12,6 @@ # http_status: int (async-only failures use 500 placeholder) # retryable: bool # retry_after_seconds: int | null (RATE_LIMIT/TRANSIENT 권고 backoff) -# owner_branch: source branch (raw/branch-notes/feature-*.md) # owner_layer: presentation | application | domain | infrastructure | crosscut # client_safe_message: no token / no principal raw / no internal path / no stack trace # log_level: ERROR | WARN | INFO @@ -121,7 +119,8 @@ errors: - code: AUTH_KID_UNKNOWN category: AUTH http_status: 401 - retryable: true # 2026-06-01: false→true. JWKS 키 회전 중 unknown kid 는 ~5s 후 JWKS refresh 로 해소 가능(transient). retry_after_seconds=5 + client_safe_message "please retry" 와 정합. 키 고정 정책으로 전환 시 false 복귀. + # 2026-06-01: false→true. JWKS rotation 중 unknown kid는 refresh 후 해소 가능한 transient failure. + retryable: true retry_after_seconds: 5 owner_branch: feature-security-operational-baseline owner_layer: presentation @@ -404,61 +403,6 @@ errors: # ============================================================ # source: feature-file-resource-handling-contract L69 — "spring.servlet.multipart.max-file-size 10MB ... Spring 단의 enforcement가 실패 시 envelope 응답 보장" / 테스트 계약 "oversized upload가 generic 500으로 처리되면 실패" - - code: UPLOAD_SIZE_EXCEEDED - category: VALIDATION - http_status: 413 - retryable: false - retry_after_seconds: null - owner_branch: feature-file-resource-handling-contract - owner_layer: presentation - client_safe_message: "Uploaded file exceeds maximum size" - log_level: WARN - runbook_link: null - compatibility_impact: none - required_test: contract-verification:file-upload - - # source: feature-file-resource-handling-contract L72 — "allowed content-type allowlist starting set ..." - - code: UPLOAD_CONTENT_TYPE_REJECTED - category: VALIDATION - http_status: 415 - retryable: false - retry_after_seconds: null - owner_branch: feature-file-resource-handling-contract - owner_layer: presentation - client_safe_message: "Uploaded content type is not allowed" - log_level: WARN - runbook_link: null - compatibility_impact: none - required_test: contract-verification:file-upload - - # source: feature-file-resource-handling-contract — Decisionized Work Items "path traversal | normalized storage key only ... | traversal test" - - code: PATH_TRAVERSAL_DETECTED - category: VALIDATION - http_status: 400 - retryable: false - retry_after_seconds: null - owner_branch: feature-file-resource-handling-contract - owner_layer: presentation - client_safe_message: "Invalid file path" - log_level: ERROR - runbook_link: null - compatibility_impact: none - required_test: contract-verification:file-upload - - # source: feature-file-resource-handling-contract L73 — "streaming download backpressure = response timeout 60s, max stream 100MB. 초과 시 truncate + ERROR log" - - code: DOWNLOAD_STREAMING_FAILURE - category: TRANSIENT_DEPENDENCY - http_status: 503 - retryable: true - retry_after_seconds: 5 - owner_branch: feature-file-resource-handling-contract - owner_layer: presentation - client_safe_message: "Download failed, please retry" - log_level: ERROR - runbook_link: "runbook://file/download-streaming-failure" - compatibility_impact: none - required_test: contract-verification:file-download - # ============================================================ # API contract transport-standard codes (feature-api-contract-baseline) # ============================================================ @@ -560,19 +504,6 @@ errors: # ============================================================ # source: feature-tenant-context-policy L71 — "tenant 미지원 모드에서 X-Tenant-Id 헤더 수신 시 400 TENANT_NOT_SUPPORTED (filter 단계)" - - code: TENANT_NOT_SUPPORTED - category: VALIDATION - http_status: 400 - retryable: false - retry_after_seconds: null - owner_branch: feature-tenant-context-policy - owner_layer: presentation - client_safe_message: "Tenant context is not supported by this deployment" - log_level: WARN - runbook_link: null - compatibility_impact: none - required_test: contract-verification:tenant-policy - # ============================================================ # Validation / Business rule (feature-business-rule-validation-contract) # ============================================================ @@ -583,51 +514,11 @@ errors: # Phase D(도메인 feature 적용) 시 본 registry에 추가. # source: feature-operational-error-observability-foundation L110 — "code: VALIDATION_EMAIL_FORMAT, // registry-registered code" (validation field error JSON shape example) - - code: VALIDATION_EMAIL_FORMAT - category: VALIDATION - http_status: 400 - retryable: false - retry_after_seconds: null - owner_branch: feature-operational-error-observability-foundation - owner_layer: presentation - client_safe_message: "Invalid email format" - log_level: INFO - runbook_link: null - compatibility_impact: none - required_test: contract-verification:validation-envelope - # ============================================================ # Cache (feature-cache-consistency-contract) # ============================================================ # source: feature-cache-consistency-contract — Decisionized Work Items "Redis unavailable | degrade only if declared | fail-fast for required cache | generic INTERNAL | unavailable mapping" / 테스트 "Redis unavailable이 degrade 가능 여부 없이 INTERNAL로 처리되면 실패" - - code: CACHE_UNAVAILABLE - category: TRANSIENT_DEPENDENCY - http_status: 503 - retryable: true - retry_after_seconds: 2 - owner_branch: feature-cache-consistency-contract - owner_layer: infrastructure - client_safe_message: "Service temporarily unavailable" - log_level: ERROR - runbook_link: "runbook://cache/unavailable" - compatibility_impact: none - required_test: contract-verification:cache-consistency - - # source: feature-cache-consistency-contract L70 — "stampede 방지 default = single-instance Caffeine local lock, multi-instance HPA 시 Redisson RLock distributed mutex" / 테스트 "동일 key에 대해 동시 cache miss 시 backend 호출이 1회로 제한되는지 verify (stampede). 미충족 시 실패" - - code: CACHE_STAMPEDE_LOCK_TIMEOUT - category: TRANSIENT_DEPENDENCY - http_status: 503 - retryable: true - retry_after_seconds: 1 - owner_branch: feature-cache-consistency-contract - owner_layer: infrastructure - client_safe_message: "Service temporarily unavailable" - log_level: WARN - runbook_link: "runbook://cache/stampede-lock-timeout" - compatibility_impact: none - required_test: contract-verification:cache-consistency - # ============================================================ # Outbound HTTP (feature-outbound-http-client-baseline) # ============================================================ @@ -824,54 +715,6 @@ errors: # ============================================================ # source: feature-migration-startup-contract L71 — "startup exit code 표준 = ... migration 실패=70 ..." + Decisionized "startup failure log | structured log with startup.phase, error.code, error.category" - - code: MIGRATION_FAILED - category: INTERNAL - http_status: 500 - retryable: false - retry_after_seconds: null - owner_branch: feature-migration-startup-contract - owner_layer: infrastructure - client_safe_message: "Internal server error" - log_level: ERROR - runbook_link: "runbook://migration/failed" - compatibility_impact: none - required_test: contract-verification:migration-startup - - # source: feature-migration-startup-contract L71 — "startup exit code 표준 = env 누락/malformed=78 ..." / 테스트 "required env 누락 시 startup이 성공하면 실패" - - code: STARTUP_VALIDATION_FAILED - category: INTERNAL - http_status: 500 - retryable: false - retry_after_seconds: null - owner_branch: feature-migration-startup-contract - owner_layer: infrastructure - client_safe_message: "Internal server error" - log_level: ERROR - runbook_link: "runbook://startup/validation-failed" - compatibility_impact: none - required_test: contract-verification:migration-startup - - # source: feature-migration-startup-contract L71 — "startup exit code 표준 = ... required adapter disabled=72" / 테스트 "disabled required adapter로 app이 뜨면 실패" - - code: REQUIRED_ADAPTER_DISABLED - category: INTERNAL - http_status: 500 - retryable: false - retry_after_seconds: null - owner_branch: feature-migration-startup-contract - owner_layer: infrastructure - client_safe_message: "Internal server error" - log_level: ERROR - runbook_link: "runbook://startup/required-adapter-disabled" - compatibility_impact: none - required_test: contract-verification:migration-startup - - # source: feature-integration-adapter-templates §구현 가이드 §4 (Layer 3) + §Audit A2. - # Runtime-lifecycle fail-fast for an invoke against a DISABLED optional adapter - # (Kafka/Redis/Slack/Google Email). Deliberately distinct from the startup-lifecycle - # REQUIRED_ADAPTER_DISABLED above (exit 72): a runtime invoke ≠ a startup validation, - # so reusing the startup code would conflate two lifecycles (A2 resolution — new - # runtime code owned by this branch). retryable=false: the adapter stays disabled - # until redeploy, so retrying the same call never clears it. - code: ADAPTER_DISABLED category: INTERNAL http_status: 500 @@ -886,19 +729,6 @@ errors: required_test: adapter-contract:adapter-disabled-runtime-call # source: feature-migration-startup-contract L71 — "startup exit code 표준 = ... profile mismatch=71" / 테스트 "prod profile에서 local-only 설정이 켜지면 실패" - - code: PROFILE_MISMATCH - category: INTERNAL - http_status: 500 - retryable: false - retry_after_seconds: null - owner_branch: feature-migration-startup-contract - owner_layer: infrastructure - client_safe_message: "Internal server error" - log_level: ERROR - runbook_link: "runbook://startup/profile-mismatch" - compatibility_impact: none - required_test: contract-verification:migration-startup - # ============================================================ # Management / Actuator (feature-management-actuator-security-contract) # ============================================================ @@ -916,3 +746,139 @@ errors: runbook_link: "runbook://management/actuator-forbidden" compatibility_impact: none required_test: contract-verification:management-actuator + + # ============================================================ + # CURRENT CODE RECONCILIATION (2026-09-21) + # Skeleton-wide OperationalError entries that were live in code but absent from the Phase-B + # registry. Product-specific ApiErrorCode enums remain owned by their product modules. + # ============================================================ + + - code: VALIDATION_FAILED + category: VALIDATION + http_status: 400 + retryable: false + retry_after_seconds: null + owner_branch: 2026-09-21-core-web-review-remediation + owner_layer: application + client_safe_message: "Validation failed" + log_level: INFO + runbook_link: null + compatibility_impact: additive + required_test: contract-verification:operational-error-registry + + - code: BAD_PARAMETER + category: VALIDATION + http_status: 400 + retryable: false + retry_after_seconds: null + owner_branch: 2026-09-21-core-web-review-remediation + owner_layer: presentation + client_safe_message: "Invalid request parameter" + log_level: INFO + runbook_link: null + compatibility_impact: additive + required_test: contract-verification:operational-error-registry + + - code: MAPPING_FAILED + category: VALIDATION + http_status: 400 + retryable: false + retry_after_seconds: null + owner_branch: 2026-09-21-core-web-review-remediation + owner_layer: presentation + client_safe_message: "Request mapping failed" + log_level: INFO + runbook_link: null + compatibility_impact: additive + required_test: contract-verification:operational-error-registry + + - code: BATCH_PARTIAL_FAILURE + category: VALIDATION + http_status: 200 + retryable: false + retry_after_seconds: null + owner_branch: 2026-09-21-core-web-review-remediation + owner_layer: application + client_safe_message: "Some batch items failed" + log_level: WARN + runbook_link: null + compatibility_impact: additive + required_test: contract-verification:operational-error-registry + + - code: INTERNAL_ERROR + category: INTERNAL + http_status: 500 + retryable: true + retry_after_seconds: null + owner_branch: 2026-09-21-core-web-review-remediation + owner_layer: crosscut + client_safe_message: "Internal server error" + log_level: ERROR + runbook_link: "runbook://internal/error-spike" + compatibility_impact: additive + required_test: contract-verification:operational-error-registry + + - code: UNAUTHENTICATED + category: AUTH + http_status: 401 + retryable: false + retry_after_seconds: null + owner_branch: 2026-09-21-core-web-review-remediation + owner_layer: presentation + client_safe_message: "Authentication required" + log_level: WARN + runbook_link: "runbook://auth/token-missing" + compatibility_impact: additive + required_test: contract-verification:operational-error-registry + + - code: INVALID_TOKEN + category: AUTH + http_status: 401 + retryable: false + retry_after_seconds: null + owner_branch: 2026-09-21-core-web-review-remediation + owner_layer: presentation + client_safe_message: "Authentication failed" + log_level: WARN + runbook_link: "runbook://auth/token-malformed" + compatibility_impact: additive + required_test: contract-verification:operational-error-registry + + - code: FORBIDDEN + category: AUTHZ + http_status: 403 + retryable: false + retry_after_seconds: null + owner_branch: 2026-09-21-core-web-review-remediation + owner_layer: presentation + client_safe_message: "Access denied" + log_level: WARN + runbook_link: "runbook://authz/insufficient-permission" + compatibility_impact: additive + required_test: contract-verification:operational-error-registry + + - code: ROUTE_NOT_FOUND + category: NOT_FOUND + http_status: 404 + retryable: false + retry_after_seconds: null + owner_branch: 2026-09-21-core-web-review-remediation + owner_layer: presentation + client_safe_message: "Route not found" + log_level: INFO + runbook_link: null + compatibility_impact: additive + required_test: contract-verification:operational-error-registry + + - code: DB_LOCK_TIMEOUT + category: CONFLICT + http_status: 409 + retryable: false + retry_after_seconds: null + owner_branch: 2026-09-21-core-web-review-remediation + owner_layer: infrastructure + client_safe_message: "Database lock not available" + log_level: WARN + runbook_link: null + compatibility_impact: additive + required_test: contract-verification:operational-error-registry diff --git a/docs/registries/headers.yaml b/docs/registries/headers.yaml index bdc28571..e8c8a3fe 100644 --- a/docs/registries/headers.yaml +++ b/docs/registries/headers.yaml @@ -1,10 +1,9 @@ # Registry: HTTP Headers -# SSOT: wiki/projects/ca-tmpl/registries/headers.yaml # Schema owner: feature-contract-registry-governance # Last updated: 2026-05-22 # # Conventions: -# - HTTP header name: kebab-case (X-Request-Id, X-Tenant-Id) +# - HTTP header name: kebab-case (X-Request-Id, X-Correlation-Id) # - W3C standard headers: lowercase (traceparent, tracestate) # - mdc_key: snake_case (foundation SSOT) # - envelope_meta_field: camelCase (envelope SSOT) @@ -24,20 +23,6 @@ headers: compatibility_impact: none required_test: contract-verification:envelope-headers - # source: feature-api-contract-baseline.md L67 - # "X-Api-Version은 실험/compatibility 보조 header이며 path version과 충돌하면 path가 우선" - - name: X-Api-Version - direction: inbound - type: string - required: false - generated_if_missing: false - mdc_key: null - envelope_meta_field: null - owner_branch: feature-api-contract-baseline - case_style: kebab - compatibility_impact: additive - required_test: contract-verification:api-versioning - # source: feature-api-contract-baseline.md L77 / feature-rate-limit-idempotency-contract.md L66-67 # "idempotency header 이름은 Idempotency-Key" / "기본 scope는 (authenticatedPrincipal, idempotencyKey, useCaseName)" - name: Idempotency-Key @@ -67,7 +52,7 @@ headers: required_test: contract-verification:rate-limit-headers # source: feature-rate-limit-idempotency-contract.md scope L26 (rate limit response/log 기준) - # rate-limit 응답 표면 (limit/remaining/reset 3종은 표준 rate-limit signaling) + # app.rate-limit.enabled=true인 요청 경로에서만 생성되는 rate-limit 응답 표면 - name: X-RateLimit-Limit direction: outbound type: numeric @@ -107,10 +92,10 @@ headers: required_test: contract-verification:rate-limit-headers # source: feature-api-compatibility-deprecation-contract.md L87 - # "deprecation marker | OpenAPI deprecated: true + branch note | response header optional" + # "deprecation marker | OpenAPI deprecated: true + design record | response header optional" - name: Deprecation direction: outbound - type: rfc3339-date + type: http-date required: false generated_if_missing: false mdc_key: null @@ -121,10 +106,10 @@ headers: required_test: contract-verification:deprecation-marker # source: feature-api-compatibility-deprecation-contract.md L87 - # "deprecation marker | OpenAPI deprecated: true + branch note | response header optional" (RFC 8594 Sunset) + # "deprecation marker | OpenAPI deprecated: true + design record | response header optional" (RFC 8594 Sunset) - name: Sunset direction: outbound - type: rfc3339-date + type: http-date required: false generated_if_missing: false mdc_key: null @@ -176,21 +161,6 @@ headers: compatibility_impact: none required_test: contract-verification:envelope-headers - # source: feature-tenant-context-policy.md L69, L101 (foundation) - # "tenant resolution 우선순위 = ... (2) 명시적 X-Tenant-Id 헤더 (admin/internal API only)" / - # "tenant_id | tenant context (활성 시) | downstream HTTP X-Tenant-Id (with allowlist)" - - name: X-Tenant-Id - direction: both - type: ulid - required: false - generated_if_missing: false - mdc_key: tenant_id - envelope_meta_field: null - owner_branch: feature-tenant-context-policy - case_style: kebab - compatibility_impact: additive - required_test: contract-verification:tenant-header-policy - # source: feature-security-operational-baseline.md L66 # "JWT Resource Server를 baseline security model로 둠" (Bearer token via Authorization header) - name: Authorization diff --git a/docs/registries/mdc-keys.yaml b/docs/registries/mdc-keys.yaml index 616a6b41..3d041296 100644 --- a/docs/registries/mdc-keys.yaml +++ b/docs/registries/mdc-keys.yaml @@ -1,5 +1,4 @@ # Registry: MDC / Log Keys -# SSOT: wiki/projects/ca-tmpl/registries/mdc-keys.yaml # Schema owner: feature-contract-registry-governance # MDC SSOT: feature-operational-error-observability-foundation # Last updated: 2026-05-22 diff --git a/docs/registries/metrics.yaml b/docs/registries/metrics.yaml index 5057d977..7ce326ef 100644 --- a/docs/registries/metrics.yaml +++ b/docs/registries/metrics.yaml @@ -1,5 +1,4 @@ # Registry: Metrics -# SSOT: wiki/projects/ca-tmpl/registries/metrics.yaml # Schema owner: feature-contract-registry-governance # Owner branch: feature-metrics-alerting-contract # Last updated: 2026-05-22 @@ -761,14 +760,14 @@ metrics: # === Distributed tracing === # source: feature-distributed-tracing-contract — decisions - # "trace sampling rate default = prod 1%, staging 10%, dev/local 100%" + # "trace sampling rate default = prod 1%, dev/local 100%; shipped runtime profiles are local|dev|prod" - name: tracing.sampling.rate type: gauge unit: total tags: - name: profile - cardinality_limit: 4 - allowed_values: [prod, staging, dev, local] + cardinality_limit: 3 + allowed_values: [prod, dev, local] percentiles: null histogram_buckets: null alert_severity_thresholds: diff --git a/docs/registries/secrets-classification.yaml b/docs/registries/secrets-classification.yaml index 53e7c576..1e584cc4 100644 --- a/docs/registries/secrets-classification.yaml +++ b/docs/registries/secrets-classification.yaml @@ -1,5 +1,4 @@ # Registry: Secrets Classification -# SSOT: wiki/projects/ca-tmpl/registries/secrets-classification.yaml # Schema owner: feature-contract-registry-governance # Owner branch: feature-secrets-config-source-contract # Last updated: 2026-05-22 @@ -33,47 +32,19 @@ secrets: compatibility_impact: breaking required_test: secrets-contract:db-password-no-leak-in-actuator - - name: APP_SECURITY_JWT_SIGNING_KEY - # source: feature-secrets-config-source-contract 2026-05-22 - # "JWT signing key는 24h overlap window 유지 (security branch와 cross-link)" - # + feature-security-operational-baseline "rotation overlap window = 새 kid 도입 → 24h 동안 old kid 병행" - classification: secret - source: secret-manager - rotation_policy: overlap-24h - prod_default: null - dev_sentinel_prefix: __LOCAL_DEV_ - owner_branch: feature-secrets-config-source-contract - masking_rule: full - compatibility_impact: breaking - required_test: secrets-contract:jwt-signing-key-rotation-overlap - - - name: APP_SECURITY_OAUTH_CLIENT_SECRET - # source: feature-secrets-config-source-contract 2026-05-22 - # "secret classification은 ... naming pattern은 보조(suffix _TOKEN, _KEY, _PASSWORD)" - # + feature-security-operational-baseline "JWT Resource Server를 baseline security model" (OAuth 자격 증명 분류) + - name: SPRING_MAIL_PASSWORD + # source: notification/fileserver techlead review H2 — credential consumed natively by Spring + # Mail and therefore intentionally retains the SPRING_* name rather than gaining an APP_* alias. classification: secret source: secret-manager rotation_policy: restart-only prod_default: null + required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true dev_sentinel_prefix: __LOCAL_DEV_ - owner_branch: feature-secrets-config-source-contract + owner_branch: 2026-09-21-notification-review-remediation masking_rule: full - compatibility_impact: breaking - required_test: secrets-contract:oauth-client-secret-no-leak - - - name: APP_EXTERNAL_API_KEY - # source: feature-secrets-config-source-contract 2026-05-22 - # "external API key는 application restart 시 reload" - # (per-dependency suffix는 adapter 등록 시 추가; 본 row는 baseline 분류 정의) - classification: secret - source: secret-manager - rotation_policy: restart-only - prod_default: null - dev_sentinel_prefix: __LOCAL_DEV_ - owner_branch: feature-secrets-config-source-contract - masking_rule: full_except_last_4 - compatibility_impact: breaking - required_test: secrets-contract:external-api-key-no-leak + compatibility_impact: additive + required_test: secrets-contract:smtp-password-no-leak - name: APP_CACHE_REDIS_PASSWORD # source: feature-secrets-config-source-contract 2026-05-22 @@ -395,6 +366,19 @@ secrets: compatibility_impact: breaking required_test: secrets-contract:datasource-username-masked-in-actuator + - name: SPRING_MONGODB_URI + # MongoDB URIs can carry username/password material and must never be logged as public config. + # Typed-profile deployments should prefer uri-secret so the URI itself never becomes env data. + classification: sensitive-config + source: mounted-env + rotation_policy: restart-only + prod_default: null + dev_sentinel_prefix: __LOCAL_DEV_ + owner_branch: persistence-mongo-runtime-remediation + masking_rule: full_except_last_4 + compatibility_impact: additive + required_test: secrets-contract:mongodb-uri-masked + - name: APP_DATASOURCE_URL # source: feature-secrets-config-source-contract 2026-05-22 — JDBC URL은 host/db 포함하므로 sensitive-config # (env-keys.yaml에서는 public-config 처리; 본 파일에서는 노출 통제 관점에서 sensitive로 재분류 — masking 기준 명시 목적) diff --git a/docs/reviews/2026-08-14-jpa-module-code-review.md b/docs/reviews/2026-08-14-jpa-module-code-review.md index b1cb584b..c75429a4 100644 --- a/docs/reviews/2026-08-14-jpa-module-code-review.md +++ b/docs/reviews/2026-08-14-jpa-module-code-review.md @@ -1581,25 +1581,18 @@ cd src - [ ] focused test, full `test`, full `check`, architecture validators의 실행 명령과 결과를 PR에 남긴다. - [ ] Docker/보호 환경 때문에 실행하지 못한 검증은 이유와 남은 위험을 명시한다. -## 11. LLM Wiki capture +## 11. documentation update 이 리뷰는 의미 있는 아키텍처/코드 감사이므로 root `AGENTS.md`의 capture 대상이다. 최종 응답 전에 -`/home/donghyeon/workspace/ai-tool/llm-wiki-private/raw/branch-notes/main.md`에 current HEAD, finding, 변경 파일, 검증, 미실행 Docker lane, evidence grade를 추가한다. 이번 작업은 구현 전 read-only review이므로 -별도 canonical `wiki/` 추출이나 interview/blog 파생 문서는 만들지 않는다. 실제 capture 결과: -- `raw/branch-notes/main.md`에 `2026-08-14 캡처 — merge 이후 JPA persistence 모듈 상세 리뷰`를 추가했다. - 제품 HEAD/규모/30개 finding 요약, 단계별 결정, 변경 파일, 성공·실패·미실행 검증과 evidence grade를 기록했다. -- `raw/errors/`는 새 실패 모드가 없어 별도 생성하지 않았고, shared Gradle output 경합은 기존 - `[[raw/errors/parallel-gradle-shared-build-race-2026-08-10]]`를 가리켰다. -- `raw/interviews/`, `raw/blog-topics/`, canonical `wiki/`는 구현 전 read-only finding이므로 별도 파생 없음으로 기록했다. -- `wiki_structure_lint.py --file raw/branch-notes/main.md --links-only`: PASS. - full single-file lint는 제품 규칙이 요구하는 실제 branch 파일 `main.md`와 vault의 4-prefix naming rule이 충돌해 기존 `NAMING_VIOLATION` 1건으로 실패했다. 파일을 임의 rename하거나 어느 정책도 완화하지 않았다. -- untracked branch-note에 대한 `git diff --no-index --check /dev/null ...`은 whitespace 진단 출력 0 bytes였다 +- untracked design record에 대한 `git diff --no-index --check /dev/null ...`은 whitespace 진단 출력 0 bytes였다 (내용 diff 때문에 command exit 1은 정상). diff --git a/docs/reviews/2026-08-14-messaging-module-code-review.md b/docs/reviews/2026-08-14-messaging-module-code-review.md index 05baf77e..b4d96747 100644 --- a/docs/reviews/2026-08-14-messaging-module-code-review.md +++ b/docs/reviews/2026-08-14-messaging-module-code-review.md @@ -1535,12 +1535,9 @@ green으로 해석하면 안 된다. 위 architecture/static gate의 통과는 현재 registry가 스스로 일관된다는 증거다. root policy의 “19개”와 실제 43개가 의미적으로 일치하거나 신규 platform이 runtime-ready라는 증거는 아니다. -## 12. LLM Wiki 캡처 +## 12. 문서 갱신 -필수 작업 기록은 `/home/donghyeon/workspace/ai-tool/llm-wiki-private/raw/branch-notes/main.md`의 `2026-08-14 캡처 — merge 이후 Messaging 모듈 상세 리뷰` 섹션에 갱신했다. 검토 범위, 25개 finding의 핵심 판정, 구현 순서, 변경 파일, 실행한 검증, 실패·미실행 범위와 evidence grade를 기록했다. -이번 작업은 production 구현 전 read-only review이므로 `raw/errors/`, `raw/interviews/`, -`raw/blog-topics/` 및 canonical `wiki/` 파생 문서는 만들지 않았다. 실제 P0/P1 구현과 transaction/rebalance/restart/cutover evidence가 생긴 뒤 파생 여부를 다시 판단한다. diff --git a/docs/reviews/2026-08-14-mongodb-module-code-review.md b/docs/reviews/2026-08-14-mongodb-module-code-review.md index 3a3429e5..d5d49732 100644 --- a/docs/reviews/2026-08-14-mongodb-module-code-review.md +++ b/docs/reviews/2026-08-14-mongodb-module-code-review.md @@ -1215,9 +1215,8 @@ Mongo platform을 Stable/production-ready로 다시 판정하려면 최소한 이 체크리스트를 충족하기 전의 정확한 표현은 “MongoDB persistence platform contract와 일부 실행 경로가 구현된 opt-in experimental leaf”다. -## 11. LLM Wiki capture +## 11. documentation update -- 갱신: `/home/donghyeon/workspace/ai-tool/llm-wiki-private/raw/branch-notes/main.md` - 기록 내용: 기준 HEAD, 검토 범위, 핵심 finding, 구현 순서, 변경 파일, fresh Gradle 결과, `check` blocker, Docker/Advanced 미실행 범위, 증거 등급. - 파생 raw 문서: 없음. 구현 전 read-only finding이므로 interview/blog/canonical로 승격하지 않았다. diff --git a/docs/reviews/2026-09-18-app-bootstrap-review-closure.md b/docs/reviews/2026-09-18-app-bootstrap-review-closure.md new file mode 100644 index 00000000..65273a23 --- /dev/null +++ b/docs/reviews/2026-09-18-app-bootstrap-review-closure.md @@ -0,0 +1,96 @@ +# app-bootstrap 리뷰 종료 판정 — 2026-09-18 + +기준 리뷰: `docs/reviews/2026-09-07-app-bootstrap-module-code-review.md` + +이 문서는 원 리뷰를 수정하지 않는다. 원 리뷰는 당시 checkout의 증거이고, 이 문서는 2026-09-18 +현재 checkout에서 각 BOOT 항목을 다시 측정한 **종료 판정**이다. + +상태는 세 가지다. + +- **완료**: 원 지적의 원인이 제거됐고 현재 구조/검증에서 재발 방지가 확인됨. +- **최신 결정으로 대체**: 문제의 일부 전제 또는 처방을 이후 승인된 설계가 의도적으로 바꿈. +- **완료 — 명시적 예외 유지**: 원 리뷰 자체가 허용한 좁은 예외만 남음. + +## 판정표 + +| ID | 상태 | 현재 판정 | +| --- | --- | --- | +| BOOT-001 | **최신 결정으로 대체** | “설정 root를 전부 `ca-skeleton.*`로 통일” 처방은 이후 Wave 1 activation SSOT가 대체했다. 현재 activation authority는 capability별 canonical key를 명시한다. 예: JPA=`ca-skeleton.persistence-jpa.enabled`, Messaging=`app.messaging.enabled`, Fileserver=`app.fileserver.enabled`. 따라서 root 이름의 단일화가 아니라 **한 capability에 activation authority가 하나인가**가 현재 invariant다. | +| BOOT-002 | **완료** | 프로파일 어휘는 `shared-contract RuntimeEnvironment`가 소유한다. bootstrap production 코드의 `prod/production/local/dev` 직접 문자열 비교는 0. 남은 helper는 Spring `Environment`를 canonical predicate에 전달하는 얇은 adapter다. | +| BOOT-003 | **완료** | startup validation은 typed `StartupFailures` 경로를 사용하고, `StartupFailureContractArchitectureTest`가 raw `IllegalStateException` 재도입을 막는다. allowlist는 API/JVM invariant와 failure machinery뿐이다. | +| BOOT-004 | **완료** | `StartupValidationContext`가 누적 검증과 phase별 failure 생성을 공통화한다. | +| BOOT-005 | **완료** | `StartupOrder`가 startup ordering vocabulary/순서를 소유한다. | +| BOOT-006 | **완료** | capability assembly는 `autoconfigure//`로 통일됐다. 리뷰 당시 top-level capability package 잔여는 0. Settings 배치 규칙과 runtime guard 예외는 `app-bootstrap/CLAUDE.md`에 문서화됐다. | +| BOOT-007 | **완료** | Redis는 cache/rate-limit/lease/idempotency/root/key helper로 분해됐다. configuration 분해 threshold도 `app-bootstrap/CLAUDE.md`에 고정됐다. | +| BOOT-008 | **완료** | `application.yml`은 248줄이며 top-level application settings를 config fragments로 분리했다. 현재 resources 아래 YAML은 19개 fragment/entry 파일로 나뉜다. | +| BOOT-009 | **완료** | runtime warning/error 로그가 structured fields를 사용한다. Fileserver cleanup, Outbox relay, distributed-lock lease expiry까지 고정 필드를 추가했고 `docs/observability/log-fields.md`를 field dictionary로 추가했다. 실제 bootstrap WARN/ERROR 중 unstructured 후보는 0. | +| BOOT-010 | **완료** | idempotency provider selection의 `switch`는 0. 각 `Provider` 상수가 필요한 bean composition expectation을 함께 소유한다. | +| BOOT-011 | **완료** | strict bind mechanics는 `adapter:outbound:support StrictSettingsBinder` 한 곳에 있다. Fileserver/HTTP client binder에는 capability-specific 차이만 남는다. | +| BOOT-012 | **완료** | architecture suite는 단일 2,792줄 테스트가 아니라 `src/architectureTest`의 22개 top-level architecture test로 분리됐다. | +| BOOT-013 | **완료** | startup failure marker는 process-global `AtomicBoolean`이 아니라 Logback Context object map에 저장된다. `clearForTest`와 mutable static state는 0이고 context-isolation test가 있다. | +| BOOT-014 | **완료** | app-bootstrap `src/test`의 실제 Testcontainers 사용은 0. 남은 Testcontainers import는 taxonomy rule을 검증하기 위한 negative fixture뿐이다. 실제 PostgreSQL 검증은 INTEGRATION lane에 있다. | +| BOOT-015 | **완료** | custom `src/testkit` source set은 0. cross-source-set/cross-leaf 공유 fixture publish 표준은 `java-test-fixtures`. app-bootstrap의 source-set-local helper는 외부 consumer가 0이므로 해당 source set에 남긴다. | +| BOOT-016 | **완료** | `docs/testing/TESTING_STRATEGY.md`를 현재 machine taxonomy와 정렬했다: TEST / INTEGRATION / SYSTEM / ARCHITECTURE / PERFORMANCE. unit/slice/contract는 TEST style이고 qualification은 gate다. 9/16 결정에 따라 Markdown↔Gradle parser는 복원하지 않는다. | +| BOOT-017 | **완료 — 명시적 예외 유지** | `EnvironmentSecretSource` 등 outbound adapter ownership은 leaf로 이동했다. bootstrap의 application/domain port implementation은 `MeteredDistributedLockPort` 하나뿐이며, 이는 원 리뷰가 “두 번째 decorator가 생기기 전까지 bootstrap 유지 가능”이라고 명시한 예외다. | + +## 이번 종료 확인에서 함께 닫힌 회귀 + +PostgreSQL idempotency store composition을 JPA leaf로 이동한 뒤 +`IdempotencyProviderScanCollisionTest`가 예전 fixture 조립을 가정하고 있었다. + +테스트를 실제 shipped composition에 맞췄다. + +- JDBC store만 fixture로 제공한다. +- `IdempotencyConfig`가 실제 executor/settings를 생성한다. +- 중복 수동 `IdempotencyExecutor` / `IdempotencySettings` bean을 제거했다. +- 최종 assertion은 JDBC V1 store 1, executor 1, owner-safe V2 store 0이다. + +이 수정 후 app-bootstrap full unit + architecture suite가 다시 GREEN이다. + +## 최종 검증 + +2026-09-18 현재 다음이 성공했다. + +`./gradlew :app-bootstrap:spotlessJavaCheck :app-bootstrap:test :app-bootstrap:architectureTest --warning-mode=fail --console=plain` + +- BUILD SUCCESSFUL +- app-bootstrap real WARN/ERROR 중 unstructured candidate: 0 +- BOOT-014 real Testcontainers import in `src/test` excluding negative fixture: 0 +- BOOT-015 `src/testkit` directories: 0 +- BOOT-017 bootstrap application/domain port implementation: documented decorator 1개 +- `git diff --check`: PASS + +Test taxonomy alignment: + +`./gradlew -p build-logic test --tests 'dev.caskeleton.buildlogic.strictlane.StrictTestLaneConventionTest' --warning-mode=fail --console=plain +./gradlew help --warning-mode=fail --console=plain` + +둘 다 PASS. + +## 결론 + +이 리뷰의 BOOT-001~017 중 **추가 구현이 필요한 미완료 항목은 없다.** + +BOOT-001은 “모든 prefix를 한 root로 합친다”는 원 처방을 실행하지 않는다. 더 최신의 activation SSOT가 +capability별 canonical activation key를 승인했기 때문이다. 나머지 항목은 완료됐거나 원 리뷰가 허용한 +좁은 예외만 남는다. + +따라서 이후 작업은 이 리뷰의 잔여 수정이 아니라 **새 리뷰/새 설계에서 발견되는 별도 개선**으로 +취급한다. + +## 2026-09-19 shared-worktree note + +The BOOT-001~017 closure above remains unchanged: there are no review items requiring additional +implementation. After that closure verification, unrelated concurrent edits appeared in the shared +worktree and currently block the aggregate app-bootstrap formatting/architecture commands before +they reach these review changes: + +- `app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/SecretReloadContractTest.java`: + comment wording changed but was not Spotless-formatted; +- `app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/ArchitectureViolationFixtureTest.java`: + a Javadoc line was removed while leaving an open `{@code` tag, so Error Prone fails + `compileArchitectureTestJava`. + +These files were not rewritten here because the repository is shared with other in-progress +uncommitted work. The BOOT-009 focused logging tests still pass, the direct production WARN/ERROR +inventory has zero unstructured candidates, and `git diff --check` passes. diff --git a/docs/reviews/2026-09-18-techlead-review/00-overview.md b/docs/reviews/2026-09-18-techlead-review/00-overview.md new file mode 100644 index 00000000..f3410e76 --- /dev/null +++ b/docs/reviews/2026-09-18-techlead-review/00-overview.md @@ -0,0 +1,687 @@ +# ca-skeleton 최종 테크리드 리뷰 + +- **대상**: `codebase/clean-architecture-backend-template` +- **원본 리뷰 스냅샷**: 2026-09-18 워킹트리 / HEAD `60b6a319` 기준 +- **성격**: `01`~`13`의 상세 근거를 실행 가능한 최종 리팩터링 기준으로 정리한 정본 +- **주의**: 세부 문서의 line number와 working-tree 상태는 리뷰 스냅샷 기준이다. 구현 시 현재 코드에서 다시 확인한다. +- **우선순위**: 영역 문서의 과거 처방이 이 문서의 최종 아키텍처 원칙과 충돌하면 **이 문서가 우선**한다. + +--- + +## 0. 2026-09-21 중간 점검 + +이 섹션은 2026-09-18 원본 리뷰를 현재 워킹트리에 다시 대조한 결과다. 저장소는 다른 세션에서도 +동시에 수정 중이므로 파일 개수는 **점검 시점의 스냅샷**이다. 아래의 “완료”는 해당 finding의 +재검증 결과를 뜻하며 전체 리팩터링 완료를 뜻하지 않는다. + +### 0.1 Phase 진행 상태 + +| Phase | 중간 판정 | 현재 근거 | +|---|---|---| +| **0 — migration 안정화** | **진행 중** | 점검 시작에는 `modified 524 / deleted 1290 / untracked 262`였고 문서 반영 후 재확인 시 `531 / 1290 / 263`으로 변했다. 다른 세션이 동시에 수정 중이라는 뜻이다. `git diff --check`는 PASS지만 tracked 삭제와 untracked 대체물이 대규모로 공존하며 리뷰 폴더 자체도 아직 untracked다. | +| **1 — CI / Release graph** | **대부분 완료, 1개 중요 공백** | Dockerfile은 `build-tools`를 복사하고, CI는 `build-tools test`를 실행하며, release는 `:releaseCheck` aggregate를 사용한다. `integration-main.yml`도 생겼다. 단 `grpc-operation-ledger-jpa:integrationTest`는 어떤 workflow/optional-platform `ci`에서도 실행되지 않는다. | +| **2 — Capability Composition ownership** | **부분 완료, 핵심 blocker** | HTTP Client/JPA/Mongo/Notification/Messaging/Redis SDK 등 여러 leaf가 자기 `AutoConfiguration.imports`를 얻었다. 그러나 `app-bootstrap`은 아직 Mongo/Messaging/Redis/Notification/Fileserver/HTTP Client/GraphQL 등을 `implementation`으로 ship하며, main Java에서 adapter 타입 직접 import가 점검 시점 120건이다. Fileserver 28개, Redis semantic wiring 10개 등 provider 조립이 bootstrap에 남아 있다. | +| **3 — Test Architecture** | **상당 부분 완료** | 일반 `src/test`에서 Testcontainers 사용은 taxonomy positive-control fixture 1개뿐이다. `integrationTest` 10개, `systemTest` 5개 등 실행 레벨 분리가 실제 소스셋으로 진행됐다. 남은 핵심은 새 lane의 CI reachability를 전수 확인하는 것이다. | +| **4 — Core boundary** | **상당 부분 완료** | `application-fileserver`, `application-notification`, `application-objectstorage`가 분리됐다. `application-core/src/main/java`에서 Spring HTTP/web/servlet, `HttpStatus`, `ContentDisposition` 등 transport 의존 후보를 다시 스캔했을 때 0건이었다. | +| **5 — Semantic defects** | **주요 항목 다수 수정됨** | Web request-id trust 충돌, WebSocket `CONNECTION_MUST_CLOSE`, Mongo deadline의 `NOT_SENT` 오판, Notification SMTP TLS, Messaging logical broker/starter 분리가 코드와 회귀 테스트로 확인됐다. focused regression 5개 leaf 묶음도 PASS했다. | +| **6 — Build simplification** | **아직 미완료, 방향 재조정 필요** | `build-logic 82 files / 5,646 LOC`, `build-tools 97 / 5,544 LOC`로 원 리뷰 때보다 줄지 않았다. `JavaConventionsPlugin`은 여전히 `api-surface`, `dependency-policy`, `strict-qualification`을 모든 Java leaf에 자동 적용한다. JPA `set_config` 문자열 검사를 위한 새 source scanner도 `build-tools`에 추가됐다. | +| **7 — Runtime / Compose / Docs** | **아직 본격 착수 전** | Compose 6개가 여전히 root에 평평하게 있고 `scripts/run local|dev` 같은 launcher는 없다. 현재 실행 스크립트는 runtime smoke/compose contract 중심이다. | + +### 0.2 이번 점검에서 새로 확정된 blocker + +**P0 — Build Composition 목표와 `app-bootstrap`의 실제 dependency graph가 아직 충돌한다.** + +`app-bootstrap/build.gradle`에는 여전히 “shipped so an operator can enable it with one environment +variable”, “all adapters are in one artifact and off is a switch rather than omission”이라는 과거 전제가 +남아 있다. 이는 이 리뷰의 정본인: + + Repository Capability Catalog + ↓ + Build Composition + ↓ + Runtime Activation + +과 직접 충돌한다. leaf-owned AutoConfiguration 이전만으로 Phase 2를 완료로 볼 수 없다. +**optional capability가 실제 application artifact에서 선택적으로 빠질 수 있는 composition**까지 +완성해야 한다. + +**P0 — gRPC operation ledger의 real-PostgreSQL integration lane이 고아다.** + +`grpc-operation-ledger-jpa`는 Testcontainers PostgreSQL을 사용하는 `integrationTest`를 선언하고 +`strictTestLanes`에도 등록했지만: + +- `optional-platforms:ci`는 `checkAll`, `qualityCheck`, architecture verification만 실행하고, +- `release.yml`의 gRPC gate는 `grpc-testkit`의 in-process/netty/fault만 실행하며, +- `integration-main.yml`에도 operation-ledger lane이 없다. + +따라서 durable idempotency의 atomic claim을 실 PostgreSQL로 검증하는 테스트가 존재하면서도 CI에서 +실행되지 않는다. + +**P1 — Build simplification 작업 중 새 build-time semantic scanner가 추가됐다.** + +`build-tools/jpa/SetConfigParameterBindingVerifier`는 Java source text에서 `set_config('...')`와 `?` +존재 여부를 스캔한다. 핵심 계약은 유효하지만 이 검증은 Gradle resolution/task graph를 필요로 하지 +않는다. 지금 목표라면 `persistence-jpa`의 architecture/unit test가 소유할 성격이다. Phase 6에서 +`build-tools`를 줄이는 동안 같은 종류의 verifier를 추가하면 방향이 다시 반대로 간다. + +### 0.3 재검증 통과 증거 + +이번 중간 점검에서 다음은 실제 명령으로 다시 확인했다. + + ./gradlew :adapter:outbound:persistence-jpa:check :app-bootstrap:architectureCheck + # BUILD SUCCESSFUL + + ./gradlew :sample-portfolio:check + # BUILD SUCCESSFUL + + ./gradlew :adapter:inbound:web:test :adapter:inbound:websocket:test :adapter:outbound:persistence-mongo:test :adapter:outbound:notification:test :messaging:messaging-spring-boot-starter:test + # BUILD SUCCESSFUL + + git diff --check + # PASS + +첫 focused regression 시도는 다른 세션이 `build-logic` 파일을 수정하는 순간과 겹쳐 일시적인 Java +syntax error를 관측했지만, 같은 파일이 수정 완료된 뒤 재실행한 위 명령은 **2m 55s에 PASS**했다. +따라서 그 일시 실패를 저장소 결함으로 판정하지 않는다. + +### 0.4 다음 중간 구간의 우선순위 + +1. `app-bootstrap`의 optional capability `implementation`과 provider wiring을 Build Composition 기준으로 끝낸다. +2. `grpc-operation-ledger-jpa:integrationTest`에 실제 CI/release caller를 연결한다. +3. `StrictQualification` 중복 및 global special-plugin auto-apply를 줄이고, 새 semantic verifier를 owner test로 되돌린다. +4. 남은 integration/system lane을 “등록됨”이 아니라 “실제로 workflow에서 실행됨” 기준으로 전수 재검증한다. +5. 위 구조가 안정화된 뒤에만 Compose/env launcher 정리를 시작한다. + +## 0-A. 2026-09-23 재점검 + +### 현재 판정 + +**작업량은 컸지만 핵심 blocker 폐쇄 속도는 낮다.** 2026-09-21 중간 점검 이후 많은 leaf와 +검증 코드가 바뀌었지만, 최상위 목표인 Build Composition과 build-system 단순화는 거의 진전되지 +않았다. 반대로 현재 focused gate는 다시 red 상태다. + +점검 시점 워킹트리: + + 2026-09-21: modified 531 / deleted 1290 / untracked 263 + 2026-09-23: modified 835 / deleted 1336 / untracked 317 + +변경량 자체가 결함은 아니지만 tracked 삭제 + untracked 대체물이 계속 커지는 동안 최상위 gate가 +red라는 점은 migration wave를 더 넓히기 전에 안정화가 필요하다는 신호다. + +### 9월 21일 blocker 재검증 + +| 항목 | 2026-09-23 판정 | 근거 | +|---|---|---| +| app-bootstrap Build Composition | **아직 더 봐야댐** | optional capability는 여전히 `implementation`으로 기본 ship된다. bootstrap의 adapter 직접 import는 120→121건으로 줄지 않았다. fileserver 28 / redis 10 / jpa 13 config class가 bootstrap에 남아 있다. | +| gRPC operation-ledger real-DB caller | **아직 더 봐야댐** | `.github/workflows`에 `grpc-operation-ledger-jpa` 참조 0건, `optional-platforms:ci`도 integration lane을 aggregate하지 않는다. | +| Build simplification | **아직 더 봐야댐** | `build-logic` 82 files / 5,671 LOC, `build-tools` 102 / 6,152 LOC. 9월 21일보다 `build-tools`가 5 files / 608 LOC 증가했다. special governance plugin global auto-apply도 그대로다. | +| Test taxonomy | **진척됨** | ordinary `src/test`의 Testcontainers 사용은 positive-control fixture 1개뿐이라는 상태가 유지된다. | +| Clean Architecture dependency verifier | **완료** | 이번 재검증에서 `verifyCleanArchitectureDependencies` 자체는 PASS했다. 이전 Gradle 9 unsafe-resolution 실패는 현재 재현되지 않는다. | + +### 현재 실제 red gate + +다음 명령을 현재 워킹트리에서 다시 실행했다. + + ./gradlew verifyCleanArchitectureDependencies \ + :adapter:outbound:persistence-jpa:test \ + :app-bootstrap:test \ + :app-bootstrap:architectureTest \ + --continue --console=plain + +결과는 **BUILD FAILED, 3 task failures**다. + +1. `persistence-jpa:test` — 529 tests 중 2 failed. + - `JpaModuleBoundaryTest`가 비어 있는 `auditing` package를 아직 independent capability/catalog로 + 요구한다. 실제 production class는 `audit`에 있고 `auditing` 디렉터리에는 class가 없다. + - 이는 진행 중 package/topology refactor와 boundary catalog가 원자적으로 맞춰지지 않은 상태다. +2. `app-bootstrap:test` — 694 tests 중 2 failed, 4 skipped. + - Redis composition test가 `redis-a:6379`에 실제 연결을 시도한다. `src/test` composition test가 + live Redis ACL probe를 통과해야 하는 비-hermetic 상태가 됐다. + - `UNAUTHENTICATED`, `INVALID_TOKEN`, `FORBIDDEN` 세 mandatory error code는 어떤 runbook에도 + 연결되지 않아 runbook contract가 실패한다. +3. `app-bootstrap:architectureTest` — 182 tests 중 1 failed. + - `PersistenceJpaRootAutoConfiguration`이 leaf 내부 타입 + `PersistenceJpaLeafReadyAutoConfiguration`을 annotation member로 직접 참조한다. + - 이 실패는 단순 테스트 드리프트가 아니라 **bootstrap이 leaf 내부 조립 타입을 직접 아는 현재 + Phase 2 blocker를 그대로 증명한다.** + +### 우선순위 교정 + +지금부터는 새 finding을 넓히기보다 다음 순서로 닫아야 한다. + +1. 현재 5개 실패를 green으로 복구하되, symptom patch가 아니라 ownership/test-lane 원인을 먼저 닫는다. +2. `app-bootstrap`의 provider-internal imports와 optional `implementation`을 Build Composition 목표에 맞게 정리한다. +3. gRPC operation-ledger real-DB lane에 자동 caller를 연결한다. +4. `build-tools`/global governance plugin 축소를 실제 파일 수와 task graph 감소로 증명한다. +5. 그 뒤에만 남은 leaf Medium/Low finding과 Compose/runtime 문서 정리를 계속한다. + +**이 순서를 지키지 않고 다시 leaf 세부 항목을 넓히면 작업량은 계속 늘어도 최종 완료 시점은 가까워지지 않는다.** + +## 1. 최종 판정 + +**부품 품질보다 조립 경계와 조립 검증이 약하다.** + +Redis, Messaging, WebSocket, GraphQL, Notification, JPA, Mongo, Fileserver에는 재사용 가치가 높은 구현, +실패 의미론, 동시성 제어, provider 계약 테스트가 이미 많이 존재한다. 문제는 그 코드가 실제 서비스에 +어떤 방식으로 **채택되고, 조립되고, 활성화되며**, 그 조립이 실제 배포 형태로 검증되는지가 영역마다 +다르다는 점이다. + +최종 목표: + + Repository Capability Catalog + ↓ + Build Composition + ↓ + Runtime Activation + +- Repository Capability Catalog: 저장소에는 선택 가능한 구현체/알고리즘을 충분히 보유한다. +- Build Composition: 파생 서비스가 실제 사용할 capability만 dependency graph/artifact에 포함한다. +- Runtime Activation: 포함된 capability 중 현재 환경에서 사용할 기능만 Bean/connection/thread를 활성화한다. + +> 저장소에 구현체가 있다고 모든 파생 서비스가 그 구현체를 ship해야 하는 것은 아니다. + +> 특정 capability를 ship하기로 선택했다면 switch off 상태에서 Bean·connection·thread·scheduler가 없어야 한다. + +## 2. 최종 아키텍처 목표 + +### 2.1 Application → Adapter → Capability + + Application-owned Port + ↓ + Thin Adapter + ↓ + Reusable Capability + ↓ + External Technology + +Application은 Redis/Kafka/S3가 아니라 `RateLimitPort`, `EventPublisherPort`, `ObjectStoragePort` 같은 +application-owned 계약을 요구한다. Adapter는 그 계약을 capability API에 번역하고 capability는 +provider-specific 구현, 알고리즘, 장애 처리, 관측을 소유한다. + +### 2.2 Composition ownership + +재사용 가능한 Spring 조립은 **그 구현을 소유한 leaf/starter**가 소유한다. + + 잘못된 방향 + app-bootstrap + ├─ Redis 세부 Bean graph + ├─ HTTP client 세부 Bean graph + ├─ Notification provider 세부 Bean graph + └─ JPA 구현 내부 설정 + + 목표 + adapter/capability leaf + └─ RootAutoConfiguration + └─ 내부 Bean graph + + app-bootstrap + └─ selected capability + application-wide common bootstrap + +`app-bootstrap`에는 entry point, 공통 `Clock`/runtime environment/observability baseline, +capability 간 배타성·필수 조합 같은 composition-level 검증만 남긴다. + +### 2.3 Build Composition과 Runtime Activation + +`implementation`/`runtimeOnly`와 `@ConditionalOnProperty`는 다른 문제를 푼다. + + dependency 없음 → runtimeClasspath/artifact 없음 + dependency 포함 + switch off → classpath 있음, Bean/resource 없음 + dependency 포함 + switch on → 실제 capability 조립 + +leaf ownership을 정리한 뒤 bootstrap이 구현 타입을 직접 import하지 않는 선택 capability는 +`runtimeOnly`까지 낮출 수 있는지 검토한다. `runtimeOnly` 자체가 목표는 아니다. + +### 2.4 Test Architecture + +실행 레벨은 다음 다섯 개를 기준으로 한다. + + test + integrationTest + systemTest + architectureTest + performanceTest + +`contract/security/migration/fault/compatibility/release`는 실행 레벨이 아니라 목적이다. + + Component contract → 직접 등록된 부품이 올바르게 동작하는가? + Composition contract → 실제 shipped application이 그 부품을 발견·조립하는가? + +`ApplicationContextRunner.withUserConfiguration(...)`만으로는 composition contract를 증명하지 못한다. + +### 2.5 Build System + +Gradle은 plugin/dependency/source set/classpath/artifact/task wiring/input-output를 담당한다. +`build-logic`은 얇은 convention 중심으로 유지하고 `StrictTestLane`의 fail-open 방어는 유지한다. +`build-tools`는 물리적으로 남을 수 있지만 evidence/readiness/qualification 플랫폼 전체를 보존해야 한다는 +뜻은 아니다. 외부 감사·attestation 요구가 없는 검증은 test/CI로 단순화한다. + +## 3. 이 리뷰를 구현에 사용하는 방법 + + Finding + ↓ + 현재 코드에서 재확인 + ↓ + 최종 아키텍처와 대조 + ↓ + failing regression test + ↓ + minimal fix / ownership refactor + ↓ + integration/composition verification + +다음 과거 처방은 적용하지 않는다. + +1. 모든 optional capability를 bootstrap `implementation`으로 계속 ship하고 ENV만으로 제어. +2. 죽은 provider config를 중앙 bootstrap `AutoConfiguration.imports`에 계속 추가. +3. defect마다 readiness/evidence/qualification DSL을 추가. +4. semantic label마다 source set을 추가. +5. CI caller가 없는 verification task를 “존재하므로 검증됨”으로 간주. + +유지: application/domain 경계, real-provider integration test, build-time optional 격리, +runtime switch fail-closed, `StrictTestLane`, 실제 production composition test. + + +## 4. 왜 이렇게 됐는가 — 단일 메커니즘 + +Spring Boot에서 자동설정이 등록되려면 **두 가지가 모두** 필요하다. + +``` +① 클래스의 @AutoConfiguration 애노테이션 +② META-INF/spring/....AutoConfiguration.imports 파일의 한 줄 +``` + +저장소 전체를 세면: + +| | 개수 | +|---|---| +| ①을 검사하는 테스트 파일 | **62** | +| `AutoConfiguration.imports` 파일 | **11** | +| ②를 검사하는 테스트를 가진 leaf | **3** (graphql, persistence-jpa, grpc-starter) | + +**그리고 이번에 찾은 조립 결함이 전부 나머지 8개 쪽에 있다.** + +이건 특수한 실수가 아니라 저장소 전체의 테스트 전략이 만든 구조적 사각지대다. 더 넓게 재면: + +| | 파일 수 | +|---|---| +| 전체 테스트 파일 | **1,899** | +| 컨텍스트를 직접 조립 (`ApplicationContextRunner`) | 102 | +| └ 설정 클래스를 손으로 주입 (`withUserConfiguration`) | 78 | +| └ 자동설정을 손으로 공급 (`AutoConfigurations.of`) | 40 | +| **실제 배포 컴포지션 루트를 기동** | **16 (0.84%)** | + +**부품은 1,883개 파일이 지키고, 이음새는 16개가 지킨다.** + +그래서 다음이 전부 통과했다. + +- `RedisCapabilityCompositionTest.java:35-38` — `withUserConfiguration`으로 죽은 설정을 손수 등록 +- gRPC — 영역 전체에 Spring 컨텍스트 테스트 **0건**, 267줄 `GrpcPlatformStartupValidator`가 + 호출되지 않는데 267줄 테스트가 정적 호출로 초록 +- WebSocket — 조합 클래스가 main에 **하나도 없는데** 테스트 482개가 초록 + (조합 로직이 테스트 안에 다시 구현돼 있다: `CommandLossRecoveryTest:59-73`) +- notification — 자동설정이 `.imports` 없이 **실행 중인 애플리케이션에 존재하지 않았는데** + 6개 빈 테스트가 `AutoConfigurations.of`로 스스로 등록을 공급해 초록 + +### 각 지점의 판단은 옳았다 — 합계를 소유한 사람이 없을 뿐이다 + +이걸 부주의로 읽으면 처방을 틀린다. `adapter:inbound:web` leaf의 픽스처 앱이 실제 컴포지션을 +**의도적으로** 피하고, 그 이유를 코드에 적어 뒀다 (`ContractFixtureApplication.java:19-22`): + +> *"No component scan. Scanning would pull in whatever else this leaf ships — the security chain, the +> file server, the notification callbacks — and the gate would then be **testing the sum of them +> rather than the status contract**."* + +leaf 단위에서 이 판단은 **옳다.** 전송 계약 테스트가 알림 콜백 때문에 깨지면 그 게이트는 곧 꺼진다. +문제는 이 옳은 판단이 62개 leaf에서 각각 반복되고, **합계를 소유한 곳이 `app-bootstrap`의 16개 +파일뿐**이라는 것이다. `adapter:inbound:web`은 main·test·testFixtures·보조 소스셋 전체에서 +`CaSkeletonApplication`을 언급하는 파일이 **0개**다. + +수치로 보면 web leaf 하나에서: + +| | 개수 | +|---|---| +| 테스트 클래스 | 126 | +| 부품 검증 (Spring 없음) | 100 (79%) | +| 조합 장치 | 26 (전부 설정 클래스를 **이름으로** 수동 주입) | +| **"배포 컨텍스트가 무엇을 조립했는가"를 묻는 것** | **0** | + +부품 검증은 대상을 `new`로 만들어 부르니 원리적으로 "아무도 안 부른다"를 관측할 수 없고, +조합 검증은 설정 클래스를 이름으로 올리니 "배포가 이걸 찾는가"를 물을 수 없다. +**두 방식 다 옳게 쓰이고 있고, 두 방식 다 이 질문에는 답할 수 없다.** + +### 되풀이되는 두 가지 형태 + +**(가) 미배선을 잡는 장치가 미배선이다.** 세 영역에서 독립적으로 나왔다. + +| 영역 | 장치 | 상태 | +|---|---|---| +| web | `WebPlatformStartupValidator` | 프로덕션 생성처 **0건**. 테스트 javadoc이 *"a control that is configured and not wired behaves exactly like one that works, right up until it is needed"*라고 적는다 | +| WebSocket | `WebSocketPlatformStartupValidator` · `WebSocketStackExclusivity` · `StompBrokerExclusivity` | main 호출부 **0건**. `StompConfiguration:17-19` Javadoc은 *"still runs and still fails loudly"*라고 **거짓 단언** | +| gRPC | `GrpcPlatformStartupValidator` (267줄 + 테스트 267줄) | `GrpcPlatformAutoConfiguration` 전체에 등장 0. `trust-all-certificates=true`+PROD가 그냥 기동 | + +**(나) 목이 재현할 수 없는 실패를 목 위에서 안전하다고 고정한다.** web leaf에만 확정 3건. + +- `RequestLoggingFilterTest.honoursClientRequestIdAndCorrelationIdHeaders`가 + `isEqualTo("client-req-1")` — **테스트 이름이 `honours…`**, 클라이언트 값을 그대로 쓰는 것을 + 정답으로 선언한다. 같은 leaf `WebMvcRequestIdFilterTest:14-27`은 `isNotEqualTo(...)`로 정반대를 + 못 박는다. **두 필터를 같은 체인에 올리는 테스트는 저장소에 0건**이라 서로를 보지 못한다. +- `RateLimitKeyResolverTest.remoteAddrModeIgnoresForwardedClientIpWhenPresent` — 목이 + `ForwardedHeaderFilter` 래핑을 재현 못 하는데 "XFF 무시"를 안전으로 고정. +- fileserver `VerificationCoordinatorTest:169-180` — `new MediaTypeVerifier(reader, true)`로 + `requireVerdict=true` 고정. **배포값은 `config/fileserver.yml:96`의 `false`.** + `true`면 판독 실패 → QUARANTINE(안전), `false`면 → ACCEPT(fail-open). + **테스트는 안전한 분기를 증명하고 배포는 위험한 분기를 돈다.** + +### 빈칸의 정확한 모양 — 방향이 하나뿐이다 + +`persistence-jpa`에서 가장 선명하게 드러난다. + +| 검사 방향 | 테스트 수 | +|---|---| +| "이건 등록되면 **안 된다**" (리플렉션) | **3개, 잘 돈다** — `CandidateAdapterCompositionTest`, `AuditingCandidateStatusTest`, `PersistenceEntityScanCoverageTest` | +| "이건 등록**돼야** 한다" | **0개** | + +**C1도 H2도 정확히 그 빈칸이다.** 기법은 이미 있고 컨텍스트도 필요 없다 — 같은 리플렉션 방식으로 +반대 방향을 쓰면 3줄이다. 이 저장소가 "꺼짐"을 검증하는 데 쏟은 정밀함이 "켜짐"에는 한 번도 +적용되지 않았다. + +그리고 우회가 **주석으로 적혀 있다.** 우연이 아니라 의도다: + +- `LegacyOutboxIntegrationSupport.java:128` — `// OutboxStoreAdapter: @Repository — registered + manually (no component scan).` 하네스가 결함을 알고 손으로 우회한다. +- `PostgreSqlLegacyOutboxRowLifecycleIntegrationTest.java:670-677` — `// OutboxReaper.reap() uses + @Transactional which only works as a Spring proxy.` 후 `new OutboxReaper(...)`로 수동 생성. + 리퍼의 **유일한** DB 테스트라 `@Component`·`@Scheduled`·조건 부재가 전부 시야 밖이다. +- `PersistenceVendorSelectionTest:91-93` — 테스트가 스스로 + `@EnableConfigurationProperties(PersistenceVendorSettings.class)`를 정의해 넣는다. + **프로덕션에 없는 바로 그 등록**이다. 그래서 "알 수 없는 vendor면 기동 실패"가 테스트에선 참, + 프로덕션에선 거짓이다. +- `PostgreSqlVendorFailureTranslatorRegistrationTest` — 이름이 *Registration*Test이고 javadoc이 + "Nothing registered a VendorFailureTranslator"를 회귀 대상으로 적어놨는데, 본문 `:40`은 + `new PostgreSqlPersistenceConfig()`다. **등록 여부가 이 테스트가 볼 수 없는 유일한 것이다.** + +### 저장소는 이 사실을 알고 있다 + +`app-bootstrap/src/systemTest/.../DependencyErrorStartupContractTest.java:21-23`: + +> *"This repository has found **five classes that were green in their own tests and present in no +> running application**; a validator is a poor candidate to become the sixth."* + +같은 Javadoc이 메커니즘도 정확히 짚는다 — `MockEnvironment`로 정적 메서드를 부르는 테스트는 +*"규칙이 올바른 문장을 계산한다"*는 증명하지만 *"무언가 그 규칙을 실행한다"*는 증명하지 못하고, +**"그 차이가 배선된 검증기와 그냥 존재하는 검증기의 차이"**다. + +**진단은 완벽하고, 처방의 적용 범위가 16개 파일에서 멈춰 있다.** 이번 리뷰가 찾은 것들은 +새로운 유형이 아니라 같은 유형의 일곱 번째 인스턴스다. + +### 빌드 계층도 같은 모양이다 + +빌드 플러그인 테스트 45개 중 **19개(42%)가 TestKit 실제 Gradle 빌드**다. 드물게 높다. +그런데 커버리지가 부품에서 끝난다. + +- 등록 플러그인 id **37개 중 21개**만 테스트가 적용 — 미적용 16개에 **`ca.architecture`와 + `ca.architecture-registry`가 둘 다** 포함 +- 등록 태스크 이름 **43개 중 23개**는 어떤 테스트도 호출하지 않음 +- **`VerifyCleanArchitectureDependenciesTask`에 테스트가 0개** — HARD-STOP #5의 유일한 Gradle 게이트 + +구조적 이유가 있다. **TestKit은 자기가 만든 임시 프로젝트의 배선만 본다.** 실제 `src/build.gradle`과 +`.github/workflows/*`의 배선은 원리적으로 시험 대상 밖이다. + +--- + +## 4-B. 2차 전수 독파가 바꾼 것 + +1차에서 6개 영역이 "이 파일들은 판정을 못 바꾼다"는 이유로 일부를 건너뛰었다. 그 판단을 검증하려고 +전부 읽혔다. **다섯 영역 중 넷에서 판정이 바뀌었다.** 건너뛴 파일에 반증이 들어 있었다. + +| 영역 | 1차 판단 | 전수 독파 후 | +|---|---|---| +| 08 httpclient/objectstorage | "미독 52개에 판정을 뒤집을 내용 없음" | **가정 철회.** M2→H7 상향 + H8·H9·L9·L10 신규 | +| 12 bootstrap/sample | C1 "고신뢰 정적 추정" | **전수 확정** + 샘플 위반 실측 발견 | +| 13 build/CI | K3 "compose lane 15개 전부 blocking" | **기각** — blocking을 읽는 코드가 CI에서 안 돔 | +| 10 messaging | K6 "증거가 등급을 결정한다" | **기각** — `Tier`가 하드코딩 리터럴 | +| 02 inbound-web | H3에 반론 있음 | **반론 철회**, C2 대폭 강화 | + +### 가장 깊은 테스트가 배포와 다른 것을 검증한다 + +`adapter:inbound:web`의 3레인 패리티 게이트는 이 저장소에서 가장 깊은 테스트다 — Tomcat·Jetty· +WebFlux 실서버 3개에서 모든 4xx/5xx에 `application/problem+json`과 `code`를 단언한다. + +그런데 그걸 띄우는 `ContractFixtureApplication`은 `@Import`가 픽스처 컨트롤러 3개 + +`WebMvcProblemExceptionHandler` **넷뿐**이고, `testFixtures` 전체에서 `EnvelopeBodyAdvice`· +`GlobalExceptionHandler` 참조가 **0건**이다. 배포에서는 둘 다 `@RestControllerAdvice`로 활성이다. +**실서버 3개로 검증하는 응답 계약을 이 애플리케이션은 한 번도 내보내지 않는다.** + +같은 모양이 파이프라인 순서 IT 3개에도 있다. 검증 대상은 `PipelineOrderFixtureApplication`이 +**직접 쓴 익명 필터**가 쓰인 순서대로 도는 것이고, 프로덕션 필터는 한 개도 로드되지 않는다. +그래서 H1(request-id 신뢰 경계 충돌)이 이 IT를 그대로 통과한다. + +`nginxProxyTest`는 한 걸음 더 나간다. 진짜 Nginx 컨테이너를 띄우고 `attackerCannotForgeTheClientAddress`로 +정확히 그 위협을 쏘는데, 통과하는 이유는 애플리케이션이 안전해서가 아니라 `proxy_headers.conf`가 +`proxy_set_header X-Forwarded-For $remote_addr`로 **치환**하기 때문이다. 애플리케이션 쪽은 +`ProxyFixtureController:52-55`가 배포가 쓰는 `ForwardedHeaderFilter`와 **다른 클래스**를 손으로 +만들어 쓰고, `application-web-contract.yaml`에는 `forward-headers-strategy`가 아예 없다. +**실서버 프록시 레인의 존재가 오히려 문제를 가린다.** + +### 검증됐다고 읽히지만 검증되지 않은 것 + +| 대상 | 규모 | 실제 | +|---|---|---| +| objectstorage S3 제공자 | 3,581줄 | **실 스토어 검증 0.** AWS qualification 2개는 `System.getenv()` 단언만. MinIO "contract" 4개 중 2개는 컨테이너 없이 체크인 JSON만 읽음. 컨테이너를 띄우는 2개는 raw `S3AsyncClient`를 직접 드라이브해 이 leaf의 제공자를 통과하지 않음. 스킵 없는 제공자 계약을 상속하는 클래스는 `LocalDevObjectStorageProviderTest` 하나 | +| httpclient SSRF DNS 핀 | `ValidatedAddressResolverGroup`·`ApacheDnsResolverFactory` | 테스트 **166개 중 0개 파일**에 등장. 하네스가 전송 제공자를 무인자 생성자로 만들어 resolverFactory가 비고 `systemDefault`로 떨어짐. **지금 하네스 구조로는 그 테스트를 쓸 수조차 없다** | +| httpclient 시도 메트릭 | 5종 | `DeclaredMetricsAreEmittedTest:70`이 `main/java` 전체를 이어붙여 **소스 텍스트 출현 횟수**를 셈. 문자열로만 있어도 통과 | +| httpclient 트레이스 전파 | `traceparent` | 테스트 166개 중 **0개 파일**에 등장 | +| httpclient 실패 증거 분류 | 재시도 안전성의 근거 | 유일한 실패주입 계약이 `isIn(NOT_SENT, SENT_NO_RESPONSE, PARTIAL_RESPONSE)`를 단언하는데 enum이 이 셋 + `RESPONSE_RECEIVED` 넷뿐 → 실패 호출에서 **자명하게 통과** | +| ArchUnit 룰 | 86개 선언 | 위반 픽스처로 **발화를 증명하는 것은 55개**. 31개는 공허 통과 여부 불명. `ArchitectureViolationFixtureTest` Javadoc 35-38이 그 위험을 직접 서술 | +| 메시징 브로커 등급 | support-matrix | `CompatibilityMatrix`의 `Tier`가 **리터럴 생성자 인자**. 증거 manifest를 지워도 `Tier.STABLE`은 남음 | + +**단, 이 저장소는 대부분 정직하다.** `minio-provider-evidence.json`은 `"status": "UNSUPPORTED"`와 +`excludedProfiles` 5종, `limitations`에 *"not AWS evidence"*·*"not production TLS or +deployment-topology evidence"*까지 스스로 적는다. 증명 안 된 프로파일은 실제로 비활성화된다. +**결함은 거짓말이 아니라 "정직한 경고와 실제 차단 사이의 간격"이다** — `providers.x.type` 한 줄이면 +그 간격을 건너뛴다. + +### 켜짐을 검증하는 층이 셋 다 비어 있다 + +| 층 | 상태 | +|---|---| +| leaf `test` | hermetic — **옳다.** 컨테이너 의존을 `check`에 넣지 않는 건 정당하다 | +| 컨테이너 레인 | `integrationCheck`가 `ci`에 없어 **안 돈다** | +| compose 레인 15개 | `expectedSwitchesOn` 고유 스위치가 **5개**뿐 — jpa(9레인)·notification(4)·messaging(3)·mongo(2)·graphql(2). **redis·fileserver·httpclient·objectstorage·websocket·grpc는 0레인.** `docker-compose.infra.yml` 520줄에 redis 서비스 자체가 없다. 게다가 `blocking: true`를 읽는 코드는 `scripts/run-compose-runtime-smoke.sh:548` 한 줄이고 `.github/`가 그 스크립트를 부르지 않는다 | + +### 샘플이 위반을 물려준다 + +`sample-portfolio`의 application 레이어 84파일에 `org.springframework.*` import가 **18건** +(`@Service` 15, `@Component` 2, `@Autowired` 1). production `application-core` 890파일은 **0건**. + +3중으로 안 잡히고 이유가 각각 다르다. ArchUnit이 샘플을 못 보고, **설령 봐도 못 잡는다** — +`APPLICATION_DOES_NOT_DEPEND_ON_ADAPTERS_OR_TRANSPORT`의 금지 목록 +(`ApplicationBoundaryArchitectureTest:59-68`)에 `org.springframework.stereotype`도 +`org.springframework.beans`도 없다. `verifyApplicationCoreDependencyPurity`는 대상이 +`:application-core`로 고정돼 있고, `verifyCleanArchitectureDependencies`는 샘플을 제외한다. + +공정하게 — 샘플은 나머지를 전부 지킨다(도메인 순수성, `@Entity` 배치, `*UseCase.java` 23개 전부 +`@UseCaseCapability` 보유, fixture 누수 0). 위반이 한 부류뿐이라 오히려 두드러진다. +뿌리는 `SamplePortfolioApplication:27-28`이 `basePackages="dev.caskeleton"`을 제외 없이 스캔해서, +유스케이스가 빈이 되는 유일한 방법이 `@Service`라는 것이다. + +## 5. 현재 작업에서 먼저 처리할 것 + +### 5.1 워킹트리 보존 + +source-set 이동과 ownership 이전이 진행 중이므로 tracked 삭제/untracked 대체물을 함께 확인한다. +`git commit -a` 방식으로 완료 상태를 판단하지 않는다. + +### 5.2 CI / Release blocker + +- release workflow의 architecture test 경로가 현재 source set과 맞는지 확인한다. +- Docker dependency-resolution stage가 모든 included build를 복사하는지 확인한다. +- 이동한 integration/system lane에 실제 CI/workflow caller가 있는지 확인한다. +- `build-tools`가 남아 있는 동안 남은 verifier test를 CI에서 실행한다. + +### 5.3 Composition ownership + +Redis/Outbox/Idempotency/Lock/Tracing 설정을 일괄 bootstrap `.imports`에 넣지 않는다. + + provider implementation wiring → owner leaf/starter + cross-provider selection/validation → 얇은 bootstrap/support + application-wide common infrastructure → bootstrap + +`Clock`은 application-wide 공통 인프라다. + +## 6. 최종 수정 순서 + +**Phase 0 — migration 안정화** +tracked/untracked 대조, root Gradle model/focused test 실행 상태 확보, 진행 중 ownership 이동 완결. + +**Phase 1 — CI / Release graph 복구** +오래된 test invocation, included-build Docker context, orphan integration/system lane을 수정하고 실제 graph view를 만든다. + +**Phase 2 — Capability Composition ownership** +leaf-owned AutoConfiguration을 확정하고 bootstrap의 provider implementation import를 제거한 뒤 dependency scope를 판단한다. + +**Phase 3 — Test Architecture** +`test/integrationTest/systemTest/architectureTest/performanceTest`로 정규화하고 실제 ON/OFF composition contract를 추가한다. + +**Phase 4 — Core boundary** +application-core의 HTTP/transport semantics를 inbound로 내리고 product-sized application capability를 optional leaf로 분리한다. + +**Phase 5 — Semantic defects** +각 Critical/High finding을 failing test부터 수정한다. + +**Phase 6 — Build simplification** +build-logic을 convention 중심으로 축소하고 qualification/evidence/readiness 중복을 test/CI로 이동한다. + +**Phase 7 — Runtime / Compose / Docs** +env launcher, developer infra/system-test Compose, README/config/support matrix를 실제 구조와 동기화하고 +capability 상태를 `IMPLEMENTED / WIRED / QUALIFIED`로 구분한다. + + +## 7. 바꾸지 말아야 할 것 + +리뷰 13개가 공통으로 지목한, **지금 이상해 보이지만 현 상황에서 옳은** 선택들. + +**K1. 꺼짐을 조건이 아니라 구조로 만든 판단.** +이 원칙은 **Build Composition에서 선택된 capability 안에서** 적용한다. 스캔 제외 + 자동설정 진입점 하나. 조건 애노테이션은 새 빈마다 사람이 기억해야 하고, 잊으면 +조용히 새어나온다. 이 설계는 잊을 수가 없다. notification이 5겹으로, mongo가 3겹으로 실증한다. +**이번 결함은 이 설계의 반증이 아니라 이 설계를 완성하지 않은 결과다.** + +**K2. `domain-core`가 104줄인 것.** +누수가 아니다. `application-core/build.gradle`에 `project(':domain-core')` 자체가 없고 도메인 타입 +참조가 0건이다. 템플릿의 도메인은 fork한 사람이 채우는 자리이므로 비어 있는 것이 정확하다. + +**K3. `application-core`의 테스트 전략.** +20,000줄 규모에 Mockito **0건**, Spring 컨텍스트 **0건**, 893 테스트 / 2,312 단정, +62%가 단정 2개 이상, 55% 파일이 예외 경로를 검증. getter/setter 테스트가 아니다. + +**K4. `shared-contract`의 "Java stdlib only"가 선언이 아니라 사실인 것.** +이게 부팅 이전 토글 판정을 가능하게 한다. + +**K5. `messaging:*` 25분할과 브로커별 leaf 분리.** +클래스패스 격리가 실제로 작동한다(avro는 production 런타임에 없다). 줄여야 할 것은 leaf가 아니라 +starter의 단일성이다. + +**K6. gRPC 플랫폼을 `optional-platforms` 별도 빌드로 뺀 것.** +env 토글보다 강한 격리다 — 빌드에서조차 존재하지 않는다. 그리고 CI에서 실제로 돈다 +(`ci-quality-gates.yml:88-95`, release-gate 필수). + +**K7. `grpcPerformanceTest`를 수동 전용으로 둔 것.** +README의 논증이 타당하다 — *"공유 CI runner의 측정값은 흔들리고, 흔들리는 게이트는 결국 꺼진다."* + +**K8. Redis lease를 `EFFICIENCY_ONLY`로 명시하고 펜싱 토큰을 주지 않는 것.** +분산 리스를 상호배제로 오용하게 만들지 않겠다는 정직한 설계다. 코드가 실제로 그렇다. + +**K9. `StrictTestLanePlugin`의 4중 방어 — 단, 선택되는 레인에 한해서.** +소스셋 비면 예외 / 0개 실행하면 실패 / skip은 결과가 아님 / required 미실행이면 실패. +**선택되는 레인에서는 조용한 실패가 불가능하다.** TestKit 실빌드 25개가 이를 검증한다. +한계는 "아무도 안 부르는 레인"이고, 그건 4단계가 덮는다. + +**K10. 부품 테스트의 품질 자체.** +`SerializedOutboundWriterTest:47-85`가 8스레드 64 offer에서 sink 동시 진입 최대치가 정확히 1임을 +`AtomicInteger`로 관측한다. `HandshakeAdmissionPipelineTest:101-163`은 404/403/503 각 케이스에서 +`tickets.redemptions()==0`을 단언해 "티켓 조회 전에 거부"를 부수효과로 증명한다. +탐지기 자신을 위반 샘플로 검증하는 관행이 6곳 있다. +**문제는 이 방식이 부실해서가 아니라, 이 방식이 이음새에는 적용될 수 없는데 이음새에도 쓰였다는 것이다.** + +**K11. 문서가 "무엇"이 아니라 "이렇게 안 하면 무엇이 깨졌는가"를 적는 관행.** +`capabilities.yml`의 네임스페이스 주석이 과거 ACL 사고를 기록하고, 마이그레이션 SQL이 "왜"를 적고, +`webfluxContractTest`가 왜 아무것도 상속하지 않는지 적는다. 이 관행이 이번 리뷰를 가능하게 했다. + +--- + +### 적용에서 제외한 과거 판단 + +전수 리뷰 중 철회된 주장과 반증 과정은 각 영역의 §9 근거로 남긴다. 이 overview에서는 실행 지침이 +아닌 메타 리뷰 이력을 반복하지 않는다. 현재 구현 기준은 §1~§7의 최종 원칙과 영역별 §0을 따른다. + +## 8. 채택 판단 + +**부품을 사고 이음새를 직접 짜는 프로젝트로 보면 값이 있다.** + +각 영역이 "재작성할 코드"인지 "배선할 코드"인지 갈렸고, 대부분 후자다. + +| 영역 | 도달 불가 규모 | 판정 | +|---|---|---| +| WebSocket | main 12,784줄 중 ~12,000 | **배선** — 부품 완성, 테스트 482개가 진짜. 조합 클래스만 없음 | +| GraphQL | 407개 중 267개(14,975줄) | **배선** — `@Test` 739개 중 300개가 배포 안 되는 코드를 지키지만 품질은 진짜. 재작성 규모는 `*HandlerFactory` 3개(281줄)뿐 | +| notification | 8,001줄 | **갈린다** — R1 3,832줄은 입력원·클라이언트·admission·시크릿 공급자가 동시에 비어 **삭제**, R2 프로바이더 4,169줄은 **배선**(SES SigV4 수제, WebPush RFC 8291+8292 전문 구현) | +| cache-redis | 32,082줄 | **배선 + 일부 재작성** — SDK 위임 37개 중 36개가 가드를 생성자에서 요구(설계 참), 능력 어댑터 6개는 가드를 우회(설계 거짓) | +| application-core | 185타입 / 6,145줄 (17%) | **참조 그래프 전수 결과** — 테스트가 직접·간접 모두 도달하지 못함. 그 안에 실행 클래스 16개 2,045줄이 있고, **이 영역에서 발견된 버그 3건이 전부 그 안에 있다** | +| gRPC 플랫폼 | testkit 밖 16,413줄 | **성격이 다름** — gRPC 런타임이 아니라 정책·계약 모델. 그 용도로는 (c)형 단위 테스트가 옳고 품질도 최고 수준 | + +**역설 하나를 기억할 것**: notification R1은 테스트 489줄이 붙어 핵심처럼 보이는데 죽었고, +R2 프로바이더는 배선이 없어 죽은 것처럼 보이는데 살아 있다. **"테스트가 있다"가 "배포된다"의 +근거가 되지 않는다** — 이 저장소를 읽을 때 가장 중요한 주의사항이다. + +--- + +## 9. 커버리지와 한계 + +- **읽기 범위 — 13개 영역 전부 전수 독파 완료.** 영역별 실측은 각 리뷰 §1에 있다. + + | 영역 | 커버리지 | 제외 | + |---|---|---| + | 01 core | **1,116 / 1,116** | — | + | 02 inbound-web | **Java 623 / 623** | `gradle.lockfile`, 35KB `README.md` | + | 03 inbound-realtime | **268 / 270** | `gradle.lockfile` 2 | + | 04 inbound-graphql | **526 / 526** | — | + | 05 persistence-jpa | **626 / 626** | — | + | 06 persistence-mongo | **494 / 494** | `gradle.lockfile` | + | 07 cache-redis | **383 / 383** | — | + | 08 httpclient/objectstorage | **589 / 589** | `gradle.lockfile` 2, `.jqwik-database` | + | 09 notification/fileserver | **386 / 386** | 대형 4파일의 게터·`equals`·`toString` 본문 | + | 10 messaging | **main 412 + test 145** | — | + | 11 grpc-platform | **368 / 368** | `gradle.lockfile` 18 | + | 12 bootstrap/sample | **678 / 678** | ArchUnit `ArchCondition` 헬퍼 약 800줄 | + | 13 build/CI | **infra 45 · compose 6 · config 12 · build-logic/tools 전량 · 워크플로 18** | 스냅샷 밖 spec 2쌍 | + + **1차에서 6개 영역이 일부를 건너뛰었고, 전수로 채우자 그중 다섯에서 판정이 바뀌었다** (§4-B). + 건너뛴 파일에 반증이 있었다. 이 문서의 수치는 전수 독파 후의 것이다. + + 방법도 한 번 교정됐다 — 01 영역의 "테스트가 도달하지 못하는 코드" 판정은 2차까지 **이름 grep**이었고, + 3차에서 main 887타입에 대한 **참조 그래프 전수**로 바꿨다. 그 결과가 §8의 코어 수치다. + +- **빌드 미실행**: Gradle wrapper jar를 스냅샷에서 제외했다. Critical·High는 정적 경로 추적이며 + 각 리뷰 §9에 반증/확인 명령을 적었다. 주요 판정은 코디네이터가 원본 소스로 재확인했다. + +- **스냅샷 경계**: 2026-09-18T11:50Z 워킹트리. 리뷰 작성 중에도 원격이 계속 움직였다 + (HEAD는 동일, 스냅샷 이후 24개 파일 수정 확인). 이 리뷰는 그 시점의 트리를 판정한다. + +- **철회·정정된 주장** — 리뷰 과정에서 반증된 것들이다. 각 리뷰 §9에 원래 주장과 함께 남겼다. + 이 목록 자체가 이 리뷰의 신뢰 근거다. 검증되지 않은 주장은 이렇게 걸러졌다. + + | 주장 | 결과 | + |---|---| + | 02 "보조 소스셋에 테스트 의존이 없어 `ci`가 깨진다" (Critical) | **철회** — `AuxiliarySourceSetSpec:10-11`의 기본값이 `["implementation","runtimeOnly"]`라 `testImplementation`을 상속한다 | + | 08 "미독 52개에 판정을 뒤집을 내용 없음" (가정) | **철회** — 전수 독파로 H7 상향 + 신규 4건 | + | 09 "`.imports`를 읽는 테스트가 저장소 전체에 0개" | **정정** — 3개 실재(graphql·persistence-jpa·grpc-starter). 11개 중 3개라 결론은 오히려 강해졌다 | + | 11 "starter 의존을 아무것도 막지 않는다" | **정정** — 실제로 도는 게이트 1개 존재 | + | 11 "fault lane이 진짜 실패를 주입한다" (Keep) | **철회** — 소켓은 열지만 결론에 기여하지 않는다 | + | 12 "compose lane 15개가 blocking" (Keep) | **기각** — `.github/`가 그 스크립트를 부르지 않는다 | + | 10 "인증 증거가 브로커 등급을 결정한다" (Keep) | **기각** — `Tier`가 리터럴 생성자 인자 | + | 10 "메시징 브리지가 미완(MSG-015)" | **기각** — 구현·커밋 완료. 루트 `CLAUDE.md:68-72`가 드리프트 | + | 01 "캐시 엔진에 테스트가 없다" | **철회** — 15개가 4스레드 단일플라이트·무효화 레이스까지 검증. 문제는 검증이 아니라 배선 | + | 02 "로컬/개발엔 인그레스가 없어 H3 노출이 낮다" (반론) | **철회** — 프로파일이 `none`으로 덮어써서 노출이 prod로 좁혀지고, 그래서 더 나쁘다 | + | 코디네이터 "optional-platforms가 CI에서 안 돈다" (브리프 가설) | **기각** — `ci-quality-gates.yml:88-95`가 돌리고 release-gate가 필수로 요구 | + | 코디네이터 "메시징 빈 해시가 35건" | **정정** — 실측 4건 | + | 코디네이터 "`.imports` 파일 12개" | **정정** — `AutoConfiguration.imports`는 11개(12번째는 `ManagementContextConfiguration.imports`) | diff --git a/docs/reviews/2026-09-18-techlead-review/01-core.md b/docs/reviews/2026-09-18-techlead-review/01-core.md new file mode 100644 index 00000000..a0546570 --- /dev/null +++ b/docs/reviews/2026-09-18-techlead-review/01-core.md @@ -0,0 +1,1084 @@ +# [영역] 코어 (domain-core / shared-contract / application-core) 리뷰 + +- 스냅샷: 2026-09-18T11:50Z / HEAD 60b6a319 + 커밋 안 된 변경 224파일 +- 담당 leaf: `domain-core`, `shared-contract`, `application-core` (`modules.json` id 기준) +- 레지스트리 대조 (`src/config/architecture/modules.json`): + - `domain-core.allowed_dependencies = []` + - `shared-contract.allowed_dependencies = []` + - `application-core.allowed_dependencies = ["domain-core", "shared-contract"]` + +> **3차 개정판.** 세 leaf의 Java 1,116개를 **한 개도 빠짐없이 전문 독파**했다(미독 0). +> 초판 대비 판정 6건이 바뀌었고 새 발견 6건이 추가됐다. 바뀐 항목은 각 절에 `[개정]`으로 표시했다. +> 3차에서 바뀐 것: H7을 이름 grep이 아니라 **참조 그래프 전수**로 확정, H6 하향(High→Medium), +> H8 근거 정밀화, M14·L6 신규, K1에 조합 검증 수치 추가. + +--- + +## 0. 최종 적용 기준 + +Core findings는 대부분 채택한다. 다만 core를 작게 만들기 위해 policy를 adapter로 밀어내지 않는다. +HTTP status/Range/Content-Disposition/raw callback 같은 transport semantics는 inbound로 이동한다. +product-sized application 기능은 optional application leaf로 분리할 수 있지만 port/policy/state machine은 +application 계층에 남긴다. 보상 트랜잭션은 real PostgreSQL integration test로 먼저 고정한다. +도달 불가 코드는 `REMOVE / WIRE / KEEP AS LIBRARY`로 분류한다. + +## 0-A. 2026-09-21 중간 재검증 + +**상태: 핵심 boundary 분리는 실제 코드로 많이 진행됐다.** + +- `application-fileserver`, `application-notification`, `application-objectstorage`가 별도 application leaf로 존재한다. +- `application-core/src/main/java`를 다시 스캔했을 때 Spring HTTP/web/servlet, `HttpStatus`, + `ContentDisposition` 등 리뷰에서 문제 삼았던 transport 의존 후보가 0건이었다. +- `:sample-portfolio:check`도 재검증 PASS했다. + +따라서 Core 리뷰의 “transport semantics를 application-core 밖으로 내린다”와 “product-sized +application capability를 optional leaf로 분리한다”는 큰 방향은 구현된 것으로 본다. + +다만 **파일 이동 자체를 완료 조건으로 삼으면 안 된다.** 각 새 application leaf의 public port/policy가 +provider-specific 타입을 다시 받아들이지 않는지와 Build Composition에서 선택 가능한지는 Phase 2 +완료 시점에 다시 검사한다. + +## 1. 커버리지 + +**세 leaf의 Java 1,116개를 전부 전문(全文) 독파했다. 미독 파일 0개.** + +| leaf | 소스셋 | 파일 | 줄 | 독파 | +|---|---|---|---|---| +| `domain-core` | main | 7 (타입 5 + `package-info` 2) | 104 | 7/7 | +| `domain-core` | test | 0 (`.gitkeep` 2) | 0 | — | +| `shared-contract` | main | 54 | 2,805 | 54/54 | +| `shared-contract` | test | 24 | 2,803 | 24/24 | +| `shared-contract` | `edgeRateLimitContractTest` | 1 | 75 | 1/1 | +| `application-core` | main | 890 | 35,894 | **890/890** | +| `application-core` | test | 139 | 19,880 | **139/139** | +| `application-core` | `testFixtures` | 1 | 100 | 1/1 | +| **합계** | | **1,116** | **61,661** | **1,116/1,116** | + +빌드 파일·CLAUDE.md·README·lockfile 19개 별도 확인. 총 1,135개. + +3차에서 채운 미독분: `notification/` R1 100개 전부, `notification/platform/{api,dispatch,port}` 140개 전부, +`notification/platform/{admin,callback,contact,email,inbox,observation,policy,provider,push,security,sms,template,webpush}` 175개 전부, +`application-core/src/test` 139개 전부. + +### 테스트 코퍼스 실측 (`application-core`) + +| 지표 | 값 | +|---|---| +| 테스트 파일 | 139 (그중 `@Test`를 가진 파일 113, 나머지 26은 fake/fixture/testkit) | +| 테스트 메서드 (`@Test`+`@ParameterizedTest`) | **663** | +| 단정 호출 (`assertThat*`) | **1,801** (메서드당 2.72) | +| `@DisplayName` (문장형 이름) | 96 | +| 손으로 쓴 fake 클래스 선언 | 86 | +| Spring / Mockito / Testcontainers / DataSource | **0** | + +Spring 문자열이 나오는 파일은 2개뿐이고, 둘 다 **금지 타입 목록의 문자열 리터럴**이다 — +`objectstorage/ObjectStorageArchitectureContractTest.java:32` `"org.springframework."`, +`fileserver/api/content/ContentStoreApiArchitectureTest.java:19-20` `"org.springframework.core.io.Resource"`. +즉 Spring을 쓰는 게 아니라 **Spring이 시그니처에 없음을 단정하는 코드**다. + +### 부품 검증 vs 조합 검증 — 663개 전수 분류 + +| 분류 | 메서드 | 비중 | 무엇을 하는가 | +|---|---|---|---| +| **A. 부품(행위) 검증** | **603** | 90.9% | 프로덕션 타입 1개(또는 소수 클러스터)를 손으로 쓴 fake와 함께 생성해 행위를 단정 | +| **B. 구조(경계) 검증** | **50** | 7.5% | 리플렉션·패키지 스캔으로 시그니처/sealed permits/애너테이션 값을 단정. 행위가 아니라 **모양** | +| **C. 실스레드 동시성** | **10** | 1.5% | `ExecutorService`/`CountDownLatch`로 진짜 경합을 만든다 (`CacheAsideExecutorTest`, `CacheResilienceConcurrencyTest`, `DistributedLockPortContractTest`) | +| **D. 조합(컨테이너/조립) 검증** | **0** | 0% | 없음 | + +B가 몰려 있는 곳: `ObjectStoragePortContractTest` 8/10, `UseCaseCapabilityTest` 5/5, +`ObjectStorageArchitectureContractTest` 4/4, `NotificationPortBoundaryTest` 3/3, +`PublicApiBoundaryTest` 2/4, `PublicApiIsTypedTest` 2/3, `IdempotencyV2ContractSingularityTest` 2/2. + +**D=0은 결함이 아니라 정의상 옳다.** `application-core`에는 조립할 것이 없다 — +`@ConditionalOn*` 0건, 빈 등록 0건, `build.gradle`의 프로덕션 의존은 `shared-contract` 하나(§3). +조립은 `app-bootstrap`의 일이고, 저장소 전체 테스트 1,899개 중 배포 컴포지션 루트를 기동하는 것은 16개(0.84%)다. +**코어가 그 16개에 하나도 없는 것이 정확히 옳다.** 자세한 함의는 §6 K1. + +### 빌드 + +**한 번도 실행하지 않았다** (wrapper jar 부재). 초판에서 "미검증"이던 2건(H1·H2)은 2차에서 +스냅샷 소스만으로 확정했다. 남은 미검증은 §9. + +--- + +## 2. 이 영역은 무엇을 하는가 + +### `domain-core` — 6파일 104줄. 도메인은 없고 마커만 있다. + +1. **식별자 계약 2개** — `ResourceId`(F-bounded 마커, `value()` 하나), `IdFactory`(`newId()` 하나) +2. **스테레오타입 애너테이션 3개** — `@ValueObject` / `@AggregateRoot` / `@DomainEvent`. 전부 RUNTIME 순수 마커 + +엔티티·값 객체·도메인 서비스·불변식 0개. `build.gradle:6-8`의 `dependencies { }`는 비어 있다. + +### `shared-contract` — 54파일 2,805줄. 운영 계약 어휘집. + +응답 봉투 / 에러 코드 계약(`OperationalError` 51값) / 엣지 레이트리밋(알고리즘 3종 + Lua 정수범위 오버플로 검증) / +활성화 스위치(`MasterSwitch` 5개) / 도메인 컨텍스트 전파 / 트레이싱·메트릭 계약 / 운영 레코드 CAS 저장소. + +### `application-core` — 890파일 35,894줄. **애플리케이션 레이어가 아니라 벤더링된 운영 플랫폼 3개다.** + +| 종류 | 개수 | +|---|---| +| `public interface` | 233 (그중 `*Port` **98개**) | +| `public record` | 376 | +| `public enum` | 96 | +| `public class` (실행 클래스) | **178개 / 13,237줄** | +| `CommandUseCase`/`QueryUseCase` 구현 | **12개** (전부 notification 11 + outbox 1) | + +``` +17,068 notification/** (R1 4,594 + platform 12,474) ← 47.5% + 7,480 fileserver/** ← 20.8% + 2,407 objectstorage/** ← 6.7% + 1,825 cache/ 2,097 idempotency(+v2) 1,494 outbox(+v2) + 643 operation 623 lease 523 realtime 505 transaction + 38 usecase + command + query + capability ← 0.1% +``` + +--- + +## 3. 런타임 토글 판정 — 꺼지면 정말 꺼지는가 + +**판정: 이 세 leaf는 토글 대상이 아니고, 그게 정확히 옳다. 껐을 때 남는 비용은 0이다.** + +| 확인 항목 | 결과 | 근거 | +|---|---|---| +| env 키 참조 | **0건** | main 전체에 `System.getenv`·`@Value`·프로퍼티 바인딩 없음 | +| `@ConditionalOn*` | **0건** | Spring 애너테이션이 클래스패스에 없음 | +| 빈 등록 | **0건** | `application-core/CLAUDE.md:163-164` 선언과 코드가 일치 | +| 스레드 생성 | **1건, 프로덕션 미배선** | `lease/LeaseWatchdog.java:47,219` — 프로덕션 생성자 호출처 0 (§H5) | +| 커넥션 풀 | 0건 | 전부 port 뒤 | +| 클래스패스 | 사실상 0 | `application-core/build.gradle:10` `implementation project(':shared-contract')` 하나. 외부 라이브러리는 `testImplementation libs.jqwik` 하나 | + +**"꺼진 기술"의 흔적 3건 — 2건 무죄, 1건 Medium:** + +1. **`shared-contract/activation/MasterSwitch.java:19-30` — Keep.** 5개 어댑터의 프로퍼티/env 이름을 + 한 곳에 모은다. `shared-contract`는 "skeleton-wide **operational** contracts"이고(CLAUDE.md:17-30) + "어떤 어댑터를 켜고 끄는가"는 정확히 운영 계약이다. 이름이 흩어지면 rename이 조용한 비활성화가 된다. +2. **`cache/DisabledCache{Observation,RefreshCoordination}Port` — 무죄.** null object. 코어는 무엇이 + 꺼졌는지 모르고 컴포지션 루트가 고른다. `CacheRefresh{Claim,Release}Outcome.Disabled` sealed 멤버도 정당하다. +3. **`cache/CacheRefreshCoordinationPort.java:15-17`의 `default boolean enabled()` — Medium (§M1).** + `CacheAsideExecutor.java:263`이 이 값으로 분기한다 = 코어가 기술의 on/off를 직접 묻는다. + +**결론:** `APP_*`를 전부 false로 두고 부팅해도 이 3개 leaf는 존재하지 않는 것과 같다. +JAR에 클래스는 들어가지만 인스턴스·스레드·커넥션·필수 env가 없다. 설계 목표 기준선 통과. + +--- + +## 4. 구조 판정 + +| 축 | 판정 | 근거 | +|---|---|---| +| 의존 방향 (modules.json 대조) | **OK (간선 1개 미사용)** | `application-core/build.gradle:9-14`에 `project(':domain-core')` 없음, `dev.caskeleton.domain` 참조 0건. 허용≠필수이므로 위반은 아니다 (§H3) | +| 경계 누수 | **위반 2건 (Critical)** | HTTP 원시 요청 DTO(C2), HTTP 상태·헤더 생산(C1). **JPA/Spring 타입 누수는 0건** | +| 비즈니스 규칙 위치 | **OK** | mapper/filter/config로 샌 규칙 없음. 반대 방향(전송 규칙이 코어로)이 문제 | +| 테스트 전략 적합성 | **최상급, 단 구멍이 정확히 한 군데** | Mockito 0 / Spring 0 / **663 테스트 / 1,801 단정**, 그중 **부품 검증 603 · 구조 검증 50 · 실스레드 10 · 조합 0**. 그러나 main 타입 185개(6,145줄, 17%)가 테스트에서 **직접·간접 모두 도달 불가**이고, 그 안에 실행 클래스 16개 2,045줄이 있다 (§H7) | + +`shared-contract` "Java stdlib only"(CLAUDE.md:33) 검증: `build.gradle:8-9` 빈 `dependencies { }`, +main 54파일 import 전수 확인 결과 `java.*` 외 **0건**. **선언대로다.** + +--- + +## 5. 발견 + +### Critical + +#### C1. `application-core`가 HTTP 프로토콜을 직접 구현한다 — 모듈 자기 규칙 위반 + +- **현상**: HTTP 상태 코드, `Range` 헤더 파싱, `Content-Disposition`/`Cache-Control` 생성, + ETag 조건부 평가, TUS 업로드 프로토콜이 전부 `application-core` 안에 있다. +- **영향 범위 (신규 수치화)** — "2개짜리 국소 결함"이 아니라 파일서버 전송 계층 **전체**다: + + **Tier 1 — HTTP가 타입의 public API 시그니처에 있음: 16타입 / 1,089줄** + ``` + 54 fileserver/api/transfer/ConditionalRequest.java (6개 HTTP 헤더 필드) + 13 fileserver/api/transfer/ConditionalRequestEvaluator.java + 127 fileserver/api/transfer/DefaultConditionalRequestEvaluator.java + 13 fileserver/api/transfer/HttpRangeResolver.java (String rangeHeader) + 128 fileserver/api/transfer/DefaultHttpRangeResolver.java ("bytes=" 파싱) + 106 fileserver/api/transfer/ContentDispositionFactory.java (헤더 값 생성) + 51 fileserver/api/transfer/DownloadDecision.java (int status: 200/206/304/412) + 23 fileserver/api/transfer/FileRepresentation.java (strongEtag) + 16 fileserver/api/transfer/UploadProtocol.java (TUS_1_0 / HTTPBIS_DRAFT12) + 62 fileserver/download/DownloadDescriptor.java (status + contentDisposition + cacheControl) + 27 fileserver/download/DownloadPolicy.java ("private, no-store") + 35 fileserver/download/DownloadApplicationService.java (반환 타입) + 199 fileserver/download/DefaultDownloadApplicationService.java + 26 fileserver/download/DownloadRequest.java + 98 fileserver/api/error/FileserverErrorCode.java (26개 HTTP 상태 + RFC7807 URN) + 111 notification/platform/api/CallbackRequest.java (→ C2) + ``` + **Tier 2 — ETag/Disposition 값이 스며든 전파면: 12타입 / 1,258줄** + (`FileRecord`·`FileDescriptor`·`FileRecordMutation`의 `strongEtag` 컬럼, + `DefaultFinalizeUploadService.java:358`의 `strongEtag()` 생성, `SanitizedFilename`, + `OriginalFilenamePolicy`, `ByteRange`, `RangeBudget`, `ResolvedRanges`, + `RangeNotSatisfiableException`, `MalformedRequestException`) + + **합계 28타입 / 2,347줄 = `application-core`의 6.5%.** + (주석에만 HTTP가 등장하는 파일 10여 개는 제외 — 코드는 중립이다) +- **핵심 근거**: + - `DownloadDecision.java:19,26,31,35,39` — `status < 100 || status > 599` 검증 + 200/206/304/412 리터럴 + - `HttpRangeResolver.java:12` / `DefaultHttpRangeResolver.java:19,29` — `"bytes="` 원시 헤더 파싱 + - `ContentDispositionFactory.java:62` — `disposition + "; filename=\"" + ascii + "\"; filename*=UTF-8''" + encoded` + - `DownloadDescriptor.java:24-25,35` / `DownloadPolicy.java:13,25` + - `FileserverErrorCode.java:25-52,78,96` + - 대조: `src/application-core/CLAUDE.md:39` **Forbidden — "HTTP status, transport types"** +- **왜 문제인가** (반증 가능): + 1. gRPC/GraphQL만 쓰는 fork가 `adapter:inbound:web`을 전부 지워도 코어는 여전히 Range 파서와 + TUS enum을 컴파일한다. + 2. **가드레일이 구조적으로 못 잡는다.** `ApplicationBoundaryArchitectureTest.java:54-70` + `APPLICATION_DOES_NOT_DEPEND_ON_ADAPTERS_OR_TRANSPORT`는 **패키지 의존**만 본다 + (`org.springframework.web..`, `jakarta.servlet..`). 헤더를 `String`으로, 상태를 `int`로 직접 + 구현하면 규칙은 초록색이다. +- **`[3차 신규]` 경계를 되돌릴 때 같이 고쳐야 할 테스트 목록 — 7파일 / 64 테스트 / 1,155줄.** + C1·C2 타입을 주어(subject)로 삼는 테스트를 전수로 셌다. 이 테스트들은 HTTP 개념을 **정답으로 고정**하고 + 있으므로, 전송 계층을 `adapter:inbound:*`로 내리면 함께 이동하거나 다시 써야 한다: + + | 테스트 파일 | 테스트 | 줄 | 무엇을 고정하는가 | + |---|---|---|---| + | `fileserver/api/transfer/ConditionalRequestEvaluatorTest` | 11 | 213 | 200/206/304/412, `W/` 약한 검증자 거부 | + | `fileserver/api/transfer/HttpRangeResolverTest` | 11 | 107 | `bytes=` 파싱·클램프·suffix·budget | + | `fileserver/download/DownloadApplicationServiceTest` | 11 | 218 | `DownloadDescriptor`의 status/`cacheControl`/`contentDisposition` | + | `fileserver/api/ValueObjectTest` | 12 | 103 | `ByteRange`(그중 5개가 HTTP range 개념) | + | `fileserver/api/error/FileserverExceptionTest` | 8 | 137 | 26개 코드 × `DESIGN_STATUSES` 전수, RFC 7807 URN | + | `fileserver/api/transfer/ContentDispositionFactoryTest` | 7 | 75 | `attachment; filename="…"; filename*=UTF-8''…` 정확한 문자열 | + | `notification/platform/callback/CallbackIngestionAtomicityTest` (C2) | 4 | 302 | 원시 `CallbackRequest`(method/헤더맵/바디) | + + 이 중 **45개 테스트 메서드가 HTTP 리터럴 값을 직접 단정**한다(상태 코드·`bytes=`·헤더 문자열·ETag·Cache-Control). + C1만 따지면 6파일 / 60 테스트 / 853줄이다. + **읽는 법**: 이 숫자는 "코어에 HTTP가 얼마나 깊이 박혀 있는가"의 측정값이면서 동시에 + **이전 작업의 안전망**이기도 하다 — 옮긴 뒤 이 64개가 그대로 통과하면 행위는 보존된 것이다. +- **수정 방향**: Tier 1의 `fileserver/api/transfer` + `download` 부분을 + `adapter:inbound:web`(또는 MVC/WebFlux/Nginx가 공유하는 inbound-support leaf)로 내린다. + 코어에는 `ByteRange` 목록과 전송 중립 결과(FULL/PARTIAL/NOT_MODIFIED/PRECONDITION_FAILED)만 남긴다. + `FileserverErrorCode.httpStatus()`는 `shared-contract.ApiErrorCode`가 이미 세운 스켈레톤 전체 관례이므로 + **그대로 둔다.** 이동 비용은 Tier 1 기준 약 1,089줄. +- **반론과 재반박**: + - *반론*: "MVC·WebFlux·Nginx 세 경로가 같은 답을 내야 한다"(`DownloadDecision.java:10-11`). 실제 문제다. + - *재반박*: 세 경로 모두 `adapter:inbound:*`이므로 inbound 공통 leaf 하나로 같은 보장을 얻는다. + 지금 위치는 공유 범위를 필요 이상으로 넓혀 HTTP를 쓰지 않는 소비자에게까지 비용을 물린다. + +#### C2. 원시 HTTP 요청 DTO가 inbound port 파라미터다 — HARD-STOP #3 + +- **현상**: 프로바이더 웹훅의 원시 HTTP 요청(메서드·헤더맵·바디 바이트·URL)이 `application-core`의 + record로 정의되고 inbound 유스케이스 port의 입력 타입이다. +- **근거**: + - `notification/platform/api/CallbackRequest.java:23-31`: + ```java + public record CallbackRequest( + ProviderId providerId, ProviderProfileId providerProfileId, + String externalUrl, String httpMethod, Optional contentType, + Map> headers, byte[] body, Instant receivedAt) { + ``` + - `notification/platform/port/in/IngestProviderCallbackUseCase.java:21-22,39` — + `extends CommandUseCase` + + `default CallbackIngestionResult ingest(CallbackRequest request)` + - `callback/CallbackLimits.java:24-30` — `contentType.split(";", 2)[0]`로 MIME 파라미터를 코어에서 파싱 + - 채우는 곳: `adapter/inbound/web/.../notification/platform/callback/CallbackRequestFactory.java` + - 대조: `src/application-core/CLAUDE.md:37` **Forbidden — "Controller request/response DTOs."** +- **전파 범위 (신규)**: `application-core` 안에서 `CallbackRequest`를 타입으로 참조하는 파일 **6개** — + `api/CallbackRequest`, `port/in/IngestProviderCallbackUseCase`, `port/in/IngestProviderCallbackCommand`, + `callback/ProviderCallbackAdapter`, `callback/VerifiedCallback`, `callback/IngestProviderCallbackApplicationUseCase`. +- **왜 문제인가**: `ApplicationBoundaryArchitectureTest.java:784-808` + `APPLICATION_METHODS_DO_NOT_ACCEPT_WEB_DTOS`는 파라미터 타입이 `..adapter.inbound.web..dto..`에 + **사는지**만 본다. `CallbackRequest`는 `dev.caskeleton.application...api`에 살므로 **규칙이 통과한다.** + 이 저장소에서 가장 정밀한 DTO 가드가, 가장 명백한 DTO 누수를 못 본다. +- **수정 방향**: `CallbackRequest`와 `ProviderCallbackAdapter`를 `adapter:inbound:web`으로 내리고, + 코어의 inbound port는 같은 패키지에 이미 있는 `NormalizedProviderEvent`/`VerifiedProviderEvent`만 받는다. +- **반론과 재반박**: + - *반론*: "여러 프로바이더가 정확한 옥텟에 서명한다"(`CallbackRequest.java:14-16`). 사실이다. + - *재반박*: 그 제약은 "검증하는 코드가 원시 바이트를 본다"를 요구하지 "유스케이스가 본다"를 요구하지 않는다. + `IngestProviderCallbackApplicationUseCase.java:111`은 검증을 **위임**만 한다 — + 코어가 원시 요청을 드는 유일한 이유가 위임 대상에게 넘기기 위해서다. + +> **C1·C2의 공통 근본 원인**: 두 가드레일 모두 **패키지 위치 기반**이라, DTO를 코어 **안에** 정의하면 +> 통과한다. 즉 규칙을 만족시키는 방법이 "DTO를 코어로 옮기는 것"이 되어 있다. 이 패턴은 §H6에서 +> 세 번째 사례로 다시 나타난다. + +--- + +### High + +#### H1. `[개정: 가정 → 확정]` `inNew`는 프로덕션 미사용이고, 보상 쓰기 2곳이 조인 가능한 `inWrite`를 쓴다 + +- **초판에서 "가정"이라고 했던 propagation을 이번에 확정했다.** + `adapter/outbound/persistence-jpa/.../transaction/SpringTransactionPort.java:112-117`: + ```java + this.writeTemplate = template(transactionManager, TransactionMode.WRITE, + TransactionDefinition.PROPAGATION_REQUIRED, false); + ``` + 그리고 `:142-144` `inWrite` → `executeLegacy(writeTemplate, ...)`. + **`inWrite`는 확정적으로 `PROPAGATION_REQUIRED`(조인 가능)이다.** + (`:124-129` `requiresNewTemplate`만 `PROPAGATION_REQUIRES_NEW`이고, `inRootWrite`는 `:148`에서 + `isActualTransactionActive()`로 거부 후 writeTemplate을 쓴다 — CLAUDE.md:176-177 요구와 정확히 일치. 이건 옳다.) +- **현상**: 보상 경로 2곳이 독립 트랜잭션이 아니라 참여형 트랜잭션을 연다. + - `fileserver/upload/DefaultFinalizeUploadService.java:318-331` — READY 커밋 실패 catch에서 + `transactions.inWrite(() -> recoveryQueue.enqueue(...))`. 주석(320행)은 *"Enqueued in its own boundary"*라고 주장한다. + - `fileserver/upload/DefaultUploadApplicationService.java:151-160` — 스테이징 생성 실패 보상. + - `transaction/TransactionPort.java:45` `inNew`의 프로덕션 호출처는 저장소 전체에서 **0건** + (테스트 3곳: `TransactionPortTest.java:50`, `SpringTransactionPortTest.java:150,169`). +- **왜 문제인가**: `finalizeUpload`가 ambient 트랜잭션 안에서 호출되면 — 실패한 안쪽 `inWrite`가 + 같은 물리 트랜잭션에 참여해 rollback-only로 마킹하고, 다음 줄의 보상 `inWrite`도 같은 트랜잭션에 + 조인하므로 **보상 기록이 함께 롤백된다.** 결과: 볼륨에 published 객체가 있고, DB 레코드도, + 복구 큐 항목도 없다. 주석이 약속한 "독립 경계"가 존재하지 않는다. + 반증: `finalizeUpload`를 `inWrite` 안에서 호출하고 `metadataStore.transition`이 던지게 하면 + `recovery_queue` 행이 0개로 끝난다. +- **수정 방향**: 두 곳 모두 `transactions.inNew(...)`. `application-core/CLAUDE.md:173`이 이미 + REQUIRES_NEW를 "Outbox / audit / **compensation**"용으로 규정해 놨다 — 코드만 안 쓰고 있다. +- **반론과 재반박**: *반론* "파일서버 서비스는 항상 최상위 호출이다." *재반박* 그렇다면 `inRootWrite`로 + 강제해야 한다. 지금 그 가정은 주석에만 있고 타입으로도 런타임으로도 검사되지 않는다. + +#### H2. `[개정: 미검증 → 설정 수준 확정]` 미커밋 변경의 import 정렬이 `:application-core:check`를 깬다 + +- `src/application-core/src/test/.../objectstorage/ObjectStorageArchitectureContractTest.java:10-11`: + ``` + 10 import dev.caskeleton.application.testsupport.CompiledPackageScanner; + 11 import dev.caskeleton.application.storage.StoredObject; + ``` + `testsupport` < `storage`가 아니다. +- **설정 확정**: `src/build-logic/src/main/java/dev/caskeleton/buildlogic/quality/QualityConventionsPlugin.java:47-51` + ```java + spotless.java(java -> { + java.googleJavaFormat(version(catalog, "googleJavaFormat")); + java.importOrder(); // ← 49행, 무인자 = 전체 알파벳 정렬 강제 + java.removeUnusedImports(); + }); + ``` + `spotlessCheck`는 leaf `check`에 묶이므로 현재 워킹트리에서 `./gradlew :application-core:check`가 실패한다. +- **수정**: `./gradlew :application-core:spotlessApply` +- **남은 미검증**: 실행은 못 했다. 확인 명령 — `cd src && ./gradlew :application-core:spotlessCheck --console=plain` + +#### H3. `domain-core` 104줄 질문 판정 — **(a)가 맞다.** 도메인이 샌 게 아니다 + +- **근거 1**: `application-core/build.gradle:9-14`에 `project(':domain-core')`가 없다. + `grep -rn "dev\.caskeleton\.domain" src/application-core/src` → **0건**. + 도메인이 샜다면 최소한 `ResourceId`나 `@AggregateRoot`를 썼어야 한다. +- **근거 2**: `domain-core`의 유일한 프로덕션 소비자는 `sample-portfolio`의 WorkLog/Poster 애그리거트 14개와 + `adapter/inbound/websocket/.../LiveEventStompBroadcaster.java` 하나다. +- **근거 3**: `application-core`의 376개 record 중 `@AggregateRoot`·`@ValueObject`가 붙은 것이 0개다. + 상태 전이는 전부 `FileState`/`InboxState`/`IdempotencyState` 같은 **운영 상태 머신**이지 비즈니스 불변식이 아니다. +- 그래서 실제 문제는 그 자리에 들어앉은 제품 3개다 → §H4. + +#### H4. `[개정: 근거 보강]` `application-core`의 76%는 fork 사용자가 고르지 않은 제품 3개다 + +초판에서는 "부피가 크다"까지만 말했다. **8,000줄을 읽은 결과 성격이 확정됐다: 인프라 배관이 아니라 +완성된 제품이며, 그 안의 결정은 전부 의견이 들어간 비즈니스 판단이다.** + +- **`notification/**` 17,068줄은 하나가 아니라 서로 독립된 두 개의 알림 플랫폼이다.** + - R1(`notification/`, 100타입 4,594줄): frozen-plan / binding-snapshot / writer-fence / cutover 모델 + - platform(`notification/platform/`, 315타입 12,474줄): plan / dispatch / ledger / projection 모델 + - 둘이 서로를 모르게 하는 ArchUnit 규칙이 따로 있다(`ApplicationBoundaryArchitectureTest.java:109-126`). +- **그 안의 결정들은 인프라가 아니라 제품 정책이다** (읽고 확인한 것): + - 억제 우선순위 — `policy/CompositeNotificationEligibilityPolicy.java:9-14` + "선호(preference)는 마지막에 평가한다. 뮤트는 선호지 차단이 아니므로 억제가 이미 거부한 걸 되살릴 수 없다" + - 재시도 vs 화해 — `policy/DefaultNotificationRetryPolicy.java:11-14` + "인증 실패는 재시도하지 않는다. 만료된 키 하나 × 큐 = 스스로 만든 장애" + - 중복 위험 승인 — `admin/DuplicateRiskGuard.java:12-15` + "재발송은 사람만 받아들일 수 있는 비용" + - 폴백 금지 — `policy/RoutingDecisionEngine.java:11-13` + "모호한 시도가 있는 동안 다른 채널로 넘어가지 않는다. 푸시가 이미 폰에 떴을 수 있는데 SMS를 '혹시 몰라' 보내면 + 모름이 확정 중복이 된다" + - 콜라간 병합 규칙 — `callback/StandardDeliveryProjector.java:12-15` + "Twilio는 콜백 순서를 보장하지 않으므로 sent가 delivered 뒤에 온다. '순위 높은 쪽 적용'은 하나를 조용히 버린다" +- **`fileserver/**` 7,480줄**도 같다 — 업로드 리스 페널싱, 고아 정리 2단계(retire→purge), + 검증 파이프라인 4-verdict, 쿼터 예약/커밋/반환. +- **그런데 진짜 "애플리케이션 계약"인 `usecase`+`command`+`query`+`capability`는 38줄이다.** +- **왜 문제인가**: fork해서 쇼핑몰을 만드는 사람이 알림 문자 하나 보내려면 (a) R1과 platform 중 어느 + `Channel`을 쓸지 고르고, (b) 남이 정한 억제 우선순위·재시도 규칙·중복 승인 정책을 상속받는다. + 템플릿의 학습 비용이 "Clean Architecture를 배우는 비용"이 아니라 "남의 플랫폼 3개를 배우는 비용"이다. +- **수정 방향**: 세 제품을 별도 leaf로 분리(`application-notification` / `application-fileserver` / + `application-objectstorage`)하고 `modules.json`에 등록해 `settings.gradle`에서 제외 가능하게 만든다. + 지금은 all-or-nothing이다. +- **반론과 재반박**: *반론* "레퍼런스 구현이 있어야 port 설계가 옳은지 증명된다." — 타당하고, 실제로 이 코드의 + port 품질이 높은 이유다. *재반박* 증명과 강제 상속은 다르다. 이 저장소는 이미 `sample-portfolio`라는 + 격리 leaf를 갖고 있다. 같은 원리를 적용하면 증명은 남기고 비용은 옵션이 된다. + +#### H5. `[개정: 하향 + 성격 변경]` 캐시 엔진·리스 워치독 약 2,000줄이 **프로덕션에서 조립되지 않는다** + +초판에서 나는 "테스트가 없어 동시성 버그가 리뷰로만 잡힌다"고 썼다. **그건 틀렸다.** +테스트를 읽어보니 `CacheAsideExecutorTest`는 **15개 테스트에 실제 멀티스레드 검증**이 들어 있다: +`concurrentSameKeyMissesInvokeTheLoaderOnce`(4스레드+래치), +`distributedSoftLeaseLetsOnePodRefreshWhileAContenderReturnsStale`, +`invalidationDuringLoadRejectsTheOldCapturedWriteCondition`(로딩 중 무효화 레이스), +`indeterminateClaimIsRetriedOnceWithTheSameOperation`(`assertThat(attempts.get(0)).isSameAs(attempts.get(1))`), +그리고 `CacheResilienceConcurrencyTest` 4개가 단일플라이트 바운드/인터럽트 보존을 검증한다. + +**따라서 문제는 "검증 부족"이 아니라 "배선 부재"다.** + +| 타입 | 줄 | 프로덕션 조립처 | 단위 테스트 | +|---|---|---|---| +| `cache/CacheAsideExecutor.java` | 457 | **없음** | 15개 (동시성 포함) | +| `cache/CacheSingleFlight.java` | 210 | **없음** | 4개 | +| `cache/CacheSourceBulkhead.java` | 69 | **없음** | 포함 | +| `cache/Disabled*Port.java` | 57 | **없음** | 2개 | +| `lease/LeaseWatchdog.java` | 224 | **없음** | 2개 | + +`application.cache`를 참조하는 외부 프로덕션 파일은 `RedisCacheConfig.java`와 `RedisCacheRegionAdapter.java` +둘뿐이고, 둘 다 `CacheRegionPort`만 배선한다. **캐시-어사이드 알고리즘이 아무 데서도 안 돈다.** +- **왜 문제인가**: fork 사용자가 이걸 "제공되는 기능"으로 믿고 배선하면, **저장소 최초의 통합 사용자**가 된다. + 단위 테스트는 통과하지만 Redis 어댑터와의 실제 조합은 한 번도 실행된 적이 없다. +- **수정 방향**: (a) `app-bootstrap`에 조립 경로 + 통합 테스트 1개를 추가해 "지원됨"으로 만들거나, + (b) `@Deprecated`나 `incubating` 패키지로 옮겨 "미지원"임을 타입으로 알린다. + +> **H6은 3차에서 Medium으로 내려 §Medium 절로 옮겼다** — N1 퍼사드의 `Map`는 실재하지만 +> 그 8타입의 구현·호출자가 저장소 전체에 0개라 라이브 경로가 없다. ID는 초판 참조용으로 유지했다. + +#### H7. `[개정: 이름 grep → 참조 그래프 전수]` 테스트가 **직접·간접 모두 도달하지 못하는** main 타입 185개 / 6,145줄 (17%), 그 안에 실행 클래스 16개 / 2,045줄, 그리고 발견된 버그 3건이 전부 그 안에 있다 + +- **2차의 한계와 3차의 방법**: 2차는 "테스트 파일에 이름이 나오는가"만 봤다. 그러면 **협력자를 통한 간접 커버**를 + 배제하지 못한다. 3차는 `application-core` main 887타입(동명 3개 제외)에 대해 **참조 그래프**를 만들어 + 전수 판정했다: + 1. 테스트 코퍼스 139파일 전체에서 이름이 등장하는 타입 = **씨앗 640개** + 2. 씨앗이 자기 main 소스에서 참조하는 타입을 **전이적으로** 확장 + 3. 확장이 끝난 뒤에도 닿지 않은 것 = **테스트가 어떤 경로로도 실행할 수 없는 타입** + + 결과 **185타입 / 6,145줄 (main 35,894줄의 17.1%)**. 종류별로 interface 66 · record 57 · class 50 · enum 12. +- **그중 실행 클래스 50개(2,677줄)에서 사소한 예외 서브클래스 34개(8~43줄, 전부 생성자 1개)를 빼면 + 행위를 담은 클래스 16개 / 2,045줄이 남는다:** + + ``` + 483 notification/platform/dispatch/NotificationDispatchService.java ← 디스패치 오케스트레이터 + 336 notification/platform/admin/NotificationAdminApplicationService.java ← 파괴적 운영 4종 + 216 notification/platform/dispatch/AcceptNotificationApplicationUseCase.java + 161 notification/platform/dispatch/DispatchOutcomeRecorder.java + 127 notification/platform/dispatch/ReconciliationService.java + 123 notification/platform/dispatch/PublishNotificationTemplateApplicationUseCase.java + 101 notification/platform/dispatch/ApplicationReceiptServiceImpl.java + 96 notification/platform/dispatch/DispatchPipeline.java + 71 notification/platform/dispatch/DeliveryAttemptFactory.java + 60 fileserver/upload/DefaultSingleShotUploadService.java ← 유일한 비-notification + 52 notification/platform/dispatch/SubmitNotificationApplicationUseCase.java + 52 notification/platform/dispatch/ScheduleNotificationApplicationUseCase.java + 48 notification/platform/dispatch/CancelNotificationApplicationUseCase.java + 45 notification/platform/dispatch/GetNotificationApplicationUseCase.java + 43 notification/platform/admin/AdminAuthorizationGuard.java + 31 notification/platform/admin/DuplicateRiskGuard.java + ``` + **16개 중 15개가 `notification/platform/{dispatch,admin}`이다.** 알림 런타임의 오케스트레이션·운영 평면 전체. + (2차에서 이 목록에 넣었던 `SensitiveValueDetector`(86)와 `GsmAlphabet`(51)은 **간접 커버가 확인되어 빠졌다** — + `BoundedObservabilityTest`가 `NotificationAuditEvent`를 통해, `SmsSegmentEstimatorTest`가 + `SmsSegmentEstimator`를 통해 실제로 실행한다. 이름 grep이 만들던 오탐이 여기서 걷혔다.) +- **이름 혼동 주의**: `NotificationDispatchUseCaseTest`는 R1의 `NotificationDispatchUseCase`를 테스트한다. + platform의 `NotificationDispatchService`가 아니다. 두 타입은 다른 패키지의 다른 코드다. +- **왜 High인가 — 인과가 확인됐다.** 이 저장소의 테스트는 §6 K1에서 보듯 최상급이다. + 그래서 구멍의 위치가 정확히 드러나고, 내가 이번 리뷰에서 찾은 버그 3건이 + **전부 이 16개 안에, 그것도 크기 1·2·3위 클래스에** 있다: + + | 발견 | 클래스 | 줄 | 목록 내 순위 | + |---|---|---|---| + | M12 (고아 DISPATCHING 행) | `NotificationDispatchService` | 483 | 1위 | + | H9 (`claim()` 미호출) | `NotificationAdminApplicationService` | 336 | 2위 | + | H8 (`Objects.hash` 멱등키) | `AcceptNotificationApplicationUseCase` | 216 | 3위 | + + **"테스트가 없는 곳에 버그가 있다"가 이 저장소에서는 비유가 아니라 측정값이다.** + 반대 방향도 사실이다 — 테스트가 닿는 702타입에서는 같은 급의 결함을 찾지 못했다. +- **수정 방향**: 이 16개를 우선순위로 테스트한다. `notification/platform/dispatch/PlatformFakes.java`(707줄)가 + 이미 request/recipient/attempt 스토어, 트랜잭션 기록기, 메트릭 기록기, 순차 ID 생성기를 다 갖고 있으므로 + `NotificationSubmissionServiceTest`와 같은 방식으로 붙일 수 있다. 진입 비용은 낮다. +- **반론과 재반박**: *반론* "이 클래스들은 어댑터 통합 테스트에서 실행된다." *재반박* 저장소 전체를 검색했고 + `dev.caskeleton.application.notification.platform.dispatch.NotificationDispatchService`를 참조하는 + 테스트 파일은 어느 소스셋에도 없다. 어댑터 쪽 스토어 구현 테스트는 있지만 오케스트레이터는 없다. + +#### H8. `[신규]` 알림 멱등키를 `Objects.hash`로 만든다 — JVM 재시작마다 값이 바뀌어 중복 발송된다 + +- **근거**: `notification/platform/dispatch/AcceptNotificationApplicationUseCase.java:186-194` + ```java + private static String derivedKey(AcceptNotificationCommand command) { + return Integer.toHexString( + Objects.hash( + command.recipientRef(), + command.channel(), // ← Channel enum + command.templateId(), + command.templateVersion(), + command.variables())); + } + ``` + 호출 지점 `:115` — `new IdempotencyKey(command.idempotencyKey().orElseGet(() -> derivedKey(command)))`. + `AcceptNotificationCommand.java:45` `Optional idempotencyKey`이므로 **키를 안 준 호출자의 정규 경로**다. +- **결함 두 개**: + 1. **JVM 실행마다 값이 달라진다 — 불안정한 원소는 정확히 하나, `channel`이다.** + `Objects.hash` → `Arrays.hashCode` → 각 원소의 `hashCode()`. + 나머지 네 원소는 안정적이다: `recipientRef`/`templateId`는 `String`, `templateVersion`은 `long`, + 그리고 `[3차 확인]` `variables`는 `Map`가 아니라 + `Map`이며(`port/in/AcceptNotificationCommand.java:704`) + `NotificationVariable`은 `String`/`BigDecimal`/`boolean` 위에 선 record 대수이므로 값 기반이다. + 그러나 `command.channel()`은 `routing.Channel` **enum**이고, `Enum.hashCode()`는 `final`로 + `Object.hashCode()`(= identity hash)를 반환한다 — **JVM 실행 간에 안정적이지 않다.** + 따라서 타임아웃 후 재시도가 재시작된 파드나 다른 파드에 닿으면 **다른 멱등키가 생성되고 + 중복 제거가 일어나지 않는다 → 같은 알림이 두 번 발송된다.** + 반증 가능: 같은 `AcceptNotificationCommand`로 `derivedKey`를 호출하는 테스트를 서로 다른 JVM에서 + 두 번 돌려 값이 같으면 이 판정은 틀렸다. (`channel`을 `channel.name()`으로만 바꿔도 이 결함은 사라진다.) + 2. **32비트 충돌.** 생일 한계로 약 77,000개 요청에서 충돌 확률 50%. 충돌하면 서로 다른 두 알림이 + 한 멱등키를 공유해 하나가 조용히 드롭되거나 `IdempotencyConflictException`으로 실패한다 — + `NotificationVariable.java:17-18`이 "두 요청이 한 멱등키로 붕괴한다"고 경고한 바로 그 실패다. +- **올바른 도구가 20줄 옆에 있다**: `notification/platform/dispatch/RequestFingerprint.java:34-37` — + `CanonicalNotificationPlanEncoder`가 만든 정규 바이트에 대한 SHA-256(64 hex). + `CanonicalNotificationPlanEncoder.java:112-128`의 `canonicalVariable`은 타입 태그까지 붙여 + `"1"`과 `1`을 구분한다. +- **테스트 없음**: `AcceptNotificationApplicationUseCase`는 §H7의 도달 불가 16개 중 **3위**(216줄)다. 이름 기반이 아니라 참조 그래프로 확정했다 — 어떤 테스트도 직접·간접으로 이 클래스를 실행하지 않는다. +- **수정 방향**: `derivedKey`를 지우고, 플랜을 먼저 만든 뒤 `RequestFingerprint.of(planEncoder.encode(plan))`를 쓴다. + (순환이 걸리면 `MessageDigestPort.sha256`으로 recipientRef/channel.name()/templateId/version/정규화된 변수를 + 길이 프레이밍해 해싱한다. 핵심은 **명세된 안정 해시 + 128비트 이상**.) +- **반론과 재반박**: *반론* "실무에선 호출자가 항상 키를 준다." *재반박* 그렇다면 `Optional`이 아니라 + 필수 파라미터여야 한다. 폴백을 제공하면서 그 폴백이 틀린 것이 가장 나쁜 조합이다. + +#### H9. `[신규]` 운영 멱등 `claim()`이 구현·통합테스트까지 있는데 유일한 소비자가 호출하지 않는다 + +- **근거**: + - `notification/platform/admin/AdminOperationStorePort.java:14-32`가 `claim(...)`을 선언하고, + Javadoc이 고치려는 결함을 정확히 서술한다: + > "The admin path was find, then side effect, then save. Two callers presenting the same operation id + > both read 'not found', both ran the redrive, and both saved — the idempotency key was checked but + > never held, so it prevented a repeat and not a race. **A destructive operation run twice + > concurrently is the exact failure the id exists to stop.**" + - 어댑터 구현 있음: `adapter/outbound/persistence-jpa/.../JpaAdminOperationStore.java:32-71` + - 통합 테스트 있음: `adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/.../AdminOperationClaimContractTest.java` + - **그런데 `NotificationAdminApplicationService`의 `operations.*` 호출은 전부 옛 패턴이다**: + ``` + 94: operations.findByOperationId(...) 145: operations.save(...) ← redrive + 154: operations.findByOperationId(...) 194: operations.save(...) ← reconcile + 203: operations.findByOperationId(...) 272: operations.save(...) ← suppress + 282: operations.findByOperationId(...) 328: operations.save(...) ← setProviderState + ``` + - 저장소 전체에서 `AdminOperationStorePort.claim`의 애플리케이션 호출처 **0건**. + `AdminOperationClaim.mayProceed()`(`:86-88`)도 죽은 코드다. +- **구체적 실패**: 운영자가 타임아웃 후 `redrive`를 재전송하거나 두 운영자가 같은 `operationId`로 동시에 + 누르면, 둘 다 `findByOperationId`에서 empty를 읽고 둘 다 + `recipients.transition(..., READY_TO_DISPATCH, ...)`(`:121-124`)를 실행한다 → + **알림이 두 번 발송된다.** `DuplicateRiskGuard`(`:104`)가 막으려던 바로 그것이다. +- **테스트 없음**: `NotificationAdminApplicationService`는 §H7의 도달 불가 16개 중 **2위**(336줄)다. +- **수정 방향**: 네 메서드 모두 `findByOperationId` → `claim(operationId, commandFingerprint, actor, action)`으로 + 교체하고 `AdminOperationClaim.Outcome`을 분기한다(CLAIMED만 진행, REPLAY는 반환, IN_PROGRESS/CONFLICT는 거부). + `commandFingerprint`는 각 Command record에서 파생한다. + +#### H10. `fileexport` port가 서버 절대경로를 반환하고 결과 전체를 메모리에 올린다 + +- `fileexport/ExportedFile.java:8,12` — `@param path the **absolute path** the file was written to` +- `fileexport/FileExportPort.java:36` — `exportCsv(String fileName, List header, List> rows)` +- 같은 모듈의 정반대 규율: `fileserver/api/error/FileserverFailureContext.java:14-15` + ("never carries a physical path"), `objectstorage/identity/ObjectDestinationId.java:3` + ("never a provider bucket, path, or endpoint"), `fileserver/admin/StorageHealthReport.java:9-11`. +- 후속 설계 `filepublication/FilePublicationPort.java:9`는 이미 스트리밍(`TabularRowProducer`)에 + 오퍼크 `PublishedFileReference`를 반환한다. **그런데 `fileexport`에는 `@Deprecated`가 없다** — + 같은 성격의 레거시인 `storage/ObjectStoragePort.java:28`은 `@Deprecated(forRemoval = true)`가 붙어 있다. +- **수정**: `fileexport` 전체에 `@Deprecated(forRemoval = true)`, `ExportedFile.path`를 오퍼크 참조로. + 소비자는 `FilesystemCsvExportAdapter` + `FileExportConfig` 둘뿐이라 이동 비용이 작다. + +--- + +### Medium + +#### M1. 코어가 기술의 on/off를 직접 묻는다 +`cache/CacheRefreshCoordinationPort.java:15-17` `default boolean enabled()`, +`cache/CacheAsideExecutor.java:263` 분기. null object + `CacheRefreshClaimOutcome.Disabled`와 삼중 중복이고, +셋이 어긋날 수 있다(`enabled()==true`인데 `claim()`이 `Disabled` 반환). +**수정**: `enabled()` 제거, `Disabled` 결과만으로 판단. +*반론* "false면 토큰 발급 비용을 아낀다." *재반박* `newAttempt()`가 `CacheRefreshClaimAttempt.unavailable()` +상수를 반환하므로 아끼는 비용이 0이다. + +#### M2. 같은 개념의 `Channel` enum이 3개, 그중 2개는 같은 패키지에 +- `notification/Channel.java:8` — `{EMAIL, SLACK}` +- `notification/NotificationChannel.java:4` — `{EMAIL, SLACK}` ← **같은 패키지, 같은 값** +- `notification/platform/api/routing/Channel.java:7` — `{EMAIL, SMS, PUSH, WEB_PUSH, IN_APP, WEBHOOK}` + +`ApplicationBoundaryArchitectureTest.java:60-63`이 문제를 인지하고 있으나, 규칙 +`NOTIFICATION_R1_AND_PLATFORM_DO_NOT_DEPEND_ON_EACH_OTHER`는 **두 네임스페이스 사이**만 막고 +R1 패키지 **안**의 중복은 못 막는다. `Channel`은 참조가 3파일뿐이라 제거 비용이 작다. +같은 종류로 `dispatch/RequestFingerprint` vs `idempotency/RequestFingerprint`, `ReconciliationResult` 2개. + +#### M3. 인가 추상화가 4개 병렬로 존재한다 +`security/AuthorizationPort`(Permission) · `security/ObjectAccessPolicy`(객체 단위) · +`fileserver/api/security/FileAccessPolicy`(파일서버 전용) · +`notification/platform/admin/{NotificationAdminAuthority,AdminAuthorizationGuard}`(알림 전용). +fork 사용자는 하나의 정책을 4번 구현해야 하고, 넷이 서로를 모르므로 한 곳만 채우고 빠뜨리는 게 정상 경로다. +**수정**: 앞의 2축을 정본으로 삼고 뒤의 둘을 그 위의 얇은 어댑터로. + +#### M4. `MasterSwitch`의 프로퍼티 접두어가 3종류다 +`shared-contract/activation/MasterSwitch.java:21-30`: +``` +PERSISTENCE_JPA "ca-skeleton.persistence-jpa.enabled" +PERSISTENCE_MONGO "ca-skeleton.persistence-mongo.enabled" +MESSAGING "app.messaging.enabled" ← ca-skeleton 아님 +NOTIFICATION_PLATFORM "ca-skeleton.notification.platform.enabled" +GRAPHQL "backend.graphql.enabled" ← ca-skeleton 아님 +``` +운영자가 `APP_*`만 보면 GraphQL을 못 끈다. `:46-60` 주석이 GRAPHQL의 legacy 목록을 의도적으로 비워 놨으므로 +마이그레이션 장치도 이 불일치를 다루지 않는다. +**수정**: `ca-skeleton.*`로 정규화하고 기존 이름을 `legacyProperties()`에 등록(이 클래스가 정확히 그 용도다). + +#### M5. `shared-contract`에 Redis 이름이 박혀 있다 +`health/RedisHealthSnapshotProvider`(타입명 자체), `ratelimit/RateLimitDecision.java:51-53` +`enum DecisionSource { GLOBAL_REDIS }`(값이 하나), `error/AdapterDisabledException.java:42` Javadoc. +`shared-contract/CLAUDE.md:22-23`이 `RedisHealthSnapshotProvider`를 명시 허용하므로 **문서 드리프트는 아니다.** +다만 같은 `ratelimit` 패키지의 나머지가 집요하게 provider-neutral인데 `GLOBAL_REDIS`만 벤더를 못 박는다. +**수정**: `GLOBAL_SHARED_STORE`로. `RedisHealthSnapshotProvider`는 그대로. + +#### M6. `application-core`에 정적 `ThreadLocal` 전역 상태 +`transaction/IrreversibleSideEffectContext.java:25`. 프로덕션 소비자는 +`adapter/outbound/persistence-jpa/.../DefaultJpaRetryPolicy.java` 하나. +파일 주석(13-16행)의 방향 논리는 맞다. 그럼에도 Medium인 이유: (a) `clear()`를 잊으면 스레드 풀에서 누수, +(b) `shared-contract`는 같은 문제를 `DomainContextPropagator` port + 명시적 capture/restore로 풀어놨는데 +여기만 전역 static이다. 두 해법이 공존한다. +**수정**: `DomainContextKey` + `DomainContextPropagator`로 표현하면 기존 seam을 재사용한다. + +#### M7. `application-core/CLAUDE.md`에 같은 절이 두 번 통째로 복사돼 있다 +`:85-106`과 `:108-129`가 **"## Notification R1 application boundary"**로 제목·본문 6개 불릿까지 동일. +SSOT라고 선언된 파일이므로 그 자체로 결함이다. + +#### M8. `DefaultTransferAdmissionController`의 스코프 세마포어 맵이 무한 증가 +`fileserver/quota/DefaultTransferAdmissionController.java:30,100-103` — +`ConcurrentHashMap`에 `computeIfAbsent`만 있고 제거 경로가 없다. +`QuotaScope.ofTenant`가 존재하므로 테넌트 단위 키가 정상 사용처다. 엔트리는 작지만 **상한이 없다.** +**수정**: 상한 있는 LRU, 또는 초과 시 전역 세마포어 폴백. + +#### M9. `edgeRateLimitContractTest` 보조 소스셋이 얻는 게 거의 없다 +`shared-contract/build.gradle:11-26` — 전용 소스셋 + `strictTestLanes` 레인(`group = 'redis verification'`). +그 안의 유일한 파일은 **75줄**이고 Redis도 프로바이더도 등장하지 않는다. +소스셋 격리가 주는 보장("provider를 아는 헬퍼를 import 못 함")은 `shared-contract`가 **Java stdlib only**라는 +사실만으로 이미 성립한다. 레인 이름이 `redis verification`인데 Redis가 없는 점도 운영자를 오도한다. +*반론* "나중에 Redis 구현이 이 레인에 붙는다." *재반박* `sourceSet = 'edgeRateLimitContractTest'` 주석이 +*"nothing else in this leaf can join the lane"*이라 프로바이더는 애초에 못 들어온다. + +#### M10. `domain-core` 테스트가 0줄이다 +`.gitkeep` 2개가 전부. 마커 애너테이션 3개와 인터페이스 2개는 실행 로직이 없으므로 단위 테스트할 것이 +실제로 없다 — **여기까진 Keep 쪽이다.** 문제는 `domain-core/README.md`가 주장하는 보장 +(`no_long_id_pk`, `domain_events_are_records`, `value_objects_have_no_public_no_arg_constructor`, `domain_is_pure`)이 +전부 `app-bootstrap`의 ArchUnit에만 있다는 것이다. **`domain-core`의 계약을 검증하는 코드가 `domain-core` 밖에만 있다.** +**수정**: `ResourceId.value()`가 36자 UUID라는 계약(`ResourceId.java:13`)만이라도 leaf 안에 계약 테스트 하나로. + +#### M11. `FileRecordMutation.publish(...)`는 죽은 코드이고 main 유일의 `Instant.now()`를 품는다 +`fileserver/api/metadata/FileRecordMutation.java:47-57` — `Optional.of(Instant.now())`. +저장소 전체에서 `FileRecordMutation.publish(` 호출 **0건**; 프로덕션은 전부 `publishAt(...)`(주입 `Clock`)을 쓴다. +`application-core` main 전체에서 비주입 시계 호출은 이 한 줄뿐이다 +(`outbound/CallBudget.java:15`의 `System.nanoTime()`은 단조시계라 별개). **수정**: 삭제. + +#### M12. `NotificationDispatchService`가 리스를 잃으면 DISPATCHING 시도 행이 고아로 남는다 +`notification/platform/dispatch/NotificationDispatchService.java:149-166` — +`attempts.insertDispatching(...)`를 **커밋한 뒤** `if (!leases.stillHeld(lease)) { return; }`. +주석(162-165)은 "위쪽은 다시 하면 되는 DB 작업"이라 하지만 방금 커밋한 DISPATCHING 행은 아무도 지우지 않고, +새 홀더는 `nextAttemptNo`로 다음 번호를 쓴다. +**`ReconciliationService.java`를 이번에 전문 독파해 확인한 결과, 회수 경로가 없다** — +`reconcile(attemptId)`는 주어진 attempt를 게이트웨이에 물을 뿐이고, +게이트웨이가 `supports()`를 만족하지 않으면 `Unsupported`로 끝난다. 고아 DISPATCHING 행을 스캔하는 주체가 없다. +초판에서 "미확인"이라 했던 부분을 확정한다. 이 클래스는 §H7의 도달 불가 16개 중 **1위**(483줄)다. + +#### M13. `[신규]` `RenderCommand`/`TemplateVariableValidator`의 `Map` — 정당하지만 표시가 없다 +`template/RenderCommand.java:16`, `template/TemplateVariableValidator.java:9`. +H6과 달리 **이건 옳다** — `NotificationVariable.plain()`(`:41-50`)이 "One direction only"로 명시한 +렌더링용 투영이기 때문이다. 다만 두 파일 어디에도 "여기의 Object는 의도된 것"이라는 표시가 없어, +H6을 고치는 사람이 같이 바꾸려다 닫힌 대수를 역방향으로 열 위험이 있다. **수정**: 두 곳에 한 줄 주석. + +--- + +#### M14. `[신규]` 두 번째 트랜잭션 계약 188줄이 어댑터·어댑터 테스트까지 갖췄는데 코어 호출자가 0이다 +`transaction/PolicyTransactionPort.java:10-13`이 `TransactionPort`를 확장해 +` TransactionResult inTransaction(TransactionRequest, Supplier)`를 선언한다. +딸린 타입이 `TransactionRequest`(38) · `TransactionResult`(83) · `TransactionPolicyId`(45) · +`ReadConsistency`(9) — 합계 **188줄**. 어댑터 구현도 있다 +(`adapter/outbound/persistence-jpa/.../SpringTransactionPort.java:31,165` `implements PolicyTransactionPort`), +어댑터 테스트도 있다(`SpringPolicyTransactionPortTest` 13건 + `PostgreSqlTransactionIntegrationTest`), +코어 테스트도 있다(`TransactionRequestTest` 5건 + `TransactionResultTest` 4건). + +**그런데 `application-core` main에서 `inTransaction(`를 호출하는 곳은 0건이다.** +`TransactionPort`를 주입받는 코어 파일 34개는 전부 4메서드 버전(`inWrite`/`inRootWrite`/`inRead`/`inNew`)만 쓴다. +`port.inTransaction(` 호출은 어댑터 테스트 2파일에만 존재한다. + +**왜 Medium인가**: 두 가지가 겹친다. +1. 같은 개념의 계약이 둘이라 fork 사용자가 어느 쪽에 맞춰야 하는지 알 수 없다(§M3의 인가 4중화와 같은 냄새). +2. **미사용 쪽이 더 정확하다.** `TransactionResult`는 `Committed` / `Participating` / + `Indeterminate(phase, reconciliationReference)` / `DeterminateRollback` / + `CommittedWithPostCommitFailure`를 구분한다 — §H1의 보상 쓰기 문제가 필요로 하는 바로 그 어휘다. + 현재 코어는 `Supplier`를 받아 `T`를 돌려주는 계약만 쓰므로 "커밋됐는지 모른다"를 표현할 방법이 없다. + +**수정 방향**: 둘 중 하나. (a) `PolicyTransactionPort`로 실제 이전한다 — 최소한 §H1이 지적한 +보상 쓰기 2곳(`DefaultFinalizeUploadService.java:318-331`, `DefaultUploadApplicationService.java:151-160`)부터. +(b) 쓸 계획이 없으면 188줄과 어댑터 구현을 지운다. 지금 상태는 "더 나은 계약이 있는데 아무도 안 쓴다"이고, +이건 §H5·§H6과 같은 "선언됐지만 조립되지 않음" 계열의 세 번째 사례다. + +#### H6→M. `[개정: High → Medium]` (ID는 초판 참조용으로 유지) N1 퍼사드 8타입이 `Map`를 들고 있는데, **구현도 호출자도 저장소 전체에 0개다** + +- **현상**: `NotificationVariable` 닫힌 대수가 존재하는데, N1 공개 진입점 4개가 여전히 원시 `Object` 맵을 받는다. + ``` + notification/platform/email/EmailNotification.java:19 Map variables + notification/platform/sms/SmsNotification.java:19 Map variables + notification/platform/push/MobilePushNotification.java:22 Map variables + notification/platform/webpush/WebPushNotification.java:19 Map variables + ``` +- **`[3차 개정]` 심각도를 내린 이유 — 배선이 없다.** 저장소 전체(`src/**`)를 검색한 결과: + - `EmailNotifier`를 참조하는 파일: `EmailNotifier.java` 자신 + `PublicApiBoundaryTest` 뿐 + - `SmsNotifier`: 자신 + `PublicApiBoundaryTest` 뿐 + - `MobilePushNotifier` / `WebPushNotifier`: **자기 파일 하나씩** + - `EmailNotification`을 타입으로 쓰는 파일: 자신과 `EmailNotifier` 뿐 + - `InAppNotifier`: **존재하지 않음** + + 즉 N1은 **인터페이스 4 + record 4 = 8타입, 구현 0, 호출자 0**이다. 지문 충돌이 실제로 일어나는 + 라이브 경로가 없으므로 Critical/High가 아니다. 이건 §H5와 같은 "선언됐지만 조립되지 않음" 계열이다. +- **그래도 결함인 이유** — 이 정확한 결함을 코드가 스스로 문서화해 놨다. + `notification/platform/api/NotificationVariable.java:13-24`: + > "The plan took `Map`. ... The fingerprint had to render values with `toString()`, + > **so two different values could produce the same text and two accepted requests could collapse onto + > one idempotency key.**" + + N2(`NotificationPlan`)는 고쳤고 N1 퍼사드는 안 고쳤다. **fork 사용자가 N1을 구현하는 순간 그 결함을 상속한다.** + 공개 API가 정본보다 약한 타입을 받는 상태로 고정돼 있다. +- **가드 2개가 왜 못 잡는가 (구조가 핵심)**: + 1. `PublicApiBoundaryTest.java:25-33` `typedFacadesDoNotAcceptRawMaps()` — + `EmailNotifier.class.getMethods()`의 **파라미터 타입**만 검사한다. `send(EmailNotification)`이므로 + `Map`이 아니다 → **통과.** record 컴포넌트는 안 본다. + 2. `PublicApiIsTypedTest.java:30,34-50` `noPublicApiRecordCarriesAnUntypedValue()` — + record 컴포넌트를 **모든 깊이까지** 올바르게 검사하고 공허통과 가드(`:57` `hasSizeGreaterThan(10)`)까지 있다. + 그러나 스캔 대상이 `API_PACKAGE = "dev.caskeleton.application.notification.platform.api"` 하나다. + 퍼사드 4개는 `...platform.{email,sms,push,webpush}` — **스캔 범위 밖.** + + Javadoc은 "So the ban is structural"(`PublicApiIsTypedTest.java:25`)이라고 선언하는데, + 구조적으로 금지된 범위와 공개 진입점이 어긋나 있다. **C1·C2와 같은 패턴의 세 번째 사례다.** +- **수정 방향**: (a) `PublicApiIsTypedTest`의 스캔 대상에 4개 퍼사드 패키지를 추가하고, + (b) 네 record의 `variables`를 `Map`로 바꾼다. 호출자가 0이므로 파급은 8파일. + (c) 또는 N1을 통째로 삭제한다 — 구현도 호출자도 없는 퍼사드를 유지할 이유를 찾지 못했다. +- **반론과 재반박**: *반론* "N1은 fork가 나중에 구현할 확장점이다." *재반박* 그렇다면 더더욱 + 정본보다 강한 타입이어야 한다. 확장점은 구현자가 그 자리에서 결함을 물려받는 자리다. + 참고로 `template/RenderCommand.java:16`과 `TemplateVariableValidator.java:9`의 `Map`는 + **정당하다** — `NotificationVariable.plain()`이 "one direction only"로 명시한 렌더링용 투영이고 + (`NotificationVariable.java:128-137`), `NotificationDispatchService.plainVariables(...)`(`:327-332`)가 + 타입 대수에서 그쪽으로만 변환한다. 진입점과 렌더링 경계는 다르다. + +### Low + +#### L1. `[개정: 1건 → 패턴]` 손으로 쓴 코덱이 2개, 합계 약 600줄 +초판에서는 `OutboxPayloadPolicy`의 JSON 검증기 270줄만 지적했다. 두 번째가 있다: +`notification/platform/dispatch/CanonicalNotificationPlanEncoder.java` **338줄** — +길이 프레이밍 인코더 + 자체 `Cursor` 파서(`:208-253`)까지 포함한 왕복 코덱. +둘 다 이유가 같다 — `OutboxPayloadPolicy.java:20-22`: *"Building a tree would mean a JSON library on +application-core's classpath, which the module's contract forbids"*, +`CanonicalNotificationPlanEncoder.java:25-26`: *"It needs nothing from a framework: the variables are a +closed algebra."* +**판정: 현재로선 옳다**(§6 K2와 같은 논리). 다만 순수성 규칙의 **가격표**로 기록한다 — +이제 1건이 아니라 패턴이고, 세 번째가 생기면 라이브러리 금지 규칙 자체를 재검토할 시점이다. + +#### L2. `NotificationSubmissionService`에 죽은 중첩 블록 +`notification/platform/dispatch/NotificationSubmissionService.java:274-275`와 `:336-337`에 +`{ { ... } }` 빈 중첩 블록이 있다. `try (...)` 제거의 잔재로 보이며 들여쓰기만 두 단계 밀려 있다. + +#### L3. `AdapterDisabledException` Javadoc이 벤더명을 하드코딩 +`shared/error/AdapterDisabledException.java:4,42` — `(Kafka / Redis / Slack / Google Email …)`. +`adapterName`은 파라미터이므로 동작은 중립. 문서 정리 수준. + +#### L4. `[신규]` 코어에 스토리지 백엔드 이름이 상수로 박혀 있다 +`fileserver/upload/DefaultUploadApplicationService.java:272-273`: +```java +/** One bounded value, because the platform has exactly one storage provider. */ +private static final String STORAGE_TYPE = "local"; +``` +메트릭 태그 전용이라 피해는 없으나, `objectstorage`가 filesystem/S3/MinIO 세 백엔드를 지원하는 것과 +어긋나는 가정이다. 파일서버가 두 번째 백엔드를 얻으면 조용히 틀린 태그가 된다. + +#### L5. `[신규]` 라이브 I/O 리소스가 record 컴포넌트로 경계를 넘는다 +`notification/platform/provider/ResolvedAttachment.java:9` — `record ResolvedAttachment(InputStream content, ...)`. +`AutoCloseable`을 구현해 닫기는 모델링돼 있으나, record이므로 `equals`/`hashCode`가 스트림 신원을 비교한다. +같은 종류로 `fileserver/download/DownloadApplicationService.java:24,33`의 +`ReadableByteChannel`/`WritableByteChannel`, `fileserver/api/content/AsyncContentStore.java:20,27`의 +`Flow.Publisher`. 전부 JDK 타입이라 규칙 위반은 아니지만, 수명 관리 책임이 시그니처에 없다. + +#### L6. `[신규]` `withReasonSuffix(reasonCode)`가 인자를 검증만 하고 버린다 +`notification/platform/api/error/NotificationFailureDescriptor.java:994-1002`: +```java +private NotificationFailureDescriptor withReasonSuffix(String reasonCode) { + Objects.requireNonNull(reasonCode, "reasonCode"); + return this; // ← 인자를 쓰지 않는다 +} +``` +유일한 호출자는 같은 파일의 `suppressed(String reasonCode, Channel channel)`(`:960-972`)이다. +따라서 `suppressed("USER_OPT_OUT", EMAIL)`과 `suppressed("QUIET_HOURS", EMAIL)`은 **완전히 같은 값**이다. +Javadoc은 "태그를 닫아 두는 것이 metrics에 안전하다"고 설명하는데 그 판단 자체는 옳다. +문제는 **파라미터를 받아 `requireNonNull`까지 하고 버린다**는 것 — +호출자는 자기가 전달한 이유가 어딘가에 남는다고 믿게 된다. +`NotificationRedactionTest`·`NotificationExceptionTest`는 메시지만 보므로 이 사실을 잡지 못한다. +**수정**: 파라미터와 메서드를 지우거나(팩토리를 `suppressed(Channel)`로), 이유를 담을 필드를 추가한다. + +--- + +## 6. 바꾸지 말 것 (Keep) + +### K1. `[개정: 전수 실측 + 조합 검증 판정 추가]` 테스트 전략 — Mockito 0, Spring 0, 그리고 **부품 검증만 있는 것이 옳다** + +초판은 "무엇을 안 썼는가"(Mockito/Spring 부재)로 주장했고, 2차는 이름과 밀도를 셌다. +3차는 **139개 전문 독파 + 663개 전수 분류**로 확정한다. + +**전수 지표 (3차 실측):** + +| 지표 | `application-core` | `shared-contract` | 합계 | +|---|---|---|---| +| 테스트 파일 | 139 (`@Test` 보유 113) | 25 | 164 | +| 테스트 메서드 | **663** | 242 | **905** | +| 단정 호출 | **1,801** | 510 | **2,311** | +| 메서드당 단정 | 2.72 | 2.11 | 2.55 | +| `@DisplayName` 문장형 이름 | 96 | — | — | +| 손으로 쓴 fake 클래스 선언 | 86 | — | — | +| `org.mockito` | **0** | **0** | **0** | +| Spring 컨텍스트 | **0** | **0** | **0** | + +**부품 대 조합 — 663개를 전수 분류한 결과 (§1 상세표):** + +``` +부품(행위) 검증 603 90.9% 프로덕션 타입 + 손으로 쓴 fake, 행위 단정 +구조(경계) 검증 50 7.5% 리플렉션으로 시그니처·sealed permits·애너테이션 값 단정 +실스레드 동시성 10 1.5% ExecutorService / CountDownLatch로 진짜 경합 +조합(조립) 검증 0 0.0% 없음 +``` + +**그리고 0인 것이 옳다.** `application-core`에는 조립할 것이 존재하지 않는다 — +`@ConditionalOn*` 0, 빈 등록 0, 프로덕션 의존 1개(`shared-contract`), 라이프사이클 훅 0(§3). +조립은 `app-bootstrap`의 책임이고, **저장소 전체 테스트 1,899개 중 배포 컴포지션 루트를 기동하는 것은 +16개(0.84%)뿐이며, 코어가 그 16개에 하나도 없는 것은 결함이 아니라 계약 준수다** — +코어는 Spring을 몰라야 하고, 실제로 모른다. +따라서 §H5(캐시 엔진·리스 워치독이 조립되지 않음)와 §H7(16클래스 테스트 0)은 +**"조합 검증이 없다"는 문제가 아니라 "부품 검증조차 없다"와 "app-bootstrap이 배선하지 않았다"는 +두 개의 서로 다른 문제**다. 이 구분이 없으면 잘못된 처방(코어에 Spring 테스트 추가)으로 간다. + +**Spring 문자열이 나오는 2곳은 오히려 반대 증거다** — 둘 다 금지 타입 denylist의 리터럴이다: +`objectstorage/ObjectStorageArchitectureContractTest.java:32` `"org.springframework."`, +`fileserver/api/content/ContentStoreApiArchitectureTest.java:19-20` `"org.springframework.core.io.Resource"`. + +**테스트가 실제로 무엇을 잡는가 — 이름이 곧 명세다:** +``` +randomGraphsCollideOnlyWhenEqual (속성 기반 2,000회, 고정 시드) +mutatingANestedValueAfterConstructionChangesNothing (방어 복사) +framingCharactersCannotBeSmuggled (길이 프레이밍 위조) +twoSpellingsOfOneInstantAreOneEvent (Z vs +02:00) +theFingerprintDependsOnTheEvent (구 구현의 정의적 성질을 테스트로 고정) +sentAfterDeliveredDoesNotDowngrade (순서 뒤바뀐 콜백) +hardBounceIsTerminalAgainstALaterDeliveryEvent +ambiguousWithStatusQueryReconcilesInsteadOfResending +pausedWriterCannotCommitAfterLeaseTakeover +aWriterCannotTakeALeaseOnAnUploadCleanupHasClaimed +legacyMarkPublishedFailureLeavesInFlightAndDuplicatePossibleCharacterization +tenThousandCategoriesProduceABoundedNumberOfSeries (카디널리티 폭발) +theRefusalMessageDoesNotRepeatTheValue (거부 메시지의 유출) +aRejectedAttachmentIsClosedRatherThanLeaked +aFailureToCloseDoesNotMaskTheIntegrityFailure +theTestActuallyScansSomething (공허통과 가드) +``` + +**fake 키트가 스스로 한계를 선언한다 — 이게 이 Keep의 핵심 증거다.** +`fileserver/testkit/DirectTransactions.java:11-15`: +> "The fake stores in this package are in-memory maps with no rollback, **so this cannot prove that a +> failed unit undoes its writes — that is what the real-PostgreSQL readiness suite is for.** +> What it does prove is the part unit tests can: that a service opens a boundary at all, and how many." + +`InMemoryFileMetadataStore.java:82-85`는 과거에 fake와 어댑터가 갈라져 +"a caller could pass every unit test and fail against a database"였던 사건을 기록하고 같은 상태기계를 강제한다. +`InMemoryCleanupQueue.java:16-18`은 리스 펜싱을 **가짜로 만들기를 거부한다** — +"a fake that pretends to have it would report success for a guarantee only real PostgreSQL can give". + +**즉 이 저장소의 fake는 "못 하는 것을 못 한다고 코드에 써 둔" fake다.** 이것이 Mockito 부재보다 훨씬 강한 신호다. +(같은 문장이 §H1의 한계도 설명한다: `DirectTransactions.inWrite`는 인라인 실행 + "write" 기록이므로 +단위 테스트가 롤백-only 보상 위험을 **구조적으로** 잡을 수 없다. 키트가 그렇게 말하고 있다.) + +**공허통과 방어**: 동적 패키지 스캔을 하는 테스트는 2개뿐이고(`PublicApiIsTypedTest`, +`ObjectStorageArchitectureContractTest`) 둘 다 vacuity guard를 갖고 있다(`hasSizeGreaterThan(10)`). +나머지 구조 검증은 명시적 클래스 리터럴을 쓰므로 공허통과가 불가능하다(빠지면 컴파일 에러). + +**언제 재검토**: port 하나가 메서드 8개를 넘어 fake 작성 비용이 실제 문제가 될 때. +그때도 답은 Mockito가 아니라 port 분할이다. +**단, §H7의 16클래스 2,045줄은 이 Keep의 예외이며 거기부터 메워야 한다 — 부품 검증으로.** + +### K2. `shared-contract`의 "Java stdlib only"는 선언이 아니라 사실이다 +`build.gradle:8-9` 빈 `dependencies { }`, main 54파일 import 전수 `java.*` 외 0건. +대가는 `RuntimeEnvironment.java:30-34` 주석이 정확히 계산해 뒀다 — +*"callers pass `List.of(environment.getActiveProfiles())` instead. That is not a workaround: it keeps +the vocabulary ... usable from the `EnvironmentPostProcessor` phase, **where no application context +exists yet**."* `MasterSwitchParser.java:9-11`도 같은 이유다. +**이 제약이 "판정이 런타임에, 컨텍스트 이전에 이루어져야 한다"는 핵심 설계 목표를 물리적으로 가능하게 만든다.** +**언제 재검토**: 부팅 이전 판정이 필요 없어졌을 때. 사실상 없다. + +### K3. `domain-core`가 비어 있는 것 — 템플릿으로서 정확히 옳다 +세 가지 근거로 "미완성"이 아니라 "의도된 빈칸"이다. +1. `domain-core/README.md`가 `ResourceId`를 `sealed`로 닫지 **않은** 이유를 설명한다 — + `permits WorkLogId`를 쓰면 `domain-core`가 `sample-portfolio`를 의존하게 되고 + `production_code_does_not_depend_on_sample_portfolio` 규칙 위반이다. **비워두기 위해 타입 설계를 양보했다.** +2. 잃은 보장을 빌드 타임 규칙 `no_long_id_pk`로 대체했다. 포기가 아니라 이동이다. +3. 네이밍 규칙 대신 마커 애너테이션을 쓴 것은 fork 사용자가 **선언적으로 옵트인**하게 만든다. +**언제 재검토**: 파생 서비스가 2개 이상 생겨 공통 도메인 개념(TenantId, Money)이 실제로 중복될 때. + +### K4. "모름(indeterminate)"을 타입으로 표현 가능하게 유지한 결과 대수 +같은 원칙이 8곳에 일관 적용돼 있다: +`transaction/TransactionResult.java:48-67` `Indeterminate` · +`transaction/CompletionResolution.java:19-20` `STILL_UNKNOWN` · +`outbox/OutboxPublishOutcome.java:30-36` `AMBIGUOUS` · +`shared/ratelimit/RateLimitOutcome` `Indeterminate`/`Unavailable`/`Incompatible` · +`lease/LeaseAcquireOutcome.java:43` · `idempotency/v2/IdempotencyClaimOutcome.java:66` · +`objectstorage/model/ObjectMutationOutcome.java:9` · +**(신규 확인)** `notification/platform/provider/EvidenceFact.java:11-20` — +`EvidenceCertainty {PROVEN, INFERRED, UNKNOWN}`와 `"an unknown fact cannot be asserted as true"` 불변식, +그리고 `ProviderExecutionEvidence.responseLost()`가 4개 사실을 각각의 확실성과 함께 기록한다. + +`CompletionResolution.java:7-9`가 이유를 요약한다 — *"Forcing a binary result would push the resolver +into guessing, and a wrong guess either duplicates a payment or loses one."* +`OutboxPublishOutcome.java:12-23`은 구체적 함정까지 적어놨다: 레거시 `OutboxEventStatus.FAILED`는 +**재시도 가능**이고 플랫폼 `OutboxStatus.FAILED`는 **확정 거부**라서 이름으로 매핑하면 의미가 뒤집힌다. +**언제 재검토**: 하지 않는다. 오히려 §H1이 이 원칙을 트랜잭션 **경계**에서만 안 지킨 사례다. + +### K5. `objectstorage` · `realtime` · `notification/platform/provider`의 port 설계 +- `objectstorage/**` 88파일이 벤더 타입 0개로 stage→verify→finalize + direct/multipart + scan + purge를 표현한다. + 식별자 6종이 전부 오퍼크이고 `ObjectIdentitySupport.java:82-88`에서 **체크섬 검증**까지 한다. + `toString()`이 전부 `redactedLogToken()`이라 로그 유출이 구조적으로 불가능하다. + `ObjectPurgeMaintenancePort.java:6-9` — *"must never be injected into normal business use cases"* — + 권한 분리를 **주입 그래프로** 강제한다. +- `realtime/**`이 `EphemeralFanoutPort`(best-effort)와 `DurableFanoutPort`(at-least-once)를 **이름으로** 분리하고, + 각 Javadoc이 "반대로 쓰면 무엇이 깨지는지"를 적는다. +- **(신규)** `provider/NotificationProviderAdapter.java:11-12` — + *"The asynchronous type is `CompletionStage` so that no reactive library leaks into the core contract"*. + `provider/ProviderSubmission.java:55-97`은 채널·프로필·렌더링된 콘텐츠 3자 정합을 **생성자에서** 강제한다 + (*"a test could construct one that no real dispatch would ever produce — which is how an adapter suite + comes to pass against a shape the platform cannot emit"*). +**언제 재검토**: 하지 않는다. `fileserver`를 이 기준에 맞추는 게 C1의 수정 방향이다. + +### K6. `application-core`가 설정을 읽지 않고 스스로 등록하지 않는 것 +main 890파일에 `System.getenv` 0, `@Value` 0, `@Component`/`@Service`/`@Bean` 0, `@ConditionalOn*` 0. +정책 값은 전부 생성자로 들어온다(`DownloadPolicy`, `UploadPolicy`, `TransferAdmissionProperties`, +`CacheAsidePolicy`, `RateLimitPolicy`, `CallbackLimits`, `RangeBudget`, `NotificationKindPolicy`, +`RetryBackoff`, `RetryBudget`). 그리고 각 record가 생성자에서 경계를 검증한다 +(`TransferAdmissionProperties.java:17-27`이 `0 < soft < hard <= 1`을 강제). +**이게 §3의 토글 판정이 깨끗하게 나온 유일한 이유다.** 코어가 프로퍼티를 한 번이라도 읽으면 +기술을 꺼도 그 프로퍼티는 여전히 필수가 된다. **언제 재검토**: 하지 않는다. + +### K7. R1과 platform 네임스페이스가 서로를 모르게 강제한 규칙 +`ApplicationBoundaryArchitectureTest.java:109-126`, 예외는 +`dev.caskeleton.application.notification.compatibility.r1` 한 패키지뿐. +`because` 문구가 이유를 정확히 말한다 — 두 모델이 같은 단순명을 갖고 있어서 +*"a new consumer picks one by import order and the two models drift apart while both claim to be current."* +예외를 한 패키지로 못 박은 것도 옳다: *"an exception in several places is not an exception, it is the +second canonical model the ADR exists to prevent."* +**언제 재검토**: R1의 마지막 프로덕션 소비자가 사라졌을 때. 현재 R1은 살아 있다 — +`adapter/outbound/notification/.../RoutingNotifier.java`가 R1 `NotificationPort`를 구현한다. + +### K8. 미커밋 `testFixtures` 계약 키트 — 방향이 맞다 +`application-core/build.gradle:2-3` + `src/testFixtures/.../outbox/testkit/LegacyOutboxAppendContract.java`, +소비자는 `adapter/outbound/persistence-jpa/build.gradle:75`. +파일 주석 14-16행 — *"expressed only in application-owned types ... No Spring, JPA, SQL, or provider type"* — +이 실제로 지켜진다(import가 `LegacyOutboxAppendPort`, `NewOutboxEvent`, `TransactionPort`, `java.*`뿐). +**계약 소유자가 검증 키트를 제공하고 구현자가 통과를 증명하는** 구조는 어댑터마다 다시 쓰는 것보다 낫다. +특히 `verifyRollbackRemovesEvent`는 §H1이 지적한 트랜잭션 경계 문제와 같은 종류를 검사한다. +**언제 재검토**: 하지 않는다. 오히려 구현이 2개 이상인 port(`IdempotencyStorePortV2`는 PostgreSQL과 Redis +두 구현이 각자 테스트를 쓴다, `InboxStorePort`, `CacheRegionPort`)로 확대해야 한다. + +--- + +## 7. 커밋 안 된 리팩토링이 이 영역에 미친 영향 + +**결론: 이 영역에서 안전망을 자른 것은 없다. 전부 순증이고 변경은 4건뿐이다.** + +`diffstat.txt` 전체는 `224 files changed, +2,374 / −22,532`지만 내 3개 leaf에 닿은 줄은: +``` +src/application-core/CLAUDE.md | 1 + +src/application-core/build.gradle | 1 + +src/application-core/gradle.lockfile | 42 +- +``` +untracked 3건: `outbound/SecretSourcePort.java`, `src/test/.../testsupport/`, `src/testFixtures/`. + +**−22,532줄 삭제는 전부 내 영역 바깥**(app-bootstrap 테스트킷 IT, `application-test.yml` 195줄, +openapi 스냅샷 523줄 등)이며, **`domain-core`와 `shared-contract`는 한 줄도 바뀌지 않았다.** + +| 변경 | 없어진 것 | 판정 | +|---|---|---| +| `java-test-fixtures` + `LegacyOutboxAppendContract` | 없음 | **개선** (§K8) | +| `SecretSourcePort` 신규 + CLAUDE.md 1행 | 없음 | **개선.** 배선 완결 — `adapter/outbound/support/EnvironmentSecretSource`가 구현, `bootstrap/runtime/SecretSourceFactory.java:15`가 전략 선택. 코어는 백엔드를 모른다 | +| 아키텍처 테스트 2개 → `testsupport/CompiledPackageScanner` 추출 | **삭제된 보장 없음.** 기존 classes-디렉터리 스캔이 그대로 옮겨졌고 **JAR 스캔 경로가 추가**됐다(`CompiledPackageScanner.java:25-27,56-`) | **개선.** 원래 코드에 있던 "test output 루트를 가리키면 스윕이 0건이 되고 통과"하는 함정이 한 곳에 모였고, `PublicApiIsTypedTest.theTestActuallyScansSomething`이 그 가드다 | +| `gradle.lockfile` +42 | 없음 | 기계 생성 | + +**단 §H2** — 그 추출 과정에서 import 정렬이 깨졌다. 리팩토링이 아직 안 끝났다는 신호다. + +**교차 확인 필요**: 영역 밖에서 삭제된 `application-test.yml`(195줄)과 openapi 스냅샷(523줄). +`application-core` 테스트는 Spring 컨텍스트를 0건 쓰므로 무관하다고 보는 게 합리적이지만, +확정은 `app-bootstrap` 담당이 해야 한다. + +--- + +## 8. 템플릿 사용자 관점 + +### 손대야 하는 파일 (예상보다 적다 — 좋은 소식) +1. `src/domain-core/.../domain/` 아래에 자기 애그리거트를 **처음부터** 쓴다. + `@AggregateRoot`/`@ValueObject`/`@DomainEvent`를 붙이면 `app-bootstrap` ArchUnit이 불변식을 강제해준다. +2. `sample-portfolio`를 통째로 지운다(production이 의존하지 않으므로 안전). +3. `application-core`에 자기 유스케이스 패키지를 만든다. 따라 쓸 canonical 예시는 + `application-core/CLAUDE.md:139-161`, 실제 코드로는 `outbox/PublishPendingOutboxEventsUseCase.java` + (`@RequiresPermission` + `@UseCaseCapability` + `tx.inWrite`가 전부 등장). + +### 밟게 될 지뢰 (심각한 순서) +1. **`application-core`를 열면 890개 파일을 마주한다.** 자기 유스케이스와 관련 있는 건 + `usecase`/`command`/`query`/`capability`/`transaction`/`security` 60파일 1,300줄이고, + 나머지 830파일 34,600줄은 알림·파일·스토리지 플랫폼이다. 그런데 `CLAUDE.md:56-74`의 안내 표는 + `notification`/`fileserver`/`objectstorage`를 **언급하지 않는다.** → §H4 +2. **알림을 보내려는 순간 `Channel` 세 개 중 하나를 골라야 한다.** → §M2 +3. **키 없이 알림을 보내면 멱등이 되지 않는다.** `AcceptNotificationCommand.idempotencyKey`를 비우면 + JVM 재시작·다른 파드에서 다른 키가 나와 중복 발송된다. → §H8 +4. **파일 다운로드 유스케이스를 쓰면 코어에서 HTTP 상태 코드를 반환하게 된다.** → §C1 +5. **보상 트랜잭션을 `inWrite`로 쓰는 예시를 그대로 따라 한다.** 저장소 안의 보상 쓰기 2곳이 전부 + `inWrite`라 관례처럼 보이고, `CLAUDE.md:173`이 권하는 `inNew`는 프로덕션 예시가 0개다. → §H1 +6. **인가를 4번 구현한다.** → §M3 +7. **캐시-어사이드를 배선하면 저장소 최초의 통합 사용자가 된다.** → §H5 +8. **알림 런타임을 커스터마이즈하면 테스트 없는 2,000줄을 만진다.** → §H7 + +### 좋은 소식 +- 테스트를 쓸 때 Mockito를 설치할 필요가 없다. `fileserver/testkit`에만 in-memory fake 19개가 있어 + 베끼기 좋다. 905개 테스트가 전부 이 스타일이다. +- `shared-contract`는 그대로 쓰면 된다. `OperationalError` 51개 코드가 도메인 코드를 추가할 자리 + (`ApiErrorCode` 구현)까지 열어놨다. +- `TransactionPort` 4개 메서드만 이해하면 트랜잭션 경계는 끝난다. +- `objectstorage`/`realtime`/`provider` 패키지는 port를 어떻게 설계해야 하는지에 대한 + 이 저장소 최고의 교재다(§K5). + +--- + +## 9. 미확인 / 가정 + +### 초판에서 해소된 것 +- ~~`SpringTransactionPort.inWrite`의 propagation~~ → **확정**: `SpringTransactionPort.java:116` `PROPAGATION_REQUIRED` (§H1) +- ~~Spotless `importOrder()` 동작~~ → **설정 확정**: `QualityConventionsPlugin.java:49` 무인자 호출 (§H2) +- ~~`ReconciliationService`가 고아 DISPATCHING 행을 회수하는가~~ → **확정: 회수하지 않는다** (§M12) +- ~~C1/C2가 국소 결함인가 구조인가~~ → **확정: 28타입 2,347줄 + 그것을 정답으로 고정하는 테스트 7파일 64개** (§C1) +- ~~main·test 미독분~~ → **3차에서 전부 해소. 1,116/1,116 전문 독파** (§1) +- ~~테스트가 진짜 계약을 잡는가~~ → **확정: 잡는다(663개 전수 분류). 단 16클래스 2,045줄은 참조 그래프상 도달 불가** (§K1, §H7) + +### 빌드 미실행으로 남은 미검증 + +| 주장 | 확인 명령 | +|---|---| +| §H2가 실제로 `check`를 깬다 | `cd src && ./gradlew :application-core:spotlessCheck --console=plain` | +| 미커밋 변경 포함 전체 컴파일 | `cd src && ./gradlew :application-core:check --console=plain` | +| 보조 소스셋이 실제로 돈다 | `cd src && ./gradlew :shared-contract:edgeRateLimitContractTest --console=plain` | +| ArchUnit이 C1/C2/H6를 통과시킨다(=가드가 못 잡는다) | `cd src && ./gradlew :app-bootstrap:test --tests '*ApplicationBoundaryArchitectureTest' --console=plain` | +| `testFixtures`가 consumer에서 해석된다 | `cd src && ./gradlew :adapter:outbound:persistence-jpa:compilePostgresqlIntegrationTestJava --console=plain` | + +### 남은 가정 + +1. **`Enum.hashCode()`가 identity hash라는 것**(§H8의 핵심)은 `java.lang.Enum`의 명세다 + (`public final int hashCode() { return super.hashCode(); }`). 다만 **실제로 두 JVM에서 값이 달라지는지는 + 실행으로 확인하지 못했다.** 확인 방법: `derivedKey`와 동등한 계산을 하는 테스트를 JVM 두 번 돌려 비교. + `[3차 보강]` `command.variables()`는 `Map`(값 기반 record 대수)임을 + 소스로 확인했으므로 **불안정 원소는 `channel` enum 하나로 좁혀졌다.** record의 `hashCode`는 JLS가 + 알고리즘을 고정하지 않지만 구성요소가 `String`/`BigDecimal`/`boolean`이라 실무상 안정적이다. +2. ~~**§H7의 "테스트 참조 0"은 이름 기반 grep**~~ → **3차에서 해소.** main 887타입 참조 그래프를 + 만들어 전이 도달성으로 전수 판정했고(씨앗 640 → 확장 → 미도달 185), 그 과정에서 + `SensitiveValueDetector`·`GsmAlphabet` 등 **간접 커버되던 타입이 목록에서 빠졌다**. 남은 가정은 + "정적 참조가 없으면 실행도 없다"이며, 이 코드베이스에는 리플렉션 인스턴스화·SPI(`ServiceLoader`)· + DI 컨테이너가 없으므로(§3) 성립한다. 반증 방법: JaCoCo로 `:application-core:test` 커버리지를 내고 + 16개 클래스의 라인 커버리지가 0인지 확인. +3. **`modules.json`의 `allowed_dependencies`를 "허용"으로 해석**했다. Gradle 게이트가 "선언된 간선은 + 반드시 존재해야 한다"고 검사한다면 §H3의 판정이 바뀐다. 확인: `src/build.gradle`의 + `verifyCleanArchitectureDependencies`. +4. **`application-test.yml` 삭제가 `application-core` 테스트에 무관**하다고 가정(Spring 컨텍스트 0건 근거). + +### 다른 영역 담당자에게 넘기는 교차 이슈 + +1. **(아키텍처/bootstrap)** `APPLICATION_METHODS_DO_NOT_ACCEPT_WEB_DTOS`를 패키지 위치 기반 → + **형태 기반**(파라미터가 `httpMethod`/`Map> headers`/`byte[] body` 필드를 갖는가)으로 + 바꿔야 §C2가 재발하지 않는다. 같은 이유로 `PublicApiIsTypedTest`의 스캔 대상을 `...platform.api`에서 + 퍼사드 4개 패키지까지 넓혀야 §H6이 막힌다. +2. **(persistence)** §H1 확정됨 — `DefaultFinalizeUploadService.java:321`과 + `DefaultUploadApplicationService.java:154`를 `inNew`로 바꾸는 변경에 동의가 필요하다. +3. **(bootstrap/설정)** §M4 `app.messaging.enabled` / `backend.graphql.enabled`가 `ca-skeleton.*` 트리 밖이다. + `docs/registries/env-keys.yaml`과 `config/*.yml` 대조 필요. +4. **(inbound web 어댑터)** §C1/§C2 수정 시 `CallbackRequestFactory`, + `NotificationCallbackMvcController`, 파일서버 MVC/WebFlux 컨트롤러가 함께 움직여야 한다. +5. **(notification 어댑터 + QA)** §H7의 16클래스 2,045줄에 테스트를 붙이는 작업. + §H8·§H9·§M12가 전부 그 안에 있으므로 우선순위가 가장 높다. diff --git a/docs/reviews/2026-09-18-techlead-review/02-inbound-web.md b/docs/reviews/2026-09-18-techlead-review/02-inbound-web.md new file mode 100644 index 00000000..ed4c8be7 --- /dev/null +++ b/docs/reviews/2026-09-18-techlead-review/02-inbound-web.md @@ -0,0 +1,1650 @@ +# [영역] inbound HTTP (adapter:inbound:web) 리뷰 + +- 스냅샷: 2026-09-18T11:50Z / HEAD 60b6a319 + 커밋 안 된 변경 + - tracked: 224파일 (+2,374 / −22,532) — `full.diff` + - untracked: 175파일 (+21,270) — `untracked-files.txt` / `untracked-wc.txt` + - **실제 순증감 ≈ +1,112.** `git diff HEAD`는 untracked를 담지 않으므로 diff의 −22,532는 + 대부분 "삭제"가 아니라 "이동"이다. 이 영역에서 그 사실을 파일 단위로 대조 검증했다(§7). +- 담당 leaf: `adapter-inbound-web` (`:adapter:inbound:web`, `src/adapter/inbound/web`) + - `modules.json` allowed_dependencies: `domain-core`, `application-core`, `shared-contract` + +--- + +## 0. 최종 적용 기준 + +request-id, forwarded-header, rate-limit key, route prefix, ObjectMapper, startup-validator, 실제 filter-chain +조립 문제는 채택한다. Web이 Build Composition에서 선택된 주 transport라면 별도 runtime master toggle은 +필수 요구가 아니다. fixture 계약과 실제 production composition 계약을 분리한다. +Tomcat/Jetty/WebFlux/Nginx처럼 classpath/runtime가 다른 레인은 유지할 수 있다. + +## 0-A. 2026-09-21 중간 재검증 + +**상태: request-id trust 충돌은 해결된 것으로 재검증했다.** + +`RequestLoggingFilter`는 이제 `X-Request-Id`를 다시 읽어 독자적인 trust 결정을 하지 않고 +`WebRequestId.REQUEST_ATTRIBUTE`에 이미 할당된 값을 사용한다. `WebMvcRequestIdFilter`의 기본값은 +`trustInboundRequestId=false`이며, `usesTheRequestIdAlreadyAssignedByTheMvcRequestIdFilter`가 +caller가 제안한 ID와 실제 MDC/response ID가 다름을 검증한다. + +이번 focused regression에서 `:adapter:inbound:web:test`도 PASS했다. + +따라서 원 리뷰의 “서로 다른 두 필터가 반대 trust policy를 동시에 가진다”는 finding은 **현재 코드에서 +해소됨**으로 본다. Forwarded-header/rate-limit/external URI 전체 배포 조합은 별도 system/composition +lane 범위이므로 이 중간 점검에서 완료 판정하지 않는다. + +## 1. 커버리지 + +leaf 전체 파일 **636개**. 소스셋별 내역: + +| 소스셋 | 파일 | Java | 읽음 | +|---|---:|---:|---| +| `main` | 400 | 397 | **397개 전문** | +| `test` | 141 | 139 | **139개 전문** (테스트 클래스 126 + `@Test` 없는 헬퍼·픽스처 13). 분류는 §1.1 | +| `testFixtures` | 55 | 53 | **53개 전문** (5,181줄) + `application-web-contract.yaml`·`performance/web-load-profile.yaml` | +| `jettyCompatTest` | 8 | 8 | **8개 전문** (291줄) | +| `webfluxContractTest` | 15 | 15 | **15개 전문** (916줄) | +| `nginxProxyTest` | 5 | 3 | **5개 전문** (374줄 — Java 3 + `nginx.conf` + `proxy_headers.conf`) | +| `performanceTest` | 1 | 1 | 전문 | +| `systemTest` | 7 | 7 | 전문 | +| leaf 루트 | 4 | — | `build.gradle`, `CLAUDE.md` 전문 / **`README.md`(35KB)와 `gradle.lockfile`은 읽지 않았다** | + +**읽지 않은 2개와 그 이유.** + +- `gradle.lockfile` — 의존 버전 잠금 파일이고, 버전·의존은 브리프가 다른 에이전트 담당으로 + 지정한 범위다. 이 리뷰의 어떤 판정도 잠긴 버전 문자열에 의존하지 않는다. +- `README.md`(35KB) — 목차와 prefix·sort·에러계약 관련 절만 읽었다. 문서와 코드가 어긋날 때 + **코드가 사실**이라는 것이 이 리뷰의 규칙이므로, README 전문은 판정을 바꾸지 못하고 + "문서에 이렇게 적혀 있다"는 근거를 더 쌓을 뿐이다. 이미 §5 C2·H4·M6·M7에서 문서-코드 + 불일치를 코드 쪽에서 확정했다. 다만 **fork 사용자 관점(§8) 판정은 README 전문을 읽으면 + 더 정확해질 수 있다**는 점은 유보로 남긴다. + +leaf 밖에서 추가로 읽은 것: `src/build.gradle`, `src/config/architecture/modules.json`, +`src/app-bootstrap/src/main/resources/application.yml` + `config/*.yml` 15개, +`src/app-bootstrap/src/main/java/.../CaSkeletonApplication.java`, +`.../autoconfigure/fileserver/*`, `src/build-logic`의 `StrictTestLanePlugin`· +`AuxiliarySourceSetExtension`·`JavaConventionsPlugin`·`SpringLibraryConventionPlugin`, +`app-bootstrap/src/architectureTest`의 경계 규칙 4개, +`docs/registries/{error-codes,headers}.yaml`, `docs/fileserver/http-contract.md`, +`docs/superpowers/specs/2026-09-18-test-architecture-phase2-provider-ownership.md`, +`.github/workflows/*.yml`. + +리소스 3종(`AutoConfiguration.imports`, `problem-catalog.yaml`, `wire-type-manifest.yaml`)과 +`testFixtures/resources/application-web-contract.yaml`은 전문 열람. + +**초판에서 상단만 읽었던 main 44파일(3,793줄)도 전문을 읽었다** — +`fileserver/reactive/*` 10, `advanced/stream/**` 24, `advanced/webflux/*` 7, +`advanced/openapi/*` 5, `advanced/functional/*` 4, `webflux/budget/*` 2, +`webflux/operation/ReactiveOperationHttpController`. 그 결과 바뀐 것: + +- **바뀌지 않은 판정**: 이 패키지들이 컴포지션 루트에서 도달 불가라는 §2·§5 M1의 결론. + 이번에 전문을 읽은 44파일 중 Spring 애너테이션을 가진 것은 + `fileserver/reactive/FileserverReactiveConfiguration` 하나뿐이고, 그것도 + `@ConditionalOnWebApplication(REACTIVE)`로 서블릿 배포에서는 꺼진다. + (`advanced/**` 전체에서 Spring 애너테이션을 가진 파일은 `advanced/mvc/*` 3개뿐 — + `MvcStreamingExecutorConfiguration`, `VirtualThreadMvcConfiguration`, `VirtualThreadSettings`. + 나머지 75개는 순수 라이브러리다.) +- **바로잡은 것 1 — 의존 방향 의심 해소.** `advanced/stream/replay/MessagingReplayBridge.java:4-6`은 + `LiveEventReplayPort`·`ReplayCursorUnavailableException`·`ReplayWindow`를 임포트하는데, + 이름만 보면 `messaging:*` 의존처럼 보인다. 실제 패키지는 + **`dev.caskeleton.application.realtime`**(application-core)이다. `modules.json` 위반 아님. + §4의 "의존 방향 OK" 판정 유지. +- **바로잡은 것 2 — 리액티브 fileserver는 진짜 조건부 `@Configuration`이다.** + `fileserver/reactive/FileserverReactiveConfiguration.java:1-20`이 + `@ConditionalOnWebApplication(REACTIVE)` + `@ConditionalOnProperty(app.fileserver-platform.enabled=true)`로 + 빈 7개를 만든다. 서블릿 배포에서는 첫 조건에서 꺼진다. 초판이 "미도달"로 뭉갠 것보다 + 정확하게는 **"조건부로 꺼져 있다"**이고, 이건 올바른 설계다. +- **새로 확인한 것 — `addPathPrefix`는 RouterFunction에 붙지 않는다.** + `FileserverRouterFactory.routes():18-25`는 `/v1/files...`를 RouterFunctions로 등록한다. + `PresentationWebConfig`의 `addPathPrefix`는 **애너테이션 컨트롤러 매핑에만** 적용되므로, + 리액티브 배포에서는 fileserver 라우트에 prefix가 붙지 않고 애너테이션 컨트롤러에는 붙는다. + §5 H4의 이중 prefix 문제는 서블릿 배포의 문제이고, 리액티브 배포에서는 **같은 애플리케이션 안에서 + 두 라우트 집합의 prefix 규칙이 달라지는** 다른 모양의 문제가 된다. + +빌드는 실행하지 않았다(스냅샷에 Gradle wrapper jar 없음). 빌드로만 확정되는 항목은 §9에 모았다. + +--- + +### 1.1 테스트 139개를 "부품 검증"과 "조합/배선 검증"으로 가른 결과 + +스냅샷 `src/test/java` 139파일을 전부 읽고 기계적으로 분류했다. 기준은 하나다 — +**Spring 컨텍스트나 MockMvc/WebTestClient 같은 조립 장치가 등장하는가.** + +| 분류 | 파일 | 내용 | +|---|---:|---| +| 헬퍼·픽스처 (`@Test` 없음) | 13 | `fileserver/testkit/*` 8, `moduleboundary/{WebBuildModel,WebSourceGraph}`, `fixtures/badcontroller/*` 2, `idempotency/InMemoryIdempotencyStore` | +| **부품 검증** (Spring 없음. `new X(...)` 후 단언) | **100** | 테스트 클래스 126개 중 **79%** | +| **조합 장치를 쓰는 검증** | **26** | 아래 내역 | + +조합 26개 내역 (3개는 ContextRunner와 standaloneSetup을 둘 다 써서 중복 계상): + +| 형태 | 파일 | 배포 컨텍스트를 재현하는가 | +|---|---:|---| +| `*ContextRunner` | 13 | **아니오.** 13개 전부 설정 클래스를 손으로 주입한다 — `withUserConfiguration(...)` 11개, `withConfiguration(AutoConfigurations.of(...))` 4개(2개 중복) | +| `MockMvcBuilders.standaloneSetup(...)` | 12 | **아니오.** 컨트롤러·어드바이스·필터를 `new`로 만들어 손으로 끼운다 | +| `WebTestClient.bindToRouterFunction(...)` | 1 | 아니오. 라우터를 손으로 만든다 (`fileserver/reactive/ReactiveFileserverContractTest`) | +| `@WebMvcTest` | 2 | 부분. `@Import`로 나열한 것만 올라온다. `envelope/EnvelopeBodyAdviceTest`는 `excludeAutoConfiguration = SecurityAutoConfiguration` + `@AutoConfigureMockMvc(addFilters = false)` | +| ArchUnit (`ClassFileImporter`) | 1 | 해당 없음(바이트코드 정적 분석) | +| `@SpringBootTest` | **0** | 스냅샷 `src/test`에 한 건도 없다 | + +**핵심 수치: 테스트 클래스 126개 중 "배포 컨텍스트가 무엇을 조립했는가"를 묻는 것이 0개다.** + +- `src/test`의 `@SpringBootTest`는 0건이다. 8건은 §7에서 본 대로 `systemTest`/`performanceTest`로 + 옮겨갔다. +- 그 8건을 포함해 보조 소스셋 5개(`systemTest`·`performanceTest`·`jettyCompatTest`· + `webfluxContractTest`·`nginxProxyTest`)의 `@SpringBootTest` 26건은 **전부 픽스처 애플리케이션**을 + 띄운다 — `ContractFixtureApplication` 10, `ReactiveContractFixtureApplication` 5, + 나머지는 `Budget`/`Throttle`/`PipelineOrder`/`Proxy`/`Sse` 픽스처. 본문까지 읽고 확정한 + 내용은 §1.2에 있다. +- **이 leaf 전체(main·test·testFixtures·보조 소스셋)에서 `CaSkeletonApplication`을 언급하는 파일은 + 0개다** (`grep -rn 'CaSkeletonApplication' src/adapter/inbound/web/src` → 0건). +- 그리고 픽스처가 그렇게 만들어진 이유는 추측이 아니라 **주석에 적혀 있다.** + `testFixtures/.../webtestkit/ContractFixtureApplication.java:19-22`: + + > "No component scan. Scanning would pull in whatever else this leaf ships — the security chain, + > the file server, the notification callbacks — and the gate would then be testing the sum of + > them rather than the status contract." + + 실제 컴포지션을 **의도적으로** 피한 것이다. 게이트 설계로는 타당하다(§6 K5). 문제는 + 그 반대편, 즉 "실제 컴포지션이 무엇을 조립했는가"를 보는 테스트가 **한 개도 없다**는 것이다. + (`@EnableAutoConfiguration`은 살아 있으므로 `AutoConfiguration.imports`에 등록된 + `WebMvcPlatformAutoConfiguration`/`WebFluxPlatformAutoConfiguration` 2개는 픽스처에도 올라온다. + 그 파일에 없는 나머지 — 보안 체인, 레이트리밋, 멱등성, fileserver 전송 — 는 올라오지 않는다.) + +**이 분포가 §5의 H2·H3·H4·H6을 설명한다.** 그 넷은 전부 "클래스는 있는데 배포 경로에 연결돼 +있지 않다" 한 가지 형태다. + +- 부품 검증 100개는 대상을 `new`로 만들어 부르므로, 원리적으로 **"아무도 이걸 안 부른다"를 관측할 + 수 없다.** 오히려 대상이 정상 동작한다는 증거를 쌓아 미배선을 가린다. +- 조합 26개는 설정 클래스를 **이름으로 지정해서** 올리므로 **"배포 컨텍스트가 이 설정을 찾는가"를 + 물을 수 없다.** + +25,029줄 테스트가 전부 통과하면서 미배선이 남아 있는 것은 모순이 아니라 이 분포의 당연한 결과다. + +**공정하게 적어야 할 예외 3개.** 진짜 필터 체인을 조립해 검증하는 테스트가 있다 — +`auth/CorsSecurityFilterIntegrationTest`(`@Tag("security-boundary")`), +`auth/SecurityModeWebContractTest`, `auth/JwtJwksSecurityFilterIntegrationTest`. +셋 다 `WebApplicationContextRunner.withUserConfiguration(PropertiesConfig.class, SecurityConfig.class)`로 +컨텍스트를 올린 뒤 `context.getBean("springSecurityFilterChain", Filter.class)`를 꺼내 +`MockMvcBuilders.standaloneSetup(new ProbeController()).addFilters(...)`에 끼운다. +`JwtJwks...`는 실제 임베디드 OIDC 서버(`OidcServer.available()`/`jwksUnavailable()`/ +`misconfiguredDiscovery()`)까지 띄워 discovery·JWKS 요청 횟수와 안전한 에러 바디를 단언한다. +**이 leaf 테스트 중 품질이 가장 높다.** 그래도 `SecurityConfig.class`를 손으로 지정하는 형태이므로 +"배포가 이 설정을 찾는가"는 여전히 묻지 못한다. + +**참고 — 부품 검증 100개가 나쁜 테스트라는 뜻은 아니다.** 읽어 보면 상당수가 이 저장소에서 +가장 잘 쓰인 테스트다. `validation/WebValidationExceptionMapperTest`(불명 예외는 추측하지 않고 +던진다), `versioning/PathApiVersionResolverTest`(`v10`은 `v1`이 아니다 / `v01`은 두 번째 철자가 +아니다), `security/WebCorsCsrfPolicyTest`(모든 credential mode가 분류되어 새 값이 기본 면제로 +떨어질 수 없다), `fileserver/reactive/DataBufferReleaseTest`(할당 수 == 해제 수)처럼 +실패 시나리오를 `as(...)`에 한 줄로 적어 둔다. 지적하는 것은 **개별 테스트의 품질이 아니라 +분포**다. + +--- + +### 1.2 보조 소스셋(Java 34 + Nginx 설정 2)과 `testFixtures` 53파일이 실제로 보증하는 것 + +§1.1의 인구조사는 `src/test` 139개만 대상이었다. "보조 소스셋의 `@SpringBootTest` 26건을 넣으면 +결론이 달라지는가"가 남은 질문이었다. **본문을 전부 읽고 확정한 답: 달라지지 않는다. 오히려 강해진다.** + +#### (a) 픽스처 애플리케이션 7개는 전부 "테스트 대상을 직접 등록"한다 + +`@SpringBootTest(classes = ...)`가 가리키는 7개를 전부 읽었다. 공통 구조는 +`@Configuration(proxyBeanMethods = false)` + `@EnableAutoConfiguration` + `@Import(픽스처컨트롤러)` ++ permit-all `SecurityFilterChain`이고, **컴포넌트 스캔이 없다.** + +| 픽스처 앱 | 이 앱이 직접 등록하는 것 | 배포에서 같은 일을 하는 주체 | +|---|---|---| +| `ContractFixtureApplication` | `WebMvcProblemExceptionHandler` + `WebProblemFactory` 빈 | **없다.** `mvc.error`는 스캔에서 빠져 있고 배포는 `GlobalExceptionHandler` + `EnvelopeBodyAdvice`를 쓴다 | +| `BudgetFixtureApplication:29-41` | `WebMvcBudgetFilter`를 `HIGHEST_PRECEDENCE`로 직접 등록 | `WebMvcPlatformAutoConfiguration` (다른 order 계산) | +| `ThrottleFixtureApplication:22-40` | `WebMvcThrottleFilter`를 URL 패턴 2개에 직접 등록 | 배포에는 throttle 필터 배선이 없다 | +| `PipelineOrderFixtureApplication` | **직접 작성한 익명 `OncePerRequestFilter` + `HandlerInterceptor`** | 프로덕션 필터는 하나도 참여하지 않는다 | +| `ProxyFixtureApplication` | `ProxyFixtureController`(그 안에서 `ForwardedHeaderSanitizer`를 `new`) | 배포는 Spring의 `ForwardedHeaderFilter`를 쓴다 (§5 H3) | +| `Reactive*FixtureApplication` 3종 | 위와 같은 구조의 WebFlux 판 | — | + +즉 **보조 소스셋의 26건은 "이 필터를 내가 이 자리에 끼우면 올바르게 동작하는가"를 검증한다. +"배포가 이 필터를 이 자리에 끼우는가"는 여전히 어디에서도 묻지 않는다.** §1.1의 결론은 +유지되고, 대상이 `src/test` 126개에서 **`src/test` 126 + 보조 26 = 152개 전부**로 넓어진다. + +#### (b) `MvcPipelineOrderIT`는 실제 파이프라인 순서를 검증하지 않는다 → §5 H7 + +가장 심각한 사례라 별도 발견으로 올렸다. §5 H7 참조. + +#### (c) `testFixtures` 53개는 픽스처인가 프로덕션 로직인가 — **픽스처다. 다만 두 가지 예외가 있다** + +53개의 성격 분포: + +| 성격 | 파일 수 | 예 | +|---|---:|---| +| 프로토콜 상수·값 타입 | 12 | `BudgetFixtureProtocol`, `WireProbe`, `WireOutcome`, `WebPipelineStage`, `FaultFixtureProtocol` | +| 픽스처 컨트롤러 (`@RestController @TestComponent`) | 9 | `ContractFixtureController`, `ThrottleFixtureController`, `ProxyFixtureController` … | +| HTTP 구동 하네스 (소켓으로 때리는 클라이언트) | 8 | `WebContractAssertions`, `HttpPipelineFixture`, `WebLoadFixture`, `HttpResponseLossFixture` | +| 추상 계약 클래스 (`@Test`를 들고 레인이 상속) | 6 | `WebPipelineOrderContract`, `IdempotencyResponseLossContract`, `WebBudgetContract`, `OperationHttpContract`, `WebThrottleHttpContract`, `WebLoadAndShutdownContract` | +| 픽스처 앱 | 4 | `webtestkit/*FixtureApplication` | +| 인메모리 스텁 스토어 | 3 | `FaultFixtureStore`, `TestDurableOperationStore`, `CountingRateLimiter` | +| **ArchUnit 규칙 팩** | **4** | `WebArchitectureRules`, `WebForbiddenTypeCatalog`, `Forbidden{Class,Method}AnnotationCondition` | +| 기타 (레코더·SSE 어댑터 래퍼 등) | 7 | `WebPipelineRecorder`, `GracefulShutdownProbe`, `WebLoadResult` | + +**예외 1 — ArchUnit 규칙 팩 4개는 사실상 프로덕션 정책이다.** `WebArchitectureRules`는 +"컨트롤러는 유스케이스 어댑터다", "애플리케이션에 전송 타입 금지", "Stable은 Advanced를 이름대지 않는다" +같은 **아키텍처 계약**을 들고 있고, 컴포지션 루트의 `WebProductionArchitectureTest`가 이걸 프로덕션 +그래프에 돌린다. 클래스 javadoc이 왜 `main`이 아니라 testkit에 있는지 직접 설명한다 — +"ArchUnit is a test library: shipping the rule pack in production would put it on every deployment +classpath to serve code that only runs in a test." **타당한 판단이다.** 그 대신 §5 C2가 지적한 +"규칙이 이름으로만 매칭해서 커버리지를 거짓 보고하는" 결함이 프로덕션 정책의 결함이 된다. + +**예외 2 — 픽스처 컨트롤러 9개가 `@RestController`를 그대로 달고 있다.** 스캔 방지는 두 겹이다: +(i) `@TestComponent`를 같이 달고, (ii) 픽스처 앱을 `dev.caskeleton.webtestkit`(스캔 루트 밖)에 둔다. +그런데 픽스처 **컨트롤러**들은 `dev.caskeleton.adapter.inbound.web.testkit.*`, 즉 **스캔 루트 안**에 +있다. 코드 주석이 위험을 정확히 적어 뒀다 — "a plain `@RestController` in this package is scanned +into the real application, publishing fixture routes in a deployment." +`testFixtures`가 배포 런타임 클래스패스에 오르지 않는 한 실현되지 않지만, **막고 있는 것이 +`@TestComponent` 애너테이션 하나뿐**이라는 뜻이다. 이건 §6에 Keep으로 적을 만큼 잘 처리된 부분이자, +동시에 fork 사용자가 `testFixtures`를 `implementation`으로 잘못 끌어오면 바로 깨지는 지점이다. + +**결론(Q4):** `testFixtures` 53개는 프로덕션 로직이 아니다. 예외는 ArchUnit 규칙 팩 4개이고, +그것은 의도적이며 이유가 코드에 적혀 있다. + +--- + +## 2. 이 영역은 무엇을 하는가 + +이 leaf는 **하나가 아니라 두 개의 서로 다른 HTTP 어댑터**를 한 소스 트리에 담고 있다. + +**(A) 실제로 배선되는 얇은 어댑터** — `CaSkeletonApplication`의 컴포넌트 스캔과 이 leaf의 +`AutoConfiguration.imports`로 컨텍스트에 들어간다. + +``` +요청 + → WebMvcRequestIdFilter (order MIN+10, @Bean) requestId/traceId 속성 부여, X-Request-Id 응답 + → CacheControlFilter (order MIN+20, @Component) no-store + Vary 고정 + → WebMvcEvidenceFilter (order MIN+20, @Bean) EvidenceTracker 부착 + → (Boot 기본 필터들) → springSecurityFilterChain (-100) SecurityConfig: JWT | redis-session + → RequestLoggingFilter (order 없음 = LOWEST, @Component) MDC 채움, X-Request-Id/Correlation-Id/traceparent 응답 + → DispatcherServlet + → RateLimitInterceptor (RateLimitWebConfig, 항상 등록) + → PresentationWebConfig 가 모든 컨트롤러에 apiBasePath prefix 부착 + → 컨트롤러 (Healthcheck / fileserver / notification / 소비 모듈) + → EnvelopeBodyAdvice (@RestControllerAdvice) 모든 JSON 바디를 {success,data,meta} 로 감쌈 + → 예외 시 FileserverExceptionHandler(@Order HIGHEST) → GlobalExceptionHandler(order 없음) +``` + +여기에 인증(`auth`), 인가(`authz` + `@RequiresPermission` 어드바이저), 설정 바인딩(`settings`), +MDC/상관관계(`observability`), 엣지 레이트리밋 브리지(`ratelimit`), Fileserver HTTP 표면 +(`fileserver`, 51파일 3,446줄), 알림 플랫폼 표면(`notification`, 16파일 1,057줄)이 붙는다. + +**(B) 배선되지 않은 "웹 플랫폼" 라이브러리** — 같은 leaf 안에 있지만 `app-bootstrap`· +`sample-portfolio` 어느 쪽에서도 참조되지 않고, 이 leaf 자신의 테스트/픽스처에서만 쓰인다. + +| 패키지 | 파일 | 줄 | 컴포지션 루트 도달 | +|---|---:|---:|---| +| `advanced/**` | 78 | 5,295 | 12개 기능 중 2개(`ndjson`, `mvc-virtual-threads`)만 `@Configuration` 존재, 기본 off | +| `mvc/**` | 15 | 1,660 | `autoconfigure`·`filter`만 등록. `mvc.error`/`mvc.budget`/`mvc.operation`은 스캔 제외 + import 하는 곳 없음 | +| `webflux/**` | 12 | 1,288 | `@ConditionalOnWebApplication(REACTIVE)` — 서블릿 배포에서 영구 비활성 | +| `pagination` | 19 | 1,230 | `PageParams`/`SortParam`/`PageValidationException`만 sample이 사용. 커서·필터·프로젝션 계열 전부 미사용 | +| `idempotency` | 9 | 775 | `IdempotencyKeySupport`(@Component)는 **아무도 주입하지 않음**. `WebIdempotencyGate` 계열은 테스트 전용 | +| `http` | 12 | 771 | `ApiHeaders`만 사용 | +| `moduleboundary` | 3 | 668 | 자기 테스트 전용 | +| `openapi` | 7 | 607 | `WebOpenApiCustomizer`는 springdoc 빈이 아니어서 생성 스펙에 반영 안 됨 | +| `operationasync` | 9 | 605 | 컨트롤러가 등록되지 않으므로 도달 불가 | +| `security` | 11 | 561 | `SecurityConfig`가 이 패키지를 전혀 쓰지 않음(자체 CORS/CSRF 구현) | +| `conditional` | 10 | 520 | `ETags`·`PreconditionFailedException`만 sample이 사용 | +| `operation` | 11 | 481 | 카탈로그 빈은 등록되지만 소비자 없음 | +| `budget` | 7 | 477 | 카탈로그 빈 등록, 집행 필터 미등록 | +| `proxy` | 4 | 421 | 미사용 (§5 H3) | +| `versioning` | 7 | 364 | 미사용 | +| `admin`·`admission`·`evidence`·`core`·`cache`·`json`·`contract`·`validation`·`cursor` | 48 | 2,684 | 대부분 미사용 | + +합계 대략 **main 27,473줄 중 16,000줄 안팎이 실행 경로에서 도달되지 않는다.** +설계 문서(`README.md`, `docs/web/repository-adaptation.md`)는 이것을 "Stable 23 모듈 + +Advanced 12 기능"이라는 제품으로 설명하지만, **현재 컴포지션 루트가 소비하는 것은 그 중 일부뿐이다.** + +이것 자체가 곧 결함은 아니다(벤더링된 라이브러리일 수 있다). 결함은 **두 세트가 서로 모순되는 +계약을 들고 있고, 둘 다 같은 leaf 안에 있으며, 어느 쪽이 정본인지 코드가 말하지 않는다**는 점이다 +(§5 C2, H1, H2). + +--- + +## 3. 런타임 토글 판정 — 꺼지면 정말 꺼지는가 + +### 3.1 이 어댑터 자체는 끌 수 없다 + +`spring-boot-starter-web`이 leaf의 `implementation`이고, `app-bootstrap`이 이 leaf를 런타임 +멤버로 가지므로 Tomcat은 항상 뜬다. 배포 단위가 HTTP 서비스 1개인 템플릿에서는 **맞는 선택**이다 +(§6 K1). 문제는 "부분 토글이 있는 것처럼 보이는데 실제로는 절반만 끈다"는 쪽이다. + +**리액티브 스택은 토글이 아니라 항상 실린다.** `build.gradle:55-56`이 +`implementation 'org.springframework:spring-webflux'`와 `implementation 'io.projectreactor:reactor-core'`를 +선언한다. `compileOnly`가 아니다. 즉 `backend.web.webflux.enabled=false`로 두어도 +**WebFlux와 Reactor는 모든 배포의 런타임 클래스패스와 fat jar에 들어간다.** +빈은 안 만들어지므로(`WebFluxPlatformAutoConfiguration`이 `@ConditionalOnWebApplication(REACTIVE)`) +런타임 비용은 거의 없지만, "꺼진 기술은 비용이 0이어야 한다"는 이 템플릿의 기준으로는 +**아티팩트 크기와 의존 표면이라는 비용이 남는다.** 같은 leaf가 CBOR/XML은 +`compileOnly`로 정확히 처리했다는 점(§6 K4)과 대비된다 — +그쪽은 "jar가 런타임에 있으면 Boot가 매퍼 빈을 만들어 버린다"는 이유까지 테스트로 고정해 뒀다. +WebFlux에 같은 논리를 적용하지 않은 이유는 코드 어디에도 적혀 있지 않다. +(`springdoc-openapi-starter-webmvc-api`도 `implementation`이라 항상 실린다.) + +### 3.2 토글 키 인벤토리 (코드에서 추출) + +| 키 | 기본값 | 정의 위치 | 실제로 무엇을 끄는가 | +|---|---|---|---| +| `backend.web.mvc.enabled` | **true** (matchIfMissing) | `WebMvcPlatformAutoConfiguration.java:48` | 오토컨피그 13개 빈만. `SecurityConfig`·`RequestLoggingFilter`·`EnvelopeBodyAdvice`·`GlobalExceptionHandler`·`RateLimitWebConfig`·컨트롤러는 **컴포넌트 스캔이라 그대로 남는다** | +| `backend.web.mvc.trust-inbound-request-id` | false | `WebMvcPlatformSettings.java:29` | §5 H1 참조 — 무력화됨 | +| `backend.web.mvc.strict-json` | true | 동 | `webStrictObjectMapper` 빈의 프로파일. §5 H2 | +| `backend.web.budgets.enabled` | 없음(=off) | `WebMvcBudgetExceptionHandler.java:40` | 켜도 핸들러가 스캔 제외 패키지라 등록되지 않음 | +| `backend.web.webflux.*` | true | `WebFluxPlatformAutoConfiguration.java:43` | 서블릿 배포에서 조건 자체가 false | +| `backend.web.advanced.ndjson.enabled` | 없음 | `MvcStreamingExecutorConfiguration.java:36` | NDJSON + JSON-Sequence writer 동시 등록 | +| `backend.web.advanced.mvc-virtual-threads.enabled` | 없음 | `VirtualThreadMvcConfiguration.java:32` | `applicationTaskExecutor` 교체 | +| 나머지 `backend.web.advanced.*` 10종 | — | `WebAdvancedFeature.propertyName()` | **읽는 코드가 없음** | +| `app.rate-limit.enabled` | false | `config/ratelimit.yml:9` | §3.3 | +| `app.fileserver-platform.enabled` (+ `.tus.enabled`, `.httpbis-draft12.enabled`, `.admin.enabled`) | false | `config/fileserver.yml` | 깨끗하게 끊긴다 (§6 K3) | +| `ca-skeleton.notification.platform.enabled` / `.callbacks.enabled` | false | `config/notification.yml` | 깨끗하게 끊긴다 | +| `ca-skeleton.security.auth-mode` | jwt | `config/security.yml:8` | jwt ↔ redis-session 배타 | +| `ca-skeleton.cors.enabled` | false | `config/security.yml:50` | `UrlBasedCorsConfigurationSource`에 패턴 미등록 → 비활성. 정상 | +| `app.web-platform.durable-operations.enabled` | 없음 | `OperationHttpController.java:35` | 컨트롤러가 스캔 제외 + import 없음 → 켜도 라우트 없음 | + +**네 개의 프로퍼티 루트가 공존한다: `ca-skeleton.*`, `backend.web.*`, `app.*`, +`app.web-platform.*`.** 브리프가 말한 SSOT(`ca-skeleton.*`)를 따르는 것은 이 leaf의 +`@ConfigurationProperties` 8개 중 4개뿐이다. + +### 3.3 레이트리밋이 disabled일 때 — **등록된 채 no-op으로 돈다** + +`RateLimitWebConfig`(`ratelimit/RateLimitWebConfig.java:20`)에는 `@ConditionalOnProperty`가 없다. +`app.rate-limit.enabled=false`여도: + +- `RateLimitWebConfig` 빈 생성 (`ObjectMapper` 주입 필요) +- `RateLimitInterceptor.disabled(objectMapper)` 인스턴스 생성 (`:33`) +- `addInterceptors(registry)`로 **모든 요청 경로에 인터셉터 등록** (`:55-57`) +- 요청마다 `preHandle()` 진입 → `bridge == null` 확인 후 `return true` (`RateLimitInterceptor.java:55-57`) + +비용: 요청당 인터셉터 체인 1엔트리 + 가상 호출 1회. 스레드/커넥션/필수 env는 없다. +**"꺼도 안 꺼지는" Critical 기준(빈·스레드·커넥션·필수 env 요구)에는 못 미치지만**, +"꺼진 기술은 존재하지 않는 것과 같아야 한다"는 프로젝트 목표에는 어긋난다. → Medium (§5 M2). + +옹호 근거: `RateLimitWebConfigTest`가 "disabled일 때 provider/pseudonymizer/clock을 resolve하지 +않는다"를 검증한다. 즉 **비싼 의존은 확실히 안 건드린다.** 그래도 인터셉터 등록 자체는 막지 않는다. + +### 3.4 멱등성이 disabled일 때 + +`ca-skeleton.capabilities.idempotency.provider=disabled`(기본)일 때 web leaf 쪽에 남는 것: + +- `IdempotencyKeySupport`(`@Component`, `idempotency/IdempotencyKeySupport.java:322`) — **provider와 + 무관하게 항상 빈으로 등록된다.** 다만 이 빈을 주입하는 코드가 저장소 전체에 없다 + (`grep -rn "IdempotencyKeySupport" src` → 선언부 + 자기 테스트뿐). +- `WebIdempotencyGate`/`WebMvcIdempotentInvoker`는 빈이 아니므로 잔여 없음. + +즉 **`Idempotency-Key` 헤더를 읽는 코드가 라이브 요청 경로에 하나도 없다.** `WorkLogController`는 +헤더를 받되 "tolerated (ignored)"라고 주석으로 밝히고 있다 +(`src/sample-portfolio/.../WorkLogController.java:151`). 정직하지만, 템플릿 사용자 관점에서는 +"멱등성 기본 탑재"가 HTTP 경계에서는 사실이 아니다 (§5 H2). + +### 3.5 `APP_ERROR_DETAIL_EXPOSURE_ENABLED` / `APP_LOG_BODY_CAPTURE_ENABLED` + +**두 키 모두 소비자가 없다.** 저장소 전체에서 이 값을 읽는 코드는 +`bootstrap/settings/RuntimeSafetySettings.java:13-14`(바인딩)과 +`bootstrap/runtime/StartupSafetyValidator.java:56-60`(prod에서 true면 기동 실패)뿐이다. +web leaf에는 한 줄도 없다. + +- prod에서 실수로 켤 수 있는 경로: 없다. `StartupSafetyValidator`가 prod 프로파일에서 거부한다. +- dev/local에서 켜면? **아무 일도 안 일어난다.** 에러 상세도 더 나오지 않고 바디 캡처도 안 된다. + `GlobalExceptionHandler`는 프로파일과 무관하게 항상 `ClientSafeErrorMessages`의 고정 문자열만 + 내보낸다(`error/GlobalExceptionHandler.java:80-282`). + +판정: **안전 쪽으로 틀린 토글**이지만, "존재하지 않는 기능에 대한 가드"라는 점에서 +템플릿 사용자에게 잘못된 안심을 준다 (§5 M3). + +--- + +## 4. 구조 판정 + +| 축 | 판정 | 근거 | +|---|---|---| +| 의존 방향 (modules.json 대조) | **OK** | `modules.json` allowed = {domain-core, application-core, shared-contract}. `build.gradle:15-16`은 `application-core`·`shared-contract`만 선언. main의 `import dev.caskeleton.*` 분포: adapter(자기) 308, application 179, shared 48, **domain 0, messaging 0, 타 adapter 0** | +| HARD-STOP #2 (controller → repository/SpringData/entity) | **위반 없음** | `@RestController` 보유 타입 18개 전수 조사. main 트리 전체에 `org.springframework.data.*`/`jakarta.persistence.*`/`org.hibernate.*`/`com.mongodb.*`/`java.sql.*`/`javax.sql.*`/`software.amazon.*`/`io.minio.*` import **0건**. 유일한 인접 import는 `auth/JwtDecoderConfig.java:23`의 `org.springframework.web.client.RestClientException`(예외 타입 `instanceof` 용도) | +| HARD-STOP #2를 막는 것 | ArchUnit `AdapterBoundaryArchitectureTest.CONTROLLERS_DO_NOT_ACCESS_REPOSITORIES_OR_JPA_ENTITIES` (`app-bootstrap/src/architectureTest/.../AdapterBoundaryArchitectureTest.java:392-405`) + 애너테이션 기반 셀렉터 `CleanArchitectureRuleSupport.ARE_CONTROLLERS:29-43` | §6 K2 | +| HARD-STOP #3 (inbound DTO → application/domain) | **위반 없음** | `application-core`·`domain-core` main에 `import dev.caskeleton.adapter` **0건**. 구조적으로 불가능: Gradle 의존이 한 방향이고, `ApplicationBoundaryArchitectureTest.APPLICATION_DOES_NOT_DEPEND_ON_ADAPTERS_OR_TRANSPORT:53-70`이 `..application..` → `..adapter..`를 통째로 금지 | +| 경계 누수 (framework 타입) | **OK** | `WebForbiddenTypeCatalog.TRANSPORT_TYPES_FORBIDDEN_INSIDE:47-53`이 `HttpServletRequest`/`ServerWebExchange`/`ProblemDetail`/`ResponseEntity`를 application·domain에서 금지 | +| 비즈니스 규칙 위치 | **OK** | 컨트롤러·필터·매퍼에서 도메인 판단을 하는 코드를 찾지 못했다. `AuthorizationAdapter`는 `AuthorizationPort` 구현(포트 방향 정상), `RolePermissionRegistry`는 설정 투영뿐 | +| leaf 내부 모듈 경계 | **OK, 그리고 강함** | `WebStableModule`(60개 패키지 모듈 + 허용 edge) + `WebModuleBoundaryTest`가 소스를 직접 스캔해 미선언 edge·CORE 모듈의 프레임워크 import를 거부하고, **네거티브 픽스처로 실패도 증명**한다 | +| 테스트 전략 적합성 | **부분 위반** | 컨테이너별 실서버 레인(Tomcat/Jetty/Reactor Netty/Nginx)은 훌륭하고, Nginx 레인은 다른 무엇도 검증하지 않는 `nginx.conf`를 검증한다. 그러나 (a) 테스트 클래스 126 + 보조 소스셋 26 = **152개 전부가 대상을 이름으로 지정해 올리고, 배포 컨텍스트가 무엇을 조립했는지 묻는 테스트가 0개다**(§1.1·§1.2). 미배선 결함(§5 H2·H3·H4·H6)이 전부 이 구멍으로 빠져나간다. (b) 파이프라인 순서 IT 3개는 픽스처가 직접 쓴 필터의 순서를 검증한다(§5 H7). (c) 3레인 패리티 게이트가 배포가 내보내지 않는 에러 계약(problem+json)을 정본으로 고정한다(§5 C2). (d) 실제 배선(Envelope+MDC+prefix)을 끝까지 검증하는 유일한 테스트가 `sample-portfolio`에 있는데 `ci`가 그 leaf를 제외한다(§5 M5) | + +--- + +## 5. 발견 + +### Critical + +> **C1은 철회했다.** 초판의 C1은 "새 `systemTest`/`performanceTest` 소스셋이 테스트 의존을 +> 하나도 선언하지 않아 `compileSystemTestJava`가 깨지고 `ci`가 실패한다"였다. +> 내가 Gradle 플러그인의 기본값을 잘못 읽은 결과였고, 코디네이터가 플러그인 소스로 반증했다. +> **철회 근거와 내가 어디서 틀렸는지는 §9 "코디네이터 반증으로 철회한 주장"에 전문 기록했다.** +> 번호는 다시 매기지 않는다 — 다른 절에서 C2/C3를 가리키는 참조를 살리기 위해서다. + +--- + +#### C2. 하나의 응답 계약을 금지하는 ArchUnit 규칙과, 그 응답 계약을 전 응답에 적용하는 어드바이스가 같은 leaf에 있다 + +- **현상**: 이 leaf는 "글로벌 응답 엔벨로프 금지"를 규칙으로 갖고 있으면서 동시에 글로벌 응답 + 엔벨로프를 출하한다. 규칙이 **타입 이름**으로 매칭하기 때문에 둘 다 통과한다. +- **근거**: + - 금지 규칙: `testFixtures/.../arch/WebArchitectureRules.java:122-136` + ```java + noClasses().that().resideInAPackage("dev.caskeleton.adapter.inbound.web..") + .should().haveSimpleName("ApiResponse") + .orShould().haveSimpleName("CommonResponse") + .orShould().haveSimpleName("ResponseWrapper") + ``` + - 실제 엔벨로프: `envelope/EnvelopeBodyAdvice.java:22-49` — `supports()`가 무조건 `true`, + `beforeBodyWrite()`가 JSON 바디를 전부 `Envelope.ok(...)`로 감싼다. + 타입 이름이 `Envelope`라서 위 세 이름 중 어디에도 걸리지 않는다. + - 같은 leaf의 반대편 주장: `http/WebSuccessResponse.java` 클래스 javadoc — + "The design forbids a global `ApiResponse` envelope and the reason is worth keeping next to + the type: an envelope puts a second status inside a response that already has one…" + - 그리고 컴포지션 루트 테스트는 반대 방향을 못 박는다: + `app-bootstrap/src/test/.../OperationalContractRuntimeTest.java:78` — + "EnvelopeBodyAdvice must be component-scanned into the CaSkeletonApplication context". + - **규칙이 통과한다는 사실을 테스트가 확인까지 해준다.** + `test/.../testkit/arch/WebArchitectureRulesTest.theProductionWebTreeSatisfiesEveryRule`가 + `WebArchitectureRules.all()`을 프로덕션 트리에 돌리고 통과한다. + `noGlobalResponseEnvelope()`는 이름 3개만 보므로 `dev.caskeleton.shared.response.Envelope`는 + 애초에 후보에도 들지 않는다. **규칙이 "검사했고 없다"가 아니라 "찾아보지 않았다"를 통과로 보고한다.** + - 반대편 테스트도 전부 통과한다. 세 테스트가 각자 자기 편만 본다: + - `envelope/EnvelopeBodyAdviceTest.rawBodyIsWrappedInEnvelope` — + `@WebMvcTest(controllers = Probe.class, excludeAutoConfiguration = SecurityAutoConfiguration.class)` + + `@Import({Probe.class, EnvelopeBodyAdvice.class})` 로 `$.success`/`$.data.k`를 정답으로 못 박는다. + - `envelope/EnvelopeMetaIntegrationTest` — + `standaloneSetup(new Probe()).addFilter(new RequestLoggingFilter(raw -> raw)) + .setControllerAdvice(new EnvelopeBodyAdvice(), new GlobalExceptionHandler(SpanErrorRecorder.NOOP))` + 로 `meta.requestId`/`meta.traceId`까지 못 박는다. + - `error/ProblemCatalogTest` — `VALIDATION_FAILED == 422`와 + `thePublishedDocumentSaysExactlyWhatTheCatalogSays`(코드 ↔ `problem-catalog.yaml` 일치)를 못 박는다. + **카탈로그와 실제 런타임 응답을 대조하는 테스트는 없다.** 그래서 422/400 불일치가 남아 있다. + - **그리고 이 leaf에서 가장 깊은 테스트(크로스스택 패리티 게이트)가 배포가 내보내지 않는 + 에러 계약을 정본으로 고정한다.** 보조 소스셋 본문을 읽고 확정했다: + - `testFixtures/.../contract/WebPlatformContractRecording.everyFailureIsAProblemDocument`가 + 모든 4xx/5xx에 대해 `contentType == "application/problem+json"`과 "code가 비어 있지 않을 것"을 + 단언한다. `test/.../testkit/contract/CrossStackParityTest`도 같은 것을 3레인에 걸쳐 재확인한다. + - 그 게이트가 띄우는 `ContractFixtureApplication`은 `WebMvcProblemExceptionHandler`를 + `@Import`하고 `WebProblemFactory` 빈을 직접 선언한다. **`EnvelopeBodyAdvice`도 + `GlobalExceptionHandler`도 올리지 않는다.** 이유까지 주석에 적혀 있다 — + "without it Spring's own `ProblemDetail` answers instead — RFC 9457-shaped, so it looks + right, and carrying no `code` for a client to branch on." + - 배포는 정반대다. `mvc.error`는 컴포넌트 스캔에서 빠져 있고, 실제 응답은 + `EnvelopeBodyAdvice` + `GlobalExceptionHandler`가 만든 `{success,error,meta}`다. + → **Tomcat·Jetty·Reactor Netty 3레인을 실서버로 띄워 검증하는 계약이, 이 애플리케이션이 + 한 번도 내보내지 않는 계약이다.** C2를 "문서 불일치"가 아니라 Critical로 두는 이유가 이것이다. +- **왜 문제인가**: 두 가지가 동시에 깨진다. + 1. **규칙이 커버리지를 거짓 보고한다.** `WebProductionArchitectureTest`가 이 규칙을 프로덕션 + 그래프에 돌리고 통과한다. 리뷰어는 "글로벌 엔벨로프 없음"이 검증됐다고 읽지만 사실이 아니다. + 2. **에러 바디가 두 갈래다.** 실제 응답은 `{success,data,meta}` / `{success,error,meta}`인데, + 같은 leaf의 `WebProblem`(RFC 9457) + `problem-catalog.yaml`(22코드) + `ProblemSchemaContributor`는 + 전혀 다른 바디를 선언한다. fork한 사람이 `docs/`나 `problem-catalog.yaml`을 읽고 클라이언트를 + 짜면 실제 응답과 안 맞는다. + - 구체적 실패 시나리오: 클라이언트가 `type`/`code`/`traceId`(RFC 9457)로 분기하도록 짠다. + 실제로는 `error.code`/`meta.traceId`가 온다. 400/422 분기도 다르다 — + `ProblemCatalog`는 `VALIDATION_FAILED`를 **422**로 정의(`error/ProblemCatalog.java:62-64`)하지만 + 라이브 경로인 `GlobalExceptionHandler.handleMethodArgumentNotValid:284-298`는 + `OperationalError.VALIDATION_FAILED.httpStatus()`(= 400)로 답한다. +- **수정 방향**: 어느 쪽이 정본인지 한 번 정한다. + (a) 엔벨로프가 정본이면 `noGlobalResponseEnvelope()` 규칙을 삭제하고 + `error/ProblemCatalog`·`WebProblem`·`problem-catalog.yaml`·`ProblemSchemaContributor`를 + `advanced` 쪽으로 옮기거나 제거한다. + (b) problem+json이 정본이면 `EnvelopeBodyAdvice`를 제거하고 `mvc.error` 패키지를 스캔에 넣는다. + 어느 쪽이든 규칙은 **이름 매칭이 아니라 `ResponseBodyAdvice` 구현체 존재 여부**로 바꿔야 한다. +- **반론과 재반박**: "엔벨로프는 skeleton의 명시적 D1/D5 결정이고, problem 카탈로그는 아직 켜지지 + 않은 Advanced 표면이다" — `application.yml:17-22`가 실제로 그렇게 적고 있다. 그러나 그 경우 + 금지 규칙은 **존재해서는 안 된다.** 통과하는 금지 규칙이 있다는 사실이 리뷰어에게 + "엔벨로프가 없다"고 말하고, 그 위에서 `WebSuccessResponse`의 javadoc과 `ProblemCatalogTest`가 + 같은 거짓말을 강화한다. 판정 유지. + +--- + +#### C3. 이동한 테스트 8개와 공유 프로파일이 전부 untracked다 — `git add` 없이 커밋하면 사라진다 + +- **현상**: `build.gradle`(tracked)은 `systemTest`/`performanceTest` 소스셋과 레인을 선언하도록 + 이미 수정돼 있고, 기존 IT 8개와 `application-web-contract.yaml` 3부는 **삭제로 스테이징 + 가능한 상태**다. 그런데 그것들이 옮겨간 새 위치는 전부 **untracked**다. +- **근거** (`scratchpad/diff/untracked-files.txt` 26~34행, 이 leaf 9파일 303줄): + ``` + src/adapter/inbound/web/src/performanceTest/.../TomcatLoadAndShutdownIT.java (63) + src/adapter/inbound/web/src/systemTest/.../TomcatWebBudgetIT.java (30) + src/adapter/inbound/web/src/systemTest/.../TomcatContractRecordingIT.java (26) + src/adapter/inbound/web/src/systemTest/.../CommitThenConnectionResetIT.java (27) + src/adapter/inbound/web/src/systemTest/.../TomcatWebContractIT.java (44) + src/adapter/inbound/web/src/systemTest/.../TomcatOperationHttpIT.java (26) + src/adapter/inbound/web/src/systemTest/.../MvcPipelineOrderIT.java (27) + src/adapter/inbound/web/src/systemTest/.../TomcatWebThrottleIT.java (41) + src/adapter/inbound/web/src/testFixtures/resources/application-web-contract.yaml (19) + ``` + `git commit -a`는 untracked를 스테이징하지 않는다. +- **왜 문제인가**: 그 커밋의 결과물은 **"레인은 선언돼 있는데 소스가 없는"** 저장소다. + - Tomcat 실서버 IT 8개(파이프라인 순서·응답 손실·throttle 503·예산·graceful shutdown· + 와이어 레코딩)가 저장소에서 사라진다. + - `web-contract` 프로파일 문서가 **한 부도 남지 않는다**(기존 3부 삭제 + 새 1부 untracked). + `@ActiveProfiles("web-contract")`를 쓰는 25곳(jetty·webflux 레인 포함)이 프로파일 없이 돈다. + - `systemTest` 레인이 선택되면 `StrictTestLanePlugin.java:52-62`가 + "has no sources in source set 'systemTest'"로 실패한다 — 다행히 조용히 통과하지는 않는다. + - 같은 위험이 인접 영역에도 있다: websocket 3파일, sample-portfolio 4파일 + 스냅샷 JSON. +- **수정 방향**: 커밋 전에 + `git add src/adapter/inbound/web/src/systemTest src/adapter/inbound/web/src/performanceTest + src/adapter/inbound/web/src/testFixtures/resources`. + 일반화하면 **`git status --porcelain`에 `??`가 남아 있는 동안은 이 리팩토링을 커밋하지 않는다.** +- **반론과 재반박**: 없음(결정적 사실). 다만 작업자가 이미 알고 있을 가능성은 높다 — + 그래도 리뷰 산출물에 남기는 이유는, 이 이동이 20개 spec에 걸친 다단계 작업이고 + 중간 커밋이 여러 번 일어날 형태이기 때문이다. + +--- + +### High + +#### H1. `trust-inbound-request-id=false` 가 `RequestLoggingFilter`에 의해 무력화된다 — 그리고 두 테스트가 서로 반대를 못 박고 있다 + +- **현상**: 같은 컨텍스트에 `X-Request-Id`를 다루는 필터가 둘 있고, 정책이 정반대이며, + **나중에 도는 쪽(신뢰하는 쪽)이 이긴다.** +- **근거**: + - 신뢰 안 함: `mvc/filter/WebMvcRequestIdFilter.java:105-112` — + `trustInboundRequestId`가 false면 무조건 `UUID.randomUUID()`. 기본값 false + (`mvc/autoconfigure/WebMvcPlatformSettings.java:29`). order = `HIGHEST_PRECEDENCE + 10` + (`WebMvcPlatformAutoConfiguration.java:147`). + - 신뢰함: `filter/RequestLoggingFilter.java:56-59, 91-94` — + `HeaderSanitizer.sanitize(inbound, 200)` 후 MDC와 응답 헤더에 **클라이언트 값을 그대로 쓴다.** + `@Component`이고 `@Order`가 없다 → Spring Boot의 필터 등록에서 + `Ordered.LOWEST_PRECEDENCE` → 체인 가장 안쪽 → `res.setHeader("X-Request-Id", …)`가 + 앞 필터 값을 덮어쓴다. + - **테스트가 양쪽을 정반대로 못 박고 있다 (본문 전문 확인함).** + - `test/.../mvc/filter/WebMvcRequestIdFilterTest.java:14-27` + `aCallerCannotChooseTheRequestIdByDefault`: + ```java + request.addHeader(WebMvcRequestIdFilter.REQUEST_ID_HEADER, "chosen-by-caller"); + new WebMvcRequestIdFilter().doFilter(request, response, new MockFilterChain()); + assertThat(WebMvcRequestIdFilter.requestId(request).orElseThrow().value()) + .as("two exchanges sharing one identity is how an investigation reads the wrong request") + .isNotEqualTo("chosen-by-caller"); + assertThat(response.getHeader(WebMvcRequestIdFilter.REQUEST_ID_HEADER)).isNotBlank(); + ``` + 마지막 줄이 중요하다 — 응답 헤더가 **"비어 있지 않다"만** 확인하고, 그 값이 방금 만든 id와 + 같은지는 확인하지 않는다. 그래서 뒤 필터가 덮어써도 이 테스트는 통과한다. + - `test/.../filter/RequestLoggingFilterTest.java` `honoursClientRequestIdAndCorrelationIdHeaders`: + ```java + req.addHeader("X-Request-Id", "client-req-1"); + req.addHeader("X-Correlation-Id", "client-corr-1"); + filter.doFilter(req, res, chain); + assertThat(reqId.get()).isEqualTo("client-req-1"); + assertThat(res.getHeader("X-Correlation-Id")).isEqualTo("client-corr-1"); + ``` + **테스트 이름이 `honours…`다.** 클라이언트 값을 그대로 쓰는 것을 "정답"으로 선언한다. + - 같은 파일에 세 번째 고정이 하나 더 있다 — `requestIdAndCorrelationIdMdcStillSetAlongsideTraceparent`: + `req.addHeader("X-Request-Id","my-req-id")` → `assertThat(capturedReqId.get()).isEqualTo("my-req-id")`. + - **세 테스트 전부 `MockHttpServletRequest` + `filter.doFilter(...)` 직접 호출**이다. + 어느 쪽도 상대 필터를 보지 못한다. 둘을 같은 체인에 올려 확인하는 테스트는 저장소에 없다 + (`grep -rn "WebMvcRequestIdFilter" src | grep -i requestlogging` → 0건). + 이건 §1.1의 "부품 검증 100개" 분포가 만드는 결과의 교과서적 사례다 — + **두 부품이 각각 옳고, 합쳤을 때 틀리며, 합치는 테스트가 없다.** +- **왜 문제인가**: `X-Request-Id: <피해자의 요청 id>`를 보내면 공격자의 요청 로그가 피해자의 요청과 + 같은 `request_id`로 기록되고, 응답 `meta.requestId`에도 그 값이 실린다. 필터 javadoc이 막겠다고 + 적은 바로 그 시나리오("A caller that can choose its own request id can make two different requests + share one identity, which is how a support investigation ends up reading somebody else's exchange")가 + 그대로 성립한다. 부수적으로 `WebMvcRequestIdFilter`가 만든 id는 요청 속성에만 남고 응답에는 안 나가므로 + **응답 헤더의 id와 플랫폼 내부 id가 다른 값**이 된다. +- **수정 방향**: 필터를 하나로 합치거나, `RequestLoggingFilter`가 + `WebMvcRequestIdFilter.requestId(request)`를 먼저 읽고 없을 때만 생성하도록 바꾼다. + 어느 쪽이든 신뢰 정책은 `backend.web.mvc.trust-inbound-request-id` 한 곳에서만 결정돼야 한다. +- **반론과 재반박**: "`RequestLoggingFilter`는 CRLF를 제거하므로 로그 인젝션은 막힌다" — 맞다. + 그러나 이 결함은 로그 인젝션이 아니라 **식별자 충돌/가장**이고, 새니타이즈는 그걸 막지 않는다 + (`"client-req-1"`은 새니타이즈를 그대로 통과한다). + +--- + +#### H2. 라이브 요청 경로에 `Idempotency-Key`를 읽는 코드가 없고, 준비된 세 구현이 서로 다른 지문을 쓴다 + +- **현상**: 멱등성 구현이 leaf 안에 3개 있는데, HTTP 경계에서 도는 것은 0개다. +- **근거**: + 1. `idempotency/WebIdempotencyGate.java` + `SemanticRequestFingerprintFactory.java` + + `mvc/idempotency/WebMvcIdempotentInvoker.java` — 의미론적 지문(operation + path 변수 + + 정규화된 커맨드 + 선택 헤더). `new WebMvcIdempotentInvoker(` 호출처는 + `src/test/.../WebMvcIdempotentInvokerTest.java:72`와 + `src/testFixtures/.../FaultFixtureController.java:62`뿐. + 2. `idempotency/IdempotencyKeySupport.java:322` — `@Component`. 주입하는 코드 **0건** + (`grep -rn "IdempotencyKeySupport" src`). + 3. `application-core`의 `IdempotencyExecutor`/`IdempotencyExecutorV2` — sample-portfolio가 + **유스케이스 안에서** 쓴다(`PublishPosterImageUseCase.java:61`). HTTP 경계가 아니다. + - 실제 컨트롤러: `WorkLogController.java:151-157` — "`Idempotency-Key` is accepted on the POST + surface but only tolerated (ignored)". + - main 트리 전체에서 `request.getHeader(ApiHeaders.IDEMPOTENCY_KEY)`를 호출하는 곳은 + `WebMvcIdempotentInvoker.java:70`과 `WebFluxIdempotentInvoker.java:85`뿐이며, 둘 다 미배선. + - **방어 테스트는 있는데 미배선을 못 잡는 이유(본문 확인).** + `idempotency/IdempotencyKeySupportTest`는 `IdempotencyKeySupport`를 `new`로 만들어 + 키 형식·스코프·만료를 꼼꼼히 검증한다. `webflux/idempotency/WebFluxIdempotentInvokerTest`는 + 재시도 replay, 지문 불일치 422, in-flight 충돌 409 + `Retry-After`, 심지어 + "스토어 호출이 호출 스레드에서 돌지 않는다"까지 단언한다. + **셋 다 대상을 자기가 직접 생성한다.** 그러니 "아무 컨트롤러도 이걸 부르지 않는다"는 관측 대상이 + 아니다. §1.1에서 센 부품 검증 100개의 전형이다. + - **실서버 IT까지 올라가도 같다(본문 확인).** `CommitThenConnectionResetIT` / + `JettyCommitThenConnectionResetIT` / `ReactiveCommitThenConnectionResetIT` 3개는 + 커밋 후 연결이 끊긴 요청을 같은 `Idempotency-Key`로 재시도해 **부작용이 1회뿐**이고 + `Idempotency-Replayed: true`가 오는지를 실서버로 검증한다. 훌륭한 테스트다. + 그런데 그 경로를 만드는 것은 `testFixtures/.../fault/FaultFixtureController.java`가 + 필드에서 **직접 조립한** `WebMvcIdempotentInvoker`다: + ```java + private final WebMvcIdempotentInvoker invoker = + new WebMvcIdempotentInvoker( + new WebIdempotencyGate(store, new SemanticRequestFingerprintFactory(...), ...), + new IdempotentResponseWriter(...)); + ``` + → **멱등성은 "픽스처 컨트롤러가 호출하면 정확히 동작한다"까지 3개 컨테이너에서 증명돼 있고, + 프로덕션 컨트롤러 18개 중 그것을 호출하는 것은 0개다.** 기능이 없는 게 아니라 + **마지막 한 줄이 빠져 있다.** H2의 수정 비용이 낮다는 뜻이기도 하다. +- **왜 문제인가**: 템플릿의 셀링 포인트 하나가 HTTP 계층에서는 빈 상자다. fork한 사람이 + `Idempotency-Key`를 보내는 클라이언트를 만들면 **중복 POST가 그대로 두 번 실행된다.** + `docs/registries/headers.yaml`은 `Idempotency-Key`를 `direction: inbound`, + `required_test: contract-verification:idempotency-replay`로 등록해두고 있어 더 헷갈린다. +- **수정 방향**: `WebIdempotencyGate` 경로를 오토컨피그로 올려 `app.rate-limit`처럼 + provider 존재 여부에 물리거나, 반대로 `IdempotencyKeySupport`와 `mvc/idempotency`를 지우고 + "멱등성은 유스케이스 책임"이라고 `CLAUDE.md`에 한 줄로 못 박는다. 셋 다 두는 것만은 안 된다. +- **반론과 재반박**: "의미론적 지문은 바인딩 후에만 계산 가능하므로 필터가 아니라 핸들러에서 + 호출해야 하고, 그건 도메인 코드가 하는 일이다" — `WebMvcIdempotentInvoker`의 javadoc이 정확히 + 그렇게 주장한다. 타당하다. 그러나 그 경우 **템플릿이 제공해야 하는 것은 호출 예제**이고, + `sample-portfolio` 어디에도 `WebMvcIdempotentInvoker`를 쓰는 예가 없다. 예제 없는 확장점은 + fork 사용자에게 없는 것과 같다. + +--- + +#### H3. `forward-headers-strategy: framework`가 기본인데 신뢰 프록시 정책은 배선되지 않았다 — `remote-addr-only` 레이트리밋 키가 스푸핑 가능 + +- **현상**: `X-Forwarded-For`를 임의의 클라이언트가 보낼 수 있고, 그 값이 + `request.getRemoteAddr()`로 둔갑한다. 레이트리밋이 "안전한" 모드로 설정돼 있어도 키가 바뀐다. +- **근거**: + - `config/server.yml:11` — `forward-headers-strategy: ${APP_SERVER_FORWARD_HEADERS_STRATEGY:framework}`. + `framework`는 Spring의 `ForwardedHeaderFilter`를 등록하고, 이 필터의 요청 래퍼는 + `getRemoteAddr()`/`getScheme()`/`getServerName()`을 `X-Forwarded-*`로 덮어쓴다. **피어 IP 검사는 없다.** + - `ratelimit/RemoteAddrClientIpResolver.java:8` — `return request.getRemoteAddr();` + - `ratelimit/ClientIpResolverFactory.java:9` — `REMOTE_ADDR_ONLY → RemoteAddrClientIpResolver` + - 기본 모드: `config/ratelimit.yml:14` — `client-ip-mode: ${APP_RATE_LIMIT_CLIENT_IP_MODE:remote-addr-only}` + - 이 leaf에는 제대로 된 신뢰 프록시 구현이 있다 — `proxy/TrustedProxyPolicy.java`(CIDR 매칭), + `proxy/ForwardedHeaderSanitizer.java`(비신뢰 피어의 forwarded 헤더를 예외로 거부), + `proxy/UntrustedForwardedHeaderException.java`. **main 어디에서도 참조되지 않는다** + (§2 표: `proxy` 4파일 421줄, 도달 0). + - **방어 테스트가 있는데 이 결함을 구조적으로 관측할 수 없다(본문 확인).** + `ratelimit/RateLimitKeyResolverTest.remoteAddrModeIgnoresForwardedClientIpWhenPresent`: + ```java + req.setRemoteAddr("10.0.0.1"); + req.addHeader("X-Forwarded-For", "203.0.113.9, 10.0.0.1"); + assertThat(resolver.resolve(req).canonicalIdentity()).isEqualTo("10.0.0.1"); + ``` + `MockHttpServletRequest`는 `ForwardedHeaderFilter`에 래핑되지 않으므로 `getRemoteAddr()`가 + 바뀌지 않는다. **"XFF를 무시한다"를 증명하는 게 아니라, XFF가 영향을 줄 수 없는 객체 위에서 + XFF가 영향을 안 준다는 것을 확인하고 있다.** 실배포에서는 그 필터가 바로 `getRemoteAddr()`를 + 바꿔치기한다. + - 같은 leaf에 올바른 구현과 **7개짜리 충실한 테스트**가 이미 있다 — + `proxy/ForwardedHeaderSanitizerTest`. 대상 클래스의 javadoc은 이 위협을 그대로 이름 짓는다 + ("the address its rate limit is keyed on"). **그 클래스는 프로덕션 어디에도 배선돼 있지 않다.** + - **`nginxProxyTest` 레인 전문을 읽고 H3를 확정했다. 기각되지 않는다 — 두 층이 서로 다른 + 메커니즘을 쓰고, 테스트는 배포가 쓰지 않는 쪽만 본다.** + - 그 레인은 진짜 Nginx 컨테이너(`nginx:1.27-alpine`, Testcontainers)를 띄우고 + **정확히 이 위협을 쏜다**: `NginxProxyContractIT.attackerCannotForgeTheClientAddress`가 + `X-Forwarded-For: 203.0.113.9`를 보내고 `assertThat(response.body()).isNotEqualTo("203.0.113.9")`를 + 단언한다. `X-Forwarded-Host`, `X-Forwarded-Proto`, RFC 7239 `Forwarded`, `X-Forwarded-Prefix`도 + 각각 한 케이스씩 있다. + - **그런데 그 테스트가 통과하는 이유는 애플리케이션이 안전해서가 아니라 `nginx.conf`가 + 값을 덮어쓰기 때문이다.** `nginxProxyTest/resources/nginx/proxy_headers.conf`: + `proxy_set_header X-Forwarded-For $remote_addr;` / `X-Forwarded-Host hyeonworks.com;` / + `Forwarded "";` — 전부 **set**(치환)이고 add가 아니다. 파일 주석이 그것이 요점이라고 적는다. + **이 레인이 검증하는 것은 Nginx 설정 파일이다.** 그건 다른 무엇도 검증하지 않는 귀중한 대상이고 + 이 레인의 정당한 가치다(§6 K5). + - **애플리케이션 쪽에서는 배포와 다른 메커니즘이 돈다.** + 픽스처 컨트롤러 `testFixtures/.../proxy/ProxyFixtureController.java:52-55`가 + `new ForwardedHeaderSanitizer(TrustedProxyPolicy.of("10.0.0.0/8", ...))`를 필드에서 직접 + 만들어 쓴다. 즉 이 레인은 **`ForwardedHeaderSanitizer` 경로**를 검증한다. + 배포가 쓰는 것은 `server.forward-headers-strategy=framework` → Spring의 `ForwardedHeaderFilter`, + **다른 클래스, 다른 신뢰 모델(피어 허용목록 없음)**이다. + - 결정적으로, 이 레인이 쓰는 `web-contract` 프로파일에는 + **`forward-headers-strategy`가 아예 없다**(`testFixtures/resources/application-web-contract.yaml` + 전문 확인 — `spring.main`, `spring.mvc.problemdetails`, `server.error`, `backend.web.mvc`뿐). + **배포의 기본값인 `framework`는 어느 레인에서도 켜지지 않는다.** + → **판정: H3 확정.** 실서버 프록시 레인이 있다는 사실이 오히려 문제를 가린다 — + "프록시 뒤 forwarded 헤더 처리는 실 컨테이너로 검증됨"이라는 인상을 주는데, + 검증된 것은 (1) Nginx 설정과 (2) 프로덕션이 쓰지 않는 sanitizer 경로다. + - **반론 하나는 내가 초판에서 틀렸으므로 정정한다.** 초판은 "`docker-compose` 기반 로컬/개발 + 배포에는 인그레스가 없다"를 근거로 들었다. 확인해 보니 + `app-bootstrap/src/main/resources/application-local.yml:131`이 + `forward-headers-strategy: none`으로 덮어쓰고, 테스트 프로파일도 + `application-test.yml:86`에서 `none`이다. **로컬·개발은 안전하다.** + 노출되는 것은 `config/server.yml:11`의 기본값 `framework`가 그대로 적용되는 + **프로덕션 프로파일뿐**이다. 반론이 하나 줄었지만 판정은 그대로다 — + 오히려 "안전한 쪽이 개발이고 노출되는 쪽이 운영"이라 더 나쁘다. + - 같은 뿌리의 두 번째 사례: `notification/platform/callback/ExternalRequestUrlResolver.java:20` — + `trustedProxies.contains(request.getRemoteAddr())`로 프록시를 판정한다. `getRemoteAddr()`가 + 이미 공격자 제어값이므로 **신뢰 프록시 IP를 `X-Forwarded-For`에 적으면 그 검사를 통과**하고, + 그 결과 콜백 서명 검증에 쓰이는 외부 URL(scheme/host)을 공격자가 고를 수 있게 된다. +- **왜 문제인가**: 구체적 실패 — `APP_RATE_LIMIT_ENABLED=true`, `APP_RATE_LIMIT_PROVIDER=redis`, + 기본 `client-ip-mode=remote-addr-only`로 배포한다. 미인증 요청에 대해 + `RateLimitKeyResolver.java:47-48`이 `CLIENT_IP` 종류의 subject를 만든다. + 공격자가 요청마다 `X-Forwarded-For: 10.0.0.`을 바꿔 보내면 매번 다른 버킷을 얻는다. + 즉 **레이트리밋이 사실상 없다.** 이 모드는 이름이 `REMOTE_ADDR_ONLY`이고 주석이 + "ignores forwarded headers"라고 말하므로, 운영자는 안전한 쪽을 골랐다고 믿는다. +- **수정 방향**: 셋 중 하나. + (a) `APP_SERVER_FORWARD_HEADERS_STRATEGY` 기본값을 `none`으로 바꾸고, 프록시 뒤 배포만 켜게 한다. + (b) `ForwardedHeaderFilter` 대신 `proxy/ForwardedHeaderSanitizer` + `TrustedProxyPolicy`를 + 배선하고 신뢰 CIDR을 env로 받는다(이미 만들어져 있다). + (c) 최소한 `RemoteAddrClientIpResolver`가 래핑되지 않은 원본 요청의 peer를 읽도록 한다. +- **반론과 재반박**: "프로덕션은 반드시 신뢰 가능한 인그레스 뒤에 있고, 인그레스가 XFF를 + 덮어쓴다 — 그리고 그 인그레스 설정을 `nginxProxyTest`가 실 컨테이너로 검증한다" — + 이게 가장 강한 반론이고, 절반은 맞다. `nginx.conf`/`proxy_headers.conf`가 실제로 모든 forwarded + 헤더를 `set`으로 치환하고 그것이 컨테이너 레인으로 고정돼 있다. 그러나 + (1) 그 `nginx.conf`는 **테스트 소스셋의 리소스**이고, `infra/`의 실제 배포 프록시 설정과 + 같은 파일이 아니다(레인은 자기 파일을 컨테이너에 복사해 넣는다). 배포 프록시가 같은 + 규칙을 쓴다는 보장은 코드에 없다. + (2) 템플릿의 기본값은 가정이 아니라 기본값이다. `APP_SERVER_FORWARD_HEADERS_STRATEGY`를 + 지정하지 않은 fork는 `framework`로 뜬다. + (3) `TrustedProxyPolicy`·`ForwardedHeaderSanitizer`가 코드로 존재한다는 것은 팀이 이미 그 + 가정을 믿지 않기로 결정했다는 뜻이고, 그럼에도 프로덕션에 배선되지 않았다. + (4) 초판의 "로컬/개발에는 인그레스가 없다"는 근거는 **철회한다** — 위에서 확인한 대로 + `application-local.yml:131`과 `application-test.yml:86`이 `none`으로 덮어쓴다. + 노출 면은 프로덕션 프로파일 한 곳으로 좁혀지고, 그래서 더 나쁘다. + 판정 유지. + +--- + +#### H4. `PresentationWebConfig`의 전역 prefix가 `/v1`을 하드코딩한 라우트에 이중으로 붙고, 그 결과 알림 콜백의 보안 체인이 라우트를 못 잡는다 + +- **현상**: 모든 컨트롤러 매핑 앞에 `ca-skeleton.presentation.api-base-path`가 붙는다 + (`config/PresentationWebConfig.java:23` — `configurer.addPathPrefix(prefix, c -> true)`). + 그런데 fileserver·operation·알림 라우트는 애너테이션에 이미 버전/`/internal` 경로를 적고 있다. +- **근거** (main 트리의 라우트 리터럴 전수): + - `/v1/files`, `/v1/files:raw`, `/v1/files:batch`, `/v1/files/{fileId}`, + `/v1/files/{fileId}/content`, `/v1/files/{fileId}:copy`, `/v1/files/{fileId}:move`, + `/v1/uploads`, `/v1/uploads/{uploadId}`, `/v1/experimental/draft12/uploads` + - `/api/v1/operations` (`mvc/operation/OperationHttpController.java:43`) + - `/internal/notification/callbacks` (`notification/platform/callback/NotificationCallbackMvcController.java:38`) + - prefix가 실제로 붙는다는 증거: `sample-portfolio/src/test/.../VersioningPrefixTest.java:39-47`가 + `/probe`는 404, `/v1/probe`는 200임을 못 박는다. + - 기본값: `config/runtime.yml:53` → `${PRESENTATION_API_BASE_PATH:/v1}`. + `src/.env:112`는 `/api`. **`src/.env.example`에는 이 키가 아예 없다**(`grep PRESENTATION` → 0건), + `docs/registries/env-keys.yaml`에도 없다(`grep PRESENTATION` → 0건). + - 문서: `docs/fileserver/http-contract.md:10-26`은 `POST /v1/files`라고 적는다. + - **알림 콜백 테스트가 오히려 접두사 없는 경로를 정답으로 고정한다(본문 확인).** + `notification/platform/callback/NotificationCallbackMvcControllerTest`: + ```java + void aForwardedHostFromATrustedProxyBecomesTheCanonicalUrl() { + ... assertThat(verified.get(0).externalUrl()).isEqualTo( + "https://callback.example.com/internal/notification/callbacks/twilio/twilio-primary"); + } + ``` + `standaloneSetup`이라 `PresentationWebConfig`의 `addPathPrefix`가 적용되지 않는다. 실배포 경로는 + `/{prefix}/internal/notification/callbacks/...`인데, **제공자 서명 검증은 이 URL 위에서 계산된다.** + 즉 이 테스트가 통과한다는 사실은 H4-2와 모순되지 않고, H4-2를 못 잡는 이유를 설명한다. + - 같은 파일의 `aForwardedHostFromAnUntrustedPeerIsIgnored`는 `request.setRemoteAddr("203.0.113.9")` + + `X-Forwarded-Host: attacker.example.com`이 무시되는 것을 확인하는데, H3과 같은 이유로 + `MockHttpServletRequest`에서는 애초에 `getRemoteAddr()`가 스푸핑될 수 없다. + **이 leaf에서 "목(mock)이 재현할 수 없는 실패를 목 위에서 안전하다고 고정하는" 세 번째 사례다** + (H1 requestId, H3 XFF, 여기). +- **왜 문제인가**: 세 갈래로 깨진다. + 1. **경로 문서 불일치.** `.env.example`을 복사한 fork는 `/v1` 기본값을 쓰므로 업로드가 + `/v1/v1/files`에 뜬다. `src/.env`를 쓰면 `/api/v1/files`. 문서는 `/v1/files`. + `FileserverDocumentationCoverageTest`는 **컨트롤러 애너테이션 리터럴**을 문서와 대조하므로 + 이 불일치를 잡지 못한다. + 2. **알림 콜백이 401로 죽는다.** `CallbackMvcSecurityConfiguration.java:22`가 + `http.securityMatcher("/internal/notification/callbacks/**")` + `permitAll()`인데, + 실제 라우트는 `/{prefix}/internal/notification/callbacks/...`다. 매처가 안 걸리니 + 기본 체인의 `anyRequest().authenticated()`로 떨어진다. → **제공자 웹훅은 항상 401.** + (반대로 클라이언트가 접두사 없는 경로로 보내면 permitAll 체인엔 걸리지만 핸들러가 없어 404.) + 3. **관리 플레인 역할 게이트가 조건부로 무력화된다.** + `FileserverAdminPlaneConfiguration.java:32-37`이 기여하는 `RestrictedPathRule`의 패턴은 + `/internal/fileserver/**`다. 기본 배포에서는 `MANAGEMENT_SERVER_PORT=9001`이라 어드민 + 컨트롤러가 자식 관리 컨텍스트에 들어가고 prefix가 안 붙으므로 문제가 없다. 그러나 그 + 클래스의 javadoc은 "Boot falls back to the same context when the ports are equal, **which is + why the role gate contributed by FileserverAdminPlaneConfiguration stays**"라고 적는다. + 포트를 같게 두면 어드민 컨트롤러가 메인 컨텍스트에 들어가 prefix가 붙고, 그 순간 + `/internal/fileserver/**` 룰은 매칭되지 않으며 `anyRequest().authenticated()`만 남는다. + → **인증된 아무 사용자나 `:force-delete`를 호출할 수 있다.** 코드가 스스로 약속한 보호가 + 그 시나리오에서만 성립하지 않는다. +- **수정 방향**: 라우트 리터럴에서 `/v1`·`/api/v1`을 걷어내고 prefix에만 맡기거나, + `addPathPrefix`의 술어를 `c -> true` 대신 "버전을 스스로 선언하지 않은 컨트롤러"로 좁힌다. + 보안 매처/`RestrictedPathRule` 패턴은 `PresentationSettings.apiBasePath()`를 읽어 조립한다. + `PRESENTATION_API_BASE_PATH`/`SECURITY_PUBLIC_PATHS`를 `env-keys.yaml`과 `.env.example`에 등록한다. +- **반론과 재반박**: "fileserver는 자체 버저닝을 가진 별도 표면이고, 배포가 + `PRESENTATION_API_BASE_PATH=`(빈 값)로 두면 문제가 없다" — 가능하다. 그러나 (1) 빈 값은 + 기본값이 아니고, (2) 그렇게 두면 `security.public-paths` 기본값 + `${PRESENTATION_API_BASE_PATH:/v1}/healthcheck`가 `/healthcheck`가 되는데 + `HealthcheckController`도 prefix가 없어져 맞긴 하지만, (3) 알림 콜백 401 문제는 prefix가 + 비어 있을 때만 사라진다 — 즉 **템플릿이 정상 동작하는 설정이 딱 하나뿐인데 그게 기본값이 아니다.** + +--- + +#### H5. `webStrictObjectMapper`가 Boot의 Jackson 오토컨피그와 같은 타입으로 등록된다 — 어느 매퍼가 요청 바디를 읽는지 코드로 결정돼 있지 않다 + +- **현상**: `WebMvcPlatformAutoConfiguration.java:129-139`가 + `tools.jackson.databind.json.JsonMapper` 타입 빈 `webStrictObjectMapper`를 등록한다. + 조건은 `@ConditionalOnMissingBean(name = "webStrictObjectMapper")` — **이름 기준**이므로 + Boot의 `JacksonAutoConfiguration`이 만드는 `JsonMapper` 빈과 무관하게 항상 등록된다. +- **근거**: + - `mvc/autoconfigure/WebMvcPlatformAutoConfiguration.java:130-139` (주석: "A JsonMapper, not an + ObjectMapper: Spring 7's JacksonJsonHttpMessageConverter takes the concrete Jackson 3 type, + so anything else is a bean the framework never reads a body with.") + - `webflux/autoconfigure/WebFluxPlatformAutoConfiguration.java:127-130` 동일. + - 이 매퍼의 정책은 `WebJsonProfile.strict()`(`json/WebJsonProfile.java:22-24`)이고, + `application.yml:209-227`의 `spring.jackson.*` 핀과는 **다른 축의 설정**이다 + (예: `WebJsonProfile.strict()`는 `ACCEPT_CASE_INSENSITIVE_PROPERTIES`를 끄고 스칼라 강제 + 변환을 전부 Fail로 만든다 — `json/WebObjectMapperFactory.java:74-100`). + - 이 상호작용을 검증하는 테스트가 없다: + `WebMvcPlatformAutoConfigurationTest`는 `WebApplicationContextRunner`에 + **`WebMvcPlatformAutoConfiguration` 하나만** 올린다(`:20-22`). + `app-bootstrap`의 `JacksonSerializationPolicyTest`는 **`JacksonAutoConfiguration` 하나만** 올린다(`:41-44`). + `getBeansOfType(JsonMapper)` / `hasSingleBean(JsonMapper)` 를 단언하는 테스트는 저장소에 0건. + - 팀은 이미 같은 계열의 사고를 겪었다 — `build.gradle:38-52`: + "every deployment got three ObjectMapper beans — which broke `@Autowired ObjectMapper` + in the composition root with an ambiguity". +- **왜 문제인가**: 셋 중 무엇이 참인지에 따라 요청 바인딩 계약이 통째로 달라진다. + (i) Boot 빈이 `@Primary`라 메시지 컨버터가 그것을 쓴다 → `webStrictObjectMapper`는 아무도 안 쓰는 + 매퍼 1개(메모리·시작시간 낭비)이고 `backend.web.mvc.strict-json` 토글은 무의미하다. + (ii) 플랫폼 빈이 이긴다 → `application.yml`의 `spring.jackson.*` 블록 전체가 무효가 되고, + `JacksonSerializationPolicyTest`/`JacksonDeserializationPolicyTest`가 실제 런타임과 다른 것을 + 검증하고 있는 셈이 된다. + (iii) 모호성 예외로 기동 실패. + **세 가지 모두 심각하고, 코드/테스트 어디에도 답이 없다.** +- **수정 방향**: `webStrictObjectMapper`를 `@ConditionalOnMissingBean(JsonMapper.class)`로 바꾸거나 + (=Boot에 양보), 반대로 `@Primary`를 붙여 명시적으로 이기게 하고 `spring.jackson.*` 블록을 지운다. + 어느 쪽이든 `app-bootstrap`에 "컨텍스트에 `JsonMapper` 빈이 정확히 1개"를 단언하는 테스트가 필요하다. +- **반론과 재반박**: "이름 조건은 어댑터가 자기 매퍼를 갈아끼울 수 있게 하려는 의도다" — 그럴 수 있다. + 그러나 그 의도라면 `@ConditionalOnMissingBean(name=...)`이 아니라 별도 `@Qualifier`로 분리하고 + 메시지 컨버터에 명시적으로 꽂아야 한다. 현재 형태는 **프레임워크의 빈 해석에 계약을 맡긴 것**이고, + 그게 이 저장소에서 이미 한 번 사고를 낸 형태다. + +--- + +#### H6. "설정됐지만 배선 안 됨"을 잡으라고 만든 기동 검증기 자체가 배선돼 있지 않다 + +- **현상**: 이 leaf는 **미배선 결함을 기동 시점에 잡는 검증기**를 이미 갖고 있다. + 그 검증기를 생성하는 코드가 프로덕션에 없다. +- **근거**: + - `admin/platform/WebPlatformStartupValidator.java:20-39` — + 필수 컨트롤 목록을 받아 `WebPlatformSnapshot`의 `uninstalledControls()`를 검사하고, + 하나라도 없으면 기동을 실패시킨다. 빈 problem 카탈로그도 거부한다. + - `grep -rn "new WebPlatformStartupValidator(" src` → **테스트 1곳뿐** + (`test/.../admin/platform/WebPlatformStartupValidatorTest.java`). + main 트리에서 이 타입을 생성·주입하는 코드는 0건이다. + `WebPlatformSnapshot`도 main에서는 정의만 되고 어디서도 만들어지지 않는다. + - 그리고 그 테스트의 클래스 javadoc이 이 리뷰의 §1.1 결론을 그대로 적고 있다: + + > "The check that would have caught this session's worst defect at startup. The problem catalog + > existed, was fully tested, and was reached by nothing on the framework's error path — found by + > accident, weeks of work later, through a cross-stack parity recording. + > **Every case here is the same shape: a control that is configured and not wired behaves + > exactly like one that works, right up until it is needed.**" +- **왜 문제인가**: 팀이 이 실패 유형을 **정확히 식별했고, 대책을 코드로 만들었고, 테스트까지 + 붙였는데, 그 대책이 자기 자신이 경고한 바로 그 상태로 남아 있다.** H2(멱등성)·H3(신뢰 프록시)· + H4(경로 접두사)·C2(엔벨로프 vs 카탈로그)가 전부 이 검증기가 잡도록 설계된 모양이다. + fork 사용자 관점에서 더 나쁜 점은, 이 클래스의 존재 자체가 "이 템플릿은 배선을 기동 때 검증한다"는 + 인상을 준다는 것이다. +- **수정 방향**: `WebMvcPlatformAutoConfiguration`에 `WebPlatformSnapshot`을 조립하는 + `SmartInitializingSingleton`(또는 `ApplicationRunner`) 하나를 추가하고, 필수 컨트롤 목록을 + `backend.web.platform.required-controls`로 노출한다. 최소 세 개 — + `problemHandler`(= `GlobalExceptionHandler` 또는 `WebMvcProblemExceptionHandler`), + `requestIdFilter`, `evidenceFilter` — 만 넣어도 C2와 H1은 기동에서 걸린다. +- **반론과 재반박**: "이건 아직 완성되지 않은 Advanced 표면이고, `admin/platform`은 §5 M1이 + 이미 지적한 미도달 패키지에 속한다" — 맞다. 그래서 별도 Critical이 아니라 High다. + 그러나 M1의 나머지(스트리밍·코덱·함수형 라우팅)는 **없어도 아무 약속을 깨지 않는** 기능인 반면, + 이것은 **다른 결함들을 잡겠다는 약속**이다. 약속이 있는데 실행되지 않는 것과, + 기능이 없는 것은 fork 사용자에게 같은 무게가 아니다. + +--- + +#### H7. 파이프라인 순서 IT 3개가 검증하는 것은 픽스처가 직접 쓴 필터의 순서이지, 이 애플리케이션의 파이프라인이 아니다 + +- **현상**: 브리프 1번 질문("실제 HTTP 파이프라인 순서를 재구성하고, 그것이 우연이 아니라 코드로 + 고정돼 있음을 증명하라")에 대해 이 저장소가 내놓는 답은 `MvcPipelineOrderIT` / + `JettyPipelineOrderIT` / `WebFluxPipelineOrderIT` 3개다. **그 셋 중 어느 것도 프로덕션 필터를 + 한 개도 로드하지 않는다.** +- **근거**: + - `testFixtures/.../webtestkit/PipelineOrderFixtureApplication.java` — 픽스처 앱이 + **직접 작성한 익명 `OncePerRequestFilter`** 하나를 `HIGHEST_PRECEDENCE`로 등록하고, + 그 `doFilterInternal` 본문이 다섯 줄을 연달아 실행한다: + ```java + recorder.record(WebPipelineStage.FORWARDED_NORMALIZATION); + recorder.record(WebPipelineStage.CORS); + recorder.record(WebPipelineStage.TRACE); + recorder.record(WebPipelineStage.AUTHENTICATION); + recorder.record(WebPipelineStage.GLOBAL_ADMISSION); + ``` + - `ROUTE_SELECTED`/`ROUTE_POLICY`는 같은 파일의 `addInterceptors(...)`가 등록하는 + 익명 `HandlerInterceptor.preHandle`에서, `BINDING_VALIDATION`/`CONTROLLER`는 + `PipelineOrderFixtureController`의 핸들러 본문에서 기록된다. + - 계약 테스트 `testFixtures/.../testkit/order/WebPipelineOrderContract.stagesFollowSemanticOrder`는 + 그 11개가 위 순서로 나오는지 `containsExactly`로 단언한다. + - WebFlux 판(`webfluxContractTest/.../ReactivePipelineOrderFixtureApplication`)도 같은 구조다 — + `@Order(HIGHEST_PRECEDENCE)` `WebFilter`와 `@Order(HIGHEST_PRECEDENCE + 1)` `WebFilter` 둘을 + 직접 만들어 같은 다섯 + 두 스테이지를 기록한다. + - 프로덕션 필터 이름(`WebMvcRequestIdFilter`, `RequestLoggingFilter`, `WebMvcEvidenceFilter`, + `CacheControlFilter`, `ForwardedHeaderFilter`)은 이 세 소스셋 어디에도 등장하지 않는다. +- **왜 문제인가**: `stagesFollowSemanticOrder`는 **한 메서드 안의 다섯 줄이 쓰여진 순서대로 + 실행된다**는 것을 단언한다. 그건 Java의 성질이지 이 애플리케이션의 성질이 아니다. + 결과적으로 §5 H1(요청 id 필터 2개가 서로 덮어씀)이 이 IT를 그대로 통과한다 — + IT에 그 두 필터가 없기 때문이다. 리뷰어·fork 사용자 입장에서 더 나쁜 것은 이 레인의 이름과 + 문서가 "파이프라인 순서를 실서버에서 고정한다"고 읽힌다는 점이다. +- **이 IT가 실제로 증명하는 것 두 가지**(공정하게 적는다): + 1. **필터 vs 인터셉터의 구조적 분리.** 픽스처 주석이 직접 말한다 — "Filters carry the stages + that must happen before routing; interceptors carry the ones that need the handler to be + known. That split is the semantic order made structural rather than asserted." 라우팅 전 + 스테이지가 라우팅 후 스테이지보다 먼저 온다는 것은 서블릿/MVC의 구조적 사실이고, + 이 IT는 그것을 실서버에서 확인한다. **이건 진짜 검증이다.** + 2. **async 재디스패치에서 완료 관측이 1회인가.** `asyncRequestObservesCompletionOnce`가 + `RESPONSE_OR_PROBLEM`·`OBSERVATION`이 각각 1회인지 센다. MockMvc로는 재현 불가능한 + 성질이고(`Callable`을 ASYNC 재디스패치 없이 풀어버림), 실제로 접근 로그 중복·메트릭 + 이중 계상의 원인이다. **이것도 진짜 검증이다.** +- **수정 방향**: 픽스처 앱이 `WebMvcPlatformAutoConfiguration`을 `@Import`하고, 레코더를 + `FilterRegistrationBean` 대신 각 프로덕션 필터를 감싸는 데코레이터로 붙인다. 그러면 + 같은 계약 테스트가 **실제 등록 순서**를 읽게 되고, H1은 그 즉시 실패로 드러난다. + 최소한으로는 스테이지 이름 대신 **실제 필터 클래스 이름 목록**을 단언하는 테스트 하나를 추가한다 + (`context.getBeansOfType(FilterRegistrationBean.class)`를 order로 정렬해 이름을 비교). +- **반론과 재반박**: "이 레인은 '의미론적 순서'라는 **설계 규약**을 고정하는 것이지 배선을 + 검증하는 것이 아니다. 배선은 다른 곳의 책임이다" — 픽스처 주석을 보면 실제로 그런 의도로 읽힌다. + 그러나 (1) 그 "다른 곳"이 이 leaf에 없고(§1.1: 배포 컨텍스트를 묻는 테스트 0개), + (2) 레인 이름이 `PipelineOrderIT`이며 `system()` 카테고리로 `ci`에 들어가 있고, + (3) §5 H1이라는 **실제 순서 결함이 이미 존재**한다. 규약만 고정하는 테스트를 + 배선 게이트 자리에 놓아 둔 것이 문제다. 판정 유지. + +--- + +### Medium + +#### M1. Advanced 12기능 중 10개는 활성화 경로가 없고, 그 플래그를 읽는 코드도 없다 + +- **현상**: `WebAdvancedFeature`(`advanced/WebAdvancedFeature.java`)는 12개 기능과 + `propertyName()`(`backend.web.advanced..enabled`)을 선언한다. + `advanced/**` 78파일 중 `@Configuration`/`@Bean`을 가진 파일은 3개 + (`advanced/mvc/VirtualThreadMvcConfiguration`, `advanced/mvc/MvcStreamingExecutorConfiguration`, + `advanced/mvc/VirtualThreadSettings`)뿐이다. +- **근거**: main 트리의 `backend.web.advanced.*` 리터럴 전수 → + `mvc-virtual-threads`, `ndjson`, 그리고 어디서도 읽지 않는 + `advanced.virtual-threads.enabled`(`advanced/virtualthread/VirtualThreadProfile.java:propertyName()`)뿐. + `WebAdvancedFeatureFlags`를 참조하는 곳은 테스트 2개뿐 + (`test/.../advanced/release/WebAdvancedRollbackIT.java`, `WebAdvancedReleaseTest.java`). +- **왜 문제인가**: fork 사용자가 `backend.web.advanced.sse.enabled=true`를 켜면 아무 일도 안 일어난다. + `WebAdvancedPromotionGate`(승격 게이트)와 `WebAdvancedReleaseManifest`(증거 매니페스트)는 + 존재하지 않는 활성화 경로를 위한 프로세스를 정의한다. +- **수정 방향**: 최소한 `WebAdvancedFeature`에 "활성화 경로 있음/없음"을 표시하고, + `MvcStreamingExecutorConfiguration`이 NDJSON 플래그로 JSON-Sequence writer까지 등록하는 것 + (`advanced/mvc/MvcStreamingExecutorConfiguration.java:44-52`)은 각자 플래그로 쪼갠다. +- **반론과 재반박**: "Advanced는 의도적으로 라이브러리이고, 소비자가 자기 `@Configuration`에서 + 조립하는 것이 설계다" — `README`와 `WebAdvancedPromotionGate`가 그렇게 읽힌다. 그렇다면 + `propertyName()`과 `WebAdvancedFeatureFlags`는 거짓 API다(아무도 안 읽는 키를 반환한다). + 라이브러리라면 팩토리만 남기고 플래그 개념을 지워야 한다. + +#### M2. 레이트리밋이 disabled여도 인터셉터가 등록된다 (다만 부작용은 0으로 증명돼 있다) + +- §3.3 참조. 근거 `ratelimit/RateLimitWebConfig.java:20, 32-35, 54-57`, + `ratelimit/RateLimitInterceptor.java:48-57`. +- **공정하게 적어야 할 점**: 꺼진 인터셉터가 **정말 아무것도 안 한다는 것은 테스트로 증명돼 있다.** + `ratelimit/RateLimitInterceptorTest.disabledModeHasNoProviderPseudonymizerOrResolverSideEffects`는 + 포트·가명화기·IP 리졸버를 전부 "호출되면 `AssertionError`"로 만들어 넣고 + `RateLimitInterceptor.disabled(objectMapper).preHandle(...)` 후 `assertThat(calls).hasValue(0)`을 + 단언한다. 헤더도 안 쓴다. 즉 비용은 **인터셉터 객체 1개 + 체인 1홉**이고, Redis 연결·스레드· + 필수 env는 요구하지 않는다. "꺼졌는데 안 꺼진" 부류가 아니라 **Medium 수준의 군더더기**다. +- **수정 방향**: `RateLimitWebConfig`에 `@ConditionalOnProperty(prefix="app.rate-limit", name="enabled", havingValue="true")`. +- **반론과 재반박**: "토글이 런타임에 바뀔 수 있어야 한다면 빈은 항상 있어야 한다" — + 이 저장소의 토글은 전부 기동 시 판정이고(`StartupSafetyValidator`, `capabilities.yml`), + 런타임 재구성 경로가 없다. 판정 유지. + +#### M3. `APP_ERROR_DETAIL_EXPOSURE_ENABLED`/`APP_LOG_BODY_CAPTURE_ENABLED`는 소비자가 없다 + +- §3.5 참조. 근거: `grep -rn "errorDetailExposureEnabled\|logBodyCaptureEnabled" src` → + `bootstrap/settings/RuntimeSafetySettings.java:13-14`, `bootstrap/runtime/StartupSafetyValidator.java:56-60` + 둘뿐. +- **수정 방향**: 기능을 구현하거나(예: dev에서 `GlobalExceptionHandler`가 원인 클래스명을 details에 + 넣는 정도), 키와 가드를 같이 지운다. **가드만 남기는 것이 가장 나쁜 상태다.** +- **반론과 재반박**: "미래 기능을 위한 예약 키"라는 해석이 가능하다. 그러나 + `EnvProfileMatrixContractTest`/`PiiTokenBodyForbiddenContractTest`가 이 키의 기본값을 + "바디가 로그에 절대 도달하지 않음"의 **근거로** 쓰고 있어(`PiiTokenBodyForbiddenContractTest.java:30`), + 존재하지 않는 기능이 보안 증거로 인용되고 있다. + +#### M4. leaf 레벨 ArchUnit 컨트롤러 규칙이 패키지 이름으로 셀렉트한다 — 컴포지션 루트 규칙보다 좁다 + +- **현상**: `WebArchitectureRules.controllersAreUseCaseAdapters()`(`testFixtures/.../WebArchitectureRules.java:32-42`)는 + `resideInAnyPackage("..web..controller..", "..web.controller..")`로 고른다. 이 leaf의 + `@RestController` 18개 중 **3개만** 매칭된다(`controller/HealthcheckController`, + `fileserver/controller/FileDownloadController`, `fileserver/controller/FileUploadController`). + `TusController`, `Draft12UploadController`, `FileLifecycleController`, `FileserverAdminController`, + `NotificationSubmissionController`, `NotificationTemplateController`, + `NotificationCallbackMvcController`, `OperationHttpController`, + `ReactiveOperationHttpController`는 빠진다. +- **근거**: 컴포지션 루트에는 **제대로 된 버전이 이미 있다** — + `CleanArchitectureRuleSupport.ARE_CONTROLLERS`(`app-bootstrap/.../CleanArchitectureRuleSupport.java:29-43`)는 + `@RestController`/`@Controller`/메타애너테이션으로 고르고, javadoc이 정확히 이 실수를 기록한다: + "`NotificationCallbackMvcController` sits in `..web.notification.platform.callback`, so the rules + that forbid a controller from touching a repository or returning an entity never looked at it". +- **왜 문제인가**: 같은 규칙의 넓은 버전과 좁은 버전이 동시에 돌고 + (`WebProductionArchitectureTest`가 `WebArchitectureRules.all()`을 프로덕션에 적용), + 좁은 쪽이 통과한다는 사실이 리뷰어에게 "규칙이 있다"는 잘못된 신호를 준다. +- **수정 방향**: `WebArchitectureRules`도 `ARE_CONTROLLERS`와 같은 애너테이션 술어를 쓴다 + (`testFixtures`에 술어를 옮기고 bootstrap이 그걸 재사용). +- **반론과 재반박**: "leaf 규칙은 픽스처로 '실패할 수 있음'만 증명하고, 실제 집행은 루트에서 한다" — + `WebArchitectureRulesTest`의 javadoc이 그렇게 적는다. 그러나 `WebArchitectureRulesTest:69-81`과 + `WebProductionArchitectureTest:45-51`이 **둘 다 프로덕션 그래프에 이 규칙을 적용**하므로 + "픽스처 전용"이라는 설명은 코드와 다르다. + +#### M5. 이 영역의 유일한 엔드투엔드 계약 테스트가 `ci`에서 빠져 있다 + +- **현상**: 엔벨로프·MDC·`/v1` prefix·OpenAPI 스냅샷을 실제 서버로 검증하는 테스트는 + `sample-portfolio/src/webSystemTest/`에 있다 + (`OpenApiSnapshotTest`, `OpenApiDriftContractTest`, `DateHeaderContractTest`, `VirtualThreadMdcE2ETest`). +- **근거**: 루트 `src/build.gradle:80-83`의 `leafPaths`가 `:sample-portfolio`를 제외하고, + `ci`(`:136-143`)는 그 `leafPaths`만 쓴다. + `.github/workflows/*` 어디에도 `sample-portfolio`/`webSystemTest`/`openapiCheckSnapshot`를 + 호출하는 스텝이 없다(`grep -rn "sample" .github/workflows` → 0건). + 커밋 안 된 변경이 `tasks.named('check') { dependsOn openapiCheckSnapshot }`를 추가했지만 + (`sample-portfolio/build.gradle`), sample의 `check` 자체가 CI에서 호출되지 않는다. +- **왜 문제인가**: OpenAPI 드리프트 게이트와 MDC/prefix 계약이 실질적으로 꺼져 있다. + H4(이중 prefix)와 C2(엔벨로프 vs problem)가 이렇게 오래 남아 있는 이유이기도 하다. +- **수정 방향**: `ci`에 `:sample-portfolio:openapiCheckSnapshot`(또는 `webSystemTestLaneCheck`)를 + 추가하거나, `pr-adapters.yml`에 전용 job을 만든다. +- **반론과 재반박**: "sample은 fixture 모듈이라 production CI에서 빼는 게 맞다" — + 일반적으로는 옳다. 그러나 이 저장소에서 sample은 **유일한 소비자**이고, + "prefix가 붙은 뒤의 실제 경로"를 아는 유일한 컨텍스트다. 최소한 계약 레인만은 넣어야 한다. + +#### M6. 에러 코드 레지스트리와 코드가 어긋난다 — 그리고 코드 어휘가 6개다 + +- **숫자**: `docs/registries/error-codes.yaml`에 `- code:` **57개**. + `shared/error/OperationalError` 상수 **54개**. + - 레지스트리에만 있고 `OperationalError`에 없음 **12개**: + `CACHE_STAMPEDE_LOCK_TIMEOUT`, `CACHE_UNAVAILABLE`, `DOWNLOAD_STREAMING_FAILURE`, + `MIGRATION_FAILED`, `PATH_TRAVERSAL_DETECTED`, `PROFILE_MISMATCH`, `REQUIRED_ADAPTER_DISABLED`, + `STARTUP_VALIDATION_FAILED`, `TENANT_NOT_SUPPORTED`, `UPLOAD_CONTENT_TYPE_REJECTED`, + `UPLOAD_SIZE_EXCEEDED`, `VALIDATION_EMAIL_FORMAT`. + 이 중 7개는 **저장소 전체 어느 Java 파일에도 없다** + (`CACHE_STAMPEDE_LOCK_TIMEOUT`, `CACHE_UNAVAILABLE`, `DOWNLOAD_STREAMING_FAILURE`, + `PATH_TRAVERSAL_DETECTED`, `TENANT_NOT_SUPPORTED`, `UPLOAD_CONTENT_TYPE_REJECTED`, + `UPLOAD_SIZE_EXCEEDED`). `MIGRATION_FAILED`/`PROFILE_MISMATCH`/`STARTUP_VALIDATION_FAILED`는 + `StartupErrorCode`라는 **다른 enum**에 있다. + - `OperationalError`에만 있고 레지스트리에 없음 **9개**: + `BAD_PARAMETER`, `BATCH_PARTIAL_FAILURE`, `FORBIDDEN`, `INTERNAL_ERROR`, `INVALID_TOKEN`, + `MAPPING_FAILED`, `ROUTE_NOT_FOUND`, `UNAUTHENTICATED`, `VALIDATION_FAILED`. + 이 9개는 전부 **`GlobalExceptionHandler`가 실제로 내보내는 코드**다. + - `ratelimit/RateLimitTransportError`의 `RATE_LIMIT_UNAVAILABLE`/`RATE_LIMIT_INCOMPATIBLE`도 + 레지스트리에 없다. +- **어휘 개수**: `ApiErrorCode` 구현체 4개(`OperationalError`, `FileserverErrorCode`, + `PortfolioErrorCode`, `RateLimitTransportError`) + `ProblemCode`(22개, 별도 카탈로그) + + `StartupErrorCode` = **6개**. +- **RFC 7807/9457 사용 여부**: 라이브 경로는 **쓰지 않는다** + (`application.yml:17-22` — `spring.mvc.problemdetails.enabled: false`). + `application/problem+json`을 실제로 내보내는 것은 fileserver 경로뿐이고 + (`fileserver/problem/FileserverExceptionHandler.java:31-45`), 그 바디는 RFC 9457이 아니라 + `FileserverProblem`이라는 자체 레코드(`retryable`/`ambiguous`/`reconciliationRequired`/ + `expectedOffset`… 확장 멤버 9개)다. 즉 **한 애플리케이션에서 성공은 엔벨로프, 파일 에러는 + problem+json, 나머지 에러는 엔벨로프**라는 3중 스키마가 나간다. +- **수정 방향**: 레지스트리를 SSOT라고 부른다면 코드→레지스트리 방향 검증 태스크가 필요하다 + (현재 `verifyEnvKeys`에 해당하는 것이 에러 코드에는 없다). 최소한 위 21개 차이를 해소한다. +- **반론과 재반박**: "레지스트리는 Phase B 산출물이고 코드는 Phase C2라 아직 수렴 중"이라고 + 파일 헤더가 밝힌다(`error-codes.yaml:6`). 사실이다. 그러나 `required_test` 컬럼이 + `contract-verification:*`를 가리키는데 그런 테스트 스위트가 저장소에 없고 + (`grep -rn "contract-verification:" src` → 0건), 레지스트리가 "Last updated: 2026-05-22"로 + 4개월째 멈춰 있다. "수렴 중"이 아니라 "포기된 SSOT"로 읽히는 상태다. + +#### M7. `headers.yaml`과 코드가 두 곳에서 정면충돌한다 + +- `X-Tenant-Id`: 레지스트리는 `direction: both`, `mdc_key: tenant_id`, + "tenant resolution 우선순위 = ... (2) 명시적 X-Tenant-Id 헤더 (admin/internal API only)" + (`docs/registries/headers.yaml`). 코드는 이 헤더를 **공격으로 간주**한다 — + `security/WebTenantContextResolver.java:19-20, 38-49`가 `x-tenant-id`를 보면 + `UntrustedTenantInputException`을 던진다. 그리고 `MdcKeys`에는 `tenant_id`가 없다 + (`observability/MdcKeys.java:6-10`). +- `X-RateLimit-*`: 레지스트리는 `generated_if_missing: true`. 코드는 레이트리밋이 켜졌을 때만 + 쓴다(`ratelimit/RateLimitInterceptor.java:91-97`), 기본값은 off. +- `Deprecation`/`Sunset`: `versioning/DeprecationHeaderWriter.java`는 배선되지 않았다. +- `X-Api-Version`: `http/ApiHeaders.X_API_VERSION` 상수만 있고 읽는 코드가 없다. +- **수정 방향**: 레지스트리를 코드에 맞추거나(특히 `X-Tenant-Id`는 "금지"로 바꿔야 한다), + `headers.yaml`을 검증하는 태스크를 만든다. + +#### M8. `SecurityErrorClassifier`가 예외 메시지 문자열에 의존한다 + +- `auth/SecurityErrorClassifier.java:69-99` — `"jwk set"`, `"expired"`, `"iss claim"`, + `"signature"`, `"signed jwt rejected"` 등 upstream(Nimbus/Spring Security) 메시지 텍스트를 + 소문자 `contains`로 매칭해 `AUTH_*` 코드를 정한다. +- **왜 문제인가**: Nimbus 또는 Spring Security 마이너 업그레이드로 문구가 바뀌면 전부 + 기본값 `AUTH_TOKEN_MALFORMED`로 조용히 무너진다. 클라이언트가 만료(재발급)와 서명오류(차단)를 + 구분할 수 없게 되는데, **테스트는 통과한다**(테스트도 같은 문자열로 픽스처를 만들 것이므로). +- **수정 방향**: `OAuth2Error.getErrorCode()`와 예외 타입(`JwtValidationException` 안의 + `OAuth2Error` 식별자)을 1차로 쓰고 텍스트 매칭은 폴백으로만 남긴다. +- **반론과 재반박**: "Nimbus가 구조화된 사유를 주지 않으므로 텍스트가 유일한 신호다" — 상당 부분 맞다. + 다만 `JwtTimestampValidator`/`JwtIssuerValidator`/자체 audience validator는 이 저장소가 직접 + 조립하므로(`auth/JwtDecoderConfig.java:73-90`) 최소한 그 세 가지는 구조화된 코드로 바꿀 수 있다. + +#### M9. `ci`가 실서버 매트릭스 3개를 끌어오게 됐다 (커밋 안 된 변경) + +- `systemTest`/`webJettyCompatTest`/`webFluxContractTest`가 모두 `system()` 카테고리가 되면서 + `systemTestLaneCheck → systemTestCheck → qualificationCheck → ci`에 묶였다 + (`build.gradle:41-46, 77-91, 21-35`; `src/build.gradle:121-142`). + 이전에는 Tomcat IT만 `test` 안에 있었고 Jetty/WebFlux는 `pr-adapters.yml`/`integration-main.yml`의 + 별도 job이었다. +- **판정**: 게이트 강화 자체는 좋으나, 같은 레인을 워크플로가 **중복 실행**하게 됐다 + (`integration-main.yml:73-75`가 `:adapter:inbound:web:webJettyCompatTest`, + `:adapter:inbound:web:webFluxContractTest`를 직접 호출한다). PR 시간이 두 배가 된다. +- **수정 방향**: `ci`에 넣든 워크플로에 두든 한쪽으로 정리한다. + +### Low + +- **L1.** `CacheControlFilter`(`filter/CacheControlFilter.java:21`, order `HIGHEST+20`)와 + `WebMvcEvidenceFilter`(`mvc/filter/WebMvcEvidenceFilter.java:39`, order `HIGHEST+20`)의 + 순서가 **같다**. 둘이 서로 간섭하지 않아 현재는 무해하지만, 순서가 우연에 맡겨져 있다. +- **L2.** `mvc/error/WebMvcProblemExceptionHandler.java:176`과 + `webflux/error/WebFluxProblemExceptionHandler.java:170`이 `request.getAttribute("webTraceId")`를 + 읽는데, **이 문자열 키를 쓰는 코드가 저장소에 없다**(`grep -rn '"webTraceId"' src` → 이 2건뿐). + `WebMvcRequestIdFilter.TRACE_ID_ATTRIBUTE`는 FQCN 기반 키다. 두 핸들러는 항상 zero trace를 낸다. +- **L3.** `VirtualThreadProfile.propertyName()`(`advanced/virtualthread/VirtualThreadProfile.java`)이 + `backend.web.advanced.virtual-threads.enabled`를 반환하는데 실제 조건은 + `backend.web.advanced.mvc-virtual-threads`다(`advanced/mvc/VirtualThreadMvcConfiguration.java:32`). +- **L4.** `cursor/CursorCodec.withDevKey()`가 하드코딩 키 + `"ca-skeleton-dev-cursor-key-0001"`를 들고 있다. 현재 호출처는 테스트뿐이지만, + 같은 leaf에 키링 기반의 올바른 구현(`pagination/HmacWebCursorCodec` + `WebCursorKeyRing`)이 + 따로 있다. 커서 코덱이 2개인 것도 중복. +- **L5.** 페이지네이션 계약이 2개다. `PageParams`(offset, default 20 / max 100, + `pagination/PageParams.java:8-11`) vs `WebPageSizePolicy`(cursor, default 50 / max 200, + `pagination/WebPageSizePolicy.java:6-8`). 정렬 문법도 반대다 — + `SortParam.parse`는 `-field`를 **거부**하고(`pagination/SortParam.java:16-22`) + `WebCollectionRequestParser.parse`는 `-field`를 내림차순으로 **해석**한다(`:35`). +- **L6.** `openapi/WebOpenApiCustomizer`는 springdoc의 `OpenApiCustomizer` 빈이 아니므로 + `Problem`/`CursorPage` 스키마가 생성 스펙에 들어가지 않는다. 실제 등록된 커스터마이저는 + `config/OpenApiContractConfig.java:26`(ApiError.details) 하나뿐. +- **L7.** `CLAUDE.md:8`이 "Spring Boot 4.0.0", 루트/브리프는 4.0.8. `build.gradle:9-11` 주석은 + "23 Stable Gradle modules"라 적지만 `WebStableModule` enum은 60개 모듈을 선언한다. +- **L8.** `config/capabilities.yml` 마지막 줄이 값 없는 `security:` 키로 끝난다(71행). + 바인딩 대상이 없어 무해하지만 미완성 흔적이다. (이 영역 밖이지만 web 토글을 읽다 발견.) +- **L9.** `src/.env`의 `SECURITY_PUBLIC_PATHS=/api/healthcheck`는 `PRESENTATION_API_BASE_PATH=/api`와 + 일치하지만, 두 키 모두 `.env.example`과 `env-keys.yaml`에 없어 fork가 복사할 수 없다. + +--- + +## 6. 바꾸지 말 것 (Keep) + +### K1. 인바운드 HTTP 어댑터에 마스터 토글을 만들지 않은 것 + +- **무엇**: `spring-boot-starter-web`이 leaf의 `implementation`이고, `SecurityConfig`· + `GlobalExceptionHandler`·`EnvelopeBodyAdvice`가 조건 없이 컴포넌트 스캔된다. + 다른 능력들(fileserver, notification, messaging, cache)과 달리 `enabled` 스위치가 없다. +- **왜 지금 이게 맞는가**: 이 템플릿의 배포 단위는 HTTP 서비스 1개다(`Dockerfile`이 8080/9001을 + 노출하고, `app-bootstrap`이 유일한 컴포지션 루트다). HTTP를 끄면 남는 게 없다. + 토글을 만들면 (a) 꺼진 상태를 테스트해야 하고 (b) "웹이 꺼진 배포"라는 존재하지 않는 형상을 + 문서화해야 하며 (c) `backend.web.mvc.enabled=false`가 이미 그 절반을 흉내내면서 + §3.2에서 본 "절반만 꺼지는" 혼란을 만들고 있다. +- **언제 재검토**: 이 저장소가 배치 전용/컨슈머 전용 배포 프로파일을 갖게 되면. + 그때는 `backend.web.mvc.enabled`를 진짜 마스터로 승격하고 컴포넌트 스캔 대상을 + `mvc.error`처럼 오토컨피그 소유로 옮겨야 한다. + +### K2. 컨트롤러 경계 규칙을 애너테이션 술어로 판정하고, 그걸 컴포지션 루트에서 돌리는 것 + +- **무엇**: `CleanArchitectureRuleSupport.ARE_CONTROLLERS`(애너테이션 + 패키지 OR)와 + `AdapterBoundaryArchitectureTest.CONTROLLERS_DO_NOT_ACCESS_REPOSITORIES_OR_JPA_ENTITIES`, + 그리고 그것을 `dev.caskeleton` 전체 그래프에 적용하는 + `app-bootstrap/src/architectureTest` 소스셋(위반 픽스처 60여 개 포함). +- **왜 지금 이게 맞는가**: HARD-STOP #2/#3이 이 규칙들 때문에 실제로 0건이다(§4). + 특히 `ARE_CONTROLLERS`의 javadoc이 **왜 패키지 셀렉터를 버렸는지**를 실패 사례와 함께 기록하고 + 있다 — 규칙이 왜 그 모양인지 6개월 뒤에도 알 수 있다. `violations/` 아래 픽스처가 + "이 규칙은 실패할 수 있다"를 증명하는 것도 드물게 잘 된 부분이다. +- **언제 재검토**: leaf가 늘어 `importPackages("dev.caskeleton")`의 메모리/시간이 문제가 될 때. + 그때도 규칙을 leaf로 되돌리지 말고 import 옵션을 좁혀야 한다. + +### K3. `WebStableModule` + `WebModuleBoundaryTest` — Gradle 모듈 대신 패키지로 쪼개되, 소스 스캔으로 강제한 것 + +- **무엇**: 설계의 23(실제로는 60) Stable 모듈을 별도 Gradle leaf가 아니라 패키지로 두고, + `WebStableModule` enum이 `id / packageSuffix / purity(CORE|FRAMEWORK_BOUND) / allowedDependencies`를 + 선언한다. `WebModuleBoundaryTest`가 **소스 트리를 직접 읽어** 미선언 edge, 선언됐지만 없는 모듈, + CORE 모듈의 프레임워크 import를 거부하고, 각각에 대해 `@TempDir` 네거티브 픽스처로 실패를 증명한다. +- **왜 지금 이게 맞는가**: `modules.json`이 leaf 목록의 SSOT이므로 웹 플랫폼을 23개 leaf로 + 쪼개는 것은 레지스트리 정책과 충돌한다. Gradle 의존 게이트는 leaf 안을 못 본다 — + 그 빈틈을 소스 스캔이 정확히 메운다. 이 leaf에서 가장 신뢰할 수 있는 검증 장치다. +- **언제 재검토**: 웹 플랫폼이 실제로 별도 제품으로 분리되어 `modules.json`에 자기 leaf를 갖게 될 때. + +### K4. `advanced/codec`의 CBOR/XML을 `compileOnly`로 둔 것 + +- **무엇**: `build.gradle:38-56` — `jackson-dataformat-cbor`/`-xml`이 `compileOnly`. + `WebRepresentation.available()`(`advanced/codec/WebRepresentation.java:29-36`)이 런타임 부재를 + 문장으로 바꾸고, `WebXmlMapperFactory.requireBackend()`가 명확한 예외를 던진다. +- **왜 지금 이게 맞는가**: build.gradle 주석이 실제 사고를 기록한다 — 이 jar가 런타임에 있으면 + Boot가 `xmlMapper`/`cborMapper`를 자동 등록하고 Spring이 `application/xml` 메시지 컨버터를 + 붙여서 **아무도 켜지 않은 XML 역직렬화(=XXE 표면)가 전 배포에 생긴다.** 꺼진 기술이 비용을 + 물지 않아야 한다는 목표의 교과서적 적용이다. +- **언제 재검토**: Boot가 이 자동 등록을 조건부로 바꾸면. + (덧붙여 `SecureXmlInputFactory`가 DTD/외부 엔티티를 막고 `WebXmlMapperFactory`가 + 안전하지 않은 factory를 거부하는 것도 같이 유지할 것.) + +### K5. 컨테이너별 실서버 레인을 소스셋으로 분리한 것 (Tomcat / Jetty / Reactor Netty / Nginx) + +- **무엇**: `jettyCompatTest`는 Tomcat을 exclude하고, `webfluxContractTest`는 아무것도 상속하지 + 않으며(Tomcat이 classpath에 오면 Boot가 서블릿으로 판정하므로), 각 IT의 첫 단언이 + **"지금 뜬 서버가 그 서버가 맞는가"**다(`JettyWebContractIT.java:35-41`). + `nginxProxyTest`는 Docker가 필요하다는 이유로 분리돼 `check`를 오염시키지 않는다. +- **왜 지금 이게 맞는가**: "호환성 매트릭스가 같은 컨테이너를 두 번 인증하는" 실패는 조용하다. + 그걸 구조(소스셋)와 단언(서버 클래스명) 양쪽으로 막았다. + `StrictTestLanePlugin`이 "소스 없는 레인", "전부 skip된 레인", "requires에 적었는데 안 돈 테스트"를 + 전부 실패로 만드는 것(`StrictTestLanePlugin.java:44-62, 162-215`)도 같은 철학이고 유지할 가치가 있다. +- **언제 재검토**: 레인 수가 PR 시간을 지배하기 시작하면 — 그때는 레인을 지우지 말고 + PR/nightly로 나눈다(M9 참조). +- **`jettyCompatTest`가 지금도 의미가 있는가 — 있다(8파일 전문 확인).** + `application-web-contract.yaml`이 `testFixtures/resources/`로 옮겨진 것은 이 레인에 아무 영향이 + 없다. 레인은 그 파일을 **소유한 적이 없고 `@ActiveProfiles("web-contract")`로 소비할 뿐**이다. + 레인의 8파일은 전부 공유 계약 클래스를 상속한 얇은 껍데기이고, 상속하는 계약이 곧 검증 내용이다: + 상태 계약(`WebContractAssertions` 7종), 예산(`WebBudgetContract`), throttle(`WebThrottleHttpContract`), + 멱등성 응답 유실(`IdempotencyResponseLossContract` 4종), 오퍼레이션(`OperationHttpContract`), + 파이프라인 순서(`WebPipelineOrderContract` 10종), 부하+graceful shutdown(`WebLoadAndShutdownContract`), + 패리티 레코딩(`WebPlatformContractRecording`). 여기에 레인 고유 단언이 하나 붙는다 — + `JettyWebContractIT.theLaneIsActuallyRunningOnJetty`가 + `context.getWebServer().getClass().getName()`에 "Jetty"가 들어 있는지 본다. + **즉 "Tomcat이 classpath에 남아 같은 컨테이너를 두 번 인증하는" 실패를 구조와 단언 양쪽으로 + 막는다.** 이 레인을 지우면 두 번째 서블릿 컨테이너에 대한 유일한 증거가 사라진다. +- **다만 한계도 같이 적는다**: 이 레인이 증명하는 것은 **"픽스처 애플리케이션이 Jetty에서도 + Tomcat과 같게 동작한다"**이지 "이 배포가 Jetty에서 뜬다"가 아니다(§1.2). 컨테이너 교체를 + 실제로 계획한다면 `CaSkeletonApplication`을 Jetty로 한 번 띄우는 스모크가 따로 필요하다. + +### K6. `RestrictedPathRule` — 두 번째 SecurityFilterChain 대신 기여 포인트를 만든 것 + +- **무엇**: `auth/RestrictedPathRule.java` + `auth/SecurityConfig.java:73-93`. + 관리 표면을 가진 모듈이 체인을 새로 만들지 않고 규칙 레코드 하나를 빈으로 기여한다. + 빈 권한 목록은 생성자에서 거부한다(`RestrictedPathRule.java:30-34`). +- **왜 지금 이게 맞는가**: 두 번째 체인은 JWT 디코딩·세션·엔벨로프 엔트리포인트를 통째로 + 재진술해야 하고, 두 사본의 드리프트가 곧 인가 구멍이다. 그 판단은 옳다. + (다만 H4-3에서 본 대로 패턴이 prefix를 모른다 — 기여 포인트는 유지하되 패턴 조립을 고쳐야 한다.) +- **언제 재검토**: 관리 플레인이 완전히 별도 포트/프로세스로 확정되면 규칙 자체가 불필요해진다. + +### K7. `ExperimentalApi` 애너테이션과 draft-12 라우트의 분리 + +- **무엇**: `fileserver/draft12/ExperimentalApi.java`(`specification` 필수), + 경로가 `/v1/experimental/draft12/uploads`로 명시적으로 격리, 토글이 2단 + (`app.fileserver-platform.enabled` AND `httpbis-draft12.enabled`). +- **왜 지금 이게 맞는가**: IETF 드래프트는 번호가 바뀌면 와이어가 바뀐다. 경로·토글·애너테이션 + 셋 다에 "experimental"이 박혀 있어서, 이걸 켠 배포는 자기가 뭘 켰는지 모를 수 없다. +- **언제 재검토**: 드래프트가 RFC가 되면 경로에서 `experimental`을 떼고 토글을 하나로 합친다. + +### K8. 픽스처 애플리케이션과 픽스처 컨트롤러를 배포에서 떼어 놓는 2중 방어 + +- **무엇**: 픽스처 앱 4개는 `dev.caskeleton.webtestkit`, 즉 **컴포지션 루트의 스캔 루트 밖**에 있고, + 픽스처 컨트롤러 9개는 스캔 루트 안에 있되 전부 `@RestController` + **`@TestComponent`**를 단다. +- **왜 지금 이게 맞는가**: 이유가 코드 주석에 정확히 적혀 있다 — + 픽스처 앱이 스캔 루트 안에 있으면 그 permit-all `SecurityFilterChain`이 진짜 체인을 가려 + "도달 불가능한 필터 체인"으로 컨텍스트가 기동 실패한다. `@TestConfiguration`으로 막고 싶어도 + `@SpringBootTest(classes = ...)`가 그 타입을 받지 않는다. **그래서 패키지 위치가 방어 수단이다.** + 픽스처 컨트롤러 쪽도 같은 주석이 붙어 있다 — "a plain `@RestController` in this package is + scanned into the real application, publishing fixture routes in a deployment." + 이건 흔한 사고이고, 이 저장소는 이유까지 남겨 뒀다. +- **언제 재검토**: `testFixtures`를 다른 leaf가 `implementation`으로 끌어오려 할 때. + 그 순간 픽스처 컨트롤러 9개가 배포 클래스패스에 올라가고, 막는 것은 `@TestComponent` 하나뿐이다. + 차라리 픽스처 컨트롤러도 `dev.caskeleton.webtestkit` 아래로 옮기는 편이 방어가 하나 더 는다. + +### K9. 인증 테스트 3개가 실제 `springSecurityFilterChain` 빈을 꺼내 MockMvc에 끼우는 방식 + +`auth/CorsSecurityFilterIntegrationTest`(`@Tag("security-boundary")`), +`auth/SecurityModeWebContractTest`, `auth/JwtJwksSecurityFilterIntegrationTest` 셋은 +`WebApplicationContextRunner`로 컨텍스트를 올린 뒤 +`context.getBean("springSecurityFilterChain", Filter.class)`를 꺼내 +`MockMvcBuilders.standaloneSetup(new ProbeController()).addFilters(...)`에 끼운다. +`JwtJwks...`는 실제 임베디드 OIDC 서버까지 띄워 discovery·JWKS 요청 횟수와, +발급자 불일치·JWKS 불능 상황의 응답 바디가 내부 정보를 흘리지 않는지까지 단언한다. + +**이건 §1.1에서 지적한 분포의 예외이고, 유일하게 "체인이 실제로 어떻게 도는지"를 보는 테스트다.** +보안 설정을 리팩토링할 때 이 세 개를 `@WebMvcTest`나 단위 테스트로 "단순화"하고 싶어질 텐데, +그 순간 CORS preflight·credential 모드·JWT 검증 경로에 대한 유일한 실행 증거가 사라진다. +오히려 **이 형태를 레이트리밋·멱등성·알림 콜백으로 확장하는 것**이 §5 H2·H3·H4의 재발 방지책이다. + +--- + +## 7. 커밋 안 된 리팩토링이 이 영역에 미친 영향 + +### 7.0 먼저: 이 diff는 "삭제"가 아니다 + +`git diff HEAD`는 untracked 파일을 담지 않는다. 그래서 tracked 기준 −22,532줄이 찍혔지만, +untracked 추가가 +21,270줄(175파일)이고 **실제 순증감은 약 +1,112줄**이다. +이 영역(`src/adapter/inbound/web`)의 untracked 추가는 **303줄 / 9파일**이다. + +나는 이 영역에 대해 삭제분과 신규분을 **파일 단위로 대조 검증했다.** +`full.diff`에서 삭제된 본문을 추출해 스냅샷의 새 파일과 비교한 결과: + +| diff에서 삭제된 경로 | 스냅샷의 새 경로 | 결과 | +|---|---|---| +| `test/.../testkit/budget/TomcatWebBudgetIT.java` | `systemTest/.../budget/TomcatWebBudgetIT.java` | **IDENTICAL** | +| `test/.../testkit/contract/TomcatContractRecordingIT.java` | `systemTest/.../contract/` | **IDENTICAL** | +| `test/.../testkit/fault/CommitThenConnectionResetIT.java` | `systemTest/.../fault/` | **IDENTICAL** | +| `test/.../testkit/mvc/TomcatWebContractIT.java` | `systemTest/.../mvc/` | **IDENTICAL** | +| `test/.../testkit/operation/TomcatOperationHttpIT.java` | `systemTest/.../operation/` | **IDENTICAL** | +| `test/.../testkit/order/MvcPipelineOrderIT.java` | `systemTest/.../order/` | **IDENTICAL** | +| `test/.../testkit/throttle/TomcatWebThrottleIT.java` | `systemTest/.../throttle/` | **IDENTICAL** | +| `test/.../testkit/performance/TomcatLoadAndShutdownIT.java` | `performanceTest/.../performance/` | **IDENTICAL** | +| `test/resources/application-web-contract.yaml`
`jettyCompatTest/resources/…`
`webfluxContractTest/resources/…` (동일 내용 3부) | `testFixtures/resources/application-web-contract.yaml` (1부) | **IDENTICAL**, 3→1 중복 제거 | + +같은 패턴이 인접 영역에도 있다: `websocket`의 IT 3개 → `websocket/src/systemTest/`, +`sample-portfolio`의 `OpenApiSnapshotTest`·`OpenApiDriftContractTest`·`DateHeaderContractTest`· +`VirtualThreadMdcE2ETest`·`worklogs-openapi-snapshot.json` → `sample-portfolio/src/webSystemTest/`. + +### 7.1 이 리팩토링이 무엇인가 — "검증 축소"가 아니라 "조립 소유권 이전" + +오늘 날짜(2026-09-18)로 작성된 spec/plan 20개가 untracked로 들어와 있고, 전부 같은 주제다: +**capability composition ownership** — 재사용 가능한 Spring 조립을 `app-bootstrap`에서 +각 capability leaf 안으로 옮기고, `app-bootstrap`에는 트랜잭션 경계와 inbound 유스케이스 +구성만 남긴다. + +내 영역에 직접 걸리는 문장이 두 개 있다 +(`docs/superpowers/specs/2026-09-18-test-architecture-phase2-provider-ownership.md`): + +- Follow-up slice 3: "Fileserver: fileserver owns local filesystem behavior, persistence-jpa owns + metadata persistence/migration, **inbound web owns transport**, bootstrap/system owns only the + final assembled journey if still needed." +- Acceptance: "**moved provider tests live on a provider source set, not ordinary `test`**; + Docker/provider absence **fails the required lane** rather than becoming an approved JUnit skip." + +`systemTest`/`performanceTest` 소스셋 신설은 두 번째 문장의 직접 구현이다. +그리고 `StrictTestLanePlugin`이 (a) 소스 없는 레인, (b) 전부 skip된 레인, +(c) `requires`에 적었는데 안 돈 테스트를 모두 실패로 만드는 것 +(`StrictTestLanePlugin.java:44-62, 162-215`)이 "fails the required lane"의 집행 장치다. +**방향은 이 프로젝트의 목표(능력별 소유권 + 끌 수 있는 능력)와 일치한다.** + +### 7.2 판정 세 가지 + +브리프가 요구한 세 질문에 대해, 이 영역에서 확인한 결과다. + +**(1) 양쪽에 다 없는 것(진짜 손실) — 없다.** +이 leaf에서 tracked 삭제 11건(IT 8 + yaml 3) 전부가 untracked 신규 9건으로 대응된다 +(yaml 3→1은 의도된 중복 제거). `git status`의 ` D` 11줄과 `??` 3줄(디렉터리 2 + 파일 1)이 +정확히 맞물린다. 위 표의 바이트 동일성 검증이 근거다. +부수적으로 `src/test/resources/`가 비었고 `contract/.gitkeep`·`mvc/.gitkeep`만 남았다 — +정리 잔여물이지 손실이 아니다. + +**(2) 양쪽에 다 있는 것(중복 조립 → 빈 충돌) — 이 leaf에는 없다.** +`app-bootstrap`에서 web leaf 타입을 조립하는 곳은 4개 파일 +(`autoconfigure/fileserver/{FileserverPlatformAutoConfiguration,FileserverAdminPlaneConfiguration, +FileserverAdminManagementContextConfiguration,FileserverStartupConfiguration}.java`)이고, +거기서 만드는 빈 타입(`FileserverWebProperties`, `TransferExecutorProperties`, +`FileserverRequestContextFactory`, `FileserverProblemFactory`, `RawUploadRequestMapper`, +`MultipartUploadRequestMapper`, `MvcConditionalRequestFactory`, `MvcDownloadResponseWriter`, +`ZeroCopyEligibility`, `NginxDelegationProperties`, `NginxInternalUriMapper`, +`NginxDownloadStrategy` 등)과 web leaf가 스스로 만드는 빈 타입 +(`MvcTransferExecutorConfiguration`의 `ThreadPoolTaskExecutor fileserverTransferExecutor`, +`BlockingTransferExecutor blockingTransferExecutor`)은 **겹치지 않는다.** +`WebMvcPlatformAutoConfiguration`이 만드는 13개 빈과도 겹치지 않는다. +→ 이중 조립으로 인한 빈 충돌은 확인되지 않았다. + +**(3) untracked라서 커밋하면 사라지는 것 — 있다. 그리고 치명적이다.** +`git add` 없이 `git commit -a`를 하면 tracked 수정/삭제만 스테이징되고 untracked는 남는다. +이 leaf에서 그 결과는: + +- `build.gradle`은 `systemTest`/`performanceTest` 소스셋과 레인을 **선언한 채로** 커밋되고, +- 그 소스셋의 파일 8개는 **저장소에 존재하지 않게 되며**, +- 다섯 레인이 공유하던 `application-web-contract.yaml`은 **한 부도 남지 않는다** + (기존 3부는 삭제로 커밋, 새 1부는 untracked). + +즉 **Tomcat 실서버 IT 8개와 `web-contract` 프로파일이 통째로 증발한다.** +그 상태에서 `systemTest` 레인이 선택되면 `StrictTestLanePlugin.java:52-62`가 +"has no sources in source set 'systemTest'"로 실패하고, `@ActiveProfiles("web-contract")`를 +쓰는 25곳(jetty/webflux 레인 포함)은 프로파일 문서 없이 돌게 된다. +같은 위험이 websocket(3파일)과 sample-portfolio(4파일 + 스냅샷 JSON)에도 있다. + +→ **이 리팩토링을 커밋하는 사람은 `git add src/adapter/inbound/web/src/systemTest +src/adapter/inbound/web/src/performanceTest +src/adapter/inbound/web/src/testFixtures/resources`를 먼저 해야 한다.** +`git status --porcelain`의 `??` 줄이 그대로 남아 있으면 커밋하면 안 된다. + +### 7.3 새 소스셋의 의존 선언 — 초판에서 틀렸던 부분 + +초판은 여기서 "새 `systemTest`/`performanceTest` 소스셋이 테스트 의존을 하나도 선언하지 않아 +컴파일이 깨진다"고 판정했다(당시 C1). **그 판정은 틀렸고 철회했다.** + +`AuxiliarySourceSetSpec.java:10-11`에서 `inheritedTestConfigurations`의 **기본값이 +`["implementation", "runtimeOnly"]`**다. 즉 `inherits`를 **쓰지 않으면** 기본값이 적용되어 +`systemTestImplementation extendsFrom testImplementation`, +`systemTestRuntimeOnly extendsFrom testRuntimeOnly`가 걸린다 — +`spring-boot-starter-test`와 `junit-platform-launcher`를 그대로 받는다. +`inherits 'implementation'`(jettyCompatTest, nginxProxyTest)은 오히려 **기본값보다 좁고**, +`inherits()`(webfluxContractTest)는 `clear()`만 하므로 진짜 아무것도 상속하지 않는다. +상세는 §9의 철회 기록에 있다. + +> **판정: 방향도 옳고(spec이 요구한 provider source set 분리 + 중복 제거 + `test` 경량화), +> 이동 자체도 무손실이며, 새 소스셋의 의존 배선도 정상이다. 남은 마감은 하나 — `git add`(§5 C3). +> 지금 상태로 `git commit -a`하면 실서버 IT 8개와 `web-contract` 프로파일이 사라진다.** + +### 7.4 절반만 옮겨진 소유권 — 이 leaf의 다음 작업 + +spec이 "inbound web owns transport"라고 적었는데, 현재 소유권은 이렇게 갈려 있다. + +| 조립 대상 | 현재 소유자 | spec 목표 | +|---|---|---| +| 웹 플랫폼(문제 카탈로그·예산·오퍼레이션 카탈로그·requestId/evidence 필터) | **web leaf** (`AutoConfiguration.imports`) | 유지 | +| WebFlux 플랫폼 | **web leaf** | 유지 | +| Fileserver HTTP transport 빈 18개 | **app-bootstrap** (`FileserverPlatformAutoConfiguration:87-300`) | web leaf로 이동 대상 | +| Fileserver 관리 플레인 + 역할 게이트 | **app-bootstrap** (`FileserverAdminPlaneConfiguration`, `FileserverAdminManagementContextConfiguration`) | 이동 대상 | +| Fileserver 전송 스레드풀 | **web leaf** (`MvcTransferExecutorConfiguration`) | 이미 이동됨 | +| 알림 콜백/제출 HTTP 표면 | web leaf(컨트롤러) + app-bootstrap(`NotificationApplicationCompositionAutoConfiguration`) | 갈림 | + +이 절반 상태가 만드는 실질 문제 두 개: + +1. **역방향 의존이 생겼다.** `MvcTransferExecutorConfiguration.java:26`의 + `fileserverTransferExecutor(TransferExecutorProperties, TaskDecorator taskDecorator)`는 + `TaskDecorator` 빈을 필수 인자로 받는데, 그 빈의 유일한 제공자는 + `app-bootstrap`의 `AsyncContextTaskDecorator`다(`bootstrap/async/AsyncContextTaskDecorator.java:14`). + `ObjectProvider` 폴백이 없다. **capability leaf의 `@Configuration`이 컴포지션 루트의 빈에 + 의존하는 형태**이고, 이건 지금 진행 중인 이전이 없애려는 바로 그 결합이다. + fork가 그 데코레이터를 지우거나 이름을 바꾸면 fileserver가 unsatisfied dependency로 기동 실패한다. + `advanced/mvc/VirtualThreadMvcConfiguration.java:67`도 같은 형태다. +2. **§5 H4-3의 역할 게이트 구멍이 이 절반 상태에서 나온다.** 어드민 컨트롤러는 web leaf에 있고, + 그것을 관리 컨텍스트에 넣는 결정과 역할 패턴(`/internal/fileserver/**`)은 app-bootstrap에 있고, + 실제 경로에 prefix를 붙이는 `PresentationWebConfig`는 다시 web leaf에 있다. + **세 조각이 세 곳에 흩어져 있어서 아무도 최종 경로를 모른다.** + +### 7.5 부수 효과 두 가지 + +1. **게이트가 넓어졌다.** `webCrossStackParityTest`의 `dependsOn`이 `'test'` → `'systemTest'`로 + 바뀌고, `systemTest`/`webJettyCompatTest`/`webFluxContractTest` 세 레인이 전부 + `system()` 카테고리가 되면서 `systemTestCheck → qualificationCheck → ci`에 들어왔다(§5 M9). + 의도는 좋으나 `integration-main.yml:73-75`·`pr-adapters.yml:144`와 중복 실행된다. +2. **`test`가 가벼워졌다.** `./gradlew :adapter:inbound:web:test`가 더 이상 실서버를 8번 띄우지 + 않는다. 개발자 루프 개선으로는 명확한 이득이고, spec의 "not ordinary `test`"와도 맞는다. + +--- + +## 8. 템플릿 사용자 관점 + +fork해서 이 leaf를 쓰는 사람이 순서대로 밟게 되는 것: + +1. **`src/.env.example`을 복사한다.** 거기엔 `PRESENTATION_API_BASE_PATH`도 + `SECURITY_PUBLIC_PATHS`도 없다. 그래서 `config/runtime.yml`의 기본값 `/v1`이 먹는다. + → 모든 라우트가 `/v1` 아래로 가고, fileserver를 켜면 `/v1/v1/files`가 된다(§5 H4). + → `docs/fileserver/http-contract.md`와 안 맞는다. 이걸 깨닫는 데 걸리는 시간이 이 템플릿의 + 첫 번째 지뢰다. + +2. **컨트롤러를 하나 만든다.** `@RequestMapping("/orders")`로 쓰면 `/v1/orders`가 된다. + 여기까지는 정상 동작하고 `VersioningPrefixTest`가 그걸 증명한다. + +3. **응답 모양을 정한다.** 자동으로 `{success,data,meta}`로 감싸진다(`EnvelopeBodyAdvice`). + 그런데 같은 leaf의 `WebSuccessResponse`/`ProblemCatalog`/`problem-catalog.yaml`/ + `ProblemSchemaContributor`는 RFC 9457을 말한다. 어느 쪽을 믿어야 하는지 코드가 답하지 않는다(§5 C2). + → **fork 첫날 반드시 결정해야 하는 항목인데, 템플릿이 결정을 위임하지 않고 두 개를 다 준다.** + +4. **에러 코드를 추가한다.** `PortfolioErrorCode`가 예시다(`ApiErrorCode` 구현). + `docs/registries/error-codes.yaml`에 등록해야 한다고 문서가 말하지만, 등록 여부를 검사하는 + 태스크가 없고 레지스트리는 이미 21개가 코드와 어긋나 있다(§5 M6). + +5. **인증을 붙인다.** `APP_SECURITY_JWT_ISSUER`는 기본값이 없어 반드시 채워야 하고 + (`SecuritySettings.java:31-34`가 기동을 거부한다), 그건 옳다. + `ca-skeleton.authz.role-permissions`의 기본값에 **sample 도메인 권한이 들어 있다** — + `config/security.yml:39-41`의 `user: worklog:read,worklog:write` / `admin: ...worklog:close`. + fork가 지워야 하는 항목인데 `sample-portfolio` 격리 원칙에 구멍이다. + +6. **`@RequiresPermission`을 쓴다.** `MethodSecurityConfig` + `AuthorizationAdapter`가 + 바로 동작한다. 이 부분은 깔끔하다. + +7. **레이트리밋을 켠다.** `APP_RATE_LIMIT_ENABLED=true` + `APP_RATE_LIMIT_PROVIDER=redis`. + 기본 `client-ip-mode=remote-addr-only`가 안전해 보이지만 XFF로 우회된다(§5 H3). + +8. **멱등성을 기대한다.** `Idempotency-Key`를 받는 인프라가 HTTP 계층엔 없다(§5 H2). + `application-core`의 `IdempotencyExecutor`를 유스케이스 안에서 직접 호출해야 하고, + 그 방법은 `sample-portfolio/.../PublishPosterImageUseCase.java`를 읽어야 알 수 있다. + +9. **테스트를 돌린다.** `./gradlew :adapter:inbound:web:test`는 실서버를 8번 띄우지 않게 되어 + 가벼워졌다(좋다). `./gradlew :ci`를 돌리면 Tomcat·Jetty·Reactor Netty 3레인이 실서버로 뜨고, + Docker가 있으면 Nginx 레인까지 돈다. **인상은 "이 템플릿은 실서버로 검증된다"이고, + 그 인상은 절반만 맞다.** 전부 통과해도 배선은 검증되지 않는다 — + 테스트 클래스 126개 + 보조 소스셋 26개 전부가 대상을 이름으로 지정해 올리고, + 배포 컨텍스트가 무엇을 조립했는지 묻는 것이 0개다(§1.1·§1.2). + 구체적으로 fork 사용자가 오해하게 되는 것 셋: + - "파이프라인 순서가 실서버로 고정됐다" → 픽스처가 직접 쓴 필터의 순서다(§5 H7). + - "에러 계약이 3스택 패리티로 고정됐다" → 고정된 것은 problem+json이고 + 이 애플리케이션은 `{success,error,meta}`를 내보낸다(§5 C2). + - "프록시 뒤 forwarded 헤더 처리가 실 Nginx로 검증됐다" → 검증된 것은 테스트용 `nginx.conf`와 + 배포가 쓰지 않는 `ForwardedHeaderSanitizer` 경로다(§5 H3). + 실제로 H2·H3·H4·H6·H7의 미배선이 25,029줄 테스트를 그대로 통과한다. + +10. **웹 플랫폼(`advanced/`, `mvc/`, `webflux/`, `budget/`, `operationasync/` …)을 발견한다.** + 16,000줄짜리 고품질 라이브러리인데, 어떻게 켜는지 알려주는 예제가 없다. + `backend.web.advanced.*` 플래그 10개는 읽히지 않는다(§5 M1). + → fork 사용자가 실제로 할 일은 이 부분을 **삭제**하는 것이다. 그런데 삭제하면 + `WebModuleBoundaryTest`(선언됐지만 소스 없는 모듈 거부)와 `WebAdvancedReleaseTest` + (기능 12개 고정)가 깨진다. **즉 안 쓰는 것을 지우는 비용이 남겨두는 비용보다 크다.** + +**손대야 하는 파일 최소 목록:** +`src/.env`(또는 `.env.example`), `config/security.yml`(role-permissions), +`config/runtime.yml`(api-base-path), +`config/PresentationWebConfig.java` 또는 fileserver/notification 라우트 리터럴(H4), +`envelope/EnvelopeBodyAdvice.java` 또는 `error/ProblemCatalog.java` 중 하나 제거(C2), +`mvc/autoconfigure/WebMvcPlatformAutoConfiguration.java`에 `WebPlatformStartupValidator` 배선(H6). + +--- + +## 9. 미확인 / 가정 + +### 9.0 코디네이터 반증으로 철회한 주장 — 구 C1 + +**철회한 주장(초판 C1):** "새 `systemTest`/`performanceTest` 소스셋이 테스트 의존을 하나도 +선언하지 않았다. 따라서 `compileSystemTestJava`가 심볼을 못 찾고 실패하고, 그 레인이 +`systemTestCheck → qualificationCheck → ci`에 묶여 있으므로 **현재 워킹트리는 PR 게이트를 +통과할 수 없다.**" — Critical로 올렸다. + +**반증 (코디네이터가 플러그인 소스를 읽어 제시, 내가 재확인함):** + +`build-logic/src/main/java/dev/caskeleton/buildlogic/auxiliary/AuxiliarySourceSetSpec.java:10-11` + +```java +private final List inheritedTestConfigurations = + new ArrayList<>(List.of("implementation", "runtimeOnly")); +``` + +**기본값이 비어 있지 않다.** `inherits(String... names)`는 `clear()` 후 인자를 채우는 +*덮어쓰기* 메서드다(`:39-42`). `AuxiliarySourceSetExtension.java:68-90`이 이 목록을 +`test{Capitalized}` → `{sourceSet}{Capitalized}`로 매핑해 `extendsFrom`을 건다. +따라서 세 가지가 전부 다른 뜻이다: + +| 선언 | 실제 상속 | +|---|---| +| `inherits` 없음 (systemTest, performanceTest, graphql의 systemTest) | 기본값 적용 → `testImplementation` + `testRuntimeOnly` 상속. **`spring-boot-starter-test`와 JUnit 런처를 받는다** | +| `inherits 'implementation'` (jettyCompatTest, nginxProxyTest) | `testImplementation`만. **기본값보다 좁다** | +| `inherits()` (webfluxContractTest) | `clear()` 후 아무것도 안 넣음 → 진짜 무상속 | + +즉 `inherits`를 쓰지 않은 것은 **가장 넓은 상속**이고, 다른 레인들이 굳이 의존을 적는 것은 +기본값을 **좁히기 위해서**다. 내가 "다른 레인은 적는데 이 둘만 안 적었다"를 결함의 증거로 읽은 것이 +정확히 거꾸로였다. + +**두 가지 교차 확인:** + +1. 같은 `build.gradle`의 `webfluxContractTest` 주석이 직접 이렇게 적고 있다 — + "Inherits nothing. The default is to extend `testImplementation`". **내 C1은 이 주석과 + 정면으로 충돌했는데, 나는 그 충돌을 발견하지 못했다.** +2. `src/adapter/inbound/graphql/build.gradle:22` — + `sourceSet('systemTest') { compilesAgainst 'main' }`. 역시 `inherits` 없음, 별도 + `systemTestImplementation` 선언도 없음. 그리고 그 `systemTest`는 **현재 `ci`에서 실제로 돈다.** + 내 논리가 맞다면 graphql leaf도 이미 깨져 있어야 했다. + +**내가 틀린 지점 (숨기지 않고 적는다):** + +- `AuxiliarySourceSetExtension.java`(매핑 코드)만 읽고 `AuxiliarySourceSetSpec.java`(기본값을 + 들고 있는 데이터 클래스)를 **열지 않았다.** 확장 메서드의 동작만 보고 "호출이 없으면 빈 목록"이라고 + **가정**했다. 기본값은 스펙 객체에 있었다. +- 같은 파일 안에서 내 주장과 반대되는 주석을 읽고도 대조하지 않았다. +- 같은 패턴을 쓰는 다른 leaf(graphql)를 대조군으로 찾지 않았다. 대조군을 `jettyCompatTest` 등 + **같은 파일 안**에서만 골랐고, 그 셋이 전부 기본값을 좁히는 쪽이었다. +- 근본 원인: "다른 데는 다 있는데 여기만 없다"는 패턴이 강한 신호라고 믿고, 그 신호를 + **플러그인 기본값 한 줄로 검증하기 전에** Critical로 올렸다. 규칙상 Critical에는 반론 절을 달았지만, + 달아 놓은 반론("어딘가 공통 컨벤션이 있을 수 있다")을 **확인하러 가지 않았다.** + +**남기는 것:** C3(untracked 미추가 위험)은 유효하다. 저장소 전체 기준 tracked 삭제 135 / +untracked 신규 175이고, `git check-ignore`로 새 소스셋 경로가 `.gitignore`에 걸리지 않음을 확인했다. +C1과 C3는 같은 리팩토링을 대상으로 하지만 근거가 다르다 — C1은 플러그인 동작 추론(틀림), +C3는 `git status` 관측(사실). + +--- + +### 9.1 빌드로만 확정되는 항목 + +빌드를 돌리지 않았다(스냅샷에 `gradle/wrapper/gradle-wrapper.jar`가 없다). 아래는 전부 미검증이다. + +| # | 주장 | 확인 명령 | +|---|---|---| +| 1 | **H6** — `WebPlatformStartupValidator`를 생성하는 프로덕션 코드가 정말 없는가 | `grep -rn "new WebPlatformStartupValidator(\|WebPlatformSnapshot(" src --include='*.java' \| grep -v '/test/'` (현재 0건) | +| 2 | 새 `systemTest`/`performanceTest` 레인이 실제로 돌아가는가 (철회한 C1의 반대 방향 확인) | `cd src && ./gradlew :adapter:inbound:web:systemTest :adapter:inbound:web:performanceTest --console=plain` | +| 3 | **H4-2** — 알림 콜백이 401을 받는다 | `APP_...CALLBACKS_ENABLED=true`로 기동 후 `curl -i localhost:8080/v1/internal/notification/callbacks/x/y -d '{}'` (401 기대) 및 `curl -i localhost:8080/internal/notification/callbacks/x/y` (404 기대) | +| 4 | **H4-1** — fileserver 경로가 `/{prefix}/v1/files` 다 | `APP_FILESERVER_PLATFORM_ENABLED=true` 기동 후 `curl -s localhost:9001/actuator/mappings \| jq '..\|.patterns? // empty'` | +| 5 | **H4-3** — `MANAGEMENT_SERVER_PORT == APP_SERVER_PORT` 일 때 어드민 라우트가 역할 게이트를 벗어난다 | 두 포트를 같게 두고 일반 사용자 토큰으로 `POST /{prefix}/internal/fileserver/files/x:force-delete` (403 기대, 202면 결함 확정) | +| 6 | **H5** — `JsonMapper` 빈이 몇 개이고 메시지 컨버터가 무엇을 쓰는가 | `curl -s localhost:9001/actuator/beans \| jq '[..\|.type? // empty] \| map(select(test("JsonMapper\|ObjectMapper")))'`, 또는 `ApplicationContextRunner`에 `JacksonAutoConfiguration` + `WebMvcPlatformAutoConfiguration`을 같이 올리는 테스트 1개 | +| 7 | **H3** — XFF로 레이트리밋 버킷이 갈린다 | 레이트리밋 on 상태에서 `X-Forwarded-For`를 바꿔가며 한도 초과를 시도. 429가 안 나오면 확정 | +| 8 | **H1** — 실제 체인에서 클라이언트 `X-Request-Id`가 응답에 반사된다 | `curl -i -H 'X-Request-Id: attacker-1' localhost:8080/v1/healthcheck` → 응답 헤더가 `attacker-1`이면 확정 | +| 9 | **L2** — problem 핸들러의 traceId가 항상 0 | `mvc.error` 패키지를 스캔에 넣고 400을 유발했을 때 `traceId`가 `"000…0"`인지 | +| 10 | Jetty/WebFlux/Nginx 레인이 현재 통과하는지 | `./gradlew :adapter:inbound:web:webJettyCompatTest :adapter:inbound:web:webFluxContractTest --console=plain` (Nginx 레인은 Docker 필요) | +| 13 | **H7** — 픽스처를 `WebMvcPlatformAutoConfiguration` 임포트로 바꾸면 순서 IT가 깨지는지 | `PipelineOrderFixtureApplication`에 `@Import(WebMvcPlatformAutoConfiguration.class)`를 넣고 `MvcPipelineOrderIT` 실행. H1이 사실이면 requestId 관련 단언이 깨져야 한다 | +| 14 | **C2 확장** — 패리티 게이트를 배포 구성으로 돌리면 문제 문서가 나오는지 | `ContractFixtureApplication`에서 `WebMvcProblemExceptionHandler` 대신 `EnvelopeBodyAdvice` + `GlobalExceptionHandler`를 임포트하고 `webCrossStackParityTest` 실행. `everyFailureIsAProblemDocument`가 `application/problem+json`에서 깨지면 확정 | +| 11 | **C3** — 커밋 직전 untracked가 남아 있는지 | `git status --porcelain -- src/adapter/inbound/web \| grep '^??'` (출력이 있으면 커밋 금지) | +| 12 | **§7.4-1** — `TaskDecorator` 빈이 없을 때 fileserver가 기동 실패하는지 | `app-bootstrap`의 `AsyncContextTaskDecorator`를 제외한 슬라이스 컨텍스트에 `MvcTransferExecutorConfiguration`만 올려 `ApplicationContextRunner`로 확인 | + +반대로, **이번에 빌드 없이 확정한 것**도 적어 둔다: §7.0의 이동 무손실 대조는 +`full.diff`에서 삭제 본문을 추출해 스냅샷 파일과 문자열 비교한 결과이므로 추가 검증이 필요 없다 +(8개 IT + yaml 3→1 전부 IDENTICAL). + +**세운 가정 (코드에서 직접 확인하지 못한 프레임워크 동작):** + +- (A) Spring Boot가 `@Component`/`@Bean`으로 등록된 `Filter`를 `Ordered`/`@Order` 기준으로 정렬하며, + order가 없는 필터는 `Ordered.LOWEST_PRECEDENCE`로 취급한다. → H1, §2 파이프라인 순서가 여기 의존한다. +- (B) `server.forward-headers-strategy=framework`가 `ForwardedHeaderFilter`를 등록하고, + 그 요청 래퍼가 `getRemoteAddr()`를 `X-Forwarded-For` 첫 홉으로 바꾼다. → H3의 핵심 고리. +- (C) `PathMatchConfigurer.addPathPrefix(prefix, c -> true)`가 **요청 URI**가 아니라 **매핑**을 + 바꾸므로, 보안 필터의 `securityMatcher`는 prefix가 붙은 URI로 판정한다. → H4-2/H4-3. + (A)(B)(C) 모두 Spring의 문서화된 동작이지만, 이 저장소의 테스트가 검증하지는 않는다. + +**테스트 커버리지 (최종):** +leaf의 Java 623개 + 리소스를 전부 읽었다. 남긴 예외는 `gradle.lockfile`과 `README.md`(35KB) +두 개뿐이고, 이유는 §1에 적었다. 초판에서 "미독"을 이유로 유보했던 판단은 전부 정리됐다. + +- **확정**: H1(세 테스트가 서로 반대를 못 박음), C2(세 테스트가 각자 자기 편만 보고, 게다가 + 3레인 실서버 패리티 게이트가 배포가 내보내지 않는 계약을 고정함), H2(실서버 IT까지 올라가도 + 픽스처 컨트롤러가 인보커를 직접 조립함), H3(`nginxProxyTest`는 Nginx 설정과 sanitizer 경로를 + 검증하고 배포가 쓰는 `ForwardedHeaderFilter` 경로는 어느 레인에서도 켜지지 않음), + H4(콜백 테스트가 접두사 없는 URL을 canonical로 고정), H6(생성처 0건), + H7(파이프라인 순서 IT가 픽스처 자작 필터를 검증). +- **여전히 코드로만 판정한 것**: H5. `hasSingleBean(JsonMapper` / `getBeansOfType(JsonMapper`가 + 테스트 트리 전체에서 0건임을 전수 확인했다. 다만 **실제 메시지 컨버터가 어느 매퍼를 쓰는지**는 + 런타임 확인이 필요하다(아래 표 6번). +- **정정한 것**: 초판 H3의 반론 근거 중 "docker-compose 로컬/개발에는 인그레스가 없다"는 틀렸다. + `application-local.yml:131`·`application-test.yml:86`이 `forward-headers-strategy: none`으로 + 덮어쓴다. 노출 면은 프로덕션 프로파일뿐이다. +- **의심했다가 해소한 것**: `advanced/stream/replay/MessagingReplayBridge`의 + `LiveEventReplayPort` 임포트는 `messaging:*`이 아니라 `dev.caskeleton.application.realtime`이다. + `modules.json` 위반 아님. + +**다른 영역 담당자에게 넘기는 교차 이슈:** + +- (빌드/CI) `src/build.gradle`의 `ci`가 `:sample-portfolio`를 제외하는 정책 — §5 M5. + 그리고 `CLAUDE.md`의 "`ci` is check + architectureCheck + qualityCheck + configContractCheck"는 + 현재 코드(`qualificationCheck` 추가)와 다르다. +- (설정/부트스트랩) `PRESENTATION_API_BASE_PATH`·`SECURITY_PUBLIC_PATHS`가 + `docs/registries/env-keys.yaml`과 `.env.example`에 없다 — `verifyEnvKeys`가 코드→레지스트리 + 방향을 검사하지 않는다는 뜻으로 보인다. +- (설정) `config/capabilities.yml` 71행의 값 없는 `security:` 키. +- (설정) `config/runtime.yml` 38~48행의 알림 플랫폼 설명 주석이 어떤 키에도 붙어 있지 않다 + (트리가 `notification.yml`로 옮겨진 흔적). +- (설정/샘플 격리) `config/security.yml`의 `role-permissions` 기본값에 `worklog:*`가 들어 있다. +- (에러 계약) `docs/registries/error-codes.yaml` ↔ `OperationalError` 21건 차이 — §5 M6. + `FileserverErrorCode`/`PortfolioErrorCode`/`RateLimitTransportError`까지 합치면 더 커진다. +- (전 영역 공통) **untracked 미추가 위험** — §5 C3. 이 leaf 9파일 외에 + websocket 3파일, sample-portfolio 4파일 + 스냅샷 JSON, 그리고 `docs/superpowers/{specs,plans}`의 + 2026-09-18 문서 20개가 전부 untracked다. 종합 리뷰에서 한 번 더 강조할 가치가 있다. +- (아키텍처/소유권) 2026-09-18 spec의 "inbound web owns transport"가 아직 절반만 실행됐다 — §7.4. + Fileserver HTTP transport 빈 18개가 여전히 `app-bootstrap`에 있고, 그 때문에 web leaf의 + `@Configuration`이 컴포지션 루트의 `TaskDecorator` 빈에 필수 의존한다. +- (websocket 담당) 이 leaf와 같은 리팩토링 패턴(`TomcatWebSocketRuntimeIT` 등 3개 삭제 + + `websocket/src/systemTest/` 신규)이 websocket leaf에도 있다. **의존 선언은 문제가 아니다** + (§9.0 — `inherits` 없음이 곧 기본 상속이다). 확인할 것은 **`git add` 여부**다(C3). +- (전 영역 공통, 방법론) §1.1의 "부품 검증 vs 조합 검증" 분포는 이 leaf만의 문제가 아닐 가능성이 + 높다. 다른 영역에서도 `withUserConfiguration(...)` / `AutoConfigurations.of(...)` 비중을 세어 + 비교하면, "테스트는 많은데 미배선이 통과한다"는 현상이 저장소 전체의 구조적 특성인지 + 이 leaf의 국지적 문제인지 판정할 수 있다. diff --git a/docs/reviews/2026-09-18-techlead-review/03-inbound-realtime.md b/docs/reviews/2026-09-18-techlead-review/03-inbound-realtime.md new file mode 100644 index 00000000..0bf87b7b --- /dev/null +++ b/docs/reviews/2026-09-18-techlead-review/03-inbound-realtime.md @@ -0,0 +1,1229 @@ +# [영역] inbound 실시간 전송 (WebSocket / gRPC 어댑터) 리뷰 + +- 스냅샷: 2026-09-18T11:50Z / HEAD 60b6a319 + 커밋 안 된 변경 224파일 +- 담당 leaf: `adapter-inbound-websocket`, `adapter-inbound-grpc` + +--- + +## 0. 최종 적용 기준 + +WebSocket/gRPC의 build-time opt-in은 최종 아키텍처와 일치한다. ENV 하나로 켤 수 없는 것 자체는 결함이 아니다. +채택 UX는 단순화하고, 선택된 뒤 settings/Bean graph가 runtime switch 밖으로 새지 않게 한다. +미배선 advanced 기능은 supported로 표시하지 않는다. optional-platform 격리는 유지한다. + +## 0-A. 2026-09-21 중간 재검증 + +**상태: WebSocket backpressure close path는 수정됐다.** + +`PlatformWebSocketHandler`가 `OutboundEnqueueResult.CONNECTION_MUST_CLOSE`를 명시적으로 처리해 +session close로 연결하며 `PlatformWebSocketHandlerBackpressureTest`가 존재한다. 이번 +`:adapter:inbound:websocket:test`도 PASS했다. + +따라서 원 리뷰의 “`CONNECTION_MUST_CLOSE` 반환값을 상위 handler가 무시한다”는 finding은 +**해소됨**으로 본다. + +반면 gRPC 쪽에는 새 CI reachability 공백이 확인됐다. 자세한 내용은 `11-grpc-platform.md`와 +`13-build-dependency-ci.md`의 2026-09-21 재검증을 따른다. + +## 1. 커버리지 + +**270개 중 268개 전문 열람. 못 읽은 2개는 `gradle.lockfile`(생성물)뿐이다.** + +| 구분 | 읽음 / 전체 | 비고 | +|---|---|---| +| `adapter/inbound/grpc` main `.java` | 8 / 8 | 전문 | +| `adapter/inbound/grpc` test `.java` | 6 / 6 | 전문 | +| `adapter/inbound/grpc` build.gradle / CLAUDE.md / README.md | 3 / 3 | 전문 | +| `adapter/inbound/websocket` main `.java` | **169 / 169** | 전문 | +| `adapter/inbound/websocket` test `.java` | **64 / 64** | 전문 | +| `adapter/inbound/websocket` testFixtures `.java` | 7 / 7 | 전문 | +| `adapter/inbound/websocket` systemTest `.java` | 3 / 3 | 전문 | +| `adapter/inbound/websocket` jettyWebSocketTest `.java` | 1 / 1 | 전문 | +| `adapter/inbound/websocket` nginxWebSocketTest (`.java` 2 + `.conf` 2) | 4 / 4 | 전문 | +| `adapter/inbound/websocket` build.gradle / CLAUDE.md / README.md | 3 / 3 | 전문 | +| `gradle.lockfile` ×2 | **0 / 2** | **미열람.** Gradle이 생성하는 의존 해석 결과물이고, 사람이 편집하지 않는다. 판정에 쓸 내용이 없다 | + +**영역 밖이지만 판정 근거로 전문 열람한 파일:** + +``` +src/config/architecture/modules.json (62 leaf 전수) +src/app-bootstrap/build.gradle +src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/CaSkeletonApplication.java (1~90줄) +src/app-bootstrap/src/conditionalTransportTest/.../ConditionalTransportCompositionContractTest.java +src/build-logic/.../ConditionalTransportQualificationPlugin.java +src/build-logic/.../architecture/ArchitecturePlugin.java +src/build-logic/.../architecture/VerifyCleanArchitectureDependenciesTask.java +src/build-logic/.../runtime/VerifyRuntimeModuleRegistryTask.java +src/app-bootstrap/src/main/resources/config/*.yml (목록 + capabilities.yml + graphql.yml) +docs/registries/env-keys.yaml (websocket/grpc grep → 0건) +docs/websocket/repository-adaptation.md, docs/websocket/runbook.md +src/optional-platforms/README.md, settings.gradle +``` + +**여전히 읽지 않은 것:** `docs/websocket-superpowers-package/` 하위(문서 패키지). §9 참조. + +## 2. 이 영역은 무엇을 하는가 + +README 요약이 아니라 코드에서 읽어낸 실제 구조다. **두 leaf는 서로 완전히 다른 물건이다.** + +### 2.1 `adapter:inbound:grpc` — 602줄, 전부 배선된 진짜 어댑터 + +8개 파일이 전부 한 패키지에 있고, 하나도 죽어 있지 않다. + +``` +GrpcServerConfig @ConditionalOnProperty(ca-skeleton.grpc.enabled=true) + └─ GrpcServerRunner (SmartLifecycle) ← io.grpc Netty Server 직접 소유 + ├─ ObjectProvider (feature가 기여) + ├─ ObjectProvider (feature가 기여, 정확히 1개) + ├─ GrpcExceptionHandlingInterceptor → GrpcStatusMapper + └─ HealthStatusManager (grpc.health.v1) + 옵션 reflection +``` + +- **`src/grpc/*` 플랫폼(14 leaf)과 코드 의존이 0이다.** `grpc/build.gradle`의 project 의존은 + `:shared-contract` 하나뿐이고(`src/adapter/inbound/grpc/build.gradle:36`), import도 + `dev.caskeleton.shared.error.*` 4종뿐이다. `optional-platforms`가 꺼져 있어도 이 어댑터는 + 그대로 컴파일된다 — **의존한 적이 없으니까.** +- feature RPC는 0개다. `.proto`도 protobuf 플러그인도 없다. health/reflection은 `grpc-services` + jar에 이미 컴파일돼 들어있는 것을 쓴다(`GrpcServerRunner.java:88,90`). +- 즉 **껍데기가 아니라 "빈 호스트"다.** 서버 수명주기·인증 경계·에러 매핑이라는 세 가지 횡단 + 관심사를 제대로 구현해 놓고, 도메인 서비스 자리만 비워 뒀다. 템플릿으로서는 이게 맞는 모양이다. + +### 2.2 `adapter:inbound:websocket` — 12,784줄, 실제로 배선된 건 570줄 + +파일 169개 중 **Spring 타입을 import 하는 것이 15개뿐이다.** + +``` +$ grep -rl 'import org.springframework' src/main | wc -l → 15 +$ find src/main -name '*.java' | wc -l → 169 +``` + +실제 Spring 컨텍스트에 올라가는 것은 두 덩어리다. + +**(a) `stomp/` 8파일 (~570줄) — 유일하게 완전히 배선된 부분** + +``` +WebSocketConfig @ConditionalOnProperty(ca-skeleton.websocket.enabled=true) + @EnableWebSocketMessageBroker + ├─ AuthenticatedHandshakeInterceptor (핸드셰이크에 Principal 없으면 401) + ├─ WebSocketInboundAuthorizationInterceptor (SUBSCRIBE는 설정된 1개 토픽만, SEND는 /app/** 만) + ├─ SafeStompSubProtocolErrorHandler (모든 실패 → 고정 코드 + 빈 페이로드) + └─ LiveEventStompBroadcaster (@DomainEvent → LiveEventProjector 정확히 1개 → /topic) +``` +`systemTest/.../WebSocketBoundaryQualificationTest`가 랜덤 포트 Tomcat + 실제 SockJS/STOMP +클라이언트로 이 네 가지를 전부 관통한다. **여기는 진짜다.** + +**(b) `advanced/` 4개 `@Configuration` (SockJs, Stomp, StompDefaults, RabbitRelay)** +— 배선은 돼 있지만 **켜면 기동이 깨진다.** C1 참조. + +**(c) 나머지 154파일 (~12,000줄) — Spring이 아예 모르는 순수 Java 라이브러리** + +`core/ protocol/ error/ security/ handshake/ authz/ budget/ codec/ inbound/ outbound/ +lifecycle/ session/ handler/ ordering/ idempotency/ evidence/ observability/ release/ +moduleboundary/ admin/ webflux/ servlet/ advanced/*` + +내용의 질은 이 저장소에서 본 것 중 가장 높다. 프레임 재조립 3중 바운드, 슬로우 컨슈머 +per-connection + node-wide 2단 예산, 쓰기 락과 큐 락 분리, close 핸드셰이크 단계 기계, +resume 토큰 HMAC + 키링 로테이션, CRIME/BREACH를 고려한 엔드포인트별 압축 정책, 메트릭 태그 +카디널리티 allowlist… 전부 실무에서 한 번씩 데여 본 사람이 쓴 코드다. + +**그런데 이 중 어느 것도 런타임에 실행되지 않는다.** 아래 표가 근거다. + +| 클래스 | main에서 참조하는 파일 수 | 생성/호출하는 프로덕션 코드 | +|---|---|---| +| `config/WebSocketPlatformSettings` (`@ConfigurationProperties("backend.websocket")`) | 1 (자기 자신) | **없음** — `@EnableConfigurationProperties`가 어디에도 없다 | +| `config/WebSocketPlatformStartupValidator.validate(...)` | 1 (자기 자신) | **없음** | +| `config/WebSocketStackExclusivity.require(...)` | 1 (자기 자신) | **없음** | +| `advanced/stomp/StompBrokerExclusivity.verify(...)` | 1 (자기 자신) | **없음** | +| `servlet/PlatformWebSocketHandler` | 1 (자기 자신) | **없음** — testFixtures의 `WebSocketFixtureApplication:40`만 생성 | +| `session/WebSocketSessionRegistry` | 1 (자기 자신) | **없음** | +| `lifecycle/HeartbeatPolicy` | 1 (자기 자신) | **없음** | +| `handshake/HandshakeAdmissionPipeline` | 1 (자기 자신) | **없음** | +| `codec/StrictWebSocketJsonCodec` | 1 (자기 자신) | **없음** | +| `advanced/cluster/PortBackedExternalSessionIndex` | 1 (자기 자신) | **없음** | + +검증 명령: +```bash +cd src/adapter/inbound/websocket/src +grep -rl '\bWebSocketPlatformSettings\b' main/java # → 1건 (자기 파일) +grep -rn '@Bean' main/java | wc -l # → 8건, 전부 stomp/ 와 advanced/ 안 +``` + +**정리: WebSocket leaf는 "어댑터 1개(570줄) + 조합층이 빠진 라이브러리 1개(12,000줄)"가 +한 Gradle leaf 안에 같이 들어 있는 상태다.** + +전수 독파 후 이 문장을 한 단계 더 정확히 할 수 있다. **빠진 것은 Spring 배선만이 아니다.** +부품을 순서대로 호출하는 **순수 자바 조합 클래스조차 main에 없다** — `HandshakeAdmissionPipeline`, +`StrictWebSocketJsonCodec`, `WebSocketCorrelationRegistry`, `GapDetector`, `StreamSequencer`, +`WebSocketInboundEvidence`, `ResumeCoordinator`, `HeartbeatPolicy`를 `new` 하는 main 코드가 0건이고, +`CommittedResultLedger.claim(...)`을 호출하는 main 코드도 0건이다. 자세한 근거와 +"그래서 이 12,000줄은 자산인가 부채인가"의 판정은 **§4-B**에 있다. + +--- + +## 3. 런타임 토글 판정 — 꺼지면 정말 꺼지는가 + +### 3.1 결론부터 + +**두 leaf 모두 "env로 끄는 기술"이 아니다. 아예 배포 산출물에 들어 있지 않다.** +프로젝트의 핵심 설계 목표(`BRIEF.md` §1: "env true/false로 켜고 끄되 판정은 런타임에")와 +이 영역의 실제 구현은 **다른 계약**이다. + +근거 — `src/config/architecture/modules.json`의 `app-bootstrap.allowed_dependencies`: + +``` +domain-core, application-core, adapter-outbound-persistence-jpa, adapter-outbound-support, +adapter-outbound-messaging, adapter-outbound-cache-redis, adapter-outbound-notification, +adapter-outbound-fileserver, adapter-outbound-httpclient, adapter-outbound-identifier, +adapter-inbound-web, shared-contract, adapter-outbound-persistence-mongo, +adapter-inbound-graphql, messaging-spring-boot-starter +``` + +`adapter-inbound-websocket`도 `adapter-inbound-grpc`도 **없다.** +`src/app-bootstrap/build.gradle:213-215`: + +```gradle +conditionalTransportTestImplementation project(':adapter:inbound:graphql') +conditionalTransportTestImplementation project(':adapter:inbound:grpc') +conditionalTransportTestImplementation project(':adapter:inbound:websocket') +``` + +즉 **테스트 소스셋에서만 클래스패스에 올린다.** bootJar에는 들어가지 않는다. + +확인한 부수 사실: +- `docs/registries/env-keys.yaml`에 `websocket`/`grpc` 문자열이 **0건**이다. + (`grep -ci 'websocket\|grpc' docs/registries/env-keys.yaml` → 0) +- `src/app-bootstrap/src/main/resources/config/`에 `websocket.yml`도 `grpc.yml`도 **없다.** + (`graphql.yml`만 있다 — GraphQL은 반대로 정식 배포 대상이다.) + +**따라서 "껐을 때 무엇이 남는가"의 답은 "아무것도 남지 않는다. 클래스 자체가 없다"이다.** +핸들러 등록·엔드포인트 매핑·세션 레지스트리·하트비트 스케줄러·스레드 풀·gRPC 포트 바인딩 +전부 존재하지 않는다. 비용은 0이다. `spring-boot-starter-websocket`, `io.grpc:grpc-netty-shaded` +jar도 runtimeClasspath에 없다. + +### 3.2 그 "없음"을 무엇이 지키는가 — 2중 장치 + +**장치 1 — `verifyCleanArchitectureDependencies` (진짜 게이트)** + +`build-logic/.../ArchitecturePlugin.java:17-18`이 production 선언을 +`api / implementation / compileOnly / runtimeOnly` 4개로 정의하고, +`VerifyCleanArchitectureDependenciesTask.java:72-91`이 각 모듈의 project 의존을 +`modules.json`의 `allowed_dependencies`와 대조해 **초과분이 있으면 빌드를 깨뜨린다.** + +→ 누군가 `app-bootstrap/build.gradle`에 `implementation project(':adapter:inbound:websocket')`를 +추가하면 **`architectureCheck`가 실패한다.** `conditionalTransportTestImplementation`은 +production 선언 목록에 없으므로 통과한다. 이건 제대로 작동하는 설계다. + +**장치 2 — `ConditionalTransportCompositionContractTest` (텍스트 grep, 보조)** + +`src/app-bootstrap/src/conditionalTransportTest/.../ConditionalTransportCompositionContractTest.java:96-104`: + +```java +Pattern.compile("(?m)^\\s*(?:api|implementation|compileOnly|runtimeOnly)\\s*\\(?\\s*project\\(\\s*['\"]" + + quotedPath + "['\"]\\s*\\)\\s*\\)?"); +``` + +`build.gradle` **파일 텍스트**를 정규식으로 본다. 그리고 `Class.forName`으로 해당 타입이 +이 소스셋 클래스패스에 실제로 있음을 확인한다(:106-112). + +**이 장치가 실제로 보장하는 것 / 보장하지 않는 것:** + +| 보장한다 | 보장하지 않는다 | +|---|---| +| `app-bootstrap/build.gradle`에 3개 전송의 production project 의존 줄이 없다 | 전이 의존으로 runtimeClasspath에 들어오는 경우 (텍스트만 보므로 못 잡음) | +| opt-in 타입이 실제로 로드된다 = 등록만 되고 삭제된 껍데기가 아니다 | 스프링 컨텍스트에서 실제로 비활성인지 (컨텍스트를 띄우지 않는다) | +| GraphQL은 반대로 실제 의존이고 `APP_GRAPHQL_ENABLED:false` 기본값을 가진다 | WebSocket/gRPC의 **런타임** off 상태 (증거가 없다 — 애초에 런타임이 없으니) | + +`ConditionalTransportQualificationPlugin.java:52-56`이 이 테스트 + 각 leaf의 wire 자격시험 + +`verifyRuntimeModuleMembership`를 한 태스크로 묶고, `:58-66`에서 JUnit XML에 +**skip이 하나도 없음**을 검증한다(`evidence.verifyNoSkipJUnitXml`). "조건 미충족으로 조용히 +건너뛴 자격시험"을 막는 장치다. + +**판정: 이 장치는 목적에 대해 충분하다. 다만 목적이 브리프가 말하는 목적과 다르다.** +- "빌드 산출물에 안 들어감"을 보장하는 데는 **충분하다** (장치 1이 진짜 게이트, 장치 2가 이중화). +- "런타임 env로 끈다"는 계약은 **이 영역에 존재하지 않는다.** 그건 결함이 아니라 다른 결정이다. + 다만 `websocket/CLAUDE.md:22-23`이 "미래의 composition이 의존을 추가하고 + `ca-skeleton.websocket.enabled=true`를 설정하면 된다"고 써 놓았는데, 그 "의존 추가"가 + `modules.json` 편집까지 요구한다는 사실은 어디에도 없다. H5 참조. + +### 3.3 `verifyRuntimeModuleMembership`의 한계 (교차 이슈) + +`VerifyRuntimeModuleRegistryTask.java:55-64`는 composition root의 resolved runtimeClasspath에 +**"등록되지 않은"** 프로젝트가 있는지만 본다. websocket/grpc는 `modules.json`에 **등록돼 있으므로**, +전이로 들어와도 이 태스크는 통과한다. 즉 이 태스크는 위 장치 1의 대체재가 아니다. +빌드 담당 리뷰어가 알아야 할 사항이다. + +--- + +## 4. 구조 판정 + +| 축 | 판정 | 근거 | +|---|---|---| +| 의존 방향 (modules.json 대조) | **OK** | grpc는 `:shared-contract` 1개만 선언(`grpc/build.gradle:36`), websocket은 `:domain-core` + `:application-core`(`websocket/build.gradle:23,27`). 둘 다 `allowed_dependencies` 부분집합. 초과 없음 | +| 경계 누수 (DTO·entity·framework) | **OK** | websocket main의 외부 `dev.caskeleton` import는 `application.realtime.*` 9종 + `domain.stereotype.DomainEvent` 1종이 **전부**. grpc는 `shared.error.*` 4종이 전부. repository/entity/Spring Data/outbound 어댑터 타입 **0건** | +| HARD-STOP #2 (controller→repository) | **위반 없음** | `WS-ARCH-4`(testFixtures `WebSocketArchitectureRules:90-102`)가 `dev.caskeleton.adapter.outbound..`, `jakarta.persistence..`, `org.springframework.data..`를 ArchUnit으로 금지. 실제 import도 0건 | +| HARD-STOP #3 (inbound DTO 누수) | **위반 없음** | websocket이 application-core에 **주는** 타입은 없다. `MessagingFanoutAdapter:343-352`, `PortBackedExternalSessionIndex:490-506`이 전송 어휘(`WebSocketEndpointName`)를 포트 어휘(`RealtimeChannel`)로 **번역**한다. 방향이 옳다 | +| 비즈니스 규칙 위치 | **OK** | 두 leaf 모두 도메인 규칙 없음. `LiveEventStompBroadcaster:102-130`의 bound 검사는 전송 정책이지 비즈니스 규칙이 아니다 | +| 테스트 전략 적합성 | **부품 우수 / 조합 공백** | 64개 전수 독파 결과 껍데기 테스트 0건. 동시성 실측·순서 부수효과 증명·탐지기 자체 검증·실컨테이너 3종까지 있다(§4-B.2). **다만 482건이 전부 부품 단위이고, 조합·수명주기를 검증하는 테스트는 0건이다**(§4-B.3). H3가 그 공백에서 나온 결함 | +| 내부 패키지 DAG | **OK, 우수** | `WebSocketStableModule` + `WebSocketModuleBoundaryTest`가 선언과 소스트리를 양방향 대조. 음성 케이스를 `@TempDir`에 직접 만들어 탐지기 자체를 검증(`WebSocketModuleBoundaryTest:79-127`) | + +--- + +## 4-B. 미배선 12,000줄은 (a) 완성된 자산인가 (b) 검증된 적 없는 코드인가 + +**64개 테스트 파일 전수 독파 후 판정: 압도적으로 (a)이다. 단, 한 층이 통째로 빠져 있고 그 층은 +(b)다.** 섞여 있으므로 갈라서 쓴다. + +### 4-B.1 판정 요약 + +| 층 | 무엇 | 판정 | 근거 | +|---|---|---|---| +| **결정(policy) 층** — 값 객체·정책·상태기계 154파일 | 예산, 프레임 재조립, 아웃바운드 큐, 세션 레지스트리, close 단계기계, 핸드셰이크 admission, 코덱, 카탈로그, resume 토큰, 클러스터 인덱스, presence, 멱등성 | **(a) 완성. 배선만 하면 된다** | 아래 4-B.2 | +| **조합(orchestration) 층** — "이 부품들을 순서대로 호출하는 것" | 프레임 수신 → 재조립 → 디코드 → admission → authz → 핸들러 → evidence 기록 → 응답 큐잉 파이프라인 / 하트비트·유휴·만료 스케줄러 / 멱등성 claim→commit→record 흐름 | **(b) 존재하지 않음. main에 클래스가 없다** | 아래 4-B.3 | +| **Spring 배선 층** | `@Configuration` / `@Bean` | **(b) 존재하지 않음** | C1·C2 | + +### 4-B.2 왜 (a)인가 — 테스트가 실제 계약을 잡는다 + +전수 독파 결과, **구조만 도는 껍데기 테스트는 한 건도 없었다.** 근거가 되는 유형을 셋으로 나눈다. + +**(i) 동시성·시간을 실제로 돌린다 (mock 아님)** + +| 테스트 | 무엇을 실제로 돌리는가 | +|---|---| +| `outbound/SerializedOutboundWriterTest.java:47-85` | 8-스레드 풀에서 64개 offer를 동시에 던지고, sink 내부 동시 진입 최대치가 **정확히 1**임을 `AtomicInteger`로 관측. 직렬화 보장이 주장이 아니라 측정값이다 | +| `session/WebSocketSessionRegistryTest.java:68-96` | 8-스레드 16-요청 동시 register → accepted가 **정확히 3**(cap). check-then-insert 경쟁을 실제로 재현 | +| `testkit/runtime/SlowConsumerContract.java:54-91` | 가상 스레드를 sink 안에서 `CountDownLatch`로 **실제로 park**시켜 "peer가 안 읽는" 상태를 만든다. 주석(:48-52)이 "이전 버전은 producer 스레드에서 블록했는데 그건 slow producer이지 slow consumer가 아니었다"고 실패 이력까지 기록 | +| `advanced/codec/BinaryCodecRoundTripTest.java` | `FileDescriptorProto`로 **런타임에 protobuf 디스크립터를 컴파일**하고 실제 round trip. CBOR도 실제 인코딩/디코딩 | +| `codec/WebSocketJsonWireManifestTest.java` | 실제 Jackson 3로 duplicate key / trailing token / 200단 중첩 / case-insensitive / float-for-int를 **실제 파싱 시도** | + +**(ii) 순서(ordering)를 부수효과 카운터로 증명한다 — 이게 껍데기 테스트와 가장 크게 갈리는 지점** + +- `handshake/HandshakeAdmissionPipelineTest.java:101-118, 128-145, 148-163`: + 경로 404 / origin 403 / capacity 503 각각에서 `tickets.redemptions()`가 **0**임을 단언한다. + "티켓 조회 전에 거부했다"를 **관측 가능한 부수효과**로 증명한다. 문서의 순서 주장이 아니라 사실이다. +- `advanced/resume/ResumeDecisionTest.java:68-77`: `ReplayAvailability`를 **호출되면 `AssertionError`를 + 던지는 람다**로 주입해 "authorisation이 availability보다 먼저"를 증명. +- `fault/CommandLossRecoveryTest.java:59-73`: 커맨드 처리 타임라인에 fault point 5개를 심고 + `sideEffects` 카운터로 각 크래시 지점의 결과를 관측. 특히 `:91-114`가 commit↔ledger 사이 크래시를 + 재현해 `UNKNOWN` 도달과 reconciliation 해소를 **부수효과 1회**로 확인한다. + +**(iii) 탐지기가 실패할 수 있음을 스스로 증명한다 (non-vacuity control)** + +이 저장소에서 가장 드문 품질 신호다. 4곳에 있다. + +| 위치 | 무엇 | +|---|---| +| `arch/WebSocketArchitectureRulesTest.java:22-28` | `production.size() > 30` — 빈 클래스셋에 대고 통과하는 걸 막는다 | +| `arch/WebSocketArchitectureRulesTest.java:33-53` | 같은 ArchUnit 룰을 **transport 타입이 실제로 있는 `stomp` 패키지**에 적용해 `AssertionError`가 나는지 확인. "룰이 실패할 수 있음"을 증명 | +| `moduleboundary/WebSocketModuleBoundaryTest.java:79-127` | `@TempDir`에 위반 샘플 4종(미선언 edge / CORE의 프레임워크 import / CORE의 `WebSocketSession` / 미선언 패키지)을 실제로 써서 탐지되는지 확인 | +| `moduleboundary/WebSocketBuildModel.java:120-125` | 스캔 파일 수가 0이면 **예외를 던진다**. "0개 읽고 깨끗하다고 보고"를 구조적으로 불가능하게 만듦 | +| `nginxWebSocketTest/.../NginxWebSocketContractIT.java:95-107` | **일부러 망가뜨린 `nginx-no-upgrade.conf`**로 컨테이너를 띄워 연결이 실패하는지 확인 | +| `advanced/codec/BinaryCodecBackendScopeTest.java` | build.gradle을 읽어 두 바이너리 백엔드가 `implementation`이 **아니고** `compileOnly`인지 검증. 버전 카탈로그 alias(`libs.protobuf.java`)까지 `libs.versions.toml`을 파싱해 해석한다 | + +**(iv) 실컨테이너 증거도 실재한다** + +- `systemTest/.../TomcatWebSocketRuntimeIT` + `jettyWebSocketTest/.../JettyWebSocketRuntimeIT`가 + **같은 계약**(`WebSocketRuntimeContract` 7케이스)을 두 컨테이너에서 돌린다. + Jetty 레인은 `JettyWebSocketRuntimeIT.java:34-41`에서 `context.getWebServer()`가 실제로 Jetty인지 + 확인한다 — "Tomcat이 남아 있어 같은 컨테이너를 두 번 인증"하는 것을 막는 대조군. +- `TomcatWebSocketAbuseIT`는 half-open 핸드셰이크 64개, 버스트, plain HTTP GET을 **생 소켓**으로 던진다. +- `NginxWebSocketContractIT`는 실제 Nginx 1.27 컨테이너 뒤에서 업그레이드·순서·1009 close를 확인한다. + +**결론(i~iv): 이 12,000줄은 "테스트가 도는 척하는 코드"가 아니다. 계약이 실제로 고정돼 있고, +탐지기 자체가 검증돼 있으며, 컨테이너·프록시 레인까지 실물이다.** + +### 4-B.3 그런데 (b)인 층이 하나 있다 — 조합(orchestration)이 main에 없다 + +§2.2에서 "Spring 배선이 없다"고 썼는데, 전수 독파 후 **더 정확한 사실**을 확인했다. +**Spring 배선만 없는 게 아니라, 순수 자바 조합 클래스조차 없다.** + +```bash +cd src/adapter/inbound/websocket/src +grep -rn 'new WebSocketInboundEvidence\|new ResumeCoordinator\|new GapDetector\|new StreamSequencer\|new WebSocketCorrelationRegistry\|new LateResponseTombstone\|new HandshakeAdmissionPipeline\|new StrictWebSocketJsonCodec\|new WebSocketSessionRegistry\|HeartbeatPolicy\.' main/java +# → 0건 +grep -rn '\.claim(\|recordCommitted' main/java +# → CommittedResultLedger.java 의 인터페이스 선언 2건뿐. 호출 0건 +``` + +즉 `HandshakeAdmissionPipeline`, `StrictWebSocketJsonCodec`, `WebSocketSessionRegistry`, +`WebSocketCorrelationRegistry`, `LateResponseTombstone`, `GapDetector`, `StreamSequencer`, +`WebSocketInboundEvidence`, `ResumeCoordinator`, `HeartbeatPolicy` — **main 어디에서도 생성되지 않는다.** +`servlet/PlatformWebSocketHandler`가 유일하게 조합을 하는데, 그것도 세 부품 +(`FragmentAssembler`, `OutboundQueue`, `SerializedOutboundWriter`)만 쓴다. + +**그리고 그 조합 로직이 테스트 안에 다시 쓰여 있다.** +`fault/CommandLossRecoveryTest.java:59-73`의 `attempt(...)` 메서드가 +`claim → 비즈니스 작업 → recordCommitted → committedResult` 순서를 **테스트가 직접 구현한다.** +같은 순서를 구현한 프로덕션 클래스는 없다. + +**따라서 정확한 판정은 이렇다:** + +> 부품은 (a)다 — 하나하나가 실제 계약을 갖고 있고 그 계약이 진짜로 검증돼 있다. +> **조립도는 (b)다** — 순서·수명주기·스케줄링을 담당하는 층이 main에 존재하지 않으며, +> 그 층이 있어야만 드러나는 결함(H3가 그 예다)은 아직 아무도 발견할 수 없는 상태다. + +### 4-B.4 이 판정이 채택 결정에 갖는 의미 + +- **부품 재작성은 필요 없다.** 12,000줄을 다시 쓰는 비용은 들지 않는다. 오히려 이 중 + 프레임 재조립 3중 바운드, 2단 버퍼 예산, 2-lock writer, 멱등성 UNKNOWN 상태, resume 키링은 + 직접 작성하면 실무에서 한 번씩 데여야 나오는 것들이다. +- **남은 일은 "조립 + Spring 배선 + 스케줄러"다.** 이건 새 코드이고 새 리스크다. + 그리고 그 새 코드는 **현재 테스트가 하나도 커버하지 않는다** — + 기존 482개 테스트는 전부 부품 단위이기 때문이다. +- **부품이 검증돼 있다는 사실이 조립이 안전하다는 뜻은 아니다.** H3가 정확히 그 증거다: + `OutboundQueue`는 `CONNECTION_MUST_CLOSE`를 올바르게 만들고 3개 테스트가 그것을 확인하지만, + 유일한 조립 지점인 `PlatformWebSocketHandler`가 그 값을 버린다. **부품 테스트는 이걸 잡을 수 없다.** + +### 4-B.5 (b) 쪽에서 나온 부수 발견 — "테스트가 죽은 계약을 고정하고 있다" + +전수 독파에서 새로 확인한 것. 조합층이 없다 보니, **테스트가 아무도 읽지 않는 값을 계약으로 +고정하고 있는** 경우가 둘 있다. 둘 다 "테스트가 초록색이니 배선돼 있겠지"라는 오독을 유발한다. + +1. `advanced/resume/ResumeTokenTest.java` — `everyCapabilityHasItsOwnFlag`: + ```java + assertThat(WebSocketAdvancedCapability.RESUME.propertyName()) + .isEqualTo("backend.websocket.advanced.resume.enabled"); + ``` + 이 문자열을 읽는 코드는 저장소에 없다(H2). 테스트가 **죽은 프로퍼티 이름을 계약으로 고정**한다. +2. `protocol/WebSocketProtocolProfileTest.java` — `stableSubprotocolIsVersioned`: + ```java + assertThat(STABLE.value()).isEqualTo("hyeonworks.realtime.v1.json"); + ``` + fork 사용자가 M2를 고치려 하면 **이 테스트가 깨진다.** 다른 제품의 브랜드가 테스트로 못 박혀 있다. + +--- + +## 5. 발견 + +### Critical + +#### C1. Advanced WebSocket 토글 4개는 **켜면 컨텍스트 기동이 깨진다** (필수 빈 제공자가 없다) + +- **현상**: `app.websocket-platform.advanced.*.enabled=true`로 켜면 + `NoSuchBeanDefinitionException`으로 스프링 컨텍스트가 뜨지 않는다. + 필요한 협력 빈을 만드는 `@Bean` 메서드가 leaf 어디에도 없다. + +- **근거**: + - `advanced/sockjs/SockJsConfiguration.java:48-57` 생성자가 + `WebSocketEndpointCatalog`, `WebSocketOriginPolicy`, `WebSocketHandler` 3개를 요구한다. + main 전체 `@Bean` 8개 중 이 셋을 만드는 것은 **0개**다. + - `advanced/stomp/StompDefaultsConfiguration.java:42` `stompAuthorizationPolicy(StompDestinationCatalog catalog)` + — `StompDestinationCatalog` 빈 제공자 **없음**. Javadoc(:36-39)이 "기본값을 일부러 두지 + 않았다"고 명시하지만, `@ConditionalOnMissingBean`은 *대체 빈이 있을 때* 물러나는 것이지 + *없을 때* 자기를 비활성화하지 않는다. + - `advanced/stomp/rabbit/RabbitBrokerRelayConfiguration.java:57-60` + `multiNodeUserDestination(UserDestinationPolicy, WebSocketNodeId)` — `WebSocketNodeId` 빈 **없음**. + - **전수 검색으로 확정했다 (코디네이터 요청 5번). 기각 사유를 찾지 못했다.** + + | 확인한 경로 | 결과 | + |---|---| + | leaf 전체 `@Bean` | **8개뿐**(아래 목록). 다섯 타입 중 어느 것도 만들지 않는다 | + | leaf 전체 `@Component` / `@Service` | **0건** | + | leaf 전체 `@Import` | **1건** — `StompConfiguration:23` → `StompDefaultsConfiguration` (순환 회피용) | + | `META-INF/spring/…AutoConfiguration.imports` | websocket leaf에 **파일 자체가 없다**. graphql·web·persistence-jpa·cache-redis·messaging·notification·httpclient·persistence-mongo 8개 leaf에는 있다 | + | `META-INF/spring.factories` | websocket leaf에 **없다** | + | app-bootstrap에서 websocket 언급 | **1곳뿐** — `CaSkeletonApplication.java:72`의 `@ConfigurationPropertiesScan` 항목. 빈 정의가 아니다 | + | 다섯 타입의 생성자·정적팩토리 호출 | **main 0건.** 전부 테스트에서만(`HandshakeAdmissionPipelineTest`, `WebSocketPlatformStartupValidatorTest`, `StompAuthorizationPolicyTest`, `StompDestinationCatalogTest`, `PortBackedBridgeTest`, `ClusterFanoutTest` 등) | + | `WebSocketHandler` 빈 | main 0건. `testFixtures/.../WebSocketFixtureApplication.java:55-58`만 | + + leaf 전체 `@Bean` 8개: + ``` + advanced/sockjs/SockJsConfiguration.java:60 (SockJsCompatibilityProfile) + advanced/stomp/StompDefaultsConfiguration.java:27,40,47 (StompProfile / StompAuthorizationPolicy / StompSecurityInterceptor) + advanced/stomp/rabbit/RabbitBrokerRelayConfiguration.java:39,48,55 + stomp/WebSocketConfig.java:68 (LiveEventStompBroadcaster) + ``` + **컴포넌트 스캔 우회 경로도 없다**: 스캔은 스테레오타입 애노테이션만 찾는데, + 다섯 타입은 전부 애노테이션 없는 `final class` 또는 `record`다. + +- **왜 문제인가 (실패 시나리오)**: fork 사용자가 `docs/websocket/repository-adaptation.md`와 + `WebSocketAdvancedCapability` enum을 읽고 "SockJS 폴백이 필요하다"고 판단 → + leaf 의존 추가 → `app.websocket-platform.advanced.sockjs.enabled=true` → + **애플리케이션이 부팅되지 않는다.** 에러 메시지는 `SockJsCompatibilityProfile`이 아니라 + `WebSocketEndpointCatalog`를 가리킨다. 그게 무엇이고 누가 만들어야 하는지는 문서에 없다. + + **이 4개 `@Configuration`이 "발견되기는 하는가"는 확인했다 — 발견된다.** + `app-bootstrap/src/main/java/dev/caskeleton/bootstrap/CaSkeletonApplication.java:41-47`의 + `@ComponentScan(basePackages = {..., "dev.caskeleton.adapter", ...})`가 + **adapter 트리 전체**를 스캔한다. 제외 필터는 `bootstrap.autoconfigure.*` 정규식뿐이고 + (`:51-57`), websocket 패키지는 걸리지 않는다. 따라서 leaf를 의존에 추가하는 즉시 + `SockJsConfiguration` / `StompConfiguration` / `StompDefaultsConfiguration` / + `RabbitBrokerRelayConfiguration`이 전부 컨텍스트 후보가 되고, 각자의 + `@ConditionalOnProperty`만이 유일한 방벽이 된다. + + 현재 leaf가 어떤 composition root에도 없으므로 **오늘 프로덕션에서 터지지는 않는다.** + 터지는 시점은 누군가 이 leaf를 채택하는 순간이다. + +- **수정 방향**: 둘 중 하나. + (a) `@ConditionalOnBean(WebSocketEndpointCatalog.class)` 등을 추가해 "협력 빈이 없으면 + 토글이 켜져도 조용히 비활성" — 단 이건 이 저장소의 fail-closed 정신에 반한다. + (b) 각 `@Configuration`에 `@ConditionalOnMissingBean` 기본 구현(빈 카탈로그/거부 정책)을 + 추가하되, 기본값이 "아무 엔드포인트도 없음"이라 안전하게 아무것도 안 하도록. + (c) 최소한 `WebSocketPlatformStartupValidator`를 실제로 호출해 "이 토글을 켜려면 X,Y,Z 빈을 + 제공하라"는 문장으로 실패시킨다 → C2와 함께 해결된다. + +- **반론과 재반박**: "어차피 composition root에 없으니 도달 불가능한 코드다." — + 맞지만 그 논리대로면 `@ConditionalOnProperty`도 불필요하다. 저장소는 이 토글들을 **문서화된 + 기능**으로 제시하고(`WebSocketAdvancedCapability` enum, `docs/websocket/advanced-support-matrix.md`, + runbook), 릴리즈 게이트(`AdvancedPromotionGate`)까지 만들어 뒀다. 제시된 기능이 켜면 깨지는 것은 + 도달 불가능한 코드가 아니라 **거짓 약속**이다. + +#### C2. 문서·주석이 "실행된다"고 단언하는 fail-closed 가드 3개가 **프로덕션에서 한 번도 호출되지 않는다** + +- **현상**: 기동 시 위험 설정을 거부하도록 만들어진 정적 검사 3개가 main 코드에 + 호출부가 하나도 없다. 테스트만 직접 호출한다. + +- **근거**: + | 가드 | main 호출부 | 테스트 호출부 | + |---|---|---| + | `config/WebSocketPlatformStartupValidator.validate(...)` | **0** | `test/.../config/WebSocketPlatformStartupValidatorTest` | + | `config/WebSocketStackExclusivity.require(...)` | **0** | `test/.../config/WebSocketStackExclusivityTest:33,42` | + | `advanced/stomp/StompBrokerExclusivity.verify(...)` | **0** | `test/.../advanced/stomp/StompBrokerExclusivityTest:22,23,30,39,48,58` | + + 확인: + ```bash + cd src/adapter/inbound/websocket/src + grep -rn 'StompBrokerExclusivity\.\|WebSocketStackExclusivity\.require\|StartupValidator' main/java + # → StompBrokerExclusivity: 주석 2건(StompConfiguration.java:17,50)뿐. 호출 0건 + ``` + + 그리고 **`advanced/stomp/StompConfiguration.java:17-19`의 Javadoc이 사실이 아니다**: + > "`StompBrokerExclusivity` still runs and still fails loudly" + + 실행되지 않는다. 같은 클래스 `:50`도 "Enabling none is refused by StompBrokerExclusivity rather + than silently accepted here"라고 쓰지만 거부하는 코드가 없다. + +- **왜 문제인가 (실패 시나리오)**: `StompConfiguration`의 `@ConditionalOnProperty`(:24-27)는 + `app.websocket-platform.advanced.stomp.enabled`만 본다. **Javadoc이 말하는 "그리고 legacy + 채널이 켜져 있지 않을 때"라는 두 번째 조건이 애노테이션에 없다.** + 따라서 `ca-skeleton.websocket.enabled=true` + `app.websocket-platform.advanced.stomp.enabled=true`이면 + `@EnableWebSocketMessageBroker` 설정이 **컨텍스트에 두 개** 존재한다. + `WebSocketConfig.configureMessageBroker`(`stomp/WebSocketConfig.java:63-66`)와 + `StompConfiguration.configureMessageBroker`(`advanced/stomp/StompConfiguration.java:44-51`)가 + 둘 다 호출되고, 최종 prefix는 **빈 순서로 결정된다.** 에러도 로그도 없다. + 이것이 `StompBrokerExclusivity` 클래스 Javadoc(:10-18)이 정확히 묘사한 실패이고, + 그걸 막기로 한 코드가 실행되지 않는다. + + 마찬가지로 `WebSocketPlatformStartupValidator`가 막기로 한 것 — + "쿠키 인증 엔드포인트에 origin allowlist 없음"(`:77-86`, WebSocket 핸드셰이크의 **유일한** + CSRF 방어) — 도 실행되지 않는다. + +- **수정 방향**: 최소 수정은 `StompConfiguration`에 + `@ConditionalOnProperty(prefix="ca-skeleton.websocket", name="enabled", havingValue="false", matchIfMissing=true)` + 를 추가하는 것. 제대로 된 수정은 `WebSocketPlatformStartupValidator`를 + `ApplicationContextInitializer`나 `@PostConstruct`로 실제 배선하고, 세 가드를 그 안에서 부르는 것. + +- **반론과 재반박**: "테스트가 통과하니 로직은 검증됐다." — 로직은 검증됐고 **적용은 검증되지 + 않았다.** 이 저장소의 다른 곳(`ConditionalTransportQualificationPlugin`, + `WebSocketModuleBoundaryTest`)은 "탐지기가 실제 트리에 붙어 있는지"까지 검증한다. + 같은 기준을 이 세 가드에는 적용하지 않았다. 판정은 유효하다. + +### High + +#### H1. main 12,784줄 중 ~12,000줄이 프로덕션 배선 0 — `CLAUDE.md`는 이 사실을 말하지 않는다 + +- **현상**: `websocket/CLAUDE.md`(81줄)의 "Responsibility" 절은 `stomp/` 패키지 8파일만 기술한다. + 나머지 154파일 21개 패키지(`core`, `protocol`, `outbound`, `handshake`, `resume`, `cluster`, + `presence`, `codec` …)는 **한 줄도 언급되지 않는다.** +- **근거**: `websocket/CLAUDE.md:13-23` 전체가 STOMP/SockJS 채널 얘기다. + 같은 파일 `:41-50`의 "Typed settings" 표에는 `ca-skeleton.websocket.*` 4개 키만 있고, + `backend.websocket.*`(14개 필드, `config/WebSocketPlatformSettings.java:36-51`)와 + `app.websocket-platform.advanced.*`(4개 prefix)는 없다. +- **왜 문제인가**: leaf의 SSOT 문서를 읽고 "아, STOMP 브로드캐스터구나"라고 판단한 사람이 + `./gradlew :adapter:inbound:websocket:test`를 돌리면 482개 테스트가 2분쯤 돈다. + 왜 그런지 설명이 없다. 반대로 `docs/websocket/runbook.md:9-13`은 + "`PlatformWebSocketHandler`가 SmartLifecycle로 1001을 보낸다. **핸들러 빈이 등록돼 있는지 + 확인하라**"고 쓰지만, 그 빈을 등록하는 코드는 프로덕션에 없다. 운영 문서가 배포할 수 없는 + 플랫폼의 운영법을 설명하고 있다. +- **수정 방향**: `CLAUDE.md`에 "이 leaf는 두 가지를 담는다: (1) 배선된 STOMP 채널, + (2) 아직 composition root가 없는 WebSocket 플랫폼 라이브러리" 를 명시. runbook 맨 위에 + "이 runbook은 플랫폼을 채택해 직접 배선한 배포를 전제한다" 한 줄. +- **반론과 재반박**: "설계 문서(`docs/websocket/repository-adaptation.md`)가 18모듈 매핑을 + 설명한다." — 설명한다. 하지만 그 문서도 "배선돼 있지 않다"는 말은 하지 않는다. + `grep -i 'not wired\|unwired\|no composition' docs/websocket/*.md` → 0건. + +#### H2. 한 leaf 안에 프로퍼티 네임스페이스가 **4개**, 그중 3개가 저장소 SSOT 밖 + +- **현상**: + | prefix | 어디서 | env-keys.yaml 등재 | config/*.yml | + |---|---|---|---| + | `ca-skeleton.websocket.*` | `stomp/WebSocketProperties.java:11`, `stomp/WebSocketConfig.java:32` | 없음 | 없음 | + | `backend.websocket.*` | `config/WebSocketPlatformSettings.java:35` | 없음 | 없음 | + | `app.websocket-platform.advanced.{sockjs,stomp,stomp.relay}` | `SockJsConfiguration.java:38`, `StompConfiguration.java:25`, `StompDefaultsConfiguration.java:21`, `RabbitBrokerRelayConfiguration.java:25` | 없음 | 없음 | + | `backend.websocket.advanced..enabled` | `advanced/WebSocketAdvancedCapability.java:76-78` | 없음 | 없음 | +- **왜 문제인가**: 브리프가 확인한 저장소 규약은 "프로퍼티 트리 루트는 `ca-skeleton.*`, + 값은 `${APP_*:default}`"다. 4개 중 3개가 그 규약 밖이다. 더 나쁜 것은 **네 번째가 세 번째와 + 일치하지 않는다**는 점이다: `WebSocketAdvancedCapability.propertyName()`은 + `backend.websocket.advanced.sockjs-compat.enabled`를 반환하는데, 실제로 SockJS를 켜는 키는 + `app.websocket-platform.advanced.sockjs.enabled`다. **enum이 "이 capability를 켜는 프로퍼티"라고 + 선언하는 문자열을 읽는 코드가 세상에 없다.** 운영자가 그 값을 설정해도 아무 일도 일어나지 않는다. +- **수정 방향**: 전부 `ca-skeleton.websocket.*` 하위로 통합하고 `docs/registries/env-keys.yaml`에 + `APP_WEBSOCKET_*`로 등재. 그 전까지는 `propertyName()`을 삭제하거나 실제 prefix로 고친다. +- **반론과 재반박**: "플랫폼 부분은 아직 배선 전이라 prefix가 확정 안 됐다." — + 그렇다면 `@ConfigurationProperties`를 붙이면 안 된다. 붙어 있으면 클래스패스에 올라오는 순간 + 바인딩 대상이 되고, `configContractCheck`가 모르는 키가 생긴다. + +#### H3. `PlatformWebSocketHandler`가 `CONNECTION_MUST_CLOSE`를 **버린다** — GUARANTEED 계약이 지켜지지 않는다 + +- **현상**: 백프레셔로 GUARANTEED 메시지가 거부되면 연결을 닫아야 하는데, 반환값을 무시하고 + 연결을 그대로 둔다. 클라이언트는 응답을 못 받았다는 사실을 영원히 모른다. +- **근거**: + - `outbound/OutboundEnqueueResult.java:28` — `CONNECTION_MUST_CLOSE`의 계약: + "The connection has to close. A client that reconnects and resynchronises has lost nothing; + one that silently missed a guaranteed message is wrong and does not know it." + - `servlet/PlatformWebSocketHandler.java:173-181` — `writer.offer(...)`의 반환값을 받지 않는다. + 같은 호출이 `OutboundDelivery.GUARANTEED`(:178)로 넣는다. + - main 전체에서 `CONNECTION_MUST_CLOSE`를 **소비**하는 코드 0건: + ```bash + grep -rn 'CONNECTION_MUST_CLOSE' main/java + # OutboundEnqueueResult.java:28 (선언), OutboundQueue.java:167 (생성), + # SerializedOutboundWriter.java:87 (생성) — 소비 0 + ``` + - **이 구멍을 덮는 테스트가 없음을 전수 확인했다.** `CONNECTION_MUST_CLOSE`를 단언하는 테스트는 + 3개(`OutboundQueueTest:100`, `OutboundQueueSnapshotTest:83`, `SerializedOutboundWriterTest:152`)이고 + **세 개 모두 큐/라이터를 직접 만들어 반환값만 본다.** 그 값을 받은 호출자가 무엇을 하는지는 + 어느 테스트도 보지 않는다. + - `SlowConsumerContract`는 원리적으로 이 구멍을 덮을 수 없다: + `testFixtures/.../SlowConsumerContract.java:110-117`의 유일한 메시지 팩토리가 + `OutboundDelivery.DROPPABLE` 고정이라 **GUARANTEED를 한 번도 넣지 않는다.** + `CONNECTION_MUST_CLOSE`가 애초에 발생하지 않고, `PlatformWebSocketHandler`를 거치지도 않는다. + - 실컨테이너 레인도 못 잡는다: `WebSocketFixtureApplication.java:52`의 애플리케이션 람다가 + 항상 짧은 `"echo:" + message`를 돌려주므로 8KiB 버퍼를 채울 수 없다. +- **왜 문제인가 (실패 시나리오)**: 느린 소비자가 8KB 버퍼(fixture 기준)를 채운 상태에서 + 요청을 하나 더 보낸다 → 응답이 `CONNECTION_MUST_CLOSE`로 거부됨 → 응답은 사라지고 + 연결은 살아 있음 → 클라이언트는 타임아웃까지 대기 → 재시도 → 같은 일 반복. + `OutboundQueue`의 `losslessOverflowed` 플래그(:170)는 서 있지만 아무도 읽지 않는다. +- **수정 방향**: + ```java + if (writer.offer(msg) == OutboundEnqueueResult.CONNECTION_MUST_CLOSE) { + closeFor(session, WebSocketFailureCategory.OVERLOADED, "outbound buffer exhausted"); + } + ``` + `WebSocketClosePolicy.closeCodeFor(OVERLOADED)` → `TRY_AGAIN_LATER`(1013)가 이미 준비돼 있다. +- **반론과 재반박**: "이 핸들러는 테스트 픽스처용 데모다." — `main/`에 있고 + `WebSocketStableModule.SERVLET`로 선언된 프로덕션 모듈이며, 이 leaf에서 컨테이너에 붙는 + **유일한** 코드다. 데모라면 `main`에 있으면 안 된다. + +#### H4. 롤링 재시작 게이트는 close code **1012**를 요구하는데, 실제 종료 경로는 **1001**을 보내고 1012는 enum에 없다 + +- **현상**: 같은 leaf 안의 두 모듈이 "재시작 시 어떤 close code를 보내는가"에 대해 서로 + 다른 답을 갖고 있고, 각자 자기 답에 대한 테스트를 갖고 있어서 둘 다 통과한다. +- **근거**: + - `release/WebSocketRollingRestartScenario.java:37` `SERVICE_RESTART = 1012`, + `:51-55` 생성자가 1012가 아니면 거부, `:21` Javadoc "Close is 1012 — service restart — **not 1001**". + - 실제 종료 경로: `servlet/PlatformWebSocketHandler.java:144` `session.close(CloseStatus.GOING_AWAY)` = **1001**. + - 정책 테이블: `lifecycle/CloseOrchestration.java:101` `case NODE_SHUTTING_DOWN -> WebSocketCloseCode.GOING_AWAY` = **1001**. + - `error/WebSocketCloseCode.java`에 **1012 상수 자체가 없다**(1000/1001/1008/1009/1011/1013 + 4xxx). + - **전수 독파 결과, 서로 모순되는 세 테스트가 각자 초록으로 통과한다:** + + | 테스트 | 단언 | + |---|---| + | `systemTest/.../TomcatWebSocketAbuseIT.shutdownClosesLiveConnections` | **실제 Tomcat + 실제 클라이언트**로 `handler.stop()` 후 관측 코드 `isEqualTo(1001)` | + | `test/.../lifecycle/ConnectionLifecycleTest.java:81` | `codeFor(NODE_SHUTTING_DOWN) == GOING_AWAY` (1001) | + | `test/.../release/WebSocketRollingRestartScenarioTest.wrongCloseCodeBlocks` | 관측 코드 **1001은 blocker**, 1012만 통과 | + + 즉 **실물 컨테이너 증거가 1001을 확인하는데, 같은 leaf의 릴리즈 게이트가 그 1001을 결함으로 + 판정한다.** `WebSocketRollingRestartScenarioTest.wrongExpectationIsRefused`는 한술 더 떠 + "1012가 아닌 시나리오는 생성 자체를 거부"하므로, 게이트를 실물에 맞추는 것조차 막는다. + - `error/WebSocketCloseCodeTest.everyDeclaredCodeIsSendable`은 이것을 잡을 수 없다 — + enum에 1012가 없으므로 순회 대상이 아니다. +- **왜 문제인가**: 이 게이트를 실제 롤링 배포에 적용하면 **항상 블로커가 뜬다** + (`observedCloseCode=1001 != 1012`). 게이트가 언제나 빨간불이면 사람들은 게이트를 끈다. + `WebSocketRollingRestartScenario` Javadoc 자신이 "1001 says the server is going away for good"이라 + 주장하는데, RFC 6455에서 1001은 "going away (서버 종료 또는 브라우저 이탈)"이고 + "for good"이라는 뜻은 없다. `PlatformWebSocketHandler:158-165`의 주석은 오히려 1001이 옳은 + 선택이라고 상세히 논증한다. **두 주석이 정면으로 충돌한다.** +- **수정 방향**: 하나를 고른다. 1012를 택하면 `WebSocketCloseCode`에 상수를 추가하고 + `CloseOrchestration.CloseReason`에 `NODE_RESTARTING`을 분리한다. + 1001을 택하면 `WebSocketRollingRestartScenario`의 상수와 검증을 고친다. +- **반론과 재반박**: "1012는 브라우저 지원이 나빠서 1001이 실용적이다." — 그럴 수 있다. + 그렇다면 게이트가 틀린 것이다. 어느 쪽이든 **지금은 둘 다 main에 있고 서로를 모른다**는 것이 결함이다. + +#### H5. [최종 수정] WebSocket/gRPC의 build-time opt-in 자체는 의도대로다 — 채택 절차가 불완전하다 + +**최종 판정: 원본 High에서 수정. 기능 결함이 아니라 채택 UX/문서 결함이다.** + +WebSocket/gRPC를 모든 bootJar에 싣고 ENV만으로 끄는 구조로 바꾸지 않는다. 이 두 capability는 Build +Composition에서 선택하는 것이 최종 목표와 일치한다. + +문제는 dependency, architecture registry, conditional transport contract, config import, env registry 등 +채택 절차가 한 곳에 정리되어 있지 않다는 점이다. + +1. `websocket/CLAUDE.md`와 `grpc/CLAUDE.md`에 Adopting this capability 절을 둔다. +2. 가능하면 여러 파일 수동 편집을 source-controlled composition 한 곳에서 파생되도록 줄인다. +3. 채택된 뒤에는 settings binding과 Bean graph가 runtime switch 밖에서 생성되지 않게 한다. +4. build-time 미선택과 runtime disabled를 서로 다른 계약으로 테스트한다. + +즉 이 finding은 ENV 토글로 바꾸라는 요구가 아니라 **Build Composition 절차를 명확하게 만들라는 요구**다. + +#### H6. composition root가 **배포하지 않는 두 leaf의 패키지를 `@ConfigurationPropertiesScan`에 등재해 두었다** — 채택 순간 마스터 스위치 밖에서 설정이 바인딩된다 + +- **현상**: `CaSkeletonApplication`의 `@ConfigurationPropertiesScan` 목록에 + `dev.caskeleton.adapter.inbound.grpc`와 `dev.caskeleton.adapter.inbound.websocket`이 들어 있다. + 두 leaf는 런타임 클래스패스에 없다. 있는 순간 **마스터 스위치와 무관하게** 설정이 바인딩된다. + +- **근거**: + - `app-bootstrap/src/main/java/dev/caskeleton/bootstrap/CaSkeletonApplication.java:70,72` + ```java + @ConfigurationPropertiesScan(basePackages = { + ..., + "dev.caskeleton.adapter.inbound.grpc", + "dev.caskeleton.adapter.inbound.web", + "dev.caskeleton.adapter.inbound.websocket", + ... + }) + ``` + - 같은 파일 `:26-30`의 Javadoc이 **이 패턴을 금지한다**: + > "The asymmetry that existed before — beans gated, settings not — is why a notification + > settings object bound itself in a deployment whose notification master was off. + > A capability whose beans are gated but whose settings still bind is gated only where + > somebody remembered to gate it." + > "The five optional adapters are absent from the list below on purpose." + - 그런데 websocket 패키지에는 `@ConditionalOnProperty` 없이 존재하는 + `@ConfigurationProperties(prefix = "backend.websocket")`가 있다 + (`config/WebSocketPlatformSettings.java:35`). `@EnableConfigurationProperties`로 + capability root에 묶여 있지 **않다** — 아무도 그걸 하지 않기 때문이다(C1/C2 참조). + +- **왜 문제인가 (실패 시나리오)**: leaf를 의존에 추가하는 순간, + `WebSocketPlatformSettings`가 `backend.websocket.*`를 **마스터 스위치 없이** 바인딩하는 + 빈으로 컨텍스트에 등록된다. `ca-skeleton.websocket.enabled=false`여도 등록된다. + 이건 Javadoc이 "notification 사고"로 기록한 것과 **정확히 같은 모양**이다. + 부수적으로 `docs/registries/env-keys.yaml`에 없는 `backend.websocket.*` 네임스페이스가 + 기동 시 바인딩 대상이 되므로 `configContractCheck`/`verifyEnvKeys`와도 충돌한다(H2와 연동). + +- **수정 방향**: 지금 당장은 두 항목을 `@ConfigurationPropertiesScan` 목록에서 제거한다 + (배포하지 않는 패키지를 스캔 목록에 두는 것 자체가 드리프트다). + 채택 시에는 `WebSocketPlatformSettings`를 capability root의 + `@EnableConfigurationProperties`로 옮겨 마스터 스위치에 묶는다. + +- **반론과 재반박**: "없는 패키지를 스캔해도 no-op이라 지금은 무해하다." — 무해하다. + 다만 (a) 이 파일의 Javadoc이 스스로 정한 규칙을 이 두 줄이 위반하고 있고, + (b) 이 목록은 "이 composition root의 멤버"를 선언하는 문서로 읽히는데 + `modules.json`의 `allowed_dependencies`와 **불일치**한다. + 둘 중 하나는 낡았고, 그걸 강제하는 검사가 없다. + +#### H7. gRPC 어댑터는 loopback 바인딩만 허용한다 — 쿠버네티스/컨테이너에서 **원리적으로 사용 불가** + +- **현상**: `enabled=true`이면서 `bindAddress`가 loopback이 아니면 기동이 실패한다. +- **근거**: `grpc/GrpcServerProperties.java:90-94` + ```java + @AssertTrue(message = "insecure gRPC requires allow-insecure-local=true and a loopback bind address") + public boolean isInsecureLocalConfigurationValid() { + return !enabled || (allowInsecureLocal && isLoopbackBindAddress()); + } + ``` + `GrpcServerRunner.java:73`은 `InsecureServerCredentials.create()` 하나뿐 — TLS 경로가 없다. + 테스트도 이를 고정한다: `GrpcSafeActivationTest.java:47-55` "insecureTransportRejectsANonLoopbackBindAddress". +- **왜 문제인가**: 파드 안에서 `127.0.0.1:9090`에 바인딩하면 **같은 파드의 다른 컨테이너만** + 접근할 수 있다. 다른 파드·서비스·ingress는 도달 불가다. 즉 이 어댑터로 서비스할 수 있는 + gRPC API는 사실상 사이드카 통신뿐이다. `README.md:92-93`과 `CLAUDE.md:73-74`가 "P1이고 + TLS/mTLS/external bind는 P2"라고 밝히긴 하지만, "그래서 지금은 클러스터에서 못 쓴다"는 + 귀결은 적혀 있지 않다. +- **수정 방향**: (a) TLS 크리덴셜 경로를 추가하고 TLS일 때만 non-loopback 허용, + 또는 (b) `CLAUDE.md`에 "현재 이 어댑터는 사이드카/로컬 전용이며, 클러스터 노출은 P2다"를 명시. +- **반론과 재반박**: "P1 범위를 정직하게 좁힌 것이고, 오히려 좋은 fail-closed다." — + fail-closed 자체는 훌륭하다(K3 참조). 다만 "602줄짜리 gRPC 어댑터가 기본 탑재돼 있다"를 + 읽은 사람의 기대와 "사이드카 전용"은 거리가 멀고, 그 거리가 문서에 없다. + +### Medium + +#### M1. `grpc/README.md:80-81`이 사실과 다르다 — build.gradle이 자기 README를 반박한다 +- **근거**: `README.md:80-81` "Spring Boot BOM 은 … 이 저장소엔 version catalog 도 없다." + `build.gradle:21-26`: "This sentence used to end 'and this repo has no version catalog', + **which is false**: gradle/libs.versions.toml exists and this leaf's siblings use it." + build.gradle에서 고쳤는데 README에는 반영하지 않았다. 코드가 사실, 문서가 결함. + +#### M2. `WebSocketSubprotocolName.stable()`이 다른 제품 브랜드를 박아 넣는다 +- **근거**: `core/WebSocketSubprotocolName.java:47` + `return new WebSocketSubprotocolName("hyeonworks.realtime.v1.json");` +- 기본 패키지가 `dev.caskeleton`인 템플릿에서, fork한 서비스가 아무것도 안 고치면 + `Sec-WebSocket-Protocol: hyeonworks.realtime.v1.json`을 네고시에이션한다. + 이건 클라이언트에게 공개되는 계약 문자열이다. `WebSocketProtocolProfile.stable()`(:60-63)이 + 이 값을 그대로 쓴다. +- **전수 독파로 확인한 추가 사실 — 브랜드가 두 군데 더 있고, 하나는 테스트로 못 박혀 있다:** + - `test/.../protocol/WebSocketProtocolProfileTest.stableSubprotocolIsVersioned`가 + `assertThat(STABLE.value()).isEqualTo("hyeonworks.realtime.v1.json")`로 단언한다. + **fork 사용자가 이 값을 고치면 테스트가 깨진다.** 고치라는 안내는 어디에도 없다. + - `nginxWebSocketTest/resources/nginx/nginx.conf`의 `server_name hyeonworks.com`, + `proxy_set_header X-Forwarded-Host hyeonworks.com`. 프록시 계약 레인이 남의 도메인을 전제한다. +- **수정 방향**: `ca-skeleton.realtime.v1.json`으로 바꾸고 테스트 단언도 같이 옮긴다. + 더 나은 방향은 `WebSocketPlatformSettings`에 subprotocol을 두어 배포가 정하게 하는 것. + nginx.conf 도메인은 `example.com`으로. + +#### M3. resume 토큰의 "단회용" 주장이 구현되지 않았다 +- **근거**: `advanced/resume/ResumeTokenOutcome.java:1402` `REPLAYED` — + "a token is single-use, so a second presentation is either a client that retried … or somebody + replaying a captured token." `:1405` `NOT_AUTHORISED`. + 그런데 `ResumeTokenCodec.decode(...)`(:1126-1187)가 반환할 수 있는 값은 + `TAMPERED / UNSUPPORTED_VERSION / UNKNOWN_KEY / EXPIRED / ACCEPTED`뿐이다. + 사용 이력 저장소가 없으므로 `REPLAYED`는 **도달 불가능**하다. + `ResumeCoordinator.decide`(:911-957)도 `authorises()` 실패 시 `refused(...)`를 반환할 뿐 + `NOT_AUTHORISED`를 쓰지 않는다. +- **왜 문제인가**: 토큰 수명이 있긴 하지만, 그 창 안에서는 캡처한 토큰을 몇 번이든 쓸 수 있다. + `ResumeTokenPayload` Javadoc(:1442-1443)이 "a token presented twice asks for the same range + twice, which is a different thing"이라며 탐지 가능성을 주장하지만 탐지하는 코드가 없다. +- **수정 방향**: `WebSocketTicketStore`와 같은 atomic redeem 포트를 resume에도 도입하거나, + 주장에서 "single-use"를 뺀다. + +#### M4. `OutboundQueue.offer`에 죽은 분기, 글로벌 예산은 write 완료가 아니라 poll 시점에 반납된다 +- **근거**: + - `outbound/OutboundQueue.java:83-89` + ```java + if (!roomLocally || !globalBudget.reserve(bytes)) { + if (roomLocally) { return refuse(message); } + return refuse(message); // 두 분기가 동일 + } + ``` + 동작상 문제는 없지만 주석(:85-86)이 설명하는 구분이 코드에 반영돼 있지 않다. + - `:100-113` `poll()`이 큐에서 꺼내는 순간 `globalBudget.release(...)`를 호출한다. + 실제 소켓 write는 그 뒤 `SerializedOutboundWriter.drain()`(:712)에서 락 바깥에서 일어난다. + 느린 피어 하나당 최대 1메시지 분량이 노드 예산에서 빠진 채 heap에 머문다. + `maxBufferedBytes` 계산이 그만큼 낙관적이다. +- **수정 방향**: 죽은 분기는 합치고, release는 `sink.write` 성공 후로 옮긴다. + (후자는 락 구조를 건드리므로 신중히.) + +#### M5. gRPC 어댑터가 컨텍스트의 **모든** `BindableService` 빈을 무조건 등록한다 +- **근거**: `GrpcServerRunner.java:63,80-84` — `ObjectProvider.orderedStream()`을 + 전부 등록. 필터가 없다. +- **왜 문제인가**: composition root가 다른 목적으로 `BindableService`를 노출하는 라이브러리를 + 추가하면(예: 관측 도구, `src/grpc/*` 플랫폼 채택 시) 그 서비스가 **의도치 않게 gRPC 포트에 + 공개된다.** 인증 인터셉터는 붙지만, 그 서비스가 존재해야 하는지는 아무도 결정하지 않았다. +- **수정 방향**: 마커 애노테이션이나 `@Qualifier`로 "이 어댑터가 노출할 서비스"를 명시. + loopback 전용(H7)이라 지금 위험은 낮지만, H7이 풀리면 같이 올라간다. + +#### M6. 모듈 purity 탐지기가 `dev.caskeleton.application` 을 프레임워크로 세지 않아, CORE 선언이 실제보다 느슨하다 + +- **현상**: `advanced` 모듈은 `WebSocketStableModule.java:214-223`에서 **`WebSocketModulePurity.CORE`** + 로 선언돼 있다. 그런데 그 하위 패키지 `advanced.cluster` / `advanced.presence` / `advanced.resume`의 + 세 클래스가 `dev.caskeleton.application.realtime.*`를 import 한다. +- **근거**: + - `test/.../moduleboundary/WebSocketBuildModel.java:44-51`의 `FRAMEWORK_IMPORT` 정규식: + ``` + ^(org\.springframework|jakarta|reactor|io\.micrometer|com\.fasterxml|tools\.jackson|org\.slf4j|io\.swagger)\. + ``` + `dev.caskeleton.application`도 `dev.caskeleton.domain`도 목록에 없다. + - `WebSocketModuleBoundary.moduleIdForPackage`는 longest-prefix 매칭이므로 + `advanced.cluster`는 `advanced` 모듈(CORE)에 귀속된다. + - 따라서 `MessagingFanoutAdapter.java:302-304`, `PortBackedExternalSessionIndex.java:405-409`, + `PortBackedPresenceStore.java:749-751`, `PortBackedReplayAvailability.java:781`의 + application-core import는 `frameworkImportsInCoreModules`에 걸리지 않는다. +- **왜 문제인가**: CORE의 약속은 Javadoc(`WebSocketModulePurity.java:16-24`)에 따르면 + "Java 표준 라이브러리와 이 플랫폼 자신의 타입만"이다. 지금 CORE 모듈 하나가 + **다른 Gradle leaf의 타입**에 의존하고 있고, 그걸 막기로 한 탐지기가 그 카테고리를 모른다. + 실질 위험은 낮다(application-core는 순수하고 `modules.json`이 이 edge를 허용한다). + 다만 "CORE = 다른 leaf와도 무관"이라고 읽으면 틀리고, 탐지기는 그 오독을 정정해 주지 않는다. +- **수정 방향**: 둘 중 하나. (a) `FRAMEWORK_IMPORT`에 `dev\.caskeleton\.(application|domain)\.`을 + 추가하고 `advanced`를 `FRAMEWORK_BOUND`로 내리거나, (b) `WebSocketModulePurity`에 + "CORE는 application-core 포트까지 허용"을 명시하고 Javadoc을 고친다. + (b)가 현실에 맞다 — 포트 의존은 의도된 설계이기 때문이다. +- **반론과 재반박**: "application-core는 프레임워크가 아니니 목록에 없는 게 맞다." — 맞다. + 결함은 분류가 아니라 **선언과 탐지 범위가 어긋나 있다**는 것이다. `advanced` 하위 세 클래스는 + "서버 없이 테스트 가능"이라는 CORE의 실질 목적은 충족하므로 심각도는 Medium이다. + +#### M7. 커밋 안 된 변경으로 `:adapter:inbound:websocket:test`의 성격이 바뀌었는데 `CLAUDE.md`는 그대로다 +- `CLAUDE.md:7`의 focused test는 `./gradlew :adapter:inbound:websocket:test`. + 변경 후 이 명령은 더 이상 Tomcat 컨테이너 테스트를 포함하지 않는다(§7 참조). + `CLAUDE.md:74-77`의 "Evidence and limits"는 여전히 `WebSocketBoundaryQualificationTest`가 + `test`에 있는 것처럼 읽힌다. 실제로는 `systemTest` 레인이다. + +### Low + +- **L1** `GrpcServerRunner.java:65` — feature service가 **없을 때**는 정책이 2개여도 검증하지 않는다. + `policies.size() == 1 ? policies.getFirst() : null`(:70)이라 정책 2개면 조용히 null(무인증)이 된다. + 서비스가 없으면 health만 노출되므로 실피해는 없지만, 조건을 + `policies.size() > 1`도 거부하도록 넓히는 편이 일관적이다. +- **L2** `stomp/WebSocketProperties.java`에는 `ignoreUnknownFields = false`가 없고 + `grpc/GrpcServerProperties.java:17`에는 있다. 같은 저장소의 형제 어댑터끼리 바인딩 엄격도가 다르다. +- **L3** `moduleboundary/WebSocketStableModule.java:86-88` — `HANDSHAKE` 항목에 + `/** The handshake admission pipeline. */` Javadoc이 **두 번** 연속으로 붙어 있다(복붙 잔해). + +--- + +## 6. 바꾸지 말 것 (Keep) + +### K1. WebSocket/gRPC를 bootJar에서 빼고 build-time 옵트인으로 둔 것 + +- **무엇**: `app-bootstrap`의 `allowed_dependencies`에서 제외 + `conditionalTransportTestImplementation`으로만 참조 + (`src/app-bootstrap/build.gradle:213-215`, `src/config/architecture/modules.json`). +- **왜 지금 이게 맞는가**: + - WebSocket 플랫폼은 §2.2에서 본 대로 **배선 자체가 없다.** 배선 없는 12,000줄을 bootJar에 + 넣으면 `spring-boot-starter-websocket`과 `spring-webflux`, `reactor-core`가 런타임 + 클래스패스에 올라온다. `websocket/build.gradle:30-34`가 직접 경고하듯 webflux가 올라오면 + Boot의 애플리케이션 타입 추론이 흔들린다. 이건 "꺼도 안 꺼지는" 비용의 교과서적 사례이고, + 지금 구조는 그 비용을 **0으로** 만든다. + - 같은 leaf가 `jackson-dataformat-cbor`와 `protobuf-java`를 **compileOnly**로 둔 이유 + (`websocket/build.gradle:37-52`)도 동일 논리다. 그 jar들은 존재만으로 Boot가 + `cborMapper` 빈과 Protobuf 컨버터를 등록시키고, 형제 web leaf에서 실제로 + "`ObjectMapper` 빈 3개" 사고를 냈다고 기록돼 있다. 이 판단은 경험에서 나온 것이다. + - gRPC는 `io.grpc:grpc-netty-shaded`(수십 MB)와 별도 protobuf 런타임을 끌고 온다. + `grpc/build.gradle:24-26`이 명시하듯 websocket(카탈로그 protobuf)과 grpc(root ext protobuf)의 + protobuf 메이저가 다르다. 둘을 같은 런타임 클래스패스에 올리면 충돌한다. + **두 leaf가 composition root에 없다는 사실이 지금 그 충돌을 막고 있다.** +- **언제 재검토**: (a) WebSocket 플랫폼에 진짜 composition(`WebSocketPlatformConfiguration`)이 + 생겨서 C1/C2가 해결될 때, (b) protobuf 버전이 카탈로그로 통일될 때. + 그때는 GraphQL과 같은 모양(bootJar 포함 + `APP_*_ENABLED:false`)으로 승격하는 것이 맞다. + +### K2. `WebSocketStableModule` + `WebSocketModuleBoundaryTest` — 이 저장소의 최고 자산 중 하나 + +- **무엇**: leaf 내부 패키지를 "모듈"로 선언하고(`moduleboundary/WebSocketStableModule.java`, 30개 항목), + 각 모듈의 **purity 등급**(CORE = 프레임워크 타입 금지)과 **허용 edge 집합**을 명시한 뒤, + 소스트리를 스캔해 양방향으로 대조한다(`test/.../moduleboundary/WebSocketModuleBoundaryTest.java`). +- **왜 지금 이게 맞는가**: + - `modules.json`이 fail-closed로 leaf 목록을 소유하므로 18개 Gradle 모듈로 쪼갤 수 없다. + "그러면 패키지로 하되 기계로 검증한다"는 것은 제약에 대한 **정직한** 대응이다. + - 탐지기 자체를 검증한다: `:79-127`이 `@TempDir`에 위반 샘플을 직접 만들어 + "미선언 edge", "CORE에 프레임워크 import", "CORE에 `WebSocketSession`", "미선언 패키지"를 + 각각 잡는지 확인한다. `:39-43`은 스캔이 0파일을 읽고 "깨끗함"을 보고하는 경우를 막는다. + **"아무것도 못 찾는 탐지기는 위반이 없는 코드베이스와 구분되지 않는다"**는 문제를 + 이 저장소에서 유일하게 정면으로 다룬 곳이다. + - `servlet ↔ webflux` edge가 **없다**는 것을 명시적으로 단언한다(`:73-74`). + 부재를 테스트하는 건 드물고 어렵다. + - 나중에 패키지 하나를 진짜 Gradle leaf로 승격시킬 때, 의존 그래프를 다시 발굴할 필요가 없다. +- **언제 재검토**: 패키지가 실제 leaf로 승격되어 Gradle이 같은 것을 강제하게 되면, + 그 모듈에 한해 중복이 된다. 그 전까지는 유지. + +### K3. gRPC의 fail-closed 설정 검증 — plaintext는 loopback에서만 + +- **무엇**: `grpc/GrpcServerProperties.java:90-94` + `:104-113`. + `enabled=true`이면 `allowInsecureLocal=true` **그리고** 실제로 resolve된 loopback 주소여야 한다. + 문자열 비교가 아니라 `InetAddress.getByName(...).isLoopbackAddress()`로 판정한다(:96-102). +- **왜 지금 이게 맞는가**: + - TLS 경로가 아직 없다는 사실을 **설정으로 강제**한다. 흔한 대안("경고 로그만 찍고 뜬다")은 + 스테이징에서 아무도 안 읽고 프로덕션에 그대로 간다. + - 문자열이 아니라 resolve 결과를 보므로 `localhost.evil.example` 같은 우회가 막힌다. + - `reflectionEnabled`가 `enabled`와 **독립된 플래그**다(:35-36). 서버를 켜는 것과 + 스키마 전체를 공개하는 것은 다른 결정이다. `GrpcP1BoundaryWireTest:110-117`이 + 실제 채널로 reflection이 `UNIMPLEMENTED`임을 확인한다. + - feature 서비스가 있는데 인증 정책이 정확히 1개가 아니면 리스너 시작을 거부한다(`GrpcServerRunner.java:65-68`). + "인증 붙이는 걸 깜빡함"이 기동 실패가 된다. +- **언제 재검토**: TLS/mTLS 크리덴셜 경로가 추가될 때. 그때는 "TLS면 non-loopback 허용"으로 + 조건을 넓히되, plaintext + non-loopback 조합은 계속 거부해야 한다. + +### K4. gRPC를 third-party starter 없이 `SmartLifecycle`로 직접 소유한 것 + +- **무엇**: `GrpcServerRunner implements SmartLifecycle`, `getPhase() = Integer.MAX_VALUE - 1` + (`GrpcServerRunner.java:31,142-145`). +- **왜 지금 이게 맞는가**: + - `grpc-spring-boot-starter` 류는 Spring Boot 릴리스에 버전이 커플링된다. + 이 저장소는 Boot 4.0.x라는 최신 라인을 쓴다 — starter가 따라오지 못하면 전체가 막힌다. + io.grpc 런타임에만 의존하면 그 리스크가 없다. + - phase가 `MAX_VALUE - 1`이라 web 서버 **뒤에** 시작하고 **먼저** 멈춘다. 종료 시 + `healthStatusManager.enterTerminalState()`(:112)로 health를 NOT_SERVING으로 뒤집고 + `shutdownGraceSeconds` 동안 in-flight RPC를 기다린 뒤 `shutdownNow()`(:113-117). + LB 드레이닝을 고려한 순서다. + - 전체가 8파일 602줄이다. starter 하나를 받는 것보다 **읽고 검증하기 쉽다.** +- **언제 재검토**: gRPC 기능이 스트리밍·deadline·인터셉터 체인으로 커지면 직접 소유 비용이 + starter 비용을 넘는다. 지금은 넘지 않았다. + +### K5. `GrpcExceptionHandlingInterceptor`가 `ServerCall.close`까지 감싸는 것 + +- **무엇**: 핸들러 throw, listener 콜백 throw, `responseObserver.onError(...)`, + raw `StatusRuntimeException` — 네 경로가 **전부** 같은 sanitizer를 지난다 + (`GrpcExceptionHandlingInterceptor.java:90-112`의 `SimpleForwardingServerCall.close` 오버라이드). +- **왜 지금 이게 맞는가**: + - 인터셉터만 있고 `close`를 안 감싸면 `observer.onError(Status.ABORTED.withDescription(secret))`가 + 그대로 클라이언트에 나간다. 이건 흔히 놓치는 구멍이다. + - `GrpcP1BoundaryWireTest`가 네 경로 각각에 **고유 sentinel 문자열**을 심고 + (`HANDLER_SENTINEL`, `LISTENER_SENTINEL`, `CARRIER_SENTINEL`, `RAW_STATUS_SENTINEL`, :44-48), + 실제 loopback Netty 채널을 통해 status/trailers 어디에도 안 나오는지 확인한다(:235-238). + **"유출 안 됨"을 음성 단언으로 증명한 드문 사례다.** + - `AtomicBoolean closed`(:42, :95)로 이중 close를 막는다. + - 인식 못 하는 예외는 원래 status를 신뢰하지 않고 `INTERNAL` + `INTERNAL_ERROR`로 떨어뜨린다(:104-106). + fail-closed 방향이 맞다. +- **언제 재검토**: 스트리밍 RPC가 추가되면 `onHalfClose`/`onMessage` 외의 경로가 생긴다. + 그때 sentinel 테스트를 스트리밍으로 확장해야 한다. + +### K6. `SafeStompSubProtocolErrorHandler` — 모든 STOMP 실패를 고정 코드 + 빈 바디로 + +- **무엇**: `stomp/SafeStompSubProtocolErrorHandler.java:14-31`. + 예외 메시지도, 거부된 destination도, 클라이언트가 보낸 내용도 ERROR 프레임에 반사하지 않는다. +- **왜 지금 이게 맞는가**: + - STOMP destination은 클라이언트가 보내는 자유 문자열이다. 이걸 에러에 되돌려주면 + (a) 어떤 destination이 존재하는지 프로버에게 알려주고, (b) 로그를 읽는 쪽에 대한 + 주입 경로가 된다. + - `WebSocketBoundaryQualificationTest:182-190`이 `/topic/SECRET_SENTINEL`로 SEND를 던지고 + ERROR 프레임 전체에 `SECRET_SENTINEL`이 없음을 확인한다. **실제 소켓으로 검증된 음성 단언.** + - 진단 정보를 잃는다는 비용은 있지만, 서버 로그에는 남는다(`WebSocketPolicyViolationException`). +- **언제 재검토**: 클라이언트 개발자가 디버깅 못 하겠다는 불만이 실제로 나오면, + `local` 프로파일에 한해 상세 코드를 허용하는 방안. 단 prod 기본은 지금이 맞다. + +### K7. `LiveEventStompBroadcaster`의 "프로젝터 정확히 1개" 규칙 + +- **무엇**: `@DomainEvent` 애노테이션이 붙은 이벤트를, 그 **정확한 클래스**에 대한 + `LiveEventProjector`가 정확히 1개일 때만 전송한다. 0개면 "공개 이벤트가 아님", 2개 이상이면 + "소유권 모호" — 둘 다 drop (`stomp/LiveEventStompBroadcaster.java:64-74`). +- **왜 지금 이게 맞는가**: + - `@DomainEvent`는 마커일 뿐이다. 이걸 "전송해도 되는 것"으로 해석하면, 도메인 레코드에 + 필드 하나 추가하는 순간 그 필드가 공개 API가 된다. **템플릿에서 이건 치명적이다** — + fork한 사람은 자기 도메인 이벤트에 뭘 넣을지 모른다. + - projector 출력은 `Map`으로 받아 필드 수 32개, 이름 64자, 값 512자, + 총합 4096자로 검증한다(:31-35, :109-130). 도메인 객체가 `SimpMessagingTemplate`에 + 직접 넘어가는 경로가 없다. + - `WebSocketBoundaryQualificationTest:154-171`이 projector 없는 이벤트를 발행하고 + **아무 프레임도 안 나가는 것**을 400ms 동안 확인한다. 부재 단언이다. +- **언제 재검토**: 이벤트 종류가 수십 개가 되어 projector 보일러플레이트가 부담이 되면, + "명시적 allowlist + 자동 매핑" 조합을 고민할 수 있다. 다만 기본값은 계속 "불허"여야 한다. + +### K8. 테스트가 "탐지기 자신을 검증"하는 관행 — 이 저장소 전체로 확산시킬 가치가 있다 + +- **무엇**: 검사 장치를 만들 때마다 **그 장치가 실패할 수 있음을 증명하는 대조군**을 함께 둔다. + 전수 독파로 6곳에서 확인했다: + | 위치 | 대조군 | + |---|---| + | `arch/WebSocketArchitectureRulesTest.java:22-28` | 임포트한 클래스가 30개 초과인지 확인 — 빈 셋에 통과하는 걸 차단 | + | `arch/WebSocketArchitectureRulesTest.java:33-53` | 같은 ArchUnit 룰을 transport 타입이 실제로 있는 패키지에 적용해 `AssertionError`를 확인 | + | `moduleboundary/WebSocketModuleBoundaryTest.java:79-127` | `@TempDir`에 위반 샘플 4종을 실제로 써서 탐지 확인 | + | `moduleboundary/WebSocketBuildModel.java:120-125` | 스캔 0파일이면 **예외를 던짐** | + | `nginxWebSocketTest/.../NginxWebSocketContractIT.java:95-107` | 일부러 망가뜨린 `nginx-no-upgrade.conf`로 연결 실패 확인 | + | `jettyWebSocketTest/.../JettyWebSocketRuntimeIT.java:34-41` | 실제로 Jetty에서 도는지 확인 — 같은 컨테이너 두 번 인증 차단 | +- **왜 지금 이게 맞는가**: 이 저장소의 다른 리뷰 영역에서 반복해서 나오는 결함이 + "존재하고, 테스트를 통과하고, 아무것에도 적용되지 않는 통제"다. C2가 정확히 그 사례다. + 이 leaf는 **그 실패 모드를 스스로 인지하고 구조적으로 막아 놓은 유일한 곳**이다. + `WebSocketStableReleaseGateTest` 클래스 Javadoc이 그걸 말로도 적어 뒀다: + "A gate whose refusals are never exercised is the failure this repository keeps finding." +- **언제 재검토**: 재검토할 이유가 없다. 오히려 **C2를 고칠 때 같은 관행을 적용해야 한다** — + `WebSocketPlatformStartupValidator`를 배선한 뒤, "배선돼 있음"을 증명하는 대조군 + (예: 위험 설정으로 컨텍스트를 띄워 기동 실패를 확인)을 함께 둔다. + +### K9. 커밋 안 된 변경: 컨테이너 테스트를 `test` → `systemTest`로 옮긴 것 + +§7에서 상세히 다룬다. 결론만: **안전망을 자른 것이 아니라 레인을 나눈 것이다. 유지.** + +### K10. 부품 테스트가 "순서"를 부수효과로 증명하는 방식 + +- **무엇**: 순서 보장을 주석이나 코드 리딩이 아니라 **관측 가능한 부수효과**로 단언한다. + - `handshake/HandshakeAdmissionPipelineTest.java:101-118, 128-145, 148-163` — + 404/403/503 각 케이스에서 `tickets.redemptions()`가 **0**임을 확인. "티켓 조회 전에 거부했다"가 사실로 증명된다. + - `advanced/resume/ResumeDecisionTest.java:68-77` — `ReplayAvailability`를 **호출되면 던지는 람다**로 + 주입해 "authorisation이 availability보다 먼저"를 증명. +- **왜 지금 이게 맞는가**: 핸드셰이크 admission 순서는 이 플랫폼의 CSRF 방어와 DoS 방어가 + 모두 걸려 있는 지점이다(`HandshakeAdmissionPipeline` Javadoc :356-375). + 순서를 바꾸는 리팩토링은 **컴파일도 되고 기존 케이스도 전부 통과한다** — 이 부수효과 단언만이 잡는다. +- **언제 재검토**: 없음. 조합층을 새로 쓸 때 같은 기법을 그대로 써야 한다. + +--- + +## 7. 커밋 안 된 리팩토링이 이 영역에 미친 영향 + +### 7.1 변경 내역 + +``` + M src/adapter/inbound/websocket/build.gradle (+15 -4) + M src/adapter/inbound/websocket/gradle.lockfile (±238) + D .../src/test/.../runtime/TomcatWebSocketAbuseIT.java (-84) + D .../src/test/.../runtime/TomcatWebSocketRuntimeIT.java (-25) + D .../src/test/.../stomp/WebSocketBoundaryQualificationTest.java (-357) +?? src/adapter/inbound/websocket/src/systemTest/ +``` + +`adapter/inbound/grpc`는 **변경 0**이다. + +### 7.2 삭제가 아니라 이동이다 — 검증했다 + +세 파일의 diff에서 삭제된 줄과 `src/systemTest/` 아래 새 파일을 공백 제외 비교한 결과: + +``` +TomcatWebSocketAbuseIT.java identical(non-blank): True old 75 new 75 +TomcatWebSocketRuntimeIT.java identical(non-blank): True old 21 new 21 +WebSocketBoundaryQualificationTest identical(non-blank): True old 305 new 305 +``` + +**한 줄도 바뀌지 않았다.** 경로만 `src/test/` → `src/systemTest/`로 옮겼다. + +### 7.3 build.gradle 변경이 무엇을 바꿨는가 + +- `auxiliarySourceSets`에 `systemTest` 추가 (`build.gradle:62-64`) +- `strictTestLanes`에 `lane('systemTest') { system() ... }` 추가 (`:117-122`) +- `lane('websocketJettyTest')`에 `system()` 마킹 추가 (`:134`) +- 자격시험 등록 소스셋 변경 (`:151-153`): + ```diff + - sourceSets.test, + + sourceSets.systemTest, + ``` + +### 7.4 판정: **유지보수 부담을 줄인 것이다. 안전망은 그대로다.** + +근거 넷: + +1. **자격시험 증거는 그대로 블로킹이다.** + `ConditionalTransportQualificationPlugin.java:54`가 부르는 태스크 이름은 + `:adapter:inbound:websocket:websocketTransportQualificationTest`로 **바뀌지 않았다.** + 그 태스크가 가리키는 소스셋만 바뀌었고, 클래스 이름 단언 + (`'dev.caskeleton...WebSocketBoundaryQualificationTest'`, `build.gradle:155`)은 그대로다. + `verifyNoSkipJUnitXml`(플러그인 :64)도 그대로 적용된다. + +2. **`:websocket:test`가 더 이상 Docker/컨테이너를 요구하지 않는다.** + 이건 실질적 개선이다. 개발자의 빠른 루프가 Tomcat 부팅에 묶여 있으면 아무도 안 돌린다. + 같은 논리가 `app-bootstrap/build.gradle:15-20`에 이미 명시돼 있고, + 이번 변경은 그 규약을 websocket leaf에도 적용한 것이다. **일관성이 늘었다.** + +3. **잃은 것이 있다면 하나: `./gradlew :adapter:inbound:websocket:check`의 의미가 좁아졌다.** + 변경 전에는 `check` 한 번으로 실컨테이너 계약까지 돌았다. 지금은 `systemTest` 레인을 + 따로 불러야 한다. CI가 `integrationCheck`/자격시험 레인을 돌린다면 손실은 없지만, + **로컬에서 `check`만 돌리고 "다 됐다"고 판단하는 사람에게는 커버리지가 줄었다.** + `CLAUDE.md:7`의 focused test 안내가 이를 반영하지 않은 것이 M6이다. + +4. **`gradle.lockfile` 238줄 변경은 새 소스셋 3개(systemTest 관련 configuration)가 추가되면서 + 생긴 락 엔트리다.** 프로덕션 런타임 의존은 `build.gradle`의 `dependencies` 블록이 + 바뀌지 않았으므로 변하지 않았다. (빌드 미실행이라 lockfile 내용은 대조하지 않았다 — §9) + +### 7.5 이 영역 밖이지만 확인한 사실 + +브리프가 말한 "검증 표면 축소 — 테스트킷 IT, `application-test.yml`, openapi 스냅샷 대량 삭제" +흐름에서, **이 영역은 삭제가 아니라 재배치만 겪었다.** 이 영역 diff에 순삭제는 0줄이다. + +--- + +## 8. 템플릿 사용자 관점 + +fork해서 이 영역을 쓰려는 사람이 실제로 겪을 일. 세 시나리오로 나눈다. + +### 시나리오 A — "실시간 푸시가 필요하다. STOMP면 충분하다." + +**가능하다. 이 영역에서 가장 잘 정돈된 경로다.** + +손대야 하는 파일: +1. `src/app-bootstrap/build.gradle` — `implementation project(':adapter:inbound:websocket')` +2. `src/config/architecture/modules.json` — `app-bootstrap.allowed_dependencies`에 `adapter-inbound-websocket` 추가 + (**안 하면 `architectureCheck` 실패.** 에러 메시지는 명확하다: + "Module ':app-bootstrap' has forbidden project dependencies […]") +3. `src/app-bootstrap/src/conditionalTransportTest/.../ConditionalTransportCompositionContractTest.java:22-27` — + `BUILD_ONLY_TRANSPORTS` 맵에서 websocket 항목 제거 (**안 하면 이 테스트가 실패**) +4. `src/app-bootstrap/src/main/resources/config/websocket.yml` 신규 + `application.yml`의 + `spring.config.import`에 등록 +5. `docs/registries/env-keys.yaml` — `APP_WEBSOCKET_ENABLED` 등 등재 (**안 하면 `verifyEnvKeys` 실패**) +6. 자기 도메인 이벤트마다 `LiveEventProjector` 빈 작성 +7. HTTP 경계에서 `Principal`을 세우는 필터 확보 — + `AuthenticatedHandshakeInterceptor:20-24`는 **이미 있는** Principal만 본다. 토큰을 해석하지 않는다. + `WebSocketBoundaryQualificationTest:324-350`의 픽스처 필터가 그 모양의 예시다. + +**밟게 될 지뢰:** +- `ca-skeleton.websocket.allowed-origins` 기본값이 `http://localhost:3000`이다 + (`WebSocketProperties.java:22`). prod에서 안 고치면 아무 브라우저도 연결 못 한다 — 그리고 + 실패는 401/403이 아니라 **핸드셰이크 403**으로 나온다. 원인 찾기 어렵다. +- 와일드카드는 `@AssertTrue`로 거부된다(`:74-82`). 이건 좋은 지뢰다. +- 구독 가능한 destination은 **`broadcast-destination` 하나뿐이다** + (`WebSocketInboundAuthorizationInterceptor.java:34-37`). 여러 토픽을 쓰려면 이 클래스를 고쳐야 한다. + `CLAUDE.md:56`에 적혀 있지만 "제약"이 아니라 "정책"처럼 읽힌다. +- 멀티 인스턴스에서 `enableSimpleBroker("/topic")`(`WebSocketConfig.java:64`)는 + **발행한 노드에 붙어 있는 클라이언트에게만 간다.** `README.md:39-44`가 정직하게 밝히지만, + `APP_MULTI_INSTANCE_ENABLED=true`로 켜도 이쪽은 아무 검사도 받지 않는다. + `StartupSafetyValidator`가 "multi-instance인데 조정 빈 없으면 기동 실패"시킨다고 브리프에 있는데, + 그 검사 대상에 WebSocket은 없다(이 leaf가 composition root 밖이라 당연하다). + **채택하는 순간 이 조합이 조용히 깨진다.** + +### 시나리오 B — "WebSocket 플랫폼(백프레셔·resume·클러스터)을 쓰고 싶다." + +**현재로서는 불가능에 가깝다. 스스로 composition을 작성해야 한다.** + +없는 것: +- `WebSocketPlatformSettings`를 바인딩하는 `@EnableConfigurationProperties` — 없음 +- `WebSocketEndpointCatalog` / `WebSocketOriginPolicy` / `WebSocketMessageCatalog` / + `WebSocketWireTypeManifest` / `MessageAuthorizationPolicy` / `WebSocketAuthenticationProfile` / + `WebSocketProtocolProfile` / `WebSocketTicketStore` 빈 — 전부 없음 +- `PlatformWebSocketHandler`를 `WebSocketConfigurer`에 등록하는 코드 — 없음 + (testFixtures에 예시는 있다: `testkit/runtime/WebSocketFixtureApplication.java:60-63`) +- 하트비트를 실제로 보내는 스케줄러 — 없음 (`HeartbeatPolicy`는 판정 함수만 제공) +- 유휴/최대수명 연결을 실제로 끊는 스케줄러 — 없음 + (`WebSocketSessionRegistry.expiredAt(...)`:1238-1244는 목록만 반환) +- `WebSocketAdminOperations` 구현 — 없음 (인터페이스만) +- `CommittedResultLedger` / `WebSocketTicketStore` 구현 — 없음 (의도적. Javadoc이 + "트랜잭션 원장이 아니면 의미 없으므로 기본 구현을 안 준다"고 명시) + +즉 **부품은 전부 훌륭한데 조립 설명서와 조립된 완제품이 없다.** +`testkit/runtime/WebSocketFixtureApplication.java`가 사실상 유일한 조립 예시이고, +그건 인증 없는 64줄짜리 에코 서버다. + +**전수 독파로 확인한 규모 감각**: 부품 쪽은 482개 테스트로 계약이 고정돼 있어 재작성이 필요 없다(§4-B.2). +채택자가 새로 써야 하는 것은 **조합층 하나**다 — 프레임 수신부터 응답 큐잉까지의 파이프라인, +하트비트·유휴·만료·tombstone eviction을 도는 스케줄러, 멱등성 claim→commit→record 흐름, 그리고 +그 전부를 잇는 `@Configuration`. 그리고 그 새 코드는 **기존 테스트가 한 줄도 커버하지 않는다.** +`fault/CommandLossRecoveryTest.java:59-73`이 그 파이프라인의 한 갈래를 테스트 안에 구현해 두었으므로, +적어도 멱등성 흐름은 참고할 레퍼런스가 있다. + +이 시나리오를 시도하는 사람은 C1(켜면 기동 실패)과 C2(가드 미실행)를 **반드시** 만난다. + +### 시나리오 C — "gRPC API를 만들고 싶다." + +**사이드카/로컬 통신이면 가능. 클러스터 노출이면 불가능(H7).** + +손대야 하는 파일: 시나리오 A와 동일한 1~5번(`websocket`을 `grpc`로) + +`.proto` 소유 모듈 신설 + `BindableService` 빈 + `GrpcAuthenticationPolicy` 빈 1개. + +**밟게 될 지뢰:** +- `bindAddress`를 `0.0.0.0`으로 바꾸면 기동이 실패한다(`GrpcServerProperties.java:90-94`). + 에러 메시지("insecure gRPC requires allow-insecure-local=true and a loopback bind address")는 + "TLS를 붙이면 된다"로 읽히지만, **TLS 경로가 구현돼 있지 않다.** + `GrpcServerRunner.java:73`에 `InsecureServerCredentials.create()` 하나뿐이다. + 여기서 막히면 어댑터를 직접 고치는 수밖에 없다. +- protobuf 버전이 websocket leaf(catalog `protobuf`)와 gRPC leaf(root `ext.protobufVersion`)에서 + **메이저가 다르다**(`grpc/build.gradle:21-26` 본인 주석). 두 leaf를 동시에 채택하면 충돌한다. + "오늘은 둘 다 composition root에 없어서 만나지 않는다"는 것이 현재 상태다. +- feature 서비스를 하나라도 넣으면 `GrpcAuthenticationPolicy`를 **정확히 1개** 줘야 한다. + 0개거나 2개면 기동 실패(`GrpcServerRunner.java:65-68`). 이건 좋은 지뢰다. + +### 요약 판정 (템플릿 관점) + +| | 상태 | +|---|---| +| STOMP 실시간 푸시 | **쓸 수 있다.** 단 5개 파일 편집 + 멀티 인스턴스 한계 인지 필요 | +| gRPC (사이드카) | **쓸 수 있다.** 에러 매핑·인증 경계·graceful shutdown이 잘 돼 있다 | +| gRPC (클러스터) | **못 쓴다.** TLS 없음 + loopback 강제 | +| WebSocket 플랫폼 | **못 쓴다.** composition이 없고, 있는 토글은 켜면 깨진다 | +| 참고 코드로서의 가치 | **매우 높다.** 12,000줄이 실무 실패 모드 카탈로그에 가깝다 | + +--- + +## 9. 미확인 / 가정 + +### 빌드를 돌리지 않아 확인하지 못한 것 + +Gradle wrapper jar가 스냅샷에 없고 브리프가 빌드 실행을 금지했다. 아래는 **미검증**이다. + +| 주장 | 확인 명령 | +|---|---| +| C1: Advanced 토글을 켜면 `NoSuchBeanDefinitionException`으로 컨텍스트가 실패한다 | `ApplicationContextRunner().withUserConfiguration(SockJsConfiguration.class).withPropertyValues("app.websocket-platform.advanced.sockjs.enabled=true").run(ctx -> assertThat(ctx).hasFailed())` — 현재 이런 테스트가 없다 | +| C2: `ca-skeleton.websocket.enabled=true` + `app.websocket-platform.advanced.stomp.enabled=true`에서 브로커 prefix가 빈 순서로 결정된다 | 두 `@Configuration`을 함께 올린 `@SpringBootTest`로 `SimpUserRegistry`/prefix 확인. 현재 그런 테스트가 없다 | +| H3: 큐가 찬 상태에서 응답이 조용히 사라진다 | `PlatformWebSocketHandler`를 8KB 버퍼로 띄우고 stall된 피어에 요청 반복 → 연결이 열린 채 응답만 사라지는지 | +| `verifyCleanArchitectureDependencies`가 실제로 websocket 추가를 막는다 | `./gradlew architectureCheck --console=plain` 후 app-bootstrap에 의존 한 줄 추가하고 재실행 | +| 커밋 안 된 변경으로 `:adapter:inbound:websocket:test`가 통과한다 | `cd src && ./gradlew :adapter:inbound:websocket:test --console=plain` | +| 자격시험 레인이 통과한다 | `cd src && ./gradlew conditionalTransportQualification --console=plain` | +| lockfile 238줄 변경이 프로덕션 런타임 의존을 바꾸지 않았다 | `./gradlew :adapter:inbound:websocket:dependencies --configuration runtimeClasspath` 를 변경 전/후로 비교 | + +### 세운 가정 + +1. ~~`app-bootstrap`이 component-scan 한다고 가정~~ → **확인 완료. 가정 아님.** + `CaSkeletonApplication.java:41-47`이 `dev.caskeleton.adapter` 트리 전체를 스캔한다. + 제외 필터는 `bootstrap.autoconfigure.*` 정규식뿐이라 websocket/grpc 패키지는 걸리지 않는다. + C1과 H6의 전제는 검증됐다. +2. **`@ConditionalOnMissingBean`이 붙은 `@Bean`이 필수 인자를 못 받으면 컨텍스트가 실패한다**고 + 가정했다(Spring의 일반 동작). `StompDefaultsConfiguration.stompAuthorizationPolicy`가 + `StompDestinationCatalog` 없이 어떻게 되는지는 실제로 돌려봐야 한다. +3. **`docs/websocket-superpowers-package/`를 읽지 않았다 — 이제 이 영역에서 유일하게 안 읽은 것이다.** 6개 항목(`docs/`, `research/`, + `MANIFEST.sha256`, `validate_websocket_docs.py`, `VALIDATION.md`, `README.md`)이 있고, + 여기에 배선 계획이나 채택 가이드가 있을 수 있다. 브리프가 이 영역 문서로 지정했지만 + 분량을 이유로 `docs/websocket/`만 읽었다. **C1/C2/H1 판정을 뒤집을 수 있는 내용이 + 여기 있을 가능성은 낮다(코드에 호출부가 없다는 사실은 문서로 바뀌지 않는다)** + — 다만 "왜 배선하지 않았는가"의 근거가 거기 있을 수 있다. +4. ~~websocket `test/` 60개 미열람~~ → **해소. 64개 전부 전문 열람했다.** + 결과는 §4-B. 배선을 검증하는 테스트는 없었고, 그 이유는 검증할 배선이 없기 때문이다. + 대신 부품 계약이 실제로 고정돼 있다는 것과, 조합층이 통째로 빠져 있다는 것을 확인했다. + +### 다른 영역 담당자가 알아야 할 교차 이슈 + +- **빌드 담당**: `verifyRuntimeModuleRegistry`(`VerifyRuntimeModuleRegistryTask.java:55-64`)는 + "등록되지 않은 프로젝트"만 잡는다. websocket/grpc는 등록돼 있으므로 전이 의존으로 들어와도 + 통과한다. 실질 게이트는 `verifyCleanArchitectureDependencies` 하나뿐이다. +- **application-core 담당**: `dev.caskeleton.application.realtime.*` 14개 타입은 + 현재 websocket leaf(미배선)와 `adapter/inbound/web/.../MessagingReplayBridge`가 쓴다. + 구현체는 cache-redis / messaging / persistence-jpa 3곳에 있다. + **즉 포트와 구현은 배포되는데, 그걸 쓰는 inbound 소비자 중 하나(websocket)가 배포되지 않는다.** + `EphemeralFanoutPort`/`ConnectionRegistryPort`의 실사용처가 web leaf뿐인지 확인 필요. +- **web 어댑터 담당**: `adapter/inbound/web/.../advanced/stream/replay/MessagingReplayBridge`가 + `LiveEventReplayPort`를 쓴다. websocket leaf의 `advanced/cluster/ReplayEventMapper`와 + 기능이 겹칠 수 있다. 두 leaf가 같은 replay 포트를 다르게 해석하는지 확인 필요. +- **gRPC 플랫폼(`src/grpc/*`) 담당**: `adapter/inbound/grpc`는 플랫폼에 **코드 의존이 0**이다. + 플랫폼 쪽에서 "어댑터가 우리를 쓴다"고 가정한 문서가 있다면 그건 틀렸다. + `optional-platforms/README.md:11-12`는 정확히 기술돼 있다. +- **문서/레지스트리 담당**: `docs/registries/env-keys.yaml`에 websocket/grpc 키가 0건이다. + 이건 현재 상태와 일치하므로 결함이 아니지만, 누가 leaf를 채택하면 즉시 `verifyEnvKeys`가 + 깨진다. 채택 절차 문서에 반영 필요. diff --git a/docs/reviews/2026-09-18-techlead-review/04-inbound-graphql.md b/docs/reviews/2026-09-18-techlead-review/04-inbound-graphql.md new file mode 100644 index 00000000..727ed98c --- /dev/null +++ b/docs/reviews/2026-09-18-techlead-review/04-inbound-graphql.md @@ -0,0 +1,1136 @@ +# [영역] inbound GraphQL (adapter:inbound:graphql) 리뷰 + +- 스냅샷: 2026-09-18T11:50Z / HEAD 60b6a319 + 커밋 안 된 변경 224파일 +- 담당 leaf: `adapter-inbound-graphql` (`:adapter:inbound:graphql`, `src/adapter/inbound/graphql`) + +--- + +## 0. 최종 적용 기준 + +GraphQL의 fail-closed authorization/transport neutrality/boundary scanning은 유지한다. 그러나 모든 서비스에 +기본 ship해야 한다는 원본 Keep은 폐기한다. GraphQL은 Build Composition에서 선택하고 선택된 뒤 runtime +switch로 활성화한다. OFF/ON 모두 실제 shipped composition으로 검증하고 지원 상태는 +`IMPLEMENTED / WIRED / QUALIFIED`를 구분한다. + +## 0-A. 2026-09-21 중간 재검증 + +**상태: leaf-owned AutoConfiguration은 정착했지만 Build Composition은 아직 완료가 아니다.** + +GraphQL leaf에는 `AutoConfiguration.imports`와 `GraphQlRootAutoConfiguration`이 존재한다. 이 부분은 +기존 “클래스만 있고 Boot가 발견하지 못하는” 문제를 해결하는 방향이다. + +그러나 `app-bootstrap/build.gradle`은 여전히 `implementation project(':adapter:inbound:graphql')`을 +기본 runtime module set에 포함하고 “한 ENV로 enable”하는 과거 모델을 주석으로 유지한다. + +따라서 **Runtime Activation은 개선됐지만 Build Composition은 미완료**다. GraphQL을 사용하지 않는 +파생 서비스가 artifact/classpath에서 이 capability를 제외할 수 있는 구조까지 가야 이 문서의 `0 +기준을 충족한다. + +## 1. 커버리지 + +| 소스셋 | 파일 | 줄 | 읽음 | +|---|---|---|---| +| `src/main/java` | 407 | 26,303 | **407 / 407 전문** | +| `src/test/java` | 99 | 12,985 | **99 / 99 전문** | +| `src/testFixtures/java` | 18 | 1,074 | **18 / 18 전문** | +| `src/systemTest/java` | 2 | 686 | **2 / 2 전문** | +| 리소스 | `.graphqls` 3, `spring.factories`, `AutoConfiguration.imports` | — | 전부 | +| 문서 | `README.md`, `CLAUDE.md`, `docs/graphql-superpowers-package/README.md` | — | 전부 | + +이 leaf의 소스는 **526개 파일 전부를 전문으로 읽었다.** 부분 열람분은 없다. + +`main` 파일 수를 408 → **407**로 정정한다. `docs/architecture/graphql-api-surface.txt`의 +`# types: 408`은 **public 타입 수**이고(파일 하나가 타입 2개를 담은 경우가 1건), +`.java` 파일 수는 407이다. 아래 도달 가능성 계산(140 + 267 = 407)은 파일 단위다. + +추가로 읽은 영역 밖 파일(내 판정에 필요해서): +`src/build-logic/.../graphql/{GraphQlPlatformPlugin,VerifyGraphQlProductionJarTask,ForbiddenJarMarker}.java`, +`src/build-logic/.../strictlane/StrictTestLanePlugin.java`, `src/build.gradle`, +`src/app-bootstrap/build.gradle`, `src/app-bootstrap/src/main/resources/config/graphql.yml`, +`src/app-bootstrap/src/systemTest/.../GraphQlShippedAndGatedTest.java`, +`src/app-bootstrap/src/test/.../AdapterActivationInventory.java`, +`src/config/architecture/modules.json`, `docs/registries/env-keys.yaml`, +`docs/registries/error-codes.yaml`, `docs/architecture/graphql-api-surface.txt`, +`src/adapter/inbound/websocket/.../advanced/graphql/GraphQlTransportBridge.java`. + +빌드는 돌리지 않았다(9절). + +--- + +## 2. 이 영역은 무엇을 하는가 + +**스켈레톤 부분은 40줄이다.** `skeleton.graphqls`가 `type Query { _health: String! }` 하나를 +선언하고 `HealthGraphqlController`가 `"UP"`을 돌려준다 +(`src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/HealthGraphqlController.java:22`). +Spring for GraphQL은 빈 스키마로 기동하지 않으므로 이게 최소 표면이다. + +**나머지 26,263줄은 "GraphQL 실행 플랫폼"이라는 별개의 물건이다.** 설계서 +(`docs/graphql-superpowers-package/docs/superpowers/specs/2026-08-12-...-design.md`)가 +Stable 16 + Advanced 12 = 28개 Gradle 모듈로 그린 것을, 이 leaf 안의 40개 sub-package로 +매핑했다. 실제로 하는 일은: + +``` +요청 → [Spring GraphQL /graphql 라우트] + → GraphQlPlatformWebInterceptor : 인증→컨텍스트 생성, 문서/변수 크기·형태 한계 + → [graphql-java parse/validate] ← BoundedPreparsedDocumentProvider 가 캐시 + → GraphQlPlatformInstrumentation.beginExecuteOperation ← 여기가 정책 관문 + ├ GraphQlOperationSelectionHandler : operation 1개 확정 + ├ GraphQlDocumentAuthorizationHandler : 루트 좌표 인가 + introspection 게이트 + └ GraphQlCostBudgetHandler : depth/alias/fields/복잡도 + 데드라인 + → [resolver 실행] ← GraphQlBatchLoaderRegistrar 가 DataLoader 배선 + → GraphQlDataFetcherExceptionResolver : 필드 실패를 와이어 에러로 +``` + +`beginExecuteOperation`을 고른 것이 핵심이다. 문서는 파싱·검증됐고 operation은 하나로 +확정됐는데 **data fetcher는 아직 하나도 안 돌았다.** 그래서 "거부된 요청은 resolver를 +0번 부른다"가 희망이 아니라 사실이 된다 +(`runtime/GraphQlPlatformInstrumentation.java:52-101`, 증명은 +`systemTest/.../GraphQlPlatformExecutionPathTest.java:273-278`의 `RESOLVER_INVOCATIONS` 카운터). + +### 26,303줄의 출처 — 패키지별 + +| 패키지 | 파일 | 줄 | 빈 그래프에서 도달 | +|---|---|---|---| +| execution | 22 | 1,220 | 14/22 | +| cost | 21 | 1,595 | 12/21 | +| schema | 19 | 1,159 | 8/19 | +| http | 19 | 1,297 | 7/19 | +| runtime | 19+1 | 1,731 | **20/20** | +| pagination | 17 | 1,018 | **0/17** | +| dataloader | 17 | 895 | **17/17** | +| security | 15 | 889 | 11/15 | +| mutation | 14 | 683 | **0/14** | +| autoconfigure | 13 | 1,742 | 11/13 | +| compat | 11 | 1,562 | **0/11** | +| fetch | 10 | 434 | **0/10** | +| error | 10 | 599 | 6/10 | +| release | 9 | 540 | **0/9** | +| policy | 9 | 451 | 2/9 | +| observation | 9 | 642 | 8/9 | +| architecture | 9 | 969 | **9/9** | +| scalar | 7 | 884 | **7/7** | +| context | 6 | 483 | 4/6 | +| api | 5 | 205 | 4/5 | +| moduleboundary | 4 | 537 | 0/4 (의도됨 — 빌드시 경계 테스트용 데이터) | +| **advanced/** (17개 하위) | 143 | 6,401 | **0/143** | + +**스키마 우선이다.** `.graphqls`는 3개뿐이고 그중 2개는 systemTest 픽스처다. 제너레이티드 +코드는 **없다**(`advanced/codegen`은 "코드 생성 계획을 검증하는 정책 객체"이지 생성기가 아니다). +26,303줄은 전부 손으로 쓴 정책·계약·값 객체다. + +### 도달 가능성 측정 — 이 영역의 핵심 숫자 + +`GraphQlRootAutoConfiguration` / `GraphQlOffAutoConfigurationImportFilter` / +`GraphQlActivationEnvironmentPostProcessor` / `HealthGraphqlController` 네 개(= Spring이 +실제로 진입하는 전부, `META-INF/spring.factories`와 `AutoConfiguration.imports`가 등록하는 +것 전부)에서 **javadoc을 제거한 뒤** 클래스 참조를 전이 폐포로 따라간 결과: + +``` +main 파일 407개 중 + 빈 그래프에서 도달 가능 140개 / 11,283줄 (43%) + 도달 불가 267개 / 14,975줄 (57%) +``` + +**패키지 23개가 통째로 도달 불가**: `pagination`, `mutation`, `fetch`, `compat`, `release`, +`moduleboundary`, `advanced/*` 17개 전부. + +이건 "죽은 코드"라는 뜻이 **아니다**. 세 부류가 섞여 있다. + +1. **의도된 빌드타임 데이터** — `moduleboundary/*`(537줄). `GraphQlModuleBoundaryTest`가 + 읽는 선언이고, 런타임에 도달하면 안 되는 게 맞다. 문제 없음. +2. **adopter가 직접 호출하라고 내놓은 building block** — `pagination/`(HMAC 커서 코덱), + `mutation/`(멱등성 스코프), `fetch/`(fetch profile). 템플릿이 도구를 제공하는 정상 형태다. +3. **아무도 부르지 않는 정책 객체** — `compat/`(1,562줄, 스키마 호환성 비교기), + `release/`(540줄, 릴리스 게이트), `advanced/*`(6,401줄). 이들은 adopter가 호출할 + 자리도 없다. `GraphQlAdvancedCapability.featureFlag()`가 `backend.graphql.advanced.*` + 프로퍼티 이름을 만들지만(`advanced/bootstrap/GraphQlAdvancedCapability.java:96-98`) + **그 프로퍼티를 바인딩하는 `@ConfigurationProperties`가 없다.** `GraphQlPlatformSettings`에 + `advanced` 컴포넌트가 없다(`autoconfigure/GraphQlPlatformSettings.java:38-48`). + 즉 "Advanced는 기본 전부 off"는 **플래그가 off라서가 아니라 플래그를 읽는 코드가 + 없어서** 참이다. + +### 도달 불가 267개를 테스트는 어떻게 다루는가 — 이 판정의 갈림길 + +도달 불가 코드에 **테스트가 없으면** "검증된 적 없는 14,975줄"이고, **테스트가 있으면** +"배선만 남은 자산"이다. 채택 비용이 자릿수로 갈린다. 그래서 테스트 99개 + fixture 18개를 +전문으로 읽고 도달 불가 267개와 대조했다. + +**(1) 테스트는 존재한다. 거의 전부에 붙어 있다.** + +``` +도달 불가 267개 중 + 테스트가 import 하거나 같은 패키지에서 직접 쓰는 것 250개 (93.6%) + 어떤 테스트도 건드리지 않는 것 17개 / 868줄 +``` + +즉 **초록색 테스트 상당수가 배포되지 않는 코드를 지키고 있다.** 도달 불가 267개 중 +206개(11,175줄)는 23개 "통째로 도달 불가" 패키지에 있고, 여기에만 테스트 **34개 파일 / +5,076줄 / `@Test` 300개**가 붙어 있다. 전체 테스트 99개 중 34개(34%), `@Test` 739개 중 +300개(41%)가 **런타임에 존재하지 않는 코드를 검증한다.** + +| 도달 불가 패키지 | main 클래스/줄 | 테스트 파일 | 테스트 줄 | `@Test` | +|---|---|---|---|---| +| `pagination` | 17 / 1,018 | 3 | 459 | 24 | +| `mutation` | 14 / 683 | 2 | 425 | 29 | +| `fetch` | 10 / 434 | 2 | 224 | 15 | +| `compat` | 11 / 1,562 | 2 | 515 | 40 | +| `release` | 9 / 540 | 1 | 165 | 9 | +| `moduleboundary` | 4 / 537 | 3 | 513 | 13 | +| `advanced/*` (17개 패키지) | 141 / 6,401 | 21 | 2,775 | 170 | +| **합계** | **206 / 11,175** | **34** | **5,076** | **300** | + +나머지 61개(3,800줄)는 `cost`/`http`/`schema`/`execution`/`security`/`error`/`policy` 같은 +**혼합 패키지** 안의 도달 불가분이고, 같은 패키지 테스트가 함께 커버한다 +(예: `cost/GraphQlParserLimitPolicyTest`, `cost/GraphQlRuntimeBudgetTrackerTest`는 +도달 불가 클래스만 검사한다). + +**(2) 그 테스트는 압도적으로 부품 단위다. 조합 단위는 0개다.** + +이 leaf에서 Spring 컨텍스트나 graphql-java 엔진을 실제로 띄우는 테스트는 **9개뿐이고, +9개 전부 도달 *가능* 쪽에 있다.** + +``` +ApplicationContextRunner → autoconfigure/ 6개 (전부 도달 가능) +GraphQL.newGraphQL → runtime/GraphQlBatchLoaderRegistrationTest +AnnotationConfigApplicationContext + GraphQlTester → HealthGraphqlControllerTest +@SpringBootTest + TestRestTemplate → systemTest 2개 (전부 도달 가능 경로) +``` + +도달 불가 34개 테스트 파일 중 **컨텍스트를 띄우거나 스키마를 실행하는 것은 하나도 없다.** +전부 `new`로 값 객체를 만들고 메서드를 직접 부른다. + +조합처럼 **보이는** 유일한 예외는 `testkit/GraphQlCrossModuleContractSuiteTest`(174줄, +`@Test` 9개)이고, 이걸 구동하는 `testFixtures/testkit/GraphQlContractFixture`는 자기가 +조합이 아니라고 **본문에 적어놨다**: + +> *"What it deliberately is not is a transport. … This fixture executes nothing and owns no +> threads: it composes the pure policies, so it can never become the second execution path +> that the custom MVC and WebFlux adapters had turned into."* +> — `testFixtures/.../testkit/GraphQlContractFixture.java:29-37` + +의도적인 설계다(두 번째 실행 경로를 만들지 않겠다는 것). 다만 **결과적으로 도달 불가 +코드의 배선을 덮는 테스트는 저장소에 0줄**이라는 사실은 그대로 남는다. + +**(3) 그런데 그 부품 테스트의 품질은 진짜다.** 형식만 갖춘 껍데기가 아니다. 근거: + +- `pagination/HmacGraphQlCursorCodecTest`(251줄, `@Test`/`@ParameterizedTest` 14개) — + `|;=\:`·한글·이모지 라운드트립 파라미터화, 키 로테이션, 남의 키 거부, 방향/테넌트/ + 쿼리/필터 스코프 불일치 거부, 변조·절단·초과 길이. 그리고 `everyStringFieldRoundTrips`는 + **v1 구분자 이스케이프가 깨졌던 실제 사고를 고정한 회귀 테스트**다. +- `mutation/GraphQlMutationIdempotencyContextTest`(318줄, 21개) — + `twoDifferentInputsNeverShareAFingerprint`가 옛 `key=value;` 직렬화 충돌을 고정하고, + 키 로테이션·프레이밍 위조까지 본다. +- `compat/GraphQlSchemaComparatorTest`(343줄, 28개) — 스키마 호환성 판정의 각 규칙마다 + positive/negative 한 쌍. +- `cost/GraphQlRuntimeBudgetTrackerTest` — `anEstimateThatPassedDoesNotExemptTheRuntimeBudget` + 처럼 **정적 추정과 런타임 예산이 별개라는 계약**을 명시적으로 못박는다. + +즉 부품은 "돌기만 하는" 상태가 아니라 **회귀가 고정된 완성 부품**이다. + +**(4) 부품 테스트조차 없는 17개 — 하필 배선 모양 클래스들이다.** + +``` +advanced/websocket/GraphQlWebSocketHandlerFactory.java 102줄 +advanced/sse/GraphQlSseHandlerFactory.java 95줄 +advanced/rsocket/GraphQlRSocketHandlerFactory.java 84줄 +mutation/GraphQlCanonicalInput.java 87줄 +cost/GraphQlResponseByteLimiter.java 60줄 +autoconfigure/GraphQlPlatformConfigurationReport.java 55줄 +pagination/GraphQlCursorKeyset.java 54줄 +cost/GraphQlResponseNodeCounter.java 44줄 +pagination/GraphQlConnection.java 43줄 +http/GraphQlExecutionOutcome.java 42줄 +execution/GraphQlResolverBudget.java 32줄 +advanced/subscription/GraphQlSubscriptionContext.java 35줄 +fetch/GraphQlSelectionCoordinate.java 30줄 +mutation/GraphQlBatchMutationItemResult.java 28줄 +pagination/GraphQlCursorCodec.java 27줄 (인터페이스) +advanced/subscription/GraphQlSubscriptionSource.java 26줄 +http/GraphQlHttpExecutor.java 24줄 (인터페이스) + 합 868줄 +``` + +대부분은 값 객체·인터페이스라 테스트가 없어도 이상하지 않다. **문제는 위 셋이다** — +`*HandlerFactory` 3개(281줄)는 이 leaf에서 유일하게 **transport를 실제로 붙이는 모양의 +클래스**이고, 정확히 그 셋만 테스트가 0개다. 부품은 전부 검증됐는데 **부품을 꽂는 자리에 +해당하는 코드만 검증이 없다**는 형태이고, 이건 (2)의 "조합 커버리지 0"과 같은 구멍이 +클래스 수준에서 다시 나타난 것이다. + +### 자산인가 부채인가 — 판정 (테스트 전수 독파 후 갱신) + +**갱신 전 판정은 "지금 상태로 fork하면 부채"였다. 그 판정의 근거를 아래로 바꾼다.** +테스트를 다 읽기 전에는 도달 불가 14,975줄이 "검증된 적 없는 코드"일 가능성이 열려 있었다. +아니었다. **267개 중 250개가 부품 테스트로 검증돼 있고, 그 테스트는 회귀가 고정된 +진짜 테스트다.** 그래서 성격이 다음으로 바뀐다. + +> **도달 불가 57%는 "미검증 코드"가 아니라 "검증된 부품 + 조합 0"이다.** +> 부품은 사서 쓸 수 있는 상태이고, 없는 것은 그 부품을 요청 경로에 꽂는 코드와 +> 그 배선을 지키는 테스트다. + +채택 비용이 이렇게 갈린다: + +| | 미검증 코드였다면 | 실제(검증된 부품 + 조합 0) | +|---|---|---| +| `pagination` 커서를 켜려면 | 1,018줄을 읽고 재작성·재검증 | `@ConfigurationProperties` + resolver 배선 + 조합 테스트 | +| `advanced/persisted` | 832줄 전부 신뢰 불가 | 21개 `@Test`가 정책을 이미 고정, interceptor 등록만 남음 | +| 예상 비용 | **재작성 규모** | **배선 규모** (단, `*HandlerFactory` 3개 281줄은 예외 — 재작성 규모) | + +**그래도 부채는 남는다. 다만 부채의 항목이 바뀐다.** 남는 부채는 "14,975줄이 검증되지 +않았다"가 아니라 아래 셋이다. + +1. **초록불이 실제 위험을 덮는다.** `@Test` 739개 중 300개(41%)가 배포되지 않는 코드를 + 지킨다. CI 초록색의 41%는 런타임 안전과 무관하다. 고장 신호도 아니고 진행 신호도 + 아닌 테스트가 다수이므로, 신규 adopter가 "테스트 739개 통과"를 품질 근거로 읽으면 + 과대평가한다. +2. **조합 커버리지가 정확히 0이다.** 도달 불가 34개 테스트 파일 중 컨텍스트를 띄우는 + 것이 하나도 없다. 부품을 꽂는 순간 나오는 버그(빈 등록 순서, `@ConfigurationProperties` + 바인딩, interceptor 순서, DataLoader 스코프)는 지금 저장소의 어떤 테스트도 못 잡는다. +3. **public 표면 문제는 그대로다** (아래 원문 유지). + +자산 쪽: +- 43%(11,283줄)는 실제로 배선돼 있고, 그 배선은 random-port 테스트가 증명한다. +- 코드 품질이 균일하게 높다. 주석이 "무엇을 하는가"가 아니라 **"왜 이렇게 하지 않으면 + 무엇이 깨졌는가"**를 쓴다. 예: `execution/BoundedPreparsedDocumentProvider.java:25-30` + ("메서드 전체가 synchronized였고, 그래서 캐시의 miss 경로가 캐시가 제거하려던 경합 + 지점이 됐다"), `http/GraphQlJsonValues.java:12-16`(`Map.copyOf`가 null 변수에서 던지는 + 문제), `pagination/GraphQlCursorFraming.java:9-13`(v1 구분자 이스케이프가 라운드트립 + 실패한 사유). 이건 리뷰에서 읽은 코드 중 상위 몇 %에 드는 수준이다. + +부채 쪽: +- **57%가 런타임에 존재하지 않는데 100%가 public이다.** + `docs/architecture/graphql-api-surface.txt`는 `# types: 408`이라고 적혀 있고 실제로 + `dev.` 시작 줄이 408개다. main 파일 407개 = public 타입 408개(파일 1개가 타입 2개). + 이 leaf는 단일 jar이므로 **adopter의 코드에서 408개 전부가 보인다.** + `build.gradle:117-127`의 `apiSurface` 코멘트가 이 문제를 정확히 자백하고 있다: + "단일 jar 안에서 public은 모두에게 public이다." +- fork한 사람이 "이 26,000줄 중 내가 켠 게 뭔지"를 알려면, 이 리뷰가 한 것처럼 + 전이 폐포를 직접 계산해야 한다. `CLAUDE.md`의 등급표(`modelled`/`wired`)가 이 일을 + 하려는 시도이고 **대체로 정확하지만**, 표는 capability 단위이지 줄 수 단위가 아니다. +- 유지보수 관점에서는 이 57%가 **컴파일·Spotless·Checkstyle·Error Prone·SpotBugs를 + 전부 통과해야 하는 부담**으로 남는다. Boot/graphql-java 업그레이드 때 컴파일이 깨지는 + 표면이 실제 기능의 2.3배다. + +**최종 판정: fork 시점의 부채는 "26,303줄"이 아니라 "조합 0 + public 표면 407"이다.** +도달 불가 14,975줄은 배선하면 쓸 수 있는 자산이고(부품 테스트가 그 근거다), 채택 비용은 +재작성이 아니라 배선 + 조합 테스트 작성이다. 예외는 `*HandlerFactory` 3개(281줄)로, +여기만 부품 테스트조차 없어 실제 재작성 후보다. +**다음 조치로 자산으로 돌릴 수 있다** — (a) 도달 +불가 패키지를 별도 아티팩트로 분리하거나 `api`/`spi` 외를 package-private으로 내리고, +(b) `apiSurface` 스냅샷을 "줄이기 위한 기준선"으로 실제로 쓰고, +(c) `CLAUDE.md` 등급표에 줄 수/도달 가능성을 함께 적고, +(d) **capability를 하나만 골라 조합 테스트를 1개 쓴다** — `ApplicationContextRunner`로 +`backend.graphql.cursor.*`를 바인딩하고 커서 서명이 요청 경로에 실제로 걸리는지 보는 것. +지금 `GraphQlPolicyRequestPathTest`가 "안 걸려 있다"를 고정하고 있으므로(네거티브), +그 테스트를 뒤집는 순간이 곧 배선 완료 시점이 되도록 설계돼 있다. (a)는 이미 +`GraphQlStableModule`/`GraphQlAdvancedModule` 레코드가 leaf 명세로 승격 가능하게 설계돼 +있어(`moduleboundary/GraphQlStableModule.java:20-22`) 비용이 낮다. + +--- + +## 3. 런타임 토글 판정 — 꺼지면 정말 꺼지는가 + +### 끄는 키 + +```yaml +# src/app-bootstrap/src/main/resources/config/graphql.yml:5-12 +backend: + graphql: + enabled: ${APP_GRAPHQL_ENABLED:false} # 기본 false + deployment-mode: ${APP_GRAPHQL_DEPLOYMENT_MODE:} # enabled=true 일 때 필수 +``` + +`docs/registries/env-keys.yaml:4333, 4346`에 두 키가 등록돼 있다. **GraphQL 관련 env 키는 +이 둘뿐이다**(레지스트리 전체 grep `APP_GRAPHQL` → 3 hit, 그중 하나는 `required_when` 참조). + +### 껐을 때 남는 것 — 계층별 + +| 계층 | 껐을 때 | 근거 | +|---|---|---| +| 프로젝트 빈 | **0개** | `GraphQlRootAutoConfiguration`에 `@ConditionalOnProperty(prefix="backend.graphql", name="enabled", havingValue="true")` (`autoconfigure/GraphQlRootAutoConfiguration.java:21`). main 전체 grep 결과 `@Component/@Service/@Configuration/@Bean` 은 `autoconfigure/` 안에만 있고 `@Controller`는 `HealthGraphqlController` 하나인데 이건 루트가 `@Import` 로만 들여온다(같은 파일 :31). 컴포넌트 스캔 경로에 없다. | +| 프레임워크 빈 + 라우트 | **0개** | `GraphQlOffAutoConfigurationImportFilter`가 `AutoConfigurationImportFilter`로 Spring GraphQL 자체 auto-config를 후보에서 제거 (`autoconfigure/GraphQlOffAutoConfigurationImportFilter.java:42-54`). **단, 여기에 결함이 있다 → H1** | +| 스키마 파싱 / `GraphQlSource` | **없음** | `GraphQlSource`를 만드는 것은 Boot의 `GraphQlAutoConfiguration`이고 그게 필터에 걸린다 | +| DataLoader 레지스트리 | **없음** | `graphQlBatchPolicyRegistry`/`graphQlDataLoaderFactory`/`graphQlBatchLoaderRegistrar` 전부 `GraphQlPlatformAutoConfiguration`의 `@Bean` (`:632, :648, :679`) → 루트 조건에 종속 | +| 인스트루멘테이션 | **없음** | `graphQlPlatformInstrumentation` 동일 (`:417`) | +| 스레드 | **0개** | 이 leaf가 만드는 유일한 스레드는 `GraphQlBlockingBridge`인데(`runtime/GraphQlBlockingBridge.java:49-58`) 어떤 `@Bean`도 이걸 만들지 않는다. adopter가 명시적으로 만들 때만 존재한다 | +| 커넥션/소켓 | **0개** | 이 leaf는 아웃바운드 연결을 열지 않는다 | +| 필수 env | **0개** | `enabled=false`면 `GraphQlRetiredSafetyAxis.problems()`가 즉시 빈 리스트 반환(`autoconfigure/GraphQlRetiredSafetyAxis.java:45-47`), `GraphQlActivationEnvironmentPostProcessor`도 즉시 return(`:56-58`) | +| 부팅 비용 | 클래스 2개 로드 + 프로퍼티 2회 읽기 + 후보 목록 1회 순회 | 무시 가능 | +| **클래스패스** | **남는다** | `app-bootstrap/build.gradle:120`이 `implementation project(':adapter:inbound:graphql')`. jar 안의 408 타입 + `spring-boot-starter-graphql` + `graphql-java 25.0` + `java-dataloader 6.0.0`이 runtimeClasspath에 있다 | + +### 껐다는 증거가 실제로 있는가 + +**있다. 그리고 이 저장소에서 가장 강한 형태다.** +`src/app-bootstrap/src/systemTest/java/dev/caskeleton/bootstrap/activation/GraphQlShippedAndGatedTest.java`가 +**실제 shipped composition을 전체 off 인자로 기동한 뒤 진짜 포트에** 두 가지를 확인한다: + +- `/graphql` POST의 상태 코드가 **한 번도 정의된 적 없는 경로**(`/no-such-route-exists`)와 + 동일한지 (`:71-85`). 리터럴 404를 assert 하지 않은 이유를 주석이 설명한다 — 시큐리티 + 필터 체인이 매핑 여부와 무관하게 401을 주므로, 리터럴 assert는 "인증만 요구하는 published + endpoint"에서도 통과했을 것이다. +- GraphQL이 소유한 빈이 0개인지 (`:87-93`). 소유 판정은 프로젝트 패키지뿐 아니라 + **vendor 패키지**(`graphql`, `org.springframework.graphql`, `org.springframework.boot.graphql`)까지 + 포함한다 (`AdapterActivationInventory.java:141-145`). + +즉 "빈 인벤토리로는 볼 수 없는 실패(프레임워크가 스스로 라우트를 publish)"를 정확히 +겨냥한 테스트다. **이 leaf의 토글 설계는 이 저장소에서 내가 본 것 중 가장 잘 만들어져 있다.** + +### `VerifyGraphQlProductionJarTask` / `ForbiddenJarMarker` — 브리프의 가설은 틀렸다 + +브리프는 이 이름을 "production jar에 GraphQL이 들어가면 안 된다는 규칙"으로 읽었다. +**읽어보니 아니다.** 이 태스크는 **GraphQL leaf 자신의 jar 안에 테스트 픽스처가 섞였는지**만 +본다: + +```java +// build-logic/.../graphql/VerifyGraphQlProductionJarTask.java:17-23 +new ForbiddenJarMarker("/testkit/", "contract suites and integration fixtures belong to test fixtures"), +new ForbiddenJarMarker("InMemory", "an in-memory implementation is a development stand-in, ..."), +new ForbiddenJarMarker("ForTests", "a for-tests factory in the production jar is reachable ..."), +new ForbiddenJarMarker("TestContext", "a credential-free authenticated context must not ship"), +new ForbiddenJarMarker("Fixture", "fixtures belong to test fixtures"), +``` + +`jar` 태스크 산출물의 `.class` 엔트리 이름에 위 5개 마커가 있으면 실패 +(`VerifyGraphQlProductionJarTask.java:36-44`), `check`에 붙어 있다 +(`GraphQlPlatformPlugin.java:117-120`). + +**이건 위생 게이트이지 토글 강제 장치가 아니다.** 노리는 사고는 구체적이고 실재한다 — +`GraphQlRequestContexts.testContext(String)`가 자격증명 없이 인증된 actor를 만들어내고 +(`testFixtures/.../testkit/GraphQlRequestContexts.java`), `InMemoryGraphQlPersistedOperationRegistry`는 +두 번째 인스턴스가 뜰 때까지 완벽하게 동작하는 빈이다. 그게 production jar에 있으면 +adopter가 진짜로 쓴다. 그래서 `testFixtures`로 옮기고, "옮겼다"를 믿지 않고 jar 내용으로 +확인한다. **의도와 구현이 일치하고, 잘 작동한다. Keep이다(K3).** + +다만 마커 매칭이 **경로가 아니라 이름 문자열 포함**이므로 (a) `/testkit/`만 패키지 기반이고 +나머지 4개는 클래스명 휴리스틱, (b) `Fixture`/`InMemory`를 피해 이름 지은 픽스처는 통과한다. +현재 `testFixtures` 18개는 전부 걸리므로 실효는 있다. Low로도 올리지 않는다. + +### 토글 판정 요약 + +**꺼지면 진짜 꺼진다.** 빈 0, 스레드 0, 라우트 0, 필수 env 0. +남는 것은 클래스패스뿐이고, 그건 `app-bootstrap/build.gradle:117-119`가 명시적으로 선택한 +트레이드오프다 — *"an adapter an operator cannot enable with one environment variable is not +off, absent"*(`GraphQlShippedAndGatedTest.java:55`). 나는 이 선택에 동의한다(K1). + +**단 하나의 구멍이 H1이다.** + +--- + +## 4. 구조 판정 + +| 축 | 판정 | 근거 | +|---|---|---| +| 의존 방향 (modules.json 대조) | **OK** | `modules.json`의 `adapter-inbound-graphql.allowed_dependencies = [domain-core, application-core, shared-contract]`. `build.gradle:36,42`는 `:shared-contract`, `:application-core` 둘만 선언(부분집합). outbound 어댑터·다른 inbound 어댑터 의존 0 | +| 경계 누수 — inbound DTO → application-core (HARD-STOP #3) | **OK** | `grep -rn 'adapter.inbound.graphql' application-core/src domain-core/src shared-contract/src` → 0 hit. ACL은 `context/GraphQlCommandAttribution.java:25-26`(4개 plain value) 이고, 답하는 계약은 application-core가 소유(`application-core/.../security/ObjectAccessPolicy.java:21`) | +| 경계 누수 — controller → repository/entity (HARD-STOP #2) | **OK + 런타임 강제** | 이 leaf의 유일한 controller는 `HealthGraphqlController`(의존 0). 그리고 **adopter의 controller까지** 기동 시 검사한다 — `graphQlControllerBoundaryCheck`가 컨텍스트의 모든 `@Controller`를 읽어 `GraphQlResolverBoundaryRules.assertNoPersistenceAccess` / `GraphQlTransportTypeRules.assertTransportTypesOnly` / `assertRawDataFetcherIsInfrastructureOnly`를 건다 (`autoconfigure/GraphQlPlatformAutoConfiguration.java:150-161`). CGLIB 프록시를 `ClassUtils.getUserClass`로 벗기고(`:176`), **erased 타입이 아니라 제네릭 타입 그래프**를 걷는다(`architecture/GraphQlTypeGraph.java:42-85`) — `Optional`도 잡힌다 | +| 프레임워크 타입 누수 (transport neutrality) | **OK** | production 파일 중 `org.springframework.web`·`jakarta.servlet`·`org.springframework.http` import 0개. `jakarta.servlet-api`는 `compileOnly`(`build.gradle:71`). lockfile 확인: `spring-boot-starter-web`·`spring-webmvc`·`tomcat-embed-core` 전부 `systemTest*,test*` 스코프만 | +| 비즈니스 규칙 위치 (HARD-STOP #4) | **OK** | 이 leaf에 도메인 규칙이 없다. 전부 전송 정책(크기·깊이·비용·카디널리티·마스킹). object 인가는 `application-core`로 넘긴다 | +| 모듈 내부 경계 (sub-package) | **OK, 기계 강제** | `moduleboundary/GraphQlModuleBoundaryTest`가 **컴파일된 클래스가 아니라 소스 텍스트**를 스캔해 (a) Stable→Advanced import 금지, (b) CORE 모듈의 프레임워크 import 금지, (c) 미선언 edge 금지, (d) 미등록 패키지 금지, (e) 선언만 있고 소스 없는 모듈 금지를 건다. **규칙마다 거부돼야 하는 합성 트리(negative fixture)가 붙어 있다**(`:101-125`). 0개 스캔은 통과가 아니라 실패(`GraphQlBuildModel.java:238-243`) | +| 테스트 전략 적합성 | **OK, 예외적으로 좋음** | 아래 | + +### 테스트 전략 + +이 leaf의 테스트는 "정책 객체가 맞는가"와 **"요청이 그 정책을 만나기는 하는가"**를 +분리해서 둘 다 확인한다. 후자가 대부분의 프로젝트가 빠뜨리는 것이고, 여기는 안 빠뜨렸다. + +- `systemTest/.../GraphQlPlatformExecutionPathTest`: random-port 서블릿, 실제 `/graphql` POST, + 거부 케이스마다 **resolver 호출 0회**를 측정(`:273-278`). depth/alias/introspection/ + fragment 뒤에 숨긴 introspection/복잡도/인가/문서크기/변수 형태/raw body cap/parse 캐시 hit. +- `runtime/GraphQlBatchLoaderRegistrationTest`: Spring의 `BatchLoaderRegistry`에 실제 등록하고 + graphql-java로 실행. **50 parent → downstream 3회**(`:77-79`), 반복 키 dedup, 요청 간 + 캐시 비공유, 테넌트별 스코프 분리, 예산 초과 시 다음 chunk 차단, "안 물어본 키를 답한 + loader" 거부. +- `runtime/GraphQlRequestObservationConventionAdapterTest`: 진짜 `SimpleMeterRegistry`에 + **임의 operation 이름 10,000개 → 시계열 1개**(`:52-63`). +- `autoconfigure/GraphQlPolicyRequestPathTest`: **배선되지 **않은** 것을 못박는 네거티브 + 테스트.** 커서 서명·mutation 멱등성이 요청 경로에 없다는 사실을 assert 한다. 한쪽만 + 배선하면 이 테스트가 깨진다. +- `architecture/` 10개: compliant/violating **양쪽** fixture. 위반 fixture는 리포지토리 주입 + + `Map` 반환 + `@Transactional`을 한 클래스에 모아놨다(`fixture/violating/LeakyGraphQlController.java`). + +**단, 이 "둘 다 확인한다"는 도달 가능 43%에 한해서다.** 테스트 99개를 전수로 읽고 분류한 +결과, 컨텍스트/엔진을 띄우는 테스트 9개는 전부 도달 가능 쪽에 있고, 도달 불가 패키지에 +붙은 34개 파일 / `@Test` 300개는 **전부 부품 단위**다(2절 "도달 불가 267개를 테스트는 +어떻게 다루는가"). 즉 전략은 옳은데 **적용 범위가 켜져 있는 절반에서 끝난다.** + +--- + +## 5. 발견 + +### Critical + +**없다.** + +이건 빈칸을 채우지 못해서가 아니라 판정이다. 확인한 것: HARD-STOP 8개 중 이 영역에 +해당하는 #1~#5 전부 위반 없음(4절). 토글은 실제로 끈다(3절). prod 기동 실패는 존재하지만 +전부 **fail-closed이고 의도된 것**이다(아래 H2). "꺼도 안 꺼지는 토글"은 없다. + +--- + +### High + +#### H1. off 계약을 지키는 클래스 이름 목록이 Spring Boot 4.0.8의 실제 목록과 4곳 어긋나 있고, 그 목록에 붙은 테스트는 저장소 전체에 0개다 + +- **현상**: + `GraphQlOffAutoConfigurationImportFilter`는 Spring GraphQL 자체 auto-configuration을 + **문자열 리터럴 10개**로 열거해 후보에서 제거한다 + (`.../autoconfigure/GraphQlOffAutoConfigurationImportFilter.java:26-37`). + Boot 4.0.8이 실제로 등록하는 것은 **12개**다. 대조 결과: + + | 필터의 항목 | Boot 4.0.8 실제 | 상태 | + |---|---|---| + | `...reactive.GraphQlWebFluxSecurityAutoConfiguration` | `...security.GraphQlWebFluxSecurityAutoConfiguration` | **패키지 틀림 → 아무것도 매칭 안 함** | + | `...servlet.GraphQlWebMvcSecurityAutoConfiguration` | `...security.GraphQlWebMvcSecurityAutoConfiguration` | **패키지 틀림 → 아무것도 매칭 안 함** | + | (없음) | `...data.GraphQlQueryByExampleAutoConfiguration` | **누락** | + | (없음) | `...data.GraphQlReactiveQueryByExampleAutoConfiguration` | **누락** | + | 나머지 8개 | 일치 | OK | + +- **근거**: + - 필터: `src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/autoconfigure/GraphQlOffAutoConfigurationImportFilter.java:34, 37` + - Boot 실제 목록(로컬 Gradle 캐시의 4.0.8 jar에서 직접 확인): + ``` + unzip -p ~/.gradle/caches/modules-2/files-2.1/org.springframework.boot/\ + spring-boot-graphql/4.0.8/e8a50609.../spring-boot-graphql-4.0.8.jar \ + META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports + ``` + - 필터의 이름 10개를 검증하는 테스트: **저장소 전체에 0개** (아래 항목에서 확정). + +- **이 필터에 붙은 테스트가 정확히 무엇인가 (테스트 99개 + fixture 18개 전수 독파 후 확정)**: + + **없다. 0개다.** "목록을 하드코딩해 자기 자신과 비교하는 테스트"조차 아니고, 그보다 + 약한 **테스트 부재**다. + + ``` + $ grep -rn "GraphQlOffAutoConfigurationImportFilter" src build-logic + src/adapter/inbound/graphql/src/main/resources/META-INF/spring.factories:2 + src/adapter/inbound/graphql/src/main/java/.../GraphQlOffAutoConfigurationImportFilter.java:21 + ``` + + 저장소 전체에서 이 클래스의 참조는 **자기 선언 1줄과 `spring.factories` 등록 1줄뿐**이다. + `test`·`testFixtures`·`systemTest` 어디에도 없다. `autoconfigure/` 테스트 7개 + (`GraphQlPlatformAutoConfigurationTest`, `GraphQlDeploymentModeContractTest`, + `GraphQlTransportNeutralityTest`, `GraphQlPolicyRequestPathTest`, + `GraphQlPlatformStartupValidatorTest`, `GraphQlBatchLoaderWiringTest`, + `GraphQlObservationWiringTest`)를 전문으로 읽었고 **어느 것도 이 필터를 건드리지 않는다.** + `ApplicationContextRunner`는 `AutoConfigurationImportFilter`를 거치지 않으므로 + 이 6개 컨텍스트 테스트는 구조적으로도 이 필터를 실행하지 않는다. + + 대신 서 있는 것은 `app-bootstrap`의 **행동 관찰 1개**뿐이다 — + `src/app-bootstrap/src/systemTest/.../GraphQlShippedAndGatedTest.java`가 전부 off로 + 실제 부팅해 `/graphql` 응답이 "정의되지 않은 라우트"와 같은지 본다. 필터의 **문자열 + 목록**을 보는 것이 아니라 **결과 포트**를 본다. 그래서 목록이 4곳 틀려도 초록색이다 + (틀린 4개가 `@ConditionalOnBean`이라 오늘은 어차피 안 켜지므로). + + 즉 이건 코디네이터가 의심한 "테스트가 죽은 계약을 고정한다"의 변종이 아니라, + **계약 자체에 테스트가 없고 우연한 행동만 관찰된다**는 더 약한 상태다. 고치는 비용도 + 더 낮다(기존 잘못된 테스트를 걷어낼 필요가 없다). + + **저장소 차원의 패턴이라는 점은 덧붙인다.** 같은 모양의 형제 필터 3개도 테스트가 0개다: + `bootstrap/autoconfigure/jpa/JpaOffAutoConfigurationImportFilter`, + `adapter/outbound/messaging/.../MessagingOffAutoConfigurationImportFilter`, + `adapter/outbound/mongo/MongoOptInAutoConfigurationImportFilter`. + off 계약을 문자열 목록으로 구현하는 방식이 이 저장소에 4곳 있고, **4곳 전부 목록을 + 대조하지 않는다.** 이건 graphql leaf 하나의 실수가 아니라 규약의 구멍이다. + +- **왜 문제인가**: + 필터 자신의 javadoc이 위험을 정확히 적어놨다 — *"A misspelled entry fails open silently + — the filter simply never matches"*(`:18`). **지금 두 항목이 정확히 그 상태다.** + + 오늘 실제 노출은 없다. 누락·오타 4개는 전부 + `@ConditionalOnBean(GraphQlSource)` 또는 `@ConditionalOnBean(GraphQlHttpHandler)`이고 + (jar의 `META-INF/spring-autoconfigure-metadata.properties`로 확인), + 그 빈을 만드는 `GraphQlAutoConfiguration`·`GraphQlWebMvcAutoConfiguration`은 필터에 + 제대로 걸린다. **즉 off 계약은 필터가 옳아서가 아니라 의존 사슬이 우연히 받쳐줘서 + 유지되고 있다.** + + 깨지는 시나리오(반증 가능): + 1. Boot 4.0.x 패치가 GraphQL auto-configuration을 하나 추가하는데 그게 + `GraphQlSource`에 조건이 걸려 있지 않다 → `backend.graphql.enabled=false`인데 활성화된다. + 2. Boot가 `GraphQlWebMvcAutoConfiguration`을 `servlet` → 다른 패키지로 옮긴다 → + 필터가 놓치고 `/graphql`이 스위치 off 상태로 publish된다. + 둘 다 **`GraphQlShippedAndGatedTest`의 `/graphql` POST 한 번**만이 잡아낸다. 그것도 + `/graphiql`·RSocket 라우트·SSE 라우트는 안 본다. 그리고 그 테스트는 이 leaf가 아니라 + `app-bootstrap`의 systemTest에 있고 `ci`/`qualificationCheck`에서만 돈다. + +- **수정 방향**: + 리터럴 목록을 유지하려면 **파리티 테스트를 추가한다** — 이 leaf의 `test`에 + (a) 10개(→12개) 이름이 전부 `Class.forName`으로 해석되는지, + (b) 필터의 집합이 클래스패스의 + `META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports` 중 + `org.springframework.boot.graphql.autoconfigure.` 로 시작하는 항목 집합과 **같은지**. + (b)를 넣으면 Boot 업그레이드 때 목록 드리프트가 컴파일이 아니라 테스트로 잡힌다. + 더 나은 안: `match()` 안에서 `candidates[index].startsWith("org.springframework.boot.graphql.autoconfigure.")` + 로 판정하면 목록 자체가 사라진다. 현재 필터가 잡으려는 것은 전부 그 패키지 아래에 있다. + +- **반론과 재반박**: + 반론 — "오늘 노출이 없고, systemTest가 실제 포트로 지키고 있다. 접두사 매칭은 과하게 + 넓어서 미래에 무해한 auto-configuration까지 막을 수 있다." + 재반박 — 접두사가 과하다면 파리티 테스트만으로 충분하고 비용은 20줄이다. 그리고 + **"오늘 노출 없음"은 이 필터가 존재하는 이유가 아니다.** 이 필터는 프레임워크가 스스로 + 라우트를 publish하는 것을 막으려고 있고, 그건 정의상 프레임워크 버전에 종속된 방어다. + 버전 종속 방어를 버전과 대조하지 않으면 그건 방어가 아니라 그 시점의 스냅샷이다. + 같은 저장소가 lockfile을 테스트로 읽고(`GraphQlTransportNeutralityTest:44-54`), + registry를 테스트로 대조하고, `apiSurface` 스냅샷을 강제한다. 이 목록만 대조되지 않는다. + +#### H2. `APP_GRAPHQL_ENABLED=true` + `APP_GRAPHQL_DEPLOYMENT_MODE=PRODUCTION_*` 만으로는 prod에서 기동하지 않는다. 나머지 두 요구사항에는 env 키가 없다 + +- **현상**: 등록된 GraphQL env 키는 2개뿐이다(`docs/registries/env-keys.yaml:4333, 4346`). + 그 둘만 설정하고 prod 모드로 켜면 기동이 **두 번** 실패한다: + 1. `graphQlAuthorizationPolicy` 빈이 `GraphQlPlatformConfigurationException`을 던진다 — + production 모드는 명시적 `GraphQlAuthorizationPolicy` 빈을 요구 + (`autoconfigure/GraphQlPlatformAutoConfiguration.java:351-358`). + 2. `GraphQlPlatformStartupValidator`가 `backend.graphql.cursor.key-ids`가 비었다고 거부 + (`autoconfigure/GraphQlPlatformStartupValidator.java:42-44`). + 둘 중 어느 것도 `graphql.yml`에 `${APP_*}` 플레이스홀더가 없다. `config/graphql.yml`은 + 12줄이고 키가 2개다. + +- **근거**: + - `src/app-bootstrap/src/main/resources/config/graphql.yml:5-12` (전문) + - 계약 테스트가 이 사실을 정확히 고정하고 있다: + `test/autoconfigure/GraphQlDeploymentModeContractTest.java:169-184` + (`PRODUCTION_INTERNAL`/`PRODUCTION_PUBLIC` → `"requires an explicit GraphQlAuthorizationPolicy"`), + `test/autoconfigure/GraphQlPlatformAutoConfigurationTest.java:81-94` (동일) + - `app-bootstrap`에 `GraphQlAuthorizationPolicy` 빈은 **없다** + (`grep -rn 'GraphQlAuthorizationPolicy' src/app-bootstrap/src/main` → 0) + +- **왜 문제인가**: + fork한 사람의 경로는 이렇게 된다 — README/CLAUDE를 읽고 "env 하나로 켜진다"고 이해 → + `APP_GRAPHQL_ENABLED=true APP_GRAPHQL_DEPLOYMENT_MODE=PRODUCTION_INTERNAL` 설정 → + 기동 실패 → 예외 메시지를 읽고 `GraphQlAuthorizationPolicy` 빈을 직접 작성 → 다시 기동 → + 또 실패 → `backend.graphql.cursor.key-ids`를 yml에 손으로 추가. + **두 번째 실패가 특히 나쁘다.** 그 키가 요구하는 것은 커서 서명 키인데, + **이 플랫폼에는 커서에 서명하는 코드가 요청 경로에 없다**(아래). + 즉 operator는 "아무것도 보호하지 않는 값"을 넣어야 기동한다. + + `LOCAL`/`DEV` 모드에서는 둘 다 통과한다(permissive 기본 인가 정책 + cursor 키 불필요). + 그러니 로컬에서는 env 2개로 정말 켜진다. prod에서만 깨진다. + +- **수정 방향**: + 1. `config/graphql.yml`에 `cursor.key-ids: ${APP_GRAPHQL_CURSOR_KEY_IDS:}` 와 + `limits.maximum-page-size` / `maximum-complexity` / `console.*` 를 `${APP_*}`로 추가하고 + `env-keys.yaml`에 등록. (지금 `backend.graphql.*` 중 env로 노출된 비율은 2/17이다.) + 2. cursor 키 요구를 **커서 서명이 실제로 배선될 때까지 제거**하거나, 메시지를 + "unsigned cursors are client-editable"에서 "이 키는 현재 아무 커서에도 서명하지 + 않는다(GQL-INT-003)"로 바꾼다. 지금 메시지는 사실이 아니다. + 3. `README.md:85-104`의 예제 YAML을 고친다 — 지금 `production: true`, + `environment: PRODUCTION_PUBLIC`을 보여주는데 **둘 다 은퇴한 키**이고, + `GraphQlRetiredSafetyAxis`가 이 키를 발견하면 기동을 거부한다 + (`autoconfigure/GraphQlRetiredSafetyAxis.java:27-34, 50-58`). + **README를 그대로 복사한 adopter는 기동에 실패한다.** + +- **반론과 재반박**: + 반론 — "production이 인가 정책 빈을 요구하는 건 옳다. allow-by-default를 prod에 내보내는 + 것보다 기동 거부가 낫다. env 키가 없는 것도 '이건 코드로 써야 할 것'이라는 신호다." + 재반박 — 인가 정책 요구(1번)에는 **동의한다. 그건 고치지 말아야 한다(K2).** + 내가 High로 두는 것은 (a) 커서 키 요구가 아무것도 보호하지 않는다는 것, (b) README가 + 기동 실패하는 설정을 예제로 보여준다는 것, (c) 두 env 키만 등록돼 있어서 + `verifyEnvKeys` 게이트가 "prod 기동에 필요한 설정이 다 있는가"를 답해주지 못한다는 + 것 — 이 셋이다. (1)은 반례가 아니라 이 항목의 일부일 뿐이다. + +#### H3. `cursor` / `mutation` / `fetch` / `compat` / `release` 는 요청 경로에 없는데, 그중 하나는 startup validator가 "있는 것처럼" 보이게 만든다 + +- **현상**: `pagination`(17파일/1,018줄), `mutation`(14/683), `fetch`(10/434), + `compat`(11/1,562), `release`(9/540) — 합 61파일/4,237줄이 어떤 `@Bean`에서도 + 도달 불가다. 그리고 `backend.graphql.cursor.key-ids`를 읽는 곳은 정확히 두 군데다: + 기동을 거부하는 `GraphQlPlatformStartupValidator`와 그 값을 돌려주는 + `GraphQlPlatformActuatorEndpoint`. **`HmacGraphQlCursorCodec`도 `GraphQlCursorKeyRing`도 + 플랫폼이 한 번도 생성하지 않는다.** + +- **근거**: 전이 폐포 계산(2절) + 프로젝트 자신의 테스트가 이미 이를 못박고 있다 — + `test/autoconfigure/GraphQlPolicyRequestPathTest.java:66-85` + (`doesNotHaveBean(GraphQlCursorCodec.class)`, `doesNotHaveBean(GraphQlCursorKeyRing.class)`), + `:87-97` (`doesNotHaveBean(GraphQlMutationIdempotencyInterceptor.class)`). + `CLAUDE.md:168-175`가 이를 GQL-INT-003으로 산문으로도 기록해뒀다. + +- **왜 문제인가**: 두 겹이다. + 1. **fork 사용자 관점** — `HmacGraphQlCursorCodec`은 잘 만들어져 있다(길이 프레이밍, + 상수시간 비교, 키 회전, direction/tenant/filter 스코프 바인딩). 하지만 adopter가 + 이걸 쓰려면 `GraphQlCursorKeyRing.of(Map, String)`에 **키 재료를 직접 + 공급**해야 하고, 설정 계약은 "키 자체는 설정에 나타나지 않는다"고 못박아 뒀다 + (`autoconfigure/GraphQlPlatformSettings.java:117`). 그래서 **어디서 가져오는지가 + 정의돼 있지 않다.** 배선이 아니라 설계 결정이 빠져 있다. + 2. **운영자 관점** — prod가 키 식별자를 요구하고, operator가 넣고, actuator가 + "설정됨"이라고 확인해 준다. 그런데 커서는 여전히 client-editable이다. + validator 메시지(`"unsigned cursors are client-editable"`)가 **거짓 안심**을 준다. + +- **수정 방향**: 키 재료의 출처를 먼저 정한다(가장 가까운 선례는 + `shared.opstore.OperationalRecordStorePort`처럼 중립 SecretSource 포트). 그 전까지는 + validator 메시지를 사실에 맞게 고치고, `HmacGraphQlCursorCodec`을 `spi` 패키지로 옮겨 + "adopter가 직접 조립하는 부품"임을 타입 위치로 표시한다. + +- **반론과 재반박**: + 반론 — "`CLAUDE.md`가 `modelled` 등급으로 정직하게 표기했고, 네거티브 테스트로 + 못박았다. 미완성을 미완성이라고 적은 것을 결함으로 셀 수 없다." + 재반박 — **문서화는 실제로 훌륭하고 그래서 Critical이 아니라 High다**(K4로 따로 기린다). + 그럼에도 High인 이유는, validator가 **기동을 거부하는** 강제력을 가진 채로 존재하지 + 않는 보호를 요구한다는 점이다. 등급표는 `docs`에 있고 거부 메시지는 운영자의 터미널에 + 있다. 둘이 충돌할 때 운영자가 읽는 것은 후자다. + +--- + +### Medium + +#### M1. GraphQL의 클라이언트 노출 에러 코드가 저장소 SSOT(`error-codes.yaml`)에 하나도 없다 + +- **현상**: `docs/registries/error-codes.yaml`(918줄)은 `code`/`category`/`http_status`/ + `retryable`/`runbook_link`/`required_test`를 요구하는 SSOT이고, + `app-bootstrap`·`sample-portfolio`의 계약 테스트 6개가 이걸 강제한다 + (`BackgroundJobErrorCodeContractTest`, `RunbookCoverageContractTest`, + `PortfolioErrorCodeRegistryMappingTest` 등). + GraphQL 플랫폼이 클라이언트에 내보내는 코드 14개 + (`INTERNAL_ERROR`, `REQUEST_ERROR`, `AUTHORIZATION_DENIED`, `AUTHENTICATION_REQUIRED`, + `RESOURCE_NOT_FOUND`, `REQUEST_TIMEOUT`, `DEPENDENCY_UNAVAILABLE`, + `GRAPHQL_COMPLEXITY_EXCEEDED`, `GRAPHQL_DOCUMENT_SHAPE_REJECTED`, + `GRAPHQL_DOCUMENT_LIMIT_EXCEEDED`, `GRAPHQL_INPUT_SHAPE_REJECTED`, + `GRAPHQL_BATCH_TIMEOUT`, `GRAPHQL_CURSOR_REJECTED`, `PARTIAL_RESPONSE`) + 는 **한 개도 등록돼 있지 않다.** + +- **근거**: `grep -c` 각 코드 vs `docs/registries/error-codes.yaml` → 전부 0. + 코드 형식은 `error/GraphQlErrorCode.java:31`의 정규식(`[A-Z][A-Z0-9_]{2,63}`)만 강제한다 — + 형식 검사이지 레지스트리 검사가 아니다. + +- **왜 문제인가**: web 어댑터를 통해 인증 실패한 클라이언트와 GraphQL을 통해 인증 실패한 + 클라이언트가 **다른 코드 체계**를 본다. 같은 서비스인데. 그리고 `error-codes.yaml`이 + 요구하는 `runbook_link`가 GraphQL 코드에는 없으므로, `GRAPHQL_COMPLEXITY_EXCEEDED`가 + 대량 발생해도 운영자가 열 runbook이 없다. + +- **반론과 재반박**: 반론 — "레지스트리는 `ApiErrorCode`(애플리케이션/도메인 실패)를 + 다루고, GraphQL의 코드는 전송 레이어 거부라서 web이라면 HTTP status로 표현됐을 것이다. + 다른 축이므로 같은 표에 넣을 이유가 없다." + 재반박 — 그 논리는 `GRAPHQL_DOCUMENT_SHAPE_REJECTED` 같은 것에는 맞다. 하지만 + `RESOURCE_NOT_FOUND`/`AUTHORIZATION_DENIED`/`AUTHENTICATION_REQUIRED`는 레지스트리의 + `AUTH_*`/`AUTHZ_*` 행과 **같은 사건**이다. 그리고 `GraphQlWireErrorMapper.fromApiError`는 + `ApiErrorCode.code()`를 그대로 통과시키므로(`runtime/GraphQlWireErrorMapper.java:88-94`) + **두 체계가 같은 `extensions.code` 필드에 섞여서** 나간다. 클라이언트는 어느 쪽인지 + 구분할 방법이 없다. 최소한 GraphQL 전용 코드에 접두사 규칙을 두고 레지스트리에 + "transport" 계층으로 등록해야 한다. + +#### M2. 문서가 "이 leaf는 composition root가 의존하지 않는다"고 말하는데, 의존한다 + +- **현상**: `README.md:31-33` — *"현재 `app-bootstrap`과 `sample-portfolio`의 production + runtime은 이 leaf를 의존하지 않는다. 즉 이 모듈은 **classpath opt-in**"*. + `CLAUDE.md:66-68`도 같은 말. + 실제: `src/app-bootstrap/build.gradle:120` = `implementation project(':adapter:inbound:graphql')`. + `app-bootstrap/build.gradle:210-211`의 주석도 어긋난다 — + *"These projects remain absent from main api/implementation/compileOnly/runtimeOnly"* + 라고 적어놓고 바로 위 120줄에 `implementation`으로 선언돼 있다. +- **왜 문제인가**: **코드가 사실이고 문서가 결함이다.** 그리고 이건 사소한 드리프트가 + 아니라 3절 전체의 전제를 뒤집는 문장이다. "classpath에 없다"와 "classpath에 있지만 + 스위치가 꺼져 있다"는 완전히 다른 운영 상태다(CVE 노출 표면, jar 크기, 업그레이드 부담). + 실제 구현은 후자이고 그게 더 나은 선택인데(K1), 문서가 전자라고 말한다. +- **수정 방향**: 세 곳(`README.md:31`, `CLAUDE.md:66`, `app-bootstrap/build.gradle:210`)을 + "shipped and gated"로 고친다. `GraphQlShippedAndGatedTest`의 이름이 이미 정답이다. + +#### M3. `CLAUDE.md`의 테스트 명령이 커밋 안 된 리팩토링으로 깨졌다 + +- **현상**: `CLAUDE.md:188-191` + ```bash + ./gradlew :adapter:inbound:graphql:test \ + --tests dev.caskeleton.adapter.inbound.graphql.GraphqlHttpBoundaryQualificationTest + ``` + 이 클래스는 이제 `src/systemTest/java`에 있다. `test` 태스크의 classesDirs에 없으므로 + 이 명령은 "no tests found"로 끝난다. + 또 `CLAUDE.md:141`이 `wired` 등급의 증거로 `runtime/GraphQlPlatformExecutionPathTest`를 + 지목하는데, 그 테스트도 `systemTest`로 갔으므로 **`:test`로는 안 돈다.** +- **수정 방향**: `./gradlew :adapter:inbound:graphql:systemTestLaneCheck` 또는 + `graphqlTransportQualificationTest`로 고친다. 등급표의 증거 칸에 어느 레인인지 적는다. +- **반론과 재반박**: 반론 — "커밋 안 된 작업 중이라 문서가 아직 안 따라왔을 뿐이다." + 재반박 — 맞다. 그래서 Medium이다. 다만 이 리팩토링의 diff가 + **삭제만 커밋 가능한 상태**라는 점(7절)과 합쳐지면 위험이 올라간다. + +#### M4. `graphql-transport-ws` 프로토콜 모델이 두 leaf에 중복 존재한다 + +- **현상**: `adapter/inbound/graphql/advanced/websocket/`(7파일/415줄, 도달 불가)과 + `adapter/inbound/websocket/advanced/graphql/`(3파일, close code 4400/4401/4403/4408/ + 4409/4429 구현 + init deadline + subscription id 유일성)이 같은 서브프로토콜을 모델링한다. +- **근거**: 양쪽 `grep -c '44[0-9][0-9]'` — graphql leaf 쪽 0, websocket leaf 쪽 + `GraphQlCloseCode.java`=7, `GraphQlTransportBridge.java`=8. + websocket leaf는 graphql leaf를 의존하지 않는다(`adapter/inbound/websocket/build.gradle:23,27` + = `domain-core`, `application-core`만) — **이 분리 자체는 옳다**(어댑터 간 의존 금지). +- **판정**: **중복이지 분담이 아니다.** 실제로 동작하는 쪽은 websocket leaf이고 + (`GraphQlTransportBridge.java:14-32`가 "opaque document를 양방향으로 옮기고 연결 레벨 + 규칙 두 개만 강제한다"고 책임을 명확히 선언), + graphql leaf의 `advanced/websocket`은 아무도 부르지 않는 병렬 모델이다. +- **수정 방향**: graphql leaf의 `advanced/websocket` 7파일을 지우고, 구독 전송은 + websocket leaf가 소유한다고 `CLAUDE.md` 등급표에 명시한다. + (교차 이슈 — websocket 담당자와 조율 필요.) + +#### M5. parser 한계·응답 런타임 예산이 구현돼 있는데 아무도 설치하지 않는다 + +- **현상**: + - `cost/GraphQlParserOptionsFactory.installOperationDefaults()`는 graphql-java의 + static default parser options를 교체한다(`:38-42`). **main에서 이걸 호출하는 곳은 없다.** + `GraphQlParserLimitPolicy.java`의 javadoc `{@link}`가 유일한 참조. + → graphql-java 라이브러리 기본값(문자 ~1MiB, 토큰 15,000)이 그대로 적용된다. + `GraphQlParserLimits.java:8-11`이 바로 그 상황을 "public endpoint를 위한 값이 아니다"라고 + 적어놓았다. + - `cost/GraphQlRuntimeBudgetTracker`(응답 노드 수/바이트 수 상한)는 + `advanced/incremental/GraphQlIncrementalTransportPolicy`에서만 참조된다. + `advanced`는 배선이 없으므로 **Stable 요청 경로에 응답 크기 상한이 없다.** +- **완화 요인**: 문서 크기 상한은 `GraphQlPlatformWebInterceptor.verifyRequestBounds`가 + 16KiB로 자르고(`policy/GraphQlClientPolicy.java:88`), raw body는 servlet 필터가 자른다. + 그래서 parser 한계 미설치의 실제 노출은 작다. 응답 크기 쪽은 사전 complexity 예산이 + 대신 막는다 — 다만 `GraphQlRuntimeBudget.java:8-11`이 "사전 추정은 리스트에 오늘 + 5만 행이 있다는 걸 모른다"고 스스로 그 한계를 적어놓았다. +- **수정 방향**: `CLAUDE.md` 등급표에 `parser 한계`와 `응답 런타임 예산` 두 줄을 추가하고 + `modelled`로 표기한다(지금 표에 없다). 또는 `GraphQlPlatformAutoConfiguration`에 + `installOperationDefaults(GraphQlParserLimits.from(clientPolicy))`를 거는 + `InitializingBean`을 하나 추가한다(5줄). + +#### M6. `extensions` 키 allowlist가 실제 요청 경로에서 강제되지 않는다 + +- **현상**: `http/GraphQlExtensionsPolicy`는 등록되지 않은 `extensions` 키를 거부한다. + 그런데 이걸 호출하는 것은 `GraphQlRequestEnvelopeValidator.validateEnvelope` + (`http/GraphQlRequestEnvelopeValidator.java:133`)뿐이고, 그 클래스는 도달 불가다. + 실제 경로인 `GraphQlPlatformWebInterceptor.verifyRequestBounds`는 + `structurePolicy.verify("extensions", ...)`만 부른다(`runtime/GraphQlPlatformWebInterceptor.java:132`) + — 이건 **깊이/요소수/키수 한계**이지 키 이름 allowlist가 아니다. +- **왜 문제인가**: `GraphQlExtensionsPolicy.java:11-14`가 밝힌 위협 — + *"undocumented feature flag가 나타나서 조용히 execution을 바꾸는 자리"* — 가 열려 있다. + 현재 플랫폼은 `extensions`를 읽지 않으므로 실제 영향은 없다. 하지만 adopter가 + `extensions`를 읽는 순간 allowlist 없이 읽게 된다. +- **수정 방향**: `GraphQlPlatformWebInterceptor`에 `GraphQlExtensionsPolicy` 빈을 주입해 + `verifyRequestBounds`에서 호출. `GraphQlExtensionsPolicy.stableDefaults()`가 이미 있다. + +#### M7. `schema/` 패키지 19개 중 11개(691줄)가 병렬 구현이고, 그중 하나는 아무도 소비하지 않는 빈이다 + +- **현상**: `GraphQlSchemaAssembler`/`GraphQlSchemaAssemblyResult`(결정적 정렬, 중복 선언 + 거부, 소유권 귀속, canonical SDL, 스키마 해시)는 **Spring GraphQL 자신의 + `classpath:graphql/**` 병합과 같은 일을 다시 한다.** main에서 이들을 호출하는 곳은 없다. + Spring 쪽이 실제로 돌고, 이쪽은 안 돈다. + 더 구체적으로: `graphQlMappingInspectionGate` 는 `@Bean`으로 등록되지만 + (`autoconfigure/GraphQlPlatformAutoConfiguration.java:502-506`) + **`verify(...)`를 호출하는 코드가 main에 없다.** Spring이 알 수 없는 타입이므로 + 프레임워크가 가져가지도 않는다. **소비자 없는 빈이다.** + `GraphQlOneOfSchemaGate`/`GraphQlOneOfInputValidator`도 마찬가지. +- **수정 방향**: `graphQlMappingInspectionGate` 빈을 지우거나, + Spring의 `SchemaMappingInspector` 결과를 받아 `verify`를 거는 `InitializingBean`을 붙인다. + 후자가 `CLAUDE.md`가 약속한 동작이다("Stable 프로파일은 그 리포트를 기동 실패로 승격"). + 현재는 승격되지 않는다. + +--- + +### Low + +#### L1. `moduleboundary/GraphQlAdvancedModule.java:90-101` — javadoc 두 개가 붙어 `WEBSOCKET`의 설명이 `SPRING_DATA`에 달렸다 +`/** The GraphQL over WebSocket protocol state machine. */` 바로 뒤에 `SPRING_DATA`의 +javadoc이 오고, 그 아래 `SPRING_DATA(...)` 선언, 그다음 `WEBSOCKET(...)`이 설명 없이 온다. +컴파일·동작에는 영향 없음. + +#### L2. `graphQlPlatformClock` 이 애플리케이션 전역 `Clock` 빈을 등록한다 +`@ConditionalOnMissingBean(Clock.class)`(`autoconfigure/GraphQlPlatformAutoConfiguration.java:288`). +GraphQL을 켜면 컨텍스트에 `Clock`이 하나 생긴다. 주석이 반대 방향의 사고(이름 조건으로 +했더니 `Clock`이 둘이 돼서 깨졌다)를 설명하고 있어서 이 선택 자체는 근거가 있다. +다만 **인바운드 어댑터가 전역 타입을 공급하는 것**은 방향이 이상하다. GraphQL을 켰다 껐다 +할 때 다른 모듈의 `ObjectProvider` 해석이 바뀔 수 있다. `app-bootstrap`이 +`Clock`을 소유하는 쪽이 맞다. + +#### L3. `README.md`가 `modules.json`의 leaf 개수를 산문으로 적었다 +`README.md:135` — "현재 총 43개 leaf". 브리프의 확인값은 62개다. 루트 `CLAUDE.md`가 +"산문에 숫자를 쓰지 말라"고 명시한 바로 그 종류의 드리프트다. + +--- + +## 6. 바꾸지 말 것 (Keep) + +### K1. [최종 수정] GraphQL은 build-selected capability이고, 선택된 뒤 runtime switch로 끈다 + +- 유지: `GraphQlRootAutoConfiguration`의 master switch와 OFF 계약. +- 폐기: 모든 파생 서비스가 GraphQL leaf를 `implementation`으로 기본 ship해야 한다는 결론. +- 최종 구조: + + Repository Catalog: GraphQL 구현 존재 + ↓ + Build Composition: 이 서비스가 GraphQL을 선택 + ↓ + Runtime Activation: backend.graphql.enabled + +GraphQL을 사용하지 않는 서비스는 graphql-java/Spring GraphQL의 이미지·CVE 비용까지 부담할 필요가 없다. +반대로 GraphQL을 선택한 서비스에서는 OFF와 ON 모두 실제 shipped composition으로 검증한다. + +leaf-owned AutoConfiguration을 먼저 완결하고 bootstrap의 직접 구현 import를 제거한 뒤 dependency scope를 +판단한다. `runtimeOnly` 전환 자체를 선행 목표로 삼지 않는다. + +### K2. production 모드가 명시적 `GraphQlAuthorizationPolicy` 빈 없이는 기동을 거부하는 것 +- **무엇**: `autoconfigure/GraphQlPlatformAutoConfiguration.java:344-360`. + `LOCAL`/`DEV`는 permissive 기본값을 주고, `PRODUCTION_*`는 예외를 던진다. +- **왜 지금 이게 맞는가**: 주석이 세 가지 선택지를 전부 검토했다는 것을 보여준다 — + deny-by-default 스켈레톤 정책은 아무것도 답하지 못해서 adopter가 allow-all로 바꿀 것이고, + allow-by-default를 prod에 내보내면 그건 무인가 엔드포인트다. **좌표 규칙은 애플리케이션 + 지식이므로 플랫폼이 가질 수 없다.** 그래서 "개발은 탐색 가능하게, prod는 기동 거부"가 + 남는 유일한 정직한 답이다. `GraphQlDeploymentModeContractTest.java:169-184`가 이걸 고정한다. +- **언제 재검토**: 스키마 좌표를 자동 발견해서 "등록 안 된 좌표는 deny"를 기본값으로 줄 수 + 있게 되면. 그때도 prod 기본은 deny여야 한다. + +### K3. `verifyGraphQlProductionJar` + `testFixtures` 분리 +- **무엇**: 계약 스위트·in-memory 레지스트리·`testContext(String)`를 + `src/testFixtures/java`로 옮기고, "옮겼다"를 믿지 않고 **jar 내용으로** 확인한다 + (`build-logic/.../VerifyGraphQlProductionJarTask.java:32-54`, `check`에 연결). +- **왜 지금 이게 맞는가**: 막으려는 사고가 구체적이다 — production jar에 있는 + `InMemoryGraphQlPersistedOperationRegistry`는 **두 번째 인스턴스가 뜰 때까지 완벽하게 + 동작하는 빈**이고, `testContext(String)`는 자격증명 없이 인증된 actor를 만든다. + 둘 다 adopter가 "있으니까 쓴다". `build.gradle:24-30`이 이 추론을 그대로 적어놨다. + 그리고 **jar를 실제로 여는** 검증이라 "옮기는 걸 깜빡했다"가 통과할 수 없다. +- **언제 재검토**: 마커가 이름 기반이라 우회 가능하다. leaf가 capability 아티팩트로 쪼개져서 + testkit이 별도 artifact가 되면 이 태스크는 불필요해진다. + +### K4. `CLAUDE.md`의 capability 등급표와 `GraphQlPolicyRequestPathTest` +- **무엇**: `CLAUDE.md:129-155`가 capability마다 + `modelled`/`wired`/`integration-verified`/`production-verified` 등급을 매기고 + **"현재 등급보다 높게 표현하지 않는다"**고 선언한다. 그리고 + `test/autoconfigure/GraphQlPolicyRequestPathTest`가 **배선되지 않은 것을 테스트로 고정**한다. +- **왜 지금 이게 맞는가**: 내가 전이 폐포로 계산한 결과와 이 표가 **대체로 일치했다.** + 커서 서명 `modelled`, mutation 멱등성 `modelled`, object 인가 `modelled`, + DataLoader `wired`, 실행 파이프라인 `wired` — 전부 맞다. 리뷰 대상 코드베이스에서 + "문서가 코드보다 낙관적이지 않다"는 경우는 드물다. 그리고 네거티브 테스트는 + **"한쪽만 배선하면 깨진다"**는 성질을 가진다 — 커서 코덱 빈을 추가하면 + `aConfiguredCursorKeySignsNothing`이 실패하고, 그러면 작성자가 validator 메시지와 + 등급표를 같이 고치게 된다. 이건 문서 드리프트를 테스트로 막는 방법이고 잘 작동한다. +- **언제 재검토**: 표에 줄 수/도달 가능성 칸을 추가하면 더 좋다(M5가 표에 없다). + 표 자체는 유지. + +### K5. 모듈 경계를 **소스 텍스트**로 스캔하고, 규칙마다 negative fixture를 두는 것 +- **무엇**: `test/moduleboundary/GraphQlBuildModel` + `GraphQlModuleBoundaryTest`. +- **왜 지금 이게 맞는가**: 세 가지가 동시에 옳다. + (a) **바이트코드가 아니라 소스를 읽는다** — 상수 인라이닝이나 미보존 시그니처로 + 바이트코드에서 지워진 import를 리뷰어는 여전히 소스에서 읽는다(`GraphQlBuildModel.java:21-24`). + (b) **0개 스캔은 실패다**(`:238-243`, `theScanActuallyReadsTheProductionTree`가 300개 이상을 요구). + (c) **규칙마다 거부돼야 하는 합성 트리가 있다** — 한 번도 실패한 적 없는 경계 테스트는 + 잘못된 디렉토리를 읽는 테스트와 구분되지 않는다(`GraphQlModuleBoundaryTest.java:26-29`). + 이 leaf는 과거에 `.gitignore`의 anchor 없는 `build/` 규칙 때문에 경계 모델 전체를 + 커밋에서 잃은 적이 있고(`CLAUDE.md:46-51`), 그 경험이 이 설계에 반영돼 있다. +- **언제 재검토**: leaf를 실제 Gradle leaf로 쪼개서 의존 게이트가 대신할 수 있게 되면. + +### K6. adopter의 `@Controller`까지 기동 시 경계 검사하는 것 +- **무엇**: `graphQlControllerBoundaryCheck`가 컨텍스트의 모든 `@Controller` 빈을 읽어 + 리포지토리 주입·엔티티 반환·`@Transactional`·raw `DataFetcher`를 검사한다 + (`autoconfigure/GraphQlPlatformAutoConfiguration.java:150-185`). +- **왜 지금 이게 맞는가**: 이게 **HARD-STOP #2/#3을 런타임에 실제로 강제하는 유일한 장치**다. + 패키지 이름으로만 검사하던 시절에는 이 leaf 자기 테스트 픽스처만 검사됐고 + adopter의 컨트롤러는 아무것도 보지 않았다(`:144-148`이 이 과거를 기록). + 그리고 JPA/Spring Data에 **컴파일 의존 없이** 한다 — 애노테이션 단순명 매칭 + (`architecture/GraphQlReturnTypePolicy.java:40-41`). 인바운드 어댑터가 금지 대상에 + 의존해야 금지를 검사할 수 있다면 본말전도라는 판단이고, 맞다. + 제네릭 타입 그래프를 걷는 것(`GraphQlTypeGraph`)도 필수다 — `Optional`는 + erased 검사를 그냥 통과한다. +- **언제 재검토**: 기동 시간이 문제가 되면 `ApplicationContext` 스캔을 빌드타임 ArchUnit으로 + 옮기는 안이 있으나, 그러면 adopter의 컨트롤러는 다시 검사 밖으로 나간다. 지금이 맞다. + +### K7. transport neutrality — 서버를 leaf가 고르지 않는 것 +- **무엇**: production 파일 중 `org.springframework.web`/`jakarta.servlet` import 0개. + `jakarta.servlet-api`는 `compileOnly`. 서버 선택은 composition root. + `GraphQlRuntimeTransport`가 실제 실행 중인 서버를 감지해 선언된 프로파일과 어긋나면 + **기동 거부**(`autoconfigure/GraphQlPlatformStartupValidator.java:112-119`). +- **왜 지금 이게 맞는가**: 과거에는 leaf가 `spring-boot-starter-web`을 production + `implementation`으로 갖고 있어서 **모든 adopter에게 Tomcat을 올리면서 동시에 + `REACTIVE_WEBFLUX` 프로파일을 표방**했다 — 성립 불가능한 조합이었다. + 지금은 lockfile로 고정되고(`GraphQlTransportNeutralityTest:44-54`), 불일치는 기동 거부다. + 그리고 두 검사가 서로 못 보는 것을 커버한다 — lockfile 검사는 컨텍스트를 띄우는 + 테스트가 볼 수 없는 transitive 서버를 잡고, 컨텍스트 검사는 lockfile이 의견 없는 + 프로파일 불일치를 잡는다. +- **언제 재검토**: 없음. 이건 그냥 옳다. + +--- + +## 7. 커밋 안 된 리팩토링이 이 영역에 미친 영향 + +### 브리프의 전제를 정정한다 — 테스트는 삭제되지 않았다. 이동했다. + +`status.txt`가 보여주는 것: +``` + M src/adapter/inbound/graphql/build.gradle + M src/adapter/inbound/graphql/gradle.lockfile + D .../src/test/java/.../GraphqlHttpBoundaryQualificationTest.java + D .../src/test/java/.../runtime/GraphQlPlatformExecutionPathTest.java + D .../src/test/resources/graphql-platform/platform.graphqls + D .../src/test/resources/graphql-qualification/qualification.graphqls +?? src/adapter/inbound/graphql/src/systemTest/ ← 여기 +``` + +`full.diff`에서 삭제된 4개 파일의 원본을 복원해 새 위치와 **바이트 단위로 대조**했다: + +``` +old-qual.java vs src/systemTest/java/.../GraphqlHttpBoundaryQualificationTest.java → IDENTICAL +old-exec.java vs src/systemTest/java/.../runtime/GraphQlPlatformExecutionPathTest.java → IDENTICAL +old-platform.graphqls vs src/systemTest/resources/graphql-platform/platform.graphqls → IDENTICAL +old-q.graphqls vs src/systemTest/resources/graphql-qualification/qualification.graphqls → IDENTICAL +``` + +`?? src/.../systemTest/`가 untracked라서 diff에 삭제만 보인 것이다. +동일한 이동이 **4개 leaf에서 동시에** 일어났다 (`status.txt:244,246,248,314` — +graphql, web, websocket, sample-portfolio). `app-bootstrap/src/systemTest`는 이미 tracked였다. +즉 **저장소 전역 패턴의 채택**이지 graphql만의 절단이 아니다. + +`gradle.lockfile`의 254줄 변경도 확인했다 — 좌표 집합의 차집합이 **양방향 모두 공집합**이다. +`systemTest*` 컨피규레이션 이름이 추가된 것뿐이고 **버전 변경도, 의존 추가/제거도 없다.** + +### 무엇이 바뀌었나 — 실행 시점 + +`build.gradle` diff: +```groovy ++ id 'ca.auxiliary-source-set' ++ auxiliarySourceSets { sourceSet('systemTest') { compilesAgainst 'main' } } ++ strictTestLanes { lane('systemTest') { system(); sourceSet = 'systemTest' } } + extensions.getByName('strictQualification').register( + 'graphqlTransportQualificationTest', +- sourceSets.test, ++ sourceSets.systemTest, +``` + +실행 경로: +``` +:adapter:inbound:graphql:test → 더 이상 두 테스트를 안 돈다 +:adapter:inbound:graphql:systemTestLaneCheck → 돈다 +src/build.gradle:117-120 systemTestCheck → 모든 leaf의 systemTestLaneCheck +src/build.gradle:122-126 qualificationCheck → systemTestCheck +src/build.gradle:128-135 ci → qualificationCheck +``` + +즉 **`ci`에서는 여전히 돈다.** 개발자의 빠른 `:test` 레인에서만 빠졌다. + +### 안전망이 약해졌는가 — 판정 + +**아니다. 오히려 fail-closed가 강해졌다.** 근거: + +`StrictTestLanePlugin`이 이 이동에 걸어놓은 것: +- 레인이 선택됐는데 소스셋이 비어 있으면 **GradleException** — + *"Gradle would skip it as NO-SOURCE and report success for a lane that ran nothing"* + (`build-logic/.../strictlane/StrictTestLanePlugin.java:53-63`). +- 레인이 테스트를 **0개 실행하면 실패**(`:174-203`). 전부 `@Disabled`로 skip돼도 실패 + (`:178-182` — *"a skip is not a result"*). +- `strictQualification`이 `GraphqlHttpBoundaryQualificationTest`를 **이름으로 required** + 선언하고(`build.gradle:135-141`), 그 이름이 실행되지 않으면 실패 + (`:214-227` — *"A lane that named a test it no longer runs proves less than it claims"*). +- `getFailOnNoDiscoveredTests().set(true)` (`:157`). + +**이 이동으로 두 테스트가 조용히 사라질 수는 없다.** 파일을 지우면 +`systemTest` 소스셋이 비어서 레인이 예외로 죽거나, required test가 실행 안 돼서 죽는다. + +그리고 `graphqlStableTest` 레인은 영향 없다 — +`GraphQlPlatformPlugin`이 `sourceSets.test`를 쓰고(`GraphQlPlatformPlugin.java:33-38`) +required class인 `moduleboundary.GraphQlModuleBoundaryTest`는 `src/test`에 그대로 있다. + +**판정: 유지보수 부담을 줄이면서 보증은 유지한 좋은 리팩토링이다.** +`:test`가 random-port 서블릿 부팅 두 개를 매번 끌고 다니지 않게 됐고 +(`:test`는 `maxParallelForks=2`로 도는 빠른 레인이다), 무거운 증거는 `ci` 레인으로 갔다. + +### 다만 남는 위험 두 가지 + +1. **`src/systemTest/`가 untracked다.** `git add`를 잊고 삭제만 커밋하면 + 두 테스트는 **진짜로** 사라진다. 그 순간 `systemTestLaneCheck`가 + "소스셋이 비었다"로 죽으므로 CI에서는 잡히지만, 로컬에서 `:test`만 돌리는 + 개발자에게는 아무 신호가 없다. + **확인 명령**: `git status --porcelain src/adapter/inbound/graphql/src/systemTest` + 가 `??`인 동안은 커밋하지 말 것. 4개 leaf 전부 같은 상태다. +2. **문서가 안 따라왔다** (M3). `CLAUDE.md:188-191`의 명령이 깨졌고, + 등급표(`:141`)의 증거가 `:test`에서 안 도는 레인을 가리킨다. + +### `VerifyGraphQlProductionJarTask`가 이걸 대체하는가 + +**아니다. 애초에 다른 것을 검사한다.** 3절에서 확인했듯 그 태스크는 jar 안의 픽스처 +혼입만 본다. 토글/클래스패스 격리와는 무관하다. +**이동한 두 테스트를 대체할 수 있는 것은 없고, 대체할 필요도 없다 — 그대로 남아 있다.** + +--- + +## 8. 템플릿 사용자 관점 + +### GraphQL을 안 쓰는 경우 (기본값) +아무것도 안 해도 된다. `APP_GRAPHQL_ENABLED`는 기본 false이고, 빈도 스레드도 라우트도 +생기지 않는다. jar가 조금 커지는 것만 감수하면 된다. **여기는 잘 돼 있다.** + +### GraphQL을 로컬/dev에서 켜는 경우 +```bash +APP_GRAPHQL_ENABLED=true +APP_GRAPHQL_DEPLOYMENT_MODE=LOCAL +``` +이것만으로 켜진다. `/graphql`이 뜨고 `{ _health }`가 `"UP"`을 준다. +introspection/GraphiQL은 기본 off이고, `backend.graphql.console.*`로 켤 수 있다 +(이 두 키는 `graphql.yml`에 없으므로 `application-local.yml`에 직접 써야 한다). + +### GraphQL을 prod에서 켜는 경우 — 여기서 걸려 넘어진다 + +밟게 될 순서: +1. env 두 개 설정 → 기동 실패: + `"backend.graphql.deployment-mode=PRODUCTION_INTERNAL requires an explicit + GraphQlAuthorizationPolicy bean"` +2. `app-bootstrap`에 `@Bean GraphQlAuthorizationPolicy`를 작성해야 한다. + **좌표를 하나하나 열거해야 한다** — + `GraphQlAuthorizationPolicy.builder().denyByDefault(true).allow(coordinate, profile)...` + (예시는 `systemTest/.../GraphQlPlatformExecutionPathTest.java:396-407`). + `Query._health`를 빼먹으면 health 쿼리가 막힌다. +3. 다시 기동 → 또 실패: `"a cursor signing key is required; unsigned cursors are + client-editable"` +4. `application-prod.yml`에 `backend.graphql.cursor.key-ids: [cursor-key-1]`을 손으로 추가. + **이 값은 아무것도 하지 않는다**(H3). 알고 넣어야 한다. +5. 기동 성공. + +### 그다음 실제 API를 붙일 때 + +**손대야 하는 파일**: +- `src/main/resources/graphql/*.graphqls` — feature 스키마. `classpath:graphql/**`로 병합된다. +- `@Controller` + `@QueryMapping`/`@MutationMapping` 빈. **컴포넌트 스캔 경로에 있어야 한다.** + 이 leaf의 `HealthGraphqlController`는 스캔 제외 패키지에 있고 루트가 `@Import`로 + 들여온다는 점에 주의(`autoconfigure/GraphQlRootAutoConfiguration.java:25-31`). +- `GraphQlAuthorizationPolicy` — 좌표마다 `allow()`. 이게 실질적인 작업량이다. +- `GraphQlCostCatalog` — 등록 안 한 좌표는 보수적 기본 가중치 10(`EXTERNAL_BATCH`)을 + 받는다(`cost/GraphQlCostCatalog.java:17, 41-48`). 기본 complexity 예산 10,000에 + 중첩 connection이 몇 겹 들어가면 **정상 쿼리가 거부되기 시작한다.** + 실제로 systemTest는 예산 100으로 낮춰서 이 경계를 테스트한다. +- `GraphQlBatchPolicyRegistry.register(...)` + `GraphQlBatchLoaderRegistrar.register(...)` + — N+1 방지는 **adopter가 loader를 등록해야만** 동작한다. 플랫폼은 기계만 제공한다. + `runtime/GraphQlBatchLoaderRegistrationTest`가 정확한 사용 예다. + +**밟게 될 지뢰**: +- `@Transactional`을 resolver에 붙이면 **기동이 거부된다**(K6). 라이브러리 무관, + 단순명 `Transactional`이면 전부. 의도된 동작이지만 모르면 당황한다. +- 엔티티를 반환하거나 `Map`를 반환하면 기동 거부. `Optional` + 주입도 거부(제네릭까지 본다). +- `Flux`를 query에 반환하면 거부(subscription만 허용). `Mono`는 허용. +- depth 12 / alias 50 / fields 500 / document 16KiB는 **하드코딩 상수**다 + (`policy/GraphQlClientPolicy.java:87-103`). `backend.graphql.limits.*`로 조정 가능한 것은 + page size와 complexity 둘뿐. 나머지를 바꾸려면 `GraphQlClientPolicy` 빈 자체를 교체해야 + 하고, 그러면 `runtimeProblems`가 configured ceiling과 대조한다. +- 커서 페이지네이션을 쓰려면 `HmacGraphQlCursorCodec`을 **직접 조립**해야 하고, + 키 재료를 어디서 가져올지는 정해져 있지 않다(H3). +- mutation 멱등성도 직접 조립(`GraphQlMutationIdempotencyInterceptor`는 static util이고 + 빈이 아니다). +- 구독이 필요하면 **이 leaf가 아니라 `adapter:inbound:websocket`**을 본다(M4). +- 에러 코드는 `error-codes.yaml` 밖에 있다(M1). 자기 도메인 코드는 `ApiErrorCarrier`로 + 던지면 그대로 통과한다. + +### 정직한 요약 +**로컬/dev에서 켜기: 쉽다. prod에서 켜기: 반나절. 실제 API 붙이기: 인가 정책 + cost catalog +작성이 본체이고, 나머지 26,000줄 중 대부분은 읽지도 만지지도 않는다.** + +--- + +## 9. 미확인 / 가정 + +**빌드를 한 번도 돌리지 않았다** — 스냅샷에 Gradle wrapper jar가 없다(브리프 2절). +아래는 전부 정적 분석 결과이고, 확인하려면 명시한 명령이 필요하다. + +| 미확인 | 확인 명령 | +|---|---| +| H1이 실제로 아무 노출도 만들지 않는지(내 판단은 "오늘은 안 만든다") | `./gradlew :app-bootstrap:systemTestLaneCheck --console=plain` — `GraphQlShippedAndGatedTest` 통과 확인 | +| H1의 파리티가 깨진 것 자체 | **이건 확인했다.** 로컬 Gradle 캐시의 `spring-boot-graphql-4.0.8.jar`에서 `AutoConfiguration.imports`를 직접 읽어 대조했다. 유일한 가정은 "런타임 클래스패스의 버전이 lockfile의 4.0.8과 같다"이고, lockfile이 그걸 고정하므로 안전하다 | +| H2의 기동 실패 2회 | `APP_GRAPHQL_ENABLED=true APP_GRAPHQL_DEPLOYMENT_MODE=PRODUCTION_INTERNAL ./gradlew :app-bootstrap:bootRun --args='--spring.profiles.active=prod'` | +| 이동한 두 테스트가 새 레인에서 실제로 통과하는지 | `./gradlew :adapter:inbound:graphql:systemTestLaneCheck --console=plain` | +| `graphqlStableTest` / `graphqlAdvancedTest` / `graphqlContractTest` 레인이 여전히 도는지, `CLAUDE.md:198-201`의 숫자(605/9/152)가 맞는지 | `./gradlew :adapter:inbound:graphql:graphqlStableTest --console=plain` 등. **`CLAUDE.md`의 숫자는 검증하지 않았다** | +| `verifyGraphQlApiSurface`가 현재 통과하는지 (스냅샷 `# types: 408` vs 실제 public 타입 408 — 수는 맞췄으나 태스크 구현은 안 읽음) | `./gradlew :adapter:inbound:graphql:verifyGraphQlApiSurface --console=plain` | +| `verifyGraphQlProductionJar`가 통과하는지 | `./gradlew :adapter:inbound:graphql:verifyGraphQlProductionJar --console=plain` | +| M7의 `graphQlMappingInspectionGate`가 정말 소비자가 없는지 (Spring이 어떤 경로로도 이 타입을 찾지 않는다는 가정) | `./gradlew :adapter:inbound:graphql:test --tests '*MappingInspection*'` + Spring GraphQL 2.0.5의 `SchemaMappingInspector` 통합 지점 확인 | + +**세운 가정**: +1. **전이 폐포 계산의 한계** — javadoc을 제거한 뒤 클래스 단순명의 단어 경계 매칭으로 + 참조를 셌다. 리플렉션·문자열 기반 로딩·SPI를 통한 간접 참조는 놓친다. + 이 leaf는 `Class.forName`을 `architecture/GraphQlResolverBoundaryRules.classesIn`에서만 + 쓰고 그건 패키지 이름 인자를 받으므로, 놓친 참조가 있을 가능성은 낮다고 본다. + **57%라는 숫자는 ±몇 %의 오차를 가정하고 읽어야 한다. 결론(절반 이상이 배선 밖)은 + 그 오차에 영향받지 않는다.** +2. `modules.json`에 `runtime_memberships` 필드가 없어서(구조상 `modules`와 + `composition_roots` 두 키뿐이고 후자는 이름 배열) composition root 멤버십은 + `app-bootstrap/build.gradle`의 project 의존으로 판정했다. +3. ~~읽지 못한 테스트 65개에 판정을 뒤집을 내용이 없다고 가정했다.~~ **해소됨.** + 테스트 99개 + testFixtures 18개를 전문으로 읽었고, 이 가정은 **부분적으로 틀렸다** — + 2절의 "자산인가 부채인가" 판정 근거가 바뀌었다(미검증 코드 → 검증된 부품 + 조합 0). + Critical/High/Medium/Low 발견 목록 자체는 바뀌지 않았다. diff --git a/docs/reviews/2026-09-18-techlead-review/05-persistence-jpa.md b/docs/reviews/2026-09-18-techlead-review/05-persistence-jpa.md new file mode 100644 index 00000000..1ae83e40 --- /dev/null +++ b/docs/reviews/2026-09-18-techlead-review/05-persistence-jpa.md @@ -0,0 +1,1550 @@ +# [영역] JPA/PostgreSQL 영속 어댑터 리뷰 + +- 스냅샷: 2026-09-18T11:50Z / HEAD 60b6a319 + 커밋 안 된 변경 224파일(tracked) + 175파일(untracked) +- 담당 leaf: `adapter-outbound-persistence-jpa` (`src/adapter/outbound/persistence-jpa`, gradle `:adapter:outbound:persistence-jpa`) +- **개정 2 (커버리지 보강)**: 1차에서 미독이었던 main 37파일 + 테스트 210파일을 전문 정독했다. + 그 결과 **§4.5 신설**(부품/조합 구분과 개수), **H4 재작성**(단발 회귀 → 네 leaf 패턴 + 원인 확정), + **K7 확정**(한계 3가지 명시), **H10 신규**(테넌트 무차별 CRUD 상속), **M16~M22 신규**, + **H5의 55P03 범위 정정**(체인이 두 벌이고 한 쪽만 구멍)이 추가/변경됐다. + +--- + +## 0. 최종 적용 기준 + +JPA leaf가 자기 AutoConfiguration과 real-PostgreSQL 계약을 소유한다. provider Bean graph를 bootstrap으로 +되돌리지 않는다. transaction/migration/locking/idempotency는 real PostgreSQL integration test로 검증한다. +이동한 test의 CI 공백은 readiness card 추가가 아니라 integration lane의 실제 CI caller 연결을 우선한다. +readiness/evidence registry는 외부 certification에 필요한 최소 범위만 남긴다. + +## 0-A. 2026-09-21 중간 재검증 + +**상태: JPA focused gate는 건강하지만 Build simplification 측면의 새 역행이 확인됐다.** + +재검증: + + ./gradlew :adapter:outbound:persistence-jpa:check :app-bootstrap:architectureCheck + # BUILD SUCCESSFUL + +JPA leaf는 자기 `AutoConfiguration.imports`를 갖고 있고 real-PostgreSQL test lane도 계속 분리되는 +방향이다. + +하지만 현재 워킹트리에 다음 build-tools 코드가 새로 생겼다. + +- `SetConfigParameterBindingResult` +- `SetConfigParameterBindingVerifier` +- `VerifySetConfigParameterBindingTask` +- `SetConfigParameterBindingVerifierTest` + +이 verifier는 Java source text에서 `set_config('...')`와 `?`를 찾는 source scanner다. 검증하려는 +보안 계약 자체는 유지해야 하지만 **Gradle resolution/task graph가 필요한 규칙이 아니다.** +`persistence-jpa`의 architecture/unit test가 직접 source/SQL contract를 검증하는 편이 이 리뷰의 +Build simplification 원칙에 맞다. + +따라서 이 항목은 “검증 삭제”가 아니라 **ownership 이동 후보**로 추가한다. + +## 0-B. 2026-09-23 재검증 + +**판정: 아직 더 봐야댐. 현재 leaf test가 red다.** + +현재 `:adapter:outbound:persistence-jpa:test`는 529개 중 2개가 실패한다. 두 실패는 모두 +`JpaModuleBoundaryTest`에서 발생한다. + +- production tree에는 `audit` package에 실제 class 3개가 있다. +- `auditing` 디렉터리는 존재하지만 production class는 0개다. +- 그런데 `DOWNSTREAM_OF_API`, `INDEPENDENT_CAPABILITIES`, `PACKAGE_CATALOG`은 여전히 + `auditing`을 실 capability로 요구한다. + +따라서 package split/rename 이동과 boundary catalog 변경이 원자적으로 끝나지 않았다. 이건 +ArchUnit을 완화할 문제가 아니라 **현재 의도한 package topology를 하나로 확정하고 test catalog와 +production tree를 동일한 모델로 맞춰야 하는 migration residue**다. + +추가로 bootstrap architecture gate에서 +`PersistenceJpaRootAutoConfiguration -> PersistenceJpaLeafReadyAutoConfiguration` 직접 참조가 잡힌다. +leaf-owned auto-configuration으로 ownership을 옮기는 방향 자체는 맞지만, composition root가 leaf 내부 +ready auto-config 타입을 annotation으로 직접 이름 짓는 순간 export surface를 다시 뚫는다. + +## 1. 커버리지 + +파일 626개(Java 584 + 비Java 42) **전량을 본문까지 읽었다.** (2차 보강 완료 — 1차 리뷰의 미독 127개를 모두 소화) + +**main 소스 356개 / 28,500줄 — 전문 정독 (356/356)** + +`api/**`(49) · `audit`(3) · `auditing`(3) · `autoconfigure`(5) · `cache`(5) · `config`(3) · `envers`(6) · +`experimental/**`(25) · `failure`(3) · `fileserver/**`(25) · `h2`(5) · `hibernate/**`(22) · +`idempotency/**`(7) · `liveevent/**`(3) · `lock`(3) · `migration`(8) · `observation`(6) · +`operation/**`(3) · `outbox/**`(6) · `postgresql/**`(68) · `querydsl`(3) · `security`(4) · +`springdata`(17) · `transaction`(29) · `notification/**`(전부, 엔티티 12 + Spring Data 인터페이스 11 + +store·crypto·config 포함). + +1차에서 "구조 스캔만" 했던 `notification/platform/` 37개(약 2,700줄)를 전문 정독했고, 그 결과 +새 발견 6건(M16~M21)과 **H10(테넌트 무차별 CRUD 상속 9건)** 을 §5에 추가했다. + +**테스트 소스 228개 / 29,209줄 — 전량 본문 정독 (228/228)** + +| 소스셋 | 파일 | 줄 | 상태 | +| --- | ---: | ---: | --- | +| `src/test` | 107 | 10,183 | 전문 정독 | +| `src/postgresqlIntegrationTest` | 78 | 15,746 | 전문 정독 | +| `src/testFixtures` | 40 | 3,012 | 전문 정독 | +| `src/jpaPlatformPerformanceTest` | 3 | 268 | 전문 정독 | + +이 정독의 결과가 §4.5(부품/조합 구분), K7 확정, H2·H4 근거 확정이다. + +**비Java 42개 — 전량 정독.** Flyway SQL 32개 전부(`db/migration/postgresql` 13 + `db/migration/jpa/**` 18 ++ `db/experimental-rls` 1), `META-INF/spring/...imports`, `build.gradle`, `CLAUDE.md`, `README.md`(관련 절), +통합테스트 리소스 SQL 4개는 경로만 확인. + +**관련 파일도 읽음:** `src/config/architecture/modules.json`, `src/config/jpa/release-registry.json`, +`src/config/jpa/readiness-cards.yaml`(앞부분), `src/app-bootstrap/.../config/{runtime,persistence,outbox,idempotency,capabilities}.yml`, +`application{,-local,-dev,-prod}.yml`, `app-bootstrap`의 JPA 조립 클래스 8개, +`src/build-tools/.../buildtools/jpa/{JpaSqlConstructionSafetyVerifier,VerifyJpaSqlConstructionSafetyTask,JpaQualificationPlugin,JpaEvidencePlugin}.java`, +`docs/superpowers/specs/2026-09-18-jpa-capability-composition-ownership.md`. + +**빌드는 실행하지 않았다**(브리프 규칙). 런타임 주장은 §9에 검증 명령과 함께 명시한다. + +--- + +## 2. 이 영역은 무엇을 하는가 + +README나 CLAUDE.md가 말하는 "JPA 프로덕션 플랫폼"과 **실제로 돌아가는 코드는 다른 물건이다.** 코드에서 +읽어낸 실제 책임은 세 덩어리다. + +**(a) 실제로 조립되고 돌아가는 어댑터 — 전체의 약 1/4** + +애플리케이션 port 구현체들이다. `SpringTransactionPort`(트랜잭션 경계), +`PersistenceExceptionTranslator`(SQLState→에러코드), `IdempotencyStoreAdapter`, +`OutboxStoreAdapter`+`OutboxReaper`, `DistributedLockPersistenceConfig`(SI JDBC 락), +`DomainContextAuditContextPort`. 여기에 옵션 capability 스위치 뒤의 `fileserver/**`(9개 store), +`notification/**`(15개 store)이 붙는다. + +**(b) fork 사용자를 위한 라이브러리 — 전체의 약 1/2, 현재 소비자 0** + +`springdata`(keyset 페이지네이션, safe sort, fetch plan, stream guard), `querydsl`, `cache`, +`envers`, `hibernate/{batch,bulk,stateless}`, `postgresql/{copy,json,range,array,write,lock}`, +`experimental/**`(멀티테넌시 4종, 리드 레플리카, 호환성 레인), `migration`의 절반. +이 클래스들은 **`main` 소스 어디에서도 생성되지 않는다.** 실측: + +``` +FlywayValidationGate / ConcurrentIndexMigrationInspector / FailedConcurrentIndexRecovery / +NonTransactionalMigrationPolicy / SchemaVersionSnapshot / HibernateCacheGuard / +HibernateEnversHistoryReader / ConsistencyAwareDataSourceRouter / RlsPolicyVerifier / +SchemaTenantMigrationOrchestrator / TenantAwareRepositoryGuard / QuerydslJpaSupport / +RegisteredPostgreSqlUpsertExecutor / PostgreSqlWorkClaimExecutor / HibernateJpaBatchExecutor / +HibernateBulkDmlExecutor / HibernateStatelessSessionRunner / JpaStreamExecutor / +FetchPlanApplier / JpaBatchProfileRegistry / TransactionProfileRegistry +→ main 소스 참조 수 = 0 +``` + +나쁜 게 아니다. 템플릿이 "쓸 수 있게 미리 깔아둔 도구상자"라고 이해하면 맞다. 다만 **문서는 이걸 +"플랫폼이 제공하는 Stable capability"라고 부른다**(§5 M11 참조). + +**(c) PostgreSQL 전용 후보 구현 — 조립 안 됨, 통합테스트로만 검증** + +`PostgreSqlOwnerSafeIdempotencyStore`(662줄), `PostgreSqlSameStoreInboxAdapter`(597줄), +`PostgreSqlImmutableOutboxAppendAdapter`(390줄), `PostgreSqlPollingDeliveryAdapter`(543줄). +전부 스프링 stereotype이 없고, `CandidateAdapterCompositionTest`가 **stereotype이 붙는 것을 금지**한다 +(`src/test/.../CandidateAdapterCompositionTest.java:38-50`). 네 개 중 idempotency만 조립 경로가 있다 +(`autoconfigure/PostgreSqlIdempotencyStoreConfig.java`). 나머지 셋은 "구현은 있고 선택 경로는 아직 없다". + +**그리고 가장 중요한 구조적 사실:** + +> **이 leaf에는 JPA 연관관계가 하나도 없다.** `@OneToMany`/`@ManyToOne`/`@OneToOne`/`@ManyToMany`/ +> `@ElementCollection` — main 소스 356파일 전수 grep 결과 **0건**. + +모든 엔티티가 평면 row이고, FK는 raw `UUID`/`String` 컬럼이다. 동시성 제어는 Hibernate의 낙관적 락이 +아니라 **`WHERE`에 state/version/owner를 다시 쓰는 조건부 UPDATE**로 한다 +(예: `fileserver/repository/FileTransitionRepository.java:22-38`, +`operation/DurableOperationJpaRepository.java:43-69`, +`postgresql/idempotency/IdempotencyTransitionGateway.java:23-40`). + +즉 **이건 JPA 애노테이션을 입은 손수 작성 SQL 레이어다.** 이게 §4의 "고전적 지뢰" 판정 전부를 지배한다. + +--- + +## 3. 런타임 토글 판정 — 꺼지면 정말 꺼지는가 + +### 마스터 스위치 + +`ca-skeleton.persistence-jpa.enabled` (`config/persistence.yml:13`, 기본 `${APP_PERSISTENCE_JPA_ENABLED:false}`). + +### 꺼졌을 때 확실히 사라지는 것 (OK) + +| 대상 | 근거 | +|---|---| +| DataSource·Hikari 풀·Flyway·EntityManagerFactory 자체 | `app-bootstrap/.../jpa/JpaOffAutoConfigurationImportFilter.java:24-50` — Boot의 관계형 auto-config 10개를 후보 집합에서 제거 | +| 엔티티 스캔 / Spring Data 리포지토리 / 8개 스캔 컴포넌트 | `autoconfigure/PersistenceJpaAutoConfiguration.java:14-25` + `config/JpaAdapterComponentsConfig.java:59-67` | +| 벤더 SPI 4종(claim repo, sqlstate mapping, timeout configurer) | `postgresql/PostgreSqlPersistenceConfig.java:38-42`, `h2/H2PersistenceConfig.java:41-45` — 둘 다 `PersistenceJpaAutoConfiguration` `@Import` 아래 | +| fileserver 9 store + notification 15 store | 각자 `@ConditionalOnProperty(app.fileserver-platform.enabled)` / `(ca-skeleton.notification.platform.enabled)` + 별도 `@EntityScan` (`fileserver/FileserverJpaPersistenceConfig.java:37-40`, `notification/NotificationJpaPersistenceConfig.java:22-27`) | +| `CanonicalOutboxAppendAdapter` | `outbox/CanonicalOutboxAppendAdapter.java:24-27` — 두 프로퍼티 AND 조건 | +| 마이그레이션 시작 러너·prod Flyway 검증기 | `app-bootstrap/.../MigrationStartupConfig.java:20-23` | + +### 꺼졌는데도 남는 것 (NOT OK) + +| 대상 | 무엇이 남나 | 근거 | +|---|---|---| +| **`OutboxReaper`** | **@Scheduled 스레드 + 10분마다 `DELETE FROM outbox_event`** | `outbox/OutboxReaper.java:16-17,37-38` — `@Component`에 조건 애노테이션 **없음**. `JpaAdapterComponentsConfig.java:65`가 `...persistence.outbox`를 스캔 | +| **`OutboxStoreAdapter`** | 빈 1개 + `OutboxClaimRepository` 의존 | `outbox/OutboxStoreAdapter.java:39` — 조건 없음 | +| `HibernateProviderPolicy` | 빈 1개 (+ `Version.getVersionString()` 클래스패스 조회) | `autoconfigure/PersistenceJpaRuntimeConfig.java:26,31-33` | +| `PostgreSqlRuntimeRoleVerifier` | 빈 1개 | 같은 파일 `:37-39` | +| `RetryEventListener`(noop) | 빈 1개 | 같은 파일 `:43-45` | + +`OutboxReaper`/`OutboxStoreAdapter`는 **JPA가 켜져 있고 `ca-skeleton.outbox.enabled=false`일 때**도 +남는다. 그런데 `config/outbox.yml:15-17`은 이렇게 쓰여 있다: + +> "Off means no outbox settings, validator, leader token, metrics, **or store binding at all**" + +코드가 사실이고 문서가 결함이다. 같은 패키지의 `CanonicalOutboxAppendAdapter`는 조건을 달고 있으므로 +설계 의도가 아니라 누락이다. → **C1** + +`PersistenceJpaRuntimeConfig` 3개는 `@ConditionalOnClass(javax.sql.DataSource.class)`(JDK 클래스라 항상 참) ++ `@ConditionalOnProperty(app.jpa-platform.addons-enabled, matchIfMissing=true)`(어디에도 설정 없음)만 +걸려 있고 **JPA 마스터 스위치가 없다.** → **H4** + +### 벤더 선택자 판정 (브리프 질문 1) + +**(a) "프로퍼티가 프로파일보다 낫다"는 논증은 타당한가?** + +논증 자체는 타당하다. `config/PersistenceVendorSettings.java:8-11`이 말하는 대로, 프로파일 이름은 +배포 환경의 이름이지 데이터스토어의 이름이 아니다. `dev1`/`dev2`/`qa-eu` 같은 프로파일을 쓰는 fork가 +벤더를 바꾸려고 프로파일 이름을 바꿔야 한다면 그게 결함이다. + +**반론:** 벤더가 바뀌면 SQL 방언, 마이그레이션 트리, SQLState 매핑, 타임아웃 적용 방식이 전부 바뀐다. +그만큼 큰 결정을 프로파일보다 조용한 프로퍼티 하나에 걸어두면 "실수로 바꾸기" 쉬워진다. +**재반박:** 이 저장소는 그 반론에 이미 답했다 — `PersistenceVendorProdSafetyValidator`가 prod에서 +셀렉터와 JDBC URL 양쪽을 검사한다(`app-bootstrap/.../PersistenceVendorProdSafetyValidator.java:55-75`). +설계는 맞다. **문제는 구현이 문서가 약속한 fail-closed를 하지 않는다는 것**(→ H1)이다. + +**(b) h2와 postgresql이 같은 매핑 코드를 공유하는가?** + +**엔티티/매퍼는 100% 공유하고, 벤더 SPI 4종만 갈라진다.** 갈라지는 지점과 그 결과: + +| 지점 | PostgreSQL | H2 | 결과 | +|---|---|---|---| +| outbox claim SQL | `postgresql/PostgreSqlOutboxClaimRepository.java:15-29` | `h2/H2OutboxClaimRepository.java:24-38` — **문자 단위 동일** | 동등 | +| idempotency claim | `INSERT ... ON CONFLICT ... DO UPDATE ... RETURNING` (`postgresql/PostgreSqlIdempotencyClaimRepository.java:14-34`) | `MERGE ... USING` (`h2/H2IdempotencyClaimRepository.java:33-63`) | 의미는 맞춰놨으나 동시성 semantics는 다름 | +| 타임아웃 적용 | `set_config(..., true)` = **트랜잭션 로컬** (`postgresql/PostgreSqlLocalTimeoutConfigurer.java:12-14`) | `SET QUERY_TIMEOUT` = **세션 스코프** (`h2/H2LocalTimeoutConfigurer.java:32-33`) | 풀 커넥션에 값이 남음(주석 `:17-21`이 인정) | +| idle-in-transaction 가드 | 있음 | **없음** (`h2/H2LocalTimeoutConfigurer.java:20-23`) | H2에서 유휴 트랜잭션 무한 | +| **`VendorFailureTranslator`** | 등록함 (`postgresql/PostgreSqlPersistenceConfig.java:84-89`) | **등록 안 함** | **H2에서는 40001/40P01이 분류되지 않아 재시도가 절대 일어나지 않는다** → H5 | + +마지막 항목은 이 저장소 자신의 테스트가 증명한다: +`src/test/.../autoconfigure/PersistenceJpaRuntimeConfigTest.java:100-116` +(`noVendorTranslatorLeavesFailureUnclassified` — 40001이 raw `TransientDataAccessResourceException`으로 +남는 것을 **기대 동작으로 단언**). + +**H2에서 통과한 테스트가 PostgreSQL에서 깨질 수 있는 지점** — 실제로 발견된 두 건이 이미 코드에 기록돼 있다: + +- `db/migration/postgresql/V10__idempotency_request_hash_varchar.sql:6-13` — + `request_hash char(64)` vs 엔티티 `length=64`(varchar). "H2 create-drop은 엔티티대로 스키마를 만드니 + 절대 어긋날 수 없다"고 명시. +- `config/PersistenceJpaConfig.java:24-26` — `fs_cleanup_item` 누락. "H2에서는 보이지 않았고 실제 + PostgreSQL + 실제 마이그레이션 이력이 있어야 보였다." + +즉 **이 위험은 가설이 아니라 이 저장소에서 이미 두 번 현실화됐다.** + +**(c) "local은 H2 + create-drop이라 마이그레이션이 일상 개발에서 한 번도 안 돌아간다"** + +**이 전제는 스냅샷 시점에 이미 틀렸다.** `application-local.yml`은 지금: + +- `:56` `url: ${APP_DATASOURCE_URL:jdbc:postgresql://localhost:5433/ca_skeleton}` — **기본이 PostgreSQL** +- `:76` `flyway.enabled: ${APP_FLYWAY_ENABLED:true}` — **Flyway 켜짐** +- `:84` `ddl-auto: ${APP_DATASOURCE_DDL_AUTO:validate}` — **validate** +- `:156` `vendor: ${APP_PERSISTENCE_VENDOR:postgresql}` + +H2 경로는 별도 Gradle 태스크로 옮겨졌다(`app-bootstrap/build.gradle:280-298`, `bootRunH2`가 +`APP_PERSISTENCE_VENDOR=h2` + `APP_FLYWAY_ENABLED=false` + `APP_DATASOURCE_DDL_AUTO=create-drop`을 주입). + +**판정: 이건 옳은 수정이고, 이 저장소가 스스로 두 번 데인 뒤 내린 결정이다(→ Keep K3).** +단, 같은 파일 `:22-23`에 옛 문장이 남아 있다: "What it does not: migrations and vendor behaviour — +the schema here comes from the JPA entities". 한 파일 안에서 22행과 56/76/84행이 서로를 부정한다. +leaf의 `CLAUDE.md:118-124`도 여전히 "`application-local.yml` selects H2"라고 쓴다 → M3. + +**남은 위험:** `bootRunH2`를 쓰는 개발자는 여전히 마이그레이션·벤더 semantics·재시도(H5)를 하나도 안 +거친다. 방어 장치는 `postgresqlIntegrationTest` 78개 레인 + `postgresqlSecurityBaselineIntegrationTest` +등이고, 이건 `check`가 아니라 별도 레인이다. + +--- + +## 4. 구조 판정 + +| 축 | 판정 | 근거 | +|---|---|---| +| 의존 방향 (modules.json 대조) | **OK** | `modules.json` allowed = `[domain-core, application-core, shared-contract]`. `build.gradle:33-34`는 `application-core`, `shared-contract`만 `implementation`으로 선언(domain-core는 추이). 금지 대상(`app-bootstrap`, 다른 adapter) import 0건 — `docs/superpowers/specs/2026-09-18-jpa-capability-composition-ownership.md:52` "persistence-jpa production imports from app-bootstrap: 0"와 일치 | +| 경계 누수 (DTO·entity·framework 타입) | **OK** | entity는 전부 `...persistence.*.entity` 또는 `...notification.platform` 패키지 내부에서만 쓰인다. port 구현체가 반환하는 건 전부 application 레코드(`FileRecord`, `IdempotencyRecord`, `DurableOperation`, `NotificationRequestRecord` …). inbound DTO import 0건. HARD-STOP #2/#3 위반 없음 | +| 비즈니스 규칙 위치 | **OK (경계 사례 1건)** | 매퍼는 순수 번역이다 — `fileserver/FileEntityMapper.java:22-25`, `idempotency/mapper/IdempotencyRecordEntityMapper.java:10-13`, `notification/platform/NotificationRecordMapper.java:28-33`. 상태 전이 규칙은 application이 소유(`JpaFileMetadataStore.java:88`이 `stateMachine.requireTransition`을 먼저 호출). 경계 사례: `NotificationRecordMapper.protectPayload/revealPayload`(`:137-164`)가 암복호화를 매퍼에 둔다 — "at rest"의 정의상 저장 경계가 맞고 주석이 이유를 밝히므로 위반으로 보지 않는다. HARD-STOP #4 위반 없음 | +| 트랜잭션 경계 선언 위치 | **application (원칙) / 어댑터 3곳 예외** | 원칙은 `application-core`의 `PolicyTransactionPort`이고 이 leaf가 `SpringTransactionPort`로 구현한다(`transaction/SpringTransactionPort.java:31`). 어댑터들은 `@Transactional`을 안 붙고 caller 경계에 참여한다(`outbox/OutboxStoreAdapter.java:35-36`, `fileserver/JpaFileMetadataStore.java:33-34`). **예외: `operation/DurableOperationStoreAdapter.java`(9개 메서드), `liveevent/JpaLiveEventReplayAdapter.java`(4개)가 자체 `@Transactional`을 단다** → M7 | +| 테스트 전략 적합성 | **OK, 다만 게이트 위치가 문제** | 단위 107 + fixture 40 + **실제 PostgreSQL 통합 78** + 성능 3. 계약 테스트가 진짜 DB를 쓴다는 점이 이 영역에서 가장 큰 자산이다. 문제는 이게 `check`가 아니라 별도 레인이라 일상 빌드에서 안 돈다는 것과, `verifyJpaSqlConstructionSafety`가 어느 aggregate에도 안 걸려 있다는 것(→ H9) | + +### JPA의 고전적 지뢰 (브리프 질문 4) — 각각 판정 + +| 지뢰 | 판정 | 근거 | +|---|---|---| +| **N+1** | **구조적으로 발생 불가 (이 leaf 한정)** | 연관관계 0건이므로 lazy 컬렉션이 없다. 그래서 `@EntityGraph`/`join fetch`/`@BatchSize`도 0건. `springdata/EntityGraphCatalog`·`FetchPlanApplier`는 **fork 사용자의 엔티티용 도구**지 이 leaf가 쓰는 장치가 아니다. 예외 1건: `envers/HibernateEnversHistoryReader.java:42-46`이 `getRevisions()` 후 리비전마다 `reader.find()`를 돌려 1+N. Advanced opt-in이고 소비자 0이라 Medium(M9) | +| **낙관적 락 / 버전 컬럼** | **구현됨, 단 메커니즘이 Hibernate가 아니다** | `@Version`은 8개 엔티티에 있으나 실제 제어는 `WHERE ... AND version = :expectedVersion` + `SET version = version + 1`을 손으로 쓰는 조건부 UPDATE다(`fileserver/repository/FileTransitionRepository.java:33,37`, `notification/platform/RecipientClaimSql.java:41-45`). `@Version`은 주로 `ddl-auto=validate`가 컬럼을 보게 하려고 존재한다. 네이티브 UPDATE가 version을 손으로 올리는 이유는 `RecipientClaimSql.java:42-45`에 정확히 설명돼 있다 | +| **비관적 락** | **JPA로는 없음. 네이티브 SQL로 있음** | `@Lock`/`LockModeType` 사용 0건(유일한 등장은 아무도 안 쓰는 값 타입 `postgresql/lock/PostgreSqlLockOptions`). 실제 락은 전부 손으로 쓴 `FOR UPDATE [SKIP LOCKED]` / `FOR SHARE`다(`PostgreSqlOutboxClaimRepository:28`, `DurableOperationJpaRepository:61`, `IdempotencyRowMapper:40`, `PostgreSqlImmutableOutboxAppendAdapter:67`, `RecipientClaimSql:34`) | +| **트랜잭션 경계 선언 위치** | **application. Clean Architecture상 옳다** | 위 표 참조. 게다가 세 어댑터는 경계가 없으면 **거부한다** — `PostgreSqlSameStoreInboxAdapter.java:203-210`, `PostgreSqlImmutableOutboxAppendAdapter.java:121-133`, `postgresql/idempotency/IdempotencyCapabilityGuard.java:92-108`(이건 `hasResource(dataSource)`까지 확인해 "다른 데이터소스의 트랜잭션"을 걸러낸다), `HibernateJpaBatchExecutor.java:39-42`, `springdata/JpaStreamScope.java:27-38`. **판정: 설계로도 옳고 강제도 있다.** 다만 강제가 전부는 아니다(→ H7) | +| **OSIV** | **끔. 이중으로 강제** | `application.yml:168` `open-in-view: ${APP_DATASOURCE_OPEN_IN_VIEW:false}`, `application-local.yml:86` `open-in-view: false`. 강제: `app-bootstrap/.../JpaDangerousConfigurationGuard.java:50-59`가 local-convenience 프로파일 외에서 `true`면 기동 실패. **왜 문제인가**는 같은 파일 `:12-17`에 정확히 쓰여 있다 — 뷰 렌더링 중 lazy 접근이 프레젠테이션 계층에서 쿼리를 날리고, 에러 없이 응답 row당 쿼리 1개가 나간다 | +| **커넥션 풀 env 조정** | **부분** | 조정 가능: `APP_DATASOURCE_POOL_MAX_SIZE`(기본 10), `_MIN_IDLE`(2), `_CONNECTION_TIMEOUT`(5000ms), `_IDLE_TIMEOUT`, `_MAX_LIFETIME`. **하드코딩(env 없음): `keepalive-time: 120000`, `leak-detection-threshold: 30000`, `validation-timeout: 3000`, `initialization-fail-timeout: 1`** (`application.yml:85,93,102,111`) — 주석이 전부 "env 키 등록은 다른 브랜치 소관"이라고 미뤄놨다. 기본값 자체는 합리적이다(`connection-timeout` 5s fail-fast, `validation-timeout` < `connection-timeout` 제약을 `HikariPoolConstraintValidator`가 기동 시 검사). `minimum-idle=2` vs 고정 크기 권고 불일치는 `application.yml:53-55`가 스스로 `MIN_IDLE_POLICY_DRIFT`로 기록해뒀다 | +| **LazyInitializationException 구조적 방지** | **구조적으로 발생 불가 + 별도 장치 있음** | lazy 연관 자체가 없다. 추가로 OSIV 강제 off, `JpaStreamScope.requireActiveReadOnly()`가 스트림 커서를 트랜잭션 밖으로 못 내보내게 한다(`springdata/JpaStreamScope.java:27-38`), `JpaStreamExecutor`는 스트림을 **반환하지 않고** try-with-resources 안에서만 소비한다(`springdata/JpaStreamExecutor.java:52-86`) | +| **JDBC 배치** | **없음** | `hibernate.jdbc.batch_size`/`order_inserts`/`order_updates`/`default_batch_fetch_size`를 설정하는 곳이 `src/**` 전체에서 **production 소스에는 0건**(통합테스트 fixture `JpaPlatformEntityManagerSupport.java:71-73`에만 있음). `HibernateJpaBatchExecutor`는 존재하나 소비자 0이고, 쓰려면 `hibernate.generate_statistics=true`가 필요한데(`hibernate/HibernateStatisticsCollector.java:49-54`가 없으면 throw) 그 설정도 어디에도 없다 → M12 | + +--- + +## 4.5 테스트 29,209줄을 '부품 검증'과 '조합 검증'으로 갈라 세기 + +이 영역의 Critical·High 중 C1·H2·H4는 전부 **조합 결함**이다 — 클래스의 동작은 옳고, 그 클래스가 +스프링 컨텍스트에 *어떻게 등록되는가*가 틀렸다. 테스트 29,209줄이 이걸 한 줄도 못 잡았다. +왜 못 잡는지는 추측이 아니라 테스트 본문에 적혀 있다. + +### 개수 + +| 구분 | 파일 수 | 근거 | +| --- | ---: | --- | +| 테스트 파일 총계 | **228** | test 107 / postgresqlIntegrationTest 78 / testFixtures 40 / perf 3 | +| 스프링 컨텍스트를 한 번이라도 띄우는 파일 | **13** | `ApplicationContextRunner` 8(test) + `AnnotationConfigApplicationContext` 5(integration) | +| 그중 **실제 auto-config 등록 경로**(`AutoConfigurations.of`)를 타는 파일 | **2** | `autoconfigure/PersistenceJpaAutoConfigurationTest`, `autoconfigure/PersistenceJpaRuntimeConfigTest` | +| 설정 클래스를 **직접 주입**해 등록 단계를 건너뛰는 파일 | **11** | `withUserConfiguration` / `withBean(` / `@Import(` / `ctx.register(` / `registerBean(` | +| `@SpringBootTest` / `SpringApplicationBuilder` / `@DataJpaTest` / `@JdbcTest` | **0** | 네 소스셋 전부 0 | +| 컨텍스트를 아예 안 띄우는 파일 | **215** | 나머지 | + +통합테스트 78개는 **전부** 컨텍스트 없이 손으로 부트스트랩한다: `new JdbcTemplate` 53파일, +`PostgreSQLContainer` 14, `HikariConfig` 12, `DataSourceTransactionManager` 12, +`JpaTransactionManager` 8, `LocalContainerEntityManagerFactoryBean` 5, `DriverManager.getConnection` 3. + +**즉 조립 단계를 검증 대상으로 삼는 파일은 228개 중 2개다.** 나머지 226개는 전부 부품 검증이다. +(부품 검증의 품질 자체는 높다 — §6 Keep 참조. 문제는 커버 대상이 다르다는 것이다.) + +### 왜 못 잡는가 — 테스트 본문이 직접 말한다 + +조립을 우회한다는 사실이 **주석으로 적혀 있는** 곳이 5군데다. 즉 우연이 아니라 의도된 설계다. + +1. `src/postgresqlIntegrationTest/.../readiness/LegacyOutboxIntegrationSupport.java:128` + ```java + // OutboxStoreAdapter: @Repository — registered manually (no component scan). + ``` + → H2가 말하는 "어떤 스캔에도 안 걸린다"를 테스트 하네스가 **알고 손으로 우회한다.** +2. `src/postgresqlIntegrationTest/.../readiness/PostgreSqlLegacyOutboxRowLifecycleIntegrationTest.java:670-677` + ```java + // OutboxReaper.reap() uses @Transactional which only works as a Spring proxy. + OutboxReaper reaper = new OutboxReaper(repo, clock, Duration.ofSeconds(1)); + // @Transactional is not active on a manually-constructed bean; run within tx. + int purged = tx.inWrite(() -> reaper.reap()); + ``` + → 리퍼의 **유일한** 통합테스트가 `new`로 만들고 트랜잭션을 손으로 감싼다. 그래서 `@Component`도, + `@Scheduled`도, 조건 애노테이션 부재(=C1)도 이 테스트의 시야 밖이다. +3. `src/postgresqlIntegrationTest/.../readiness/FileserverJpaTestContext.java:27` + "Boot auto-configuration is deliberately not used" + `:38-42`에 프로덕션과 **다른** 자체 + `@ComponentScan(regex ".*fileserver\.Jpa.*", useDefaultFilters=false)`. +4. `src/postgresqlIntegrationTest/.../readiness/PostgreSqlRecipientLeaseFencingIntegrationTest.java:227` + "A migrated database plus the real repository, built without a Spring context." +5. `src/test/.../liveevent/JpaLiveEventReplayAdapterActivationTest.java:60` — `@Import(JpaLiveEventReplayAdapter.class)`. + 이름이 "Activation"인데 어댑터를 직접 import한다. H2(라이브이벤트 어댑터가 어떤 스캔에도 안 걸림)를 + 구조적으로 볼 수 없다. + +같은 모양의 자기모순이 두 건 더 있다. + +- `src/test/.../postgresql/PostgreSqlVendorFailureTranslatorRegistrationTest.java` — 클래스 이름은 + *Registration*Test이고 javadoc `:27`은 *"Nothing registered a VendorFailureTranslator"* 를 회귀 + 대상으로 적어놨는데, 본문 `:40`은 `new PostgreSqlPersistenceConfig()`로 설정 객체를 직접 만들고 + 팩토리 메서드를 호출한다. **등록 여부는 이 테스트가 볼 수 없는 유일한 것이다.** +- `src/test/.../config/PersistenceVendorSelectionTest.java:91-93` — 테스트가 스스로 + `@Configuration @EnableConfigurationProperties(PersistenceVendorSettings.class)`를 정의해서 넣는다. + 프로덕션에 없는 바로 그 등록이다(→ H1). 그래서 "알 수 없는 vendor는 기동 실패"가 테스트에서는 + 참이고 프로덕션에서는 거짓이다. +- `src/test/.../lock/DistributedLockPersistenceConfigTest.java:19` — `withUserConfiguration( + DistributedLockPersistenceConfig.class)`. 이 클래스는 `config/JpaAdapterComponentsConfig.java:45`가 + 스스로 *"was registered by nothing but a test calling `ctx.register(...)`"* 라고 기록한 과거 사고의 + 당사자다. 프로덕션은 고쳤지만 **테스트는 여전히 같은 우회를 쓰므로, 같은 회귀가 재발해도 녹색이다.** + +리포지토리 자신이 이 구분을 이미 말로 정리해둔 곳도 있다 — +`src/test/.../experimental/ExperimentalEntryConsentTest.java` javadoc: +*"the gate's unit tests cannot see that difference because they always ask"*, +`src/test/.../transaction/PersistenceFailureTranslatorChainTest.java` javadoc: +*"Every unit fixture passed, because each threw an exception that had already been translated by hand."* +개념은 있다. 스프링 등록에는 적용이 안 됐을 뿐이다. + +### 구조적 비대칭 — "등록되면 안 된다"는 3개, "등록돼야 한다"는 0개 + +| 방향 | 테스트 | 메커니즘 | +| --- | --- | --- | +| 등록되면 **안 된다** | `CandidateAdapterCompositionTest:38-50` | 리플렉션으로 `@Repository/@Component/@Service` 부재 단언 | +| 등록되면 **안 된다** | `auditing/AuditingCandidateStatusTest:38-48` | 동일 | +| 스캔되면 **안 된다** | `config/PersistenceEntityScanCoverageTest:49-69` | `@EntityScan` basePackages에 opt-in 패키지 부재 단언 | +| 등록**돼야** 한다 | *(없음)* | — | + +부정 방향은 리플렉션만으로 확실히 검사되고 실제로 잘 돌고 있다. 같은 기법으로 긍정 방향을 쓰는 게 +가능한데 아무도 안 썼다. C1·H2가 정확히 그 빈칸에 들어 있다. + +### 유일한 예외 — 이 leaf에만 있는 `.imports` 짝 검사 + +`src/test/.../autoconfigure/PersistenceJpaAutoConfigurationTest.java:62-72`는 +`META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports` 파일을 **열어서** +두 클래스 이름이 들어 있는지 단언한다. 조정자가 지적한 "스캔 제외 정규식과 `.imports`가 짝이 맞는지 +검사하는 게 없다"는 문제의, 절반짜리지만 **실재하는 해법**이다. redis/httpclient가 이걸 갖고 있었다면 +두 건 다 잡혔다. 이 패턴을 공통 규칙으로 올리는 게 H4의 실질 수정안이다. + +### 권고 (조립 게이트 3줄) + +`CandidateAdapterCompositionTest`와 같은 파일에, 같은 기법으로 넣으면 된다. 컨텍스트 불필요: + +1. **스테레오타입 완전성** — `main` 클래스그래프에서 `@Component/@Repository/@Service`를 단 클래스를 + 모두 모아, 각각이 `JpaAdapterComponentsConfig`의 `@ComponentScan` basePackages 중 하나에 + 속하는지 검사. 현재 `operation`·`liveevent` 2건이 걸린다(H2). +2. **마스터 스위치 도달성** — `.imports`에 등록된 `@AutoConfiguration` 클래스가 전부 + `ca-skeleton.persistence-jpa.enabled` 조건 아래에 있는지(직접이든 `after` 체인이든) 검사. + 현재 `PersistenceJpaRuntimeConfig` 1건이 걸린다(H4). +3. **스캔 제외 ↔ `.imports` 짝** — 이건 leaf가 아니라 `app-bootstrap`에 있어야 한다. + `CaSkeletonApplication`의 제외 정규식에 잡히는 패키지 집합과 `.imports`에 실린 클래스의 패키지 + 집합을 비교해, 한쪽에만 있는 패키지를 보고. httpclient(제외 누락 → 누수)와 redis(`.imports` 누락 + → 사망)가 걸린다. + +--- + +## 5. 발견 + +### Critical + +#### C1. 아웃박스를 꺼도 리퍼 스레드와 주기적 DELETE가 계속 돈다 + +- **현상**: `ca-skeleton.outbox.enabled=false`(기본값)인 배포에서도, JPA만 켜져 있으면 + `OutboxReaper` 빈이 생성되고 `@Scheduled(fixedDelay=PT10M)`가 등록되어 10분마다 + `DELETE FROM outbox_event WHERE status='PUBLISHED' AND occurred_at < ?`를 실행한다. + 같은 조건에서 `OutboxStoreAdapter`도 빈으로 남는다. +- **근거**: + - `src/main/java/.../outbox/OutboxReaper.java:16-17` — `@Component`만 있고 `@ConditionalOnProperty` 없음 + - `src/main/java/.../outbox/OutboxReaper.java:37-38` — `@Scheduled` + `@Transactional` + - `src/main/java/.../outbox/OutboxStoreAdapter.java:39` — `@Repository`만 있고 조건 없음 + - `src/main/java/.../config/JpaAdapterComponentsConfig.java:65` — `...persistence.outbox` 패키지를 스캔 + - `src/app-bootstrap/src/main/resources/config/outbox.yml:15-17` — "Off means no outbox settings, + validator, leader token, metrics, **or store binding at all**" + - `src/test/.../outbox/OutboxReaperWiringTest.java:80-87` — 아무 프로퍼티 없이 빈이 생성됨을 단언 + - 대조군: `src/main/java/.../outbox/CanonicalOutboxAppendAdapter.java:24-27`은 같은 패키지에서 + 두 프로퍼티 AND 조건을 정확히 달고 있고, `src/main/java/.../idempotency/IdempotencyReaper.java:16-19`도 + `@ConditionalOnProperty`를 단다. **즉 설계가 아니라 누락이다.** +- **왜 문제인가**: 브리프의 Critical 정의("꺼진 기술이 빈·스레드·커넥션·필수 env를 요구")에 정면으로 + 해당한다. 구체 실패 시나리오: 아웃박스를 안 쓰기로 한 fork가 `outbox_event` 테이블을 유지하는데 + (V3가 무조건 만든다), 리퍼가 매 10분 쓰기 트랜잭션을 열고 인덱스 스캔을 돌린다. 나아가 fork가 + `outbox_event`를 다른 용도로 재활용하면 **자기가 켜지도 않은 기능이 데이터를 삭제한다.** +- **수정 방향**: `OutboxReaper`와 `OutboxStoreAdapter`에 + `@ConditionalOnProperty(prefix="ca-skeleton.outbox", name="enabled", havingValue="true")`를 붙인다. + 리퍼는 추가로 `relay-enabled`가 아니라 `enabled`에 걸어야 한다(retention purge는 relay와 별개). + `OutboxReaperWiringTest`도 함께 고쳐야 한다 — 현재 테스트가 잘못된 동작을 잠그고 있다. +- **2차 정독 보강 — 리퍼를 건드리는 테스트가 3개 있는데 셋 다 이 결함을 볼 수 없다**: + 1. `src/test/.../outbox/OutboxReaperTest.java:24-44` — mock 리포지토리에 `new OutboxReaper(...)`. + 컷오프 계산과 반환값만 본다. 스프링 전혀 없음. + 2. `src/test/.../outbox/OutboxReaperWiringTest.java:67-87` — `ApplicationContextRunner`를 쓰지만 + `.withBean(OutboxReaper.class)`로 **빈을 직접 넣는다.** 그래서 "프로퍼티가 하나도 없을 때 + 빈이 생성된다"(`:80-87`)를 **정답으로 단언**한다. `@Component` 등록 경로도, 조건 부재도 + 이 테스트의 관측 대상이 아니다. + 3. `postgresqlIntegrationTest/.../readiness/PostgreSqlLegacyOutboxRowLifecycleIntegrationTest.java:670-677` + — 유일한 실제 DB 테스트인데 `new OutboxReaper(...)`로 만들고 `@Transactional`이 없다는 걸 + 주석으로 인정하며 트랜잭션을 손으로 감싼다. + + 즉 **`@Component` + `@Scheduled` + 조건 없음**이라는 세 애노테이션의 조합을 관측하는 테스트가 + 0개다. 리플렉션 한 줄이면 잡힌다(§4.5 권고 1). +- **반론과 재반박**: "리퍼는 PUBLISHED row만 지우니 무해하다"—아웃박스가 꺼진 배포에 PUBLISHED row가 + 있다면 그건 과거에 켰다가 끈 것이고, 그때 남은 증거를 조용히 지우는 게 더 나쁘다. 또 "무해함"은 + 스레드와 주기적 트랜잭션의 존재 자체를 정당화하지 못한다 — 이 프로젝트의 존재 이유가 "쓰지 않는 + 기술은 꺼진 상태로 아무 비용도 물리지 않는다"이기 때문이다. + +--- + +### High + +#### H1. 벤더 셀렉터의 fail-closed는 구현돼 있지 않다 (문서가 사실과 다름) + +- **현상**: `PersistenceVendorSettings`가 **프로덕션에서 `@ConfigurationProperties` 빈으로 등록되지 않는다.** + `ca-skeleton.persistence.vendor=postgres`(오타) 같은 값을 주면 예외 대신 **두 벤더 설정이 모두 꺼진다.** +- **근거**: + - `src/main/java/.../config/PersistenceVendorSettings.java:13-17` — "Binding to an enum is what makes + an unknown vendor a startup failure. With a raw string the two `@ConditionalOnProperty` vendor + configurations would both stay off, and the first missing SPI bean would surface as a + `NoSuchBeanDefinitionException` naming `OutboxClaimRepository`" + - `src/adapter/outbound/persistence-jpa/CLAUDE.md:121-122` — 같은 주장 반복 + - `src/app-bootstrap/.../CaSkeletonApplication.java:58-78` — `@ConfigurationPropertiesScan` + `basePackages`에 `dev.caskeleton.adapter.outbound.persistence`가 **없다** + - `main` 소스 전체에 `@EnableConfigurationProperties(PersistenceVendorSettings.class)` **0건** + (유일한 등장은 테스트 `src/test/.../config/PersistenceVendorSelectionTest.java:92`) + - 프로덕션이 실제로 읽는 경로는 raw 문자열이다: + `app-bootstrap/.../PersistenceJpaRootAutoConfiguration.java:50` + (`environment.getProperty(VENDOR_PROPERTY, "postgresql")`)와 + 두 `@ConditionalOnProperty`(`PostgreSqlPersistenceConfig.java:38-42`, `H2PersistenceConfig.java:41-45`) +- **왜 문제인가**: javadoc이 예측한 그 실패가 실제로 일어난다. 게다가 한 단계 더 나쁘다 — + `PostgreSqlPersistenceConfig.postgreSqlFlywayLocationCustomizer`(`:110-118`)도 함께 꺼지므로 + Flyway가 기본 위치 `classpath:db/migration`으로 떨어지고, 거기엔 `postgresql/V1`과 + `jpa/core/V1`·`jpa/fileserver/V1`·`jpa/idempotency/V1`·`jpa/inbox/V1`· + `jpa/notification-platform/V1`·`jpa/outbox-polling/V1`·`jpa/outbox-storage/V1`이 **모두 V1**로 들어 있다. + Flyway는 중복 버전에 대해 "Found more than one migration with version 1"로 기동을 거부한다. + 즉 증상이 "벤더 오타"와 전혀 무관한 곳에서 터진다. +- **수정 방향**: (1) `config`/`autoconfigure` 중 한 곳에 + `@EnableConfigurationProperties(PersistenceVendorSettings.class)`를 붙이고 실제로 주입받아 + 기동 시 검증하거나, (2) javadoc과 CLAUDE.md의 주장을 사실에 맞게 내리고 + `app-bootstrap`에 `postgresql|h2` 외 값을 거부하는 기동 검증기를 추가한다. + (2)가 현실적이다 — 이미 `PersistenceVendorProdSafetyValidator`라는 자리가 있다. +- **반론과 재반박**: "`@ConditionalOnProperty(matchIfMissing=true)`가 PostgreSQL을 기본으로 잡으니 + 대부분 괜찮다"—맞다. 하지만 이 발견의 핵심은 동작이 아니라 **문서가 약속한 안전망이 없다는 것**이다. + fork 사용자는 "enum 바인딩이 오타를 잡아준다"는 두 곳의 문장을 읽고 그걸 믿는다. + +#### H2. `DurableOperationStorePort` / `LiveEventReplayPort` 구현체를 등록하는 스캔이 없다 + +- **현상**: `DurableOperationStoreAdapter`(`@Repository`)와 `JpaLiveEventReplayAdapter`(`@Repository`)가 + **어떤 컴포넌트 스캔에도 걸리지 않는다.** 두 포트는 `application-core`와 `adapter:inbound:web`이 소비한다. +- **근거**: + - `src/main/java/.../operation/DurableOperationStoreAdapter.java:29-30` — `@Repository`, + 패키지 `...persistence.operation` + - `src/main/java/.../liveevent/JpaLiveEventReplayAdapter.java:39-43` — `@Repository`, + 패키지 `...persistence.liveevent` + - `src/main/java/.../config/JpaAdapterComponentsConfig.java:60-67` — 스캔 대상은 + `audit, failure, idempotency, lock, outbox, transaction` **6개뿐**. `operation`/`liveevent` 없음 + - `src/app-bootstrap/.../CaSkeletonApplication.java:105` — `dev\.caskeleton\.adapter\.outbound\.persistence\..*` + 를 컴포넌트 스캔에서 제외 + - `fileserver`/`notification`은 각자 전용 config가 `@ComponentScan`을 갖는데(`FileserverJpaPersistenceConfig.java:40`) + `operation`/`liveevent`에는 그런 config가 없다 + - 소비자: `src/application-core/.../operation/SubmitDurableOperationUseCase.java:55`, + `src/adapter/inbound/web/.../operationasync/OperationQueryService.java:20`, + `src/adapter/inbound/web/.../advanced/stream/replay/MessagingReplayBridge.java:31`, + `src/adapter/inbound/websocket/.../advanced/resume/PortBackedReplayAvailability.java:22` + - `DurableOperationStoreAdapter` 전체 참조: **자기 파일 4곳뿐**(테스트조차 없음) + - **2차 정독 보강 — 범위 정정**: 엔티티와 Spring Data 인터페이스 쪽은 **정상이다.** + `config/PersistenceJpaConfig.java:52-53,75-76`이 `...persistence.liveevent`와 + `...persistence.operation`을 `@EntityScan`·`@EnableJpaRepositories` 양쪽에 모두 넣는다. + 빠진 것은 **`@Repository`를 단 포트 구현체 2개**뿐이다. 즉 "리포지토리 인터페이스는 빈인데 + 그걸 쓰는 어댑터는 빈이 아닌" 상태다. + - **테스트 하네스가 이 사실을 알고 손으로 우회한다**: + `postgresqlIntegrationTest/.../readiness/LegacyOutboxIntegrationSupport.java:128` + `// OutboxStoreAdapter: @Repository — registered manually (no component scan).` + (같은 부류의 어댑터를 `ctx.registerBean(...)`으로 직접 등록한다.) 통합테스트가 녹색인 이유가 + 여기 있다 — 스캔을 안 쓰니 스캔 누락이 보이지 않는다(→ §4.5). + - **`operation` 패키지의 유일한 PG 계약 테스트는 어댑터를 안 쓴다**: + `postgresqlIntegrationTest/.../operation/DurableOperationStoreContractTest`(474줄)는 + `DurableOperationJpaRepository`의 네이티브 `@Query` 7개를 **테스트에 다시 타이핑해** 돌린다. + 조립되지 않은 컴포넌트의, 복사된 SQL을 검증하는 상태다(→ K7 한계 1). +- **왜 문제인가**: 이건 `JpaAdapterComponentsConfig`의 javadoc(`:14-25`)이 **여덟 개 클래스에 대해 이미 + 겪었다고 서술한 바로 그 사고다** — "annotated `@Component` and `@Repository` and were beans in no + running application". 그 수정에서 두 개가 빠졌다. 구체 실패: fork가 durable-operation HTTP 경로를 + 켜면 `OperationQueryService` 생성 시 `DurableOperationStorePort` 미충족으로 기동 실패하거나, 더 나쁘게는 + (현재처럼 `OperationQueryService` 자체가 어디서도 생성되지 않아) **기능이 조용히 없는 상태**가 된다. + 한편 `durable_operation`·`live_event_log` 테이블은 `db/migration/postgresql/V11`·`V12`가 + **모든 배포에 무조건 만든다.** 아무도 쓰지 않는 테이블 2개를 fork가 물려받는다. +- **수정 방향**: `JpaAdapterComponentsConfig`의 `basePackages`에 `operation`, `liveevent`를 추가하거나 + (권장) 두 capability에 각자 스위치와 전용 config를 준다. 후자면 V11/V12도 `db/migration/jpa/*`로 + 옮기는 게 일관적이다. `PersistenceEntityScanCoverageTest`(`src/test/.../config/`)가 엔티티 스캔은 + 검사하지만 **컴포넌트 스캔 커버리지는 검사하지 않는다** — 그 테스트를 확장하는 게 재발 방지책이다. +- **반론과 재반박**: "두 capability 모두 아직 미완성이라 의도적으로 안 켠 것"—그럴 수 있다. 그렇다면 + `PostgreSqlSameStoreInboxAdapter`처럼 stereotype을 떼고 "후보 구현, 선택 경로 없음"이라고 명시해야 + 한다(`CandidateAdapterCompositionTest`가 정확히 그 패턴을 강제한다). `@Repository`를 단 채로 스캔이 + 안 닿는 상태는 "켜져 있다고 믿게 만드는" 최악의 중간 상태다. + +#### H3. `db/migration/postgresql/V13`이 `NOT VALID` 없이 CHECK 제약 6개를 붙인다 — 기동 시 전체 테이블 락 + +- **현상**: `V13__outbox_canonical_transport_compatibility.sql`이 `outbox_event`에 CHECK 제약 6개를 + `NOT VALID` 없이 추가한다. PostgreSQL은 `ACCESS EXCLUSIVE` 락을 잡고 **기존 전 row를 스캔해 검증**한다. + `APP_MIGRATION_ON_STARTUP`이 기본 `true`이므로 이 스캔은 **배포 중 기동 시점에** 일어난다. +- **근거**: + - `src/main/resources/db/migration/postgresql/V13__outbox_canonical_transport_compatibility.sql:29-107` + — `ADD CONSTRAINT ck_outbox_event_canonical_shape CHECK (...)` 외 5개, 전부 `NOT VALID` 없음 + - `src/app-bootstrap/src/main/resources/config/runtime.yml:20` — `migration-on-startup: ${APP_MIGRATION_ON_STARTUP:true}` + - `docs/registries/env-keys.yaml:307-318` — `default: true` + - **같은 저장소가 정답을 알고 있다**: + `db/migration/jpa/notification-platform/V4__notification_platform_alignment_and_activation.sql:164-168` + — "Added NOT VALID and validated separately: `VALIDATE CONSTRAINT` takes only a SHARE UPDATE + EXCLUSIVE lock and lets concurrent writes continue, whereas adding a validating constraint + outright rewrites the table under an ACCESS EXCLUSIVE lock. On an empty tree the difference is + nothing; on an adopted one it is an outage." 그리고 `:193,196`에서 실제로 `NOT VALID` → + `VALIDATE CONSTRAINT`를 쓴다. `db/migration/jpa/idempotency/V1__expand_owner_safe_v2.sql:101,108,122`도 동일 + - 같은 결함이 있는 다른 파일: `jpa/notification-platform/V7:101-103`, `V8:130-132`, `V9:159-180`, + `jpa/fileserver/V2:27-29` +- **왜 문제인가**: 반증 가능한 시나리오 — `outbox_event`에 1천만 row가 있는 배포에서 롤링 업데이트를 + 하면, 첫 인스턴스가 V13을 적용하는 동안 `ACCESS EXCLUSIVE`가 걸려 **모든 아웃박스 append(=모든 도메인 + 이벤트 발행)가 블록된다.** 동시에 Flyway 락 때문에 나머지 인스턴스는 기동 자체가 대기하므로 + readiness probe가 실패하고 롤아웃이 멈춘다. 추가로 `V13:6-7`의 + `ALTER COLUMN event_id TYPE varchar(96)`는 PG 9.2+에서 카탈로그 변경뿐이라 안전하지만, + `jpa/notification-platform/V4:125-142`의 `char(64) → varchar(64)` 9건은 **진짜 테이블 재작성**이다. +- **수정 방향**: V13의 6개 제약을 `... NOT VALID`로 추가하고, `VALIDATE CONSTRAINT`는 별도 마이그레이션 + 또는 운영 작업으로 분리한다. 그리고 "새 CHECK/FK는 `NOT VALID`로만 추가한다"를 규칙으로 못 박아야 한다 — + 현재는 같은 트리 안에서 한쪽은 지키고 한쪽은 안 지킨다. +- **반론과 재반박**: "V13 시점에 `outbox_event`는 비어 있거나 작다"—신규 fork는 그렇다. 하지만 이 파일의 + 헤더(`:1-3`)가 명시하듯 V13은 **기존 legacy authority를 유지한 채 하는 추가 마이그레이션**이다. 즉 + 존재 이유 자체가 "이미 데이터가 있는 DB"다. + +#### H4. 진행 중인 리팩토링이 세 빈에서 JPA 마스터 스위치를 떼어냈다 (스펙 자기 위반) + +- **현상**: `HibernateProviderPolicy`, `PostgreSqlRuntimeRoleVerifier`, `RetryEventListener`가 + **`ca-skeleton.persistence-jpa.enabled=false`에서도 생성된다.** 이건 이번 미커밋 리팩토링이 + 만든 **회귀**다. +- **근거**: + - 이전(tracked, 삭제됨): `app-bootstrap/.../jpa/JpaPlatformRuntimeAutoConfiguration.java`가 이 세 빈을 + 선언했고, 이 클래스는 `PersistenceJpaRootAutoConfiguration`(=`@ConditionalOnProperty(ca-skeleton.persistence-jpa.enabled=true)`)이 + `@Import` 하는 평범한 `@Configuration`이었다 → **마스터 스위치 아래 있었다**. + 삭제 hunk: `full.diff`의 `JpaPlatformRuntimeAutoConfiguration.java` `-hibernateProviderPolicy()`, + `-postgreSqlRuntimeRoleVerifier()`, `-jpaRetryEventListener()` + - 이후(untracked, 신규): `src/main/java/.../autoconfigure/PersistenceJpaRuntimeConfig.java:20-27` — + 독립 `@AutoConfiguration`이고 조건이 `@ConditionalOnClass(javax.sql.DataSource.class)`(JDK 클래스, + 항상 참) + `@ConditionalOnProperty(prefix="app.jpa-platform", name="addons-enabled", matchIfMissing=true)` + (이 프로퍼티는 어느 yml에도 없음, 따라서 항상 참)뿐이다. **마스터 스위치 없음** + - `src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports:2` + 가 이 클래스를 auto-config 후보로 등록 + - `app-bootstrap/.../JpaOffAutoConfigurationImportFilter.java:24-35`는 Boot 자체 auto-config 10개만 + FQN으로 제거하므로 이 클래스는 걸러지지 않는다 + - **스펙 자기 위반**: `docs/superpowers/specs/2026-09-18-jpa-capability-composition-ownership.md:41` — + "JPA off remains structural: no persistence entities, repositories, **provider beans**, transaction + executors, **retry runtime**, or observation beans are assembled." `HibernateProviderPolicy`는 + provider bean이고 `RetryEventListener`는 retry runtime이다. 같은 문서 `:48-58`의 "Verified result" + 목록에는 이 조건을 검사한 항목이 없다 + - **테스트가 회귀를 잠갔다**: `src/test/.../autoconfigure/PersistenceJpaRuntimeConfigTest.java:43-49` + (`providerRuntimeBeansAreLeafOwned`)가 마스터 스위치 없이 두 빈이 존재함을 **기대값으로 단언**한다 +- **왜 문제인가**: 비용 자체는 작다(POJO 3개, 스레드·커넥션·필수 env 없음) — 그래서 Critical이 아니라 + High다. 문제는 **이 리팩토링이 스스로 선언한 수용 기준을 어겼고, 그 어긴 상태를 신규 테스트가 정답으로 + 고정했다는 것**이다. 지금 고치지 않으면 다음 사람은 이게 의도라고 읽는다. +##### H4-A. 이건 단발 회귀가 아니다 — 같은 이전이 네 leaf에서 네 가지 결과를 냈다 + +조정자가 다른 영역에서 확인한 것을 합치면, 진행 중인 *capability composition ownership* 이전은 +**게이트를 잃는 방식으로 세 번 일어났고 한 번만 제대로 됐다.** 원인은 네 leaf 공통이다. + +| leaf | 스캔 제외 정규식에 잡히나 | `.imports`에 실렸나 | 결과 | +| --- | --- | --- | --- | +| `adapter:outbound:notification` | **예** (`adapter\.outbound\.notification\..*`) | 예 | **정상** — 유일하게 제대로 이전됨 | +| `adapter:outbound:httpclient` | **아니오** (신규 `...httpclient.autoconfigure` 패키지가 정규식에 없음) | 예 | **누수** — 스위치를 꺼도 자식 `@Configuration` 9개가 컴포넌트 스캔으로 등록됨 | +| `adapter:outbound:persistence-jpa` (이 영역) | **예** | 예 | **스위치 상실** — 등록은 맞는데 조건이 없음 | +| redis capability | **예** | **아니오** | **완전 사망** — `RedisCapabilityConfig`는 main 참조 0건, javadoc 한 줄뿐 | + +**공통 원인**: `CaSkeletonApplication:99-113`의 스캔 제외 정규식과 각 leaf의 +`META-INF/spring/...AutoConfiguration.imports`는 **손으로 관리되는 두 목록인데, 짝이 맞는지 검사하는 +것이 아무 데도 없다.** 한쪽만 맞추면 죽고(redis), 다른 쪽만 맞추면 샌다(httpclient). + +##### H4-B. JPA의 원인 확정 — 제외 누락이 아니라 순수한 조건 애노테이션 누락 + +조정자 질문에 대한 답. **`dev\.caskeleton\.adapter\.outbound\.persistence\..*`는 신규 +`autoconfigure/` 패키지를 덮는다.** 정규식 시뮬레이션으로 확인: + +- 패턴: `CaSkeletonApplication.java:99-113`의 `excludeFilters` REGEX 중 + `dev\.caskeleton\.adapter\.outbound\.persistence\..*` +- 대상: `dev.caskeleton.adapter.outbound.persistence.autoconfigure.PersistenceJpaRuntimeConfig`, + `...autoconfigure.PersistenceJpaAutoConfiguration` → **둘 다 매치** +- 대조군: `dev.caskeleton.adapter.outbound.httpclient.autoconfigure.*`, + `dev.caskeleton.adapter.outbound.redis.*` → 정규식에 **없음** + +게다가 `.imports`로 등록된 클래스는 Boot의 `AutoConfigurationExcludeFilter`가 컴포넌트 스캔에서 +독립적으로 배제하므로, JPA 쪽은 **제외/등록 두 목록이 이미 짝이 맞는다.** + +**그러므로 JPA는 httpclient 케이스가 아니다.** 어느 칸에 들어가야 하느냐는 질문의 답은 +"notification과 같은 칸(정상)"이고, 거기서 **한 가지만 빠졌다 — 클래스 레벨 조건.** 수정은 3줄이다: + +```java +@AutoConfiguration(afterName = { ... }) // 그대로 +@ConditionalOnClass(javax.sql.DataSource.class) // 그대로 (무의미하지만 해롭진 않음) +@ConditionalOnProperty( // ← 추가 + prefix = "ca-skeleton.persistence-jpa", name = "enabled", havingValue = "true") +@ConditionalOnProperty( // 기존 세부 스위치는 유지 + prefix = "app.jpa-platform", name = "addons-enabled", matchIfMissing = true) +class PersistenceJpaRuntimeConfig { +``` +(두 `@ConditionalOnProperty`는 `@Conditional`로 합치거나 `name = {"...enabled"}` 형태로 묶는다.) + +함께 `PersistenceJpaRuntimeConfigTest.java:43-49`의 `providerRuntimeBeansAreLeafOwned`에 +`withPropertyValues("ca-skeleton.persistence-jpa.enabled=false")` → `doesNotHaveBean` 케이스를 더한다. +현재 이 테스트는 스위치를 아예 설정하지 않은 상태에서 빈 존재를 단언하므로, **고친 뒤에는 이 테스트가 +그대로는 실패한다.** 즉 이 테스트는 회귀 방지 장치가 아니라 회귀의 잠금장치다. + +- **반론과 재반박**: + - "`@AutoConfiguration(afterName=...)` 순서 때문에 독립 auto-config여야 했다" — `afterName`과 + `@ConditionalOnProperty`는 배타적이지 않다. 순서를 위해 조건을 포기할 이유가 없다. + - "비용이 POJO 3개뿐이니 두고 봐도 된다" — 비용이 문제가 아니라 **스펙이 선언한 수용 기준 + (spec `:41`)을 어긴 상태를 신규 테스트가 정답으로 고정했다**는 게 문제다. 다음 사람은 이걸 의도로 + 읽는다. + - "이건 이전이 끝나면 자연히 정리된다" — 네 leaf 중 셋이 이미 서로 다른 방식으로 틀렸다. + 검사 장치 없이는 정리되지 않는다(→ §4.5 권고 3). + +#### H5. H2 벤더에서는 경합 실패가 절대 재시도되지 않는다 + +- **현상**: `ca-skeleton.persistence.vendor=h2`일 때 `VendorFailureTranslator` 빈이 없어 + 40001(serialization failure)·40P01(deadlock)이 `JpaPersistenceException`으로 분류되지 않고, + 재시도 코디네이터의 catch에 절대 걸리지 않는다. +- **근거**: + - `src/main/java/.../postgresql/PostgreSqlPersistenceConfig.java:84-89` — PostgreSQL은 + `postgreSqlVendorFailureTranslator` 빈을 등록 + - `src/main/java/.../h2/H2PersistenceConfig.java:46-67` — H2는 SPI 4종만 등록하고 + `VendorFailureTranslator`는 **등록하지 않음** + - `src/main/java/.../autoconfigure/PersistenceJpaRuntimeConfig.java:55-58` — 번역기가 없으면 + catalog-free 체인으로 폴백 + - `src/main/java/.../transaction/PersistenceFailureTranslatorChain.java:67-68,104` — + `NO_VENDOR_TRANSLATOR`가 `null`을 돌려주고, 원본 예외가 그대로 나간다 + - **저장소 자신의 테스트가 이를 단언**: `src/test/.../autoconfigure/PersistenceJpaRuntimeConfigTest.java:100-116` + - 그리고 `PostgreSqlPersistenceConfig.java:66-77`의 javadoc이 이 정확한 결과를 설명한다 — + "Contention then goes unretried in exactly the deployments that have a database" +- **부수 발견 (2차 정독으로 범위 정정)**: 이 leaf에는 **오류 분류 체인이 두 벌** 있고 커버리지가 + 다르다. 1차 리뷰에서 "55P03이 아예 없다"고 쓴 것은 범위가 틀렸다. 정확히는: + - `api.error.FailureCategory` 체인 — **55P03 있음.** + `postgresql/error/PostgreSqlFailureClassifier`가 `55P03 → LOCK_NOT_AVAILABLE`로 매핑하고 + (`src/test/.../postgresql/error/PostgreSqlFailureClassifierTest`의 `@CsvSource`가 9개 코드 전부 + 고정), `postgresql/lock/PostgreSqlLockExceptionTranslator`가 이를 + `PessimisticLockTimeoutException`으로 바꾼다. 실제 PG에서 검증된다 — + `postgresqlIntegrationTest/.../platform/PostgreSqlPessimisticLockContractTest:66-76`. + - `shared.error.OperationalError` 체인 — **55P03 없음.** + `postgresql/PostgreSqlSqlStateErrorMapping.java:14-17`이 `40P01`, `25P03`, `57014`만 매핑한다. + 그리고 이 누락은 **테스트가 고정하고 있다**: + `src/test/.../postgresql/PostgreSqlSqlStateErrorMappingTest.java:33-36` + `assertThat(codes).containsOnlyKeys("40P01","25P03","57014")` — 행을 추가하려면 이 테스트를 같이 + 고쳐야 한다. `h2/H2SqlStateErrorMapping.java:23-27`의 주석이 같은 사실을 자백한다. + - **결과**: 어떤 경로를 타느냐로 갈린다. `SpringTransactionPort`/`PersistenceExceptionTranslator`를 + 통과한 락 타임아웃은 분류되지 않아 INTERNAL로 떨어지고, + `PostgreSqlLockExceptionTranslator`를 통과한 것은 제대로 분류된다. 두 체인이 같은 SQLSTATE에 + 대해 다른 답을 주는 상태이고, 어느 쪽을 타는지는 호출 경로에 달려 있다. +- **왜 문제인가**: fork 개발자가 `bootRunH2`로 개발하면서 "재시도가 동작한다"고 믿고 코드를 쓰는데, + H2에서는 한 번도 재시도가 일어나지 않는다. 그리고 prod(PG)에서는 재시도는 되지만 **락 타임아웃은 + 여전히 분류되지 않아** 클라이언트가 500을 받는다. +- **수정 방향**: (a) `H2SqlStateErrorMapping`처럼 `H2VendorFailureTranslator`를 만들어 + `H2PersistenceConfig`에 등록하거나, 최소한 H2에서 재시도가 없다는 것을 leaf CLAUDE.md의 + 벤더 표에 명시한다. (b) `PostgreSqlSqlStateErrorMapping`에 `55P03 → DB_LOCK_TIMEOUT`(또는 + 기존 `DB_QUERY_CANCELED`) 행을 추가한다. +- **반론과 재반박**: "H2는 로컬 개발용이고 동시성 fidelity는 `postgresqlIntegrationTest` 담당"—맞다. + 하지만 (b)의 55P03 누락은 H2와 무관한 **프로덕션 경로의 구멍**이다. + +#### H6. `SpringTransactionPort`가 HikariCP를 하드 요구한다 + +- **현상**: 트랜잭션 포트가 `DataSource`를 `HikariDataSource`로 언랩하지 못하면 기동 실패한다. +- **근거**: `src/main/java/.../transaction/SpringTransactionPort.java:182-193` — + `dataSource.unwrap(HikariDataSource.class)` 실패 시 + `IllegalStateException("the JPA transaction deadline policy requires a HikariDataSource")`. + `:3`에서 `com.zaxxer.hikari.HikariDataSource`를 **벤더 중립이어야 할 `transaction` 패키지가 직접 import**한다. +- **왜 문제인가**: Agroal/Tomcat JDBC/DBCP2로 바꾸는 fork, 또는 `application.yml:117-121`이 + 계획으로 언급하는 `datasource-proxy`/`spring-boot-data-source-decorator` 데코레이터를 도입하는 순간 + 기동이 죽는다(`unwrap`이 프록시를 뚫는지는 데코레이터 구현에 달렸다). 템플릿의 "기술을 갈아끼울 수 + 있다"는 전제와 정면 충돌한다. +- **수정 방향**: 커넥션 획득 타임아웃을 프로퍼티(`spring.datasource.hikari.connection-timeout`)에서 + 읽거나, `Duration connectionAcquisitionTimeout`을 생성자 인자로 받아 조립 지점에서 결정하게 한다. + `TransactionRetryBackoff`는 이미 그 형태다(`transaction/TransactionRetryBackoff.java:37-42`). +- **반론과 재반박**: "Boot 기본이 Hikari이고 이 저장소는 Hikari를 전제로 풀 제약을 검증한다 + (`HikariPoolConstraintValidator`)"—사실이다. 그래도 **fail-fast 메시지가 '이 템플릿은 Hikari 전용'이라고 + 말하지 않는다.** 최소한 leaf CLAUDE.md의 "Allowed/Forbidden"에 명시해야 한다. + +#### H7. 아웃박스 상태 전이가 트랜잭션 밖에서 조용히 no-op이 된다 + +- **현상**: `OutboxStoreAdapter.markPublished/markFailed/markDead`가 `findById` 후 엔티티를 + 변경하고 dirty checking에 의존한다. 호출자가 트랜잭션을 안 열면 엔티티는 detached이고 + **변경은 아무 에러 없이 사라진다.** +- **근거**: + - `src/main/java/.../outbox/OutboxStoreAdapter.java:88-120` — 세 메서드 모두 `findById(...).setStatus(...)` 패턴 + - `src/main/java/.../outbox/OutboxStoreAdapter.java:35-36` — javadoc이 "run inside the caller's + `TransactionPort.inWrite()` boundary and declare no `@Transactional` of their own"이라고 + **전제만 서술하고 강제하지 않는다** + - `claimBatch`도 같다(`:69-80`) — 반환 엔티티를 IN_FLIGHT로 바꾸고 flush를 caller에 맡긴다 + - 대조군(강제하는 쪽): `hibernate/batch/HibernateJpaBatchExecutor.java:39-42` + (`entityManager.isJoinedToTransaction()` 확인 후 throw), + `postgresql/inbox/PostgreSqlSameStoreInboxAdapter.java:203-210`, + `postgresql/idempotency/IdempotencyCapabilityGuard.java:92-108` +- **왜 문제인가**: 반증 가능한 시나리오 — 릴레이가 경계를 빠뜨리면 `markPublished`가 아무것도 안 하고, + 같은 row가 다음 폴링에서 다시 claim되어 **같은 이벤트가 영원히 재발행된다.** 그리고 로그에는 + 아무 흔적이 없다. `markPublished`가 row 부재에는 `IllegalStateException`을 던지도록 공들여 만들어 + 놨으면서(`:91`) 정작 더 흔한 실패 모드는 막지 않는다. +- **수정 방향**: 세 메서드와 `claimBatch` 진입부에 + `EntityManager#isJoinedToTransaction()` 또는 `TransactionSynchronizationManager.isActualTransactionActive()` + 확인을 추가한다. 같은 leaf 안에 이미 세 가지 구현 예가 있다. +- **반론과 재반박**: "port 계약상 caller가 경계를 여는 게 보장된다"—계약은 컴파일러가 검사하지 않는다. + 이 leaf의 다른 어댑터 세 곳이 굳이 런타임 검사를 넣은 이유가 그것이다. + +#### H8. 프로덕션 마이그레이션 버전 공간이 `sample-portfolio`와 묶여 있다 + +- **현상**: `db/migration/postgresql`에 **V2, V7, V8이 없다.** 그 번호는 `sample-portfolio`의 + `db/sample-migration`이 소유한다. +- **근거**: + - `src/main/resources/db/migration/postgresql/` 실제 목록: V1, V3, V4, V5, V6, V9, V10, V11, V12, V13 + - `db/migration/postgresql/V9__widen_capability_schema_stream.sql:3-6` — + "Numbered V9, not V8 or V7. `db/migration/postgresql` and `db/sample-migration` are merged into + one Flyway location list by the sample composition root, so the two trees share a single version + space: **the sample already owns V2, V7 and V8.**" + - `src/sample-portfolio/src/main/resources/application.yml:52` — + `locations: classpath:db/migration/postgresql,classpath:db/sample-migration` +- **왜 문제인가**: **fixture 모듈이 프로덕션 마이그레이션의 번호 공간을 제약한다.** `modules.json`은 + `sample-portfolio`를 "fixture 소비자, production이 의존하지 않음"으로 선언하는데, 실제로는 + 프로덕션 스트림이 샘플의 번호를 피해가야 한다. fork가 `sample-portfolio`를 지우면 V2/V7/V8이 + 영구 결번으로 남고(동작엔 무해), 반대로 fork가 자기 V14를 추가하려다 샘플이 이미 V14를 쓰면 충돌한다. +- **수정 방향**: 샘플 스트림에 자체 history table을 주면 된다 — 이 저장소는 이미 옵션 capability에서 + 그 패턴을 완벽하게 쓴다(`notification/NotificationSchemaStream.java:8-21`이 정확히 같은 문제를 + 같은 방법으로 해결한다). 샘플만 예외로 남아 있다. +- **반론과 재반박**: "샘플은 fork가 첫날 지우는 물건"—그렇다면 더더욱 프로덕션 번호 공간을 + 물어뜯게 두면 안 된다. 지우고 나면 왜 결번인지 아무도 모른다. + +#### H9. `JpaSqlConstructionSafetyVerifier`는 이름이 약속하는 것을 하지 않고, 일상 빌드에서 돌지도 않는다 + +- **현상**: "SQL 구성 안전성" 검사기가 실제로 하는 일은 **한 줄 안에 `set_config('`가 있으면 같은 줄에 + `?`도 있어야 한다**는 것뿐이다. 문자열 연결 SQL, 동적 쿼리, `String.format`, `+` 연결은 전혀 안 본다. +- **근거**: + - `src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/JpaSqlConstructionSafetyVerifier.java:34-37` + — 검사 로직 전체가 `if (line.contains("set_config('") && !line.contains("?"))` 한 줄 + - `.../VerifyJpaSqlConstructionSafetyTask.java:28-29` — 성공 메시지는 + "every set_config value in {} binds a parameter" (이름보다 정직하다) + - 등록: `.../JpaEvidencePlugin.java:40-48`. **`check`/`ci`/`architectureCheck` 어디에도 안 걸려 있다.** + `persistence-jpa/build.gradle`의 `tasks.named('check')`는 `verifyJpaReadinessRegistry`만 건다 + - 유일한 호출자는 `src/config/jpa/readiness-cards.yaml:37`의 `support-tasks` 항목 +- **우회 경로 (High 근거)**: + 1. 멀티라인 — `set_config(` 다음 줄에 값이 오면 매치 안 됨 + 2. `:name` 바인딩 — JPA `createNativeQuery`는 `:tenant` 형태를 쓰는데 `?`가 없으므로 + **정상 파라미터 바인딩이 오탐으로 빌드를 깬다** (`experimental/rls/RlsTenantSessionBinder.java:34`가 + `?`를 쓰는 건 이 검사기를 통과하기 위한 형태로 보인다) + 3. `set_config` 외의 모든 문자열 연결 SQL — 완전 무검사 +- **실코드 샘플 검증 결과**: `set_config` 사용처 4곳 + (`postgresql/PostgreSqlLocalTimeoutConfigurer.java:12-14`, + `experimental/rls/RlsTenantSessionBinder.java:34`, + `experimental/schema/SchemaMultiTenantConnectionProvider.java:68`, + `postgresql/copy/RegisteredPostgreSqlCopyLoader.java:124`) **모두 `?` 바인딩을 쓴다 — 규칙은 지켜지고 있다.** + 그리고 이 leaf 전체에서 문자열 연결로 SQL을 만드는 곳은 없다(SQL은 전부 `static final String` 상수이거나 + `@Query` 애노테이션). **즉 규칙은 지켜지지만, 검사기가 그걸 증명하지 못한다.** +- **왜 문제인가**: 이름이 보증을 과대 광고한다. fork 사용자가 `verifyJpaSqlConstructionSafety: OK`를 + 보고 "이 leaf의 SQL 구성은 검증됐다"고 읽는다. 그리고 그마저도 `check`/`ci`에서 안 돌아 회귀를 못 잡는다. +- **수정 방향**: (a) 태스크 이름을 `verifySetConfigParameterBinding`으로 바꾸거나, + (b) 실제로 SQL 문자열 연결을 잡는 ArchUnit 규칙으로 격상한다(이 저장소는 ArchUnit을 이미 쓴다 — + `testFixtures/.../testkit/arch/JpaArchitectureRules.java`). 어느 쪽이든 `check`에 건다. + 참고로 이 저장소는 **무의미한 소스 토큰 검사를 이미 한 번 제거했다** + (`springdata/RegisteredQuery.java:21-29`, `postgresql/lock/WorkQueueDefinition.java:33-41` — + "Forbidding dynamic construction is a rule about source, and ArchUnit and review are where source + rules live"). 그 판단을 이 검사기에도 적용해야 한다. + +#### H10. 테넌트 범위 엔티티 위에 `JpaRepository`를 상속한 리포지토리가 9개 남아 있고, 이를 막는 규칙은 돌고 있다고 표시돼 있다 + +*(2차 정독 — `notification/platform/` 37파일 전문 독파에서 발견)* + +- **현상**: `notification/platform/NotificationRequestJpaRepository.java:11-25`는 `JpaRepository`를 + 버리고 **맨 `Repository`** 로 내려왔다. 그 이유가 그 파일에 적혀 있다 — 상속된 표면이 + `findById(UUID)`, `findAll()`, `deleteById(UUID)`, `count()`를 내주는데 **전부 테넌트 무차별**이라는 + 것이다. 그런데 **같은 패키지의 나머지 9개는 여전히 `JpaRepository`를 상속한다.** + + | 리포지토리 | 상위 타입 | 엔티티에 `tenantId` 필드 | + | --- | --- | :---: | + | `NotificationRequestJpaRepository` | `Repository<…>` (고쳐짐) | 있음 | + | `AdminAuditJpaRepository` | `JpaRepository<…>` | **있음** | + | `ConsentJpaRepository` | `JpaRepository<…>` | **있음** | + | `ContactPointJpaRepository` | `JpaRepository<…>` | **있음** | + | `DeduplicationClaimJpaRepository` | `JpaRepository<…>` | **있음** | + | `PreferenceJpaRepository` | `JpaRepository<…>` | **있음** | + | `RecipientDeliveryJpaRepository` | `JpaRepository<…>` | **있음** | + | `SuppressionJpaRepository` | `JpaRepository<…>` | **있음** | + | `TemplateVersionJpaRepository` | `JpaRepository<…>` | **있음** | + | `inbox/InboxItemJpaRepository` | `JpaRepository<…>` | **있음** | + | `DeliveryAttemptJpaRepository` / `ProviderEventJpaRepository` | `JpaRepository<…>` | 없음(해당 없음) | + +- **이걸 막는 규칙은 존재하고, 실행된다고 표시돼 있다**: + - `testFixtures/.../testkit/arch/JpaArchitectureRules.java:90-100` + `tenantScopedRepositoriesDoNotInheritBroadCrud()` — + `noClasses().that(new TenantScopedRepositoryPredicate()).should().beAssignableTo(CrudRepository.class)` + - `testFixtures/.../testkit/arch/TenantScopedRepositoryPredicate.java` — **이름이 아니라 구조로** + 매칭한다: Spring Data 리포지토리이고, 타입 인자 중에 `@Entity`이면서 `tenantId` 필드를 가진 + 클래스가 있으면 매치. javadoc이 대상까지 지목한다 — *"a rule that matched on + `*GenericRepository` would never have seen a perfectly ordinary + `NotificationRequestJpaRepository` handing out `findById(UUID)`."* + - `app-bootstrap/src/architectureTest/.../JpaProductionArchitectureTest.java:103`이 이 규칙을 + `productionClasses`(=`importPackages("dev.caskeleton")`, `ProductionClassImportOption`)에 건다. + 그 옵션은 persistence-jpa의 프로덕션 jar를 **제외하지 않는다**(`/test/`, `/architectureTest/`, + `/systemTest/`, `/testkit/`, `-testkit.jar`만 뺀다). + +- **따라서 둘 중 하나다 — 어느 쪽이든 결함이다**: + - (a) `:app-bootstrap:architectureTest`가 **지금 실패한다.** 위 9개가 규칙 위반이므로. + - (b) 규칙이 **공허하게 통과한다.** `tenantScopedRepositoriesDoNotInheritBroadCrud()`는 + `.allowEmptyShould(true)`를 달고 있으므로(`JpaArchitectureRules.java:99`), 술어가 아무것도 + 매칭하지 못하면 녹색이다. 그 경우 "구조로 잡는다"는 javadoc이 사실이 아니게 된다. +- **확정 명령**(빌드 실행은 내 권한 밖이므로 실행하지 않았다): + ```bash + ./gradlew :app-bootstrap:architectureTest \ + --tests 'dev.caskeleton.bootstrap.architecture.JpaProductionArchitectureTest.noTenantScopedRepositoryInheritsBroadCrud' \ + --console=plain -i + ``` + 녹색이면 (b)이고, 술어가 왜 매칭하지 않는지가 다음 질문이다 + (`JavaClass#getAllInvolvedRawTypes()`가 인터페이스의 제네릭 상위 타입 인자를 어떻게 다루는지). +- **왜 High인가**: 실제 어댑터들은 대부분 테넌트를 명시적으로 넘긴다. 즉 **오늘 새는 게 아니라 + 표면이 열려 있는 것**이다. 다만 (i) 이 정확한 실수가 한 번 실제로 발생했고 + (`NotificationRequestJpaRepository`의 주석이 그 사고 기록이다), (ii) 그걸 일반적으로 막으라고 + 만든 규칙이 **초록인 채로 9건을 놓치고 있을 가능성**이 있으며, (iii) fork 사용자가 이 패키지를 + 본보기로 삼는다. 데이터 유출은 아직 아니지만 "가드가 있다"는 믿음이 틀렸을 수 있다. +- **수정 방향**: 먼저 위 명령으로 (a)/(b)를 확정한다. (b)면 술어를 고치고(예: 제네릭 인자 대신 + `getRawGenericInterfaces()`/메서드 반환 타입 기준), `allowEmptyShould(true)`를 제거해 공허 + 통과를 막는다. 그다음 9개를 `NotificationRequestJpaRepository`와 같은 모양으로 내린다. + `src/test/.../notification/platform/NotificationRepositorySurfaceTest.java`가 지금은 + `NotificationRequestJpaRepository` **한 클래스만** 검사하므로, 목록을 패키지 전수로 바꾼다. +- **반론과 재반박**: "어차피 어댑터가 테넌트를 넘기니 실무상 문제없다" — 그 논증은 지금 이 코드에만 + 해당하고, 상속된 표면은 **다음에 이 리포지토리를 쓰는 사람**에게 열려 있다. 그리고 그 논증이 + 옳다면 `NotificationRequestJpaRepository`도 고칠 필요가 없었다. 저장소 자신이 그렇게 판단하지 + 않았다. + +--- + +### Medium + +#### M1. `JpaLiveEventReplayAdapter.append`가 read-max-then-insert라 동시 append가 PK 충돌로 실패한다 +- `src/main/java/.../liveevent/JpaLiveEventReplayAdapter.java:88-91` — `highestEverAssigned(streamId) + 1`을 + 읽고 insert. 같은 스트림에 동시 append하면 둘 다 같은 max를 읽고 PK(`stream_id`, `position`) 충돌. + javadoc `:33-37`이 "constraint violation is the right outcome"이라고 정당화하지만 **재시도도 시퀀스도 + advisory lock도 없다.** `@Transactional`이 붙어 있으므로 caller 트랜잭션이 통째로 오염된다. +- 반론: 라이브 이벤트는 스트림당 단일 writer를 가정할 수 있다. 재반박: 그 가정이 코드 어디에도 없고, + fan-out이 있는 순간 이벤트가 유실된다. + +#### M2. 문서-코드 드리프트: local 프로파일의 벤더 +- `src/adapter/outbound/persistence-jpa/CLAUDE.md:118,124` — "`application-local.yml` selects H2" +- `src/app-bootstrap/src/main/resources/application-local.yml:156` — `vendor: ${APP_PERSISTENCE_VENDOR:postgresql}` +- 같은 파일 `:22-23`이 `:56,76,84`와 모순(§3 참조) + +#### M3. 등록되지 않은 env 키 2개 +- `APP_PERSISTENCE_VENDOR` — `application-local.yml:156`과 `app-bootstrap/build.gradle:288`이 쓰는데 + `docs/registries/env-keys.yaml`에 **없다**(grep 0건) +- `ca-skeleton.realtime.replay.enabled` / `.retention` — `liveevent/JpaLiveEventReplayAdapter.java:41,63`이 + 요구하는데 **어느 yml에도, env-keys.yaml에도 없다.** `.retention`은 기본값 없는 `@Value`라 + `enabled=true`면 기동이 죽는다. `src/test/.../liveevent/JpaLiveEventReplayAdapterActivationTest.java:35-44`가 + 그 실패를 기대값으로 단언한다 +- `./gradlew :app-bootstrap:verifyEnvKeys`가 이걸 잡는지는 미검증(§9) + +#### M4. idempotency provider enum이 세 곳에서 다르다 +- `config/capabilities.yml:28` 주석 — `disabled | jdbc | redis` (3개) +- `docs/registries/env-keys.yaml:1680` — `[disabled, jdbc, redis, postgresql]` (4개), **`default: jdbc`** +- `config/capabilities.yml:30` 실제 값 — `${APP_IDEMPOTENCY_PROVIDER:disabled}` (**기본 disabled**) +- 즉 레지스트리의 default가 yml의 default와 다르고, 주석은 `postgresql`을 빠뜨린다 +- 부수: `app-bootstrap/.../PostgreSqlIdempotencyProviderConfig.java:37` `RESPONSE_CODEC_ID = "json.v1"` vs + `capabilities.yml:37` `response-codec-id: json-v2` — 후자는 읽히지 않는 죽은 키다 + +#### M5. `outbox-storage/V1`의 legacy fence 트리거가 핫 경로에 row 단위 SELECT를 넣고, cutover 후 드레인 경로가 없다 +- `db/migration/jpa/outbox-storage/V1__initialize_or_adopt.sql:209-211` — + `BEFORE INSERT OR UPDATE OR DELETE ON outbox_event FOR EACH ROW`. 함수(`:188-207`)가 + `outbox_publication_control_v2`를 매 row마다 SELECT한다. 즉 **모든 도메인 이벤트 append와 + 릴레이의 모든 상태 전이가 트리거 SELECT를 한 번씩 더 낸다** +- 더 중요한 건 드레인: 함수가 `authority <> 'LEGACY_POLLING'`이면 예외를 던지므로, POLLING_V2로 + cutover한 뒤에는 **legacy 릴레이가 남은 PENDING row를 PUBLISHED로 마킹할 수도 없다.** + `control.state`에 `DRAINING`이 있는데(`:62`) 트리거는 `state`를 보지 않는다 +- 부수 1: `:242-289`의 `legacy_digest`가 `string_agg`로 테이블 전체를 한 문자열로 만든다 — + 대형 legacy 아웃박스에서 메모리/1GB varlena 한계 위험. 게다가 `md5(x) || md5('outbox-v2:'||x)`로 + `char(64)`를 채우는 것이지 SHA-256이 아니다 +- 부수 2: `:138-141` `outbox_event_log_v2`가 `PARTITION BY RANGE (retention_bucket)`인데 **DEFAULT 파티션만 + 만든다.** 파티션 관리 job이 저장소 어디에도 없으므로 모든 row가 DEFAULT로 들어가고, 이후 범위 파티션을 + ATTACH하려면 DEFAULT의 row를 먼저 옮겨야 한다 — 파티셔닝의 이득이 0이면서 나중 전환 비용만 만든다 + +#### M6. `@Transactional` 사용이 leaf 안에서 일관되지 않다 +- 없음(원칙): `OutboxStoreAdapter`, `IdempotencyStoreAdapter`, `JpaFileMetadataStore`, notification store 전부 +- 있음(예외): `operation/DurableOperationStoreAdapter.java`(44,82,92,115,122,135,145,162,168,174), + `liveevent/JpaLiveEventReplayAdapter.java`(83,95,108,139) +- `REQUIRED` 전파라 caller 경계가 있으면 합류하므로 실동작은 무해하지만, **경계가 없을 때 조용히 + 새 트랜잭션을 여는 게 문제다** — H7과 정확히 반대 방향의 실패 모드다. 그리고 + `JpaFileMetadataStore.java:33-34`가 명문화한 규칙을 같은 leaf가 어긴다 + +#### M7. `NotificationJpaPersistenceFacade`가 빈 생성 중에 DB를 조회한다 +- `src/main/java/.../notification/configuration/NotificationJpaPersistenceFacade.java:106-110` — + `@Bean` 팩토리 메서드 안에서 `activation.requireActive()`를 호출한다. + `JdbcOperations` 빈은 `DataSource`에만 의존하고 Flyway 마이그레이션 완료에는 의존하지 않으므로, + 이 빈이 Flyway보다 먼저 만들어지면 `capability_schema_registry`가 아직 없어 조회가 실패하고 + `NotificationSchemaActivation.java:62-68`의 "registry is unreadable" 메시지로 기동이 죽는다 + (실제 원인은 "아직 안 돌았다"인데) +- 수정: `@Bean`은 객체만 만들고, 검증은 `InitializingBean`/`SmartInitializingSingleton`으로 옮긴다. + `app-bootstrap`이 이미 그 패턴을 쓴다(`PersistenceJpaRootAutoConfiguration.java:44-52`) +- **미검증** — 실제 빈 생성 순서는 부팅해봐야 확정된다(§9) + +#### M8. `HibernateEnversHistoryReader.revisions`가 구조적으로 1+N +- `src/main/java/.../envers/HibernateEnversHistoryReader.java:42-46` — `getRevisions()` 1회 후 + 리비전마다 `reader.find()`. Advanced opt-in이고 소비자 0이지만, 이 leaf에서 **유일하게 N+1인 코드**다 + +#### M9. 감사(audit) 메커니즘이 두 벌 있다 +- `audit/AuditableEntity.java:16-26` — `created_at/updated_at/created_by/updated_by`, 수동 스탬핑 +- `auditing/AuditMetadata.java:32-46` — `created_at/created_by/modified_at/modified_by`, + Spring Data `@CreatedDate` 계열 +- 컬럼 이름이 다르고(`updated_*` vs `modified_*`) 길이도 다르다(256 vs 64). 어느 쪽을 써야 하는지 + 코드만으로는 알 수 없다. `testFixtures/.../testkit/arch/JpaAuditMechanismRule.java`(214줄)가 + 이 혼동을 다루는 것으로 보이나 본문 미독 + +#### M10. capability 리포트가 조립되지 않은 기능을 STABLE로 보고한다 +- `app-bootstrap/.../jpa/JpaPlatformAutoConfiguration.java:54-76` — `capabilities()`가 + `TRANSACTION_RETRY`, `COMPLETION_EVIDENCE`, `KEYSET_PAGINATION`, `BATCH`, `SCHEMA_GATE`, + `OBSERVABILITY`를 **하드코딩된 `stable()`** 로 반환한다 +- 실제: `COMPLETION_EVIDENCE`의 구현체 `EvidenceAwareJpaTransactionManager`는 **아무데서도 생성되지 않고** + (`main` 참조 0건 — 자기 파일과 javadoc 언급뿐), `OBSERVABILITY`의 조립 팩토리 + `autoconfigure/JpaObservabilityAutoConfiguration`도 호출자가 없으며(이번 이동으로 `public`→ + package-private가 되어 **외부에서 호출할 수도 없게 됐다**), `PersistenceJpaRuntimeConfig.java:43-45`는 + 관측용 `JpaRetryObservation` 대신 noop 리스너를 등록한다. `BATCH`는 M12 참조 +- 완충재: 실제 completion-unknown 판정은 **별도 경로**인 `SpringPolicyTransactionPort`의 + `PhaseSentinel` + `TransactionResult.Indeterminate`(`transaction/SpringPolicyTransactionPort.java:116-133,250-289`)로 + 작동한다. 즉 기능은 있으나 `api/error/TransactionCompletionUnknownException` 계층을 통하지 않는다 — + **같은 관심사를 두 벌 구현해 놓고 하나만 쓴다** +- 판정: 데이터 손상은 없다. 하지만 액추에이터가 없는 기능을 STABLE이라 말하는 건 운영자를 오도한다 + +#### M11. Hibernate 배치 설정이 어디에도 없고, 배치 실행기는 쓰면 던진다 +- `hibernate.jdbc.batch_size`/`order_inserts`/`order_updates`/`default_batch_fetch_size`가 + `src/**` production 리소스에 **0건** +- `hibernate/batch/HibernateJpaBatchExecutor.java:44`가 `statistics.snapshot()`을 호출하는데 + `hibernate/HibernateStatisticsCollector.java:49-54`는 `hibernate.generate_statistics`가 꺼져 있으면 + `IllegalStateException`을 던진다. 그 설정도 어디에도 없다 +- 즉 fork가 `JpaBatchExecutor`를 쓰려는 순간 런타임 예외를 만난다. 어떤 프로퍼티를 켜야 하는지 + 안내하는 문서가 없다 + +#### M12. inbox 어댑터의 transition digest가 형제 구현과 다른(약한) 방식이다 +- `postgresql/inbox/PostgreSqlSameStoreInboxAdapter.java:252-263` — `kind|opId|token|attempt|revision`을 + `|`로 join +- 형제: `postgresql/idempotency/IdempotencyDigestPolicy.java:22-25,71-73` — **length-framed**. + 그 javadoc이 이유를 명시한다: "Joining with a delimiter means two different component lists can + render to one string" +- 같은 파일에서 같은 문제를 다르게 푼다. 토큰이 hex라 현재 충돌 가능성은 낮지만, 규칙의 일관성 문제다 +- 동일 패턴: `postgresql/outbox/PostgreSqlPollingDeliveryAdapter.java:221-240` + +#### M13. 공개 API 표면이 사실상 leaf 전체다 +- `docs/architecture/jpa-api-surface.txt` 346줄(주석 5줄 제외 ≈ 341 타입) vs main 클래스 356개 +- 즉 **거의 모든 클래스가 fork가 물려받는 공개 API**다. baseline 파일 자신이 이를 인정한다 — + "`api` is the intended external surface; the rest is implementation that has not been moved under + an internal root yet" +- `build.gradle:113-125`의 주석도 정직하다 — "This is a record, not a budget... A ceiling the + approval flag cannot lift is a separate decision nobody has taken yet" +- 판정: 지금 당장 깨지는 건 없다. 하지만 fork가 이 leaf를 손보면 **291개 타입이 호환성 부채**가 된다 + +#### M14. 조립되지 않는 클래스 3개에 `@Autowired` 생성자가 붙어 있다 +- `postgresql/inbox/PostgreSqlSameStoreInboxAdapter.java:203-206`, + `postgresql/outbox/PostgreSqlImmutableOutboxAppendAdapter.java:152-155`, + `postgresql/outbox/PostgreSqlPollingDeliveryAdapter.java:285-288` +- 세 클래스 모두 javadoc이 "Deliberately carries no Spring stereotype"이라 쓰고 + `CandidateAdapterCompositionTest`가 stereotype 부착을 금지한다. 그런데 `@Autowired`는 남아 있다 — + "스프링이 만든다"는 잘못된 신호 +- 부수: 셋 다 생성자에서 `new JdbcTemplate(dataSource)`를 직접 만든다(컨테이너 것을 안 쓴다) + +#### M15. `bootstrap`이 leaf의 package-private 클래스를 문자열로 가리킨다 +- `app-bootstrap/.../jpa/PersistenceJpaRootAutoConfiguration.java:26-29` — + `@AutoConfiguration(afterName = {"dev.caskeleton.adapter.outbound.persistence.autoconfigure.PersistenceJpaAutoConfiguration", "...PersistenceJpaRuntimeConfig"})` +- 두 클래스 모두 package-private이므로 컴파일러가 이 참조를 검사하지 않는다. leaf에서 이름을 바꾸면 + **조용히 순서 보장이 사라진다.** 이번 리팩토링이 만든 새 결합이다 + +*(아래 M16~M22는 2차 정독 — `notification/platform/` 37파일과 테스트 228파일 전문 독파에서 추가)* + +#### M16. 인박스 페이지네이션이 leaf 자신의 size+1 규칙을 안 따라서 마지막 페이지에 유령 커서를 준다 + +- `notification/platform/inbox/JpaNotificationInbox.java:96,103` — 쿼리가 정확히 `query.limit()` 행을 + 읽는다(`limit+1`이 아니다). `:107-109`가 `mapped.size() < query.limit()`이면 커서 없음, 아니면 커서 발급. +- **결과**: 마지막 페이지가 **정확히 꽉 차면** 뒤에 아무것도 없어도 next 커서가 나간다. 클라이언트는 + 빈 페이지를 한 번 더 받는다. 무한 스크롤 UI에서는 "더 보기"가 한 번 더 뜬다. +- **같은 leaf가 이미 정답을 갖고 있다**: `springdata/KeysetSliceAssembler.java:10,25` — + *"Turns a `size + 1` fetch into a page plus a next cursor"*. `JpaKeysetQuerySupport`는 + `setMaxResults(size+1)`을 하고 그 계약이 `src/test/.../springdata/KeysetSliceAssemblerTest`로 + 고정돼 있다. 인박스만 이 장치를 안 쓴다. +- **수정**: 쿼리를 `limit+1`로 바꾸고 `KeysetSliceAssembler`에 위임한다. + +#### M17. `JpaAdminOperationStore.findByOperationId`가 이전 결과가 아니라 플레이스홀더를 돌려준다 + +- `notification/platform/JpaAdminOperationStore.java:75-89` — 감사 행은 찾아놓고 + `new AdminOperationResult(operationId, dryRun, 0, empty, empty, empty, List.of("REPLAYED"))`를 + 만든다. 처리 건수 0, 결과 3개 전부 비어 있음. +- **왜 문제인가**: 이 메서드의 존재 이유가 "같은 operation id로 다시 온 관리자에게 **원래 결과**를 + 돌려주는 것"이다. 지금은 "REPLAYED"라는 문자열 하나만 준다. 멱등 재시도가 성공한 것처럼 보이지만 + 호출자가 받는 내용은 원래 작업의 결과가 아니다. +- `postgresqlIntegrationTest/.../notification/AdminOperationClaimContractTest`는 **claim 경쟁**만 + 검증한다(정확히 하나만 이긴다). 결과 반환은 검증 범위 밖이다. + +#### M18. `JdbcReconciliationJobStore`가 주입된 `Clock`을 무시하고 `Instant.now()`를 쓴다 + +- `notification/platform/JdbcReconciliationJobStore.java:94`, `:131` — `Timestamp.from(Instant.now())`. +- 이 leaf의 나머지는 전부 `Clock`을 생성자로 받는다(`JpaDeliveryAttemptStore:46,56`, + `JpaTemplateRegistry`, `JpaRecipientLeaseStore` …). 이 한 클래스만 벽시계를 직접 읽는다. +- **결과**: 재조정(reconciliation) 스케줄이 테스트에서 고정 시각으로 재현되지 않는다. + `ServingStateContractTest`가 `Clock.fixed`로 `reconciliationDue`를 측정하는데, 그 행을 **넣는** 쪽은 + 고정 시계를 안 쓴다. + +#### M19. `JpaTemplateRegistry.get()`이 `Channel` 값 수만큼 쿼리를 날리고, `disable()`은 저장을 안 한다 + +- `notification/platform/JpaTemplateRegistry.java:66-79` — 핀 고정 선택은 채널을 안 담으므로 + `Arrays.stream(Channel.values())`를 돌며 **채널당 쿼리 1개**를 날리고 첫 성공을 쓴다. + 주석(`:64-65`)이 이유를 밝히긴 한다("좌표가 실무상 채널 간 유일하고, 호출자에게 채널을 강요하는 + 것보다 싸다"). 채널 수가 4~5면 수용 가능하지만, **N+1을 구조적으로 배제한 leaf에서 유일하게 + 남은 반복 쿼리**이고 채널이 늘면 그대로 늘어난다. +- `:150-158` `disable()` — 엔티티를 찾아 `entity.disable(clock.instant())`만 하고 `save`를 안 한다. + **더티 체킹 의존**이다. 호출자에 트랜잭션 경계가 없으면 조용히 no-op이 된다 — H7과 정확히 같은 모양. + 이 클래스에는 `@Transactional`이 없다. + +#### M20. `JpaDeliveryAttemptStore`가 한 표현식에서 `toRecord(entity)`를 세 번 호출한다 + +- `notification/platform/JpaDeliveryAttemptStore.java:163-165` — + `toRecord(entity).submissionOutcome()`, `toRecord(entity).deliveryOutcome()`, + `toRecord(entity).evidenceLevel()`. `toRecord`(`:317`)는 엔티티 전체를 레코드로 변환한다. +- 순수 함수라 정확성 문제는 없다. 배치 투영 경로에서 행마다 3배 변환이 돈다는 낭비다. 지역 변수 하나로 끝난다. + +#### M21. 통합테스트가 알림 마이그레이션 목록을 세 벌 복사해 갖고 있고, 세 벌이 서로 다르다 + +- `postgresqlIntegrationTest/.../notification/NotificationFixtures.java:35-48` — V1~**V9** +- `postgresqlIntegrationTest/.../notification/RecipientClaimContractTest.java:326-338` — V1~**V8** +- `postgresqlIntegrationTest/.../notification/ProjectionFactDurabilityContractTest.java:271-281` — V1~**V6** +- 같은 패키지 안의 같은 목록이 세 벌이고 끝 버전이 다르다. 각 테스트가 자기가 필요한 지점까지만 적은 + 결과인데, **V10이 추가되면 세 곳을 다 고쳐야 하고, 안 고치면 "적용 안 된 스키마에 대한 계약"이 된다.** + `NotificationFixtures.migrations()`가 이미 공용 진입점으로 있으므로 나머지 둘이 그걸 쓰면 된다 + (`LateEventBindingContractTest:198-200`은 이미 그렇게 한다). + +#### M22. 쓰이지 않는 테스트 인프라 2건 + +- `testFixtures/.../testkit/postgresql/PostgreSqlContractExtension.java` — JUnit + `BeforeAllCallback/AfterAllCallback` 구현체이고 JVM 단위 컨테이너 캐싱까지 갖췄는데, + **저장소 전체에서 참조가 0건이다.** 78개 통합테스트는 전부 `JpaPlatformContractSupport.start()` 또는 + `PostgreSqlReadinessSupport.start()`를 직접 쓴다. 컨테이너 기동 비용을 줄이려고 만든 장치가 + 아무 데도 안 걸려 있다. +- `postgresqlIntegrationTest/.../readiness/PostgreSqlNotificationSchemaManifestIntegrationTest.java:40-61` + — 엔티티 12개를 **손으로 나열한다.** 오늘은 정확하다(패키지에 정확히 12개). 하지만 13번째 엔티티는 + 조용히 커버리지 밖이다. 같은 소스셋의 `PostgreSqlDefaultPersistenceUnitIntegrationTest:83-84`가 + `PersistenceJpaConfig`의 `@EntityScan`을 리플렉션으로 읽는 정답 패턴을 이미 쓰고 있다. + +--- + +### Low + +- **L1.** 예외의 `context`/`category`/`details` 필드가 `transient`인데 `serialVersionUID`를 선언한다 + (`api/error/JpaPersistenceException.java:16-19`, `CheckConstraintViolationException.java:13-15` 외 4개). + 역직렬화하면 `context()`가 NPE. 실제로 직렬화하지는 않지만 의도가 모순이다 +- **L2.** `transaction/FullTransactionRetryCoordinator.java:91` — `profile.retryProfile() == null` 분기는 + 죽은 코드다. `api/transaction/TransactionProfile.java:30`이 `requireNonNull(retryProfile)`을 한다 +- **L3.** `notification/platform/RecipientClaimSql.java:75` — `replaceAll(":[A-Za-z][A-Za-z0-9]*", "?")`는 + PostgreSQL `::` 캐스트가 들어오면 SQL을 망가뜨린다. 현재 상수 2개엔 캐스트가 없어 무해 +- **L4.** `config/runtime.yml:28-37`에 벤더 셀렉터 설명 주석 10줄이 **값 없이 남아 있다.** + 실제 `vendor:` 키는 `config/persistence.yml:24`로 이사했다. 주석이 `presentation:` 위에 고아로 떠 있다 +- **L5.** `idempotency/IdempotencyReaper.java:19`, `IdempotencyStoreAdapter.java:32` — `matchIfMissing=true`. + `capabilities.yml`이 항상 있으니 지금은 무해하지만, 프로퍼티 소스가 달라지는 테스트 슬라이스나 + fork의 설정 트리 개편에서 되살아난다 +- **L6.** `config/persistence.yml:24` — `vendor: postgresql`에 `${APP_*}` 플레이스홀더가 없다. + `CA_SKELETON_PERSISTENCE_VENDOR` relaxed binding으로만 덮을 수 있고, 그 키는 레지스트리에 없다 + +--- + +## 6. 바꾸지 말 것 (Keep) + +### K1. JPA 연관관계를 하나도 안 쓰고 조건부 UPDATE로 동시성을 제어한 것 +- **무엇**: 엔티티 간 `@OneToMany`/`@ManyToOne` 0건. FK는 raw 컬럼. 모든 상태 전이가 + `WHERE id=? AND state=? AND version=?` 형태의 단일 UPDATE이고 **영향 row 수가 곧 답**이다 + (`fileserver/repository/FileTransitionRepository.java:22-51`, + `operation/DurableOperationJpaRepository.java:72-89`, + `postgresql/idempotency/IdempotencyTransitionGateway.java:23-40`, + `notification/platform/RecipientClaimSql.java:26-50`). +- **왜 지금 이게 맞는가**: 이 leaf가 담는 건 **인프라 레코드**다 — 아웃박스 row, 멱등성 클레임, + 워커 리스, 파일 메타데이터, 알림 job. 전부 "여러 워커가 경합하는 큐/레저"이지 도메인 애그리거트가 + 아니다. 이런 데이터에 lazy 연관과 Hibernate 낙관적 락을 쓰면 (a) read-modify-write 윈도가 생기고 + (b) `@Version` 충돌이 "누가 이겼는지"를 알려주지 않는다. 지금 방식은 그 두 문제를 원천적으로 없앤다. + 덤으로 **N+1과 LazyInitializationException이 구조적으로 불가능**해진다. +- **언제 재검토**: fork가 이 leaf **안에** 진짜 도메인 애그리거트를 넣으려 할 때. 그때는 이 leaf에 + 넣지 말고 fork 자기 영속 모듈을 만드는 게 맞다 — `springdata`·`querydsl`·`cache` 패키지가 정확히 + 그걸 위해 준비된 도구다. + +### K2. 옵션 capability 스트림을 별도 Flyway history table로 격리한 것 +- **무엇**: 6개 스트림이 각자 location + 각자 history table을 갖는다. + `NotificationSchemaStream.java:25-28`(`flyway_jpa_notification_history`), + README 표(`README.md:234-238`). 기본 Flyway location은 `db/migration/postgresql`뿐 + (`postgresql/PostgreSqlPersistenceConfig.java:110-118`). +- **왜 지금 이게 맞는가**: `NotificationSchemaStream.java:12-17`이 이유를 정확히 쓴다 — 두 트리 모두 + V1부터 번호를 매기므로 history table을 공유하면 Flyway가 거부하거나(더 나쁘게) 하나만 기록하고 + 하나를 건너뛴다. 그리고 이게 **capability를 진짜로 optional하게 만든다**: 알림을 안 쓰는 배포에는 + 알림 테이블도, 알림 history table도 없다. `PersistenceJpaConfig.java:14-26`이 두 패키지를 + `@EntityScan`에서 빼놓은 것도 같은 이유이고, 그 결정이 `ddl-auto=validate` 실패를 실제로 막았다. +- **언제 재검토**: 스트림이 20개를 넘어 운영자가 어느 걸 적용해야 하는지 추적하지 못하게 될 때. + 그때는 `capability_schema_registry`를 읽어 필요한 스트림을 자동 적용하는 도구가 필요하다. + **지금 없는 게 그 도구다(→ §8).** + +### K3. `local` 프로파일을 H2 → PostgreSQL + Flyway + validate로 바꾼 것 +- **무엇**: `application-local.yml:56,76,84`가 기본 PostgreSQL/Flyway on/validate. H2는 + `bootRunH2`(`app-bootstrap/build.gradle:280-298`)로 분리. +- **왜 지금 이게 맞는가**: 근거가 가설이 아니라 **실제 사고 두 건**이다 — + `db/migration/postgresql/V10:6-13`(`request_hash` 타입 불일치), + `config/PersistenceJpaConfig.java:24-26`(`fs_cleanup_item` 누락). 둘 다 "H2 create-drop은 엔티티대로 + 스키마를 만드니 어긋날 수 없다"가 원인이었다. 로컬이 prod와 같은 벤더/같은 스키마 소유자를 쓰면 + 매핑-마이그레이션 불일치가 **로컬 실패**가 된다. +- **언제 재검토**: 컨테이너를 못 쓰는 환경이 주 개발 환경이 될 때. 그때도 H2를 기본으로 되돌리지 말고 + `bootRunH2`를 유지하면서 CI에서 PostgreSQL 레인을 필수로 만드는 쪽이 맞다. + +### K4. 트랜잭션 경계를 application이 소유하고, 어댑터가 경계 부재를 거부하는 것 +- **무엇**: `PolicyTransactionPort`(application-core) ← `SpringTransactionPort`(leaf). + 어댑터는 `@Transactional`을 안 붙고, 세 곳은 아예 경계가 없으면 던진다 + (`PostgreSqlSameStoreInboxAdapter.java:203-210`, + `PostgreSqlImmutableOutboxAppendAdapter.java:121-133`, + `postgresql/idempotency/IdempotencyCapabilityGuard.java:92-108`). +- **왜 지금 이게 맞는가**: Clean Architecture에서 "언제 트랜잭션을 여는가"는 유스케이스 결정이다. + 어댑터가 `@Transactional`을 달면 유스케이스가 두 어댑터를 원자적으로 묶을 수 없다. + 특히 `IdempotencyCapabilityGuard.java:14-20`의 `hasResource(dataSource)` 검사는 한 수 위다 — + "트랜잭션이 열려 있나"가 아니라 "**이** 데이터소스의 트랜잭션인가"를 묻는다. 데이터소스가 둘인 + 애플리케이션에서 다른 쪽 트랜잭션 안에서 호출된 작업이 조용히 따로 커밋되는 사고를 막는다. +- **언제 재검토**: JTA/XA를 도입할 때. 그때는 `hasResource` 검사가 오히려 방해가 된다. + +### K5. 아무 일도 안 하던 소스 토큰 검사를 지운 것 +- **무엇**: `springdata/RegisteredQuery.java:21-29`, `postgresql/lock/WorkQueueDefinition.java:33-41` — + 완성된 문자열에서 `"' +"`를 찾던 검사를 지우고, **왜 그게 무의미했는지를 주석으로 남겼다** + ("a Java concatenation operator, which the compiler has already evaluated and removed by the time + any string reaches this constructor"). +- **왜 지금 이게 맞는가**: 작동하지 않는 가드는 작동하는 가드보다 나쁘다 — 사람이 그걸 믿기 때문이다. + 지우면서 근거를 남긴 것도 옳다. 삭제만 있고 이유가 없으면 다음 사람이 "보안 검사가 사라졌다"고 읽는다. +- **언제 재검토**: 재검토할 것 없다. **오히려 이 판단을 `JpaSqlConstructionSafetyVerifier`에도 + 적용해야 한다(→ H9).** + +### K6. 진단 정보를 타입 레벨에서 바운드한 것 +- **무엇**: `api/error/JpaFailureContext.java:30-57`(SQLSTATE 5자, identifier 128자, 아니면 `redacted`), + `api/PersistenceOperationName.java:16-22`(정규식 고정), `observation/LowCardinality.java:20,29-36`, + `observation/SqlDiagnosticRedactor.java:27-41`, `api/error/JpaPersistenceException.java:52-82` + (메시지를 바운드된 조각으로만 조립). +- **왜 지금 이게 맞는가**: 메트릭 태그 하나에 entity id가 들어가면 시계열이 row당 하나씩 생겨 + 메트릭 백엔드가 죽고, 동시에 PII가 로그/메트릭/에러 응답 세 곳에 복제된다. 여기서는 **생성자가 + 거부하므로 규율이 아니라 타입이 보장한다.** `JpaFailureContext:51-53`의 + "completion unknown failures are never retryable" 불변식도 같은 성질 — 설정으로 뒤집을 수 없다. +- **언제 재검토**: 재검토 대상 아님. fork가 자기 코드에도 이 패턴을 복사하는 게 맞다. + +### K7. 실제 PostgreSQL 계약 테스트 78개를 유지하는 것 — **확정 (본문 78/78 정독 후)** + +1차 리뷰에서는 파일명만 보고 Keep에 올렸다. 78개 전부를 읽고 **확정한다.** 다만 근거를 정확히 +좁혀서 쓴다 — "CRUD를 도는가, 진짜 벤더 계약을 잡는가"에 대한 답은 **대부분 후자, 일부는 아니다.** + +- **무엇**: `src/postgresqlIntegrationTest` 78파일 15,746줄. Testcontainers로 진짜 PG를 띄운다. + `PostgreSqlContainerFactory:assertDockerAvailable()`이 **Docker 부재를 skip이 아니라 에러로** + 처리한다(*"a suite that quietly skips when Docker is missing reports success on a machine that + verified nothing"*). `JpaPlatformContractSupport:72-86`은 **다중 버전 선택을 거부**한다 — + `-Pjpa.matrix.versions=16,17,18`을 주면 첫 번째만 돌고 세 버전 커버리지를 보고하던 사고가 있었다. + +- **진짜 벤더 계약인가 — 근거**: 단위 테스트로 대체 불가능한 것만 골라 돈다. + - **SQLSTATE를 서버가 실제로 보낸 값으로** 확인: `platform/PostgreSqlSqlStateContractTest:93-98` + (*"a real check violation is 23514 on PostgreSQL, not H2's 23513"*), `:101-106`(23503), + `platform/PostgreSqlConcurrencyFailureContractTest:57-76`(두 스레드 역순 락 → 서버가 victim을 + 고르고 40P01). + - **커밋 소실**: `platform/CommitAmbiguityContractTest:100-115` — `pg_terminate_backend`로 커밋 + 도중 백엔드를 죽이고 **57P01**이 오는 것을 확인. 주석 `:105-108`이 핵심이다 — + *"not class 08, which is what a reasonable reading of 'the connection broke' predicts."* + 이건 mock으로는 원리적으로 못 만든다. + - **락 semantics**: `platform/PostgreSqlPessimisticLockContractTest` — NOWAIT(즉시 55P03)와 + 대기 후 `lock_timeout` 만료(≥200ms)를 **경과 시간으로** 구분. + `platform/PostgreSqlWorkClaimContractTest` — 두 열린 트랜잭션이 `FOR UPDATE SKIP LOCKED`로 + 서로소 행을 가져가고 **블록되지 않음**을 확인. + - **DDL 제약**: `platform/PostgreSqlMigrationUpgradeContractTest:55-81` — `CREATE INDEX + CONCURRENTLY`가 트랜잭션 안에서 거부되고 밖에서 성공. H2에는 이 제약이 없다. + - **권한/격리/TLS**: `platform/PostgreSqlSecurityContractTest`(42501로 DDL 거부), + `experimental/RlsIsolationFailureTest`(force 안 한 RLS가 소유자에게 안 먹힘, 세션 스코프 + `set_config`가 풀 커넥션으로 다음 테넌트에 샘), + `readiness/PostgreSqlSecurityBaselineIntegrationTest`(verify-full이 호스트 불일치·만료 인증서· + 미신뢰 CA를 거부 — 실제 openssl로 CA를 만들어 서버를 띄운다). + - **마이그레이션**: `readiness/PostgreSqlBaseStreamUpgradeIntegrationTest` — 이전 릴리스 버전으로 + 한 번 마이그레이션 → 행 seed → 현재까지 업그레이드 → **그 행이 살아남았는지** 확인. + 같은 파일 `:118-148`에 "seed 행을 지우면 시나리오가 실패한다"는 **메타 테스트**까지 있다. + `readiness/PostgreSqlOptionalStreamLifecycle:56-65`는 `capability_schema_registry`를 ACCESS + EXCLUSIVE로 잡고 `lock_timeout=250ms`에서 마이그레이션이 200ms~3s 사이에 **실패하는지** 본다. + - **프로덕션 매핑 검증**: `readiness/PostgreSqlDefaultPersistenceUnitIntegrationTest:79-92`가 + `PersistenceJpaConfig`의 `@EntityScan` basePackages를 **리플렉션으로 읽어와** 실제 마이그레이션 + 스키마에 `hbm2ddl=validate`를 건다. 목록을 손으로 안 적었으므로 패키지가 늘어도 커버된다. + +- **다만 이건 사실대로 적는다 — 세 가지 한계**: + 1. **프로덕션 SQL을 그대로 돌리는 건 소수다.** 프로덕션 상수/클래스를 import해서 도는 것: + `notification/RecipientClaimContractTest`(`RecipientClaimSql.CLAIM_BATCH`를 import해 + placeholder만 바꿔 실행 — `:36-38`에 *"Retyping the SQL here would prove that two authors + agreed about a query rather than that the query is right"*), + `readiness/PostgreSqlIdempotencyIntegrationTest`(`PostgreSqlOwnerSafeIdempotencyStore`), + `readiness/PostgreSqlInboxIntegrationTest`(`PostgreSqlSameStoreInboxAdapter`), + `readiness/PostgreSqlOutbox{Polling,Storage}IntegrationTest`(`PostgreSqlImmutableOutboxAppendAdapter`, + `PostgreSqlPollingDeliveryAdapter`), `readiness/PostgreSqlTransactionIntegrationTest` + (`SpringTransactionPort` + `PostgreSqlLocalTimeoutConfigurer` + `PersistenceExceptionTranslator`), + `readiness/PostgreSqlRecipientLeaseFencingIntegrationTest`(`RecipientDeliveryJpaRepository`의 + 실제 `@Query`), `readiness/PostgreSqlFileserver*`(`Jpa*Store` 9개). + 반대로 **SQL을 테스트에 다시 타이핑한** 것: `operation/DurableOperationStoreContractTest` 전체 + (`DurableOperationJpaRepository`의 네이티브 `@Query` 7개를 통째로 재작성), + `notification/LateEventBindingContractTest:127-142`("The adapter's two statements"라고 써놓고 + 재작성), `notification/WorkerCrashRecoveryContractTest`(복구 판정 쿼리 재작성), + `readiness/PostgreSqlInboxCutoffIntegrationTest:86-105`. **재작성본은 어댑터가 바뀌어도 녹색이다.** + 2. **10개 파일은 프로덕션 엔티티가 아니라 테스트 fixture 엔티티로 스키마를 만든다** — + `platform/JpaPlatformEntityManagerSupport:65-79`가 `hibernate.hbm2ddl.auto=create`로 + `SequenceEntity`/`IdentityEntity`/`PagedParent`/`MappingEntity`/`AuditedDocument` 같은 + testFixtures 엔티티에서 스키마를 만든다. N+1, 배치, Envers, 값 매핑, 컬렉션 페이지네이션 계약이 + 여기 속한다. **Hibernate 동작의 증거로는 유효하지만, 이 leaf의 프로덕션 매핑 증거는 아니다.** + (30개는 실제 Flyway 마이그레이션을 적용하고, 프로덕션 엔티티를 직접 만지는 건 4개다.) + 3. **조립은 전혀 못 본다** — §4.5. 78개 전부 스프링 auto-config 경로를 타지 않고, 5개는 + 주석으로 그렇게 한다고 명시한다. + +- **왜 그래도 Keep인가**: 한계 1·2는 "커버리지가 생각보다 좁다"는 문제지 "잘못된 증거"가 아니다. + 이 레인이 없으면 §3에서 본 사고 두 건(`request_hash char(64)` vs `varchar(64)`, 알림 엔티티가 + 존재하지 않는 테이블을 요구)은 Compose 레인에서 4분씩 태우며 발견됐을 것이고, `CommitAmbiguity`· + `RlsIsolationFailure`·`SecurityBaseline` 급 계약은 아예 만들 수 없다. **지우면 대체재가 없다.** +- **언제 재검토**: 실행 시간이 CI 예산을 넘을 때. 그때도 지우지 말고 레인을 분리하고 nightly로 미는 게 맞다. + 이번 리팩토링이 **오히려 6개를 추가하고 있다**(→ §7). +- **개선 제안(Keep을 약화시키지 않는 선에서)**: 한계 1을 좁혀라. `DurableOperationStoreContractTest`가 + `DurableOperationJpaRepository`의 `@Query` 값을 리플렉션으로 읽어 돌면 + `RecipientClaimContractTest`와 같은 등급이 된다. 현재 이 어댑터는 **스캔에도 안 걸리므로**(H2) + "조립되지 않은 컴포넌트의 복사된 SQL을 검증"하는 상태다. + +### K8. 마이그레이션 SQL에 "왜"를 쓴 것 +- **무엇**: `V10:6-18`, `V13:1-3`, `jpa/notification-platform/V4:84-99,101-108,115-124,157-168`, + `jpa/fileserver/V3:1-16`, `V4:1-17`, `jpa/notification-platform/V10:181-201` — 마이그레이션마다 + 어떤 사고를 막으려는지, 왜 V1을 고치지 않고 앞으로 나아갔는지를 적었다. +- **왜 지금 이게 맞는가**: 마이그레이션은 **한 번 적용되면 checksum이 약속**이므로 되돌릴 수 없다. + 6개월 뒤 "이 컬럼 왜 varchar지"를 묻는 사람에게 답을 주는 유일한 수단이 이 주석이다. + `jpa/idempotency/V2:9-11`의 한 줄이 특히 좋다 — "Editing V1 in place would have been smaller and + wrong: an applied migration's checksum is a promise to every deployment that already ran it." +- **언제 재검토**: 재검토 대상 아님. + +### K9. `.imports` 파일을 **열어서** 짝을 확인하는 테스트 *(2차 정독에서 추가)* +- **무엇**: `src/test/.../autoconfigure/PersistenceJpaAutoConfigurationTest.java:62-72` — + `META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports`를 클래스패스에서 + 읽어 `PersistenceJpaAutoConfiguration`과 `PersistenceJpaRuntimeConfig` 두 이름이 들어 있는지 단언한다. +- **왜 지금 이게 맞는가**: 이 저장소에서 **auto-config 등록 여부를 실제로 검사하는 유일한 장치**다. + 같은 검사가 없어서 redis capability는 `.imports`에 안 실려 완전히 죽었고 + (`RedisCapabilityConfig` main 참조 0건), httpclient는 스캔 제외에 안 들어가 샜다(→ H4-A). + 세 줄짜리 파일 읽기가 두 건의 사고를 막는다. +- **언제 재검토**: 확장할 때다. 지금은 "이 두 개가 들어 있다"만 보는 **단방향** 검사다. + 반대 방향(`.imports`의 모든 항목이 마스터 스위치 아래 있는가)과 교차 방향(스캔 제외 정규식 ↔ + `.imports` 패키지 집합)이 §4.5 권고 2·3이다. **지우지 말고 늘려라.** + +### K10. "아무것도 못 찾아서 통과"를 막는 비공허(non-vacuity) 검사 *(2차 정독에서 추가)* +- **무엇**: ArchUnit `noClasses()` 규칙은 매칭이 0건이면 **통과한다.** 이 저장소는 그걸 세 곳에서 + 명시적으로 막는다. + - `src/test/.../JpaModuleBoundaryTest.java`의 `importActuallyLoadedTheProductionClasses` — + *"a location filter that silently matched no output would report four green module-boundary + checks for a platform nobody examined"*. 실제로 이 검사 때문에 `java-test-fixtures` 도입 후 + 클래스패스가 jar로 바뀌어 코퍼스가 비었던 사고가 **실패로** 드러났다(`:282-287` 주석). + - `app-bootstrap/.../JpaProductionArchitectureTest.java:29-49`의 `theImportFoundTheProductionGraph` — + 엔티티 수 > 0, 웹 타입 수 > 0을 먼저 단언한다. + - `src/test/.../testkit/JpaAuditMechanismRuleTest` — 프로덕션 그래프에 위반 사례가 없으므로 + 규칙을 그래프에 돌리면 항상 초록이다. 그래서 실패 케이스를 **직접 만들어** 돌린다. +- **왜 지금 이게 맞는가**: 이 leaf에서 가장 비싼 실수는 "검사가 있다고 믿었는데 아무것도 안 봤다"이고 + (H9의 SQL 검사기, H10의 테넌트 규칙, `PoolLaneClaimTest`가 기록한 성능 게이트 사고), + 비공허 검사가 그걸 막는 유일한 수단이다. +- **언제 재검토**: 없음. 오히려 **H10의 `allowEmptyShould(true)`가 이 원칙의 예외**이고, + 그게 H10이 (a)인지 (b)인지 모르게 만드는 이유다. 예외를 없애는 방향이 맞다. + +--- + +## 7. 커밋 안 된 리팩토링이 이 영역에 미친 영향 + +**정정 반영:** `full.diff`는 `git diff HEAD`라 untracked를 포함하지 않는다. 이 leaf의 실제 변경은 +tracked 7파일(수정) + **untracked 18파일 2,320줄(신규)** 이다. + +### 이건 삭제가 아니라 조립 소유권 이전이다 + +스펙이 명시한다 — `docs/superpowers/specs/2026-09-18-jpa-capability-composition-ownership.md:3-6`: +"Move reusable relational-persistence Spring composition from app-bootstrap into +adapter:outbound:persistence-jpa without moving application deployment policy into the adapter and +without expanding the JPA public API surface." + +### 무엇이 어디로 갔나 — 파일 단위 대조 + +| bootstrap에서 삭제(D) | leaf로 신규(untracked) | 대조 결과 | +|---|---|---| +| `bootstrap/autoconfigure/jpa/JpaTransactionAutoConfiguration.java` | `persistence/autoconfigure/JpaTransactionAutoConfiguration.java` (117줄) | **본문 동일.** 차이는 `public final class`→`final class`, `public` 생성자→package-private 뿐(diff 8줄, 전부 가시성) | +| `bootstrap/autoconfigure/jpa/JpaObservabilityAutoConfiguration.java` | `persistence/autoconfigure/JpaObservabilityAutoConfiguration.java` (80줄) | **본문 동일.** 차이는 가시성 + 포맷팅(diff 9줄) | +| `bootstrap/.../PostgreSqlIdempotencyProviderConfig.postgreSqlOwnerSafeIdempotencyStore()` (메서드 삭제) | `persistence/autoconfigure/PostgreSqlIdempotencyStoreConfig.java` (21줄, 신규) | 빈 정의 이동. 조건(`provider=postgresql`)은 동일 | +| `bootstrap/.../JpaPlatformRuntimeAutoConfiguration`의 빈 5개 삭제 (`hibernateProviderPolicy`, `postgreSqlRuntimeRoleVerifier`, `jpaTransactionExecutor`, `jpaRetryCoordinator`, `jpaRetryEventListener`) | `persistence/autoconfigure/PersistenceJpaRuntimeConfig.java` (73줄, 신규) | **본문 동일, 조건이 달라짐 → H4** | +| — | `persistence/autoconfigure/PersistenceJpaAutoConfiguration.java` (26줄, 신규) | 신규. leaf가 Boot 진입점을 갖게 됨 | +| — | `META-INF/spring/...AutoConfiguration.imports` (2줄, 신규) | 위 두 클래스 등록 | +| `app-bootstrap/src/integrationTest/.../IdempotencyUniqueScopeContractTest.java` (D) | `persistence-jpa/src/postgresqlIntegrationTest/.../PostgreSqlIdempotencyUniqueScopeIntegrationTest.java` (191줄, 신규) | 이동. 본문 미대조(§9) | + +### 판정 1 — 순수 손실: **없음** + +이 leaf에서 삭제된 production/test 파일은 0개다. `git status --porcelain`의 ` D` 라인에 +`persistence-jpa` 경로가 하나도 없다. bootstrap 쪽 삭제 3건은 전부 leaf에 대응물이 있다. + +### 판정 2 — 중복 조립: **없음 (깔끔함)** + +빈 정의가 양쪽에 남은 경우가 없다. `JpaPlatformRuntimeAutoConfiguration`은 이동한 5개 빈의 `@Bean` +메서드와 import를 **같은 커밋에서 정확히 제거**했고(`-import ... VendorFailureTranslator` 등), +`PostgreSqlIdempotencyProviderConfig`도 `-import PostgreSqlOwnerSafeIdempotencyStore`와 +`-import JdbcOperations`까지 지웠다. 남은 `JpaPlatformAutoConfiguration`은 `HibernateProviderPolicy`· +`PostgreSqlRuntimeRoleVerifier`를 **생성자 인자로 받기만** 한다(소비자). 이동이 반쪽이 아니다. + +### 판정 3 — 이동 중 발생한 회귀: **2건** + +1. **마스터 스위치 상실 (H4).** 이동 전 5개 빈은 `PersistenceJpaRootAutoConfiguration`의 + `@ConditionalOnProperty(ca-skeleton.persistence-jpa.enabled=true)` 아래 있었다. + 이동 후 `PersistenceJpaRuntimeConfig`는 독립 auto-config가 되면서 그 조건을 잃었다. + **스펙 `:41`이 금지한 바로 그것**이고, 신규 테스트가 그 상태를 정답으로 고정했다. +2. **관측 조립이 도달 불가가 됐다 (M10).** `JpaObservabilityAutoConfiguration`은 이동 전 + `public`이라 애플리케이션이 직접 호출할 수 있었다. 이동 후 package-private가 되어 + **leaf 밖에서 호출할 방법이 없고, leaf 안에서도 호출자가 없다.** + `verifyJpaApiSurface`를 안 키우려는 목적(스펙 `:38`)은 달성했지만, 조립 경로를 같이 안 만들어서 + 기능이 닫혔다. +3. (부수) **`liveevent`에 미등록 프로퍼티 2개가 생겼다 (M3).** + `JpaLiveEventReplayAdapter`가 이번에 `@ConditionalOnProperty(ca-skeleton.realtime.replay.enabled)`와 + 기본값 없는 `@Value("${ca-skeleton.realtime.replay.retention}")`를 얻었다. 두 키 모두 + 설정 트리에도 env-keys.yaml에도 없다. 게다가 이 클래스는 애초에 스캔이 안 닿는다(H2) — + **죽은 빈을 더 죽게 만들면서 필수 프로퍼티만 하나 늘렸다.** + +### 판정 4 — `git add` 없이 커밋하면 사라지는 것: **2,320줄 전부** + +이 leaf의 신규 18파일은 **전부 untracked**다. 그중 production 6파일(317줄)이 빠지면: +- `META-INF/spring/...imports`가 없어져 `PersistenceJpaAutoConfiguration`이 로드되지 않는다 + → **JPA capability 전체가 조립되지 않는다** +- 동시에 bootstrap 쪽 빈 정의는 이미 삭제된 상태이므로 → **되돌아갈 곳도 없다** + +즉 **부분 커밋이 곧 전체 기능 상실**이다. `build.gradle`과 `CLAUDE.md`와 +`JpaModuleBoundaryTest`(=tracked, 이미 `autoconfigure` 패키지를 카탈로그에 추가함)는 tracked라 +먼저 커밋될 수 있는데, 그러면 컴파일은 되지만 런타임에 아무것도 조립되지 않는다. + +### 판정 5 — 안전망 방향: **늘었다** + +이 leaf의 신규 테스트 8파일(1,656줄) 중 **실제 PostgreSQL 통합테스트가 6개 1,415줄**이다: + +``` +PostgreSqlLegacyOutboxRowLifecycleIntegrationTest 720 +LegacyOutboxIntegrationSupport 207 +PostgreSqlIdempotencyUniqueScopeIntegrationTest 191 +PostgreSqlLegacyOutboxConcurrentRelayIntegrationTest 166 +PostgreSqlDistributedLockIntegrationTest 149 +PostgreSqlIntLockMigrationCompatibilityIntegrationTest 109 +PostgreSqlLegacyOutboxAppendTransactionalIntegrationTest 73 +``` + +**"실제 PostgreSQL로 벤더 동작을 검증하는 레인이 깎였다"는 결론은 이 영역에 대해 성립하지 않는다. +반대로 78 → 84개로 늘고 있다.** 특히 legacy 아웃박스 3종(row lifecycle / concurrent relay / +transactional append)은 §5 H7이 지적한 "트랜잭션 경계 강제 부재"와 정확히 같은 지점을 진짜 DB로 +검증하려는 시도로 보인다(본문 미독 — §9). + +### 종합 판정 + +> **유지보수 부담 감소도 안전망 절단도 아니다. "capability가 자기 조립을 소유한다"는 아키텍처 정리이고, +> 방향은 옳다.** Clean Architecture 관점에서도 옳다 — 어댑터가 자기 Spring 조립을 갖는 것은 +> 컴포지션 루트의 책임을 침범하는 게 아니라, 컴포지션 루트가 어댑터 내부 타입 22개를 이름으로 알던 +> 상태(leaf CLAUDE.md의 신규 절이 서술)를 되돌리는 것이다. +> +> **단, 이동 도중의 지금 상태는 일관적이지 않다.** 조건 하나(H4)와 가시성 하나(M10)가 이동 중에 +> 의미를 잃었고, 두 개 다 신규 코드/신규 테스트가 그 상태를 정답으로 굳혔다. +> 커밋 전에 고쳐야 한다 — 커밋 후엔 "원래 그랬다"가 된다. + +--- + +## 8. 템플릿 사용자 관점 + +fork해서 이 영역을 쓰는 사람이 순서대로 겪을 일. + +### 첫날: 켜기 + +1. `APP_PERSISTENCE_JPA_ENABLED=true`, `APP_DATASOURCE_*` 4개를 준다. `docker compose`로 PG 5433을 띄운다. +2. `./gradlew :app-bootstrap:bootRun`. Flyway가 `db/migration/postgresql` 13개를 적용한다. +3. **여기서 `durable_operation`, `live_event_log`, `INT_LOCK`, `capability_schema_registry`, + `outbox_event`, `idempotency_record`가 전부 생긴다.** 쓰든 안 쓰든. + +### 밟게 될 지뢰 + +**지뢰 1 — 옵션 capability를 켜면 기동이 죽는다 (의도된 것이지만 안내가 없다)** + +`app.fileserver-platform.enabled=true`를 주면: +``` +jpa-fileserver-metadata-v1 is not ACTIVE at core epoch 1 revision 2. +Apply db/migration/jpa/fileserver against history table flyway_jpa_fileserver_history +and promote the capability before enabling app.fileserver-platform.enabled +``` +(`fileserver/FileserverSchemaActivation.java:60-66`) + +메시지는 훌륭하다. **문제는 그 "Apply and promote"를 해주는 도구가 저장소에 없다는 것이다.** +- `NotificationSchemaStream.migrate()`는 알림 전용이고 `main`에서 호출되지 않는다 +- fileserver/idempotency/inbox/outbox-storage/outbox-polling에는 그런 클래스조차 없다 +- `capability_schema_registry`의 `lifecycle_state`를 `INSTALLED_INACTIVE` → `ACTIVE`로 올리는 + SQL/스크립트도 없다. 운영자가 손으로 `UPDATE`를 쳐야 한다 + +→ **fork 사용자가 첫날 막히는 지점이 여기다.** 스트림 6개 × (Flyway 수동 실행 + 수동 promote). + +**지뢰 2 — 벤더 오타가 엉뚱한 곳에서 터진다 (H1)** + +`ca-skeleton.persistence.vendor=postgres`라고 쓰면 Flyway 중복 버전 에러가 난다. +문서 두 곳이 "enum이라 startup failure"라고 약속한 것과 다르다. + +**지뢰 3 — `bootRunH2`로 개발하면 재시도가 동작하지 않는다 (H5)** + +그리고 `INT_LOCK`, `capability_schema_registry`, inbox/polling 테이블이 없으므로 +`multi-instance-enabled=true`나 옵션 capability를 켜면 즉시 깨진다. +leaf CLAUDE.md `:127-131`이 이 사실은 정직하게 적어놨다. + +**지뢰 4 — 아웃박스를 안 써도 리퍼가 돈다 (C1)** + +`ca-skeleton.outbox.enabled=false`로 두고 `outbox_event`를 다른 용도로 재활용하면 데이터가 삭제된다. + +**지뢰 5 — 자기 엔티티에 연관관계를 넣는 순간, 이 leaf의 관례와 갈라진다** + +이 leaf는 K1대로 연관관계를 안 쓴다. fork가 자기 애그리거트에 `@OneToMany`를 넣으면 +N+1과 LazyInitializationException이 **처음으로** 등장한다. 그때 쓰라고 있는 도구가 +`springdata/EntityGraphCatalog`·`FetchPlanApplier`·`SafeSortRegistry`인데, +**어느 것도 조립돼 있지 않으므로 직접 빈으로 만들어야 한다.** +`hibernate.jdbc.batch_size`/`default_batch_fetch_size`도 직접 넣어야 한다(M11). + +**지뢰 6 — 공개 API 291개** + +`docs/architecture/jpa-api-surface.txt`가 341개 타입을 baseline으로 잠근다. +fork가 leaf 내부를 정리하려 하면 `verifyPublicPathSnapshot` 계열이 걸린다. + +### 손대야 하는 파일 (최소 경로) + +| 목적 | 파일 | +|---|---| +| capability 켜기 | `src/app-bootstrap/src/main/resources/config/{persistence,outbox,idempotency,capabilities}.yml` | +| 옵션 스트림 적용 | `db/migration/jpa/*` 를 손으로 Flyway 실행 + `capability_schema_registry` UPDATE | +| 도메인 엔티티 추가 | 새 패키지 + `config/PersistenceJpaConfig.java`의 `@EntityScan`/`@EnableJpaRepositories` 목록 **두 곳 다** (`PersistenceEntityScanCoverageTest`가 누락을 잡는다) | +| 도메인 컴포넌트 추가 | `config/JpaAdapterComponentsConfig.java:60-67` — **여기를 빠뜨리면 H2와 같은 사고가 난다** | +| 마이그레이션 추가 | `db/migration/postgresql/V14__*.sql` — V2/V7/V8은 쓸 수 없다(H8) | +| env 키 추가 | `docs/registries/env-keys.yaml` + `./gradlew :app-bootstrap:verifyEnvKeys` | +| 샘플 제거 | `sample-portfolio` 삭제 시 `modules.json`·`settings.gradle`·`db/sample-migration` 정리 | + +### 이 영역을 실무에 도입할 것인가 — 판정 + +**조건부 YES.** + +- **강점이 진짜다.** 동시성 제어(조건부 UPDATE + fencing token), 진단 바운딩, 실제 PG 계약 테스트 78개, + 마이그레이션에 이유를 적는 규율 — 이 네 가지는 대부분의 사내 백엔드보다 낫다. +- **약점은 "완성되지 않은 플랫폼"이다.** 28,500줄 중 절반이 소비자 0인 도구상자이고, + 그 도구상자가 문서에서는 "Stable capability"로 보고된다(M10). 운영자가 액추에이터를 믿으면 안 된다. +- **도입 전 반드시 고쳐야 하는 것: C1, H1, H2, H4, H7.** 다섯 개 다 수정이 작다(조건 애노테이션 + 추가, 스캔 목록 2줄, 가드 3줄). H3는 fork의 outbox 규모에 따라 즉시/나중이 갈린다. + **H10은 먼저 한 줄 확인(§9 표)이 필요하다** — 결과에 따라 "9건 수정"이거나 "가드 술어 수정"이다. +- **2차 정독 후 판정을 하나 더 붙인다 — 이 다섯 개가 전부 같은 종류다.** C1·H2·H4는 조립 결함이고, + H1은 조립되지 않은 프로퍼티 바인딩이며, H7은 조립(트랜잭션 프록시) 의존인데 그 의존을 선언하지 + 않은 것이다. **부품 품질은 상위권인데 조립 검증이 228개 중 2개다**(§4.5). 도입 시 가장 먼저 + 넣어야 할 것은 새 기능이 아니라 §4.5 권고 1~3의 조립 게이트 3개다 — 셋 다 스프링 컨텍스트 없이 + 리플렉션만으로 되고, 저장소에 이미 같은 기법의 선례가 3개 있다 + (`CandidateAdapterCompositionTest`, `AuditingCandidateStatusTest`, `PersistenceEntityScanCoverageTest`). +- **fork 첫 주에 해야 할 일: 옵션 스트림 적용/승격 스크립트를 직접 만드는 것.** 이게 없어서 막힌다. + +--- + +## 9. 미확인 / 가정 + +빌드를 돌리지 않았다(브리프 규칙: Gradle wrapper jar가 스냅샷에 없음). 아래는 **정적 분석으로만 도달한 +결론**이고, 확인 명령을 함께 적는다. + +### 빌드/런타임으로만 확정 가능한 주장 + +| 주장 | 확인 명령 | +|---|---| +| C1 — JPA on + outbox off에서 `OutboxReaper` 빈이 실제로 생성되고 `@Scheduled`가 등록된다 | `./gradlew :app-bootstrap:test --tests '*OutboxReaper*'` 후, `ApplicationContextRunner`에 `ca-skeleton.outbox.enabled=false`를 주고 `hasSingleBean(OutboxReaper.class)`를 확인하는 케이스 추가 | +| H1 — `vendor=postgres`에서 두 벤더 설정이 모두 꺼지고 Flyway가 중복 버전으로 실패한다 | `APP_PERSISTENCE_VENDOR=postgres ./gradlew :app-bootstrap:bootRun` (PG 컨테이너 필요) | +| H2 — `DurableOperationStoreAdapter`/`JpaLiveEventReplayAdapter`가 실제 컨텍스트에 빈으로 없다 | `./gradlew :app-bootstrap:test --tests 'dev.caskeleton.bootstrap.architecture.*'` + 두 포트에 대한 `doesNotHaveBean` 단언 추가 | +| H3 — V13의 6개 CHECK가 `ACCESS EXCLUSIVE`를 잡는다 | PG에서 `EXPLAIN` 불가. `SELECT relname, mode FROM pg_locks JOIN pg_class ...`를 마이그레이션 중 다른 세션에서 관측하거나, 대량 데이터를 넣고 `\timing`으로 측정 | +| H4 — JPA off에서 3개 빈이 남는다 | `./gradlew :adapter:outbound:persistence-jpa:test --tests '*PersistenceJpaRuntimeConfigTest*'` — 현재 테스트가 **남는 것**을 단언하므로 통과할 것이다. 반대 단언을 추가해 실패를 확인하는 게 검증이다 | +| **H10 — 테넌트 규칙이 빨간가, 공허 통과인가** | `./gradlew :app-bootstrap:architectureTest --tests 'dev.caskeleton.bootstrap.architecture.JpaProductionArchitectureTest.noTenantScopedRepositoryInheritsBroadCrud' --console=plain -i` — **빨강이면 (a), 초록이면 (b)**. 이번 라운드 최우선 확인 항목 | +| M7 — `notificationSchemaActivation` 빈 생성이 Flyway보다 먼저 일어날 수 있다 | `APP_NOTIFICATION_PLATFORM_ENABLED=true`로 빈 DB에 기동. Flyway 순서 문제면 "registry is unreadable"이 뜬다 | +| 미등록 env 키(M3)를 `verifyEnvKeys`가 잡는지 | `./gradlew :app-bootstrap:verifyEnvKeys --console=plain` | +| 의존 방향(§4) | `./gradlew architectureCheck --console=plain` | +| 공개 표면(M13) | `./gradlew :adapter:outbound:persistence-jpa:verifyJpaApiSurface` | +| SQL 안전성 검사기(H9)가 `check`에 없다 | `./gradlew :adapter:outbound:persistence-jpa:check --dry-run --console=plain` — 태스크 목록에 `verifyJpaSqlConstructionSafety`가 없을 것 | + +### 세운 가정 + +1. **`javax.sql.DataSource`는 항상 클래스패스에 있다** (JDK `java.sql` 모듈). 따라서 + `PersistenceJpaRuntimeConfig`의 `@ConditionalOnClass`는 무조건 참이다. Java 21 기준 확실하나 + 모듈 경로를 커스터마이즈한 배포에서는 다를 수 있다. +2. **`app.jpa-platform.addons-enabled`는 어느 프로퍼티 소스에도 없다.** `src/**` 전수 grep 결과 + `main` 소스 정의는 `JpaSafetySettings.java:21`의 `@ConfigurationProperties(prefix)` 뿐이고, + yml에는 없다. 외부 env로 주입될 가능성은 배제하지 못한다. +3. **Flyway가 `classpath:db/migration`을 재귀 스캔해 중복 버전에 실패한다** — Flyway의 표준 동작이고 + `db/migration/jpa/core/V2__widen_capability_schema_stream.sql`과 + `db/migration/postgresql/V9`가 "같은 widening을 두 위치에서 한다"고 명시한 것이 방증이나, + 실제 실패 메시지는 확인하지 않았다. +4. **PostgreSQL에서 `ADD CONSTRAINT ... CHECK`(NOT VALID 없음)가 ACCESS EXCLUSIVE + full scan** — + PostgreSQL 문서의 표준 동작이고, 이 저장소 자신이 `jpa/notification-platform/V4:164-168`에서 + 같은 내용을 서술한다. +5. **Flyway가 PostgreSQL에서 advisory lock으로 다중 인스턴스 동시 마이그레이션을 직렬화한다** — + Flyway의 표준 동작. 따라서 `APP_MIGRATION_ON_STARTUP=true` + 멀티 인스턴스 동시 기동 자체는 + **데이터 관점에서 안전하다.** 위험은 가용성이다(H3): 락 대기 동안 나머지 인스턴스의 기동이 + 블록되고 readiness가 늦어진다. **이 저장소는 그 위험을 스스로 알고 있으면서 + (`migration/FlywaySchemaPolicy.java:13-17` — "migrating from inside the application means every + instance of a rolling deploy races to apply the same script") 그 정책 클래스의 `modeFor()` 맵을 + 아무데서도 쓰지 않는다** (`JpaDangerousConfigurationGuard.java:63`이 `requirePermittedDdlAuto`만 호출). + 즉 "prod는 VALIDATE_ONLY"라는 선언은 장식이다. + +### 읽지 않아 판정하지 못한 것 — **해소됨 (2차 정독 완료)** + +1차 리뷰가 미독으로 남겼던 항목의 현재 상태: + +| 1차에 남긴 항목 | 결과 | +| --- | --- | +| `testFixtures` 40개, 특히 `JpaAuditMechanismRule` | 읽음. 규칙 6개 전부 `app-bootstrap/.../JpaProductionArchitectureTest`에서 실행된다. `JpaAuditMechanismRule`은 "감사 엔티티의 bulk update가 감사 컬럼을 찍는가"를 강제하고, 실패 케이스를 `src/test/.../testkit/JpaAuditMechanismRuleTest`가 직접 돌린다(그래프에 위반 사례가 없어 공허 통과하는 걸 막으려고). **M9는 유효하나, 규칙이 없다는 뜻은 아니다** — 두 메커니즘 중 하나만 쓰도록 강제는 돼 있다 | +| 신규 통합테스트 6개가 H7을 커버하는가 | **아니다.** H7(트랜잭션 없으면 dirty checking이 no-op)은 `OutboxStoreAdapterTest`가 mock 리포지토리로 엔티티 필드 변화만 단언한다(`markPublished/markFailed/markDead`에 `verify(repo).save(...)`가 없다 — `append`에는 있다). mock이므로 영속 컨텍스트 요구 자체가 관측 불가 | +| `PostgreSqlMigrationIntegrationTest`가 H3(NOT VALID 누락)를 잡는가 | **아니다.** 이 파일은 legacy 채택(`flyway_schema_history`가 정확히 `1,3,4,5,6,9,10,11,12,13`)을 단언해 **H8(결번 V2/V7/V8)을 오히려 독립 확인**해준다. 락 시간 검증은 있으나(`:136-180`) 전용 fixture(`db/readiness/rolling`) 대상이고 프로덕션 V13이 아니다. 빈 테이블에 CHECK를 붙이면 스캔이 즉시 끝나므로 H3는 이 레인에서 원리적으로 안 보인다 | +| `JpaModuleBoundaryTest` 전문 | 읽음. **Keep 급이다** — 패키지 카탈로그 22개를 디스크와 정확히 대조하고, 관측된 패키지 간 간선을 전부 선언 목록과 비교하고, DAG인지 확인하고, **공허 통과 방지 검사**(`importActuallyLoadedTheProductionClasses`)까지 있다. 다만 검사 대상이 **패키지 의존 간선**이지 스프링 빈 등록이 아니다(→ §4.5) | +| `JpaDocumentationContractTest`가 M2를 잡는가 | **부분.** `docs/jpa/support-matrix.md`가 레지스트리의 provider baseline·게이트 목록과 일치하는지는 잡는다. M2(local 프로파일 주석 드리프트)는 `application-local.yml` 주석이므로 범위 밖 | +| `notification/platform` 개별 SQL 정합성 | 읽음 → M16~M20, H10 | +| 삭제된 `IdempotencyUniqueScopeContractTest` ↔ 신규 `PostgreSqlIdempotencyUniqueScopeIntegrationTest` | 신규본 읽음. 프로덕션 조합(`StandardSqlStateErrorMapping` + `PostgreSqlSqlStateErrorMapping`)으로 실제 PG의 23505를 분류하는 2개 계약. 이동 손실 없음 | + +**여전히 미확인인 것**(읽어서 해소되지 않고, 빌드 실행이 필요한 것): + +- **H10의 (a)/(b) 분기** — `tenantScopedRepositoriesDoNotInheritBroadCrud()`가 지금 빨간지, 아니면 + 술어가 9건을 못 잡아 공허 통과하는지. H10 본문의 명령 한 줄로 결정된다. **이게 이번 라운드에서 + 남은 가장 큰 미확인이다.** +- `src/config/jpa/readiness-cards.yaml` 28KB 중 앞 70줄만 읽음(빌드 태스크 배선 목록이라 H9 판정에 + 필요한 부분은 확인함). +- `src/testFixtures`의 `CommitAmbiguityProxy`는 읽었으나, 이걸 쓰는 테스트가 없다는 것까지만 확인했고 + (grep 0건) 왜 남겼는지는 모른다 — M22와 같은 성격일 가능성이 높다. diff --git a/docs/reviews/2026-09-18-techlead-review/06-persistence-mongo.md b/docs/reviews/2026-09-18-techlead-review/06-persistence-mongo.md new file mode 100644 index 00000000..3cc5d392 --- /dev/null +++ b/docs/reviews/2026-09-18-techlead-review/06-persistence-mongo.md @@ -0,0 +1,686 @@ +# [영역] MongoDB 영속 어댑터 리뷰 + +- 스냅샷: 2026-09-18T11:50Z / HEAD 60b6a319 + 커밋 안 된 변경 224파일 +- 담당 leaf: `adapter-outbound-persistence-mongo` (`:adapter:outbound:persistence-mongo`, `allowed_dependencies: []`) + +--- + +## 0. 최종 적용 기준 + +Mongo는 build-selected optional persistence capability다. 선택된 서비스에서 runtime switch/profile이 실제 +`MongoClientSettings`까지 전달되어야 한다. 설정 검증과 실제 driver 적용을 같은 integration path에서 +증명한다. deadline semantics와 reactive/change-stream 지원 상태는 실제 composition 기준으로 수정한다. + +## 0-A. 2026-09-21 중간 재검증 + +**상태: deadline outcome finding은 수정됨.** + +`DefaultMongoImperativeExecutor`는 callback이 이미 반환된 뒤 deadline을 초과한 write를 +`NOT_SENT`로 보고하지 않는다. `MongoTimeoutException`을 통해 write 결과를 ambiguous +`WRITE_RESULT_UNKNOWN`으로 보존한다. + +`DefaultMongoImperativeExecutorDeadlineTest.completedWritePastItsDeadlineIsAmbiguousRatherThanReportedNotSent` +가 이를 직접 검증하며, 이번 `:adapter:outbound:persistence-mongo:test`도 PASS했다. + +Mongo leaf에는 현재 root/client AutoConfiguration import가 존재하므로 composition ownership도 +원 리뷰 시점보다 진척됐다. 다만 real Mongo provider lanes의 workflow reachability와 실제 +`MongoClientSettings` profile 적용은 전체 integration 점검에서 별도로 닫아야 한다. + +## 1. 커버리지 + +| 소스셋 | 파일 | 읽음 | 비고 | +|---|---|---|---| +| `src/main/java` | 353 | 353 | 전문 | +| `src/test/java` | 98 | 98 | 전문(일부는 `import`/빈줄만 제거한 축약 덤프로 읽음 — 의미 있는 줄은 전부) | +| `src/testFixtures/java` | 27 | 27 | 전문(주석 제거 축약 포함) | +| `src/mongoProviderTestkit/java` | 8 | 8 | 4개 전문, 4개는 diff 대조 후 축약 열람 | +| `src/mongoIntegrationTest/java` | 7 | 7 | 전문 | +| `src/mongoPerformanceTest/java` | 1 | 1 | 전문 | +| 리소스 | `META-INF/spring.factories`, `AutoConfiguration.imports`, `build.gradle`, `gradle.lockfile`(변경 요약만), `README.md`, `CLAUDE.md` | 전부 | | +| 부수 파일 | `src/config/architecture/modules.json`, `src/config/mongodb/release-contracts.json`, `src/build-tools/.../buildtools/mongo/*`(11개), `src/build-logic/.../buildlogic/strictlane/*`(5개), `scripts/verify-mongodb-platform.sh`, `scripts/verify-mongodb-advanced.sh`, `src/app-bootstrap/build.gradle`, `config/persistence.yml`, `CaSkeletonApplication.java`, `CapabilityDependencyValidator.java`, `docs/registries/env-keys.yaml`(Mongo 구간), `docs/architecture/mongo-api-surface.txt`, `docker-compose.infra.yml`(mongo 구간), `src/.env.example`, `src/.env.local.example` | 전부 | | +| 설계 문서 | `docs/superpowers/specs/2026-09-18-mongo-health-composition-ownership.md`, `.../2026-09-18-test-architecture-phase2-provider-ownership.md` | 전부 | untracked. §7의 근거 | +| diff 자료 | `evidence/status.txt`, `diffstat.txt`, `full.diff`(Mongo 구간), `untracked-files.txt`, `untracked-wc.txt` | 전부 | | + +**전문을 읽지 못한 파일: 없음.** 단 `gradle.lockfile`(293줄 변경)은 diff 요약만 보고 개별 좌표를 검증하지 않았다 — 의존성 버전은 다른 담당자 영역이다. + +`docs/mongodb/*.md` 9개 문서는 목록만 확인하고 내용을 읽지 않았다. 판정에 쓰지 않았으므로 아래 발견은 전부 코드·설정 근거만 쓴다. + +--- + +## 2. 이 영역은 무엇을 하는가 + +**MongoDB용 애플리케이션 포트 구현이 아니다. 저장소 안에 벤더링된 MongoDB 플랫폼 라이브러리다.** + +코드가 말하는 사실: + +- `src/config/architecture/modules.json`의 이 leaf 항목은 `allowed_dependencies: []`다. `domain-core`도 `application-core`도 `shared-contract`도 참조하지 않는다. **즉 이 leaf는 애플리케이션 포트를 하나도 구현하지 않는다.** +- `README.md:3-6` — document/repository/mapper와 포트 구현은 fork가 추가한다. +- production 클래스 353개 중 Spring bean으로 등록되는 것은 `MongoPlatformAutoConfiguration`(443줄)이 선언하는 약 15개뿐이다. 나머지 60여 개의 진입점 타입(`SpringMongoTransactionExecutor`, `PolicyAwareMongoQueryBuilder`, `PolicyAwareMongoAggregationExecutor`, `MongoKeysetCursorCodec`, `VersionedMongoUpdater`, `SpringMongoGeospatialOperations`, `MongoMigrationRunner`, `MongoCollectionMigrationLedger`, `PolicyAwareMongoNativeGateway`, `MongoAdminGateway`, `advanced/**` 전부)은 **main 안에서 서로를 참조하지 않고, bean으로도 등록되지 않는다.** fork가 직접 조립해야 한다. + +실제로 하는 일을 층별로 보면: + +``` +api/ 프레임워크 무의존 계약 (operation 이름, consistency profile, 실행 결과, 예외 계층, BSON 표현 manifest, schema 버전) +failure/ driver 예외 → 플랫폼 예외 1회 변환 + retry scope 분류 +mapping/ Decimal128·BigInteger·DomainDocumentId converter, _class 대신 alias를 쓰는 type mapper +imperative/ blocking 실행 스코프(컬렉션 1개로 스코프 고정) + atomic/bulk 업데이트 정책 +reactive/ 동일 구조의 reactive 버전 + cursor lease/budget +transaction/ body retry와 commit retry를 분리한 코디네이터, causal session +query/ 필드·연산자 allowlist 질의 빌더, keyset pagination, HMAC 커서 +schema/ 컬렉션·인덱스·validator manifest와 diff, TTL 정책, 문서 크기 예산 +changestream/ at-least-once projector, resume checkpoint, invalidate/history-lost 처리 +migration/ fencing token 기반 lock·ledger·checkpoint runner +security/ secret:// 참조 credential, 역할 분리, D4 admin plane +observation/ driver command/pool/SDAM 메트릭, tag allowlist +advanced/** sharding·time series·CSFLE/QE·search/vector·tenancy·GridFS — 전부 flag 게이트, 대부분 값 객체 +``` + +### 브리프 질문 1에 대한 판정: (c)에 가깝고, 설계는 (b)를 준비했으며, (a)는 아니다 + +- **(a) 대안 — 아니다.** 같은 port를 두 방식으로 구현한 것이 아니다. Mongo leaf는 port를 하나도 구현하지 않으므로 고를 대상이 없다. JPA leaf와 공유하는 인터페이스가 없다. +- **(b) 역할 분담 — 설계로는 선언되어 있고, 구현은 없다.** `CLAUDE.md:21`이 명시한다: *"It does **not** reimplement idempotency / outbox / lock on Mongo (those stay JPA-only)."* 두 토글은 서로 배타가 아니다(`config/persistence.yml:12`/`:16`이 독립 불리언이고 `CapabilityDependencyValidator`는 둘의 조합을 검사하지 않는다). 즉 "RDB는 트랜잭션·아이덴포턴시·아웃박스, Mongo는 문서"라는 분담이 **문서로 선언**되어 있다. 그러나 Mongo 쪽 문서 저장 경로가 실제로 구현된 것은 없다. +- **(c) 템플릿이라 둘 다 — 현재 상태는 이것이다.** production에 도메인 타입이 0개고, bean 15개는 정책 레지스트리(대부분 비어 있는 기본값)뿐이다. + +**이 판정이 나머지 리뷰에 주는 의미:** 이 leaf는 "동작하는 영속 경로"로 평가하면 안 되고 "fork가 그 위에 구현을 얹을 라이브러리"로 평가해야 한다. 그래서 아래 발견의 무게중심은 *런타임 버그*보다 **"라이브러리가 자기 계약을 지키는가"** 와 **"fork가 켰을 때 무슨 일이 벌어지는가"** 에 있다. + +--- + +## 3. 런타임 토글 판정 — 꺼지면 정말 꺼지는가 + +### 끄는 키 + +| 키 | 프로퍼티 | 기본값 | 근거 | +|---|---|---|---| +| `APP_PERSISTENCE_MONGO_ENABLED` | `ca-skeleton.persistence-mongo.enabled` | `false` | `src/app-bootstrap/src/main/resources/config/persistence.yml:14-16`, `docs/registries/env-keys.yaml:4294-4305` | +| `APP_PERSISTENCE_MONGO_ACTIVE_PROFILE` | `ca-skeleton.persistence-mongo.active-profile` | `""` (켜면 필수) | `persistence.yml:17-19`, `env-keys.yaml:4306-4319` | + +### OFF일 때 남는 것 — 3중 차단이고, 실제로 꺼진다 + +1. **Boot 자체 auto-configuration 차단.** `MongoOptInAutoConfigurationImportFilter`(`src/.../mongo/MongoOptInAutoConfigurationImportFilter.java:24-53`)가 `META-INF/spring.factories`를 통해 `AutoConfigurationImportFilter`로 등록되어, Boot 4의 Mongo auto-config 9개를 후보에서 제거한다. 이건 project condition보다 먼저 평가되므로 유일하게 옳은 위치다. +2. **leaf 자신의 진입점 1개.** `AutoConfiguration.imports`에는 `MongoRootAutoConfiguration` 하나만 있고, 이 클래스가 `@ConditionalOnProperty(...enabled=true)`를 달고 나머지 4개 configuration을 `@Import`한다(`MongoRootAutoConfiguration.java:26-38`). +3. **component scan에서 leaf 전체 제외.** `CaSkeletonApplication.AUTO_CONFIGURED_PACKAGES`(`src/app-bootstrap/.../CaSkeletonApplication.java:103`)에 `dev\.caskeleton\.adapter\.outbound\.mongo\..*`가 있다. `@ComponentScan(basePackages = {..., "dev.caskeleton.adapter", ...})`가 이 leaf를 훑지만 정규식 필터가 걷어낸다. `@ConfigurationPropertiesScan`의 패키지 목록에도 mongo 패키지가 없으므로 설정 바인딩도 일어나지 않는다. + +**검증:** `MongoPersistenceConfigTest.disabledByDefaultCreatesNoMongoInfrastructure`(`src/test/.../MongoPersistenceConfigTest.java:22-30`)가 실제 `@EnableAutoConfiguration` 컨텍스트에서 `MongoClient`/`MongoTemplate` 부재를 확인한다. 테스트 classpath에 진짜 Mongo starter가 있고 spring.factories도 로드되므로 **필터까지 포함한 end-to-end 증거**다. 이 테스트는 `@Tag` 없이 기본 `test` 레인에서 돈다. + +| 항목 | OFF 상태 | +|---|---| +| `MongoClient` bean | 없음 | +| 커넥션 풀 / 소켓 | 없음 (bean이 없으므로 driver가 cluster를 만들지 않음) | +| `MongoTemplate` / `ReactiveMongoTemplate` | 없음 | +| 인덱스 생성 | 없음 (애초에 런타임 인덱스 생성 경로 자체가 없음 — §4 참조) | +| converter 등록 | 없음 (`MongoMappingConfiguration`도 같은 flag 게이트 + scan 제외) | +| health indicator | 없음 (`MongoPlatformHealthConfiguration`은 `MongoRootAutoConfiguration`에서만 import되고 scan에서 제외됨) | +| 스레드 | 없음 | +| 필수 env | **없음** (`APP_PERSISTENCE_MONGO_ACTIVE_PROFILE`은 `enabled=true`일 때만 요구됨 — `CapabilityDependencyValidator.java:104-113`) | +| classpath | `spring-boot-starter-data-mongodb`(sync) + `mongodb-driver-sync` + `spring-boot-health` + `micrometer-core`가 jar에 남음. reactive starter와 `mongodb-driver-reactivestreams`는 `app-bootstrap/build.gradle:91-99`에서 exclude | + +**판정: 끄면 꺼진다.** 브리프의 Critical 정의("꺼진 기술이 빈·스레드·커넥션·필수 env를 요구")에 해당하는 것은 하나도 없다. 남는 것은 classpath 비용뿐이고, 그건 `README.md:22-24`가 의도적 선택이라고 명시한다("부재는 배포 시점에 되돌릴 수 없고 gating 결함을 전부 가린다"). + +### 자동설정이 클래스패스만으로 켜지는 경로 — 막혀 있지만 fail-open이다 + +`MongoOptInAutoConfigurationImportFilter.java:24-34`의 차단 목록은 **하드코딩된 9개 클래스명 Set**이고, `:50`의 판정은 `!MONGO_AUTO_CONFIGURATIONS.contains(cls)` — 즉 **목록에 없으면 통과**다. Boot가 Mongo auto-configuration을 하나 더 추가하거나 이름을 바꾸면 그 순간 조용히 뚫린다. 이 필터를 직접 겨냥한 테스트는 저장소 전체에 **하나도 없다**(`grep -rl MongoOptInAutoConfigurationImportFilter` → main 소스, spring.factories, README, CLAUDE.md뿐). `MongoPersistenceConfigTest`가 `MongoClient`/`MongoTemplate` 부재만 확인하므로, health/metrics 계열 auto-config가 새로 새어 들어오면 잡히지 않는다. → **H7** + +--- + +## 4. 구조 판정 + +| 축 | 판정 | 근거 | +|---|---|---| +| 의존 방향 (modules.json 대조) | **OK** | `modules.json`의 `allowed_dependencies: []` ↔ `build.gradle:28-49`에 `project(...)` 의존 0건. 외부 의존만 있고 그 외부도 전부 Boot BOM에서 버전이 온다(`build.gradle:23-24` 주석대로 driver 버전 pin 없음). `app-bootstrap`이 leaf를 `implementation(project(...))`로 싣는 역방향 edge만 존재(`app-bootstrap/build.gradle:91`) | +| 패키지 내부 경계 | **OK, 그리고 이 저장소에서 가장 강한 장치** | `MongoModuleBoundaryTest`(`src/test/.../architecture/MongoModuleBoundaryTest.java:38-105`)가 **닫힌 edge 행렬**을 들고 (a) 디스크의 top-level 패키지 집합과 정확히 일치하는지, (b) 관측된 모든 edge가 선언된 것인지, (c) 선언된 edge가 DAG인지를 검사한다. `api..`는 Spring/driver/BSON/Reactor/Micrometer를 전부 금지 | +| 경계 누수 (DTO·entity·framework 타입) | **누수 없음** | inbound/application/domain 타입이 이 leaf에 하나도 없다. 반대 방향은 `MongoAccessRules.noMongoAccessFrom`(testFixtures)이 `MongoTemplate`/`MongoClient`/`MongoDatabase`/`MongoCollection`을 inbound에서 금지하고, **실패 fixture(`LeakyController`)로 규칙이 실제로 떨어지는지까지 확인**한다(`MongoAccessRulesTest:660-671`) | +| 비즈니스 규칙 위치 | **OK** | mapper·config에 도메인 규칙이 없다. 단 `MongoAggregationStageDescriptor.KNOWN_STAGES`, `MongoObservationConvention.ALLOWED_TAGS`, `DefaultMongoFailureClassifier.CATEGORY_BY_CODE` 같은 **벤더 사실 테이블**이 코드에 박혀 있는데, 이건 비즈니스 규칙이 아니라 MongoDB 사실이므로 여기가 맞는 자리다 | +| 테스트 전략 적합성 | **OK, 예외적으로 잘함 (단 진행 중)** | hermetic 98개(`mongodb-contract` 83 + 무태그 15)와 Docker 레인 7개가 **소스셋 단위로 분리**되어 있어 `test`의 runtime classpath에 Testcontainers가 없다(`grep testcontainers src/test src/testFixtures` → 0건). Docker 레인은 실제 벤더 동작(트랜잭션, change stream, Toxiproxy 응답 유실, TLS 인증서 4종, RBAC, migration fence)을 검증한다. **이 분리는 지금 커밋되지 않은 상태다** — `mongoIntegrationTest`/`mongoProviderTestkit` 소스셋 15파일이 untracked (§7, H6) | +| public surface | **OK** | `docs/architecture/mongo-api-surface.txt`의 346개 엔트리가 실제 public top-level 타입 346개와 **이름 단위로 정확히 일치**(내가 직접 대조). `verifyMongoApiSurface`가 `check`에 걸려 있다 | + +--- + +## 5. 발견 + +### Critical + +#### C1. Mongo를 켜면, 아무도 설정하지 않은 클라이언트가 만들어진다 + +- **현상**: `APP_PERSISTENCE_MONGO_ENABLED=true`로 켰을 때 연결 URI를 지정하는 경로가 저장소 어디에도 기본으로 없다. 그리고 README가 알려주는 키는 Boot 4에서 바인딩되지 않는 키다. +- **근거**: + - `src/adapter/outbound/persistence-mongo/README.md:36-38` — 활성화 예시가 `spring.data.mongodb.uri=mongodb://localhost:27017/portfolio` + - `src/adapter/outbound/persistence-mongo/CLAUDE.md:25` — "The connection URI and database come from Spring's standard `spring.data.mongodb.*` settings" + - `src/.../mongo/MongoPersistenceSettings.java:14-19` — **같은 저장소의 production 소스가 정반대를 말한다**: "`spring.mongodb.*` is the canonical namespace in Spring Boot 4; `spring.data.mongodb.*` is deprecated at **error level** in its metadata." + - `src/app-bootstrap/src/main/resources/config/persistence.yml` — `spring.mongodb.uri`도 `spring.data.mongodb.uri`도 없음 + - `src/.env.example:297-299`, `src/.env.local.example:27-29` — `SPRING_MONGODB_URI`가 없음. `APP_PERSISTENCE_MONGO_ENABLED`와 `APP_PERSISTENCE_MONGO_ACTIVE_PROFILE`만 있음 + - `docs/registries/env-keys.yaml` — `SPRING_MONGODB_URI`가 등록되어 있지 않음(`grep -i mongo` 결과 7줄 전부 `APP_PERSISTENCE_MONGO_*`) + - 유일하게 URI를 주는 곳은 `src/config/runtime/compose-profile-contracts.json:143`/`:603`의 `SPRING_MONGODB_URI` 뿐이다 — 즉 Compose 레인만 올바르게 설정되어 있고 그 외 경로는 전부 비어 있다 +- **왜 문제인가**: fork 사용자가 README대로 `spring.data.mongodb.uri`를 세팅하면 Boot 4는 그 키를 바인딩하지 않는다. `MongoAutoConfiguration`은 드라이버 기본값(`mongodb://localhost:27017`, database `test`)으로 클라이언트를 만든다. 드라이버는 lazy라 **기동은 성공한다.** 그 다음 (a) 컨테이너 환경이면 첫 연산에서 server selection timeout으로 죽고, (b) 개발자 로컬이면 조용히 `test` 데이터베이스에 쓴다. 둘 다 "설정했다고 믿는 곳이 아닌 곳"이다. +- **수정 방향**: (1) `config/persistence.yml`에 `spring.mongodb.uri: ${SPRING_MONGODB_URI:}`를 추가하고 `env-keys.yaml`에 `SPRING_MONGODB_URI`를 `required_when: APP_PERSISTENCE_MONGO_ENABLED=true`로 등록. (2) README.md:37과 CLAUDE.md:25를 `spring.mongodb.uri`로 고친다. (3) `MongoNamespaceContractTest.productionSources`(`src/test/.../MongoNamespaceContractTest.java:72-90`)가 `/src/main/`만 훑으므로 `.md`도 대상에 넣는다. (4) 켰는데 URI가 비면 기동 실패시키는 검사를 `CapabilityDependencyValidator`에 추가. +- **반론과 재반박**: "Compose 레인은 올바르므로 런타임은 처음부터 맞는 네임스페이스였다" — `MongoPersistenceSettings`의 Javadoc과 `MongoNamespaceContractTest`가 실제로 그렇게 주장한다. 맞다. **그러나 그 주장이 성립하는 범위가 Compose 레인 뿐이라는 것이 문제다.** 이 저장소는 템플릿이고, fork 사용자가 읽는 첫 문서는 leaf의 README다. README가 안 되는 키를 가리키고, `.env.example`에 되는 키가 없고, 기본 yml에도 없다. 세 곳이 동시에 비어 있으면 "런타임은 맞았다"는 방어는 실제 사용자에게 도달하지 않는다. + +#### C2. profile이 선언한 TLS·Stable API·타임아웃·풀 경계가 실제 드라이버에 도달하지 않는다 + +- **현상**: `MongoClientSettingsFactory`는 typed profile을 `MongoClientSettings`로 바꾸는 유일한 클래스인데, **production 코드 중 이 클래스를 호출하는 곳이 없다.** +- **근거**: + - `src/.../mongo/client/MongoClientSettingsFactory.java:38` — 클래스 본문. `grep -rn MongoClientSettingsFactory src/` 결과 참조자는 `MongoClientSettingsFactoryTest` 7곳뿐, main 참조 0건 + - 실제 클라이언트는 `MongoPersistenceConfig.java:26`이 `@ImportAutoConfiguration({MongoAutoConfiguration.class, ...})`로 Boot에 맡긴다. Boot는 `spring.mongodb.*` + `MongoClientSettingsBuilderCustomizer`만 읽는다 + - 이 leaf가 등록하는 유일한 customizer는 `MongoDriverObservabilityAutoConfiguration.java:38-48`의 관측 리스너뿐이고, profile 설정은 건드리지 않는다 + - 반면 `MongoProfileProperties.validate()`(`autoconfigure/MongoProfileProperties.java:104-163`)는 production profile에 TLS·인증·Stable API strict·유한 타임아웃·풀 경계를 **강제**한다 + - 그 validate는 `MongoPlatformAutoConfiguration.java:342`에서 실제로 호출된다(probe + 3개 bean이 있을 때) +- **왜 문제인가**: `platform.profiles.primary.tls-required=true`, `production=true`로 설정한 배포는 startup validation을 **통과한다.** 그리고 URI에 `tls=true`가 없으면 평문으로 연결한다. `MongoClientSettingsFactory.java:97-102`의 주석이 정확히 이 실패를 막겠다고 쓰여 있다("A profile that declares TLS and connects without it is the failure this leaf's production validation exists to prevent, and it cannot prevent it from a record the driver never reads") — 그런데 그 클래스 자체가 호출되지 않으므로 같은 실패가 한 층 위에서 그대로 반복된다. 타임아웃·풀 경계도 마찬가지로 드라이버 기본값(server selection 30s, socket read 무한)이 쓰인다. +- **수정 방향**: `MongoPlatformAutoConfiguration`에 `@ConditionalOnBean(MongoCredentialResolver.class)` + `profiles` 비어있지 않음 조건으로 `MongoClientSettingsBuilderCustomizer`를 하나 더 등록해서 `MongoClientSettingsFactory.create()`의 결과를 Boot builder에 반영하거나, 최소한 CLAUDE.md/README에 "profile 설정은 fork가 `MongoClientSettingsFactory`를 직접 wiring해야 적용된다"를 명시한다. 후자만 해도 "적용된 것처럼 읽히는" 문제는 사라진다. +- **반론과 재반박**: "`MongoCredentialResolver` 구현체를 이 저장소가 싣지 않으므로(`security/MongoCredentialResolver.java:35-45`가 `unconfigured()`를 refuse로 정의) factory를 자동 wiring할 수 없다" — 맞다, 그래서 auto-wiring이 없는 것 자체는 옳은 선택이다. **그러나 그 결과 production 보안 검증이 아무것도 강제하지 않는 상태가 되었고, 어느 문서도 그 사실을 말하지 않는다.** `CLAUDE.md:101-112`는 "A production `MongoProfileProperties` must declare TLS... `validate()` enforces all of them"이라고만 쓰고, 그 강제가 드라이버에 도달하지 않는다는 말은 없다. 지금 상태는 "보안 통제가 있는 것처럼 읽히는 문서 + 통제가 없는 런타임"이고, 그게 Critical인 이유다. + +--- + +### High + +#### H1. `APP_PERSISTENCE_MONGO_ACTIVE_PROFILE`은 켤 때 필수인데, 바인딩되는 곳이 없다 + +- **현상**: env 레지스트리가 "정확히 하나의 Mongo profile을 고르고, 선택되지 않은 profile의 secret은 절대 resolve하지 않는다"고 서술하는 키가, 런타임 코드 어디에도 바인딩되지 않는다. +- **근거**: + - `docs/registries/env-keys.yaml:4306-4319` — `required_when: APP_PERSISTENCE_MONGO_ENABLED=true`, 설명은 "the runtime builds one sync client and one pool; a profile present in the map but not selected has neither its secret resolved nor a client created" + - `src/app-bootstrap/.../activation/CapabilityDependencyValidator.java:104-113` — 비어 있으면 기동 실패 + - `src/.../mongo/MongoPersistenceSettings.java:22-37` — `ca-skeleton.persistence-mongo` prefix에 바인딩되는 필드는 `enabled` **하나뿐** + - `MongoPlatformSettings`는 `ca-skeleton.persistence-mongo.platform` prefix라 `active-profile`을 못 읽는다(`autoconfigure/MongoPlatformSettings.java:26`) + - `active-profile`을 읽는 유일한 코드는 위 validator뿐. `MongoClientSettingsFactory`의 `activeProfile` 생성자 파라미터는 C2대로 호출자가 없다 +- **왜 문제인가**: fork가 `APP_PERSISTENCE_MONGO_ACTIVE_PROFILE=primary`를 세팅하면 기동은 통과한다. 그리고 `primary`는 아무것도 고르지 않는다. 오타(`primry`)를 내도 똑같이 통과한다. 설정했다고 믿는 값이 런타임에 영향이 0인 상태는, 나중에 profile 기능이 실제로 붙었을 때 "이미 맞게 설정돼 있는 줄 알았던" 배포를 만든다. +- **수정 방향**: `MongoPersistenceSettings`에 `activeProfile` 필드를 추가하고, `MongoPlatformSettings.profiles`가 비어있지 않을 때 `require(activeProfile)`로 존재를 검증하는 `InitializingBean`을 `MongoPlatformAutoConfiguration`에 추가. 혹은 기능이 붙을 때까지 이 키를 레지스트리에서 내리고 validator 규칙을 제거. +- **반론과 재반박**: "profile 기능이 나중에 붙을 것이므로 키를 미리 예약해 둔 것" — 그렇다면 `env-keys.yaml`의 설명문이 **미래형이 아니라 현재형으로 동작을 서술하고 있는 것**이 문제다. 예약이면 예약이라고 써야 한다. + +#### H2. 선언한 deadline을 넘긴 연산이, 성공했는데 "전송되지 않음"으로 보고된다 + +- **현상**: blocking executor가 콜백 완료 후 elapsed를 재고, 초과했으면 `MongoOperationRejectedException`을 던진다. 그 예외의 outcome은 `NOT_SENT`, category는 `OPERATION_REJECTED`, retryable은 false다. +- **근거**: `src/.../mongo/imperative/DefaultMongoImperativeExecutor.java:93-105` + ```java + if (elapsed.compareTo(context.timeout()) > 0) { + observation.success(outcome); // :97 + throw MongoOperationRejectedException.of(...); // :98 + } + ``` + `MongoOperationRejectedException.of`는 `MongoFailureContext.rejected(...)`를 쓰고(`api/error/MongoOperationRejectedException.java:24-28`), 그 컨텍스트는 `outcome = NOT_SENT, ambiguous = false`다(`api/error/MongoFailureContext.java:130-145`). +- **왜 문제인가**: 이 시점에 콜백은 **이미 성공적으로 반환했다.** 즉 서버는 쓰기를 적용했다. 그런데 호출자가 받는 예외는 "아무것도 전송되지 않았다, 애매하지 않다"라고 말한다. `MongoExecutionOutcome.NOT_SENT`의 정의가 "The command never left the client"이므로, 이 예외를 보고 재시도하는 호출자는 **중복 쓰기를 만든다.** 이 leaf 전체가 "ambiguous outcome을 성공/실패로 뭉개지 말라"는 원칙 위에 서 있는데(`CLAUDE.md:131`), 여기서만 정확히 그 반대를 한다. + - 이 경로가 실제로 도달 가능한 이유: `BoundScopedOperations`는 `maxTimeMS`를 붙이지만(`imperative/BoundScopedOperations.java:57-60`), atomic/bulk/geo/aggregation 실행기는 전부 `access.rawOperations()`를 쓴다(예: `imperative/atomic/MongoAtomicOperationsTemplate.java:78-95`). raw 경로에는 `maxTimeMS`가 없으므로 서버가 먼저 끊어주지 않는다. + - 부수 문제: `:97`에서 `observation.success(outcome)`를 호출한 뒤 예외를 던지므로 메트릭은 성공, 호출자는 실패로 서로 어긋난다. +- **수정 방향**: 이 경로의 실패 컨텍스트를 `MongoFailureContext.timedOut(operationName, operationType, timeout)`으로 바꾼다 — 그 팩토리는 이미 존재하고 쓰기일 때 `WRITE_RESULT_UNKNOWN`, `ambiguous=true`를 준다(`api/error/MongoFailureContext.java:105-129`). 그리고 관측은 `observation.failure(...)`로 기록한다. +- **반론과 재반박**: "콜백이 반환한 뒤에는 작업을 되돌릴 수 없으니 예외 종류는 큰 의미가 없다" — 의미가 있다. 이 플랫폼의 계약은 "outcome을 읽고 재시도 여부를 판단하라"이고(`MongoExecutionOutcome.forbidsBlindReplay()`), `NOT_SENT`는 그 계약에서 "안전하게 재시도 가능"을 뜻한다. 예외 종류가 곧 재시도 지시다. + +#### H3. reactive·change stream 절반은 배포된 composition root에서 절대 활성화되지 않는다 + +- **현상**: `MongoPlatformAutoConfiguration.ReactiveExecution`은 `@ConditionalOnBean(ReactiveMongoTemplate.class)`인데, `app-bootstrap`이 reactive starter를 exclude한다. +- **근거**: + - `src/app-bootstrap/build.gradle:91-99` — `exclude module: 'spring-boot-starter-data-mongodb-reactive'`, `exclude module: 'mongodb-driver-reactivestreams'` + - `src/.../mongo/autoconfigure/MongoPlatformAutoConfiguration.java:187-189` — `@ConditionalOnClass(ReactiveMongoTemplate.class)` + `@ConditionalOnBean(ReactiveMongoTemplate.class)` + - `MongoPersistenceConfig.java:26`은 `MongoAutoConfiguration`/`DataMongoAutoConfiguration`(sync)만 import한다. reactive template을 만드는 것은 아무것도 없다 + - 게다가 `MongoPlatformSettings.java:55`가 `changeStreams = false`를 강제한다 +- **왜 문제인가**: `reactive/`(8), `reactive/cursor/`(5), `changestream/`(9+5+4+3) 등 약 34개 production 클래스와 `ReactiveExecution` 안의 bean 5개가 **이 애플리케이션에서 도달 불가능**하다. `MongoReactiveWiringTest`는 격리된 `ApplicationContextRunner`에 reactive template을 직접 주입해서 통과하므로, 이 사실을 잡아내지 못한다. `README.md:16-17`은 exclude를 "there is no reactive port in the shipped Stable scope"라고 설명하지만, CLAUDE.md 어디에도 "그래서 reactive/changestream 패키지는 fork가 exclude를 걷어내기 전까지 죽은 코드"라는 문장이 없다. +- **수정 방향**: (a) fork가 reactive를 쓰려면 `app-bootstrap/build.gradle`의 exclude 2줄을 지워야 한다는 것을 leaf README에 한 줄로 쓴다. (b) `MongoPlatformAutoConfiguration.ReactiveExecution`이 활성화될 수 없는 조합이라는 것을 app-bootstrap 쪽 wiring 테스트에서 assertion으로 고정하거나, 반대로 exclude를 걷어내고 `@ConditionalOnProperty`로 reactive를 별도 토글로 승격한다. +- **반론과 재반박**: "안 쓰는 기술을 classpath에서 빼는 것이 이 템플릿의 목표에 부합한다" — 목표에는 부합한다. 문제는 **leaf 안에 34개 클래스와 5개 bean 정의가 남아 있고, 그것들의 테스트가 전부 초록이라는 것**이다. 초록 테스트가 "이 기능은 동작한다"로 읽히는 것이 리스크다. exclude는 유지하되 사실을 문서화하면 해결된다. + +#### H4. platform profile을 하나라도 설정하면, 고지되지 않은 bean 4개를 fork가 공급해야 기동한다 + +- **현상**: `ca-skeleton.persistence-mongo.platform.profiles.*`가 비어 있지 않은 순간 startup 요구사항이 계단식으로 늘어나는데, 그 4개는 이 저장소가 싣지 않고 한 문서에 함께 나열되어 있지도 않다. +- **근거**: `src/.../mongo/autoconfigure/MongoPlatformAutoConfiguration.java` + - `:388-405` `mongoTopologyProbeRequirement` — `profiles`가 비어있지 않은데 `MongoTopologyProbe` bean이 없으면 `IllegalStateException`으로 기동 실패. 이 bean은 조건 없이 등록되므로 회피 불가 + - `:330-367` `mongoPlatformStartupCheck` — probe가 있으면 추가로 `MongoSecurityProfile`, `MongoCredentialReference`(admin), `MongoSchemaVersionRange` 세 bean을 요구하고, 하나라도 없으면 fail closed + - 이 4개 타입 중 이 leaf가 bean으로 등록하는 것은 0개 + - 추가로 `MongoProfileProperties`(`autoconfigure/MongoProfileProperties.java:23-53`)는 **17개 컴포넌트 전부 필수**인 record다. `Objects.requireNonNull`이 10개, 나머지는 primitive. 기본값이 없고 예시 yml도 저장소에 없으므로, profile 하나를 설정하려면 17개 키를 정확히 써야 바인딩이 성공한다 +- **왜 문제인가**: fork 사용자가 "production profile을 선언하자"고 생각한 순간, 기동 실패 4연타를 순서대로 맞는다. 각 실패 메시지는 잘 쓰여 있지만(예: `:396-402`), **한 번에 무엇이 필요한지를 말해 주는 문서가 없다.** `CLAUDE.md:101-112`는 credential resolver가 없다는 것만 말하고 나머지 3개는 언급하지 않는다. +- **수정 방향**: leaf README에 "platform profile을 켜려면 다음 4개 bean과 17개 키가 필요하다" 섹션과 완성된 yml 예시 하나. 또는 `MongoProfileProperties`에 `local()`/`production()`이 이미 정의한 기본값을 record component default로 끌어내려 필수 키를 3~4개로 줄인다. +- **반론과 재반박**: "기본값을 주면 '아무도 고르지 않은 답'이 생긴다 — 이 leaf 전체의 설계 원칙이 그것을 금지한다" — 원칙 자체는 옳고, `MongoUuidRepresentation`에 `UNSPECIFIED`를 두지 않은 것은 정확히 맞는 선택이다. 그러나 `poolMaxWaitTime`이나 `serverSelectionTimeout` 같은 운영 튜닝값까지 전부 "명시 안 하면 바인딩 실패"로 두는 것은 원칙의 과적용이다. 데이터 표현(uuid/decimal)과 운영 파라미터(timeout/pool)를 같은 엄격도로 다룰 이유가 없다. + +#### H5. health가 "관측값"이라고 부르는 숫자는 기동 시점에 얼려진 상수다 + +- **현상**: `MongoTopologyProbe`는 생성자에서 topology·serverVersion·availableSecondaries를 받아 final 필드에 저장하는 불변 `final` 클래스다. health indicator는 그 인스턴스를 필드로 붙잡는다. +- **근거**: + - `src/.../mongo/autoconfigure/MongoTopologyProbe.java:24-45` — `final class`, 세 값 모두 final, 갱신 메서드 없음 + - `:20-22` 주석 — "Everything here is an observation... the health view that reads these values reports them to an operator as fact" + - `autoconfigure/MongoPlatformHealthIndicator.java:35-38` — 생성자 주입 후 `:69-72`의 `degradedSecondaryAvailability()`가 `probe.availableSecondaries()`를 읽는다 + - `MongoPlatformHealthContributor.health()`(`src/.../mongo/MongoPlatformHealthContributor.java:18-22`)가 매 actuator 호출마다 이 값을 details에 넣는다 +- **왜 문제인가**: 이 클래스의 Javadoc이 **바로 이 결함을 고쳤다고 주장한다**(`MongoPlatformHealthIndicator.java:30-33`: "The observed count was a literal `0` in the bean method, so every replica set reported every secondary missing"). 고친 결과는 리터럴 0이 아니라 "기동 시점 스냅샷"이다. 세컨더리가 죽어도 `/actuator/health`는 기동 때 세던 숫자를 계속 보고하고, `ready()`도 기동 시점 topology로만 판정한다. 운영자 입장에서는 이전보다 더 나쁘다 — 이전엔 명백히 틀린 0이라 무시했겠지만 지금은 그럴듯한 숫자다. +- **수정 방향**: `MongoTopologyProbe`를 값 record가 아니라 `Supplier` 형태의 포트로 바꾸거나, health indicator가 `ObjectProvider`가 아니라 매 호출마다 cluster description을 다시 읽는 함수를 받게 한다. 최소 조치로는 details에 `observedAt` 타임스탬프를 넣어 스냅샷임을 드러낸다. +- **반론과 재반박**: "probe는 fork가 만드는 bean이므로 fork가 갱신되는 구현을 주면 된다" — 못 준다. `MongoTopologyProbe`는 `final class`라 서브클래싱이 불가능하고, 필드가 final이며, 세터가 없다. fork에게 남은 유일한 선택지는 bean scope를 바꾸는 것인데 health indicator가 인스턴스를 직접 들고 있으므로 소용없다. **타입 설계가 갱신을 구조적으로 막고 있다.** + +#### H6. untracked 18파일 2,530줄 — `git add` 없이 커밋하면 production health 브리지와 Docker 레인 전부가 저장소에서 사라진다 + +- **현상**: 리팩토링이 tracked 파일 18개를 지우고 대응물 18개를 새 위치에 만들었는데, **새 파일이 전부 untracked다.** 그중 2개는 테스트가 아니라 production 코드다. +- **근거**: `evidence/status.txt` + `evidence/untracked-files.txt` + `untracked-wc.txt` + - 삭제(tracked): `status.txt:54-60` `src/test/.../*LaneTest.java` 7개 / `:61-68` `src/testFixtures/.../testkit/{atlas,failover,rs}/*` 8개 / `:113-114` `app-bootstrap/.../autoconfigure/mongo/MongoPlatformHealthConfig.java`·`MongoPlatformHealthContributor.java` / `:155` 그 테스트 — 합계 18파일 + - 추가(untracked): `untracked-files.txt`의 persistence-mongo 18줄 — `src/mongoIntegrationTest/`(7), `src/mongoProviderTestkit/`(8), `src/main/.../mongo/MongoPlatformHealthConfiguration.java`, `src/main/.../mongo/MongoPlatformHealthContributor.java`, `src/test/.../MongoPlatformHealthContributorTest.java` + - 줄 수: `untracked-wc.txt` 합계 **2,530줄** +- **왜 문제인가**: `git commit -a` / `git add -u` 뒤 commit이면 삭제 18건만 반영되고 추가는 0건이다. 결과: + - **production**: `app-bootstrap`의 Mongo health 브리지가 사라지고 leaf의 대체물이 없다 → Actuator에서 Mongo health가 통째로 없어진다. + - **테스트**: replica set / failover / migration / compatibility / security-integration / TLS 6개 레인의 클래스와 컨테이너 fixture 전부가 사라진다 — 이 leaf에서 **실제 MongoDB를 상대로 하는 유일한 증거**다. +- **조용히 깨지지는 않는다** (앞선 판정 정정): + - production 쪽: `MongoRootAutoConfiguration.java`의 tracked diff(+3/−1)가 `MongoPlatformHealthConfiguration.class`를 `@Import` 목록에 넣는 변경이므로, 클래스가 없으면 **컴파일이 깨진다.** + - 테스트 쪽: `StrictTestLanePlugin`(`src/build-logic/.../strictlane/StrictTestLanePlugin.java:47-64`)이 레인 선택 시 소스셋 파일이 0개면 GradleException을 던진다 — *"has no sources in source set 'mongoIntegrationTest'. Gradle would skip it as NO-SOURCE and report success for a lane that ran nothing."* 추가로 `:157`의 `failOnNoDiscoveredTests = true`와 `:174-203`의 "실행 0건" 검사가 이중으로 막는다. **빈 채로 초록이 되는 경로는 없다.** +- **수정 방향**: 커밋 전에 `git add -A`, 또는 + `git add src/adapter/outbound/persistence-mongo/src/mongoIntegrationTest src/adapter/outbound/persistence-mongo/src/mongoProviderTestkit src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/MongoPlatformHealth*.java src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/MongoPlatformHealthContributorTest.java` +- **반론과 재반박**: "작업 중인 워킹트리라 당연한 상태다" — 맞다. 그래서 이건 코드 결함이 아니라 **커밋 직전 체크리스트 항목**이고, 심각도의 근거는 (a) production 코드 2개가 섞여 있다는 것, (b) `-u`/`-a`가 일상적 커밋 습관이라는 것, (c) 사라지는 것이 이 leaf의 유일한 실서버 증거라는 것 세 가지다. **내용 손실 자체는 0이다** — 삭제분과 새 파일을 바이트 단위로 대조해 16/18 동일, 2개는 기능 확장임을 확인했다(§7.3). + +#### H7. auto-configuration 차단 목록이 하드코딩 fail-open이고, 그것을 검증하는 테스트가 없다 + +- **현상**: 토글 계약에서 가장 중요한 장치가 9개 문자열 Set이고, 목록 밖은 통과시킨다. +- **근거**: + - `src/.../mongo/MongoOptInAutoConfigurationImportFilter.java:24-34` — 9개 FQCN 하드코딩 + - `:47-50` — `matches[index] = enabled || cls == null || !MONGO_AUTO_CONFIGURATIONS.contains(cls)` → 모르는 클래스는 허용 + - 이 클래스를 참조하는 테스트: 0건 (`grep -rl MongoOptInAutoConfigurationImportFilter src/` → main 소스 1, spring.factories 1, 문서 2) +- **왜 문제인가**: Boot 4.0.x 패치 하나가 Mongo auto-configuration을 추가하거나 패키지를 옮기면 그 순간 "꺼진" 배포에 bean이 생긴다. `MongoPersistenceConfigTest`가 `MongoClient`/`MongoTemplate` 부재만 보므로, health contributor나 metrics binder가 새어 들어와도 초록이다. +- **수정 방향**: classpath에서 `org.springframework.boot.mongodb.autoconfigure`/`org.springframework.boot.data.mongodb.autoconfigure` 패키지의 `@AutoConfiguration` 클래스를 스캔해서 `MONGO_AUTO_CONFIGURATIONS`와 정확히 일치하는지 확인하는 테스트 하나. `MongoModuleBoundaryTest`가 패키지 집합에 대해 하는 것과 같은 방식이다. 또는 `enabled=false`에서 컨텍스트의 bean 정의 이름 중 `mongo`를 포함하는 것이 0개인지 확인. +- **반론과 재반박**: "필터는 fail-open이 아니라 fail-safe다 — 모르는 클래스를 막으면 Mongo와 무관한 auto-config까지 막힌다" — Set 기반 allowlist가 아니라 **패키지 prefix 기반**으로 바꾸면 둘 다 만족한다. 지금 목록의 9개는 모두 두 패키지 안에 있다. + +--- + +### Medium + +#### M1. README·CLAUDE.md가 폐기된 네임스페이스를 가리키고, 네임스페이스 계약 테스트는 문서를 검사하지 않는다 + +- **근거**: `README.md:37`, `README.md:53`, `CLAUDE.md:25` vs `MongoPersistenceSettings.java:14-19`. `MongoNamespaceContractTest.productionSources`(`src/test/.../MongoNamespaceContractTest.java:72-90`)는 `.java`/`.yml`/`.properties`만, 그것도 `/src/main/` 아래만 훑는다. +- **왜 문제인가**: C1의 근본 원인. 테스트가 "드리프트를 막는다"고 선언하지만(`:19`) 드리프트가 실제로 있는 곳(README)을 보지 않는다. +- **수정 방향**: `productionSources`에 `.md`를 추가. +- **반론**: "문서 스캔은 오탐이 많다" — 이 테스트는 이미 Java 주석을 제거하는 전처리를 갖고 있고, Markdown은 "폐기된 키를 쓰라고 지시하는 문서"와 "폐기됐다고 기록하는 문서"를 코드블록 여부로 구분할 수 있다. + +#### M2. 릴리스 증거 검증기가 두 벌이고, CLAUDE.md는 "하나"라고 말한다 + +- **근거**: + - testFixtures 쪽: `src/testFixtures/.../testkit/release/MongoReleaseEvidenceVerifier.java:59-85` — staleness, skipped, failures, suite name 일치까지 검사. 6필드 contract(`topology` 포함) + - build-tools 쪽: `src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/MongoReleaseContractLaneVerifier.java:11-50` — 파일 존재 + `tests - skipped >= minimumExecuted`만. staleness·failures·suite name 검사 없음. 4필드 contract + - `check`에 걸려 있는 것은 build-tools 쪽(`MongoVerificationPlugin.java:36-57`). testFixtures 쪽은 `MongoReleaseEvidenceVerifierTest` 외에 호출자가 없다 + - `CLAUDE.md:88-90` — "Release gating is testkit-only for the same reason and is **one implementation, not two**" + - `scripts/verify-mongodb-platform.sh`는 둘 중 아무것도 안 쓰고 `sed`로 직접 XML을 센다(`:47-56`) +- **왜 문제인가**: `check`가 돌리는 검증기가 더 약하다. **테스트가 실패해도 통과하고**(failures 미검사), **엉뚱한 클래스의 XML을 읽어도 통과한다**(suite name 미검사 — testFixtures 쪽은 `:75-77`에서 검사한다). + - staleness는 실질 문제가 아니다: `StrictTestLanePlugin:158`이 모든 strict lane에 `getOutputs().upToDateWhen(ignored -> false)`를 걸고, `verifyMongoReleaseContractLanes`가 `dependsOn("test", "mongoStableContractTest")`이므로(`MongoVerificationPlugin.java:45`) 두 레인이 항상 재실행된다. 남은 실질 구멍은 **failures 미검사**와 **suite name 미검사** 두 가지다. +- **추가 구멍**: `MongoReleaseContractLaneVerifier.java:16-18`의 `if (!hermeticLanes.contains(contract.task())) continue;` — 누군가 `contracts[]`에 `mongoReplicaSetTest`를 추가하면 **조용히 건너뛴다.** 이게 정확히 `release-contracts.json`의 `not_promoted_reason`이 경고하는 실패 모드다. +- **수정 방향**: build-tools 검증기에 failures·suite-name 검사를 이식하고(testFixtures 쪽 `MongoReleaseEvidence.rejection()`이 이미 구현체를 갖고 있다), hermetic이 아닌 lane은 `continue`가 아니라 명시적 "verified elsewhere" 보고로 바꾼다. CLAUDE.md:88-94를 사실에 맞춘다. + +#### M3. `findAndModify` 경로는 matched/modified를 항상 1/1로 보고한다 + +- **근거**: `src/.../mongo/imperative/atomic/MongoAtomicOperationsTemplate.java:118` — `return AtomicUpdateResult.applied(1, 1, document);` +- **왜 문제인가**: `AtomicUpdateResult`의 계약(`imperative/atomic/AtomicUpdateResult.java:9-13`)은 "matched but not modified"를 상태 전이 판단 신호로 쓰라고 말한다. `ReturnDocumentMode.BEFORE/AFTER`를 쓰는 호출자에게는 `matchedButUnchanged()`가 **절대 true가 되지 않는다.** 같은 논리를 `updateOne`(`:132-134`)은 실제 count로 올바르게 보고하므로, 두 경로가 서로 다른 의미를 준다. +- **수정 방향**: `findAndModify`가 count를 주지 않으므로, 이 경로에서는 `matched`/`modified`를 -1 같은 "알 수 없음"으로 두거나 `AtomicUpdateResult`에 `countsUnavailable()`을 추가한다. + +#### M4. reactive cursor의 클라이언트 측 결과 예산 추적기는 절대 발동할 수 없다 + +- **근거**: `src/.../mongo/reactive/cursor/MongoReactiveCursorPublisher.java:56-67` + ```java + Query bounded = Query.of(query).cursorBatchSize(batchSize).maxTimeMsec(...).limit(budget.maxResults()); // :59 + MongoResultBudgetTracker tracker = new MongoResultBudgetTracker(budget, null); // :60 + ... .doOnNext(result -> tracker.record(null)); // :67 + ``` + `MongoResultBudgetTracker.record`는 `seen > budget.maxResults()`일 때 던진다(`reactive/cursor/MongoResultBudgetTracker.java:51-56`). 서버 limit이 `maxResults`와 같으므로 `seen`은 `maxResults`를 넘지 못한다. +- **왜 문제인가**: 주석(`:64-66`)이 "Counted client-side as well: a server limit bounds one query, and this bounds the stream the caller actually consumes"라고 이유를 대는데, 같은 값이므로 두 번째 경계가 첫 번째와 동일하다. 또 `codecs`에 `null`을 넘기므로 바이트 예산은 아예 측정되지 않는다(`MongoResultBudgetTracker.java:57-59`가 즉시 return). +- **수정 방향**: 서버 limit을 `maxResults + 1`로 두거나(추가 1건이 오면 예산 초과가 관측 가능), tracker를 제거하고 서버 limit만 신뢰한다고 문서화. 바이트 예산을 쓰려면 codec registry를 실제로 넘긴다. + +#### M5. `change-streams: true`는 조용히 무시된다 — Javadoc은 "거부한다"고 말한다 + +- **근거**: `src/.../mongo/autoconfigure/MongoPlatformSettings.java:48-55` + ```java + // ... Accepting the flag and ignoring it would leave an operator believing it took effect, + // so the value is refused rather than stored ... + changeStreams = false; // :55 + ``` + 코드는 정확히 "accept and ignore"를 한다. 예외를 던지지 않는다. `MongoStartupValidationTest.changeStreamsCannotBeSwitchedOn`(`src/test/.../autoconfigure/MongoStartupValidationTest.java:71-81`)이 이 강제 coercion을 의도된 동작으로 고정한다. +- **왜 문제인가**: 주석이 서술하는 실패 모드가 바로 구현된 동작이다. 운영자가 `true`로 켜고 아무 피드백도 못 받는다. +- **수정 방향**: `changeStreams == true`면 `MongoOperationRejectedException`을 던진다. 한 줄이고 테스트만 반대로 뒤집으면 된다. + +#### M6. `FlamingockLedgerAdapter`가 in-memory 비동시 맵을 쓰고 fence를 버린다 + +- **근거**: `src/.../mongo/migration/flamingock/FlamingockLedgerAdapter.java:28-30` — `LinkedHashMap` 2개. `:56-62` `recordApplied(..., long fence)`가 fence 파라미터를 무시하고 로컬 맵에만 쓴다. `saveCheckpoint(checkpoint, fence)`(`:74-78`)도 동일. +- **왜 문제인가**: `MongoMigrationLedger`의 계약(`migration/MongoMigrationLedger.java:18-34`)은 "fence가 현재 것이 아니면 거부"를 요구하고, `MongoMigrationRunner`는 unfenced lease를 refuse할 만큼 이 규약에 의존한다(`migration/MongoMigrationRunner.java:80-89`). Flamingock 어댑터는 그 규약을 어기면서 같은 인터페이스를 구현한다. 또한 로컬 맵은 재시작을 못 넘긴다 — 클래스 Javadoc(`:694-700`)이 "avoid the failure where the two disagree"라고 주장하는데, 로컬 맵과 엔진 로그가 정확히 그 두 개다. +- **수정 방향**: `recorded`/`checkpoints`를 Flamingock 자신의 저장소 또는 `MongoCollectionMigrationLedger`에 위임하고, fence 미지원을 `UNFENCED`로 정직하게 보고한다(`FlamingockLockAdapter.fence()`가 이미 그렇게 한다 — 어댑터끼리 태도가 다르다). + +#### M7. `verify-mongodb-platform.sh`의 첫 레인이 clean 빌드에서 깨질 가능성 + +- **근거**: `scripts/verify-mongodb-platform.sh:102` — `run_lane "static-analysis" "check" -x "mongoStableContractTest"`. `check`는 `verifyMongoTestLaneDisjointness`에 의존하고(`build.gradle:225-228`), 그 태스크의 `@InputDirectory getContractResults()`는 `build/test-results/mongoStableContractTest`다(`buildtools/mongo/MongoVerificationPlugin.java:22-27`). +- **왜 문제인가**: `-x`로 제외하면 그 디렉터리가 생성되지 않는다. Gradle의 `@InputDirectory`는 존재하지 않는 디렉터리를 오류로 처리한다. clean 체크아웃에서 릴리스 게이트 첫 줄이 실패할 개연성이 높다. +- **미검증**: 빌드를 돌리지 못했다. 확인 명령: `cd src && ./gradlew clean :adapter:outbound:persistence-mongo:check -x mongoStableContractTest --console=plain` +- **수정 방향**: `getContractResults()`에 `@Optional`을 붙이고 없으면 빈 집합으로 처리하거나, 스크립트에서 `check` 대신 `compileJava spotlessCheck checkstyleMain` 등을 명시적으로 나열한다. + +#### M8. `MongoProfileProperties`는 기본값 없는 17-component record이고, 예시 yml이 저장소에 없다 + +- **근거**: `autoconfigure/MongoProfileProperties.java:23-53`. `production()`/`local()` 팩토리(`:56-97`)에는 합리적 기본값이 전부 있는데 record component default로는 내려오지 않는다. `grep -rn "persistence-mongo.platform" src/**/*.yml` → 0건. +- **왜 문제인가**: H4와 함께, "profile 하나 켜기"의 실질 비용이 17키 + 4bean이 된다. 그 조합을 보여주는 파일이 저장소에 없다. +- **수정 방향**: `config/persistence.yml`에 주석 처리된 완전한 profile 예시 블록 하나. + +#### M9. Compose가 쓰는 Mongo 이미지와 테스트 레인이 pin한 이미지가 다르다 + +- **근거**: `docker-compose.infra.yml:59` — `image: mongo:7` (부동 태그). `build.gradle:139-144` — `mongo:8.0.16`(primary), `mongo:7.0.28`(compatibility). +- **왜 문제인가**: 로컬 개발이 7.x 최신, CI 레인이 8.0.16이다. Stable API V1 strict를 쓰는 배포에서 두 서버의 거동 차이가 로컬에서 안 잡힌다. `mongo:7`은 부동이라 어제와 오늘이 다를 수도 있다. +- **수정 방향**: compose를 `mongo:8.0.16`으로 pin해 primary 레인과 맞추거나, 최소한 `mongo:7.0.28`로 고정. + +#### M10. CLAUDE.md가 "shipped되지 않았다"고 쓴 change-stream driver source가 shipped되어 있다 + +- **근거**: `CLAUDE.md:121-124` — "The driver-side source — `watch`, `resumeAfter`/`startAfter`, cursor lifetime and reconnection — is **not** shipped." vs `src/.../mongo/changestream/consumer/SpringReactiveChangeStreamSource.java:43-70`(watch + resumeAfter/startAfter 전부 구현) + `MongoPlatformAutoConfiguration.java:207-215`(bean으로 등록). +- **수정 방향**: CLAUDE.md를 사실에 맞춘다. 코드가 사실이다. + +#### M11. CLAUDE.md가 존재하지 않는 `testkit` 소스셋을 가리킨다 + +- **근거**: `CLAUDE.md:66`("No production package may depend on `…mongo.testkit..`"), `:87-94`("in the **testkit** source set"). 실제 소스셋은 `testFixtures`와 `mongoProviderTestkit`이다(`build.gradle:65-80`). 패키지 이름은 `…mongo.testkit…`이 맞지만 소스셋 이름은 아니다. +- **수정 방향**: 용어 통일. (자잘하지만 이 문서는 fork가 읽는 첫 계약서다.) + +#### M12. `SpringReactiveChangeStreamSource`가 subscription의 batchSize와 maxAwaitTime을 버린다 + +- **근거**: `changestream/MongoChangeStreamSubscription.java:17-18, 31-37` — 두 값 모두 검증되고 상한이 있다(`MAX_BATCH_SIZE = 1000`, maxAwaitTime > 0). vs `changestream/consumer/SpringReactiveChangeStreamSource.java:52-70` `optionsFor` — `fullDocumentLookup`, `fullDocumentBeforeChangeLookup`, `resumeAfter`/`startAfter`만 설정한다. `ChangeStreamOptions`에는 `maxAwaitTime`이 있는데 쓰지 않는다. +- **왜 문제인가**: subscription record의 Javadoc(`:10-13`)이 "an unbounded batch buys throughput with heap, and an unbounded await time makes a stalled stream indistinguishable from an idle one"이라고 이유를 대며 두 값을 강제한다. 그 두 값이 드라이버에 도달하지 않으므로 이유가 성립하지 않는다. +- **완화 요인**: H3대로 이 경로 자체가 배포된 composition root에서 활성화되지 않는다. 그래서 Medium. +- **수정 방향**: `options.maxAwaitTime(subscription.maxAwaitTime())`를 추가. batchSize는 Spring Data의 reactive change stream API가 노출하지 않으므로, 못 적용한다는 사실을 record Javadoc에 적거나 필드를 제거한다. + +--- + +### Low + +- **L1.** `MongoPersistenceConfigTest`(`src/test/.../MongoPersistenceConfigTest.java:20, 64`)가 폐기 네임스페이스 `spring.data.mongodb.database`를 쓴다. `MongoNamespaceContractTest`가 `/src/main/`만 훑기 때문에 잡히지 않는다. 바인딩되지 않아도 테스트는 통과하므로(database 이름은 URI 기본값으로 대체) 증거력이 약한 어서션이다. +- **L2.** `MongoReactiveWiringTest`(`:55-60`)와 `ReactiveBinderCarriesRuntimeContractTest`(`:1309-1317`)가 실제 `com.mongodb.reactivestreams.client.MongoClients.create(...)`를 호출한다. 주석은 "the driver is lazy and no operation runs here"라고 쓰지만, 드라이버는 `create` 시점에 cluster/monitor 스레드를 만든다. 테스트당 스레드 누수 가능. `hermetic`이라는 이름과 어긋난다. +- **L3.** `MongoModuleBoundaryTest.theDeclaredEdgesFormADag`(`:319-340`)의 `reaches`가 `visited` 집합을 형제 분기 간에 공유한다. 사이클을 놓칠 수 있는 형태다(현재는 사이클이 없으므로 결과에 영향 없음). +- **L4.** `build.gradle:238`의 주석이 "311 of this leaf's 313 production files declare a public top-level type"라고 쓰는데 실제로는 353개 중 346개다. 루트 `CLAUDE.md`가 "a number written in prose drifts the moment a leaf is added"라고 경고하는 바로 그 형태. (baseline 파일 자체는 346개로 정확히 일치한다 — 내가 이름 단위로 대조 확인.) +- **L5.** `MongoAtomicOperationsTemplate`·`MongoBulkExecutor`·`SpringMongoGeospatialOperations`·`PolicyAwareMongoAggregationExecutor`가 전부 `access.rawOperations()`를 쓰므로 `BoundScopedOperations`의 `maxTimeMS` 부착을 우회한다(`imperative/BoundScopedOperations.java:44-47`). 이 네 경로에는 서버 측 deadline이 없다. H2의 전제. +- **L6.** `MongoValidatorApplyPolicy.CERTIFIED_RELEASE_LINES`(`schema/validation/MongoValidatorApplyPolicy.java:33-34`)는 7.0/8.0을 pin하는데, `MongoVersionMatrix.standard()`(testFixtures)도 같은 목록을 따로 갖고 있다. 두 곳이 드리프트할 수 있다. +- **L7.** `mongoIntegrationTest` 소스셋 안의 5개 레인은 같은 클래스 디렉터리 위에서 태그로만 갈린다(`StrictTestLanePlugin:141-145`). 한 클래스에 태그를 두 개 달면 두 레인에서 실행되고, `MongoLaneDisjointnessVerifier`는 `test` ↔ `mongoStableContractTest` 쌍만 보므로 잡히지 않는다. 현재 실제 중복은 0이다(7개 클래스가 태그 1개씩: compatibility 1, failover 2, migration 1, replicaset 1, security-integration 2). Docker 레인은 `check`에 없으므로 비용·증거 왜곡이 hermetic 쌍보다 작다. 자세한 분석은 §7.6. + +--- + +## 6. 바꾸지 말 것 (Keep) + +### K1. opt-in을 세 겹으로 만든 것 — 필터 + 게이트된 AutoConfiguration 하나 + component scan 제외 + +- **무엇**: `MongoOptInAutoConfigurationImportFilter`(Boot 자체 auto-config 차단) / `MongoRootAutoConfiguration`(유일한 진입점, `@ConditionalOnProperty`) / `AUTO_CONFIGURED_PACKAGES` 정규식(component scan 제외). +- **왜 지금 이게 맞는가**: 이 중 하나라도 빠지면 뚫린다. 필터가 없으면 starter가 classpath에 있는 것만으로 `MongoClient`가 생기고, 진입점이 여러 개면 서로 "꺼져 있다"고 믿으면서 각자 조립한다(`MongoRootAutoConfiguration.java:12-18`이 그 이력을 기록하고 있다). scan 제외가 없으면 `dev.caskeleton.adapter`를 훑는 component scan이 `@Configuration` 클래스를 직접 발견한다. `MongoPersistenceConfigTest`가 이 조합을 실제 `@EnableAutoConfiguration` 컨텍스트에서 end-to-end로 증명한다. +- **언제 재검토**: Boot가 auto-configuration import 필터 SPI를 바꾸거나, composition root가 component scan 대신 명시적 import로 전환할 때. + +### K2. `api` 패키지의 프레임워크 무의존 + 닫힌 edge 행렬 + +- **무엇**: `api/package-info.java`가 규칙을 선언하고, `MongoModuleBoundaryTest.ALLOWED_EDGES`(`:38-105`)가 **전체 패키지 DAG를 닫힌 집합으로** 강제한다. 디스크의 패키지 목록과 정확히 일치해야 하고, 관측된 edge가 선언에 없으면 실패한다. +- **왜 지금 이게 맞는가**: 이 leaf는 22,968줄 단일 jar다. Gradle 모듈 분리 없이 22개 패키지 경계를 지키는 방법은 이것뿐이다. 그리고 이 테스트는 **자신이 무력화되는 조건까지 방어한다** — `:107-114`의 주석이 `DO_NOT_INCLUDE_JARS`를 켰더니 import가 비어서 10개 규칙이 전부 "검사할 클래스 없음"으로 통과했던 사건을 기록하고, `allowEmptyShould`를 일부러 켜지 않았다고 쓴다. +- **언제 재검토**: leaf가 실제 Gradle 모듈로 쪼개질 때. 그때는 Gradle 의존 그래프가 이 행렬을 대체한다. + +### K3. transaction body retry와 commit retry를 별개 루프로 분리한 것 + +- **무엇**: `MongoTransactionRetryCoordinator.execute`(`transaction/retry/MongoTransactionRetryCoordinator.java:73-105`)가 body 실패 시 **새 세션**으로 전체 재실행, `commitWithRetry`(`:134-152`)는 이미 계산된 값을 그대로 들고 commit만 반복. `MongoTransactionSession`이 `runBody`와 `commit`을 분리된 메서드로 노출(`transaction/MongoTransactionSession.java:16-25`). +- **왜 지금 이게 맞는가**: `TransientTransactionError`와 `UnknownTransactionCommitResult`는 정반대 대응을 요구하고, 이걸 틀리면 실패가 조용하다 — 주문 중복, 이중 환불. `TransactionTemplate`이나 `MongoTransactionManager`는 암묵 커밋이라 이 분리를 표현할 수 없고, `SpringMongoTransactionSessionFactory.java:30-34`가 그 이유를 명시한다. 예외 타입이 컨텍스트를 검증해서 모순된 조합을 생성자에서 거부하는 것(`api/error/MongoTransactionCommitUnknownException.java:36-53`, `MongoTransactionTransientException.java:35-50`)까지 포함해 일관적이다. +- **언제 재검토**: Spring Data가 body/commit 분리 API를 1급으로 제공할 때. + +### K4. Docker 레인을 별도 provider 소스셋으로 옮기고 `check`에서 뺀 것 — 지금 진행 중인 변경 + +- **무엇**: `build.gradle:65-80`의 `mongoProviderTestkit`/`mongoIntegrationTest` 소스셋, `:98-113`의 Testcontainers 의존 격리, `:123-127`의 `test`에서 `mongodb-contract` 태그 제외, `:225-228`의 `check` 의존. 근거 스펙은 `docs/superpowers/specs/2026-09-18-test-architecture-phase2-provider-ownership.md`의 수용 기준 — *"moved provider tests live on a provider source set, not ordinary `test`"*, *"Docker/provider absence fails the required lane rather than becoming an approved JUnit skip"*. +- **왜 지금 이게 맞는가**: 결과가 측정 가능하다 — `grep -rn testcontainers src/test src/testFixtures` → **0건**. Docker 없는 노트북에서 `test`가 Testcontainers를 classpath에 올리지 않는다. `build.gradle:115-122`가 이유를 쓴다: "a `check` that fails on a laptop without Docker teaches people to skip `check`". 분리 방식도 옳다 — `testFixtures`에는 provider-neutral 계약(`MongoNetworkFaultController`/`MongoPrimaryController` 인터페이스, `MongoReplicaSetContract`/`MongoFailoverScenario` enum)만 남고, Docker 구현체는 `mongoProviderTestkit`에만 있다(§7.3-B). 그리고 `verifyMongoTestLaneDisjointness`가 JUnit XML로 실제 교집합을 검사한다 — 주석을 믿지 않는다. +- **언제 재검토**: CI가 Docker를 항상 제공하고 개발자 환경도 그렇게 보장될 때. 그때도 `check`에 넣기보다 별도 `integrationCheck`에 두는 게 낫다. + +### K4b. `ca.strict-test-lane` 규약 — "돌지 않은 레인"을 초록으로 만들 수 없게 한 것 + +- **무엇**: `src/build-logic/.../strictlane/StrictTestLanePlugin.java` + - `:47-64` 레인이 선택됐는데 소스셋 파일이 0개면 GradleException (`"Gradle would skip it as NO-SOURCE and report success for a lane that ran nothing"`) + - `:157` `failOnNoDiscoveredTests = true` + - `:158` `getOutputs().upToDateWhen(ignored -> false)` — 레인은 절대 up-to-date가 되지 않는다 + - `:174-203` 실행 0건이면 GradleException, 그리고 이유를 구분해서 보고한다 — 전부 skip됐는지 / 태그가 아무것도 매칭 못 했는지 / required test가 없어졌는지 + - `:204-213` `rejectSkipped` 레인은 skip 하나만 있어도 실패 + - `:214-227` `requiredTests`가 실제로 실행됐는지 사후 대조 (`"A lane that named a test it no longer runs proves less than it claims"`) + - `:237-243` 태그도 required도 없이 `test` 소스셋 위에서 도는 레인은 **선언 자체를 거부**한다 +- **왜 지금 이게 맞는가**: 이 저장소의 릴리스 게이트 전체가 "레인 N이 M개를 실행했다"는 JUnit XML 위에 서 있다(`release-contracts.json`, `MongoReleaseContractLaneVerifier`, `verify-mongodb-platform.sh`). 그 증거의 전제는 "레인이 실제로 돌았다"이고, Gradle의 기본 동작(NO-SOURCE ⇒ SKIPPED ⇒ 빌드 성공)은 그 전제를 조용히 깬다. 이 규약이 그 경로를 전부 막는다. H6에서 본 대로, untracked 소스셋이 커밋에서 빠지는 최악의 시나리오에서도 **조용한 초록 대신 명시적 실패**가 난다. +- **언제 재검토**: 없음. 이건 "증거"라는 단어가 의미를 갖게 하는 최소 조건이다. + +### K5. `allowed_dependencies: []` + 양방향 parity 테스트 + +- **무엇**: `modules.json`의 이 leaf 항목이 빈 배열이고, `MongoRegistryPermissionParityTest`(`src/app-bootstrap/src/test/.../registry/`)가 레지스트리 허용 집합과 build가 선언한 project 의존이 **정확히 같은지** 확인한다. +- **왜 지금 이게 맞는가**: `verifyCleanArchitectureDependencies`는 "실제 edge ⊆ 허용 edge"만 본다. 쓰이지 않는 허용은 영원히 통과한다 — `CLAUDE.md:33-39`가 정확히 이 비대칭을 지적하고 반대 방향 검사를 추가했다. "언젠가 쓸지도 모른다"로 열어 둔 권한이 쌓이는 것을 막는 유일한 방법이다. +- **언제 재검토**: 실제 도메인 Mongo adapter가 application port를 구현하게 될 때. 그때 build와 registry를 **같은 커밋에서** 함께 넓힌다. + +### K6. Advanced capability guard를 ArchUnit으로 강제하고, 실패 fixture로 규칙을 증명한 것 + +- **무엇**: `@MongoAdvancedEntryPoint`/`@MongoAdvancedPolicy` 이분법 + `MongoAdvancedRules.everyEntryPointConsultsTheGuard()`(testFixtures)가 **public 생성자마다** guard 파라미터와 `require` 호출을 확인. `MongoAdvancedRulesTest:767-800`이 `Unclassified`/`Ungated`/`GuardIgnored` 세 개의 실패 fixture로 규칙이 실제로 떨어지는지 확인한다. +- **왜 지금 이게 맞는가**: `MongoAdvancedEntryPoint.java:20-23`이 이 규칙이 없던 시절을 기록한다 — 문서가 "모든 entry point가 flag를 확인한다"고 주장하는 동안 16개 중 4개만 확인했다. "규칙을 한 번도 떨어지는 걸 본 적 없는 규칙은 모양을 모르는 규칙"이라는 이유로 negative fixture를 쓴 것은 이 저장소 전체에서 가장 성숙한 테스트 습관이다. +- **언제 재검토**: advanced 패키지가 별도 Gradle 모듈로 분리되어 classpath 자체가 게이트가 될 때. + +### K7. 모듈을 "빼는" 대신 "꺼진 채로 싣는" 선택 + +- **무엇**: `app-bootstrap/build.gradle:91`의 `implementation(project(':adapter:outbound:persistence-mongo'))`. +- **왜 지금 이게 맞는가**: `README.md:22-24`의 논거가 정확하다 — 부재는 배포 시점에 되돌릴 수 없고, 존재하지 않는 코드는 자기 condition이 무엇이라 말하든 bean을 0개 들고 있으므로 gating 결함을 전부 가린다. 실제로 이 leaf의 토글 결함(H7의 fail-open 목록 같은 것)은 모듈이 classpath에 있기 때문에 테스트로 잡을 수 있다. +- **언제 재검토**: jar 크기나 startup classpath 스캔이 측정 가능한 문제가 될 때. 그 전에는 측정 없이 바꾸지 않는다. + +### K8. BSON 표현 manifest와 converter fingerprint + +- **무엇**: `MongoTypeRepresentationManifest`(모든 축 필수, "미지정"을 표현 불가), `MongoCustomConversionsFactory.converters()`가 **명시적 순서 리스트**를 만들고(`mapping/MongoCustomConversionsFactory.java:39-53`), `fingerprint()`가 manifest + converter 클래스명을 합친다. +- **왜 지금 이게 맞는가**: 표현은 이미 저장된 모든 문서에 구워져 있다. 라이브러리 업그레이드가 표현을 옮기면 그건 아무도 쓰지 않은 마이그레이션이다. `MongoUuidRepresentation`에 `UNSPECIFIED`가 없는 것, `MongoEnumRepresentation.LEGACY_ORDINAL_READ_ONLY`가 writable()=false인 것, `BigDecimalToDecimal128Converter`가 34자리 초과를 드라이버 이전에 거부하는 것이 전부 같은 원칙의 일관된 적용이다. +- **언제 재검토**: 없음. 이건 데이터 계약이고 바꾸려면 마이그레이션이 필요하다. + +### K9. keyset cursor의 HMAC + 타입 태그 + 길이 프레이밍 + +- **무엇**: `query/pagination/MongoKeysetCursorCodec`(HMAC-SHA256, 상수 시간 비교, 길이 상한을 decode 이전에 검사), `MongoCursorValueCodec`(BSON 타입별 인코딩, 인코딩 불가 타입은 `toString()` 격하 대신 거부, 길이 프레이밍). +- **왜 지금 이게 맞는가**: 커서는 클라이언트가 들고 다시 돌아오는 질의 술어다. 서명이 없으면 테넌트 스코프 목록에서 데이터 유출이다. 그리고 `Instant`가 `String`으로 돌아오면 MongoDB의 BSON 타입 순서 때문에 다음 페이지가 조용히 틀린다 — 오류가 아니라 다른 질문에 대한 답이 된다. `MongoKeysetCursorTypeTest:811-820`이 값 안에 프레이밍 문자가 들어간 케이스까지 확인한다. +- **언제 재검토**: 없음. + +### K10. `MongoOperationRejectedException`의 예외 계층이 driver cause를 붙이지 않는 것 + +- **무엇**: `api/error/MongoPersistenceException.java:14-21` — cause를 받는 생성자가 **없다**. `MongoFailureContext`는 bounded·data-free 값만 담는다. +- **왜 지금 이게 맞는가**: driver 예외는 실패한 command를 들고 있고, command는 문서·필터·때로는 connection string의 credential을 들고 있다. 로깅 문장에서 빼는 것보다 **타입에서 빼는 것**이 강하다 — 뺄 것이 없으니까. `MongoDriverFailureView`(`failure/MongoDriverFailureView.java:563-564`)가 driver 타입이 아직 스코프에 있는 유일한 지점에서 label·code·boolean 2개로 좁히는 것도 같은 원칙이다. +- **언제 재검토**: 없음. + +--- + +## 7. 커밋 안 된 리팩토링이 이 영역에 미친 영향 + +> **정정 반영.** `full.diff`는 `git diff HEAD`라 untracked 파일이 없다. 저장소 전체 실수치는 tracked +2,374 / −22,532, **untracked +21,270(175파일)**, 순증감 ≈ **+1,112**. 즉 −22,532는 대부분 이동이다. 이 절은 `untracked-files.txt`/`untracked-wc.txt`와 2026-09-18 스펙 2건을 읽고 다시 썼다. + +### 7.1 이 리팩토링이 무엇인가 — capability composition ownership 이전 + +`docs/superpowers/specs/2026-09-18-*.md` 10건이 같은 주제를 공유한다. 내 영역에 해당하는 2건: + +**(1) `2026-09-18-mongo-health-composition-ownership.md`** — Actuator health SPI 브리지를 `app-bootstrap`에서 Mongo leaf로 옮긴다. 스펙이 직접 쓴 이유: *"Keeping the final SPI bridge in app-bootstrap leaves the capability split across two owners."* 호환성 조항이 명시적이다 — 마스터 스위치 유지, health 의미 불변(topology mismatch ⇒ DOWN, degraded secondary ⇒ UP + detail), **bean 이름 `mongoPlatformHealthContributor` 유지**, `@ConditionalOnMissingBean` 유지, 새 public 타입 0개, `verifyMongoApiSurface` 불변. + +**(2) `2026-09-18-test-architecture-phase2-provider-ownership.md`** — 소유권 규칙을 선언한다: *"an adapter leaf owns real-provider semantics for the provider it implements; app-bootstrap owns assembly, conditional wiring, authority selection."* 수용 기준에 **"moved provider tests live on a provider source set, not ordinary `test`"** 와 **"Docker/provider absence fails the required lane rather than becoming an approved JUnit skip"** 가 있다. 이 스펙의 첫 슬라이스는 JPA(`postgresqlIntegrationTest`)이고 Mongo는 follow-up 4번이지만, **Mongo leaf가 그 패턴의 참조 구현이다** — `build.gradle:51-53`이 "This leaf is the first migration off `ca.testkit-publisher`: one leaf, two lanes, no cross-module consumer — the proof that the path works before the published testkits follow"라고 쓴다. + +repo 전체 untracked 175파일 중 신규 provider 소스셋이 확인된다: `persistence-mongo/src/mongoProviderTestkit`(8), `persistence-mongo/src/mongoIntegrationTest`(7), `persistence-jpa/src/postgresqlIntegrationTest`(7), `messaging-kafka/src/integrationTest`(11), `objectstorage/src/integrationTest`(6), `web/src/systemTest`(7), `graphql/src/systemTest`(4), `websocket/src/systemTest`(3). **"검증 삭제"가 아니라 저장소 전체의 provider 소스셋 이전이다.** + +### 7.2 내 영역의 실제 수치 + +| | 파일 | 줄 | +|---|---|---| +| tracked 삭제 (Mongo leaf) | 15 | −2,445 | +| tracked 삭제 (app-bootstrap → leaf 이전분) | 3 | −113 | +| **untracked 추가 (Mongo leaf)** | **18** | **+2,530** | +| tracked 변경 | `build.gradle`, `MongoRootAutoConfiguration.java`, `CLAUDE.md`, `gradle.lockfile` | +67/−11 (lockfile 제외) | + +**삭제 18 ↔ 추가 18. 1:1로 대응한다.** + +### 7.3 세 갈래 판정 + +#### (A) 양쪽에 다 없는 것 — 진짜 손실: **0건** + +`status.txt`의 Mongo 관련 삭제 18건을 `untracked-files.txt`와 대조한 결과 전부 대응 파일이 있다. 내용까지 바이트 단위로 대조했다: + +| 삭제 위치 → 새 위치 | 결과 | +|---|---| +| `src/test/.../compat/MongoVersionCompatibilityLaneTest` → `src/mongoIntegrationTest/...` | **바이트 동일** (155줄) | +| `src/test/.../failure/MongoNetworkFaultLaneTest` → 동 | **바이트 동일** (206줄) | +| `src/test/.../migration/MongoMigrationLaneTest` → 동 | **바이트 동일** (357줄) | +| `src/test/.../rs/MongoSingleReplicaSetContainerTest` → 동 | **바이트 동일** (111줄) | +| `src/test/.../rs/MongoThreeNodeReplicaSetTest` → 동 | **바이트 동일** (37줄) | +| `src/test/.../security/MongoSecurityIntegrationLaneTest` → 동 | **바이트 동일** (173줄) | +| `src/test/.../security/MongoTlsLaneTest` → 동 | 5줄 차이 — `connectionString("localhost")` → `connectionString(server.host())`. **어서션 약화 없음**, Docker host가 localhost가 아닌 환경 대응 | +| `src/testFixtures/.../testkit/{atlas,failover,rs}/*` 8개 → `src/mongoProviderTestkit/...` | 7개 **바이트 동일**, `MongoTlsReplicaSetContainer`만 SAN을 `DNS:localhost,IP:127.0.0.1,+dockerHost`로 **넓힘**(기능 확장) | +| `app-bootstrap/.../autoconfigure/mongo/MongoPlatformHealthConfig.java` → `leaf/.../mongo/MongoPlatformHealthConfiguration.java` | 20줄. 아래 (B) 참조 | +| `app-bootstrap/.../autoconfigure/mongo/MongoPlatformHealthContributor.java` → `leaf/.../mongo/MongoPlatformHealthContributor.java` | 23줄. `public` → package-private으로 좁아짐 (스펙의 "새 public 타입 0개"와 일치) | +| `app-bootstrap/src/test/.../MongoPlatformHealthContributorTest.java` (29줄) → `leaf/src/test/.../MongoPlatformHealthContributorTest.java` (64줄) | **강화됨** — bean 이름 유지와 override back-off를 `ApplicationContextRunner`로 확인하는 케이스가 추가됨 | + +**브리프 질문 6의 전제("그 레인이 깎였다면")는 사실과 반대다. `mongoIntegrationTest` 소스셋은 지금 새로 생기는 중이고, Docker 레인의 어서션은 하나도 줄지 않았다.** + +#### (B) 양쪽에 다 있는 것 — 중복 조립 / 빈 충돌: **0건** + +- `mongoPlatformHealthContributor` bean: 옛 `app-bootstrap/.../autoconfigure/mongo/` 디렉터리는 워킹트리에서 **사라졌다**(`ls` → 존재하지 않음). `app-bootstrap/src/main`에 남은 Mongo 참조는 `persistence.yml` 3줄, `CaSkeletonApplication:103`의 scan 제외 정규식, `CapabilityDependencyValidator`의 active-profile 검사뿐이다. 같은 이름의 bean을 만드는 곳은 leaf 한 곳뿐 → **충돌 없음.** +- 컨테이너 fixture: `testFixtures`에 남은 것은 **provider-neutral 계약만**이다 — `MongoNetworkFaultController`(interface), `MongoPrimaryController`(interface), `MongoReplicaSetContract`(enum), `MongoFailoverScenario`(enum), `MongoAtlasCapabilityContractSuite`(값 타입). Docker 구현체(`ToxiproxyMongoNetworkFaultController`, `MongoThreeNodeReplicaSet`, `MongoAtlasLocalContainer` 등)는 `mongoProviderTestkit`에만 있다. **FQCN 중복 0건**이고, 이 분리는 스펙의 "application-core owns reusable, provider-neutral port contracts; an adapter leaf owns real-provider semantics" 규칙을 소스셋 단위로 그대로 옮긴 것이다. +- 컴파일 계층도 맞다: `mongoProviderTestkit { compilesAgainst 'main', 'testFixtures' }` → 인터페이스를 본다. `mongoIntegrationTest { compilesAgainst 'main', 'testFixtures', 'mongoProviderTestkit' }` → 둘 다 본다. `test`는 `java-test-fixtures`가 붙여준 `testFixtures`만 본다 → **Testcontainers가 `test`의 classpath에 도달할 경로가 없다.** `grep -rn testcontainers src/test src/testFixtures` → **0건**으로 실증된다. + +#### (C) untracked라 `git add` 없이 커밋하면 사라지는 것: **18파일 / 2,530줄 전부** + +- `src/mongoIntegrationTest/` 통째로 (7파일, 1,204줄) — replica set / failover / migration / compatibility / security-integration / TLS 레인 전부 +- `src/mongoProviderTestkit/` 통째로 (8파일, 1,219줄) — 컨테이너·Toxiproxy·인증·TLS fixture 전부 +- `src/main/.../MongoPlatformHealthConfiguration.java`, `MongoPlatformHealthContributor.java` (43줄) — **production 코드** +- `src/test/.../MongoPlatformHealthContributorTest.java` (64줄) + +**production 코드 2개가 untracked라는 것이 가장 중요하다.** 지금 `git add -u && git commit`하면 `app-bootstrap`의 health 브리지는 삭제되고 leaf의 대체물은 추가되지 않는다 → **Mongo health contributor가 저장소에서 통째로 사라진다.** + +다만 이쪽은 빌드가 막아 준다: `MongoRootAutoConfiguration.java`의 tracked diff(+3/−1)가 `MongoPlatformHealthConfiguration.class`를 `@Import` 목록에 넣는 변경이므로, 그 클래스가 없으면 **컴파일이 깨진다.** "조용히 기능이 빠진 채 초록"이 되는 시나리오는 없다. + +`src/mongoPerformanceTest/`는 untracked가 아니다(`untracked-files.txt`에 없다) — 리팩토링 이전부터 존재하던 소스셋이고, `compilesAgainst`에 `mongoProviderTestkit`가 추가되는 build.gradle 변경만 받았다. 따라서 **`mongoPerformanceTest`는 커밋에서 살아남지만, 컴파일에 필요한 `mongoProviderTestkit`가 없어서 같이 깨진다.** + +테스트 소스셋 쪽은 다르게 실패한다. `StrictTestLanePlugin`(`src/build-logic/.../strictlane/StrictTestLanePlugin.java:47-64`)이 레인 선택 시 소스셋의 소스 파일이 0개면 GradleException을 던진다: + +> `strict test lane 'mongoReplicaSetTest' ... has no sources in source set 'mongoIntegrationTest'. Gradle would skip it as NO-SOURCE and report success for a lane that ran nothing.` + +그리고 `:157`의 `failOnNoDiscoveredTests = true`와 `:174-203`의 `doLast` 검사가 "0건 실행"을 GradleException으로 만든다. **조용히 초록이 되지 않는다.** 이건 H6의 심각도를 낮추는 사실이므로 H6 본문을 정정했다. + +### 7.4 판정 + +**안전망 절단이 아니다. 저장소 전체 provider-ownership 이전의 일부이고, 이 leaf에서는 순개선이다.** + +개선 항목 (근거 포함): +- `test`의 runtime classpath에서 Testcontainers/Toxiproxy 제거 (`build.gradle` diff `-testImplementation 'org.testcontainers:*'` 4줄 + `-testFixturesImplementation` 5줄). 실증: `src/test`·`src/testFixtures`에 testcontainers 참조 0건 +- `test`의 `excludeTags`가 6개 → 1개. 나머지 5개는 **소스셋 분리**로 물리적으로 섞일 수 없게 됨 (`StrictTestLanePlugin:141-142`가 레인별 `testClassesDirs`/`classpath`를 소스셋 출력으로 고정) +- `testcontainers-junit-jupiter` 의존 제거 — 코드가 `@Testcontainers`/`@Container`를 쓰지 않으므로(확인) 안전 +- health 소유권 이전 — 어댑터의 health를 composition root가 알 필요가 없다 +- `MongoPlatformHealthContributor`가 `public` → package-private으로 좁아짐. `verifyMongoApiSurface` 기준선(346개)이 실제 public 타입 346개와 **정확히 일치**하는 것을 내가 이름 단위로 확인했으므로, 스펙의 "새 public 타입 0개" 주장은 사실이다 + +남은 부작용 1건 (정정된 서술): +- health configuration이 옮겨 오면서 `@ConditionalOnProperty(...enabled=true)`가 사라졌다(옛 `MongoPlatformHealthConfig`에는 있었다 — diff에서 확인, 새 `MongoPlatformHealthConfiguration.java:10-15`에는 없다). **이건 결함이 아니라 게이트 위치 이동이다** — 스펙이 "the Mongo master switch and conditional registration of the health contributor"를 leaf 소유로 선언했고, 실제 게이트는 `MongoRootAutoConfiguration`(`@AutoConfiguration` + `@ConditionalOnProperty`)의 `@Import` edge 하나로 단일화됐다. auto-configuration이 import한 `@Configuration`은 auto-configuration 단계에서 처리되므로 `@ConditionalOnBean`도 지원되는 위치다. 방어층이 3겹 → 2겹으로 줄었지만(중복 조건 제거), 남은 2겹(import 체인 + component scan 제외)이 각각 독립적으로 충분하다. → **발견으로 올리지 않는다.** + +### 7.5 `check`만으로 알 수 있는 것과 알 수 없는 것 (브리프 질문 6) + +- `check`가 **증명하는 것**: 패키지 경계 전체(닫힌 DAG, 실제 클래스 그래프 대조), 실패 분류와 retry scope(phase별), 트랜잭션 body/commit 분리, change stream 순서·중복·checkpoint 순서·invalidate 처리, keyset 커서 타입 왕복과 HMAC, BSON converter 집합과 순서와 fingerprint, atomic/bulk 정책 공유, admin 승인 상태 기계(digest 바인딩·단일 사용·만료), credential 지문 동일성, TTL/인덱스/validator manifest 규칙, advanced guard 강제(실패 fixture 포함), public API surface, **그리고 `test`와 `mongoStableContractTest`가 같은 테스트를 두 번 돌리지 않는다는 것**(`verifyMongoTestLaneDisjointness`). +- `check`가 **증명하지 못하는 것**: 레플리카셋에서 트랜잭션이 실제로 커밋되는지, change stream이 실제로 이벤트를 전달하는지, 응답 유실 시 driver 예외가 정말 `WRITE_RESULT_UNKNOWN`으로 분류되는지(그리고 그때 서버에는 쓰기가 실제로 적용되어 있는지), TLS 인증서 4종 시나리오, RBAC가 실제로 쓰기를 거부하는지, migration lock이 두 번째 runner를 배제하는지, fence가 superseded runner의 checkpoint를 거부하는지, 인덱스가 실제로 사용되는지(explain executionStats). +- **그 전부가 `mongoIntegrationTest`(지금 untracked)와 `mongoPerformanceTest`(tracked이지만 untracked인 `mongoProviderTestkit`에 컴파일 의존)에 있다.** 커밋에서 빠지면 위 목록이 저장소에서 사라지거나 컴파일이 깨진다. 다만 (C)에서 본 대로 조용히 사라지지 않고 GradleException/컴파일 오류로 깨진다. +- 실행 경로: `MONGODB_DOCKER=1 bash scripts/verify-mongodb-platform.sh`. 안 돌리면 스크립트가 exit 2 + "STABLE GATE: INCOMPLETE -- lanes above were not run, so their evidence categories are absent"를 보고한다. **미실행을 통과로 계산하지 않는다.** + +### 7.6 lane disjointness가 무엇을 강제하고, 지금도 유효한가 (브리프 질문 3) + +**무엇을 강제하는가.** `MongoLaneDisjointnessVerifier`(`src/build-tools/.../buildtools/mongo/MongoLaneDisjointnessVerifier.java:12-28`)는 `build/test-results/test`와 `build/test-results/mongoStableContractTest`의 JUnit XML을 파싱해 `classname#name` 선택자 집합을 만들고, **교집합이 비어 있지 않으면 빌드를 실패시킨다.** 최대 5개 예시를 메시지에 담는다. + +**왜 그런 강제가 필요했는가.** `build.gradle:115-122`가 사고 경위를 기록한다: `mongodb-contract`가 `test`의 `excludeTags`에 없었고, `check`는 `test`와 `mongoStableContractTest`에 **둘 다** 의존한다. 결과적으로 clean 빌드마다 382개의 hermetic contract 테스트가 **두 번씩** 실행됐다. 막으려는 사고는 두 가지다 — (1) CI 시간 낭비, (2) 더 중요하게, 어느 레인이 실제로 그 테스트를 돌렸는지 불명확해져 `release-contracts.json`의 "이 클래스가 이 레인에서 N개 실행됐다"는 증거가 무의미해지는 것. 그리고 이 검사는 **주석이 아니라 JUnit XML을 읽는다** — `:120-122`가 "The two lanes are now disjoint by construction, and `MongoTestLaneDisjointnessTest` asserts it against the JUnit XML rather than trusting this comment"라고 쓴다. + +**지금도 유효한가 — 유효하고, 리팩토링이 범위를 정확히 좁혔다.** + +리팩토링 전: 6개 레인이 전부 `src/test` 소스셋을 공유하고 **태그로만** 갈렸다. 태그 하나를 빠뜨리거나 `excludeTags` 목록을 갱신하지 않으면 어느 조합이든 겹칠 수 있었다. + +리팩토링 후(`StrictTestLanePlugin:141-142`가 레인별로 `setTestClassesDirs(sourceSet.getOutput().getClassesDirs())` + `setClasspath(sourceSet.getRuntimeClasspath())`를 한다): + +| 레인 | 소스셋 | 선택 | +|---|---|---| +| `test` | `test` | `excludeTags 'mongodb-contract'` | +| `mongoStableContractTest` | `test` (`StrictTestLaneSpec:18` 기본값) | `includeTags 'mongodb-contract'` | +| `mongoReplicaSetTest` / `mongoFailoverTest` / `mongoMigrationTest` / `mongoCompatibilityTest` / `mongoSecurityIntegrationTest` | `mongoIntegrationTest` | 각자 다른 태그 | +| `mongoPerformanceTest` | `mongoPerformanceTest` | 태그 없음 (소스셋이 곧 선택) | + +**소스셋을 공유하는 레인 쌍은 `test` ↔ `mongoStableContractTest` 하나뿐이다.** 다른 조합은 클래스 디렉터리가 달라 겹칠 수 없다. 즉 검증기가 **정확히 겹칠 수 있는 유일한 쌍**을 본다. 범위를 넓힐 필요가 없어졌다. + +**남은 구멍 1건(Low).** `mongoIntegrationTest` 소스셋 안의 5개 레인은 같은 클래스 디렉터리 위에서 태그로만 갈린다. 한 클래스에 태그를 두 개 달면 두 레인에서 실행되고, 검증기는 그 쌍을 보지 않는다. 현재는 7개 클래스가 정확히 태그 1개씩이라(확인: compatibility 1, failover 2, migration 1, replicaset 1, security-integration 2) 실제 중복은 0이다. 검증기를 `mongoIntegrationTest` 레인 쌍까지 확장하거나, 각 레인에 전용 소스셋을 주면 닫힌다. 다만 Docker 레인은 `check`에 없으므로 중복 실행의 비용·증거 왜곡이 hermetic 쌍보다 작다 — 그래서 Low다. + +--- + +## 8. 템플릿 사용자 관점 + +### Mongo를 안 쓰는 fork (대다수) + +**할 일: 없다.** 기본값이 off이고, off가 구조적이다(§3). classpath에 sync driver jar가 남는 것이 유일한 비용이고, 이건 의도된 설계다. + +주의할 점 하나: leaf를 통째로 제거하고 싶다면 건드려야 할 곳이 **4군데**다 — `modules.json`, `settings.gradle`, `app-bootstrap/build.gradle:91-99`, `CaSkeletonApplication.AUTO_CONFIGURED_PACKAGES:103`. 여기에 `config/persistence.yml:13-19`, `.env.example:297-299`, `.env.local.example:27-29`, `env-keys.yaml:4294-4319`, `compose-profile-contracts.json`, `docs/architecture/mongo-api-surface.txt`, `src/config/mongodb/release-contracts.json`, `build-tools/mongo/*`까지 더하면 12군데다. (이건 이 leaf만의 문제가 아니라 레지스트리 확장점 전반의 문제이므로 다른 담당자 영역과 겹친다.) + +### Mongo를 쓰는 fork — 밟게 될 지뢰 순서대로 + +1. **`APP_PERSISTENCE_MONGO_ENABLED=true` + `APP_PERSISTENCE_MONGO_ACTIVE_PROFILE=primary`로 켠다.** 기동 성공. +2. **연결이 안 된다.** README대로 `spring.data.mongodb.uri`를 세팅했지만 바인딩되지 않았기 때문(**C1**). 올바른 키는 `spring.mongodb.uri` / `SPRING_MONGODB_URI`이고, 그건 `compose-profile-contracts.json`에만 나온다. +3. **`active-profile`이 아무것도 안 한다는 것을 나중에 알게 된다**(**H1**). 오타를 내도 통과하므로 모를 수도 있다. +4. **profile을 제대로 선언하려고 `platform.profiles.primary.*`를 쓴다.** 17개 키가 전부 필요하고(**M8**), 예시가 없다. 바인딩에 성공하면 `MongoTopologyProbe` bean이 없어서 기동 실패(**H4**). probe를 만들면 `MongoSecurityProfile`·admin `MongoCredentialReference`·`MongoSchemaVersionRange` 세 개가 더 필요하다. +5. **그 전부를 만들어도 TLS는 안 켜진다**(**C2**). `MongoClientSettingsFactory`를 직접 wiring해야 한다는 것을 아무 문서도 말하지 않는다. +6. **문서 저장을 시작한다.** `MongoCollectionProfileRegistry`(비어 있음)와 `MongoAtomicPolicyRegistry`(비어 있음, 비면 **모든** atomic/bulk 연산 거부 — `MongoAtomicPolicyRegistry.java:40-47`)를 채워야 한다. 이건 의도된 fail-closed이고 옳다. +7. **reactive를 쓰려면** `app-bootstrap/build.gradle`의 exclude 2줄을 지워야 한다(**H3**). 안 지우면 `changestream/`·`reactive/` 패키지 34개 클래스가 조용히 죽어 있다. +8. **transaction executor·query builder·pagination codec·migration runner·admin gateway는 전부 직접 bean으로 등록해야 한다.** `MongoPlatformAutoConfiguration`은 15개 bean만 만든다. + +### 손대야 하는 파일 (Mongo를 실제로 쓸 때) + +| 파일 | 왜 | +|---|---| +| `src/app-bootstrap/src/main/resources/config/persistence.yml` | `spring.mongodb.uri` 추가, `platform.profiles.*` 선언 | +| `src/.env.example`, `src/.env.local.example` | `SPRING_MONGODB_URI` 추가 | +| `docs/registries/env-keys.yaml` | 위 키 등록 (`verifyEnvKeys`가 미등록 키를 어떻게 다루는지는 미확인) | +| fork가 새로 만드는 `@Configuration` 1개 | `MongoTopologyProbe`, `MongoSecurityProfile`, admin `MongoCredentialReference`, `MongoSchemaVersionRange`, `MongoCredentialResolver`, `MongoCollectionProfileRegistry`, `MongoAtomicPolicyRegistry`, `MongoManifestRegistry`, `MongoBudgetPolicyRegistry`, `MongoTypeMetadataRegistry`, `MongoKeysetCursorCodec`, transaction executor | +| `src/app-bootstrap/build.gradle:91-99` | reactive를 쓸 경우 exclude 제거 | +| leaf의 `document`/`repository`/`mapper` 패키지 | 새로 작성 | + +### 종합 도입 판정 + +**이 leaf는 "MongoDB 어댑터"라기보다 "MongoDB 플랫폼 설계서를 실행 가능한 형태로 쓴 것"이다.** 코드 품질은 이 저장소에서 읽은 것 중 최상위다 — 모든 클래스가 자신이 막는 실패 모드를 이름으로 지목하고, 테스트가 그 실패를 재현하는 negative fixture를 들고 있으며, ArchUnit 경계가 닫혀 있다. Mongo 고유의 어려운 결정(§9의 표)을 회피하지 않고 전부 명시적으로 다뤘다. + +**그러나 22,968줄 중 fork가 켜자마자 동작하는 부분은 거의 없다.** 켜는 순간 기동 실패 4연타와 침묵하는 오설정 2건을 만난다. 도입 판정은 **"Mongo를 주 저장소로 쓸 팀에는 매우 유용한 출발점, Mongo를 곁들여 쓸 팀에는 과도한 부담"**이다. 후자라면 이 leaf를 제거하고 Spring Data MongoDB를 직접 쓰는 편이 빠르다 — 이 leaf가 제공하는 가드레일(query allowlist, atomic policy, keyset cursor, migration fence)은 전부 fork가 별도로 wiring해야 하므로, "공짜로 얻는 것"이 아니다. + +--- + +## 9. Mongo 고유 결정의 처리 현황 (브리프 질문 4) + +| 결정 | 판정 | 근거 | +|---|---|---| +| **write concern / read concern / read preference 명시 여부** | **구현됨 (드라이버 기본값에 맡기지 않음)** | `api/consistency/MongoConsistencyRegistry.standard()`가 6개 profile을 read preference + read concern + write concern + "실제 보장 문장"으로 닫힌 집합으로 선언(`:34-116`). enum 상수 하나라도 서술이 빠지면 `requireComplete`가 startup 실패(`:139-147`). `MongoConsistencyBinder.derive`(`imperative/MongoConsistencyBinder.java:72-84`)가 profile당 `MongoTemplate` 1개를 파생 — **공유 템플릿을 mutate하지 않는다**(이게 핵심: `setWriteConcern`은 전역 bean을 바꾸므로 다른 스레드의 내구성을 바꾼다). read 설정은 query별 적용(`:99-107`). `STALE_READ_ALLOWED`는 기본값이 될 수 없다(`:120-123`) | +| **multi-document 트랜잭션 사용 여부** | **구현됨. 그리고 기본 off** | `SpringMongoTransactionExecutor`/`SpringMongoTransactionSessionFactory`가 실제 driver session을 쓴다. `TransactionOptions`에 read/write concern + `maxCommitTime`을 명시(`transaction/SpringMongoTransactionSessionFactory.java:97-108`). `MongoTransactionProfile`이 secondary read를 생성자에서 거부하고 서버 기본 lifetime 60초를 넘는 timeout을 거부(`transaction/MongoTransactionProfile.java:28-43`). `MongoPlatformSettings.transactions`는 기본 false(`autoconfigure/MongoPlatformSettings.java:31`, `MongoStartupValidationTest:60-62`) | +| **local 개발 환경이 레플리카셋을 주는가** | **준다** | `docker-compose.infra.yml:55-95` — `--replSet rs0`로 뜨는 `mongo:7` + `mongo-rs-init` 서비스가 `rs.initiate()`를 멱등 실행. profile `local-mongo`/`all-adapters`. 주석(`:51-53`)이 이유를 쓴다: standalone은 "reads로는 동작하는" 배포라 사고를 늦게 발견시킨다. 다만 이미지가 부동 태그 `mongo:7`이라 레인의 `mongo:8.0.16`과 다르다(**M9**) | +| **인덱스를 코드로 만드는가 / 마이그레이션으로 만드는가** | **마이그레이션 + admin plane. 런타임 자동 생성 경로가 아예 없다** | `MongoIndexApplyPolicy`(`schema/index/MongoIndexApplyPolicy.java:22-33`)가 환경별 4단계(APPLY / APPLY_WITH_DIFF / DIFF_WITH_APPROVED_APPLY / REPORT_ONLY)를 정의하고 production은 REPORT_ONLY. `MongoProfileProperties.validate()`가 `production && runtimeAutoCreateIndexes`를 거부(`:123-129`). `MongoCollectionManifest`(`schema/manifest/MongoCollectionManifest.java:11-14`)가 **`@Indexed` 애너테이션 유래를 명시적으로 거부**한다 — "Spring Data's `@Indexed` can create an index as a side effect of a class being on the classpath, which means production index state depends on deployment order". 인덱스 삭제는 6단계 retirement workflow를 거친다(`MongoIndexRetirementState`, 한 번에 한 단계만). `MongoIndexDiffEngine`이 encryption/search가 만든 인덱스를 drop 후보에서 제외(`MongoMetadataOwnership.droppableByApplicationDrift()`) — 이게 없으면 QE `__safeContent__` 인덱스를 orphan으로 오인해 지운다 | +| **스키마 변경(문서 구조 진화) 처리** | **구현됨. 버전 필드 있음** | `DocumentSchemaVersion`(정수), `MongoSchemaVersionRange`(읽을 수 있는 범위 ≠ 쓰는 버전 — dual reader → new writer → backfill → 구 reader 은퇴 절차를 표현), `MongoSchemaVersionPolicy.requireReadable`이 **도메인 역직렬화 이전에** 미래/은퇴 버전을 거부(`api/schema/MongoSchemaVersionPolicy.java:69-79`). `schemaVersion` 필드 부재는 legacy read를 opt-in한 컬렉션에서만 V0으로 해석(`:60-66`). JSON Schema validator는 `MongoSchemaManifest`가 소유하고 완화(MODERATE/WARN)에는 **만료일이 필수**(`schema/manifest/MongoSchemaManifest.java:29-36`) | +| **낙관적 락 (`@Version`)** | **자체 구현. Spring Data `@Version`은 부족하다고 명시** | `MongoRevision`(field `version`), `VersionedUpdateCommand`가 predicate와 `$inc 1`을 **분리 불가능하게** 조립한다(`imperative/revision/VersionedUpdateCommand.java:31-42`). `validated()`가 (a) filter가 revision을 제약하는지, (b) 그 값이 숫자인지, (c) update가 revision을 **정확히 한 번** 쓰는지, (d) 그게 `$inc 1`인지를 확인(`:57-89`). `$inc 1` 후 `$inc 5`나 `$inc` 후 `$set`이 통과하던 버그가 기록되어 있다. `VersionedMongoUpdater.applyWithRetry`는 **재계산 후 재시도**한다 — 이전 계산값 재전송은 정확히 낙관적 락이 막으려던 lost update다(`:64-104`). `MongoOptimisticConflictTranslator`가 "충돌"과 "문서 없음"을 분리해 종료하지 않는 재시도 루프를 막는다. Javadoc이 이유를 쓴다: "Spring Data's `@Version` covers `save()`. It does not cover a custom partial update" | +| **`_id` 생성 전략 / 도메인 식별자 매핑** | **구현됨** | `MongoIdRepresentation` enum(STRING / OBJECT_ID / BINARY_UUID)을 컬렉션별로 선언. 핵심은 `DomainDocumentId`(`api/mapping/DomainDocumentId.java:7-17`) — Spring Data가 **24자리 hex인 String `@Id`를 자동으로 `ObjectId`로 강제 변환**하는 heuristic을 회피하기 위한 wrapper 타입. 도메인 식별자(해시, 짧은 코드, dash 없는 UUIDv7)가 우연히 그 모양이면 컬렉션의 절반이 `ObjectId`, 절반이 `String`으로 저장되고 equality query가 안 맞는다. non-String 타입에 등록된 converter는 항상 heuristic을 이긴다. `DomainIdWriteConverter`/`DomainIdReadConverter` 쌍으로 왕복 보장 | +| **(추가) 문서 크기 / embedded array 성장** | **구현됨** | `MongoDocumentSizeBudget`이 MongoDB 하드 리밋 16MiB의 1/4(4MiB)를 플랫폼 상한으로 두고 그 위는 생성자에서 거부. `EmbeddedCollectionDescriptor.unbounded()`가 "모른다"를 **표현 가능하게 만든 뒤 validator가 거부**한다. `MongoDocumentModelValidator`가 위반을 전부 모아서 한 번에 던진다 | +| **(추가) NoSQL injection** | **구현됨** | `executeUserBson(String)`/`runCommand(Map)`이 없다. `PolicyAwareMongoQueryBuilder`는 등록된 필드 경로 + 등록된 연산자로만 표현 가능. `MongoRegexPolicy.prefixPattern`/`containsPattern`이 caller의 텍스트를 `Pattern.quote`로 이스케이프해 **호출자가 문법을 기여할 수 없게** 한다. `MongoRegexPolicy:686-696`이 nested quantifier 검사가 증명이 아니라 필터라는 것을 정직하게 서술한다 | + +--- + +## 10. 미확인 / 가정 + +빌드를 돌리지 못했다(Gradle wrapper jar가 스냅샷에 없음). 아래는 코드 판독 기반 주장이고, 확인 명령을 함께 적는다. + +| 항목 | 상태 | 확인 명령 | +|---|---|---| +| **M7** `check -x mongoStableContractTest`가 `verifyMongoTestLaneDisjointness`의 `@InputDirectory` 부재로 실패하는가 | **미검증, 개연성 높음** | `cd src && ./gradlew clean :adapter:outbound:persistence-mongo:check -x mongoStableContractTest --console=plain` | +| **C1** Boot 4.0.8에서 `spring.data.mongodb.uri`가 실제로 바인딩되지 않는가 | **간접 근거만** — `MongoPersistenceSettings.java:15`가 "deprecated at error level in its metadata"라고 서술. metadata JSON을 직접 열어 확인하지 않음 | `cd src && ./gradlew :adapter:outbound:persistence-mongo:dependencies --configuration runtimeClasspath` 후 `spring-boot-mongodb-*.jar`의 `META-INF/spring-configuration-metadata.json`에서 `spring.data.mongodb.uri`의 `deprecation.level` 확인 | +| **C1** URI 미설정 시 드라이버 기본값이 `mongodb://localhost:27017/test`인가 | **드라이버 문서 기반 가정** | `APP_PERSISTENCE_MONGO_ENABLED=true APP_PERSISTENCE_MONGO_ACTIVE_PROFILE=primary ./gradlew :app-bootstrap:bootRun` 후 로그의 cluster description | +| **H3** `app-bootstrap` 런타임 classpath에 `ReactiveMongoTemplate`이 실제로 없는가 | **build.gradle exclude 기반. 전이 의존으로 들어올 가능성 미확인** | `cd src && ./gradlew :app-bootstrap:dependencies --configuration runtimeClasspath \| grep -i reactivestreams` | +| **H7** Boot 4.0.8의 Mongo auto-configuration 클래스가 정확히 9개인가 | **필터의 목록을 신뢰. classpath와 대조하지 않음** | `unzip -l ~/.gradle/.../spring-boot-mongodb-*.jar \| grep AutoConfiguration` 와 `MongoOptInAutoConfigurationImportFilter:24-34` 대조 | +| **L2** reactive `MongoClients.create`가 테스트에서 스레드를 만드는가 | **드라이버 동작 기반 가정** | `./gradlew :adapter:outbound:persistence-mongo:mongoStableContractTest --console=plain` 후 스레드 덤프 | +| `verifyEnvKeys`가 미등록 `SPRING_*` 키를 어떻게 다루는가 | **미확인** (다른 담당 영역) | `cd src && ./gradlew :app-bootstrap:verifyEnvKeys --console=plain` | +| `gradle.lockfile` 293줄 변경의 내용 | **읽지 않음** (의존성 버전은 다른 담당 영역) | — | +| `docs/mongodb/*.md` 9개 문서의 코드 일치 여부 | **읽지 않음.** M10/M11의 문서 드리프트가 이 9개에도 있을 가능성이 높다 | `grep -rn "spring.data.mongodb\|not shipped\|testkit source set" docs/mongodb/` | + +### 세운 가정 + +1. `@ComponentScan`의 `FilterType.REGEX`가 FQCN에 매칭된다고 가정했다(Spring 문서 기준). 이 가정이 틀리면 §3의 3번째 방어층이 무너지고 `MongoPlatformHealthConfiguration`이 component scan으로 발견될 수 있다 — 다만 `@ConditionalOnBean`이 여전히 막으므로 실질 결과는 같다. +2. `strictTestLanes` convention(`ca.strict-test-lane`)이 `failOnNoDiscoveredTests`를 켠다고 build.gradle 주석(`:129-131`)을 믿었다. convention 소스를 읽지 않았다. +3. H6의 "커밋하면 사라진다"는 `git commit -a` / `git add -u`를 쓸 경우다. `git add -A`나 IDE의 stage-all이면 문제없다. + +--- + +## 부록 A — 발견 요약 + +| ID | 심각도 | 한 줄 | 근거 | +|---|---|---|---| +| C1 | Critical | Mongo를 켜면 URI 없이 드라이버 기본값으로 연결된다. README가 바인딩 안 되는 키를 가리킨다 | `README.md:36-38`, `MongoPersistenceSettings.java:14-19`, `persistence.yml`, `.env.example:297-299` | +| C2 | Critical | profile의 TLS·Stable API·타임아웃·풀 경계가 드라이버에 도달하지 않는다 (`MongoClientSettingsFactory` 호출자 0건) | `client/MongoClientSettingsFactory.java:38`, `MongoPersistenceConfig.java:26` | +| H1 | High | `APP_PERSISTENCE_MONGO_ACTIVE_PROFILE`이 필수 키인데 바인딩되는 곳이 없다 | `env-keys.yaml:4306-4319`, `MongoPersistenceSettings.java:22-37` | +| H2 | High | deadline 초과한 성공 연산이 `NOT_SENT`로 보고되어 중복 재시도를 유발한다 | `imperative/DefaultMongoImperativeExecutor.java:93-105` | +| H3 | High | reactive·changestream 34개 클래스가 배포 composition root에서 활성화 불가 | `app-bootstrap/build.gradle:98-99`, `MongoPlatformAutoConfiguration.java:187-189` | +| H4 | High | platform profile 선언 시 미고지 bean 4개 + 17키 필요, 기동 실패 4연타 | `MongoPlatformAutoConfiguration.java:330-367, 388-405`, `MongoProfileProperties.java:23-53` | +| H5 | High | health가 기동 시점 스냅샷을 라이브 관측값으로 보고. probe가 `final`이라 fork도 못 고친다 | `autoconfigure/MongoTopologyProbe.java:24-45`, `MongoPlatformHealthIndicator.java:69-72` | +| H6 | High | untracked 18파일 2,530줄(production health 2개 포함) — `git add` 없이 커밋하면 소실. 단 컴파일/strict-lane이 조용한 초록은 막는다 | `status.txt:54-68, 113-114, 155`, `untracked-files.txt`, `StrictTestLanePlugin.java:47-64` | +| H7 | High | auto-config 차단 목록이 하드코딩 fail-open이고 테스트가 0건 | `MongoOptInAutoConfigurationImportFilter.java:24-50` | +| M1 | Medium | README/CLAUDE.md가 폐기 네임스페이스를 가리키고 계약 테스트가 문서를 안 본다 | `MongoNamespaceContractTest.java:72-90` | +| M2 | Medium | 릴리스 증거 검증기 2벌, `check`가 도는 쪽이 failures·suite-name을 안 본다. 비-hermetic contract는 조용히 skip | `buildtools/mongo/MongoReleaseContractLaneVerifier.java:16-18`, `CLAUDE.md:88-90` | +| M3 | Medium | `findAndModify` 경로가 matched/modified를 항상 1/1로 보고 | `imperative/atomic/MongoAtomicOperationsTemplate.java:118` | +| M4 | Medium | reactive cursor의 결과 예산 추적기가 발동 불가 + 바이트 예산 미측정 | `reactive/cursor/MongoReactiveCursorPublisher.java:59-67` | +| M5 | Medium | `change-streams: true`가 조용히 무시된다. Javadoc은 "거부한다"고 씀 | `autoconfigure/MongoPlatformSettings.java:48-55` | +| M6 | Medium | `FlamingockLedgerAdapter`가 in-memory 비동시 맵 + fence 무시 | `migration/flamingock/FlamingockLedgerAdapter.java:28-30, 56-62` | +| M7 | Medium | `verify-mongodb-platform.sh:102`의 `check -x`가 clean 빌드에서 깨질 개연성 | `MongoVerificationPlugin.java:22-27` | +| M8 | Medium | `MongoProfileProperties` 17키 전부 필수, 예시 yml 부재 | `autoconfigure/MongoProfileProperties.java:23-53` | +| M9 | Medium | compose `mongo:7`(부동) vs 레인 `mongo:8.0.16` pin | `docker-compose.infra.yml:59`, `build.gradle:139-144` | +| M10 | Medium | CLAUDE.md가 "not shipped"라 한 change-stream source가 shipped·wired | `CLAUDE.md:121-124` vs `SpringReactiveChangeStreamSource.java:43-70` | +| M11 | Medium | CLAUDE.md가 없는 `testkit` 소스셋을 가리킴 | `CLAUDE.md:66, 87-94` vs `build.gradle:65-80` | +| M12 | Medium | change stream subscription의 batchSize/maxAwaitTime이 드라이버에 미도달 | `changestream/consumer/SpringReactiveChangeStreamSource.java:52-70` | +| L1–L7 | Low | §5 Low 절 참조. L7은 `mongoIntegrationTest` 내부 5개 레인의 태그 중복을 disjointness 검증기가 보지 않는다는 것 | §7.6 | + +### 부록 A-2 — 커밋 안 된 리팩토링 판정 요약 + +| 갈래 | 건수 | 내용 | +|---|---|---| +| (A) 양쪽에 다 없음 = 진짜 손실 | **0** | 삭제 18 ↔ untracked 추가 18. 바이트 대조 16개 동일, 2개는 기능 확장 | +| (B) 양쪽에 다 있음 = 중복 조립 | **0** | `mongoPlatformHealthContributor` bean 생성자 1곳. testFixtures(계약) / mongoProviderTestkit(구현) FQCN 중복 0 | +| (C) untracked라 커밋에서 사라질 것 | **18파일 2,530줄** | production 2 + test 16. 컴파일 오류 + strict-lane GradleException이 조용한 실패를 막음 | + +**종합: 이 leaf에서 리팩토링은 검증 표면 축소가 아니라 provider-ownership 이전이고, 순효과는 개선이다.** 남은 위험은 커밋 방식 하나뿐이다(H6). diff --git a/docs/reviews/2026-09-18-techlead-review/07-cache-redis.md b/docs/reviews/2026-09-18-techlead-review/07-cache-redis.md new file mode 100644 index 00000000..7aa7926a --- /dev/null +++ b/docs/reviews/2026-09-18-techlead-review/07-cache-redis.md @@ -0,0 +1,1399 @@ +# [영역] Redis 능력 어댑터 (cache / rate-limit / lease / idempotency) 리뷰 + +- 스냅샷: 2026-09-18T11:50Z / HEAD 60b6a319 + 커밋 안 된 변경 (tracked 224파일 + untracked 175파일) +- 담당 leaf: `adapter-outbound-cache-redis` (`:adapter:outbound:cache-redis`, `src/adapter/outbound/cache-redis`) +- 같이 읽은 것: `app-bootstrap`의 `bootstrap/autoconfigure/redis/*`, `CaSkeletonApplication`, + `META-INF/spring/*.imports`, `META-INF/spring.factories`, + `config/{redis,capabilities,ratelimit}.yml`, `build-logic/.../redis/*`, `infra/redis-sdk/**`, + `.github/workflows/redis-sdk-topology.yml`, `docs/registries/env-keys.yaml`, + `docs/superpowers/specs/2026-09-18-*.md` (untracked). + +> **이 리뷰의 한 줄 결론** +> `APP_REDIS_ENABLED=true`는 커넥션과 헬스체크만 만든다. 네 능력 중 **셋(cache / rate-limit / lease)은 +> 어떤 설정으로도 조립되지 않는다.** 능력을 조립하는 `@Configuration` 다섯 개가 컴포넌트 스캔에서 +> 제외된 패키지에 있는데 어떤 등록 경로에도 올라 있지 않기 때문이다. +> 브리프의 질문은 "disabled가 진짜 disabled인가"였다. 답은 "**enabled도 disabled**"다. + +--- + +## 0. 최종 적용 기준 + +Redis는 Capability Catalog의 대표 영역이다. cache/rate-limit/lease/idempotency application contract와 +Redis 구현을 분리하고 leaf/starter가 자기 AutoConfiguration을 소유한다. Build Composition에서 선택된 +서비스만 Redis를 ship하며 switch off에서는 Bean/connection/thread/scheduler가 없어야 한다. +business-visible 알고리즘 선택을 단순 ENV tuning으로 숨기지 않는다. + +## 0-A. 2026-09-21 중간 재검증 + +**상태: SDK ownership은 이동됐지만 Redis semantic capability ownership은 아직 bootstrap에 남아 있다.** + +진척: + +- `adapter:outbound:redis-runtime`가 생겼고 + `RedisSdkAutoConfiguration`을 자기 `AutoConfiguration.imports`로 발행한다. +- SDK/client/connection runtime을 leaf가 소유하는 방향은 맞다. + +미완료: + +- `app-bootstrap`의 root imports에는 여전히 `RedisCapabilityConfig`가 들어 있다. +- bootstrap 아래 `redis/`에는 점검 시점 10개 Java class가 남아 있다. +- `RedisCacheConfig`, `RedisRateLimitConfig`, `RedisLeaseConfig`, `RedisIdempotencyConfig`가 + `cache-redis` implementation 타입을 직접 import한다. +- `app-bootstrap/build.gradle`도 `cache-redis`, `redis-runtime`을 기본 `implementation`으로 ship한다. + +즉 현재 상태는: + + Redis SDK/client ownership → leaf로 이동 + Redis application-semantic adapter wiring → bootstrap에 잔존 + +이다. Phase 2 완료 조건은 semantic wiring까지 owner leaf/starter로 이동하고, Redis를 선택하지 않은 +서비스의 artifact에서 Redis dependency가 빠질 수 있게 하는 것이다. + +## 0-B. 2026-09-23 재검증 + +**판정: 아직 더 봐야댐. SDK 물리 분리는 진척됐지만 composition/test 경계가 다시 깨졌다.** + +좋아진 점은 Redis SDK 코드가 `cache-redis`에서 대량으로 빠져 `redis-runtime` leaf로 이동하는 작업이 +진행된다는 것이다. 이는 9월 21일 리뷰의 SDK ownership 분리 방향과 일치한다. + +하지만 현재 `app-bootstrap:test`의 `RedisCapabilityCompositionTest`가 live hostname +`redis-a:6379`에 연결하려다 실패한다. stack은 다음 경계로 이어진다. + + RedisCapabilityCompositionTest + -> RedisSemanticScriptAclProbe.afterSingletonsInstantiated + -> RedisRuntimeOwner.borrow(SCRIPT) + -> Lettuce RedisClient.connect + -> UnknownHostException(redis-a) + +즉 hermetic composition test 안에서 production startup ACL probe가 실제 provider 연결을 수행한다. +실 Redis에서 SCRIPT ACL을 검증하는 행위 자체는 integration/startup qualification로 가치가 있지만, +`src/test`의 “Bean graph가 조립되는가” 질문과 섞이면 fast lane이 외부 Redis 존재 여부에 종속된다. + +또한 semantic wiring 10개 class와 `RedisCapabilityConfig`는 여전히 bootstrap 소유다. SDK leaf 분리만으로 +Phase 2 완료라고 판정하지 않는다. + +## 1. 커버리지 + +**main 314 / 314 (32,082줄), test 69 / 69 (15,244줄) — 전부 전문 독해. 못 읽은 파일 없음.** + +| 구역 | 파일 | 확인한 것 | +|---|---|---| +| 능력 어댑터 `cache`/`idempotency`/`lease`/`ratelimit`/`realtime`/`keyspace` | 14 | Lua 전문, 실패 분류, 키 렌더링 | +| `sdk/api/**` (key 17, command 13, error 16, codec 3, operations 68, reactive 17, 루트 6) | 140 | 계약 타입·검증 규칙 | +| `sdk/config` 12, `sdk/cluster` 4, `sdk/lettuce/command` 14, `sdk/lettuce/connection` 9, `sdk/lettuce/codec` 7, `sdk/lettuce/observability` 2 | 48 | 조립·가드·번역·토폴로지 | +| `sdk/programmability` 17, `sdk/raw` 7, `sdk/admin` 4, `sdk/extensions/**` 17 | 45 | 트랜잭션·스크립트·raw·진단·확장 | +| `sdk/lettuce/operations` | 67 | 아래 §1.1 | + +### 1.1 마지막에 채운 67개 — 위임 계층의 가드 통과 여부 + +앞선 판본에서 "도달 불가라 시그니처만 대조"로 남겨 뒀던 55개(위임 37 + 레코드 10 + +부분독해 8)와 테스트 7개를 전부 읽었다. 읽은 목적은 분량 채우기가 아니라 **C3의 성격을 +가르는 한 가지 질문**이었다: 위임 클래스들이 `CommandPolicyGuard`를 통과하도록 쓰여 있는가, +아니면 우회하도록 쓰여 있는가. + +**답: 37개 중 36개가 가드 또는 가드를 감싼 실행자를 생성자에서 요구한다. 우회 경로는 0이다.** + +| 분류 | 개수 | 생성자가 요구하는 것 | 우회 메서드 | +|---|---|---|---| +| `LettuceRedis*Operations` (동기) | 18 | `SyncRedisCommandExecutor` | 0 | +| `LettuceReactiveRedis*Operations` | 17 | `ReactiveRedisCommandExecutor` | 0 | +| `LettuceRedisBatchOperations`, `LettuceReactiveRedisBatchOperations` | 2 | **`CommandPolicyGuard` 직접** (`BatchExecution`에 전달) | 0 | +| `LettuceRedisBatch` | 1 | 값 홀더. `Builder`가 `CommandRequest`만 만들고 `BatchExecution`이 admit | 0 | +| `LettuceRedisCommandGateway` | 1 | **없음 — 설계상 가드 아래의 드라이버 seam** | 해당 없음 | + +모든 public 메서드가 예외 없이 `executor.execute(requests.X(...))` 한 줄이다 +(예: `LettuceRedisValueOperations.java:24-106` 14개 메서드 전부, +`LettuceRedisKeyOperations.java:20-69` 12개 전부, 반응형도 동일). +게이트웨이를 직접 잡는 곳은 구독 수명주기 두 군데뿐이고 +(`LettuceRedisPubSubOperations`의 `LiveSubscription.start`, +`LettuceReactiveRedisPubSubOperations`의 `SubscriptionFlux.create`), +그 타깃조차 `PubSubOperationRequests.channelTargets/patternTargets`가 먼저 +네임스페이스를 검사한 결과다. + +이 사실이 C3의 판정을 바꾼다 — §5 C3를 보라. + +레코드 10개(`HashScanPage`·`KeyScanPage`·`MemberScanPage`·`ScoredMemberPage`·`StreamClaimPage`· +`StreamEntry`·`StreamPendingEntry`·`StreamPendingOverview`·`KeyedElement`·`GeoSearchHit`)는 +방어 복사와 위치 정합 검증을 갖춘 값 타입이고, `StreamEntry`/`KeyedElement`/`GeoSearchHit`는 +`toString()`에서 payload를 절대 렌더링하지 않는다. 결함 없음. + +부분독해였던 `LettuceRedisCommandGateway` 850줄과 +`Bitmap/Geo/Stream/Set/List OperationRequests` 후반부도 전문을 읽었다. 새로 나온 결함은 +§5 M13 하나다. + +테스트 7개(`RedisBitmapGeoOperationsContractTest`, `RedisHashFieldExpirationContractTest`, +`RedisStreamOperationsContractTest`, `RedisStreamDeletionCapabilityTest`, +`RedisExtensionModulesContractTest`, `RedisFunctionOperationsContractTest`, +`RedisRawGatewayContractTest`)도 전문을 읽었다. 전부 `RedisOperationsFixture`(= +`InMemoryRedisCommandGateway`)를 상대로 **가드를 실제로 켜고** 검증한다 — 위조 permit 거부, +네임스페이스 밖 키 차단, 예산 초과 거부, 버전 게이트. 즉 **가드는 테스트에서만 살아 있다.** + +## 2. 이 영역은 무엇을 하는가 + +이름은 하나지만 성격이 다른 **세 덩어리**가 한 leaf에 있다. + +**(A) SDK/런타임 계층 — 유일하게 조립되는 부분 (약 1,600줄)** + +`RedisSdkAutoConfiguration`이 만든다. 설정 바인딩·검증, 크리덴셜 해석, Lettuce 클라이언트, +커넥션 소유자(`RedisRuntimeOwner`), 헬스 컨트리뷰터 2개. 이게 전부다. + +**(B) 의미 능력 어댑터 — 코드는 있고 조립은 안 되는 부분 (약 1,900줄)** + +| port | 구현 | 물리 키 | 레인 | 실패 정책 | **조립** | +|---|---|---|---|---|---| +| `CacheRegionPort` | `cache/RedisCacheRegionAdapter` | `{ns}:cache:v1:{region}:{digest}` | `REGULAR` | fail-open | **안 됨** | +| `EdgeRateLimitPort` | `ratelimit/RedisEdgeRateLimitAdapter` | `{ns}:ratelimit:v1:{policyId}:{rev}:{subj}` | `SCRIPT` | fail-closed | **안 됨** | +| `DistributedLeasePort` | `lease/RedisDistributedLeaseAdapter` | `{ns}:lease:v1:{purpose}:{digest}` | `SCRIPT` | indeterminate | **안 됨** | +| `IdempotencyStorePortV2` | `idempotency/RedisIdempotencyStoreAdapter` | `{ns}:idem:v1:d{kdv}:{op}:{digest}` | `SCRIPT` | indeterminate | **안 됨** (다른 provider는 됨) | +| `ConnectionRegistryPort` | `realtime/RedisConnectionRegistryAdapter` | `{ns}:realtime:v1:…` | `REGULAR` | fail-open | **안 됨** | +| `EphemeralFanoutPort` | `realtime/RedisEphemeralFanoutAdapter` | pub/sub | `PUBSUB` | fail-open | **불가능** (게이트웨이 구현 부재) | + +**(C) 자체 제작 Redis SDK — 조립되지 않는 부분 (약 28,500줄)** + +타입드 API, 명령 정책 카탈로그(1,406줄 YAML), permit/budget 인가, 클러스터 슬롯 산술, +트랜잭션·스크립트·함수, raw/admin 게이트웨이, Redis 8 확장 모듈 4종. + +**세 덩어리는 런타임에 서로 만나지 않는다.** (A)만 존재하고, (B)는 조립될 경로가 없으며, +(C)는 (B)가 조립되더라도 우회된다((B)는 (C)의 가드를 거치지 않고 Lettuce에 직결한다). + +--- + +## 3. 런타임 토글 판정 — 꺼지면 정말 꺼지는가 + +### 3.0 등록 사슬 — 직접 재확인한 결과 + +토글 판정의 전제는 "선택자를 켜면 능력이 조립된다"였다. **그 전제가 틀렸다.** +코디네이터의 지적을 받아 등록 경로를 전수 추적했고, 반증 경로를 다섯 갈래로 찾아봤으나 없었다. + +``` +CaSkeletonApplication.java:41-57 + @ComponentScan(basePackages = {bootstrap, adapter, application, domain, shared}, + excludeFilters = REGEX(AUTO_CONFIGURED_PACKAGES)) +CaSkeletonApplication.java:99-100 + AUTO_CONFIGURED_PACKAGES = "dev\.caskeleton\.bootstrap\.autoconfigure\..*" | … + ↓ 이 정규식이 bootstrap.autoconfigure.redis 를 스캔에서 제외한다 +RedisCapabilityConfig.java:36 @Configuration(proxyBeanMethods = false) ← @AutoConfiguration 아님 +RedisCapabilityConfig.java:45-50 @Import({RedisCacheConfig, RedisRateLimitConfig, + RedisLeaseConfig, RedisIdempotencyConfig}) + ↓ 그럼 RedisCapabilityConfig 자신은 누가 등록하나? +``` + +**아무도 등록하지 않는다.** 확인한 다섯 갈래: + +1. **`app-bootstrap`의 `AutoConfiguration.imports` — 전문 5줄, redis 없음.** + `fileserver.FileserverPlatformAutoConfiguration`, `jpa.PersistenceJpaRootAutoConfiguration`, + `messaging.DisabledMessagingSentinelAutoConfiguration`, + `activation.AdapterActivationAutoConfiguration`, + `notification.NotificationApplicationCompositionAutoConfiguration`. +2. **`app-bootstrap`의 `spring.factories` — 전문 18줄.** `EnvironmentPostProcessor` 6개, + `SpringBootExceptionReporter` 1개, `AutoConfigurationImportFilter` 1개, `ApplicationListener` 1개. + Redis 항목은 `RedisReadinessGroupPostProcessor`(6번째 줄) 하나뿐이고, 이건 + `EnvironmentPostProcessor`이지 설정이 아니다. `EnableAutoConfiguration` 키 자체가 없다. +3. **`app-bootstrap` main 전체의 `@Import`는 4개.** + `FileserverPlatformAutoConfiguration.java:68`, `FileserverAdminManagementContextConfiguration.java:31`, + `PersistenceJpaRootAutoConfiguration.java:34`, `RedisCapabilityConfig.java:45`. + 앞 세 개는 자신이 `.imports`에 등록돼 있다. 네 번째는 **자식을 import할 뿐, 자신을 import하는 것이 없다.** + `PersistenceJpaRootAutoConfiguration.java:34`가 import하는 것은 + `MigrationStartupConfig`, `JpaPlatformRuntimeAutoConfiguration`뿐이다. +4. **main 소스에서 `RedisCapabilityConfig`에 대한 참조는 단 하나 — javadoc이다.** + `RedisCacheConfig.java:18`의 `{@link RedisCapabilityConfig} imports it and carries that switch`. + 코드 참조 0건. +5. **동적 등록 우회로 없음.** `app-bootstrap` main 전체에 `ImportSelector`, + `ImportBeanDefinitionRegistrar`, `@ImportAutoConfiguration`, `registerBeanDefinition`, + `BeanDefinitionRegistryPostProcessor` 0건. + +추가로 확인한 것: +- **leaf 자신의 `.imports`는 `RedisSdkAutoConfiguration` 한 줄뿐이다.** SDK/커넥션 계층이며 + 능력 조립이 아니다(§2 A). 전문을 읽었고 `@Bean`은 settings/validation/credentials/client/owner/ + health 6개뿐이다. +- **leaf main에 `@Component`/`@Service`/`@Repository`가 0개다.** 능력 어댑터는 평범한 클래스이므로 + `bootstrap.autoconfigure.redis.*`가 생성자로 조립하지 않으면 빈이 되지 않는다. +- `@ConfigurationPropertiesScan`(`CaSkeletonApplication.java:58-79`)은 + `@ConfigurationProperties` 클래스만 등록한다. `@Configuration` 클래스를 살려내지 못한다. + +### 3.1 능력 4개 각각의 판정 + +능력마다 답이 다르다. 대체 provider를 전부 뒤져 개별로 판정했다. + +#### cache — **조립 안 됨** + +- 유일한 `CacheRegionPort` 빈 팩토리: `RedisCacheConfig.java:33-37` + (`@Bean @ConditionalOnProperty(name="ca-skeleton.capabilities.cache.bindings.default", havingValue="redis")`). +- `RedisCacheConfig`는 `RedisCapabilityConfig.java:46`에서만 import되고, 그 부모가 미등록. +- 저장소 전체에서 `CacheRegionPort`를 반환하는 `@Bean`은 이것 하나다(전수 스캔). +- ⇒ `APP_CACHE_CANONICAL_DEFAULT_PROVIDER=redis`를 줘도 **캐시 port 빈이 없다.** +- 증상: 조용하다. `CacheRegionPort`를 주입받는 production 코드가 없으므로 기동은 성공하고, + 운영자는 캐시가 켜졌다고 믿는다. + +#### rate-limit — **조립 안 됨. 그리고 켜면 기동 실패한다.** + +- 유일한 `EdgeRateLimitPort` 빈 팩토리: `RedisRateLimitConfig.java:41-45`. 부모 미등록. +- 소비자는 등록된다: `adapter/inbound/web/.../ratelimit/RateLimitWebConfig.java:20-22`는 + 평범한 `@Configuration`이고, 패키지 `…web.ratelimit`은 `AUTO_CONFIGURED_PACKAGES` 정규식에 + **없으므로**(제외 목록은 `web.mvc.error|budget|operation`, `web.webflux.error|operation`, + `web.fileserver.admin`뿐) 컴포넌트 스캔에 잡힌다. +- `RateLimitWebConfig.java:32-37`: + ```java + if (!transportSettings.enabled()) { …disabled…; return; } + EdgeRateLimitPort port = requiredUnique(portProvider, "EdgeRateLimitPort"); + ``` + `requiredUnique`(`:59-66`)는 빈이 없으면 + `IllegalStateException("EdgeRateLimitPort must have exactly one bean when edge rate limiting is enabled")`. +- ⇒ **반증 가능한 예측**: `APP_REDIS_ENABLED=true`, `APP_RATE_LIMIT_PROVIDER=redis`, + `APP_RATE_LIMIT_ENABLED=true`로 기동하면 위 메시지로 **컨텍스트 생성이 실패한다.** + 세 값을 다 올바르게 준 배포가 기동하지 못한다. +- `config/ratelimit.yml:8`이 이 fail-fast를 의도로 문서화한다("enabled=true with no exact + EdgeRateLimitPort fails fast"). 의도는 맞는데 **port를 공급할 방법이 없다.** +- 이건 `RedisActivationValidator`의 javadoc(`:18-22`)이 막겠다고 한 실패 모드 + ("composition proceeds, the conditional Redis configuration creates nothing, and startup dies on + whichever provider selector notices a missing bean first")와 **글자 그대로 같다.** + 검증기는 `enabled=false + provider=redis` 조합만 보고, "provider=redis인데 아무도 조립 안 함"은 못 본다. + +#### lease — **조립 안 됨** + +- 유일한 `DistributedLeasePort` 빈 팩토리: `RedisLeaseConfig.java:26-28`. 부모 미등록. +- 저장소 전체에 다른 `DistributedLeasePort` 빈 없음. `DistributedLockPort` 빈 팩토리도 0건. +- ⇒ `APP_LEASE_PROVIDER=redis`를 줘도 빈이 없다. 소비자가 production에 없어 조용히 넘어간다. +- 참고: `app-bootstrap/src/test/.../autoconfigure/lock/DistributedLockConfigTest.java`가 + **untracked로 새로 추가**됐다. `bootstrap.autoconfigure.lock` 패키지가 준비 중으로 보이며, + 같은 정규식에 걸리므로 등록 계획을 함께 세워야 한다. + +#### idempotency — **Redis provider는 조립 안 됨. 그러나 다른 provider는 조립된다.** + +여기만 답이 다르다. + +- Redis 경로: `RedisIdempotencyConfig.java:33-37`(store) + `:64-68`(executor). 부모 미등록. **안 됨.** +- PostgreSQL 경로: + - store: `adapter/outbound/persistence-jpa/.../autoconfigure/PostgreSqlIdempotencyStoreConfig.java:17-18`, + `@ConditionalOnProperty(name="ca-skeleton.capabilities.idempotency.provider", havingValue="postgresql")` + - 등록됨: `PersistenceJpaAutoConfiguration.java:18-24`가 `@Import`하고, + 그 클래스가 persistence-jpa leaf의 `.imports` 첫 줄에 있다. **도달 가능.** + - executor: `bootstrap/autoconfigure/idempotency/PostgreSqlIdempotencyProviderConfig.java:49` — + 이건 `bootstrap.autoconfigure.*`라 **역시 미등록**이다. + - ⇒ `provider=postgresql`이면 **store만 생기고 executor는 안 생긴다.** 반쪽이다. +- **provider 값 자체도 문서와 다르다**: `capabilities.yml:28`은 `disabled | jdbc | redis`라고 적는데, + 실제로 도달 가능한 구현이 요구하는 값은 **`postgresql`**이다. 문서의 세 값 중 동작하는 것이 없다. + +### 3.2 그렇다면 `APP_REDIS_ENABLED=true`는 무엇을 만드는가 + +`RedisSdkAutoConfiguration`(leaf `.imports`에 등록됨, `:53-54`에서 `app.redis.enabled=true` 게이트)만 +살아 있으므로 실제로 만들어지는 것은 이것뿐이다. + +| 생기는 것 | 근거 | +|---|---| +| `RedisSdkSettings` (바인딩 + `validate()`) | `RedisSdkAutoConfiguration.java:83-87`, `:101-108` | +| raw allowlist 리소스 존재 검증 | `:119-142` | +| 크리덴셜 해석(설정된 롤만) | `:156-204` | +| Lettuce 클라이언트 + 이벤트 루프 | `:226-237`, `RedisTopologyClientFactory.java:284-288` | +| `RedisRuntimeOwner`(레인 풀) | `:273-284` | +| `redisOptional` 헬스(DEGRADED) | `:297-307` | +| `redisRequired` 헬스(DOWN, 정합성 롤 선택 시) | `:324-335`, `RedisCorrectnessRoles.java:32-37` | + +**그리고 그게 전부다.** 능력 port는 0개다. + +가장 고약한 결과: `APP_RATE_LIMIT_PROVIDER=redis`를 주면 +`RedisCorrectnessRoles.anySelected`가 true가 되어 **`redisRequired`가 생기고 readiness가 +Redis에 묶인다.** 즉 **존재하지 않는 능력 때문에 Redis 장애가 파드를 unready로 만든다.** +rate limiter는 없는데 readiness는 rate limiter를 위해 Redis를 요구한다. + +### 3.3 그래도 지켜진 토글 계약 + +위 결함과 별개로, **off 방향의 계약은 정확히 지켜진다.** 이건 진짜 자산이다(§6 K1). + +- `redis.yml:10-11` `enabled: ${APP_REDIS_ENABLED:false}`, `havingValue="true"`, + `matchIfMissing` 없음. +- off면 `RedisSdkSettings` 바인딩 0, 크리덴셜 조회 0, 클라이언트 0, 스레드 0, 리소스 읽기 0. +- **"빈이 없다"가 아니라 "호출이 없다"로 검증한다**: + `RedisSdkAutoConfigurationTest.java:92-128`이 시크릿 소스 호출 횟수를 세어 `hasValue(0)`을 단언한다. +- 시크릿 참조 해석은 전부 조건 안쪽이다. 브리프가 Critical 후보로 지목한 + `secret://environment/APP_CACHE_REDIS_KEY_HMAC_SECRET`은 `RedisCacheConfig.java:33-46`의 + 조건부 `@Bean` 안에서만 해석된다. **Critical 아님.** +- 능력 선택자만으로 Redis가 켜지지 않는다. `RedisActivationValidator.java:24,27,43-63`이 + 모순 조합을 기동 실패로 막고, 이 검증기는 `bootstrap/runtime/SecretSourceConfig.java:41-42`에서 + 생성되므로 **실제로 실행된다**(`bootstrap.runtime`은 스캔 대상). + +### 3.4 그러나 off 계약에도 구멍이 하나 있다 — 능력 설정은 항상 바인딩된다 + +- `RedisCapabilitySettings.java:24`가 **클래스 레벨** `@ConfigurationProperties(prefix="ca-skeleton.capabilities")`를 갖는다. +- 그 패키지 `dev.caskeleton.bootstrap.autoconfigure.redis`가 + `CaSkeletonApplication.java:65`의 `@ConfigurationPropertiesScan` basePackages에 **들어 있다.** +- ⇒ `APP_REDIS_ENABLED=false`인 배포에서도 이 클래스는 빈으로 등록되고 바인딩된다. +- `CaSkeletonApplication.java:27-30`의 주석은 정확히 이걸 금지한다: + "The five optional adapters are absent from the list below on purpose. … + Adding a package back here would restore the binding and silently undo the gate." + 그런데 65번 줄이 redis 패키지를 넣었다. +- **이걸 막으려고 만든 테스트가 절반만 막는다**: + `RedisOptionalityContractTest.java:32`의 + `REDIS_SETTINGS_TYPES = List.of(RedisSdkSettings.class)` — **한 클래스만** 검사한다. + `RedisCapabilitySettings`는 목록에 없다. +- **반증 가능한 결과**: Redis를 전혀 쓰지 않는 배포에 + `ca-skeleton.capabilities.cache.command-timeout=notaduration`을 넣으면 + `@ConfigurationProperties` 변환 실패로 **기동이 깨진다.** + `RedisSdkAutoConfigurationTest.disabledIgnoresMalformedRedisConfiguration`가 검증하는 면역은 + `app.redis.*`에만 있고 `ca-skeleton.capabilities.*`에는 없다. +- 심각도는 Medium이다(§5 M1). 커넥션·스레드가 생기는 건 아니고, 잘못된 값이 있을 때만 터진다. + +--- + +## 4. 구조 판정 + +| 축 | 판정 | 근거 | +|---|---|---| +| 의존 방향 (modules.json 대조) | **OK** | `allowed_dependencies` = `[domain-core, application-core, shared-contract, adapter-outbound-support]`. `build.gradle:26-28` = `application-core`, `shared-contract`, `adapter:outbound:support`. 초과 없음, 역방향 import 0건 | +| 경계 누수 (DTO·entity·framework 타입) | **OK** | port 구현의 반환 타입이 전부 `dev.caskeleton.application.*` / `shared.*`. `RedisLease`·`RedisCommandGateway`·Lua digest가 어댑터 밖으로 나가지 않는다 | +| 비즈니스 규칙 위치 | **OK** | 어댑터는 TTL·키·원자성만. fail-open 라이선스가 다른 port로 복사되지 않았다 | +| **조립 경계 (leaf vs 컴포지션 루트)** | **위반** | 능력 조립이 `app-bootstrap`에 있고, 그 패키지가 스캔 제외인데 등록되지 않았다(§3.0, §5 C1). 2026-09-18 스펙군이 세운 새 표준(조립은 leaf 소유)에도 어긋난다 | +| SDK ↔ 어댑터 경계 | **위반** | `CLAUDE.md:42-44`가 "모든 호출이 `CommandPolicyGuard` admission을 통과한다"고 선언하나, 가드가 프로덕션에서 생성되지 않는다(§5 C2) | +| 테스트 전략 적합성 | **부분 미흡** | 조립 테스트가 `withUserConfiguration`으로 손수 배선해 프로덕션 등록 여부를 묻지 않는다(§5 C1) — 저장소 자신이 이 실패 유형을 다섯 번 세어 뒀다(`DependencyErrorStartupContractTest.java:16-23`). 단위 테스트는 Lua를 실행하지 않는다(§5 M3). 가드는 테스트에서만 켜진다(§1.1) | + +--- + +## 5. 발견 + +### Critical + +#### C1. 능력 조립 설정 5개가 스캔 제외 패키지에 있고 어디에도 등록되지 않았다 — 세 능력이 조립 불가 + +- **현상**: `RedisCapabilityConfig`와 그 자식 4개(`RedisCacheConfig`, `RedisRateLimitConfig`, + `RedisLeaseConfig`, `RedisIdempotencyConfig`)가 프로덕션에서 **한 번도 처리되지 않는다.** + +- **근거** (§3.0의 다섯 갈래 전수 확인 요약): + - `CaSkeletonApplication.java:99-100` 정규식이 `bootstrap.autoconfigure.*`를 스캔에서 제외 + - `RedisCapabilityConfig.java:36`은 `@Configuration`이지 `@AutoConfiguration`이 아님 + - `app-bootstrap` `.imports` 5줄에 redis 없음 + - `app-bootstrap` `spring.factories`에 `EnableAutoConfiguration` 키 자체가 없음 + - main 전체에서 `RedisCapabilityConfig` 참조 = `RedisCacheConfig.java:18` **javadoc 한 줄** + - `ImportSelector`/`ImportBeanDefinitionRegistrar`/`@ImportAutoConfiguration`/ + `registerBeanDefinition`/`BeanDefinitionRegistryPostProcessor` = 0건 + - leaf `.imports` = `RedisSdkAutoConfiguration` 한 줄 (능력 조립 아님) + - leaf main `@Component`/`@Service`/`@Repository` = 0개 + - `CacheRegionPort`/`EdgeRateLimitPort`/`DistributedLeasePort` 빈 팩토리는 저장소 전체에 + 각각 하나뿐이고 전부 위 미등록 설정 안에 있다 + +- **왜 문제인가**: §3.1의 능력별 증상. + 1. **rate-limit: 기동 실패.** 세 env를 모두 올바르게 준 배포가 + `IllegalStateException("EdgeRateLimitPort must have exactly one bean…")`로 죽는다 + (`RateLimitWebConfig.java:37,59-66`). 메시지가 가리키는 빈은 운영자가 설정한 적 없는 것이다. + 2. **cache / lease: 조용한 무동작.** 소비자가 production에 없어 기동은 성공한다. + 운영자는 능력이 켜졌다고 믿는다. + 3. **readiness 오작동.** `APP_RATE_LIMIT_PROVIDER=redis`만으로 + `RedisCorrectnessRoles.anySelected`가 true가 되어 `redisRequired`가 생기고 + readiness가 Redis에 묶인다(`RedisSdkAutoConfiguration.java:324-335`, + `RedisReadinessGroupPostProcessor.java:43`). **존재하지 않는 능력을 위해 파드가 unready가 된다.** + 4. **idempotency는 반쪽.** `provider=postgresql`이면 store는 생기지만 + (`PostgreSqlIdempotencyStoreConfig.java:17-18` ← `PersistenceJpaAutoConfiguration.java:18-24` + ← persistence-jpa `.imports`) executor는 역시 미등록 패키지에 있다 + (`bootstrap/autoconfigure/idempotency/PostgreSqlIdempotencyProviderConfig.java:49`). + +- **왜 테스트가 못 잡았는가 (이게 핵심이다)**: + `RedisCapabilityCompositionTest.java:35-38`이 + ```java + new ApplicationContextRunner() + .withConfiguration(AutoConfigurations.of(RedisSdkAutoConfiguration.class)) + .withUserConfiguration(RedisCapabilityConfig.class, Support.class) + ``` + **테스트가 `RedisCapabilityConfig`를 손으로 등록한다.** 이 테스트는 + "등록되면 올바르게 조립된다"를 증명하고, "등록되는가"는 묻지 않는다. + 다섯 개 케이스(`noRoleComposesNoPort`, `cacheBindingComposesTheCacheRegion`, + `aRateLimiterWithoutPoliciesIsRefused`, `allRolesComposeTogether`, + `theSwitchOffComposesNothing`)가 전부 초록이면서 프로덕션은 아무것도 조립하지 않는다. + +- **설계가 틀린 게 아니라 등록 한 줄이 빠졌다.** 같은 패키지에 정답 패턴이 있다. + `FileserverPlatformAutoConfiguration.java:63-75`가 네 요소를 전부 갖췄다 — + `@AutoConfiguration`(`:63`) + 마스터 스위치(`:64-67`) + 자식 6개 `@Import`(`:68-75`) + + `.imports` 1행 등재. 그 javadoc `:47-53`이 이유까지 적는다: + *"lives in a package the composition root's scan explicitly excludes. That is the whole point"*. + `RedisCapabilityConfig`는 **네 요소 중 앞 세 개를 갖고 마지막 한 줄만 못 받았다** + (`:36` `@Configuration`, `:41` 스위치, `:45-50` `@Import` 4개, `.imports` 없음). + 구조를 바꿀 필요가 없고, 등록 한 줄과 애노테이션 한 단어가 빠진 것이다. + +- **저장소가 이 결함 유형을 이미 다섯 번 세어 뒀다.** + `app-bootstrap/src/systemTest/.../DependencyErrorStartupContractTest.java:16-23`: + > *"it establishes that the rule computes the right sentence — not that anything runs the rule … + > This repository has found five classes that were green in their own tests and present in no + > running application; a validator is a poor candidate to become the sixth."* + + 그 javadoc이 설명하는 메커니즘(`MockEnvironment`로 정적 메서드를 불러 "규칙이 맞는 문장을 + 계산한다"만 증명)과 `RedisCapabilityCompositionTest.java:35-38`의 + `withUserConfiguration(RedisCapabilityConfig.class, ...)` 자기등록은 **정확히 같은 형태다.** + 그리고 같은 javadoc `:25-28`이 해법도 적는다 — *"this boots the real composition root"*. + Redis 조립 테스트에 없는 것이 바로 그것이다. + +- **수정 방향** (권장 순서): + 1. **가장 싼 임시 조치**: `app-bootstrap`의 `AutoConfiguration.imports`에 + `dev.caskeleton.bootstrap.autoconfigure.redis.RedisCapabilityConfig` 한 줄 추가하고, + 그 클래스를 `@AutoConfiguration(after = RedisSdkAutoConfiguration.class)`로 바꾼다. + `after`는 선택이 아니다 — 자식 넷이 leaf의 `RedisRuntimeOwner`와 `RedisSdkSettings`를 + 주입받으므로(`RedisCacheConfig.java:38-42` 등) 순서를 명시해야 한다. + `bootstrap.autoconfigure.idempotency`의 executor도 같이 처리해야 idempotency가 온전해진다. + 1-a. **선행 조건 — `java.time.Clock` 빈이 배포 경로에 없다.** 네 능력 빈이 전부 `Clock`을 + 요구한다(`RedisCacheConfig.java:42`, `RedisRateLimitConfig.java:49`, + `RedisLeaseConfig.java:32`, `RedisIdempotencyConfig.java:41`). 그런데 프로덕션의 + `Clock` `@Bean` 공급원은 셋뿐이고 전부 조건부다: + `bootstrap/autoconfigure/idempotency/IdempotencyConfig.java:19-22`(**같은 이유로 죽음**), + `GraphQlPlatformAutoConfiguration.java:287-291`(`@ConditionalOnMissingBean`, GraphQL 게이트), + `sample-portfolio/.../SampleIdempotencyConfig.java:22`(샘플 전용). + `JpaAuditingConfiguration.java:24`와 `JpaTransactionAutoConfiguration.java:47`은 **소비자**이지 + 공급자가 아니다. 따라서 GraphQL도 sample-portfolio도 없는 배포에서 `RedisCapabilityConfig`만 + 등록하면 `NoSuchBeanDefinitionException: java.time.Clock`으로 기동이 실패한다. + **무조건 공급되는 `Clock` 빈을 먼저 만들어야 한다.** + 2. **올바른 조치(§8)**: 2026-09-18 스펙군이 세운 표준대로 조립을 **leaf로 옮긴다.** + notification/httpclient/jpa/mongo가 이미 갔고 cache-redis만 안 갔다. + 3. **재발 방지**: "능력 선택자가 `redis`인데 대응 port 빈이 없다"를 기동 실패로 만드는 검증. + `RedisActivationValidator`가 이미 선택자 목록(`:27-33`)을 갖고 있으므로 거기에 + `ObjectProvider` 존재 확인을 붙이면 된다. 그리고 컴포지션 테스트를 실제 + `CaSkeletonApplication`에 대해 돌리는 케이스를 하나 추가한다. + +- **반론과 재반박**: 이건 결정적 사실이므로 Rule → Evidence → Fix로 적는다. + Rule: Spring `@Configuration`은 컴포넌트 스캔·`@Import`·auto-configuration 등록 중 하나로 + 도달해야 처리된다. Evidence: 위 아홉 가지 확인. Fix: 위 셋. + - 다만 하나 예상 반론은 적어 둔다. *"`AdapterActivationAutoConfiguration`이 등록돼 있으니 + 거기서 능력을 살릴 수 있지 않나."* — 전문을 읽었다. `CapabilityDependencyStartupCheck`와 + `AdapterActivationEndpoint` 두 빈만 만들고 아무것도 import하지 않는다. 아니다. + +#### C2. `IdempotencyScripts`가 스레드 안전하지 않은 `LinkedHashMap`을 요청 경로에서 변이한다 + +(조립되면 즉시 발현한다. C1을 고치는 순간 살아나므로 같이 고쳐야 한다.) + +- **근거**: + - `idempotency/IdempotencyScripts.java:188` — `private final Map> digests = new LinkedHashMap<>();` + - `:209-210` — `digests.computeIfAbsent(name, unused -> new AtomicReference<>());` + - 호출 경로: `claim/transition/release/inspect`(`:190-205`) → `run(...)` → 위 줄. 전부 요청 스레드. + - 싱글턴: `RedisIdempotencyConfig.java:45` `new IdempotencyScripts()`가 `@Bean` 안에서 1회 생성. + - 대조: 같은 문제를 가진 두 파일은 `final AtomicReference` 필드로 안전하다 — + `ratelimit/RateLimitScripts.java:132-136`, `lease/LeaseScripts.java:84-87`. idempotency만 맵이다. +- **왜 문제인가**: 동시 `computeIfAbsent`는 (a) 엔트리 유실 → 중복 `SCRIPT LOAD`(무해), + (b) `LinkedHashMap` 연결 리스트 파손 → **요청 스레드 영구 점유**, (c) 부분 초기화 노드 → + NPE가 `catch (Exception)`에 잡혀 `INDETERMINATE`. (b)가 나면 멱등성 저장소를 쓰는 모든 요청이 멈춘다. + 재현은 부하에서만 되고 단위 테스트는 전부 단일 스레드다. +- **수정**: `new ConcurrentHashMap<>()`. 저장소 안에 올바른 선례가 있다 — + `sdk/programmability/RedisScriptRegistry`가 이미 `ConcurrentHashMap`을 쓴다. + Rule → Evidence → Fix. 한 글자. + +#### C3. SDK 28,500줄이 도달 불가 — 가드는 **설계로는 완전하고 조립으로만 없다** + +- **현상**: 명령 정책 카탈로그, permit/budget 인가, 네임스페이스 검사, 슬롯 검사, + 타임아웃 프로파일, 예외 번역, 관측 sink가 한 번도 인스턴스화되지 않는다. + 능력 어댑터가 조립되더라도 **그들은 SDK를 우회해** `LettuceRedisCommandGateway`로 + Lettuce에 직결한다. + +- **근거**: + - 컴포지션 루트 기준 참조 그래프: main 314개 중 **190개(18,261줄) 도달 불가**. + (능력 어댑터를 루트에 포함해도 그렇다. 능력 어댑터마저 조립 불가이므로 실제로는 더 많다.) + - `new CommandPolicyGuard(` / `new RedisOperationContext(` / + `new SyncRedisCommandExecutor(` / `QueueingRedisCommandExecutor` / + `ReactiveRedisCommandExecutor` / `RedisCommandCatalog.loadDefault()` / + `new RedisScriptRegistry(` / `RawCommandApprovals` / `LettuceRedisAdminOperations` / + `RedisCapabilityProbe` / `RedisStartupProbe` / `ClusterTopologyObserver` / + `SentinelFailoverObserver` / `RedisConnectionRegistry` — **main 0건**(전부 리터럴 grep). + - 실제 경로: `RedisTopologyClientFactory.java:391` → `new LettuceRedisCommandGateway(connection.async())` + → `LettuceRedisCommandGateway.java:131-133` `commands.get(key)` (가드 없음), + `:1065-1067` `commands.scriptLoad(source)`, `:1125-1131` `commands.evalsha(...)` + - `RedisCommandGateway` 메서드 약 118개 중 어댑터가 쓰는 것은 22개. + - `RedisPubSubGateway`는 **main에 구현이 없다.** 유일한 구현은 테스트의 + `InMemoryRedisPubSubGateway.java:18`. `RedisEphemeralFanoutAdapter`는 생성 자체가 불가능하다. + +- **두 주장을 갈라야 한다 (전수 확인 결과).** `CLAUDE.md:42-44`의 "모든 호출이 + `CommandPolicyGuard` admission을 통과한다"는 **범위를 나누면 하나는 참이고 하나는 거짓이다.** + + | 범위 | 판정 | 근거 | 수정 비용 | + |---|---|---|---| + | `sdk.lettuce.operations`의 타입드 연산 37개 | **설계로는 참, 조립으로만 거짓** | 36/37이 생성자에서 실행자 또는 가드를 **요구**한다. public 메서드는 전부 `executor.execute(requests.X(...))`이고 게이트웨이를 직접 잡는 메서드가 0개다(§1.1) | SDK 조립 슬라이스 하나 — 코드 수정 없이 빈 등록만으로 해소 | + | 능력 어댑터 6개 (실제 프로덕션 경로) | **설계 단계부터 거짓** | `RedisRuntimeOwner`만 받고 `lease.gateway()` = `LettuceRedisCommandGateway`에 직결한다. 실행자를 받는 생성자 파라미터가 없다 — `RedisCacheRegionAdapter.java:89-99`, `RedisEdgeRateLimitAdapter.java:114-121`, `RedisDistributedLeaseAdapter.java:75-83`, `RedisIdempotencyStoreAdapter.java:75-80` | 어댑터를 다시 쓰는 별도 작업 | + + 즉 **가드를 짠 사람과 능력 어댑터를 짠 사람의 판단이 갈렸다.** SDK 쪽은 "모든 명령은 + admission을 통과한다"를 타입으로 강제했고 — 그래서 우회하려면 생성자를 바꿔야 한다 — + 능력 어댑터 쪽은 그 계층을 아예 쓰지 않기로 했다. `CLAUDE.md`의 문장은 전자만 서술하면서 + 후자가 존재한다는 사실을 적지 않는다. + +- **실무적 함의**: C1을 고치는 것만으로는 이 항목이 해소되지 않는다. C1은 능력 어댑터를 + 조립할 뿐이고, 그 어댑터는 가드 밖 경로다. SDK 타입드 API를 살리는 것은 **독립된 결정**이며, + §5 C3 수정 방향의 (1)/(2)/(3)은 그 결정을 말한다. + +- **왜 문제인가**: + 1. `CLAUDE.md:40-44`가 "카탈로그에 없는 명령은 거부된다 / 모든 호출은 admission을 통과한다"고 + 단언한다. `redis-command-policy.yml`(1,406줄)을 편집해도 런타임 동작이 바뀌지 않는다. + 2. **Redis 7.2 미만 거부가 작동하지 않는다.** `RedisCapabilityProbe.java:211-215`의 게이트를 + 호출하는 `RedisStartupProbe`가 실행되지 않는다. + 3. **`APP_REDIS_ACKNOWLEDGED_WRITE_LOSS_ACCEPTED`가 무동작.** `env-keys.yaml:1903-1917`이 + 등록하고 `RedisCapabilityProbe.java:275-309`가 구현하지만 호출자가 없다. + Sentinel/Cluster에서 min-replicas 미설정을 막겠다는 약속이 실행되지 않는다. + +- **수정 방향**: 셋 중 하나를 고르고 문서를 맞춘다. + (1) 조립한다 — 비용이 크고, 어댑터가 쓰는 22개 메서드에 대응하는 `CommandRequest` 경로를 + 전부 만들어야 한다. (2) **분리한다** — `src/optional-platforms`의 별도 included build로. + `grpc:*` 18개가 이미 그 선례다. (3) 삭제한다. + **지금 당장 할 최소 조치는 `CLAUDE.md:36-80`과 `README.md`에서 "모든 호출이 가드를 통과한다"를 + 지우는 것이다.** 사실이 아니다. + +- **반론과 재반박**: + - *반론*: "Phase E에서 조립될 예정이다. `build.gradle:13-25`가 그렇게 적는다." + - *재반박*: 그 주석이 이미 사실과 다르다. "SDK main은 application-core를 import하지 않는다 / + semantic 어댑터는 제거되었다"고 쓰여 있는데, main에 `dev.caskeleton.application.*` import가 + 50건, `shared.*`가 7건이다. 복구는 끝났고 주석만 남았다. 계획으로 현재를 정당화할 수 없다. + - *반론*: "테스트가 SDK를 검증하므로 죽은 코드가 아니다." + - *재반박*: `RedisSdkModuleBoundaryTest.java:105`의 `NOT_YET_IMPLEMENTED_MODULES = List.of()`는 + "12개 모듈 전부 구현됨"으로 통과하지만, 검증 로직(`:109-119`)은 **패키지 디렉터리 존재 여부**만 + 본다. C1과 같은 구조의 은폐다 — 존재를 검증하고 도달을 묻지 않는다. + +### High + +#### H1. 토큰 버킷 Lua가 `PEXPIRE`에 소수를 넘긴다 — capacity가 refill-tokens의 배수가 아니면 전량 차단 + +- **근거**: + - `ratelimit/RateLimitScripts.java:123`(거부 분기), `:128`(허용 분기): + `redis.call('PEXPIRE', KEYS[1], refillPeriodMillis * (capacity / math.max(1, refillTokens)) + refillPeriodMillis)` + - Lua 5.1에 정수 타입이 없다. `/`는 double을 만들고, Redis는 Lua number를 `fpconv_dtoa`로 + 문자열화하므로 `4333.333333333333`이 그대로 인자가 된다. + - 배수 제약이 없다: `shared-contract/.../RateParameters.java:28-39`의 `TokenBucket`은 + 양수·Lua 안전 정수 범위·스케일 곱만 본다. `RedisRateLimitConfig.java:103-105`도 그대로 만든다. + - **기본값은 우연히 안전하다**: `capabilities.yml:65-66` `capacity:100`, `refill-tokens:100` + → `100/100 = 1.0` → `2000.0` → `"2000"` → 통과. +- **반증 가능한 시나리오**: `capacity=100, refill-tokens=30` → 첫 요청에서 + `PEXPIRE key 4333.333333333333` → 스크립트 오류 → + `RedisEdgeRateLimitAdapter.java:181-183`의 `catch (Exception)` → + `Unavailable(NO_MUTATION_CONFIRMED)` → fail-closed → **모든 요청 429/503.** 로그 없음(H4). + *반증 방법*: Redis 7.2에 `EVAL "redis.call('PEXPIRE', KEYS[1], 4333.33)" 1 k`가 오류를 내지 않으면 틀렸다. +- **왜 테스트가 못 잡는가**: 단위 테스트는 `TokenBucket(2, 1, 10s)`(2/1=2.0, 정수)를 쓰고 + **Lua를 실행하지 않는다**(M3). 실서버 레인은 `LiveRedisSemanticPortsTest.java:180,232,349`에서 + **`FixedWindow`만** 쓴다. **토큰 버킷과 슬라이딩 카운터 Lua는 이 저장소 어디에서도 실행된 적이 없다.** + 그리고 슬라이딩 카운터가 기본 알고리즘이다(`capabilities.yml:62`). +- **수정**: Java에서 상수를 계산해 ARGV로 넘기거나 Lua에서 `math.floor(...)`. + 실서버 레인에 세 알고리즘 × 나누어떨어지지 않는 파라미터 케이스 추가. +- **반론과 재반박**: *"기본값에서는 안 터지니 낮다."* → 기본값이 안전한 건 우연이다 + (capacity == refill-tokens). 토큰 버킷을 쓰려는 사람이 제일 먼저 바꾸는 값이 이 둘이고, + 100/10은 되고 100/30은 안 되는 식이라 **어떤 조합이 터지는지 예측 불가능하다.** + +#### H2. 세 능력의 시각이 호출자 JVM 시계다 — 인스턴스 간 시계 오차가 한도·상호배제 오차가 된다 + +- **근거**: + - `ratelimit/RateLimitScripts.java:25-28` 주석 "Time comes from the caller, not from the + server's `TIME`" → `:153` `long nowMillis = now.toEpochMilli();` + - `ratelimit/RedisEdgeRateLimitAdapter.java:147,165` + - `idempotency/RedisIdempotencyStoreAdapter.java:107,120` + - `idempotency/IdempotencyScripts.java:76` — + `if state == 'FAILED_RETRYABLE' or (leaseUntil ~= nil and leaseUntil <= nowMillis)` then take over + - `Clock`은 앱 전역 빈이다: `RedisRateLimitConfig.java:49`, `RedisIdempotencyConfig.java:41` +- **왜 문제인가**: + 1. rate-limit: `windowStart = now - (now % windowMillis)`. 기본 윈도우 1초(`capabilities.yml:64`)라 + 시계가 50ms만 달라도 경계 근처에서 파드마다 다른 해시 필드를 쓴다. 그 구간 실효 한도는 최대 N×limit. + 2. idempotency: 시계가 앞선 인스턴스가 살아 있는 처리 리스를 만료로 보고 `TAKEN_OVER` → + **같은 결제가 두 번 실행된다.** `processing-lease: 30s`라도 시계가 31초 앞서면 즉시 만료로 보인다. + NTP 요구나 최대 허용 스큐 검증이 없다. + - 주석의 근거("TIME은 비결정적")는 **Redis 5 이전 기준**이다. Redis 5부터 effects replication이 + 기본이고 `redis.call('TIME')`이 허용된다. 이 저장소의 최소 지원은 7.2다. +- **수정**: Lua 첫 줄에서 `local t = redis.call('TIME')`. 호출자 시계는 `callerDeadline` 비교 + (`RedisEdgeRateLimitAdapter.java:148`)에만 남긴다. +- **반론과 재반박**: *"호출자 deadline과 같은 시계로 재야 한다."* → 두 시각의 용도가 다르다. + deadline은 로컬 질문, 윈도우 경계·리스 만료는 분산 질문이다. **같은 저장소의 lease 어댑터가 + 이미 이 구분을 옳게 한다** — `RedisDistributedLeaseAdapter.java:37-41`은 유효성을 로컬 + monotonic으로 재고 서버 TTL은 진단용으로만 쓴다고 명시한다. 옳은 선례가 있는데 두 능력이 반대로 갔다. + +#### H3. `maximum-clock-regression`과 `cleanup-grace`가 설정만 있고 구현이 없다 + +- **근거**: `capabilities.yml:69-70`이 선언 → `RedisRateLimitConfig.java:129-130`이 + `RateLimitPolicy`에 담음 → **leaf 전체에서 `maximumClockRegression`/`cleanupGrace` 참조 0건.** + `RateLimitScripts.evaluate`(`:148-185`)가 넘기는 인자는 limit/window/cost/nowMillis뿐이다. + 유일한 clamp는 토큰 버킷 `:110-114`인데 **무한 clamp**다(250ms로 제한하지 않는다). + fixed-window와 sliding-counter에는 clamp조차 없다. +- **왜 문제인가**: 운영자가 "250ms 넘는 역행은 방어된다"고 읽는다. 실제로는 1시간 역행도 + 통과하고, fixed-window에서 이전 윈도우 버킷이 되살아나 소진된 예산이 재사용된다. + **존재하는 안전장치보다 존재하지 않는 안전장치가 더 위험하다.** +- **수정**: H2를 고쳐 서버 `TIME`을 쓰면 개념 자체가 사라지므로 두 설정을 삭제한다. +- **반론과 재반박**: *"`shared-contract` 계약이라 provider 여지를 남긴 것."* → 계약에 두는 건 옳다. + 문제는 **유일한 provider가 무시하는데 `env-keys.yaml`이 키를 노출한다는 것**이다. + 등록된 env 키는 "이 배포가 조정할 수 있다"는 약속이고, 조정해도 아무 일이 없으면 약속 위반이다. + +#### H4. 네 어댑터 전부 로거가 없다 — fail-open/fail-closed 전환이 완전히 조용하다 + +- **근거**: `cache/`, `idempotency/`, `lease/`, `ratelimit/`, `realtime/` 다섯 패키지에 + `org.slf4j` import **0건**. + `RedisCacheRegionAdapter.java:138-141,257-259,285-287,308-310`, + `RedisEdgeRateLimitAdapter.java:181-183`, + `RedisIdempotencyStoreAdapter.java:129-131,246-250,301-303,332-334,357-359,473-475`, + `RedisDistributedLeaseAdapter.java:161-166,218-220,333-338,363-366` — 전부 + `catch (Exception failure) { return …; }`로 `failure`를 쓰지 않는다. + 대조: `RedisRuntimeOwner.java:40`, `RedisSdkAutoConfiguration.java:61`에는 로거가 있다. + **죽은 코드 쪽에 관측이 있고 살아 있는 쪽에 없다.** +- **구체적 실패**: ACL이 `evalsha`를 막는 배포(H6)에서 rate limiter가 100% 거부한다. + 운영자가 보는 건 "모든 요청 429"뿐이다. 헬스는 `UP`이다 — + `RedisHealthContributor.java:243`은 `PING`만 하고 `PING`은 모든 ACL이 허용한다. + cache 쪽은 더 나쁘다: 100% 미스여도 기능은 동작하므로 몇 주간 모를 수 있다. +- **수정**: `catch`에서 rate-limited warn. `NoThrowObservationSink.java:44-56`이 정확히 그 패턴을 + 이미 구현해 뒀다(첫 1회 warn, 이후 debug + 카운터) — 죽은 코드에서 살아 있는 코드로 옮기면 된다. +- **반론과 재반박**: *"예외 메시지에 키가 들어갈 수 있어 일부러 삼켰다."* → + `LettuceExceptionTranslator.java:38-40`(오류 코드로 축약)과 + `RedisHealthContributor.java:249-251`(클래스명만) 두 해법이 저장소 안에 있다. + 둘 다 쓰지 않았으므로 의도적 선택이 아니라 누락으로 보인다. + +#### H5. `ONLY_IF_OBSERVED` 조건부 캐시 쓰기가 원자적이지 않다 (GET → SET) + +- **근거**: `cache/RedisCacheRegionAdapter.java:217-229`가 GET으로 토큰을 비교한 뒤 + `:242-250`에서 조건 없이 SET한다. `presenceOf`(`:262-267`)는 `ONLY_IF_ABSENT`가 아니면 + `WritePresence.ALWAYS`를 반환하므로 2번째 라운드트립에 조건이 전혀 없다. + `:188-190` 주석이 보장을 주장하고, `README.md:277-279`는 이 동작이 **Lua 안에서** 일어난다고 + 적는다. 그 Lua는 존재하지 않는다. +- **반증 가능**: A가 GET(토큰 일치) → B가 SET(신규) → A가 SET(구 값) → **A의 오래된 값이 남는다.** + 이 race를 막으려고 존재하는 기능이 정확히 그 race에 취약하다. +- **수정**: 짧은 Lua 하나. + `if redis.call('GET', KEYS[1]) == ARGV[1] then redis.call('SET', …); return 1 else return 0 end`. + 세 능력이 이미 같은 방식을 쓰므로 패턴은 있다. +- **반론과 재반박**: *"캐시니까 TTL 안에 자동 복구된다."* → hard TTL 기본이 5분 + (`capabilities.yml:22`)이라 5분간 잘못된 값을 서빙한다. 그리고 이 기능은 "덮어쓰기 방지"라는 + 이름을 달고 있다 — 없으면 호출자가 대비하지만, 있다고 선언하면 대비하지 않는다. + 약한 보장보다 **잘못 선언된 보장**이 나쁘다. + +#### H6. 리전 무효화가 다른 인스턴스에 전파되지 않는다 + +- **근거**: `cache/RedisCacheRegionAdapter.java:322-325`가 `if (keys.resolved()) return;`으로 + generation을 **프로세스당 한 번만** 읽는다. `:412-417`의 `observeGeneration`이 + `resolved = true`로 고정하고 되돌리는 코드가 없다. `:296-304`의 `invalidateRegion()`은 + 서버 카운터를 올리고 **자기 프로세스만** 갱신한다. 읽기 판정은 `:165-170`. +- **반증 가능**: A·B가 generation=1. A가 `invalidateRegion()` → 서버 2, A 로컬 2. + B는 자기가 쓴 generation=1 엔트리를 `1 == 1`로 **HIT** 한다 — 무효화 무시. + 그 뒤 A는 `1 != 2`로 미스 → 2로 재기록, B는 `2 != 1`로 미스 → 1로 재기록. + **두 인스턴스가 서로의 엔트리를 무한히 무효화하며 적중률이 0에 수렴한다.** +- **왜 테스트가 못 잡는가**: `cache/RedisCacheRegionAdapterTest.java:166-182`가 + 어댑터 인스턴스 하나로만 검증한다. +- **수정**: 주기적 재확인(예: `positive-soft-ttl`마다 `INCRBY generationKey 0`). + 구 README(`:316-319`)가 "periodic generation recheck"를 언급하는데 그 코드가 사라졌다. +- **반론과 재반박**: *"매 읽기마다 읽으면 라운드트립 2배."* → 그래서 **주기적** 재확인이지 + 매번이 아니다. 지금은 주기가 무한대다. keyspace 스캔을 피한 판단 자체는 옳다(§6 K7) — + 문제는 그 대체 수단이 단일 프로세스에서만 동작한다는 점이고, **다중 인스턴스가 아니면 + 쓸 일 없는 API가 다중 인스턴스에서만 깨진다.** + +#### H7. 단일 Redis 계정 + 저장소가 제공하는 ACL 픽스처 = 세 능력 전량 차단 (기동은 성공) + +- **근거**: + - `RedisConnectionKind.java:50-55` — `SCRIPT -> RedisCredentialRole.ADVANCED` + - `RedisTopologyClientFactory.java:507-512` — 미설정 롤은 application 클라이언트로 폴백 + - `infra/redis-sdk/acl/application.acl` — `ca-skeleton-application`에 **`+evalsha` 없음**. + `application-advanced.acl`에만 `+evalsha +evalsha_ro +script|load` + - `RedisSdkSettings.java:423-430` — advanced reference 부재는 `warnings.add(...)`, 실패 아님 + - 세 능력 전부 `SCRIPT` 레인 +- **왜 문제인가**: 기동 성공 → health `UP`(PING만) → 첫 요청에서 NOPERM → + rate-limit 전량 거부, idempotency/lease 전량 `INDETERMINATE`. 로그 없음(H4). + 이걸 잡을 수 있는 `LettuceRedisAdminOperations.aclDryRun`과 `RedisStartupProbe`는 조립되지 않는다(C3). + **진단 도구를 만들어 놓고 연결하지 않았다.** +- **수정**: 정합성 롤 선택 시 기동에서 대표 프로그램 1회 `EVALSHA` 프로브. NOPERM이면 기동 실패. + `README.md:63-80`이 그 설계를 이미 적어 뒀다 — 코드만 없다. +- **반론과 재반박**: *"경고 문구가 정확하고(`RedisSdkSettings.java:427-429`), + `LiveRedisSemanticPortsTest.java:223`이 이 실패를 테스트한다."* → 둘 다 맞아서 Critical이 아니다. + 그러나 (a) 경고는 기동 로그에 묻히고, (b) 테스트는 opt-in 레인이라 `check`/`ci`에서 안 돌며, + (c) 저장소가 **자기 ACL 픽스처로 단일 계정을 불가능하게 만들고** 그 조합을 + "legitimate deployment"라 부른다. 셋이 겹치면 fork한 사람은 반드시 한 번 걸린다. + +#### H8. `SCRIPT` 레인 동시 64개 상한 — Redis가 정상인데 rate limiter가 거부하기 시작한다 + +- **근거**: `RedisSdkAutoConfiguration.java:276,279`가 `REGULAR`/`SCRIPT` 상한을 + `capacity.maximumInFlightCommands`(기본 64)로 둔다. + `RedisRuntimeOwner.java:134-139`는 상한 도달 시 대기 없이 `RedisCommandRejectedException`. + `RedisEdgeRateLimitAdapter.java:172-180`이 이를 `UNAVAILABLE_BEFORE_SEND`로 번역하고 + 웹 필터가 fail-closed로 거부한다. 세 능력이 `SCRIPT` 레인 **하나를** 공유한다. +- **반증 가능**: Tomcat 스레드 200, `command-timeout` 200ms. Redis 응답이 150ms로 느려지면 + 동시 in-flight가 65를 넘고, **Redis는 여전히 응답하는데 초과 요청이 전부 429가 된다.** + 느려짐이 전면 차단으로 증폭된다. +- **수정**: Lettuce `StatefulRedisConnection`은 스레드 안전·멀티플렉싱이므로 레인당 1개면 충분하다. + 지금은 `openLane`이 borrow마다 `client.connect()`를 호출해(`RedisTopologyClientFactory.java:389`) + 최대 64 TCP를 연다. 레인 상한을 "커넥션 수"로 재정의하고 동시성 제한은 드라이버 + `requestQueueSize`(`:307`, 이미 같은 값)에 맡긴다. +- **반론과 재반박**: *"무제한 대기보다 빠른 거부가 낫다."* → 원칙은 맞고 + `RedisRuntimeOwner.java:136-137` 주석의 논지도 맞다. 문제는 **상한의 단위**다. + 64는 커넥션 수로는 과하고 동시 명령 수로는 부족하다. 멀티플렉싱 드라이버 위에서 + "커넥션 하나 = 명령 하나"로 모델링해 두 값이 강제로 같아졌다. Cluster에서는 더 나쁘다 — + `RedisClusterClient.connect()` 하나가 노드 수만큼 소켓을 연다. + +#### H9. `README.md`가 존재하지 않는 세대의 코드를 현재형으로 서술한다 + +- **근거** (전부 저장소 전체 grep으로 부재 확인): + + | README 서술 | 위치 | 실제 | + |---|---|---| + | `RedisKeyBuilder`가 `ca:::…`를 만든다 | `:207-215` | 클래스 없음. 실제는 `CapabilityKeyspace.java:48` | + | `RedisStringCacheRegion` bean | `:262` | 없음 | + | `CacheStoreRouter`/`RedisCacheStore`/`FailOpenCacheStore` | `:355-360` | 없음 | + | `RedisVersionedSessionRepository` + 세션 Lua 6개 | `:132-157` | 없음. 세션 능력 자체가 없다 | + | `RedisAtomicPrimitives`, `RedisLuaProgramExecutor` | `:219-241` | 없음 | + | `redis/*-program-set.json` manifest | `:219-224` | **파일 0개** | + | `LettuceRedisRuntime`, `app.cache.redis.client-mode=external` | `:45-46,256-259` | 없음. 트리는 `app.redis.*` 하나 | + | L1 로컬 캐시 | `:307-323` | 없음 | + | `RedisCredentialMaterialProvider` | `:249-250` | 없음 | + | "Envelope v2가 digest로 보호된다" | `:274-277` | `CacheEnvelope.java:104-123`은 파이프 구분 평문 v1 | + | readiness 표: semantic port·topology client "구현 없음" | `:26-27` | 둘 다 존재한다 | + | "세 프로그램은 Redis `TIME`을 읽고 clock-regression clamp" | `:122-124` | H2·H3. 정반대 | + +- **왜 문제인가**: 도입 검토자가 README로 세운 계획이 전부 틀어진다. 세션 저장소를 고르면 + 기동 실패하고, L1을 전제로 용량을 산정하면 Redis 부하가 몇 배가 된다. + **코드가 사실이고 문서가 결함이다.** +- **수정**: README를 삭제하고 필요한 내용만 `CLAUDE.md`(149줄, 코드와 거의 일치)로 합친다. +- **반론과 재반박**: *"설계 결정 기록으로 가치가 있다."* → `README.md:36-37`이 "그 코드는 현재 + 이 leaf에 없다"고 한 번 밝히긴 한다. 그러나 그 뒤 300줄이 현재형이고, 같은 문서의 + readiness 표(`:23-28`)는 **있는 것을 없다고** 적어 방향이 반대다. 독자가 어느 문장이 현재인지 + 구분할 수 없다. 기록이 필요하면 `docs/reviews/`로 옮기고 날짜를 붙여야 한다. + +### Medium + +#### M1. `RedisCapabilitySettings`가 모든 배포에서 바인딩된다 — 게이트를 우회한다 *(severity 재판정: Medium 유지)* + +- **근거**: `RedisCapabilitySettings.java:24` 클래스 레벨 + `@ConfigurationProperties(prefix="ca-skeleton.capabilities")` + + `CaSkeletonApplication.java:65`가 `dev.caskeleton.bootstrap.autoconfigure.redis`를 + `@ConfigurationPropertiesScan` basePackages에 포함. +- `CaSkeletonApplication.java:27-30`의 주석이 정확히 이걸 금지한다: + "Adding a package back here would restore the binding and silently undo the gate." +- 방어 테스트가 절반만 막는다: `RedisOptionalityContractTest.java:32`의 + `REDIS_SETTINGS_TYPES = List.of(RedisSdkSettings.class)` — `RedisCapabilitySettings`가 없다. +- **반증 가능**: Redis를 안 쓰는 배포에 + `ca-skeleton.capabilities.cache.command-timeout=notaduration`을 넣으면 **기동이 깨진다.** + `app.redis.*`에 대한 면역(`RedisSdkAutoConfigurationTest.disabledIgnoresMalformedRedisConfiguration`)은 + `ca-skeleton.capabilities.*`에는 없다. +- **수정**: 클래스 레벨 애노테이션을 떼고 `RedisSdkSettings`처럼 + `@Bean @ConfigurationProperties`로 조건부 등록. 그리고 `REDIS_SETTINGS_TYPES`에 추가. + (C1 해결 시 `bootstrap.autoconfigure.redis` 패키지를 스캔 목록에서 빼는 것으로도 해결된다.) + +- **severity 재판정 — Medium을 유지한다.** 다른 영역에서 httpclient의 거울상 결함이 확인됐다: + 조립을 leaf로 옮겼는데 목적지 `adapter.outbound.httpclient.autoconfigure`가 제외 정규식에 + 없어서 자식 `@Configuration` 9개가 스위치와 무관하게 스캔된다. **둘은 같은 계열이다** — + "게이팅 대상과 스캔 제외 목록이 따로 관리되어 어긋난다". 그러나 심각도는 다르다. + - httpclient 쪽은 **빈이 조립된다** — 스위치가 꺼진 배포에서 커넥션 풀·TLS 컨텍스트가 생길 수 있다. + - Redis 쪽은 **설정 객체 하나가 바인딩될 뿐이다.** `RedisCapabilitySettings`는 POJO이고, + `validate()`는 조건부 빈 안에서만 호출된다(`RedisCacheConfig.java:44`). 스레드·커넥션· + 시크릿 조회가 0인 것은 §3.3에서 확인한 대로다. + - 실제 피해는 하나뿐이다: **Redis를 안 쓰는 배포가 잘못된 `ca-skeleton.capabilities.*` 값 + 하나로 기동에 실패할 수 있다.** 이건 "꺼도 안 꺼지는 토글"의 약한 형태이지 커넥션이 생기는 + 형태가 아니므로 Critical/High가 아니다. + - 다만 **계열이 같다는 사실 자체가 교차 권고를 만든다**: 게이팅 대상 패키지 목록과 + `@ConfigurationPropertiesScan` basePackages, `AUTO_CONFIGURED_PACKAGES` 정규식 셋을 + 한곳에서 파생시키거나, 최소한 "게이트된 설정 클래스는 클래스 레벨 + `@ConfigurationProperties`를 갖지 않는다"를 저장소 전역 아키텍처 테스트로 만들어야 한다. + 지금은 `RedisOptionalityContractTest.java:32`가 **한 클래스만** 손으로 나열해 막고 있다. + +#### M2. `build.gradle`의 의존 주석이 사실과 반대다 + +- **근거**: `build.gradle:13-25`가 "SDK main은 이들에서 아무것도 import하지 않는다 / + semantic 어댑터는 제거되었고 Phase E가 복구한다"고 적는데, main에 + `dev.caskeleton.application.*` 50건, `shared.*` 7건이다 + (`cache/RedisCacheRegionAdapter.java:8-16` 등). 주석이 말하는 "제거된 어댑터"가 그 파일들이다. +- **왜 문제인가**: 주석을 믿고 `implementation project(':application-core')`를 지우면 컴파일이 깨진다. +- **수정**: 3문단을 한 줄로. `adapter:outbound:support` 참조 0건이라는 부분은 맞다(grep 확인). + +#### M3. 단위 테스트가 Lua를 실행하지 않고, fake가 Lua 소스를 substring으로 골라 Java로 재구현한다 + +- **근거**: `src/test/.../InMemoryRedisCommandGateway.java:1440-1500` + ```java + if (source.contains("'tokens'")) return done(tokenBucket(...)); + if (source.contains("previous * weight")) return done(slidingCounter(...)); + if (source.contains("local windowStart = nowMillis - (nowMillis % windowMillis)")) … + if (source.contains("'ACQUIRED'")) return done(idempotencyClaim(...)); + ``` + 이 파일은 **2,456줄**로 실제 게이트웨이 구현(1,282줄)보다 크다. +- **왜 문제인가**: (a) Lua 문법·타입·인자 규칙 위반을 못 잡는다(H1이 그 예다). + (b) "Lua와 Java 재구현이 같은 답인가"가 아니라 "Java 재구현이 기대값을 내는가"만 검증한다 — + 둘이 같이 틀리면 초록이다. (c) Lua를 리팩터링해 `'tokens'` 같은 조각이 사라지면 + fixture가 조용히 다른 프로그램으로 라우팅한다. +- **수정**: `redisTopologyTest` standalone 레인에 세 알고리즘 × 경계 케이스 추가. 그 레인은 + 이미 PR에서 돈다(§6 K3)이라 비용이 거의 없다. +- **반론과 재반박**: *"Docker 없이 빠른 테스트가 가치 있다."* → 맞고 지켜야 한다(K2). + 문제는 **Lua를 커버한다고 믿게 만드는 것**이다. `@DisplayName("a token bucket refills by + elapsed periods")`는 알고리즘 검증으로 읽히지만 대상은 `InMemoryRedisCommandGateway.tokenBucket()`이다. + +#### M4. Fixed-window 해시가 무한히 커진다 + +- **근거**: `ratelimit/RateLimitScripts.java:55-56`이 윈도우마다 새 필드를 `HSET`하고 + 허용될 때마다 `PEXPIRE`로 TTL을 갱신하는데 **`HDEL`이 없다.** + 대조: sliding-counter는 `:84`에 `HDEL`이 있다. + `:39-41` 주석("The expiry is set from the window rather than refreshed per hit, so a subject + cannot hold a counter alive indefinitely")이 **틀렸다** — `PEXPIRE`는 매 허용마다 갱신된다. +- **왜 문제인가**: 기본 윈도우 1초(`capabilities.yml:64`)에서 1초에 한 번 이상 요청하는 subject가 + 있으면 하루 86,400 필드. `hash-max-listpack-entries`(기본 128)를 넘으면 hashtable로 승격되고 + 메모리·`HGET` 비용이 오른다. 활동이 이어지는 한 키가 만료되지 않는다. +- **수정**: HSET 뒤에 `redis.call('HDEL', KEYS[1], tostring(windowStart - (windowMillis * 2)))` 한 줄. + +#### M5. idempotency·lease의 `key-hmac-secret-reference`가 아무도 읽지 않는다 + +- **근거**: `capabilities.yml:31,43`에 선언. 그러나 + `RedisIdempotencyConfig.java:37-56`와 `RedisLeaseConfig.java:28-44`는 `RedisKeys.KeyDigest`를 + 호출하지 않고 `…Keys(namespace, keyVersion)`만 만든다. + cache만 `RedisCacheConfig.java:45-46`에서 digest를 만든다. + 두 어댑터는 호출자가 이미 만든 digest를 받는다(`RedisIdempotencyStoreAdapter.java:526`, + `RedisDistributedLeaseAdapter.java:144`). +- **왜 문제인가**: 브리프의 전제("네 능력 모두 `key-hmac-secret-reference`를 갖는다")가 여기서 + 나왔다. 실제로는 **세 가지 모양**이다 — cache만 HMAC 수행, rate-limit은 reference 자체가 없고 + (`capabilities.yml:51-70`에 `key-version`만), idempotency/lease는 reference만 있고 미사용. + 설정 파일 배치가 "넷이 같다"로 읽히게 만든다. +- **수정**: 두 줄을 삭제하거나 두 어댑터도 digest를 적용한다. 지금은 운영자가 시크릿을 + 로테이션하고 "키 공간이 바뀌었겠지"라고 잘못 추론한다. + +#### M6. `key-version` 회전에 구버전 병존 읽기가 없다 — idempotency에서는 중복 실행 창이 열린다 + +- **근거**: `CapabilityKeyspace.java:48`이 `v{keyVersion}`을 접두사에 넣고, + digest 접두사는 `RedisKeys.java:96`의 하드코딩 `"hv1:"`이며 `key-version`과 연동되지 않는다. + 어느 어댑터에도 "v{n-1}도 조회" 분기가 없다. HMAC 시크릿을 버전 없이 교체해도 같다 + (`RedisKeys.java:55-70`이 material을 키로 쓴다). +- **왜 문제인가**: cache는 콜드 스타트로 끝나지만 **idempotency는 심각하다.** + 배포 중 `key-version` 1→2면 배포 전 레코드를 찾지 못해 클라이언트 재시도가 + `ACQUIRED`를 받고 **같은 부작용이 두 번 실행된다.** replay TTL 24시간(`capabilities.yml:35`)이라 + 창이 24시간이다. +- **수정**: idempotency만이라도 현재 버전 miss 시 직전 버전을 한 번 더 조회(읽기 전용). + 아니면 `key-version` 변경을 기동에서 거부하고 마이그레이션 절차를 문서화한다. + +#### M7. `inspect`로 복구한 lease 핸들만 drift budget이 빠져 있다 + +- **근거**: `lease/RedisDistributedLeaseAdapter.java:229`(acquire)와 `:321`(renew)는 + `localValidityOf(...)`를 쓰는데 `:206`(inspect)은 서버 PTTL을 그대로 쓴다. + 클래스 javadoc `:37-41`은 "Validity is measured locally … never from the server's TTL"라고 단언한다. +- **왜 문제인가**: 응답 유실 후 `inspect`로 소유권을 복구하는 것이 이 port의 공식 복구 절차인데 + (`:162-166`), **그 경로에서만** 드리프트 여유가 사라져 서버가 이미 만료시킨 리스를 + 유효하다고 믿는 구간이 `driftBudget`(기본 10ms)만큼 생긴다. EFFICIENCY_ONLY라 치명적이진 + 않지만 **같은 타입을 반환하는 두 경로가 일관되지 않는다는 점**이 문제다. +- **수정**: `:206`을 `localValidityOf(...)`로. 남은 TTL이 budget보다 짧으면 예외가 나므로 + 그 경우를 `Absent`/`NotOwner`로 닫는 분기가 추가로 필요하다. + +#### M8. 세 능력의 NOSCRIPT 복구가 문자열 매칭이다 — C3를 고치는 순간 조용히 깨진다 + +- **근거**: `ratelimit/RateLimitScripts.java:240-241`, `lease/LeaseScripts.java:160-161`, + `idempotency/IdempotencyScripts.java:262-263`이 + `message.strip().toUpperCase(Locale.ROOT).startsWith("NOSCRIPT")`를 쓴다. + 올바른 선례 둘: `sdk/programmability/LettuceRedisScriptOperations`의 `scriptMissing`은 + 타입드 예외를 먼저 보고, `sdk/lettuce/operations/AtomicCounterScripts`의 `scriptMissing`은 + Lettuce 타입과 SDK 타입 **둘 다** 본 뒤 문자열로 폴백한다. + 깨지는 이유: `sdk/lettuce/command/LettuceExceptionTranslator.java:92-97`이 + 메시지를 `"registered script is absent from the server cache"`로 **바꾼다.** +- **왜 문제인가**: 지금은 번역기가 경로에 없어 **우연히** 동작한다. C3를 고쳐 실행자를 조립하면 + Redis 재시작/`SCRIPT FLUSH` 이후 세 능력이 스크립트를 다시 로드하지 못한다 → + rate-limit 전량 거부, idempotency/lease 전량 `INDETERMINATE`. +- **수정**: 세 곳을 `AtomicCounterScripts`의 구현으로 통일. 지금 해도 손해가 없고 지뢰를 미리 제거한다. + +#### M9. 계정마다 `ClientResources`를 새로 만든다 — 계정 수만큼 이벤트 루프가 늘어난다 + +- **근거**: `RedisTopologyClientFactory.java:284-288`의 `resources()`가 + `:171,201,208`에서 각각 호출되고 `clientFor`는 롤마다 불린다(`:129-136`). +- **왜 문제인가**: application + advanced + pubsub 세 계정이면 `DefaultClientResources` 3개, + 각각 `max(2, cores)` IO 스레드 + computation 풀 + 타이머. 8코어 파드에서 24 IO 스레드. + 클래스 주석(`:52-54`)은 단일 계정 비용만 말하고 다중 계정 비용을 말하지 않는다. +- **수정**: `create()`에서 한 번 만들어 공유하고 마지막 클라이언트가 닫힐 때 한 번만 `shutdown()`. + `:275-283` 주석이 이미 그 함정을 정확히 이해하고 있다. + +#### M10. `CacheEnvelope`에 무결성 digest가 없다 (문서는 있다고 한다) + +- **근거**: `cache/CacheEnvelope.java:104-123`의 `encode()`는 + `schemaVersion|sourceRevision|generation|softMs|hardMs|absence|payload` 평문. digest 필드 없음. + `README.md:274-277`은 "digest로 보호" "integrity digest를 version byte보다 먼저 검사"라고 적는다. +- **왜 문제인가**: 같은 Redis를 쓰는 다른 애플리케이션이나 운영자가 덮어써도 감지 못 한다. + 다만 (a) 관측 토큰이 SHA-256 content digest라 "내가 읽은 것과 같은가"는 확인되고, + (b) 키가 HMAC이라 외부에서 맞추기 어렵다. 그래서 Medium이다. +- **수정**: 문서를 코드에 맞춘다(H9의 일부). + +#### M11. `NOT_YET_IMPLEMENTED_MODULES = List.of()` — "전부 구현됨"으로 통과하는 테스트 + +- **근거**: `src/test/.../sdk/RedisSdkModuleBoundaryTest.java:105`, 검증 로직 `:109-119`가 + **패키지 디렉터리 존재 여부**만 본다. +- **왜 문제인가**: 초록이면 "12개 설계 모듈 전부 구현됨"으로 읽힌다. C1/C3와 같은 은폐 구조다 — + 존재를 검증하고 도달을 묻지 않는다. +- **수정**: "각 모듈의 진입점이 컴포지션 루트에서 도달 가능한가"를 묻는 테스트를 추가하거나, + DisplayName에서 "implemented"를 뺀다. + +#### M13. Pub/Sub 구독의 "첫 채널 코덱을 전부에 적용" 버그가 6개 중 3개에 남아 있다 + +- **현상**: 여러 채널을 한 번에 구독할 때 첫 채널의 코덱으로 모든 메시지를 디코드한다. + 같은 저장소가 이 버그를 한 곳에서만 고쳤다. + +- **근거** — 6개 구독 구현의 상태: + + | 구현 | 코덱 선택 | 판정 | + |---|---|---| + | `LettuceRedisPubSubOperations.subscribe` | 채널→코덱 `HashMap`, 미등록 채널은 예외 | **고쳐짐** | + | `LettuceRedisPubSubOperations.patternSubscribe` | 코덱이 섞이면 `IllegalArgumentException`으로 거부 | **고쳐짐**(거부가 옳다) | + | `LettuceRedisShardedPubSubOperations.subscribe` | `first.messageCodec()` 전부에 적용 | **남아 있음** | + | `LettuceReactiveRedisPubSubOperations.subscribe` | `first.messageCodec()` | **남아 있음** | + | `LettuceReactiveRedisPubSubOperations.patternSubscribe` | `first.messageCodec()`, 거부 없음 | **남아 있음** | + | `LettuceReactiveRedisShardedPubSubOperations.subscribe` | `first.messageCodec()` | **남아 있음** | + + 고친 쪽이 자기 주석에 결함을 정확히 기록해 뒀다(`LettuceRedisPubSubOperations.subscribe` 내부): + > *"One codec per channel, not the first channel's codec for all of them. A subscription that + > mixes channels used to decode every message with whichever codec happened to be first, so the + > payloads of the other channels were reinterpreted under the wrong schema — silently, when the + > framings happened to be compatible."* + +- **왜 문제인가**: 주석이 말하는 "framings happened to be compatible" 조건이 성립하면 + **잘못된 스키마로 디코드된 객체가 아무 오류 없이 애플리케이션에 전달된다.** 동기 API로 + 두 채널을 구독하면 안전하고, 같은 코드를 반응형으로 옮기면 조용히 깨진다. 같은 SDK 안에서 + API 표면에 따라 정확성이 달라지는 것은 그 자체로 결함이다. + +- **수정**: 동기 구현의 `Map>` 패턴을 나머지 셋에 복사한다. + 패턴 구독은 `patternSubscribe`처럼 코덱 불일치를 거부하는 쪽이 맞다 — 매치된 메시지는 + 패턴이 아니라 구체 채널명을 들고 오므로 어느 코덱인지 알 방법이 없기 때문이고, + 동기 구현이 이미 그 논증을 적어 뒀다. + +- **반론과 재반박**: *"도달 불가 코드라 무해하다."* → 맞다. 그래서 High가 아니라 Medium이다. + 다만 C3를 "조립한다"로 풀면 즉시 살아나고, **고친 쪽과 안 고친 쪽이 한 디렉터리에 있어서 + 다음 사람이 어느 쪽을 복사할지 알 수 없다.** + +#### M12. `capabilities.yml`의 idempotency provider 값이 실제와 다르다 + +- **근거**: `capabilities.yml:28` 주석이 `disabled | jdbc | redis`. + 그러나 도달 가능한 유일한 구현은 + `PostgreSqlIdempotencyStoreConfig.java:12-14`의 `havingValue = "postgresql"`이다. + `jdbc`라는 값을 받는 코드가 저장소에 없다. +- **왜 문제인가**: 문서의 세 값 중 동작하는 것이 하나도 없다. `redis`는 C1으로 조립 불가, + `jdbc`는 애초에 어떤 조건에도 매치하지 않는다. +- **수정**: 주석을 `disabled | postgresql | redis`로 고치고, C1 해결 후 `redis`가 실제로 동작하는지 + 확인한다. + +### Low + +#### L1. 같은 바이트열에 SHA-256을 두 번 계산 +`cache/RedisCacheRegionAdapter.java:187`과 `:190`이 `observationOf(stored)`를 각각 호출한다. +hit 경로마다 2회. 지역 변수 하나로 끝난다. + +#### L2. `AuthoritativeAbsence.valueOf`가 unavailable로 분류된다 +`cache/RedisCacheRegionAdapter.java:177`. 저장된 문자열이 enum 상수가 아니면 +`IllegalArgumentException`이 `:138`의 `catch (Exception)`에 잡혀 `Unavailable`이 된다. +의미상 `IncompatibleSchema(CORRUPT_ENVELOPE)`가 맞다. + +#### L3. `decodeAll`의 인덱스 클램프가 오류를 숨긴다 +`sdk/lettuce/operations/ValueOperationRequests.java`의 `decodeAll` — +`keys.get(Math.min(index, keys.size() - 1))`. MGET 응답 길이가 키 개수와 다르면 마지막 키의 +코덱으로 조용히 디코드한다. 길이 불일치는 예외가 맞다. + +#### L4. `SearchQuery.expression`이 무검증으로 FT.SEARCH에 들어간다 +`sdk/extensions/search/LettuceRedisSearchOperations`의 `query(...)`. 인덱스 이름은 +네임스페이스로 묶지만 질의식은 호출자 문자열 그대로다. 도달 불가 코드라 Low. + +#### L5. `slowLog`의 마이크로초 변환이 읽기 어렵다 +`sdk/admin/LettuceRedisAdminOperations`의 `Duration.ofNanos(Duration.ofMillis(v).toNanos() / 1_000L)`. +결과는 `v` 마이크로초로 **맞다**(Redis SLOWLOG는 마이크로초). `Duration.of(v, ChronoUnit.MICROS)`가 낫다. + +--- + +## 6. 바꾸지 말 것 (Keep) + +### K1. off 방향 토글 계약과 "호출 횟수"로 검증하는 optionality 테스트 + +- **무엇**: `APP_REDIS_ENABLED`만이 활성화 권한을 갖고, 능력 선택자는 "무엇을 얹을까"만 정한다. + 모순 조합은 기동 실패. 그리고 "off면 빈이 없다"가 아니라 **"off면 시크릿 소스를 호출조차 하지 + 않는다"**를 카운터로 검증한다. +- **왜 지금 이게 맞는가**: + - `RedisSdkSettings.java:17-22`가 클래스 레벨 `@ConfigurationProperties`를 붙이지 않은 판단이 + 핵심이다. 붙였다면 앱 전역 스캔이 Redis를 안 쓰는 배포에서도 바인딩한다. + (그 판단이 `RedisCapabilitySettings`에는 적용되지 않은 것이 M1이다. 판단 자체는 옳다.) + - `RedisSdkAutoConfigurationTest.java:92-128`의 `secretLookups.hasValue(0)`은 + "빈이 없다"보다 강하다. 시크릿 매니저는 조회를 감사·과금하므로 실제로 의미가 있다. + - `RedisCorrectnessRoles.java:15-22`가 남긴 사고 기록 — readiness 그룹과 빈 조건이 갈라져 + **모든 Redis-off 배포가 기동 실패했다** — 은 이 설계가 경험에서 나왔음을 보여준다. + 상수 하나, 읽는 곳 둘이라는 해법이 옳다. + - `RedisActivationValidator.java:48-54`가 위반 롤을 **전부 모아** 한 번에 보고하는 것도 맞다. +- **언제 재검토**: C1을 고쳐 조립이 살아나면, 이 검증기에 "선택자가 redis인데 port 빈이 없다"를 + 추가해야 한다. 지금 형태로는 그 케이스를 못 본다. + +### K2. 결정론적 in-memory 게이트웨이로 `./gradlew test`가 Docker 없이 돈다 + +- **왜 지금 이게 맞는가**: 이건 스켈레톤이다. fork한 사람이 처음 실행하는 명령이 Docker를 + 요구하면, Redis를 쓰지 않더라도 Docker를 설치해야 한다. `check`는 leaf 하나만 검증한다는 + 이 저장소 원칙과도 맞다. 실서버 검증은 별도 레인(K3)에 있다. +- **언제 재검토**: M3를 고쳐 Lua 커버리지가 토폴로지 레인으로 옮겨간 뒤에는, fake의 + Lua 에뮬레이션 부분(약 300줄)만 걷어내도 된다. 자료구조 에뮬레이션은 유지한다. + +### K3. `redisTopologyTest` 레인과 그 fail-closed 장치 + +- **무엇**: `ca.redis-topology-lane`이 (a) 모드 화이트리스트, (b) 엔드포인트 필수, + (c) 0건 실행 실패, (d) 레인이 존재 이유로 삼는 클래스가 실제로 돌았는지, + (e) skip 1건도 실패 — 다섯 가지로 닫는다. +- **왜 지금 이게 맞는가**: + - `RedisTopologyContract.java:34-59`의 모드 검증은 실제 사고에서 나왔다. + `README.md:374`가 "오타 mode가 tag를 아무것도 매칭하지 못해 test 0건으로 BUILD SUCCESSFUL이 + 났다"고 기록한다. 검증 레인의 최악 실패는 실패가 아니라 **가짜 성공**이다. + - `:61-83`의 `verifyExecution`은 더 강하다. "0건이 아니다"가 아니라 "이 레인이 검증하겠다고 + 선언한 클래스가 실제로 돌았는가"를 본다. `requiredClasses()`(`:85-98`)의 8개가 전부 실재함을 확인했다. + - skip을 실패로 보는 판단(`:75-82`)도 맞다. qualification 레인에 조건부 커버리지는 없다. + - `.github/workflows/redis-sdk-topology.yml:32-38`이 이 leaf를 건드리는 PR마다 + standalone 레인을 실제 Redis 7.4로 돌린다. **다른 outbound 어댑터에는 이런 게이트가 없다.** +- **언제 재검토**: 레인 실행 시간이 PR 피드백을 늦추면 merge queue로. 지금 규모에서는 PR 게이트가 맞다. + +### K4. cache만 `bindings.default`이고 나머지가 `provider`인 것 — 일관성 결함이 아니다 + +- **왜 지금 이게 맞는가**: cache는 **region 단위로 여러 개**가 존재할 수 있는 유일한 능력이다. + - `RedisCacheConfig.java:37-56`이 만드는 port의 region 이름은 `cache.getSemanticRegion()`에서 온다. + - `RedisCacheRegionAdapter.CacheKeys`(`:372-375`)가 region을 키 세그먼트로 받는다(`:386`). + - 나머지 셋은 키에 region 개념이 없다. `LeaseKeys`의 `purpose`, `RateLimitKeys`의 `policyId`는 + **호출 시점 인자**이지 배포 설정이 아니다. + - `bindings.: ` 모양이면 나중에 `bindings.session: redis`, + `bindings.catalog: caffeine`처럼 region별 provider를 고를 수 있다. `provider` 하나로는 안 된다. + - `RedisCorrectnessRoles.java:32-37`이 cache를 정합성 롤에서 **뺀** 것도 맞다. + 캐시 장애는 느려짐이지 오답이 아니다. +- **언제 재검토**: `bindings`에 `default` 말고 다른 키가 1년 안에 생기지 않으면 `provider`로 통일. + 지금은 **의도된 차이**로 판정한다. + +### K5. `EFFICIENCY_ONLY` lease가 실제로 펜싱을 주지 않고, 오용할 API 표면도 없다 + +- **왜 지금 이게 맞는가** (전수 확인): + - `LeaseHandle`이 노출하는 것은 `ownerToken`(랜덤 24바이트), `operationId`, `acquiredAt`, + `remainingValidity`, `observedServerExpiry`, `state`뿐이다. + **펜싱에 쓸 수 있는 단조 증가 값이 하나도 없다.** + - `RedisDistributedLeaseAdapter.java:400-402`의 `guarantee()`가 + `LeaseGuarantee.EFFICIENCY_ONLY`를 상수로 반환한다. 조건 분기 없음. + - 클래스 javadoc `:30-35`가 "anything correctness-sensitive needs a conditional write at the + point of effect, not a lock in front of it"라고 정확히 적는다. + - **다른 홀더의 owner token이 애플리케이션으로 새지 않는다.** Lua `:38,40,51,65,79`가 + `existing`을 반환하지만, `contendedOrConflicting`(`:169-183`)과 `inspect`(`:212-214`)는 + `startsWith(내ownerToken + ":")` 불리언 판정에만 쓰고 `Contended`/`OwnerOperationConflict`/ + `NotOwner`만 내보낸다. 토큰이 어댑터 밖으로 나가지 않으므로 "남의 리스를 훔치는" 경로가 없다. + - **drift budget 계산이 맞다.** `localValidityOf`(`:108-121`)가 `ttl - driftBudget`을 주고, + `grantedAtNanos`를 **요청 전** `nanoTime`(`:138`)으로 잡는다. 서버는 명령을 받은 시점부터 + 세므로 왕복 시간만큼 보수적이다. 응답 도착 기준이었다면 실제보다 긴 유효기간을 믿게 된다. + `ttl <= driftBudget`이면 예외를 던지는 것(`:109-119`)도 맞다. + - `state()`(`:295-302`)가 예산 소진 시 `LOST`를 반환한다. 서버 상태와 무관하게 + "이 홀더는 더 이상 주장할 수 없다"를 말한다. 정직하다. +- **언제 재검토**: 누군가 이 port로 결제·재고를 지키려 하면 필요한 것은 이 port의 강화가 아니라 + **별도의 펜싱 port**다. 지금 port에 토큰을 추가하면 "EFFICIENCY_ONLY"라는 이름이 거짓이 되고, + 그게 이 설계가 막고 있는 바로 그 사고다. (M7의 `inspect` drift 누락은 고치되 설계는 유지한다.) + +### K6. 하나의 네임스페이스 접두사와 `CapabilityKeyspace`의 세퍼레이터 규칙 + +- **왜 지금 이게 맞는가** (브리프 질문 3의 답 — 전수 검증): + - 능력 **다섯 개가 전부** 같은 `RedisNamespace`를 받고 같은 `CapabilityKeyspace`로 렌더한다: + `RedisCacheRegionAdapter.CacheKeys:373`(`"cache"`), `RateLimitKeys:35`(`"ratelimit"`), + `RedisDistributedLeaseAdapter.LeaseKeys:382`(`"lease"`), + `RedisIdempotencyStoreAdapter.IdempotencyKeys:514`(`"idem"`), `RealtimeKeys:35`(`"realtime"`). + namespace 인스턴스는 전부 `RedisKeys.namespaceOf(sdk)` 한 곳에서 온다 + (`RedisCacheConfig.java:50`, `RedisRateLimitConfig.java:53`, `RedisLeaseConfig.java:37`, + `RedisIdempotencyConfig.java:46`). + - 따라서 ACL 패턴 `~prod:*`(`infra/redis-sdk/acl/application.acl`)가 다섯을 전부 덮는다. + `LiveRedisSemanticPortsTest.java:335`가 실서버에서 검증한다. + **주석이 밝힌 과거 사고는 실제로 해결됐다.** + - 세퍼레이터 규칙(`CapabilityKeyspace.java:91-104`)의 논증이 정확하다: + `("a:b","c")`와 `("a","b:c")`가 같은 키로 렌더되면 두 subject가 한도를 공유하거나 + 두 operation이 멱등성 레코드를 공유한다. 마지막 세그먼트만 허용하는 것은 그게 + `hv1:` digest이고 뒤에 아무것도 없어 모호성이 생길 수 없기 때문이다. + - environment를 맨 앞에 둔 것도 맞다. ACL이 가장 먼저 가두고 싶은 축이고, 앞에 있어야 + 하나의 패턴으로 배포 전체를 덮으면서 다른 환경은 덮지 않는다. +- **남은 구멍 하나**: `sdk/api/key/RedisKeyRenderer.java`는 여전히 **다른 모양**을 만든다 — + `{env}:{svc}:{domain}:{entity}:{identifier}`로 capability 토큰도 key version도 없다. + 지금은 죽은 코드라 충돌하지 않지만, C3를 "조립한다"로 해결하면 **두 번째 키 모양이 살아난다.** +- **언제 재검토**: 멀티테넌시가 들어오면 tenant를 네임스페이스에 넣을지 digest에 넣을지 결정해야 한다. + +### K7. 클러스터 해시 태그 문제를 **키 하나짜리 스크립트**로 회피한 것 + +- **왜 지금 이게 맞는가** (브리프 질문 6의 답 — 전수 확인): + - `RateLimitScripts`의 세 프로그램, `LeaseScripts`의 네 프로그램(`:28-82`), + `IdempotencyScripts`의 네 프로그램(`:40-186`) — **전부 `KEYS[1]` 하나만** 쓴다. + - cache는 Lua를 쓰지 않는다. `generationKey`와 `entryKey`는 별개 명령이므로 + (`RedisCacheRegionAdapter.java:299,276`) 슬롯이 달라도 무방하다. + - 따라서 `CROSSSLOT`이 발생할 수 있는 지점이 **없다.** 해시 태그를 도입하면 오히려 한 정책의 + 모든 subject가 한 슬롯에 몰려 핫스팟이 된다. + - `sdk/api/key/RedisSlotTag.java:8-11` 주석도 같은 판단을 적는다: + "A deliberately low-cardinality tag pins an entire tenant onto a single slot and is a + documented misuse." + - `RedisSlotCalculator.hashed`의 구현도 Redis 규칙과 일치한다 — 첫 `{` 이후 첫 `}`, + 빈 태그 `{}`는 태그가 아님. +- **언제 재검토**: 두 키를 원자적으로 봐야 하는 능력이 추가되면 그때 필요하다. 그 전엔 비용만 생긴다. + +### K8. cache만 fail-open이고 나머지는 fail-closed / indeterminate인 것 + +- **왜 지금 이게 맞는가**: 실패의 의미가 다르다. + - cache 실패 = 느려짐. `RedisCacheRegionAdapter.java:28-32`가 "That licence is specific to this + port and must never be copied"라고 못 박고, 실제로 복사되지 않았다. + - rate-limit 실패 = 한도 없음. `RedisEdgeRateLimitAdapter.java:77-81`의 "an in-process count + during a Redis outage is not a global limit, it is N times the limit"는 정확한 논증이다. + - idempotency/lease 실패 = **모름**. `Indeterminate`를 별도로 유지하고 "실패"로 뭉개지 않는다 + (`RedisIdempotencyStoreAdapter.java:44-47,246-250`). 실패로 보고하면 호출자가 재시도해 + 중복 부작용을 만든다. + - `RedisSdkAutoConfiguration.java:66-71`의 `DEGRADED`와 readiness 그룹 분리도 같은 축이다. +- **언제 재검토**: 캐시가 "없으면 서비스 불가" 수준이 되면 cache도 정합성 롤로 올린다. + 스켈레톤 기본값으로는 지금이 맞다. + +### K9. raw 게이트웨이 allowlist 리소스를 기동 시 검증하는 것 + +- **왜 지금 이게 맞는가**: 기본값이 `classpath:redis-sdk/raw-command-allowlist.yml` + (`RedisSdkSettings.java:800`)인데 **이 모듈은 그 파일을 배포하지 않는다** + (`src/main/resources/redis-sdk/`에는 `redis-command-policy.yml` 하나뿐임을 확인). + 즉 raw를 켜면 반드시 이 검증에 걸린다. `RedisSdkAutoConfiguration.java:113-118` 주석이 + "설정 검증은 통과하고 첫 raw 명령에서, 요청 안에서, 살아 있는 커넥션 상대로 실패했다"는 + 사고를 기록한다. **인가 모델을 읽을 수 없는 것은 기동 실패가 맞다.** +- **언제 재검토**: raw 게이트웨이가 조립되면 "파일이 읽히는가"를 넘어 "파싱되고 카탈로그와 + 정합한가"까지 가야 한다. + +--- + +## 7. 커밋 안 된 리팩토링이 이 영역에 미친 영향 (정정판) + +### 7.1 먼저 수치를 바로잡는다 + +내가 처음 받은 `full.diff`는 `git diff HEAD`라서 **untracked 파일을 포함하지 않는다.** +`−22,532`를 "안전망 절단"으로 읽은 것은 틀렸다. 실제는 이렇다. + +| | 줄 | +|---|---| +| tracked 추가 | +2,374 | +| tracked 삭제 | −22,532 | +| untracked 추가 (175파일, diff에 안 보임) | **+21,270** | +| **실제 순증감** | **≈ +1,112** | + +**−22,532는 대부분 이동이다.** 삭제된 135개 파일과 신규 175개 파일의 경로를 대조하면 +Mongo·web·websocket·graphql·objectstorage·httpclient의 테스트가 `src/test/`에서 +`src/integrationTest/`, `src/systemTest/`, `src/mongoIntegrationTest/`, +`src/mongoProviderTestkit/` 같은 **전용 소스셋으로 이사**했다. +예: `MongoMigrationLaneTest`는 `src/test/`에서 삭제되고 `src/mongoIntegrationTest/`에 357줄로 +다시 나타난다. `GraphqlHttpBoundaryQualificationTest`, `WebSocketBoundaryQualificationTest`, +`FailureInjectionContractTest`, `ToxiproxyFixture`, MinIO contract/fault 레인도 전부 같은 패턴이다. + +### 7.2 이 영역의 변경 — tracked 4파일, untracked 0파일 + +**cache-redis leaf는 tracked에도 untracked에도 단 한 파일도 없다.** + +tracked에서 Redis 관련으로 바뀐 것은 app-bootstrap의 **타입 이름 하나**뿐이다. + +| 파일 | 변경 | +|---|---| +| `RedisCacheConfig.java` | `bootstrap.runtime.SecretSource` → `application.outbound.SecretSourcePort` | +| `RedisCapabilityConfig.java` | 동일 | +| `RedisKeys.java` | 동일 (`KeyDigest.of` 시그니처) | +| `RedisCapabilityCompositionTest.java` | 동일 (테스트 픽스처 빈) | + +각 `+2/-2`. `docs/superpowers/specs/2026-09-18-secret-source-port-ownership.md`가 소유하는 +슬라이스이고, 그 스펙 `:46`이 "SecretSourceValidator and **Redis secret consumers** depend only on +SecretSourcePort"라고 명시한다. 시크릿 소스 포트를 bootstrap에서 application-core로 올리고 +구현을 `adapter:outbound:support`로 내린 것이다 — **경계 관점에서 정방향 개선이다.** + +### 7.3 진짜 관찰: cache-redis만 이번 물결에 들어오지 않았다 + +untracked 175개의 공통 주제는 하나다. `docs/superpowers/specs/2026-09-18-*.md` 10개가 +**오늘 날짜로** 작성돼 있고, 그중 5개가 `*-composition-ownership`이다. 표준은 이렇다 +(`2026-09-18-httpclient-capability-composition-ownership.md:17-25`): + +> 능력 leaf가 **자기 Boot 자동설정 진입점을 소유**하고 `AutoConfiguration.imports`로 발행한다. +> `app-bootstrap`은 애플리케이션 전역 시작 리포팅만 남기고, **이 슬라이스 이후에는 해당 능력의 +> 구현·자동설정 타입을 import하지 않는다.** + +이미 옮겨간 leaf와 그 증거: + +| leaf | 신규 패키지 | 자기 `.imports` 진입점 | +|---|---|---| +| httpclient | `autoconfigure/` 16파일 | `HttpClientPlatformAutoConfiguration` | +| notification | `platform/autoconfigure/` 12파일 | (leaf `.imports` 보유) | +| persistence-jpa | `persistence/autoconfigure/` | `PersistenceJpaAutoConfiguration`, `PersistenceJpaRuntimeConfig` | +| persistence-mongo | — | (leaf `.imports` 보유) | +| **cache-redis** | **없음** | `RedisSdkAutoConfiguration` **하나 — SDK 계층뿐** | + +그리고 `adapter:outbound:support`에 **공유 기반 3개가 새로 생겼다**(untracked): + +- `EnvironmentSecretSource.java`(22줄) — `SecretSourcePort`의 Spring Environment 구현. + `secret://environment/...` 해석의 새 공식 경로다. **cache-redis는 여전히 + `RedisSdkAutoConfiguration.java:213-217`의 자체 `System.getenv` 폴백을 갖고 있다.** +- `CapabilityStartupValidationException.java`(30줄) — `IllegalStateException` + + `ExitCodeGenerator(78)`. "컴포지션 루트 아래에 살아서 capability 자동설정이 app-bootstrap에 + 의존하지 않고 fail-closed할 수 있게" 한다는 것이 클래스 javadoc(`:8-10`)이다. + **cache-redis는 `IllegalStateException`(`RedisSdkSettings` 전반)과 + `StartupFailures.envValidation`(`RedisKeys.java:42`, `RedisRateLimitConfig.java:66`)을 섞어 쓴다. + 후자는 `dev.caskeleton.bootstrap.runtime.startup`에 있어 leaf로 옮길 수 없다.** +- `StrictSettingsBinder.java`(82줄) — **마스터 스위치가 켜졌을 때만, 그리고 prefix 아래 + 미지정 키를 거부하며** 바인딩한다. javadoc `:51-54`: + "Silently dropping `app.fileserver-platform.uplaod.max-file-size` is how a deployment ends up + running the default limit while its configuration file says otherwise." + +### 7.4 판정 + +**삭제는 안전망 절단이 아니라 이동이었다. 그리고 cache-redis에 관한 한 이번 물결의 의미는 +"무엇이 없어졌나"가 아니라 "무엇이 안 왔나"다.** + +두 가지가 동시에 참이다. + +1. **Redis의 실서버 증거 레인은 온전히 남았다.** 다른 어댑터들이 테스트를 전용 소스셋으로 + 재배치하는 동안 `redisTopologyTest`와 `.github/workflows/redis-sdk-topology.yml`은 + 손대지 않았다. 이 영역에서 찾은 H1(토큰 버킷 PEXPIRE)과 M4(fixed-window 무한 해시)는 + in-memory fake로는 절대 잡히지 않고 **그 레인에 케이스 몇 개를 더하는 것만으로 잡힌다.** + 남은 레인의 가치가 여기서 증명된다(§6 K3). + +2. **조립 소유권 이전이 오지 않았고, 그 사이에 C1이 생겼다.** cache-redis의 능력 조립은 + 여전히 `app-bootstrap`의 스캔 제외 패키지에 있고, 등록되지 않는다. 다른 네 leaf가 + `.imports`를 갖게 되는 동안 이 leaf만 남았다. **C1은 "아직 안 온 이전"의 증상이다.** + +--- + +## 8. 템플릿 사용자 관점 + +### 8.1 지금 상태에서 fork하면 실제로 벌어지는 일 + +**능력 4개 중 셋은 어떤 설정으로도 켜지지 않고, 하나는 켜면 기동이 실패한다.** + +| 설정 | 결과 | +|---|---| +| `APP_REDIS_ENABLED=true`만 | Lettuce 클라이언트 + 커넥션 풀 + 헬스 2개. 능력 0개 | +| `+ APP_CACHE_CANONICAL_DEFAULT_PROVIDER=redis` | 아무 일도 안 일어남. 기동 성공. 캐시 port 없음 | +| `+ APP_LEASE_PROVIDER=redis` | 아무 일도 안 일어남. 기동 성공. lease port 없음 | +| `+ APP_IDEMPOTENCY_PROVIDER=redis` | 아무 일도 안 일어남. 기동 성공. store·executor 없음 | +| `+ APP_RATE_LIMIT_PROVIDER=redis` | port 없음. **게다가** `redisRequired` 헬스가 생겨 readiness가 Redis에 묶인다 | +| `+ APP_RATE_LIMIT_ENABLED=true` (HTTP 강제) | **기동 실패**: `EdgeRateLimitPort must have exactly one bean when edge rate limiting is enabled` | + +마지막 줄이 핵심이다. 운영자가 보는 메시지는 자기가 설정한 적 없는 빈 이름이고, +env를 다 올바르게 준 상태에서 나온다. `RedisActivationValidator`의 javadoc(`:18-22`)이 +"그 실패가 운영자를 잘못된 파일로 보낸다"고 정확히 예언한 바로 그 실패다. + +### 8.2 손대야 하는 파일 + +| 파일 | 왜 | +|---|---| +| `app-bootstrap`의 `AutoConfiguration.imports` | **C1. 지금은 여기에 redis 항목이 없다** | +| `config/capabilities.yml` | 능력 선택 + TTL/정책 기본값 | +| 배포 env | `APP_REDIS_*` 20개 이상 | +| `infra/redis-sdk/acl/*.acl` | 계정 분리를 쓸 거면 필수 | +| `src/adapter/outbound/cache-redis/README.md` | **읽지 말 것.** H9 | + +### 8.3 지뢰 (C1을 고친 뒤에도 남는 것들) + +1. **네임스페이스 기본값이 `local:sample-service:shared`다.** + `RedisSdkSettings.java:153-155`. 이 세 값은 **어떤 yml에도 없고** `env-keys.yaml:2207-2250`에만 + `required: false`로 등록돼 있다. `APP_REDIS_ENABLED=true`만 켜고 프로덕션에 나가면 키가 + `local:sample-service:shared:…`로 써지는데 저장소 ACL은 `~prod:*`다 → **모든 명령 NOPERM**, + 로그 없음(H4), health는 `UP`. *최소 방어*: `namespace.environment`가 `local`인데 프로파일이 + `prod`면 기동 실패시키는 검증 한 줄. 지금은 없다. +2. **단일 Redis 계정이면 스크립트 능력 셋이 전부 죽는다.** H7. +3. **토큰 버킷 파라미터 조합.** H1. +4. **`key-version`/HMAC 시크릿 변경 시 멱등성이 24시간 끊긴다.** M6. +5. **다중 인스턴스에서 `invalidateRegion()`이 동작하지 않는다.** H6. + 개발 환경(단일 인스턴스)에서는 완벽히 동작하고 프로덕션에서만 깨진다. 가장 발견하기 어렵다. +6. **문서가 있다고 하는 기능의 절반이 없다.** H9. + +### 8.4 가장 실용적인 권고 — 조립 소유권 이전을 이 leaf에도 적용하라 + +C1을 `.imports`에 한 줄 추가하는 것으로 임시로 막을 수는 있다. 그러나 +**2026-09-18 스펙군이 세운 표준대로 leaf로 옮기는 것이 이 leaf에서 특히 이득이 크다.** +이유는 이 leaf가 저장소에서 토글 밀도가 가장 높기 때문이다(능력 4 + 마스터 1 + provider 5). + +**이전이 오면 자동으로 해결되는 것** + +- **C1이 구조적으로 사라진다.** leaf의 `.imports`에 `RedisCapabilityPlatformAutoConfiguration`을 + 적으면 등록이 **파일 하나의 존재**로 보장된다. 지금처럼 "스캔 제외 패키지에 있는데 아무도 + import하지 않는" 상태가 성립할 수 없다. httpclient가 정확히 이 형태다 + (`HttpClientPlatformAutoConfiguration.java:28-44` — `@AutoConfiguration` + + `@ConditionalOnProperty` + `@Import(자식 9개)`, 그리고 leaf `.imports` 1줄). +- **M1이 사라진다.** `RedisCapabilitySettings`가 leaf로 가면 + `bootstrap.autoconfigure.redis`가 `@ConfigurationPropertiesScan` 목록에서 빠진다. + `StrictSettingsBinder.bind(environment, "ca-skeleton.capabilities.…", …)`로 바꾸면 + **마스터 스위치가 켜졌을 때만 바인딩**되고, 덤으로 **오타 키가 거부된다.** + 지금은 `app.redis.timeout.fats=5s`가 조용히 무시되고 기본 500ms가 적용된다. +- **`app-bootstrap` → `cache-redis` 컴파일 의존이 끊긴다.** 지금 `RedisCacheConfig.java:3-9`가 + `RedisCacheRegionAdapter`·`RedisSdkSettings`·`RedisRuntimeOwner`를 import한다. + httpclient 스펙 `:25`가 금지하는 바로 그 형태다. + +**이전해도 자동으로 해결되지 않는 것 (별도 수정 필요)** + +- **C3(SDK 도달 불가)는 해결되지 않는다.** 조립 위치가 바뀔 뿐, `CommandPolicyGuard`와 + 실행자를 빈으로 만들지 않는 한 어댑터는 계속 `LettuceRedisCommandGateway`에 직결한다. + 이전 슬라이스에서 **같이 결정해야 한다** — SDK를 조립할지, included build로 분리할지. +- **C2(LinkedHashMap)와 H1~H8은 전부 어댑터 내부 결함이라 그대로 남는다.** + 특히 C2는 **이전이 끝나 조립이 살아나는 순간 처음으로 발현한다.** 지금은 조립이 안 돼서 + 드러나지 않을 뿐이다. 이전과 같은 PR에 넣어야 한다. +- **M8(NOSCRIPT 문자열 매칭)도 남는다.** C3를 "조립한다"로 풀면 그때 깨진다. + +**권장 순서** + +0. **선행 조건 — 무조건 공급되는 `java.time.Clock` 빈.** 네 능력 빈이 전부 `Clock`을 + 요구하는데(`RedisCacheConfig.java:42`, `RedisRateLimitConfig.java:49`, + `RedisLeaseConfig.java:32`, `RedisIdempotencyConfig.java:41`) 배포 경로의 공급원은 + 죽은 것 하나(`IdempotencyConfig.java:19-22`)와 조건부 둘 + (`GraphQlPlatformAutoConfiguration.java:287-291`, sample-portfolio)뿐이다. + **이걸 먼저 하지 않으면 1·2단계가 `NoSuchBeanDefinitionException: java.time.Clock`으로 끝난다.** + `@ConditionalOnMissingBean`을 단 `Clock.systemUTC()` 빈을 `AdapterActivationAutoConfiguration` + 같은 무조건 등록 지점에 두는 것이 가장 싸다. +1. C2(`ConcurrentHashMap`) — 한 글자. 조립보다 먼저. 조립되는 순간 발현하는 결함이다. +2. 조립 소유권 이전: `RedisCapabilityPlatformAutoConfiguration`을 leaf에 만들고 + `.imports`에 등록(`@AutoConfiguration(after = RedisSdkAutoConfiguration.class)`). + 설정을 `StrictSettingsBinder`로. 실패를 `CapabilityStartupValidationException`으로 통일 + (`StartupFailures` 탈피). 시크릿은 `EnvironmentSecretSource`를 쓰고 + `RedisSdkAutoConfiguration.java:213-217`의 자체 `System.getenv` 폴백을 제거. + 급하면 그 전에 `app-bootstrap` `.imports`에 한 줄만 넣어 C1을 먼저 멈출 수 있다. +3. 같은 PR에서 `RedisActivationValidator`에 "선택자가 redis인데 port 빈이 없다" 검증 추가. + 그리고 컴포지션 테스트를 `withUserConfiguration` 대신 **실제 `CaSkeletonApplication`을 + 띄우는** 케이스로 하나 추가 — `DependencyErrorStartupContractTest`가 이미 그 형태다. + 이게 없었기 때문에 C1이 살아남았다. +4. H1·M4(Lua) + 실서버 레인 케이스 확장(세 알고리즘 × 나누어떨어지지 않는 파라미터). +5. M13(Pub/Sub 코덱)은 C3 결정 전에 고쳐 둔다 — 고친 구현이 이미 있으므로 복사면 된다. +6. C3(SDK) 방향 결정. **C1을 고쳐도 자동으로 해소되지 않는다**(§5 C3의 범위 표). + +### 8.5 도입 판정 + +- **알고리즘 설계 품질은 이 저장소에서 본 것 중 가장 높다.** 실패 분류(K8), lease의 정직함(K5), + 네임스페이스 통합(K6), 클러스터 회피(K7)는 전부 근거 있는 판단이고 코드가 그 판단을 지킨다. + **다만 그것은 지금 "배포 경로에 없는 코드의 품질"이다.** 32,082줄 중 능력 어댑터 1,900줄은 + 조립되지 않고, SDK 28,500줄은 조립되더라도 우회된다. +- **지금 상태로 프로덕션에 도입할 수 없다.** C1을 고치기 전에는 능력이 존재하지 않는다. +- **C1 + C2를 고치면 cache / rate-limit(fixed-window·sliding-counter) / lease는 쓸 만하다.** + H1·H4·H6을 순서대로 처리하면 충분하다. +- **idempotency는 C1 + C2 + M6를 전부 고치기 전에는 쓰지 않는 것을 권한다.** + 동시성 결함이 "가끔 스레드가 멈춘다"로 나타나고, 그게 하필 결제 중복을 막는 컴포넌트다. +- **SDK 28,500줄은 자산이 아니라 부채다.** 컴파일·정적분석·Spotless·Error Prone·SpotBugs가 + 전부 검사하고 테스트 15,244줄 중 대부분이 검증하는데 런타임에 존재하지 않는다. + fork한 사람이 유지보수 대상으로 물려받는다. included build 분리가 가장 싸고, + `grpc:*` 18개가 이미 그 선례다. + +--- + +## 9. 미확인 / 가정 + +### 빌드 미실행 + +Gradle wrapper jar가 스냅샷에 없어 **아무 태스크도 실행하지 않았다.** 아래는 전부 정적 분석이다. + +| 주장 | 확인 명령 | +|---|---| +| C1: rate-limit 켜면 기동 실패 | `APP_REDIS_ENABLED=true APP_RATE_LIMIT_PROVIDER=redis APP_RATE_LIMIT_ENABLED=true ./gradlew :app-bootstrap:bootRun` → `EdgeRateLimitPort must have exactly one bean…` 확인 | +| C1: 능력 빈 부재 | `./gradlew :app-bootstrap:test --tests '*RedisCapabilityComposition*'`는 통과하므로 무의미. 실제 컨텍스트에 `CacheRegionPort`/`DistributedLeasePort` 빈이 없음을 `ApplicationContextRunner` 대신 `@SpringBootTest(classes=CaSkeletonApplication.class)`로 확인 | +| M1: Redis-off에서 능력 설정 바인딩 | `APP_REDIS_ENABLED=false` + `ca-skeleton.capabilities.cache.command-timeout=notaduration`으로 기동 → 실패하면 확인 | +| H1: 소수 PEXPIRE | `redis-cli EVAL "redis.call('PEXPIRE', KEYS[1], 4333.33)" 1 k` | +| H1: rate limiter 전량 차단 | `algorithm=token-bucket, capacity=100, refill-tokens=30` 후 `redisTopologyTest` | +| C2: `LinkedHashMap` 동시성 | 50스레드 × `claim()` 스트레스 테스트 (현재 없음) | +| H6: 다중 인스턴스 invalidateRegion | 같은 Redis에 어댑터 2개 붙이는 테스트 (현재 없음) | +| H8: 레인 포화 | `APP_REDIS_CAPACITY_MAXIMUM_IN_FLIGHT_COMMANDS=2` + 동시 3스레드 | +| 현 상태 회귀 | `cd src && ./gradlew :adapter:outbound:cache-redis:check --console=plain` | +| 아키텍처 경계 | `cd src && ./gradlew architectureCheck --console=plain` | +| env 키 정합 | `cd src && ./gradlew :app-bootstrap:verifyEnvKeys --console=plain` | + +### 세운 가정 + +1. **Spring Boot의 등록 규칙.** C1은 "`@Configuration`은 컴포넌트 스캔·`@Import`· + auto-configuration 등록 중 하나로 도달해야 처리된다"에 의존한다. 표준 동작이고 + `@ConfigurationPropertiesScan`이 `@Configuration`을 살려내지 못한다는 것도 표준이지만, + 스냅샷에서 실행 확인은 못 했다. **가장 확실한 반증 방법은 §9 표의 첫 줄이다.** +2. **Lua 5.1 / Redis 7.2 의미론.** H1은 Redis가 Lua number를 `fpconv_dtoa`로 문자열화하고 + `PEXPIRE`가 정수만 받는다는 동작에 의존한다. +3. **Lettuce의 lazy connect.** "서버 없이도 기동한다"는 `RedisClient.create(...)`가 연결하지 + 않는다는 동작에 의존한다. `RedisSdkAutoConfigurationTest`가 서버 없이 컨텍스트를 만드는 + 케이스를 여럿 갖고 있어 간접 확인은 됐다. +4. **참조 그래프 분석의 보수성.** C3의 "190개 도달 불가"는 정규식 기반이라 **과대 포함** + (주석의 타입명도 도달로 셈) 쪽으로 편향됐다. 실제 도달 불가는 그보다 많을 수 있고 적을 수는 없다. + 핵심 주장(`CommandPolicyGuard`·`RedisOperationContext`·세 실행자 main 0회 생성)은 + `new X(` 리터럴 grep으로 확인했다. +5. **untracked 파일의 내용.** `untracked-files.txt`/`untracked-wc.txt`와 스냅샷의 실제 파일을 + 대조했고, 스펙 3개(`secret-source-port-ownership`, `httpclient-capability-composition-ownership`)와 + support 신규 3개는 전문을 읽었다. 나머지 7개 스펙은 제목과 경로로만 판단했다. + +### 다른 영역 담당자에게 넘길 것 (교차 이슈) + +- **app-bootstrap 담당 — 최우선. 전수 확인은 이미 완료됐다.** 죽은 것은 + `autoconfigure.{redis, outbox, lock, idempotency, tracing}` 다섯, + 살아 있는 것은 `autoconfigure.{fileserver, jpa, messaging, notification}` 넷이다. + 다섯 중 넷은 `.imports` 한 줄이면 되고 **`RedisCapabilityConfig`만 + `@AutoConfiguration(after = RedisSdkAutoConfiguration.class)`가 추가로 필요하다**(§5 C1). + 내 영역에서 확인한 연쇄: `provider=postgresql`이면 + `PostgreSqlIdempotencyStoreConfig.java:17-18`(persistence-jpa, 도달 가능)이 store를 만들지만 + `bootstrap/autoconfigure/idempotency/PostgreSqlIdempotencyProviderConfig.java:49`의 executor는 + 죽어 있어 **반쪽만 조립된다.** 그리고 **`Clock` 공급원이 그 다섯 안에 있다**(§8.4 0단계) — + 다섯을 한꺼번에 살리지 않고 하나씩 살리면 순서에 따라 `Clock` 미존재로 깨진다. +- **web/inbound 담당**: `RateLimitWebConfig.java:37,59-66`의 fail-fast가 C1의 유일한 가시적 + 증상이다. `app.rate-limit.enabled=true`인 배포는 지금 기동할 수 없다. + H2(시계)·H8(레인 포화)도 전부 그쪽에서 429/503으로 관측된다. 원인이 Redis 어댑터에 있다는 + 사실을 공유해야 한다. +- **persistence-jpa 담당**: `PostgreSqlIdempotencyStoreConfig.java:12-14`의 + `havingValue = "postgresql"`과 `capabilities.yml:28`의 `disabled | jdbc | redis`가 어긋난다(M12). + 둘 중 하나가 틀렸고, 지금은 어떤 값으로도 완전한 멱등성 스택이 조립되지 않는다. +- **shared-contract / application-core 담당**: `RateLimitPolicy.maximumClockRegression`과 + `cleanupGrace`(H3)는 계약에만 있고 유일한 provider가 무시한다. + `EphemeralFanoutPort`/`ConnectionRegistryPort`는 프로덕션 구현이 없다(C3) — port만 떠 있다. +- **빌드/CI 담당**: `redis-sdk-topology.yml`은 **유지 권고**다(K3). 다만 C3를 + "SDK를 included build로 분리"로 풀면 `settings.gradle`, `modules.json`, + `ca.redis-topology-lane` 적용 대상이 전부 바뀐다. 사전 협의 필요. +- **문서 담당**: `docs/redis/support-matrix.md`가 실서버 증거를 기록하고 + `RedisSupportMatrixTest`가 "증거 주장에 테스트 클래스 이름이 붙었는가"만 검증한다. + H1·M3의 맥락에서 그 매트릭스가 **토큰 버킷·슬라이딩 카운터에 대해 무엇을 주장하는지** + 확인이 필요하다. 실행된 적 없는 Lua에 대한 증거 주장이 있다면 별도 결함이다. diff --git a/docs/reviews/2026-09-18-techlead-review/08-httpclient-objectstorage.md b/docs/reviews/2026-09-18-techlead-review/08-httpclient-objectstorage.md new file mode 100644 index 00000000..e91f3b81 --- /dev/null +++ b/docs/reviews/2026-09-18-techlead-review/08-httpclient-objectstorage.md @@ -0,0 +1,742 @@ +# [영역] 아웃바운드 HTTP 클라이언트 / 오브젝트 스토리지 리뷰 + +- 스냅샷: 2026-09-18T11:50Z / HEAD 60b6a319 + 커밋 안 된 변경 224파일 +- 담당 leaf: `adapter-outbound-httpclient`, `adapter-outbound-objectstorage` + +--- + +## 0. 최종 적용 기준 + +HTTP Client와 Object Storage는 독립 optional capability다. leaf가 자기 AutoConfiguration을 소유하고 +bootstrap은 구현 타입을 직접 조립하지 않는다. 사용하지 않는 capability는 Build Composition에서 제외한다. +SecretSource seam, 실제 provider를 통과하는 storage test, 실제 socket path의 SSRF/TLS test를 우선한다. + +## 0-A. 2026-09-21 중간 재검증 + +**상태: HTTP Client leaf ownership과 integration lane 정리는 진척됐지만 application composition은 아직 과도하다.** + +HTTP Client leaf는 현재 자기 `AutoConfiguration.imports`를 갖는다. Object Storage도 +`src/integrationTest`로 real-provider contract를 분리했고 `integration-main.yml`에서 +`:adapter:outbound:objectstorage:integrationTest`가 실제 호출된다. + +다만 `app-bootstrap`은 아직 HTTP Client를 `implementation`으로 기본 포함한다. 따라서 leaf ownership이 +끝났다는 사실과 “파생 서비스가 capability를 선택적으로 artifact에서 제외할 수 있다”는 것은 별개다. + +이번 중간 점검에서는 HTTP Client/Object Storage의 전체 security/fault provider lane을 다시 돌리지는 +않았으므로 원 리뷰의 나머지 High/Medium finding을 일괄 완료 처리하지 않는다. + +## 1. 커버리지 + +두 leaf의 **모든 소스 파일을 한 개도 빠짐없이 전문 독파**했다. main 423파일 + 테스트 8개 소스셋 166파일 = **589파일 / 48,562줄**. + +| 소스셋 | 파일 | 줄 | 읽은 정도 | +|---|---:|---:|---| +| httpclient `main` | 276 | 16,470 | 전문 | +| httpclient `test` | 67 | 6,973 | 전문 | +| httpclient `testFixtures` | 34 | 2,662 | 전문 | +| httpclient `integrationTest` | 2 | 189 | 전문 | +| httpclient `httpClientPerformanceTest` | 7 | 495 | 전문 | +| httpclient `jmh` | 2 | 130 | 전문 | +| objectstorage `main` | 147 | 14,344 | 전문 | +| objectstorage `test` | 47 | 6,651 | 전문 | +| objectstorage `integrationTest` | 5 | 597 | 전문 | +| objectstorage `objectStorageAwsQualificationTest` | 2 | 51 | 전문 | +| **합계 (.java)** | **589** | **48,562** | | + +측정: `find -name '*.java' | wc -l`, `find -name '*.java' -exec cat {} + | wc -l`. + +**테스트 소스셋 8개를 통틀어 `.java`가 아닌 파일은 딱 1개다** — `objectstorage/src/integrationTest/resources/object-storage/minio-provider-evidence.json`(25줄). 이것도 전문 읽었고, 아래 §1.3(Q4)의 핵심 증거다. + +비-java 중 **의도적으로 제외한 것과 이유**: +- `gradle.lockfile` 2개 — Gradle이 만드는 의존성 잠금 산출물이다. 사람이 쓴 코드가 아니고 내용이 `group:artifact:version=configuration` 나열이라 리뷰 판정이 나올 여지가 없다. 의존성 버전은 다른 에이전트 담당. +- `.jqwik-database` — jqwik이 실패 샘플을 기록하는 실행 산출물(바이너리)이다. 테스트를 돌리면 생기는 파일이지 소스가 아니다. +- 그 외 두 leaf의 `build.gradle`, `README.md`, `CLAUDE.md`, `AutoConfiguration.imports`는 전부 전문 읽었다. + +추가로 읽은 것(영역 밖이지만 판정에 직결): + +| 파일 | 줄 | 왜 | +|---|---:|---| +| `docs/superpowers/specs/2026-09-18-httpclient-capability-composition-ownership.md` | 39 | 이번 리팩토링의 정본 | +| `docs/superpowers/plans/2026-09-18-httpclient-capability-composition-ownership.md` | 15 | 체크리스트에 무엇이 없는지 | +| `docs/superpowers/specs/2026-09-18-secret-source-port-ownership.md` | 64 | 시크릿 해석 경계 | +| `docs/superpowers/plans/2026-09-18-secret-source-port-ownership.md` | 15 | 동일 | +| `adapter/outbound/support/.../CapabilityStartupValidationException.java` | 30 | 두 leaf가 공유하는 기동 실패 타입 | +| `adapter/outbound/support/.../EnvironmentSecretSource.java` | 22 | 시크릿 어댑터 | +| `adapter/outbound/support/.../StrictSettingsBinder.java` | 82 | httpclient 설정 바인딩의 실체 | +| `app-bootstrap/.../CaSkeletonApplication.java` | 105까지 | 컴포넌트 스캔/제외 규칙 (C1) | +| `app-bootstrap/src/systemTest/.../ShippedCompositionHarness.java`, `FiveAdapterOffInventoryTest.java`, `test/.../AdapterActivationInventory.java` | 발췌 | C1을 잡을 수 있었던 테스트의 범위 확인 | +| `docs/registries/{env-keys,mdc-keys,headers,secrets-classification,metrics,object-storage-readiness}.yaml` | 해당 절 | 레지스트리 대조 | + +참고로 브리프 표의 httpclient test 줄 수(10,449)는 HEAD 기준이다. 스냅샷(=변경 적용 후)은 `test` 6,973 + `testFixtures` 2,662 + `integrationTest` 189 + perf 495 + jmh 130 = 10,449. 삭제가 아니라 소스셋 재배치다(§7). + +--- + +### 1.1 테스트 인구조사 — 부품 검증인가, 조립 검증인가 + +166개를 **"스프링 컨텍스트를 실제로 만드는가"** 하나로 갈랐다. + +| 분류 | 파일 | 비율 | +|---|---:|---:| +| 조립/배선 검증 — 스프링 컨텍스트를 만든다 | **9** | 5.4% | +| 조립 검증이지만 스프링 밖 — 조립기를 직접 호출한다 | **1** | 0.6% | +| 부품 검증 — 단위·계약·픽스처·성능·JMH | **156** | 94.0% | + +측정 명령: `find <소스셋> -name '*.java' -exec grep -l -F -- '<패턴>' {} + | wc -l` + +| 패턴 | 파일 수 | 어디 | +|---|---:|---| +| `ApplicationContextRunner` | **9** | httpclient `test` 4 + objectstorage `test` 5 | +| `withUserConfiguration` | **9** | 위와 같은 9개 | +| `AutoConfigurations.of` | **4** | httpclient `test/autoconfigure/` 전용 | +| `@SpringBootTest` | **0** | — | +| `CaSkeletonApplication` | **0** | — | +| `SpringApplicationBuilder` | **0** | — | +| `AnnotationConfigApplicationContext` | **0** | — | +| `AutoConfiguration.imports`(문자열) | **0** | — | + +`CaSkeletonApplication`이 **0개**인 것은 web leaf에서 관찰된 것과 같다. 이 두 leaf의 테스트 166개 중 **배포되는 컴포지션 루트를 띄우는 것은 0개**다. + +컨텍스트를 만드는 9개의 정체: + +| 파일 | 러너에 심는 것 | +|---|---| +| `httpclient/test/.../autoconfigure/HttpClientPlatformActivationTest.java:39-42` | `AutoConfigurations.of(HttpClientPlatformAutoConfiguration.class)` + `SupportingBeans`(Clock, `List`) | +| `httpclient/test/.../autoconfigure/HttpClientAutoConfigurationTest.java:32-36` | 동일 | +| `httpclient/test/.../autoconfigure/UnsafeStartupConfigurationTest.java:36-39` | 동일 | +| `httpclient/test/.../autoconfigure/ReactiveAuthenticationContractTest.java:28-32` | 동일 | +| `objectstorage/test/.../config/ObjectStorageCapabilityConfigTest.java:44-46` | `withUserConfiguration(ObjectStorageCapabilityConfig.class)` | +| `objectstorage/test/.../config/RoutingObjectStorageAdapterTest.java:50-52` | 동일 | +| `objectstorage/test/.../config/ObjectStorageScanMaintenanceConfigTest.java:17-20` | `ObjectStorageCapabilityConfig` + `ObjectStorageScanMaintenanceConfig` | +| `objectstorage/test/.../config/ObjectStorageLegacyMigrationConfigTest.java:20-23` | `ObjectStorageLegacyMigrationConfig` | +| `objectstorage/LegacyObjectStorageConfigTest.java:31-33` | `ObjectStorageConfig`(레거시) | + +10번째 — 스프링 밖 조립: `objectstorage/test/.../s3/S3ProviderCompositionTest.java:67-72`가 `ObjectStorageCapabilityAssembler`를 손으로 만들어 조립/해제 계약을 검증한다. 이건 실제로 "조립"을 보는 몇 안 되는 테스트인데, 스프링을 거치지 않으므로 컴포지션 루트 문제는 원리적으로 못 본다. + +도구 분포(참고): + +| 도구 | 파일 | +|---|---:| +| `MockHttpServer`(MockWebServer 래퍼) | 34 | +| Mockito | 12 (전부 objectstorage) | +| ArchUnit | 5 (httpclient 4 + objectstorage 1) | +| Testcontainers | 5 (httpclient `integrationTest` 2 + objectstorage `integrationTest` 3) | +| Reactor `StepVerifier` | 7 | +| BlockHound | 2 | +| jqwik(property) | 1 | +| JMH | 2 | + +**판정**: 이 영역의 테스트는 부품 검증으로는 밀도가 매우 높다(단위 1개당 계약 테스트가 붙어 있고, `ObjectStorageProviderContract` 같은 추상 계약도 있다). 그러나 **조립을 보는 눈이 5%뿐이고, 그 5%마저 전부 "부품을 손으로 심어 준 컨텍스트"다.** 배포되는 조립을 보는 테스트는 0개다. C1이 여기서 나온다. + +--- + +### 1.2 Q2 — 166개 중 C1을 잡을 수 있었던 테스트가 있는가: **없다** + +C1(9개 자식 `@Configuration`이 컴포넌트 스캔에 노출된 것)은 **본문으로 확정**한다. + +- `CaSkeletonApplication.java:99-113`의 `AUTO_CONFIGURED_PACKAGES`에 `...adapter.outbound.httpclient...` 없음. +- `AutoConfiguration.imports`는 부모 1줄뿐(`httpclient/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports:1`). `AutoConfigurationExcludeFilter`는 등재된 클래스만 제외하므로 자식 9개는 필터를 통과한다. +- 자식 9개 전부 클래스 레벨 조건 없는 `@Configuration(proxyBeanMethods = false)` (각 파일 첫 애노테이션 줄: `DynamicTargetAutoConfiguration:27`, `HttpClientAuthenticationAutoConfiguration:29`, `HttpClientManagementAutoConfiguration:13`, `HttpClientObservationAutoConfiguration:20`, `HttpClientProfileAutoConfiguration:37`, `HttpClientResilienceAutoConfiguration:20`, `HttpClientSecurityAutoConfiguration:16`, `HttpClientTransportAutoConfiguration:36`, `HttpServiceClientAutoConfiguration:28`). 부모만 `@AutoConfiguration` + `@ConditionalOnProperty`(`HttpClientPlatformAutoConfiguration:28-32`). + +잡을 수 있는 테스트가 **하나도 없는 이유는 구조적이다**: + +1. 이 결함은 **컴포넌트 스캔이 일어나야** 재현된다. 스캔을 일으키는 방법은 `@SpringBootTest`, `@ComponentScan`이 달린 설정 클래스, 또는 `SpringApplicationBuilder`뿐이다. **166개 중 이 셋을 쓰는 파일은 0개다.** +2. 유일하게 컨텍스트를 만드는 httpclient 쪽 4개는 전부 `new ApplicationContextRunner().withConfiguration(AutoConfigurations.of(HttpClientPlatformAutoConfiguration.class))` 형태다. 이 러너는 **자기가 넘겨받은 클래스만** 등록하는 `AnnotationConfigApplicationContext`를 만든다. 스캔 대상 패키지가 없으므로 자식 9개를 "스캔으로 발견"하는 일이 원리적으로 일어날 수 없다. +3. `HttpClientPlatformActivationTest`의 off 케이스는 `doesNotHaveBean(...)` 11건을 단언하는데, 그 11건이 전부 통과한다 — **러너 안에서는 실제로 빈이 안 생기기 때문이다.** 테스트는 정확하고, 테스트가 측정하는 세계가 배포되는 세계와 다르다. +4. 자기 leaf의 `.imports` 파일을 검사하는 테스트도 없다(문자열 `AutoConfiguration.imports` 출현 0건). 저장소에 그 관행의 참고 구현이 이미 있다 — `PersistenceJpaAutoConfigurationTest.java:62-72`. httpclient는 그 관행 밖이다. + +즉 **잡을 수 있었던 테스트가 있는데 안 돈 것이 아니라, 잡을 수 있는 종류의 테스트가 이 leaf에 존재하지 않는다.** 고쳐야 할 것은 C1 한 줄(제외 정규식)과, 조립을 보는 테스트가 0개라는 구조다. + +--- + +### 1.3 Q4 — objectstorage `integrationTest` 5개 + AWS qualification 2개가 실제로 보증하는 것 + +먼저 결론: **이 7개 중 저장소 자신의 S3 제공자(`S3ManagedObjectProvider` / `S3ConditionalObjectControlStore` / `S3ManagedMultipartProvider`)를 실제 스토어에 대고 돌리는 것은 0개다.** M2가 확정되고 등급이 올라간다. + +| 파일 | 줄 | 실제로 하는 일 | +|---|---:|---| +| `objectStorageAwsQualificationTest/.../qualification/AwsS3ManagedCommonSubsetQualificationTest.java` | 26 | **환경변수 존재만 단언한다.** `OBJECT_STORAGE_AWS_QUALIFICATION_ENABLED == "true"`, `..._BUCKET`/`..._REGION` non-blank, `..._EXPECTED_OWNER`가 `[0-9]{12}`. S3 클라이언트를 만들지 않고 요청도 보내지 않는다 | +| `objectStorageAwsQualificationTest/.../qualification/AwsS3DirectTransferQualificationTest.java` | 23 | 같은 형태 + `..._DIRECT_MUTATION_ENABLED == "true"` 한 줄 추가. 역시 요청 0건 | +| `integrationTest/.../MinioDirectTransferContractTest.java` | 25 | `minio-provider-evidence.json`을 읽고 `assertThat(evidence).contains("\"status\": \"UNSUPPORTED\"")`. MinIO를 띄우지 않는다 | +| `integrationTest/.../MinioDirectTransferFaultTest.java` | 32 | 같은 JSON에 대한 문자열 단언. MinIO를 띄우지 않는다 | +| `integrationTest/.../MinioManagedObjectContractTest.java` | 291 | 진짜 Testcontainers MinIO(다이제스트 고정). 다만 드라이브하는 대상이 **raw AWS SDK `S3AsyncClient.builder()`**이고 이 leaf의 제공자가 아니다 | +| `integrationTest/.../MinioManagedObjectFaultTest.java` | 147 | 진짜 MinIO + Toxiproxy. 역시 raw SDK | +| `integrationTest/.../S3ObjectStorageAdapterIT.java` | 102 | **deprecated 레거시** `S3ObjectStorageAdapter`(whole-`byte[]`)를 MinIO에 대고 검증 | + +그리고 그 JSON이 기록하는 내용이 판정을 뒤집는다 — `integrationTest/resources/object-storage/minio-provider-evidence.json`: + +- `"status": "UNSUPPORTED"` +- *"PutObject If-None-Match was accepted and overwrote an existing object"* +- *"stale PutObject If-Match returned HTTP 412 but create-if-absent control CAS is not safe"* +- *"CompleteMultipartUpload accepted If-None-Match despite a pre-existing target and overwrote it"* + +즉 **MinIO는 이 leaf의 불변 생성(`ifNoneMatch("*")`)과 제어 레코드 CAS가 딛고 선 원시 연산을 지키지 않는다**는 것이 저장소 자신의 측정 결과로 체크인돼 있다. `MinioManagedObjectContractTest`의 테스트 이름이 그걸 그대로 말한다 — `checksumHeadRangeWorkButConditionalCreateIsIgnoredWhileStaleCasIsRejected`, `lowLevelMultipartWorksButCompletionCreateOnlyConditionIsIgnored`. + +한편 그 사실은 바인딩 단에서 이미 강제되고 있다 — `S3ProviderBindingTest.java:56-64`가 MinIO 식별자로 direct 능력을 주장하면 `compile`이 거부함을 확인하고, `S3ProviderBindingTest.java:354-369`는 MinIO 프로필의 증거 상태를 `UNSUPPORTED`로 고정한다. **설계는 정직하다.** 문제는 그 정직함이 남기는 결론이다: MinIO는 지원되지 않고, AWS 실물은 한 번도 돌려본 적이 없으므로, **`s3/` 3,581줄 전체가 "실 스토어에 대고 한 번도 검증되지 않은 코드"다.** 단위 테스트 12개(`S3ManagedObjectProviderTest` 등)는 전부 Mockito `S3AsyncClient`를 상대로 요청 필드만 캡처해 단언한다. + +추가 근거 하나 더: `ObjectStorageProviderContract`(247줄, 스킵 없는 제공자 계약)를 **상속하는 클래스는 `LocalDevObjectStorageProviderTest` 단 하나다**(전수 grep). `s3` 패키지의 테스트들은 이 계약의 `static operation()` / `producer()` 헬퍼만 빌려 쓴다. 즉 "모든 제공자가 통과해야 하는 계약"을 S3 제공자는 통과한 적이 없다. + +마지막으로 `ObjectStorageReadinessRegistryTest.java:23`의 `KNOWN_PROVIDERS = Set.of("filesystem-local-dev")` — 레지스트리 검증기 자체가 `filesystem-local-dev` 외의 provider_type을 **unknown으로 거부**한다(`:82-91`). 즉 S3 카드는 추가하고 싶어도 이 테스트를 같이 고치지 않으면 추가할 수 없다. 레지스트리가 filesystem 100%인 것은 우연이 아니라 강제다. + +--- + +## 2. 이 영역은 무엇을 하는가 + +### 2.1 httpclient — "RestClient 얇은 래퍼"가 아니라 자체 복원력 프레임워크다 + +패키지별 main 줄 수(측정값): + +| 패키지 | 줄 | 파일 | 하는 일 | +|---|---:|---:|---| +| `restclient` | 2,018 | 19 | 블로킹 실행 경로(시도 실행기, 리다이렉트 코디네이터, 응답 매퍼, 바이트 상한, RestClient 런타임 팩토리) | +| `resilience` | 1,746 | 39 | **재시도 적격성 엔진, 증거 분류기, 데드라인, 백오프, 재시도 예산, 서킷/레이트/벌크헤드 파이프라인** | +| `autoconfigure` | 1,466 | 16 | 마스터 스위치, 설정 바인딩, 기동 검증, 전송 등록, 게이트웨이 발행, actuator | +| `webclient` | 1,458 | 17 | 리액티브 실행 경로 + SSE + 스트리밍 | +| `profile` | 1,271 | 29 | Named Client Profile 모델, 기동 검증기(30여 개 위반 코드), 런타임 세대/드레인 레지스트리 | +| `service` | 1,164 | 14 | `@HttpExchange` 타입드 클라이언트 스캐너/프록시 + 커널 어댑터 | +| `security` | 1,146 | 21 | 대상 정책, 헤더 정책, TLS 자재/정책, 리다이렉트 평가, URI 템플릿 확장 | +| `dynamic` | 989 | 11 | **H3 SSRF 방어**(정규화→허용목록→전수 DNS 검증→주소 핀) | +| `auth` | 926 | 18 | Basic/API-Key/Static-Bearer/OAuth2 자격증명, 단일비행 토큰 로더 | +| `api/*` | 1,264 | 49 | 프레임워크 무의존 공개 타입(오퍼레이션, 바디, 결과, 안정 예외 23종) | +| `apache`/`jdk`/`reactor`/`http3` | 1,717 | 21 | 전송 SPI 4종 구현 + 실패 분류기 4종 | +| `transport` | 365 | 10 | 전송 SPI + 능력 검증기 | +| `observation` | 381 | 6 | 메트릭 어휘, 태그 정책, 안전 로그 이벤트 | +| `migration`/`spring7` | 271 | 7 | RestTemplate 인벤토리/브리지, Spring 7 서비스 그룹 | + +**판정: 자체 복원력 프레임워크다.** `RestClient`/`WebClient`는 소켓을 잡는 마지막 한 겹으로만 쓰이고(`BlockingClientRuntime.java:85`, `ReactiveClientRuntime.java:72` — 둘 다 package-private 접근자), 나머지는 전부 이 leaf가 직접 구현했다. Resilience4j는 `CircuitBreaker`/`RateLimiter` 원시 연산만 쓰고 재시도 판단은 전혀 위임하지 않는다(`build.gradle:48-49` 주석이 그렇게 선언하고, `resilience/DefaultRetryEligibilityEngine.java`가 그대로 구현). + +16,470줄의 근거는 설득력이 있다. "메서드만 보고 재시도하지 않는다"(`RetryContext`에 HTTP 메서드가 아예 없다, `resilience/RetryContext.java:21-38`), "보냈는지 안 보냈는지를 증거로 판정한다"(`AttemptStage.provesNotSent`, `DefaultExecutionEvidenceClassifier`), "모호하면 세 번째 답을 준다"(`AmbiguousFailure`) — 이 세 가지를 제대로 하려면 실제로 이 정도 코드가 필요하다. + +### 2.2 objectstorage — 두 개의 어댑터가 한 leaf 안에 공존 + +| 패키지 | 줄 | 하는 일 | +|---|---:|---| +| `s3` | 3,581 | AWS S3 / MinIO 비동기 제공자(관리형 단건, 멀티파트, 다이렉트, 조건부 컨트롤 스토어) | +| `control` | 2,470 | 제어 레코드 14종 + 정규 JSON 코덱(직접 구현한 canonical reader/writer) | +| `config` | 1,883 | 비활성 기본 바인딩 컴파일러, 능력 조립기, 라우팅 어댑터 3종 | +| `direct` | 1,670 | presigned 그랜트 상태기계·정책·리댁터 | +| `kernel` | 1,463 | 오퍼레이션 커널/상태기계/에포크/정책 스냅샷 | +| `filesystem` | 841 | `filesystem-local-dev` 제공자(경로 가드, 스트림 전송, 단일프로세스 CAS) | +| `maintenance` | 609 | 레거시 입양(Ed25519 승인 검증 포함) | +| `codec` | 539 | Crockford Base32, 데이터/컨트롤 키, 핸들, 지문 | +| `multipart` | 318 | 관리형 멀티파트 코디네이터 | +| `readiness` | 294 | 능력 카드 / 증거 / 준비도 레벨 | +| `provider` | 244 | 제공자 SPI | +| 최상위 3파일 | 432 | **deprecated 레거시** `ObjectStoragePort`(whole-`byte[]`) + filesystem/S3 어댑터 | + +**대상**: S3와 MinIO **둘 다** — 단, 정확한 릴리스만 허용하는 닫힌 allowlist다(`s3/S3ProviderType.java:7-8`, `s3/S3ProviderVersion.java:5-7`). 로컬 파일시스템 제공자도 있고(`filesystem/`), 제공자 선택은 env가 아니라 **설정 트리**로 한다: `app.object-storage.providers..type` (`config/ObjectStorageProviderSettings.java:8`). 부트스트랩에 `objectstorage.yml`이 없으므로 env 한 줄로 켜지는 구조가 아니다. + +`src/.data/objectstorage`, `src/sample-portfolio/.data/objectstorage`는 **레거시** filesystem 어댑터의 기본 경로다(`ObjectStorageSettings.java:21` `./.data/objectstorage`), 새 `filesystem-local-dev` 제공자의 루트가 아니다. 새 제공자는 `providers..root`를 명시하지 않으면 기동 실패한다(`filesystem/FilesystemLocalDevProviderContribution.java:23-27`). + +--- + +## 3. 런타임 토글 판정 — 꺼지면 정말 꺼지는가 + +### 3.1 httpclient + +> **전제**: 이 토글 메커니즘 전체가 **아직 커밋되지 않은 코드**다. `autoconfigure/` 16파일과 `AutoConfiguration.imports`는 untracked이고(§7), 구 위치(`app-bootstrap`)는 워킹트리에서 이미 삭제됐다. 즉 **HEAD를 그대로 체크아웃하면 지금의 토글 구조는 존재하지 않고, `git add` 없이 커밋하면 capability 자체가 사라진다.** + +- **끄는 키**: `APP_HTTPCLIENT_ENABLED` → `app.httpclient.enabled` (`src/app-bootstrap/src/main/resources/config/httpclient.yml:7`, 기본 `false`). +- **설계상 의도**: `HttpClientPlatformAutoConfiguration`이 유일한 진입점이고 `@ConditionalOnProperty(havingValue="true")`로 잠긴다(`autoconfigure/HttpClientPlatformAutoConfiguration.java:28-32`). 나머지 9개 설정은 `@Import`로만 들어온다(`:33-43`). 설정 바인딩도 `@ConfigurationProperties`를 일부러 안 붙이고 게이트 안에서 수동 바인딩한다(`autoconfigure/HttpClientPlatformSettings.java:16-22`, `HttpClientPlatformAutoConfiguration.java:58-59`). +- **leaf 단위 검증**: `test/.../autoconfigure/HttpClientPlatformActivationTest.java`가 `ApplicationContextRunner`로 11종 빈 부재를 단언한다. 이 테스트는 진짜다. +- **그러나 실제 컴포지션 루트에서는 성립하지 않는다 → C1 참조.** `app-bootstrap`의 컴포넌트 스캔이 `dev.caskeleton.adapter`를 통째로 스캔하는데(`CaSkeletonApplication.java:42-48`), 제외 정규식(`:99` 이하 `AUTO_CONFIGURED_PACKAGES`)에 `dev.caskeleton.adapter.outbound.httpclient.autoconfigure`가 **없다**. 9개 자식 `@Configuration`이 스위치와 무관하게 스캔된다. +- **껐을 때 남는 클래스패스 비용(토글과 무관, 항상)**: `app-bootstrap/build.gradle:114`가 `implementation`이므로 Apache HC5, Reactor Netty, **Jetty client**, Resilience4j 5종, spring-webflux, spring-security-oauth2-client, Jackson 2+3이 항상 런타임 클래스패스에 있다(`httpclient/build.gradle:25-68`). 이건 CLAUDE.md:62-63이 "빌드 포함은 런타임 활성화와 별개"라고 명시적으로 인정한 선택이다(M5 참조). +- **필수 env**: 없음. `APP_HTTPCLIENT_ENABLED` 외에는 전부 배포별이고 `docs/httpclient/env-fields.yaml`에 별도 등록. Redis/외부 의존 없음. + +### 3.2 objectstorage + +- **끄는 키**: `app.object-storage.enabled` (기본 `false`, `config/ObjectStorageCapabilitySettings.java:9`). `app.object-storage.legacy.enabled`는 별개 스위치. +- **부트스트랩에 아예 없다.** `app-bootstrap/build.gradle`에 `:adapter:outbound:objectstorage` 의존이 없고, `modules.json`의 `app-bootstrap.allowed_dependencies`에도 없다. 유일한 소비자는 `sample-portfolio/build.gradle:54` `runtimeOnly`. → 프로덕션 컴포지션 루트 기준으로 "꺼짐"이 아니라 **부재**다(M1). +- **sample-portfolio에서 켜졌을 때**: `ObjectStorageCapabilityConfig`가 무조건부 `@Configuration`이라(`config/ObjectStorageCapabilityConfig.java:22-24`) `app.object-storage.enabled=false`여도 빈 4개가 항상 생긴다 — 제공자 기여 2개(`:28`, `:34`), 바인딩 컴파일러(`:39`), 조립기(`:54`). 다만 **이 4개는 자원을 만들지 않는다**: `describe()`는 부작용 금지가 인터페이스 계약이고(`config/ObjectStorageProviderContribution.java:9-11`), S3 클라이언트/프리사이너/스레드풀은 `create()`에서만 생기며 `create()`는 `enabled=true`일 때만 불린다(`ObjectStorageCapabilityConfig.java:60-65`). 테스트가 이걸 명시적으로 단언한다(`test/.../config/ObjectStorageCapabilityConfigTest.java:139-158` "disabledContributionIsNeverDescribedConstructedOrClosed", `:51` 디렉터리 미생성). +- **S3/MinIO 없이 기동되는가**: 된다. AWS SDK 클래스는 클래스패스에 있지만 로딩되는 시점이 `create()`뿐이다. +- **sample의 실제 설정**: `sample-portfolio/src/main/resources/application.yml:318-323` — canonical은 `enabled: false`, **레거시 filesystem은 `enabled: true`**. 즉 샘플이 실제로 도는 경로는 deprecated whole-`byte[]` 어댑터다. + +**요약 판정**: objectstorage 토글은 "꺼지면 정말 꺼진다"가 코드·테스트 양쪽에서 성립한다. httpclient 토글은 **leaf 단위로는 성립하고 컴포지션 루트에서는 성립하지 않는다** — 그리고 그 차이를 만든 것이 이번 커밋 안 된 리팩토링이다. + +--- + +## 4. 구조 판정 + +| 축 | 판정 | 근거 | +|---|---|---| +| 의존 방향 (modules.json 대조) | **OK** | httpclient 허용=`domain-core, application-core, shared-contract, adapter-outbound-support`. 실제 `build.gradle:20-22`는 `application-core`, `shared-contract`, `adapter:outbound:support` 3개(domain-core 미사용 — 허용 범위 내). objectstorage 허용=`application-core, shared-contract`, 실제 `build.gradle:37-38` 동일. 초과 없음 | +| 경계 누수 — DTO/entity/framework 타입 | **OK (httpclient)** / **매우 우수 (objectstorage)** | httpclient: `api` 패키지 49파일에 Spring/Apache/Netty/Jetty/Resilience4j import 0건, `PublicApiArchitectureTest`가 강제. objectstorage: `application-core/.../objectstorage/**` 88파일에 `java.io`·`InputStream`·`OutputStream`·`ByteBuffer` **0건** (전수 grep). IO는 `ObjectChunkSink/Source` 콜백으로 뒤집어 놓았다 | +| 비즈니스 규칙 위치 | **OK** | 두 leaf 모두 기술적 복원력/전송 정책만 보유. 도메인 보상·유스케이스 순서는 없음 | +| port 인터페이스가 HTTP 개념 노출 | **해당 없음(설계상)** | httpclient는 application port를 구현하지 않는다. 자기 API(`HttpServiceRegistry` 등)를 발행하고 application이 그걸 쓰는 형태. 즉 `HttpStatus`/헤더가 application에 보이는 것은 **application이 이 leaf를 import할 때뿐**이고, CLAUDE.md:54-55가 그걸 금지한다. 다만 강제 수단이 이 leaf 안에 없다(M6) | +| 테스트 전략 적합성 — 부품 | **매우 우수** | 166파일 17,748줄 전수 독파 기준. 단위당 계약 테스트가 붙어 있고, `ObjectStorageProviderContract`(스킵 없는 추상 계약)·`AllStableTransportsContractTest`(전송별 동일 계약)·BlockHound 자기검증·jqwik property·다이제스트 고정 Testcontainers까지 갖췄다 | +| 테스트 전략 적합성 — **조립** | **불충분** | 166개 중 스프링 컨텍스트를 만드는 것이 9개(5.4%), 배포되는 컴포지션 루트를 띄우는 것이 **0개**다. `@SpringBootTest`·`CaSkeletonApplication`·`SpringApplicationBuilder` 모두 0건. C1·H8·L9가 전부 이 공백에서 나온다 (§1.1, §1.2) | +| 테스트 레인 배선 | **구멍 있음** | 중복 실행 3건 + "MinIO 계약"으로 이름 붙었지만 JSON 문자열만 단언하는 레인 2건 + 환경변수만 단언하는 AWS qualification 2건 (M7, §1.3) | + +**objectstorage → application-core 포트 경계에 대한 별도 판정**: 브리프가 물은 "스트림이 port를 통해 새는가"에 대한 답은 **안 샌다, 그리고 대안이 제대로 설계돼 있다**. `ObjectContentProducer.produce(context, sink)`가 어댑터 소유 싱크에 chunk를 밀어 넣고, `ObjectChunkSink.scoped`가 호출 범위 밖 사용을 무효화하며(`application-core/.../content/ObjectChunkSink.java:11-25`), 배열은 `write` 반환까지만 유효하다고 계약에 적혀 있다. S3 업로드는 이 싱크를 reactive-streams demand에 그대로 연결해 백프레셔까지 유지한다(`s3/S3AsyncRequestBodyBridge.java:137` `awaitDemand()`). + +--- + +## 5. 발견 + +### Critical + +#### C1. 커밋 안 된 리팩토링이 httpclient 마스터 스위치를 무력화했다 — 기본값(off)으로 `app-bootstrap` 기동이 깨질 가능성이 높다 + +- **현상**: 이번 변경이 9개 capability `@Configuration`을 `dev.caskeleton.bootstrap.autoconfigure.httpclient` → `dev.caskeleton.adapter.outbound.httpclient.autoconfigure`로 옮겼다. 앞쪽 패키지는 컴포넌트 스캔 제외 정규식에 걸려 있었고, 뒤쪽 패키지는 **걸리지 않는다.** +- **근거**: + - 스캔 대상: `src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/CaSkeletonApplication.java:42-48` — `basePackages`에 `"dev.caskeleton.adapter"` 포함. + - 제외 규칙: 같은 파일 `:49-57` — `TypeExcludeFilter`, `AutoConfigurationExcludeFilter`, REGEX `AUTO_CONFIGURED_PACKAGES`. + - `AUTO_CONFIGURED_PACKAGES` 정본: 같은 파일 `:99-113`. 열거된 9개 패턴 중 `...adapter.outbound.httpclient...`는 **없다**. (`bootstrap.autoconfigure.*`는 있다 — 이동 전 위치가 바로 여기였다.) + - `AutoConfigurationExcludeFilter`는 `AutoConfiguration.imports`에 등재된 클래스만 제외한다. 등재된 것은 부모 1개뿐: `httpclient/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports:1`. + - 자식 9개는 전부 평범한 `@Configuration(proxyBeanMethods = false)`다 — `HttpClientTransportAutoConfiguration.java:36`, `HttpClientProfileAutoConfiguration.java:147`, `HttpServiceClientAutoConfiguration.java:28`, `DynamicTargetAutoConfiguration.java:117`, `HttpClientResilienceAutoConfiguration.java:192`, `HttpClientSecurityAutoConfiguration.java:216`, `HttpClientAuthenticationAutoConfiguration.java:29`, `HttpClientObservationAutoConfiguration.java:109`, `HttpClientManagementAutoConfiguration.java:138`. `@Configuration`은 `@Component` 메타애노테이션이므로 스캐너가 각각 독립적으로 등록한다. + - `app-bootstrap/build.gradle:114`가 `implementation project(':adapter:outbound:httpclient')` — 클래스가 실제로 스캔 경로에 있다. +- **왜 문제인가**: 두 단계로 깨진다. + 1. `app.httpclient.enabled=false`여도 `HttpClientSecurityAutoConfiguration`(TlsPolicyValidator, TlsMaterialProvider), `HttpClientObservationAutoConfiguration`(TagPolicy, BlockingExecutionSupport), `HttpClientAuthenticationAutoConfiguration`(secretResolver, CredentialProviderRegistry, ReactiveRequestCredentialProvider), `HttpClientTransportAutoConfiguration`(Apache/JDK/Reactor 전송 제공자 3개) 빈이 생성된다. "off면 빈이 하나도 없다"는 README·CLAUDE.md·클래스 javadoc의 핵심 주장이 그 자리에서 거짓이 된다. + 2. 더 나쁘게, `HttpClientProfileAutoConfiguration.httpClientRuntimeRegistry(...)`가 파라미터로 `HttpClientPlatformSettings`를 요구한다(`HttpClientProfileAutoConfiguration.java:166-168`). 그 빈은 게이트가 열렸을 때만 만들어진다(`HttpClientPlatformAutoConfiguration.java:57-60`). 스캔으로 들어온 `HttpClientProfileAutoConfiguration`은 게이트와 무관하게 살아 있으므로 **`UnsatisfiedDependencyException`으로 컨텍스트 리프레시가 실패**한다. `HttpServiceClientAutoConfiguration`(모든 빈이 `ClientRuntimeRegistry` 요구)도 같다. + - 이것은 이동시킨 본인이 예측한 실패 모드와 **정확히 같은 문장**이다. `CaSkeletonApplication.java:93-97` javadoc: *"a component scan finds them regardless — so an all-off or partially configured deployment failed to start on an unsatisfied dependency rather than simply not installing the control."* 그리고 `HttpClientPlatformAutoConfiguration.java:20-23` javadoc: *"Wrapping them in a conditional parent would have changed nothing — the component scanner finds each child on its own — so the children had to leave the scan together with the switch."* 이번 이동은 자식들을 스캔 **안으로** 다시 넣었다. +- **왜 CI가 못 잡았나** (테스트 166개 전수 독파 후 확정 — §1.2): 이 결함을 잡을 수 있는 테스트가 두 leaf에 **0개**다. `@SpringBootTest` 0건, `CaSkeletonApplication` 언급 0건, `SpringApplicationBuilder` 0건, 자기 `.imports`를 검사하는 테스트 0건. leaf 쪽 새 테스트는 `ApplicationContextRunner`로 부모 auto-config만 등록하므로 컴포넌트 스캔을 절대 실행하지 않는다(`test/.../autoconfigure/HttpClientPlatformActivationTest.java:39-42`). 진짜 컴포지션 루트를 띄우는 유일한 테스트는 `app-bootstrap/src/systemTest/.../FiveAdapterOffInventoryTest`인데, 그 인벤토리는 JPA/MONGO/MESSAGING/NOTIFICATION/GRAPHQL **다섯 개만** 다루고(`test/.../activation/AdapterActivationInventory.java:31-37`) httpclient는 대상이 아니며, `systemTest` 레인은 `system()`이라 `check`/`ci`에 붙지 않는다(`app-bootstrap/build.gradle:54-60`, `check`에 `dependsOn` 없음). +- **작업 계획서가 이걸 보장한다고 주장한다**: + - `docs/superpowers/specs/2026-09-18-httpclient-capability-composition-ownership.md:21` — *"Runtime activation remains app.httpclient.enabled=true. When absent or false the root auto-configuration creates no client, pool, transport, thread, scheduler, or endpoint."* + - `docs/superpowers/plans/2026-09-18-httpclient-capability-composition-ownership.md:10` — `[x] Prove disabled capability creates no runtime beans`. 이 항목을 만족시킨 증거가 `ApplicationContextRunner` 테스트인데, 그 러너는 **구조적으로** 컴포넌트 스캔을 실행할 수 없다. 즉 체크된 항목이 증명하지 못하는 것을 증명했다고 기록돼 있다. + - 같은 plan `:13` — `[x] Run HTTP-client unit/security/integration regression, bootstrap test/architecture regression`. `test`와 `architectureTest`는 실제 컴포지션 루트를 띄우지 않는다. `systemTest`는 목록에 없다. + - 계획서 15개 항목 어디에도 **"컴포넌트 스캔 제외 목록을 갱신한다"**가 없다. 구 패키지가 우연히 제외 정규식 안에 있었다는 사실이 계획에 반영되지 않았다. + - 그리고 같은 spec `:39`가 전제를 확정한다 — *"It does not yet flip the app-bootstrap project dependency to runtimeOnly"*. 즉 이 슬라이스가 끝난 시점에도 leaf 클래스는 `app-bootstrap`의 스캔 경로에 그대로 있다. +- **수정 방향**: `AUTO_CONFIGURED_PACKAGES`에 `|dev\\.caskeleton\\.adapter\\.outbound\\.httpclient\\.autoconfigure\\..*` 추가. 그리고 이번 변경이 노출한 진짜 구멍 — "capability autoconfigure 패키지가 제외 목록에 있는가"를 강제하는 테스트가 없다 — 을 메워야 한다. `AutoConfiguration.imports`에 등재된 클래스가 `@Import`하는 모든 `@Configuration`의 패키지가 제외 정규식에 매칭되는지 검사하는 ArchUnit 규칙이면 충분하다. +- **반론과 재반박**: 반론 — "Spring이 `@Import`로 이미 등록될 클래스를 스캔으로 중복 등록하면 그냥 같은 빈 정의로 덮어써질 뿐 아닌가?" 아니다. 게이트가 닫혀 있으면 `@Import` 경로 자체가 실행되지 않으므로 "덮어쓸 원본"이 없고, 스캔이 등록한 정의만 남는다. 게이트가 열려 있으면 같은 클래스라 정의가 하나로 합쳐져 문제가 없다 — 즉 **켠 상태에서는 멀쩡하고 끈 상태에서만 깨진다**. 그래서 개발자가 `APP_HTTPCLIENT_ENABLED=true`로 로컬 확인을 하면 절대 안 보인다. +- **미검증 표시**: 빌드를 못 돌렸으므로 "기동 실패"는 추론이다. 판정 명령: `cd src && ./gradlew :app-bootstrap:systemTest --tests '*FiveAdapterOffInventoryTest*' --console=plain`. 이 테스트가 `@BeforeAll`의 `shippedComposition("local").run(allOffArguments())`에서 `UnsatisfiedDependencyException: httpClientRuntimeRegistry`로 죽으면 확정이다. 초록이면 내 추론이 틀렸고, 왜 스캐너가 그 패키지를 건너뛰었는지가 답이다. 최소한 §5-C1-1(빈이 생긴다)만큼은 정적으로 확실하다. + +--- + +### High + +#### H1. 리액티브 프로필에는 서킷 브레이커·레이트 리미터·벌크헤드가 없다 — README는 있다고 쓰여 있다 + +- **현상**: `api: WEB_CLIENT` 프로필은 물리 시도가 `AttemptResiliencePipeline`을 **통과하지 않는다**. +- **근거**: + - README 주장: `httpclient/README.md:44` — "Every physical attempt passes Circuit Breaker → Rate Limiter → Bulkhead, and holds no permit while a backoff waits." + - 블로킹: `restclient/BlockingClientRuntime.java:35` 필드 보유, `restclient/BlockingAttemptExecutor.java:62-63`에서 `runtime.resiliencePipeline().execute(...)`로 감싼다. + - 리액티브: `webclient/ReactiveClientRuntime.java:28-37` 필드 목록에 `AttemptResiliencePipeline`이 **없다**. `webclient/ReactiveAttemptExecutor.java:52`는 `Mono.defer(...)`로 바로 요청을 만든다. + - 전수 grep: `resiliencePipeline` 심볼이 main에서 `resilience/AttemptResiliencePipeline.java`, `restclient/BlockingClientRuntime.java`, `restclient/RestClientRuntimeFactory.java`, `restclient/BlockingAttemptExecutor.java` 4파일에만 등장. + - 즉 리액티브에 남는 것은 `LogicalAdmissionLimiter`(논리 호출 수 상한)와 `RetryBudget`뿐이다. +- **왜 문제인가**: 실패 중인 업스트림을 `WEB_CLIENT` 프로필로 호출하면 브레이커가 절대 열리지 않는다. 구체적 시나리오: 리액티브 프로필로 502를 계속 받는 업스트림 → 매 호출이 소켓까지 나간다 → 블로킹 프로필의 동일 업스트림은 브레이커가 막아주는데 리액티브는 안 막아준다. 같은 플랫폼 안에서 API 선택이 안전 속성을 바꾼다. +- **수정 방향**: 단기 — README:44와 CLAUDE.md의 주장을 "블로킹 스택에 한한다"로 정정하고, `ClientProfileValidator`에 "WEB_CLIENT 프로필은 resilience 미지원"을 명시적 위반 코드로 추가하거나 최소한 actuator 리포트에 표시. 중기 — `ReactiveResiliencePipeline`(Mono 기반, permit을 `usingWhen`으로 획득/반납)을 만들어 대칭을 회복. +- **반론과 재반박**: 반론 — "리액티브는 이벤트 루프라 세마포어 벌크헤드가 의미가 다르다." 맞는 지적이고 `ReactiveClientRuntime.java:22-25` javadoc도 그걸 근거로 스레드풀 벌크헤드를 거부한다. 하지만 **서킷 브레이커와 레이트 리미터는 스레드 모델과 무관하다.** `AttemptCircuitBreaker.tryAcquirePermission()`은 논블로킹이고, 이 둘이 빠진 것은 설계 판단이 아니라 미구현이다 — 그 증거로 `ReactiveClientRuntime`은 벌크헤드 부재만 javadoc으로 정당화하고 브레이커/리미터 부재는 언급조차 없다. + +#### H2. 리액티브 경로는 `timeout.total-call`을 강제하지 않는다 + +- **현상**: `Deadline`을 계산해서 `RetryContext`에 넣지만, 그 데드라인으로 호출을 **끊는 코드가 없다**. +- **근거**: + - 블로킹: `restclient/DefaultGenericHttpGateway.java:89`(호출 시작 전)와 `:191-197`(매 시도 전, `requireTimeRemaining` + `requireAttemptBudget`). + - 리액티브: `webclient/DefaultReactiveHttpGateway.java:118-125`에서 `deadline`을 계산하고, `ReactiveGatewayCall.attempt(int)`(`:246-262`)에는 어떤 가드도 없다. `webclient/` 전체에서 `DeadlineGuard` import 0건(전수 grep). `.timeout(` 호출은 SSE 게이트웨이 2곳(`DefaultReactiveSseGateway.java:81`, `:142`)뿐. + - 남는 방어는 Netty 레벨의 `responseTimeout(responseHeader)` + write/read idle 핸들러뿐(`reactor/ReactorHttpClientFactory.java:43`, `:53-63`). +- **왜 문제인가**: 업스트림이 `readIdle`(기본 3s)보다 자주 바이트를 조금씩 흘려보내면 리액티브 호출은 `totalCall`(기본 4s)을 넘겨 무한정 지속된다. 블로킹 프로필은 같은 상황에서 `HttpDeadlineExceededException`으로 끊긴다. 호출자가 `operation.deadline()`으로 부모 예산을 넘겨줘도 리액티브에서는 무시된다. +- **수정 방향**: `runCall`이 반환하는 Mono에 `.timeout(deadline.remaining(clock), Mono.error(new HttpDeadlineExceededException(...)))`를 걸고, `attempt(n)` 진입 시 `DeadlineGuard.requireTimeRemaining`을 호출. +- **반론과 재반박**: 반론 — "Reactor에서 `.timeout()`은 취소를 유발해 연결 정리가 미묘해진다." 사실이지만 이 leaf는 이미 취소 경로를 갖추고 있다(`ReactiveStreamingGateway`의 `doOnDiscard`, `ReactorFailureClassifier`의 `CancellationException` 처리, `ReactiveStreamingLifecycleTest.cancellationReleasesTheConnectionForTheNextCall`). 정리 비용이 아니라 미구현이다. + +#### H3. `http.client.requests`를 포함한 시도 단위 메트릭 5종을 아무도 발행하지 않는다 — 그리고 그걸 막으려고 쓴 테스트가 통과한다 + +- **현상**: `AttemptObservation`이 실행 경로에서 **한 번도 생성되지 않는다.** +- **근거**: + - `observation/AttemptObservation.java:38` `public static AttemptObservation start(...)` — main 전수 grep 결과 호출자 0건. `AttemptObservation` 심볼이 main에 등장하는 곳은 자기 자신과 `LogicalCallObservation`뿐이고, 후자는 `static toTags()` 헬퍼만 쓴다(`LogicalCallObservation.java:61, 67, 73, 84`). + - 따라서 발행되지 않는 이름: `ATTEMPT_TIMER`=`http.client.requests`, `ATTEMPT_COUNTER`, `TIMEOUT`, `REQUEST_BYTES`, `RESPONSE_BYTES` (`observation/HttpClientObservationNames.java:12, 14, 18, 19, 20`). + - `http.client.requests`는 "기존 대시보드가 계속 동작하도록 Spring 표준 이름을 유지했다"고 설계상 특별히 언급된 이름이다(`HttpClientObservationNames.java:6-8`, README·support-matrix). + - **방어 테스트가 무력하다**: `test/.../observation/DeclaredMetricsAreEmittedTest.java:70`은 소스 텍스트에서 `HttpClientObservationNames.` 문자열 출현 횟수를 센다. 이 5개는 `AttemptObservation.java` 안에 문자열로 존재하므로 카운트 ≥ 1 → 통과. 테스트가 잡으려던 실패("이름은 있는데 아무도 안 낸다")가 **한 단계 위에서 그대로 재현**된다. + - `TransportLifecycleListener`도 기본 빈이 `noop()`이므로(`autoconfigure/HttpClientTransportAutoConfiguration.java:39-43`) 풀/스테이지 콜백은 애초에 아무 데도 안 간다. +- **왜 문제인가**: 운영자가 `http.client.requests{clientName=...}`로 대시보드를 만들면 영원히 0이다. `DefaultGenericHttpGatewayTest.recordsSeparateLogicalAndAttemptMetrics`라는 이름의 테스트가 있지만 실제로는 `LOGICAL_CALL_TIMER`만 단언한다(`test/.../restclient/DefaultGenericHttpGatewayTest.java:148-154`) — 이름이 하지 않는 일을 주장한다. +- **수정 방향**: `BlockingAttemptExecutor.execute` / `ReactiveAttemptExecutor.execute`에서 `AttemptObservation.start(...)` → `stop(...)`으로 감싼다. 그리고 `DeclaredMetricsAreEmittedTest`를 "텍스트 참조"가 아니라 "실제 호출 후 `SimpleMeterRegistry`에 이름이 존재하는가"로 바꾼다 — 통합 단언 하나면 된다. +- **반론과 재반박**: 반론 — "시도 단위 메트릭은 카디널리티가 높아 일부러 껐을 수 있다." 그렇다면 `NOT_YET_EMITTED` 목록(`:40-53`)에 이유와 함께 올렸어야 한다. 그 목록은 정확히 그 용도로 만들어졌고 8개가 이미 올라가 있다. 5개가 거기 없다는 것은 의도가 아니라 누락이라는 뜻이다. + +#### H4. 트레이스·상관관계 전파가 전혀 구현돼 있지 않고, 헤더 정책이 caller의 우회까지 막는다 + +- **현상**: 아웃바운드 요청에 `traceparent`, `tracestate`, `X-Request-Id`, `X-Correlation-Id` 중 무엇도 실리지 않는다. 그리고 호출자가 직접 넣는 것도 거부된다. +- **근거**: + - `security/HeaderPolicy.java:31-33` — `traceparent`, `tracestate`, `baggage`가 `PLATFORM_OWNED`. `:70-72`에서 caller가 넣으면 `HttpTargetRejectedException`. + - 그런데 플랫폼이 이 헤더를 **쓰는 코드가 없다**: main 전수 grep에서 `traceparent`/`tracestate`/`baggage`는 위 3줄이 유일한 출현. `MDC`, `ObservationRegistry`, `Propagator`, micrometer-tracing 의존 모두 0건. + - `HttpFailureMetadata.traceId`는 항상 `Optional.empty()`로만 생성된다(`api/error/HttpFailureMetadata.java:55, 76` — `startup()`/`validation()` 둘 다, 그리고 `with*` 메서드가 그대로 나른다). + - `SafeHttpLogEvent`(`observation/SafeHttpLogEvent.java`)는 main에서 생성 지점 0건. 그리고 **main 전체에 slf4j `Logger` 선언이 0건** — `build.gradle:68`에 `org.slf4j:slf4j-api`를 선언해 놓고 이 플랫폼은 로그를 한 줄도 남기지 않는다. + - 레지스트리 대조: `docs/registries/mdc-keys.yaml`의 `trace_id`는 `http_header_mapping: traceparent`, `propagation: [http, async, message]`, `request_id`는 `X-Request-Id`로 선언돼 있다. `docs/registries/headers.yaml:139-149` `traceparent` `direction: both`, `generated_if_missing: true`, `required_test: contract-verification:trace-propagation`. + - `DynamicTargetSettings.tracePropagation`(`autoconfigure/HttpClientPlatformSettings.java:147`)은 바인딩되고 `DynamicTargetPolicy.tracePropagation`(`dynamic/DynamicTargetPolicy.java:20`)에 저장되지만 **읽는 코드가 없다.** +- **왜 문제인가**: 이 스켈레톤은 MDC/트레이스 계약을 레지스트리로 SSOT화해 놓았는데, 유일한 아웃바운드 HTTP 경로가 그 계약을 지키지 않는다. fork 사용자는 인바운드 요청에 붙은 `trace_id`가 아웃바운드 호출로 이어질 거라 가정할 것이고, 실제로는 스팬이 끊긴다. 게다가 `HeaderPolicy`가 caller 우회를 막으므로 **애플리케이션 코드로 임시 조치할 수도 없다.** +- **수정 방향**: 이 leaf의 정책과 일관되게 처리하면 된다 — `ClientProfileValidator.validateUnsupportedSettings`(`profile/ClientProfileValidator.java:103-116`)가 이미 "바인딩되지만 아무 전송에도 닿지 않는 설정은 거부한다"는 규칙을 `timeout.dns`, `proxy.credential-provider`, `proxy.import-ambient-no-proxy` 3개에 적용하고 있다. `dynamic-targets[*].trace-propagation=true`는 **같은 종류인데 거부되지 않는다.** 최소 조치는 그것을 같은 목록에 넣는 것이고, 제대로 된 조치는 `PreparedOperation` 조립 시 현재 Observation/MDC에서 `traceparent`/`X-Request-Id`를 주입하는 것이다. +- **반론과 재반박**: 반론 — "트레이싱은 `app-bootstrap`의 `bootstrap.autoconfigure.tracing`이 소유하고, 여기서 하면 중복이다." 그렇다면 `HeaderPolicy`가 그 헤더들을 `PLATFORM_OWNED`로 선언해 caller를 막을 이유가 없다. 지금 상태는 "내가 소유한다"고 선언하고 소유물을 방치한 것이라, 어느 계층이 하든 지금은 아무도 안 하고 있다. + +#### H5. Dynamic Target 정책은 같은 이름의 client 프로필을 암묵적으로 요구하고, 없으면 첫 호출에서 `NoSuchElementException`이 난다 + +- **현상**: `app.httpclient.dynamic-targets[0].name=webhooks`만 선언하고 `clients[*].name=webhooks`(mode=DYNAMIC)를 선언하지 않으면 기동은 성공하고 첫 호출에서 터진다. +- **근거**: + - `dynamic/DefaultDynamicTargetGateway.java:82` — `runtimes.acquire(new ClientProfileName(policyName.value()))`. 정책 이름을 그대로 프로필 이름으로 쓴다. + - `profile/ClientRuntimeRegistry.java:161-167` — 없으면 `NoSuchElementException("unregistered http client profile: ...")`. 이건 안정 예외 계층(`HttpClientException`)이 아니라 raw JDK 예외다. + - 기동 검증(`autoconfigure/HttpClientStartupValidator.java:59-93`)은 profiles만 돈다. `DynamicTargetAutoConfiguration`(`:30-50`, `:65-81`)에도 교차 검사 없음. + - `mode: DYNAMIC` + `api: WEB_CLIENT` 조합도 같은 모양으로 깨진다 — `requireBlockingRuntime`이 호출 시점에 `HttpTargetRejectedException`을 던진다(`DefaultDynamicTargetGateway.java:220-227`). `ClientProfileValidator`는 DYNAMIC+JDK/JETTY는 거부하지만(`profile/ClientProfileValidator.java:173-177`) DYNAMIC+WEB_CLIENT는 통과시킨다. +- **왜 문제인가**: 이 플랫폼의 설계 원칙은 "설정 실수는 기동에서 잡는다"인데(30개 넘는 위반 코드가 그 증거), H3 표면에서만 그 원칙이 깨진다. SSRF 검증이 필요한 경로라 프로덕션 첫 요청에서 터지면 영향이 크다. +- **수정 방향**: `HttpClientStartupValidator.validate`에 `dynamicTargets`를 넘기고, 각 정책 이름에 대해 (a) 동명 프로필 존재, (b) `mode == DYNAMIC`, (c) `api == REST_CLIENT`를 검사해 `DYNAMIC_TARGET_PROFILE_MISSING` 같은 안정 코드로 실패시킨다. +- **반론과 재반박**: 반론 — "`HttpClientPlatformActivationTest.java:193` `aDynamicTargetPolicyIsRegisteredUnderItsOwnName`이 이미 커버한다." 그 테스트는 **정상 케이스**(둘 다 선언한 경우)만 확인한다. 누락 케이스의 기동 실패를 단언하는 테스트는 없다. + +#### H6. 같은 날 `SecretSourcePort`를 만들어 놓고 httpclient는 그걸 쓰지 않는다 — 인증 프로필은 첫 호출에서 터진다 + +- **현상**: httpclient의 시크릿 해석은 `Function httpClientSecretResolver` 빈 하나로 되어 있고, 저장소 전체에서 이 빈을 제공하는 유일한 구현이 **무조건 예외를 던진다.** +- **근거**: + - 기본 구현: `autoconfigure/HttpClientAuthenticationAutoConfiguration.java:36-43` — `@ConditionalOnMissingBean(name="httpClientSecretResolver")`, 본문은 `throw new CapabilityStartupValidationException("no http client secret resolver is configured for reference '" + reference + "'")`. + - 전수 grep: `httpClientSecretResolver` 심볼은 저장소 전체에서 이 leaf 안 2개 파일에만 등장한다(`HttpClientAuthenticationAutoConfiguration`, `DynamicTargetAutoConfiguration:73,80`). **오버라이드 빈을 제공하는 코드가 어디에도 없다** — `app-bootstrap`에도, `sample-portfolio`에도. + - 그런데 같은 워킹트리에 제대로 된 시크릿 포트가 **방금 생겼다**: `application-core/.../application/outbound/SecretSourcePort.java`(신규), `adapter/outbound/support/.../EnvironmentSecretSource.java:9`(신규, untracked), `app-bootstrap/.../runtime/SecretSourceFactory.java:17`이 `ENVIRONMENT` 전략으로 선택. 소비자는 Redis 계열 4개 클래스뿐이다(`RedisKeys`, `RedisCacheConfig`, `RedisCapabilityConfig`, `SecretSourceValidator`). + - httpclient가 이걸 쓰지 못할 구조적 이유는 없다 — `httpclient/build.gradle:20,22`가 `application-core`와 `adapter:outbound:support`를 이미 의존하고, `modules.json`의 `adapter-outbound-httpclient.allowed_dependencies`가 둘 다 허용한다. +- **왜 문제인가**: `authentication.type`이 `BASIC`/`API_KEY_HEADER`/`API_KEY_QUERY`/`STATIC_BEARER` 중 하나인 프로필은 기동에 성공하고 **첫 요청에서** 터진다. 시크릿 해석이 요청 경로에서 일어나기 때문이다 — `auth/BasicCredentialProvider.java:50` `secretResolver.apply(reference)`, `auth/StaticBearerCredentialProvider.java:38`, `auth/ApiKeyHeaderCredentialProvider.java:57`. H3 다이나믹 타깃의 `DynamicCredentialBinding` 시크릿도 같다(`dynamic/DefaultDynamicTargetGateway.java:186`). + - 더 나쁘게, 던지는 타입이 `CapabilityStartupValidationException`이다. 그 클래스의 javadoc은 *"Configuration failure raised by an optional capability **before it can start**"*이고 `ExitCodeGenerator`로 exit 78을 선언한다(`support/.../CapabilityStartupValidationException.java:12-28`). 요청 스레드에서 던져진 `ExitCodeGenerator`는 아무 일도 하지 않는다 — 의도한 실패 계약(기동 실패 + exit 78 + 구조화 로그)이 통째로 무효가 되고, 대신 안정 예외 계층(`HttpClientException`)에도 속하지 않는 예외가 게이트웨이 밖으로 새어 나간다. +- **수정 방향**: `HttpClientAuthenticationAutoConfiguration`이 `SecretSourcePort`를 주입받아 기본 리졸버로 삼는다(`port.resolve(ref).orElseThrow(...)`). 최소 조치로는 `HttpClientStartupValidator`에 "credential을 붙이는 authentication type인데 오버라이드 리졸버 빈이 없다"를 기동 위반으로 추가해, 첫 호출이 아니라 기동에서 실패시킨다. +- **반론과 재반박**: 반론 — "시크릿 백엔드는 배포가 정하는 것이고, 플랫폼이 강제로 env를 읽으면 Vault 같은 백엔드를 쓰는 배포를 막는다." 맞는 원칙이고 `HttpClientAuthenticationAutoConfiguration.java:24-26` javadoc도 그렇게 쓴다. 하지만 그 원칙을 만족시키는 추상이 **바로 옆에 방금 생겼고**(`SecretSourcePort` — 백엔드 선택은 `SecretSourceFactory`가 하고 포트는 프레임워크 무관), 그걸 쓰면 원칙을 지키면서 기본값도 동작한다. 지금 상태는 원칙을 지킨 게 아니라 두 슬라이스가 같은 날 같은 워킹트리에 들어오면서 접합부를 안 만든 것이다. + +#### H7 (원래 M2에서 상향). S3 제공자 3,581줄은 실 스토어에 대고 한 번도 검증된 적이 없는데, 설정 한 줄이면 프로덕션에 붙는다 + +- **근거**: `docs/registries/object-storage-readiness.yaml`의 claim 9개 전부 `provider_type: filesystem-local-dev`. 소유 테스트도 `KNOWN_PROVIDERS = Set.of("filesystem-local-dev")`로 고정(`test/.../readiness/ObjectStorageReadinessRegistryTest.java:23`). 반면 `s3` 패키지는 3,581줄이고 `S3ObjectStorageProviderContribution`이 항상 빈으로 등록된다(`config/ObjectStorageCapabilityConfig.java:33-36`). +- **왜 문제인가**: `objectstorage/CLAUDE.md:44`의 Forbidden이 "`docs/registries/object-storage-readiness.yaml`의 정확한 행을 넘어서는 주장"을 금지한다. `type: aws-s3-general-purpose`로 배포하는 것은 정의상 행이 0개인 주장인데, 기동 시 이를 막는 코드가 없다. `ObjectStorageBindingCompiler`는 프로파일/증거 검증은 하지만(`config/ObjectStorageBindingCompiler.java:179-191`) readiness 레지스트리는 읽지 않는다. +- **수정 방향**: 둘 중 하나. (a) S3/MinIO 카드를 레지스트리에 (R0이어도) 추가하고 `KNOWN_PROVIDERS`를 확장, (b) `ObjectStorageBindingCompiler`가 선택된 `providerType`에 해당하는 카드가 레지스트리에 존재하는지 기동 시 확인. README:61-62가 "legacy S3/MinIO adapter ... advances no S3 readiness card"라고 쓰고 있지만, 이 문장은 **레거시** 어댑터 얘기지 `s3/` 패키지의 새 제공자 얘기가 아니다 — 그 자체가 문서 모호성이다. +- **반론과 재반박**: 반론 — "S3 제공자는 아직 아무 데도 배선되지 않았으니 실질 위험이 없다." 배선은 설정 한 줄(`providers.x.type`)이고, 코드는 그 한 줄을 받으면 완전히 동작한다. "아직 안 쓴다"는 레지스트리가 보장해야 할 것을 우연에 맡기는 것이다. +- **테스트 전수 독파 후 상향(§1.3)**: 처음엔 "레지스트리 카드가 없다"는 문서 문제로 봤다. 7개 qualification/integration 테스트를 본문으로 읽고 나니 문서 문제가 아니다. + - AWS qualification 레인 2개는 **환경변수 존재만 단언**한다. S3 클라이언트를 만들지 않는다(`qualification/AwsS3ManagedCommonSubsetQualificationTest.java:12-25`, `AwsS3DirectTransferQualificationTest.java:12-22`). 레인 이름이 약속하는 "AWS 적격성"을 하나도 보증하지 않는다. + - MinIO "contract/fault"로 이름 붙은 4개 중 2개(`MinioDirectTransferContractTest.java`, `MinioDirectTransferFaultTest.java`)는 **체크인된 JSON 문자열을 단언**할 뿐 MinIO를 띄우지 않는다. 그런데 `objectstorage/build.gradle:70-94`는 이 둘을 각각 *"Runs the non-skipping exact-release MinIO managed object contract"*, *"digest-pinned MinIO/Toxiproxy fault contract"* 레인으로 설명한다 — 레인 설명과 테스트 본문이 어긋난다. + - 진짜 MinIO를 띄우는 2개(`MinioManagedObjectContractTest.java`, `MinioManagedObjectFaultTest.java`)는 **raw AWS SDK `S3AsyncClient`를 직접 드라이브**한다. 이 leaf의 `S3ManagedObjectProvider`/`S3ConditionalObjectControlStore`/`S3ManagedMultipartProvider`를 통과하지 않는다. + - 남은 `S3ObjectStorageAdapterIT.java`는 **deprecated 레거시** 어댑터를 검증한다. + - 결정타: 스킵 없는 제공자 계약 `contract/ObjectStorageProviderContract.java`(247줄)를 **상속하는 클래스는 `LocalDevObjectStorageProviderTest` 하나뿐이다**(전수 grep). s3 테스트들은 그 계약의 `static operation()`/`producer()` 헬퍼만 빌려 쓴다. + - 그리고 저장소 자신의 측정 결과가 MinIO를 배제한다 — `integrationTest/resources/object-storage/minio-provider-evidence.json`: `"status": "UNSUPPORTED"`, *"PutObject If-None-Match was accepted and overwrote an existing object"*, *"CompleteMultipartUpload accepted If-None-Match despite a pre-existing target and overwrote it"*. 이 leaf의 불변 생성과 제어 CAS가 딛고 선 원시 연산이다. +- **상향 이유**: "카드가 없다"가 아니라 **"실 스토어 검증이 0이고, 유일하게 돌려본 호환 스토어는 핵심 원시 연산을 지키지 않는다고 저장소 자신이 기록해 두었다"**이다. 그 상태에서 `providers.x.type=aws-s3-general-purpose` 한 줄로 프로덕션 경로가 열린다. fork 사용자가 "S3 지원됨"으로 읽을 표면(README, `s3/` 패키지 크기, `S3ProviderQualifier`)은 충분히 크다. +- **설계가 정직한 부분은 인정해야 한다**: 바인딩 단이 MinIO의 direct 능력 주장을 거부하고(`S3ProviderBindingTest.java:56-64`), MinIO 프로필 증거를 `UNSUPPORTED`로 고정하며(`:354-369`), readiness 검증기가 `filesystem-local-dev` 외 provider_type을 unknown으로 거부한다(`readiness/ObjectStorageReadinessRegistryTest.java:23, 82-91`). 즉 **과대 주장은 막혀 있다.** 막혀 있지 않은 것은 "검증되지 않은 제공자로 실제 배포하는 것"이다. + +#### Q3. H1~H6을 166개 테스트가 왜 못 잡았는가 — 한 줄씩 + +테스트 전수 독파 후 확정. 공통 패턴은 하나다: **부품은 직접 생성해 검증하고, 그 부품이 실행 경로에 연결됐는지는 아무도 안 본다.** + +| 발견 | 왜 못 잡았나 | 근거 | +|---|---|---| +| **H1** 리액티브에 브레이커·리미터·벌크헤드 없음 | `CircuitBreaker` 심볼이 테스트 166개 중 **픽스처 1개**(`testFixtures/.../RecordingResilienceComponents.java`)에만 등장한다. 브레이커가 열리는지를 게이트웨이를 통해 단언하는 테스트가 0개이고, 같은 시나리오를 블로킹/리액티브 양쪽에 돌려 대칭을 확인하는 테스트도 0개다 | `resilience/AttemptResiliencePipelineTest.java`는 파이프라인을 직접 생성해 검증한다 — 파이프라인이 리액티브 런타임에 **연결돼 있지 않다는 사실**은 이 테스트의 시야 밖이다 | +| **H2** 리액티브가 `timeout.total-call`을 강제 안 함 | `HttpDeadlineExceededException`이 테스트 166개 중 **`resilience/DeadlineCalculatorTest.java` 1개**에만 등장한다. 그것도 순수 계산 단위 테스트다. 게이트웨이를 통해 데드라인 초과를 단언하는 테스트는 블로킹에도 리액티브에도 없다 | 반대로 `webclient/ReactiveSseGatewayTest.closesSilentStreamAtStreamingIdleTimeout`은 초록이라 "리액티브 타임아웃이 검증됐다"처럼 보인다 — 그건 SSE 게이트웨이 전용 `.timeout()`이지 `total-call`이 아니다 | +| **H3** 시도 단위 메트릭 5종 미발행 | 방어 테스트가 **소스 텍스트를 센다**: `test/.../observation/DeclaredMetricsAreEmittedTest.java:70` `countOccurrences(platformSources, "HttpClientObservationNames." + name)`. `readPlatformSources()`(`:107-119`)가 `main/java`의 모든 `.java`를 이어붙이므로, 이름이 `AttemptObservation.java` 안에 문자열로 존재하기만 하면 통과한다 | 보강 3건: ① `observation/HttpClientTagPolicyTest.java:47`이 `AttemptObservation.start(...)`를 **테스트에서 직접 호출**해 클래스에 커버리지를 만든다(프로덕션 호출자는 0건) ② `restclient/DefaultGenericHttpGatewayTest.java:137-156` `recordsSeparateLogicalAndAttemptMetrics`는 이름과 달리 `LOGICAL_CALL_TIMER`만 단언한다 ③ `testFixtures/.../ObservabilityContract.java:62-63`은 서로 다른 두 상수가 다르다는 **동어반복**으로 끝난다 | +| **H4** 트레이스·상관관계 전파 미구현 | **`traceparent` 문자열이 테스트 166개 중 0개 파일에 등장한다.** 아웃바운드 요청에 그 헤더가 실리는지 확인하는 테스트가 아예 존재하지 않는다 | 있는 것은 반대 방향뿐이다 — `security/TrustedRequestPolicyTest.java:49-55`는 caller가 플랫폼 소유 헤더를 넣으면 거부됨을 단언한다. 거부 테스트가 초록이면 "헤더 정책이 검증됐다"로 읽히지만, 플랫폼이 그 헤더를 **넣는지**는 누구도 묻지 않았다 | +| **H5** Dynamic Target이 동명 프로필을 암묵 요구 | `autoconfigure/HttpClientPlatformActivationTest.java:193`이 **정상 케이스만** 단언한다(둘 다 선언). 누락 케이스에서 기동이 실패해야 한다는 단언이 없고, `UnsafeStartupConfigurationTest`의 거부 목록에도 이 조합이 없다 | 첫 호출에서 터지는 결함은 `ApplicationContextRunner` 계열이 구조적으로 못 본다 — 러너는 컨텍스트를 만들고 끝나지 호출을 하지 않는다 | +| **H6** `SecretSourcePort`를 안 쓰고 인증 프로필은 첫 호출에서 터짐 | **테스트가 결함 직전에서 멈춘다.** `autoconfigure/ReactiveAuthenticationContractTest.java:62-63`이 `authentication.secret-reference=secret://env/EVENTS_TOKEN`을 설정하고 `assertThat(context).hasNotFailed()` 하나만 단언한다. H6이 말하는 그대로다 — "기동은 된다". 그 다음 한 줄(요청 보내기)이 없어서 "첫 호출에서 터진다"가 드러나지 않는다 | 같은 파일 `:41`도 `hasNotFailed()`뿐이다. 시크릿 참조를 실제로 해석하는 경로를 타는 테스트는 166개 중 0개다 | + +--- + +#### H8. SSRF 방어의 "핀을 실제 소켓에 강제하는" 두 클래스는 테스트 참조가 0건이고, 어떤 하네스도 그 경로를 배선하지 않는다 + +- **현상**: DNS 재바인딩 방어의 마지막 한 칸 — 검증된 IP로 소켓을 고정하는 부분 — 이 어떤 테스트에서도 실행되지 않는다. +- **근거**: + - 전수 grep: `ValidatedAddressResolverGroup`(Reactor Netty 측), `ApacheDnsResolverFactory`(Apache 측) 두 심볼이 테스트 166개 중 **0개 파일**에 등장한다. main에서는 각각 `reactor/ReactorHttpClientFactory.java:66`, `apache/ApacheClientFactory.java:62-63`이 쓴다. + - 하네스가 배선하지 않는다: `testFixtures/.../TestGateways.java:67-68`이 `new ApacheBlockingTransportProvider()` / `new JdkBlockingTransportProvider()`를, `ReactiveTestGateways.java:58`이 `new ReactorNettyTransportProvider()`를 **무인자 생성자**로 만든다. 그 생성자는 `this(Optional.empty(), profile -> Optional.empty(), profile -> Optional.empty())`다(`ApacheBlockingTransportProvider.java:46-48`, `ReactorNettyTransportProvider.java:44-46`) — 즉 `tlsMaterialResolver`와 `resolverFactory`가 **둘 다 빈 값**이다. 그래서 `ApacheClientFactory`는 `orElseGet(ApacheDnsResolverFactory::systemDefault)`로 떨어진다. + - 검증되는 것: `dynamic/DynamicTargetSecurityTest.java`와 `testFixtures/.../DynamicTargetSecurityContract.java`가 정규화·IP 분류·모든 답변 검증·`CallScopedDnsPin`을 **부품 단위로** 촘촘히 검증한다. 좋은 테스트다. 다만 "핀이 실제 커넥션 팩토리를 통해 소켓에 적용되는가"는 그 밖이다. +- **왜 문제인가**: SSRF 방어에서 실무상 가장 자주 깨지는 지점이 정확히 여기다(검증은 통과했는데 재해석된 주소로 연결). 위쪽 전부가 초록이므로 이 구멍은 계측되지 않는다. +- **수정 방향**: `TestGateways.forProfile`에 resolverFactory를 넘길 수 있게 하고, 계약 테스트 하나를 추가한다 — 검증 단계에서 A를 반환하고 연결 단계에서 B(내부 IP)를 반환하는 리졸버를 주입해 **연결이 A로 갔음**을 단언한다. 지금 하네스 구조로는 그 테스트를 쓸 수조차 없다는 점이 더 큰 문제다. +- **반론과 재반박**: 반론 — "핀 자체가 검증됐으면 충분하다." 아니다. 이 leaf는 같은 종류의 실패(부품은 맞는데 경로에 연결 안 됨)를 H1·H3에서 이미 두 번 냈다. 그 실패 유형이 반복되는 저장소에서 "연결됐을 것"은 근거가 아니다. + +#### H9. `integrationTest` 레인의 유일한 실패주입 계약이 사실상 동어반복이다 + +- **근거**: `httpclient/src/integrationTest/.../contract/FailureInjectionContractTest.java:77-80` — Toxiproxy로 실패를 주입한 뒤 증거를 `isIn(NOT_SENT, SENT_NO_RESPONSE, PARTIAL_RESPONSE)`로 단언한다. `ExecutionEvidence`의 값은 이 셋 + `RESPONSE_RECEIVED` 네 개뿐이다. 실패한 호출에서 `RESPONSE_RECEIVED`가 아닌 것은 정의상 자명하다. +- **왜 문제인가**: 이 leaf의 재시도 안전성 전체가 "증거를 **정확히** 분류한다"에 걸려 있다(`AttemptStage.provesNotSent` → 재시도 허용). 그 분류가 맞는지를 실제 네트워크 실패로 확인하는 유일한 자리인데, 어떤 값이 나와도 통과한다. 예컨대 연결 거부가 `SENT_NO_RESPONSE`로 잘못 분류되면 비멱등 요청이 재시도되지 않아야 하는데도 안전 판정이 뒤집힌다 — 이 테스트는 그걸 못 잡는다. +- **수정 방향**: 주입한 결함 종류별로 기대 증거를 **정확히 하나** 단언한다(연결 거부 → `NOT_SENT`, 응답 중 절단 → `PARTIAL_RESPONSE`). + +--- + +### Medium + +#### M1. objectstorage는 프로덕션 컴포지션 루트에 연결돼 있지 않은데, 부트스트랩은 연결된 것처럼 선언해 놓았다 + +- **근거**: `src/config/architecture/modules.json`의 `app-bootstrap.allowed_dependencies` 15개에 `adapter-outbound-objectstorage` 없음. `app-bootstrap/build.gradle`에 해당 project 의존 없음. 유일 소비자는 `sample-portfolio/build.gradle:54`(`runtimeOnly`). +- **그런데** `CaSkeletonApplication.java:75`의 `@ConfigurationPropertiesScan` basePackages에 `"dev.caskeleton.adapter.outbound.objectstorage"`가 들어 있다. 클래스패스에 없으니 무해하지만, **컴포지션 루트가 이 leaf를 소유한다고 선언**하면서 빌드는 그렇지 않은 드리프트다. +- **영향**: fork 사용자가 README("Activation and routing ... `app.object-storage`")를 읽고 `APP_OBJECT_STORAGE_ENABLED=true`류를 찾다가 부트스트랩에 `objectstorage.yml`도, gradle 의존도 없다는 걸 나중에 발견한다. +- **수정 방향**: 둘 중 하나. (a) `modules.json` + `app-bootstrap/build.gradle` + `config/objectstorage.yml`을 추가해 실제로 편입, (b) `@ConfigurationPropertiesScan`에서 그 줄을 제거하고 README에 "샘플 전용 / 편입은 fork의 몫"이라고 명시. + +#### M3. 서킷 브레이커·레이트 리미터가 Resilience4j 기본값 고정이고 설정 surface가 없다 + +- **근거**: `resilience/ResilienceRegistry.java:36-39` — `CircuitBreakerRegistry.ofDefaults()`, `RateLimiterRegistry.ofDefaults()`. `restclient/RestClientRuntimeFactory.java:133-142`가 프로필 이름으로 조회만 한다. `HttpClientPlatformSettings`(242줄)에 breaker/limiter/bulkhead 필드가 **하나도 없다** — `Pool`, `Timeout`, `Redirect`, `Request`, `Response`, `Authentication`, `Retry`, `Observability`, `Tls`, `Proxy`가 전부다. +- **결과**: + - 브레이커: Resilience4j 기본 `minimumNumberOfCalls=100`, `slidingWindowSize=100`. 초당 1회 호출하는 업스트림은 100번 실패할 때까지 절대 안 열린다. `waitDurationInOpenState=60s`도 조정 불가. + - 레이트 리미터: 기본 `limitForPeriod=50 / 500ns` — 사실상 무제한이라 **비용만 있고 효과가 없다**. 더 나쁜 것은 `AttemptRateLimiter.resilience4j`가 `delegate.acquirePermission(1)`을 쓴다는 점(`resilience/AttemptRateLimiter.java:26-28`). 이 호출은 기본 `timeoutDuration=5s`까지 **블로킹 대기**한다. 프로필 기본 `timeout.total-call`은 4s(`HttpClientPlatformSettings.java:173`)라, 리미터가 실제로 포화하는 설정으로 바뀌는 순간 데드라인 바깥에서 최대 5초가 소모된다. + - 벌크헤드 permit은 `pool.max-total-connections`로 유도(`RestClientRuntimeFactory.java:139`), 논리 admission은 `maxPendingAcquires + maxTotalConnections`(`:109-111`). 유도 규칙은 합리적이지만 독립 조정이 불가능하다. +- **수정 방향**: `ClientSettings`에 `resilience` 블록(브레이커 임계/윈도, 리미터 limit/period/timeout, 벌크헤드 permit)을 추가하거나, 최소한 `RateLimiter`를 `tryAcquirePermission()`(논블로킹)으로 바꾸고 현재 기본값을 문서화한다. +- **반론과 재반박**: 반론 — "기본값으로 충분하고, 설정 표면을 늘리면 오설정이 늘어난다." 이 leaf의 다른 모든 설정은 정반대 철학을 따른다 — `Request.maxBodyBytes`는 프로덕션에서 기본값 0을 거부하고(`profile/ClientProfileValidator.java:274-276`), TLS 프로필 ID도 필수다. 유독 브레이커만 "프레임워크 기본값에 맡긴다"는 것은 일관성이 없고, actuator가 `retryPolicy`는 보여주면서 브레이커 설정은 안 보여준다(`autoconfigure/HttpClientActuatorEndpoint.java:190-199`). + +#### M4. `DirectTransferCoordinator`의 presigned 자재 캐시가 무제한이고, 다운로드 그랜트는 절대 제거되지 않는다 + +- **근거**: `direct/DirectTransferCoordinator.java:46-47` — `private final Map issued = new ConcurrentHashMap<>();`. 업로드는 `completeUpload`에서 제거(`:126`)되지만, **다운로드 경로는 `:188`에서 `put`만 하고 어디서도 `remove`하지 않는다.** TTL도, 최대 크기도 없다. +- 클래스 javadoc(`:35-37`)은 "bounded process-local replay cache"라고 쓴다. bounded가 아니다. +- **왜 문제인가**: 다운로드 그랜트 N건 발급 = presigned URI + 서명 헤더 N건이 힙에 영구 상주. 만료된 bearer 자재가 프로세스 생애 내내 메모리에 남는 것 자체가 노출면이다. +- **완화 요인**: `DirectTransferCoordinator`는 main 전체에서 참조 0건이다(전수 grep). 어떤 composition도 이걸 만들지 않는다 — `config/RoutingObjectDirectGrantAdapter.java`는 private 생성자만 있는 빈 자리표시자다. 즉 **잠재 결함**이지 현재 가동 중인 누수는 아니다. 같은 이유로 `ManagedMultipartCoordinator`, `DirectMultipartCoordinator`, `MultipartOperationResolver`, `S3ObjectOperationResolver`도 배선되지 않은 상태다(합계 약 2,000줄). +- **수정 방향**: `issued`를 `expiresAt` 기준으로 만료시키는 bounded 맵으로 바꾸고, 다운로드 경로에도 제거 시점을 정의한다. 배선 시점 전에 고치는 편이 싸다. + +#### M5. 토글을 꺼도 클래스패스는 그대로고, 그 부작용이 앱 전역 기본 RequestFactory를 바꾼다 + +- **근거**: `httpclient/build.gradle:35-37` — Apache HC5, reactor-netty-http, **jetty-client**가 전부 `implementation`(런타임). `app-bootstrap/build.gradle:114`도 `implementation`. +- HTTP/3용 jetty-http3만 `compileOnly`로 제대로 분리해 놓았고(`:45-46`, 이유도 주석에 명시), jetty-client 본체는 런타임에 남는다. 그런데 stable 경로에서 jetty-client를 쓰는 곳은 없다 — `JettyHttp3TransportProvider`뿐이고 그건 auto-config가 절대 등록하지 않는다. +- **부작용(미검증, 확인 필요)**: Spring Boot의 `ClientHttpRequestFactoryBuilder.detect()`는 클래스패스 우선순위(Apache HC5 > Jetty > Reactor Netty > JDK)로 고른다. 이 leaf를 넣는 것만으로 앱 안의 **다른 모든** `RestClient.Builder`/`RestTemplateBuilder`의 기본 팩토리가 Apache HC5로 바뀐다. `app.httpclient.enabled=false`여도 그렇다. +- **수정 방향**: 최소한 CLAUDE.md:62-63의 "빌드 포함은 별개" 문장에 이 구체적 귀결을 적는다. jetty-client는 jetty-http3와 함께 `compileOnly`로 내릴 수 있는지 검토(HTTP/3 전송만 쓰므로 가능해 보인다). +- **확인 명령**: `cd src && ./gradlew :app-bootstrap:dependencies --configuration runtimeClasspath | grep -i jetty` + +#### M6. `application-core`가 httpclient를 import하지 못하게 막는 강제 장치가 이 leaf 안에 없다 + +- **근거**: `httpclient/CLAUDE.md:54-55`가 "Application/domain code must not import this module's gateways, operation descriptors, URI types, Spring HTTP types, engine clients, retry types, or wire DTOs"라고 금지한다. 이 leaf의 ArchUnit 테스트 2종(`HttpClientModuleBoundaryTest`, `PublicApiArchitectureTest`)은 **leaf 내부 패키지 간** 규칙만 검사한다(테스트 메서드 12개 전수 확인). +- 방향이 반대라 leaf 테스트로는 원천적으로 못 잡는다 — application-core나 아키텍처 레인에 규칙이 있어야 한다. `modules.json` 의존 게이트는 `application-core`가 `httpclient`에 의존하지 못하게 하므로 **컴파일은 막힌다.** 즉 실질 위험은 낮고, 문제는 "CLAUDE.md가 이 leaf의 테스트가 지키는 것처럼 읽힌다"는 점이다. +- **수정 방향**: CLAUDE.md:54-55에 "이 규칙은 Gradle 의존 게이트가 강제한다"고 명시하거나, `architectureTest` 레인에 명시 규칙을 추가. + +#### M7. 테스트 레인 배선에 남은 구멍 + +- `httpclient/build.gradle:144-146`: `test`는 `httpclient-blockhound`만 제외한다. `httpclient-contract`(5개)·`httpclient-security`(2개) 태그 테스트는 `test`와 전용 레인에서 **두 번** 실행된다. `check`가 두 레인을 모두 부르므로(`:254-258`) 매 빌드마다 중복. +- `spring62ApiSurfaceScan` 레인은 태그 `httpclient-spring62-surface`를 쓰는데 그 태그를 단 테스트는 1개뿐이고, `test`에서도 같이 돈다. +- `objectstorage/build.gradle:70-94`: `objectStorageMinioContractTest`와 `objectStorageMinioFaultTest` 두 qualification이 **같은 `integrationTest` 소스셋**을 보게 바뀌었다. 클래스 이름으로 분리하므로 동작은 하지만, 같은 소스셋을 3개 태스크(`integrationTest` 레인 + 2개 qualification)가 각각 실행한다 — `integrationTest` 레인은 필터가 없으므로 4개 qualification 테스트를 **전부 다시** 돌린다. +- `app-bootstrap`의 `systemTest` 레인이 `check`/`ci`에 붙어 있지 않아 C1 같은 컴포지션 결함을 잡을 위치가 비어 있다. +- 그리고 전수 독파로 드러난 것: `objectStorageMinioContractTest` / `objectStorageMinioFaultTest` 레인이 지정하는 클래스 4개 중 **2개는 MinIO를 띄우지 않는다.** `qualification/MinioDirectTransferContractTest.java`(25줄)와 `MinioDirectTransferFaultTest.java`(32줄)는 체크인된 `minio-provider-evidence.json`에 `contains("\"status\": \"UNSUPPORTED\"")`를 단언할 뿐이다. 레인 설명(*"Runs the non-skipping exact-release MinIO managed object contract"*)과 본문이 어긋난다 — Docker 없이도 초록이다. +- `objectStorageAwsQualificationTest` 소스셋 2개도 같은 종류다(§1.3). 레인이 `OBJECT_STORAGE_AWS_*` 환경변수를 요구하고 그 변수의 **존재만** 확인한 뒤 끝난다. + +#### M8. 문서-코드 드리프트 (코드가 사실) + +| 문서 | 주장 | 실제 | +|---|---|---| +| `httpclient/CLAUDE.md:40-41` | testkit이 `src/testkit/java` 소스셋 | `src/testFixtures/java` (java-test-fixtures 변형). `build.gradle:1-6`의 `java-test-fixtures` 플러그인과 `:109-122`의 `testFixturesImplementation`이 정본 | +| `docs/httpclient/repository-adaptation.md:30` | 같은 주장 반복 | 동일 | +| `httpclient/build.gradle:71-73` 주석 | "the testkit source set inherits them by extending testImplementation" | 바로 아래 `:106-108` 주석이 "moving to testFixtures makes that surface explicit"이라고 그 문장을 부정한다 | +| `httpclient/CLAUDE.md:75` | 레인 이름 `spring62CompatibilityTest` | 실제 태스크명 `spring62ApiSurfaceScan` (`build.gradle:205`). `spring70CompatibilityTest`는 일치 | +| `httpclient/README.md:44` | 모든 물리 시도가 브레이커→리미터→벌크헤드 통과 | 블로킹만 (H1) | +| `docs/registries/env-keys.yaml` | object-storage 키 0건 | `app.object-storage.*` 전체 표면이 SSOT 바깥. httpclient는 `docs/httpclient/env-fields.yaml:13-21`에서 왜 분리했는지 명시적으로 설명한 반면, objectstorage는 설명도 없다 | + +--- + +### Low + +- **L1.** `dynamic/ValidatedDnsResolver.approved` 맵(`:37`)은 `CallScopedDnsPin` 도입 이후 사실상 유물이다. `resolve()`가 채우고 게이트웨이가 `forget()`으로 지우지만, 핀은 ThreadLocal로 따로 전달된다(`dynamic/DefaultDynamicTargetGateway.java:105-106`). 정상 경로에서는 정리되나 `approvedAddresses(String)` 공개 메서드는 main에서 호출자가 없다. 삭제 후보. +- **L2.** `filesystem/LocalDevObjectControlStore.locks`(`:26`)는 CAS된 키마다 모니터 객체를 하나씩 쌓고 제거하지 않는다. local-dev 전용이라 영향은 작다. +- **L3.** 레거시 `FilesystemObjectStorageAdapter.get()`이 `Files.readAllBytes`로 크기 제한 없이 읽는다(`:71`). 같은 어댑터의 `put`도 whole-`byte[]`다 — 이건 deprecated `ObjectStoragePort` 계약 자체의 성질이라 어댑터가 고칠 수 없다. 현재 유일한 상한은 Spring Boot 기본 multipart 제한(1MB)인데, 이 저장소 어디에도 `spring.servlet.multipart.*` 설정이 없으므로 **우연한 보호**다. 샘플이 실제로 이 경로를 켜 두고 있다(`sample-portfolio/.../application.yml:319-323`). +- **L4.** `webclient/DefaultReactiveSseGateway.java:123` — `credentialProvider().resolve(...).block(setupDeadline)`. 현재 등록되는 리액티브 제공자 4종은 전부 동기 계산이라 즉시 완료되지만(`autoconfigure/HttpClientAuthenticationAutoConfiguration.java:82-87`), 재접속 시 `retryWhen`이 이벤트 루프 스레드에서 재구독하면 `block()`이 루프에서 호출될 수 있다. BlockHound 레인이 SSE 재접속을 커버하는지는 미확인(`BlockHoundEventLoopTest`의 3개 테스트는 gateway·retry backoff만). +- **L5.** `resilience/Http2EvidenceMapper`는 main에서 호출자가 없다. `BlockingAttemptExecutor.java:109`가 항상 `ProtocolEvidence.none()`을 넘기므로, 설계가 약속한 "HTTP/2 REFUSED_STREAM은 NOT_SENT로 승격"은 실행 경로에 없다. `Http2EvidenceMapperTest` 5개가 클래스 단위로만 검증한다. +- **L6.** `security/TlsRuntimeRotationCoordinator`가 어떤 auto-config에서도 빈으로 발행되지 않는다. `ClientRuntimeRegistry.swap`과 세대 드레인이 완전히 구현돼 있는데도 런타임 인증서 회전 진입점이 없다. CLAUDE.md:26이 "runtime generations"를 책임으로 선언한다. +- **L7.** `observation/SensitiveValueRedactor`, `auth/ProxyCredentialProvider`도 main 호출자 0건. +- **L8.** `ObjectStorageScanMaintenanceConfig`(`config/:9-19`)는 무조건부 `@Configuration`이고 그 안의 빈이 `AssembledCapability`를 요구한다. `scan-maintenance.enabled=true` + `app.object-storage.enabled=false` 조합이면 미충족 의존으로 기동 실패한다 — C1과 같은 모양이지만 둘 다 opt-in이라 영향이 작다. +- **L9.** 포워드 프록시 기능은 **플랫폼 호출을 통해 한 번도 검증되지 않는다.** `test/.../testkit/ForwardProxyContractTest.java`의 3개 테스트 중 2개는 raw `java.net.Socket`으로 픽스처 프록시에 직접 `CONNECT`를 쏘고(`:20-33`, `:55-70`), 1개는 `ProxyCredentialProvider`를 단독 생성해 헤더 이름만 본다(`:35-53`). 프로필에 `proxy`를 설정하고 게이트웨이로 요청을 보내는 테스트는 166개 중 0개다. main에서 `ProxyCredentialProvider` 호출자가 0건인 것(L7)과 짝을 이룬다. +- **L10.** `test/.../s3/S3SdkApiCharacterizationTest.java:102-108`이 AssertJ의 `assertThatCode`와 **같은 이름의 private 헬퍼**를 정의한다. 실제로는 호출해서 `ReflectiveOperationException`이면 `LinkageError`로 바꾸는 것뿐이라 동작은 맞지만, `:76-79`의 `allSatisfy(builder -> assertThatCode(...))`는 AssertJ 단언처럼 읽히면서 아무 단언 객체도 만들지 않는다. 읽는 사람을 속이는 이름이다. + +--- + +## 6. 바꾸지 말 것 (Keep) + +### K1. objectstorage가 `InputStream` 대신 스코프 chunk 콜백을 port로 삼은 것 + +- **무엇**: `application-core/.../objectstorage/content/`의 `ObjectContentProducer/Consumer` + `ObjectChunkSink/Source` + `ObjectContentProductionContext`. application 쪽 88개 파일에 `java.io`가 **0건**. +- **왜 지금 이게 맞는가**: 스트리밍 오브젝트 스토리지에서 `InputStream`을 port에 태우면 (a) 누가 닫는지, (b) 재시도 시 재생 가능한지, (c) 취소 시 커넥션이 어떻게 되는지가 전부 계약 밖으로 나간다. 여기서는 배열이 `write` 반환까지만 유효하다고 계약에 박아 넣고(`ObjectChunkSink.java:5`), `context.invalidate()`로 콜백 범위를 강제하며(`filesystem/LocalObjectStreamTransfer.java:87`), 그 결과 S3 어댑터는 같은 싱크를 reactive-streams demand에 직결해 백프레셔를 유지할 수 있다(`s3/S3AsyncRequestBodyBridge.java:137`). 로컬 파일시스템과 S3 비동기 클라이언트라는 완전히 다른 두 IO 모델이 **application 코드 변경 없이** 같은 port 뒤에 들어간다 — 이건 `InputStream` port로는 불가능하다. +- **언제 재검토**: application 쪽에서 이 콜백 형태를 감당하기 어려운 유스케이스(예: 사용자가 스트림을 오래 들고 있어야 하는 경우)가 나오면. 그때도 port를 바꾸는 게 아니라 어댑터 측 브리지를 추가하는 방향이 맞다. + +### K2. httpclient가 재시도 판정에서 HTTP 메서드를 아예 제거한 것 + +- **무엇**: `resilience/RetryContext.java:21-38`에 `HttpMethod` 필드가 없다. 대신 `OperationIdempotency`(명시 선언), `BodyReplayability`, `ExecutionEvidence`, `firstByteDelivered`, 데드라인, 예산이 들어간다. `safelyIdempotent()`(`:71-76`)는 키를 **실제로 전송했는지**까지 본다. +- **왜 지금 이게 맞는가**: "GET이면 재시도해도 된다"는 관행은 GET RPC 엔드포인트에서 틀리고, "POST면 안 된다"는 관행은 Idempotency-Key를 쓰는 결제 API에서 과도하게 보수적이다. 이 leaf는 대신 `@HttpOperationPolicy(idempotency=...)`를 필수로 만들고(`service/ServiceOperationDescriptorScanner.java:54-58`), 키를 헤더로 렌더링하는 책임까지 플랫폼이 가져갔다(`security/TrustedTargetPolicy.java:105-132`). `RetryEligibilityEngineTest`의 18개 케이스와 `aKeyThatWasNeverSentDoesNotMakeARepeatSafe`가 그 결정을 고정한다. +- **언제 재검토**: 재검토 대상이 아니다. 이건 이 leaf가 16,470줄인 이유이자 그 크기를 정당화하는 유일한 근거다. + +### K3. 위험 설정을 "표현 가능하되 거부 가능"하게 만든 패턴 + +- **무엇**: `tls.trust-all`, `tls.hostname-verification`, `tls.allow-plain-http`가 설정에 존재하지만 **true를 받아들이는 코드 경로가 없다.** `TlsSettings.java:13-15` javadoc이 그렇게 선언하고, `TlsPolicyValidator`(`security/:18-39`)와 `ClientProfileValidator.validateTls`(`profile/:226-244`)가 둘 다 거부한다. `TlsProfile`(실제로 자재를 만드는 레코드)에는 `trustAll` 컴포넌트가 아예 **없다**. +- **왜 지금 이게 맞는가**: 이 옵션들을 아예 없애면 운영자가 "인증서 검증을 끄고 싶다"를 표현할 방법이 없어 SDK를 직접 만지는 우회를 하게 된다. 표현은 허용하고 기동에서 명확한 코드(`TRUST_ALL_FORBIDDEN`)로 죽이면, 의도가 로그에 남고 우회 동기가 사라진다. 브리프가 물은 "인증서 검증을 끄는 스위치가 있는가"에 대한 답은 **"있지만 작동하지 않고, 있는 이유가 작동하지 않기 위해서"**다. +- **언제 재검토**: 사내 CA를 쓰는 배포가 늘어 `trust-material-reference` 경로가 실제로 널리 쓰이게 되면, 그때도 `trust-all`이 아니라 참조 경로를 개선한다. + +### K4. Dynamic Target의 SSRF 방어를 "차단 목록"이 아니라 "글로벌 유니캐스트 허용 목록"으로 뒤집은 것 + +- **무엇**: `dynamic/IpAddressClassifier.globallyRoutableUnicast`(`:91-137`). JDK 술어(loopback/link-local/site-local/multicast/any) + 명시 특수목적 대역(0/8, 100.64/10, 192.0.0/24, 192.0.2/24, 198.51.100/24, 203.0.113/24, 198.18/15, 240/4, fc00::/7, 2001:db8::/32, 2001::/32, 100::/64) + 메타데이터 주소 4종 + 운영자 CIDR. **허용되지 않으면 거부**. +- **왜 지금 이게 맞는가**: 차단 목록은 빠뜨린 대역이 곧 취약점이고, IANA가 대역을 추가할 때마다 갱신 부채가 생긴다. 허용 목록은 부담을 뒤집는다. 여기에 (a) IPv4-mapped IPv6 정규화(`:37-57`), (b) **모든** A/AAAA 답변 검증(`ValidatedDnsResolver.java:56-63`), (c) 승인 주소를 소켓까지 핀(`CallScopedDnsPin` + `ApacheDnsResolverFactory.validated` + `ValidatedAddressResolverGroup`), (d) 홉마다 재검증·재핀(`DefaultDynamicTargetGateway.java:94-138`), (e) CIDR 파싱 시 호스트명 거부(`:166-194`)가 붙어 있다. DNS 리바인딩까지 실제로 막는 구현은 흔하지 않다. +- **언제 재검토**: IPv6 대역이 새로 할당되거나(2000::/3 가정이 깨지면), CGNAT 대역을 정당한 아웃바운드 대상으로 써야 하는 배포가 생기면. 후자는 `blocked-cidrs`의 반대 방향이라 정책 확장이 필요하다. + +### K5. httpclient 설정을 `@ConfigurationProperties`로 만들지 **않은** 결정 + +- **무엇**: `HttpClientPlatformSettings`에 애노테이션이 없고(`:16-22`), 게이트 안에서 `StrictSettingsBinder`로 수동 바인딩한다. 그리고 환경변수는 record 트리에서 역산한 화이트리스트로 따로 검사한다(`HttpClientEnvironmentKeys.rejectUnrecognised`). +- **왜 지금 이게 맞는가**: `@ConfigurationPropertiesScan`은 선택적이지 않다 — 스캔에 걸리면 모든 배포에서 바인딩되고, 잘못된 값이면 **그 capability를 안 쓰는 배포까지** 기동 실패시킨다. 그러면 옵션 기능이 필수 기능이 된다. 환경변수 쪽 처리도 근거가 정확하다: Spring이 `APP_HTTPCLIENT_CLIENTS_0_BASE_URL`을 바인딩할 때는 `base-url`로, 열거할 때는 `base.url`로 보고하기 때문에 `NoUnboundElementsBindHandler`로는 오타를 못 잡는다(`HttpClientPlatformSettingsBinder.java:14-19`). 그래서 방향을 뒤집었다. +- **이번 리팩토링이 이 패턴을 공유 자산으로 올린 것도 맞는 방향이다**: fileserver와 httpclient가 각자 복제하고 있던 바인더가 `adapter/outbound/support/StrictSettingsBinder`로 합쳐졌고(`:26-32`가 BOOT-011로 중복 근거를 기록), 유일한 실질 차이(어떤 property source에 unbound 검사를 적용할지)만 파라미터로 남겼다. 통합하면서 기능을 잃지 않은 드문 사례다. +- **언제 재검토**: Spring Boot가 프로퍼티 스캔에 조건부 등록을 지원하게 되면. 그 전까지는 이게 유일하게 정직한 방법이다. + +### K6. objectstorage의 "선택되기 전까지 아무것도 만들지 않는다" 조립 규약 + +- **무엇**: `ObjectStorageProviderContribution`이 `describe`(부작용 금지)와 `create`(선택 후에만, 부분 할당 정리 책임 포함)로 갈려 있다(`config/ObjectStorageProviderContribution.java:9-11`). `ObjectStorageCapabilityAssembler.assemble`(`:24-58`)은 **모든 바인딩을 먼저 컴파일**하고, 실제 선택된 제공자만 역순 정리 보장과 함께 구성한다. +- **왜 지금 이게 맞는가**: httpclient가 C1에서 잃어버린 성질을 objectstorage는 **다른 방법으로** 유지하고 있다 — 설정 클래스는 무조건부로 스캔되지만 그 안의 빈이 자원을 만들지 않으므로 무해하다. 그리고 그것이 우연이 아님을 6개 테스트가 고정한다(`ObjectStorageCapabilityConfigTest`의 `disabledContributionIsNeverDescribedConstructedOrClosed`, `unselectedContributionIsDescribedButNeverConstructedOrClosed`, `selectedContributionConstructionFailureCleansItsPartialAllocation`, `contributionIsConstructedOnceOnlyWhenSelectedAndClosedOnce` 등). **부작용 없는 무조건부 빈 + 자원을 쥔 조건부 빈**이 "설정 클래스를 조건부로 만든다"보다 견고한 패턴이다. +- **언제 재검토**: 제공자 기여가 생성자에서 비용을 치러야 하는 경우가 생기면. 그때는 계약을 바꾸는 게 아니라 `describe`를 lazy로 만든다. + +### K7. S3 관리형 제공자의 "증거 없으면 거부" 스타일 + +- **무엇**: `s3/S3ManagedObjectProvider.create`(`:37-70`)가 `ifNoneMatch("*")`(불변 생성), `checksumSHA256`(요청+응답 양방향 검증), `serverSideEncryption(AES256)` 강제, `expectedBucketOwner`를 한 번에 건다. `transfer`는 HEAD 증거와 GET 응답(ETag·versionId·SSE·Content-Range)이 정확히 일치하지 않으면 거부한다(`:137-166`). 컨트롤 레코드는 64KB 상한 + ETag 기반 CAS + **응답 유실 시 재조정**(`s3/S3ConditionalObjectControlStore.java:110-122`). `S3ProviderBinding.validateProvisioning`(`:267-271`)은 `autoCreateBucket`과 `publicAcl`을 아예 거부한다. +- **왜 지금 이게 맞는가**: 브리프가 물은 "서버측 암호화, 버킷 정책, 퍼블릭 액세스 차단"에 대한 답이 전부 여기 있고, 방향이 옳다 — 런타임 프로비저닝을 하지 않고(버킷 생성/정책 변경은 인프라의 일), 암호화는 요청에 걸고 응답에서 다시 확인한다. 레거시 어댑터가 `autoCreateBucket=true`를 기본값으로 갖는 것과 대비된다(`ObjectStorageSettings.java:46`). +- **언제 재검토**: KMS(SSE-KMS)를 써야 하면 `ServerSideEncryption.AES256` 하드코딩을 정책화해야 한다. 지금 `ObjectEncryptionRequirement`가 설정에 존재하지만 S3 제공자는 그걸 읽지 않고 AES256을 고정한다 — 그 자체는 안전한 방향의 불일치다. + +### K8. HTTP/3를 "라벨"이 아니라 "경계"로 만든 처리 + +- **무엇**: `jetty-http3-client-transport`가 `compileOnly`(`build.gradle:45`), stable starter는 이 전송을 절대 등록하지 않고(`autoconfigure/HttpClientTransportAutoConfiguration.java:29-35`), 정확한 승인 문자열이 필요하며(`http3/Http3ExperimentalAcknowledgement.java:11`), 클래스가 없으면 TCP로 폴백하지 않고 **기동 실패**한다(`http3/JettyHttp3TransportProvider.java:123-129`), wire 증명 없이는 promotable이 아니다(`Http3CapabilityReport.java:83-85`). +- **왜 지금 이게 맞는가**: javadoc이 과거 결함을 그대로 기록한다 — 예전엔 `HttpClientTransportOverHTTP`(평범한 HTTP/1.1)를 만들어 놓고 HTTP/3라고 보고했다. 지금은 클래스 프로브가 **제공자가 실제로 생성하는 클래스명**을 검사하므로 둘이 다시 어긋나면 로딩에서 죽는다. 실험적 기능을 다루는 법의 좋은 본보기다. +- **언제 재검토**: 이 빌드가 실제 HTTP/3 서버를 세울 수 있게 되면 `wireVerified`를 true로 만들 수 있다. + +--- + +## 7. 커밋 안 된 리팩토링이 이 영역에 미친 영향 + +### 7.0 먼저: diff 수치를 액면으로 읽으면 안 된다 + +`full.diff`는 `git diff HEAD`라서 **untracked 파일을 담지 않는다.** 저장소 전체로는 tracked −22,532 / +2,374인데, untracked 175파일이 +21,270을 더한다 → 실제 순증감 ≈ **+1,112**. 즉 −22,532는 대부분 **이동의 한쪽 면만 보인 것**이다. + +내 영역만 정확히 계산하면 이렇다 (lockfile 제외, 줄 단위 실측): + +| | tracked 삭제 | untracked 추가 | 순증감 | +|---|---:|---:|---:| +| httpclient 조립 코드 (bootstrap main 16파일 → leaf `autoconfigure/` 16파일) | −1,466 | +1,466 | 0 | +| httpclient 조립 테스트 (bootstrap test 6파일 → leaf `test/autoconfigure/` 6파일) | −1,004 | +1,004 | 0 | +| httpclient Toxiproxy 2파일 (`test`+`testFixtures` → `integrationTest`) | −189 | +189 | 0 | +| httpclient Boot 등록 파일 | — | +1 | **+1** | +| **httpclient 소계** | **−2,659** | **+2,660** | **+1** | +| objectstorage MinIO/S3 통합 5파일 + 증거 JSON (2개 소스셋 → `integrationTest`) | −622 | +622 | **0** | +| `adapter/outbound/support` 신규 3 main + 2 test | — | +179 | +179 | +| 문서·빌드 스크립트 (`CLAUDE.md`, `build.gradle` ×3, `repository-adaptation.md`, `ObjectStorageArchitectureContractTest`) | −54 | +43 | −11 | + +**httpclient 슬라이스는 1,466줄 조립 코드 + 1,004줄 테스트가 바이트 단위로 그대로 옮겨간 것이고, 순증은 `AutoConfiguration.imports` 한 줄이다.** objectstorage 슬라이스는 순증 0 — 완전한 이동이다. + +### 7.1 무엇이 바뀌었나 + +| 범주 | 내용 | +|---|---| +| **이동 (main)** | `dev.caskeleton.bootstrap.autoconfigure.httpclient` 16파일 → `dev.caskeleton.adapter.outbound.httpclient.autoconfigure`. 내용 동일, 패키지 선언과 import만 변경 | +| **이동 (test)** | 같은 6파일이 leaf로. `HttpClientPlatformActivationTest` 253줄은 패키지 라인 외 **바이트 동일**(diff의 삭제분과 스냅샷의 untracked 본문을 대조 확인) | +| **이동** | httpclient `ToxiproxyFixture` + `FailureInjectionContractTest` → 신규 `integrationTest` 소스셋. Testcontainers 3종이 `testImplementation`/`testFixturesImplementation` → `integrationTestImplementation` | +| **통합** | objectstorage `objectStorageMinioContractTest` + `objectStorageMinioFaultTest` 두 소스셋 → 단일 `integrationTest`. `S3ObjectStorageAdapterIT`와 evidence JSON도 `test` → `integrationTest` | +| **신규 (진짜 추가)** | `adapter/outbound/support`에 `StrictSettingsBinder`(82), `CapabilityStartupValidationException`(30), `EnvironmentSecretSource`(22) + 테스트 2개. 앞의 둘은 httpclient와 fileserver가 각자 갖고 있던 복제본의 통합이고(`StrictSettingsBinder.java:26-33` 주석이 BOOT-011로 근거를 밝힘), 셋째는 `secret-source-port-ownership` 슬라이스 산물 | +| **신규** | `httpclient/src/main/resources/META-INF/spring/...AutoConfiguration.imports` 1줄 | +| **추가 의존** | httpclient에 `spring-boot-actuator` + `actuator-autoconfigure` (actuator endpoint가 leaf로 왔으니 필연) | +| **제거** | `test` 레인의 `excludeTags 'httpclient-fault'` (fault 테스트가 소스셋으로 분리됐으므로 불필요) | +| **문서** | httpclient `CLAUDE.md`, `docs/httpclient/repository-adaptation.md`의 composition 소유권 문장 갱신 | + +### 7.2 세 갈래 판정: 사라진 것 / 중복된 것 / 커밋하면 사라질 것 + +**(a) 양쪽에 다 없는 것 = 진짜 손실: 없다.** +파일 단위로 대조했다. tracked에서 지워진 30개 파일 전부가 untracked 쪽에 대응 파일을 갖는다(httpclient 24개, objectstorage 6개). 줄 수도 위 표대로 일치한다. **테스트는 한 줄도 사라지지 않았다.** `test` 소스셋 줄 수가 10,449 → 6,973으로 줄어 보이는 것은 소스셋 분할의 착시다(§1). + +**(b) 양쪽에 다 있는 것 = 중복 조립 / 빈 충돌: 없다.** — 확인함. +- `src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/` : **파일 0개**(빈 디렉터리만 남음). test 쪽도 0개. +- `app-bootstrap`의 `META-INF/spring/...AutoConfiguration.imports` 5줄에 httpclient 항목 **없음**(fileserver, jpa, messaging, activation, notification만). +- `app-bootstrap/src/main/java` 전체에서 `httpclient` 문자열 grep **0건** — spec의 "app-bootstrap must not import HTTP-client implementation or auto-configuration types"(`:25`)와 plan 항목 12가 실제로 지켜졌다. +- 따라서 같은 빈이 두 번 등록되는 충돌은 없다. **C1은 중복 등록 문제가 아니라, 남은 한 벌이 게이트 바깥에서 스캔된다는 문제다** — 성격이 다르다. + +**(c) `git add` 없이 커밋하면 진짜로 사라지는 것: capability 전체.** +이게 가장 큰 운영 리스크다. 지금 상태에서 `git commit -a`(= tracked만)를 하면: +- httpclient 조립 코드 1,466줄 + 조립 테스트 1,004줄 + `AutoConfiguration.imports`가 **양쪽 다 없어진다.** 구 위치는 삭제가 커밋되고 신 위치는 untracked라 커밋되지 않는다. 결과는 "HTTP 클라이언트 플랫폼이 어떤 Spring 컨텍스트에서도 조립되지 않는" 상태 — 컴파일은 되고(leaf 내부는 자족적) 런타임에 capability가 통째로 증발한다. +- 동시에 `build.gradle`의 `sourceSet('integrationTest')` 선언은 커밋되는데 그 소스셋의 파일 4개(httpclient 2, objectstorage 4 = 6개)는 안 커밋된다 → `httpClientFailureInjectionTest` / `objectStorageMinioContractTest` / `objectStorageMinioFaultTest` 레인이 **빈 소스셋을 실행**한다. 이 레인들은 `failOnNoDiscoveredTests`를 갖고 있으므로(`httpclient/build.gradle:150-155` 주석이 그 속성을 잃었던 사고를 기록) 빨간불로 죽는다 — 조용히 초록이 되는 것보다는 낫지만, objectstorage의 `strictQualification.register(...)`가 같은 보호를 갖는지는 확인하지 못했다. +- `adapter/outbound/support`의 `StrictSettingsBinder`도 untracked인데, httpclient·fileserver의 구 복제본은 tracked 삭제다 → **컴파일 자체가 깨진다.** + +즉 이 워킹트리는 `git add -A`가 아니면 안전하게 커밋할 수 없다. 리뷰 시점에 이걸 명시해 두는 것이 이 절의 실질적 가치다. + +### 7.3 판정 + +**이동 자체는 옳고, 유지보수 부담을 실제로 줄였다.** 근거: +- Docker가 필요한 테스트를 `test` 소스셋 밖으로 빼서 "Docker 없는 노트북에서 `test`가 빨간색"을 제거했다. +- Testcontainers를 `testFixtures`에서 떼어내 픽스처 변형의 컴파일 표면을 줄였다. +- objectstorage의 두 qualification 소스셋을 하나로 합친 근거(`build.gradle:22-24`: "MinIO/Testcontainers exercises are one physical INTEGRATION runtime. Contract/fault are qualification meanings over that source set, not separate test kinds")는 정확한 진단이다. +- `StrictSettingsBinder` 통합은 실제 중복 제거다 — fileserver와 httpclient가 같은 핸들러·같은 `orElseThrow`를 prefix만 바꿔 복제하고 있었다(`StrictSettingsBinder.java:26-32`). +- 조립을 leaf가 소유하는 방향도 맞다. `app-bootstrap`이 httpclient 지식 1,466줄을 들고 있던 것보다 낫고, `repository-adaptation.md:29`의 갱신된 근거("Capability-specific Spring composition is owned with the reusable HTTP client platform")도 타당하다. + +**그런데 이동이 자기가 옮긴 것의 전제를 깨뜨렸다.** `bootstrap.autoconfigure.*`는 컴포넌트 스캔 제외 정규식이 이미 덮고 있던 **안전한 자리**였고, `adapter.outbound.httpclient.autoconfigure`는 덮이지 않은 자리다. 정규식 한 줄이 같이 옮겨가지 않았다(C1). + +이걸 몰랐다고 보기 어렵다: +- `HttpClientPlatformAutoConfiguration.java:20-23` javadoc이 바로 이 위험을 설명한다 — "component scanner finds each child on its own — so the children had to leave the scan together with the switch." +- `CaSkeletonApplication.java:93-97` javadoc이 다른 capability에 대해 똑같은 실패 모드를 이미 기록하고 있다 — "a component scan finds them regardless — so an all-off or partially configured deployment failed to start on an unsatisfied dependency." +- spec `:21`은 off 상태 보장을 명시적으로 약속하고, plan `:10`은 그걸 증명했다고 체크돼 있다. + +**세 문서가 전부 있었는데 정규식 한 줄이 빠졌고, 그걸 잡을 수 있는 테스트는 계획에 없었다.** + +이건 "삭제가 안전망을 잘랐다"가 아니라 **"이동이 안전망의 좌표를 무효화했고, 이동을 검증한 테스트가 좌표를 볼 수 없는 종류였다"**는 사고다. 그리고 같은 패턴이 이 워킹트리에 9개 더 있다 — `2026-09-18-*-composition-ownership` 스펙이 jpa, mongo, notification, postgresql-idempotency에 대해 같은 이동을 하고 있다. **이 리뷰의 C1은 httpclient 한 건이지만, 검토해야 할 것은 그 4개 슬라이스 전부와 `AUTO_CONFIGURED_PACKAGES` 목록의 동기화 여부다.** (그 leaf들은 내 담당이 아니므로 교차 이슈로만 남긴다.) + +**그리고 두 슬라이스의 접합부가 비었다.** `secret-source-port-ownership`이 같은 날 `SecretSourcePort` + `EnvironmentSecretSource`를 만들었는데, `httpclient-capability-composition-ownership`은 자기 시크릿 해석을 여전히 "항상 던지는 `Function`"으로 옮겨 왔다(H6). 두 계획서 어느 쪽에도 상대를 참조하는 항목이 없다. + +--- + +## 8. 템플릿 사용자 관점 + +### 8.1 fork 직후 실제로 겪을 일 + +1. **아무것도 안 해도 C1에 걸린다.** `APP_HTTPCLIENT_ENABLED`는 기본 false고, `app-bootstrap`은 이 leaf에 의존한다. 기동이 실패하면 스택트레이스는 `httpClientRuntimeRegistry`를 가리키고, 사용자는 자기가 쓰지도 않는 capability의 빈 이름을 보게 된다. 첫 대응은 십중팔구 "`APP_HTTPCLIENT_ENABLED=true`로 켜 본다"가 될 텐데, 그러면 이번엔 `HTTPCLIENT_ACTIVE_WITHOUT_CLIENTS`로 죽는다(`HttpClientPlatformSettings.java:51-61`). 즉 **켜도 죽고 꺼도 죽는** 구간에 들어간다. 탈출구는 `clients[0]` 전체를 선언하거나 leaf 의존을 제거하는 것. + +2. **httpclient를 실제로 쓰려면 프로필 하나에 최소 이만큼을 써야 한다** (프로덕션 프로파일 기준, `ClientProfileValidator.validateProductionCompleteness` `:266-280` + `validateTarget` `:34-63`): + - `name`, `base-url`(https, userinfo/query 금지), `allowed-hosts`(비면 프로덕션 거부), `allowed-ports` + - `request.max-body-bytes`(기본 0은 프로덕션 거부) + - `tls.profile-id`(프로덕션 필수) + - `retry.policy`와 `retry.max-attempts`가 **서로 모순이면 거부**(`:246-263`) — `policy: none`인데 `max-attempts: 3`이면 죽는다 + - 환경변수로 쓸 거라면 `docs/httpclient/env-fields.yaml`의 179줄짜리 템플릿 표를 봐야 한다. `APP_HTTPCLIENT_` 접두사 변수 중 그 표에 없는 것은 **기동을 막는다**(`HttpClientEnvironmentKeys.rejectUnrecognised`). 오타 방어로는 훌륭하지만 첫 배포에서 여러 번 튕길 것이다. + +3. **typed client 하나 만드는 데 필요한 것** (`ServiceOperationDescriptorScanner` 규칙 전수): + - 인터페이스에 `@HttpClientProfile("name")` 필수 + - 모든 메서드에 `@HttpExchange` + `@HttpOperationPolicy(name=..., idempotency=...)` 필수 (idempotency에 기본값 없음) + - 연산명 중복 금지, 인터페이스는 **전부 블로킹이거나 전부 리액티브** + - `IDEMPOTENCY_KEY_REQUIRED`면 `@RequestHeader("Idempotency-Key")` 파라미터 필수 + - `retryPolicy != "none"` + `NON_IDEMPOTENT` 조합 금지 + + 이 규칙들은 전부 startup failure다. 배우는 비용이 있지만 각 규칙에 실패 사례 근거가 javadoc에 적혀 있어 납득 가능하다. + +4. **objectstorage는 fork 후 손을 대야 쓸 수 있다.** 부트스트랩 의존이 없으므로 `modules.json`의 `app-bootstrap.allowed_dependencies` + `app-bootstrap/build.gradle` + `config/objectstorage.yml`을 직접 추가해야 한다. `modules.json`은 fail-closed라 순서를 틀리면 `settings.gradle`에서 막힌다. 그다음 `app.object-storage.providers/destinations`를 손으로 써야 하는데, 이건 `enabled: true` 한 줄로 되는 구조가 아니다 — `provider.type`, `provider.version`(정확한 토큰), `root` 또는 `s3.*` 블록, `destinations.`의 `provider-ref`/`route-token`/`binding-revision`/`policy-revision`/`operation-profile`, 그리고 S3면 `capability-profiles`의 증거(digest·observedAt·validUntil·identity)까지 전부 필수다. **첫 성공까지 가장 먼 leaf다.** + +5. **`filesystem-local-dev`는 prod에서 거부된다**(`ObjectStorageBindingCompiler.java:126-128`). 로컬에서 되던 게 prod에서 안 되는 정상적 실패지만, 대안(S3 제공자)은 readiness 카드가 없다(M2). 즉 **문서상 "프로덕션에 써도 된다"고 선언된 오브젝트 스토리지 제공자가 하나도 없다.** + +### 8.2 손대야 하는 파일 (최소 경로) + +| 목적 | 파일 | +|---|---| +| C1 우회 | `src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/CaSkeletonApplication.java:99` (제외 정규식) | +| httpclient 켜기 | `src/app-bootstrap/src/main/resources/config/httpclient.yml` + 배포 환경변수 | +| httpclient 프로필 작성 참고 | `docs/httpclient/configuration-reference.md`, `docs/httpclient/env-fields.yaml` | +| objectstorage 편입 | `src/config/architecture/modules.json`, `src/app-bootstrap/build.gradle`, 새 `config/objectstorage.yml` | +| objectstorage readiness 갱신 | `docs/registries/object-storage-readiness.yaml` + `test/.../readiness/ObjectStorageReadinessRegistryTest.java:23` | +| 레거시 objectstorage 탈출 | `src/sample-portfolio/src/main/resources/application.yml:318-323` | + +### 8.3 밟게 될 지뢰 요약 + +- **fork 시점 자체가 위험하다**: 지금 워킹트리를 `git commit -a`로 커밋하면 httpclient capability 조립 2,470줄이 양쪽 다 사라지고 support의 `StrictSettingsBinder`가 없어 컴파일이 깨진다(§7.2-c). fork 전에 `git status`로 untracked 175개를 반드시 확인해야 한다 +- C1 (기동 실패, 기본 설정) +- 인증을 쓰는 프로필은 기동 성공 후 **첫 호출**에서 "no http client secret resolver is configured"로 터진다 (H6) +- 리액티브 프로필을 고르면 브레이커·리미터·벌크헤드·total-call 데드라인이 조용히 사라진다 (H1/H2) +- `http.client.requests` 대시보드가 영원히 0 (H3) +- 아웃바운드 호출에 trace/correlation이 안 실리고, 애플리케이션에서 넣을 수도 없다 (H4) +- dynamic target 정책만 선언하면 기동은 되고 첫 호출에서 터진다 (H5) +- 브레이커가 저트래픽 업스트림에서 절대 안 열린다 (M3, Resilience4j 기본 minimumNumberOfCalls=100) +- objectstorage는 부트스트랩에 없다 (M1) +- **S3로 배포하면 실 스토어 검증이 0인 코드 3,581줄 위에 서게 된다** (H7). MinIO는 저장소 자신의 측정으로 `UNSUPPORTED`이고, AWS는 한 번도 돌려본 적이 없다 +- SSRF 방어의 마지막 한 칸(검증된 IP로 소켓 고정)이 테스트 참조 0건이다 (H8) +- 프록시 설정은 게이트웨이를 통해 한 번도 검증되지 않았다 (L9) + +--- + +## 9. 미확인 / 가정 + +### 빌드 미실행으로 확인 못 한 것 + +| 항목 | 확인 명령 | 기대 | +|---|---|---| +| **C1 (최우선)** | `cd src && ./gradlew :app-bootstrap:systemTest --tests '*FiveAdapterOffInventoryTest*' --console=plain` | `@BeforeAll`에서 `UnsatisfiedDependencyException: httpClientRuntimeRegistry` → C1 확정. 초록이면 내 추론이 틀렸고 스캐너가 그 패키지를 건너뛴 이유를 찾아야 함 | +| C1 보조 | `cd src && ./gradlew :app-bootstrap:bootRun --args='--spring.profiles.active=local'` (기본 env) | 위와 동일한 실패가 나면 확정 | +| H1/H2 | 리액티브 프로필로 502를 반복 반환하는 MockHttpServer에 호출 → `http.client.circuit.state` 게이지가 항상 0인지, `totalCall`을 넘겨도 호출이 지속되는지 | 현재 이를 단언하는 테스트 없음 | +| H3 | `cd src && ./gradlew :adapter:outbound:httpclient:test --tests '*DefaultGenericHttpGatewayTest*' --console=plain` 후 `SimpleMeterRegistry`에 `http.client.requests`가 있는지 수동 확인 | 없을 것으로 예상 | +| M5 | `cd src && ./gradlew :app-bootstrap:dependencies --configuration runtimeClasspath \| grep -iE 'jetty\|httpclient5\|reactor-netty'` | 세 개 모두 존재 예상 | +| H6 | 인증 프로필(`authentication.type=STATIC_BEARER` + `secret-reference`)로 한 번 호출 | `CapabilityStartupValidationException: no http client secret resolver is configured for reference '...'` 예상. 이 실패를 단언하는 테스트가 현재 없음 | +| §7.2-c | `cd src && git status --porcelain \| grep '^??'` 로 untracked 175개 확인 후 `git add -A` 없이 커밋했을 때 `./gradlew :adapter:outbound:support:compileJava`가 깨지는지 | 깨질 것으로 예상 | +| 전체 | `cd src && ./gradlew :adapter:outbound:httpclient:check :adapter:outbound:objectstorage:check --console=plain` | 두 leaf의 현재 상태(커밋 안 된 변경 포함)가 초록인지 자체가 미확인 | + +### 세운 가정 + +1. **Spring 컴포넌트 스캔 동작**: `@Configuration(proxyBeanMethods=false)`는 `@Component` 메타애노테이션을 통해 `ClassPathBeanDefinitionScanner` 기본 필터에 잡힌다. `AutoConfigurationExcludeFilter`는 `AutoConfiguration.imports`에 등재된 클래스만 제외한다. C1 전체가 이 가정 위에 있다. (Spring Framework/Boot의 문서화된 동작이고 `CaSkeletonApplication.java:93-97` javadoc이 같은 이해를 전제한다.) +2. **Resilience4j 기본값**: `CircuitBreakerConfig.ofDefaults()` = failureRate 50% / slidingWindow 100 / minimumNumberOfCalls 100 / wait 60s, `RateLimiterConfig.ofDefaults()` = 50 permits / 500ns / timeout 5s. M3의 구체 수치가 여기 의존한다. 코드에서 재정의하는 곳은 없음(확인함). +3. **Spring Boot 기본 multipart 제한** 1MB — L3의 완화 근거. 저장소 어디에도 `spring.servlet.multipart.*` 설정이 없음(전수 grep 확인). +4. **`ClientHttpRequestFactoryBuilder.detect()` 우선순위** Apache HC5 > Jetty > Reactor Netty > JDK — M5의 부작용 주장 근거. Boot 3.4+ 동작이며 Boot 4.0.8에서 동일하다고 가정. +5. ~~미독 소스셋 가정~~ — **철회한다.** 테스트 166파일 17,748줄을 전부 전문 읽었고, 그 결과 H7(구 M2)이 M→H로 올라갔고 H8·H9·L9·L10이 새로 나왔다. 즉 이 가정은 틀렸었다. 이제 두 leaf에서 읽지 않은 소스 파일은 0개다(§1). +6. ~~testFixtures 가정~~ — **철회한다.** 34개 전부 읽었다. `HttpClientModuleBoundaryTest`의 본문도 확인했고, 다만 픽스처가 전송 제공자를 **무인자 생성자**로 만들어 DNS 핀·TLS 자재를 배선하지 않는다는 사실이 새로 드러났다(H8). +7. **§7.0의 줄 수 대조는 `full.diff`의 `-`/`+` 라인 수와 `untracked-wc.txt`의 `wc -l` 값을 직접 비교한 것**이다. diff의 삭제 줄 수는 파일 전체 줄 수와 같다(전체 삭제이므로). 파일 내용이 바이트 단위로 같은지는 `HttpClientPlatformActivationTest`에 대해서만 실제로 대조했고, 나머지 29개는 줄 수 일치 + 스냅샷 본문 독해로 동일성을 판단했다 — 완전한 바이트 대조는 아니다. +8. **`objectstorage`의 `strictQualification.register(...)`가 `failOnNoDiscoveredTests`를 갖는지 확인하지 못했다**(§7.2-c). `src/build-logic`의 해당 확장은 다른 에이전트 영역이라 읽지 않았다. +9. **`ApplicationContextRunner`가 컴포넌트 스캔을 수행하지 않는다**는 것 — §1.2(Q2)의 결론이 이 가정 위에 있다. 러너는 `withConfiguration`/`withUserConfiguration`으로 넘긴 클래스만 등록하는 컨텍스트를 만들고, `@ComponentScan`이 달린 클래스를 넘기지 않는 한 스캔이 일어나지 않는다. 9개 파일의 본문을 확인했고 어디에도 `@ComponentScan`이 달린 설정 클래스를 넘기는 곳이 없다. + +### 의도적으로 판정하지 않은 것 + +- `gradle.lockfile` 2개(751줄 변경), 의존성 버전, CI 워크플로 — 다른 에이전트 담당. +- `fileserver`/`notification` leaf 내부 — §10 참조. + +--- + +## 10. objectstorage vs fileserver — 중복인가 분담인가 + +**분담이다. 다만 경계가 문서에 적혀 있지 않고 포트 이름에서 추론해야 한다.** + +`modules.json`에서 둘은 형제고 허용 의존이 동일하다(`application-core`, `shared-contract`). 서로를 의존하지 않는다. 구분은 **application-core의 포트 패키지**에서 드러난다: + +- `application/objectstorage/port/**` — `ManagedObjectPublicationPort`, `ObjectInspectionPort`, `ObjectTransferPort`, `ObjectRetirementPort`, `ObjectOperationResolutionPort`, `StagedObjectPublicationPort`, `DirectObjectUploadPort`, `DirectObjectDownloadGrantPort`, `DirectMultipartUploadPort`, `ObjectScanMaintenancePort`. 어휘가 전부 **바이트·버전·다이제스트·보존·스캔**이다. `ObjectReference`/`ObjectVersionToken`/`ObjectContentIdentity`가 1급이고, 파일명·확장자·MIME 협상 같은 개념은 없다(`ObjectMediaType`만 있고 그것도 불투명 토큰). +- `application/fileserver/**`, `application/filepublication/**`, `application/fileexport/**` — 별도 포트군. (내부는 다른 에이전트 담당이라 열지 않았다.) + +즉 objectstorage는 **"불변 바이트 덩어리의 저장·검증·수명주기"** 계층이고, fileserver는 그 위에서 **"파일이라는 사용자 개념의 게시·전송"** 계층이다. objectstorage의 포트는 파일을 모르고 fileserver는 S3 API를 모른다. + +중복이 아니라고 판단하는 결정적 근거는 **objectstorage 포트에 "이 오브젝트를 URL로 서빙한다"는 개념이 전혀 없다**는 점이다. presigned 그랜트조차 `DirectUploadGrant`/`DirectDownloadGrant`라는 **불투명 bearer 자재**를 반환할 뿐, 경로나 파일명을 만들지 않는다. + +다만 두 가지를 지적한다. (a) 이 분담은 `objectstorage/README.md`나 `CLAUDE.md` 어디에도 문장으로 적혀 있지 않아서, fork 사용자가 "파일 업로드를 어느 쪽에 붙여야 하나"를 포트 시그니처를 읽어서 스스로 결론 내야 한다. (b) 현재 `app-bootstrap`은 fileserver만 의존하고 objectstorage는 의존하지 않으므로(M1), **실제 배선상으로는 fileserver가 단독으로 존재**한다 — 분담 구조가 설계에만 있고 컴포지션에는 없다. 루트 `CLAUDE.md`의 Module families 표에 한 줄(`adapter:outbound:objectstorage` = 바이트 계층, `adapter:outbound:fileserver` = 파일 계층)을 추가하는 것이 가장 싼 해결이다. diff --git a/docs/reviews/2026-09-18-techlead-review/09-notification-fileserver.md b/docs/reviews/2026-09-18-techlead-review/09-notification-fileserver.md new file mode 100644 index 00000000..ee44b244 --- /dev/null +++ b/docs/reviews/2026-09-18-techlead-review/09-notification-fileserver.md @@ -0,0 +1,1765 @@ +# [영역] 알림 플랫폼 / 파일서버 어댑터 리뷰 + +- 스냅샷: 2026-09-18T11:50Z / HEAD 60b6a319 + 커밋 안 된 변경 + (tracked 224파일 +2,374/−22,532, untracked 175파일 +21,270 — 실제 순증감 ≈ +1,112) +- 담당 leaf: `adapter-outbound-notification`, `adapter-outbound-fileserver` +- 관계 판정만 한 leaf: `adapter-outbound-objectstorage` + +--- + +## 0. 최종 적용 기준 + +도달 불가 코드를 일괄 삭제하지 않는다. R1/실험/미완성은 REMOVE 후보, 완성 자산은 WIRE 또는 +KEEP AS LIBRARY로 분류한다. Notification leaf가 provider assembly/gating을 소유하고 Fileserver의 application +policy와 HTTP transport를 분리한다. placeholder fail-closed test는 유지 가능하지만 custom evidence manifest는 +기본 요구로 확대하지 않는다. + +## 0-A. 2026-09-21 중간 재검증 + +**상태: Notification은 크게 진척됐고 Fileserver는 Phase 2의 가장 큰 잔여물 중 하나다.** + +Notification: + +- `NotificationPlatformAutoConfiguration`이 leaf에 존재하고 자기 `AutoConfiguration.imports`로 발행된다. +- SMTP transport는 implicit TLS 또는 `STARTTLS enable=true + required=true`를 요구하도록 검증한다. +- `NotificationSmtpTransportConfigurationTest`가 있고 이번 `:adapter:outbound:notification:test`가 PASS했다. + +Fileserver: + +- reusable implementation은 `adapter:outbound:fileserver`에 많이 존재하지만, + `app-bootstrap/autoconfigure/fileserver`에 **28개** configuration/composition Java class가 남아 있다. +- bootstrap main에서 발견한 120개 adapter 직접 import 중 상당수가 Fileserver wiring이다. +- `FileserverWebAssemblyConfiguration`, local storage, verification, protocol, observability, + storage operations 등을 bootstrap이 구현 타입으로 직접 조립한다. + +따라서 Fileserver는 **application policy와 provider implementation을 분리한 뒤 owner leaf가 +AutoConfiguration을 소유하도록 옮기는 작업이 아직 필요**하다. Notification의 leaf ownership 패턴을 +Fileserver에도 같은 수준으로 적용해야 한다. + +## 1. 커버리지 + +**2차 패스에서 1차 미독 114개를 전부 읽었다. 현재 커버리지 386 / 386 파일 (100%).** + +| leaf | main `.java` | test `.java` | 그 외 | +|---|---|---|---| +| notification (266) | **187 / 187** (1차 104 + 2차 83) | **70 / 70** (전문 20, 메서드 본문 단위 50) | 9 / 9 | +| fileserver (120) | **79 / 79** (1차 48 + 2차 31) | **37 / 37** (전문 9, 메서드 본문 단위 28) | 4 / 4 | + +### 읽기 방식의 정확한 고백 + +"전문"과 "메서드 본문 단위"를 구분해 둔다. 대형 R2 파일 4개 +(`LocalPersistentControlPlane` 1,470줄, `LocalPersistentPayloadOperations` 1,101줄, +`LocalPersistentPublicationProvider` 896줄, `FileserverControlRecordCodec` 855줄)는 +**클래스 javadoc + 전체 메서드 시그니처 + 보안·불변식 관련 메서드 본문**을 읽었고, 순수 게터·`equals`· +`toString`·record 접근자 본문은 시그니처 확인에 그쳤다. 판정에 쓰인 근거는 전부 실제로 읽은 줄에서 나왔다. +`gradle.lockfile` 2개는 diff 해당 줄만 읽었다. + +### 2차 패스가 실제로 바꾼 판정 + +건너뛴 판단("도달 불가라서", "HTTP 노출이 없어서")은 합리적이었지만 **네 군데에서 결론을 바꿨다.** + +| 항목 | 1차 | 2차 | +|---|---|---| +| H1 검증 fail-open | High | **Critical(C2)로 승격** — 테스트가 비기본 분기만 검증한다는 사실 확인 | +| H4 8,001줄 | "하나의 죽은 덩어리" | **성질이 정반대인 두 덩어리로 분리.** 한쪽은 삭제, 한쪽은 배선 | +| 자기등록 테스트 | 없음 | **H6 신설** — `.imports`를 자기 테스트로 지키는 leaf가 11개 중 3개뿐, notification은 그 3개 밖 (1차 수치는 코디네이터 반증으로 정정, §9.5) | +| M1 fileserver 설정 바인딩 | "비대칭" | **httpclient와 같은 결함 계열로 재서술**, severity 유지 근거 보강 | + +--- + +## 2. 이 영역은 무엇을 하는가 + +### notification — 한 leaf 안에 같은 기능의 구현이 3세대 공존한다 + +`README.md`는 이 leaf를 "R0 legacy 라우터 + 프로바이더 seam"이라고 설명하지만, 코드는 그것보다 훨씬 크다. +실제로는 아래 세 덩어리가 한 leaf 안에 있고, 서로 다른 application-core 포트 집합을 쓴다. + +``` +[1세대 R0 legacy] core/ + email/google/ + slack/webhook/ + NotificationConfig + NotificationRoutesSettings + → application.notification.NotificationPort (raw notify(Channel, route, Notification)) + → Spring 배선 O (마스터 스위치 뒤) 219 + 6 + ... ≈ 400줄 + +[2세대 R1 canonical graph] catalog/ + provider/ + template/ + → application.notification.{NotificationProviderAttemptPort, NotificationDispatchUseCase, ...} + → Spring 배선 X (어떤 @Bean도 생성하지 않음) 3,832줄 + +[3세대 R2 delivery platform] platform/** + → application.notification.platform.** (전용 패키지 트리) + → Spring 배선 O (마스터 스위치 뒤). 단 provider assembler는 SMTP 1개뿐 +``` + +3세대(`platform/**`)가 실제 제품이다. 동작은 이렇다. + +``` +제출 NotificationSubmissionService (application-core, TransactionPort 경계) + → notification_request / recipient_delivery / delivery_attempt 행을 커밋 +디스패치 NotificationSchedulerWorker (가상 스레드 폴링 루프) + → RecipientLeaseStorePort.claim(worker, n, leaseDuration) ← DB 리스 기반 큐 + → NotificationDispatchService.dispatch(lease) + → RegistryProviderDispatchGateway → ProviderRuntime(허가증) → ProviderAdapter.submit() +보정 NotificationBackgroundWorkers (데몬 스케줄러 1개, 3개 패스) + → LeaseRecoveryService / ProviderEventReplayWorker / ReconciliationJobWorker +``` + +즉 **자체 트랜잭셔널 아웃박스**다. `config/outbox.yml`의 아웃박스 모듈도, `messaging:*`도 쓰지 않는다 +(`src/adapter/outbound/notification/src/main/` 전체에서 `Outbox`/`MessageBroker` 참조 0건). +프로바이더 호출은 사용자 요청 스레드가 아니라 스케줄러 워커에서 일어나므로, **프로바이더 장애가 사용자 요청을 +막지 않는다**(브리프 3번 질문의 답: 동기 아님). + +### fileserver — 한 leaf 안에 서로 다른 성숙도의 능력이 2개 있다 + +`CLAUDE.md`/`README.md`가 설명하는 것은 (a)뿐이다. + +- **(a) 테이블 데이터 발행 (R1/R2)** — `app.file-export.*`, `app.fileserver.*`. + `FilePublicationPort`/`FileExportPort` 뒤에서 CSV를 미리 준비된 절대 경로 루트에 스트리밍 기록한다. + `local-persistent` 프로바이더는 소유자·모드·FileStore·마운트 sentinel·경로 동일성을 기동 시 증명하고, + `WRITING → SEALED → DATA_PUBLISHED → MANIFEST_PUBLISHED → REFERENCE_PUBLISHED → PUBLISHED` + 상태 기계를 강제 fsync로 전진시킨다. 8,634줄. +- **(b) HTTP 파일서버의 로컬 콘텐츠 저장소** — `app.fileserver-platform.*`(스위치는 `app-bootstrap` 소유). + 업로드 스테이징/이어올리기/다이제스트/검증/발행/다운로드(레인지·제로카피)/고아 스캔/정리. 4,263줄. + `platform/local`, `platform/verification`, `platform/security`, `platform/audit`, `platform/observability`. + +**(b)가 이 두 leaf 전체에서 가장 위험한 코드다**(사용자가 올린 바이트를 되돌려준다). 그런데 leaf의 +`CLAUDE.md:25-31`은 (b)를 "a different capability again ... owned by `app-bootstrap`"이라고만 쓰고 넘어간다. +4,263줄이 이 leaf 안에 있는데 leaf 문서가 그것을 자기 것으로 다루지 않는다(§5 M6). + +--- + +## 3. 런타임 토글 판정 — 꺼지면 정말 꺼지는가 + +### 3.1 notification — `config/runtime.yml:38-48`의 주장은 **참이다** + +검증 대상 주장(주석 원문): +> "Disabled by default, and disabled means nothing is bound: no provider runtime, no schema activation +> check, no scheduler thread, no secret required." +> "Every value carries an inline default so that a deployment leaving the platform off never has to +> supply an environment variable for a subsystem it is not running." + +토글 키: `ca-skeleton.notification.platform.enabled` ← `APP_NOTIFICATION_PLATFORM_ENABLED`, 기본 `false` +(`src/app-bootstrap/src/main/resources/config/notification.yml:9`). + +| 주장 | 판정 | 근거 | +|---|---|---| +| provider 런타임 빈이 등록되지 않는가 | **참** | 아래 조건식 표 | +| 스케줄러 스레드가 안 뜨는가 | **참** | 아래 | +| DB 스키마 활성화 체크가 건너뛰어지는가 | **참** | 아래 | +| 시크릿이 필요 없는가 | **참** | 아래 | +| 인라인 기본값이 모든 키에 있는가 | **참** | 아래 | + +**(1) 빈 등록 — 구조적으로 차단된다.** 이게 이 저장소에서 가장 잘 만든 부분이다. + +`src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/CaSkeletonApplication.java:99-113`가 +`dev\.caskeleton\.adapter\.outbound\.notification\..*`를 컴포넌트 스캔에서 **정규식으로 제외**한다(:105). +동시에 `@ConfigurationPropertiesScan`의 basePackages 목록(:58-79)에 notification 패키지가 **없다**. +따라서 이 leaf의 클래스는 오직 하나의 경로로만 컨텍스트에 들어온다 — +`src/adapter/outbound/notification/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports:1`에 +등록된 `NotificationPlatformAutoConfiguration`. 그 클래스의 조건식은: + +```java +// NotificationPlatformAutoConfiguration.java:19-23 +@AutoConfiguration +@ConditionalOnProperty( + prefix = "ca-skeleton.notification.platform", + name = "enabled", + havingValue = "true") +``` + +`havingValue = "true"`이고 `matchIfMissing`이 없으므로 **속성이 없거나 `false`면 매칭 실패**다. +이 루트가 `@Import`하는 10개 슬라이스 전부가 같은 조건식을 반복해서 들고 있다(중복이지만 안전 쪽 중복): + +| 파일 | 줄 | 조건 | +|---|---|---| +| `platform/autoconfigure/NotificationPlatformCoreConfig.java` | 34-37 | `enabled=true` | +| `platform/autoconfigure/NotificationPlatformRuntimeConfig.java` | 24-27 | `enabled=true` | +| `platform/autoconfigure/NotificationPlatformSecretsConfig.java` | 53-56 | `enabled=true` | +| `platform/autoconfigure/NotificationPlatformRegistriesConfig.java` | 28-31 | `enabled=true` | +| `platform/autoconfigure/NotificationPlatformCodecConfig.java` | 39-42 | `enabled=true` | +| `platform/autoconfigure/NotificationPlatformObservabilityConfig.java` | 35-38 | `enabled=true` | +| `platform/autoconfigure/NotificationPlatformProviderConfig.java` | 37-40 | `enabled=true` | +| `platform/autoconfigure/NotificationPlatformPolicyConfig.java` | — | `enabled=true` | +| `platform/autoconfigure/NotificationPlatformDispatchConfig.java` | 39-42 | `enabled=true` | +| `platform/autoconfigure/NotificationPlatformWorkerConfig.java` | 30-33 | `enabled=true` | +| `email/google/GoogleEmailNotificationAdapterConfig.java` | 18-21 | 추가로 `app.notification.google-email.enabled=true` | +| `slack/webhook/SlackNotificationAdapterConfig.java` | 18-21 | 추가로 `app.notification.slack-webhook.enabled=true` | + +`@ConfigurationProperties` 3종(`NotificationPlatformSettings`, `NotificationRoutesSettings`, +`NotificationSmtpSettings`)은 애노테이션 자체에는 조건이 없지만, 스캔 밖에 있고 +`@EnableConfigurationProperties`가 **게이트된 설정 안에서만** 걸려 있다 +(`NotificationPlatformAutoConfiguration.java:24`, `NotificationPlatformCoreConfig.java:33`, +`NotificationSmtpProviderConfig.java:59`). 그래서 **꺼져 있으면 설정 객체 바인딩 자체가 일어나지 않는다.** +`CaSkeletonApplication.java:20-31` 주석이 이 비대칭("빈은 게이팅, 설정은 아님")을 과거 결함으로 명시하고 +그것을 고친 결과다. + +**(2) 스케줄러 스레드 — 뜨지 않는다. 두 겹으로 막혀 있다.** + +스레드를 실제로 만드는 곳은 두 군데뿐이다. +- `platform/dispatch/NotificationSchedulerWorker.java:62`(`Executors.newVirtualThreadPerTaskExecutor()`) + 와 `:140`(`Thread.ofVirtual()...start()`) +- `platform/dispatch/NotificationBackgroundWorkers.java:115-123`(`newScheduledThreadPool(1)`, 데몬) + +이 둘을 만드는 `@Bean`은 `NotificationPlatformWorkerConfig.ServingWorkerConfig`(`:150`) 안에 있고, +이 중첩 설정은 마스터 스위치 **위에** `mode=SERVING` 조건을 하나 더 들고 있다(`:145-149`). +즉 `enabled=false`면 부모가 로드되지 않아 스레드 0개, `enabled=true`이고 `mode=INGEST_ONLY`면 +자식이 로드되지 않아 역시 스레드 0개. 클래스 주석(`:127-143`)이 "per-bean 조건은 미래의 빈이 잊을 수 있고, +로드되지 않는 설정은 잊을 수 없다"고 설계 의도를 밝힌다. 이 성질은 +`platform/autoconfigure/NotificationWorkerLifecycleTest.java:232-255`가 리플렉션으로 검사한다. + +**(3) 스키마 활성화 체크 — 건너뛰어진다. 엔티티 스캔까지 게이팅했다.** + +`src/adapter/outbound/persistence-jpa/.../notification/NotificationJpaPersistenceConfig.java:21-27`: + +```java +@Configuration(proxyBeanMethods = false) +@ConditionalOnProperty(prefix = "ca-skeleton.notification.platform", name = "enabled", havingValue = "true") +@EntityScan(basePackages = "dev.caskeleton.adapter.outbound.persistence.notification") +@EnableJpaRepositories(basePackages = "dev.caskeleton.adapter.outbound.persistence.notification") +``` + +`@EntityScan`까지 같은 스위치 뒤에 있다는 게 핵심이다. `application.yml:164`의 기본값은 +`ddl-auto: ${APP_DATASOURCE_DDL_AUTO:validate}`이므로, 엔티티가 무조건 스캔되면 알림을 끈 배포에서도 +Hibernate가 `notification_*` 테이블 검증에 실패해 기동이 깨진다. 같은 파일 주석(:12-19)이 그게 실제로 +일어났던 사고라고 기록한다. `NotificationSchemaActivation.requireActive()`(`:58`)는 +`NotificationJpaPersistenceFacade`(`:86`에 같은 조건식)를 통해서만 호출되므로 꺼지면 DB 왕복 0회다. + +**(4) 시크릿 — 필요 없다. 게다가 켜도 "쓰는 것만" 요구한다.** + +시크릿 디코딩은 `NotificationPlatformSecretsConfig.notificationSecretMaterialProvider`(`:96`) 한 곳뿐이고, +그 설정 클래스가 마스터 스위치 뒤에 있다. `secret://` 같은 eager 해석 참조는 이 leaf에 존재하지 않는다 +(`EnvironmentSecretSource`는 `environment.getProperty(key)` 한 줄이고 lazy다). +켠 뒤에도 8개 목적 전부를 요구하지 않고 **켜진 기능이 실제로 쓰는 것만** 요구한다 +(`platform/autoconfigure/NotificationSecretRequirements.java:34-67`): 항상 4개(CONTACT_ENCRYPTION, +CONTACT_LOOKUP_HMAC, PAYLOAD_ENCRYPTION, PROVIDER_REQUEST_LOOKUP_HMAC), 콜백을 켜면 +2, +Web Push 프로파일이 있으면 +VAPID_SIGNING, SMTP 외 프로바이더가 있으면 +PROVIDER_CREDENTIAL. +SMTP는 자격증명을 `spring.mail.*`가 갖고 있으므로 제외한다(`:78-80`). + +**(5) 인라인 기본값 — 44개 플레이스홀더 전부 있다.** + +`config/notification.yml`의 `${...}` 44개를 전부 뽑아 `${VAR}`(기본값 없음) 형태를 찾았다. **0건**이다. +`APP_NOTIFICATION_PLATFORM_*` 42개 + R0 레거시 2개 모두 `${VAR:default}` 형태다. +`docs/registries/env-keys.yaml`에 등록된 `APP_NOTIFICATION_PLATFORM_*`도 정확히 42개이고 +양방향으로 차집합이 0이다(바인딩되지 않은 등록 키 0, 등록되지 않은 바인딩 키 0). + +**종합 판정: notification의 "꺼진 기술은 아무 비용도 물리지 않는다"는 주장은 사실이다.** +남는 비용은 (i) 클래스패스에 있는 jar(`spring-boot-starter-mail`, `thymeleaf`, `reactor-core`, +`json-schema-validator`, `micrometer-core`, actuator 3종), (ii) Boot가 `AutoConfiguration.imports` 1줄을 +읽고 조건식 1개를 평가하는 비용. 둘 다 빈·스레드·커넥션·필수 env가 아니다. +(i)은 `implementation project(':adapter:outbound:notification')`(`app-bootstrap/build.gradle:112`)이 +컴파일 의존이라 생기는 것이고, spec이 이것을 "the later build-inclusion/runtimeOnly phase"로 명시적으로 +미룬다(`docs/superpowers/specs/2026-09-18-notification-capability-composition-ownership.md:56-63`). + +**이 leaf는 다른 leaf가 따라야 할 기준점이다.** 자세한 이유는 §6 K1. + +### 3.2 fileserver — 같은 leaf 안에서 두 능력의 판정이 갈린다 + +| 능력 | 토글 키 | 기본 | 껐을 때 남는 것 | 판정 | +|---|---|---|---|---| +| R2 발행 | `app.fileserver.enabled` | false | `FileserverR2Config` 인스턴스 + `FileserverR2Settings` **바인딩됨** | **부분 위반** | +| R1 export | `app.file-export.enabled` | false | `FileExportConfig` 인스턴스 + `FileExportSettings` **바인딩됨** | **부분 위반** | +| HTTP 플랫폼 | `app.fileserver-platform.enabled` | false | 없음 | **OK** | + +**HTTP 플랫폼(b)은 깨끗하다.** `FileserverPlatformSettings`는 스캔되는 `@ConfigurationProperties`가 아니라 +`FileserverPlatformSettingsBinder.bind(environment)`가 **게이트된 auto-configuration 안에서** +명령형으로 바인딩한다(`app-bootstrap/.../FileserverPlatformAutoConfiguration.java:88`). +공유 유틸 `adapter/outbound/support/StrictSettingsBinder.java:69-72`가 그 이유를 규칙으로 적어 놓았다: + +> "A binder runs inside its master-gated auto-configuration, so a deployment that never enables a +> capability never binds one of its settings — a malformed `Duration` in a block nobody switched on +> cannot fail that deployment's startup." + +**R1/R2(a)는 그 규칙을 따르지 않는다.** `CaSkeletonApplication.java:74`가 +`dev.caskeleton.adapter.outbound.fileserver`를 `@ConfigurationPropertiesScan` 목록에 넣고, +`AUTO_CONFIGURED_PACKAGES` 제외 정규식(:99-113)에는 fileserver가 **없다**. +따라서 `FileserverR2Config`/`FileExportConfig`는 꺼져 있어도 컴포넌트 스캔으로 등록되고, +`FileserverR2Settings`/`FileExportSettings`는 무조건 바인딩된다. 자세한 영향은 §5 M1. + +껐을 때 디렉터리 생성·워처·정리 스케줄러는 **없다**. `FileExportConfig.canonicalDirectory`의 +`Files.createDirectories(root)`(`:222`)는 `@ConditionalOnProperty`가 붙은 `@Bean` 메서드 안에서만 호출되고, +R2의 루트 증명(`LocalPersistentRootAttestor.attest`)도 마찬가지다(`FileserverR2Config.java:69-90`). +`FileserverCleanupWorker`는 `app.fileserver-platform.cleanup.enabled`(기본 false) 뒤에 있다. + +--- + +## 4. 구조 판정 + +| 축 | 판정 | 근거 | +|---|---|---| +| 의존 방향 (modules.json 대조) | **OK (양쪽 다)** | 아래 | +| 경계 누수 (DTO·entity·framework 타입) | **OK 1건 예외(문서화된 레거시)** | 아래 | +| 비즈니스 규칙 위치 | **OK** | 아래 | +| 테스트 전략 적합성 | **부분 미달 (조합 검증 3파일 / 674 테스트)** | 아래 | + +**의존 방향.** `src/config/architecture/modules.json`의 두 항목: + +``` +adapter-outbound-notification: allowed = [domain-core, application-core, shared-contract, adapter-outbound-support] +adapter-outbound-fileserver: allowed = [application-core, shared-contract] +``` + +실제 `build.gradle`의 project 의존: +- `notification/build.gradle:7-9` → `:application-core`, `:shared-contract`, `:adapter:outbound:support` +- `fileserver/build.gradle:14-15` → `:application-core`, `:shared-contract` + +main 소스의 `import dev.caskeleton.*`를 전수 집계한 결과: +- notification(721건): `application.notification.platform` 484, 자기 leaf 153, `application.notification` 81, + `adapter.outbound.support` 3, `shared.error` 1. **`bootstrap`/`domain`/`sample`/다른 adapter 0건.** +- fileserver(263건): `application.fileserver.*` 175, `application.filepublication` 76, + `application.fileexport` 3, 자기 leaf 3, `shared.error` 2. **금지 패키지 0건.** + +notification은 `domain-core`가 허용되어 있는데 한 건도 쓰지 않는다(§5 L5). + +**경계 누수.** R2의 `FilePublishReceipt`/`PublishedFileReference`는 `Path`/`File`/Spring/스트림 타입을 +넘기지 않는다 — `PublishedFileReference`는 `FilePublicationValues.requireOpaque(...)`로 불투명성을 강제한다. +`FilePublicationProvider`는 leaf 내부 `interface`(package-private)라서 포트를 넘지 않는다 +(`FilePublicationProvider.java:54`). notification도 `RoutingNotifier`가 해석된 프로바이더를 반환하지 않는다. + +**예외 1건(문서화됨):** `application.fileexport.ExportedFile`이 `String path`(절대 경로)를 담아 +application-core로 넘어간다. R1 레거시 포트의 명시적 계약이고 `README.md:60-63`이 "returns an absolute +path ... must not be used as R2 durability evidence"라고 기록한다. 신규 결함이 아니라 삭제 대기 중인 부채다. + +**비즈니스 규칙 위치.** 매퍼/설정/핸들러에 비즈니스 규칙이 있는지 봤다. 없다. 오히려 반대 방향의 증거가 있다 — +`NotificationPlatformProviderConfig.java:126-131`이 라우트 선택 정책을 어댑터의 `ConfiguredRoutePlanner`에서 +application-core의 `PolicyRoutePlanner`로 옮긴 이유를 "those decisions used to be made inside +`ConfiguredRoutePlanner`, in the outbound adapter, where no application test could reach them"이라고 적는다. +`RegistryProviderRuntimeControl`(`:14-19`)도 "권한·테넌트·트랜잭션은 여기 없다"고 잔여 책임을 좁혀 놓았다. + +**테스트 전략.** leaf 규칙(가짜 클라이언트·contract test·실네트워크 금지)은 지켜지고, 품질도 높다 — +두 leaf 합쳐 **테스트 메서드 674개, Mockito 0개**(전부 손으로 만든 페이크), fileserver는 26개 파일이 +`@TempDir`로 실제 파일시스템을 쓴다. 문제는 종류의 편중이다. + +| | notification | fileserver | +|---|---|---| +| 테스트 파일 / 메서드 | 70 / **361** | 37 / **313** | +| Spring 컨텍스트를 띄우는 파일 | **1** | **2** | + +**674개 중 조합·배선을 실행하는 것은 3개 파일뿐이다.** 구체적 미달 지점 5개: + +1. 꺼짐 불변식을 실제로 실행하는 테스트는 notification 슬라이스 10개 중 **1개**뿐이다 + (`NotificationPlatformCoreConfigurationTest.java:33-41`, `NotificationPlatformCoreConfig`만 로드). + 나머지 9개는 동일한 애노테이션을 들고 있지만 아무것도 확인하지 않는다. +2. **등록 파일(`.imports`)을 자기 테스트로 지키는 leaf가 11개 중 3개뿐이고, notification은 그 3개에 + 들어가지 않는다**(§5 H6). 이 저장소가 실제로 겪은 "테스트는 초록인데 애플리케이션에는 존재하지 않는 + 빈" 사고를 notification에서 다시 잡아낼 장치가 없다. +3. `LocalVerificationContentReader`는 이름조차 어떤 테스트에도 나오지 않고, 체인 테스트가 람다 reader를 + 쓰기 때문에 **간접 실행 경로도 없다**(§5 C2). +4. C1(SMTP TLS 미적용)을 잡을 수 있었던 자리에서 테스트가 오히려 그 주장을 되풀이한다 — + `SmtpProviderRuntimeAssemblerTest`는 `TlsMode.STARTTLS_REQUIRED`를 넘기면서 + "the transport refusing an unencrypted relay by construction"이라는 주석을 달고, + TLS에 대해서는 **아무것도 단언하지 않는다.** dispatch 람다는 + `throw new UnsupportedOperationException("assembly only; nothing is sent here")`다. +5. H5(비활성 primary 충돌)가 **두 테스트 사이로 빠진다** — + `NotificationProviderAssemblyTest:115 twoPrimariesAreRefused`는 **둘 다 enabled**인 경우를, + `:129 aDisabledProfileAssemblesNothing`은 **disabled + non-primary**인 경우를 검증한다. + 기본 제공 `smtp` 프로파일의 조합(**disabled + primary**)은 어느 쪽에도 없다. + + +--- + +## 5. 발견 + +### Critical + +#### C1. SMTP의 TLS 모드·타임아웃이 3개 레코드를 통과해 전달되지만 트랜스포트에 **한 번도 적용되지 않는다** + +- **현상**: `ca-skeleton.notification.platform.smtp.tls-mode`(기본 `STARTTLS_REQUIRED`), + `connect-timeout`, `read-timeout`, `write-timeout`이 바인딩되고 검증되고 세 개의 레코드를 거쳐 전달되지만, + 실제 SMTP 연결을 만드는 코드에는 도달하지 않는다. 연결은 전적으로 Spring이 만든 `JavaMailSender`가 하고, + 그 동작은 `spring.mail.properties.mail.smtp.*`만 본다. +- **근거**: + - 값의 종착점: `NotificationSmtpProviderConfig.java:201-209`가 + `new SmtpProviderProperties(host, port, settings.tlsMode(), senderIdentity, connectTimeout, readTimeout, writeTimeout, maxConcurrency)`를 만든다. + - 그 레코드를 받는 곳: `SmtpProviderRuntimeAssembler.java:99-110` → `SmtpNotificationProviderAdapter`. + - 어댑터가 실제로 쓰는 필드는 **`senderIdentity()` 하나뿐**이다 + (`SmtpNotificationProviderAdapter.java` `send()` 안의 `properties.senderIdentity()`). + - 실제 전송: `JavaMailSenderSmtpDispatch.java`는 `sender.send(message)` 한 줄이고 + `SmtpProviderProperties`를 아예 받지 않는다. + - 전수 grep: `tlsMode`는 `NotificationSmtpSettings`(선언/검증), `NotificationSmtpProviderConfig:204`(전달), + `SmtpProviderRuntimeAssembler:105`(전달), `SmtpProviderProperties:15/30/44`(선언/검증)에만 등장한다. + `mail.smtp.starttls`를 설정하는 코드나 설정 파일은 저장소 전체에 **0건**이다 + (유일한 등장은 `NotificationSmtpProviderConfig.java:190`의 주석). + - `connectTimeout()`/`readTimeout()`/`writeTimeout()`도 마찬가지로 `NotificationSmtpProviderConfig:206-208`과 + `SmtpProviderRuntimeAssembler:107` 이후 소비처가 없다. +- **왜 문제인가**: JavaMail의 `mail.smtp.starttls.enable` 기본값은 `false`이고, Spring Boot는 이 값을 + 자동으로 켜지 않는다. 그러므로 운영자가 `config/notification.yml:80-82`의 주석 + > "There is no plaintext member: the type refuses an unencrypted relay by construction rather than by + > a validator somebody has to run." + + 을 읽고 TLS가 보장된다고 믿은 상태에서, 587 포트로 **평문 SMTP 세션**이 열린다. + 릴레이가 AUTH를 요구하면 `spring.mail.password`가 평문으로 나간다. + 같은 세션에 렌더된 알림 본문(일회용 코드, 수신자 주소)이 함께 나간다. + **재현 조건**: `APP_NOTIFICATION_PLATFORM_ENABLED=true`, `APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true`, + `SPRING_MAIL_HOST=`, `SPRING_MAIL_PORT=587`, `spring.mail.properties.*` 미설정. + 기대(설정이 말하는 것): STARTTLS. 실제: 평문. 패킷 캡처 한 번이면 판명된다. + 타임아웃도 같은 이유로 무효이므로, 응답하지 않는 릴레이는 `APP_NOTIFICATION_PLATFORM_SMTP_TIMEOUT=10s`와 + 무관하게 JavaMail 기본(무한)까지 스레드를 잡는다. 유일한 실질 방어선은 프로파일당 + `max-concurrency=4`(`ProviderAttemptLimiter`)뿐이다. +- **수정 방향**: 둘 중 하나. (a) `NotificationSmtpProviderConfig`가 `JavaMailSenderImpl`에 + `mail.smtp.starttls.enable`/`.required`, `mail.smtp.ssl.enable`(IMPLICIT_TLS), `connectiontimeout`, + `timeout`, `writetimeout`을 실제로 설정하도록 바꾼다 — 단 그러면 "릴레이는 Spring이 소유한다"는 + 이 파일의 설계 원칙(:44-50)과 충돌한다. (b) 원칙을 지키고 `tls-mode`/타임아웃 4개 키를 **삭제한 뒤**, + 기동 시 `spring.mail.properties.mail.smtp.starttls.enable`이 켜져 있는지 검증하는 validator를 둔다. + (b)가 이 저장소의 다른 결정들과 일관된다 — `NotificationSmtpProviderConfig.java:44-50` 자신이 + "One relay described in two places is a defect this repository has already paid for"라고 쓴 + `app.jpa-platform.datasource.*` 사례와 **정확히 같은 결함**이기 때문이다. +- **반론과 재반박**: 반론 — 배포자가 `spring.mail.properties.mail.smtp.starttls.enable=true`를 직접 넣으면 + 되고, `spring.mail.*`는 Spring의 영역이니 이 leaf의 책임이 아니다. + 재반박 — 그렇다면 `tls-mode` 키가 존재해서는 안 된다. 현재 상태는 **꺼져 있지 않은데 꺼져 있다고 말하는 + 설정**이고, 이 저장소가 스스로 가장 심각한 결함 유형으로 규정한 것이다 + (`NotificationSmtpProviderConfig.java:46-49`: "the validation passed while describing something that + was not running"). 게다가 `SmtpProviderProperties:44`가 "포트 25 + STARTTLS_REQUIRED"만 거부하는 검사를 + 들고 있어서, 값이 실제로 쓰인다는 인상을 한 번 더 강화한다. + +#### C2. 업로드 콘텐츠 검증이 **판독 실패를 ACCEPT로** 바꾼다 — 그리고 그 분기가 바로 템플릿의 기본 설정이다 + +> 1차 리뷰에서 High(H1)로 매겼다. 테스트 107개를 읽고 **Critical로 올린다.** 승격 사유는 §5 C2-3이다. + +- **현상**: `MediaTypeVerifier`와 `ScriptableContentPolicy`는 판정을 위해 `VerificationContentReader`로 + 파일 앞부분을 읽는다. 구현체가 판독 실패를 **예외 대신 빈 배열**로 바꾸고, 두 검증기는 빈 배열을 + "위험 없음"으로 읽는다. 그리고 테스트는 그 경로를 한 번도 지나가지 않는다. + +- **근거 C2-1 (fail-open 경로)**: `platform/verification/LocalVerificationContentReader.java:49-55` + ```java + private byte[] readStagingPrefix(UploadId uploadId, int maxBytes) { + try { return store.readStagingPrefix(uploadId, maxBytes); } + catch (RuntimeException unreadable) { return new byte[0]; } // ← 여기 + } + ``` + `:57-67`의 published 경로도 `catch (IOException | RuntimeException)` 후 **그때까지 읽은 만큼** + (0바이트일 수 있음)을 반환한다. + 빈 배열이 들어가면 `MediaTypeVerifier.java:51-57`은 `requireVerdict==false`일 때 + `accept("MEDIA_TYPE_DEFAULTED", "application/octet-stream")`을, + `ScriptableContentPolicy.java:42-48`은 `accept("NO_SCRIPTABLE_CONTENT")`를 돌려준다. + +- **근거 C2-2 (설계 선언과의 충돌)**: `docs/fileserver/security.md:41-44` + > "A verifier that times out or throws is `RETRY`, never a silent pass, and an empty verifier chain + > answers `RETRY` rather than accepting." + + 그 선언은 `VerificationCoordinator.runBounded`(`:54-66`)에서만 참이다. 판독 실패는 코디네이터에 + **도달하기 전에** 이미 삼켜진다. + +- **근거 C2-3 (승격 사유 — 테스트가 비기본 분기만 검증한다)**: + `platform/verification/VerificationCoordinatorTest.java:169-180`이 실제 체인을 만드는 유일한 곳인데, + ```java + private static VerificationCoordinator designChain(byte[] content) { + VerificationContentReader reader = + (request, maxBytes) -> java.util.Arrays.copyOf(content, Math.min(content.length, maxBytes)); + return new VerificationCoordinator( + List.of(..., new MediaTypeVerifier(reader, true), // ← requireVerdict = true + new ScriptableContentPolicy(reader, false)), + Duration.ofSeconds(2)); + } + ``` + 세 가지가 동시에 성립한다. + 1. `reader`가 **람다**다. 프로덕션 구현 `LocalVerificationContentReader`는 + 저장소 전체에서 **어떤 테스트도 인스턴스화하지 않는다** + (`grep -rl 'LocalVerificationContentReader'` → main 3개 + bootstrap 1개, 테스트 **0개**). + 2. 그 람다는 **실패 모드가 없다.** 판독 실패로 빈 접두부가 체인에 들어가는 시나리오를 검증하는 + 테스트는 하나도 없다. + 3. **`requireVerdict`가 `true`로 고정되어 있다.** 그런데 템플릿이 실제로 배포하는 값은 + `config/fileserver.yml:96`의 `require-media-type-verdict: ${...:false}`다. + `true`면 판독 실패 → `QUARANTINE`(안전), `false`면 → `ACCEPT`(fail-open). + **테스트는 안전한 분기를 증명하고, 배포는 위험한 분기를 돈다.** + +- **왜 Critical인가**: 단순히 "fail-open이 있다"가 아니다. **fail-open이 곧 shipped default이고, + 테스트 스위트가 그 사실을 감춘다.** `VerificationCoordinatorTest`에는 + `scannerTimeoutDoesNotBecomeAccept`(`:42`), + `aThrowingVerifierIsRetryRatherThanASilentPass`(`:52`), + `retryOutranksAcceptSoAnUnavailableScannerNeverPublishes`(`:65`)가 초록으로 있다. + 리뷰어가 이 세 이름을 보면 "판독 실패는 절대 통과 못 한다"고 결론짓는다. 그 결론은 틀렸고, + 틀렸다는 것을 알려 줄 테스트가 없다. + 구체적 실패 시나리오: HTML 본문 업로드 → finalize 직전 스토리지가 `StorageUnavailableException`을 + 던지는 창이 열림 → `readStagingPrefix`가 `byte[0]` 반환 → + `MEDIA_TYPE_DEFAULTED`(octet-stream) + `NO_SCRIPTABLE_CONTENT` → ACCEPT → + 격리되지 않고 READY로 발행. +- **수정 방향**: 세 가지를 같이 해야 한다. + (1) `VerificationContentReader`의 반환 타입을 `Optional`나 sealed 결과 타입으로 바꿔 + "객체가 없다"(정당한 빈 배열)와 "읽을 수 없었다"(RETRY)를 **타입으로 구분**한다. + 최소 수정은 `LocalVerificationContentReader`가 `FileNotFoundException` 계열만 삼키고 나머지는 + 다시 던지는 것 — `VerificationCoordinator.runBounded:63`이 이미 그것을 `RETRY`로 바꾼다. + (2) `designChain`을 `requireVerdict=false`(배포 기본값)로도 돌린다. + (3) `LocalVerificationContentReader`에 대한 테스트를 만든다. 지금은 0개다. +- **반론과 재반박**: 반론 — 서빙 쪽이 무조건 `X-Content-Type-Options: nosniff`와 + `Content-Disposition: attachment`를 붙이므로(§6 K3) 실제 저장형 XSS로는 이어지지 않는다. + 재반박 — 그 방어는 유효하고, 그래서 이 항목은 "원격 코드 실행"이 아니다. 그러나 + (i) 격리(quarantine)는 이 시스템에서 **"사람이 검토하기 전에는 공개하지 않는다"**는 독립된 보장이고 + 그것이 무력화된다, (ii) `MEDIA_TYPE_MISMATCH`는 위장 업로드 탐지 신호인데 그 신호가 사라진다, + (iii) severity 정의상 Critical은 "보안 구멍"이고, **문서가 보장한다고 쓴 보안 불변식이 기본 설정에서 + 성립하지 않으면서 테스트가 그것을 가리는 상태**가 정확히 그것이다. 다중 방어의 한 겹이 없는 것과, + 없다는 걸 아무도 알 수 없는 것은 다른 문제다. + +### High + +#### H2. 문서화된 프로바이더 7종 중 6종은 **조립기가 없어서** 설정하면 기동이 실패한다. SMTP도 오진 메시지를 낸다 + +- **현상**: `ProviderType`은 `APNS | FCM | SES | SMTP | TWILIO | WEB_PUSH | WEBHOOK` 7개를 닫힌 enum으로 + 선언하고, `docs/notification/configuration-reference.md:62`가 그 7개를 설정 가능한 값으로 문서화한다. + 그러나 `ProviderRuntimeAssembler` 구현체는 저장소 전체에 **`SmtpProviderRuntimeAssembler` 1개**뿐이다. +- **근거**: + - `grep 'implements ProviderRuntimeAssembler' src/**/*.java` (테스트 제외) → + `platform/autoconfigure/SmtpProviderRuntimeAssembler.java:48` 단 한 건. + - `platform/autoconfigure/NotificationProviderAssembly.java:95-105`: + ```java + ProviderRuntimeAssembler assembler = assemblers.get(type); + if (assembler == null) { + throw new IllegalStateException("notification provider profile '" + profileId + "' is of type " + + type + ", which has no assembler in this build. The transport is a seam, not an " + + "implementation; remove the profile or supply a ProviderRuntimeAssembler for that family."); + } + ``` + - SMTP 조립기 자체도 `spring.mail.host`가 있을 때만 등록된다 + (`NotificationSmtpProviderConfig.java:58` `@ConditionalOnProperty(name = "spring.mail.host")`). + `spring.mail.host`는 `src/app-bootstrap/src/main/resources/` 어디에도 없고 + `docs/registries/env-keys.yaml`에도 없다(grep 결과 0건). +- **왜 문제인가**: 템플릿 사용자가 `config/notification.yml:60-62`의 안내 + > "a deployment that wants the common case sets `APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true` and + > the relay address below" + + 를 그대로 따르면 — 즉 `APP_NOTIFICATION_PLATFORM_ENABLED=true`, + `APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true`, `APP_NOTIFICATION_PLATFORM_SMTP_SENDER_IDENTITY=...`를 + 설정하면 — `spring.mail.host`가 없어 SMTP 조립기 빈이 만들어지지 않고, 조립 단계가 + **"The transport is a seam, not an implementation"** 이라는 메시지로 기동을 거부한다. + 이 메시지는 **거짓이다.** SMTP 트랜스포트는 구현되어 있다. 진짜 원인은 릴레이 주소가 없는 것이다. + (주: "the relay address below"가 가리키는 `smtp.sender-identity`는 envelope sender이지 호스트가 아니다.) + 나머지 6종은 메시지가 정확하지만, 4,200줄의 어댑터 코드가 존재하는데 설정으로는 닿을 수 없다. +- **수정 방향**: (1) `NotificationSmtpProviderConfig`에 "릴레이가 설정되지 않음"을 구분해서 보고하는 + 경로를 만들거나, `NotificationProviderAssembly`가 `SMTP`일 때는 `spring.mail.host` 부재를 이름으로 지목한다. + (2) `spring.mail.host`/`port`/`username`/`password`를 `config/notification.yml`에 + `${SPRING_MAIL_HOST:}` 형태로 노출하고 env 레지스트리에 등록한다 — 지금은 + `verifyNotificationConfiguration`도 `verifyEnvKeys`도 이 키를 보지 못한다. + (3) `docs/notification/support-matrix.md`의 채널 표에 "설정으로 도달 가능한가" 열을 추가한다. +- **반론과 재반박**: 반론 — support matrix가 이미 5개 채널을 `Contract implemented / runtime unqualified`로 + 낮춰 놓았으니 과장 광고는 아니다. 재반박 — 그 등급은 "와이어 검증이 안 됐다"는 뜻이지 + "설정할 수 없다"는 뜻이 아니다. `configuration-reference.md:62`는 7개 타입을 전부 유효한 설정값으로 + 제시하고, 닫힌 enum이라는 설명까지 붙여서 **선택 가능하다는 인상**을 준다. 등급과 도달 가능성은 다른 축이고 + 문서에 후자가 없다. + +#### H3. `template.engine=thymeleaf`는 DB에 저장된 템플릿 문자열을 OGNL 식으로 평가한다. 그리고 그 키는 설정 트리 어디에도 없다 + +- **현상**: 템플릿 엔진 선택 키가 `@Value` 기본값으로만 존재하고, `thymeleaf`를 고르면 + DB에서 읽은 템플릿 본문이 Thymeleaf StandardDialect(OGNL) 식으로 평가된다. +- **근거**: + - `platform/autoconfigure/NotificationPlatformCoreConfig.java:69-83`: + ```java + public NotificationTemplateEngine notificationTemplateEngine( + @Value("${ca-skeleton.notification.platform.template.engine:placeholder}") String engine) { + return switch (engine.toLowerCase(Locale.ROOT)) { + case "placeholder" -> new PlaceholderTemplateEngine(); + case "thymeleaf" -> new ThymeleafStringTemplateEngine(); + ... + ``` + - `platform/template/ThymeleafStringTemplateEngine.java:143-150`: + ```java + private static TemplateEngine engineFor(TemplateMode mode) { + StringTemplateResolver resolver = new StringTemplateResolver(); + resolver.setTemplateMode(mode); + resolver.setCacheable(false); + TemplateEngine created = new TemplateEngine(); // SpringTemplateEngine 아님 → StandardDialect → OGNL + created.setTemplateResolver(resolver); + return created; + } + ``` + `TemplateEngine`(순수 Thymeleaf)은 `${...}`를 OGNL로 평가한다. OGNL은 `@java.lang.Runtime@getRuntime()` + 형태의 정적 메서드 호출을 허용한다. + - 템플릿 본문의 출처: `platform/autoconfigure/NotificationPlatformProviderConfig.java:52-61`이 + `TemplateRegistry`(= `JpaTemplateRegistry`, DB 테이블)에서 읽은 슬롯 소스를 그대로 엔진에 넘긴다 + (`CanonicalNotificationRenderer.java` `slot()` → `engine.render(mode, template.content().requireSlot(slot), variables)`). + 템플릿을 쓰는 입구는 `adapter/inbound/web/.../NotificationTemplateController`다. + - 키의 부재: `grep 'template.engine\|TEMPLATE_ENGINE'`을 + `src/app-bootstrap/src/main/resources/`, `docs/registries/env-keys.yaml`, `docs/notification/`에 돌려 + **0건**이다. 즉 `config/notification.yml`에 없고, env 키로 등록되어 있지 않고, 설정 레퍼런스에도 없다. +- **왜 문제인가**: 두 가지가 겹친다. + (a) **키가 보이지 않는다.** `config/notification.yml:44-45`가 "Every value carries an inline default so + that a deployment leaving the platform off never has to supply an environment variable"이라고 주장하는데, + 이 키는 트리에 없으므로 그 문장의 적용 범위 밖이다. `verifyNotificationConfiguration`은 + `APP_NOTIFICATION_PLATFORM_*` 플레이스홀더만 비교하므로(`NotificationConfigurationVerifier.java:18`) + `ca-skeleton.*` 전용 키는 구조적으로 못 본다. 템플릿 사용자는 이 스위치의 존재를 코드를 읽어야 안다. + (b) **켜면 템플릿이 데이터에서 코드가 된다.** 템플릿 작성 권한(운영자/관리자)이 곧 프로세스 실행 권한이 + 된다. 관리자가 신뢰 대상이라 해도, 알림 템플릿 편집은 보통 RCE와 같은 등급의 권한으로 취급되지 않는다. +- **수정 방향**: `ThymeleafStringTemplateEngine`의 `TemplateEngine`에서 StandardDialect의 식 평가를 + 제한하거나(허용 식 화이트리스트), 최소한 이 키를 `config/notification.yml`에 노출하고 + `configuration-reference.md`에 "이 값을 바꾸면 템플릿 본문이 식으로 평가된다"는 경고와 함께 등록한다. +- **반론과 재반박**: 반론 — 기본값이 `placeholder`이고 `PlaceholderTemplateEngine`은 식 평가기가 아예 없다 + (`:14` 정규식 `\{([a-zA-Z0-9_.-]{1,64})\}` 치환뿐). `NotificationPlatformCoreConfig.java:64-67`가 그 이유를 + 명시적으로 적는다. 재반박 — 기본값이 안전하다는 것과 위험한 대안이 문서 없이 존재한다는 것은 별개다. + 이 저장소의 다른 위험 토글(`allow-ambiguous-fallback`)은 **바인딩 단계에서 아예 거부**한다 + (`NotificationPlatformSettings.java:68-73`). 같은 저장소가 더 위험한 스위치는 문서 없이 열어 두었다. + +#### H4. 도달 불가 8,001줄은 **한 덩어리가 아니다.** 4,169줄은 미완성 실험(삭제), 3,832줄은 완성 자산(배선) + +> 1차 리뷰는 "88개 클래스가 도달 불가"라는 **사실**만 확정했다. 2차에서 그 83개 파일을 전부 읽었고, +> **성질이 정반대인 두 덩어리**였다. 이 구분이 "지울 것인가 배선할 것인가"를 가른다. + +##### H4-A. R1 canonical graph 세대 — **미완성 실험이다. 삭제가 맞다.** + +`catalog/`(12파일 1,500줄) + `provider/`(18파일 1,170줄) + `template/`(6파일 1,162줄) = **36파일 3,832줄**, +여기에 `application-core/.../application/notification/` 최상위 클래스 100개가 딸려 있다. + +설계 자체는 야심적이다 — provider capability card, route revision, 증폭 상한 +(`maximumTargets × maximumPhysicalAttempts + maximumReconcileCalls ≤ maximumTotalProviderCalls`, +`NotificationBindingCompiler.java:256-264`), fallback 그래프 순환 검출(`:293-323`), +"indeterminate 후 fallback은 불안전"이라는 거부 규칙(`:363-366`). +`LocalEmailRenderer`의 컨텍스트 인식 HTML 이스케이핑(승인 태그/속성 allowlist, URL 컴포넌트 인코딩, +확장 바이트 사전 투영)은 **R2의 `TemplateSlotPolicy.escapeHtml`(무맥락 5문자 치환)보다 명백히 낫다.** + +그런데 **배선할 대상이 없다.** 네 가지가 동시에 비어 있다. + +| 없는 것 | 확인 방법 | 결과 | +|---|---|---| +| 설정 입력원 | `grep -rl 'new NotificationRouteDescriptor\|new NotificationProviderDescriptor\|new NotificationProviderRuntimeProfile\|new NotificationTemplateDescriptor\|new NotificationBindingCompiler'` | main **0건**, 테스트 2파일뿐 | +| 와이어 클라이언트 | `NotificationProviderAttemptClient` 구현 | main **0건** (테스트 3파일만 구현) | +| 레이트 어드미션 | `NotificationProviderRateAdmission` 구현 | **0건** | +| 시크릿 제공자 | `NotificationProviderSecretMaterialProvider` 구현 | **0건** | + +설정 키도 없다 — `route-descriptor|runtime-profile|capability-card|binding-revision`을 +`app-bootstrap/src/main/resources/` 전체에서 grep하면 **0건**이다. +즉 컴파일러를 Spring에 등록해도 **컴파일할 입력이 존재하지 않는다.** + +미완성의 흔적도 코드에 남아 있다. +- `NotificationProviderCapabilityCard.initial(cardId)`(`:38-84`)이 **하드코딩 switch**로 + `slack-web-api-inline-single-local-v1`, `slack-web-api-durable-single-local-v1`, + `aws-ses-v2-durable-single-local-sns-v1` **3장만** 허용한다. + **유일하게 작동하는 프로바이더인 SMTP는 이 3장에 없다.** + `NotificationBindingCompiler.java:135-147`의 `INITIAL_CARD_IDS`/`APPROVED_CARD_PROVIDERS`가 + 그 3장을 한 번 더 못박는다. 프로바이더 추가가 "새 파일"이 아니라 **이 switch 수정**이다 — + R0(`NotificationProvider` 빈 기여)와 R2(`ProviderRuntimeAssembler` SPI) 둘 다보다 나쁜 확장점이다. +- `validateRouteShape`(`:246-292`)가 `SINGLE`이 아니면 무조건 거부 + ("initial notification catalog supports SINGLE route strategy only")하면서, 바로 아래에 + `FAN_OUT_ALL`/`ORDERED_FALLBACK` 검증 분기를 **도달 불가 상태로** 들고 있다. +- `NotificationReconciliationAdapter.supportsLookup`(`:~150`)이 + `cardId().equals("aws-ses-v2-durable-single-local-sns-v1")` 매직 스트링으로 화해를 한 장에 못박는다. + +**판정: 삭제.** 배선 비용이 "설정 바인딩 계층 전체 + 와이어 클라이언트 3종 + 레이트/시크릿 구현"이고, +그 결과물은 이미 살아 있는 R2가 더 넓은 프로바이더 집합으로 하고 있는 일이다. +`README.md:57-78`의 "Wave G deletion inventory"가 R0에 대해 이미 같은 약속을 하고 있으니 +**R1 항목을 그 목록에 추가하는 것**이 이 저장소의 기존 방식과 일치한다. +다만 `LocalEmailRenderer`의 컨텍스트 인식 이스케이핑은 **버리지 말고 R2의 `TemplateSlotPolicy`로 이식**해야 한다. + +##### H4-B. R2 비-SMTP 프로바이더 6종 — **완성 자산이다. 배선이 맞다.** + +`platform/provider/{ses,twilio,fcm,apns,webpush,webhook}/` 47파일 **4,169줄**. +이들은 R1과 달리 **현재 배선된 R2 런타임이 실제로 소비하는 SPI** +(`NotificationProviderAdapter`, `ProviderCallbackAdapter`, `ProviderEventProjector`, +`ReconciliationCapability`)를 구현한다. 품질은 프로덕션급이다. + +- **SES**: AWS SigV4 서명을 손으로 구현(`AwsSignatureV4Signer` — canonical request, credential scope, + signing key derivation), SES v2 `Simple`/`Raw` 콘텐츠 분기, SNS 서명 검증 + (`SnsSignatureVerifier` — 인증서 URL을 https·포트443·호스트 접미사·`/SimpleNotificationService-*.pem` + 경로로 제한), 이벤트 정규화(Send→PROVIDER_ACCEPTED, Delivery→DELIVERY_CONFIRMED, + Bounce→HARD/SOFT, Complaint), 서프레션 반영. +- **Twilio**: HMAC-SHA1 서명 검증 + `MessageDigest.isEqual` 상수시간 비교, 상태 조회 기반 화해 + (`TwilioReconciliationCapability` — pending 상태 재조회, 창 만료 처리), 에러코드 21211/21214/21610 등 + invalid-number 분류. +- **WebPush**: **RFC 8291 aes128gcm 전문 구현**(P-256 ECDH, HKDF extract/expand, salt+rs+키길이 헤더, + 0x02 패딩 구분자) + **RFC 8292 VAPID ES256 JWT**(DER→JOSE 변환 포함), 키 회전용 + `VapidKeyRegistry.requiresSubscriptionMigration`. +- **Webhook**: 신뢰/동적 게이트웨이 분리 + `NotificationEndpoints.requireExternallyRoutable` + (모든 DNS 응답 검사, 100.64/10·192.0.0/24·fc00::/7 포함), HMAC 서명, 진단 본문 512바이트 절단. +- **APNs/FCM**: 4096바이트 페이로드 상한, TTL 파생, 토큰 무효화 분류, FCM 배치 상한 500. + +배선에 실제로 필요한 것은 넷이고, 전부 **경계가 명확하고 유한하다.** + +| 필요한 것 | 규모 | +|---|---| +| 패밀리별 `ProviderRuntimeAssembler` 6개 | `SmtpProviderRuntimeAssembler`(164줄)가 그대로 본보기 | +| `NotificationPlatformSettings.Provider`에 필드 추가 | 현재 11개 필드로는 `endpoint`/`region`/`projectId`/`accountSid`/`fromNumber`를 **표현할 수 없다** | +| `config/notification.yml` + `env-keys.yaml` 확장 | 키당 1줄씩 | +| FCM `FcmGateway` 구현 1개, APNs `Supplier`(ES256 JWT) 1개 | 나머지 4종은 와이어까지 완성 | + +**판정: 배선.** 단 위 표의 2행이 진짜 작업량이다 — +`NotificationPlatformSettings.Provider`가 이 프로바이더들이 요구하는 필드를 담지 못하므로 +설정 레코드·YAML·env 레지스트리를 같이 늘려야 한다. "assembler만 쓰면 된다"는 과소평가다. + +##### H4-C. 템플릿 사용자에게 주는 답 + +- **지금 당장**: `docs/notification/module-mapping.md`에 "조립 경로 있음/없음" 열을 추가해 + 88개를 표시한다. 이것만으로도 fork한 사람이 **살아 있는 코드를 고르는 비용**이 사라진다. +- **다음**: R1(3,832줄 + application-core 100클래스)을 삭제 인벤토리에 올린다. +- **그 다음**: 필요한 채널부터 R2 assembler를 하나씩 쓴다. 전부 할 필요 없다 — SES 하나만 배선해도 + `support-matrix.md`의 Email 행이 처음으로 설정 가능해진다. +- **반론과 재반박**: 반론 — 전환 중 코드가 공존하는 건 정상이고, 삭제는 되돌리기 어렵다. + 재반박 — 공존 자체가 아니라 **공존이 문서화되어 있지 않은 것**이 문제다. `README.md`는 R0만, + `CLAUDE.md`는 R0만 설명하고 **R1의 존재는 저장소 어느 문서에도 없다.** 전환이 진행 중인 것과 + 전환이 두 번 중단된 것은 다르고, 후자를 후자라고 적어 두는 것이 삭제보다 먼저다. + +#### H5. **비활성** 프로바이더 프로파일이 primary 충돌 검사에 참여한다 — 기본 제공 `smtp` 프로파일이 지뢰다 + +- **현상**: 채널당 primary가 하나인지 검사하는 로직이 `enabled` 여부를 보지 않는다. +- **근거**: `platform/autoconfigure/NotificationProviderAssembly.java:144-164` + ```java + private static void refuseAmbiguousRoutes(Map> claimants, + NotificationPlatformSettings settings) { + Map primaries = new HashMap<>(); + settings.providers().forEach((profileId, profile) -> { + if (profile.primaryForChannel()) { // ← enabled 검사 없음 + String channel = ProviderType.parse(profileId, profile.type()).channel().name(); + String previous = primaries.put(channel, profileId); + if (previous != null) { + throw new IllegalStateException("profiles '" + previous + "' and '" + profileId + + "' are both marked primary for channel " + channel); + } + } + }); + ``` + 같은 메서드의 조립 루프(`:88-93`)는 `if (!profile.enabled()) continue;`로 비활성을 건너뛴다. + 즉 한 파일 안에서 두 루프가 `enabled`에 대해 다른 규칙을 쓴다. + 그리고 기본 제공 프로파일이 정확히 이 조건을 만족한다 — `config/notification.yml:66-71`: + ```yaml + providers: + smtp: + type: SMTP + enabled: ${APP_NOTIFICATION_PLATFORM_SMTP_ENABLED:false} # 비활성 + primary-for-channel: ${APP_NOTIFICATION_PLATFORM_SMTP_PRIMARY:true} # 그러나 primary + ``` +- **왜 문제인가**: fork한 프로젝트가 SES를 쓰려고 자기 YAML에 + `ca-skeleton.notification.platform.providers.ses-primary.{type: SES, enabled: true, primary-for-channel: true}`를 + 추가하면, 켜 놓지도 않은 `smtp` 프로파일 때문에 + `profiles 'ses-primary' and 'smtp' are both marked primary for channel EMAIL`로 **기동이 실패한다.** + 메시지는 두 프로파일을 지목하지만 그 중 하나는 꺼져 있으므로, 사용자는 왜 꺼진 것이 문제인지 알 수 없다. + 해결하려면 `APP_NOTIFICATION_PLATFORM_SMTP_PRIMARY=false`를 설정해야 하는데 이건 문서 어디에도 없다 + (`configuration-reference.md`는 이 키를 "exactly one primary per channel"로만 설명한다). + 부수 효과가 하나 더 있다: `:152`의 `ProviderType.parse(profileId, profile.type())`도 비활성 프로파일에 + 대해 호출되므로, **비활성 + `primary-for-channel: true` + 알 수 없는 type** 조합은 기동을 깨뜨린다 + (`Provider.validate`는 `:147`에서 비활성을 건너뛰므로 바인딩은 통과한다). +- **수정 방향**: `refuseAmbiguousRoutes`의 `primaries` 수집에 `profile.enabled()` 조건을 추가한다. + 조립 루프와 같은 규칙이 된다. +- **반론과 재반박**: 반론 — 비활성 프로파일의 `primary` 표시도 잘못된 설정이니 일찍 거부하는 게 fail-fast다. + 재반박 — 그 논리라면 비활성 프로파일의 **모든** 필드를 검증해야 하는데 + `Provider.validate(:147)`가 정반대로 하고 있다("A disabled profile is bound and validated but contributes + no runtime"이라고 문서는 말하지만 코드는 `if (!enabled) return;`). 같은 파일 안에서 두 규칙이 충돌하고, + 충돌의 대가를 **기본 제공 설정 그대로 쓰는 사용자**가 치른다. + +#### H6. 등록 파일(`.imports`)을 자기 테스트로 지키는 leaf는 **11개 중 3개뿐**이고, 알려진 고장은 전부 나머지 8개에 있다 + +> **정정 이력**: 1차 제출에서 나는 이것을 *"`.imports`를 읽는 테스트가 저장소 전체에 0개"*라고 썼다. +> **틀렸다. 3개 있다.** 코디네이터 반증 → 직접 재확인 → 아래 형태로 다시 썼다. +> 오류 원인과 원래 주장은 §9.5에 남긴다. **고친 형태가 원래 주장보다 강하다** — 없는 관행을 +> 발명하라는 권고가 아니라, **이미 세 곳에 있는 관행을 규약으로 승격**하라는 권고가 되기 때문이다. + +- **현상**: Spring Boot가 auto-configuration을 등록하려면 두 가지가 **모두** 필요하다 — + 클래스의 `@AutoConfiguration` 애노테이션과, `META-INF/spring/org.springframework.boot + .autoconfigure.AutoConfiguration.imports` 파일에 그 FQCN이 적혀 있는 것. + 저장소에는 그 등록 파일이 **11개** 있고, **자기 파일을 테스트로 지키는 것은 3개**다. + +- **근거 1 — 전수 집계** (`find src -path '*META-INF/spring/*AutoConfiguration.imports'`, + 그리고 `grep -rl 'META-INF/spring/' --include=*.java`): + + | # | `.imports` 보유 leaf | 줄 | 자기 파일을 읽는 테스트 | + |---|---|---|---| + | 1 | `adapter/inbound/graphql` | 1 | **있음** — `GraphQlPlatformAutoConfigurationTest:186-196` | + | 2 | `adapter/outbound/persistence-jpa` | 2 | **있음** — `PersistenceJpaAutoConfigurationTest:61-72` | + | 3 | `grpc/grpc-spring-boot-starter` | 1 | **있음** — `GrpcPlatformStartupValidatorTest:244-255` | + | 4 | `adapter/inbound/web` | 2 | 없음 | + | 5 | `adapter/outbound/cache-redis` | 1 | 없음 | + | 6 | `adapter/outbound/httpclient` | 1 | 없음 | + | 7 | `adapter/outbound/messaging` | 1 | 없음 | + | 8 | **`adapter/outbound/notification`** | **1** | **없음 ← 내 영역** | + | 9 | `adapter/outbound/persistence-mongo` | 1 | 없음 | + | 10 | `app-bootstrap` | 5 | 없음 | + | 11 | `messaging/messaging-spring-boot-starter` | 1 | 없음 | + + 세 곳의 방식은 전부 **리소스 경로 문자열**이다 — graphql은 헬퍼 `readClasspathResource(...)`, + persistence-jpa는 `getResourceAsStream(resource)`(경로가 변수), grpc는 `read(Path.of("src/main/resources/..."))`. + Boot가 실제로 쓰는 `ImportCandidates` API 사용은 **0건**이 맞다. + (집계 주의: 코디네이터는 12개로 셌고 나는 11개다. 차이는 `app-bootstrap`으로, 코디네이터는 2개, + 내 `find`는 `src/app-bootstrap/src/main/resources/...` 1개만 잡는다. 어느 쪽이든 판정은 같다.) + +- **근거 2 — 알려진 고장이 전부 "테스트 없는 8개" 쪽에 있다** (코디네이터 확정 교차 사실): + - `app-bootstrap`의 `.imports`(5줄)에 redis·outbox·lock·idempotency·tracing **5개가 누락**돼 있다. + - `cache-redis`의 `.imports`는 `dev.caskeleton.adapter.outbound.cache.redis.sdk.config.RedisSdkAutoConfiguration` + **한 줄뿐**이다 — SDK 계층만 등재되고 능력 조립은 등재되지 않았다(내가 파일 내용을 직접 확인했다). + - 테스트를 가진 3개에서는 같은 종류의 고장이 보고된 바 없다. + + **즉 이건 "아무도 안 하는 일"이 아니라 "세 곳은 하는데 규약이 아니라서 나머지 여덟 곳이 빠진 일"이다.** + 관행의 부재가 아니라 관행의 미승격이 원인이므로, 수정 비용도 새 설계가 아니라 복제다. + +- **내 영역의 구체적 노출**: notification leaf의 등록 파일은 **정확히 1줄**이고 + (`dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationPlatformAutoConfiguration`) + 이번 리팩토링에서 **신규 생성된 untracked 파일**이다. 그리고 그 1줄을 지키는 테스트가 없다. + `NotificationPlatformReachabilityTest.java:17-22`가 검사하는 것은 + ```java + assertThat(AnnotatedElementUtils.hasAnnotation( + NotificationPlatformAutoConfiguration.class, AutoConfiguration.class)).isTrue(); + ``` + — **클래스에 애노테이션이 붙어 있는가**이지, 등록 파일이 그것을 나열하는가가 아니다. + +- **왜 문제인가 — 구체적 실패 시나리오**: 그 1줄 파일을 지운다(또는 리소스 필터링·셰이딩·jar 머지에서 누락된다). + - `NotificationPlatformReachabilityTest` **통과**(애노테이션은 그대로다), + - `NotificationPlatformImportCoverageTest` **통과**(`@Import` 그래프는 그대로다), + - `NotificationPlatformCoreConfigurationTest` **통과**(`withUserConfiguration`으로 직접 공급한다), + - `NotificationWorkerLifecycleTest` **통과**(리플렉션으로 애노테이션만 본다), + - 그리고 **알림 능력은 `enabled=true`를 줘도 영원히 뜨지 않는다.** + + 이건 가설이 아니다. 삭제된 bootstrap `NotificationPlatformReachabilityTest`의 javadoc이 + **그 사고가 실제로 있었다고** 기록한다(diff 전문에서): + > "`NotificationPlatformAutoConfiguration` is named like an auto-configuration but annotated + > `@Configuration` ... the notification leaf ships no `AutoConfiguration.imports`. It was imported + > by no root and scanned by no package. The six beans it declares ... therefore existed in no + > running application. **Its own test passed throughout**, because that test builds an + > `ApplicationContextRunner` with `AutoConfigurations.of(NotificationPlatformAutoConfiguration.class)` + > — it supplies the registration the runtime was missing, and then verifies the beans it just + > caused to exist." + + 이번 리팩토링은 **애노테이션과 파일을 둘 다 만들어서** 그 사고를 고쳤다. 그러나 **파일 쪽을 지키는 + 테스트는 만들지 않았다.** 사고는 고쳐졌고 재발 방지는 안 됐다 — 그리고 같은 저장소의 다른 세 leaf는 + 이미 그 재발 방지를 갖고 있다. + +- **severity 판단: High 유지.** 근거가 바뀌었지만 등급은 그대로다. + (i) 결과가 "능력이 조용히 죽음"이고 **모든 테스트가 초록인 채로** 그렇게 된다, + (ii) 실제로 한 번 일어났고 문서로 기록돼 있다, + (iii) 같은 계열의 고장이 지금 다른 두 곳(`app-bootstrap` 5개 누락, `cache-redis` 조립 미등재)에 + **현재진행형으로 존재한다.** + Critical로 올리지 않는 이유는 notification 쪽은 지금 파일이 **있고 올바르기** 때문이다 — + 이것은 발생한 결함이 아니라 **재발 방지 장치의 부재**다. + +- **수정 방향**: 세 곳의 관행을 **규약으로 승격**한다. 단 형태는 개선한다 — + 세 곳이 쓰는 리소스 경로 문자열은 **파일이 옮겨지면 같이 따라가지 않는다** + (grpc는 아예 `Path.of("src/main/resources/...")`로 빌드 디렉터리 구조에 의존한다). + Boot가 실제로 쓰는 API로 바꾼다: + ```java + assertThat(ImportCandidates.load(AutoConfiguration.class, getClass().getClassLoader())) + .contains(NotificationPlatformAutoConfiguration.class.getName()); + ``` + 이러면 파일 위치·패키징 방식과 무관하게 **Boot가 보는 것과 같은 것**을 본다. + `.imports`를 가진 11개 leaf 전부에 한 줄씩 넣는다. + 더 강한 형태는 `verifyCleanArchitectureDependencies` 옆에 저장소 수준 태스크를 하나 두어 + "`.imports`를 가진 leaf는 그 파일을 검증하는 테스트를 가져야 한다"를 강제하는 것이다. + +- **반론과 재반박**: 반론 — 통합 테스트가 실제 컨텍스트를 띄우면 등록 누락은 거기서 잡힌다. + 재반박 — **notification에는 그런 통합 테스트가 없다.** §5 H6 부록 계수대로 notification leaf에서 + Spring 컨텍스트를 띄우는 테스트 파일은 **1개**이고, 그 1개가 `withUserConfiguration`으로 등록을 + 스스로 공급하는 바로 그 형태다. fileserver 쪽은 `app-bootstrap`의 + `FileserverPlatformAutoConfigurationTest`가 `AutoConfigurations.of(FileserverPlatformAutoConfiguration.class)`를 + 쓰는데 그 클래스가 `app-bootstrap` `.imports:1`에 실제로 등재돼 있어 러너와 프로덕션이 일치한다 — + **fileserver는 우연히 안전하고 notification은 우연히 위험하다.** 우연에 기대는 것이 문제이고, + 그 우연을 규약으로 바꾸는 방법이 이미 저장소 안에 세 개 있다. + + +##### H6 부록 — 부품 검증 vs 조합 검증 계수 + +| 지표 | notification | fileserver | +|---|---|---| +| 테스트 파일 | 70 | 37 | +| 테스트 메서드(`@Test`/`@ParameterizedTest`/`@RepeatedTest`) | **361** | **313** | +| Spring 컨텍스트를 띄우는 파일 | **1** | **2** | +| `@TempDir`(실제 파일시스템) 사용 파일 | 0 | 26 | +| Mockito 사용 | 0 | 0 | +| `AutoConfigurations.of(...)` 사용 | 0 | 0 | +| `withUserConfiguration(...)` 사용 | 1 | 2 | + +**674개 테스트 메서드 중 조합·배선을 실제로 실행하는 것은 3개 파일에서만 나온다.** +나머지는 전부 부품 검증이다(품질은 높다 — Mockito 0개, 전부 손으로 만든 페이크와 실제 파일시스템). + +자기등록(테스트가 스스로 설정을 공급) 형태의 **현재** 분포: + +| 파일 | 공급 방식 | 프로덕션 등록 경로 | 일치? | +|---|---|---|---| +| `notification/.../NotificationPlatformCoreConfigurationTest` | `withUserConfiguration(NotificationPlatformCoreConfig.class)` | `.imports` → 루트 → `@Import` (3단계) | **불일치.** 3단계 중 1단계(파일)가 미검증 | +| `fileserver/.../FileserverR2ConfigTest` | `withUserConfiguration(FileserverR2Config.class)` | 컴포넌트 스캔 | 일치 | +| `fileserver/.../FilePublicationConfigTest` | `withUserConfiguration(FileExportConfig.class)` | 컴포넌트 스캔 | 일치 | +| `app-bootstrap/.../FileserverPlatformAutoConfigurationTest` | `AutoConfigurations.of(FileserverPlatformAutoConfiguration.class)` | `app-bootstrap` `.imports:1` | 일치(우연) | +| `app-bootstrap/.../FileserverRuntimeAssemblyTest` | 동상 | 동상 | 일치(우연) | +| ~~`app-bootstrap/.../NotificationAutoConfigurationTest`(이전)~~ | ~~`AutoConfigurations.of(NotificationPlatformAutoConfiguration.class)`~~ | ~~없음~~ | **과거의 사고. 지금은 수정됨** | + +**추가 계수 — 테스트가 이름조차 언급하지 않는 production 클래스:** +notification main 187개 중 **59개(3,190줄)**, fileserver main 79개 중 **26개(1,973줄)**. +(주의: "이름이 안 나온다"가 "실행이 안 된다"는 아니다. `StreamingCsvEncoder`는 +`LocalFilePublicationAdapterTest`를 통해, `SecureDirectoryWalk`는 `LocalStorageGatewayContractTest`를 +통해 간접 실행된다. 그러나 **`LocalVerificationContentReader`는 이름도 안 나오고 간접 실행 경로도 없다** — +테스트가 람다 reader를 쓰기 때문이다. 그게 C2의 결정적 근거다.) + + +### Medium + +#### M1. fileserver R1/R2 설정은 꺼져 있어도 바인딩된다 — **httpclient와 같은 결함 계열이다** + +> 코디네이터가 확정해 준 교차 사실로 재서술한다. 이건 fileserver 고유의 실수가 아니라 +> **저장소 전체에 세 가지 상태가 공존하는 문제의 한 사례**다. + +- **세 가지 상태**(코디네이터 확정 + 내 확인): + + | leaf | 제외 정규식(`CaSkeletonApplication:99-113`) | `.imports` 등재 | 자식 `@Configuration` 조건 | 결과 | + |---|---|---|---|---| + | notification | **있음**(`adapter\.outbound\.notification\..*`) | 있음 | 전 슬라이스에 있음 | **정상** | + | httpclient | **없음** | 있음 | 자식 9개에 클래스 레벨 조건 **없음** | 꺼져도 스캔됨 | + | redis | 있음 | (코디네이터: 등재 없음) | — | 조립 자체가 도달 불가 | + | **fileserver R1/R2** | **없음** | (leaf에 `.imports` 자체가 없음 — bootstrap 소유) | `@Bean`에만 있고 클래스에는 없음 | **꺼져도 스캔·바인딩됨** | + + fileserver는 여기에 더해 `@ConfigurationPropertiesScan` 목록(`CaSkeletonApplication:74`)에도 + 올라가 있어서, 빈뿐 아니라 **설정 객체까지** 무조건 바인딩된다. + `FileserverR2Config`/`FileExportConfig`는 클래스 레벨 조건 없이 `@Configuration`만 달고 있고 + 조건은 `@Bean` 메서드에만 있다 — **httpclient의 자식 9개와 정확히 같은 형태다.** +- **근거**: + - `FileserverR2Settings.java:7` — `@ConfigurationProperties(prefix = "app.fileserver", ignoreUnknownFields = false)` + - `CaSkeletonApplication.java:74` — `@ConfigurationPropertiesScan`에 `dev.caskeleton.adapter.outbound.fileserver` 포함 + - `CaSkeletonApplication.java:99-113` — 제외 정규식에 fileserver **없음** + (mongo/messaging/notification/persistence/graphql은 있다) + - 같은 파일 `:27`이 "The five optional adapters are absent from the list below on purpose"라고 쓰는데 + fileserver는 `:74`에 **있다.** 즉 주석이 세는 다섯 개에 fileserver가 안 들어간다. + - 반대쪽 규칙은 이미 추출되어 있다 — `adapter/outbound/support/StrictSettingsBinder.java:69-72`: + > "A binder runs inside its master-gated auto-configuration, so a deployment that never enables a + > capability never binds one of its settings — a malformed `Duration` in a block nobody switched + > on cannot fail that deployment's startup." + + 그리고 **같은 leaf의 HTTP 플랫폼은 그 규칙을 따른다** + (`FileserverPlatformSettingsBinder.java:20-23` → `FileserverPlatformAutoConfiguration.java:88`). + 한 leaf 안에서 두 능력이 반대 방향을 향한다. +- **왜 문제인가**: `ignoreUnknownFields = false` + 무조건 바인딩 = + **능력을 끈 배포에서도 `app.fileserver.*` 아래 오타 하나가 기동을 깨뜨린다.** + 재현: `app.fileserver.enabled=false`로 두고 + `app.fileserver.destinations.local-export.maximum-row: 1000`(`maximum-rows` 오타) → 기동 실패. + 그리고 이 동작은 **테스트로 고정되어 있다** — `FileserverR2ConfigTest:312` + `unknownConfigurationFieldIsRejectedInsteadOfSilentlyIgnored`가 오타 거부를 검증하고, + `:48 disabledR2CreatesNoPortOrFilesystemSideEffect`는 빈 부재만 검증할 뿐 + `FileserverR2Settings`가 미바인딩임은 검증하지 않는다(할 수 없다 — 실제로 바인딩된다). + 대조군이 바로 옆에 있다: `FileserverPlatformAutoConfigurationTest:44-48`은 + `doesNotHaveBean(FileserverPlatformSettings.class)`를 **직접 단언한다.** + `StrictSettingsBinder` 패턴은 그 단언이 가능하고, 스캔 패턴은 불가능하다. +- **severity 재검토 결과: Medium 유지.** Critical/High로 올리지 않는 이유는 + (i) 실패가 기동 시점이고 조용하지 않다, (ii) 데이터 손상이나 보안 구멍이 아니다, + (iii) 트리거가 운영자의 오타이지 공격자 입력이 아니다. + 다만 **httpclient 쪽 severity와 맞춰야 한다** — 같은 계열이면 같은 등급이어야 하고, + httpclient는 자식 9개가 스캔되므로 영향 범위가 더 넓다. +- **수정 방향**: 둘 중 하나. (a) `dev.caskeleton.adapter.outbound.fileserver`를 + `@ConfigurationPropertiesScan`에서 빼고 제외 정규식에 넣은 뒤, R1/R2 조립을 게이트된 + auto-configuration + `StrictSettingsBinder`로 옮긴다(= notification이 방금 한 것). + (b) 최소한 클래스 레벨 `@ConditionalOnProperty`를 `FileserverR2Config`/`FileExportConfig`에 단다. + (a)가 맞다 — §7.3대로 이 저장소는 이미 그 방향의 물결 중이고, fileserver만 남았다. +- **반론과 재반박**: 반론 — 레코드 2개 바인딩은 비용이 사실상 0이고, 스레드도 커넥션도 아니다. + 재반박 — 비용이 아니라 **실패 모드**가 문제다. 꺼진 능력이 기동을 깨뜨릴 수 있으면 + "꺼진 기술은 아무 비용도 물리지 않는다"는 목표가 성립하지 않는다. + 그리고 이건 notification에서 이미 고친 결함의 재발이며, 저장소가 그 고침을 + `CaSkeletonApplication.java:20-31`에 명문으로 적어 두었다. + +#### M2. 레디니스 임계값이 하드코딩되어 있다 — 클래스 자신이 그러면 안 된다고 쓴 채로 + +- **근거**: `platform/observation/NotificationServingThresholds.java:41-49`가 + `DEFAULT`를 `(100_000, 10분, 50, 50_000, 1_000, 15분, 30분)`으로 고정하고, + `NotificationPlatformObservabilityConfig.java:86`이 `NotificationServingThresholds.DEFAULT`를 그대로 쓴다. + 그런데 같은 클래스의 javadoc(`:7-10`)은: + > "a backlog of 4,000 is either routine or an incident depending on a deployment's throughput, + > and only the deployment knows which." + + 배포가 그 값을 공급할 설정 키는 존재하지 않는다(`config/notification.yml`, `env-keys.yaml` 모두 0건). +- **왜 문제인가**: 이 임계값이 `NotificationHealthReporter.snapshot()`의 `healthy` 판정을 결정하고, + 그 판정이 actuator 헬스 인디케이터로 나간다. 즉 **쿠버네티스 readiness에 영향을 준다.** + 처리량이 낮은 배포는 backlog 100,000에 도달하기 한참 전에 이미 장애인데 healthy로 보고되고, + 처리량이 큰 배포는 정상 버스트에서 DOWN으로 떨어진다. +- **수정 방향**: `ca-skeleton.notification.platform.serving-thresholds.*`를 `NotificationPlatformSettings`에 + 추가하고 `DEFAULT`를 그 기본값으로 남긴다. +- **반론과 재반박**: 반론 — javadoc `:44-46`이 "ages are the operative checks"라며 나이 기반 임계값은 + 처리량과 무관하다고 방어한다. 재반박 — 부분적으로 타당하다. 그러나 `exceededBy`(`:63-71`)는 OR이라 + 개수 기반 4개도 똑같이 판정에 참여하고, 그 4개가 바로 javadoc이 "추측해야 한다"고 인정한 것들이다. + +#### M3. 종료 유예 20초와 디스패치 추정 2초가 코드에 박혀 있다 + +- **근거**: `platform/autoconfigure/NotificationPlatformDispatchConfig.java:125-134` + ```java + return new NotificationDispatchProperties( + settings.dispatch().claimBatchSize(), ..., + Duration.ofSeconds(2), // estimatedDispatchDuration + settings.dispatch().maxQueueAge(), + Duration.ofSeconds(20)); // shutdownGrace + ``` + `shutdownGrace`는 `NotificationSchedulerWorker.close()`(`:175`, `:183`)와 + `NotificationBackgroundWorkers.close()`(`:171`)에서 두 번 쓰이므로 최악 40초를 기다린다. +- **왜 문제인가**: 쿠버네티스 `terminationGracePeriodSeconds` 기본값은 30초다. 롤링 재시작에서 + 워커가 드레인을 마치기 전에 SIGKILL을 받으면 리스가 만료될 때까지(기본 2분) 배달이 멈춘다. + `NotificationSchedulerWorker.java:167-170` 주석이 close()를 "a fact rather than a request"로 만들었다고 + 자평하는데, 그 사실을 배포 환경과 맞출 수단이 없다. +- **수정 방향**: `dispatch.shutdown-grace` 키를 추가한다. `estimatedDispatchDuration`은 소비처를 확인하고 + 쓰이지 않으면 필드를 지운다. + +#### M4. 발행 시점(스테이징→공개)만 "검사 후 경로 재해석" 패턴을 쓴다 — `SecureDirectoryWalk`가 없애려던 바로 그 창 + +- **근거**: `platform/local/AtomicMoveContentPublisher.java` + ```java + channels.createParentDirectories(root, target); + channels.requireNoSymlinkBetween(root, target.getParent()); // 검사 + ... + Files.move(staging, target, StandardCopyOption.ATOMIC_MOVE); // 경로로 재해석해서 사용 + ``` + `ContentPublishVerification.forceDirectory`도 같은 형태다: + `channels.requireNoSymlinkBetween(root, directory)` 후 `FileChannel.open(directory, READ)`. + 이 패턴은 같은 leaf의 `platform/local/SecureDirectoryWalk.java:17-21`이 명시적으로 부정한 것이다: + > "Proving that no component ... is a symbolic link and then calling `FileChannel.open` on that string + > re-resolves every component from scratch ... More checks only narrow the window; they never close it." + + `SafeFileChannelFactory.java:154-160`도 `requireNoSymlinkBetween`을 "Retained for the capability probe" + 라고 격하하면서 "Production access no longer relies on it"이라고 쓰는데, 발행 경로는 여전히 의존한다. +- **왜 문제인가**: 업로드가 공개로 바뀌는 **바로 그 순간**이 leaf 안에서 유일하게 TOCTOU 창이 남은 지점이다. + `SecureDirectoryStream`에는 `move(srcpath, targetdir, targetpath)`가 있으므로 대안이 없는 것도 아니다. +- **수정 방향**: `SecureDirectoryWalk`에 두 디렉터리 디스크립터를 동시에 여는 move 연산을 추가하고 + `AtomicMoveContentPublisher`가 그것을 쓰게 한다. +- **반론과 재반박**: 반론 — 저장소 루트는 0700, 프로세스 사용자 소유이고 모든 하위 디렉터리도 + `applyOwnerOnlyDirectoryPermissions`로 0700이 된다. 공격자가 컴포넌트를 바꾸려면 이미 같은 사용자여야 한다. + 재반박 — 맞다. 그래서 Medium이다. 다만 `createParentDirectories`(`SafeFileChannelFactory.java:141-152`)가 + `Files.createDirectories(parent)`로 디렉터리를 만든 **뒤에** 권한을 조정하므로, 프로세스 umask가 + 느슨한 배포(컨테이너 기본 0022)에서는 0755로 잠깐 존재하는 창이 있다. 두 개를 합치면 이론적 창이 + 실무적 창에 조금 더 가까워진다. + +#### M5. 스크립트 콘텐츠 탐지가 `startsWith`뿐이다 — 주석 접두사·폴리글롯을 놓친다 + +- **근거**: `platform/verification/ScriptableContentPolicy.java:43-45` + ```java + String text = new String(prefix, UTF_8).toLowerCase(Locale.ROOT).stripLeading(); + boolean scriptable = SCRIPTABLE_MARKERS.stream().anyMatch(text::startsWith); + ``` + 마커는 `\n...`, UTF-8 BOM 선행, 또는 GIF89a 헤더 뒤에 `", + "GIF89a-binary-prefix-" + }) + void quarantinesScriptableMarkersAnywhereInTheBoundedPrefix(String content) { + byte[] bytes = content.getBytes(StandardCharsets.UTF_8); + ScriptableContentPolicy policy = + new ScriptableContentPolicy( + (request, maxBytes) -> java.util.Arrays.copyOf(bytes, Math.min(bytes.length, maxBytes)), + false); + + assertThat(policy.verify(request()).toCompletableFuture().join().verdict()) + .isEqualTo(VerificationVerdict.QUARANTINE); + } + + private static VerificationRequest request() { + return new VerificationRequest( + FileId.of(UUID.randomUUID()), + Optional.of(UploadId.of(UUID.randomUUID())), + Optional.empty(), + 10, + "a".repeat(64), + Optional.of("image/gif"), + new SanitizedFilename("image.gif")); + } +} diff --git a/src/adapter/outbound/httpclient/CLAUDE.md b/src/adapter/outbound/httpclient/CLAUDE.md index eaeb3117..6f414e4b 100644 --- a/src/adapter/outbound/httpclient/CLAUDE.md +++ b/src/adapter/outbound/httpclient/CLAUDE.md @@ -37,10 +37,11 @@ moving a type between packages. - `profile` depends publicly only on `api`. - transport packages never reach back into the gateways. - `resilience` never depends on a transport — retry eligibility is transport-neutral. -- no production package depends on `testkit`. The testkit lives in its own `testkit` source set - (`src/testkit/java`), consumed by the `test`, `httpClientPerformanceTest` and `jmh` lanes; its - dependencies are declared only on the test configurations, so production still cannot reach it. - `PlatformClasses` is the single definition of "production classes" the boundary rules import. +- no production package depends on the reusable testkit. It lives in Gradle + `testFixtures` (`src/testFixtures/java`) and is consumed explicitly by the ordinary tests, + integration/performance lanes, and JMH. Its dependencies stay on test-fixture/test configurations, + so production still cannot reach it. `PlatformClasses` is the single definition of "production + classes" the boundary rules import. - Stable code never references `http3`. - `org.springframework.web.service.registry` appears only in `spring7`. - `RestTemplate` appears only in `migration`. @@ -52,13 +53,17 @@ moving a type between packages. - Retry and circuit-breaker code is technical resilience; business compensation and use-case sequencing stay in application/domain layers. - Application/domain code must not import this module's gateways, operation descriptors, URI types, - Spring HTTP types, engine clients, retry types, or wire DTOs. + Spring HTTP types, engine clients, retry types, or wire DTOs. The repository-level Gradle + dependency gate in `config/architecture/modules.json` enforces that direction; this leaf's + ArchUnit rules only govern boundaries inside the leaf. - Normal calls use a registered profile and a profile-relative template. Absolute URLs are H3 only. -- Composition is owned by `app-bootstrap` (`dev.caskeleton.bootstrap.autoconfigure.httpclient`): - profile binding, startup validation, transport registration, and the actuator endpoint live there. - That package is excluded from the composition root's component scan and reached only through - `HttpClientPlatformAutoConfiguration`, which is gated on `app.httpclient.enabled=true`. While the - switch is off the capability has no beans at all — not an empty registry, nothing. +- Composition is capability-owned under `dev.caskeleton.adapter.outbound.httpclient.autoconfigure`: + profile binding, startup validation, transport registration, service gateways, dynamic targets, + and the actuator endpoint live in this leaf and are published through Boot auto-configuration + metadata. `HttpClientPlatformAutoConfiguration` is gated on `app.httpclient.enabled=true`. While + the switch is off the capability has no beans at all — not an empty registry, nothing. +- `app-bootstrap` must not import HTTP-client implementation or auto-configuration classes from + production code. Build inclusion is decided separately from this runtime activation switch. ## Tests @@ -70,7 +75,7 @@ Default lane: `./gradlew :adapter:outbound:httpclient:test`. Additional lanes, a | `httpClientSecurityTest` | SSRF matrix, credential stripping, tag cardinality | | `httpClientFailureInjectionTest` | Toxiproxy faults; **requires Docker and fails without it** | | `httpClientPerformanceTest` | pool, streaming, retry, rotation resource bounds | -| `spring62CompatibilityTest` | Spring 6.2 API-surface confinement | +| `spring62ApiSurfaceScan` | Spring 6.2 API-surface confinement | | `spring70CompatibilityTest` | contract suite on the repository baseline | | `jmh` | per-call overhead benchmarks | diff --git a/src/adapter/outbound/httpclient/build.gradle b/src/adapter/outbound/httpclient/build.gradle index fd162e1a..e4b0de7c 100644 --- a/src/adapter/outbound/httpclient/build.gradle +++ b/src/adapter/outbound/httpclient/build.gradle @@ -23,6 +23,8 @@ dependencies { // Spring client layer. `httpclient-core-api` must not reach these; ArchUnit enforces it. implementation 'org.springframework.boot:spring-boot-autoconfigure' + implementation 'org.springframework.boot:spring-boot-actuator' + implementation 'org.springframework.boot:spring-boot-actuator-autoconfigure' implementation 'org.springframework:spring-web' implementation 'org.springframework:spring-webflux' implementation 'io.projectreactor:reactor-core' @@ -32,7 +34,8 @@ dependencies { // Experimental HTTP/3 transport that the Stable starter never auto-configures. implementation 'org.apache.httpcomponents.client5:httpclient5' implementation 'io.projectreactor.netty:reactor-netty-http' - implementation 'org.eclipse.jetty:jetty-client' + compileOnly 'org.eclipse.jetty:jetty-client' + testImplementation 'org.eclipse.jetty:jetty-client' // HTTP/3 is Experimental and off by default, so its transport is compileOnly plus a test // dependency rather than a runtime one. It used to be `implementation`, which put the whole // QUIC/HTTP-3/QPACK stack on every deployment's runtime classpath — megabytes and an attack @@ -66,36 +69,34 @@ dependencies { implementation 'org.slf4j:slf4j-api' - // Testkit dependencies (design §28.1 test topology). They are test-scoped so no production - // module can depend on the testkit; the testkit source set inherits them by extending - // testImplementation, and the test lanes use them directly. + // Ordinary test dependencies. Reusable testkit dependencies are declared on + // testFixturesImplementation below so production and unrelated test lanes do not inherit them. testImplementation libs.mockwebserver testImplementation libs.okhttp.tls - testImplementation 'org.testcontainers:testcontainers' - testImplementation 'org.testcontainers:testcontainers-junit-jupiter' - testImplementation 'org.testcontainers:testcontainers-toxiproxy' testImplementation 'io.projectreactor:reactor-test' testImplementation libs.archunit.junit5 testImplementation libs.blockhound } -// The testkit is its own source set, not part of `test`, because three lanes consume it and only -// one of them is a test lane. Reaching into `sourceSets.test.output` from `jmh` compiled under -// Gradle and could not be modelled by the IDE at all: a source set is test source there only when -// a Test task runs its output, `jmh` is driven by JavaExec, and IDE main source may not read IDE -// test source — so every testkit reference in the benchmarks was an unresolved type in the editor -// while the build was green. A source set nobody runs tests from is main source for all three -// consumers, which is what it always was. +// Reusable test support lives in Gradle testFixtures. Integration/performance lanes and JMH opt +// into that published test surface explicitly, so IDE and Gradle agree on the dependency direction +// and production never sees fixture code. // // Performance certification and JMH benchmarks are separate source sets for their own reason: they // are slow, they assert on resource bounds rather than behaviour, and they must never be part of // the default unit lane. auxiliarySourceSets { // The testkit compiles against exactly what a test does: `implementation` inheritance runs + sourceSet('integrationTest') { compilesAgainst 'main', 'testFixtures' } sourceSet('httpClientPerformanceTest') { compilesAgainst 'main', 'testFixtures' } } dependencies { + integrationTestImplementation 'org.testcontainers:testcontainers' + integrationTestImplementation 'org.testcontainers:testcontainers-junit-jupiter' + integrationTestImplementation 'org.testcontainers:testcontainers-toxiproxy' + integrationTestImplementation libs.toxiproxy.java + // Testkit dependencies (design §28.1 test topology). They stay off the production // configurations, so no production module can depend on the testkit. // Declared rather than inherited. The `testkit` source set extended `testImplementation`, so the @@ -107,15 +108,11 @@ dependencies { testFixturesImplementation 'org.assertj:assertj-core' testFixturesImplementation 'org.junit.jupiter:junit-jupiter-api' testFixturesImplementation 'org.slf4j:slf4j-api' - testFixturesImplementation libs.toxiproxy.java // The Netty leak detector reads logback's own event types to catch a LEAK record. testFixturesImplementation 'io.netty:netty-common' testFixturesImplementation 'ch.qos.logback:logback-classic' testFixturesImplementation libs.mockwebserver testFixturesImplementation libs.okhttp.tls - testFixturesImplementation 'org.testcontainers:testcontainers' - testFixturesImplementation 'org.testcontainers:testcontainers-junit-jupiter' - testFixturesImplementation 'org.testcontainers:testcontainers-toxiproxy' testFixturesImplementation 'io.projectreactor:reactor-test' testFixturesImplementation libs.archunit.junit5 testFixturesImplementation libs.blockhound @@ -141,7 +138,7 @@ tasks.named('test', Test) { // and fails closed without it, and the BlockHound lane rewrites core JDK bytecode, which must // not be imposed on every unit run. useJUnitPlatform { - excludeTags 'httpclient-fault', 'httpclient-blockhound' + excludeTags 'httpclient-blockhound', 'httpclient-contract', 'httpclient-security', 'httpclient-spring62-surface' } } @@ -220,6 +217,7 @@ strictTestLanes { } lane('httpClientFailureInjectionTest') { integration() + sourceSet = 'integrationTest' tag = 'httpclient-fault' description = 'Runs the Toxiproxy fault-injection suite; fails closed without Docker ' + '(design §28.3).' diff --git a/src/adapter/outbound/httpclient/gradle.lockfile b/src/adapter/outbound/httpclient/gradle.lockfile index be0ad990..0036b8e8 100644 --- a/src/adapter/outbound/httpclient/gradle.lockfile +++ b/src/adapter/outbound/httpclient/gradle.lockfile @@ -1,250 +1,254 @@ # This is a Gradle generated file for dependency locking. # Manual edits can break the build and are not advised. # This file is expected to be part of source control. -biz.aQute.bnd:biz.aQute.bnd.annotation:7.1.0=httpClientPerformanceTestCompileClasspath,jmhCompileClasspath,testCompileClasspath,testkitCompileClasspath -ch.qos.logback:logback-classic:1.5.38=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -ch.qos.logback:logback-core:1.5.38=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.fasterxml.jackson.core:jackson-annotations:2.21=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.fasterxml.jackson.core:jackson-core:2.21.5=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.fasterxml.jackson.core:jackson-databind:2.21.5=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.fasterxml.jackson:jackson-bom:2.21.5=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.github.docker-java:docker-java-api:3.7.1=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.github.docker-java:docker-java-transport-zerodep:3.7.1=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.github.docker-java:docker-java-transport:3.7.1=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +biz.aQute.bnd:biz.aQute.bnd.annotation:7.1.0=httpClientPerformanceTestCompileClasspath,integrationTestCompileClasspath,jmhCompileClasspath,testCompileClasspath,testkitCompileClasspath +ch.qos.logback:logback-classic:1.5.38=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +ch.qos.logback:logback-core:1.5.38=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.fasterxml.jackson.core:jackson-annotations:2.21=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.fasterxml.jackson.core:jackson-core:2.21.5=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.fasterxml.jackson.core:jackson-databind:2.21.5=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.fasterxml.jackson:jackson-bom:2.21.5=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.github.docker-java:docker-java-api:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.github.docker-java:docker-java-transport-zerodep:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.github.docker-java:docker-java-transport:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor com.github.spotbugs:spotbugs-annotations:4.10.2=spotbugs com.github.spotbugs:spotbugs:4.10.2=spotbugs -com.github.stephenc.jcip:jcip-annotations:1.0-1=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,spotbugs,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.google.auto:auto-common:1.2.2=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.github.stephenc.jcip:jcip-annotations:1.0-1=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,spotbugs,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.auto:auto-common:1.2.2=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor com.google.code.findbugs:jsr305:3.0.2=checkstyle,spotbugs -com.google.code.gson:gson:2.13.2=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,spotbugs,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.google.errorprone:error_prone_annotations:2.41.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,spotbugs,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.google.code.gson:gson:2.13.2=integrationTestCompileClasspath,integrationTestRuntimeClasspath,spotbugs,testkitCompileClasspath,testkitRuntimeClasspath +com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.38.0=httpClientPerformanceTestCompileClasspath,jmhCompileClasspath,testCompileClasspath +com.google.errorprone:error_prone_annotations:2.41.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,spotbugs,testkitCompileClasspath,testkitRuntimeClasspath com.google.errorprone:error_prone_annotations:2.47.0=checkstyle -com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,httpClientPerformanceTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.google.guava:guava:33.5.0-jre=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,httpClientPerformanceTestAnnotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.guava:guava:33.5.0-jre=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor com.google.guava:guava:33.6.0-jre=checkstyle -com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,httpClientPerformanceTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,httpClientPerformanceTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,httpClientPerformanceTestAnnotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,httpClientPerformanceTestAnnotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins -com.jayway.jsonpath:json-path:2.10.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.nimbusds:content-type:2.3=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.nimbusds:lang-tag:1.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.nimbusds:nimbus-jose-jwt:10.4=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.nimbusds:oauth2-oidc-sdk:11.26.1=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.jayway.jsonpath:json-path:2.10.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.nimbusds:content-type:2.3=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.nimbusds:lang-tag:1.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.nimbusds:nimbus-jose-jwt:10.4=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.nimbusds:oauth2-oidc-sdk:11.26.1=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath com.puppycrawl.tools:checkstyle:13.5.0=checkstyle -com.squareup.okhttp3:mockwebserver:4.12.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.squareup.okhttp3:okhttp-tls:4.12.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.squareup.okhttp3:okhttp:4.12.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.squareup.okio:okio-jvm:3.6.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.squareup.okio:okio:3.6.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.tngtech.archunit:archunit-junit5-api:1.3.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.tngtech.archunit:archunit-junit5-engine-api:1.3.0=httpClientPerformanceTestRuntimeClasspath,jmhRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath -com.tngtech.archunit:archunit-junit5-engine:1.3.0=httpClientPerformanceTestRuntimeClasspath,jmhRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath -com.tngtech.archunit:archunit-junit5:1.3.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.tngtech.archunit:archunit:1.3.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.vaadin.external.google:android-json:0.0.20131108.vaadin1=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.squareup.okhttp3:mockwebserver:4.12.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.squareup.okhttp3:okhttp-tls:4.12.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.squareup.okhttp3:okhttp:4.12.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.squareup.okio:okio-jvm:3.6.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.squareup.okio:okio:3.6.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.tngtech.archunit:archunit-junit5-api:1.3.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.tngtech.archunit:archunit-junit5-engine-api:1.3.0=httpClientPerformanceTestRuntimeClasspath,integrationTestRuntimeClasspath,jmhRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath +com.tngtech.archunit:archunit-junit5-engine:1.3.0=httpClientPerformanceTestRuntimeClasspath,integrationTestRuntimeClasspath,jmhRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath +com.tngtech.archunit:archunit-junit5:1.3.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.tngtech.archunit:archunit:1.3.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.vaadin.external.google:android-json:0.0.20131108.vaadin1=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath commons-beanutils:commons-beanutils:1.11.0=checkstyle -commons-codec:commons-codec:1.19.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +commons-codec:commons-codec:1.19.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath commons-collections:commons-collections:3.2.2=checkstyle -commons-io:commons-io:2.20.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +commons-io:commons-io:2.20.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath commons-io:commons-io:2.21.0=spotbugs -commons-logging:commons-logging:1.3.6=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -eu.rekawek.toxiproxy:toxiproxy-java:2.1.11=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -eu.rekawek.toxiproxy:toxiproxy-java:2.1.7=testFixturesCompileClasspath,testFixturesRuntimeClasspath +commons-logging:commons-logging:1.3.6=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +eu.rekawek.toxiproxy:toxiproxy-java:2.1.11=testkitCompileClasspath,testkitRuntimeClasspath +eu.rekawek.toxiproxy:toxiproxy-java:2.1.7=integrationTestCompileClasspath,integrationTestRuntimeClasspath info.picocli:picocli:4.7.7=checkstyle -io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -io.github.resilience4j:resilience4j-bulkhead:2.2.0=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.github.resilience4j:resilience4j-circuitbreaker:2.2.0=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.github.resilience4j:resilience4j-core:2.2.0=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.github.resilience4j:resilience4j-micrometer:2.2.0=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.github.resilience4j:resilience4j-ratelimiter:2.2.0=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.github.resilience4j:resilience4j-retry:2.2.0=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.github.resilience4j:resilience4j-timelimiter:2.2.0=httpClientPerformanceTestRuntimeClasspath,jmhRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath -io.micrometer:micrometer-commons:1.16.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.micrometer:micrometer-core:1.16.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.micrometer:micrometer-observation:1.16.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.netty:netty-buffer:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.netty:netty-codec-base:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.netty:netty-codec-classes-quic:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.netty:netty-codec-compression:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.netty:netty-codec-dns:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.netty:netty-codec-http2:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.netty:netty-codec-http3:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.netty:netty-codec-http:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.netty:netty-codec-native-quic:4.2.17.Final=httpClientPerformanceTestRuntimeClasspath,jmhRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath -io.netty:netty-codec-socks:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.netty:netty-common:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.netty:netty-handler-proxy:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.netty:netty-handler:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.netty:netty-resolver-dns-classes-macos:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.netty:netty-resolver-dns-native-macos:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.netty:netty-resolver-dns:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.netty:netty-resolver:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.netty:netty-transport-classes-epoll:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.netty:netty-transport-native-epoll:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.netty:netty-transport-native-unix-common:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.netty:netty-transport:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.projectreactor.netty:reactor-netty-core:1.3.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.projectreactor.netty:reactor-netty-http:1.3.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.projectreactor.tools:blockhound:1.0.17.RELEASE=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.projectreactor:reactor-core:3.8.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.projectreactor:reactor-test:3.8.7=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -jakarta.activation:jakarta.activation-api:2.1.4=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -jakarta.annotation:jakarta.annotation-api:3.0.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -jakarta.xml.bind:jakarta.xml.bind-api:4.0.5=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -javax.inject:javax.inject:1=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +io.github.resilience4j:resilience4j-bulkhead:2.2.0=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.github.resilience4j:resilience4j-circuitbreaker:2.2.0=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.github.resilience4j:resilience4j-core:2.2.0=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.github.resilience4j:resilience4j-micrometer:2.2.0=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.github.resilience4j:resilience4j-ratelimiter:2.2.0=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.github.resilience4j:resilience4j-retry:2.2.0=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.github.resilience4j:resilience4j-timelimiter:2.2.0=httpClientPerformanceTestRuntimeClasspath,integrationTestRuntimeClasspath,jmhRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath +io.micrometer:micrometer-commons:1.16.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.micrometer:micrometer-core:1.16.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.micrometer:micrometer-observation:1.16.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.netty:netty-buffer:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.netty:netty-codec-base:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.netty:netty-codec-classes-quic:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.netty:netty-codec-compression:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.netty:netty-codec-dns:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.netty:netty-codec-http2:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.netty:netty-codec-http3:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.netty:netty-codec-http:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.netty:netty-codec-native-quic:4.2.17.Final=httpClientPerformanceTestRuntimeClasspath,integrationTestRuntimeClasspath,jmhRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath +io.netty:netty-codec-socks:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.netty:netty-common:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.netty:netty-handler-proxy:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.netty:netty-handler:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.netty:netty-resolver-dns-classes-macos:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.netty:netty-resolver-dns-native-macos:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.netty:netty-resolver-dns:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.netty:netty-resolver:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.netty:netty-transport-classes-epoll:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.netty:netty-transport-native-epoll:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.netty:netty-transport-native-unix-common:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.netty:netty-transport:4.2.17.Final=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.projectreactor.netty:reactor-netty-core:1.3.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.projectreactor.netty:reactor-netty-http:1.3.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.projectreactor.tools:blockhound:1.0.17.RELEASE=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.projectreactor:reactor-core:3.8.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.projectreactor:reactor-test:3.8.7=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +jakarta.activation:jakarta.activation-api:2.1.4=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +jakarta.annotation:jakarta.annotation-api:3.0.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +jakarta.xml.bind:jakarta.xml.bind-api:4.0.5=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +javax.inject:javax.inject:1=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor jaxen:jaxen:2.0.6=spotbugs -junit:junit:4.13.2=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -net.bytebuddy:byte-buddy-agent:1.17.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -net.bytebuddy:byte-buddy:1.17.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -net.java.dev.jna:jna:5.18.1=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -net.minidev:accessors-smart:2.6.0=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -net.minidev:json-smart:2.6.0=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +junit:junit:4.13.2=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +net.bytebuddy:byte-buddy-agent:1.17.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +net.bytebuddy:byte-buddy:1.17.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +net.java.dev.jna:jna:5.18.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +net.minidev:accessors-smart:2.6.0=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +net.minidev:json-smart:2.6.0=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath net.sf.jopt-simple:jopt-simple:5.0.4=jmhAnnotationProcessor,jmhCompileClasspath,jmhRuntimeClasspath net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs org.antlr:antlr4-runtime:4.13.2=checkstyle org.apache.bcel:bcel:6.12.0=spotbugs -org.apache.commons:commons-compress:1.28.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.apache.commons:commons-lang3:3.20.0=checkstyle,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,spotbugs,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.apache.commons:commons-compress:1.28.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.apache.commons:commons-lang3:3.20.0=checkstyle,integrationTestCompileClasspath,integrationTestRuntimeClasspath,spotbugs,testkitCompileClasspath,testkitRuntimeClasspath org.apache.commons:commons-math3:3.6.1=jmhAnnotationProcessor,jmhCompileClasspath,jmhRuntimeClasspath org.apache.commons:commons-text:1.15.0=spotbugs org.apache.commons:commons-text:1.3=checkstyle -org.apache.httpcomponents.client5:httpclient5:5.5.2=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.apache.httpcomponents.core5:httpcore5-h2:5.3.6=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.apache.httpcomponents.core5:httpcore5:5.3.6=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.apache.httpcomponents.client5:httpclient5:5.5.2=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.apache.httpcomponents.core5:httpcore5-h2:5.3.6=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.apache.httpcomponents.core5:httpcore5:5.3.6=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath org.apache.httpcomponents:httpclient:4.5.13=checkstyle org.apache.httpcomponents:httpcore:4.4.16=checkstyle -org.apache.logging.log4j:log4j-api:2.25.5=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,spotbugs,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.apache.logging.log4j:log4j-api:2.25.5=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,spotbugs,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath org.apache.logging.log4j:log4j-core:2.25.5=spotbugs -org.apache.logging.log4j:log4j-to-slf4j:2.25.5=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.apache.logging.log4j:log4j-to-slf4j:2.25.5=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath org.apache.maven.doxia:doxia-core:1.12.0=checkstyle org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle -org.apache.tomcat.embed:tomcat-embed-core:11.0.24=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.apache.tomcat.embed:tomcat-embed-el:11.0.24=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.apache.tomcat.embed:tomcat-embed-websocket:11.0.24=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.apache.tomcat.embed:tomcat-embed-core:11.0.24=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.apache.tomcat.embed:tomcat-embed-el:11.0.24=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.apache.tomcat.embed:tomcat-embed-websocket:11.0.24=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath org.apache.xbean:xbean-reflect:3.7=checkstyle -org.apiguardian:apiguardian-api:1.1.2=httpClientPerformanceTestCompileClasspath,jmhCompileClasspath,testCompileClasspath,testFixturesCompileClasspath,testkitCompileClasspath -org.assertj:assertj-core:3.27.7=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.awaitility:awaitility:4.3.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.apiguardian:apiguardian-api:1.1.2=httpClientPerformanceTestCompileClasspath,integrationTestCompileClasspath,jmhCompileClasspath,testCompileClasspath,testFixturesCompileClasspath,testkitCompileClasspath +org.assertj:assertj-core:3.27.7=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.awaitility:awaitility:4.3.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle org.codehaus.plexus:plexus-component-annotations:2.1.0=checkstyle org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle org.codehaus.plexus:plexus-utils:3.3.0=checkstyle org.dom4j:dom4j:2.2.0=spotbugs -org.eclipse.jetty.compression:jetty-compression-common:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.eclipse.jetty.compression:jetty-compression-gzip:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.eclipse.jetty.http3:jetty-http3-client-transport:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.eclipse.jetty.http3:jetty-http3-client:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.eclipse.jetty.http3:jetty-http3-common:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.eclipse.jetty.http3:jetty-http3-qpack:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.eclipse.jetty.quic:jetty-quic-api:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.eclipse.jetty.quic:jetty-quic-client:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.eclipse.jetty.quic:jetty-quic-common:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.eclipse.jetty.quic:jetty-quic-util:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.eclipse.jetty:jetty-alpn-client:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.eclipse.jetty:jetty-client:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.eclipse.jetty:jetty-http:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.eclipse.jetty:jetty-io:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.eclipse.jetty:jetty-util:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.hamcrest:hamcrest-core:3.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.hamcrest:hamcrest:3.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.hdrhistogram:HdrHistogram:2.2.2=httpClientPerformanceTestRuntimeClasspath,jmhRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath +org.eclipse.jetty.compression:jetty-compression-common:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.eclipse.jetty.compression:jetty-compression-gzip:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.eclipse.jetty.http3:jetty-http3-client-transport:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.eclipse.jetty.http3:jetty-http3-client:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.eclipse.jetty.http3:jetty-http3-common:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.eclipse.jetty.http3:jetty-http3-qpack:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.eclipse.jetty.quic:jetty-quic-api:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.eclipse.jetty.quic:jetty-quic-client:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.eclipse.jetty.quic:jetty-quic-common:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.eclipse.jetty.quic:jetty-quic-util:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.eclipse.jetty:jetty-alpn-client:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.eclipse.jetty:jetty-client:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.eclipse.jetty:jetty-http:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.eclipse.jetty:jetty-io:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.eclipse.jetty:jetty-util:12.1.12=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.hamcrest:hamcrest-core:3.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.hamcrest:hamcrest:3.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.hdrhistogram:HdrHistogram:2.2.2=httpClientPerformanceTestRuntimeClasspath,integrationTestRuntimeClasspath,jmhRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath org.javassist:javassist:3.28.0-GA=checkstyle -org.jetbrains.kotlin:kotlin-stdlib-common:2.2.21=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.jetbrains.kotlin:kotlin-stdlib-jdk7:2.2.21=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.jetbrains.kotlin:kotlin-stdlib-jdk8:2.2.21=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.jetbrains.kotlin:kotlin-stdlib:2.2.21=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.jetbrains:annotations:17.0.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,httpClientPerformanceTestAnnotationProcessor,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhAnnotationProcessor,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testFixturesAnnotationProcessor,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitAnnotationProcessor,testkitCompileClasspath,testkitRuntimeClasspath -org.junit.jupiter:junit-jupiter-api:6.0.3=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.junit.jupiter:junit-jupiter-engine:6.0.3=httpClientPerformanceTestRuntimeClasspath,jmhRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath -org.junit.jupiter:junit-jupiter-params:6.0.3=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.junit.jupiter:junit-jupiter:6.0.3=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.junit.platform:junit-platform-commons:6.0.3=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.junit.platform:junit-platform-engine:6.0.3=httpClientPerformanceTestRuntimeClasspath,jmhRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath -org.junit.platform:junit-platform-launcher:6.0.3=httpClientPerformanceTestRuntimeClasspath,jmhRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath -org.junit:junit-bom:6.0.3=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.jetbrains.kotlin:kotlin-stdlib-common:2.2.21=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.jetbrains.kotlin:kotlin-stdlib-jdk7:2.2.21=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.jetbrains.kotlin:kotlin-stdlib-jdk8:2.2.21=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.jetbrains.kotlin:kotlin-stdlib:2.2.21=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.jetbrains:annotations:13.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.jetbrains:annotations:17.0.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,httpClientPerformanceTestAnnotationProcessor,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestAnnotationProcessor,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhAnnotationProcessor,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testFixturesAnnotationProcessor,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitAnnotationProcessor,testkitCompileClasspath,testkitRuntimeClasspath +org.junit.jupiter:junit-jupiter-api:6.0.3=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.junit.jupiter:junit-jupiter-engine:6.0.3=httpClientPerformanceTestRuntimeClasspath,integrationTestRuntimeClasspath,jmhRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath +org.junit.jupiter:junit-jupiter-params:6.0.3=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.junit.jupiter:junit-jupiter:6.0.3=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.junit.platform:junit-platform-commons:6.0.3=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.junit.platform:junit-platform-engine:6.0.3=httpClientPerformanceTestRuntimeClasspath,integrationTestRuntimeClasspath,jmhRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath +org.junit.platform:junit-platform-launcher:6.0.3=httpClientPerformanceTestRuntimeClasspath,integrationTestRuntimeClasspath,jmhRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath +org.junit:junit-bom:6.0.3=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath org.junit:junit-bom:6.1.0=spotbugs -org.latencyutils:LatencyUtils:2.0.3=httpClientPerformanceTestRuntimeClasspath,jmhRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath -org.mockito:mockito-core:5.20.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,mockitoAgent,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.mockito:mockito-junit-jupiter:5.20.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.objenesis:objenesis:3.3=httpClientPerformanceTestRuntimeClasspath,jmhRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath +org.latencyutils:LatencyUtils:2.0.3=httpClientPerformanceTestRuntimeClasspath,integrationTestRuntimeClasspath,jmhRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath +org.mockito:mockito-core:5.20.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,mockitoAgent,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.mockito:mockito-junit-jupiter:5.20.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.objenesis:objenesis:3.3=httpClientPerformanceTestRuntimeClasspath,integrationTestRuntimeClasspath,jmhRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath org.openjdk.jmh:jmh-core:1.37=jmhAnnotationProcessor,jmhCompileClasspath,jmhRuntimeClasspath org.openjdk.jmh:jmh-generator-annprocess:1.37=jmhAnnotationProcessor -org.opentest4j:opentest4j:1.3.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.osgi:org.osgi.annotation.bundle:2.0.0=httpClientPerformanceTestCompileClasspath,jmhCompileClasspath,testCompileClasspath,testkitCompileClasspath -org.osgi:org.osgi.annotation.versioning:1.1.2=httpClientPerformanceTestCompileClasspath,jmhCompileClasspath,testCompileClasspath,testkitCompileClasspath -org.osgi:org.osgi.resource:1.0.0=httpClientPerformanceTestCompileClasspath,jmhCompileClasspath,testCompileClasspath,testkitCompileClasspath -org.osgi:org.osgi.service.serviceloader:1.0.0=httpClientPerformanceTestCompileClasspath,jmhCompileClasspath,testCompileClasspath,testkitCompileClasspath +org.opentest4j:opentest4j:1.3.0=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.osgi:org.osgi.annotation.bundle:2.0.0=httpClientPerformanceTestCompileClasspath,integrationTestCompileClasspath,jmhCompileClasspath,testCompileClasspath,testkitCompileClasspath +org.osgi:org.osgi.annotation.versioning:1.1.2=httpClientPerformanceTestCompileClasspath,integrationTestCompileClasspath,jmhCompileClasspath,testCompileClasspath,testkitCompileClasspath +org.osgi:org.osgi.resource:1.0.0=httpClientPerformanceTestCompileClasspath,integrationTestCompileClasspath,jmhCompileClasspath,testCompileClasspath,testkitCompileClasspath +org.osgi:org.osgi.service.serviceloader:1.0.0=httpClientPerformanceTestCompileClasspath,integrationTestCompileClasspath,jmhCompileClasspath,testCompileClasspath,testkitCompileClasspath org.ow2.asm:asm-analysis:9.10.1=spotbugs org.ow2.asm:asm-commons:9.10.1=spotbugs org.ow2.asm:asm-tree:9.10.1=spotbugs org.ow2.asm:asm-util:9.10.1=spotbugs org.ow2.asm:asm:9.10.1=spotbugs -org.ow2.asm:asm:9.7.1=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.pcollections:pcollections:4.0.1=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -org.reactivestreams:reactive-streams:1.0.4=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.ow2.asm:asm:9.7.1=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.pcollections:pcollections:4.0.1=annotationProcessor,httpClientPerformanceTestAnnotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +org.reactivestreams:reactive-streams:1.0.4=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath org.reflections:reflections:0.10.2=checkstyle -org.rnorth.duct-tape:duct-tape:1.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.skyscreamer:jsonassert:1.5.3=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.slf4j:jul-to-slf4j:2.0.18=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.slf4j:slf4j-api:2.0.18=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.rnorth.duct-tape:duct-tape:1.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.skyscreamer:jsonassert:1.5.3=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.slf4j:jul-to-slf4j:2.0.18=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.slf4j:slf4j-api:2.0.18=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j org.slf4j:slf4j-simple:2.0.18=checkstyle -org.springframework.boot:spring-boot-autoconfigure:4.0.8=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-http-converter:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-jackson:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-resttestclient:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-servlet:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-starter-jackson-test:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-starter-jackson:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-starter-logging:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-starter-test:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-starter-tomcat-runtime:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-starter-tomcat:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-starter-webmvc-test:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-starter-webmvc:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-starter:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-test-autoconfigure:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-test:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-tomcat:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-web-server:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-webmvc-test:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-webmvc:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot:4.0.8=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.security:spring-security-core:7.0.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.security:spring-security-crypto:7.0.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.security:spring-security-oauth2-client:7.0.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.security:spring-security-oauth2-core:7.0.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.security:spring-security-web:7.0.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework:spring-aop:7.0.9=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework:spring-beans:7.0.9=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework:spring-context:7.0.9=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework:spring-core:7.0.9=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework:spring-expression:7.0.9=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework:spring-test:7.0.9=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework:spring-web:7.0.9=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework:spring-webflux:7.0.9=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework:spring-webmvc:7.0.9=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.testcontainers:testcontainers-junit-jupiter:2.0.5=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.testcontainers:testcontainers-toxiproxy:2.0.5=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.testcontainers:testcontainers:2.0.5=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-actuator-autoconfigure:4.0.8=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-actuator:4.0.8=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-autoconfigure:4.0.8=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-http-converter:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-jackson:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-resttestclient:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-servlet:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-starter-jackson-test:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-starter-jackson:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-starter-logging:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-starter-test:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-starter-tomcat-runtime:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-starter-tomcat:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-starter-webmvc-test:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-starter-webmvc:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-starter:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-test-autoconfigure:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-test:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-tomcat:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-web-server:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-webmvc-test:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-webmvc:4.0.8=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot:4.0.8=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.security:spring-security-core:7.0.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.security:spring-security-crypto:7.0.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.security:spring-security-oauth2-client:7.0.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.security:spring-security-oauth2-core:7.0.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.security:spring-security-web:7.0.7=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework:spring-aop:7.0.9=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework:spring-beans:7.0.9=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework:spring-context:7.0.9=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework:spring-core:7.0.9=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework:spring-expression:7.0.9=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework:spring-test:7.0.9=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework:spring-web:7.0.9=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework:spring-webflux:7.0.9=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework:spring-webmvc:7.0.9=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.testcontainers:testcontainers-junit-jupiter:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.testcontainers:testcontainers-toxiproxy:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.testcontainers:testcontainers:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs -org.xmlunit:xmlunit-core:2.10.4=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.yaml:snakeyaml:2.5=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -tools.jackson.core:jackson-core:3.1.5=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -tools.jackson.core:jackson-databind:3.1.5=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -tools.jackson:jackson-bom:3.1.5=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.xmlunit:xmlunit-core:2.10.4=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.yaml:snakeyaml:2.5=httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +tools.jackson.core:jackson-core:3.1.5=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +tools.jackson.core:jackson-databind:3.1.5=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +tools.jackson:jackson-bom:3.1.5=compileClasspath,httpClientPerformanceTestCompileClasspath,httpClientPerformanceTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath empty= diff --git a/src/adapter/outbound/httpclient/src/integrationTest/java/dev/caskeleton/adapter/outbound/httpclient/contract/FailureInjectionContractTest.java b/src/adapter/outbound/httpclient/src/integrationTest/java/dev/caskeleton/adapter/outbound/httpclient/contract/FailureInjectionContractTest.java new file mode 100644 index 00000000..14eeda2d --- /dev/null +++ b/src/adapter/outbound/httpclient/src/integrationTest/java/dev/caskeleton/adapter/outbound/httpclient/contract/FailureInjectionContractTest.java @@ -0,0 +1,105 @@ +package dev.caskeleton.adapter.outbound.httpclient.contract; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.adapter.outbound.httpclient.api.OperationName; +import dev.caskeleton.adapter.outbound.httpclient.api.error.HttpClientException; +import dev.caskeleton.adapter.outbound.httpclient.api.operation.ExecutionEvidence; +import dev.caskeleton.adapter.outbound.httpclient.api.operation.HttpOperation; +import dev.caskeleton.adapter.outbound.httpclient.api.result.ResponseType; +import dev.caskeleton.adapter.outbound.httpclient.testkit.ClientProfiles; +import dev.caskeleton.adapter.outbound.httpclient.testkit.TestGateways; +import dev.caskeleton.adapter.outbound.httpclient.testkit.ToxiproxyFixture; +import eu.rekawek.toxiproxy.Proxy; +import java.net.URI; +import java.util.Map; +import org.junit.jupiter.api.Tag; +import org.junit.jupiter.api.Test; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.containers.Network; +import org.testcontainers.utility.DockerImageName; + +/** + * TCP-level faults against a real upstream (design §28.3). + * + *

The lane is fail-closed: selecting it without Docker throws rather than skipping, because a + * fault suite that never injected a fault proves nothing. + * + *

Each scenario asserts one exact execution-evidence class. A fault suite that accepts several + * mutually incompatible evidence states merely proves that an exception happened; it does not + * protect retry safety. + */ +@Tag("httpclient-fault") +class FailureInjectionContractTest { + + private static final DockerImageName UPSTREAM_IMAGE = + DockerImageName.parse( + System.getProperty("httpclient.fault.httpbin.image", "kennethreitz/httpbin:latest")) + .asCompatibleSubstituteFor("kennethreitz/httpbin"); + + @Test + @SuppressWarnings("resource") + void disabledProxyFailsBeforeARequestCanBeSent() throws Exception { + ToxiproxyFixture.requireAvailable(); + try (Network network = Network.newNetwork(); + GenericContainer upstream = + new GenericContainer<>(UPSTREAM_IMAGE) + .withNetwork(network) + .withNetworkAliases("upstream") + .withExposedPorts(80)) { + upstream.start(); + try (ToxiproxyFixture toxiproxy = ToxiproxyFixture.start(network)) { + Proxy proxy = toxiproxy.proxyTo("connect-refused", "upstream", 80); + proxy.disable(); + + HttpClientException failure = callThrough(toxiproxy, "/get", ResponseType.of(byte[].class)); + + assertThat(failure.metadata().evidence()).isEqualTo(ExecutionEvidence.NOT_SENT); + assertThat(failure.getMessage()).doesNotContain("http://"); + } + } + } + + @Test + @SuppressWarnings("resource") + void downstreamCutAfterHeadersProducesPartialResponseEvidence() throws Exception { + ToxiproxyFixture.requireAvailable(); + try (Network network = Network.newNetwork(); + GenericContainer upstream = + new GenericContainer<>(UPSTREAM_IMAGE) + .withNetwork(network) + .withNetworkAliases("upstream") + .withExposedPorts(80)) { + upstream.start(); + try (ToxiproxyFixture toxiproxy = ToxiproxyFixture.start(network)) { + Proxy proxy = toxiproxy.proxyTo("partial-response", "upstream", 80); + // Enough for the HTTP status/headers and some payload, deliberately not the full 4 KiB. + toxiproxy.limitDownstreamData(proxy, 512); + + HttpClientException failure = + callThrough(toxiproxy, "/bytes/4096", ResponseType.of(byte[].class)); + + assertThat(failure.metadata().evidence()).isEqualTo(ExecutionEvidence.PARTIAL_RESPONSE); + assertThat(failure.getMessage()).doesNotContain("http://"); + } + } + } + + private static HttpClientException callThrough( + ToxiproxyFixture toxiproxy, String path, ResponseType responseType) throws Exception { + URI baseUrl = + URI.create("http://" + toxiproxy.proxiedHost() + ":" + toxiproxy.proxiedPort() + "/"); + try (TestGateways.Harness harness = + TestGateways.forProfile(ClientProfiles.builder("faulty").baseUrl(baseUrl).build())) { + return org.assertj.core.api.Assertions.catchThrowableOfType( + HttpClientException.class, + () -> + harness + .gateway() + .exchange( + harness.profile().name(), + HttpOperation.get(new OperationName("fault-probe"), path, Map.of()), + responseType)); + } + } +} diff --git a/src/adapter/outbound/httpclient/src/testFixtures/java/dev/caskeleton/adapter/outbound/httpclient/testkit/ToxiproxyFixture.java b/src/adapter/outbound/httpclient/src/integrationTest/java/dev/caskeleton/adapter/outbound/httpclient/testkit/ToxiproxyFixture.java similarity index 93% rename from src/adapter/outbound/httpclient/src/testFixtures/java/dev/caskeleton/adapter/outbound/httpclient/testkit/ToxiproxyFixture.java rename to src/adapter/outbound/httpclient/src/integrationTest/java/dev/caskeleton/adapter/outbound/httpclient/testkit/ToxiproxyFixture.java index afdf9ff1..cc671754 100644 --- a/src/adapter/outbound/httpclient/src/testFixtures/java/dev/caskeleton/adapter/outbound/httpclient/testkit/ToxiproxyFixture.java +++ b/src/adapter/outbound/httpclient/src/integrationTest/java/dev/caskeleton/adapter/outbound/httpclient/testkit/ToxiproxyFixture.java @@ -95,6 +95,11 @@ public final class ToxiproxyFixture implements AutoCloseable { proxy.toxics().resetPeer("reset", ToxicDirection.DOWNSTREAM, after.toMillis()); } + /** Cuts the downstream TCP stream after an exact byte budget. */ + public void limitDownstreamData(Proxy proxy, long bytes) throws IOException { + proxy.toxics().limitData("limit-data", ToxicDirection.DOWNSTREAM, bytes); + } + @Override public void close() { container.stop(); diff --git a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/auth/ProxyCredentialProvider.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/auth/ProxyCredentialProvider.java deleted file mode 100644 index 7c1681d8..00000000 --- a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/auth/ProxyCredentialProvider.java +++ /dev/null @@ -1,36 +0,0 @@ -package dev.caskeleton.adapter.outbound.httpclient.auth; - -import java.nio.charset.StandardCharsets; -import java.util.Base64; -import java.util.Objects; -import java.util.function.Function; - -/** - * Proxy authentication, kept strictly separate from target authentication (design §24.3). - * - *

Merging the two is how a proxy credential ends up on the target request — visible to the - * upstream and to anything that logs it. - */ -public final class ProxyCredentialProvider implements RequestCredentialProvider { - - private final String secretReference; - private final Function secretResolver; - - public ProxyCredentialProvider(String secretReference, Function secretResolver) { - this.secretReference = Objects.requireNonNull(secretReference, "proxy secret reference"); - this.secretResolver = Objects.requireNonNull(secretResolver, "secret resolver"); - } - - @Override - public CredentialType type() { - return CredentialType.PROXY; - } - - @Override - public RequestCredentials resolve(CredentialRequest request) { - String userPassword = secretResolver.apply(secretReference); - String encoded = - Base64.getEncoder().encodeToString(userPassword.getBytes(StandardCharsets.UTF_8)); - return RequestCredentials.header("Proxy-Authorization", "Basic " + encoded); - } -} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/DynamicTargetAutoConfiguration.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/DynamicTargetAutoConfiguration.java similarity index 98% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/DynamicTargetAutoConfiguration.java rename to src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/DynamicTargetAutoConfiguration.java index 29b9348d..b3086b81 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/DynamicTargetAutoConfiguration.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/DynamicTargetAutoConfiguration.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; import dev.caskeleton.adapter.outbound.httpclient.dynamic.DefaultDynamicTargetGateway; import dev.caskeleton.adapter.outbound.httpclient.dynamic.DynamicCredentialBinding; diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientActuatorEndpoint.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientActuatorEndpoint.java similarity index 97% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientActuatorEndpoint.java rename to src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientActuatorEndpoint.java index e1b27440..9124952e 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientActuatorEndpoint.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientActuatorEndpoint.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; import dev.caskeleton.adapter.outbound.httpclient.profile.ClientProfile; import dev.caskeleton.adapter.outbound.httpclient.profile.ClientRuntime; diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientAuthenticationAutoConfiguration.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientAuthenticationAutoConfiguration.java similarity index 73% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientAuthenticationAutoConfiguration.java rename to src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientAuthenticationAutoConfiguration.java index 3ab25afd..d1fb5300 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientAuthenticationAutoConfiguration.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientAuthenticationAutoConfiguration.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; import dev.caskeleton.adapter.outbound.httpclient.auth.ApiKeyHeaderCredentialProvider; import dev.caskeleton.adapter.outbound.httpclient.auth.BasicCredentialProvider; @@ -8,7 +8,8 @@ import dev.caskeleton.adapter.outbound.httpclient.auth.OAuth2CredentialProvider; import dev.caskeleton.adapter.outbound.httpclient.auth.ReactiveCredentialProviderRegistry; import dev.caskeleton.adapter.outbound.httpclient.auth.ReactiveRequestCredentialProvider; import dev.caskeleton.adapter.outbound.httpclient.auth.StaticBearerCredentialProvider; -import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; +import dev.caskeleton.adapter.outbound.support.CapabilityStartupValidationException; +import dev.caskeleton.application.outbound.SecretSourcePort; import java.time.Clock; import java.util.Set; import java.util.function.Function; @@ -35,13 +36,41 @@ public class HttpClientAuthenticationAutoConfiguration { @Bean @ConditionalOnMissingBean(name = "httpClientSecretResolver") - Function httpClientSecretResolver() { + Function httpClientSecretResolver( + ObjectProvider secretSources) { return reference -> { - throw StartupFailures.envValidation( - "no http client secret resolver is configured for reference '" + reference + "'"); + SecretSourcePort source = secretSources.getIfAvailable(); + if (source == null) { + throw new CapabilityStartupValidationException( + "no SecretSourcePort is configured for HTTP credential reference '" + reference + "'"); + } + String key = secretKey(reference); + return source + .resolve(key) + .orElseThrow( + () -> + new CapabilityStartupValidationException( + "HTTP credential reference '" + reference + "' resolved to nothing")); }; } + private static String secretKey(String reference) { + if (reference == null || reference.isBlank()) { + throw new CapabilityStartupValidationException("HTTP credential reference must be non-blank"); + } + if (!reference.startsWith("secret://")) { + return reference; + } + String path = reference.substring("secret://".length()); + int separator = path.lastIndexOf('/'); + String key = separator >= 0 ? path.substring(separator + 1) : path; + if (key.isBlank()) { + throw new CapabilityStartupValidationException( + "HTTP credential reference '" + reference + "' does not name a secret"); + } + return key; + } + @Bean @ConditionalOnMissingBean CredentialProviderRegistry httpClientCredentialProviderRegistry( diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientEnvironmentKeys.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientEnvironmentKeys.java similarity index 97% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientEnvironmentKeys.java rename to src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientEnvironmentKeys.java index c554e4c3..651f6edc 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientEnvironmentKeys.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientEnvironmentKeys.java @@ -1,6 +1,6 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; -import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; +import dev.caskeleton.adapter.outbound.support.CapabilityStartupValidationException; import java.lang.reflect.ParameterizedType; import java.lang.reflect.RecordComponent; import java.util.LinkedHashMap; @@ -85,7 +85,7 @@ final class HttpClientEnvironmentKeys { } } if (!unrecognised.isEmpty()) { - throw StartupFailures.envValidation( + throw new CapabilityStartupValidationException( "unrecognised HTTP client environment variables " + unrecognised + "; see docs/httpclient/env-fields.yaml for the accepted names"); diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientManagementAutoConfiguration.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientManagementAutoConfiguration.java similarity index 92% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientManagementAutoConfiguration.java rename to src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientManagementAutoConfiguration.java index d50a28ef..a5a4f7cb 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientManagementAutoConfiguration.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientManagementAutoConfiguration.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; import dev.caskeleton.adapter.outbound.httpclient.profile.ClientRuntimeRegistry; import org.springframework.boot.actuate.autoconfigure.endpoint.condition.ConditionalOnAvailableEndpoint; diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientObservationAutoConfiguration.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientObservationAutoConfiguration.java similarity index 95% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientObservationAutoConfiguration.java rename to src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientObservationAutoConfiguration.java index 306214e6..22cd236d 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientObservationAutoConfiguration.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientObservationAutoConfiguration.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; import dev.caskeleton.adapter.outbound.httpclient.observation.HttpClientTagPolicy; import dev.caskeleton.adapter.outbound.httpclient.restclient.BlockingExecutionSupport; diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientPlatformAutoConfiguration.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientPlatformAutoConfiguration.java similarity index 97% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientPlatformAutoConfiguration.java rename to src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientPlatformAutoConfiguration.java index 619177e5..203cda54 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientPlatformAutoConfiguration.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientPlatformAutoConfiguration.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; import org.springframework.boot.autoconfigure.AutoConfiguration; import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientPlatformSettings.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientPlatformSettings.java similarity index 95% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientPlatformSettings.java rename to src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientPlatformSettings.java index 79cff694..3c7aad52 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientPlatformSettings.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientPlatformSettings.java @@ -1,6 +1,6 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; -import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; +import dev.caskeleton.adapter.outbound.support.CapabilityStartupValidationException; import java.time.Duration; import java.util.ArrayList; import java.util.LinkedHashMap; @@ -52,7 +52,7 @@ public record HttpClientPlatformSettings( // An active platform with nothing to call still holds transport providers, a resilience // registry and five caller-facing gateways that no caller can reach. That is not a working // deployment with an empty configuration; it is a configuration mistake with a running cost. - throw StartupFailures.envValidation( + throw new CapabilityStartupValidationException( "HTTPCLIENT_ACTIVE_WITHOUT_CLIENTS: " + PREFIX + ".enabled is true but no client is declared under " @@ -77,16 +77,17 @@ public record HttpClientPlatformSettings( Map byNormalisedForm = new LinkedHashMap<>(); for (String name : names) { if (name == null || name.isBlank()) { - throw StartupFailures.envValidation(where + "[*].name must be non-blank"); + throw new CapabilityStartupValidationException(where + "[*].name must be non-blank"); } if (seen.contains(name)) { - throw StartupFailures.envValidation(where + " declares '" + name + "' more than once"); + throw new CapabilityStartupValidationException( + where + " declares '" + name + "' more than once"); } seen.add(name); String normalised = name.toUpperCase(Locale.ROOT).replaceAll("[^A-Z0-9]", ""); String previous = byNormalisedForm.putIfAbsent(normalised, name); if (previous != null) { - throw StartupFailures.envValidation( + throw new CapabilityStartupValidationException( where + " declares '" + previous diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientPlatformSettingsBinder.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientPlatformSettingsBinder.java similarity index 91% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientPlatformSettingsBinder.java rename to src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientPlatformSettingsBinder.java index 1ea95d3c..5448a338 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientPlatformSettingsBinder.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientPlatformSettingsBinder.java @@ -1,6 +1,6 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; -import dev.caskeleton.bootstrap.autoconfigure.StrictSettingsBinder; +import dev.caskeleton.adapter.outbound.support.StrictSettingsBinder; import org.springframework.core.env.Environment; import org.springframework.core.env.SystemEnvironmentPropertySource; diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientProfileAutoConfiguration.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientProfileAutoConfiguration.java similarity index 89% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientProfileAutoConfiguration.java rename to src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientProfileAutoConfiguration.java index 3b9856d8..db3c0fb6 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientProfileAutoConfiguration.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientProfileAutoConfiguration.java @@ -1,8 +1,9 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; import dev.caskeleton.adapter.outbound.httpclient.api.ClientProfileName; import dev.caskeleton.adapter.outbound.httpclient.auth.CredentialProviderRegistry; import dev.caskeleton.adapter.outbound.httpclient.auth.ReactiveRequestCredentialProvider; +import dev.caskeleton.adapter.outbound.httpclient.dynamic.DynamicCredentialBinding; import dev.caskeleton.adapter.outbound.httpclient.profile.ClientApiType; import dev.caskeleton.adapter.outbound.httpclient.profile.ClientProfile; import dev.caskeleton.adapter.outbound.httpclient.profile.ClientRuntime; @@ -18,10 +19,12 @@ import dev.caskeleton.adapter.outbound.httpclient.transport.BlockingTransportPro import dev.caskeleton.adapter.outbound.httpclient.transport.ReactiveTransportProvider; import dev.caskeleton.adapter.outbound.httpclient.transport.TransportLifecycleListener; import dev.caskeleton.adapter.outbound.httpclient.webclient.WebClientRuntimeFactory; +import dev.caskeleton.application.outbound.SecretSourcePort; import java.util.LinkedHashMap; import java.util.List; import java.util.Map; import java.util.random.RandomGenerator; +import org.springframework.beans.factory.ObjectProvider; import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; @@ -64,10 +67,17 @@ public class HttpClientProfileAutoConfiguration { CredentialProviderRegistry credentialProviders, ReactiveRequestCredentialProvider reactiveCredentialProvider, BlockingExecutionSupport executionSupport, - TransportLifecycleListener lifecycleListener) { + TransportLifecycleListener lifecycleListener, + List dynamicCredentialBindings, + ObjectProvider secretSources) { Map profiles = profileFactory.create(properties); - startupValidator.validate(profiles, runtimeEnvironment(environment)); + startupValidator.validateComposition( + profiles, + properties.dynamicTargets(), + dynamicCredentialBindings, + runtimeEnvironment(environment), + secretSources.getIfAvailable() != null); RestClientRuntimeFactory blockingFactory = new RestClientRuntimeFactory( diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientProfileFactory.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientProfileFactory.java similarity index 99% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientProfileFactory.java rename to src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientProfileFactory.java index c91946ee..1efa15b5 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientProfileFactory.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientProfileFactory.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; import dev.caskeleton.adapter.outbound.httpclient.api.ClientProfileName; import dev.caskeleton.adapter.outbound.httpclient.profile.AuthenticationSettings; diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientResilienceAutoConfiguration.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientResilienceAutoConfiguration.java similarity index 94% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientResilienceAutoConfiguration.java rename to src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientResilienceAutoConfiguration.java index d33c67b9..427a592a 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientResilienceAutoConfiguration.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientResilienceAutoConfiguration.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; import dev.caskeleton.adapter.outbound.httpclient.resilience.ResilienceRegistry; import java.time.Clock; diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientSecurityAutoConfiguration.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientSecurityAutoConfiguration.java similarity index 94% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientSecurityAutoConfiguration.java rename to src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientSecurityAutoConfiguration.java index 272734df..27b62fda 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientSecurityAutoConfiguration.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientSecurityAutoConfiguration.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; import dev.caskeleton.adapter.outbound.httpclient.security.TlsMaterialProvider; import dev.caskeleton.adapter.outbound.httpclient.security.TlsPolicyValidator; diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientStartupValidator.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientStartupValidator.java similarity index 71% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientStartupValidator.java rename to src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientStartupValidator.java index 5af42d9f..046e8c60 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientStartupValidator.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientStartupValidator.java @@ -1,10 +1,12 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; import dev.caskeleton.adapter.outbound.httpclient.api.ClientProfileName; import dev.caskeleton.adapter.outbound.httpclient.api.error.HttpConfigurationException; import dev.caskeleton.adapter.outbound.httpclient.api.error.HttpFailureMetadata; +import dev.caskeleton.adapter.outbound.httpclient.dynamic.DynamicCredentialBinding; import dev.caskeleton.adapter.outbound.httpclient.profile.AuthenticationType; import dev.caskeleton.adapter.outbound.httpclient.profile.ClientApiType; +import dev.caskeleton.adapter.outbound.httpclient.profile.ClientMode; import dev.caskeleton.adapter.outbound.httpclient.profile.ClientProfile; import dev.caskeleton.adapter.outbound.httpclient.profile.ClientProfileValidator; import dev.caskeleton.adapter.outbound.httpclient.profile.ClientProfileViolation; @@ -92,6 +94,53 @@ public final class HttpClientStartupValidator { } } + void validateComposition( + Map profiles, + List dynamicTargets, + List dynamicCredentialBindings, + RuntimeEnvironment environment, + boolean secretSourceAvailable) { + validate(profiles, environment); + + List violations = new ArrayList<>(); + for (HttpClientPlatformSettings.DynamicTargetSettings target : dynamicTargets) { + ClientProfileName name = new ClientProfileName(target.name()); + ClientProfile profile = profiles.get(name); + if (profile == null) { + violations.add("DYNAMIC_TARGET_PROFILE_MISSING policy=" + target.name()); + continue; + } + if (profile.mode() != ClientMode.DYNAMIC) { + violations.add("DYNAMIC_TARGET_PROFILE_MODE_REQUIRED policy=" + target.name()); + } + if (profile.api() != ClientApiType.REST_CLIENT) { + violations.add("DYNAMIC_TARGET_PROFILE_API_UNSUPPORTED policy=" + target.name()); + } + } + + if (!secretSourceAvailable) { + profiles.forEach( + (name, profile) -> { + AuthenticationType type = profile.authentication().type(); + if (type == AuthenticationType.BASIC + || type == AuthenticationType.API_KEY_HEADER + || type == AuthenticationType.API_KEY_QUERY + || type == AuthenticationType.STATIC_BEARER) { + violations.add("SECRET_SOURCE_REQUIRED profile=" + name.value()); + } + }); + if (!dynamicCredentialBindings.isEmpty()) { + violations.add("SECRET_SOURCE_REQUIRED dynamic-credentials"); + } + } + + if (!violations.isEmpty()) { + throw new HttpConfigurationException( + "http client configuration is not safe to start:\n " + String.join("\n ", violations), + HttpFailureMetadata.startup(new ClientProfileName("startup"))); + } + } + /** * Refuses a reactive profile whose declared authentication has no non-blocking implementation. * diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientTransportAutoConfiguration.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientTransportAutoConfiguration.java similarity index 97% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientTransportAutoConfiguration.java rename to src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientTransportAutoConfiguration.java index d0c6db67..2a5029e9 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientTransportAutoConfiguration.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientTransportAutoConfiguration.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; import dev.caskeleton.adapter.outbound.httpclient.apache.ApacheBlockingTransportProvider; import dev.caskeleton.adapter.outbound.httpclient.dynamic.CallScopedDnsPin; @@ -90,8 +90,7 @@ public class HttpClientTransportAutoConfiguration { TransportType.REACTOR_NETTY, new ReactorNettyTransportProvider( Optional.ofNullable(meterRegistry.getIfAvailable()), - profile -> materialize(profile, tlsMaterialProvider), - HttpClientTransportAutoConfiguration::dynamicTargetPinning)); + profile -> materialize(profile, tlsMaterialProvider))); return Map.copyOf(providers); } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpServiceClientAutoConfiguration.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpServiceClientAutoConfiguration.java similarity index 98% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpServiceClientAutoConfiguration.java rename to src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpServiceClientAutoConfiguration.java index c949c393..b16b94e7 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpServiceClientAutoConfiguration.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpServiceClientAutoConfiguration.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; import dev.caskeleton.adapter.outbound.httpclient.profile.ClientRuntimeRegistry; import dev.caskeleton.adapter.outbound.httpclient.restclient.BlockingAttemptExecutor; diff --git a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/dynamic/DefaultDynamicTargetGateway.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/dynamic/DefaultDynamicTargetGateway.java index 22074cb1..8692bb6a 100644 --- a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/dynamic/DefaultDynamicTargetGateway.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/dynamic/DefaultDynamicTargetGateway.java @@ -18,6 +18,7 @@ import dev.caskeleton.adapter.outbound.httpclient.restclient.BlockingAttemptExec import dev.caskeleton.adapter.outbound.httpclient.restclient.BlockingClientRuntime; import dev.caskeleton.adapter.outbound.httpclient.restclient.StatusHandlingPolicy; import dev.caskeleton.adapter.outbound.httpclient.security.HeaderPolicy; +import dev.caskeleton.adapter.outbound.httpclient.security.PlatformHeaderPropagation; import dev.caskeleton.adapter.outbound.httpclient.security.PreparedOperation; import dev.caskeleton.adapter.outbound.httpclient.security.PreparedTarget; import io.micrometer.core.instrument.Tag; @@ -115,10 +116,6 @@ public final class DefaultDynamicTargetGateway implements DynamicTargetGateway { 1, runtime.support().clock().instant(), metadata); - } finally { - // Discarded at the end of the hop. Retaining it would grow without bound and, worse, - // would let a later call reuse an approval that was only ever made for this one. - resolver.forget(pinned.target().host()); } HttpCallResult result = @@ -154,6 +151,7 @@ public final class DefaultDynamicTargetGateway implements DynamicTargetGateway { Map> headers = HeaderPolicy.forOperation(IdempotencyKeyRequirement.none(), false) .validate(operation.headers(), metadata); + headers = PlatformHeaderPropagation.apply(headers); runtime.bodyLimitPolicy().validate(operation.body(), metadata); PreparedTarget target = PreparedTarget.of(pinned.target().toUri(), operation.uriTemplate()); return new PreparedOperation( diff --git a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/dynamic/ValidatedDnsResolver.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/dynamic/ValidatedDnsResolver.java index 29a3df64..84dfa01c 100644 --- a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/dynamic/ValidatedDnsResolver.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/dynamic/ValidatedDnsResolver.java @@ -8,9 +8,7 @@ import java.net.InetAddress; import java.net.UnknownHostException; import java.util.ArrayList; import java.util.List; -import java.util.Map; import java.util.Objects; -import java.util.concurrent.ConcurrentHashMap; import java.util.function.Function; /** @@ -34,7 +32,6 @@ public final class ValidatedDnsResolver { private final Function systemResolver; private final IpAddressClassifier classifier; - private final Map> approved = new ConcurrentHashMap<>(); public ValidatedDnsResolver(IpAddressClassifier classifier) { this(classifier, ValidatedDnsResolver::systemResolve); @@ -55,30 +52,18 @@ public final class ValidatedDnsResolver { List normalized = new ArrayList<>(answers.length); for (InetAddress answer : answers) { if (classifier.forbidden(answer)) { - approved.remove(host); throw new HttpTargetRejectedException( "dynamic target resolves to a forbidden address range", SCOPE); } normalized.add(IpAddressClassifier.normalize(answer)); } - List immutable = List.copyOf(normalized); - approved.put(host, immutable); - return immutable; + return List.copyOf(normalized); } public PinnedTarget pin(CanonicalTarget target) { return new PinnedTarget(target, resolve(target.host())); } - /** Addresses the transport may connect to; empty when the host was never validated. */ - public List approvedAddresses(String host) { - return approved.getOrDefault(host, List.of()); - } - - public void forget(String host) { - approved.remove(host); - } - private static InetAddress[] systemResolve(String host) { try { return InetAddress.getAllByName(host); diff --git a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/reactor/ReactorHttpClientFactory.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/reactor/ReactorHttpClientFactory.java index 2fb89119..e9e88bb1 100644 --- a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/reactor/ReactorHttpClientFactory.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/reactor/ReactorHttpClientFactory.java @@ -4,9 +4,6 @@ import dev.caskeleton.adapter.outbound.httpclient.profile.ClientProfile; import dev.caskeleton.adapter.outbound.httpclient.security.SslContextMaterial; import io.netty.channel.ChannelOption; import io.netty.handler.ssl.SslContextBuilder; -import io.netty.resolver.AddressResolverGroup; -import java.net.InetAddress; -import java.util.List; import java.util.Objects; import java.util.Optional; import java.util.function.Function; @@ -30,8 +27,7 @@ public final class ReactorHttpClientFactory { public HttpClient create( ClientProfile profile, ConnectionProvider connectionProvider, - Optional tlsMaterial, - Optional>> approvedAddresses) { + Optional tlsMaterial) { Objects.requireNonNull(profile, "profile"); Objects.requireNonNull(connectionProvider, "connection provider"); @@ -62,10 +58,6 @@ public final class ReactorHttpClientFactory { profile.timeout().readIdle().toMillis(), java.util.concurrent.TimeUnit.MILLISECONDS))); - if (approvedAddresses.isPresent()) { - AddressResolverGroup resolver = new ValidatedAddressResolverGroup(approvedAddresses.get()); - client = client.resolver(resolver); - } // Configured whether or not custom material is supplied. It used to be inside this isPresent, // so a profile declaring `tls.protocols: [TLSv1.3]` against the JVM trust store — the common // case — configured no TLS parameters at all and accepted whatever the platform default diff --git a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/reactor/ReactorNettyTransportProvider.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/reactor/ReactorNettyTransportProvider.java index 32d596a8..b7942510 100644 --- a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/reactor/ReactorNettyTransportProvider.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/reactor/ReactorNettyTransportProvider.java @@ -10,8 +10,6 @@ import dev.caskeleton.adapter.outbound.httpclient.transport.TransportId; import dev.caskeleton.adapter.outbound.httpclient.transport.TransportLifecycleListener; import dev.caskeleton.adapter.outbound.httpclient.transport.TransportResourceKey; import io.micrometer.core.instrument.MeterRegistry; -import java.net.InetAddress; -import java.util.List; import java.util.Map; import java.util.Objects; import java.util.Optional; @@ -38,20 +36,16 @@ public final class ReactorNettyTransportProvider implements ReactiveTransportPro private final Map pools = new ConcurrentHashMap<>(); private final Optional meterRegistry; private final Function> tlsMaterialResolver; - private final Function>>> - resolverFactory; public ReactorNettyTransportProvider() { - this(Optional.empty(), profile -> Optional.empty(), profile -> Optional.empty()); + this(Optional.empty(), profile -> Optional.empty()); } public ReactorNettyTransportProvider( Optional meterRegistry, - Function> tlsMaterialResolver, - Function>>> resolverFactory) { + Function> tlsMaterialResolver) { this.meterRegistry = Objects.requireNonNull(meterRegistry, "meter registry"); this.tlsMaterialResolver = Objects.requireNonNull(tlsMaterialResolver, "tls material resolver"); - this.resolverFactory = Objects.requireNonNull(resolverFactory, "dns resolver factory"); } @Override @@ -75,8 +69,7 @@ public final class ReactorNettyTransportProvider implements ReactiveTransportPro registry -> ReactorPoolMetricsBinder.bind(registry, profile.name(), pool)); listener.onRuntimeCreated(profile.name(), ID); return new ReactorClientHttpConnector( - clientFactory.create( - profile, pool, tlsMaterialResolver.apply(profile), resolverFactory.apply(profile))); + clientFactory.create(profile, pool, tlsMaterialResolver.apply(profile))); } @Override diff --git a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/reactor/ValidatedAddressResolverGroup.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/reactor/ValidatedAddressResolverGroup.java deleted file mode 100644 index dbe16acd..00000000 --- a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/reactor/ValidatedAddressResolverGroup.java +++ /dev/null @@ -1,58 +0,0 @@ -package dev.caskeleton.adapter.outbound.httpclient.reactor; - -import io.netty.resolver.AddressResolver; -import io.netty.resolver.AddressResolverGroup; -import io.netty.resolver.InetNameResolver; -import io.netty.resolver.InetSocketAddressResolver; -import io.netty.util.concurrent.EventExecutor; -import io.netty.util.concurrent.Promise; -import java.net.InetAddress; -import java.net.InetSocketAddress; -import java.net.UnknownHostException; -import java.util.List; -import java.util.Objects; -import java.util.function.Function; - -/** - * Makes Reactor Netty connect only to addresses the Dynamic Target policy already approved (design - * §22.3). - * - *

Validating addresses and then letting the transport resolve the host again is a - * check-then-connect gap: the second answer can differ. Routing the transport's own resolution - * through the validated set closes it. - */ -public final class ValidatedAddressResolverGroup extends AddressResolverGroup { - - private final Function> approvedAddresses; - - public ValidatedAddressResolverGroup(Function> approvedAddresses) { - this.approvedAddresses = Objects.requireNonNull(approvedAddresses, "approved addresses"); - } - - @Override - protected AddressResolver newResolver(EventExecutor executor) { - InetNameResolver nameResolver = - new InetNameResolver(executor) { - @Override - protected void doResolve(String inetHost, Promise promise) { - List approved = approvedAddresses.apply(inetHost); - if (approved.isEmpty()) { - promise.setFailure(new UnknownHostException(inetHost)); - return; - } - promise.setSuccess(approved.get(0)); - } - - @Override - protected void doResolveAll(String inetHost, Promise> promise) { - List approved = approvedAddresses.apply(inetHost); - if (approved.isEmpty()) { - promise.setFailure(new UnknownHostException(inetHost)); - return; - } - promise.setSuccess(approved); - } - }; - return new InetSocketAddressResolver(executor, nameResolver); - } -} diff --git a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/resilience/ReactiveAttemptResiliencePipeline.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/resilience/ReactiveAttemptResiliencePipeline.java new file mode 100644 index 00000000..fe4719e3 --- /dev/null +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/resilience/ReactiveAttemptResiliencePipeline.java @@ -0,0 +1,108 @@ +package dev.caskeleton.adapter.outbound.httpclient.resilience; + +import dev.caskeleton.adapter.outbound.httpclient.api.error.HttpBulkheadRejectedException; +import dev.caskeleton.adapter.outbound.httpclient.api.error.HttpCircuitOpenException; +import dev.caskeleton.adapter.outbound.httpclient.api.error.HttpFailureMetadata; +import dev.caskeleton.adapter.outbound.httpclient.api.error.HttpRateLimitRejectedException; +import java.util.Objects; +import java.util.Optional; +import java.util.concurrent.atomic.AtomicBoolean; +import java.util.function.Function; +import java.util.function.Supplier; +import reactor.core.publisher.Mono; + +/** + * Reactive counterpart of {@link AttemptResiliencePipeline}. + * + *

The same circuit breaker, rate limiter and semaphore bulkhead are used, but their permits live + * until the subscribed attempt terminates. Wrapping only the construction of a {@code Mono} would + * release every permit before a socket operation starts and would make the guards observationally + * present but operationally useless. + */ +public final class ReactiveAttemptResiliencePipeline { + + private final AttemptCircuitBreaker circuitBreaker; + private final AttemptRateLimiter rateLimiter; + private final BlockingAttemptBulkhead bulkhead; + private final Supplier metadataSupplier; + private final ResilienceRejectionRecorder rejections; + + public ReactiveAttemptResiliencePipeline( + AttemptCircuitBreaker circuitBreaker, + AttemptRateLimiter rateLimiter, + BlockingAttemptBulkhead bulkhead, + Supplier metadataSupplier, + ResilienceRejectionRecorder rejections) { + this.circuitBreaker = Objects.requireNonNull(circuitBreaker, "circuit breaker"); + this.rateLimiter = Objects.requireNonNull(rateLimiter, "rate limiter"); + this.bulkhead = Objects.requireNonNull(bulkhead, "bulkhead"); + this.metadataSupplier = Objects.requireNonNull(metadataSupplier, "failure metadata supplier"); + this.rejections = Objects.requireNonNull(rejections, "rejection recorder"); + } + + public String circuitState() { + return circuitBreaker.state(); + } + + public Mono execute( + Mono attempt, Function> remoteFailureClassifier) { + Objects.requireNonNull(attempt, "attempt"); + Objects.requireNonNull(remoteFailureClassifier, "remote failure classifier"); + + return Mono.defer( + () -> { + if (!circuitBreaker.tryAcquirePermission()) { + rejections.circuitOpen(); + return Mono.error( + new HttpCircuitOpenException( + "upstream circuit breaker is open", metadataSupplier.get())); + } + if (!rateLimiter.tryAcquirePermission()) { + rejections.rateLimited(); + return Mono.error( + new HttpRateLimitRejectedException( + "local attempt rate limit reached", metadataSupplier.get())); + } + if (!bulkhead.tryAcquire()) { + rateLimiter.onCompleted(); + rejections.bulkheadRejected(); + return Mono.error( + new HttpBulkheadRejectedException( + "attempt bulkhead has no permit available", metadataSupplier.get())); + } + + long started = System.nanoTime(); + AtomicBoolean breakerRecorded = new AtomicBoolean(); + AtomicBoolean released = new AtomicBoolean(); + Runnable release = + () -> { + if (released.compareAndSet(false, true)) { + bulkhead.release(); + rateLimiter.onCompleted(); + } + }; + + return attempt + .doOnSuccess( + result -> { + if (breakerRecorded.compareAndSet(false, true)) { + Optional remoteFailure = + result == null ? Optional.empty() : remoteFailureClassifier.apply(result); + if (remoteFailure.isPresent()) { + circuitBreaker.onError( + System.nanoTime() - started, remoteFailure.orElseThrow()); + } else { + circuitBreaker.onSuccess(System.nanoTime() - started); + } + } + }) + .doOnError( + failure -> { + if (breakerRecorded.compareAndSet(false, true)) { + circuitBreaker.onError(System.nanoTime() - started, failure); + } + }) + .doFinally(ignored -> release.run()); + }); + } +} diff --git a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/resilience/ResilienceRegistry.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/resilience/ResilienceRegistry.java index a0957ebb..e64aa49e 100644 --- a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/resilience/ResilienceRegistry.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/resilience/ResilienceRegistry.java @@ -2,6 +2,7 @@ package dev.caskeleton.adapter.outbound.httpclient.resilience; import dev.caskeleton.adapter.outbound.httpclient.api.ClientProfileName; import io.github.resilience4j.circuitbreaker.CircuitBreakerRegistry; +import io.github.resilience4j.ratelimiter.RateLimiterConfig; import io.github.resilience4j.ratelimiter.RateLimiterRegistry; import java.time.Clock; import java.time.Duration; @@ -35,7 +36,22 @@ public final class ResilienceRegistry { public static ResilienceRegistry withDefaults(Clock clock) { return new ResilienceRegistry( - CircuitBreakerRegistry.ofDefaults(), RateLimiterRegistry.ofDefaults(), clock); + CircuitBreakerRegistry.ofDefaults(), + RateLimiterRegistry.of(defaultRateLimiterConfig()), + clock); + } + + /** + * Keeps the library's conservative default quota shape but removes its five-second blocking wait. + * + *

The HTTP runtime owns the total-call deadline. A local rate limiter must therefore answer + * immediately rather than consume time outside that deadline before the request pipeline can + * account for it. + */ + static RateLimiterConfig defaultRateLimiterConfig() { + return RateLimiterConfig.from(RateLimiterConfig.ofDefaults()) + .timeoutDuration(Duration.ZERO) + .build(); } public AttemptCircuitBreaker circuitBreaker(ClientProfileName profileName) { diff --git a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/restclient/BlockingAttemptExecutor.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/restclient/BlockingAttemptExecutor.java index 3317df91..c8ef67f1 100644 --- a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/restclient/BlockingAttemptExecutor.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/restclient/BlockingAttemptExecutor.java @@ -8,6 +8,7 @@ import dev.caskeleton.adapter.outbound.httpclient.api.operation.AttemptStage; import dev.caskeleton.adapter.outbound.httpclient.api.operation.FailureCategory; import dev.caskeleton.adapter.outbound.httpclient.api.result.ResponseType; import dev.caskeleton.adapter.outbound.httpclient.auth.RequestCredentials; +import dev.caskeleton.adapter.outbound.httpclient.observation.AttemptObservation; import dev.caskeleton.adapter.outbound.httpclient.resilience.AttemptOutcome; import dev.caskeleton.adapter.outbound.httpclient.resilience.AttemptProgressTracker; import dev.caskeleton.adapter.outbound.httpclient.resilience.ProtocolEvidence; @@ -48,6 +49,17 @@ public final class BlockingAttemptExecutor { Objects.requireNonNull(runtime, "runtime"); BlockingExecutionSupport support = runtime.support(); AttemptProgressTracker tracker = new AttemptProgressTracker(); + AttemptObservation observation = + AttemptObservation.start( + support.meterRegistry(), + support.tagPolicy(), + runtime.name(), + prepared.operation().operationName(), + prepared.operation().method().name(), + prepared.operation().uriTemplate(), + runtime.transportId().value(), + runtime.profile().protocols().iterator().next().name()); + prepared.operation().body().knownLength().ifPresent(observation::recordRequestBytes); ResponseSizeLimiter limiter = new ResponseSizeLimiter( prepared.maxResponseWireBytes(), prepared.maxResponseDecodedBytes(), baseMetadata); @@ -58,46 +70,56 @@ public final class BlockingAttemptExecutor { // "the socket returned bytes", and a redirect hop no longer re-enters the pipeline while the // permits for its own attempt are still held — which with a single-permit bulkhead was a // guaranteed self-rejection, and with any configuration double-counted the rate limiter. - return runtime - .resiliencePipeline() - .execute( - () -> { - RestClientResponseReader.RawResponse response = - sendWithRedirects( - runtime, prepared, credentials, tracker, limiter, baseMetadata); - Duration elapsed = Duration.between(startedAt, support.clock().instant()); - try { - return AttemptOutcome.succeeded( - support - .responseMapper() - .map( - response, - responseType, - runtime.profile().response(), - statusHandlingPolicy, - attemptNumber, - elapsed, - baseMetadata)); - } catch (HttpRemoteErrorException remoteError) { - // Retry-After is read from the response the mapper already bounded, so the - // decision engine can honour it without the transport interpreting it. - return AttemptOutcome.failed( - remoteError, - FailureCategory.REMOTE_STATUS, - retryAfter(response), - tracker.firstByteDelivered()); - } catch (HttpClientException stable) { - return AttemptOutcome.failed( - stable, categoryOf(stable), Optional.empty(), tracker.firstByteDelivered()); - } - }, - outcome -> - outcome.failureCategory() == FailureCategory.REMOTE_STATUS - ? outcome.failure().map(failure -> (Throwable) failure) - : Optional.empty()); + AttemptOutcome attemptOutcome = + runtime + .resiliencePipeline() + .execute( + () -> { + RestClientResponseReader.RawResponse response = + sendWithRedirects( + runtime, prepared, credentials, tracker, limiter, baseMetadata); + observation.recordResponseBytes(response.bodyLength()); + Duration elapsed = Duration.between(startedAt, support.clock().instant()); + try { + return AttemptOutcome.succeeded( + support + .responseMapper() + .map( + response, + responseType, + runtime.profile().response(), + statusHandlingPolicy, + attemptNumber, + elapsed, + baseMetadata)); + } catch (HttpRemoteErrorException remoteError) { + // Retry-After is read from the response the mapper already bounded, so the + // decision engine can honour it without the transport interpreting it. + return AttemptOutcome.failed( + remoteError, + FailureCategory.REMOTE_STATUS, + retryAfter(response), + tracker.firstByteDelivered()); + } catch (HttpClientException stable) { + return AttemptOutcome.failed( + stable, + categoryOf(stable), + Optional.empty(), + tracker.firstByteDelivered()); + } + }, + outcome -> + outcome.failureCategory() == FailureCategory.REMOTE_STATUS + ? outcome.failure().map(failure -> (Throwable) failure) + : Optional.empty()); + stopObservation(observation, attemptOutcome); + return attemptOutcome; } catch (HttpClientException stable) { - return AttemptOutcome.failed( - stable, categoryOf(stable), Optional.empty(), tracker.firstByteDelivered()); + AttemptOutcome outcome = + AttemptOutcome.failed( + stable, categoryOf(stable), Optional.empty(), tracker.firstByteDelivered()); + stopObservation(observation, outcome); + return outcome; } catch (RuntimeException engineFailure) { TransportFailure classified = runtime.failureClassifier().classify(engineFailure, tracker.stage()); @@ -110,11 +132,25 @@ public final class BlockingAttemptExecutor { .withStage(classified.stage()); HttpClientException mapped = support.exceptionMapper().map(classified, metadata, engineFailure); - return AttemptOutcome.failed( - mapped, classified.category(), Optional.empty(), tracker.firstByteDelivered()); + AttemptOutcome outcome = + AttemptOutcome.failed( + mapped, classified.category(), Optional.empty(), tracker.firstByteDelivered()); + stopObservation(observation, outcome); + return outcome; } } + private void stopObservation(AttemptObservation observation, AttemptOutcome outcome) { + if (outcome.failureCategory() == FailureCategory.RESPONSE_TIMEOUT + || outcome.failureCategory() == FailureCategory.POOL_ACQUIRE_TIMEOUT + || outcome.failureCategory() == FailureCategory.DEADLINE_EXCEEDED) { + observation.recordTimeout( + outcome.failureCategory().name().toLowerCase(java.util.Locale.ROOT)); + } + observation.stop( + outcome.status(), outcome.evidence(), outcome.successful() ? "success" : "failure"); + } + private RestClientResponseReader.RawResponse sendWithRedirects( BlockingClientRuntime runtime, PreparedOperation prepared, @@ -202,7 +238,11 @@ public final class BlockingAttemptExecutor { httpResponse.getStatusCode().value(), httpResponse.getHeaders(), httpResponse.getBody(), - limiter); + limiter, + read -> { + tracker.enter(AttemptStage.RESPONSE_BODY); + tracker.recordDeliveredBytes(read); + }); tracker.enter(AttemptStage.COMPLETE); return response; }, diff --git a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/restclient/RestClientResponseReader.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/restclient/RestClientResponseReader.java index de93a1be..ef841c2b 100644 --- a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/restclient/RestClientResponseReader.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/restclient/RestClientResponseReader.java @@ -101,7 +101,24 @@ public final class RestClientResponseReader { public RawResponse readBounded( int status, HttpHeaders headers, InputStream body, ResponseSizeLimiter limiter) throws IOException { - try (InputStream counted = new CountingBoundedInputStream(body, limiter::recordWireBytes)) { + return readBounded(status, headers, body, limiter, ignored -> {}); + } + + public RawResponse readBounded( + int status, + HttpHeaders headers, + InputStream body, + ResponseSizeLimiter limiter, + java.util.function.LongConsumer responseBytes) + throws IOException { + Objects.requireNonNull(responseBytes, "response byte observer"); + try (InputStream counted = + new CountingBoundedInputStream( + body, + read -> { + limiter.recordWireBytes(read); + responseBytes.accept(read); + })) { byte[] bytes = counted.readAllBytes(); limiter.recordDecodedBytes(bytes.length); return new RawResponse(status, toMap(headers), bytes); diff --git a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/security/HeaderPolicy.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/security/HeaderPolicy.java index 6be107ea..b3017307 100644 --- a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/security/HeaderPolicy.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/security/HeaderPolicy.java @@ -30,6 +30,7 @@ public final class HeaderPolicy { "transfer-encoding", "traceparent", "tracestate", + "x-correlation-id", "baggage", "cookie"); diff --git a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/security/PlatformHeaderPropagation.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/security/PlatformHeaderPropagation.java new file mode 100644 index 00000000..92368baf --- /dev/null +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/security/PlatformHeaderPropagation.java @@ -0,0 +1,46 @@ +package dev.caskeleton.adapter.outbound.httpclient.security; + +import dev.caskeleton.shared.tracing.TraceParent; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import org.slf4j.MDC; + +/** + * Projects the current platform correlation context onto an outbound HTTP request. + * + *

The inbound boundary owns trust of incoming trace/correlation headers and records the accepted + * identifiers in MDC. The outbound client owns rendering those accepted values back onto the wire. + * Callers cannot supply these headers directly; {@link HeaderPolicy} rejects that attempt. + * + *

No client span is invented here. When a current trace/span id exists, that span becomes the + * W3C parent id seen by the upstream. The sampled bit is conservatively cleared because the shared + * MDC contract does not carry trace flags. + */ +public final class PlatformHeaderPropagation { + + static final String TRACEPARENT = "traceparent"; + static final String CORRELATION_ID = "X-Correlation-Id"; + private static final String MDC_TRACE_ID = "trace_id"; + private static final String MDC_SPAN_ID = "span_id"; + private static final String MDC_CORRELATION_ID = "correlation_id"; + + private PlatformHeaderPropagation() {} + + public static Map> apply(Map> input) { + Map> propagated = new LinkedHashMap<>(input); + + String traceId = MDC.get(MDC_TRACE_ID); + String spanId = MDC.get(MDC_SPAN_ID); + if (TraceParent.isValidTraceId(traceId) && TraceParent.isValidSpanId(spanId)) { + propagated.put(TRACEPARENT, List.of(TraceParent.of(traceId, spanId, false).toHeader())); + } + + String correlationId = MDC.get(MDC_CORRELATION_ID); + if (correlationId != null && !correlationId.isBlank()) { + propagated.put(CORRELATION_ID, List.of(correlationId)); + } + + return Map.copyOf(propagated); + } +} diff --git a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/security/TrustedTargetPolicy.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/security/TrustedTargetPolicy.java index 893051f2..67a35b81 100644 --- a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/security/TrustedTargetPolicy.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/security/TrustedTargetPolicy.java @@ -79,6 +79,7 @@ public final class TrustedTargetPolicy { HeaderPolicy.forOperation(idempotencyKeyRequirement, false) .validate(operation.headers(), metadata); headers = withIdempotencyKey(operation, idempotencyKeyRequirement, headers, metadata); + headers = PlatformHeaderPropagation.apply(headers); bodyLimitPolicy.validate(operation.body(), metadata); return new PreparedOperation( diff --git a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/DefaultReactiveHttpGateway.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/DefaultReactiveHttpGateway.java index 15809433..19969e03 100644 --- a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/DefaultReactiveHttpGateway.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/DefaultReactiveHttpGateway.java @@ -3,6 +3,7 @@ package dev.caskeleton.adapter.outbound.httpclient.webclient; import dev.caskeleton.adapter.outbound.httpclient.api.ClientProfileName; import dev.caskeleton.adapter.outbound.httpclient.api.error.HttpAmbiguousExecutionException; import dev.caskeleton.adapter.outbound.httpclient.api.error.HttpClientException; +import dev.caskeleton.adapter.outbound.httpclient.api.error.HttpDeadlineExceededException; import dev.caskeleton.adapter.outbound.httpclient.api.error.HttpFailureMetadata; import dev.caskeleton.adapter.outbound.httpclient.api.error.HttpRateLimitRejectedException; import dev.caskeleton.adapter.outbound.httpclient.api.operation.ExecutionEvidence; @@ -16,10 +17,12 @@ import dev.caskeleton.adapter.outbound.httpclient.profile.ClientRuntimeLease; import dev.caskeleton.adapter.outbound.httpclient.profile.ClientRuntimeRegistry; import dev.caskeleton.adapter.outbound.httpclient.resilience.AttemptOutcome; import dev.caskeleton.adapter.outbound.httpclient.resilience.Deadline; +import dev.caskeleton.adapter.outbound.httpclient.resilience.DeadlineGuard; import dev.caskeleton.adapter.outbound.httpclient.resilience.ReactiveLogicalCall; import dev.caskeleton.adapter.outbound.httpclient.resilience.ReactiveRetryCoordinator; import dev.caskeleton.adapter.outbound.httpclient.resilience.RetryAllowed; import dev.caskeleton.adapter.outbound.httpclient.resilience.RetryContext; +import dev.caskeleton.adapter.outbound.httpclient.restclient.BlockingExecutionSupport; import dev.caskeleton.adapter.outbound.httpclient.restclient.StatusHandlingPolicy; import dev.caskeleton.adapter.outbound.httpclient.security.PreparedOperation; import java.time.Duration; @@ -140,6 +143,13 @@ public final class DefaultReactiveHttpGateway implements ReactiveHttpGateway { runtime.retryBudget(), runtime.support().clock()); + Duration remaining = deadline.remaining(runtime.support().clock()); + if (remaining.isZero()) { + return Mono.error( + new HttpDeadlineExceededException( + "effective deadline reached before the reactive call could start", metadata)); + } + return runtime .credentialProvider() .resolve(credentialRequest(runtime, prepared, false)) @@ -157,6 +167,12 @@ public final class DefaultReactiveHttpGateway implements ReactiveHttpGateway { metadata, observation, credentials))) + .timeout( + remaining, + Mono.error( + new HttpDeadlineExceededException( + "effective total-call deadline reached before the reactive call completed", + metadata))) .doOnSuccess( result -> observation.stop( @@ -249,6 +265,20 @@ public final class DefaultReactiveHttpGateway implements ReactiveHttpGateway { new HttpRateLimitRejectedException( "runtime is draining and refuses new attempts", metadata)); } + BlockingExecutionSupport attemptSupport = runtime.support(); + HttpFailureMetadata attemptMetadata = metadata.withAttempt(attemptNumber); + DeadlineGuard guard = new DeadlineGuard(attemptSupport.clock()); + try { + guard.requireTimeRemaining(deadline, attemptMetadata); + guard.requireAttemptBudget( + attemptSupport + .attemptBudgetCalculator() + .nextAttempt( + deadline, Duration.ZERO, attemptSupport.minimumAttemptBudget(), Duration.ZERO), + attemptMetadata); + } catch (HttpClientException rejected) { + return Mono.error(rejected); + } return executor.execute( runtime, prepared, diff --git a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/DefaultReactiveSseGateway.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/DefaultReactiveSseGateway.java index 5b9588c3..7cf2f261 100644 --- a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/DefaultReactiveSseGateway.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/DefaultReactiveSseGateway.java @@ -7,7 +7,6 @@ import dev.caskeleton.adapter.outbound.httpclient.api.operation.HttpOperation; import dev.caskeleton.adapter.outbound.httpclient.api.result.ClassResponseType; import dev.caskeleton.adapter.outbound.httpclient.api.result.ResponseType; import dev.caskeleton.adapter.outbound.httpclient.auth.CredentialRequest; -import dev.caskeleton.adapter.outbound.httpclient.auth.RequestCredentials; import dev.caskeleton.adapter.outbound.httpclient.profile.ClientRuntimeLease; import dev.caskeleton.adapter.outbound.httpclient.profile.ClientRuntimeRegistry; import dev.caskeleton.adapter.outbound.httpclient.security.PreparedOperation; @@ -108,37 +107,35 @@ public final class DefaultReactiveSseGateway implements ReactiveSseGateway { PreparedOperation prepared = runtime.targetPolicy().prepare(subscribeOperation); java.net.URI uri = prepared.target().uri(); - RequestCredentials credentials = - runtime - .credentialProvider() - .resolve( - new CredentialRequest( - runtime.name(), - operation.operationName(), - runtime.profile().authentication(), - uri, - java.util.Optional.empty(), - runtime.profile().tls().keyMaterialReference(), - false)) - .block(operation.setupDeadline()); + CredentialRequest credentialRequest = + new CredentialRequest( + runtime.name(), + operation.operationName(), + runtime.profile().authentication(), + uri, + java.util.Optional.empty(), + runtime.profile().tls().keyMaterialReference(), + false); - var request = runtime.webClient().get().uri(uri).accept(MediaType.TEXT_EVENT_STREAM); - for (Map.Entry> header : prepared.headers().entrySet()) { - for (String value : header.getValue()) { - request = request.header(header.getKey(), value); - } - } - if (credentials != null) { - for (Map.Entry credential : credentials.headers().entrySet()) { - request = request.header(credential.getKey(), credential.getValue()); - } - } - if (operation.reconnectPolicy().sendLastEventId() && lastEventId.get() != null) { - request = request.header("Last-Event-ID", lastEventId.get()); - } - return request - .retrieve() - .bodyToFlux(serverSentEventType(eventType)) + return runtime + .credentialProvider() + .resolve(credentialRequest) + .flatMapMany( + credentials -> { + var request = runtime.webClient().get().uri(uri).accept(MediaType.TEXT_EVENT_STREAM); + for (Map.Entry> header : prepared.headers().entrySet()) { + for (String value : header.getValue()) { + request = request.header(header.getKey(), value); + } + } + for (Map.Entry credential : credentials.headers().entrySet()) { + request = request.header(credential.getKey(), credential.getValue()); + } + if (operation.reconnectPolicy().sendLastEventId() && lastEventId.get() != null) { + request = request.header("Last-Event-ID", lastEventId.get()); + } + return request.retrieve().bodyToFlux(serverSentEventType(eventType)); + }) .timeout( operation.setupDeadline(), Flux.error( diff --git a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/ReactiveAttemptExecutor.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/ReactiveAttemptExecutor.java index 36f2d940..fdcc53c8 100644 --- a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/ReactiveAttemptExecutor.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/ReactiveAttemptExecutor.java @@ -7,6 +7,7 @@ import dev.caskeleton.adapter.outbound.httpclient.api.operation.FailureCategory; import dev.caskeleton.adapter.outbound.httpclient.api.result.HttpCallResult; import dev.caskeleton.adapter.outbound.httpclient.api.result.ResponseType; import dev.caskeleton.adapter.outbound.httpclient.auth.RequestCredentials; +import dev.caskeleton.adapter.outbound.httpclient.observation.AttemptObservation; import dev.caskeleton.adapter.outbound.httpclient.resilience.AttemptOutcome; import dev.caskeleton.adapter.outbound.httpclient.restclient.BlockingAttemptExecutor; import dev.caskeleton.adapter.outbound.httpclient.restclient.RestClientResponseReader; @@ -49,47 +50,80 @@ public final class ReactiveAttemptExecutor { HttpFailureMetadata baseMetadata) { Objects.requireNonNull(runtime, "runtime"); - return Mono.defer( - () -> { - // Query-parameter credentials are applied here, as they are on the blocking path. - // An API_KEY_QUERY profile resolved its credential, the reactive executor read only - // the header map, and the request went out with the key missing — an authentication - // mechanism that worked on one API and silently did not on the other. - WebClient.RequestBodySpec spec = - runtime - .webClient() - .method( - org.springframework.http.HttpMethod.valueOf( - prepared.operation().method().name())) - .uri(withCredentialQuery(prepared.target().uri(), credentials)); - headers(prepared, credentials) - .forEach((name, values) -> spec.header(name, values.toArray(String[]::new))); - WebClient.RequestHeadersSpec request = - bodyWriter.write( - spec, - prepared.operation().body(), - reactiveBody, - runtime.bodyLimitPolicy(), - baseMetadata); - return request.exchangeToMono( - response -> - responseMapper.readBounded( - response, Math.toIntExact(prepared.maxResponseWireBytes()))); - }) - .map( - response -> - mapResponse( - runtime, - responseType, - statusHandlingPolicy, - attemptNumber, - startedAt, - baseMetadata, - response)) + AttemptObservation observation = + AttemptObservation.start( + runtime.support().meterRegistry(), + runtime.support().tagPolicy(), + runtime.name(), + prepared.operation().operationName(), + prepared.operation().method().name(), + prepared.operation().uriTemplate(), + runtime.transportId().value(), + runtime.profile().protocols().iterator().next().name()); + prepared.operation().body().knownLength().ifPresent(observation::recordRequestBytes); + + Mono> physicalAttempt = + Mono.defer( + () -> { + // Query-parameter credentials are applied here, as they are on the blocking path. + WebClient.RequestBodySpec spec = + runtime + .webClient() + .method( + org.springframework.http.HttpMethod.valueOf( + prepared.operation().method().name())) + .uri(withCredentialQuery(prepared.target().uri(), credentials)); + headers(prepared, credentials) + .forEach((name, values) -> spec.header(name, values.toArray(String[]::new))); + WebClient.RequestHeadersSpec request = + bodyWriter.write( + spec, + prepared.operation().body(), + reactiveBody, + runtime.bodyLimitPolicy(), + baseMetadata); + return request.exchangeToMono( + response -> + responseMapper.readBounded( + response, Math.toIntExact(prepared.maxResponseWireBytes()))); + }) + .map( + response -> { + observation.recordResponseBytes(response.bodyLength()); + return mapResponse( + runtime, + responseType, + statusHandlingPolicy, + attemptNumber, + startedAt, + baseMetadata, + response); + }); + + return runtime + .resiliencePipeline() + .execute( + physicalAttempt, + outcome -> + outcome.failureCategory() == FailureCategory.REMOTE_STATUS + ? outcome.failure().map(failure -> (Throwable) failure) + : Optional.empty()) .onErrorResume(failure -> Mono.just(mapFailure(runtime, baseMetadata, failure))) + .doOnNext(outcome -> stopObservation(observation, outcome)) .doOnDiscard(DataBuffer.class, DataBufferUtils::release); } + private void stopObservation(AttemptObservation observation, AttemptOutcome outcome) { + if (outcome.failureCategory() == FailureCategory.RESPONSE_TIMEOUT + || outcome.failureCategory() == FailureCategory.POOL_ACQUIRE_TIMEOUT + || outcome.failureCategory() == FailureCategory.DEADLINE_EXCEEDED) { + observation.recordTimeout( + outcome.failureCategory().name().toLowerCase(java.util.Locale.ROOT)); + } + observation.stop( + outcome.status(), outcome.evidence(), outcome.successful() ? "success" : "failure"); + } + private AttemptOutcome mapResponse( ReactiveClientRuntime runtime, ResponseType responseType, diff --git a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/ReactiveClientRuntime.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/ReactiveClientRuntime.java index ad4f8e67..ddba0f1c 100644 --- a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/ReactiveClientRuntime.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/ReactiveClientRuntime.java @@ -6,6 +6,7 @@ import dev.caskeleton.adapter.outbound.httpclient.profile.ClientRuntime; import dev.caskeleton.adapter.outbound.httpclient.profile.RuntimeGeneration; import dev.caskeleton.adapter.outbound.httpclient.resilience.BackoffStrategy; import dev.caskeleton.adapter.outbound.httpclient.resilience.LogicalAdmissionLimiter; +import dev.caskeleton.adapter.outbound.httpclient.resilience.ReactiveAttemptResiliencePipeline; import dev.caskeleton.adapter.outbound.httpclient.resilience.RetryBudget; import dev.caskeleton.adapter.outbound.httpclient.restclient.BlockingExecutionSupport; import dev.caskeleton.adapter.outbound.httpclient.security.BodyLimitPolicy; @@ -30,6 +31,7 @@ public final class ReactiveClientRuntime extends ClientRuntime { private final TransportFailureClassifier failureClassifier; private final TrustedTargetPolicy targetPolicy; private final BodyLimitPolicy bodyLimitPolicy; + private final ReactiveAttemptResiliencePipeline resiliencePipeline; private final LogicalAdmissionLimiter admissionLimiter; private final RetryBudget retryBudget; private final Supplier backoffFactory; @@ -43,6 +45,7 @@ public final class ReactiveClientRuntime extends ClientRuntime { WebClient webClient, TransportId transportId, TransportFailureClassifier failureClassifier, + ReactiveAttemptResiliencePipeline resiliencePipeline, LogicalAdmissionLimiter admissionLimiter, RetryBudget retryBudget, Supplier backoffFactory, @@ -52,6 +55,8 @@ public final class ReactiveClientRuntime extends ClientRuntime { this.webClient = Objects.requireNonNull(webClient, "web client"); this.transportId = Objects.requireNonNull(transportId, "transport id"); this.failureClassifier = Objects.requireNonNull(failureClassifier, "failure classifier"); + this.resiliencePipeline = + Objects.requireNonNull(resiliencePipeline, "reactive resilience pipeline"); this.admissionLimiter = Objects.requireNonNull(admissionLimiter, "admission limiter"); this.retryBudget = Objects.requireNonNull(retryBudget, "retry budget"); this.backoffFactory = Objects.requireNonNull(backoffFactory, "backoff factory"); @@ -89,6 +94,10 @@ public final class ReactiveClientRuntime extends ClientRuntime { return bodyLimitPolicy; } + ReactiveAttemptResiliencePipeline resiliencePipeline() { + return resiliencePipeline; + } + public LogicalAdmissionLimiter admissionLimiter() { return admissionLimiter; } diff --git a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/WebClientRuntimeFactory.java b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/WebClientRuntimeFactory.java index 9c2e47f5..323d5790 100644 --- a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/WebClientRuntimeFactory.java +++ b/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/webclient/WebClientRuntimeFactory.java @@ -10,6 +10,7 @@ import dev.caskeleton.adapter.outbound.httpclient.profile.RuntimeGeneration; import dev.caskeleton.adapter.outbound.httpclient.profile.TransportType; import dev.caskeleton.adapter.outbound.httpclient.resilience.BackoffStrategy; import dev.caskeleton.adapter.outbound.httpclient.resilience.ExponentialFullJitterBackoff; +import dev.caskeleton.adapter.outbound.httpclient.resilience.ReactiveAttemptResiliencePipeline; import dev.caskeleton.adapter.outbound.httpclient.resilience.ResilienceRegistry; import dev.caskeleton.adapter.outbound.httpclient.resilience.RetryBudget; import dev.caskeleton.adapter.outbound.httpclient.restclient.BlockingExecutionSupport; @@ -112,6 +113,7 @@ public final class WebClientRuntimeFactory implements ClientRuntimeFactory { webClient, provider.id(), provider.failureClassifier(), + newResiliencePipeline(profile), resilienceRegistry.admission( profile.name(), profile.pool().maxPendingAcquires() + profile.pool().maxTotalConnections()), @@ -120,4 +122,16 @@ public final class WebClientRuntimeFactory implements ClientRuntimeFactory { credentialProvider, support); } + + private ReactiveAttemptResiliencePipeline newResiliencePipeline(ClientProfile profile) { + dev.caskeleton.adapter.outbound.httpclient.resilience.AttemptCircuitBreaker breaker = + resilienceRegistry.circuitBreaker(profile.name()); + return new ReactiveAttemptResiliencePipeline( + breaker, + resilienceRegistry.rateLimiter(profile.name()), + resilienceRegistry.bulkhead(profile.name(), profile.pool().maxTotalConnections()), + () -> HttpFailureMetadata.startup(profile.name()), + dev.caskeleton.adapter.outbound.httpclient.resilience.ResilienceRejectionRecorder + .micrometer(support.meterRegistry(), profile.name(), breaker::state)); + } } diff --git a/src/adapter/outbound/httpclient/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/src/adapter/outbound/httpclient/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports new file mode 100644 index 00000000..7bdfe580 --- /dev/null +++ b/src/adapter/outbound/httpclient/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports @@ -0,0 +1 @@ +dev.caskeleton.adapter.outbound.httpclient.autoconfigure.HttpClientPlatformAutoConfiguration diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientAutoConfigurationTest.java b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientAutoConfigurationTest.java similarity index 88% rename from src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientAutoConfigurationTest.java rename to src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientAutoConfigurationTest.java index 7d9feb50..268227eb 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientAutoConfigurationTest.java +++ b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientAutoConfigurationTest.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; import static org.assertj.core.api.Assertions.assertThat; @@ -63,6 +63,7 @@ class HttpClientAutoConfigurationTest { void bindsADynamicTargetPolicyWithoutAnyInheritedCredential() { runner .withPropertyValues(paymentClient()) + .withPropertyValues(dynamicWebhookClient()) .withPropertyValues( "app.httpclient.dynamic-targets[0].name=webhook", "app.httpclient.dynamic-targets[0].allowed-schemes[0]=https", @@ -104,6 +105,20 @@ class HttpClientAutoConfigurationTest { }); } + private static String[] dynamicWebhookClient() { + return new String[] { + "app.httpclient.clients[1].name=webhook", + "app.httpclient.clients[1].mode=DYNAMIC", + "app.httpclient.clients[1].base-url=https://webhook.invalid", + "app.httpclient.clients[1].allowed-hosts[0]=webhook.invalid", + "app.httpclient.clients[1].allowed-ports[0]=443", + "app.httpclient.clients[1].api=REST_CLIENT", + "app.httpclient.clients[1].transport=APACHE", + "app.httpclient.clients[1].request.max-body-bytes=1048576", + "app.httpclient.clients[1].tls.profile-id=webhook" + }; + } + private static String[] paymentClient() { return new String[] { "app.httpclient.clients[0].name=payment", diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientPlatformActivationTest.java b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientPlatformActivationTest.java similarity index 79% rename from src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientPlatformActivationTest.java rename to src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientPlatformActivationTest.java index 67910f33..6336d847 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientPlatformActivationTest.java +++ b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientPlatformActivationTest.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; import static org.assertj.core.api.Assertions.assertThat; @@ -189,9 +189,10 @@ class HttpClientPlatformActivationTest { } @Test - @DisplayName("a dynamic target policy is registered under the name it carries") + @DisplayName("a dynamic target policy is registered only with its matching dynamic REST profile") void aDynamicTargetPolicyIsRegisteredUnderItsOwnName() { enabled() + .withPropertyValues(dynamicWebhookClient()) .withPropertyValues( "app.httpclient.dynamic-targets[0].name=webhook", "app.httpclient.dynamic-targets[0].allowed-schemes[0]=https", @@ -212,12 +213,77 @@ class HttpClientPlatformActivationTest { }); } + @Test + @DisplayName("a dynamic target without a same-named runtime profile fails startup") + void aDynamicTargetWithoutMatchingProfileFailsStartup() { + enabled() + .withPropertyValues( + "app.httpclient.dynamic-targets[0].name=webhook", + "app.httpclient.dynamic-targets[0].allowed-schemes[0]=https", + "app.httpclient.dynamic-targets[0].allowed-ports[0]=443") + .run( + context -> + assertThat(context) + .hasFailed() + .getFailure() + .hasStackTraceContaining("DYNAMIC_TARGET_PROFILE_MISSING policy=webhook")); + } + + @Test + @DisplayName("a dynamic target cannot bind to a reactive runtime") + void aDynamicTargetRejectsWebClientProfile() { + enabled() + .withPropertyValues(dynamicWebhookClient()) + .withPropertyValues( + "app.httpclient.clients[1].api=WEB_CLIENT", + "app.httpclient.clients[1].transport=REACTOR_NETTY", + "app.httpclient.dynamic-targets[0].name=webhook", + "app.httpclient.dynamic-targets[0].allowed-schemes[0]=https", + "app.httpclient.dynamic-targets[0].allowed-ports[0]=443") + .run( + context -> + assertThat(context) + .hasFailed() + .getFailure() + .hasStackTraceContaining( + "DYNAMIC_TARGET_PROFILE_API_UNSUPPORTED policy=webhook")); + } + + @Test + @DisplayName("a secret-bearing profile requires the application secret source at startup") + void aSecretBearingProfileWithoutSecretSourceFailsStartup() { + enabled() + .withPropertyValues( + "app.httpclient.clients[0].authentication.type=STATIC_BEARER", + "app.httpclient.clients[0].authentication.secret-reference=secret://env/PAYMENT_TOKEN") + .run( + context -> + assertThat(context) + .hasFailed() + .getFailure() + .hasStackTraceContaining("SECRET_SOURCE_REQUIRED profile=payment")); + } + private ApplicationContextRunner enabled() { return runner .withPropertyValues("app.httpclient.enabled=true") .withPropertyValues(validPaymentClient()); } + private static String[] dynamicWebhookClient() { + return new String[] { + "app.httpclient.clients[1].name=webhook", + "app.httpclient.clients[1].mode=DYNAMIC", + "app.httpclient.clients[1].base-url=https://webhook.invalid", + "app.httpclient.clients[1].allowed-hosts[0]=webhook.invalid", + "app.httpclient.clients[1].allowed-ports[0]=443", + "app.httpclient.clients[1].api=REST_CLIENT", + "app.httpclient.clients[1].transport=APACHE", + "app.httpclient.clients[1].request.max-body-bytes=1048576", + "app.httpclient.clients[1].tls.profile-id=webhook" + }; + } + private static String[] validPaymentClient() { return new String[] { "app.httpclient.clients[0].name=payment", diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientPlatformEnvManifestTest.java b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientPlatformEnvManifestTest.java similarity index 97% rename from src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientPlatformEnvManifestTest.java rename to src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientPlatformEnvManifestTest.java index 332ea762..c69b2cf2 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientPlatformEnvManifestTest.java +++ b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientPlatformEnvManifestTest.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.assertThatThrownBy; @@ -181,11 +181,11 @@ class HttpClientPlatformEnvManifestTest { return entries; } - /** The module's working directory is {@code src/app-bootstrap} under Gradle. */ + /** The test locates the repository root rather than relying on a module working directory. */ private static Path repositoryRoot() { Path candidate = Path.of(System.getProperty("user.dir")).toAbsolutePath(); List tried = new ArrayList<>(); - for (int depth = 0; depth < 4 && candidate != null; depth++) { + for (int depth = 0; depth < 8 && candidate != null; depth++) { tried.add(candidate); if (Files.exists(candidate.resolve("docs/registries/env-keys.yaml"))) { return candidate; diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientPlatformSettingsTest.java b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientPlatformSettingsTest.java similarity index 98% rename from src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientPlatformSettingsTest.java rename to src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientPlatformSettingsTest.java index 6318bc1a..2a811112 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/HttpClientPlatformSettingsTest.java +++ b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/HttpClientPlatformSettingsTest.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.assertThatThrownBy; diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/ReactiveAuthenticationContractTest.java b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/ReactiveAuthenticationContractTest.java similarity index 81% rename from src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/ReactiveAuthenticationContractTest.java rename to src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/ReactiveAuthenticationContractTest.java index d1fa1ef8..545e4c13 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/ReactiveAuthenticationContractTest.java +++ b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/ReactiveAuthenticationContractTest.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; import static org.assertj.core.api.Assertions.assertThat; @@ -6,8 +6,11 @@ import dev.caskeleton.adapter.outbound.httpclient.auth.CredentialType; import dev.caskeleton.adapter.outbound.httpclient.auth.ReactiveCredentialProviderRegistry; import dev.caskeleton.adapter.outbound.httpclient.auth.ReactiveRequestCredentialProvider; import dev.caskeleton.adapter.outbound.httpclient.dynamic.DynamicCredentialBinding; +import dev.caskeleton.application.outbound.SecretSourcePort; import java.time.Clock; import java.util.List; +import java.util.Optional; +import java.util.function.Function; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; import org.springframework.boot.autoconfigure.AutoConfigurations; @@ -54,13 +57,38 @@ class ReactiveAuthenticationContractTest { } @Test - @DisplayName("a reactive profile declaring a supported mechanism starts") + @DisplayName("a reactive profile resolves supported credentials through SecretSourcePort") void aReactiveProfileWithASupportedMechanismStarts() { + runner + .withBean( + SecretSourcePort.class, + () -> key -> "EVENTS_TOKEN".equals(key) ? Optional.of("token-123") : Optional.empty()) + .withPropertyValues(reactiveClient("STATIC_BEARER")) + .withPropertyValues( + "app.httpclient.clients[0].authentication.secret-reference=secret://env/EVENTS_TOKEN") + .run( + context -> { + assertThat(context).hasNotFailed(); + @SuppressWarnings("unchecked") + Function resolver = + (Function) context.getBean("httpClientSecretResolver"); + assertThat(resolver.apply("secret://env/EVENTS_TOKEN")).isEqualTo("token-123"); + }); + } + + @Test + @DisplayName("a supported secret mechanism without SecretSourcePort fails at startup") + void supportedSecretMechanismWithoutSecretSourceFailsAtStartup() { runner .withPropertyValues(reactiveClient("STATIC_BEARER")) .withPropertyValues( "app.httpclient.clients[0].authentication.secret-reference=secret://env/EVENTS_TOKEN") - .run(context -> assertThat(context).hasNotFailed()); + .run( + context -> + assertThat(context) + .hasFailed() + .getFailure() + .hasStackTraceContaining("SECRET_SOURCE_REQUIRED profile=events")); } /** diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/UnsafeStartupConfigurationTest.java b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/UnsafeStartupConfigurationTest.java similarity index 98% rename from src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/UnsafeStartupConfigurationTest.java rename to src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/UnsafeStartupConfigurationTest.java index 84b17a7d..5a084636 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/httpclient/UnsafeStartupConfigurationTest.java +++ b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/autoconfigure/UnsafeStartupConfigurationTest.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.httpclient; +package dev.caskeleton.adapter.outbound.httpclient.autoconfigure; import static org.assertj.core.api.Assertions.assertThat; diff --git a/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/contract/FailureInjectionContractTest.java b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/contract/FailureInjectionContractTest.java deleted file mode 100644 index bd864272..00000000 --- a/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/contract/FailureInjectionContractTest.java +++ /dev/null @@ -1,86 +0,0 @@ -package dev.caskeleton.adapter.outbound.httpclient.contract; - -import static org.assertj.core.api.Assertions.assertThat; - -import dev.caskeleton.adapter.outbound.httpclient.api.OperationName; -import dev.caskeleton.adapter.outbound.httpclient.api.error.HttpClientException; -import dev.caskeleton.adapter.outbound.httpclient.api.operation.ExecutionEvidence; -import dev.caskeleton.adapter.outbound.httpclient.api.operation.HttpOperation; -import dev.caskeleton.adapter.outbound.httpclient.api.result.ResponseType; -import dev.caskeleton.adapter.outbound.httpclient.testkit.ClientProfiles; -import dev.caskeleton.adapter.outbound.httpclient.testkit.TestGateways; -import dev.caskeleton.adapter.outbound.httpclient.testkit.ToxiproxyFixture; -import dev.caskeleton.adapter.outbound.httpclient.testkit.UserResponse; -import eu.rekawek.toxiproxy.Proxy; -import java.net.URI; -import java.time.Duration; -import java.util.Map; -import org.junit.jupiter.api.Tag; -import org.junit.jupiter.api.Test; -import org.testcontainers.containers.GenericContainer; -import org.testcontainers.containers.Network; -import org.testcontainers.utility.DockerImageName; - -/** - * TCP-level faults against a real upstream (design §28.3). - * - *

The lane is fail-closed: selecting it without Docker throws rather than skipping, because a - * fault suite that never injected a fault proves nothing. - */ -@Tag("httpclient-fault") -class FailureInjectionContractTest { - - private static final DockerImageName UPSTREAM_IMAGE = - // Overridable so a deployment can pin a digest. Hard-coding `:latest` meant the fault suite's - // upstream could change between two runs of the same commit, so a red build might be - // someone else's image push rather than this repository's regression — the one thing a - // fault-injection lane must never be ambiguous about. The default stays `:latest` because no - // digest can be verified from here; `-Dhttpclient.fault.httpbin.image=@sha256:` - // makes the run reproducible, and docs/httpclient/operations.md records that CI should set - // it. - DockerImageName.parse( - System.getProperty("httpclient.fault.httpbin.image", "kennethreitz/httpbin:latest")) - .asCompatibleSubstituteFor("kennethreitz/httpbin"); - - @Test - @SuppressWarnings("resource") - void aResetPeerProducesStableEvidenceRatherThanAGenericFailure() throws Exception { - ToxiproxyFixture.requireAvailable(); - try (Network network = Network.newNetwork(); - GenericContainer upstream = - new GenericContainer<>(UPSTREAM_IMAGE) - .withNetwork(network) - .withNetworkAliases("upstream") - .withExposedPorts(80)) { - upstream.start(); - try (ToxiproxyFixture toxiproxy = ToxiproxyFixture.start(network)) { - Proxy proxy = toxiproxy.proxyTo("upstream", "upstream", 80); - toxiproxy.resetPeer(proxy, Duration.ofMillis(50)); - - URI baseUrl = - URI.create("http://" + toxiproxy.proxiedHost() + ":" + toxiproxy.proxiedPort() + "/"); - try (TestGateways.Harness harness = - TestGateways.forProfile(ClientProfiles.builder("faulty").baseUrl(baseUrl).build())) { - HttpClientException failure = - org.assertj.core.api.Assertions.catchThrowableOfType( - HttpClientException.class, - () -> - harness - .gateway() - .exchange( - harness.profile().name(), - HttpOperation.get(new OperationName("get-user"), "/get", Map.of()), - ResponseType.of(UserResponse.class))); - - assertThat(failure).isNotNull(); - assertThat(failure.metadata().evidence()) - .isIn( - ExecutionEvidence.NOT_SENT, - ExecutionEvidence.SENT_NO_RESPONSE, - ExecutionEvidence.PARTIAL_RESPONSE); - assertThat(failure.getMessage()).doesNotContain("http://"); - } - } - } - } -} diff --git a/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/contract/NegotiatedProtocolContractTest.java b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/contract/NegotiatedProtocolContractTest.java index bf64d702..6aeaf374 100644 --- a/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/contract/NegotiatedProtocolContractTest.java +++ b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/contract/NegotiatedProtocolContractTest.java @@ -111,8 +111,7 @@ class NegotiatedProtocolContractTest { try { String version = new ReactorHttpClientFactory() - .create( - profile, pool, Optional.of(TlsMaterials.trustOnly(fixture)), Optional.empty()) + .create(profile, pool, Optional.of(TlsMaterials.trustOnly(fixture))) .get() .uri(server.uri("/p").toString()) .response((response, bytes) -> Mono.just(response.version().text())) diff --git a/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/dynamic/DnsPinningSocketPathTest.java b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/dynamic/DnsPinningSocketPathTest.java new file mode 100644 index 00000000..bbeadf3d --- /dev/null +++ b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/dynamic/DnsPinningSocketPathTest.java @@ -0,0 +1,53 @@ +package dev.caskeleton.adapter.outbound.httpclient.dynamic; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.adapter.outbound.httpclient.api.OperationName; +import dev.caskeleton.adapter.outbound.httpclient.api.operation.HttpOperation; +import dev.caskeleton.adapter.outbound.httpclient.api.result.ResponseType; +import dev.caskeleton.adapter.outbound.httpclient.profile.TransportType; +import dev.caskeleton.adapter.outbound.httpclient.testkit.ClientProfiles; +import dev.caskeleton.adapter.outbound.httpclient.testkit.MockHttpServer; +import dev.caskeleton.adapter.outbound.httpclient.testkit.TestGateways; +import dev.caskeleton.adapter.outbound.httpclient.testkit.UserResponse; +import java.net.InetAddress; +import java.net.URI; +import java.time.Duration; +import java.util.List; +import java.util.Map; +import org.junit.jupiter.api.Test; + +class DnsPinningSocketPathTest { + + @Test + void apacheSocketUsesTheCallScopedApprovedAddressInsteadOfResolvingTheHostAgain() + throws Exception { + try (MockHttpServer server = MockHttpServer.start()) { + URI baseUrl = URI.create("http://pin.invalid:" + server.port() + "/"); + var profile = + ClientProfiles.builder("pinned-apache") + .baseUrl(baseUrl) + .transport(TransportType.APACHE) + .build(); + + try (TestGateways.Harness harness = + TestGateways.forProfileWithResolver(profile, CallScopedDnsPin::addressesFor); + CallScopedDnsPin ignored = + CallScopedDnsPin.open( + "pin.invalid", List.of(InetAddress.getAllByName("127.0.0.1")[0]))) { + server.enqueueJson(200, "{\"id\":11,\"name\":\"pinned\"}"); + + var result = + harness + .gateway() + .exchange( + profile.name(), + HttpOperation.get(new OperationName("get-user"), "/users/11", Map.of()), + ResponseType.of(UserResponse.class)); + + assertThat(result.body().id()).isEqualTo(11); + assertThat(server.takeRequest(Duration.ofSeconds(2)).path()).isEqualTo("/users/11"); + } + } + } +} diff --git a/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/dynamic/DynamicTargetSecurityTest.java b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/dynamic/DynamicTargetSecurityTest.java index e795be15..e554170a 100644 --- a/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/dynamic/DynamicTargetSecurityTest.java +++ b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/dynamic/DynamicTargetSecurityTest.java @@ -41,15 +41,13 @@ class DynamicTargetSecurityTest { DynamicTargets.resolvesTo("mixed.test", "93.184.216.34", "10.0.0.4"); assertThatThrownBy(() -> resolver.resolve("mixed.test")) .isInstanceOf(HttpTargetRejectedException.class); - assertThat(resolver.approvedAddresses("mixed.test")).isEmpty(); } @Test - void acceptsAFullyPublicAnswerAndRetainsItForPinning() { + void acceptsAFullyPublicAnswerForTheCurrentPin() { ValidatedDnsResolver resolver = DynamicTargets.resolvesTo("public.test", "93.184.216.34", "8.8.8.8"); assertThat(resolver.resolve("public.test")).hasSize(2); - assertThat(resolver.approvedAddresses("public.test")).hasSize(2); } @Test @@ -122,7 +120,6 @@ class DynamicTargetSecurityTest { DynamicTargets.resolvesTo(java.util.Map.of("rebind.test", List.of("10.0.0.9"))); assertThatThrownBy(() -> resolver.resolve("rebind.test")) .isInstanceOf(HttpTargetRejectedException.class); - assertThat(resolver.approvedAddresses("rebind.test")).isEmpty(); } @Test diff --git a/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/resilience/ResilienceRegistryDefaultsTest.java b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/resilience/ResilienceRegistryDefaultsTest.java new file mode 100644 index 00000000..cbdc492f --- /dev/null +++ b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/resilience/ResilienceRegistryDefaultsTest.java @@ -0,0 +1,15 @@ +package dev.caskeleton.adapter.outbound.httpclient.resilience; + +import static org.assertj.core.api.Assertions.assertThat; + +import java.time.Duration; +import org.junit.jupiter.api.Test; + +class ResilienceRegistryDefaultsTest { + + @Test + void defaultRateLimiterNeverWaitsOutsideTheHttpCallDeadline() { + assertThat(ResilienceRegistry.defaultRateLimiterConfig().getTimeoutDuration()) + .isEqualTo(Duration.ZERO); + } +} diff --git a/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/restclient/DefaultGenericHttpGatewayTest.java b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/restclient/DefaultGenericHttpGatewayTest.java index a88e2e1c..3518a243 100644 --- a/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/restclient/DefaultGenericHttpGatewayTest.java +++ b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/restclient/DefaultGenericHttpGatewayTest.java @@ -19,6 +19,7 @@ import dev.caskeleton.adapter.outbound.httpclient.testkit.UserResponse; import java.time.Duration; import java.util.Map; import org.junit.jupiter.api.Test; +import org.slf4j.MDC; class DefaultGenericHttpGatewayTest { @@ -152,6 +153,73 @@ class DefaultGenericHttpGatewayTest { .timer() .count()) .isEqualTo(1L); + assertThat( + harness + .meterRegistry() + .get(HttpClientObservationNames.ATTEMPT_COUNTER) + .counter() + .count()) + .isEqualTo(1.0); + assertThat( + harness.meterRegistry().get(HttpClientObservationNames.ATTEMPT_TIMER).timer().count()) + .isEqualTo(1L); + assertThat( + harness + .meterRegistry() + .get(HttpClientObservationNames.REQUEST_BYTES) + .summary() + .count()) + .isEqualTo(1L); + assertThat( + harness + .meterRegistry() + .get(HttpClientObservationNames.RESPONSE_BYTES) + .summary() + .count()) + .isEqualTo(1L); + } + } + + @Test + void propagatesPlatformTraceAndCorrelationHeadersOnTheWire() throws Exception { + MDC.put("trace_id", "4bf92f3577b34da6a3ce929d0e0e4736"); + MDC.put("span_id", "00f067aa0ba902b7"); + MDC.put("correlation_id", "corr-123"); + try (MockHttpServer server = MockHttpServer.start(); + TestGateways.Harness harness = TestGateways.apache(server.uri("/"))) { + server.enqueueJson(200, "{\"id\":1,\"name\":\"a\"}"); + + harness + .gateway() + .exchange( + harness.profile().name(), + HttpOperation.get(new OperationName("get-user"), "/users/1", Map.of()), + ResponseType.of(UserResponse.class)); + + var request = server.takeRequest(Duration.ofSeconds(2)); + assertThat(request.firstHeader("traceparent")) + .contains("00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-00"); + assertThat(request.firstHeader("X-Correlation-Id")).contains("corr-123"); + } finally { + MDC.clear(); + } + } + + @Test + void callerCannotOverridePlatformCorrelationHeaders() throws Exception { + try (MockHttpServer server = MockHttpServer.start(); + TestGateways.Harness harness = TestGateways.apache(server.uri("/"))) { + HttpOperation operation = + HttpOperation.get(new OperationName("probe"), "/probe", Map.of()) + .withHeaders(Map.of("X-Correlation-Id", java.util.List.of("caller-value"))); + + assertThatThrownBy( + () -> + harness + .gateway() + .exchange(harness.profile().name(), operation, ResponseType.of(String.class))) + .isInstanceOf(HttpTargetRejectedException.class); + assertThat(server.requestCount()).isZero(); } } diff --git a/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/testkit/ForwardProxyContractTest.java b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/testkit/ForwardProxyContractTest.java index ec869516..c972b8b4 100644 --- a/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/testkit/ForwardProxyContractTest.java +++ b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/testkit/ForwardProxyContractTest.java @@ -2,17 +2,19 @@ package dev.caskeleton.adapter.outbound.httpclient.testkit; import static org.assertj.core.api.Assertions.assertThat; -import dev.caskeleton.adapter.outbound.httpclient.api.ClientProfileName; import dev.caskeleton.adapter.outbound.httpclient.api.OperationName; -import dev.caskeleton.adapter.outbound.httpclient.auth.CredentialRequest; -import dev.caskeleton.adapter.outbound.httpclient.auth.CredentialType; -import dev.caskeleton.adapter.outbound.httpclient.auth.ProxyCredentialProvider; -import dev.caskeleton.adapter.outbound.httpclient.auth.RequestCredentials; -import dev.caskeleton.adapter.outbound.httpclient.profile.AuthenticationSettings; -import java.net.URI; +import dev.caskeleton.adapter.outbound.httpclient.api.operation.HttpOperation; +import dev.caskeleton.adapter.outbound.httpclient.api.result.ResponseType; +import dev.caskeleton.adapter.outbound.httpclient.profile.ClientApiType; +import dev.caskeleton.adapter.outbound.httpclient.profile.ProxySettings; +import dev.caskeleton.adapter.outbound.httpclient.profile.ProxyType; +import dev.caskeleton.adapter.outbound.httpclient.profile.TransportType; import java.nio.charset.StandardCharsets; +import java.time.Duration; +import java.util.Map; import java.util.Optional; import org.junit.jupiter.api.Test; +import reactor.test.StepVerifier; class ForwardProxyContractTest { @@ -33,23 +35,41 @@ class ForwardProxyContractTest { } @Test - void proxyCredentialsUseTheirOwnHeaderAndNeverTheTargetAuthorization() { - ProxyCredentialProvider provider = - new ProxyCredentialProvider("secret://proxy", reference -> "user:secret"); - RequestCredentials credentials = - provider.resolve( - new CredentialRequest( - new ClientProfileName("payment"), - new OperationName("create-payment"), - AuthenticationSettings.none(), - URI.create("https://payment.example.com/payments"), - Optional.empty(), - Optional.empty(), - false)); + void reactiveGatewayUsesTheConfiguredForwardProxy() throws Exception { + try (MockHttpServer upstream = MockHttpServer.start(); + ProxyFixture proxy = ProxyFixture.openProxy(); + ReactiveTestGateways.Harness harness = + ReactiveTestGateways.forProfile( + ClientProfiles.builder("proxied") + .baseUrl(upstream.uri("/")) + .transport(TransportType.REACTOR_NETTY) + .api(ClientApiType.WEB_CLIENT) + .proxy( + new ProxySettings( + true, + proxy.host(), + proxy.port(), + ProxyType.HTTP, + Optional.empty(), + Duration.ofSeconds(1), + false)) + .build())) { + upstream.enqueueJson(200, "{\"id\":7,\"name\":\"proxied\"}"); - assertThat(provider.type()).isEqualTo(CredentialType.PROXY); - assertThat(credentials.headers()).containsOnlyKeys("Proxy-Authorization"); - assertThat(credentials.toString()).doesNotContain("secret"); + StepVerifier.create( + harness + .gateway() + .exchange( + harness.profile().name(), + HttpOperation.get(new OperationName("get-user"), "/users/7", Map.of()), + ResponseType.of(UserResponse.class))) + .assertNext(result -> assertThat(result.body().id()).isEqualTo(7)) + .verifyComplete(); + + assertThat(proxy.requestLines()) + .anyMatch(line -> line.startsWith("CONNECT localhost:" + upstream.port())); + assertThat(proxy.proxyAuthorizationValues()).isEmpty(); + } } @Test diff --git a/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/webclient/BlockHoundEventLoopTest.java b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/webclient/BlockHoundEventLoopTest.java index d4241ae0..8a469af1 100644 --- a/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/webclient/BlockHoundEventLoopTest.java +++ b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/webclient/BlockHoundEventLoopTest.java @@ -5,6 +5,7 @@ import static org.assertj.core.api.Assertions.assertThat; import dev.caskeleton.adapter.outbound.httpclient.api.OperationName; import dev.caskeleton.adapter.outbound.httpclient.api.operation.HttpOperation; import dev.caskeleton.adapter.outbound.httpclient.api.result.ResponseType; +import dev.caskeleton.adapter.outbound.httpclient.testkit.EventPayload; import dev.caskeleton.adapter.outbound.httpclient.testkit.MockHttpServer; import dev.caskeleton.adapter.outbound.httpclient.testkit.ReactiveTestGateways; import dev.caskeleton.adapter.outbound.httpclient.testkit.UserResponse; @@ -75,6 +76,35 @@ class BlockHoundEventLoopTest { } } + @Test + void theReactiveSseSetupDoesNotBlockANonBlockingScheduler() throws Exception { + try (MockHttpServer server = MockHttpServer.start(); + ReactiveTestGateways.Harness harness = ReactiveTestGateways.reactor(server.uri("/"))) { + server.enqueueSse( + "id: event-1\ndata: {\"id\":\"event-1\",\"value\":\"first\"}\n\n", + java.time.Duration.ZERO); + + ReactiveSseGateway gateway = new DefaultReactiveSseGateway(harness.registry()); + + StepVerifier.create( + Mono.defer( + () -> + gateway + .connect( + harness.profile().name(), + SseOperation.of( + new OperationName("stream-events"), + "/events", + java.time.Duration.ofSeconds(5), + java.time.Duration.ofSeconds(5)), + ResponseType.of(EventPayload.class)) + .next()) + .subscribeOn(Schedulers.parallel())) + .assertNext(event -> assertThat(event.id()).isEqualTo("event-1")) + .verifyComplete(); + } + } + @Test void theReactiveRetryBackoffDoesNotBlockAnEventLoop() throws Exception { try (MockHttpServer server = MockHttpServer.start(); diff --git a/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/webclient/DefaultReactiveHttpGatewayTest.java b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/webclient/DefaultReactiveHttpGatewayTest.java index fa0419d5..3d3c4b4e 100644 --- a/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/webclient/DefaultReactiveHttpGatewayTest.java +++ b/src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/webclient/DefaultReactiveHttpGatewayTest.java @@ -3,18 +3,25 @@ package dev.caskeleton.adapter.outbound.httpclient.webclient; import static org.assertj.core.api.Assertions.assertThat; import dev.caskeleton.adapter.outbound.httpclient.api.OperationName; +import dev.caskeleton.adapter.outbound.httpclient.api.error.HttpDeadlineExceededException; import dev.caskeleton.adapter.outbound.httpclient.api.error.HttpRemoteErrorException; import dev.caskeleton.adapter.outbound.httpclient.api.error.HttpTargetRejectedException; import dev.caskeleton.adapter.outbound.httpclient.api.operation.HttpOperation; import dev.caskeleton.adapter.outbound.httpclient.api.result.HttpCallResult; import dev.caskeleton.adapter.outbound.httpclient.api.result.ResponseType; +import dev.caskeleton.adapter.outbound.httpclient.profile.ClientApiType; +import dev.caskeleton.adapter.outbound.httpclient.profile.TimeoutSettings; +import dev.caskeleton.adapter.outbound.httpclient.profile.TransportType; +import dev.caskeleton.adapter.outbound.httpclient.testkit.ClientProfiles; import dev.caskeleton.adapter.outbound.httpclient.testkit.MockHttpServer; import dev.caskeleton.adapter.outbound.httpclient.testkit.NettyLeakDetectionExtension; import dev.caskeleton.adapter.outbound.httpclient.testkit.ReactiveTestGateways; import dev.caskeleton.adapter.outbound.httpclient.testkit.UserResponse; +import java.time.Duration; import java.util.Map; import org.junit.jupiter.api.Test; import org.junit.jupiter.api.extension.ExtendWith; +import org.slf4j.MDC; import reactor.core.publisher.Mono; import reactor.test.StepVerifier; @@ -75,6 +82,72 @@ class DefaultReactiveHttpGatewayTest { } } + @Test + void totalCallBudgetCutsOffAReactiveResponseThatKeepsTheTransportAlive() throws Exception { + try (MockHttpServer server = MockHttpServer.start()) { + server.enqueueDelayedBody(200, "{\"id\":9,\"name\":\"late\"}", Duration.ofMillis(500)); + TimeoutSettings defaults = ClientProfiles.timeouts(); + var profile = + ClientProfiles.builder("events") + .baseUrl(server.uri("/")) + .api(ClientApiType.WEB_CLIENT) + .transport(TransportType.REACTOR_NETTY) + .timeout( + new TimeoutSettings( + defaults.dns(), + defaults.connect(), + defaults.tlsHandshake(), + defaults.proxyConnect(), + defaults.requestWriteIdle(), + defaults.responseHeader(), + defaults.readIdle(), + Duration.ofMillis(100), + defaults.streamingIdle())) + .build(); + + try (ReactiveTestGateways.Harness harness = ReactiveTestGateways.forProfile(profile)) { + StepVerifier.create( + harness + .gateway() + .exchange( + harness.profile().name(), + HttpOperation.get(new OperationName("get-user"), "/users/9", Map.of()), + ResponseType.of(UserResponse.class))) + .expectError(HttpDeadlineExceededException.class) + .verify(Duration.ofSeconds(2)); + } + assertThat(server.requestCount()).isEqualTo(1); + } + } + + @Test + void propagatesPlatformTraceAndCorrelationHeadersOnTheReactiveWire() throws Exception { + MDC.put("trace_id", "4bf92f3577b34da6a3ce929d0e0e4736"); + MDC.put("span_id", "00f067aa0ba902b7"); + MDC.put("correlation_id", "corr-reactive"); + try (MockHttpServer server = MockHttpServer.start(); + ReactiveTestGateways.Harness harness = ReactiveTestGateways.reactor(server.uri("/"))) { + server.enqueueJson(200, "{\"id\":9,\"name\":\"nine\"}"); + + StepVerifier.create( + harness + .gateway() + .exchange( + harness.profile().name(), + HttpOperation.get(new OperationName("get-user"), "/users/9", Map.of()), + ResponseType.of(UserResponse.class))) + .expectNextCount(1) + .verifyComplete(); + + var request = server.takeRequest(Duration.ofSeconds(2)); + assertThat(request.firstHeader("traceparent")) + .contains("00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-00"); + assertThat(request.firstHeader("X-Correlation-Id")).contains("corr-reactive"); + } finally { + MDC.clear(); + } + } + @Test void releasesTheRuntimeLeaseAfterCompletion() throws Exception { try (MockHttpServer server = MockHttpServer.start(); diff --git a/src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/SensitiveValueRedactor.java b/src/adapter/outbound/httpclient/src/testFixtures/java/dev/caskeleton/adapter/outbound/httpclient/observation/SensitiveValueRedactor.java similarity index 100% rename from src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/observation/SensitiveValueRedactor.java rename to src/adapter/outbound/httpclient/src/testFixtures/java/dev/caskeleton/adapter/outbound/httpclient/observation/SensitiveValueRedactor.java diff --git a/src/adapter/outbound/httpclient/src/testFixtures/java/dev/caskeleton/adapter/outbound/httpclient/testkit/ProxyFixture.java b/src/adapter/outbound/httpclient/src/testFixtures/java/dev/caskeleton/adapter/outbound/httpclient/testkit/ProxyFixture.java index 1ce8d009..904dfc00 100644 --- a/src/adapter/outbound/httpclient/src/testFixtures/java/dev/caskeleton/adapter/outbound/httpclient/testkit/ProxyFixture.java +++ b/src/adapter/outbound/httpclient/src/testFixtures/java/dev/caskeleton/adapter/outbound/httpclient/testkit/ProxyFixture.java @@ -108,8 +108,10 @@ public final class ProxyFixture implements AutoCloseable { } requestLines.add(requestLine); + java.util.List headers = new java.util.ArrayList<>(); String line; while ((line = reader.readLine()) != null && !line.isEmpty()) { + headers.add(line); if (line.regionMatches( true, 0, "Proxy-Authorization:", 0, "Proxy-Authorization:".length())) { proxyAuthorizationValues.add(line.substring(line.indexOf(':') + 1).trim()); @@ -127,6 +129,10 @@ public final class ProxyFixture implements AutoCloseable { tunnel(requestLine, scoped, out); return; } + if (requestLine.contains(" http://")) { + forwardHttp(requestLine, headers, scoped, out); + return; + } out.write(NOT_IMPLEMENTED.getBytes(StandardCharsets.UTF_8)); out.flush(); } catch (IOException ignored) { @@ -134,6 +140,60 @@ public final class ProxyFixture implements AutoCloseable { } } + private void forwardHttp( + String requestLine, List headers, Socket client, OutputStream clientOut) + throws IOException { + String[] parts = requestLine.split(" ", 3); + if (parts.length != 3) { + clientOut.write(NOT_IMPLEMENTED.getBytes(StandardCharsets.UTF_8)); + clientOut.flush(); + return; + } + + java.net.URI target = java.net.URI.create(parts[1]); + if (!"http".equalsIgnoreCase(target.getScheme()) || target.getHost() == null) { + clientOut.write(NOT_IMPLEMENTED.getBytes(StandardCharsets.UTF_8)); + clientOut.flush(); + return; + } + + int targetPort = target.getPort() >= 0 ? target.getPort() : 80; + Socket upstream = new Socket(); + openSockets.add(upstream); + try { + upstream.connect(new InetSocketAddress(target.getHost(), targetPort), 2000); + } catch (IOException unreachable) { + clientOut.write(BAD_GATEWAY.getBytes(StandardCharsets.UTF_8)); + clientOut.flush(); + upstream.close(); + return; + } + + String path = target.getRawPath(); + if (path == null || path.isEmpty()) { + path = "/"; + } + if (target.getRawQuery() != null) { + path += "?" + target.getRawQuery(); + } + + OutputStream upstreamOut = upstream.getOutputStream(); + upstreamOut.write( + (parts[0] + " " + path + " " + parts[2] + CRLF).getBytes(StandardCharsets.UTF_8)); + for (String header : headers) { + if (header.regionMatches(true, 0, "Proxy-Authorization:", 0, "Proxy-Authorization:".length()) + || header.regionMatches(true, 0, "Proxy-Connection:", 0, "Proxy-Connection:".length())) { + continue; + } + upstreamOut.write((header + CRLF).getBytes(StandardCharsets.UTF_8)); + } + upstreamOut.write(CRLF.getBytes(StandardCharsets.UTF_8)); + upstreamOut.flush(); + + workers.execute(() -> pipe(client, upstream)); + pipe(upstream, client); + } + private void tunnel(String requestLine, Socket client, OutputStream clientOut) throws IOException { String authority = requestLine.split(" ", 3)[1]; diff --git a/src/adapter/outbound/httpclient/src/testFixtures/java/dev/caskeleton/adapter/outbound/httpclient/testkit/ReactiveTestGateways.java b/src/adapter/outbound/httpclient/src/testFixtures/java/dev/caskeleton/adapter/outbound/httpclient/testkit/ReactiveTestGateways.java index 84248a1d..a8cbf420 100644 --- a/src/adapter/outbound/httpclient/src/testFixtures/java/dev/caskeleton/adapter/outbound/httpclient/testkit/ReactiveTestGateways.java +++ b/src/adapter/outbound/httpclient/src/testFixtures/java/dev/caskeleton/adapter/outbound/httpclient/testkit/ReactiveTestGateways.java @@ -22,6 +22,7 @@ import java.net.URI; import java.time.Clock; import java.util.EnumMap; import java.util.Map; +import java.util.Optional; import java.util.random.RandomGenerator; /** Assembles the reactive stack against a fixture server (design §28.6). */ @@ -55,7 +56,9 @@ public final class ReactiveTestGateways { public static Harness forProfile(ClientProfile profile) { MeterRegistry meterRegistry = new SimpleMeterRegistry(); Map providers = new EnumMap<>(TransportType.class); - providers.put(TransportType.REACTOR_NETTY, new ReactorNettyTransportProvider()); + providers.put( + TransportType.REACTOR_NETTY, + new ReactorNettyTransportProvider(Optional.empty(), ignored -> Optional.empty())); ReactiveRequestCredentialProvider credentials = ReactiveRequestCredentialProvider.fromNonBlocking(new NoAuthCredentialProvider()); diff --git a/src/adapter/outbound/httpclient/src/testFixtures/java/dev/caskeleton/adapter/outbound/httpclient/testkit/TestGateways.java b/src/adapter/outbound/httpclient/src/testFixtures/java/dev/caskeleton/adapter/outbound/httpclient/testkit/TestGateways.java index 6df22292..9373d4b1 100644 --- a/src/adapter/outbound/httpclient/src/testFixtures/java/dev/caskeleton/adapter/outbound/httpclient/testkit/TestGateways.java +++ b/src/adapter/outbound/httpclient/src/testFixtures/java/dev/caskeleton/adapter/outbound/httpclient/testkit/TestGateways.java @@ -18,10 +18,14 @@ import dev.caskeleton.adapter.outbound.httpclient.transport.BlockingTransportPro import dev.caskeleton.adapter.outbound.httpclient.transport.TransportLifecycleListener; import io.micrometer.core.instrument.MeterRegistry; import io.micrometer.core.instrument.simple.SimpleMeterRegistry; +import java.net.InetAddress; import java.net.URI; import java.time.Clock; import java.util.EnumMap; +import java.util.List; import java.util.Map; +import java.util.Optional; +import java.util.function.Function; import java.util.random.RandomGenerator; /** @@ -62,9 +66,25 @@ public final class TestGateways { public static Harness forProfile( ClientProfile profile, CredentialProviderRegistry credentialProviders) { + return forProfile(profile, credentialProviders, ignored -> Optional.empty()); + } + + public static Harness forProfileWithResolver( + ClientProfile profile, Function> resolver) { + return forProfile( + profile, CredentialProviderRegistry.withNoAuth(), ignored -> Optional.of(resolver)); + } + + private static Harness forProfile( + ClientProfile profile, + CredentialProviderRegistry credentialProviders, + Function>>> resolverFactory) { MeterRegistry meterRegistry = new SimpleMeterRegistry(); Map providers = new EnumMap<>(TransportType.class); - providers.put(TransportType.APACHE, new ApacheBlockingTransportProvider()); + providers.put( + TransportType.APACHE, + new ApacheBlockingTransportProvider( + Optional.empty(), ignored -> Optional.empty(), resolverFactory)); providers.put(TransportType.JDK, new JdkBlockingTransportProvider()); RestClientRuntimeFactory factory = diff --git a/src/adapter/outbound/identifier/build.gradle b/src/adapter/outbound/identifier/build.gradle index 42d0ef5f..c5bf4c14 100644 --- a/src/adapter/outbound/identifier/build.gradle +++ b/src/adapter/outbound/identifier/build.gradle @@ -4,4 +4,5 @@ plugins { dependencies { implementation project(':application-core') + implementation project(':application-fileserver') } diff --git a/src/adapter/outbound/messaging-kafka/build.gradle b/src/adapter/outbound/messaging-kafka/build.gradle new file mode 100644 index 00000000..962bae82 --- /dev/null +++ b/src/adapter/outbound/messaging-kafka/build.gradle @@ -0,0 +1,11 @@ +plugins { + id 'ca.spring-library' + id 'ca.spring-config' +} + +dependencies { + implementation project(':adapter:outbound:messaging') + implementation 'org.apache.kafka:kafka-clients' + + implementation 'org.springframework.boot:spring-boot-autoconfigure' +} diff --git a/src/adapter/outbound/messaging-kafka/gradle.lockfile b/src/adapter/outbound/messaging-kafka/gradle.lockfile new file mode 100644 index 00000000..30e34afd --- /dev/null +++ b/src/adapter/outbound/messaging-kafka/gradle.lockfile @@ -0,0 +1,157 @@ +# This is a Gradle generated file for dependency locking. +# Manual edits can break the build and are not advised. +# This file is expected to be part of source control. +at.yawk.lz4:lz4-java:1.10.1=runtimeClasspath,testRuntimeClasspath +biz.aQute.bnd:biz.aQute.bnd.annotation:7.1.0=testCompileClasspath +ch.qos.logback:logback-classic:1.5.38=runtimeClasspath,testCompileClasspath,testRuntimeClasspath +ch.qos.logback:logback-core:1.5.38=runtimeClasspath,testCompileClasspath,testRuntimeClasspath +com.ethlo.time:itu:1.14.0=runtimeClasspath,testRuntimeClasspath +com.fasterxml.jackson.core:jackson-annotations:2.21=runtimeClasspath,testCompileClasspath,testRuntimeClasspath +com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,testAnnotationProcessor +com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,testAnnotationProcessor +com.github.luben:zstd-jni:1.5.6-10=runtimeClasspath,testRuntimeClasspath +com.github.spotbugs:spotbugs-annotations:4.10.2=spotbugs +com.github.spotbugs:spotbugs:4.10.2=spotbugs +com.github.stephenc.jcip:jcip-annotations:1.0-1=spotbugs +com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,testAnnotationProcessor +com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,testAnnotationProcessor +com.google.auto:auto-common:1.2.2=annotationProcessor,testAnnotationProcessor +com.google.code.findbugs:jsr305:3.0.2=checkstyle,spotbugs +com.google.code.gson:gson:2.13.2=spotbugs +com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.38.0=testCompileClasspath +com.google.errorprone:error_prone_annotations:2.41.0=spotbugs +com.google.errorprone:error_prone_annotations:2.47.0=checkstyle +com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,testAnnotationProcessor +com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.guava:guava:33.5.0-jre=annotationProcessor,testAnnotationProcessor +com.google.guava:guava:33.6.0-jre=checkstyle +com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,testAnnotationProcessor +com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins +com.jayway.jsonpath:json-path:2.10.0=testCompileClasspath,testRuntimeClasspath +com.networknt:json-schema-validator:3.0.2=runtimeClasspath,testRuntimeClasspath +com.puppycrawl.tools:checkstyle:13.5.0=checkstyle +com.vaadin.external.google:android-json:0.0.20131108.vaadin1=testCompileClasspath,testRuntimeClasspath +commons-beanutils:commons-beanutils:1.11.0=checkstyle +commons-collections:commons-collections:3.2.2=checkstyle +commons-io:commons-io:2.21.0=spotbugs +commons-logging:commons-logging:1.3.6=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +info.picocli:picocli:4.7.7=checkstyle +io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,testAnnotationProcessor +io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,testAnnotationProcessor +io.micrometer:micrometer-commons:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.micrometer:micrometer-observation:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +jakarta.activation:jakarta.activation-api:2.1.4=testCompileClasspath,testRuntimeClasspath +jakarta.annotation:jakarta.annotation-api:3.0.0=runtimeClasspath,testCompileClasspath,testRuntimeClasspath +jakarta.xml.bind:jakarta.xml.bind-api:4.0.5=testCompileClasspath,testRuntimeClasspath +javax.inject:javax.inject:1=annotationProcessor,testAnnotationProcessor +jaxen:jaxen:2.0.6=spotbugs +net.bytebuddy:byte-buddy-agent:1.17.8=testCompileClasspath,testRuntimeClasspath +net.bytebuddy:byte-buddy:1.17.8=testCompileClasspath,testRuntimeClasspath +net.minidev:accessors-smart:2.6.0=testCompileClasspath,testRuntimeClasspath +net.minidev:json-smart:2.6.0=testCompileClasspath,testRuntimeClasspath +net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs +org.antlr:antlr4-runtime:4.13.2=checkstyle +org.apache.bcel:bcel:6.12.0=spotbugs +org.apache.commons:commons-lang3:3.20.0=checkstyle,spotbugs +org.apache.commons:commons-text:1.15.0=spotbugs +org.apache.commons:commons-text:1.3=checkstyle +org.apache.httpcomponents:httpclient:4.5.13=checkstyle +org.apache.httpcomponents:httpcore:4.4.16=checkstyle +org.apache.kafka:kafka-clients:4.1.2=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.apache.logging.log4j:log4j-api:2.25.5=runtimeClasspath,spotbugs,testCompileClasspath,testRuntimeClasspath +org.apache.logging.log4j:log4j-core:2.25.5=spotbugs +org.apache.logging.log4j:log4j-to-slf4j:2.25.5=runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.apache.maven.doxia:doxia-core:1.12.0=checkstyle +org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle +org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle +org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle +org.apache.tomcat.embed:tomcat-embed-core:11.0.24=testCompileClasspath,testRuntimeClasspath +org.apache.tomcat.embed:tomcat-embed-el:11.0.24=testCompileClasspath,testRuntimeClasspath +org.apache.tomcat.embed:tomcat-embed-websocket:11.0.24=testCompileClasspath,testRuntimeClasspath +org.apache.xbean:xbean-reflect:3.7=checkstyle +org.apiguardian:apiguardian-api:1.1.2=testCompileClasspath +org.assertj:assertj-core:3.27.7=testCompileClasspath,testRuntimeClasspath +org.awaitility:awaitility:4.3.0=testCompileClasspath,testRuntimeClasspath +org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle +org.codehaus.plexus:plexus-component-annotations:2.1.0=checkstyle +org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle +org.codehaus.plexus:plexus-utils:3.3.0=checkstyle +org.dom4j:dom4j:2.2.0=spotbugs +org.hamcrest:hamcrest:3.0=testCompileClasspath,testRuntimeClasspath +org.javassist:javassist:3.28.0-GA=checkstyle +org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-api:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-engine:6.0.3=testRuntimeClasspath +org.junit.jupiter:junit-jupiter-params:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-commons:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-engine:6.0.3=testRuntimeClasspath +org.junit.platform:junit-platform-launcher:6.0.3=testRuntimeClasspath +org.junit:junit-bom:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit:junit-bom:6.1.0=spotbugs +org.mockito:mockito-core:5.20.0=mockitoAgent,testCompileClasspath,testRuntimeClasspath +org.mockito:mockito-junit-jupiter:5.20.0=testCompileClasspath,testRuntimeClasspath +org.objenesis:objenesis:3.3=testRuntimeClasspath +org.opentest4j:opentest4j:1.3.0=testCompileClasspath,testRuntimeClasspath +org.osgi:org.osgi.annotation.bundle:2.0.0=testCompileClasspath +org.osgi:org.osgi.annotation.versioning:1.1.2=testCompileClasspath +org.osgi:org.osgi.resource:1.0.0=testCompileClasspath +org.osgi:org.osgi.service.serviceloader:1.0.0=testCompileClasspath +org.ow2.asm:asm-analysis:9.10.1=spotbugs +org.ow2.asm:asm-commons:9.10.1=spotbugs +org.ow2.asm:asm-tree:9.10.1=spotbugs +org.ow2.asm:asm-util:9.10.1=spotbugs +org.ow2.asm:asm:9.10.1=spotbugs +org.ow2.asm:asm:9.7.1=testCompileClasspath,testRuntimeClasspath +org.pcollections:pcollections:4.0.1=annotationProcessor,testAnnotationProcessor +org.reflections:reflections:0.10.2=checkstyle +org.skyscreamer:jsonassert:1.5.3=testCompileClasspath,testRuntimeClasspath +org.slf4j:jul-to-slf4j:2.0.18=runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.slf4j:slf4j-api:2.0.18=runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testRuntimeClasspath +org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j +org.slf4j:slf4j-simple:2.0.18=checkstyle +org.springframework.boot:spring-boot-autoconfigure:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-configuration-processor:4.0.8=annotationProcessor +org.springframework.boot:spring-boot-http-converter:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-jackson:4.0.8=runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-resttestclient:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-servlet:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-jackson-test:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-jackson:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-json:4.0.8=runtimeClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-logging:4.0.8=runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-test:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-tomcat-runtime:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-tomcat:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-webmvc-test:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-webmvc:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter:4.0.8=runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-test-autoconfigure:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-test:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-tomcat:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-web-server:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-webmvc-test:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-webmvc:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-aop:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-beans:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-context:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-core:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-expression:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-test:7.0.9=testCompileClasspath,testRuntimeClasspath +org.springframework:spring-web:7.0.9=testCompileClasspath,testRuntimeClasspath +org.springframework:spring-webmvc:7.0.9=testCompileClasspath,testRuntimeClasspath +org.xerial.snappy:snappy-java:1.1.10.7=runtimeClasspath,testRuntimeClasspath +org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs +org.xmlunit:xmlunit-core:2.10.4=testCompileClasspath,testRuntimeClasspath +org.yaml:snakeyaml:2.5=testCompileClasspath,testRuntimeClasspath +tools.jackson.core:jackson-core:3.1.5=runtimeClasspath,testCompileClasspath,testRuntimeClasspath +tools.jackson.core:jackson-databind:3.1.5=runtimeClasspath,testCompileClasspath,testRuntimeClasspath +tools.jackson:jackson-bom:3.1.5=runtimeClasspath,testCompileClasspath,testRuntimeClasspath +empty= diff --git a/src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/BrokerAddress.java b/src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/BrokerAddress.java similarity index 100% rename from src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/BrokerAddress.java rename to src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/BrokerAddress.java diff --git a/src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaAdapterConfig.java b/src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaAdapterConfig.java similarity index 100% rename from src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaAdapterConfig.java rename to src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaAdapterConfig.java diff --git a/src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaAdapterSettings.java b/src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaAdapterSettings.java similarity index 100% rename from src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaAdapterSettings.java rename to src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaAdapterSettings.java diff --git a/src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaMessageBroker.java b/src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaMessageBroker.java similarity index 100% rename from src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaMessageBroker.java rename to src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaMessageBroker.java diff --git a/src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaSender.java b/src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaSender.java similarity index 100% rename from src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaSender.java rename to src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaSender.java diff --git a/src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaSenderAutoConfiguration.java b/src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaSenderAutoConfiguration.java similarity index 100% rename from src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaSenderAutoConfiguration.java rename to src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaSenderAutoConfiguration.java diff --git a/src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/LegacyKafkaMessagingRootAutoConfiguration.java b/src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/LegacyKafkaMessagingRootAutoConfiguration.java new file mode 100644 index 00000000..e09bc150 --- /dev/null +++ b/src/adapter/outbound/messaging-kafka/src/main/java/dev/caskeleton/adapter/outbound/messaging/kafka/LegacyKafkaMessagingRootAutoConfiguration.java @@ -0,0 +1,17 @@ +package dev.caskeleton.adapter.outbound.messaging.kafka; + +import org.springframework.boot.autoconfigure.AutoConfiguration; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Import; + +/** + * Build-time Kafka capability for the legacy R0 messaging seam. + * + *

The broker-neutral messaging bridge no longer imports Kafka classes. An application that still + * needs the R0 Kafka seam must deliberately add this leaf; only then can the Kafka producer/client + * enter its runtime graph. + */ +@AutoConfiguration +@ConditionalOnProperty(prefix = "app.messaging", name = "enabled", havingValue = "true") +@Import({KafkaSenderAutoConfiguration.class, KafkaAdapterConfig.class}) +public class LegacyKafkaMessagingRootAutoConfiguration {} diff --git a/src/adapter/outbound/messaging-kafka/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/src/adapter/outbound/messaging-kafka/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports new file mode 100644 index 00000000..b9b6bc19 --- /dev/null +++ b/src/adapter/outbound/messaging-kafka/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports @@ -0,0 +1 @@ +dev.caskeleton.adapter.outbound.messaging.kafka.LegacyKafkaMessagingRootAutoConfiguration diff --git a/src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/kafka/BrokerAddressTest.java b/src/adapter/outbound/messaging-kafka/src/test/java/dev/caskeleton/adapter/outbound/messaging/kafka/BrokerAddressTest.java similarity index 100% rename from src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/kafka/BrokerAddressTest.java rename to src/adapter/outbound/messaging-kafka/src/test/java/dev/caskeleton/adapter/outbound/messaging/kafka/BrokerAddressTest.java diff --git a/src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaAdapterSettingsTest.java b/src/adapter/outbound/messaging-kafka/src/test/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaAdapterSettingsTest.java similarity index 100% rename from src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaAdapterSettingsTest.java rename to src/adapter/outbound/messaging-kafka/src/test/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaAdapterSettingsTest.java diff --git a/src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaSenderAutoConfigurationOwnershipTest.java b/src/adapter/outbound/messaging-kafka/src/test/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaSenderAutoConfigurationOwnershipTest.java similarity index 64% rename from src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaSenderAutoConfigurationOwnershipTest.java rename to src/adapter/outbound/messaging-kafka/src/test/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaSenderAutoConfigurationOwnershipTest.java index a20250e0..ed67183c 100644 --- a/src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaSenderAutoConfigurationOwnershipTest.java +++ b/src/adapter/outbound/messaging-kafka/src/test/java/dev/caskeleton/adapter/outbound/messaging/kafka/KafkaSenderAutoConfigurationOwnershipTest.java @@ -2,15 +2,14 @@ package dev.caskeleton.adapter.outbound.messaging.kafka; import static org.assertj.core.api.Assertions.assertThat; -import dev.caskeleton.adapter.outbound.messaging.autoconfigure.MessagingBridgeRootAutoConfiguration; import java.util.Arrays; import org.junit.jupiter.api.Test; import org.springframework.context.annotation.Import; class KafkaSenderAutoConfigurationOwnershipTest { @Test - void messagingBridgeRootOwnsTheProductionKafkaSenderInsideTheAdapter() { - Import imports = MessagingBridgeRootAutoConfiguration.class.getAnnotation(Import.class); + void kafkaCapabilityRootOwnsTheProductionKafkaSenderInsideTheAdapter() { + Import imports = LegacyKafkaMessagingRootAutoConfiguration.class.getAnnotation(Import.class); assertThat(imports).isNotNull(); assertThat(Arrays.asList(imports.value())) diff --git a/src/adapter/outbound/messaging/build.gradle b/src/adapter/outbound/messaging/build.gradle index 77a1a644..85f8330c 100644 --- a/src/adapter/outbound/messaging/build.gradle +++ b/src/adapter/outbound/messaging/build.gradle @@ -13,11 +13,17 @@ dependencies { implementation 'org.springframework.boot:spring-boot-autoconfigure' implementation 'org.springframework.boot:spring-boot-starter-json' - implementation 'org.apache.kafka:kafka-clients' implementation(libs.json.schema.validator) { exclude group: 'com.fasterxml.jackson.dataformat', module: 'jackson-dataformat-yaml' } implementation 'org.slf4j:slf4j-api' + + // Test-only: the off-filter promises compatibility when an adopter adds Boot's broker + // auto-configuration modules. Keep those modules off production runtime, but load their actual + // AutoConfiguration.imports here so stale FQCNs fail the contract test. + testImplementation project(':adapter:outbound:messaging-kafka') + testImplementation 'org.springframework.boot:spring-boot-kafka' + testImplementation 'org.springframework.boot:spring-boot-amqp' } tasks.withType(Test).configureEach { systemProperty 'messaging.commonEvidenceSchema', diff --git a/src/adapter/outbound/messaging/gradle.lockfile b/src/adapter/outbound/messaging/gradle.lockfile index c173eadb..776e6464 100644 --- a/src/adapter/outbound/messaging/gradle.lockfile +++ b/src/adapter/outbound/messaging/gradle.lockfile @@ -36,6 +36,7 @@ com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins com.jayway.jsonpath:json-path:2.10.0=testCompileClasspath,testRuntimeClasspath com.networknt:json-schema-validator:3.0.2=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath com.puppycrawl.tools:checkstyle:13.5.0=checkstyle +com.rabbitmq:amqp-client:5.27.1=testCompileClasspath,testRuntimeClasspath com.vaadin.external.google:android-json:0.0.20131108.vaadin1=testCompileClasspath,testRuntimeClasspath commons-beanutils:commons-beanutils:1.11.0=checkstyle commons-collections:commons-collections:3.2.2=checkstyle @@ -46,6 +47,17 @@ io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,testAnnota io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,testAnnotationProcessor io.micrometer:micrometer-commons:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath io.micrometer:micrometer-observation:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-buffer:4.2.17.Final=testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-base:4.2.17.Final=testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-compression:4.2.17.Final=testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-marshalling:4.2.17.Final=testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-protobuf:4.2.17.Final=testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec:4.2.17.Final=testCompileClasspath,testRuntimeClasspath +io.netty:netty-common:4.2.17.Final=testCompileClasspath,testRuntimeClasspath +io.netty:netty-handler:4.2.17.Final=testCompileClasspath,testRuntimeClasspath +io.netty:netty-resolver:4.2.17.Final=testCompileClasspath,testRuntimeClasspath +io.netty:netty-transport-native-unix-common:4.2.17.Final=testCompileClasspath,testRuntimeClasspath +io.netty:netty-transport:4.2.17.Final=testCompileClasspath,testRuntimeClasspath jakarta.activation:jakarta.activation-api:2.1.4=testCompileClasspath,testRuntimeClasspath jakarta.annotation:jakarta.annotation-api:3.0.0=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath jakarta.xml.bind:jakarta.xml.bind-api:4.0.5=testCompileClasspath,testRuntimeClasspath @@ -63,7 +75,7 @@ org.apache.commons:commons-text:1.15.0=spotbugs org.apache.commons:commons-text:1.3=checkstyle org.apache.httpcomponents:httpclient:4.5.13=checkstyle org.apache.httpcomponents:httpcore:4.4.16=checkstyle -org.apache.kafka:kafka-clients:4.1.2=compileClasspath,testCompileClasspath,testRuntimeClasspath +org.apache.kafka:kafka-clients:4.1.2=testCompileClasspath,testRuntimeClasspath org.apache.logging.log4j:log4j-api:2.25.5=compileClasspath,runtimeClasspath,spotbugs,testCompileClasspath,testRuntimeClasspath org.apache.logging.log4j:log4j-core:2.25.5=spotbugs org.apache.logging.log4j:log4j-to-slf4j:2.25.5=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath @@ -116,10 +128,15 @@ org.slf4j:jul-to-slf4j:2.0.18=compileClasspath,runtimeClasspath,testCompileClass org.slf4j:slf4j-api:2.0.18=compileClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testRuntimeClasspath org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j org.slf4j:slf4j-simple:2.0.18=checkstyle +org.springframework.amqp:spring-amqp:4.0.5=testCompileClasspath,testRuntimeClasspath +org.springframework.amqp:spring-rabbit:4.0.5=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-amqp:4.0.8=testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-autoconfigure:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-configuration-processor:4.0.8=annotationProcessor org.springframework.boot:spring-boot-http-converter:4.0.8=testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-jackson:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-kafka:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-persistence:4.0.8=testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-resttestclient:4.0.8=testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-servlet:4.0.8=testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-starter-jackson-test:4.0.8=testCompileClasspath,testRuntimeClasspath @@ -135,16 +152,20 @@ org.springframework.boot:spring-boot-starter:4.0.8=compileClasspath,runtimeClass org.springframework.boot:spring-boot-test-autoconfigure:4.0.8=testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-test:4.0.8=testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-tomcat:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-transaction:4.0.8=testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-web-server:4.0.8=testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-webmvc-test:4.0.8=testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-webmvc:4.0.8=testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.kafka:spring-kafka:4.0.7=testCompileClasspath,testRuntimeClasspath org.springframework:spring-aop:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework:spring-beans:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework:spring-context:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework:spring-core:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework:spring-expression:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-messaging:7.0.9=testCompileClasspath,testRuntimeClasspath org.springframework:spring-test:7.0.9=testCompileClasspath,testRuntimeClasspath +org.springframework:spring-tx:7.0.9=testCompileClasspath,testRuntimeClasspath org.springframework:spring-web:7.0.9=testCompileClasspath,testRuntimeClasspath org.springframework:spring-webmvc:7.0.9=testCompileClasspath,testRuntimeClasspath org.xerial.snappy:snappy-java:1.1.10.7=testRuntimeClasspath diff --git a/src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/autoconfigure/MessagingBridgeRootAutoConfiguration.java b/src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/autoconfigure/MessagingBridgeRootAutoConfiguration.java index 247b7c63..31c6e043 100644 --- a/src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/autoconfigure/MessagingBridgeRootAutoConfiguration.java +++ b/src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/autoconfigure/MessagingBridgeRootAutoConfiguration.java @@ -2,8 +2,6 @@ package dev.caskeleton.adapter.outbound.messaging.autoconfigure; import dev.caskeleton.adapter.outbound.messaging.MessagingConfig; import dev.caskeleton.adapter.outbound.messaging.MessagingSettings; -import dev.caskeleton.adapter.outbound.messaging.kafka.KafkaAdapterConfig; -import dev.caskeleton.adapter.outbound.messaging.kafka.KafkaSenderAutoConfiguration; import dev.caskeleton.adapter.outbound.messaging.platformbridge.PlatformIntegrationEventPublishAdapter; import dev.caskeleton.application.messaging.event.IntegrationEventPublishPort; import dev.caskeleton.messaging.schema.EncodedMessagePublisher; @@ -21,13 +19,13 @@ import org.springframework.context.annotation.Import; *

Before this, whether {@code app.messaging.broker} was blank was the de-facto switch. That is a * selector doing a switch's job, and it reads badly in both directions: a blank broker with the * relay enabled took down startup, while a deployment that wanted no messaging at all still - * assembled settings, a Kafka adapter configuration and two publishers. The broker id now selects - * which transport, and this switch decides whether there is one. + * assembled settings and publishers. Broker-specific client configuration is now a build-time + * capability leaf; this root remains broker-neutral and only binds ports to a contributed broker. */ @AutoConfiguration @ConditionalOnProperty(prefix = "app.messaging", name = "enabled", havingValue = "true") @EnableConfigurationProperties(MessagingSettings.class) -@Import({MessagingConfig.class, KafkaSenderAutoConfiguration.class, KafkaAdapterConfig.class}) +@Import(MessagingConfig.class) public class MessagingBridgeRootAutoConfiguration { /** diff --git a/src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/autoconfigure/MessagingOffAutoConfigurationImportFilter.java b/src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/autoconfigure/MessagingOffAutoConfigurationImportFilter.java index 597b0c54..392a72e8 100644 --- a/src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/autoconfigure/MessagingOffAutoConfigurationImportFilter.java +++ b/src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/autoconfigure/MessagingOffAutoConfigurationImportFilter.java @@ -25,8 +25,8 @@ public final class MessagingOffAutoConfigurationImportFilter "org.springframework.boot.kafka.autoconfigure.KafkaAutoConfiguration", "org.springframework.boot.kafka.autoconfigure.metrics.KafkaMetricsAutoConfiguration", "org.springframework.boot.amqp.autoconfigure.RabbitAutoConfiguration", - "org.springframework.boot.amqp.autoconfigure.RabbitAnnotationDrivenAutoConfiguration", - "org.springframework.boot.amqp.autoconfigure.health.RabbitHealthContributorAutoConfiguration"); + "org.springframework.boot.amqp.autoconfigure.health.RabbitHealthContributorAutoConfiguration", + "org.springframework.boot.amqp.autoconfigure.metrics.RabbitMetricsAutoConfiguration"); private Environment environment; diff --git a/src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/outbox/OutboxMessagePublishAdapter.java b/src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/outbox/OutboxMessagePublishAdapter.java index 887e2e15..bb3265ea 100644 --- a/src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/outbox/OutboxMessagePublishAdapter.java +++ b/src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/outbox/OutboxMessagePublishAdapter.java @@ -78,24 +78,24 @@ public final class OutboxMessagePublishAdapter implements OutboxMessagePublishPo return publisher.publish(canonical.event()).toCompletableFuture().join(); } if (event instanceof OutboxEvent legacy) { - publishLegacy(legacy); - return OutboxPublishOutcome.CONFIRMED; + return publishLegacy(legacy); } throw new IllegalStateException("unsupported claimed outbox event type: " + event.getClass()); } - private void publishLegacy(OutboxEvent event) { + private OutboxPublishOutcome publishLegacy(OutboxEvent event) { MessageBroker activeBroker = broker.orElseThrow(() -> new AdapterDisabledException("messaging legacy broker")); String envelope = OutboxEnvelopeJson.toJson(event); OutboundMessage message = new OutboundMessage(event.eventType(), event.aggregateId(), envelope); try { activeBroker.send(message); - } catch (RuntimeException exception) { - throw exception; - } catch (Exception exception) { - throw new RuntimeException( - "outbox publish failed for broker '" + activeBroker.brokerId() + "'", exception); + return OutboxPublishOutcome.CONFIRMED; + } catch (Exception unknownOutcome) { + // The legacy MessageBroker seam exposes no transmission evidence. Once send() throws, this + // adapter cannot prove that zero bytes reached the broker, so calling it a refusal risks + // losing an event that was accepted before the acknowledgement path failed. + return OutboxPublishOutcome.AMBIGUOUS; } } } diff --git a/src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/autoconfigure/MessagingOffAutoConfigurationImportFilterParityTest.java b/src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/autoconfigure/MessagingOffAutoConfigurationImportFilterParityTest.java new file mode 100644 index 00000000..8d239078 --- /dev/null +++ b/src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/autoconfigure/MessagingOffAutoConfigurationImportFilterParityTest.java @@ -0,0 +1,44 @@ +package dev.caskeleton.adapter.outbound.messaging.autoconfigure; + +import static org.assertj.core.api.Assertions.assertThat; + +import java.lang.reflect.Field; +import java.util.LinkedHashSet; +import java.util.Set; +import java.util.stream.Collectors; +import org.junit.jupiter.api.Test; +import org.springframework.boot.autoconfigure.AutoConfiguration; +import org.springframework.boot.context.annotation.ImportCandidates; + +/** + * Keeps the optional Boot broker compatibility filter synchronized with the actual Boot version. + * + *

The broker Boot modules are test-only here. Production deliberately depends on Spring + * Kafka/Rabbit through the messaging platform rather than on Boot's competing broker + * auto-configurations. + */ +class MessagingOffAutoConfigurationImportFilterParityTest { + + @Test + void targetListExactlyMatchesBootKafkaAndRabbitCandidates() throws Exception { + Set candidates = + ImportCandidates.load(AutoConfiguration.class, getClass().getClassLoader()) + .getCandidates() + .stream() + .filter( + name -> + name.startsWith("org.springframework.boot.kafka.autoconfigure.") + || name.startsWith("org.springframework.boot.amqp.autoconfigure.")) + .collect(Collectors.toCollection(LinkedHashSet::new)); + + Field field = + MessagingOffAutoConfigurationImportFilter.class.getDeclaredField( + "BROKER_AUTO_CONFIGURATIONS"); + field.setAccessible(true); + @SuppressWarnings("unchecked") + Set targets = new LinkedHashSet<>((Set) field.get(null)); + + assertThat(candidates).isNotEmpty(); + assertThat(targets).isEqualTo(candidates); + } +} diff --git a/src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/outbox/OutboxMessagePublishAdapterTest.java b/src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/outbox/OutboxMessagePublishAdapterTest.java index 2dbcd915..9ab82ff4 100644 --- a/src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/outbox/OutboxMessagePublishAdapterTest.java +++ b/src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/outbox/OutboxMessagePublishAdapterTest.java @@ -128,13 +128,14 @@ class OutboxMessagePublishAdapterTest { class FailClosedPath { @Test - void senderExceptionPropagatesAsRuntimeExceptionCharacterization() { + void senderFailureIsTypedAsAmbiguousWhenTheLegacySeamHasNoTransmissionEvidence() { FakeBroker broker = new FakeBroker(new IllegalStateException("broker down")); OutboxMessagePublishAdapter adapter = new OutboxMessagePublishAdapter(broker); assertThatThrownBy(() -> adapter.publish(sampleEvent())) - .isInstanceOf(IllegalStateException.class) - .hasMessage("broker down"); + .isInstanceOf(dev.caskeleton.application.outbox.OutboxPublishAmbiguousException.class); + assertThat(adapter.publishForOutcome(sampleEvent())) + .isEqualTo(dev.caskeleton.application.outbox.OutboxPublishOutcome.AMBIGUOUS); } @Test @@ -161,13 +162,12 @@ class OutboxMessagePublishAdapterTest { } @Test - void publishWrapsCheckedExceptionInRuntimeException() { + void checkedNetworkFailureIsAlsoAmbiguousRatherThanAnUntypedRuntimeException() { FakeBroker broker = new FakeBroker(new IOException("network error")); OutboxMessagePublishAdapter adapter = new OutboxMessagePublishAdapter(broker); assertThatThrownBy(() -> adapter.publish(sampleEvent())) - .isInstanceOf(RuntimeException.class) - .hasCauseInstanceOf(IOException.class); + .isInstanceOf(dev.caskeleton.application.outbox.OutboxPublishAmbiguousException.class); } @Test diff --git a/src/adapter/outbound/notification/README.md b/src/adapter/outbound/notification/README.md index 4fbe71c2..d87708af 100644 --- a/src/adapter/outbound/notification/README.md +++ b/src/adapter/outbound/notification/README.md @@ -54,6 +54,17 @@ client 는 포킹 프로젝트가 채우는 seam 이다. `GoogleEmailProvider`, `SlackWebhookProvider`). `GoogleEmailClient`/`SlackClient` 는 포크가 구현하는 seam 이며 실패는 데코레이터가 fail-open 처리한다. +## Removed R1 outbound experiment + +The old top-level `catalog/`, `provider/`, and `template/` graph was never assembled by production +and has been removed. Do not recreate it to reach the canonical platform. The application R1 public +contract remains governed separately by NOTIF-ADR-005; new runtime code belongs under +`..notification.platform..`. + +The context-aware HTML safety that was stronger in `LocalEmailRenderer` was carried forward before +removal: `platform.template.TemplateSlotPolicy` now validates operator-authored HTML against the +reviewed tag/attribute subset after rendering. + ## Wave G deletion inventory 다음 surface는 canonical-only cutover와 retained evidence 검증이 끝난 뒤 한 묶음으로 제거한다. @@ -71,7 +82,7 @@ client 는 포킹 프로젝트가 채우는 seam 이다. - legacy configuration/tests: `app.notification.routes.*`, `app.notification.google-email.enabled`, `app.notification.slack-webhook.enabled`, drifted - `APP_NOTIFICATION_EMAIL_PROVIDER`/`APP_NOTIFICATION_SLACK_PROVIDER`, + `APP_NOTIFICATION_GOOGLE_EMAIL_ENABLED`/`APP_NOTIFICATION_SLACK_WEBHOOK_ENABLED`, `NotificationAdapterTest`, `RoutingNotifierTest`와 bootstrap legacy gating cases accepted 또는 indeterminate work를 inventory하지 않은 상태에서 이 목록을 삭제하거나 canonical diff --git a/src/adapter/outbound/notification/build.gradle b/src/adapter/outbound/notification/build.gradle index fb0a347f..b62b1c19 100644 --- a/src/adapter/outbound/notification/build.gradle +++ b/src/adapter/outbound/notification/build.gradle @@ -5,10 +5,14 @@ plugins { dependencies { implementation project(':application-core') + implementation project(':application-notification') implementation project(':shared-contract') implementation project(':adapter:outbound:support') implementation 'org.springframework.boot:spring-boot-autoconfigure' + implementation 'org.springframework.boot:spring-boot-actuator' + implementation 'org.springframework.boot:spring-boot-actuator-autoconfigure' + implementation 'org.springframework.boot:spring-boot-health' implementation 'org.springframework:spring-web' // Slack webhook client (RestClient) implementation 'org.slf4j:slf4j-api' diff --git a/src/adapter/outbound/notification/gradle.lockfile b/src/adapter/outbound/notification/gradle.lockfile index b7a0b5fe..e6935411 100644 --- a/src/adapter/outbound/notification/gradle.lockfile +++ b/src/adapter/outbound/notification/gradle.lockfile @@ -125,8 +125,11 @@ org.slf4j:jul-to-slf4j:2.0.18=compileClasspath,runtimeClasspath,testCompileClass org.slf4j:slf4j-api:2.0.18=compileClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testRuntimeClasspath org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j org.slf4j:slf4j-simple:2.0.18=checkstyle +org.springframework.boot:spring-boot-actuator-autoconfigure:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-actuator:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-autoconfigure:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-configuration-processor:4.0.8=annotationProcessor +org.springframework.boot:spring-boot-health:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-http-converter:4.0.8=testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-jackson:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-mail:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/NotificationRoutesSettings.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/NotificationRoutesSettings.java index 416c2cb2..55847e3c 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/NotificationRoutesSettings.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/NotificationRoutesSettings.java @@ -1,7 +1,7 @@ package dev.caskeleton.adapter.outbound.notification; import dev.caskeleton.adapter.outbound.notification.core.RoutingNotifier; -import dev.caskeleton.application.notification.Channel; +import dev.caskeleton.application.notification.NotificationChannel; import java.util.List; import java.util.Map; import org.springframework.boot.context.properties.ConfigurationProperties; @@ -11,7 +11,7 @@ import org.springframework.boot.context.properties.ConfigurationProperties; * app.notification.routes..=[,]}. * *

Mirrors {@code CacheBindingSettings}: relaxed binding maps the channel segment (e.g. {@code - * email} → {@link Channel#EMAIL}) automatically via Spring's {@code ApplicationConversionService}. + * email} → {@link NotificationChannel#EMAIL}) automatically via Spring's {@code ApplicationConversionService}. * Route values are coerced to {@code List} by the binder (comma-separated or YAML list). * Default is an empty map so the notification template stays a non-required optional module: * startup never fails when no routes are configured. Consistency (every referenced providerId has @@ -20,7 +20,7 @@ import org.springframework.boot.context.properties.ConfigurationProperties; * @param routes channel → (route → providerId list), default empty */ @ConfigurationProperties(prefix = "app.notification") -public record NotificationRoutesSettings(Map>> routes) { +public record NotificationRoutesSettings(Map>> routes) { public NotificationRoutesSettings { routes = (routes == null) ? Map.of() : Map.copyOf(routes); diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/CompiledNotificationBinding.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/CompiledNotificationBinding.java deleted file mode 100644 index 589a6a1e..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/CompiledNotificationBinding.java +++ /dev/null @@ -1,151 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.catalog; - -import java.util.Comparator; -import java.util.List; -import java.util.Objects; - -/** - * Fully resolved immutable route graph; only {@link NotificationBindingCompiler} can construct it. - */ -public final class CompiledNotificationBinding { - - private final NotificationRouteDescriptor route; - private final NotificationTemplateDescriptor template; - private final List targets; - private final String bindingDigest; - - CompiledNotificationBinding( - NotificationRouteDescriptor route, - NotificationTemplateDescriptor template, - List targets, - String bindingDigest) { - this.route = Objects.requireNonNull(route, "compiled notification route must be non-null"); - this.template = - Objects.requireNonNull(template, "compiled notification template must be non-null"); - Objects.requireNonNull(targets, "compiled notification targets must be non-null"); - this.targets = - targets.stream() - .map(target -> Objects.requireNonNull(target, "compiled target must be non-null")) - .sorted(Comparator.comparing(target -> target.target().targetId())) - .toList(); - if (this.targets.size() != route.targets().size()) { - throw new IllegalArgumentException( - "compiled notification target count must match route target count"); - } - this.bindingDigest = - NotificationCatalogException.requireDigest( - "compiled notification binding digest", bindingDigest); - } - - public NotificationRouteDescriptor route() { - return route; - } - - public NotificationTemplateDescriptor template() { - return template; - } - - public List targets() { - return targets; - } - - public String bindingDigest() { - return bindingDigest; - } - - @Override - public boolean equals(Object other) { - return this == other - || (other instanceof CompiledNotificationBinding that - && route.equals(that.route) - && template.equals(that.template) - && targets.equals(that.targets) - && bindingDigest.equals(that.bindingDigest)); - } - - @Override - public int hashCode() { - return Objects.hash(route, template, targets, bindingDigest); - } - - @Override - public String toString() { - return "CompiledNotificationBinding[route=" - + route.routeId().value() - + ", routeRevision=" - + route.routeRevision() - + ", template=" - + template.templateRef().templateId() - + "-v" - + template.templateRef().version() - + ", targets=, bindingDigest=" - + bindingDigest - + "]"; - } - - /** Non-forgeable resolved target exposed read-only to provider protocol implementations. */ - public static final class CompiledTarget { - - private final NotificationRouteDescriptor.Target target; - private final NotificationProviderRuntimeProfile runtimeProfile; - private final NotificationProviderDescriptor provider; - private final NotificationProviderCapabilityCard capabilityCard; - - CompiledTarget( - NotificationRouteDescriptor.Target target, - NotificationProviderRuntimeProfile runtimeProfile, - NotificationProviderDescriptor provider, - NotificationProviderCapabilityCard capabilityCard) { - this.target = Objects.requireNonNull(target, "compiled route target must be non-null"); - this.runtimeProfile = - Objects.requireNonNull(runtimeProfile, "compiled runtime profile must be non-null"); - this.provider = Objects.requireNonNull(provider, "compiled provider must be non-null"); - this.capabilityCard = - Objects.requireNonNull(capabilityCard, "compiled capability card must be non-null"); - } - - public NotificationRouteDescriptor.Target target() { - return target; - } - - public NotificationProviderRuntimeProfile runtimeProfile() { - return runtimeProfile; - } - - public NotificationProviderDescriptor provider() { - return provider; - } - - public NotificationProviderCapabilityCard capabilityCard() { - return capabilityCard; - } - - @Override - public boolean equals(Object other) { - return this == other - || (other instanceof CompiledTarget that - && target.equals(that.target) - && runtimeProfile.equals(that.runtimeProfile) - && provider.equals(that.provider) - && capabilityCard.equals(that.capabilityCard)); - } - - @Override - public int hashCode() { - return Objects.hash(target, runtimeProfile, provider, capabilityCard); - } - - @Override - public String toString() { - return "CompiledTarget[targetId=" - + target.targetId() - + ", runtimeProfileId=" - + runtimeProfile.profileId() - + ", providerId=" - + provider.providerId() - + ", capabilityCardId=" - + capabilityCard.cardId() - + ", sensitiveReferences=]"; - } - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationBindingCompiler.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationBindingCompiler.java deleted file mode 100644 index 6a3825e6..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationBindingCompiler.java +++ /dev/null @@ -1,516 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.catalog; - -import dev.caskeleton.application.notification.NotificationRouteId; -import dev.caskeleton.application.notification.NotificationTemplateRef; -import java.security.MessageDigest; -import java.util.ArrayList; -import java.util.Comparator; -import java.util.HashMap; -import java.util.HashSet; -import java.util.List; -import java.util.Map; -import java.util.Objects; -import java.util.Set; -import java.util.function.Function; - -/** - * Pure deterministic compiler over explicit provider, template, route and runtime-profile inputs. - */ -public final class NotificationBindingCompiler { - - private static final Set INITIAL_CARD_IDS = - Set.of( - "slack-web-api-inline-single-local-v1", - "slack-web-api-durable-single-local-v1", - "aws-ses-v2-durable-single-local-sns-v1"); - private static final Map APPROVED_CARD_PROVIDERS = - Map.of( - "slack-web-api-inline-single-local-v1", - "slack-web-api", - "slack-web-api-durable-single-local-v1", - "slack-web-api", - "aws-ses-v2-durable-single-local-sns-v1", - "aws-ses-v2"); - - private final List providers; - private final List templates; - private final List routes; - private final List runtimeProfiles; - private final Map activeRouteRevisions; - - public NotificationBindingCompiler( - List providers, - List templates, - List routes, - List runtimeProfiles) { - this(providers, templates, routes, runtimeProfiles, singletonActiveRevisions(routes)); - } - - public NotificationBindingCompiler( - List providers, - List templates, - List routes, - List runtimeProfiles, - Map activeRouteRevisions) { - this.providers = immutableCopy("providers", providers); - this.templates = immutableCopy("templates", templates); - this.routes = immutableCopy("routes", routes); - this.runtimeProfiles = immutableCopy("runtime profiles", runtimeProfiles); - this.activeRouteRevisions = - Map.copyOf( - Objects.requireNonNull( - activeRouteRevisions, "active notification route revisions must be non-null")); - } - - public CompiledGraph compile() { - Map providerIndex = - uniqueIndex(providers, NotificationProviderDescriptor::providerId, "provider"); - Map templateIndex = - uniqueIndex(templates, NotificationTemplateDescriptor::templateRef, "template"); - Map profileIndex = - uniqueIndex( - runtimeProfiles, NotificationProviderRuntimeProfile::profileId, "runtime profile"); - uniqueIndex( - routes, route -> route.routeId().value() + "#" + route.routeRevision(), "route revision"); - validateActiveRevisions(routes, activeRouteRevisions); - validateRegisteredCards(providerIndex.values()); - - List bindings = - routes.stream() - .sorted( - Comparator.comparing((NotificationRouteDescriptor route) -> route.routeId().value()) - .thenComparingInt(NotificationRouteDescriptor::routeRevision)) - .map(route -> compileRoute(route, providerIndex, templateIndex, profileIndex)) - .toList(); - if (bindings.isEmpty() || bindings.size() > 100) { - throw new NotificationCatalogException( - "notification binding graph must contain 1..100 routes"); - } - return new CompiledGraph( - bindings, activeRouteRevisions, manifestDigest(bindings, activeRouteRevisions)); - } - - private static CompiledNotificationBinding compileRoute( - NotificationRouteDescriptor route, - Map providers, - Map templates, - Map profiles) { - NotificationTemplateDescriptor template = templates.get(route.templateRef()); - if (template == null) { - throw new NotificationCatalogException( - "unknown template for route " + route.routeId().value()); - } - if (template.channel() != route.channel()) { - throw new NotificationCatalogException( - "template channel does not match route " + route.routeId().value()); - } - validateRouteShape(route); - - List targets = new ArrayList<>(); - for (NotificationRouteDescriptor.Target target : route.targets()) { - NotificationProviderRuntimeProfile profile = profiles.get(target.runtimeProfileId()); - if (profile == null) { - throw new NotificationCatalogException( - "unknown runtime profile for target " + target.targetId()); - } - NotificationProviderDescriptor provider = providers.get(profile.providerId()); - if (provider == null) { - throw new NotificationCatalogException( - "unknown provider for runtime profile " + profile.profileId()); - } - if (provider.legacyFailOpen()) { - throw new NotificationCatalogException( - "legacy fail-open provider cannot participate in a canonical binding"); - } - NotificationProviderCapabilityCard card = - provider.capabilityCards().stream() - .filter(candidate -> candidate.cardId().equals(profile.capabilityCardId())) - .findFirst() - .orElseThrow( - () -> - new NotificationCatalogException( - "unknown capability card for runtime profile " + profile.profileId())); - validateCompatibility(route, template, provider, card); - targets.add(new CompiledNotificationBinding.CompiledTarget(target, profile, provider, card)); - } - String bindingDigest = bindingDigest(route, template, targets); - return new CompiledNotificationBinding(route, template, targets, bindingDigest); - } - - private static void validateRouteShape(NotificationRouteDescriptor route) { - if (route.routeStrategy() - != dev.caskeleton.application.notification.NotificationRouteStrategy.SINGLE) { - throw new NotificationCatalogException( - "initial notification catalog supports SINGLE route strategy only"); - } - if (route.targets().size() != route.maximumTargets()) { - throw new NotificationCatalogException( - "route target count must equal its maximum target bound"); - } - long worstCaseCalls = - Math.addExact( - Math.multiplyExact( - (long) route.maximumTargets(), (long) route.maximumPhysicalAttempts()), - route.maximumReconcileCalls()); - if (worstCaseCalls > route.maximumTotalProviderCalls()) { - throw new NotificationCatalogException( - "route amplification exceeds maximum total provider calls"); - } - switch (route.routeStrategy()) { - case SINGLE -> { - if (route.maximumTargets() != 1 - || route.maximumFallbackActivations() != 0 - || route.targets().stream().anyMatch(target -> target.fallbackTargetId().isPresent())) { - throw new NotificationCatalogException( - "SINGLE route requires one target and no fallback"); - } - } - case FAN_OUT_ALL -> { - if (route.maximumFallbackActivations() != 0 - || route.targets().stream().anyMatch(target -> target.fallbackTargetId().isPresent())) { - throw new NotificationCatalogException("FAN_OUT_ALL route cannot define fallback"); - } - } - case ORDERED_FALLBACK -> { - if (route.maximumTargets() < 2 - || route.maximumFallbackActivations() < 1 - || route.maximumFallbackActivations() > route.maximumTargets() - 1) { - throw new NotificationCatalogException("ORDERED_FALLBACK route has invalid bounds"); - } - } - default -> - throw new NotificationCatalogException( - "unknown notification route strategy: " + route.routeStrategy()); - } - validateFallbackGraph(route); - } - - private static void validateFallbackGraph(NotificationRouteDescriptor route) { - Map edges = new HashMap<>(); - Set targets = - route.targets().stream() - .map(NotificationRouteDescriptor.Target::targetId) - .collect(java.util.stream.Collectors.toUnmodifiableSet()); - route - .targets() - .forEach( - target -> - target - .fallbackTargetId() - .ifPresent( - fallback -> { - if (!targets.contains(fallback)) { - throw new NotificationCatalogException( - "fallback references unknown target"); - } - edges.put(target.targetId(), fallback); - })); - for (String start : targets) { - Set visited = new HashSet<>(); - String current = start; - while (current != null) { - if (!visited.add(current)) { - throw new NotificationCatalogException("cyclic notification fallback graph"); - } - current = edges.get(current); - } - } - } - - private static void validateCompatibility( - NotificationRouteDescriptor route, - NotificationTemplateDescriptor template, - NotificationProviderDescriptor provider, - NotificationProviderCapabilityCard card) { - if (provider.channel() != route.channel() || card.channel() != route.channel()) { - throw new NotificationCatalogException( - "provider channel does not match route " + route.routeId().value()); - } - if (card.mode() != route.mode()) { - throw new NotificationCatalogException( - "provider mode does not match route " + route.routeId().value()); - } - if (card.routeStrategy() != route.routeStrategy()) { - throw new NotificationCatalogException( - "provider route strategy does not match route " + route.routeId().value()); - } - if (route.maximumTargets() > card.maximumTargets()) { - throw new NotificationCatalogException("route target bound exceeds provider capability"); - } - if (route.receiptRequired() && !card.receiptSupported()) { - throw new NotificationCatalogException( - "receipt-required route uses provider without receipt capability"); - } - if (route.maximumReconcileCalls() > card.maximumReconcileCalls() - || (route.maximumReconcileCalls() > 0 && !card.reconciliationSupported())) { - throw new NotificationCatalogException( - "route reconciliation bound exceeds provider capability"); - } - if (route.maximumPhysicalAttempts() > card.maximumPhysicalAttempts()) { - throw new NotificationCatalogException("route attempt bound exceeds provider capability"); - } - if (route.maximumTotalProviderCalls() > card.maximumTotalProviderCalls()) { - throw new NotificationCatalogException( - "route amplification bound exceeds provider capability"); - } - if (template.maximumRenderedBytes() > card.maximumPayloadBytes()) { - throw new NotificationCatalogException("template payload bound exceeds provider capability"); - } - if (route.fallbackAfterIndeterminate() && card.terminalIndeterminatePossible()) { - throw new NotificationCatalogException( - "fallback after an indeterminate submission is unsafe"); - } - } - - private static void validateRegisteredCards( - java.util.Collection providers) { - Set seen = new HashSet<>(); - providers.forEach( - provider -> - provider - .capabilityCards() - .forEach( - card -> { - if (!INITIAL_CARD_IDS.contains(card.cardId())) { - throw new NotificationCatalogException( - "unknown provider capability card: " + card.cardId()); - } - if (!provider - .providerId() - .equals(APPROVED_CARD_PROVIDERS.get(card.cardId()))) { - throw new NotificationCatalogException( - "provider capability card is bound to a different provider family"); - } - NotificationProviderCapabilityCard approved = - NotificationProviderCapabilityCard.initial(card.cardId()); - if (!approved.equals(card)) { - throw new NotificationCatalogException( - "provider capability card differs from approved definition: " - + card.cardId()); - } - if (!seen.add(card.cardId())) { - throw new NotificationCatalogException( - "duplicate provider capability card: " + card.cardId()); - } - })); - } - - private static String bindingDigest( - NotificationRouteDescriptor route, - NotificationTemplateDescriptor template, - List targets) { - MessageDigest digest = NotificationCatalogException.sha256(); - updateRoute(digest, route); - NotificationCatalogException.update(digest, template.templateRef().templateId()); - NotificationCatalogException.update(digest, template.templateRef().version()); - NotificationCatalogException.update(digest, template.rendererRevision()); - NotificationCatalogException.update(digest, template.checksum()); - template.supportedLocales().stream() - .map(java.util.Locale::toLanguageTag) - .sorted() - .forEach(locale -> NotificationCatalogException.update(digest, locale)); - NotificationCatalogException.update(digest, template.fallbackLocale().toLanguageTag()); - template.parameterNames().stream() - .sorted() - .forEach(parameter -> NotificationCatalogException.update(digest, parameter)); - NotificationCatalogException.update(digest, template.maximumRenderedBytes()); - targets.stream() - .sorted(Comparator.comparing(target -> target.target().targetId())) - .forEach( - target -> { - NotificationCatalogException.update(digest, target.target().targetId()); - NotificationCatalogException.update( - digest, target.target().fallbackTargetId().orElse("")); - NotificationCatalogException.update(digest, target.runtimeProfile().profileId()); - NotificationCatalogException.update( - digest, target.runtimeProfile().bindingRevision()); - NotificationCatalogException.update( - digest, target.runtimeProfile().credentialGeneration()); - NotificationCatalogException.update( - digest, target.runtimeProfile().credentialReference()); - NotificationCatalogException.update( - digest, target.runtimeProfile().destinationReference()); - NotificationCatalogException.update(digest, target.provider().providerId()); - NotificationCatalogException.update(digest, target.capabilityCard().cardId()); - }); - return NotificationCatalogException.finish(digest); - } - - private static String manifestDigest( - List bindings, - Map activeRouteRevisions) { - MessageDigest digest = NotificationCatalogException.sha256(); - bindings.forEach( - binding -> { - NotificationCatalogException.update(digest, binding.route().routeId().value()); - NotificationCatalogException.update(digest, binding.route().routeRevision()); - NotificationCatalogException.update(digest, binding.bindingDigest()); - }); - activeRouteRevisions.entrySet().stream() - .sorted(Map.Entry.comparingByKey(Comparator.comparing(NotificationRouteId::value))) - .forEach( - entry -> { - NotificationCatalogException.update(digest, "active"); - NotificationCatalogException.update(digest, entry.getKey().value()); - NotificationCatalogException.update(digest, entry.getValue()); - }); - return NotificationCatalogException.finish(digest); - } - - private static Map singletonActiveRevisions( - List routes) { - Objects.requireNonNull(routes, "notification routes must be non-null"); - Map active = new HashMap<>(); - routes.forEach( - route -> { - Objects.requireNonNull(route, "notification route entry is null"); - if (active.putIfAbsent(route.routeId(), route.routeRevision()) != null) { - throw new NotificationCatalogException( - "multiple retained route revisions require an explicit active revision map"); - } - }); - return Map.copyOf(active); - } - - private static void validateActiveRevisions( - List routes, - Map activeRouteRevisions) { - Set routeIds = - routes.stream() - .map(NotificationRouteDescriptor::routeId) - .collect(java.util.stream.Collectors.toUnmodifiableSet()); - if (!activeRouteRevisions.keySet().equals(routeIds)) { - throw new NotificationCatalogException( - "active route revision map must exactly match retained route IDs"); - } - activeRouteRevisions.forEach( - (routeId, revision) -> { - Objects.requireNonNull(routeId, "active route ID must be non-null"); - Objects.requireNonNull(revision, "active route revision must be non-null"); - if (routes.stream() - .noneMatch( - route -> route.routeId().equals(routeId) && route.routeRevision() == revision)) { - throw new NotificationCatalogException( - "active route revision does not exist in retained bindings"); - } - }); - } - - private static void updateRoute(MessageDigest digest, NotificationRouteDescriptor route) { - NotificationCatalogException.update(digest, route.routeId().value()); - NotificationCatalogException.update(digest, route.routeRevision()); - NotificationCatalogException.update(digest, route.channel().name()); - NotificationCatalogException.update(digest, route.mode().name()); - NotificationCatalogException.update(digest, route.admissionClass().name()); - NotificationCatalogException.update(digest, route.routeStrategy().name()); - NotificationCatalogException.update(digest, route.receiptRequired()); - NotificationCatalogException.update(digest, route.fallbackAfterIndeterminate()); - NotificationCatalogException.update(digest, route.maximumTargets()); - NotificationCatalogException.update(digest, route.maximumPhysicalAttempts()); - NotificationCatalogException.update(digest, route.maximumFallbackActivations()); - NotificationCatalogException.update(digest, route.maximumReconcileCalls()); - NotificationCatalogException.update(digest, route.maximumTotalProviderCalls()); - NotificationCatalogException.update(digest, route.perAttemptDeadline().toNanos()); - } - - private static List immutableCopy(String label, List source) { - Objects.requireNonNull(source, "notification " + label + " must be non-null"); - return source.stream() - .map(value -> Objects.requireNonNull(value, "notification " + label + " entry is null")) - .toList(); - } - - private static Map uniqueIndex(List values, Function key, String label) { - Map index = new HashMap<>(); - values.forEach( - value -> { - K itemKey = key.apply(value); - if (index.putIfAbsent(itemKey, value) != null) { - throw new NotificationCatalogException("duplicate " + label + ": " + itemKey); - } - }); - return Map.copyOf(index); - } - - /** Sorted immutable result and digest suitable for release evidence. */ - public static final class CompiledGraph { - - private final List bindings; - private final Map activeRouteRevisions; - private final String manifestDigest; - - private CompiledGraph( - List bindings, - Map activeRouteRevisions, - String manifestDigest) { - Objects.requireNonNull(bindings, "compiled notification bindings must be non-null"); - this.bindings = - bindings.stream() - .map(binding -> Objects.requireNonNull(binding, "compiled binding must be non-null")) - .sorted( - Comparator.comparing( - (CompiledNotificationBinding binding) -> - binding.route().routeId().value()) - .thenComparingInt(binding -> binding.route().routeRevision())) - .toList(); - this.activeRouteRevisions = - Map.copyOf( - Objects.requireNonNull( - activeRouteRevisions, "active route revisions must be non-null")); - this.manifestDigest = - NotificationCatalogException.requireDigest( - "notification graph manifest digest", manifestDigest); - } - - public List bindings() { - return bindings; - } - - public Map activeRouteRevisions() { - return activeRouteRevisions; - } - - public String manifestDigest() { - return manifestDigest; - } - - public CompiledNotificationBinding activeBinding(NotificationRouteId routeId) { - Objects.requireNonNull(routeId, "active notification route ID must be non-null"); - Integer revision = activeRouteRevisions.get(routeId); - if (revision == null) { - return null; - } - return bindings.stream() - .filter(binding -> binding.route().routeId().equals(routeId)) - .filter(binding -> binding.route().routeRevision() == revision) - .findFirst() - .orElseThrow( - () -> new IllegalStateException("active notification binding is not retained")); - } - - @Override - public boolean equals(Object other) { - return this == other - || (other instanceof CompiledGraph that - && bindings.equals(that.bindings) - && activeRouteRevisions.equals(that.activeRouteRevisions) - && manifestDigest.equals(that.manifestDigest)); - } - - @Override - public int hashCode() { - return Objects.hash(bindings, activeRouteRevisions, manifestDigest); - } - - @Override - public String toString() { - return "CompiledGraph[bindingCount=" - + bindings.size() - + ", activeRouteCount=" - + activeRouteRevisions.size() - + ", manifestDigest=" - + manifestDigest - + "]"; - } - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationCanonicalRouteCatalog.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationCanonicalRouteCatalog.java deleted file mode 100644 index 066b7a1d..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationCanonicalRouteCatalog.java +++ /dev/null @@ -1,124 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.catalog; - -import dev.caskeleton.application.notification.NotificationCanonicalWriterRouteSet; -import dev.caskeleton.application.notification.NotificationRouteId; -import java.security.MessageDigest; -import java.util.Comparator; -import java.util.HashSet; -import java.util.List; -import java.util.Map; -import java.util.Objects; -import java.util.Set; - -/** Retained key-only source of truth derived only from the compiled binding graph. */ -public final class NotificationCanonicalRouteCatalog { - - private final List routes; - - private NotificationCanonicalRouteCatalog(List routes) { - Objects.requireNonNull(routes, "canonical notification routes must be non-null"); - this.routes = - routes.stream() - .map(route -> Objects.requireNonNull(route, "canonical route key must be non-null")) - .sorted(Comparator.naturalOrder()) - .toList(); - if (this.routes.isEmpty() || this.routes.size() > 100) { - throw new IllegalArgumentException("canonical route catalog must contain 1..100 routes"); - } - if (new HashSet<>(this.routes).size() != this.routes.size()) { - throw new NotificationCatalogException("duplicate canonical route key"); - } - if (this.routes.stream().map(RouteKey::routeId).distinct().count() != this.routes.size()) { - throw new NotificationCatalogException("duplicate canonical route ID has multiple revisions"); - } - } - - public static NotificationCanonicalRouteCatalog fromCompiledGraph( - NotificationBindingCompiler.CompiledGraph graph) { - Objects.requireNonNull(graph, "compiled notification graph must be non-null"); - return new NotificationCanonicalRouteCatalog( - graph.activeRouteRevisions().entrySet().stream() - .map(entry -> new RouteKey(entry.getKey(), entry.getValue())) - .toList()); - } - - static NotificationCanonicalRouteCatalog fromRoutes(List routes) { - Objects.requireNonNull(routes, "notification route descriptors must be non-null"); - return new NotificationCanonicalRouteCatalog( - routes.stream() - .map( - route -> { - Objects.requireNonNull(route, "notification route descriptor must be non-null"); - return new RouteKey(route.routeId(), route.routeRevision()); - }) - .toList()); - } - - public List routes() { - return routes; - } - - public NotificationCanonicalWriterRouteSet toApplication( - Map predecessorGenerations) { - Objects.requireNonNull( - predecessorGenerations, "canonical predecessor generations must be non-null"); - if (!predecessorGenerations.keySet().equals(Set.copyOf(routes))) { - throw new NotificationCatalogException( - "canonical generation config must exactly match route catalog keys"); - } - return new NotificationCanonicalWriterRouteSet( - routes.stream() - .map( - route -> - new NotificationCanonicalWriterRouteSet.RouteRevision( - route.routeId(), - route.routeRevision(), - Objects.requireNonNull( - predecessorGenerations.get(route), - "predecessor generation must be non-null"))) - .toList()); - } - - public String digest() { - MessageDigest digest = NotificationCatalogException.sha256(); - routes.forEach( - route -> { - NotificationCatalogException.update(digest, route.routeId().value()); - NotificationCatalogException.update(digest, route.routeRevision()); - }); - return NotificationCatalogException.finish(digest); - } - - @Override - public boolean equals(Object other) { - return this == other - || (other instanceof NotificationCanonicalRouteCatalog that && routes.equals(that.routes)); - } - - @Override - public int hashCode() { - return routes.hashCode(); - } - - @Override - public String toString() { - return "NotificationCanonicalRouteCatalog[routes=" + routes + "]"; - } - - public record RouteKey(NotificationRouteId routeId, int routeRevision) - implements Comparable { - - public RouteKey { - Objects.requireNonNull(routeId, "canonical notification route ID must be non-null"); - if (routeRevision < 1 || routeRevision > 1_000_000) { - throw new IllegalArgumentException("canonical route revision must be in 1..1000000"); - } - } - - @Override - public int compareTo(RouteKey other) { - int routeOrder = routeId.value().compareTo(other.routeId.value()); - return routeOrder != 0 ? routeOrder : Integer.compare(routeRevision, other.routeRevision); - } - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationCatalogException.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationCatalogException.java deleted file mode 100644 index e7e5ef12..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationCatalogException.java +++ /dev/null @@ -1,70 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.catalog; - -import java.nio.ByteBuffer; -import java.nio.charset.StandardCharsets; -import java.security.MessageDigest; -import java.security.NoSuchAlgorithmException; -import java.util.HexFormat; - -/** Fail-closed error for an invalid checked-in notification catalog. */ -public final class NotificationCatalogException extends RuntimeException { - - private static final long serialVersionUID = 1L; - - public NotificationCatalogException(String message) { - super(message); - } - - static String requireSlug(String field, String value) { - if (value == null || !value.matches("[a-z][a-z0-9.-]{0,62}")) { - throw new IllegalArgumentException(field + " must match [a-z][a-z0-9.-]{0,62}"); - } - return value; - } - - static String requireOpaque(String field, String value) { - if (value == null || !value.matches("[A-Za-z0-9][A-Za-z0-9._:-]{0,127}")) { - throw new IllegalArgumentException( - field + " must contain 1..128 opaque identifier characters"); - } - return value; - } - - static String requireDigest(String field, String value) { - if (value == null || !value.matches("[0-9a-f]{64}")) { - throw new IllegalArgumentException(field + " must be a lowercase SHA-256 digest"); - } - return value; - } - - static MessageDigest sha256() { - try { - return MessageDigest.getInstance("SHA-256"); - } catch (NoSuchAlgorithmException unavailable) { - throw new IllegalStateException( - "SHA-256 must be available on every Java runtime", unavailable); - } - } - - static void update(MessageDigest digest, String value) { - byte[] encoded = value.getBytes(StandardCharsets.UTF_8); - digest.update(ByteBuffer.allocate(Integer.BYTES).putInt(encoded.length).array()); - digest.update(encoded); - } - - static void update(MessageDigest digest, int value) { - digest.update(ByteBuffer.allocate(Integer.BYTES).putInt(value).array()); - } - - static void update(MessageDigest digest, long value) { - digest.update(ByteBuffer.allocate(Long.BYTES).putLong(value).array()); - } - - static void update(MessageDigest digest, boolean value) { - digest.update((byte) (value ? 1 : 0)); - } - - static String finish(MessageDigest digest) { - return HexFormat.of().formatHex(digest.digest()); - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationCutoverRouteCatalog.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationCutoverRouteCatalog.java deleted file mode 100644 index 2fd0408d..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationCutoverRouteCatalog.java +++ /dev/null @@ -1,151 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.catalog; - -import dev.caskeleton.application.notification.NotificationCanonicalWriterRouteSet; -import dev.caskeleton.application.notification.NotificationWriterRouteSet; -import java.security.MessageDigest; -import java.util.Comparator; -import java.util.HashSet; -import java.util.List; -import java.util.Map; -import java.util.Objects; -import java.util.Optional; - -/** PRE-only legacy proof metadata decorating exactly the retained canonical route keys. */ -public record NotificationCutoverRouteCatalog( - NotificationCanonicalRouteCatalog canonical, List routes) { - - public NotificationCutoverRouteCatalog { - Objects.requireNonNull(canonical, "canonical route catalog must be non-null"); - Objects.requireNonNull(routes, "cutover route catalog must be non-null"); - routes = - routes.stream() - .map(route -> Objects.requireNonNull(route, "cutover route must be non-null")) - .sorted(Comparator.comparing(CutoverRoute::route)) - .toList(); - if (!routes.stream().map(CutoverRoute::route).toList().equals(canonical.routes())) { - throw new NotificationCatalogException( - "cutover route keys must exactly equal canonical route keys"); - } - List aliases = routes.stream().flatMap(route -> route.legacyAlias().stream()).toList(); - if (new HashSet<>(aliases).size() != aliases.size()) { - throw new NotificationCatalogException("cutover route contains duplicate legacy alias"); - } - } - - public NotificationWriterRouteSet toApplication( - Map predecessorGenerations) { - NotificationCanonicalWriterRouteSet applicationCanonical = - canonical.toApplication(predecessorGenerations); - Map< - NotificationCanonicalRouteCatalog.RouteKey, - NotificationCanonicalWriterRouteSet.RouteRevision> - routeIndex = - applicationCanonical.routes().stream() - .collect( - java.util.stream.Collectors.toUnmodifiableMap( - route -> - new NotificationCanonicalRouteCatalog.RouteKey( - route.routeId(), route.routeRevision()), - route -> route)); - return new NotificationWriterRouteSet( - applicationCanonical, - routes.stream() - .map( - route -> - new NotificationWriterRouteSet.RouteProfile( - routeIndex.get(route.route()), - route.legacyAlias(), - route.transportProfiles().stream() - .map(LegacyTransportProfile::toApplication) - .toList())) - .toList()); - } - - public String digest() { - MessageDigest digest = NotificationCatalogException.sha256(); - NotificationCatalogException.update(digest, canonical.digest()); - routes.forEach( - route -> { - NotificationCatalogException.update(digest, route.route().routeId().value()); - NotificationCatalogException.update(digest, route.route().routeRevision()); - NotificationCatalogException.update(digest, route.legacyAlias().orElse("")); - route - .transportProfiles() - .forEach( - profile -> { - NotificationCatalogException.update(digest, profile.profileId()); - NotificationCatalogException.update(digest, profile.proofClass().name()); - NotificationCatalogException.update(digest, profile.evidenceRevision()); - NotificationCatalogException.update(digest, profile.activeAdmissionProfile()); - NotificationCatalogException.update( - digest, profile.reviewedHardBoundEvidence()); - }); - }); - return NotificationCatalogException.finish(digest); - } - - public record CutoverRoute( - NotificationCanonicalRouteCatalog.RouteKey route, - Optional legacyAlias, - List transportProfiles) { - - public CutoverRoute { - Objects.requireNonNull(route, "cutover route key must be non-null"); - Objects.requireNonNull(legacyAlias, "legacy route alias container must be non-null"); - legacyAlias = - legacyAlias.map( - alias -> NotificationCatalogException.requireSlug("legacy route alias", alias)); - Objects.requireNonNull( - transportProfiles, "legacy transport profile registry must be non-null"); - transportProfiles = - transportProfiles.stream() - .map( - profile -> - Objects.requireNonNull(profile, "legacy transport profile must be non-null")) - .sorted(Comparator.comparing(LegacyTransportProfile::profileId)) - .toList(); - if (transportProfiles.isEmpty() || transportProfiles.size() > 8) { - throw new IllegalArgumentException( - "legacy transport profile registry must contain 1..8 entries"); - } - if (new HashSet<>(transportProfiles.stream().map(LegacyTransportProfile::profileId).toList()) - .size() - != transportProfiles.size()) { - throw new IllegalArgumentException( - "legacy transport profile registry contains duplicate profile"); - } - if (transportProfiles.stream().filter(LegacyTransportProfile::activeAdmissionProfile).count() - != 1) { - throw new IllegalArgumentException( - "legacy transport registry requires exactly one active admission profile"); - } - } - } - - public record LegacyTransportProfile( - String profileId, - NotificationWriterRouteSet.ProofClass proofClass, - String evidenceRevision, - boolean activeAdmissionProfile, - boolean reviewedHardBoundEvidence) { - - public LegacyTransportProfile { - profileId = - NotificationCatalogException.requireSlug("legacy transport profile ID", profileId); - Objects.requireNonNull(proofClass, "legacy transport proof class must be non-null"); - evidenceRevision = - NotificationCatalogException.requireSlug( - "legacy transport evidence revision", evidenceRevision); - if (proofClass == NotificationWriterRouteSet.ProofClass.HARD_BOUND_PROVEN - && !reviewedHardBoundEvidence) { - throw new IllegalArgumentException( - "HARD_BOUND_PROVEN requires reviewed integration evidence"); - } - } - - NotificationWriterRouteSet.TransportProfile toApplication() { - return new NotificationWriterRouteSet.TransportProfile( - profileId, proofClass, evidenceRevision, activeAdmissionProfile); - } - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationPlanAdapter.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationPlanAdapter.java deleted file mode 100644 index ddcab405..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationPlanAdapter.java +++ /dev/null @@ -1,86 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.catalog; - -import dev.caskeleton.application.notification.NotificationFrozenPlan; -import dev.caskeleton.application.notification.NotificationIntentDraft; -import dev.caskeleton.application.notification.NotificationKindPolicy; -import dev.caskeleton.application.notification.NotificationPlanPort; -import dev.caskeleton.application.notification.NotificationPlanningResult; -import dev.caskeleton.application.notification.NotificationReasonCode; -import java.util.Comparator; -import java.util.List; -import java.util.Locale; -import java.util.Objects; - -/** Converts a selected adapter-local binding to the application-owned immutable plan snapshot. */ -public final class NotificationPlanAdapter implements NotificationPlanPort { - - private static final NotificationReasonCode ROUTE_UNAVAILABLE = - new NotificationReasonCode("CATALOG_ROUTE_UNAVAILABLE"); - private static final NotificationReasonCode POLICY_MISMATCH = - new NotificationReasonCode("CATALOG_POLICY_MISMATCH"); - private static final NotificationReasonCode PARAMETERS_MISMATCH = - new NotificationReasonCode("CATALOG_PARAMETERS_MISMATCH"); - - private final NotificationBindingCompiler.CompiledGraph graph; - - public NotificationPlanAdapter(NotificationBindingCompiler.CompiledGraph graph) { - this.graph = Objects.requireNonNull(graph, "compiled notification graph must be non-null"); - } - - @Override - public NotificationPlanningResult plan(NotificationIntentDraft draft) { - Objects.requireNonNull(draft, "notification intent draft must be non-null"); - CompiledNotificationBinding binding = graph.activeBinding(draft.policy().routeId()); - if (binding == null) { - return new NotificationPlanningResult.CapabilityUnavailable(ROUTE_UNAVAILABLE); - } - if (!matchesPolicy(binding.route(), draft.policy())) { - return new NotificationPlanningResult.Rejected(POLICY_MISMATCH); - } - if (!binding.template().parameterNames().equals(draft.parameters().values().keySet())) { - return new NotificationPlanningResult.Rejected(PARAMETERS_MISMATCH); - } - - Locale locale = binding.template().selectLocale(draft.requestedLocale()); - List targets = - binding.targets().stream() - .sorted(Comparator.comparing(target -> target.target().targetId())) - .map( - target -> - new NotificationFrozenPlan.FrozenTarget( - binding.targets().stream() - .sorted(Comparator.comparing(item -> item.target().targetId())) - .toList() - .indexOf(target), - target.target().targetId(), - target.capabilityCard().cardId(), - target.runtimeProfile().bindingRevision(), - target.runtimeProfile().credentialGeneration())) - .toList(); - NotificationFrozenPlan.BindingSnapshot snapshot = - new NotificationFrozenPlan.BindingSnapshot( - binding.route().routeRevision(), - binding.bindingDigest(), - binding.template().checksum(), - binding.template().rendererRevision(), - targets, - binding.route().receiptRequired(), - binding.route().perAttemptDeadline()); - return new NotificationPlanningResult.Planned( - NotificationFrozenPlan.from(draft, locale, snapshot)); - } - - private static boolean matchesPolicy( - NotificationRouteDescriptor route, NotificationKindPolicy policy) { - return route.channel() == policy.channel() - && route.mode() == policy.mode() - && route.admissionClass() == policy.admissionClass() - && route.routeStrategy() == policy.routeStrategy() - && route.templateRef().equals(policy.templateRef()) - && route.maximumTargets() == policy.maxTargetsPerRecipient() - && route.maximumPhysicalAttempts() == policy.maxPhysicalAttemptsPerDelivery() - && route.maximumFallbackActivations() == policy.maxFallbackActivations() - && route.maximumReconcileCalls() == policy.maxReconcileCalls() - && route.maximumTotalProviderCalls() == policy.maxTotalProviderCallsPerIntent(); - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationProviderCapabilityCard.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationProviderCapabilityCard.java deleted file mode 100644 index 4eefb824..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationProviderCapabilityCard.java +++ /dev/null @@ -1,99 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.catalog; - -import dev.caskeleton.application.notification.NotificationChannel; -import dev.caskeleton.application.notification.NotificationMode; -import dev.caskeleton.application.notification.NotificationRouteStrategy; -import java.util.Objects; - -/** Closed, code-owned capability statement for one qualified provider protocol shape. */ -public record NotificationProviderCapabilityCard( - String cardId, - NotificationChannel channel, - NotificationMode mode, - NotificationRouteStrategy routeStrategy, - boolean receiptSupported, - boolean reconciliationSupported, - boolean hiddenRetriesControlled, - boolean terminalIndeterminatePossible, - int maximumTargets, - int maximumPhysicalAttempts, - int maximumReconcileCalls, - int maximumTotalProviderCalls, - int maximumPayloadBytes) { - - public NotificationProviderCapabilityCard { - cardId = NotificationCatalogException.requireSlug("provider capability card ID", cardId); - Objects.requireNonNull(channel, "provider capability channel must be non-null"); - Objects.requireNonNull(mode, "provider capability mode must be non-null"); - Objects.requireNonNull(routeStrategy, "provider capability route strategy must be non-null"); - if (maximumTargets < 1 - || maximumTargets > 16 - || maximumPhysicalAttempts < 1 - || maximumPhysicalAttempts > 10 - || maximumReconcileCalls < 0 - || maximumReconcileCalls > 10 - || maximumTotalProviderCalls < 1 - || maximumTotalProviderCalls > 64 - || maximumPayloadBytes < 1 - || maximumPayloadBytes > 10_000_000) { - throw new IllegalArgumentException("provider capability bounds are outside supported limits"); - } - if (!hiddenRetriesControlled) { - throw new IllegalArgumentException("provider capability must control hidden retries"); - } - } - - /** Returns one of the only three initially qualified provider capability cards. */ - public static NotificationProviderCapabilityCard initial(String cardId) { - return switch (cardId) { - case "slack-web-api-inline-single-local-v1" -> - new NotificationProviderCapabilityCard( - cardId, - NotificationChannel.SLACK, - NotificationMode.BEST_EFFORT_INLINE, - NotificationRouteStrategy.SINGLE, - false, - false, - true, - true, - 1, - 1, - 0, - 1, - 32_000); - case "slack-web-api-durable-single-local-v1" -> - new NotificationProviderCapabilityCard( - cardId, - NotificationChannel.SLACK, - NotificationMode.DURABLE_ASYNC, - NotificationRouteStrategy.SINGLE, - false, - false, - true, - true, - 1, - 1, - 0, - 1, - 32_000); - case "aws-ses-v2-durable-single-local-sns-v1" -> - new NotificationProviderCapabilityCard( - cardId, - NotificationChannel.EMAIL, - NotificationMode.DURABLE_ASYNC, - NotificationRouteStrategy.SINGLE, - true, - true, - true, - true, - 1, - 1, - 1, - 2, - 64_000); - default -> - throw new NotificationCatalogException( - "unknown initial provider capability card: " + cardId); - }; - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationProviderCapabilityDescriptorSource.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationProviderCapabilityDescriptorSource.java deleted file mode 100644 index a5f6322e..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationProviderCapabilityDescriptorSource.java +++ /dev/null @@ -1,43 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.catalog; - -import dev.caskeleton.application.notification.NotificationProviderCapabilityDescriptor; -import java.util.Comparator; -import java.util.List; -import java.util.Objects; -import java.util.Set; - -/** Derives application-owned actual capability facts from the compiled provider cards. */ -public final class NotificationProviderCapabilityDescriptorSource { - - private final List descriptors; - - public NotificationProviderCapabilityDescriptorSource( - NotificationBindingCompiler.CompiledGraph graph) { - Objects.requireNonNull(graph, "compiled notification graph must be non-null"); - this.descriptors = - graph.bindings().stream() - .flatMap(binding -> binding.targets().stream()) - .map(CompiledNotificationBinding.CompiledTarget::capabilityCard) - .distinct() - .sorted(Comparator.comparing(NotificationProviderCapabilityCard::cardId)) - .map(NotificationProviderCapabilityDescriptorSource::toApplication) - .toList(); - } - - public List descriptors() { - return descriptors; - } - - private static NotificationProviderCapabilityDescriptor toApplication( - NotificationProviderCapabilityCard card) { - return new NotificationProviderCapabilityDescriptor( - card.cardId(), - card.channel(), - Set.of(card.mode()), - card.receiptSupported(), - card.reconciliationSupported(), - card.hiddenRetriesControlled(), - card.maximumTargets(), - card.maximumPayloadBytes()); - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationProviderDescriptor.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationProviderDescriptor.java deleted file mode 100644 index 9ebffdeb..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationProviderDescriptor.java +++ /dev/null @@ -1,41 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.catalog; - -import dev.caskeleton.application.notification.NotificationChannel; -import java.util.Comparator; -import java.util.HashSet; -import java.util.List; -import java.util.Objects; - -/** Provider family descriptor; legacy fail-open providers deliberately have no canonical cards. */ -public record NotificationProviderDescriptor( - String providerId, - NotificationChannel channel, - boolean legacyFailOpen, - List capabilityCards) { - - public NotificationProviderDescriptor { - providerId = NotificationCatalogException.requireSlug("notification provider ID", providerId); - Objects.requireNonNull(channel, "notification provider channel must be non-null"); - Objects.requireNonNull(capabilityCards, "provider capability cards must be non-null"); - capabilityCards = - capabilityCards.stream() - .map(card -> Objects.requireNonNull(card, "provider capability card must be non-null")) - .sorted(Comparator.comparing(NotificationProviderCapabilityCard::cardId)) - .toList(); - if (new HashSet<>( - capabilityCards.stream().map(NotificationProviderCapabilityCard::cardId).toList()) - .size() - != capabilityCards.size()) { - throw new IllegalArgumentException("provider descriptor contains duplicate capability cards"); - } - if (legacyFailOpen && !capabilityCards.isEmpty()) { - throw new IllegalArgumentException("legacy provider cannot advertise canonical capability"); - } - if (!legacyFailOpen && capabilityCards.isEmpty()) { - throw new IllegalArgumentException("canonical provider must advertise a capability card"); - } - if (capabilityCards.stream().anyMatch(card -> card.channel() != channel)) { - throw new IllegalArgumentException("provider capability card channel must match provider"); - } - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationProviderRuntimeProfile.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationProviderRuntimeProfile.java deleted file mode 100644 index da9f2cd5..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationProviderRuntimeProfile.java +++ /dev/null @@ -1,45 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.catalog; - -/** Runtime indirection for secrets and destinations; sensitive references never leave this type. */ -public record NotificationProviderRuntimeProfile( - String profileId, - String providerId, - String bindingRevision, - String capabilityCardId, - String credentialGeneration, - String credentialReference, - String destinationReference) { - - public NotificationProviderRuntimeProfile { - profileId = NotificationCatalogException.requireSlug("provider runtime profile ID", profileId); - providerId = NotificationCatalogException.requireSlug("provider ID", providerId); - bindingRevision = - NotificationCatalogException.requireSlug("provider binding revision", bindingRevision); - capabilityCardId = - NotificationCatalogException.requireSlug("provider capability card ID", capabilityCardId); - credentialGeneration = - NotificationCatalogException.requireSlug( - "provider credential generation", credentialGeneration); - credentialReference = - NotificationCatalogException.requireOpaque( - "provider credential reference", credentialReference); - destinationReference = - NotificationCatalogException.requireOpaque( - "provider destination reference", destinationReference); - } - - @Override - public String toString() { - return "NotificationProviderRuntimeProfile[profileId=" - + profileId - + ", providerId=" - + providerId - + ", bindingRevision=" - + bindingRevision - + ", capabilityCardId=" - + capabilityCardId - + ", credentialGeneration=" - + credentialGeneration - + ", credentialReference=, destinationReference=]"; - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationRouteDescriptor.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationRouteDescriptor.java deleted file mode 100644 index e473bfa6..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationRouteDescriptor.java +++ /dev/null @@ -1,93 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.catalog; - -import dev.caskeleton.application.notification.NotificationAdmissionClass; -import dev.caskeleton.application.notification.NotificationChannel; -import dev.caskeleton.application.notification.NotificationMode; -import dev.caskeleton.application.notification.NotificationRouteId; -import dev.caskeleton.application.notification.NotificationRouteStrategy; -import dev.caskeleton.application.notification.NotificationTemplateRef; -import java.time.Duration; -import java.util.Comparator; -import java.util.HashSet; -import java.util.List; -import java.util.Objects; -import java.util.Optional; - -/** Provider-neutral route declaration compiled against explicit local catalogs. */ -public record NotificationRouteDescriptor( - NotificationRouteId routeId, - int routeRevision, - NotificationChannel channel, - NotificationMode mode, - NotificationAdmissionClass admissionClass, - NotificationRouteStrategy routeStrategy, - NotificationTemplateRef templateRef, - boolean receiptRequired, - boolean fallbackAfterIndeterminate, - int maximumTargets, - int maximumPhysicalAttempts, - int maximumFallbackActivations, - int maximumReconcileCalls, - int maximumTotalProviderCalls, - Duration perAttemptDeadline, - List targets) { - - public NotificationRouteDescriptor { - Objects.requireNonNull(routeId, "notification route ID must be non-null"); - if (routeRevision < 1 || routeRevision > 1_000_000) { - throw new IllegalArgumentException("notification route revision must be in 1..1000000"); - } - Objects.requireNonNull(channel, "notification route channel must be non-null"); - Objects.requireNonNull(mode, "notification route mode must be non-null"); - Objects.requireNonNull(admissionClass, "notification admission class must be non-null"); - Objects.requireNonNull(routeStrategy, "notification route strategy must be non-null"); - Objects.requireNonNull(templateRef, "notification template reference must be non-null"); - if (maximumTargets < 1 - || maximumTargets > 16 - || maximumPhysicalAttempts < 1 - || maximumPhysicalAttempts > 10 - || maximumFallbackActivations < 0 - || maximumFallbackActivations > 15 - || maximumReconcileCalls < 0 - || maximumReconcileCalls > 10 - || maximumTotalProviderCalls < 1 - || maximumTotalProviderCalls > 64) { - throw new IllegalArgumentException("notification route bounds are outside supported limits"); - } - Objects.requireNonNull(perAttemptDeadline, "per-attempt deadline must be non-null"); - if (perAttemptDeadline.isZero() - || perAttemptDeadline.isNegative() - || perAttemptDeadline.compareTo(Duration.ofMinutes(5)) > 0) { - throw new IllegalArgumentException( - "per-attempt deadline must be positive and at most five minutes"); - } - Objects.requireNonNull(targets, "notification route targets must be non-null"); - targets = - targets.stream() - .map(target -> Objects.requireNonNull(target, "notification target must be non-null")) - .sorted(Comparator.comparing(Target::targetId)) - .toList(); - if (targets.isEmpty() || targets.size() > 16) { - throw new IllegalArgumentException("notification route targets must contain 1..16 entries"); - } - if (new HashSet<>(targets.stream().map(Target::targetId).toList()).size() != targets.size()) { - throw new IllegalArgumentException("notification route contains duplicate target IDs"); - } - } - - /** One provider leg and optional next fallback leg. */ - public record Target( - String targetId, String runtimeProfileId, Optional fallbackTargetId) { - - public Target { - targetId = NotificationCatalogException.requireSlug("notification target ID", targetId); - runtimeProfileId = - NotificationCatalogException.requireSlug( - "notification runtime profile ID", runtimeProfileId); - Objects.requireNonNull(fallbackTargetId, "fallback target ID container must be non-null"); - fallbackTargetId = - fallbackTargetId.map( - value -> NotificationCatalogException.requireSlug("fallback target ID", value)); - } - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationTemplateDescriptor.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationTemplateDescriptor.java deleted file mode 100644 index b8d3e170..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationTemplateDescriptor.java +++ /dev/null @@ -1,81 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.catalog; - -import dev.caskeleton.application.notification.NotificationChannel; -import dev.caskeleton.application.notification.NotificationTemplateRef; -import java.util.Comparator; -import java.util.HashSet; -import java.util.Locale; -import java.util.Objects; -import java.util.Set; -import java.util.stream.Collectors; - -/** Immutable checked-in template manifest metadata used by the binding compiler. */ -public record NotificationTemplateDescriptor( - NotificationTemplateRef templateRef, - NotificationChannel channel, - String rendererRevision, - String checksum, - Set supportedLocales, - Locale fallbackLocale, - Set parameterNames, - int maximumRenderedBytes) { - - public NotificationTemplateDescriptor { - Objects.requireNonNull(templateRef, "notification template reference must be non-null"); - Objects.requireNonNull(channel, "notification template channel must be non-null"); - rendererRevision = - NotificationCatalogException.requireSlug( - "notification renderer revision", rendererRevision); - checksum = - NotificationCatalogException.requireDigest("notification template checksum", checksum); - Objects.requireNonNull(supportedLocales, "supported template locales must be non-null"); - supportedLocales = - supportedLocales.stream() - .map(locale -> requireLocale("supported template locale", locale)) - .sorted(Comparator.comparing(Locale::toLanguageTag)) - .collect(Collectors.toUnmodifiableSet()); - if (supportedLocales.isEmpty() || supportedLocales.size() > 32) { - throw new IllegalArgumentException("supported template locales must contain 1..32 entries"); - } - fallbackLocale = requireLocale("template fallback locale", fallbackLocale); - if (!supportedLocales.contains(fallbackLocale)) { - throw new IllegalArgumentException("template fallback locale must be supported"); - } - Objects.requireNonNull(parameterNames, "template parameter names must be non-null"); - parameterNames = - parameterNames.stream() - .map(NotificationTemplateDescriptor::requireParameterName) - .collect(Collectors.toUnmodifiableSet()); - if (parameterNames.size() > 32) { - throw new IllegalArgumentException("template parameter names exceed 32 entries"); - } - if (new HashSet<>(parameterNames).size() != parameterNames.size()) { - throw new IllegalArgumentException("template parameter names contain duplicates"); - } - if (maximumRenderedBytes < 1 || maximumRenderedBytes > 10_000_000) { - throw new IllegalArgumentException("maximum rendered bytes must be in 1..10000000"); - } - } - - Locale selectLocale(Locale requested) { - Locale normalized = requireLocale("requested template locale", requested); - return supportedLocales.contains(normalized) ? normalized : fallbackLocale; - } - - private static Locale requireLocale(String field, Locale locale) { - Objects.requireNonNull(locale, field + " must be non-null"); - String tag = locale.toLanguageTag(); - if (locale.equals(Locale.ROOT) || tag.equals("und") || tag.isBlank() || tag.length() > 35) { - throw new IllegalArgumentException(field + " must be an explicit bounded locale"); - } - return Locale.forLanguageTag(tag); - } - - private static String requireParameterName(String name) { - if (name == null || !name.matches("[a-z][A-Za-z0-9]{0,63}")) { - throw new IllegalArgumentException( - "template parameter name must match [a-z][A-Za-z0-9]{0,63}"); - } - return name; - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/core/FailOpenNotificationProvider.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/core/FailOpenNotificationProvider.java index 60b282fd..4558232e 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/core/FailOpenNotificationProvider.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/core/FailOpenNotificationProvider.java @@ -1,7 +1,7 @@ package dev.caskeleton.adapter.outbound.notification.core; import dev.caskeleton.adapter.outbound.support.FailOpenDependencyLogger; -import dev.caskeleton.application.notification.Channel; +import dev.caskeleton.application.notification.NotificationChannel; import dev.caskeleton.application.notification.Notification; /** @@ -23,7 +23,7 @@ public final class FailOpenNotificationProvider implements NotificationProvider } @Override - public Channel channel() { + public NotificationChannel channel() { return delegate.channel(); } diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/core/NotificationProvider.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/core/NotificationProvider.java index fae64a05..2569c513 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/core/NotificationProvider.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/core/NotificationProvider.java @@ -1,18 +1,18 @@ package dev.caskeleton.adapter.outbound.notification.core; -import dev.caskeleton.application.notification.Channel; +import dev.caskeleton.application.notification.NotificationChannel; import dev.caskeleton.application.notification.Notification; /** * SPI a forking project contributes to bind the notification template to a real provider for a - * given {@link Channel}. Each provider registers a bean of this type. {@link #providerId()} is the + * given {@link NotificationChannel}. Each provider registers a bean of this type. {@link #providerId()} is the * identifier referenced by {@code app.notification.routes..=[,]} values and * must be unique within a channel. */ public interface NotificationProvider { - /** The channel this provider delivers to (e.g. {@link Channel#EMAIL}). */ - Channel channel(); + /** The channel this provider delivers to (e.g. {@link NotificationChannel#EMAIL}). */ + NotificationChannel channel(); /** * Stable provider id referenced by {@code app.notification.routes.*}; unique within a channel. diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/core/RoutingNotifier.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/core/RoutingNotifier.java index 1fc3ed6b..97fb8a3d 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/core/RoutingNotifier.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/core/RoutingNotifier.java @@ -1,6 +1,6 @@ package dev.caskeleton.adapter.outbound.notification.core; -import dev.caskeleton.application.notification.Channel; +import dev.caskeleton.application.notification.NotificationChannel; import dev.caskeleton.application.notification.Notification; import dev.caskeleton.application.notification.NotificationPort; import dev.caskeleton.shared.error.AdapterDisabledException; @@ -25,13 +25,13 @@ public final class RoutingNotifier implements NotificationPort { private static final String ADAPTER_NAME = "notification"; - private final Map> registry; + private final Map> registry; - private final Map>> routes; + private final Map>> routes; public RoutingNotifier( Collection providers, - Map>> routes) { + Map>> routes) { this.registry = buildRegistry(providers); validateRoutes(routes, this.registry); this.routes = immutableRoutesCopy(routes); @@ -41,9 +41,9 @@ public final class RoutingNotifier implements NotificationPort { * Indexes contributed providers by {@code (channel, providerId)}. A duplicate providerId within a * channel fails at construction (boot). */ - private static Map> buildRegistry( + private static Map> buildRegistry( Collection providers) { - Map> registry = new EnumMap<>(Channel.class); + Map> registry = new EnumMap<>(NotificationChannel.class); for (FailOpenNotificationProvider provider : providers) { Map byId = registry.computeIfAbsent(provider.channel(), ch -> new HashMap<>()); @@ -58,8 +58,8 @@ public final class RoutingNotifier implements NotificationPort { + " unique providerId within its channel"); } } - Map> immutable = - new EnumMap<>(Channel.class); + Map> immutable = + new EnumMap<>(NotificationChannel.class); registry.forEach((channel, byId) -> immutable.put(channel, Map.copyOf(byId))); return Map.copyOf(immutable); } @@ -70,10 +70,10 @@ public final class RoutingNotifier implements NotificationPort { * only on the channel. */ private static void validateRoutes( - Map>> routes, - Map> registry) { - for (Map.Entry>> channelEntry : routes.entrySet()) { - Channel channel = channelEntry.getKey(); + Map>> routes, + Map> registry) { + for (Map.Entry>> channelEntry : routes.entrySet()) { + NotificationChannel channel = channelEntry.getKey(); Map channelRegistry = registry.getOrDefault(channel, Map.of()); for (Map.Entry> routeEntry : channelEntry.getValue().entrySet()) { @@ -97,9 +97,9 @@ public final class RoutingNotifier implements NotificationPort { } /** Deep, immutable copy of the routes map (channel → route → providerId list). */ - private static Map>> immutableRoutesCopy( - Map>> routes) { - Map>> immutable = new EnumMap<>(Channel.class); + private static Map>> immutableRoutesCopy( + Map>> routes) { + Map>> immutable = new EnumMap<>(NotificationChannel.class); routes.forEach( (channel, routeMap) -> { Map> copy = new HashMap<>(); @@ -110,7 +110,7 @@ public final class RoutingNotifier implements NotificationPort { } @Override - public void notify(Channel channel, String route, Notification notification) { + public void notify(NotificationChannel channel, String route, Notification notification) { List providerIds = resolveRoute(channel, route); Map channelRegistry = registry.getOrDefault(channel, Map.of()); @@ -122,7 +122,7 @@ public final class RoutingNotifier implements NotificationPort { } } - private List resolveRoute(Channel channel, String route) { + private List resolveRoute(NotificationChannel channel, String route) { Map> channelRoutes = routes.get(channel); if (channelRoutes == null || !channelRoutes.containsKey(route)) { throw new AdapterDisabledException( diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/email/google/GoogleEmailProvider.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/email/google/GoogleEmailProvider.java index 69e42abe..124f2976 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/email/google/GoogleEmailProvider.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/email/google/GoogleEmailProvider.java @@ -1,11 +1,11 @@ package dev.caskeleton.adapter.outbound.notification.email.google; import dev.caskeleton.adapter.outbound.notification.core.NotificationProvider; -import dev.caskeleton.application.notification.Channel; +import dev.caskeleton.application.notification.NotificationChannel; import dev.caskeleton.application.notification.Notification; /** - * Google Email contribution of the {@link NotificationProvider} SPI (channel {@link Channel#EMAIL}, + * Google Email contribution of the {@link NotificationProvider} SPI (channel {@link NotificationChannel#EMAIL}, * providerId {@code "google-email"}). Delegates the raw send to the project-supplied {@link * GoogleEmailClient} seam; the fail-open policy and PII-safe logging are applied centrally by * {@link dev.caskeleton.adapter.outbound.notification.core.FailOpenNotificationProvider}, not here @@ -25,8 +25,8 @@ public class GoogleEmailProvider implements NotificationProvider { } @Override - public Channel channel() { - return Channel.EMAIL; + public NotificationChannel channel() { + return NotificationChannel.EMAIL; } @Override diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/AssembledProvider.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/AssembledProvider.java index 928df24c..6c0ba6fc 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/AssembledProvider.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/AssembledProvider.java @@ -1,8 +1,8 @@ package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackAdapter; import dev.caskeleton.adapter.outbound.notification.platform.dispatch.ProviderRuntime; import dev.caskeleton.application.notification.platform.api.routing.Channel; -import dev.caskeleton.application.notification.platform.callback.ProviderCallbackAdapter; import dev.caskeleton.application.notification.platform.callback.ProviderEventProjector; import dev.caskeleton.application.notification.platform.provider.ReconciliationCapability; import java.util.Objects; diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationCallbackProviderConfig.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationCallbackProviderConfig.java new file mode 100644 index 00000000..2a44e27f --- /dev/null +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationCallbackProviderConfig.java @@ -0,0 +1,73 @@ +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; + +import dev.caskeleton.adapter.outbound.notification.platform.provider.http.NotificationHttpGateway; +import dev.caskeleton.adapter.outbound.notification.platform.provider.http.NotificationHttpRequest; +import dev.caskeleton.adapter.outbound.notification.platform.provider.ses.SnsCertificateProvider; +import java.io.ByteArrayInputStream; +import java.net.URI; +import java.security.PublicKey; +import java.security.cert.CertificateException; +import java.security.cert.CertificateFactory; +import java.security.cert.X509Certificate; +import java.time.Duration; +import java.util.Map; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.ConcurrentMap; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +/** Provider-side callback verification contributors. */ +@Configuration(proxyBeanMethods = false) +@ConditionalOnProperty( + prefix = "ca-skeleton.notification.platform", + name = "enabled", + havingValue = "true") +class NotificationCallbackProviderConfig { + + /** + * Default SNS certificate source, using the same bounded, no-redirect HTTP gateway as providers. + */ + @Bean + @ConditionalOnMissingBean + public SnsCertificateProvider snsCertificateProvider(NotificationHttpGateway gateway) { + return new SnsCertificateProvider() { + private final ConcurrentMap cache = new ConcurrentHashMap<>(); + + @Override + public PublicKey publicKeyFor(URI certificateUrl) { + return cache.computeIfAbsent( + certificateUrl, + uri -> { + var response = + gateway.exchange( + new NotificationHttpRequest( + "GET", uri, Map.of(), new byte[0], Duration.ofSeconds(3))); + if (!response.isSuccessful()) { + throw new IllegalStateException( + "SNS signing certificate fetch failed with HTTP " + response.statusCode()); + } + try { + X509Certificate certificate = + (X509Certificate) + CertificateFactory.getInstance("X.509") + .generateCertificate(new ByteArrayInputStream(response.body())); + return certificate.getPublicKey(); + } catch (CertificateException malformed) { + throw new IllegalArgumentException( + "SNS signing certificate is not valid X.509", malformed); + } + }); + } + }; + } + + /** SES callback contribution, independently available to an INGEST_ONLY deployment. */ + @Bean + @ConditionalOnMissingBean(name = "sesProviderCallbackAssembler") + public ProviderCallbackAssembler sesProviderCallbackAssembler( + SnsCertificateProvider certificates) { + return new SesProviderCallbackAssembler(certificates); + } +} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/observation/NotificationHealthEndpoint.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationHealthEndpoint.java similarity index 95% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/observation/NotificationHealthEndpoint.java rename to src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationHealthEndpoint.java index 889be11a..e1922006 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/observation/NotificationHealthEndpoint.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationHealthEndpoint.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.notification.observation; +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; import dev.caskeleton.adapter.outbound.notification.platform.observation.NotificationHealthReporter; import dev.caskeleton.adapter.outbound.notification.platform.observation.NotificationHealthSnapshot; @@ -26,7 +26,7 @@ import org.springframework.boot.health.contributor.HealthIndicator; * is public. */ @Endpoint(id = "notifications") -public class NotificationHealthEndpoint implements HealthIndicator { +class NotificationHealthEndpoint implements HealthIndicator { private final NotificationHealthReporter reporter; diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/observation/NotificationObservationContext.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationObservationContext.java similarity index 96% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/observation/NotificationObservationContext.java rename to src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationObservationContext.java index 064db3cf..8f6bba28 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/observation/NotificationObservationContext.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationObservationContext.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.notification.observation; +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; import io.micrometer.observation.Observation; import java.util.LinkedHashMap; @@ -20,7 +20,7 @@ import java.util.Optional; * caller-supplied template name is unbounded by construction, so an unregistered one is dropped * rather than tagged. */ -public final class NotificationObservationContext extends Observation.Context { +final class NotificationObservationContext extends Observation.Context { private final String channel; private final String provider; diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/observation/NotificationObservationConvention.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationObservationConvention.java similarity index 97% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/observation/NotificationObservationConvention.java rename to src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationObservationConvention.java index 44a1da60..0d6a51c0 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/observation/NotificationObservationConvention.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationObservationConvention.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.notification.observation; +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; import dev.caskeleton.application.notification.platform.observation.CardinalityGuard; import io.micrometer.common.KeyValue; @@ -25,7 +25,7 @@ import java.util.Objects; * callback schedule rather than anything the platform did. {@link #callbackObservation} therefore * starts a root observation and records the originating trace as a link. */ -public final class NotificationObservationConvention +final class NotificationObservationConvention implements ObservationConvention { /** Observation name for a dispatch attempt. */ diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformAutoConfiguration.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformAutoConfiguration.java index c114dfcd..a32993a8 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformAutoConfiguration.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformAutoConfiguration.java @@ -1,118 +1,34 @@ package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; -import dev.caskeleton.adapter.outbound.notification.platform.provider.http.JdkNotificationHttpGateway; -import dev.caskeleton.adapter.outbound.notification.platform.provider.http.NotificationHttpGateway; -import dev.caskeleton.adapter.outbound.notification.platform.security.AesGcmContactPointProtector; -import dev.caskeleton.adapter.outbound.notification.platform.template.JacksonNotificationVariablesCodec; -import dev.caskeleton.adapter.outbound.notification.platform.template.JsonSchemaVariableValidator; -import dev.caskeleton.adapter.outbound.notification.platform.template.NotificationTemplateEngine; -import dev.caskeleton.adapter.outbound.notification.platform.template.PlaceholderTemplateEngine; -import dev.caskeleton.adapter.outbound.notification.platform.template.Sha256MessageDigestAdapter; -import dev.caskeleton.adapter.outbound.notification.platform.template.ThymeleafStringTemplateEngine; -import dev.caskeleton.application.notification.platform.dispatch.MessageDigestPort; -import dev.caskeleton.application.notification.platform.dispatch.NotificationVariablesCodecPort; -import dev.caskeleton.application.notification.platform.security.ContactPointProtector; -import dev.caskeleton.application.notification.platform.security.SecretMaterialProvider; -import dev.caskeleton.application.notification.platform.template.TemplateVariableValidator; -import java.time.Duration; -import org.springframework.beans.factory.annotation.Value; -import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import dev.caskeleton.adapter.outbound.notification.NotificationConfig; +import dev.caskeleton.adapter.outbound.notification.NotificationRoutesSettings; +import dev.caskeleton.adapter.outbound.notification.email.google.GoogleEmailNotificationAdapterConfig; +import dev.caskeleton.adapter.outbound.notification.slack.webhook.SlackNotificationAdapterConfig; +import org.springframework.boot.autoconfigure.AutoConfiguration; import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; import org.springframework.boot.context.properties.EnableConfigurationProperties; -import org.springframework.context.annotation.Bean; -import org.springframework.context.annotation.Configuration; +import org.springframework.context.annotation.Import; /** - * Notification platform wiring. + * Boot entry point for the Notification capability. * - *

Everything is opt-in and conditional. The platform contributes no beans unless it is enabled, - * and the contact point protector only appears once a secret provider exists — because a protector - * without keys would fail on the first delivery instead of at startup. + *

The reusable Notification leaf owns its Spring composition. The application composition root + * only decides whether this artifact is present; runtime activation stays on the existing {@code + * ca-skeleton.notification.platform.enabled} switch. */ -@Configuration(proxyBeanMethods = false) -@EnableConfigurationProperties(NotificationPlatformSettings.class) +@AutoConfiguration @ConditionalOnProperty( prefix = "ca-skeleton.notification.platform", name = "enabled", havingValue = "true") -public class NotificationPlatformAutoConfiguration { - - /** Canonical variables codec. */ - @Bean - @ConditionalOnMissingBean - public NotificationVariablesCodecPort notificationVariablesCodec() { - return new JacksonNotificationVariablesCodec(); - } - - /** Request fingerprint hashing. */ - @Bean - @ConditionalOnMissingBean - public MessageDigestPort notificationMessageDigest() { - return new Sha256MessageDigestAdapter(); - } - - /** JSON Schema 2020-12 variable validation. */ - @Bean - @ConditionalOnMissingBean - public TemplateVariableValidator notificationTemplateVariableValidator() { - return new JsonSchemaVariableValidator(); - } - - /** - * Template engine, defaulting to the deterministic placeholder substitution. - * - *

Thymeleaf is the opt-in alternative: it escapes by default, which matters for HTML email - * bodies built from application input. The default stays the placeholder engine because it has no - * expression evaluator at all, and an unknown engine name fails the boot rather than quietly - * falling back — a deployment that thought it had escaping and did not is the worse outcome. - */ - @Bean - @ConditionalOnMissingBean - public NotificationTemplateEngine notificationTemplateEngine( - @Value("${ca-skeleton.notification.platform.template.engine:placeholder}") String engine) { - return switch (engine.toLowerCase(java.util.Locale.ROOT)) { - case "placeholder" -> new PlaceholderTemplateEngine(); - case "thymeleaf" -> new ThymeleafStringTemplateEngine(); - default -> - throw new IllegalArgumentException( - "ca-skeleton.notification.platform.template.engine must be" - + " 'placeholder' or 'thymeleaf', not '" - + engine - + "'"); - }; - } - - /** - * Contact point protection. - * - *

{@code @ConditionalOnBean(SecretMaterialProvider.class)} used to guard this, to express - * "only once key material is available". It does not express that. This is a plain - * {@code @Configuration} imported by a root, so the condition is evaluated while configurations - * are still being parsed and answers according to what happens to be registered at that moment — - * and the secret provider is declared by a sibling configuration the same root imports. The - * answer was "absent", so the bean vanished and the application failed on an unsatisfied - * dependency several layers away, in the deployment that first assembled the platform for real. - * - *

Nothing is lost by dropping it. Both configurations are reached only through the same root - * under the same master switch, so the provider exists whenever this does — and a deployment - * missing key material already fails at the provider itself, at startup, naming the purpose whose - * key is missing. That is a better failure than a bean quietly not being created. - */ - @Bean - @ConditionalOnMissingBean - public ContactPointProtector notificationContactPointProtector(SecretMaterialProvider secrets) { - return new AesGcmContactPointProtector(secrets); - } - - /** - * Default provider transport. - * - *

Replaced in the composition root when the HTTP Client Platform is bound, which is the - * supported way to reuse its TLS, circuit-breaker and SSRF policy. - */ - @Bean - @ConditionalOnMissingBean - public NotificationHttpGateway notificationHttpGateway() { - return new JdkNotificationHttpGateway(Duration.ofSeconds(2)); - } -} +@EnableConfigurationProperties(NotificationRoutesSettings.class) +@Import({ + NotificationPlatformCoreConfig.class, + NotificationPlatformRuntimeConfig.class, + NotificationPlatformSecretsConfig.class, + NotificationPlatformRegistriesConfig.class, + NotificationConfig.class, + SlackNotificationAdapterConfig.class, + GoogleEmailNotificationAdapterConfig.class +}) +public class NotificationPlatformAutoConfiguration {} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformCodecConfig.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformCodecConfig.java similarity index 96% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformCodecConfig.java rename to src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformCodecConfig.java index 633ed21c..9d506220 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformCodecConfig.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformCodecConfig.java @@ -1,6 +1,5 @@ -package dev.caskeleton.bootstrap.autoconfigure.notification; +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; -import dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationPlatformSettings; import dev.caskeleton.adapter.outbound.notification.platform.dispatch.JacksonRoutingPlanCodec; import dev.caskeleton.adapter.outbound.notification.platform.dispatch.SingleTenantContext; import dev.caskeleton.adapter.outbound.notification.platform.dispatch.UuidV7Generator; @@ -41,7 +40,7 @@ import org.springframework.context.annotation.Configuration; prefix = "ca-skeleton.notification.platform", name = "enabled", havingValue = "true") -public class NotificationPlatformCodecConfig { +class NotificationPlatformCodecConfig { /** Time-ordered identifiers for every notification row. */ @Bean diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformCoreConfig.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformCoreConfig.java new file mode 100644 index 00000000..0324f430 --- /dev/null +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformCoreConfig.java @@ -0,0 +1,106 @@ +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; + +import dev.caskeleton.adapter.outbound.notification.platform.provider.http.JdkNotificationHttpGateway; +import dev.caskeleton.adapter.outbound.notification.platform.provider.http.NotificationHttpGateway; +import dev.caskeleton.adapter.outbound.notification.platform.security.AesGcmContactPointProtector; +import dev.caskeleton.adapter.outbound.notification.platform.template.JacksonNotificationVariablesCodec; +import dev.caskeleton.adapter.outbound.notification.platform.template.JsonSchemaVariableValidator; +import dev.caskeleton.adapter.outbound.notification.platform.template.NotificationTemplateEngine; +import dev.caskeleton.adapter.outbound.notification.platform.template.PlaceholderTemplateEngine; +import dev.caskeleton.adapter.outbound.notification.platform.template.Sha256MessageDigestAdapter; +import dev.caskeleton.application.notification.platform.dispatch.MessageDigestPort; +import dev.caskeleton.application.notification.platform.dispatch.NotificationVariablesCodecPort; +import dev.caskeleton.application.notification.platform.security.ContactPointProtector; +import dev.caskeleton.application.notification.platform.security.SecretMaterialProvider; +import dev.caskeleton.application.notification.platform.template.TemplateVariableValidator; +import java.time.Duration; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +/** + * Internal notification platform core wiring. + * + *

Everything is opt-in and conditional. The platform contributes no beans unless it is enabled, + * and the contact point protector only appears once a secret provider exists — because a protector + * without keys would fail on the first delivery instead of at startup. + */ +@Configuration(proxyBeanMethods = false) +@EnableConfigurationProperties(NotificationPlatformSettings.class) +@ConditionalOnProperty( + prefix = "ca-skeleton.notification.platform", + name = "enabled", + havingValue = "true") +class NotificationPlatformCoreConfig { + + /** Canonical variables codec. */ + @Bean + @ConditionalOnMissingBean + public NotificationVariablesCodecPort notificationVariablesCodec() { + return new JacksonNotificationVariablesCodec(); + } + + /** Request fingerprint hashing. */ + @Bean + @ConditionalOnMissingBean + public MessageDigestPort notificationMessageDigest() { + return new Sha256MessageDigestAdapter(); + } + + /** JSON Schema 2020-12 variable validation. */ + @Bean + @ConditionalOnMissingBean + public TemplateVariableValidator notificationTemplateVariableValidator() { + return new JsonSchemaVariableValidator(); + } + + /** + * Safe default template engine. + * + *

The shipped configuration deliberately exposes no property that turns database template text + * into an expression language. The placeholder engine performs bounded name substitution only. An + * application that deliberately supplies another {@link NotificationTemplateEngine} bean owns + * that engine's trust model and review burden explicitly in code. + */ + @Bean + @ConditionalOnMissingBean + public NotificationTemplateEngine notificationTemplateEngine() { + return new PlaceholderTemplateEngine(); + } + + /** + * Contact point protection. + * + *

{@code @ConditionalOnBean(SecretMaterialProvider.class)} used to guard this, to express + * "only once key material is available". It does not express that. This is a plain + * {@code @Configuration} imported by a root, so the condition is evaluated while configurations + * are still being parsed and answers according to what happens to be registered at that moment — + * and the secret provider is declared by a sibling configuration the same root imports. The + * answer was "absent", so the bean vanished and the application failed on an unsatisfied + * dependency several layers away, in the deployment that first assembled the platform for real. + * + *

Nothing is lost by dropping it. Both configurations are reached only through the same root + * under the same master switch, so the provider exists whenever this does — and a deployment + * missing key material already fails at the provider itself, at startup, naming the purpose whose + * key is missing. That is a better failure than a bean quietly not being created. + */ + @Bean + @ConditionalOnMissingBean + public ContactPointProtector notificationContactPointProtector(SecretMaterialProvider secrets) { + return new AesGcmContactPointProtector(secrets); + } + + /** + * Default provider transport. + * + *

Replaced in the composition root when the HTTP Client Platform is bound, which is the + * supported way to reuse its TLS, circuit-breaker and SSRF policy. + */ + @Bean + @ConditionalOnMissingBean + public NotificationHttpGateway notificationHttpGateway() { + return new JdkNotificationHttpGateway(Duration.ofSeconds(2)); + } +} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformDispatchConfig.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformDispatchConfig.java new file mode 100644 index 00000000..748cccfc --- /dev/null +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformDispatchConfig.java @@ -0,0 +1,158 @@ +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; + +import dev.caskeleton.adapter.outbound.notification.platform.dispatch.NotificationDispatchProperties; +import dev.caskeleton.adapter.outbound.notification.platform.dispatch.ProviderRuntimeRegistry; +import dev.caskeleton.application.notification.platform.callback.ProviderEventLedger; +import dev.caskeleton.application.notification.platform.callback.ProviderEventProjectionService; +import dev.caskeleton.application.notification.platform.dispatch.ContactPointStorePort; +import dev.caskeleton.application.notification.platform.dispatch.DeliveryAttemptFactory; +import dev.caskeleton.application.notification.platform.dispatch.DeliveryAttemptStorePort; +import dev.caskeleton.application.notification.platform.dispatch.DispatchOutcomeRecorder; +import dev.caskeleton.application.notification.platform.dispatch.DispatchPipeline; +import dev.caskeleton.application.notification.platform.dispatch.NotificationIdGeneratorPort; +import dev.caskeleton.application.notification.platform.dispatch.RecipientDeliveryStorePort; +import dev.caskeleton.application.notification.platform.dispatch.ReconciliationGatewayPort; +import dev.caskeleton.application.notification.platform.dispatch.ReconciliationService; +import dev.caskeleton.application.notification.platform.dispatch.SyntheticEventFingerprint; +import dev.caskeleton.application.notification.platform.observation.NotificationAuditPort; +import dev.caskeleton.application.notification.platform.observation.NotificationMetricsPort; +import dev.caskeleton.application.notification.platform.policy.NotificationEligibilityPolicy; +import java.time.Clock; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +/** + * Submission, dispatch and the services that record what happened. + * + *

The path a notification travels once it has been accepted, and the callback and reconciliation + * services that correct the record afterwards. + * + *

Split out of one 690-line composition class holding 42 beans. A configuration that assembles + * codecs, security, templates, policy, providers and workers at once has no boundary a reader can + * use: every change to any of them is a change to the same file, and nothing states which beans + * belong together (NTF-022). + */ +@Configuration(proxyBeanMethods = false) +@ConditionalOnProperty( + prefix = "ca-skeleton.notification.platform", + name = "enabled", + havingValue = "true") +class NotificationPlatformDispatchConfig { + /** + * The operator plane, and the narrow port it reaches runtimes through. + * + *

Neither had a bean. The admin service existed in the outbound adapter, fully written, doing + * authorization and transaction orchestration, and nothing constructed it — so every operator + * capability the platform documented was unreachable. + * + * @param runtimes the provider runtime registry + * @return the control port + */ + @Bean + public dev.caskeleton.application.notification.platform.admin.ProviderRuntimeControlPort + providerRuntimeControl(ProviderRuntimeRegistry runtimes) { + return new dev.caskeleton.adapter.outbound.notification.platform.dispatch + .RegistryProviderRuntimeControl(runtimes); + } + + /** + * Operator authority, tenant scope and duplicate-risk approval. + * + * @return the guard + */ + @Bean + public dev.caskeleton.application.notification.platform.admin.AdminAuthorizationGuard + adminAuthorizationGuard() { + return new dev.caskeleton.application.notification.platform.admin.AdminAuthorizationGuard(); + } + + /** + * The approval an ambiguous redrive requires. + * + * @return the guard + */ + @Bean + public dev.caskeleton.application.notification.platform.admin.DuplicateRiskGuard + duplicateRiskGuard() { + return new dev.caskeleton.application.notification.platform.admin.DuplicateRiskGuard(); + } + + /** Pre-provider guard chain. */ + @Bean + public DispatchPipeline dispatchPipeline( + ContactPointStorePort contactPoints, + NotificationEligibilityPolicy eligibility, + NotificationMetricsPort metrics) { + return new DispatchPipeline(contactPoints, eligibility, metrics); + } + + /** Attempt row factory. */ + @Bean + public DeliveryAttemptFactory deliveryAttemptFactory(NotificationIdGeneratorPort ids) { + return new DeliveryAttemptFactory(ids); + } + + /** Outcome recorder. */ + @Bean + public DispatchOutcomeRecorder dispatchOutcomeRecorder( + DeliveryAttemptStorePort attempts, + RecipientDeliveryStorePort recipients, + dev.caskeleton.application.notification.platform.dispatch.ReconciliationJobStorePort + reconciliationJobs, + dev.caskeleton.application.notification.platform.callback.ProviderEventLedger ledger, + dev.caskeleton.application.notification.platform.callback.ProviderEventProjectionService + projection, + NotificationMetricsPort metrics, + NotificationDispatchProperties properties) { + return new DispatchOutcomeRecorder( + attempts, + recipients, + reconciliationJobs, + ledger, + projection, + metrics, + properties.leaseDuration()); + } + + /** Dispatch runtime bounds. */ + @Bean + @ConditionalOnMissingBean + public NotificationDispatchProperties notificationDispatchProperties( + NotificationPlatformSettings settings) { + return new NotificationDispatchProperties( + settings.dispatch().claimBatchSize(), + settings.dispatch().leaseDuration(), + settings.dispatch().pollInterval(), + settings.dispatch().maxGlobalConcurrency(), + settings.dispatch().maxAdditionalAttempts(), + settings.dispatch().estimatedDispatchDuration(), + settings.dispatch().maxQueueAge(), + settings.dispatch().shutdownGrace()); + } + + /** Provider status correction. */ + @Bean + public ReconciliationService reconciliationService( + DeliveryAttemptStorePort attempts, + RecipientDeliveryStorePort recipients, + ReconciliationGatewayPort gateway, + ProviderEventLedger ledger, + ProviderEventProjectionService projection, + NotificationAuditPort audit, + NotificationMetricsPort metrics, + SyntheticEventFingerprint syntheticEventFingerprints, + Clock clock) { + return new ReconciliationService( + attempts, + recipients, + gateway, + ledger, + projection, + audit, + metrics, + syntheticEventFingerprints, + clock); + } +} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformObservabilityConfig.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformObservabilityConfig.java similarity index 89% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformObservabilityConfig.java rename to src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformObservabilityConfig.java index ca081a5c..1fc59ecc 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformObservabilityConfig.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformObservabilityConfig.java @@ -1,7 +1,5 @@ -package dev.caskeleton.bootstrap.autoconfigure.notification; +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; -import dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationPlatformSettings; -import dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationProviderAssembly; import dev.caskeleton.adapter.outbound.notification.platform.dispatch.LoggingInboxSignalPublisher; import dev.caskeleton.adapter.outbound.notification.platform.dispatch.ProviderRuntimeRegistry; import dev.caskeleton.adapter.outbound.notification.platform.observation.LoggingNotificationAudit; @@ -16,8 +14,6 @@ import dev.caskeleton.application.notification.platform.observation.Notification import dev.caskeleton.application.notification.platform.observation.NotificationMetricsPort; import dev.caskeleton.application.notification.platform.observation.NotificationSecurityAuditPort; import dev.caskeleton.application.notification.platform.observation.NotificationServingStatePort; -import dev.caskeleton.bootstrap.autoconfigure.notification.observation.NotificationHealthEndpoint; -import dev.caskeleton.bootstrap.autoconfigure.notification.observation.NotificationObservationConvention; import org.springframework.beans.factory.ObjectProvider; import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; @@ -40,7 +36,7 @@ import org.springframework.context.annotation.Configuration; prefix = "ca-skeleton.notification.platform", name = "enabled", havingValue = "true") -public class NotificationPlatformObservabilityConfig { +class NotificationPlatformObservabilityConfig { /** Metric tag guard. */ @Bean @@ -82,12 +78,20 @@ public class NotificationPlatformObservabilityConfig { NotificationPlatformSettings settings, NotificationProviderAssembly.AssembledPlatform platform, NotificationServingStatePort servingState) { + NotificationPlatformSettings.ServingThresholds thresholds = settings.servingThresholds(); return new NotificationHealthReporter( runtimes, settings.providers().keySet().stream().map(ProviderProfileId::new).toList(), servingState, platform.routes().keySet(), - NotificationServingThresholds.DEFAULT); + new NotificationServingThresholds( + thresholds.maxBacklogDepth(), + thresholds.maxOldestDueAge(), + thresholds.maxStuckLeases(), + thresholds.maxPendingProjections(), + thresholds.maxFailedProjections(), + thresholds.maxOldestPendingProjectionAge(), + thresholds.maxOldestReconciliationAge())); } /** Actuator endpoint and health indicator for the platform. */ diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformPolicyConfig.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformPolicyConfig.java similarity index 98% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformPolicyConfig.java rename to src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformPolicyConfig.java index 0273a6ac..7d753ea9 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformPolicyConfig.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformPolicyConfig.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.notification; +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; import dev.caskeleton.application.notification.platform.dispatch.CanonicalNotificationPlanWriter; import dev.caskeleton.application.notification.platform.dispatch.MessageDigestPort; @@ -42,7 +42,7 @@ import org.springframework.context.annotation.Configuration; prefix = "ca-skeleton.notification.platform", name = "enabled", havingValue = "true") -public class NotificationPlatformPolicyConfig { +class NotificationPlatformPolicyConfig { /** * Eligibility: mandatory suppression first, a deployment's own business rule last. diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformProviderConfig.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformProviderConfig.java similarity index 82% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformProviderConfig.java rename to src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformProviderConfig.java index 45b0445a..4e6655e8 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformProviderConfig.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformProviderConfig.java @@ -1,8 +1,5 @@ -package dev.caskeleton.bootstrap.autoconfigure.notification; +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; -import dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationPlatformSettings; -import dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationProviderAssembly; -import dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.ProviderRuntimeAssembler; import dev.caskeleton.adapter.outbound.notification.platform.dispatch.CapabilityReconciliationGateway; import dev.caskeleton.adapter.outbound.notification.platform.dispatch.MapTemplateRendererRegistry; import dev.caskeleton.adapter.outbound.notification.platform.dispatch.ProviderRuntimeRegistry; @@ -12,10 +9,12 @@ import dev.caskeleton.adapter.outbound.notification.platform.template.Notificati import dev.caskeleton.adapter.outbound.notification.platform.template.ThymeleafNotificationRenderer; import dev.caskeleton.adapter.outbound.notification.platform.template.ThymeleafStringTemplateEngine; import dev.caskeleton.application.notification.platform.api.routing.Channel; +import dev.caskeleton.application.notification.platform.dispatch.AttachmentIntegrityGuard; import dev.caskeleton.application.notification.platform.dispatch.NotificationRoutePlannerPort; import dev.caskeleton.application.notification.platform.dispatch.ProviderDispatchGatewayPort; import dev.caskeleton.application.notification.platform.dispatch.ReconciliationGatewayPort; import dev.caskeleton.application.notification.platform.dispatch.TemplateRendererRegistry; +import dev.caskeleton.application.notification.platform.provider.AttachmentResolver; import dev.caskeleton.application.notification.platform.template.NotificationTemplateRenderer; import dev.caskeleton.application.notification.platform.template.TemplateRegistry; import dev.caskeleton.application.notification.platform.template.TemplateVariableValidator; @@ -41,7 +40,7 @@ import org.springframework.context.annotation.Configuration; prefix = "ca-skeleton.notification.platform", name = "enabled", havingValue = "true") -public class NotificationPlatformProviderConfig { +class NotificationPlatformProviderConfig { /** * Channel renderers built on the configured engine and the shared validator. @@ -75,6 +74,28 @@ public class NotificationPlatformProviderConfig { : new CanonicalNotificationRenderer(channel, templates, validator, engine); } + /** + * Default attachment resolution is fail-closed until a file/object-storage capability binds one. + */ + @Bean + @ConditionalOnMissingBean + public AttachmentResolver notificationAttachmentResolver() { + return (reference, context) -> { + throw new IllegalStateException( + "an attachment was requested but no attachment capability is bound; enable the file" + + " server or object storage capability, or submit a notification without" + + " attachments"); + }; + } + + /** Digest/size guard shared by every attachment-capable provider family. */ + @Bean + @ConditionalOnMissingBean + public AttachmentIntegrityGuard notificationAttachmentIntegrityGuard( + AttachmentResolver resolver) { + return new AttachmentIntegrityGuard(resolver); + } + /** * Assembles every configured provider profile, or refuses to start. * @@ -91,11 +112,14 @@ public class NotificationPlatformProviderConfig { @Bean @ConditionalOnMissingBean public NotificationProviderAssembly.AssembledPlatform assembledNotificationPlatform( - java.util.List assemblers, NotificationPlatformSettings settings) { + java.util.List assemblers, + java.util.List callbackAssemblers, + NotificationPlatformSettings settings) { // The persistence facade already refuses to start until the notification schema stream is // applied and promoted, and it declares that bean before its stores. Duplicating the gate here // would reach past the persistence leaf's export surface for no additional safety. - return new NotificationProviderAssembly(assemblers).assemble(settings, settings.mode()); + return new NotificationProviderAssembly(assemblers, callbackAssemblers) + .assemble(settings, settings.mode()); } /** The registry the assembly filled, rather than an empty one. */ diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformRegistriesConfig.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformRegistriesConfig.java similarity index 50% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformRegistriesConfig.java rename to src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformRegistriesConfig.java index 7fe7d62d..ba9fe13f 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformRegistriesConfig.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformRegistriesConfig.java @@ -1,13 +1,10 @@ -package dev.caskeleton.bootstrap.autoconfigure.notification; +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; -import dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationPlatformSettings; +import dev.caskeleton.adapter.outbound.notification.platform.callback.CallbackLimits; import dev.caskeleton.adapter.outbound.notification.platform.callback.MapProviderCallbackAdapterRegistry; import dev.caskeleton.adapter.outbound.notification.platform.callback.MapProviderEventProjectorRegistry; +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackAdapterRegistry; import dev.caskeleton.application.notification.platform.api.ProviderId; -import dev.caskeleton.application.notification.platform.api.ProviderProfileId; -import dev.caskeleton.application.notification.platform.callback.CallbackLimits; -import dev.caskeleton.application.notification.platform.callback.ProviderCallbackAdapter; -import dev.caskeleton.application.notification.platform.callback.ProviderCallbackAdapterRegistry; import dev.caskeleton.application.notification.platform.callback.ProviderEventProjector; import dev.caskeleton.application.notification.platform.callback.ProviderEventProjectorRegistry; import java.util.HashMap; @@ -19,18 +16,19 @@ import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; /** - * Registries assembled from whatever provider beans the deployment actually declared. + * Registries over the provider contributions fixed by startup assembly. * - *

Both registries are built from the bean list rather than a hard-coded switch, so adding a - * provider is a matter of contributing a bean — the plan's requirement that a new adapter needs no - * change to the core. + *

Callback lookup consumes the profile-keyed map produced by {@link + * NotificationProviderAssembly} rather than rebuilding profile ownership from a bean list. That + * preserves profile-specific credentials and makes the registry describe exactly what startup + * proved reachable. */ @Configuration(proxyBeanMethods = false) @ConditionalOnProperty( prefix = "ca-skeleton.notification.platform", name = "enabled", havingValue = "true") -public class NotificationPlatformRegistriesConfig { +class NotificationPlatformRegistriesConfig { /** Projector lookup by provider family. */ @Bean @@ -44,27 +42,13 @@ public class NotificationPlatformRegistriesConfig { /** Callback adapter lookup by configured profile. */ @Bean public ProviderCallbackAdapterRegistry providerCallbackAdapterRegistry( - List adapters, NotificationPlatformSettings settings) { - Map byProvider = new HashMap<>(); - adapters.forEach(adapter -> byProvider.put(adapter.providerId().value(), adapter)); - - Map byProfile = new HashMap<>(); - settings - .providers() - .forEach( - (profileId, provider) -> { - ProviderCallbackAdapter adapter = - byProvider.get(provider.type().toLowerCase(java.util.Locale.ROOT)); - if (adapter != null) { - byProfile.put(new ProviderProfileId(profileId), adapter); - } - }); - + NotificationProviderAssembly.AssembledPlatform platform, + NotificationPlatformSettings settings) { CallbackLimits limits = new CallbackLimits( settings.callbacks().maxBodyBytes(), Set.of("application/json", "text/plain", "application/x-www-form-urlencoded")); - return new MapProviderCallbackAdapterRegistry(byProfile, limits); + return new MapProviderCallbackAdapterRegistry(platform.callbacks(), limits); } } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformRuntimeConfig.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformRuntimeConfig.java similarity index 90% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformRuntimeConfig.java rename to src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformRuntimeConfig.java index f1899231..60017997 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformRuntimeConfig.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformRuntimeConfig.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.notification; +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; import org.springframework.context.annotation.Configuration; @@ -32,6 +32,8 @@ import org.springframework.context.annotation.Import; NotificationPlatformPolicyConfig.class, NotificationPlatformDispatchConfig.class, NotificationPlatformWorkerConfig.class, + NotificationCallbackProviderConfig.class, + NotificationSesProviderConfig.class, // The SMTP provider family. It carries its own narrower condition — a relay must be configured — // so a deployment with the platform on and no spring.mail.host contributes no assembler and any // profile declaring type: SMTP is refused by name at assembly rather than dispatched into @@ -39,4 +41,4 @@ import org.springframework.context.annotation.Import; dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationSmtpProviderConfig .class, }) -public class NotificationPlatformRuntimeConfig {} +class NotificationPlatformRuntimeConfig {} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformSecretsConfig.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformSecretsConfig.java similarity index 90% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformSecretsConfig.java rename to src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformSecretsConfig.java index b5fcab98..5aecbcbe 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformSecretsConfig.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformSecretsConfig.java @@ -1,12 +1,12 @@ -package dev.caskeleton.bootstrap.autoconfigure.notification; +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; -import dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationPlatformSettings; -import dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationSecretRequirements; +import dev.caskeleton.adapter.outbound.notification.platform.security.ProviderCredentialManager; import dev.caskeleton.adapter.outbound.notification.platform.security.SettingsSecretMaterialProvider; +import dev.caskeleton.adapter.outbound.support.CapabilityStartupValidationException; import dev.caskeleton.application.notification.platform.security.SecretKeyMaterial; import dev.caskeleton.application.notification.platform.security.SecretMaterialProvider; import dev.caskeleton.application.notification.platform.security.SecretPurpose; -import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; +import java.time.Clock; import java.util.Base64; import java.util.EnumMap; import java.util.Map; @@ -57,7 +57,7 @@ import org.springframework.context.annotation.Configuration; name = "enabled", havingValue = "true") @EnableConfigurationProperties(NotificationPlatformSecretsConfig.NotificationSecretsSettings.class) -public class NotificationPlatformSecretsConfig { +class NotificationPlatformSecretsConfig { /** Base64 key material bound from the environment. */ @ConfigurationProperties("ca-skeleton.notification.platform.secrets") @@ -110,6 +110,20 @@ public class NotificationPlatformSecretsConfig { return new SettingsSecretMaterialProvider(active, historical); } + /** + * Per-profile provider credential generations. + * + *

The manager is shared by every provider family that authenticates with platform-held + * credentials. Assemblers activate generation 1 from each profile's {@code credential-profile} + * key id and later rotations replace that generation through the same manager. + */ + @Bean + @ConditionalOnMissingBean + public ProviderCredentialManager notificationProviderCredentialManager( + SecretMaterialProvider secrets, Clock clock) { + return new ProviderCredentialManager(secrets, clock); + } + /** The bound value for each purpose, in a fixed order so a failure names the same one twice. */ private static Map configured(NotificationSecretsSettings settings) { Map values = new EnumMap<>(SecretPurpose.class); @@ -142,7 +156,7 @@ public class NotificationPlatformSecretsConfig { boolean supplied = base64 != null && !base64.isBlank(); if (!supplied) { if (required.contains(purpose)) { - throw StartupFailures.envValidation( + throw new CapabilityStartupValidationException( "notification secret for " + purpose + " is not configured; the capability that uses it is enabled, so the platform" @@ -152,7 +166,7 @@ public class NotificationPlatformSecretsConfig { } String keyId = settings.activeKeyIds().get(purpose.name()); if (keyId == null || keyId.isBlank()) { - throw StartupFailures.envValidation( + throw new CapabilityStartupValidationException( "no active key id configured for " + purpose + "; a constant id makes a rotation indistinguishable from the key it replaced, so" @@ -182,13 +196,13 @@ public class NotificationPlatformSecretsConfig { if (settings.activeKeyIds().containsValue(keyId)) { // The same id under two different materials is the one state no reader can // resolve: the envelope names an id and two keys answer to it. - throw StartupFailures.envValidation( + throw new CapabilityStartupValidationException( "key id " + keyId + " is both active and historical"); } SecretKeyMaterial previous = historical.put(keyId, material(purpose, keyId, base64)); if (previous != null) { - throw StartupFailures.envValidation( + throw new CapabilityStartupValidationException( "key id " + keyId + " is declared for both " @@ -204,12 +218,12 @@ public class NotificationPlatformSecretsConfig { /** Decodes and length-checks one key, active or retired. */ private static SecretKeyMaterial material(SecretPurpose purpose, String keyId, String base64) { if (base64 == null || base64.isBlank()) { - throw StartupFailures.envValidation( + throw new CapabilityStartupValidationException( "notification secret " + keyId + " for " + purpose + " has no value"); } byte[] material = decode(purpose, keyId, base64); if (material.length < MINIMUM_KEY_BYTES) { - throw StartupFailures.envValidation( + throw new CapabilityStartupValidationException( "notification secret " + keyId + " for " @@ -230,7 +244,7 @@ public class NotificationPlatformSecretsConfig { } catch (IllegalArgumentException unknown) { // Naming the purpose, never the keys under it: a typo here would otherwise be reported by // echoing the block that was misfiled. - throw StartupFailures.envValidation( + throw new CapabilityStartupValidationException( "historical notification secrets are declared under key purpose " + name + ", which is not a purpose this platform issues keys for", @@ -244,7 +258,7 @@ public class NotificationPlatformSecretsConfig { } catch (IllegalArgumentException malformed) { // The id and the purpose, never the value, and never the decoder's own message — a base64 // failure report can quote the input it choked on. - throw StartupFailures.envValidation( + throw new CapabilityStartupValidationException( "notification secret " + keyId + " for " + purpose + " is not valid base64"); } } @@ -268,7 +282,7 @@ public class NotificationPlatformSecretsConfig { String fingerprint = java.util.HexFormat.of().formatHex(key.material()); SecretKeyMaterial previous = seen.put(fingerprint, key); if (previous != null) { - throw StartupFailures.envValidation( + throw new CapabilityStartupValidationException( "notification secrets " + previous.keyId() + " (" diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformSettings.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformSettings.java index fb23f3b7..e0614b7b 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformSettings.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformSettings.java @@ -1,9 +1,12 @@ package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; +import java.net.URI; import java.time.Duration; import java.util.Map; import java.util.Objects; import org.springframework.boot.context.properties.ConfigurationProperties; +import org.springframework.boot.context.properties.bind.ConstructorBinding; +import org.springframework.boot.context.properties.bind.DefaultValue; /** * Bound notification platform configuration. @@ -19,8 +22,10 @@ public record NotificationPlatformSettings( NotificationPlatformMode mode, Dispatch dispatch, Callbacks callbacks, + ServingThresholds servingThresholds, Map providers) { + @ConstructorBinding public NotificationPlatformSettings { // SERVING by default: a deployment that ends up with no provider is a misconfiguration unless // somebody said otherwise, and the assembly refuses it rather than accepting requests it cannot @@ -28,10 +33,22 @@ public record NotificationPlatformSettings( mode = mode == null ? NotificationPlatformMode.SERVING : mode; dispatch = dispatch == null ? Dispatch.defaults() : dispatch; callbacks = callbacks == null ? Callbacks.defaults() : callbacks; + servingThresholds = + servingThresholds == null ? ServingThresholds.defaults() : servingThresholds; providers = providers == null ? Map.of() : Map.copyOf(providers); providers.forEach((id, provider) -> provider.validate(id)); } + /** Source-compatible constructor for callers that rely on the original settings shape. */ + public NotificationPlatformSettings( + boolean enabled, + NotificationPlatformMode mode, + Dispatch dispatch, + Callbacks callbacks, + Map providers) { + this(enabled, mode, dispatch, callbacks, ServingThresholds.defaults(), providers); + } + /** Dispatch runtime bounds. */ public record Dispatch( int claimBatchSize, @@ -39,15 +56,20 @@ public record NotificationPlatformSettings( Duration pollInterval, int maxGlobalConcurrency, int maxAdditionalAttempts, + @DefaultValue("2s") Duration estimatedDispatchDuration, Duration maxQueueAge, - boolean allowAmbiguousFallback) { + boolean allowAmbiguousFallback, + @DefaultValue("20s") Duration shutdownGrace) { private static final int MAX_CLAIM_BATCH = 1000; + @ConstructorBinding public Dispatch { Objects.requireNonNull(leaseDuration, "leaseDuration"); Objects.requireNonNull(pollInterval, "pollInterval"); + Objects.requireNonNull(estimatedDispatchDuration, "estimatedDispatchDuration"); Objects.requireNonNull(maxQueueAge, "maxQueueAge"); + Objects.requireNonNull(shutdownGrace, "shutdownGrace"); if (claimBatchSize < 1 || claimBatchSize > MAX_CLAIM_BATCH) { throw new IllegalArgumentException( "ca-skeleton.notification.platform.dispatch.claim-batch-size must be 1.." @@ -65,6 +87,13 @@ public record NotificationPlatformSettings( if (leaseDuration.compareTo(pollInterval) <= 0) { throw new IllegalArgumentException("lease-duration must exceed poll-interval"); } + if (estimatedDispatchDuration.isNegative() || estimatedDispatchDuration.isZero()) { + throw new IllegalArgumentException( + "estimated-dispatch-duration must be positive and finite"); + } + if (shutdownGrace.isNegative() || shutdownGrace.isZero()) { + throw new IllegalArgumentException("shutdown-grace must be positive and finite"); + } if (allowAmbiguousFallback) { // Refused outright rather than warned about: automatic fallback after an ambiguous // submission is the configuration that turns an unknown into a guaranteed duplicate. @@ -76,7 +105,57 @@ public record NotificationPlatformSettings( /** Conservative defaults. */ public static Dispatch defaults() { return new Dispatch( - 100, Duration.ofSeconds(30), Duration.ofMillis(250), 128, 3, Duration.ofHours(24), false); + 100, + Duration.ofSeconds(30), + Duration.ofMillis(250), + 128, + 3, + Duration.ofSeconds(2), + Duration.ofHours(24), + false, + Duration.ofSeconds(20)); + } + } + + /** Deployment-owned readiness thresholds. */ + public record ServingThresholds( + long maxBacklogDepth, + Duration maxOldestDueAge, + long maxStuckLeases, + long maxPendingProjections, + long maxFailedProjections, + Duration maxOldestPendingProjectionAge, + Duration maxOldestReconciliationAge) { + + public ServingThresholds { + Objects.requireNonNull(maxOldestDueAge, "maxOldestDueAge"); + Objects.requireNonNull(maxOldestPendingProjectionAge, "maxOldestPendingProjectionAge"); + Objects.requireNonNull(maxOldestReconciliationAge, "maxOldestReconciliationAge"); + if (maxBacklogDepth < 0 + || maxStuckLeases < 0 + || maxPendingProjections < 0 + || maxFailedProjections < 0) { + throw new IllegalArgumentException("serving thresholds must not be negative"); + } + if (maxOldestDueAge.isNegative() + || maxOldestPendingProjectionAge.isNegative() + || maxOldestReconciliationAge.isNegative()) { + throw new IllegalArgumentException("serving threshold ages must not be negative"); + } + } + + public static ServingThresholds defaults() { + var defaults = + dev.caskeleton.adapter.outbound.notification.platform.observation + .NotificationServingThresholds.DEFAULT; + return new ServingThresholds( + defaults.maxBacklogDepth(), + defaults.maxOldestDueAge(), + defaults.maxStuckLeases(), + defaults.maxPendingProjections(), + defaults.maxFailedProjections(), + defaults.maxOldestPendingProjectionAge(), + defaults.maxOldestReconciliationAge()); } } @@ -138,7 +217,44 @@ public record NotificationPlatformSettings( String callbackSigningSecretRef, Duration timeout, int maxConcurrency, - int ratePerSecond) { + int ratePerSecond, + Ses ses) { + + @ConstructorBinding + public Provider {} + + /** + * Source-compatible constructor for families that do not yet need a typed family block. + * + *

Keeping this overload means existing tests and adopter code do not gain a meaningless SES + * argument merely because the SES family became composition-reachable. + */ + public Provider( + String type, + boolean enabled, + boolean primaryForChannel, + String environment, + String credentialProfile, + String topic, + String vapidPublicKey, + String callbackSigningSecretRef, + Duration timeout, + int maxConcurrency, + int ratePerSecond) { + this( + type, + enabled, + primaryForChannel, + environment, + credentialProfile, + topic, + vapidPublicKey, + callbackSigningSecretRef, + timeout, + maxConcurrency, + ratePerSecond, + null); + } /** Fail the boot when a profile cannot possibly work. */ public void validate(String profileId) { @@ -169,11 +285,15 @@ public record NotificationPlatformSettings( vapidPublicKey != null && !vapidPublicKey.isBlank(), profileId, "Web Push profiles require a VAPID key"); - case "TWILIO", "SES" -> + case "TWILIO" -> require( callbackSigningSecretRef != null && !callbackSigningSecretRef.isBlank(), profileId, - "callback-capable profiles require a callback signing secret reference"); + "Twilio profiles require a callback signing secret reference"); + case "SES" -> { + require(ses != null, profileId, "SES profiles require a ses settings block"); + ses.validate(profileId); + } default -> { // Providers without extra requirements are already covered by the common checks. } @@ -187,4 +307,28 @@ public record NotificationPlatformSettings( } } } + + /** + * SES-specific transport identity. Secret access-key material stays behind the secret provider. + */ + public record Ses( + URI endpoint, + String region, + String senderIdentity, + String accessKeyId, + String configurationSet) { + + private void validate(String profileId) { + Provider.require(endpoint != null, profileId, "SES endpoint is required"); + Provider.require(region != null && !region.isBlank(), profileId, "SES region is required"); + Provider.require( + senderIdentity != null && !senderIdentity.isBlank(), + profileId, + "SES sender-identity is required"); + Provider.require( + accessKeyId != null && !accessKeyId.isBlank(), + profileId, + "SES access-key-id is required"); + } + } } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformWorkerConfig.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformWorkerConfig.java similarity index 98% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformWorkerConfig.java rename to src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformWorkerConfig.java index de247b65..b2c7174e 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformWorkerConfig.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformWorkerConfig.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.notification; +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; import dev.caskeleton.adapter.outbound.notification.platform.dispatch.LeaseRecoveryService; import dev.caskeleton.adapter.outbound.notification.platform.dispatch.NotificationBackgroundWorkers; @@ -31,7 +31,7 @@ import org.springframework.context.annotation.Configuration; prefix = "ca-skeleton.notification.platform", name = "enabled", havingValue = "true") -public class NotificationPlatformWorkerConfig { +class NotificationPlatformWorkerConfig { /* * Queue worker. Started by the application lifecycle, stopped on shutdown. diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationProviderAssembly.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationProviderAssembly.java index eba7ccdc..13cf2ade 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationProviderAssembly.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationProviderAssembly.java @@ -1,9 +1,9 @@ package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackAdapter; import dev.caskeleton.adapter.outbound.notification.platform.dispatch.ProviderRuntimeRegistry; import dev.caskeleton.application.notification.platform.api.ProviderProfileId; import dev.caskeleton.application.notification.platform.api.routing.Channel; -import dev.caskeleton.application.notification.platform.callback.ProviderCallbackAdapter; import dev.caskeleton.application.notification.platform.callback.ProviderEventProjector; import dev.caskeleton.application.notification.platform.provider.ReconciliationCapability; import java.util.ArrayList; @@ -39,14 +39,29 @@ import java.util.TreeMap; public final class NotificationProviderAssembly { private final Map assemblers; + private final Map callbackAssemblers; /** - * Creates the assembly over the available family assemblers. + * Creates the assembly over the available dispatch assemblers. * - * @param assemblers one assembler per supported family + * @param assemblers one dispatch assembler per supported family */ public NotificationProviderAssembly(List assemblers) { + this(assemblers, List.of()); + } + + /** + * Creates the assembly over independently available dispatch and callback contributors. + * + * @param assemblers one dispatch assembler per supported family + * @param callbackAssemblers one callback assembler per callback-capable family + */ + NotificationProviderAssembly( + List assemblers, + List callbackAssemblers) { Objects.requireNonNull(assemblers, "assemblers"); + Objects.requireNonNull(callbackAssemblers, "callbackAssemblers"); + Map byType = new EnumMap<>(ProviderType.class); for (ProviderRuntimeAssembler assembler : assemblers) { ProviderRuntimeAssembler previous = byType.put(assembler.type(), assembler); @@ -57,7 +72,21 @@ public final class NotificationProviderAssembly { + "; which one builds a profile must not depend on bean ordering"); } } + + Map callbacksByType = + new EnumMap<>(ProviderType.class); + for (ProviderCallbackAssembler assembler : callbackAssemblers) { + ProviderCallbackAssembler previous = callbacksByType.put(assembler.type(), assembler); + if (previous != null) { + throw new IllegalStateException( + "two callback assemblers claim provider type " + + assembler.type() + + "; which verifier protects a profile must not depend on bean ordering"); + } + } + this.assemblers = Map.copyOf(byType); + this.callbackAssemblers = Map.copyOf(callbacksByType); } /** @@ -92,16 +121,27 @@ public final class NotificationProviderAssembly { continue; } ProviderType type = ProviderType.parse(profileId, profile.type()); + ProviderProfileId id = new ProviderProfileId(profileId); + + ProviderCallbackAssembler callbackAssembler = callbackAssemblers.get(type); + ProviderCallbackAdapter callback = + settings.callbacks().enabled() && callbackAssembler != null + ? callbackAssembler.assemble(profileId, profile) + : null; + + // INGEST_ONLY is deliberately callback-capable without being dispatch-capable. Building a + // runtime or a route here would make an ingest-only deployment able to send merely because a + // provider transport happened to be present on the classpath. + if (mode == NotificationPlatformMode.INGEST_ONLY) { + if (callback != null) { + callbacks.put(id, callback); + } + continue; + } + ProviderRuntimeAssembler assembler = assemblers.get(type); if (assembler == null) { - throw new IllegalStateException( - "notification provider profile '" - + profileId - + "' is of type " - + type - + ", which has no assembler in this build. The transport is a seam, not an" - + " implementation; remove the profile or supply a ProviderRuntimeAssembler for" - + " that family."); + throw new IllegalStateException(missingAssemblerMessage(profileId, type)); } AssembledProvider assembled = assembler.assemble(profileId, profile); if (assembled.channel() != type.channel()) { @@ -113,7 +153,6 @@ public final class NotificationProviderAssembly { + " provider; the channel a family serves is a property of the family"); } - ProviderProfileId id = new ProviderProfileId(profileId); runtimes.register(assembled.runtime()); claimants.computeIfAbsent(assembled.channel(), channel -> new ArrayList<>()).add(profileId); // The marked primary wins outright; otherwise the first (and, once the ambiguity check below @@ -124,7 +163,15 @@ public final class NotificationProviderAssembly { } else { routes.putIfAbsent(assembled.channel(), id); } - assembled.callback().ifPresent(adapter -> callbacks.put(id, adapter)); + assembled + .callback() + .ifPresentOrElse( + adapter -> callbacks.put(id, adapter), + () -> { + if (callback != null) { + callbacks.put(id, callback); + } + }); assembled.projector().ifPresent(projector -> projectors.put(id, projector)); assembled.reconciliation().ifPresent(capability -> reconciliations.put(id, capability)); } @@ -138,7 +185,24 @@ public final class NotificationProviderAssembly { Map.copyOf(callbacks), Map.copyOf(projectors), Map.copyOf(reconciliations), - routes.isEmpty() ? NotificationPlatformMode.INGEST_ONLY : NotificationPlatformMode.SERVING); + mode); + } + + private static String missingAssemblerMessage(String profileId, ProviderType type) { + if (type == ProviderType.SMTP) { + return "notification provider profile '" + + profileId + + "' is SMTP but the shipped SMTP assembler is absent. Configure spring.mail.host, " + + "spring.mail.port, required TLS and finite SMTP socket timeouts, or supply a custom " + + "ProviderRuntimeAssembler for SMTP."; + } + return "notification provider profile '" + + profileId + + "' is of type " + + type + + ", which has no assembler for dispatch in this build. The provider contract/adapter may " + + "exist without being composition-reachable; remove the profile or supply a " + + "ProviderRuntimeAssembler for that family."; } private static void refuseAmbiguousRoutes( @@ -148,7 +212,7 @@ public final class NotificationProviderAssembly { .providers() .forEach( (profileId, profile) -> { - if (profile.primaryForChannel()) { + if (profile.enabled() && profile.primaryForChannel()) { String channel = ProviderType.parse(profileId, profile.type()).channel().name(); String previous = primaries.put(channel, profileId); if (previous != null) { diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationSesProviderConfig.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationSesProviderConfig.java new file mode 100644 index 00000000..10714471 --- /dev/null +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationSesProviderConfig.java @@ -0,0 +1,26 @@ +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; + +import dev.caskeleton.adapter.outbound.notification.platform.provider.http.NotificationHttpGateway; +import dev.caskeleton.adapter.outbound.notification.platform.security.ProviderCredentialManager; +import dev.caskeleton.application.notification.platform.dispatch.AttachmentIntegrityGuard; +import dev.caskeleton.application.notification.platform.security.ContactPointProtector; +import java.time.Clock; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +/** SES dispatch-family contribution. Profile-specific values stay in the provider map. */ +@Configuration(proxyBeanMethods = false) +class NotificationSesProviderConfig { + + @Bean + @ConditionalOnMissingBean(name = "sesProviderRuntimeAssembler") + public ProviderRuntimeAssembler sesProviderRuntimeAssembler( + NotificationHttpGateway gateway, + AttachmentIntegrityGuard attachmentGuard, + ContactPointProtector protector, + ProviderCredentialManager credentials, + Clock clock) { + return new SesProviderRuntimeAssembler(gateway, attachmentGuard, protector, credentials, clock); + } +} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationSmtpProviderConfig.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationSmtpProviderConfig.java index 8870a024..1d29362d 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationSmtpProviderConfig.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationSmtpProviderConfig.java @@ -6,10 +6,11 @@ import dev.caskeleton.adapter.outbound.notification.platform.provider.smtp.SmtpF import dev.caskeleton.adapter.outbound.notification.platform.provider.smtp.SmtpMimeMessageFactory; import dev.caskeleton.adapter.outbound.notification.platform.provider.smtp.SmtpProviderProperties; import dev.caskeleton.application.notification.platform.dispatch.AttachmentIntegrityGuard; -import dev.caskeleton.application.notification.platform.provider.AttachmentResolver; import dev.caskeleton.application.notification.platform.security.ContactPointProtector; import jakarta.mail.Session; import java.time.Clock; +import java.time.Duration; +import java.util.Properties; import java.util.concurrent.Executor; import java.util.concurrent.LinkedBlockingQueue; import java.util.concurrent.ThreadPoolExecutor; @@ -46,8 +47,8 @@ import org.springframework.mail.javamail.JavaMailSenderImpl; * security come from {@code spring.mail.*} through the auto-configured {@link JavaMailSender}. One * relay described in two places is a defect this repository has already paid for: {@code * app.jpa-platform.datasource.*} validated a pool that {@code spring.datasource.hikari.*} had - * built. {@link NotificationSmtpSettings} carries only what {@code spring.mail} has no word for — - * the envelope sender, the per-attempt timeouts and the dispatch concurrency. + * built. {@link NotificationSmtpSettings} carries only what {@code spring.mail} does not own — the + * envelope sender and the dispatch executor concurrency. */ @Configuration(proxyBeanMethods = false) // The master switch is not repeated here. This configuration is reachable only through @@ -90,32 +91,6 @@ public class NotificationSmtpProviderConfig { return new SmtpFailureClassifier(); } - /** - * Attachment resolution, refused by default. - * - *

Attachments come from the file server or object storage capability, and a deployment that - * enabled neither has no way to read one. The default refuses rather than returning null: a null - * resolution reaches the integrity guard, which then compares a digest against nothing, and the - * message goes out without the attachment it claimed to carry. - */ - @Bean - @ConditionalOnMissingBean - public AttachmentResolver notificationAttachmentResolver() { - return (reference, context) -> { - throw new IllegalStateException( - "an attachment was requested but no attachment capability is bound; enable the file " - + "server or object storage capability, or submit a notification without attachments"); - }; - } - - /** Digest check between what a template referenced and what was read. */ - @Bean - @ConditionalOnMissingBean - public AttachmentIntegrityGuard notificationAttachmentIntegrityGuard( - AttachmentResolver resolver) { - return new AttachmentIntegrityGuard(resolver); - } - /** * Where an SMTP send runs. * @@ -182,30 +157,79 @@ public class NotificationSmtpProviderConfig { } /** - * The relay's address, read from Spring's mail configuration. + * The relay description, read from the actual Spring Mail sender. * - *

{@code SmtpProviderProperties.TlsMode} has two members and neither is plaintext, so the type - * refuses an unencrypted relay by construction rather than by a validator somebody has to - * remember to run. That is why the mode is a setting rather than something derived from {@code - * spring.mail.properties.mail.smtp.starttls.enable}: a derived mode would silently become - * "whatever that flag happened to say", including off. + *

Security and socket deadlines are read from the actual {@link JavaMailSenderImpl}. Keeping a + * second TLS/timeout description in this adapter would only prove that a different set of values + * was valid while the sender continued using Spring Mail's values. The assembler therefore fails + * closed unless the sender itself requires TLS and has finite connect/read/write timeouts. */ private static SmtpProviderProperties transport( NotificationSmtpSettings settings, JavaMailSender sender) { - String host = settings.host(); - int port = settings.port(); - if (sender instanceof JavaMailSenderImpl impl) { - host = impl.getHost() == null ? host : impl.getHost(); - port = impl.getPort() > 0 ? impl.getPort() : port; + if (!(sender instanceof JavaMailSenderImpl impl)) { + throw new IllegalStateException( + "SMTP provider requires JavaMailSenderImpl so TLS and timeout settings can be verified"); } + + String host = impl.getHost(); + int port = impl.getPort(); + if (host == null || host.isBlank()) { + throw new IllegalStateException("spring.mail.host must be configured for the SMTP provider"); + } + if (port < 1 || port > 65535) { + throw new IllegalStateException( + "spring.mail.port must be configured explicitly for the SMTP provider"); + } + + Properties mail = impl.getJavaMailProperties(); + SmtpProviderProperties.TlsMode tlsMode = requiredTlsMode(mail); + Duration connectTimeout = requiredTimeout(mail, "mail.smtp.connectiontimeout"); + Duration readTimeout = requiredTimeout(mail, "mail.smtp.timeout"); + Duration writeTimeout = requiredTimeout(mail, "mail.smtp.writetimeout"); + return new SmtpProviderProperties( host, port, - settings.tlsMode(), + tlsMode, settings.senderIdentity(), - settings.connectTimeout(), - settings.readTimeout(), - settings.writeTimeout(), + connectTimeout, + readTimeout, + writeTimeout, settings.maxConcurrency()); } + + private static SmtpProviderProperties.TlsMode requiredTlsMode(Properties mail) { + if (Boolean.parseBoolean(mail.getProperty("mail.smtp.ssl.enable"))) { + return SmtpProviderProperties.TlsMode.IMPLICIT_TLS; + } + + boolean startTls = Boolean.parseBoolean(mail.getProperty("mail.smtp.starttls.enable")); + boolean startTlsRequired = + Boolean.parseBoolean(mail.getProperty("mail.smtp.starttls.required")); + if (startTls && startTlsRequired) { + return SmtpProviderProperties.TlsMode.STARTTLS_REQUIRED; + } + + throw new IllegalStateException( + "SMTP transport must require TLS: configure Spring Mail with " + + "STARTTLS (mail.smtp.starttls.enable=true and mail.smtp.starttls.required=true), " + + "or implicit TLS (mail.smtp.ssl.enable=true)"); + } + + private static Duration requiredTimeout(Properties mail, String key) { + String configured = mail.getProperty(key); + if (configured == null || configured.isBlank()) { + throw new IllegalStateException("SMTP transport timeout is missing: " + key); + } + try { + long millis = Long.parseLong(configured); + if (millis <= 0) { + throw new IllegalStateException("SMTP transport timeout must be positive: " + key); + } + return Duration.ofMillis(millis); + } catch (NumberFormatException invalid) { + throw new IllegalStateException( + "SMTP transport timeout must be a positive millisecond value: " + key, invalid); + } + } } diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationSmtpSettings.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationSmtpSettings.java index c6393dab..2637e912 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationSmtpSettings.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationSmtpSettings.java @@ -1,50 +1,27 @@ package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; -import dev.caskeleton.adapter.outbound.notification.platform.provider.smtp.SmtpProviderProperties; -import java.time.Duration; import java.util.Objects; import org.springframework.boot.context.properties.ConfigurationProperties; import org.springframework.boot.context.properties.bind.DefaultValue; /** - * The parts of an SMTP relay description that {@code spring.mail.*} has no word for. + * Notification-specific SMTP settings that Spring Mail does not own. * - *

Host, port, username, password and the mail properties stay Spring's. Repeating them here - * would be one relay described twice, which is the shape of a defect this repository has already - * paid for — {@code app.jpa-platform.datasource.*} validated a pool that {@code - * spring.datasource.hikari.*} had built, so the validation passed while describing something that - * was not running. + *

The relay address, credentials, TLS policy and socket timeouts belong exclusively to {@code + * spring.mail.*}. Duplicating those values under this prefix lets validation succeed against one + * relay description while the actual {@code JavaMailSender} uses another. The SMTP assembly + * validates the sender's effective JavaMail properties instead. * - *

{@code host} and {@code port} are present all the same, as a fallback only: {@link - * NotificationSmtpProviderConfig} reads them from the configured sender and falls back here when - * the sender is not the standard implementation. They are never the primary source. - * - * @param host fallback relay host, used only when the mail sender cannot be read - * @param port fallback relay port, same - * @param tlsMode transport security; the type has no plaintext member, deliberately * @param senderIdentity the envelope sender every message is sent as - * @param connectTimeout how long a connection attempt may take - * @param readTimeout how long a reply may take - * @param writeTimeout how long a write may take * @param maxConcurrency how many sends may run at once */ @ConfigurationProperties("ca-skeleton.notification.platform.smtp") public record NotificationSmtpSettings( - @DefaultValue("localhost") String host, - @DefaultValue("587") int port, - @DefaultValue("STARTTLS_REQUIRED") SmtpProviderProperties.TlsMode tlsMode, @DefaultValue("no-reply@example.invalid") String senderIdentity, - @DefaultValue("5s") Duration connectTimeout, - @DefaultValue("10s") Duration readTimeout, - @DefaultValue("10s") Duration writeTimeout, @DefaultValue("4") int maxConcurrency) { public NotificationSmtpSettings { - Objects.requireNonNull(tlsMode, "tlsMode"); Objects.requireNonNull(senderIdentity, "senderIdentity"); - Objects.requireNonNull(connectTimeout, "connectTimeout"); - Objects.requireNonNull(readTimeout, "readTimeout"); - Objects.requireNonNull(writeTimeout, "writeTimeout"); // The sender identity has a default that cannot deliver on purpose. example.invalid is reserved // by RFC 2606 and resolves nowhere, so a deployment that forgot to set one gets a bounce it can // trace rather than mail that appears to come from a real address it does not own. diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/ProviderCallbackAssembler.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/ProviderCallbackAssembler.java new file mode 100644 index 00000000..f5f05f4b --- /dev/null +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/ProviderCallbackAssembler.java @@ -0,0 +1,26 @@ +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; + +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackAdapter; + +/** + * Builds the callback verifier for one configured provider profile. + * + *

Callback ingestion and outbound dispatch are separate runtime capabilities. An {@link + * NotificationPlatformMode#INGEST_ONLY} deployment can legitimately receive provider delivery + * events while not dispatching new notifications, so callback reachability must not depend on a + * dispatch transport being assembled. + */ +interface ProviderCallbackAssembler { + + /** The provider family this assembler verifies. */ + ProviderType type(); + + /** + * Builds the callback verifier for one profile. + * + * @param profileId configured profile id + * @param profile bound profile settings + * @return the profile-specific verifier + */ + ProviderCallbackAdapter assemble(String profileId, NotificationPlatformSettings.Provider profile); +} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/SesProviderCallbackAssembler.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/SesProviderCallbackAssembler.java new file mode 100644 index 00000000..c7115159 --- /dev/null +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/SesProviderCallbackAssembler.java @@ -0,0 +1,35 @@ +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; + +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackAdapter; +import dev.caskeleton.adapter.outbound.notification.platform.provider.ses.SesCallbackAdapter; +import dev.caskeleton.adapter.outbound.notification.platform.provider.ses.SesEventNormalizer; +import dev.caskeleton.adapter.outbound.notification.platform.provider.ses.SnsCertificateProvider; +import dev.caskeleton.adapter.outbound.notification.platform.provider.ses.SnsSignatureVerifier; +import java.util.Objects; + +/** Builds one SES/SNS callback verifier per configured SES profile. */ +final class SesProviderCallbackAssembler implements ProviderCallbackAssembler { + + private final SnsSignatureVerifier verifier; + private final SesEventNormalizer normalizer; + + SesProviderCallbackAssembler(SnsCertificateProvider certificates) { + this.verifier = + new SnsSignatureVerifier( + Objects.requireNonNull(certificates, "certificates"), "amazonaws.com"); + this.normalizer = new SesEventNormalizer(); + } + + @Override + public ProviderType type() { + return ProviderType.SES; + } + + @Override + public ProviderCallbackAdapter assemble( + String profileId, NotificationPlatformSettings.Provider profile) { + Objects.requireNonNull(profileId, "profileId"); + Objects.requireNonNull(profile, "profile"); + return new SesCallbackAdapter(verifier, normalizer); + } +} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/SesProviderRuntimeAssembler.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/SesProviderRuntimeAssembler.java new file mode 100644 index 00000000..9d5453e5 --- /dev/null +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/SesProviderRuntimeAssembler.java @@ -0,0 +1,129 @@ +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; + +import dev.caskeleton.adapter.outbound.notification.platform.dispatch.ProviderAttemptLimiter; +import dev.caskeleton.adapter.outbound.notification.platform.dispatch.ProviderRuntime; +import dev.caskeleton.adapter.outbound.notification.platform.provider.http.NotificationHttpGateway; +import dev.caskeleton.adapter.outbound.notification.platform.provider.ses.AwsSignatureV4Signer; +import dev.caskeleton.adapter.outbound.notification.platform.provider.ses.SesFailureClassifier; +import dev.caskeleton.adapter.outbound.notification.platform.provider.ses.SesNotificationProviderAdapter; +import dev.caskeleton.adapter.outbound.notification.platform.provider.ses.SesProviderProperties; +import dev.caskeleton.adapter.outbound.notification.platform.provider.ses.SesRequestMapper; +import dev.caskeleton.adapter.outbound.notification.platform.provider.smtp.SmtpMimeMessageFactory; +import dev.caskeleton.adapter.outbound.notification.platform.security.CredentialGeneration; +import dev.caskeleton.adapter.outbound.notification.platform.security.ProviderCredentialManager; +import dev.caskeleton.application.notification.platform.api.ProviderId; +import dev.caskeleton.application.notification.platform.api.ProviderProfileId; +import dev.caskeleton.application.notification.platform.api.routing.Channel; +import dev.caskeleton.application.notification.platform.dispatch.AttachmentIntegrityGuard; +import dev.caskeleton.application.notification.platform.provider.ProviderProfileSnapshot; +import dev.caskeleton.application.notification.platform.security.ContactPointProtector; +import jakarta.mail.Session; +import java.time.Clock; +import java.util.Map; +import java.util.Objects; +import java.util.Optional; +import java.util.Properties; + +/** Turns a configured SES profile into a dispatchable runtime. */ +final class SesProviderRuntimeAssembler implements ProviderRuntimeAssembler { + + private final NotificationHttpGateway gateway; + private final AttachmentIntegrityGuard attachmentGuard; + private final ContactPointProtector protector; + private final ProviderCredentialManager credentials; + private final Clock clock; + + public SesProviderRuntimeAssembler( + NotificationHttpGateway gateway, + AttachmentIntegrityGuard attachmentGuard, + ContactPointProtector protector, + ProviderCredentialManager credentials, + Clock clock) { + this.gateway = Objects.requireNonNull(gateway, "gateway"); + this.attachmentGuard = Objects.requireNonNull(attachmentGuard, "attachmentGuard"); + this.protector = Objects.requireNonNull(protector, "protector"); + this.credentials = Objects.requireNonNull(credentials, "credentials"); + this.clock = Objects.requireNonNull(clock, "clock"); + } + + @Override + public ProviderType type() { + return ProviderType.SES; + } + + @Override + public AssembledProvider assemble( + String profileId, NotificationPlatformSettings.Provider profile) { + Objects.requireNonNull(profileId, "profileId"); + Objects.requireNonNull(profile, "profile"); + NotificationPlatformSettings.Ses ses = + Objects.requireNonNull(profile.ses(), "SES profile settings"); + + ProviderProfileId id = new ProviderProfileId(profileId); + var generation = activateInitialCredential(id, profile.credentialProfile()); + + SesProviderProperties properties = + new SesProviderProperties( + ses.endpoint(), + ses.region(), + ses.senderIdentity(), + optional(ses.configurationSet()), + profile.timeout()); + SesRequestMapper mapper = + new SesRequestMapper( + properties, + new AwsSignatureV4Signer(), + new SmtpMimeMessageFactory(Session.getInstance(new Properties()))); + SesNotificationProviderAdapter adapter = + new SesNotificationProviderAdapter( + gateway, + mapper, + attachmentGuard, + new SesFailureClassifier(), + protector, + credentials, + ses.accessKeyId(), + clock); + + ProviderProfileSnapshot snapshot = + new ProviderProfileSnapshot( + id, + new ProviderId("ses"), + Channel.EMAIL, + profile.environment(), + generation.generation(), + adapter.capabilities(), + Map.of()); + + return AssembledProvider.dispatchOnly( + new ProviderRuntime( + snapshot, + adapter, + new ProviderAttemptLimiter(profile.maxConcurrency(), profile.ratePerSecond(), clock)), + Channel.EMAIL); + } + + private CredentialGeneration activateInitialCredential(ProviderProfileId id, String keyId) { + return credentials + .current(id) + .map( + active -> { + if (!active.keyId().equals(keyId)) { + throw new IllegalStateException( + "provider profile " + + id.value() + + " changed credential-profile from " + + active.keyId() + + " to " + + keyId + + " without a credential rotation"); + } + return active; + }) + .orElseGet(() -> credentials.activate(CredentialGeneration.candidate(id, 1L, keyId))); + } + + private static Optional optional(String value) { + return value == null || value.isBlank() ? Optional.empty() : Optional.of(value); + } +} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/SmtpProviderRuntimeAssembler.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/SmtpProviderRuntimeAssembler.java index d73384a6..263ab806 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/SmtpProviderRuntimeAssembler.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/SmtpProviderRuntimeAssembler.java @@ -65,7 +65,8 @@ public final class SmtpProviderRuntimeAssembler implements ProviderRuntimeAssemb * @param protector redacts contact points on the way out * @param executor where a send runs * @param attachmentGuard the attachment integrity check - * @param transport the relay's address and transport security, from {@code spring.mail.*} + * @param transport the verified relay address, TLS mode and socket deadlines from the actual + * sender * @param clock the clock the rate limiter measures against */ public SmtpProviderRuntimeAssembler( @@ -98,20 +99,9 @@ public final class SmtpProviderRuntimeAssembler implements ProviderRuntimeAssemb Objects.requireNonNull(profileId, "profileId"); Objects.requireNonNull(profile, "profile"); - SmtpProviderProperties properties = - new SmtpProviderProperties( - transport.host(), - transport.port(), - transport.tlsMode(), - transport.senderIdentity(), - transport.connectTimeout(), - profile.timeout(), - profile.timeout(), - profile.maxConcurrency()); - SmtpNotificationProviderAdapter adapter = new SmtpNotificationProviderAdapter( - dispatch, mimeFactory, classifier, protector, properties, executor, attachmentGuard); + dispatch, mimeFactory, classifier, protector, transport, executor, attachmentGuard); ProviderRuntime runtime = new ProviderRuntime( diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/CallbackLimits.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/CallbackLimits.java similarity index 53% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/CallbackLimits.java rename to src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/CallbackLimits.java index d535f67c..a372762b 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/CallbackLimits.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/CallbackLimits.java @@ -1,26 +1,20 @@ -package dev.caskeleton.application.notification.platform.callback; +package dev.caskeleton.adapter.outbound.notification.platform.callback; import java.util.Locale; import java.util.Objects; import java.util.Set; -/** Hard bounds every callback endpoint applies before doing any work. */ +/** Raw HTTP bounds enforced before provider signature verification. */ public record CallbackLimits(long maxBodyBytes, Set allowedContentTypes) { - public static final long DEFAULT_MAX_BODY_BYTES = 65_536L; - public CallbackLimits { allowedContentTypes = Set.copyOf(Objects.requireNonNull(allowedContentTypes, "allowedContentTypes")); - if (maxBodyBytes < 1) { - throw new IllegalArgumentException("maxBodyBytes"); - } - if (allowedContentTypes.isEmpty()) { - throw new IllegalArgumentException("allowedContentTypes must not be empty"); + if (maxBodyBytes < 1 || allowedContentTypes.isEmpty()) { + throw new IllegalArgumentException("callback limits must be positive and non-empty"); } } - /** Whether a content type is accepted, ignoring parameters such as charset. */ public boolean acceptsContentType(String contentType) { if (contentType == null) { return false; diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/CallbackVerificationResult.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/CallbackVerificationResult.java similarity index 79% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/CallbackVerificationResult.java rename to src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/CallbackVerificationResult.java index ecfbc0c5..d10224c2 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/CallbackVerificationResult.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/CallbackVerificationResult.java @@ -1,9 +1,9 @@ -package dev.caskeleton.application.notification.platform.callback; +package dev.caskeleton.adapter.outbound.notification.platform.callback; import java.util.Objects; import java.util.Optional; -/** Signature verification outcome. A rejection never reaches the ledger. */ +/** Signature verification outcome. An invalid callback never reaches the application ledger. */ public record CallbackVerificationResult( boolean valid, String reasonCode, Optional verifiedCallback) { @@ -14,16 +14,14 @@ public record CallbackVerificationResult( throw new IllegalArgumentException("a valid result must carry the verified callback"); } if (!valid && verifiedCallback.isPresent()) { - throw new IllegalArgumentException("an invalid result must not carry a verified callback"); + throw new IllegalArgumentException("an invalid result must not carry the verified callback"); } } - /** Accepted signature. */ public static CallbackVerificationResult valid(VerifiedCallback callback) { return new CallbackVerificationResult(true, "OK", Optional.of(callback)); } - /** Rejected signature. */ public static CallbackVerificationResult invalid(String reasonCode) { return new CallbackVerificationResult(false, reasonCode, Optional.empty()); } diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/MapProviderCallbackAdapterRegistry.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/MapProviderCallbackAdapterRegistry.java index 18e586dc..bd180636 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/MapProviderCallbackAdapterRegistry.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/MapProviderCallbackAdapterRegistry.java @@ -1,9 +1,6 @@ package dev.caskeleton.adapter.outbound.notification.platform.callback; import dev.caskeleton.application.notification.platform.api.ProviderProfileId; -import dev.caskeleton.application.notification.platform.callback.CallbackLimits; -import dev.caskeleton.application.notification.platform.callback.ProviderCallbackAdapter; -import dev.caskeleton.application.notification.platform.callback.ProviderCallbackAdapterRegistry; import java.util.Map; import java.util.Objects; diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/ProviderCallbackAdapter.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/ProviderCallbackAdapter.java new file mode 100644 index 00000000..16a6c264 --- /dev/null +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/ProviderCallbackAdapter.java @@ -0,0 +1,15 @@ +package dev.caskeleton.adapter.outbound.notification.platform.callback; + +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; +import dev.caskeleton.application.notification.platform.api.ProviderId; +import java.util.List; + +/** Provider-specific callback signature verification and normalization. */ +public interface ProviderCallbackAdapter { + + ProviderId providerId(); + + CallbackVerificationResult verify(ProviderCallbackVerificationRequest request); + + List normalize(VerifiedCallback callback); +} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/ProviderCallbackAdapterRegistry.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/ProviderCallbackAdapterRegistry.java new file mode 100644 index 00000000..355ea31a --- /dev/null +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/ProviderCallbackAdapterRegistry.java @@ -0,0 +1,13 @@ +package dev.caskeleton.adapter.outbound.notification.platform.callback; + +import dev.caskeleton.application.notification.platform.api.ProviderProfileId; + +/** + * Profile-to-provider callback verifier registry assembled by the outbound notification adapter. + */ +public interface ProviderCallbackAdapterRegistry { + + ProviderCallbackAdapter require(ProviderProfileId profileId); + + CallbackLimits limitsFor(ProviderProfileId profileId); +} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/CallbackRequest.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/ProviderCallbackVerificationRequest.java similarity index 68% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/CallbackRequest.java rename to src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/ProviderCallbackVerificationRequest.java index 21896f69..1ea93602 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/CallbackRequest.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/ProviderCallbackVerificationRequest.java @@ -1,5 +1,7 @@ -package dev.caskeleton.application.notification.platform.api; +package dev.caskeleton.adapter.outbound.notification.platform.callback; +import dev.caskeleton.application.notification.platform.api.ProviderId; +import dev.caskeleton.application.notification.platform.api.ProviderProfileId; import java.time.Instant; import java.util.Arrays; import java.util.List; @@ -8,19 +10,9 @@ import java.util.Map; import java.util.Objects; import java.util.Optional; -/** - * A provider callback as received. - * - *

The raw body is kept as bytes because several providers sign the exact octets; decoding first - * and re-encoding later is the most common cause of false signature failures. - * - *

It lives in {@code api} rather than {@code callback} because the inbound port declares it. - * With it in {@code callback}, the port package that exists to be the boundary depended on the - * package implementing behind that boundary, and the two could no longer be reasoned about - * separately. - */ -@SuppressWarnings("ArrayRecordComponent") // defensive copies on construction and on every accessor -public record CallbackRequest( +/** Raw transport material used only while a provider adapter verifies a callback signature. */ +@SuppressWarnings("ArrayRecordComponent") +public record ProviderCallbackVerificationRequest( ProviderId providerId, ProviderProfileId providerProfileId, String externalUrl, @@ -30,7 +22,7 @@ public record CallbackRequest( byte[] body, Instant receivedAt) { - public CallbackRequest { + public ProviderCallbackVerificationRequest { Objects.requireNonNull(providerId, "providerId"); Objects.requireNonNull(providerProfileId, "providerProfileId"); Objects.requireNonNull(externalUrl, "externalUrl"); @@ -39,9 +31,6 @@ public record CallbackRequest( Objects.requireNonNull(headers, "headers"); Objects.requireNonNull(body, "body"); Objects.requireNonNull(receivedAt, "receivedAt"); - if (externalUrl.isBlank()) { - throw new IllegalArgumentException("externalUrl"); - } headers = headers.entrySet().stream() .collect( @@ -56,13 +45,11 @@ public record CallbackRequest( return body.clone(); } - /** First value of a header, matched case-insensitively. */ public Optional header(String name) { List values = headers.get(name.toLowerCase(Locale.ROOT)); - return values == null || values.isEmpty() ? Optional.empty() : Optional.of(values.get(0)); + return values == null || values.isEmpty() ? Optional.empty() : Optional.of(values.getFirst()); } - /** Size of the raw body. */ public int bodyLength() { return body.length; } @@ -72,7 +59,7 @@ public record CallbackRequest( if (this == other) { return true; } - if (!(other instanceof CallbackRequest value)) { + if (!(other instanceof ProviderCallbackVerificationRequest value)) { return false; } return providerId.equals(value.providerId) @@ -100,12 +87,16 @@ public record CallbackRequest( @Override public String toString() { - return "CallbackRequest[provider=" + return "ProviderCallbackVerificationRequest[provider=" + providerId + ", profile=" + providerProfileId - + ", bytes=" - + body.length + + ", method=" + + httpMethod + + ", url=" + + externalUrl + + ", contentType=" + + contentType + ", body=redacted]"; } } diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/VerifiedCallback.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/VerifiedCallback.java new file mode 100644 index 00000000..1981ce77 --- /dev/null +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/callback/VerifiedCallback.java @@ -0,0 +1,15 @@ +package dev.caskeleton.adapter.outbound.notification.platform.callback; + +import java.util.Map; +import java.util.Objects; + +/** Provider callback whose signature has been validated. */ +public record VerifiedCallback( + ProviderCallbackVerificationRequest request, Map canonicalParameters) { + + public VerifiedCallback { + Objects.requireNonNull(request, "request"); + canonicalParameters = + Map.copyOf(Objects.requireNonNull(canonicalParameters, "canonicalParameters")); + } +} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/dispatch/NotificationDispatchProperties.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/dispatch/NotificationDispatchProperties.java index 63ff2c75..7cafab9b 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/dispatch/NotificationDispatchProperties.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/dispatch/NotificationDispatchProperties.java @@ -39,6 +39,7 @@ public record NotificationDispatchProperties( } requirePositive(leaseDuration, "leaseDuration"); requirePositive(pollInterval, "pollInterval"); + requirePositive(estimatedDispatchDuration, "estimatedDispatchDuration"); requirePositive(maxQueueAge, "maxQueueAge"); if (leaseDuration.compareTo(pollInterval) <= 0) { // A lease shorter than the poll interval expires before the worker can renew it, so two diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/http/JdkNotificationHttpGateway.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/http/JdkNotificationHttpGateway.java index aa385f4d..a6b18e59 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/http/JdkNotificationHttpGateway.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/http/JdkNotificationHttpGateway.java @@ -27,22 +27,35 @@ public final class JdkNotificationHttpGateway implements NotificationHttpGateway Set.of("connection", "content-length", "expect", "host", "upgrade"); private final HttpClient client; + private final boolean allowLoopback; public JdkNotificationHttpGateway(Duration connectTimeout) { + this(connectTimeout, false); + } + + public JdkNotificationHttpGateway(Duration connectTimeout, boolean allowLoopback) { this( HttpClient.newBuilder() .followRedirects(HttpClient.Redirect.NEVER) .connectTimeout(Objects.requireNonNull(connectTimeout, "connectTimeout")) - .build()); + .build(), + allowLoopback); } public JdkNotificationHttpGateway(HttpClient client) { + this(client, false); + } + + public JdkNotificationHttpGateway(HttpClient client, boolean allowLoopback) { this.client = Objects.requireNonNull(client, "client"); + this.allowLoopback = allowLoopback; } @Override public NotificationHttpResponse exchange(NotificationHttpRequest request) { Objects.requireNonNull(request, "request"); + NotificationEndpoints.requireExternallyRoutable( + request.uri(), "notification provider endpoint", allowLoopback); HttpRequest.Builder builder = HttpRequest.newBuilder(request.uri()) .timeout(request.timeout()) diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/ses/SesCallbackAdapter.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/ses/SesCallbackAdapter.java index 68f80fa7..d4132c66 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/ses/SesCallbackAdapter.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/ses/SesCallbackAdapter.java @@ -1,12 +1,12 @@ package dev.caskeleton.adapter.outbound.notification.platform.provider.ses; +import dev.caskeleton.adapter.outbound.notification.platform.callback.CallbackVerificationResult; +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackAdapter; +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackVerificationRequest; +import dev.caskeleton.adapter.outbound.notification.platform.callback.VerifiedCallback; import dev.caskeleton.adapter.outbound.notification.platform.template.NotificationJsonMapper; -import dev.caskeleton.application.notification.platform.api.CallbackRequest; +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; import dev.caskeleton.application.notification.platform.api.ProviderId; -import dev.caskeleton.application.notification.platform.callback.CallbackVerificationResult; -import dev.caskeleton.application.notification.platform.callback.NormalizedProviderEvent; -import dev.caskeleton.application.notification.platform.callback.ProviderCallbackAdapter; -import dev.caskeleton.application.notification.platform.callback.VerifiedCallback; import java.nio.charset.StandardCharsets; import java.util.LinkedHashMap; import java.util.List; @@ -39,7 +39,7 @@ public final class SesCallbackAdapter implements ProviderCallbackAdapter { } @Override - public CallbackVerificationResult verify(CallbackRequest request) { + public CallbackVerificationResult verify(ProviderCallbackVerificationRequest request) { Objects.requireNonNull(request, "request"); Map envelope; try { diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/ses/SesEventNormalizer.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/ses/SesEventNormalizer.java index eba30d54..24d5d5ff 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/ses/SesEventNormalizer.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/ses/SesEventNormalizer.java @@ -1,8 +1,8 @@ package dev.caskeleton.adapter.outbound.notification.platform.provider.ses; import dev.caskeleton.adapter.outbound.notification.platform.template.NotificationJsonMapper; -import dev.caskeleton.application.notification.platform.callback.NormalizedEventType; -import dev.caskeleton.application.notification.platform.callback.NormalizedProviderEvent; +import dev.caskeleton.application.notification.platform.api.NormalizedEventType; +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; import java.time.Instant; import java.util.ArrayList; import java.util.List; diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/ses/SesSuppressionUpdater.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/ses/SesSuppressionUpdater.java index 9a3d02df..1629194f 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/ses/SesSuppressionUpdater.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/ses/SesSuppressionUpdater.java @@ -1,7 +1,7 @@ package dev.caskeleton.adapter.outbound.notification.platform.provider.ses; +import dev.caskeleton.application.notification.platform.api.NormalizedEventType; import dev.caskeleton.application.notification.platform.callback.DeliveryAttemptSnapshot; -import dev.caskeleton.application.notification.platform.callback.NormalizedEventType; import dev.caskeleton.application.notification.platform.callback.NotificationSideEffectPort; import dev.caskeleton.application.notification.platform.callback.SuppressionFacts; import java.util.Objects; diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/twilio/TwilioCallbackAdapter.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/twilio/TwilioCallbackAdapter.java index d56993d3..2bd5d3d8 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/twilio/TwilioCallbackAdapter.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/twilio/TwilioCallbackAdapter.java @@ -1,11 +1,11 @@ package dev.caskeleton.adapter.outbound.notification.platform.provider.twilio; -import dev.caskeleton.application.notification.platform.api.CallbackRequest; +import dev.caskeleton.adapter.outbound.notification.platform.callback.CallbackVerificationResult; +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackAdapter; +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackVerificationRequest; +import dev.caskeleton.adapter.outbound.notification.platform.callback.VerifiedCallback; +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; import dev.caskeleton.application.notification.platform.api.ProviderId; -import dev.caskeleton.application.notification.platform.callback.CallbackVerificationResult; -import dev.caskeleton.application.notification.platform.callback.NormalizedProviderEvent; -import dev.caskeleton.application.notification.platform.callback.ProviderCallbackAdapter; -import dev.caskeleton.application.notification.platform.callback.VerifiedCallback; import dev.caskeleton.application.notification.platform.security.SecretMaterialProvider; import dev.caskeleton.application.notification.platform.security.SecretPurpose; import java.net.URLDecoder; @@ -44,7 +44,7 @@ public final class TwilioCallbackAdapter implements ProviderCallbackAdapter { } @Override - public CallbackVerificationResult verify(CallbackRequest request) { + public CallbackVerificationResult verify(ProviderCallbackVerificationRequest request) { Objects.requireNonNull(request, "request"); Map parameters = parseForm(request.body()); boolean valid = diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/twilio/TwilioStatusNormalizer.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/twilio/TwilioStatusNormalizer.java index 4c816e7f..0f6eac4b 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/twilio/TwilioStatusNormalizer.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/provider/twilio/TwilioStatusNormalizer.java @@ -1,7 +1,7 @@ package dev.caskeleton.adapter.outbound.notification.platform.provider.twilio; -import dev.caskeleton.application.notification.platform.callback.NormalizedEventType; -import dev.caskeleton.application.notification.platform.callback.NormalizedProviderEvent; +import dev.caskeleton.application.notification.platform.api.NormalizedEventType; +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; import java.time.Instant; import java.util.Map; import java.util.Optional; diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/security/AesGcmCallbackPayloadProtection.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/security/AesGcmCallbackPayloadProtection.java index 9346bef6..48d455b4 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/security/AesGcmCallbackPayloadProtection.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/security/AesGcmCallbackPayloadProtection.java @@ -1,9 +1,9 @@ package dev.caskeleton.adapter.outbound.notification.platform.security; import dev.caskeleton.adapter.outbound.notification.platform.template.NotificationDigest; +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; import dev.caskeleton.application.notification.platform.api.ProviderProfileId; import dev.caskeleton.application.notification.platform.callback.CallbackPayloadProtectionPort; -import dev.caskeleton.application.notification.platform.callback.NormalizedProviderEvent; import dev.caskeleton.application.notification.platform.security.NotificationPayloadProtection; import dev.caskeleton.application.notification.platform.security.SecretMaterialProvider; import dev.caskeleton.application.notification.platform.security.SecretPurpose; diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/security/AesGcmContactPointProtector.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/security/AesGcmContactPointProtector.java index 71ca753a..573e39e5 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/security/AesGcmContactPointProtector.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/security/AesGcmContactPointProtector.java @@ -86,6 +86,11 @@ public final class AesGcmContactPointProtector implements ContactPointProtector public ContactPointValue reveal(ProtectedContactPoint protectedValue, AccessContext context) { Objects.requireNonNull(protectedValue, "protectedValue"); Objects.requireNonNull(context, "context"); + if (!"DISPATCH".equals(context.purposeCode()) || context.auditRequired()) { + throw new SecurityException( + "contact point reveal is allowed only for the unaudited DISPATCH path; " + + "audited/admin/support reveal requires a dedicated audited boundary"); + } SecretKeyMaterial key = keys.keyById(protectedValue.keyId()); byte[] plaintext = decrypt( diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/template/PlaceholderTemplateEngine.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/template/PlaceholderTemplateEngine.java index 50cc859f..9af80184 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/template/PlaceholderTemplateEngine.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/template/PlaceholderTemplateEngine.java @@ -56,7 +56,10 @@ public final class PlaceholderTemplateEngine implements NotificationTemplateEngi rendered, Matcher.quoteReplacement(escape(mode, String.valueOf(value)))); } matcher.appendTail(rendered); - return rendered.toString(); + String result = rendered.toString(); + return mode == TemplateSlotMode.HTML_TEXT + ? TemplateSlotPolicy.verifyRendered(mode, result) + : result; } /** Escapes one substituted value for its destination. */ diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/template/TemplateSlotPolicy.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/template/TemplateSlotPolicy.java index aa4c6fa3..8b7aa5df 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/template/TemplateSlotPolicy.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/platform/template/TemplateSlotPolicy.java @@ -4,8 +4,10 @@ import dev.caskeleton.application.notification.platform.api.error.FailureCategor import dev.caskeleton.application.notification.platform.api.error.NotificationFailureCode; import dev.caskeleton.application.notification.platform.api.error.NotificationFailureDescriptor; import dev.caskeleton.application.notification.platform.api.error.TemplateRenderingException; +import java.util.ArrayDeque; import java.util.Locale; import java.util.Set; +import java.util.regex.Pattern; /** * What each slot mode means, in one place both engines use. @@ -27,6 +29,14 @@ public final class TemplateSlotPolicy { * in a notification is followed by a person who has no way to check it. */ private static final Set ALLOWED_URI_SCHEMES = Set.of("https", "caskeleton"); + private static final Pattern HTML_NAME = Pattern.compile("[a-z][a-z0-9-]{0,31}"); + private static final Set APPROVED_HTML_TAGS = + Set.of( + "a", "b", "body", "br", "div", "em", "h1", "h2", "h3", "h4", "h5", "h6", "head", + "html", "i", "img", "li", "ol", "p", "span", "strong", "table", "tbody", "td", "th", + "thead", "tr", "ul"); + private static final Set APPROVED_INERT_ATTRIBUTES = + Set.of("alt", "aria-label", "title"); private TemplateSlotPolicy() {} @@ -61,7 +71,8 @@ public final class TemplateSlotPolicy { */ public static String verifyRendered(TemplateSlotMode mode, String rendered) { return switch (mode) { - case TEXT, HTML_TEXT -> rendered; + case TEXT -> rendered; + case HTML_TEXT -> requireRestrictedHtml(rendered); case SUBJECT -> requireSingleLine(rendered); case URI -> requireAllowedScheme(rendered); }; @@ -121,6 +132,132 @@ public final class TemplateSlotPolicy { return value; } + + + /** + * Validates the operator-authored HTML surrounding escaped values. + * + *

Escaping caller values is not enough when the template source itself is persisted data. + * Restricting tags and attributes keeps "edit notification template" below arbitrary active + * markup execution. Links are static HTTPS links only; dynamic links use a dedicated URI slot. + */ + private static String requireRestrictedHtml(String template) { + ArrayDeque openTags = new ArrayDeque<>(); + int cursor = 0; + while (cursor < template.length()) { + int tagStart = template.indexOf('<', cursor); + if (tagStart < 0) { + break; + } + int tagEnd = findTagEnd(template, tagStart + 1); + if (tagEnd < 0) { + throw refuse(); + } + String body = template.substring(tagStart + 1, tagEnd).trim(); + if (body.isEmpty() || body.startsWith("!") || body.startsWith("?")) { + throw refuse(); + } + if (body.startsWith("/")) { + String closingName = body.substring(1).trim().toLowerCase(Locale.ROOT); + if (!HTML_NAME.matcher(closingName).matches() + || openTags.isEmpty() + || !openTags.removeLast().equals(closingName)) { + throw refuse(); + } + } else { + boolean selfClosing = body.endsWith("/"); + String opening = selfClosing ? body.substring(0, body.length() - 1).trim() : body; + int nameEnd = 0; + while (nameEnd < opening.length() + && (Character.isLetterOrDigit(opening.charAt(nameEnd)) + || opening.charAt(nameEnd) == '-')) { + nameEnd++; + } + String tagName = opening.substring(0, nameEnd).toLowerCase(Locale.ROOT); + if (!HTML_NAME.matcher(tagName).matches() || !APPROVED_HTML_TAGS.contains(tagName)) { + throw refuse(); + } + validateAttributes(tagName, opening.substring(nameEnd)); + boolean voidElement = tagName.equals("br") || tagName.equals("img"); + if (selfClosing != voidElement && (selfClosing || voidElement)) { + throw refuse(); + } + if (!voidElement) { + openTags.addLast(tagName); + } + } + cursor = tagEnd + 1; + } + if (!openTags.isEmpty()) { + throw refuse(); + } + return template; + } + + private static int findTagEnd(String template, int start) { + char quote = 0; + for (int index = start; index < template.length(); index++) { + char current = template.charAt(index); + if (quote != 0) { + if (current == quote) { + quote = 0; + } + } else if (current == '"' || current == '\'') { + quote = current; + } else if (current == '>') { + return index; + } + } + return -1; + } + + private static void validateAttributes(String tagName, String attributes) { + int cursor = 0; + while (cursor < attributes.length()) { + while (cursor < attributes.length() && Character.isWhitespace(attributes.charAt(cursor))) { + cursor++; + } + if (cursor == attributes.length()) { + return; + } + int nameStart = cursor; + while (cursor < attributes.length() + && (Character.isLetterOrDigit(attributes.charAt(cursor)) + || attributes.charAt(cursor) == '-')) { + cursor++; + } + String attributeName = attributes.substring(nameStart, cursor).toLowerCase(Locale.ROOT); + if (!HTML_NAME.matcher(attributeName).matches()) { + throw refuse(); + } + while (cursor < attributes.length() && Character.isWhitespace(attributes.charAt(cursor))) { + cursor++; + } + if (cursor >= attributes.length() || attributes.charAt(cursor++) != '=') { + throw refuse(); + } + while (cursor < attributes.length() && Character.isWhitespace(attributes.charAt(cursor))) { + cursor++; + } + if (cursor >= attributes.length() || attributes.charAt(cursor++) != '"') { + throw refuse(); + } + int valueEnd = attributes.indexOf('"', cursor); + if (valueEnd < 0) { + throw refuse(); + } + String value = attributes.substring(cursor, valueEnd); + if (attributeName.equals("href")) { + if (!tagName.equals("a") || !value.startsWith("https://")) { + throw refuse(); + } + } else if (!APPROVED_INERT_ATTRIBUTES.contains(attributeName)) { + throw refuse(); + } + cursor = valueEnd + 1; + } + } + private static TemplateRenderingException refuse() { return new TemplateRenderingException( NotificationFailureDescriptor.preDispatch( diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/AttemptCorrelationId.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/AttemptCorrelationId.java deleted file mode 100644 index 3a1929a0..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/AttemptCorrelationId.java +++ /dev/null @@ -1,34 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.provider; - -import java.nio.charset.StandardCharsets; -import java.security.MessageDigest; -import java.security.NoSuchAlgorithmException; -import java.util.HexFormat; - -/** Opaque non-PII correlation identity created before a provider send. */ -public record AttemptCorrelationId(String value) - implements NotificationProviderAttemptClient.ReconciliationReference { - - public AttemptCorrelationId { - value = requireOpaque("attempt correlation ID", value); - } - - static AttemptCorrelationId derive(String seed) { - try { - MessageDigest digest = MessageDigest.getInstance("SHA-256"); - return new AttemptCorrelationId( - "ca-" + HexFormat.of().formatHex(digest.digest(seed.getBytes(StandardCharsets.UTF_8)))); - } catch (NoSuchAlgorithmException unavailable) { - throw new IllegalStateException( - "SHA-256 must be available on every Java runtime", unavailable); - } - } - - static String requireOpaque(String field, String value) { - if (value == null || !value.matches("[A-Za-z0-9][A-Za-z0-9._:-]{0,127}")) { - throw new IllegalArgumentException( - field + " must contain 1..128 opaque identifier characters"); - } - return value; - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/InlineNotificationAttemptAdapter.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/InlineNotificationAttemptAdapter.java deleted file mode 100644 index 8426e145..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/InlineNotificationAttemptAdapter.java +++ /dev/null @@ -1,54 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.provider; - -import dev.caskeleton.application.notification.InlineNotificationAttemptPort; -import dev.caskeleton.application.notification.NotificationAttemptId; -import dev.caskeleton.application.notification.NotificationDeliveryId; -import dev.caskeleton.application.notification.NotificationFrozenPlan; -import dev.caskeleton.application.notification.NotificationMode; -import dev.caskeleton.application.notification.NotificationRequestResult; -import dev.caskeleton.application.notification.TargetAttemptOutcome; -import java.time.Instant; -import java.util.ArrayList; -import java.util.List; -import java.util.Objects; - -/** Bounded inline port using the same internal one-authorized-attempt protocol. */ -public final class InlineNotificationAttemptAdapter implements InlineNotificationAttemptPort { - - private final NotificationProviderAttemptAdapter attempts; - - public InlineNotificationAttemptAdapter(NotificationProviderAttemptAdapter attempts) { - this.attempts = Objects.requireNonNull(attempts, "provider attempt adapter must be non-null"); - } - - @Override - public NotificationRequestResult.InlineCompleted attempt(NotificationFrozenPlan plan) { - Objects.requireNonNull(plan, "notification frozen plan must be non-null"); - if (plan.mode() != NotificationMode.BEST_EFFORT_INLINE) { - throw new IllegalArgumentException("inline attempt requires BEST_EFFORT_INLINE plan"); - } - List outcomes = new ArrayList<>(); - for (int ordinal = 0; ordinal < plan.binding().targets().size(); ordinal++) { - String suffix = - AttemptCorrelationId.derive(plan.intentId().value() + ":" + ordinal) - .value() - .substring(3, 35); - NotificationDeliveryId deliveryId = new NotificationDeliveryId("inline-delivery-" + suffix); - NotificationAttemptId attemptId = new NotificationAttemptId("inline-attempt-" + suffix); - String executionToken = "inline-execution-" + suffix; - Instant deadline = - minimum(plan.expiresAt(), attempts.now().plus(plan.binding().perAttemptDeadline())); - outcomes.add( - new TargetAttemptOutcome( - ordinal, - deliveryId, - attempts.attemptInline( - plan, ordinal, deliveryId, attemptId, executionToken, deadline))); - } - return new NotificationRequestResult.InlineCompleted(plan.intentId(), outcomes); - } - - private static Instant minimum(Instant left, Instant right) { - return left.isBefore(right) ? left : right; - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationAdmissionReadinessAdapter.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationAdmissionReadinessAdapter.java deleted file mode 100644 index df65ef07..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationAdmissionReadinessAdapter.java +++ /dev/null @@ -1,163 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.provider; - -import dev.caskeleton.adapter.outbound.notification.catalog.NotificationProviderRuntimeProfile; -import dev.caskeleton.application.notification.NotificationAdmissionReadinessPort; -import dev.caskeleton.application.notification.NotificationReasonCode; -import java.time.Clock; -import java.time.Duration; -import java.time.Instant; -import java.util.Objects; -import java.util.concurrent.ConcurrentHashMap; -import java.util.function.Function; - -/** - * Bridges application admission operations to exact adapter-internal provider readiness evidence. - */ -public final class NotificationAdmissionReadinessAdapter - implements NotificationAdmissionReadinessPort { - - private static final int MAXIMUM_PENDING_PROBES = 1_024; - private static final Duration PROBE_DEADLINE = Duration.ofSeconds(30); - private static final NotificationReasonCode PROBE_FAILED = - new NotificationReasonCode("READINESS_PROBE_FAILED"); - private static final NotificationReasonCode TOKEN_CONFLICT = - new NotificationReasonCode("READINESS_TOKEN_CONFLICT"); - private static final NotificationReasonCode CAPACITY_EXCEEDED = - new NotificationReasonCode("READINESS_CAPACITY_EXCEEDED"); - - private final NotificationAdmissionReadinessPort state; - private final Function profiles; - private final NotificationProviderReadinessProbe readiness; - private final Clock clock; - private final ConcurrentHashMap fresh = new ConcurrentHashMap<>(); - - public NotificationAdmissionReadinessAdapter( - NotificationAdmissionReadinessPort state, - Function profiles, - NotificationProviderReadinessProbe readiness, - Clock clock) { - this.state = Objects.requireNonNull(state, "admission state port must be non-null"); - this.profiles = Objects.requireNonNull(profiles, "runtime profile resolver must be non-null"); - this.readiness = Objects.requireNonNull(readiness, "provider readiness probe must be non-null"); - this.clock = Objects.requireNonNull(clock, "provider readiness clock must be non-null"); - } - - @Override - public ParkResult park(ParkRequest request) { - return Objects.requireNonNull(state.park(request), "admission park result must be non-null"); - } - - @Override - public ReadinessProbe probe(ResumeRequest request) { - Objects.requireNonNull(request, "admission resume request must be non-null"); - Instant probeStartedAt = clock.instant(); - evictExpired(probeStartedAt); - try { - NotificationProviderRuntimeProfile profile = - Objects.requireNonNull(profiles.apply(request), "runtime profile must be non-null"); - CapturedProbe existing = fresh.get(request.operationToken()); - if (existing != null) { - if (!existing.request().equals(request) || !existing.profile().equals(profile)) { - return new ReadinessProbe(false, TOKEN_CONFLICT); - } - return new ReadinessProbe(existing.snapshot().ready(), existing.snapshot().reasonCode()); - } - NotificationProviderReadinessSnapshot snapshot = - Objects.requireNonNull( - readiness.probe(profile, probeStartedAt.plus(PROBE_DEADLINE)), - "provider readiness snapshot must be non-null"); - Instant validatedAt = clock.instant(); - validateExact(profile, snapshot, validatedAt); - if (snapshot.ready()) { - if (fresh.size() >= MAXIMUM_PENDING_PROBES) { - return new ReadinessProbe(false, CAPACITY_EXCEEDED); - } - CapturedProbe captured = new CapturedProbe(request, profile, snapshot); - CapturedProbe collision = fresh.putIfAbsent(request.operationToken(), captured); - if (collision != null && !collision.equals(captured)) { - return new ReadinessProbe(false, TOKEN_CONFLICT); - } - } - return new ReadinessProbe(snapshot.ready(), snapshot.reasonCode()); - } catch (RuntimeException probeFailure) { - return new ReadinessProbe(false, PROBE_FAILED); - } - } - - @Override - public ResumeResult resume(ResumeRequest request, ReadinessProbe probe, Instant resumedAt) { - Objects.requireNonNull(request, "admission resume request must be non-null"); - Objects.requireNonNull(probe, "application readiness probe must be non-null"); - Objects.requireNonNull(resumedAt, "admission resume time must be non-null"); - CapturedProbe captured = fresh.remove(request.operationToken()); - if (captured == null - || !captured.request().equals(request) - || !probe.ready() - || !captured.snapshot().reasonCode().equals(probe.reasonCode()) - || !captured.snapshot().expiresAt().isAfter(resumedAt)) { - throw new IllegalStateException( - "admission resume requires fresh exact provider readiness evidence"); - } - NotificationProviderRuntimeProfile currentProfile; - try { - currentProfile = - Objects.requireNonNull(profiles.apply(request), "runtime profile must be non-null"); - } catch (RuntimeException profileFailure) { - throw new IllegalStateException( - "admission resume requires fresh exact provider readiness evidence"); - } - if (!captured.profile().equals(currentProfile)) { - throw new IllegalStateException( - "admission resume requires the exact probed provider generation"); - } - Instant freshAt = clock.instant(); - if (resumedAt.isAfter(freshAt) || !captured.snapshot().expiresAt().isAfter(freshAt)) { - throw new IllegalStateException( - "admission resume requires currently fresh provider readiness evidence"); - } - return Objects.requireNonNull( - state.resume(request, probe, freshAt), "admission resume result must be non-null"); - } - - @Override - public String toString() { - return "NotificationAdmissionReadinessAdapter[state=, profiles=, " - + "readiness=, pendingProbeCount=" - + fresh.size() - + "]"; - } - - private static void validateExact( - NotificationProviderRuntimeProfile profile, - NotificationProviderReadinessSnapshot snapshot, - Instant now) { - if (!snapshot.profileId().equals(profile.profileId()) - || !snapshot.bindingRevision().equals(profile.bindingRevision()) - || !snapshot.capabilityCardId().equals(profile.capabilityCardId()) - || !snapshot.credentialGeneration().equals(profile.credentialGeneration())) { - throw new IllegalStateException( - "provider readiness snapshot does not match the exact runtime profile"); - } - if (snapshot.observedAt().isAfter(now) - || !snapshot.expiresAt().isAfter(now) - || snapshot.observedAt().isAfter(snapshot.expiresAt())) { - throw new IllegalStateException("provider readiness snapshot is not currently valid"); - } - } - - private void evictExpired(Instant now) { - fresh.entrySet().removeIf(entry -> !entry.getValue().snapshot().expiresAt().isAfter(now)); - } - - private record CapturedProbe( - ResumeRequest request, - NotificationProviderRuntimeProfile profile, - NotificationProviderReadinessSnapshot snapshot) { - - private CapturedProbe { - Objects.requireNonNull(request, "captured resume request must be non-null"); - Objects.requireNonNull(profile, "captured runtime profile must be non-null"); - Objects.requireNonNull(snapshot, "captured readiness snapshot must be non-null"); - } - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationAttemptContext.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationAttemptContext.java deleted file mode 100644 index 28f03e15..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationAttemptContext.java +++ /dev/null @@ -1,54 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.provider; - -import dev.caskeleton.application.notification.NotificationAttemptId; -import dev.caskeleton.application.notification.NotificationDeliveryId; -import java.time.Instant; -import java.util.Objects; -import java.util.Optional; - -/** Immutable one-attempt identities and absolute deadline passed to provider preparation. */ -public record NotificationAttemptContext( - NotificationDeliveryId deliveryId, - NotificationAttemptId attemptId, - int targetOrdinal, - AttemptCorrelationId correlationId, - Optional clientOperationKey, - Instant absoluteDeadline) { - - public NotificationAttemptContext { - Objects.requireNonNull(deliveryId, "notification delivery ID must be non-null"); - Objects.requireNonNull(attemptId, "notification attempt ID must be non-null"); - if (targetOrdinal < 0 || targetOrdinal > 15) { - throw new IllegalArgumentException("notification target ordinal must be in 0..15"); - } - Objects.requireNonNull(correlationId, "attempt correlation ID must be non-null"); - Objects.requireNonNull( - clientOperationKey, "provider client operation key container must be non-null"); - Objects.requireNonNull(absoluteDeadline, "attempt absolute deadline must be non-null"); - } - - @Override - public String toString() { - return "NotificationAttemptContext[deliveryId=, attemptId=" - + attemptId - + ", targetOrdinal=" - + targetOrdinal - + ", correlationId=, clientOperationKey=, absoluteDeadline=" - + absoluteDeadline - + "]"; - } - - /** Native provider operation key, distinct from local correlation and provider message IDs. */ - public record ProviderClientOperationKey(String value) - implements NotificationProviderAttemptClient.ReconciliationReference { - - public ProviderClientOperationKey { - value = AttemptCorrelationId.requireOpaque("provider client operation key", value); - } - - @Override - public String toString() { - return "ProviderClientOperationKey[value=]"; - } - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderAttemptAdapter.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderAttemptAdapter.java deleted file mode 100644 index 83b67ce2..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderAttemptAdapter.java +++ /dev/null @@ -1,363 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.provider; - -import dev.caskeleton.adapter.outbound.notification.catalog.CompiledNotificationBinding; -import dev.caskeleton.adapter.outbound.notification.catalog.NotificationBindingCompiler; -import dev.caskeleton.adapter.outbound.notification.template.NotificationTemplateRenderer; -import dev.caskeleton.adapter.outbound.notification.template.RenderedNotification; -import dev.caskeleton.application.notification.NotificationAttemptId; -import dev.caskeleton.application.notification.NotificationDeliveryId; -import dev.caskeleton.application.notification.NotificationDeliveryStorePort; -import dev.caskeleton.application.notification.NotificationFaultScope; -import dev.caskeleton.application.notification.NotificationFrozenPlan; -import dev.caskeleton.application.notification.NotificationProviderAttemptPort; -import dev.caskeleton.application.notification.NotificationReasonCode; -import dev.caskeleton.application.notification.ProviderAttemptOutcome; -import dev.caskeleton.application.notification.RetryDisposition; -import dev.caskeleton.application.notification.SubmissionCertainty; -import java.time.Clock; -import java.time.Instant; -import java.util.Comparator; -import java.util.Map; -import java.util.Objects; -import java.util.Optional; - -/** Application provider port backed by one compiled binding, renderer and internal client call. */ -public final class NotificationProviderAttemptAdapter implements NotificationProviderAttemptPort { - - private final NotificationBindingCompiler.CompiledGraph graph; - private final Map> renderers; - private final Map clients; - private final NotificationProviderRateAdmission rateAdmission; - private final NotificationProviderSecretMaterialProvider secrets; - private final Clock clock; - - public NotificationProviderAttemptAdapter( - NotificationBindingCompiler.CompiledGraph graph, - Map> renderers, - Map clients, - NotificationProviderRateAdmission rateAdmission, - NotificationProviderSecretMaterialProvider secrets, - Clock clock) { - this.graph = Objects.requireNonNull(graph, "compiled notification graph must be non-null"); - this.renderers = Map.copyOf(Objects.requireNonNull(renderers, "renderers must be non-null")); - this.clients = Map.copyOf(Objects.requireNonNull(clients, "provider clients must be non-null")); - this.rateAdmission = - Objects.requireNonNull(rateAdmission, "provider rate admission must be non-null"); - this.secrets = - Objects.requireNonNull(secrets, "provider secret material provider must be non-null"); - this.clock = Objects.requireNonNull(clock, "provider attempt clock must be non-null"); - } - - @Override - public ProviderAttemptOutcome attempt(NotificationDeliveryStorePort.AuthorizedAttempt attempt) { - Objects.requireNonNull(attempt, "authorized notification attempt must be non-null"); - Instant deadline = - minimum( - attempt.absoluteDeadline(), - clock.instant().plus(attempt.plan().binding().perAttemptDeadline())); - return attemptOne( - attempt.plan(), - attempt.targetOrdinal(), - attempt.deliveryId(), - attempt.attemptId(), - attempt.executionToken(), - deadline); - } - - ProviderAttemptOutcome attemptInline( - NotificationFrozenPlan plan, - int targetOrdinal, - NotificationDeliveryId deliveryId, - NotificationAttemptId attemptId, - String executionToken, - Instant deadline) { - return attemptOne(plan, targetOrdinal, deliveryId, attemptId, executionToken, deadline); - } - - Instant now() { - return clock.instant(); - } - - private ProviderAttemptOutcome attemptOne( - NotificationFrozenPlan plan, - int targetOrdinal, - NotificationDeliveryId deliveryId, - NotificationAttemptId attemptId, - String executionToken, - Instant deadline) { - Objects.requireNonNull(plan, "notification frozen plan must be non-null"); - AttemptCorrelationId correlation = - AttemptCorrelationId.derive(executionToken + ":" + targetOrdinal); - if (!deadline.isAfter(clock.instant())) { - return definitelyNotApplied( - correlation, - RetryDisposition.TERMINAL, - NotificationFaultScope.DELIVERY, - "ATTEMPT_DEADLINE_EXPIRED", - Optional.empty()); - } - - CompiledNotificationBinding binding; - CompiledNotificationBinding.CompiledTarget target; - try { - binding = requireBinding(plan); - target = requireTarget(binding, plan, targetOrdinal); - } catch (RuntimeException retainedBindingFailure) { - return definitelyNotApplied( - correlation, - RetryDisposition.PARK_BINDING, - NotificationFaultScope.ROUTE_REVISION, - "FROZEN_BINDING_UNAVAILABLE", - Optional.empty()); - } - NotificationProviderRateAdmission.Decision admission; - try { - admission = - Objects.requireNonNull( - rateAdmission.admit(target.runtimeProfile(), deadline), - "provider rate admission decision must be non-null"); - } catch (RuntimeException admissionFailure) { - return definitelyNotApplied( - correlation, - RetryDisposition.PARK_BINDING, - NotificationFaultScope.PROVIDER_BINDING, - "PROVIDER_RATE_ADMISSION_FAILED", - Optional.empty()); - } - if (!admission.admitted()) { - Instant retryAt = admission.retryNotBefore().orElseThrow(); - if (!retryAt.isAfter(clock.instant()) || retryAt.isAfter(deadline)) { - return definitelyNotApplied( - correlation, - RetryDisposition.PARK_BINDING, - NotificationFaultScope.PROVIDER_BINDING, - "PROVIDER_RETRY_BOUND_INVALID", - Optional.empty()); - } - return definitelyNotApplied( - correlation, - RetryDisposition.RETRY_AT, - NotificationFaultScope.PROVIDER_BINDING, - admission.reasonCode().value(), - admission.retryNotBefore()); - } - - NotificationTemplateRenderer renderer = - renderers.get(binding.template().rendererRevision()); - NotificationProviderAttemptClient client = clients.get(target.capabilityCard().cardId()); - if (renderer == null || client == null) { - return definitelyNotApplied( - correlation, - RetryDisposition.PARK_BINDING, - NotificationFaultScope.ROUTE_REVISION, - "PROVIDER_BINDING_COMPONENT_UNAVAILABLE", - Optional.empty()); - } - - NotificationAttemptContext context = - new NotificationAttemptContext( - deliveryId, attemptId, targetOrdinal, correlation, Optional.empty(), deadline); - RenderedNotification rendered; - try { - rendered = - Objects.requireNonNull(renderer.render(plan), "rendered notification must be non-null"); - } catch (RuntimeException renderingFailure) { - return definitelyNotApplied( - correlation, - RetryDisposition.PARK_BINDING, - NotificationFaultScope.ROUTE_REVISION, - "TEMPLATE_RENDERING_FAILED", - Optional.empty()); - } - if (rendered.utf8Bytes() > binding.template().maximumRenderedBytes() - || rendered.utf8Bytes() > target.capabilityCard().maximumPayloadBytes()) { - return definitelyNotApplied( - correlation, - RetryDisposition.PARK_BINDING, - NotificationFaultScope.ROUTE_REVISION, - "RENDERED_PAYLOAD_BOUND_EXCEEDED", - Optional.empty()); - } - PreparedNotificationAttempt prepared; - try { - prepared = - Objects.requireNonNull( - client.prepare(rendered, target, context), - "prepared notification attempt must be non-null"); - if (!prepared.rendered().equals(rendered) - || !prepared.target().equals(target) - || !prepared.context().equals(context)) { - return definitelyNotApplied( - correlation, - RetryDisposition.PARK_BINDING, - NotificationFaultScope.PROVIDER_BINDING, - "PROVIDER_PREPARED_ATTEMPT_MISMATCH", - Optional.empty()); - } - } catch (NotificationProviderAttemptClient.PreWireDeliveryRejectedException rejected) { - return definitelyNotApplied( - correlation, - RetryDisposition.TERMINAL, - NotificationFaultScope.DELIVERY, - "PROVIDER_PREWIRE_VALIDATION_FAILED", - Optional.empty()); - } catch (RuntimeException bindingFailure) { - return definitelyNotApplied( - correlation, - RetryDisposition.PARK_BINDING, - NotificationFaultScope.PROVIDER_BINDING, - "PROVIDER_PREWIRE_BINDING_FAILED", - Optional.empty()); - } - - NotificationSecretMaterialHandle acquired; - try { - acquired = - Objects.requireNonNull( - secrets.acquire(target.runtimeProfile()), - "provider secret material handle must be non-null"); - } catch (RuntimeException secretFailure) { - return definitelyNotApplied( - correlation, - RetryDisposition.PARK_BINDING, - NotificationFaultScope.PROVIDER_BINDING, - "PROVIDER_SECRET_ACQUISITION_FAILED", - Optional.empty()); - } - try (NotificationSecretMaterialHandle secret = acquired) { - if (!secret.revision().equals(target.runtimeProfile().credentialGeneration())) { - return definitelyNotApplied( - correlation, - RetryDisposition.PARK_BINDING, - NotificationFaultScope.PROVIDER_BINDING, - "PROVIDER_SECRET_GENERATION_MISMATCH", - Optional.empty()); - } - Instant beforeWire = clock.instant(); - if (!deadline.isAfter(beforeWire)) { - return definitelyNotApplied( - correlation, - RetryDisposition.TERMINAL, - NotificationFaultScope.DELIVERY, - "ATTEMPT_DEADLINE_EXPIRED", - Optional.empty()); - } - try { - NotificationProviderAttemptClient.ClientAttemptResult result = - Objects.requireNonNull( - client.sendOneAuthorizedAttempt(prepared, executionToken, secret, deadline), - "provider client result must be non-null"); - return map(result, correlation, clock.instant(), deadline); - } catch (RuntimeException possibleWriteFailure) { - return new ProviderAttemptOutcome( - SubmissionCertainty.INDETERMINATE, - RetryDisposition.NOT_APPLICABLE, - NotificationFaultScope.DELIVERY, - new NotificationReasonCode("PROVIDER_RESPONSE_INDETERMINATE"), - Optional.empty(), - correlation.value(), - Optional.empty()); - } - } - } - - private CompiledNotificationBinding requireBinding(NotificationFrozenPlan plan) { - return graph.bindings().stream() - .filter(binding -> binding.bindingDigest().equals(plan.binding().bindingDigest())) - .filter(binding -> binding.route().routeId().equals(plan.routeId())) - .filter(binding -> binding.route().routeRevision() == plan.binding().routeRevision()) - .findFirst() - .orElseThrow( - () -> - new IllegalArgumentException( - "frozen plan is outside the compiled notification binding graph")); - } - - private static CompiledNotificationBinding.CompiledTarget requireTarget( - CompiledNotificationBinding binding, NotificationFrozenPlan plan, int ordinal) { - java.util.List ordered = - binding.targets().stream() - .sorted(Comparator.comparing(target -> target.target().targetId())) - .toList(); - if (ordinal < 0 || ordinal >= ordered.size()) { - throw new IllegalArgumentException("notification target ordinal is outside binding"); - } - CompiledNotificationBinding.CompiledTarget target = ordered.get(ordinal); - NotificationFrozenPlan.FrozenTarget frozen = plan.binding().targets().get(ordinal); - if (!frozen.targetReference().equals(target.target().targetId()) - || !frozen.providerCapabilityReference().equals(target.capabilityCard().cardId()) - || !frozen.providerBindingRevision().equals(target.runtimeProfile().bindingRevision()) - || !frozen.credentialGeneration().equals(target.runtimeProfile().credentialGeneration())) { - throw new IllegalArgumentException( - "frozen notification target does not match compiled binding"); - } - return target; - } - - private static ProviderAttemptOutcome map( - NotificationProviderAttemptClient.ClientAttemptResult result, - AttemptCorrelationId correlation, - Instant observedAt, - Instant deadline) { - return switch (result) { - case NotificationProviderAttemptClient.ClientAttemptResult.Accepted accepted -> - new ProviderAttemptOutcome( - SubmissionCertainty.PROVIDER_ACCEPTED, - RetryDisposition.NOT_APPLICABLE, - NotificationFaultScope.DELIVERY, - new NotificationReasonCode("PROVIDER_ACCEPTED"), - Optional.empty(), - correlation.value(), - Optional.of(accepted.providerMessageReference().value())); - case NotificationProviderAttemptClient.ClientAttemptResult.DefinitelyNotApplied rejected -> { - if (rejected.retryDisposition() == RetryDisposition.RETRY_AT - && (rejected.retryNotBefore().orElseThrow().isAfter(deadline) - || !rejected.retryNotBefore().orElseThrow().isAfter(observedAt))) { - yield definitelyNotApplied( - correlation, - RetryDisposition.PARK_BINDING, - NotificationFaultScope.PROVIDER_BINDING, - "PROVIDER_RETRY_BOUND_INVALID", - Optional.empty()); - } - yield new ProviderAttemptOutcome( - SubmissionCertainty.DEFINITELY_NOT_APPLIED, - rejected.retryDisposition(), - rejected.faultScope(), - rejected.reasonCode(), - rejected.retryNotBefore(), - correlation.value(), - Optional.empty()); - } - case NotificationProviderAttemptClient.ClientAttemptResult.Indeterminate indeterminate -> - new ProviderAttemptOutcome( - SubmissionCertainty.INDETERMINATE, - RetryDisposition.NOT_APPLICABLE, - NotificationFaultScope.DELIVERY, - indeterminate.reasonCode(), - Optional.empty(), - correlation.value(), - Optional.empty()); - }; - } - - private static ProviderAttemptOutcome definitelyNotApplied( - AttemptCorrelationId correlation, - RetryDisposition retryDisposition, - NotificationFaultScope scope, - String reasonCode, - Optional retryNotBefore) { - return new ProviderAttemptOutcome( - SubmissionCertainty.DEFINITELY_NOT_APPLIED, - retryDisposition, - scope, - new NotificationReasonCode(reasonCode), - retryNotBefore, - correlation.value(), - Optional.empty()); - } - - private static Instant minimum(Instant left, Instant right) { - return left.isBefore(right) ? left : right; - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderAttemptClient.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderAttemptClient.java deleted file mode 100644 index 0f67f36f..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderAttemptClient.java +++ /dev/null @@ -1,104 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.provider; - -import dev.caskeleton.adapter.outbound.notification.catalog.CompiledNotificationBinding; -import dev.caskeleton.adapter.outbound.notification.template.RenderedNotification; -import dev.caskeleton.application.notification.NotificationFaultScope; -import dev.caskeleton.application.notification.NotificationReasonCode; -import dev.caskeleton.application.notification.RetryDisposition; -import dev.caskeleton.application.notification.SubmissionCertainty; -import java.time.Instant; -import java.util.Objects; -import java.util.Optional; - -/** Adapter-internal provider protocol: pure prepare, then one authorized wire attempt. */ -public interface NotificationProviderAttemptClient { - - PreparedNotificationAttempt prepare( - RenderedNotification rendered, - CompiledNotificationBinding.CompiledTarget target, - NotificationAttemptContext context); - - ClientAttemptResult sendOneAuthorizedAttempt( - PreparedNotificationAttempt prepared, - String executionToken, - NotificationSecretMaterialHandle secret, - Instant absoluteDeadline); - - default ClientReconciliationResult reconcile( - ReconciliationReference reference, - ReconciliationLookupMode lookupMode, - NotificationSecretMaterialHandle secret, - Instant absoluteDeadline) { - return new ClientReconciliationResult( - SubmissionCertainty.INDETERMINATE, - new NotificationReasonCode("RECONCILIATION_UNSUPPORTED")); - } - - sealed interface ReconciliationReference - permits AttemptCorrelationId, - ProviderMessageReference, - NotificationAttemptContext.ProviderClientOperationKey { - - String value(); - } - - sealed interface ClientAttemptResult - permits ClientAttemptResult.Accepted, - ClientAttemptResult.DefinitelyNotApplied, - ClientAttemptResult.Indeterminate { - - record Accepted(ProviderMessageReference providerMessageReference) - implements ClientAttemptResult { - - public Accepted { - Objects.requireNonNull( - providerMessageReference, "provider message reference must be non-null"); - } - } - - record DefinitelyNotApplied( - RetryDisposition retryDisposition, - NotificationFaultScope faultScope, - NotificationReasonCode reasonCode, - Optional retryNotBefore) - implements ClientAttemptResult { - - public DefinitelyNotApplied { - Objects.requireNonNull(retryDisposition, "retry disposition must be non-null"); - Objects.requireNonNull(faultScope, "notification fault scope must be non-null"); - Objects.requireNonNull(reasonCode, "notification reason code must be non-null"); - Objects.requireNonNull(retryNotBefore, "retry-not-before container must be non-null"); - if (retryDisposition == RetryDisposition.NOT_APPLICABLE - || (retryDisposition == RetryDisposition.RETRY_AT) != retryNotBefore.isPresent()) { - throw new IllegalArgumentException( - "definite non-application requires an explicit consistent disposition"); - } - } - } - - record Indeterminate(NotificationReasonCode reasonCode) implements ClientAttemptResult { - - public Indeterminate { - Objects.requireNonNull(reasonCode, "notification reason code must be non-null"); - } - } - } - - record ClientReconciliationResult( - SubmissionCertainty submissionCertainty, NotificationReasonCode reasonCode) { - - public ClientReconciliationResult { - Objects.requireNonNull(submissionCertainty, "submission certainty must be non-null"); - Objects.requireNonNull(reasonCode, "notification reason code must be non-null"); - } - } - - /** Explicit provider-proven invalid recipient/content detected before wire I/O. */ - final class PreWireDeliveryRejectedException extends RuntimeException { - private static final long serialVersionUID = 1L; - - public PreWireDeliveryRejectedException() { - super("provider rejected the prepared delivery before wire I/O"); - } - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderRateAdmission.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderRateAdmission.java deleted file mode 100644 index 49fbf9f8..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderRateAdmission.java +++ /dev/null @@ -1,35 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.provider; - -import dev.caskeleton.adapter.outbound.notification.catalog.NotificationProviderRuntimeProfile; -import dev.caskeleton.application.notification.NotificationReasonCode; -import java.time.Instant; -import java.util.Objects; -import java.util.Optional; - -/** Provider-local bounded quota/rate admission checked before a wire attempt. */ -@FunctionalInterface -public interface NotificationProviderRateAdmission { - - Decision admit(NotificationProviderRuntimeProfile profile, Instant absoluteDeadline); - - record Decision( - boolean admitted, Optional retryNotBefore, NotificationReasonCode reasonCode) { - - public Decision { - Objects.requireNonNull(retryNotBefore, "retry-not-before container must be non-null"); - Objects.requireNonNull(reasonCode, "rate admission reason code must be non-null"); - if (admitted == retryNotBefore.isPresent()) { - throw new IllegalArgumentException( - "admitted rate decision must not have retry time and rejection must have one"); - } - } - - public static Decision admitted(NotificationReasonCode reasonCode) { - return new Decision(true, Optional.empty(), reasonCode); - } - - public static Decision retryAt(Instant retryAt, NotificationReasonCode reasonCode) { - return new Decision(false, Optional.of(retryAt), reasonCode); - } - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderReadinessProbe.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderReadinessProbe.java deleted file mode 100644 index 90f5abc4..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderReadinessProbe.java +++ /dev/null @@ -1,12 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.provider; - -import dev.caskeleton.adapter.outbound.notification.catalog.NotificationProviderRuntimeProfile; -import java.time.Instant; - -/** Bounded control-plane probe that returns non-secret provider identity and capability facts. */ -@FunctionalInterface -public interface NotificationProviderReadinessProbe { - - NotificationProviderReadinessSnapshot probe( - NotificationProviderRuntimeProfile profile, Instant absoluteDeadline); -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderReadinessSnapshot.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderReadinessSnapshot.java deleted file mode 100644 index 3c4eee63..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderReadinessSnapshot.java +++ /dev/null @@ -1,42 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.provider; - -import dev.caskeleton.application.notification.NotificationReasonCode; -import java.time.Duration; -import java.time.Instant; -import java.util.Objects; - -/** Bounded, non-secret, exact provider readiness observation. */ -public record NotificationProviderReadinessSnapshot( - String profileId, - String bindingRevision, - String capabilityCardId, - String credentialGeneration, - boolean ready, - NotificationReasonCode reasonCode, - Instant observedAt, - Instant expiresAt) { - - public NotificationProviderReadinessSnapshot { - profileId = requireSlug("provider profile ID", profileId); - bindingRevision = requireSlug("provider binding revision", bindingRevision); - capabilityCardId = requireSlug("provider capability card ID", capabilityCardId); - credentialGeneration = requireSlug("provider credential generation", credentialGeneration); - Objects.requireNonNull(reasonCode, "provider readiness reason code must be non-null"); - Objects.requireNonNull(observedAt, "provider readiness observation time must be non-null"); - Objects.requireNonNull(expiresAt, "provider readiness expiry time must be non-null"); - Duration validity = Duration.between(observedAt, expiresAt); - if (validity.isZero() - || validity.isNegative() - || validity.compareTo(Duration.ofMinutes(5)) > 0) { - throw new IllegalArgumentException( - "provider readiness validity must be positive and at most five minutes"); - } - } - - private static String requireSlug(String field, String value) { - if (value == null || !value.matches("[a-z][a-z0-9.-]{0,62}")) { - throw new IllegalArgumentException(field + " must match [a-z][a-z0-9.-]{0,62}"); - } - return value; - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderSecretMaterialProvider.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderSecretMaterialProvider.java deleted file mode 100644 index effdc813..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderSecretMaterialProvider.java +++ /dev/null @@ -1,10 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.provider; - -import dev.caskeleton.adapter.outbound.notification.catalog.NotificationProviderRuntimeProfile; - -/** Acquires one operation-scoped mutable secret copy for a runtime profile. */ -@FunctionalInterface -public interface NotificationProviderSecretMaterialProvider { - - NotificationSecretMaterialHandle acquire(NotificationProviderRuntimeProfile profile); -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationReconciliationAdapter.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationReconciliationAdapter.java deleted file mode 100644 index a869b593..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationReconciliationAdapter.java +++ /dev/null @@ -1,151 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.provider; - -import dev.caskeleton.adapter.outbound.notification.catalog.CompiledNotificationBinding; -import dev.caskeleton.adapter.outbound.notification.catalog.NotificationProviderRuntimeProfile; -import dev.caskeleton.application.notification.NotificationDeliveryStorePort; -import dev.caskeleton.application.notification.NotificationReasonCode; -import dev.caskeleton.application.notification.NotificationReconciliationPort; -import dev.caskeleton.application.notification.SubmissionCertainty; -import java.time.Clock; -import java.util.Objects; -import java.util.function.Function; - -/** Maps retained lookup identities to bounded provider reconciliation calls. */ -public final class NotificationReconciliationAdapter implements NotificationReconciliationPort { - - private final Function - bindings; - private final NotificationProviderSecretMaterialProvider secrets; - private final Clock clock; - - public NotificationReconciliationAdapter( - Function bindings, - NotificationProviderSecretMaterialProvider secrets, - Clock clock) { - this.bindings = - Objects.requireNonNull(bindings, "reconciliation binding resolver must be non-null"); - this.secrets = - Objects.requireNonNull(secrets, "reconciliation secret provider must be non-null"); - this.clock = Objects.requireNonNull(clock, "reconciliation clock must be non-null"); - } - - @Override - public ReconciliationOutcome reconcile(NotificationDeliveryStorePort.ReconciliationClaim claim) { - Objects.requireNonNull(claim, "notification reconciliation claim must be non-null"); - if (!claim.absoluteDeadline().isAfter(clock.instant())) { - return indeterminate("RECONCILIATION_DEADLINE_EXPIRED"); - } - try { - ReconciliationBinding binding = - Objects.requireNonNull(bindings.apply(claim), "reconciliation binding must be non-null"); - if (!binding.matches(claim)) { - return indeterminate("RECONCILIATION_BINDING_MISMATCH"); - } - if (!supportsLookup(binding.target(), claim.lookupKind())) { - return indeterminate("RECONCILIATION_UNSUPPORTED"); - } - NotificationProviderAttemptClient.ReconciliationReference reference = reference(claim); - ReconciliationLookupMode mode = mode(claim.lookupKind()); - NotificationProviderRuntimeProfile profile = binding.target().runtimeProfile(); - try (NotificationSecretMaterialHandle secret = secrets.acquire(profile)) { - if (!secret.revision().equals(profile.credentialGeneration())) { - return indeterminate("RECONCILIATION_SECRET_GENERATION_MISMATCH"); - } - if (!claim.absoluteDeadline().isAfter(clock.instant())) { - return indeterminate("RECONCILIATION_DEADLINE_EXPIRED"); - } - NotificationProviderAttemptClient.ClientReconciliationResult result = - Objects.requireNonNull( - binding.client().reconcile(reference, mode, secret, claim.absoluteDeadline()), - "provider reconciliation result must be non-null"); - if (result.submissionCertainty() == SubmissionCertainty.DEFINITELY_NOT_APPLIED) { - return indeterminate("RECONCILIATION_NONAPPLICATION_UNPROVEN"); - } - return new ReconciliationOutcome(result.submissionCertainty(), result.reasonCode()); - } - } catch (RuntimeException providerFailure) { - return indeterminate("RECONCILIATION_INDETERMINATE"); - } - } - - private static NotificationProviderAttemptClient.ReconciliationReference reference( - NotificationDeliveryStorePort.ReconciliationClaim claim) { - return switch (claim.lookupKind()) { - case PRE_SEND_CORRELATION -> new AttemptCorrelationId(claim.lookupReference()); - case CLIENT_OPERATION_KEY -> - new NotificationAttemptContext.ProviderClientOperationKey(claim.lookupReference()); - case MESSAGE_REFERENCE -> new ProviderMessageReference(claim.lookupReference()); - }; - } - - private static ReconciliationLookupMode mode( - NotificationDeliveryStorePort.ReconciliationLookupKind kind) { - return ReconciliationLookupMode.valueOf(kind.name()); - } - - private static boolean supportsLookup( - CompiledNotificationBinding.CompiledTarget target, - NotificationDeliveryStorePort.ReconciliationLookupKind lookupKind) { - return target.capabilityCard().reconciliationSupported() - && target.capabilityCard().maximumReconcileCalls() > 0 - && target.capabilityCard().cardId().equals("aws-ses-v2-durable-single-local-sns-v1") - && lookupKind - == NotificationDeliveryStorePort.ReconciliationLookupKind.PRE_SEND_CORRELATION; - } - - private static ReconciliationOutcome indeterminate(String reason) { - return new ReconciliationOutcome( - SubmissionCertainty.INDETERMINATE, new NotificationReasonCode(reason)); - } - - public static final class ReconciliationBinding { - - private final CompiledNotificationBinding binding; - private final int targetOrdinal; - private final NotificationProviderAttemptClient client; - private final CompiledNotificationBinding.CompiledTarget target; - - public ReconciliationBinding( - CompiledNotificationBinding binding, - int targetOrdinal, - NotificationProviderAttemptClient client) { - this.binding = - Objects.requireNonNull(binding, "reconciliation compiled binding must be non-null"); - if (targetOrdinal < 0 || targetOrdinal >= binding.targets().size()) { - throw new IllegalArgumentException( - "reconciliation target ordinal is outside the compiled binding"); - } - this.targetOrdinal = targetOrdinal; - this.client = Objects.requireNonNull(client, "reconciliation client must be non-null"); - this.target = binding.targets().get(targetOrdinal); - } - - public NotificationProviderAttemptClient client() { - return client; - } - - public CompiledNotificationBinding.CompiledTarget target() { - return target; - } - - private boolean matches(NotificationDeliveryStorePort.ReconciliationClaim claim) { - return binding.route().routeId().equals(claim.routeId()) - && binding.route().routeRevision() == claim.routeRevision() - && binding.bindingDigest().equals(claim.bindingDigest()) - && targetOrdinal == claim.targetOrdinal() - && target.target().targetId().equals(claim.targetReference()) - && target.capabilityCard().cardId().equals(claim.providerCapabilityReference()) - && target.runtimeProfile().bindingRevision().equals(claim.providerBindingRevision()) - && target.runtimeProfile().credentialGeneration().equals(claim.credentialGeneration()); - } - - @Override - public String toString() { - return "ReconciliationBinding[bindingDigest=" - + binding.bindingDigest() - + ", targetOrdinal=" - + targetOrdinal - + ", client=, target=]"; - } - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationSecretMaterialHandle.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationSecretMaterialHandle.java deleted file mode 100644 index 3b4d8e83..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationSecretMaterialHandle.java +++ /dev/null @@ -1,93 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.provider; - -import java.util.Arrays; -import java.util.Objects; -import java.util.function.Function; - -/** Versioned operation-scoped mutable secret copy that wipes itself on close. */ -public final class NotificationSecretMaterialHandle implements AutoCloseable { - - private final String revision; - private byte[] bytes; - private char[] characters; - private boolean closed; - - private NotificationSecretMaterialHandle(String revision, byte[] bytes, char[] characters) { - this.revision = requireSlug(revision); - this.bytes = bytes; - this.characters = characters; - } - - public static NotificationSecretMaterialHandle fromBytes(String revision, byte[] value) { - Objects.requireNonNull(value, "secret byte material must be non-null"); - if (value.length < 1 || value.length > 65_536) { - throw new IllegalArgumentException("secret byte material must contain 1..65536 bytes"); - } - return new NotificationSecretMaterialHandle(revision, value.clone(), null); - } - - public static NotificationSecretMaterialHandle fromCharacters(String revision, char[] value) { - Objects.requireNonNull(value, "secret character material must be non-null"); - if (value.length < 1 || value.length > 65_536) { - throw new IllegalArgumentException("secret character material must contain 1..65536 values"); - } - return new NotificationSecretMaterialHandle(revision, null, value.clone()); - } - - public String revision() { - return revision; - } - - public synchronized T readBytes(Function reader) { - Objects.requireNonNull(reader, "secret byte reader must be non-null"); - requireOpen(); - if (bytes == null) { - throw new IllegalStateException("secret handle does not contain byte material"); - } - return reader.apply(bytes); - } - - public synchronized T readCharacters(Function reader) { - Objects.requireNonNull(reader, "secret character reader must be non-null"); - requireOpen(); - if (characters == null) { - throw new IllegalStateException("secret handle does not contain character material"); - } - return reader.apply(characters); - } - - @Override - public synchronized void close() { - if (!closed) { - if (bytes != null) { - Arrays.fill(bytes, (byte) 0); - } - if (characters != null) { - Arrays.fill(characters, '\0'); - } - closed = true; - } - } - - @Override - public String toString() { - return "NotificationSecretMaterialHandle[revision=" - + revision - + ", material=, closed=" - + closed - + "]"; - } - - private void requireOpen() { - if (closed) { - throw new IllegalStateException("secret material handle is closed"); - } - } - - private static String requireSlug(String value) { - if (value == null || !value.matches("[a-z][a-z0-9.-]{0,62}")) { - throw new IllegalArgumentException("secret revision must match [a-z][a-z0-9.-]{0,62}"); - } - return value; - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/PreparedNotificationAttempt.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/PreparedNotificationAttempt.java deleted file mode 100644 index 157d1b26..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/PreparedNotificationAttempt.java +++ /dev/null @@ -1,31 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.provider; - -import dev.caskeleton.adapter.outbound.notification.catalog.CompiledNotificationBinding; -import dev.caskeleton.adapter.outbound.notification.template.RenderedNotification; -import java.util.Objects; - -/** Side-effect-free provider preparation result for exactly one compiled target. */ -public record PreparedNotificationAttempt( - RenderedNotification rendered, - CompiledNotificationBinding.CompiledTarget target, - NotificationAttemptContext context, - String payloadDigest) { - - public PreparedNotificationAttempt { - Objects.requireNonNull(rendered, "rendered notification must be non-null"); - Objects.requireNonNull(target, "compiled notification target must be non-null"); - Objects.requireNonNull(context, "notification attempt context must be non-null"); - if (payloadDigest == null || !payloadDigest.matches("[0-9a-f]{64}")) { - throw new IllegalArgumentException("prepared payload digest must be lowercase SHA-256"); - } - } - - @Override - public String toString() { - return "PreparedNotificationAttempt[target=" - + target.target().targetId() - + ", rendered=, context=, payloadDigest=" - + payloadDigest - + "]"; - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/ProviderMessageReference.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/ProviderMessageReference.java deleted file mode 100644 index a1641478..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/ProviderMessageReference.java +++ /dev/null @@ -1,15 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.provider; - -/** Opaque provider message identity available only after an accepted response or receipt. */ -public record ProviderMessageReference(String value) - implements NotificationProviderAttemptClient.ReconciliationReference { - - public ProviderMessageReference { - value = AttemptCorrelationId.requireOpaque("provider message reference", value); - } - - @Override - public String toString() { - return "ProviderMessageReference[value=]"; - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/ReconciliationLookupMode.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/ReconciliationLookupMode.java deleted file mode 100644 index fdd03f4d..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/provider/ReconciliationLookupMode.java +++ /dev/null @@ -1,9 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.provider; - -/** Provider-documented lookup identity available for reconciliation. */ -public enum ReconciliationLookupMode { - PRE_SEND_CORRELATION, - CLIENT_OPERATION_KEY, - MESSAGE_REFERENCE, - UNSUPPORTED -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/slack/webhook/SlackWebhookProvider.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/slack/webhook/SlackWebhookProvider.java index b7805947..ca54a980 100644 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/slack/webhook/SlackWebhookProvider.java +++ b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/slack/webhook/SlackWebhookProvider.java @@ -1,12 +1,12 @@ package dev.caskeleton.adapter.outbound.notification.slack.webhook; import dev.caskeleton.adapter.outbound.notification.core.NotificationProvider; -import dev.caskeleton.application.notification.Channel; +import dev.caskeleton.application.notification.NotificationChannel; import dev.caskeleton.application.notification.Notification; /** * Slack incoming-webhook contribution of the {@link NotificationProvider} SPI (channel {@link - * Channel#SLACK}, providerId {@code "slack-webhook"}). Delegates the raw send to the + * NotificationChannel#SLACK}, providerId {@code "slack-webhook"}). Delegates the raw send to the * project-supplied {@link SlackClient} seam; the fail-open policy and PII-safe logging are applied * centrally by {@link * dev.caskeleton.adapter.outbound.notification.core.FailOpenNotificationProvider}, not here — so @@ -26,8 +26,8 @@ public class SlackWebhookProvider implements NotificationProvider { } @Override - public Channel channel() { - return Channel.SLACK; + public NotificationChannel channel() { + return NotificationChannel.SLACK; } @Override diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/LocalEmailRenderer.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/LocalEmailRenderer.java deleted file mode 100644 index 46528403..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/LocalEmailRenderer.java +++ /dev/null @@ -1,473 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.template; - -import dev.caskeleton.application.notification.NotificationChannel; -import dev.caskeleton.application.notification.NotificationFrozenPlan; -import dev.caskeleton.application.notification.NotificationTemplateValue; -import java.nio.charset.StandardCharsets; -import java.util.ArrayDeque; -import java.util.Map; -import java.util.Objects; -import java.util.regex.Matcher; -import java.util.regex.Pattern; - -/** Context-aware local email renderer for reviewed subject, text and HTML resources. */ -public final class LocalEmailRenderer - implements NotificationTemplateRenderer { - - private static final Pattern TOKEN = - Pattern.compile("\\{\\{([a-z][A-Za-z0-9]{0,63})\\|([a-z_]+)}}"); - private static final Pattern HTML_NAME = Pattern.compile("[a-z][a-z0-9-]{0,31}"); - private static final java.util.Set APPROVED_HTML_TAGS = - java.util.Set.of( - "a", "b", "body", "br", "div", "em", "h1", "h2", "h3", "h4", "h5", "h6", "head", "html", - "i", "img", "li", "ol", "p", "span", "strong", "table", "tbody", "td", "th", "thead", - "tr", "ul"); - private static final java.util.Set APPROVED_INERT_ATTRIBUTES = - java.util.Set.of("alt", "aria-label", "title"); - - private final NotificationTemplateCatalog catalog; - - public LocalEmailRenderer(NotificationTemplateCatalog catalog) { - this.catalog = Objects.requireNonNull(catalog, "template catalog must be non-null"); - } - - @Override - public RenderedNotification.Email render(NotificationFrozenPlan plan) { - Objects.requireNonNull(plan, "notification frozen plan must be non-null"); - NotificationTemplateManifest manifest = catalog.require(plan.policy().templateRef()); - validatePlan(plan, manifest, NotificationChannel.EMAIL); - NotificationTemplateCatalog.LoadedResourceSet sources = - catalog.sources(manifest, plan.selectedLocale()); - String subjectTemplate = sources.subject().orElseThrow(); - String textTemplate = sources.text().orElseThrow(); - String htmlTemplate = sources.html().orElseThrow(); - validateTemplateUsage( - java.util.List.of(subjectTemplate, textTemplate, htmlTemplate), manifest.parameterNames()); - validateContexts(subjectTemplate, java.util.Set.of("header"), "email subject"); - validateContexts(textTemplate, java.util.Set.of("text"), "email text"); - validateHtmlContexts(htmlTemplate); - requireAggregateBoundedExpansion( - java.util.List.of(subjectTemplate, textTemplate, htmlTemplate), - plan.parameters().values(), - manifest.maximumRenderedBytes(), - 12); - String subject = - stripOneTrailingLineBreak( - render( - subjectTemplate, - plan.parameters().values(), - manifest.parameterNames(), - manifest.maximumRenderedBytes())); - if (subject.indexOf('\r') >= 0 || subject.indexOf('\n') >= 0) { - throw new TemplateRenderingException("rendered email header contains a line break"); - } - String text = - render( - textTemplate, - plan.parameters().values(), - manifest.parameterNames(), - manifest.maximumRenderedBytes()); - String html = - render( - htmlTemplate, - plan.parameters().values(), - manifest.parameterNames(), - manifest.maximumRenderedBytes()); - int bytes = - subject.getBytes(StandardCharsets.UTF_8).length - + text.getBytes(StandardCharsets.UTF_8).length - + html.getBytes(StandardCharsets.UTF_8).length; - if (bytes > manifest.maximumRenderedBytes()) { - throw new TemplateRenderingException("rendered email exceeds the manifest byte bound"); - } - return new RenderedNotification.Email(sources.locale(), subject, text, html, bytes); - } - - static void validatePlan( - NotificationFrozenPlan plan, - NotificationTemplateManifest manifest, - NotificationChannel expectedChannel) { - if (plan.policy().channel() != expectedChannel || manifest.channel() != expectedChannel) { - throw new TemplateRenderingException("template channel does not match renderer"); - } - if (!plan.binding().templateChecksum().equals(manifest.checksum())) { - throw new TemplateRenderingException("frozen template checksum does not match manifest"); - } - if (!plan.binding().rendererRevision().equals(manifest.rendererRevision())) { - throw new TemplateRenderingException("frozen renderer revision does not match manifest"); - } - if (!plan.parameters().values().keySet().equals(manifest.parameterNames())) { - throw new TemplateRenderingException( - "template parameter names must exactly match the manifest"); - } - } - - static String scalar(NotificationTemplateValue value) { - return switch (value) { - case NotificationTemplateValue.SafeText safeText -> safeText.value(); - case NotificationTemplateValue.TrustedAbsoluteLinkReference link -> link.value(); - case NotificationTemplateValue.LocalDateValue date -> date.value().toString(); - case NotificationTemplateValue.LocalDateTimeValue dateTime -> - dateTime.value().atZone(dateTime.zone()).toString(); - case NotificationTemplateValue.IntegerValue integer -> Long.toString(integer.value()); - case NotificationTemplateValue.MoneyValue money -> - money.amount().toPlainString() + " " + money.currency().getCurrencyCode(); - }; - } - - static String html(String value) { - return value - .replace("&", "&") - .replace("<", "<") - .replace(">", ">") - .replace("\"", """) - .replace("'", "'"); - } - - static String urlComponent(String value) { - StringBuilder encoded = new StringBuilder(); - for (byte item : value.getBytes(StandardCharsets.UTF_8)) { - int unsigned = item & 0xff; - char character = (char) unsigned; - if ((character >= 'a' && character <= 'z') - || (character >= 'A' && character <= 'Z') - || (character >= '0' && character <= '9') - || character == '-' - || character == '.' - || character == '_' - || character == '~') { - encoded.append(character); - } else { - encoded.append('%'); - encoded.append(Character.toUpperCase(Character.forDigit((unsigned >>> 4) & 0xf, 16))); - encoded.append(Character.toUpperCase(Character.forDigit(unsigned & 0xf, 16))); - } - } - return encoded.toString(); - } - - static void validateTemplateUsage( - java.util.List templates, java.util.Set manifestNames) { - java.util.Set used = new java.util.HashSet<>(); - templates.forEach( - template -> { - Matcher matcher = TOKEN.matcher(template); - while (matcher.find()) { - used.add(matcher.group(1)); - } - }); - if (!used.equals(manifestNames)) { - throw new TemplateRenderingException( - "template parameter usage must exactly match the manifest"); - } - } - - private static void validateContexts( - String template, java.util.Set allowedContexts, String assetRole) { - Matcher matcher = TOKEN.matcher(template); - while (matcher.find()) { - if (!allowedContexts.contains(matcher.group(2))) { - throw new TemplateRenderingException( - assetRole + " uses a rendering context that is not approved for that asset"); - } - } - } - - static void validateHtmlContexts(String template) { - validateRestrictedHtml(template); - Matcher matcher = TOKEN.matcher(template); - while (matcher.find()) { - boolean insideTag = isInsideMarkupTag(template, matcher.start()); - switch (matcher.group(2)) { - case "html_text" -> { - if (insideTag) { - throw new TemplateRenderingException( - "HTML text parameter must occur outside markup tags"); - } - } - case "html_attr" -> { - if (!insideTag || !isApprovedHtmlAttribute(template, matcher)) { - throw new TemplateRenderingException( - "HTML attribute parameter is outside an approved inert attribute"); - } - } - case "url_component" -> { - if (!insideTag || !isApprovedUrlComponent(template, matcher)) { - throw new TemplateRenderingException( - "URL component parameter is outside an approved HTTPS link attribute"); - } - } - default -> - throw new TemplateRenderingException( - "email HTML uses a rendering context that is not approved for that asset"); - } - } - } - - private static String render( - String template, - Map parameters, - java.util.Set manifestNames, - int maximumBytes) { - requireBoundedExpansion(template, parameters, maximumBytes); - Matcher matcher = TOKEN.matcher(template); - StringBuilder output = new StringBuilder(Math.min(template.length(), maximumBytes)); - while (matcher.find()) { - String name = matcher.group(1); - NotificationTemplateValue parameter = parameters.get(name); - if (parameter == null || !manifestNames.contains(name)) { - throw new TemplateRenderingException("template references an unknown parameter"); - } - String raw = scalar(parameter); - String replacement = - switch (matcher.group(2)) { - case "header" -> { - if (raw.indexOf('\r') >= 0 || raw.indexOf('\n') >= 0) { - throw new TemplateRenderingException( - "rendered email header parameter contains a line break"); - } - yield raw; - } - case "text" -> raw; - case "html_text" -> html(raw); - case "html_attr" -> htmlAttribute(template, matcher, raw); - case "url_component" -> { - if (!(parameter instanceof NotificationTemplateValue.SafeText)) { - throw new TemplateRenderingException( - "URL component parameters must use bounded safe text values"); - } - yield urlComponent(raw); - } - default -> throw new TemplateRenderingException("unknown email rendering context"); - }; - matcher.appendReplacement(output, Matcher.quoteReplacement(replacement)); - } - matcher.appendTail(output); - if (output.indexOf("{{") >= 0) { - throw new TemplateRenderingException("template has an unresolved parameter"); - } - return output.toString(); - } - - private static void requireBoundedExpansion( - String template, Map parameters, int maximumBytes) { - requireAggregateBoundedExpansion(java.util.List.of(template), parameters, maximumBytes, 12); - } - - static void requireAggregateBoundedExpansion( - java.util.List templates, - Map parameters, - int maximumBytes, - int maximumEscapedBytesPerInputByte) { - long projectedBytes = 0; - for (String template : templates) { - projectedBytes = - Math.addExact(projectedBytes, template.getBytes(StandardCharsets.UTF_8).length); - Matcher matcher = TOKEN.matcher(template); - while (matcher.find()) { - NotificationTemplateValue value = parameters.get(matcher.group(1)); - if (value != null) { - long rawBytes = scalar(value).getBytes(StandardCharsets.UTF_8).length; - projectedBytes = - Math.addExact( - projectedBytes, - Math.multiplyExact(rawBytes, (long) maximumEscapedBytesPerInputByte)); - } - if (projectedBytes > maximumBytes) { - throw new TemplateRenderingException( - "rendered template expansion exceeds the manifest byte bound"); - } - } - } - } - - private static String htmlAttribute(String template, Matcher matcher, String raw) { - if (!isApprovedHtmlAttribute(template, matcher) - || raw.indexOf('`') >= 0 - || raw.chars().anyMatch(Character::isISOControl)) { - throw new TemplateRenderingException( - "HTML attribute parameter is outside an approved quoted non-URL context"); - } - return html(raw); - } - - private static boolean isApprovedHtmlAttribute(String template, Matcher matcher) { - boolean exactlyQuoted = - matcher.start() > 0 - && matcher.end() < template.length() - && template.charAt(matcher.start() - 1) == '"' - && template.charAt(matcher.end()) == '"'; - String prefix = template.substring(Math.max(0, matcher.start() - 64), matcher.start()); - return exactlyQuoted - && prefix - .toLowerCase(java.util.Locale.ROOT) - .matches("(?s).*(title|alt|aria-label)\\s*=\\s*\"$"); - } - - private static boolean isApprovedUrlComponent(String template, Matcher matcher) { - int tagStart = template.lastIndexOf('<', matcher.start()); - int quoteEnd = template.indexOf('"', matcher.end()); - int tagEnd = template.indexOf('>', matcher.end()); - if (tagStart < 0 || quoteEnd < matcher.end() || tagEnd < quoteEnd) { - return false; - } - String attributePrefix = - template.substring(tagStart, matcher.start()).toLowerCase(java.util.Locale.ROOT); - String attributeSuffix = template.substring(matcher.end(), quoteEnd); - return attributePrefix.matches( - "(?s).*\\shref\\s*=\\s*\"https://" - + "[a-z0-9](?:[a-z0-9.-]{0,251}[a-z0-9])?(?::[0-9]{1,5})?" - + "(?:/[^\"{}]*|\\?[^\"{}]*|#[^\"{}]*)$") - && !attributeSuffix.contains("{{") - && !attributeSuffix.contains("}}"); - } - - private static boolean isInsideMarkupTag(String template, int position) { - boolean insideTag = false; - char quote = 0; - for (int index = 0; index < position; index++) { - char current = template.charAt(index); - if (!insideTag) { - if (current == '<') { - insideTag = true; - } - } else if (quote != 0) { - if (current == quote) { - quote = 0; - } - } else if (current == '"' || current == '\'') { - quote = current; - } else if (current == '>') { - insideTag = false; - } - } - return insideTag; - } - - private static void validateRestrictedHtml(String template) { - ArrayDeque openTags = new ArrayDeque<>(); - int cursor = 0; - while (cursor < template.length()) { - int tagStart = template.indexOf('<', cursor); - if (tagStart < 0) { - break; - } - int tagEnd = findTagEnd(template, tagStart + 1); - if (tagEnd < 0) { - throw new TemplateRenderingException("email HTML contains an unterminated markup tag"); - } - String body = template.substring(tagStart + 1, tagEnd).trim(); - if (body.isEmpty() || body.startsWith("!") || body.startsWith("?")) { - throw new TemplateRenderingException("email HTML contains unsupported markup"); - } - if (body.startsWith("/")) { - String closingName = body.substring(1).trim().toLowerCase(java.util.Locale.ROOT); - if (!HTML_NAME.matcher(closingName).matches() - || openTags.isEmpty() - || !openTags.removeLast().equals(closingName)) { - throw new TemplateRenderingException("email HTML contains mismatched markup"); - } - } else { - boolean selfClosing = body.endsWith("/"); - String opening = selfClosing ? body.substring(0, body.length() - 1).trim() : body; - int nameEnd = 0; - while (nameEnd < opening.length() - && (Character.isLetterOrDigit(opening.charAt(nameEnd)) - || opening.charAt(nameEnd) == '-')) { - nameEnd++; - } - String tagName = opening.substring(0, nameEnd).toLowerCase(java.util.Locale.ROOT); - if (!HTML_NAME.matcher(tagName).matches() || !APPROVED_HTML_TAGS.contains(tagName)) { - throw new TemplateRenderingException("email HTML contains an unsupported tag"); - } - validateAttributes(tagName, opening.substring(nameEnd)); - boolean voidElement = tagName.equals("br") || tagName.equals("img"); - if (selfClosing != voidElement && (selfClosing || voidElement)) { - throw new TemplateRenderingException("email HTML uses an invalid void element shape"); - } - if (!voidElement) { - openTags.addLast(tagName); - } - } - cursor = tagEnd + 1; - } - if (!openTags.isEmpty()) { - throw new TemplateRenderingException("email HTML contains unclosed markup"); - } - } - - private static int findTagEnd(String template, int start) { - char quote = 0; - for (int index = start; index < template.length(); index++) { - char current = template.charAt(index); - if (quote != 0) { - if (current == quote) { - quote = 0; - } - } else if (current == '"' || current == '\'') { - quote = current; - } else if (current == '>') { - return index; - } - } - return -1; - } - - private static void validateAttributes(String tagName, String attributes) { - int cursor = 0; - while (cursor < attributes.length()) { - while (cursor < attributes.length() && Character.isWhitespace(attributes.charAt(cursor))) { - cursor++; - } - if (cursor == attributes.length()) { - return; - } - int nameStart = cursor; - while (cursor < attributes.length() - && (Character.isLetterOrDigit(attributes.charAt(cursor)) - || attributes.charAt(cursor) == '-')) { - cursor++; - } - String attributeName = - attributes.substring(nameStart, cursor).toLowerCase(java.util.Locale.ROOT); - if (!HTML_NAME.matcher(attributeName).matches()) { - throw new TemplateRenderingException("email HTML contains malformed attributes"); - } - while (cursor < attributes.length() && Character.isWhitespace(attributes.charAt(cursor))) { - cursor++; - } - if (cursor >= attributes.length() || attributes.charAt(cursor++) != '=') { - throw new TemplateRenderingException("email HTML attributes must have explicit values"); - } - while (cursor < attributes.length() && Character.isWhitespace(attributes.charAt(cursor))) { - cursor++; - } - if (cursor >= attributes.length() || attributes.charAt(cursor++) != '"') { - throw new TemplateRenderingException("email HTML attributes must be double quoted"); - } - int valueEnd = attributes.indexOf('"', cursor); - if (valueEnd < 0) { - throw new TemplateRenderingException("email HTML contains an unterminated attribute"); - } - String value = attributes.substring(cursor, valueEnd); - if (attributeName.equals("href")) { - if (!tagName.equals("a") || !value.startsWith("https://")) { - throw new TemplateRenderingException("email HTML links must be static HTTPS links"); - } - } else if (!APPROVED_INERT_ATTRIBUTES.contains(attributeName)) { - throw new TemplateRenderingException("email HTML contains an unsupported attribute"); - } - cursor = valueEnd + 1; - } - } - - private static String stripOneTrailingLineBreak(String value) { - if (value.endsWith("\r\n")) { - return value.substring(0, value.length() - 2); - } - if (value.endsWith("\n")) { - return value.substring(0, value.length() - 1); - } - return value; - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/NotificationTemplateCatalog.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/NotificationTemplateCatalog.java deleted file mode 100644 index 17f3acb4..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/NotificationTemplateCatalog.java +++ /dev/null @@ -1,253 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.template; - -import dev.caskeleton.application.notification.NotificationTemplateRef; -import java.io.IOException; -import java.io.InputStream; -import java.nio.ByteBuffer; -import java.nio.charset.StandardCharsets; -import java.security.MessageDigest; -import java.security.NoSuchAlgorithmException; -import java.util.Comparator; -import java.util.HashMap; -import java.util.HexFormat; -import java.util.LinkedHashMap; -import java.util.List; -import java.util.Locale; -import java.util.Map; -import java.util.Objects; - -/** - * Loads only manifest-named classpath assets, validates exact checksums, and retains immutable - * text. - */ -public final class NotificationTemplateCatalog { - - private static final int MAXIMUM_RESOURCE_BYTES = 1_000_000; - private static final long MAXIMUM_CATALOG_BYTES = 64L * 1024L * 1024L; - private static final int MAXIMUM_CATALOG_RESOURCES = 4_096; - private static final long MAXIMUM_MANIFEST_BYTES = 16L * 1024L * 1024L; - private static final int MAXIMUM_MANIFEST_RESOURCES = 256; - - private final Map templates; - - public NotificationTemplateCatalog( - ClassLoader classLoader, List manifests) { - Objects.requireNonNull(classLoader, "template class loader must be non-null"); - Objects.requireNonNull(manifests, "template manifests must be non-null"); - Map loaded = new HashMap<>(); - LoadBudget budget = new LoadBudget(MAXIMUM_CATALOG_BYTES, MAXIMUM_CATALOG_RESOURCES); - manifests.stream() - .sorted( - Comparator.comparing( - (NotificationTemplateManifest manifest) -> manifest.templateRef().templateId()) - .thenComparingInt(manifest -> manifest.templateRef().version())) - .forEach( - manifest -> { - Objects.requireNonNull(manifest, "template manifest must be non-null"); - if (loaded.containsKey(manifest.templateRef())) { - throw new TemplateRenderingException("duplicate template manifest"); - } - Map sources = - load(classLoader, manifest.resources(), budget); - String actual = checksumLoaded(sources); - if (!actual.equals(manifest.checksum())) { - throw new TemplateRenderingException("template manifest checksum mismatch"); - } - sources.values().forEach(NotificationTemplateCatalog::rejectDirectives); - loaded.put(manifest.templateRef(), new LoadedTemplate(manifest, sources)); - }); - if (loaded.isEmpty() || loaded.size() > 100) { - throw new TemplateRenderingException("template catalog must contain 1..100 manifests"); - } - this.templates = Map.copyOf(loaded); - } - - public NotificationTemplateManifest require(NotificationTemplateRef templateRef) { - Objects.requireNonNull(templateRef, "template reference must be non-null"); - LoadedTemplate template = templates.get(templateRef); - if (template == null) { - throw new TemplateRenderingException("unknown template revision"); - } - return template.manifest(); - } - - LoadedResourceSet sources(NotificationTemplateManifest manifest, Locale requested) { - LoadedTemplate loaded = templates.get(manifest.templateRef()); - if (loaded == null || !loaded.manifest().equals(manifest)) { - throw new TemplateRenderingException("template manifest is outside the loaded catalog"); - } - Objects.requireNonNull(requested, "frozen selected locale must be non-null"); - Locale selected = Locale.forLanguageTag(requested.toLanguageTag()); - if (!manifest.supportedLocales().contains(selected)) { - throw new TemplateRenderingException( - "frozen selected locale is outside the exact template manifest"); - } - LoadedResourceSet sources = loaded.sources().get(selected); - if (sources == null) { - throw new TemplateRenderingException("selected template locale has no exact resource set"); - } - return sources.withLocale(selected); - } - - public static String checksum( - ClassLoader classLoader, Map resources) { - Objects.requireNonNull(classLoader, "template class loader must be non-null"); - Objects.requireNonNull(resources, "template resources must be non-null"); - return checksumLoaded( - load( - classLoader, - resources, - new LoadBudget(MAXIMUM_MANIFEST_BYTES, MAXIMUM_MANIFEST_RESOURCES))); - } - - private static Map load( - ClassLoader classLoader, - Map resources, - LoadBudget budget) { - LinkedHashMap loaded = new LinkedHashMap<>(); - resources.entrySet().stream() - .sorted(Map.Entry.comparingByKey(Comparator.comparing(Locale::toLanguageTag))) - .forEach( - entry -> { - NotificationTemplateManifest.ResourceSet paths = entry.getValue(); - loaded.put( - entry.getKey(), - new LoadedResourceSet( - entry.getKey(), - paths.subject().map(path -> text(classLoader, path, budget)), - paths.text().map(path -> text(classLoader, path, budget)), - paths.html().map(path -> text(classLoader, path, budget)), - paths.slack().map(path -> text(classLoader, path, budget)))); - }); - return Map.copyOf(loaded); - } - - private static String checksumLoaded(Map sources) { - MessageDigest digest = sha256(); - sources.entrySet().stream() - .sorted(Map.Entry.comparingByKey(Comparator.comparing(Locale::toLanguageTag))) - .forEach( - entry -> { - update(digest, entry.getKey().toLanguageTag()); - LoadedResourceSet resource = entry.getValue(); - updateOptional(digest, "subject", resource.subject()); - updateOptional(digest, "text", resource.text()); - updateOptional(digest, "html", resource.html()); - updateOptional(digest, "slack", resource.slack()); - }); - return HexFormat.of().formatHex(digest.digest()); - } - - private static void updateOptional( - MessageDigest digest, String role, java.util.Optional content) { - content.ifPresent( - value -> { - update(digest, role); - byte[] encoded = value.getBytes(StandardCharsets.UTF_8); - digest.update(ByteBuffer.allocate(Integer.BYTES).putInt(encoded.length).array()); - digest.update(encoded); - }); - } - - private static void rejectDirectives(LoadedResourceSet sources) { - java.util.stream.Stream.of(sources.subject(), sources.text(), sources.html(), sources.slack()) - .flatMap(java.util.Optional::stream) - .forEach( - content -> { - if (content.contains("{{>") - || content.contains("{%") - || content.contains("${") - || content.contains("{{#")) { - throw new TemplateRenderingException( - "template contains unsupported include or reflection directive"); - } - }); - } - - private static String text(ClassLoader classLoader, String path, LoadBudget budget) { - byte[] bytes = read(classLoader, path); - budget.consume(bytes.length); - return new String(bytes, StandardCharsets.UTF_8); - } - - private static byte[] read(ClassLoader classLoader, String path) { - try (InputStream stream = classLoader.getResourceAsStream(path)) { - if (stream == null) { - throw new TemplateRenderingException("manifest resource is missing"); - } - byte[] bytes = stream.readNBytes(MAXIMUM_RESOURCE_BYTES + 1); - if (bytes.length > MAXIMUM_RESOURCE_BYTES) { - throw new TemplateRenderingException("manifest resource exceeds the byte bound"); - } - return bytes; - } catch (IOException failure) { - throw new TemplateRenderingException("manifest resource could not be loaded", failure); - } - } - - private static MessageDigest sha256() { - try { - return MessageDigest.getInstance("SHA-256"); - } catch (NoSuchAlgorithmException unavailable) { - throw new IllegalStateException( - "SHA-256 must be available on every Java runtime", unavailable); - } - } - - private static void update(MessageDigest digest, String value) { - byte[] encoded = value.getBytes(StandardCharsets.UTF_8); - digest.update(ByteBuffer.allocate(Integer.BYTES).putInt(encoded.length).array()); - digest.update(encoded); - } - - record LoadedTemplate( - NotificationTemplateManifest manifest, Map sources) { - - LoadedTemplate { - Objects.requireNonNull(manifest, "loaded template manifest must be non-null"); - sources = Map.copyOf(Objects.requireNonNull(sources, "loaded sources must be non-null")); - } - } - - record LoadedResourceSet( - Locale locale, - java.util.Optional subject, - java.util.Optional text, - java.util.Optional html, - java.util.Optional slack) { - - LoadedResourceSet { - Objects.requireNonNull(locale, "loaded resource locale must be non-null"); - Objects.requireNonNull(subject, "loaded subject container must be non-null"); - Objects.requireNonNull(text, "loaded text container must be non-null"); - Objects.requireNonNull(html, "loaded HTML container must be non-null"); - Objects.requireNonNull(slack, "loaded Slack container must be non-null"); - } - - LoadedResourceSet withLocale(Locale selected) { - return new LoadedResourceSet(selected, subject, text, html, slack); - } - } - - private static final class LoadBudget { - - private final long maximumBytes; - private final int maximumResources; - private long loadedBytes; - private int loadedResources; - - private LoadBudget(long maximumBytes, int maximumResources) { - this.maximumBytes = maximumBytes; - this.maximumResources = maximumResources; - } - - private void consume(int bytes) { - loadedBytes = Math.addExact(loadedBytes, bytes); - loadedResources = Math.addExact(loadedResources, 1); - if (loadedBytes > maximumBytes || loadedResources > maximumResources) { - throw new TemplateRenderingException( - "template catalog exceeds the aggregate resource budget"); - } - } - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/NotificationTemplateManifest.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/NotificationTemplateManifest.java deleted file mode 100644 index 0549f405..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/NotificationTemplateManifest.java +++ /dev/null @@ -1,175 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.template; - -import dev.caskeleton.application.notification.NotificationChannel; -import dev.caskeleton.application.notification.NotificationTemplateRef; -import java.util.Comparator; -import java.util.HashSet; -import java.util.Locale; -import java.util.Map; -import java.util.Objects; -import java.util.Optional; -import java.util.Set; -import java.util.TreeMap; -import java.util.stream.Collectors; - -/** Exact immutable classpath resource manifest for one reviewed template revision. */ -public record NotificationTemplateManifest( - NotificationTemplateRef templateRef, - NotificationChannel channel, - String rendererRevision, - String checksum, - Set supportedLocales, - Locale fallbackLocale, - Set parameterNames, - int maximumRenderedBytes, - Map resources) { - - public NotificationTemplateManifest { - Objects.requireNonNull(templateRef, "template reference must be non-null"); - Objects.requireNonNull(channel, "template channel must be non-null"); - rendererRevision = requireSlug("renderer revision", rendererRevision); - if (checksum == null || !checksum.matches("[0-9a-f]{64}")) { - throw new IllegalArgumentException("template checksum must be a lowercase SHA-256 digest"); - } - Objects.requireNonNull(supportedLocales, "supported locales must be non-null"); - supportedLocales = - supportedLocales.stream() - .map(NotificationTemplateManifest::requireLocale) - .sorted(Comparator.comparing(Locale::toLanguageTag)) - .collect(Collectors.toUnmodifiableSet()); - if (supportedLocales.isEmpty() || supportedLocales.size() > 32) { - throw new IllegalArgumentException("supported locales must contain 1..32 entries"); - } - fallbackLocale = requireLocale(fallbackLocale); - if (!supportedLocales.contains(fallbackLocale)) { - throw new IllegalArgumentException("fallback locale must be supported"); - } - Objects.requireNonNull(parameterNames, "template parameter names must be non-null"); - parameterNames = - parameterNames.stream() - .map(NotificationTemplateManifest::requireParameter) - .collect(Collectors.toUnmodifiableSet()); - if (parameterNames.size() > 32) { - throw new IllegalArgumentException("template parameter names exceed 32 entries"); - } - Objects.requireNonNull(resources, "template resources must be non-null"); - TreeMap> sorted = new TreeMap<>(); - resources.forEach( - (locale, resourceSet) -> { - Locale normalized = requireLocale(locale); - if (sorted.put( - normalized.toLanguageTag(), - Map.entry( - normalized, - Objects.requireNonNull( - resourceSet, "template resource set must be non-null"))) - != null) { - throw new IllegalArgumentException("duplicate normalized template locale"); - } - }); - resources = - sorted.values().stream() - .collect( - Collectors.toUnmodifiableMap( - Map.Entry::getKey, Map.Entry::getValue, (left, right) -> left)); - if (!resources.keySet().equals(supportedLocales)) { - throw new IllegalArgumentException( - "template resource locales must exactly match supported locales"); - } - if (new HashSet<>(resources.keySet()).size() != resources.size()) { - throw new IllegalArgumentException("template resources contain duplicate locales"); - } - resources.values().forEach(resource -> resource.validateFor(channel)); - if (maximumRenderedBytes < 1 || maximumRenderedBytes > 10_000_000) { - throw new IllegalArgumentException("maximum rendered bytes must be in 1..10000000"); - } - } - - public Locale selectLocale(Locale requested) { - Locale normalized = requireLocale(requested); - return supportedLocales.contains(normalized) ? normalized : fallbackLocale; - } - - private static Locale requireLocale(Locale locale) { - Objects.requireNonNull(locale, "template locale must be non-null"); - String tag = locale.toLanguageTag(); - if (locale.equals(Locale.ROOT) || tag.equals("und") || tag.isBlank() || tag.length() > 35) { - throw new IllegalArgumentException("template locale must be explicit and bounded"); - } - return Locale.forLanguageTag(tag); - } - - private static String requireParameter(String name) { - if (name == null || !name.matches("[a-z][A-Za-z0-9]{0,63}")) { - throw new IllegalArgumentException("template parameter must match [a-z][A-Za-z0-9]{0,63}"); - } - return name; - } - - private static String requireSlug(String field, String value) { - if (value == null || !value.matches("[a-z][a-z0-9.-]{0,62}")) { - throw new IllegalArgumentException(field + " must match [a-z][a-z0-9.-]{0,62}"); - } - return value; - } - - /** Channel-shaped exact classpath paths; paths cannot escape the notification template root. */ - public record ResourceSet( - Optional subject, - Optional text, - Optional html, - Optional slack) { - - public ResourceSet { - subject = validateOptional(subject); - text = validateOptional(text); - html = validateOptional(html); - slack = validateOptional(slack); - } - - public static ResourceSet email(String subject, String text, String html) { - return new ResourceSet( - Optional.of(subject), Optional.of(text), Optional.of(html), Optional.empty()); - } - - public static ResourceSet slack(String slack) { - return new ResourceSet( - Optional.empty(), Optional.empty(), Optional.empty(), Optional.of(slack)); - } - - Map rolePaths() { - java.util.LinkedHashMap paths = new java.util.LinkedHashMap<>(); - subject.ifPresent(path -> paths.put("subject", path)); - text.ifPresent(path -> paths.put("text", path)); - html.ifPresent(path -> paths.put("html", path)); - slack.ifPresent(path -> paths.put("slack", path)); - return Map.copyOf(paths); - } - - void validateFor(NotificationChannel channel) { - boolean emailShape = - subject.isPresent() && text.isPresent() && html.isPresent() && slack.isEmpty(); - boolean slackShape = - subject.isEmpty() && text.isEmpty() && html.isEmpty() && slack.isPresent(); - if ((channel == NotificationChannel.EMAIL && !emailShape) - || (channel == NotificationChannel.SLACK && !slackShape)) { - throw new IllegalArgumentException("template resources do not match channel shape"); - } - } - - private static Optional validateOptional(Optional path) { - Objects.requireNonNull(path, "template resource path container must be non-null"); - return path.map( - value -> { - if (!value.matches("notification/templates/[a-z0-9._/-]{1,180}") - || value.contains("..") - || value.startsWith("/") - || value.contains("\\")) { - throw new IllegalArgumentException( - "template resource path must remain under notification/templates"); - } - return value; - }); - } - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/NotificationTemplateRenderer.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/NotificationTemplateRenderer.java deleted file mode 100644 index 79524df5..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/NotificationTemplateRenderer.java +++ /dev/null @@ -1,10 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.template; - -import dev.caskeleton.application.notification.NotificationFrozenPlan; - -/** Deterministic local renderer over an application-owned frozen plan. */ -@FunctionalInterface -public interface NotificationTemplateRenderer { - - T render(NotificationFrozenPlan plan); -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/RenderedNotification.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/RenderedNotification.java deleted file mode 100644 index de1aa1ee..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/RenderedNotification.java +++ /dev/null @@ -1,112 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.template; - -import java.nio.charset.StandardCharsets; -import java.util.List; -import java.util.Locale; -import java.util.Objects; - -/** Closed typed renderer output; arbitrary provider JSON is deliberately absent. */ -public sealed interface RenderedNotification - permits RenderedNotification.Email, RenderedNotification.Slack { - - Locale locale(); - - int utf8Bytes(); - - record Email(Locale locale, String subject, String text, String html, int utf8Bytes) - implements RenderedNotification { - - public Email { - Objects.requireNonNull(locale, "rendered email locale must be non-null"); - Objects.requireNonNull(subject, "rendered email subject must be non-null"); - Objects.requireNonNull(text, "rendered email text must be non-null"); - Objects.requireNonNull(html, "rendered email HTML must be non-null"); - int actual = - subject.getBytes(StandardCharsets.UTF_8).length - + text.getBytes(StandardCharsets.UTF_8).length - + html.getBytes(StandardCharsets.UTF_8).length; - if (utf8Bytes != actual || utf8Bytes < 1) { - throw new IllegalArgumentException("rendered email byte count must be exact and positive"); - } - } - - @Override - public String toString() { - return "Email[locale=" - + locale.toLanguageTag() - + ", content=, utf8Bytes=" - + utf8Bytes - + "]"; - } - } - - record Slack(Locale locale, List blocks, int maximumDepth, int utf8Bytes) - implements RenderedNotification { - - public Slack { - Objects.requireNonNull(locale, "rendered Slack locale must be non-null"); - Objects.requireNonNull(blocks, "rendered Slack blocks must be non-null"); - blocks = - blocks.stream() - .map(block -> Objects.requireNonNull(block, "Slack block must be non-null")) - .toList(); - if (blocks.isEmpty() || blocks.size() > 50) { - throw new IllegalArgumentException("rendered Slack block count must be in 1..50"); - } - if (maximumDepth < 1 || maximumDepth > 8) { - throw new IllegalArgumentException("rendered Slack depth must be in 1..8"); - } - int actual = - blocks.stream() - .mapToInt(block -> block.text().getBytes(StandardCharsets.UTF_8).length) - .sum(); - if (utf8Bytes != actual || utf8Bytes < 1) { - throw new IllegalArgumentException("rendered Slack byte count must be exact and positive"); - } - } - - @Override - public String toString() { - return "Slack[locale=" - + locale.toLanguageTag() - + ", blocks=, maximumDepth=" - + maximumDepth - + ", utf8Bytes=" - + utf8Bytes - + "]"; - } - } - - record SlackBlock(TextType type, String text, boolean verbatim) { - - public SlackBlock { - Objects.requireNonNull(type, "Slack block text type must be non-null"); - Objects.requireNonNull(text, "Slack block text must be non-null"); - if (text.isBlank() || text.length() > 3_000) { - throw new IllegalArgumentException("Slack block text must contain 1..3000 characters"); - } - if (type == TextType.MRKDWN && !verbatim) { - throw new IllegalArgumentException( - "Slack mrkdwn blocks must disable automatic link and mention expansion"); - } - } - - public static SlackBlock mrkdwn(String text) { - return new SlackBlock(TextType.MRKDWN, text, true); - } - - public static SlackBlock plainText(String text) { - return new SlackBlock(TextType.PLAIN_TEXT, text, false); - } - - @Override - public String toString() { - return "SlackBlock[type=" + type + ", text=]"; - } - } - - enum TextType { - MRKDWN, - PLAIN_TEXT - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/SlackBlockKitRenderer.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/SlackBlockKitRenderer.java deleted file mode 100644 index 3e61ef29..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/SlackBlockKitRenderer.java +++ /dev/null @@ -1,124 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.template; - -import dev.caskeleton.application.notification.NotificationChannel; -import dev.caskeleton.application.notification.NotificationFrozenPlan; -import dev.caskeleton.application.notification.NotificationTemplateValue; -import java.nio.charset.StandardCharsets; -import java.util.ArrayList; -import java.util.List; -import java.util.Map; -import java.util.Objects; -import java.util.Set; -import java.util.regex.Matcher; -import java.util.regex.Pattern; - -/** Typed Block Kit renderer preserving plain_text versus mrkdwn context and bounded depth. */ -public final class SlackBlockKitRenderer - implements NotificationTemplateRenderer { - - private static final Pattern TOKEN = - Pattern.compile("\\{\\{([a-z][A-Za-z0-9]{0,63})\\|([a-z_]+)}}"); - - private final NotificationTemplateCatalog catalog; - - public SlackBlockKitRenderer(NotificationTemplateCatalog catalog) { - this.catalog = Objects.requireNonNull(catalog, "template catalog must be non-null"); - } - - @Override - public RenderedNotification.Slack render(NotificationFrozenPlan plan) { - Objects.requireNonNull(plan, "notification frozen plan must be non-null"); - NotificationTemplateManifest manifest = catalog.require(plan.policy().templateRef()); - LocalEmailRenderer.validatePlan(plan, manifest, NotificationChannel.SLACK); - NotificationTemplateCatalog.LoadedResourceSet sources = - catalog.sources(manifest, plan.selectedLocale()); - String template = sources.slack().orElseThrow(); - LocalEmailRenderer.validateTemplateUsage(List.of(template), manifest.parameterNames()); - LocalEmailRenderer.requireAggregateBoundedExpansion( - List.of(template), plan.parameters().values(), manifest.maximumRenderedBytes(), 6); - List blocks = - renderBlocks( - template, - plan.parameters().values(), - manifest.parameterNames(), - manifest.maximumRenderedBytes()); - int bytes = - blocks.stream() - .mapToInt(block -> block.text().getBytes(StandardCharsets.UTF_8).length) - .sum(); - if (bytes > manifest.maximumRenderedBytes()) { - throw new TemplateRenderingException( - "rendered Slack message exceeds the manifest byte bound"); - } - return new RenderedNotification.Slack(sources.locale(), blocks, 3, bytes); - } - - private static List renderBlocks( - String template, - Map parameters, - Set manifestNames, - int maximumBytes) { - List blocks = new ArrayList<>(); - java.util.Iterator lines = template.lines().iterator(); - while (lines.hasNext()) { - if (blocks.size() == 50) { - throw new TemplateRenderingException("rendered Slack block count is outside 1..50"); - } - String line = lines.next(); - boolean mrkdwn = line.contains("|mrkdwn}}"); - if (mrkdwn && (line.contains("|plain}}") || line.contains("|mention}}"))) { - throw new TemplateRenderingException( - "Slack block cannot mix mrkdwn and plain_text contexts"); - } - String rendered = renderLine(line, parameters, manifestNames, maximumBytes); - blocks.add( - mrkdwn - ? RenderedNotification.SlackBlock.mrkdwn(rendered) - : RenderedNotification.SlackBlock.plainText(rendered)); - } - if (blocks.isEmpty()) { - throw new TemplateRenderingException("rendered Slack block count is outside 1..50"); - } - return List.copyOf(blocks); - } - - private static String renderLine( - String template, - Map parameters, - Set manifestNames, - int maximumBytes) { - Matcher matcher = TOKEN.matcher(template); - StringBuilder output = new StringBuilder(Math.min(template.length(), maximumBytes)); - while (matcher.find()) { - String name = matcher.group(1); - NotificationTemplateValue parameter = parameters.get(name); - if (parameter == null || !manifestNames.contains(name)) { - throw new TemplateRenderingException("Slack template references an unknown parameter"); - } - String plain = escapeSlackPlain(LocalEmailRenderer.scalar(parameter)); - String replacement = - switch (matcher.group(2)) { - case "plain" -> plain; - case "mrkdwn" -> - plain - .replace("\\", "\\\\") - .replace("*", "\\*") - .replace("_", "\\_") - .replace("~", "\\~") - .replace("`", "\\`"); - case "mention" -> plain.replace("@", "@\u200B"); - default -> throw new TemplateRenderingException("unknown Slack rendering context"); - }; - matcher.appendReplacement(output, Matcher.quoteReplacement(replacement)); - } - matcher.appendTail(output); - if (output.indexOf("{{") >= 0) { - throw new TemplateRenderingException("Slack template has an unresolved parameter"); - } - return output.toString(); - } - - private static String escapeSlackPlain(String value) { - return value.replace("&", "&").replace("<", "<").replace(">", ">"); - } -} diff --git a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/TemplateRenderingException.java b/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/TemplateRenderingException.java deleted file mode 100644 index 7627cf28..00000000 --- a/src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/template/TemplateRenderingException.java +++ /dev/null @@ -1,15 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.template; - -/** Redacted fail-closed template loading or rendering error. */ -public final class TemplateRenderingException extends RuntimeException { - - private static final long serialVersionUID = 1L; - - public TemplateRenderingException(String safeMessage) { - super(safeMessage); - } - - public TemplateRenderingException(String safeMessage, Throwable cause) { - super(safeMessage, cause); - } -} diff --git a/src/adapter/outbound/notification/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/src/adapter/outbound/notification/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports new file mode 100644 index 00000000..053bcdca --- /dev/null +++ b/src/adapter/outbound/notification/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports @@ -0,0 +1 @@ +dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationPlatformAutoConfiguration diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationBindingCompilerTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationBindingCompilerTest.java deleted file mode 100644 index 4e9c5255..00000000 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationBindingCompilerTest.java +++ /dev/null @@ -1,489 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.catalog; - -import static org.assertj.core.api.Assertions.assertThat; -import static org.assertj.core.api.Assertions.assertThatThrownBy; - -import dev.caskeleton.application.notification.ConsentCheckMode; -import dev.caskeleton.application.notification.EmailRecipientReference; -import dev.caskeleton.application.notification.NotificationAdmissionClass; -import dev.caskeleton.application.notification.NotificationChannel; -import dev.caskeleton.application.notification.NotificationFrozenPlan; -import dev.caskeleton.application.notification.NotificationIntentDraft; -import dev.caskeleton.application.notification.NotificationIntentId; -import dev.caskeleton.application.notification.NotificationKindId; -import dev.caskeleton.application.notification.NotificationKindPolicy; -import dev.caskeleton.application.notification.NotificationMode; -import dev.caskeleton.application.notification.NotificationPlanningResult; -import dev.caskeleton.application.notification.NotificationRouteId; -import dev.caskeleton.application.notification.NotificationRouteStrategy; -import dev.caskeleton.application.notification.NotificationTemplateParameters; -import dev.caskeleton.application.notification.NotificationTemplateRef; -import dev.caskeleton.application.notification.NotificationTemplateValue; -import java.time.Duration; -import java.time.Instant; -import java.util.List; -import java.util.Locale; -import java.util.Map; -import java.util.Optional; -import java.util.Set; -import org.junit.jupiter.api.Test; - -class NotificationBindingCompilerTest { - - @Test - void explicitCatalogCompilesToSortedImmutableGraphAndApplicationFrozenPlan() { - NotificationBindingCompiler compiler = validCompiler(); - - NotificationBindingCompiler.CompiledGraph graph = compiler.compile(); - - assertThat(graph.bindings()) - .extracting(binding -> binding.route().routeId().value()) - .containsExactly("security-email", "security-slack"); - assertThat(graph.bindings()).isUnmodifiable(); - assertThat(graph.manifestDigest()) - .isEqualTo("de53ed4517827786b460009132c5aadad0825a12d3b8e442bb444203c7221ea7"); - assertThat(validCompiler().compile()).isEqualTo(graph); - - NotificationPlanAdapter planner = new NotificationPlanAdapter(graph); - NotificationPlanningResult result = planner.plan(emailDraft()); - assertThat(result).isInstanceOf(NotificationPlanningResult.Planned.class); - NotificationFrozenPlan plan = ((NotificationPlanningResult.Planned) result).plan(); - assertThat(plan.policy().policyRevision()).isEqualTo(17); - assertThat(plan.binding().routeRevision()).isEqualTo(3); - assertThat(plan.binding().bindingDigest()) - .isEqualTo("f9d50c2d559236a397d3607e5fed100141c8673ab8262539ecbeb736b3bfb51d"); - assertThat(plan.binding().rendererRevision()).isEqualTo("email-renderer-r1"); - assertThat(plan.binding().targets()) - .extracting(NotificationFrozenPlan.FrozenTarget::providerCapabilityReference) - .containsExactly("aws-ses-v2-durable-single-local-sns-v1"); - assertThat(plan.toString()).doesNotContain("secret-ref", "destination-ref"); - } - - @Test - void duplicateUnknownAndChannelDriftFailClosed() { - NotificationProviderDescriptor ses = sesProvider(); - assertThatThrownBy( - () -> - new NotificationBindingCompiler( - List.of(ses, ses), validTemplates(), validRoutes(), validProfiles()) - .compile()) - .isInstanceOf(NotificationCatalogException.class) - .hasMessageContaining("duplicate provider"); - - NotificationRouteDescriptor unknownProfile = - emailRoute( - List.of( - new NotificationRouteDescriptor.Target( - "email-primary", "missing-profile", Optional.empty()))); - assertThatThrownBy( - () -> - new NotificationBindingCompiler( - validProviders(), - validTemplates(), - List.of(unknownProfile), - validProfiles()) - .compile()) - .isInstanceOf(NotificationCatalogException.class) - .hasMessageContaining("unknown runtime profile"); - - NotificationProviderRuntimeProfile channelDrift = - new NotificationProviderRuntimeProfile( - "email-runtime-r1", - "slack-web-api", - "slack-binding-r1", - "slack-web-api-durable-single-local-v1", - "credential-r1", - "secret-ref-r1", - "destination-ref-r1"); - assertThatThrownBy( - () -> - new NotificationBindingCompiler( - validProviders(), - validTemplates(), - List.of(emailRoute()), - List.of(channelDrift)) - .compile()) - .isInstanceOf(NotificationCatalogException.class) - .hasMessageContaining("channel"); - - NotificationProviderDescriptor masquerading = - new NotificationProviderDescriptor( - "unknown-slack-family", - NotificationChannel.SLACK, - false, - List.of( - NotificationProviderCapabilityCard.initial( - "slack-web-api-durable-single-local-v1"))); - assertThatThrownBy( - () -> - new NotificationBindingCompiler( - List.of(masquerading), - validTemplates(), - List.of(slackRoute("slack-runtime-r1", false, false, 1)), - List.of( - new NotificationProviderRuntimeProfile( - "slack-runtime-r1", - "unknown-slack-family", - "slack-binding-r1", - "slack-web-api-durable-single-local-v1", - "credential-r1", - "secret-ref-r1", - "destination-ref-r1"))) - .compile()) - .isInstanceOf(NotificationCatalogException.class) - .hasMessageContaining("provider family"); - } - - @Test - void retainedRouteRevisionsRemainCompiledWhileOneExplicitRevisionIsActive() { - NotificationRouteDescriptor retainedEmail = withRevision(emailRoute(), 2); - NotificationBindingCompiler.CompiledGraph graph = - new NotificationBindingCompiler( - validProviders(), - validTemplates(), - List.of( - retainedEmail, emailRoute(), slackRoute("slack-runtime-r1", false, false, 1)), - validProfiles(), - Map.of( - new NotificationRouteId("security-email"), - 3, - new NotificationRouteId("security-slack"), - 3)) - .compile(); - - assertThat(graph.bindings()) - .extracting( - binding -> binding.route().routeId().value() + "#" + binding.route().routeRevision()) - .containsExactly("security-email#2", "security-email#3", "security-slack#3"); - assertThat( - graph.activeBinding(new NotificationRouteId("security-email")).route().routeRevision()) - .isEqualTo(3); - assertThat(graph.bindings()) - .anyMatch( - binding -> - binding.route().routeId().value().equals("security-email") - && binding.route().routeRevision() == 2); - - assertThatThrownBy( - () -> - new NotificationBindingCompiler( - validProviders(), - validTemplates(), - List.of(retainedEmail, emailRoute()), - validProfiles())) - .isInstanceOf(NotificationCatalogException.class) - .hasMessageContaining("explicit active revision"); - } - - @Test - void compiledArtifactsCannotBeForgedThroughPublicConstructors() { - assertThat(CompiledNotificationBinding.class.getDeclaredConstructors()) - .allMatch(constructor -> !java.lang.reflect.Modifier.isPublic(constructor.getModifiers())); - assertThat(CompiledNotificationBinding.CompiledTarget.class.getDeclaredConstructors()) - .allMatch(constructor -> !java.lang.reflect.Modifier.isPublic(constructor.getModifiers())); - assertThat(NotificationBindingCompiler.CompiledGraph.class.getDeclaredConstructors()) - .allMatch(constructor -> !java.lang.reflect.Modifier.isPublic(constructor.getModifiers())); - } - - @Test - void legacyReceiptUnsafeFallbackBoundsAndCyclesAreRejected() { - NotificationProviderDescriptor legacy = - new NotificationProviderDescriptor( - "slack-webhook", NotificationChannel.SLACK, true, List.of()); - NotificationProviderRuntimeProfile legacyProfile = - new NotificationProviderRuntimeProfile( - "legacy-runtime-r0", - "slack-webhook", - "legacy-binding-r0", - "legacy-r0", - "credential-r0", - "legacy-secret-ref", - "legacy-destination-ref"); - assertThatThrownBy( - () -> - new NotificationBindingCompiler( - List.of(legacy), - validTemplates(), - List.of(slackRoute("legacy-runtime-r0", false, false, 1)), - List.of(legacyProfile)) - .compile()) - .isInstanceOf(NotificationCatalogException.class) - .hasMessageContaining("legacy"); - - assertThatThrownBy( - () -> - new NotificationBindingCompiler( - validProviders(), - validTemplates(), - List.of(slackRoute("slack-runtime-r1", true, false, 1)), - validProfiles()) - .compile()) - .isInstanceOf(NotificationCatalogException.class) - .hasMessageContaining("receipt"); - - assertThatThrownBy( - () -> - new NotificationBindingCompiler( - validProviders(), - validTemplates(), - List.of(slackRoute("slack-runtime-r1", false, true, 1)), - validProfiles()) - .compile()) - .isInstanceOf(NotificationCatalogException.class) - .hasMessageContaining("indeterminate"); - - assertThatThrownBy( - () -> - new NotificationBindingCompiler( - validProviders(), - validTemplates(), - List.of(slackRoute("slack-runtime-r1", false, false, 2)), - validProfiles()) - .compile()) - .isInstanceOf(NotificationCatalogException.class) - .hasMessageContaining("attempt"); - - NotificationRouteDescriptor unsupportedFanOut = - new NotificationRouteDescriptor( - new NotificationRouteId("security-slack"), - 3, - NotificationChannel.SLACK, - NotificationMode.DURABLE_ASYNC, - NotificationAdmissionClass.TRANSACTIONAL, - NotificationRouteStrategy.FAN_OUT_ALL, - new NotificationTemplateRef("security-slack", 1), - false, - false, - 2, - 1, - 0, - 0, - 2, - Duration.ofSeconds(5), - List.of( - new NotificationRouteDescriptor.Target( - "target-a", "slack-runtime-r1", Optional.empty()), - new NotificationRouteDescriptor.Target( - "target-b", "slack-runtime-r1", Optional.empty()))); - assertThatThrownBy( - () -> - new NotificationBindingCompiler( - validProviders(), - validTemplates(), - List.of(unsupportedFanOut), - validProfiles()) - .compile()) - .isInstanceOf(NotificationCatalogException.class) - .hasMessageContaining("strategy"); - - NotificationRouteDescriptor cyclic = - new NotificationRouteDescriptor( - new NotificationRouteId("security-slack"), - 3, - NotificationChannel.SLACK, - NotificationMode.DURABLE_ASYNC, - NotificationAdmissionClass.TRANSACTIONAL, - NotificationRouteStrategy.ORDERED_FALLBACK, - new NotificationTemplateRef("security-slack", 1), - false, - false, - 2, - 1, - 1, - 0, - 2, - Duration.ofSeconds(5), - List.of( - new NotificationRouteDescriptor.Target( - "target-a", "slack-runtime-r1", Optional.of("target-b")), - new NotificationRouteDescriptor.Target( - "target-b", "slack-runtime-r1", Optional.of("target-a")))); - assertThatThrownBy( - () -> - new NotificationBindingCompiler( - validProviders(), validTemplates(), List.of(cyclic), validProfiles()) - .compile()) - .isInstanceOf(NotificationCatalogException.class) - .hasMessageContaining("strategy"); - } - - static NotificationBindingCompiler validCompiler() { - return new NotificationBindingCompiler( - validProviders(), validTemplates(), validRoutes(), validProfiles()); - } - - static List validProviders() { - return List.of( - sesProvider(), - new NotificationProviderDescriptor( - "slack-web-api", - NotificationChannel.SLACK, - false, - List.of( - NotificationProviderCapabilityCard.initial("slack-web-api-inline-single-local-v1"), - NotificationProviderCapabilityCard.initial( - "slack-web-api-durable-single-local-v1")))); - } - - static NotificationProviderDescriptor sesProvider() { - return new NotificationProviderDescriptor( - "aws-ses-v2", - NotificationChannel.EMAIL, - false, - List.of( - NotificationProviderCapabilityCard.initial("aws-ses-v2-durable-single-local-sns-v1"))); - } - - static List validTemplates() { - return List.of( - new NotificationTemplateDescriptor( - new NotificationTemplateRef("security-email", 1), - NotificationChannel.EMAIL, - "email-renderer-r1", - "1".repeat(64), - Set.of(Locale.ENGLISH, Locale.KOREAN), - Locale.ENGLISH, - Set.of("displayName"), - 64_000), - new NotificationTemplateDescriptor( - new NotificationTemplateRef("security-slack", 1), - NotificationChannel.SLACK, - "slack-renderer-r1", - "2".repeat(64), - Set.of(Locale.ENGLISH), - Locale.ENGLISH, - Set.of("displayName"), - 32_000)); - } - - static List validRoutes() { - return List.of(emailRoute(), slackRoute("slack-runtime-r1", false, false, 1)); - } - - static NotificationRouteDescriptor emailRoute() { - return emailRoute( - List.of( - new NotificationRouteDescriptor.Target( - "email-primary", "email-runtime-r1", Optional.empty()))); - } - - static NotificationRouteDescriptor emailRoute(List targets) { - return new NotificationRouteDescriptor( - new NotificationRouteId("security-email"), - 3, - NotificationChannel.EMAIL, - NotificationMode.DURABLE_ASYNC, - NotificationAdmissionClass.SECURITY_CRITICAL, - NotificationRouteStrategy.SINGLE, - new NotificationTemplateRef("security-email", 1), - true, - false, - 1, - 1, - 0, - 1, - 2, - Duration.ofSeconds(5), - targets); - } - - private static NotificationRouteDescriptor withRevision( - NotificationRouteDescriptor route, int revision) { - return new NotificationRouteDescriptor( - route.routeId(), - revision, - route.channel(), - route.mode(), - route.admissionClass(), - route.routeStrategy(), - route.templateRef(), - route.receiptRequired(), - route.fallbackAfterIndeterminate(), - route.maximumTargets(), - route.maximumPhysicalAttempts(), - route.maximumFallbackActivations(), - route.maximumReconcileCalls(), - route.maximumTotalProviderCalls(), - route.perAttemptDeadline(), - route.targets()); - } - - static NotificationRouteDescriptor slackRoute( - String profileId, - boolean receiptRequired, - boolean fallbackAfterIndeterminate, - int maximumAttempts) { - return new NotificationRouteDescriptor( - new NotificationRouteId("security-slack"), - 3, - NotificationChannel.SLACK, - NotificationMode.DURABLE_ASYNC, - NotificationAdmissionClass.TRANSACTIONAL, - NotificationRouteStrategy.SINGLE, - new NotificationTemplateRef("security-slack", 1), - receiptRequired, - fallbackAfterIndeterminate, - 1, - maximumAttempts, - 0, - 0, - maximumAttempts, - Duration.ofSeconds(5), - List.of( - new NotificationRouteDescriptor.Target("slack-primary", profileId, Optional.empty()))); - } - - static List validProfiles() { - return List.of( - new NotificationProviderRuntimeProfile( - "email-runtime-r1", - "aws-ses-v2", - "ses-binding-r1", - "aws-ses-v2-durable-single-local-sns-v1", - "credential-r1", - "secret-ref-r1", - "destination-ref-r1"), - new NotificationProviderRuntimeProfile( - "slack-runtime-r1", - "slack-web-api", - "slack-binding-r1", - "slack-web-api-durable-single-local-v1", - "credential-r1", - "secret-ref-r1", - "destination-ref-r1")); - } - - private static NotificationIntentDraft emailDraft() { - NotificationKindPolicy policy = - new NotificationKindPolicy( - new NotificationKindId("security-alert"), - NotificationChannel.EMAIL, - new NotificationRouteId("security-email"), - new NotificationTemplateRef("security-email", 1), - NotificationMode.DURABLE_ASYNC, - NotificationAdmissionClass.SECURITY_CRITICAL, - NotificationRouteStrategy.SINGLE, - ConsentCheckMode.RECHECK_BEFORE_EACH_DELIVERY, - 17, - 1, - 1, - 0, - 1, - 2, - Duration.ofMinutes(10)); - return new NotificationIntentDraft( - new NotificationIntentId("intent-42"), - policy, - Locale.KOREAN, - new EmailRecipientReference("recipient-ref-42"), - new NotificationTemplateParameters( - Map.of("displayName", new NotificationTemplateValue.SafeText("Ada"))), - "idempotency-scope-42", - "operation-42", - Optional.empty(), - "correlation-42", - Optional.empty(), - Instant.parse("2026-07-29T00:00:00Z"), - Instant.parse("2026-07-29T00:10:00Z")); - } -} diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationCanonicalRouteCatalogTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationCanonicalRouteCatalogTest.java deleted file mode 100644 index d0f19921..00000000 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationCanonicalRouteCatalogTest.java +++ /dev/null @@ -1,54 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.catalog; - -import static org.assertj.core.api.Assertions.assertThat; -import static org.assertj.core.api.Assertions.assertThatThrownBy; - -import dev.caskeleton.application.notification.NotificationCanonicalWriterRouteSet; -import java.util.List; -import java.util.Map; -import org.junit.jupiter.api.Test; - -class NotificationCanonicalRouteCatalogTest { - - @Test - void retainedKeyOnlyCatalogMapsOnlyWithExactReviewedGenerationConfig() { - NotificationCanonicalRouteCatalog catalog = - NotificationCanonicalRouteCatalog.fromCompiledGraph( - NotificationBindingCompilerTest.validCompiler().compile()); - List keys = catalog.routes(); - Map generations = - Map.of(keys.get(0), 7L, keys.get(1), 3L); - - NotificationCanonicalWriterRouteSet application = catalog.toApplication(generations); - - assertThat(application.routes()) - .extracting(route -> route.routeId().value()) - .containsExactly("security-email", "security-slack"); - assertThat(catalog.digest()) - .isEqualTo("c5bad4ab5dffa98fb73e14629e9b62dd6d62ec4c562c526b67680937484559e1"); - assertThat( - NotificationCanonicalRouteCatalog.fromCompiledGraph( - NotificationBindingCompilerTest.validCompiler().compile())) - .isEqualTo(catalog); - } - - @Test - void generationConfigAndRouteKeysMustMatchExactly() { - NotificationCanonicalRouteCatalog catalog = - NotificationCanonicalRouteCatalog.fromCompiledGraph( - NotificationBindingCompilerTest.validCompiler().compile()); - NotificationCanonicalRouteCatalog.RouteKey first = catalog.routes().getFirst(); - - assertThatThrownBy(() -> catalog.toApplication(Map.of(first, 7L))) - .isInstanceOf(NotificationCatalogException.class) - .hasMessageContaining("exactly"); - assertThatThrownBy( - () -> - NotificationCanonicalRouteCatalog.fromRoutes( - List.of( - NotificationBindingCompilerTest.emailRoute(), - NotificationBindingCompilerTest.emailRoute()))) - .isInstanceOf(NotificationCatalogException.class) - .hasMessageContaining("duplicate"); - } -} diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationCutoverRouteCatalogTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationCutoverRouteCatalogTest.java deleted file mode 100644 index e162f1a8..00000000 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/catalog/NotificationCutoverRouteCatalogTest.java +++ /dev/null @@ -1,123 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.catalog; - -import static org.assertj.core.api.Assertions.assertThat; -import static org.assertj.core.api.Assertions.assertThatThrownBy; - -import dev.caskeleton.application.notification.NotificationWriterRouteSet; -import java.util.List; -import java.util.Map; -import java.util.Optional; -import org.junit.jupiter.api.Test; - -class NotificationCutoverRouteCatalogTest { - - @Test - void preDecoratorCannotChangeCanonicalKeysAndDigestCoversCompleteProofRegistry() { - NotificationCanonicalRouteCatalog canonical = - NotificationCanonicalRouteCatalog.fromCompiledGraph( - NotificationBindingCompilerTest.validCompiler().compile()); - NotificationCutoverRouteCatalog catalog = - new NotificationCutoverRouteCatalog(canonical, validCutoverRoutes(canonical)); - Map generations = - Map.of(canonical.routes().get(0), 7L, canonical.routes().get(1), 3L); - - NotificationWriterRouteSet application = catalog.toApplication(generations); - - assertThat(application.routeProfiles()).hasSize(2); - assertThat(application.routeProfiles().getFirst().transportProfiles()) - .extracting(NotificationWriterRouteSet.TransportProfile::profileId) - .containsExactly("legacy-http-v1", "legacy-http-v2"); - assertThat(catalog.digest()) - .isEqualTo("62b2da4489adbec34cc124da093b1e95e8d0c4999ca3f3e824b2859592474faa"); - - NotificationCutoverRouteCatalog changed = - new NotificationCutoverRouteCatalog( - canonical, - List.of( - new NotificationCutoverRouteCatalog.CutoverRoute( - canonical.routes().get(0), - Optional.of("legacy-email"), - List.of( - new NotificationCutoverRouteCatalog.LegacyTransportProfile( - "legacy-http-v1", - NotificationWriterRouteSet.ProofClass.QUIESCENCE_REQUIRED, - "evidence-r2", - true, - false))), - validCutoverRoutes(canonical).get(1))); - assertThat(changed.digest()).isNotEqualTo(catalog.digest()); - } - - @Test - void missingKeysAliasesProfilesAndUnreviewedHardBoundsFailClosed() { - NotificationCanonicalRouteCatalog canonical = - NotificationCanonicalRouteCatalog.fromCompiledGraph( - NotificationBindingCompilerTest.validCompiler().compile()); - - assertThatThrownBy( - () -> - new NotificationCutoverRouteCatalog( - canonical, List.of(validCutoverRoutes(canonical).getFirst()))) - .isInstanceOf(NotificationCatalogException.class) - .hasMessageContaining("exactly"); - - List duplicateAlias = - List.of( - validCutoverRoutes(canonical).get(0), - new NotificationCutoverRouteCatalog.CutoverRoute( - canonical.routes().get(1), - Optional.of("legacy-email"), - List.of( - new NotificationCutoverRouteCatalog.LegacyTransportProfile( - "legacy-slack-v1", - NotificationWriterRouteSet.ProofClass.QUIESCENCE_REQUIRED, - "evidence-r1", - true, - false)))); - assertThatThrownBy(() -> new NotificationCutoverRouteCatalog(canonical, duplicateAlias)) - .isInstanceOf(NotificationCatalogException.class) - .hasMessageContaining("alias"); - - assertThatThrownBy( - () -> - new NotificationCutoverRouteCatalog.LegacyTransportProfile( - "legacy-hard-v1", - NotificationWriterRouteSet.ProofClass.HARD_BOUND_PROVEN, - "hard-bound-r1", - true, - false)) - .isInstanceOf(IllegalArgumentException.class) - .hasMessageContaining("reviewed"); - } - - static List validCutoverRoutes( - NotificationCanonicalRouteCatalog canonical) { - return List.of( - new NotificationCutoverRouteCatalog.CutoverRoute( - canonical.routes().get(0), - Optional.of("legacy-email"), - List.of( - new NotificationCutoverRouteCatalog.LegacyTransportProfile( - "legacy-http-v1", - NotificationWriterRouteSet.ProofClass.QUIESCENCE_REQUIRED, - "evidence-r1", - false, - false), - new NotificationCutoverRouteCatalog.LegacyTransportProfile( - "legacy-http-v2", - NotificationWriterRouteSet.ProofClass.QUIESCENCE_REQUIRED, - "evidence-r2", - true, - false))), - new NotificationCutoverRouteCatalog.CutoverRoute( - canonical.routes().get(1), - Optional.of("legacy-slack"), - List.of( - new NotificationCutoverRouteCatalog.LegacyTransportProfile( - "legacy-slack-v1", - NotificationWriterRouteSet.ProofClass.HARD_BOUND_PROVEN, - "hard-bound-r2", - true, - true)))); - } -} diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/core/NotificationAdapterTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/core/NotificationAdapterTest.java index 450f4afd..77ef017d 100644 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/core/NotificationAdapterTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/core/NotificationAdapterTest.java @@ -9,7 +9,7 @@ import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.read.ListAppender; import dev.caskeleton.adapter.outbound.support.FailOpenDependencyLogger; import dev.caskeleton.adapter.outbound.support.OutboundCorrelation; -import dev.caskeleton.application.notification.Channel; +import dev.caskeleton.application.notification.NotificationChannel; import dev.caskeleton.application.notification.Notification; import dev.caskeleton.shared.error.AdapterDisabledException; import java.util.List; @@ -62,10 +62,10 @@ class NotificationAdapterTest { MDC.clear(); } - private static NotificationProvider failingProvider(Channel channel, String id) { + private static NotificationProvider failingProvider(NotificationChannel channel, String id) { return new NotificationProvider() { @Override - public Channel channel() { + public NotificationChannel channel() { return channel; } @@ -89,7 +89,7 @@ class NotificationAdapterTest { void emailSendFailureIsFailOpenAndNeverRethrows() { FailOpenNotificationProvider failOpen = new FailOpenNotificationProvider( - failingProvider(Channel.EMAIL, "google-email"), dependencyLogger); + failingProvider(NotificationChannel.EMAIL, "google-email"), dependencyLogger); assertThatCode(() -> failOpen.send(PII_NOTIFICATION)).doesNotThrowAnyException(); } @@ -99,7 +99,7 @@ class NotificationAdapterTest { MDC.put(OutboundCorrelation.MDC_KEY, "corr-email-1"); FailOpenNotificationProvider failOpen = new FailOpenNotificationProvider( - failingProvider(Channel.EMAIL, "google-email"), dependencyLogger); + failingProvider(NotificationChannel.EMAIL, "google-email"), dependencyLogger); failOpen.send(PII_NOTIFICATION); @@ -121,7 +121,7 @@ class NotificationAdapterTest { void slackSendFailureIsFailOpenAndNeverRethrows() { FailOpenNotificationProvider failOpen = new FailOpenNotificationProvider( - failingProvider(Channel.SLACK, "slack-webhook"), dependencyLogger); + failingProvider(NotificationChannel.SLACK, "slack-webhook"), dependencyLogger); assertThatCode(() -> failOpen.send(PII_NOTIFICATION)).doesNotThrowAnyException(); } @@ -131,7 +131,7 @@ class NotificationAdapterTest { MDC.put(OutboundCorrelation.MDC_KEY, "corr-slack-1"); FailOpenNotificationProvider failOpen = new FailOpenNotificationProvider( - failingProvider(Channel.SLACK, "slack-webhook"), dependencyLogger); + failingProvider(NotificationChannel.SLACK, "slack-webhook"), dependencyLogger); failOpen.send(PII_NOTIFICATION); @@ -156,7 +156,7 @@ class NotificationAdapterTest { void unboundRouteThrowsAdapterDisabledExceptionForEmail() { RoutingNotifier notifier = new RoutingNotifier(List.of(), Map.of()); - assertThatThrownBy(() -> notifier.notify(Channel.EMAIL, PII_NOTIFICATION)) + assertThatThrownBy(() -> notifier.notify(NotificationChannel.EMAIL, PII_NOTIFICATION)) .isInstanceOf(AdapterDisabledException.class) .extracting("adapterName") .isEqualTo("notification"); @@ -166,7 +166,7 @@ class NotificationAdapterTest { void unboundRouteThrowsAdapterDisabledExceptionForSlack() { RoutingNotifier notifier = new RoutingNotifier(List.of(), Map.of()); - assertThatThrownBy(() -> notifier.notify(Channel.SLACK, "alerts", PII_NOTIFICATION)) + assertThatThrownBy(() -> notifier.notify(NotificationChannel.SLACK, "alerts", PII_NOTIFICATION)) .isInstanceOf(AdapterDisabledException.class) .extracting("adapterName") .isEqualTo("notification"); diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/core/RoutingNotifierTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/core/RoutingNotifierTest.java index 8f120fc7..d4341925 100644 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/core/RoutingNotifierTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/core/RoutingNotifierTest.java @@ -9,7 +9,7 @@ import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.read.ListAppender; import dev.caskeleton.adapter.outbound.support.FailOpenDependencyLogger; import dev.caskeleton.adapter.outbound.support.OutboundCorrelation; -import dev.caskeleton.application.notification.Channel; +import dev.caskeleton.application.notification.NotificationChannel; import dev.caskeleton.application.notification.Notification; import dev.caskeleton.shared.error.AdapterDisabledException; import java.util.ArrayList; @@ -74,10 +74,10 @@ class RoutingNotifierTest { // Stub helpers // ------------------------------------------------------------------------- - private static NotificationProvider stubProvider(Channel channel, String providerId) { + private static NotificationProvider stubProvider(NotificationChannel channel, String providerId) { return new NotificationProvider() { @Override - public Channel channel() { + public NotificationChannel channel() { return channel; } @@ -94,10 +94,10 @@ class RoutingNotifierTest { } private static NotificationProvider countingProvider( - Channel channel, String providerId, AtomicInteger counter) { + NotificationChannel channel, String providerId, AtomicInteger counter) { return new NotificationProvider() { @Override - public Channel channel() { + public NotificationChannel channel() { return channel; } @@ -113,10 +113,10 @@ class RoutingNotifierTest { }; } - private static NotificationProvider failingProvider(Channel channel, String providerId) { + private static NotificationProvider failingProvider(NotificationChannel channel, String providerId) { return new NotificationProvider() { @Override - public Channel channel() { + public NotificationChannel channel() { return channel; } @@ -145,7 +145,7 @@ class RoutingNotifierTest { void failOpenProviderSwallowsExceptionAndNeverRethrows() { FailOpenNotificationProvider failOpenProv = new FailOpenNotificationProvider( - failingProvider(Channel.EMAIL, "google-email"), dependencyLogger); + failingProvider(NotificationChannel.EMAIL, "google-email"), dependencyLogger); assertThatCode(() -> failOpenProv.send(PII_NOTIFICATION)).doesNotThrowAnyException(); } @@ -155,7 +155,7 @@ class RoutingNotifierTest { MDC.put(OutboundCorrelation.MDC_KEY, "corr-1"); FailOpenNotificationProvider failOpenProv = new FailOpenNotificationProvider( - failingProvider(Channel.EMAIL, "google-email"), dependencyLogger); + failingProvider(NotificationChannel.EMAIL, "google-email"), dependencyLogger); failOpenProv.send(PII_NOTIFICATION); @@ -177,9 +177,9 @@ class RoutingNotifierTest { void failOpenProviderDelegatesChannelAndProviderId() { FailOpenNotificationProvider failOpenProv = new FailOpenNotificationProvider( - stubProvider(Channel.SLACK, "slack-webhook"), dependencyLogger); + stubProvider(NotificationChannel.SLACK, "slack-webhook"), dependencyLogger); - assertThat(failOpenProv.channel()).isEqualTo(Channel.SLACK); + assertThat(failOpenProv.channel()).isEqualTo(NotificationChannel.SLACK); assertThat(failOpenProv.providerId()).isEqualTo("slack-webhook"); } @@ -187,7 +187,7 @@ class RoutingNotifierTest { void failOpenProviderLogsSuccessOnSendWithNoPii() { FailOpenNotificationProvider failOpenProv = new FailOpenNotificationProvider( - stubProvider(Channel.EMAIL, "google-email"), dependencyLogger); + stubProvider(NotificationChannel.EMAIL, "google-email"), dependencyLogger); failOpenProv.send(PII_NOTIFICATION); @@ -206,12 +206,12 @@ class RoutingNotifierTest { void defaultRouteSendsToSingleProviderOnce() { AtomicInteger sendCount = new AtomicInteger(); List providers = - List.of(failOpen(countingProvider(Channel.EMAIL, "google-email", sendCount))); - Map>> routes = - Map.of(Channel.EMAIL, Map.of("default", List.of("google-email"))); + List.of(failOpen(countingProvider(NotificationChannel.EMAIL, "google-email", sendCount))); + Map>> routes = + Map.of(NotificationChannel.EMAIL, Map.of("default", List.of("google-email"))); RoutingNotifier notifier = new RoutingNotifier(providers, routes); - notifier.notify(Channel.EMAIL, PII_NOTIFICATION); + notifier.notify(NotificationChannel.EMAIL, PII_NOTIFICATION); assertThat(sendCount.get()).isEqualTo(1); } @@ -222,13 +222,13 @@ class RoutingNotifierTest { AtomicInteger sendB = new AtomicInteger(); List providers = List.of( - failOpen(countingProvider(Channel.EMAIL, "provider-a", sendA)), - failOpen(countingProvider(Channel.EMAIL, "provider-b", sendB))); - Map>> routes = - Map.of(Channel.EMAIL, Map.of("alerts", List.of("provider-a", "provider-b"))); + failOpen(countingProvider(NotificationChannel.EMAIL, "provider-a", sendA)), + failOpen(countingProvider(NotificationChannel.EMAIL, "provider-b", sendB))); + Map>> routes = + Map.of(NotificationChannel.EMAIL, Map.of("alerts", List.of("provider-a", "provider-b"))); RoutingNotifier notifier = new RoutingNotifier(providers, routes); - notifier.notify(Channel.EMAIL, "alerts", PII_NOTIFICATION); + notifier.notify(NotificationChannel.EMAIL, "alerts", PII_NOTIFICATION); assertThat(sendA.get()).isEqualTo(1); assertThat(sendB.get()).isEqualTo(1); @@ -241,14 +241,14 @@ class RoutingNotifierTest { List wrapped = List.of( new FailOpenNotificationProvider( - failingProvider(Channel.EMAIL, "provider-a"), dependencyLogger), + failingProvider(NotificationChannel.EMAIL, "provider-a"), dependencyLogger), new FailOpenNotificationProvider( - countingProvider(Channel.EMAIL, "provider-b", sendB), dependencyLogger)); - Map>> routes = - Map.of(Channel.EMAIL, Map.of("alerts", List.of("provider-a", "provider-b"))); + countingProvider(NotificationChannel.EMAIL, "provider-b", sendB), dependencyLogger)); + Map>> routes = + Map.of(NotificationChannel.EMAIL, Map.of("alerts", List.of("provider-a", "provider-b"))); RoutingNotifier notifier = new RoutingNotifier(wrapped, routes); - assertThatCode(() -> notifier.notify(Channel.EMAIL, "alerts", PII_NOTIFICATION)) + assertThatCode(() -> notifier.notify(NotificationChannel.EMAIL, "alerts", PII_NOTIFICATION)) .doesNotThrowAnyException(); assertThat(sendB.get()).isEqualTo(1); @@ -258,7 +258,7 @@ class RoutingNotifierTest { void unboundRouteThrowsAdapterDisabledException() { RoutingNotifier notifier = new RoutingNotifier(List.of(), Map.of()); - assertThatThrownBy(() -> notifier.notify(Channel.EMAIL, PII_NOTIFICATION)) + assertThatThrownBy(() -> notifier.notify(NotificationChannel.EMAIL, PII_NOTIFICATION)) .isInstanceOf(AdapterDisabledException.class) .extracting("adapterName") .isEqualTo("notification"); @@ -268,8 +268,8 @@ class RoutingNotifierTest { void duplicateProviderIdWithinChannelFailsConstruction() { List providers = List.of( - failOpen(stubProvider(Channel.EMAIL, "google-email")), - failOpen(stubProvider(Channel.EMAIL, "google-email"))); // duplicate + failOpen(stubProvider(NotificationChannel.EMAIL, "google-email")), + failOpen(stubProvider(NotificationChannel.EMAIL, "google-email"))); // duplicate assertThatThrownBy(() -> new RoutingNotifier(providers, Map.of())) .isInstanceOf(IllegalStateException.class) @@ -280,8 +280,8 @@ class RoutingNotifierTest { @Test void routeReferencingUnknownProviderFailsConstruction() { List providers = List.of(); // no providers - Map>> routes = - Map.of(Channel.EMAIL, Map.of("default", List.of("google-email"))); + Map>> routes = + Map.of(NotificationChannel.EMAIL, Map.of("default", List.of("google-email"))); assertThatThrownBy(() -> new RoutingNotifier(providers, routes)) .isInstanceOf(IllegalStateException.class) @@ -293,8 +293,8 @@ class RoutingNotifierTest { Locale originalDefault = Locale.getDefault(); Locale.setDefault(Locale.forLanguageTag("tr-TR")); try { - Map>> routes = - Map.of(Channel.EMAIL, Map.of("default", List.of("google-email"))); + Map>> routes = + Map.of(NotificationChannel.EMAIL, Map.of("default", List.of("google-email"))); assertThatThrownBy(() -> new RoutingNotifier(List.of(), routes)) .hasMessageContaining("app.notification.routes.email.default"); @@ -314,12 +314,12 @@ class RoutingNotifierTest { List wrapped = List.of( new FailOpenNotificationProvider( - failingProvider(Channel.SLACK, "slack-webhook"), dependencyLogger)); - Map>> routes = - Map.of(Channel.SLACK, Map.of("default", List.of("slack-webhook"))); + failingProvider(NotificationChannel.SLACK, "slack-webhook"), dependencyLogger)); + Map>> routes = + Map.of(NotificationChannel.SLACK, Map.of("default", List.of("slack-webhook"))); RoutingNotifier notifier = new RoutingNotifier(wrapped, routes); - notifier.notify(Channel.SLACK, PII_NOTIFICATION); + notifier.notify(NotificationChannel.SLACK, PII_NOTIFICATION); boolean anyPii = appender.list.stream() @@ -334,8 +334,8 @@ class RoutingNotifierTest { NotificationProvider provider = new NotificationProvider() { @Override - public Channel channel() { - return Channel.SLACK; + public NotificationChannel channel() { + return NotificationChannel.SLACK; } @Override @@ -348,11 +348,11 @@ class RoutingNotifierTest { sent.add(providerId()); } }; - Map>> routes = - Map.of(Channel.SLACK, Map.of("team-alerts", List.of("slack-webhook"))); + Map>> routes = + Map.of(NotificationChannel.SLACK, Map.of("team-alerts", List.of("slack-webhook"))); RoutingNotifier notifier = new RoutingNotifier(List.of(failOpen(provider)), routes); - notifier.notify(Channel.SLACK, "team-alerts", PII_NOTIFICATION); + notifier.notify(NotificationChannel.SLACK, "team-alerts", PII_NOTIFICATION); assertThat(sent).containsExactly("slack-webhook"); } diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationLegacyNamespaceRetirementTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationLegacyNamespaceRetirementTest.java similarity index 87% rename from src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationLegacyNamespaceRetirementTest.java rename to src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationLegacyNamespaceRetirementTest.java index 7dcd6f32..a384e9fa 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationLegacyNamespaceRetirementTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationLegacyNamespaceRetirementTest.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.notification; +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; import static org.assertj.core.api.Assertions.assertThat; @@ -75,10 +75,10 @@ class NotificationLegacyNamespaceRetirementTest { .isPositive(); assertThat(platformAssemblers) .as( - "D2 landed. The platform has a production assembler now (SMTP), so the asymmetry that " - + "forced R0 to stay is gone for the email channel — this assertion was written to " - + "fail at exactly this moment and it did, which is the signal working rather than a " - + "regression. What still blocks the removal is narrower and named below.") + "D2 landed. The platform has a production assembler now (SMTP), so the asymmetry that" + + " forced R0 to stay is gone for the email channel — this assertion was written to" + + " fail at exactly this moment and it did, which is the signal working rather than" + + " a regression. What still blocks the removal is narrower and named below.") .isPositive(); } @@ -93,11 +93,11 @@ class NotificationLegacyNamespaceRetirementTest { assertThat(read(contract)) .as( - "the negative half of NTF-INT-004 lives with the switch registry contract, where a new " - + "master switch would be added; asserted here so removing it there is visible from " - + "the task that depends on it") - .contains("APP_NOTIFICATION_SLACK_PROVIDER") - .contains("APP_NOTIFICATION_EMAIL_PROVIDER") + "the negative half of NTF-INT-004 lives with the switch registry contract, where a new" + + " master switch would be added; asserted here so removing it there is visible" + + " from the task that depends on it") + .contains("APP_NOTIFICATION_SLACK_WEBHOOK_ENABLED") + .contains("APP_NOTIFICATION_GOOGLE_EMAIL_ENABLED") .contains("doesNotContain(\"master switch\")"); } diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationModeSsotTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationModeSsotTest.java similarity index 96% rename from src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationModeSsotTest.java rename to src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationModeSsotTest.java index 8bcb1ca2..f8a00a8d 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationModeSsotTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationModeSsotTest.java @@ -1,8 +1,7 @@ -package dev.caskeleton.bootstrap.autoconfigure.notification; +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; import static org.assertj.core.api.Assertions.assertThat; -import dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationPlatformMode; import java.io.IOException; import java.nio.file.Files; import java.nio.file.Path; diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/observation/NotificationObservationTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationObservationTest.java similarity index 99% rename from src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/observation/NotificationObservationTest.java rename to src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationObservationTest.java index bc45382e..129383a6 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/observation/NotificationObservationTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationObservationTest.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.notification.observation; +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.assertThatThrownBy; diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPayloadAtRestContractTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPayloadAtRestContractTest.java similarity index 98% rename from src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPayloadAtRestContractTest.java rename to src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPayloadAtRestContractTest.java index 2fc2e905..0fdc28d7 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPayloadAtRestContractTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPayloadAtRestContractTest.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.notification; +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; import static org.assertj.core.api.Assertions.assertThat; @@ -143,7 +143,7 @@ class NotificationPayloadAtRestContractTest { Path writer = repositoryRoot() .resolve( - "src/application-core/src/main/java/dev/caskeleton/application/notification/" + "src/application-notification/src/main/java/dev/caskeleton/application/notification/" + "platform/dispatch/CanonicalNotificationPlanWriter.java"); assertThat(read(writer)) diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformCoreConfigurationTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformCoreConfigurationTest.java new file mode 100644 index 00000000..5a0cab46 --- /dev/null +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformCoreConfigurationTest.java @@ -0,0 +1,207 @@ +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.adapter.outbound.notification.platform.provider.http.NotificationHttpGateway; +import dev.caskeleton.adapter.outbound.notification.platform.security.AesGcmContactPointProtector; +import dev.caskeleton.adapter.outbound.notification.platform.template.NotificationTemplateEngine; +import dev.caskeleton.adapter.outbound.notification.platform.template.PlaceholderTemplateEngine; +import dev.caskeleton.application.notification.platform.admin.NotificationAdminService; +import dev.caskeleton.application.notification.platform.dispatch.MessageDigestPort; +import dev.caskeleton.application.notification.platform.security.ContactPointProtector; +import dev.caskeleton.application.notification.platform.security.SecretKeyMaterial; +import dev.caskeleton.application.notification.platform.security.SecretMaterialProvider; +import dev.caskeleton.application.notification.platform.security.SecretPurpose; +import dev.caskeleton.application.notification.platform.template.TemplateVariableValidator; +import java.util.Arrays; +import org.junit.jupiter.api.Test; +import org.springframework.boot.test.context.runner.ApplicationContextRunner; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +/** + * Startup guardrails of the platform's conditional wiring. + * + *

The theme is that a misconfiguration must fail the boot, not the first delivery. A platform + * that starts happily and then refuses every notification at 02:00 is strictly worse than one that + * refuses to start at deploy time, when someone is watching. + */ +class NotificationPlatformCoreConfigurationTest { + + private final ApplicationContextRunner runner = + new ApplicationContextRunner().withUserConfiguration(NotificationPlatformCoreConfig.class); + + @Test + void thePlatformContributesNothingUntilItIsExplicitlyEnabled() { + runner.run( + context -> { + assertThat(context).hasNotFailed(); + assertThat(context).doesNotHaveBean(MessageDigestPort.class); + assertThat(context).doesNotHaveBean(TemplateVariableValidator.class); + assertThat(context).doesNotHaveBean(NotificationHttpGateway.class); + }); + } + + @Test + void enablingThePlatformContributesItsDefaultRuntimeBeans() { + enabled() + .run( + context -> { + assertThat(context).hasSingleBean(MessageDigestPort.class); + assertThat(context).hasSingleBean(TemplateVariableValidator.class); + assertThat(context).hasSingleBean(NotificationHttpGateway.class); + }); + } + + @Test + void aLegacyTemplateEnginePropertyCannotEnableExpressionEvaluation() { + enabled() + .withPropertyValues("ca-skeleton.notification.platform.template.engine=thymeleaf") + .run( + context -> { + assertThat(context).hasSingleBean(NotificationTemplateEngine.class); + assertThat(context.getBean(NotificationTemplateEngine.class)) + .isInstanceOf(PlaceholderTemplateEngine.class); + }); + } + + @Test + void contactPointProtectionIsUnconditionalAndFailsLoudlyWithoutKeyMaterial() { + // Was "appears only once key material exists", asserted by loading this configuration with no + // secret provider and expecting the bean to be absent. The mechanism behind that — + // @ConditionalOnBean + // on a plain @Configuration an auto-configuration imports — is evaluated during parsing and + // answers + // according to what happens to be registered at that instant. Here it answered "absent" and the + // test passed; in the application it also answered "absent", the bean vanished, and startup + // failed + // on an unsatisfied dependency several layers away. + // + // The property that replaces it is stronger and true in both places: the protector exists + // whenever + // the platform does, and a composition without key material fails at startup naming what is + // missing. + enabled() + .run( + context -> { + assertThat(context).hasSingleBean(ContactPointProtector.class); + assertThat(context.getBean(ContactPointProtector.class)) + .isInstanceOf(AesGcmContactPointProtector.class); + }); + + runner + .withPropertyValues("ca-skeleton.notification.platform.enabled=true") + .run( + context -> + assertThat(context) + .as( + "without a secret provider the platform must refuse to start rather than " + + "quietly omit the component that encrypts contact points") + .hasFailed()); + } + + @Test + void adminOperationsAreAbsentByDefaultRatherThanPresentAndUnguarded() { + enabled().run(context -> assertThat(context).doesNotHaveBean(NotificationAdminService.class)); + } + + @Test + void aWebPushProfileWithoutAVapidKeyFailsStartup() { + enabled() + .withPropertyValues( + "ca-skeleton.notification.platform.providers.webpush.type=WEB_PUSH", + "ca-skeleton.notification.platform.providers.webpush.enabled=true", + "ca-skeleton.notification.platform.providers.webpush.environment=PRODUCTION", + "ca-skeleton.notification.platform.providers.webpush.credential-profile=default", + "ca-skeleton.notification.platform.providers.webpush.timeout=5s", + "ca-skeleton.notification.platform.providers.webpush.max-concurrency=4", + "ca-skeleton.notification.platform.providers.webpush.rate-per-second=10") + .run( + context -> + // The validation failure is wrapped by the binder, so assert on the whole chain. + assertThat(context).getFailure().hasStackTraceContaining("VAPID")); + } + + @Test + void ambiguousFallbackCannotBeTurnedOnByConfiguration() { + enabled() + .withPropertyValues( + "ca-skeleton.notification.platform.dispatch.allow-ambiguous-fallback=true", + "ca-skeleton.notification.platform.dispatch.claim-batch-size=100", + "ca-skeleton.notification.platform.dispatch.lease-duration=30s", + "ca-skeleton.notification.platform.dispatch.poll-interval=250ms", + "ca-skeleton.notification.platform.dispatch.max-global-concurrency=8", + "ca-skeleton.notification.platform.dispatch.max-additional-attempts=3", + "ca-skeleton.notification.platform.dispatch.max-queue-age=1h") + .run( + context -> + assertThat(context) + .getFailure() + .hasStackTraceContaining("allow-ambiguous-fallback")); + } + + @Test + void anUnboundedClaimBatchIsRefusedAtStartup() { + enabled() + .withPropertyValues( + "ca-skeleton.notification.platform.dispatch.claim-batch-size=100000", + "ca-skeleton.notification.platform.dispatch.lease-duration=30s", + "ca-skeleton.notification.platform.dispatch.poll-interval=250ms", + "ca-skeleton.notification.platform.dispatch.max-global-concurrency=8", + "ca-skeleton.notification.platform.dispatch.max-additional-attempts=3", + "ca-skeleton.notification.platform.dispatch.max-queue-age=1h") + .run( + context -> + assertThat(context).getFailure().hasStackTraceContaining("claim-batch-size")); + } + + /** + * The platform, enabled, with the key material the real composition always supplies. + * + *

{@code SecretsConfiguration} is here rather than added per test because leaving it out + * models a deployment that cannot exist: {@code NotificationPlatformAutoConfiguration} imports + * the core configuration and {@code NotificationPlatformSecretsConfig} together, under one master + * switch, so key material is present exactly when this configuration is. A runner without it was + * testing an assembly the application never performs — and it was the reason the contact point + * protector carried an unreliable {@code @ConditionalOnBean}, which resolved to "absent" in the + * running application and took the bean with it. + */ + private ApplicationContextRunner enabled() { + return runner + .withPropertyValues("ca-skeleton.notification.platform.enabled=true") + .withUserConfiguration(SecretsConfiguration.class); + } + + /** Deterministic key material so the protector has something to bind to. */ + @Configuration(proxyBeanMethods = false) + static class SecretsConfiguration { + + @Bean + SecretMaterialProvider secrets() { + return new SecretMaterialProvider() { + + @Override + public SecretKeyMaterial activeKey(SecretPurpose purpose) { + return key(purpose); + } + + @Override + public SecretKeyMaterial keyById(String keyId) { + return key(SecretPurpose.CONTACT_ENCRYPTION); + } + + private SecretKeyMaterial key(SecretPurpose purpose) { + byte[] material = new byte[32]; + Arrays.fill(material, (byte) 0x2A); + return new SecretKeyMaterial( + purpose.name().toLowerCase(java.util.Locale.ROOT), purpose, material); + } + }; + } + } + + /** Referenced so the settings type is loaded by this test's compilation unit. */ + static Class settingsType() { + return NotificationPlatformSettings.class; + } +} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/activation/NotificationRootImportCoverageTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformImportCoverageTest.java similarity index 65% rename from src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/activation/NotificationRootImportCoverageTest.java rename to src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformImportCoverageTest.java index 11a2279c..f846e38a 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/activation/NotificationRootImportCoverageTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformImportCoverageTest.java @@ -1,8 +1,9 @@ -package dev.caskeleton.bootstrap.activation; +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; import static org.assertj.core.api.Assertions.assertThat; -import dev.caskeleton.bootstrap.autoconfigure.notification.NotificationRootAutoConfiguration; +import java.nio.file.Files; +import java.nio.file.Path; import java.util.Arrays; import java.util.List; import org.junit.jupiter.api.DisplayName; @@ -22,12 +23,24 @@ import org.springframework.context.annotation.Import; * credentials and a store, and this claim is about the import graph rather than about a running * provider. The on-path behaviour is Wave 2's subject. */ -class NotificationRootImportCoverageTest { +class NotificationPlatformImportCoverageTest { + + @Test + @DisplayName("the leaf registers its root in AutoConfiguration.imports") + void theLeafRegistersItsRoot() throws Exception { + Path imports = + Path.of( + "src/main/resources/META-INF/spring/" + + "org.springframework.boot.autoconfigure.AutoConfiguration.imports"); + + assertThat(Files.readAllLines(imports)) + .containsExactly(NotificationPlatformAutoConfiguration.class.getName()); + } @Test @DisplayName("the root imports every configuration the capability owns") void theRootNamesEveryConfiguration() { - Import imports = NotificationRootAutoConfiguration.class.getAnnotation(Import.class); + Import imports = NotificationPlatformAutoConfiguration.class.getAnnotation(Import.class); assertThat(imports).as("the root must reach its children by import, not by scan").isNotNull(); List imported = Arrays.stream(imports.value()).map(Class::getName).toList(); @@ -38,16 +51,17 @@ class NotificationRootImportCoverageTest { + "scan narrowed, a root that does not name them leaves the capability broken when " + "it is switched on, and quieter when it is off — which reads as success") .contains( - "dev.caskeleton.bootstrap.autoconfigure.notification.NotificationPlatformRuntimeConfig", - "dev.caskeleton.bootstrap.autoconfigure.notification.NotificationPlatformSecretsConfig", - "dev.caskeleton.bootstrap.autoconfigure.notification.NotificationPlatformRegistriesConfig"); + "dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationPlatformRuntimeConfig", + "dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationPlatformSecretsConfig", + "dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationPlatformRegistriesConfig"); } @Test @DisplayName("the delivery-platform runtime still names its own children") void theRuntimeConfigNamesItsChildren() { Import imports = - dev.caskeleton.bootstrap.autoconfigure.notification.NotificationPlatformRuntimeConfig.class + dev.caskeleton.adapter.outbound.notification.platform.autoconfigure + .NotificationPlatformRuntimeConfig.class .getAnnotation(Import.class); assertThat(imports).isNotNull(); @@ -56,6 +70,7 @@ class NotificationRootImportCoverageTest { .contains( "NotificationPlatformCodecConfig", "NotificationPlatformProviderConfig", + "NotificationSesProviderConfig", "NotificationPlatformPolicyConfig", "NotificationPlatformDispatchConfig", "NotificationPlatformWorkerConfig"); diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformReachabilityTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformReachabilityTest.java new file mode 100644 index 00000000..4012233b --- /dev/null +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformReachabilityTest.java @@ -0,0 +1,54 @@ +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; + +import static org.assertj.core.api.Assertions.assertThat; + +import java.util.Arrays; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.springframework.boot.autoconfigure.AutoConfiguration; +import org.springframework.context.annotation.Import; +import org.springframework.core.annotation.AnnotatedElementUtils; + +/** The Notification leaf publishes one real Boot auto-configuration root (NTF-INT-006). */ +class NotificationPlatformReachabilityTest { + + @Test + @DisplayName("the existing platform auto-configuration type is the registered Boot root") + void thePlatformConfigurationIsTheBootRoot() { + assertThat( + AnnotatedElementUtils.hasAnnotation( + NotificationPlatformAutoConfiguration.class, AutoConfiguration.class)) + .isTrue(); + } + + @Test + @DisplayName("the Boot root reaches the internal core, runtime, secrets and registries") + void theBootRootNamesItsOwnedComposition() { + Import imports = NotificationPlatformAutoConfiguration.class.getAnnotation(Import.class); + assertThat(imports).isNotNull(); + + assertThat(Arrays.asList(imports.value())) + .contains( + NotificationPlatformCoreConfig.class, + NotificationPlatformRuntimeConfig.class, + NotificationPlatformSecretsConfig.class, + NotificationPlatformRegistriesConfig.class); + } + + @Test + @DisplayName("the runtime composition reaches provider callback verification") + void theRuntimeCompositionReachesProviderCallbackVerification() { + Import imports = NotificationPlatformRuntimeConfig.class.getAnnotation(Import.class); + assertThat(imports).isNotNull(); + assertThat(Arrays.asList(imports.value())) + .contains(NotificationCallbackProviderConfig.class, NotificationSesProviderConfig.class); + } + + @Test + @DisplayName("the root imports are unique") + void theRootImportsAreUnique() { + Import imports = NotificationPlatformAutoConfiguration.class.getAnnotation(Import.class); + assertThat(imports).isNotNull(); + assertThat(imports.value()).doesNotHaveDuplicates(); + } +} diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformSettingsTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformSettingsTest.java index 6f630e98..b43e404a 100644 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformSettingsTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationPlatformSettingsTest.java @@ -24,6 +24,27 @@ class NotificationPlatformSettingsTest { .hasMessageContaining("topic"); } + @Test + void enabledSesRequiresItsTypedTransportIdentity() { + assertThatThrownBy( + () -> + properties( + new NotificationPlatformSettings.Provider( + "SES", + true, + false, + "PRODUCTION", + "cred-1", + null, + null, + null, + Duration.ofSeconds(3), + 8, + 20))) + .isInstanceOf(IllegalArgumentException.class) + .hasMessageContaining("ses settings block"); + } + @Test void aCallbackCapableProviderRequiresASigningSecret() { assertThatThrownBy(() -> properties(twilioWithoutSigningSecret())) @@ -46,8 +67,10 @@ class NotificationPlatformSettingsTest { Duration.ofMillis(250), 128, 3, + Duration.ofSeconds(2), Duration.ofHours(24), - true)) + true, + Duration.ofSeconds(20))) .isInstanceOf(IllegalArgumentException.class) .hasMessageContaining("allow-ambiguous-fallback"); } @@ -62,8 +85,10 @@ class NotificationPlatformSettingsTest { Duration.ofMillis(250), 128, 3, + Duration.ofSeconds(2), Duration.ofHours(24), - false)) + false, + Duration.ofSeconds(20))) .isInstanceOf(IllegalArgumentException.class) .hasMessageContaining("claim-batch-size"); } @@ -78,8 +103,10 @@ class NotificationPlatformSettingsTest { Duration.ofSeconds(1), 128, 3, + Duration.ofSeconds(2), Duration.ofHours(24), - false)) + false, + Duration.ofSeconds(20))) .isInstanceOf(IllegalArgumentException.class) .hasMessageContaining("lease-duration"); } @@ -90,7 +117,10 @@ class NotificationPlatformSettingsTest { assertThat(defaults.allowAmbiguousFallback()).isFalse(); assertThat(defaults.claimBatchSize()).isPositive(); + assertThat(defaults.shutdownGrace()).isEqualTo(Duration.ofSeconds(20)); assertThat(NotificationPlatformSettings.Callbacks.defaults().enabled()).isFalse(); + assertThat(NotificationPlatformSettings.ServingThresholds.defaults().maxBacklogDepth()) + .isEqualTo(100_000); } private static NotificationPlatformSettings properties( diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationProviderAssemblyTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationProviderAssemblyTest.java index f9fac342..2ae46951 100644 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationProviderAssemblyTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationProviderAssemblyTest.java @@ -3,8 +3,13 @@ package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.assertThatThrownBy; +import dev.caskeleton.adapter.outbound.notification.platform.callback.CallbackVerificationResult; +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackAdapter; +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackVerificationRequest; +import dev.caskeleton.adapter.outbound.notification.platform.callback.VerifiedCallback; import dev.caskeleton.adapter.outbound.notification.platform.dispatch.ProviderAttemptLimiter; import dev.caskeleton.adapter.outbound.notification.platform.dispatch.ProviderRuntime; +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; import dev.caskeleton.application.notification.platform.api.ProviderId; import dev.caskeleton.application.notification.platform.api.ProviderProfileId; import dev.caskeleton.application.notification.platform.api.routing.Channel; @@ -80,6 +85,20 @@ class NotificationProviderAssemblyTest { .hasMessageContaining("no assembler"); } + @Test + @DisplayName("an SMTP profile without the shipped relay assembler names spring.mail.host") + void smtpWithoutRelayNamesTheActualMissingConfiguration() { + assertThatThrownBy( + () -> + assemble( + Map.of("smtp-main", profile("SMTP", true, true)), + fakeAssembler(ProviderType.SES))) + .isInstanceOf(IllegalStateException.class) + .hasMessageContaining("smtp-main") + .hasMessageContaining("spring.mail.host") + .hasMessageContaining("SMTP assembler"); + } + @Test @DisplayName("two profiles on one channel need one of them marked primary") void twoProfilesOnOneChannelNeedAPrimary() { @@ -137,6 +156,20 @@ class NotificationProviderAssemblyTest { assertThat(platform.serving()).isFalse(); } + @Test + @DisplayName("a disabled primary profile does not participate in routing or type parsing") + void disabledPrimaryProfileIsInert() { + NotificationProviderAssembly.AssembledPlatform platform = + assemble( + Map.of( + "disabled-default", profile("SENDGRID", false, true), + "email-main", profile("SES", true, true)), + fakeAssembler(ProviderType.SES)); + + assertThat(platform.routeFor(Channel.EMAIL)).hasValue(new ProviderProfileId("email-main")); + assertThat(platform.runtimes().find(new ProviderProfileId("disabled-default"))).isEmpty(); + } + @Test @DisplayName("an enabled platform with no provider refuses to start") void anEnabledPlatformWithNoProviderRefusesToStart() { @@ -167,6 +200,52 @@ class NotificationProviderAssemblyTest { .hasMessageContaining("bean ordering"); } + @Test + @DisplayName("INGEST_ONLY assembles a callback-capable profile without a dispatch transport") + void ingestOnlyAssemblesCallbackWithoutDispatchTransport() { + NotificationPlatformSettings settings = + new NotificationPlatformSettings( + true, + NotificationPlatformMode.INGEST_ONLY, + NotificationPlatformSettings.Dispatch.defaults(), + new NotificationPlatformSettings.Callbacks(true, 1_024, Duration.ofMinutes(5)), + Map.of("ses-events", profile("SES", true, false))); + + NotificationProviderAssembly.AssembledPlatform platform = + new NotificationProviderAssembly( + List.of(), List.of(fakeCallbackAssembler(ProviderType.SES))) + .assemble(settings, NotificationPlatformMode.INGEST_ONLY); + + assertThat(platform.routes()).isEmpty(); + assertThat(platform.runtimes().find(new ProviderProfileId("ses-events"))).isEmpty(); + assertThat(platform.callbacks()).containsKey(new ProviderProfileId("ses-events")); + assertThat(platform.callbacks().get(new ProviderProfileId("ses-events")).providerId()) + .isEqualTo(new ProviderId("ses")); + } + + @Test + @DisplayName("the callback registry consumes the assembly's profile-specific callback map") + void callbackRegistryUsesAssembledProfileCallbacks() { + NotificationPlatformSettings settings = + new NotificationPlatformSettings( + true, + NotificationPlatformMode.INGEST_ONLY, + NotificationPlatformSettings.Dispatch.defaults(), + new NotificationPlatformSettings.Callbacks(true, 1_024, Duration.ofMinutes(5)), + Map.of("ses-events", profile("SES", true, false))); + NotificationProviderAssembly.AssembledPlatform platform = + new NotificationProviderAssembly( + List.of(), List.of(fakeCallbackAssembler(ProviderType.SES))) + .assemble(settings, NotificationPlatformMode.INGEST_ONLY); + + var registry = + new NotificationPlatformRegistriesConfig() + .providerCallbackAdapterRegistry(platform, settings); + + assertThat(registry.require(new ProviderProfileId("ses-events")).providerId()) + .isEqualTo(new ProviderId("ses")); + } + private static NotificationProviderAssembly.AssembledPlatform assemble( Map providers, ProviderRuntimeAssembler... assemblers) { @@ -189,6 +268,15 @@ class NotificationProviderAssemblyTest { private static NotificationPlatformSettings.Provider profile( String type, boolean enabled, boolean primary) { + NotificationPlatformSettings.Ses ses = + "SES".equals(type) + ? new NotificationPlatformSettings.Ses( + java.net.URI.create("http://127.0.0.1:8080"), + "us-east-1", + "no-reply@example.test", + "AKIAEXAMPLE", + null) + : null; return new NotificationPlatformSettings.Provider( type, enabled, @@ -200,7 +288,8 @@ class NotificationProviderAssemblyTest { "callback-secret", Duration.ofSeconds(3), 8, - 20); + 20, + ses); } /** @@ -264,4 +353,34 @@ class NotificationProviderAssemblyTest { } }; } + + private static ProviderCallbackAssembler fakeCallbackAssembler(ProviderType type) { + return new ProviderCallbackAssembler() { + @Override + public ProviderType type() { + return type; + } + + @Override + public ProviderCallbackAdapter assemble( + String profileId, NotificationPlatformSettings.Provider profile) { + return new ProviderCallbackAdapter() { + @Override + public ProviderId providerId() { + return new ProviderId(type.name().toLowerCase(java.util.Locale.ROOT)); + } + + @Override + public CallbackVerificationResult verify(ProviderCallbackVerificationRequest request) { + return CallbackVerificationResult.valid(new VerifiedCallback(request, Map.of())); + } + + @Override + public List normalize(VerifiedCallback callback) { + return List.of(); + } + }; + } + }; + } } diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationSecretsValidationTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationSecretsValidationTest.java similarity index 98% rename from src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationSecretsValidationTest.java rename to src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationSecretsValidationTest.java index b2e5ddfd..6b827381 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationSecretsValidationTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationSecretsValidationTest.java @@ -1,13 +1,11 @@ -package dev.caskeleton.bootstrap.autoconfigure.notification; +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.assertThatCode; import static org.assertj.core.api.Assertions.assertThatThrownBy; -import dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationPlatformMode; -import dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationPlatformSettings; +import dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationPlatformSecretsConfig.NotificationSecretsSettings; import dev.caskeleton.application.notification.platform.security.SecretPurpose; -import dev.caskeleton.bootstrap.autoconfigure.notification.NotificationPlatformSecretsConfig.NotificationSecretsSettings; import java.util.Base64; import java.util.LinkedHashMap; import java.util.Map; diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationSmtpTransportConfigurationTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationSmtpTransportConfigurationTest.java new file mode 100644 index 00000000..b825fae0 --- /dev/null +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationSmtpTransportConfigurationTest.java @@ -0,0 +1,96 @@ +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; + +import static org.assertj.core.api.Assertions.assertThatCode; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +import dev.caskeleton.adapter.outbound.notification.platform.provider.smtp.SmtpFailureClassifier; +import dev.caskeleton.adapter.outbound.notification.platform.provider.smtp.SmtpMimeMessageFactory; +import dev.caskeleton.application.notification.platform.contact.ContactPointValue; +import dev.caskeleton.application.notification.platform.dispatch.AttachmentIntegrityGuard; +import dev.caskeleton.application.notification.platform.security.AccessContext; +import dev.caskeleton.application.notification.platform.security.ContactPointProtector; +import dev.caskeleton.application.notification.platform.security.ProtectedContactPoint; +import java.time.Clock; +import java.util.Properties; +import org.junit.jupiter.api.Test; +import org.springframework.mail.javamail.JavaMailSenderImpl; + +class NotificationSmtpTransportConfigurationTest { + + @Test + void smtpAssemblyRejectsAPlaintextSpringMailTransport() { + JavaMailSenderImpl sender = sender(new Properties()); + + assertThatThrownBy(() -> assemble(sender)) + .isInstanceOf(IllegalStateException.class) + .hasMessageContaining("STARTTLS"); + } + + @Test + void smtpAssemblyRejectsMissingTransportTimeouts() { + Properties properties = new Properties(); + properties.setProperty("mail.smtp.starttls.enable", "true"); + properties.setProperty("mail.smtp.starttls.required", "true"); + JavaMailSenderImpl sender = sender(properties); + + assertThatThrownBy(() -> assemble(sender)) + .isInstanceOf(IllegalStateException.class) + .hasMessageContaining("timeout"); + } + + @Test + void smtpAssemblyAcceptsSpringMailWhenTlsAndTimeoutsAreAppliedToTheActualSender() { + Properties properties = new Properties(); + properties.setProperty("mail.smtp.starttls.enable", "true"); + properties.setProperty("mail.smtp.starttls.required", "true"); + properties.setProperty("mail.smtp.connectiontimeout", "5000"); + properties.setProperty("mail.smtp.timeout", "10000"); + properties.setProperty("mail.smtp.writetimeout", "10000"); + JavaMailSenderImpl sender = sender(properties); + + assertThatCode(() -> assemble(sender)).doesNotThrowAnyException(); + } + + private static JavaMailSenderImpl sender(Properties properties) { + JavaMailSenderImpl sender = new JavaMailSenderImpl(); + sender.setHost("smtp.example.test"); + sender.setPort(587); + sender.setJavaMailProperties(properties); + return sender; + } + + private static void assemble(JavaMailSenderImpl sender) { + NotificationSmtpProviderConfig config = new NotificationSmtpProviderConfig(); + NotificationSmtpSettings settings = new NotificationSmtpSettings("no-reply@example.test", 4); + + config.smtpProviderRuntimeAssembler( + message -> {}, + new SmtpMimeMessageFactory(sender.getSession()), + new SmtpFailureClassifier(), + protector(), + Runnable::run, + new AttachmentIntegrityGuard((reference, context) -> null), + settings, + sender, + Clock.systemUTC()); + } + + private static ContactPointProtector protector() { + return new ContactPointProtector() { + @Override + public ProtectedContactPoint protect(ContactPointValue value) { + throw new UnsupportedOperationException("not used"); + } + + @Override + public ContactPointValue reveal(ProtectedContactPoint value, AccessContext context) { + throw new UnsupportedOperationException("not used"); + } + + @Override + public String fingerprint(ContactPointValue value) { + throw new UnsupportedOperationException("not used"); + } + }; + } +} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationWorkerLifecycleTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationWorkerLifecycleTest.java similarity index 98% rename from src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationWorkerLifecycleTest.java rename to src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationWorkerLifecycleTest.java index 371e1432..a7766202 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationWorkerLifecycleTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationWorkerLifecycleTest.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.notification; +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; import static org.assertj.core.api.Assertions.assertThat; diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/SesProviderRuntimeAssemblerTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/SesProviderRuntimeAssemblerTest.java new file mode 100644 index 00000000..b24319e3 --- /dev/null +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/SesProviderRuntimeAssemblerTest.java @@ -0,0 +1,107 @@ +package dev.caskeleton.adapter.outbound.notification.platform.autoconfigure; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +import dev.caskeleton.adapter.outbound.notification.platform.provider.http.NotificationHttpResponse; +import dev.caskeleton.adapter.outbound.notification.platform.security.ProviderCredentialManager; +import dev.caskeleton.adapter.outbound.notification.platform.security.SecurityFixtures; +import dev.caskeleton.application.notification.platform.api.routing.Channel; +import dev.caskeleton.application.notification.platform.contact.ContactPointValue; +import dev.caskeleton.application.notification.platform.dispatch.AttachmentIntegrityGuard; +import dev.caskeleton.application.notification.platform.security.AccessContext; +import dev.caskeleton.application.notification.platform.security.ContactPointProtector; +import dev.caskeleton.application.notification.platform.security.ProtectedContactPoint; +import java.net.URI; +import java.nio.charset.StandardCharsets; +import java.time.Clock; +import java.time.Duration; +import java.time.Instant; +import java.time.ZoneOffset; +import java.util.Map; +import org.junit.jupiter.api.Test; + +class SesProviderRuntimeAssemblerTest { + + private static final Clock CLOCK = + Clock.fixed(Instant.parse("2026-09-21T00:00:00Z"), ZoneOffset.UTC); + + @Test + void configuredSesProfileBecomesAReachableEmailRuntimeAndActivatesItsCredential() { + ProviderCredentialManager credentials = + new ProviderCredentialManager(SecurityFixtures.keys(), CLOCK); + SesProviderRuntimeAssembler assembler = assembler(credentials); + + AssembledProvider assembled = assembler.assemble("ses-primary", profile("cred-1")); + + assertThat(assembler.type()).isEqualTo(ProviderType.SES); + assertThat(assembled.channel()).isEqualTo(Channel.EMAIL); + assertThat(assembled.runtime().profile().profileId().value()).isEqualTo("ses-primary"); + assertThat(assembled.runtime().profile().providerId().value()).isEqualTo("ses"); + assertThat(assembled.runtime().profile().credentialGeneration()).isEqualTo(1L); + assertThat(credentials.current(assembled.runtime().profile().profileId()).orElseThrow().keyId()) + .isEqualTo("cred-1"); + } + + @Test + void changingTheConfiguredCredentialKeyDoesNotSilentlyRotateAnActiveProfile() { + ProviderCredentialManager credentials = + new ProviderCredentialManager(SecurityFixtures.keys(), CLOCK); + SesProviderRuntimeAssembler assembler = assembler(credentials); + assembler.assemble("ses-primary", profile("cred-1")); + + assertThatThrownBy(() -> assembler.assemble("ses-primary", profile("cred-2"))) + .isInstanceOf(IllegalStateException.class) + .hasMessageContaining("without a credential rotation"); + } + + private static SesProviderRuntimeAssembler assembler(ProviderCredentialManager credentials) { + return new SesProviderRuntimeAssembler( + request -> + new NotificationHttpResponse(200, Map.of(), "{}".getBytes(StandardCharsets.UTF_8)), + new AttachmentIntegrityGuard((reference, context) -> null), + protector(), + credentials, + CLOCK); + } + + private static NotificationPlatformSettings.Provider profile(String credentialKeyId) { + return new NotificationPlatformSettings.Provider( + "SES", + true, + true, + "PRODUCTION", + credentialKeyId, + null, + null, + null, + Duration.ofSeconds(5), + 8, + 20, + new NotificationPlatformSettings.Ses( + URI.create("http://127.0.0.1:8080"), + "us-east-1", + "no-reply@example.test", + "AKIAEXAMPLE", + null)); + } + + private static ContactPointProtector protector() { + return new ContactPointProtector() { + @Override + public ProtectedContactPoint protect(ContactPointValue value) { + throw new UnsupportedOperationException("assembly only"); + } + + @Override + public ContactPointValue reveal(ProtectedContactPoint value, AccessContext context) { + throw new UnsupportedOperationException("assembly only"); + } + + @Override + public String fingerprint(ContactPointValue value) { + throw new UnsupportedOperationException("assembly only"); + } + }; + } +} diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/dispatch/ReconciliationJobWorkerTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/dispatch/ReconciliationJobWorkerTest.java index 01101163..e54982d6 100644 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/dispatch/ReconciliationJobWorkerTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/dispatch/ReconciliationJobWorkerTest.java @@ -3,9 +3,9 @@ package dev.caskeleton.adapter.outbound.notification.platform.dispatch; import static org.assertj.core.api.Assertions.assertThat; import dev.caskeleton.application.notification.platform.api.DeliveryAttemptId; +import dev.caskeleton.application.notification.platform.api.NormalizedEventType; +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; import dev.caskeleton.application.notification.platform.api.ProviderProfileId; -import dev.caskeleton.application.notification.platform.callback.NormalizedEventType; -import dev.caskeleton.application.notification.platform.callback.NormalizedProviderEvent; import dev.caskeleton.application.notification.platform.dispatch.ReconciliationJob; import dev.caskeleton.application.notification.platform.dispatch.ReconciliationJobStorePort; import dev.caskeleton.application.notification.platform.provider.ReconciliationResult; diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/apns/ApnsNotificationProviderAdapterTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/apns/ApnsNotificationProviderAdapterTest.java index 54cc57c9..fa646ae7 100644 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/apns/ApnsNotificationProviderAdapterTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/apns/ApnsNotificationProviderAdapterTest.java @@ -49,7 +49,7 @@ class ApnsNotificationProviderAdapterTest extends ProviderAdapterContract { private NotificationProviderAdapter adapter(ApnsEnvironment environment) { return new ApnsNotificationProviderAdapter( - new JdkNotificationHttpGateway(Duration.ofSeconds(2)), + new JdkNotificationHttpGateway(Duration.ofSeconds(2), true), new ApnsRequestMapper(properties(environment), CLOCK), new ApnsFailureClassifier(), protector, diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/http/JdkNotificationHttpGatewaySecurityTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/http/JdkNotificationHttpGatewaySecurityTest.java new file mode 100644 index 00000000..7f73a533 --- /dev/null +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/http/JdkNotificationHttpGatewaySecurityTest.java @@ -0,0 +1,27 @@ +package dev.caskeleton.adapter.outbound.notification.platform.provider.http; + +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +import java.net.URI; +import java.time.Duration; +import java.util.Map; +import org.junit.jupiter.api.Test; + +class JdkNotificationHttpGatewaySecurityTest { + + @Test + void productionGatewayRejectsLoopbackBeforeOpeningAConnection() { + JdkNotificationHttpGateway gateway = new JdkNotificationHttpGateway(Duration.ofSeconds(1)); + NotificationHttpRequest request = + new NotificationHttpRequest( + "POST", + URI.create("https://127.0.0.1:9/provider"), + Map.of(), + new byte[] {1}, + Duration.ofSeconds(1)); + + assertThatThrownBy(() -> gateway.exchange(request)) + .isInstanceOf(IllegalArgumentException.class) + .hasMessageContaining("deployment"); + } +} diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/ses/SesNotificationProviderAdapterTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/ses/SesNotificationProviderAdapterTest.java index 6b026127..041b0b35 100644 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/ses/SesNotificationProviderAdapterTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/ses/SesNotificationProviderAdapterTest.java @@ -257,7 +257,7 @@ class SesNotificationProviderAdapterTest extends ProviderAdapterContract { Optional.empty(), Duration.ofSeconds(3)); return new SesNotificationProviderAdapter( - new JdkNotificationHttpGateway(Duration.ofSeconds(2)), + new JdkNotificationHttpGateway(Duration.ofSeconds(2), true), new SesRequestMapper( properties, new AwsSignatureV4Signer(), diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/twilio/TwilioCallbackAndProjectionTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/twilio/TwilioCallbackAndProjectionTest.java index 7bdf8def..a17e70ac 100644 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/twilio/TwilioCallbackAndProjectionTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/twilio/TwilioCallbackAndProjectionTest.java @@ -2,11 +2,11 @@ package dev.caskeleton.adapter.outbound.notification.platform.provider.twilio; import static org.assertj.core.api.Assertions.assertThat; +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackVerificationRequest; import dev.caskeleton.adapter.outbound.notification.platform.security.SecurityFixtures; -import dev.caskeleton.application.notification.platform.api.CallbackRequest; +import dev.caskeleton.application.notification.platform.api.NormalizedEventType; import dev.caskeleton.application.notification.platform.api.ProviderId; import dev.caskeleton.application.notification.platform.api.ProviderProfileId; -import dev.caskeleton.application.notification.platform.callback.NormalizedEventType; import dev.caskeleton.application.notification.platform.security.SecretPurpose; import java.net.URLEncoder; import java.nio.charset.StandardCharsets; @@ -152,7 +152,8 @@ class TwilioCallbackAndProjectionTest { } } - private static CallbackRequest callback(Map parameters, String signature) { + private static ProviderCallbackVerificationRequest callback( + Map parameters, String signature) { String form = parameters.entrySet().stream() .map( @@ -162,7 +163,7 @@ class TwilioCallbackAndProjectionTest { + URLEncoder.encode(entry.getValue(), StandardCharsets.UTF_8)) .reduce((left, right) -> left + "&" + right) .orElse(""); - return new CallbackRequest( + return new ProviderCallbackVerificationRequest( new ProviderId("twilio"), new ProviderProfileId("twilio-primary"), CALLBACK_URL, diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/twilio/TwilioCallbackContractTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/twilio/TwilioCallbackContractTest.java index 93e57412..017aeb1d 100644 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/twilio/TwilioCallbackContractTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/twilio/TwilioCallbackContractTest.java @@ -1,11 +1,11 @@ package dev.caskeleton.adapter.outbound.notification.platform.provider.twilio; +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackAdapter; +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackVerificationRequest; import dev.caskeleton.adapter.outbound.notification.platform.security.SecurityFixtures; import dev.caskeleton.adapter.outbound.notification.platform.testkit.CallbackContract; -import dev.caskeleton.application.notification.platform.api.CallbackRequest; import dev.caskeleton.application.notification.platform.api.ProviderId; import dev.caskeleton.application.notification.platform.api.ProviderProfileId; -import dev.caskeleton.application.notification.platform.callback.ProviderCallbackAdapter; import dev.caskeleton.application.notification.platform.security.SecretPurpose; import java.net.URLEncoder; import java.nio.charset.StandardCharsets; @@ -46,20 +46,20 @@ class TwilioCallbackContractTest extends CallbackContract { } @Override - protected CallbackRequest signedRequest() { + protected ProviderCallbackVerificationRequest signedRequest() { Map parameters = delivered(); return callback(parameters, signature(parameters)); } @Override - protected CallbackRequest tamperedRequest() { + protected ProviderCallbackVerificationRequest tamperedRequest() { Map failed = new TreeMap<>(Map.of("MessageSid", "SM1", "MessageStatus", "failed")); return callback(failed, signature(delivered())); } @Override - protected CallbackRequest unsignedRequest() { + protected ProviderCallbackVerificationRequest unsignedRequest() { return callback(delivered(), ""); } @@ -81,7 +81,8 @@ class TwilioCallbackContractTest extends CallbackContract { } } - private static CallbackRequest callback(Map parameters, String signature) { + private static ProviderCallbackVerificationRequest callback( + Map parameters, String signature) { String form = parameters.entrySet().stream() .map( @@ -91,7 +92,7 @@ class TwilioCallbackContractTest extends CallbackContract { + URLEncoder.encode(entry.getValue(), StandardCharsets.UTF_8)) .reduce((left, right) -> left + "&" + right) .orElse(""); - return new CallbackRequest( + return new ProviderCallbackVerificationRequest( new ProviderId("twilio"), new ProviderProfileId("twilio-primary"), CALLBACK_URL, diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/twilio/TwilioSmsProviderAdapterTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/twilio/TwilioSmsProviderAdapterTest.java index b1aaad2a..4dba7e0d 100644 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/twilio/TwilioSmsProviderAdapterTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/twilio/TwilioSmsProviderAdapterTest.java @@ -47,7 +47,7 @@ class TwilioSmsProviderAdapterTest extends ProviderAdapterContract { @Override protected NotificationProviderAdapter adapter() { return new TwilioSmsProviderAdapter( - new JdkNotificationHttpGateway(Duration.ofSeconds(2)), + new JdkNotificationHttpGateway(Duration.ofSeconds(2), true), new TwilioRequestMapper(properties()), new TwilioFailureClassifier(), protector, diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/webhook/WebhookNotificationProviderAdapterTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/webhook/WebhookNotificationProviderAdapterTest.java index 58f5fbea..7cd545ef 100644 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/webhook/WebhookNotificationProviderAdapterTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/webhook/WebhookNotificationProviderAdapterTest.java @@ -216,7 +216,7 @@ class WebhookNotificationProviderAdapterTest { } private WebhookNotificationProviderAdapter adapter(WebhookSubscription subscription) { - var gateway = new JdkNotificationHttpGateway(Duration.ofSeconds(2)); + var gateway = new JdkNotificationHttpGateway(Duration.ofSeconds(2), true); return new WebhookNotificationProviderAdapter( gateway, gateway, diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/webpush/WebPushProviderAdapterTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/webpush/WebPushProviderAdapterTest.java index fae90930..4f946ad3 100644 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/webpush/WebPushProviderAdapterTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/provider/webpush/WebPushProviderAdapterTest.java @@ -137,7 +137,7 @@ class WebPushProviderAdapterTest { new WebPushProviderProperties( "BFakePublicKeyForTests", Duration.ofHours(1), 4096L, false, Duration.ofSeconds(3)); return new WebPushNotificationProviderAdapter( - new JdkNotificationHttpGateway(Duration.ofSeconds(2)), + new JdkNotificationHttpGateway(Duration.ofSeconds(2), true), new WebPushRequestMapper( new Rfc8291Aes128GcmEncryptor(RANDOM), // Signing needs a PKCS#8 EC key, which VapidJwtSignerTest covers; this keeps the diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/security/AesGcmContactPointProtectorTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/security/AesGcmContactPointProtectorTest.java index ca195f7f..e51e85c3 100644 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/security/AesGcmContactPointProtectorTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/security/AesGcmContactPointProtectorTest.java @@ -27,6 +27,27 @@ class AesGcmContactPointProtectorTest { assertThat(protector.reveal(first, AccessContext.dispatch("ses-primary"))).isEqualTo(value); } + @Test + void revealRejectsAContextThatRequiresAudit() { + var protectedEmail = protector.protect(EmailAddress.parse("user@example.com")); + + assertThatThrownBy( + () -> protector.reveal(protectedEmail, new AccessContext("ADMIN", "operator-1", true))) + .isInstanceOf(SecurityException.class) + .hasMessageContaining("audited boundary"); + } + + @Test + void revealRejectsAnUnauditedNonDispatchPurpose() { + var protectedEmail = protector.protect(EmailAddress.parse("user@example.com")); + + assertThatThrownBy( + () -> + protector.reveal(protectedEmail, new AccessContext("SUPPORT", "support-1", false))) + .isInstanceOf(SecurityException.class) + .hasMessageContaining("DISPATCH"); + } + @Test void encryptionAndHmacKeysMustDiffer() { var sharedKeyProtector = diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/template/BothEnginesHonourSlotModeTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/template/BothEnginesHonourSlotModeTest.java index 3635d368..bf87550a 100644 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/template/BothEnginesHonourSlotModeTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/template/BothEnginesHonourSlotModeTest.java @@ -17,7 +17,7 @@ import org.thymeleaf.templatemode.TemplateMode; * *

{@code SlotAwareRenderingTest} constructs {@code PlaceholderTemplateEngine} and only that, and * the mode-aware method was a {@code default} that forwarded to the unescaped overload. The - * Thymeleaf engine never overrode it, so with {@code template.engine=thymeleaf} — a supported, + * Thymeleaf engine never overrode it, so an application that explicitly composes Thymeleaf * documented value — a subject could carry CR/LF and a deep link could carry a {@code javascript:} * scheme. Nothing failed, because the interface compiled and the one engine under test was the one * that implemented the rule. diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/template/SlotAwareRenderingTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/template/SlotAwareRenderingTest.java index b75f5ab0..cf7f8773 100644 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/template/SlotAwareRenderingTest.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/template/SlotAwareRenderingTest.java @@ -56,6 +56,45 @@ class SlotAwareRenderingTest { .contains("""); } + @Test + @DisplayName("operator HTML cannot introduce active script or event-handler markup") + void operatorHtmlIsRestrictedToTheReviewedMarkupSubset() { + assertThatThrownBy( + () -> + engine.render( + TemplateSlotMode.HTML_TEXT, + "

{name}

", + Map.of("name", "Ada"))) + .isInstanceOf(TemplateRenderingException.class); + + assertThatThrownBy( + () -> + engine.render( + TemplateSlotMode.HTML_TEXT, + "

{name}

", + Map.of("name", "Ada"))) + .isInstanceOf(TemplateRenderingException.class); + } + + @Test + @DisplayName("HTML links in persisted templates are static HTTPS links only") + void htmlLinksAreStaticHttpsOnly() { + assertThatThrownBy( + () -> + engine.render( + TemplateSlotMode.HTML_TEXT, + "{name}", + Map.of("name", "open"))) + .isInstanceOf(TemplateRenderingException.class); + + assertThat( + engine.render( + TemplateSlotMode.HTML_TEXT, + "{name}", + Map.of("name", "open"))) + .contains("https://example.com/order"); + } + @Test @DisplayName("plain text is left exactly as the caller wrote it") void plainTextIsLeftAlone() { diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/testkit/CallbackContract.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/testkit/CallbackContract.java index 0bf316a4..f3549586 100644 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/testkit/CallbackContract.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/testkit/CallbackContract.java @@ -2,10 +2,10 @@ package dev.caskeleton.adapter.outbound.notification.platform.testkit; import static org.assertj.core.api.Assertions.assertThat; -import dev.caskeleton.application.notification.platform.api.CallbackRequest; -import dev.caskeleton.application.notification.platform.callback.CallbackVerificationResult; -import dev.caskeleton.application.notification.platform.callback.NormalizedProviderEvent; -import dev.caskeleton.application.notification.platform.callback.ProviderCallbackAdapter; +import dev.caskeleton.adapter.outbound.notification.platform.callback.CallbackVerificationResult; +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackAdapter; +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackVerificationRequest; +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; import java.util.List; import org.junit.jupiter.api.Test; @@ -25,13 +25,13 @@ public abstract class CallbackContract { protected abstract ProviderCallbackAdapter adapter(); /** A correctly signed callback. */ - protected abstract CallbackRequest signedRequest(); + protected abstract ProviderCallbackVerificationRequest signedRequest(); /** The same callback with one signed field altered. */ - protected abstract CallbackRequest tamperedRequest(); + protected abstract ProviderCallbackVerificationRequest tamperedRequest(); /** A callback whose signature header is absent or malformed. */ - protected abstract CallbackRequest unsignedRequest(); + protected abstract ProviderCallbackVerificationRequest unsignedRequest(); @Test void aValidSignatureIsAcceptedAndCarriesTheVerifiedCallback() { @@ -62,7 +62,7 @@ public abstract class CallbackContract { @Test void verificationIsPureSoADuplicateDeliveryProducesTheSameEvents() { - CallbackRequest request = signedRequest(); + ProviderCallbackVerificationRequest request = signedRequest(); List first = adapter().normalize(adapter().verify(request).verifiedCallback().orElseThrow()); diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/testkit/ContractAdapters.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/testkit/ContractAdapters.java index 6f4e1d59..37eea392 100644 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/testkit/ContractAdapters.java +++ b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/testkit/ContractAdapters.java @@ -106,7 +106,7 @@ public final class ContractAdapters { Duration.ofSeconds(3)); var adapter = new SesNotificationProviderAdapter( - new JdkNotificationHttpGateway(Duration.ofSeconds(2)), + new JdkNotificationHttpGateway(Duration.ofSeconds(2), true), new SesRequestMapper( properties, new AwsSignatureV4Signer(), @@ -146,7 +146,7 @@ public final class ContractAdapters { Duration.ofHours(12)); var adapter = new TwilioSmsProviderAdapter( - new JdkNotificationHttpGateway(Duration.ofSeconds(2)), + new JdkNotificationHttpGateway(Duration.ofSeconds(2), true), new TwilioRequestMapper(properties), new TwilioFailureClassifier(), protector, @@ -173,7 +173,7 @@ public final class ContractAdapters { Duration.ofSeconds(3)); var adapter = new ApnsNotificationProviderAdapter( - new JdkNotificationHttpGateway(Duration.ofSeconds(2)), + new JdkNotificationHttpGateway(Duration.ofSeconds(2), true), new ApnsRequestMapper(properties, CLOCK), new ApnsFailureClassifier(), protector, @@ -197,7 +197,7 @@ public final class ContractAdapters { "BFakePublicKeyForTests", Duration.ofHours(1), 4096L, false, Duration.ofSeconds(3)); var adapter = new WebPushNotificationProviderAdapter( - new JdkNotificationHttpGateway(Duration.ofSeconds(2)), + new JdkNotificationHttpGateway(Duration.ofSeconds(2), true), new WebPushRequestMapper( new Rfc8291Aes128GcmEncryptor(RANDOM), // Signing needs a PKCS#8 EC key, which WebPushCryptoTest covers; the suites here @@ -226,7 +226,7 @@ public final class ContractAdapters { } private static Case webhook(ProviderFaultHarness harness, ContactPointProtector protector) { - var gateway = new JdkNotificationHttpGateway(Duration.ofSeconds(2)); + var gateway = new JdkNotificationHttpGateway(Duration.ofSeconds(2), true); // The id of a real callback signing key, because a subscription is now signed with the key its // reference names rather than with whatever the platform's current one happens to be. var subscription = diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/provider/InlineNotificationAttemptAdapterTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/provider/InlineNotificationAttemptAdapterTest.java deleted file mode 100644 index a2bff37f..00000000 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/provider/InlineNotificationAttemptAdapterTest.java +++ /dev/null @@ -1,55 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.provider; - -import static org.assertj.core.api.Assertions.assertThat; -import static org.assertj.core.api.Assertions.assertThatThrownBy; - -import dev.caskeleton.adapter.outbound.notification.template.RenderedNotification; -import dev.caskeleton.application.notification.NotificationMode; -import dev.caskeleton.application.notification.NotificationRequestResult; -import java.time.Instant; -import java.util.concurrent.atomic.AtomicInteger; -import org.junit.jupiter.api.Test; - -class InlineNotificationAttemptAdapterTest { - - @Test - void inlinePlanInvokesOneClientPerFrozenTargetAndDurablePlanIsRejected() { - AtomicInteger sends = new AtomicInteger(); - NotificationProviderAttemptClient client = - new NotificationProviderAttemptClient() { - @Override - public PreparedNotificationAttempt prepare( - RenderedNotification rendered, - dev.caskeleton.adapter.outbound.notification.catalog.CompiledNotificationBinding - .CompiledTarget - target, - NotificationAttemptContext context) { - return new PreparedNotificationAttempt(rendered, target, context, "c".repeat(64)); - } - - @Override - public ClientAttemptResult sendOneAuthorizedAttempt( - PreparedNotificationAttempt prepared, - String executionToken, - NotificationSecretMaterialHandle secret, - Instant absoluteDeadline) { - sends.incrementAndGet(); - return new ClientAttemptResult.Accepted( - new ProviderMessageReference("provider-message-42")); - } - }; - InlineNotificationAttemptAdapter adapter = - new InlineNotificationAttemptAdapter( - ProviderTestFixtures.attemptAdapter(client, NotificationMode.BEST_EFFORT_INLINE)); - - NotificationRequestResult.InlineCompleted result = - adapter.attempt(ProviderTestFixtures.plan(NotificationMode.BEST_EFFORT_INLINE)); - - assertThat(sends).hasValue(1); - assertThat(result.outcomes()).hasSize(1); - assertThatThrownBy( - () -> adapter.attempt(ProviderTestFixtures.plan(NotificationMode.DURABLE_ASYNC))) - .isInstanceOf(IllegalArgumentException.class) - .hasMessageContaining("inline"); - } -} diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationAdmissionReadinessAdapterTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationAdmissionReadinessAdapterTest.java deleted file mode 100644 index 6e46da9d..00000000 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationAdmissionReadinessAdapterTest.java +++ /dev/null @@ -1,195 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.provider; - -import static org.assertj.core.api.Assertions.assertThat; -import static org.assertj.core.api.Assertions.assertThatThrownBy; - -import dev.caskeleton.adapter.outbound.notification.catalog.NotificationProviderRuntimeProfile; -import dev.caskeleton.application.notification.NotificationAdmissionReadinessPort; -import dev.caskeleton.application.notification.NotificationFaultScope; -import dev.caskeleton.application.notification.NotificationReasonCode; -import dev.caskeleton.application.notification.NotificationRouteId; -import java.time.Clock; -import java.time.Instant; -import java.time.ZoneId; -import java.time.ZoneOffset; -import java.util.concurrent.atomic.AtomicBoolean; -import java.util.concurrent.atomic.AtomicReference; -import org.junit.jupiter.api.Test; - -class NotificationAdmissionReadinessAdapterTest { - - @Test - void internalNonSecretProbeMustBeFreshAndExactBeforeDelegatedResume() { - AtomicBoolean resumed = new AtomicBoolean(); - NotificationAdmissionReadinessPort state = - new NotificationAdmissionReadinessPort() { - @Override - public ParkResult park(ParkRequest request) { - return ParkResult.PARKED; - } - - @Override - public ResumeResult resume( - ResumeRequest request, ReadinessProbe probe, Instant resumedAt) { - resumed.set(true); - return new ResumeResult( - ResumeStatus.RESUMED, request.expectedGeneration() + 1, 1, 0, 0, 0, 0, 0); - } - }; - NotificationProviderRuntimeProfile profile = profile("credential-r1"); - NotificationAdmissionReadinessAdapter adapter = - new NotificationAdmissionReadinessAdapter( - state, - request -> profile, - (selected, deadline) -> - new NotificationProviderReadinessSnapshot( - selected.profileId(), - selected.bindingRevision(), - selected.capabilityCardId(), - selected.credentialGeneration(), - true, - new NotificationReasonCode("READINESS_CONFIRMED"), - ProviderTestFixtures.NOW, - ProviderTestFixtures.NOW.plusSeconds(10)), - Clock.fixed(ProviderTestFixtures.NOW, ZoneOffset.UTC)); - NotificationAdmissionReadinessPort.ResumeRequest request = request(); - - NotificationAdmissionReadinessPort.ReadinessProbe probe = adapter.probe(request); - var result = adapter.resume(request, probe, ProviderTestFixtures.NOW); - - assertThat(probe.ready()).isTrue(); - assertThat(result.status()).isEqualTo(NotificationAdmissionReadinessPort.ResumeStatus.RESUMED); - assertThat(resumed).isTrue(); - assertThat(adapter.toString()).doesNotContain("secret-ref-r1", "destination-ref-r1"); - assertThatThrownBy( - () -> adapter.resume(request, probe, ProviderTestFixtures.NOW.plusSeconds(2))) - .isInstanceOf(IllegalStateException.class) - .hasMessageContaining("fresh"); - } - - @Test - void probeFailuresTokenSubstitutionAndCredentialRotationFailClosed() { - AtomicReference current = - new AtomicReference<>(profile("credential-r1")); - NotificationAdmissionReadinessAdapter adapter = - new NotificationAdmissionReadinessAdapter( - request -> NotificationAdmissionReadinessPort.ParkResult.PARKED, - request -> current.get(), - (selected, deadline) -> - new NotificationProviderReadinessSnapshot( - selected.profileId(), - selected.bindingRevision(), - selected.capabilityCardId(), - selected.credentialGeneration(), - true, - new NotificationReasonCode("READINESS_CONFIRMED"), - ProviderTestFixtures.NOW, - ProviderTestFixtures.NOW.plusSeconds(10)), - Clock.fixed(ProviderTestFixtures.NOW, ZoneOffset.UTC)); - NotificationAdmissionReadinessPort.ResumeRequest original = request(); - NotificationAdmissionReadinessPort.ReadinessProbe ready = adapter.probe(original); - NotificationAdmissionReadinessPort.ResumeRequest substituted = - new NotificationAdmissionReadinessPort.ResumeRequest( - original.operationToken(), - original.routeId(), - original.policyRevision(), - original.faultScope(), - original.scopeReference(), - original.expectedGeneration(), - original.maximumParkedLegs(), - "different-operator", - original.reasonCode()); - - NotificationAdmissionReadinessPort.ReadinessProbe conflict = adapter.probe(substituted); - - assertThat(conflict.ready()).isFalse(); - assertThat(conflict.reasonCode().value()).isEqualTo("READINESS_TOKEN_CONFLICT"); - current.set(profile("credential-r2")); - assertThatThrownBy( - () -> adapter.resume(original, ready, ProviderTestFixtures.NOW.plusSeconds(1))) - .isInstanceOf(IllegalStateException.class) - .hasMessageContaining("generation"); - - NotificationAdmissionReadinessAdapter failing = - new NotificationAdmissionReadinessAdapter( - request -> NotificationAdmissionReadinessPort.ParkResult.PARKED, - request -> { - throw new IllegalStateException("secret reference must not escape"); - }, - (selected, deadline) -> { - throw new AssertionError("probe must not run"); - }, - Clock.fixed(ProviderTestFixtures.NOW, ZoneOffset.UTC)); - NotificationAdmissionReadinessPort.ReadinessProbe failed = failing.probe(request()); - assertThat(failed.ready()).isFalse(); - assertThat(failed.reasonCode().value()).isEqualTo("READINESS_PROBE_FAILED"); - assertThat(failed.toString()).doesNotContain("secret reference"); - } - - @Test - void readinessObservationAfterProbeIoIsValidatedAgainstPostCallTime() { - AtomicReference currentTime = new AtomicReference<>(ProviderTestFixtures.NOW); - Clock advancingClock = - new Clock() { - @Override - public ZoneId getZone() { - return ZoneOffset.UTC; - } - - @Override - public Clock withZone(ZoneId zone) { - return this; - } - - @Override - public Instant instant() { - return currentTime.get(); - } - }; - NotificationAdmissionReadinessAdapter adapter = - new NotificationAdmissionReadinessAdapter( - request -> NotificationAdmissionReadinessPort.ParkResult.PARKED, - request -> profile("credential-r1"), - (selected, deadline) -> { - currentTime.set(ProviderTestFixtures.NOW.plusSeconds(1)); - return new NotificationProviderReadinessSnapshot( - selected.profileId(), - selected.bindingRevision(), - selected.capabilityCardId(), - selected.credentialGeneration(), - true, - new NotificationReasonCode("READINESS_CONFIRMED"), - currentTime.get(), - currentTime.get().plusSeconds(10)); - }, - advancingClock); - - NotificationAdmissionReadinessPort.ReadinessProbe probe = adapter.probe(request()); - - assertThat(probe.ready()).isTrue(); - } - - private static NotificationProviderRuntimeProfile profile(String credentialGeneration) { - return new NotificationProviderRuntimeProfile( - "slack-runtime-r1", - "slack-web-api", - "slack-binding-r1", - "slack-web-api-durable-single-local-v1", - credentialGeneration, - "secret-ref-r1", - "destination-ref-r1"); - } - - private static NotificationAdmissionReadinessPort.ResumeRequest request() { - return new NotificationAdmissionReadinessPort.ResumeRequest( - "resume-operation-42", - new NotificationRouteId("security-slack"), - 3, - NotificationFaultScope.PROVIDER_BINDING, - "provider-binding-scope-42", - 7, - 10, - "operator-42", - new NotificationReasonCode("OPERATOR_RESUME")); - } -} diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderAttemptContractTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderAttemptContractTest.java deleted file mode 100644 index a2558bf4..00000000 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationProviderAttemptContractTest.java +++ /dev/null @@ -1,402 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.provider; - -import static org.assertj.core.api.Assertions.assertThat; - -import dev.caskeleton.adapter.outbound.notification.catalog.NotificationBindingCompiler; -import dev.caskeleton.adapter.outbound.notification.catalog.NotificationPlanAdapter; -import dev.caskeleton.adapter.outbound.notification.catalog.NotificationProviderCapabilityCard; -import dev.caskeleton.adapter.outbound.notification.catalog.NotificationProviderDescriptor; -import dev.caskeleton.adapter.outbound.notification.catalog.NotificationProviderRuntimeProfile; -import dev.caskeleton.adapter.outbound.notification.catalog.NotificationRouteDescriptor; -import dev.caskeleton.adapter.outbound.notification.catalog.NotificationTemplateDescriptor; -import dev.caskeleton.adapter.outbound.notification.template.RenderedNotification; -import dev.caskeleton.application.notification.ConsentCheckMode; -import dev.caskeleton.application.notification.NotificationAdmissionClass; -import dev.caskeleton.application.notification.NotificationChannel; -import dev.caskeleton.application.notification.NotificationDeliveryId; -import dev.caskeleton.application.notification.NotificationDeliveryStorePort; -import dev.caskeleton.application.notification.NotificationFrozenPlan; -import dev.caskeleton.application.notification.NotificationIntentDraft; -import dev.caskeleton.application.notification.NotificationIntentId; -import dev.caskeleton.application.notification.NotificationKindId; -import dev.caskeleton.application.notification.NotificationKindPolicy; -import dev.caskeleton.application.notification.NotificationMode; -import dev.caskeleton.application.notification.NotificationPlanningResult; -import dev.caskeleton.application.notification.NotificationProviderAttemptPort; -import dev.caskeleton.application.notification.NotificationReasonCode; -import dev.caskeleton.application.notification.NotificationRouteId; -import dev.caskeleton.application.notification.NotificationRouteStrategy; -import dev.caskeleton.application.notification.NotificationTemplateParameters; -import dev.caskeleton.application.notification.NotificationTemplateRef; -import dev.caskeleton.application.notification.NotificationTemplateValue; -import dev.caskeleton.application.notification.RetryDisposition; -import dev.caskeleton.application.notification.SlackAudienceReference; -import dev.caskeleton.application.notification.SubmissionCertainty; -import java.time.Clock; -import java.time.Duration; -import java.time.Instant; -import java.time.ZoneOffset; -import java.util.List; -import java.util.Locale; -import java.util.Map; -import java.util.Optional; -import java.util.Set; -import java.util.concurrent.atomic.AtomicInteger; -import java.util.concurrent.atomic.AtomicReference; -import org.junit.jupiter.api.Test; - -class NotificationProviderAttemptContractTest { - - @Test - void oneAuthorizationPreparesWithoutWireIoAndInvokesClientExactlyOnceWithinAbsoluteDeadline() { - AtomicInteger prepareCalls = new AtomicInteger(); - AtomicInteger wireCalls = new AtomicInteger(); - AtomicReference observedDeadline = new AtomicReference<>(); - NotificationProviderAttemptClient client = - new NotificationProviderAttemptClient() { - @Override - public PreparedNotificationAttempt prepare( - RenderedNotification rendered, - dev.caskeleton.adapter.outbound.notification.catalog.CompiledNotificationBinding - .CompiledTarget - target, - NotificationAttemptContext context) { - prepareCalls.incrementAndGet(); - assertThat(wireCalls).hasValue(0); - return new PreparedNotificationAttempt(rendered, target, context, "c".repeat(64)); - } - - @Override - public ClientAttemptResult sendOneAuthorizedAttempt( - PreparedNotificationAttempt prepared, - String executionToken, - NotificationSecretMaterialHandle secret, - Instant absoluteDeadline) { - wireCalls.incrementAndGet(); - observedDeadline.set(absoluteDeadline); - return new ClientAttemptResult.Accepted( - new ProviderMessageReference("provider-message-42")); - } - }; - Instant now = ProviderTestFixtures.NOW; - NotificationDeliveryStorePort.AuthorizedAttempt authorized = - ProviderTestFixtures.authorized(NotificationMode.DURABLE_ASYNC, now.plusSeconds(3)); - NotificationProviderAttemptPort adapter = - ProviderTestFixtures.attemptAdapter(client, NotificationMode.DURABLE_ASYNC); - - var outcome = adapter.attempt(authorized); - - assertThat(prepareCalls).hasValue(1); - assertThat(wireCalls).hasValue(1); - assertThat(observedDeadline.get()).isEqualTo(now.plusSeconds(3)); - assertThat(outcome.submissionCertainty()).isEqualTo(SubmissionCertainty.PROVIDER_ACCEPTED); - assertThat(outcome.providerMessageReference()).contains("provider-message-42"); - assertThat(outcome.attemptCorrelationReference()).isNotEqualTo(authorized.executionToken()); - } - - @Test - void preWireValidationAndPossibleWriteFailuresHaveDifferentCertaintyAndSdkErrorsNeverEscape() { - NotificationProviderAttemptClient invalidBeforeWire = - new NotificationProviderAttemptClient() { - @Override - public PreparedNotificationAttempt prepare( - RenderedNotification rendered, - dev.caskeleton.adapter.outbound.notification.catalog.CompiledNotificationBinding - .CompiledTarget - target, - NotificationAttemptContext context) { - throw new NotificationProviderAttemptClient.PreWireDeliveryRejectedException(); - } - - @Override - public ClientAttemptResult sendOneAuthorizedAttempt( - PreparedNotificationAttempt prepared, - String executionToken, - NotificationSecretMaterialHandle secret, - Instant absoluteDeadline) { - throw new AssertionError("wire call must not run"); - } - }; - NotificationProviderAttemptClient responseLost = - new NotificationProviderAttemptClient() { - @Override - public PreparedNotificationAttempt prepare( - RenderedNotification rendered, - dev.caskeleton.adapter.outbound.notification.catalog.CompiledNotificationBinding - .CompiledTarget - target, - NotificationAttemptContext context) { - return new PreparedNotificationAttempt(rendered, target, context, "c".repeat(64)); - } - - @Override - public ClientAttemptResult sendOneAuthorizedAttempt( - PreparedNotificationAttempt prepared, - String executionToken, - NotificationSecretMaterialHandle secret, - Instant absoluteDeadline) { - throw new IllegalStateException("SDK body and token must not escape"); - } - }; - - var preWire = - ProviderTestFixtures.attemptAdapter(invalidBeforeWire, NotificationMode.DURABLE_ASYNC) - .attempt( - ProviderTestFixtures.authorized( - NotificationMode.DURABLE_ASYNC, ProviderTestFixtures.NOW.plusSeconds(3))); - var possibleWrite = - ProviderTestFixtures.attemptAdapter(responseLost, NotificationMode.DURABLE_ASYNC) - .attempt( - ProviderTestFixtures.authorized( - NotificationMode.DURABLE_ASYNC, ProviderTestFixtures.NOW.plusSeconds(3))); - - assertThat(preWire.submissionCertainty()).isEqualTo(SubmissionCertainty.DEFINITELY_NOT_APPLIED); - assertThat(preWire.retryDisposition()).isEqualTo(RetryDisposition.TERMINAL); - assertThat(possibleWrite.submissionCertainty()).isEqualTo(SubmissionCertainty.INDETERMINATE); - assertThat(possibleWrite.toString()).doesNotContain("SDK body", "token must not escape"); - } - - @Test - void preparedAttemptMustRemainBoundToTheAuthorizedRenderedTargetAndContext() { - AtomicInteger wireCalls = new AtomicInteger(); - NotificationProviderAttemptClient misbindingClient = - new NotificationProviderAttemptClient() { - @Override - public PreparedNotificationAttempt prepare( - RenderedNotification rendered, - dev.caskeleton.adapter.outbound.notification.catalog.CompiledNotificationBinding - .CompiledTarget - target, - NotificationAttemptContext context) { - NotificationAttemptContext differentContext = - new NotificationAttemptContext( - context.deliveryId(), - context.attemptId(), - context.targetOrdinal(), - context.correlationId(), - Optional.of( - new NotificationAttemptContext.ProviderClientOperationKey( - "different-operation-key")), - context.absoluteDeadline()); - return new PreparedNotificationAttempt( - rendered, target, differentContext, "c".repeat(64)); - } - - @Override - public ClientAttemptResult sendOneAuthorizedAttempt( - PreparedNotificationAttempt prepared, - String executionToken, - NotificationSecretMaterialHandle secret, - Instant absoluteDeadline) { - wireCalls.incrementAndGet(); - throw new AssertionError("misbound prepared attempt must not reach the wire"); - } - }; - - var outcome = - ProviderTestFixtures.attemptAdapter(misbindingClient, NotificationMode.DURABLE_ASYNC) - .attempt( - ProviderTestFixtures.authorized( - NotificationMode.DURABLE_ASYNC, ProviderTestFixtures.NOW.plusSeconds(3))); - - assertThat(wireCalls).hasValue(0); - assertThat(outcome.submissionCertainty()).isEqualTo(SubmissionCertainty.DEFINITELY_NOT_APPLIED); - assertThat(outcome.retryDisposition()).isEqualTo(RetryDisposition.PARK_BINDING); - assertThat(outcome.reasonCode().value()).isEqualTo("PROVIDER_PREPARED_ATTEMPT_MISMATCH"); - } -} - -final class ProviderTestFixtures { - - static final Instant NOW = Instant.parse("2026-07-29T00:00:00Z"); - - private ProviderTestFixtures() {} - - static NotificationProviderAttemptAdapter attemptAdapter( - NotificationProviderAttemptClient client, NotificationMode mode) { - NotificationBindingCompiler.CompiledGraph graph = graph(mode); - return new NotificationProviderAttemptAdapter( - graph, - Map.of( - "slack-renderer-r1", - plan -> - new RenderedNotification.Slack( - plan.selectedLocale(), - List.of(RenderedNotification.SlackBlock.mrkdwn("safe message")), - 3, - "safe message".getBytes(java.nio.charset.StandardCharsets.UTF_8).length)), - Map.of(cardId(mode), client), - (profile, deadline) -> - NotificationProviderRateAdmission.Decision.admitted( - new NotificationReasonCode("RATE_ADMISSION_GRANTED")), - profile -> - NotificationSecretMaterialHandle.fromBytes( - profile.credentialGeneration(), - "provider-test-secret-material-32" - .getBytes(java.nio.charset.StandardCharsets.UTF_8)), - Clock.fixed(NOW, ZoneOffset.UTC)); - } - - static NotificationDeliveryStorePort.AuthorizedAttempt authorized( - NotificationMode mode, Instant deadline) { - NotificationFrozenPlan plan = plan(mode); - return new NotificationDeliveryStorePort.AuthorizedAttempt( - new NotificationDeliveryId("delivery-42"), - new dev.caskeleton.application.notification.NotificationAttemptId("attempt-42"), - plan, - 0, - "claim-token-42", - "execution-token-42", - 3, - 7, - "provider-binding-scope-42", - deadline); - } - - static NotificationFrozenPlan plan(NotificationMode mode) { - NotificationKindPolicy policy = - new NotificationKindPolicy( - new NotificationKindId("security-slack"), - NotificationChannel.SLACK, - new NotificationRouteId("security-slack"), - new NotificationTemplateRef("security-slack", 1), - mode, - NotificationAdmissionClass.TRANSACTIONAL, - NotificationRouteStrategy.SINGLE, - ConsentCheckMode.SNAPSHOT_AT_APPEND, - 3, - 1, - 1, - 0, - 0, - 1, - Duration.ofMinutes(10)); - NotificationIntentDraft draft = - new NotificationIntentDraft( - new NotificationIntentId("intent-42"), - policy, - Locale.ENGLISH, - new SlackAudienceReference("workspace-ref-42", "audience-ref-42"), - new NotificationTemplateParameters( - Map.of("displayName", new NotificationTemplateValue.SafeText("Ada"))), - "scope-42", - "operation-42", - Optional.empty(), - "correlation-42", - Optional.empty(), - NOW, - NOW.plusSeconds(60)); - NotificationPlanningResult result = new NotificationPlanAdapter(graph(mode)).plan(draft); - return ((NotificationPlanningResult.Planned) result).plan(); - } - - static NotificationBindingCompiler.CompiledGraph graph(NotificationMode mode) { - String cardId = cardId(mode); - NotificationProviderDescriptor provider = - new NotificationProviderDescriptor( - "slack-web-api", - NotificationChannel.SLACK, - false, - List.of(NotificationProviderCapabilityCard.initial(cardId))); - NotificationTemplateDescriptor template = - new NotificationTemplateDescriptor( - new NotificationTemplateRef("security-slack", 1), - NotificationChannel.SLACK, - "slack-renderer-r1", - "b".repeat(64), - Set.of(Locale.ENGLISH), - Locale.ENGLISH, - Set.of("displayName"), - 32_000); - NotificationRouteDescriptor route = - new NotificationRouteDescriptor( - new NotificationRouteId("security-slack"), - 3, - NotificationChannel.SLACK, - mode, - NotificationAdmissionClass.TRANSACTIONAL, - NotificationRouteStrategy.SINGLE, - template.templateRef(), - false, - false, - 1, - 1, - 0, - 0, - 1, - Duration.ofSeconds(5), - List.of( - new NotificationRouteDescriptor.Target( - "slack-primary", "slack-runtime-r1", Optional.empty()))); - NotificationProviderRuntimeProfile profile = - new NotificationProviderRuntimeProfile( - "slack-runtime-r1", - "slack-web-api", - "slack-binding-r1", - cardId, - "credential-r1", - "secret-ref-r1", - "destination-ref-r1"); - return new NotificationBindingCompiler( - List.of(provider), List.of(template), List.of(route), List.of(profile)) - .compile(); - } - - static NotificationBindingCompiler.CompiledGraph emailGraph() { - String cardId = "aws-ses-v2-durable-single-local-sns-v1"; - NotificationProviderDescriptor provider = - new NotificationProviderDescriptor( - "aws-ses-v2", - NotificationChannel.EMAIL, - false, - List.of(NotificationProviderCapabilityCard.initial(cardId))); - NotificationTemplateDescriptor template = - new NotificationTemplateDescriptor( - new NotificationTemplateRef("security-email", 1), - NotificationChannel.EMAIL, - "email-renderer-r1", - "e".repeat(64), - Set.of(Locale.ENGLISH), - Locale.ENGLISH, - Set.of("displayName"), - 64_000); - NotificationRouteDescriptor route = - new NotificationRouteDescriptor( - new NotificationRouteId("security-email"), - 3, - NotificationChannel.EMAIL, - NotificationMode.DURABLE_ASYNC, - NotificationAdmissionClass.SECURITY_CRITICAL, - NotificationRouteStrategy.SINGLE, - template.templateRef(), - true, - false, - 1, - 1, - 0, - 1, - 2, - Duration.ofSeconds(5), - List.of( - new NotificationRouteDescriptor.Target( - "email-primary", "email-runtime-r1", Optional.empty()))); - NotificationProviderRuntimeProfile profile = - new NotificationProviderRuntimeProfile( - "email-runtime-r1", - "aws-ses-v2", - "ses-binding-r1", - cardId, - "credential-r1", - "secret-ref-r1", - "destination-ref-r1"); - return new NotificationBindingCompiler( - List.of(provider), List.of(template), List.of(route), List.of(profile)) - .compile(); - } - - static String cardId(NotificationMode mode) { - return mode == NotificationMode.BEST_EFFORT_INLINE - ? "slack-web-api-inline-single-local-v1" - : "slack-web-api-durable-single-local-v1"; - } -} diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationReconciliationAdapterTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationReconciliationAdapterTest.java deleted file mode 100644 index 0fdad560..00000000 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationReconciliationAdapterTest.java +++ /dev/null @@ -1,194 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.provider; - -import static org.assertj.core.api.Assertions.assertThat; - -import dev.caskeleton.application.notification.NotificationDeliveryId; -import dev.caskeleton.application.notification.NotificationDeliveryStorePort; -import dev.caskeleton.application.notification.NotificationReasonCode; -import dev.caskeleton.application.notification.SubmissionCertainty; -import java.time.Clock; -import java.time.Instant; -import java.time.ZoneOffset; -import java.util.concurrent.atomic.AtomicReference; -import org.junit.jupiter.api.Test; - -class NotificationReconciliationAdapterTest { - - @Test - void expiredLookupRemainsIndeterminateAndDoesNotCallProvider() { - NotificationDeliveryStorePort.ReconciliationClaim expired = - claim( - "correlation-42", - NotificationDeliveryStorePort.ReconciliationLookupKind.PRE_SEND_CORRELATION, - ProviderTestFixtures.NOW); - NotificationReconciliationAdapter adapter = - new NotificationReconciliationAdapter( - ignored -> { - throw new AssertionError("expired reconciliation must not resolve a client"); - }, - ignored -> { - throw new AssertionError("expired reconciliation must not acquire a secret"); - }, - Clock.fixed(ProviderTestFixtures.NOW, ZoneOffset.UTC)); - - var result = adapter.reconcile(expired); - - assertThat(result.submissionCertainty()).isEqualTo(SubmissionCertainty.INDETERMINATE); - assertThat(result.reasonCode().value()).isEqualTo("RECONCILIATION_DEADLINE_EXPIRED"); - } - - @Test - void approvedPreSendCorrelationLookupIsBoundedAndClientFailuresBecomeIndeterminate() { - AtomicReference mode = new AtomicReference<>(); - AtomicReference clientResult = - new AtomicReference<>( - new NotificationProviderAttemptClient.ClientReconciliationResult( - SubmissionCertainty.PROVIDER_ACCEPTED, - new NotificationReasonCode("PROVIDER_ACCEPTED"))); - NotificationProviderAttemptClient client = - new NotificationProviderAttemptClient() { - @Override - public PreparedNotificationAttempt prepare( - dev.caskeleton.adapter.outbound.notification.template.RenderedNotification rendered, - dev.caskeleton.adapter.outbound.notification.catalog.CompiledNotificationBinding - .CompiledTarget - target, - NotificationAttemptContext context) { - throw new UnsupportedOperationException(); - } - - @Override - public ClientAttemptResult sendOneAuthorizedAttempt( - PreparedNotificationAttempt prepared, - String executionToken, - NotificationSecretMaterialHandle secret, - Instant absoluteDeadline) { - throw new UnsupportedOperationException(); - } - - @Override - public ClientReconciliationResult reconcile( - ReconciliationReference reference, - ReconciliationLookupMode lookupMode, - NotificationSecretMaterialHandle secret, - Instant absoluteDeadline) { - mode.set(lookupMode); - return clientResult.get(); - } - }; - NotificationDeliveryStorePort.ReconciliationClaim claim = - claim( - "attempt-correlation-42", - NotificationDeliveryStorePort.ReconciliationLookupKind.PRE_SEND_CORRELATION, - ProviderTestFixtures.NOW.plusSeconds(3)); - NotificationReconciliationAdapter adapter = - new NotificationReconciliationAdapter( - ignored -> binding(client), - profile -> - NotificationSecretMaterialHandle.fromBytes( - profile.credentialGeneration(), new byte[] {1}), - Clock.fixed(ProviderTestFixtures.NOW, ZoneOffset.UTC)); - - var result = adapter.reconcile(claim); - - assertThat(mode).hasValue(ReconciliationLookupMode.PRE_SEND_CORRELATION); - assertThat(result.submissionCertainty()).isEqualTo(SubmissionCertainty.PROVIDER_ACCEPTED); - - clientResult.set( - new NotificationProviderAttemptClient.ClientReconciliationResult( - SubmissionCertainty.DEFINITELY_NOT_APPLIED, - new NotificationReasonCode("PROVIDER_EVENT_NOT_FOUND"))); - var unprovenNonApplication = adapter.reconcile(claim); - assertThat(unprovenNonApplication.submissionCertainty()) - .isEqualTo(SubmissionCertainty.INDETERMINATE); - assertThat(unprovenNonApplication.reasonCode().value()) - .isEqualTo("RECONCILIATION_NONAPPLICATION_UNPROVEN"); - - mode.set(null); - var unsupported = - adapter.reconcile( - claim( - "provider-message-42", - NotificationDeliveryStorePort.ReconciliationLookupKind.MESSAGE_REFERENCE, - ProviderTestFixtures.NOW.plusSeconds(3))); - assertThat(mode.get()).isNull(); - assertThat(unsupported.submissionCertainty()).isEqualTo(SubmissionCertainty.INDETERMINATE); - assertThat(unsupported.reasonCode().value()).isEqualTo("RECONCILIATION_UNSUPPORTED"); - - NotificationReconciliationAdapter failing = - new NotificationReconciliationAdapter( - ignored -> binding(new ThrowingReconciliationClient()), - profile -> - NotificationSecretMaterialHandle.fromBytes( - profile.credentialGeneration(), new byte[] {1}), - Clock.fixed(ProviderTestFixtures.NOW, ZoneOffset.UTC)); - assertThat(failing.reconcile(claim).submissionCertainty()) - .isEqualTo(SubmissionCertainty.INDETERMINATE); - } - - private static NotificationDeliveryStorePort.ReconciliationClaim claim( - String lookupReference, - NotificationDeliveryStorePort.ReconciliationLookupKind lookupKind, - Instant deadline) { - var compiled = compiledBinding(); - var target = compiled.targets().getFirst(); - return new NotificationDeliveryStorePort.ReconciliationClaim( - new NotificationDeliveryId("delivery-42"), - "reconcile-token-42", - 3, - compiled.route().routeId(), - compiled.route().routeRevision(), - compiled.bindingDigest(), - 0, - target.target().targetId(), - target.capabilityCard().cardId(), - target.runtimeProfile().bindingRevision(), - target.runtimeProfile().credentialGeneration(), - lookupReference, - lookupKind, - deadline); - } - - private static NotificationReconciliationAdapter.ReconciliationBinding binding( - NotificationProviderAttemptClient client) { - var compiled = compiledBinding(); - return new NotificationReconciliationAdapter.ReconciliationBinding(compiled, 0, client); - } - - private static dev.caskeleton.adapter.outbound.notification.catalog.CompiledNotificationBinding - compiledBinding() { - return ProviderTestFixtures.emailGraph().bindings().getFirst(); - } - - private static final class ThrowingReconciliationClient - implements NotificationProviderAttemptClient { - - @Override - public PreparedNotificationAttempt prepare( - dev.caskeleton.adapter.outbound.notification.template.RenderedNotification rendered, - dev.caskeleton.adapter.outbound.notification.catalog.CompiledNotificationBinding - .CompiledTarget - target, - NotificationAttemptContext context) { - throw new UnsupportedOperationException(); - } - - @Override - public ClientAttemptResult sendOneAuthorizedAttempt( - PreparedNotificationAttempt prepared, - String executionToken, - NotificationSecretMaterialHandle secret, - Instant absoluteDeadline) { - throw new UnsupportedOperationException(); - } - - @Override - public ClientReconciliationResult reconcile( - ReconciliationReference reference, - ReconciliationLookupMode lookupMode, - NotificationSecretMaterialHandle secret, - Instant absoluteDeadline) { - throw new IllegalStateException("raw SDK reconciliation body"); - } - } -} diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationSecretMaterialHandleTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationSecretMaterialHandleTest.java deleted file mode 100644 index d2e8ba7b..00000000 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/provider/NotificationSecretMaterialHandleTest.java +++ /dev/null @@ -1,38 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.provider; - -import static org.assertj.core.api.Assertions.assertThat; -import static org.assertj.core.api.Assertions.assertThatThrownBy; - -import java.nio.charset.StandardCharsets; -import java.util.Arrays; -import java.util.concurrent.atomic.AtomicReference; -import org.junit.jupiter.api.Test; - -class NotificationSecretMaterialHandleTest { - - @Test - void mutableCopyIsVersionedRedactedWipedAndRejectedAfterClose() { - byte[] caller = "sensitive-token".getBytes(StandardCharsets.UTF_8); - AtomicReference borrowed = new AtomicReference<>(); - NotificationSecretMaterialHandle handle = - NotificationSecretMaterialHandle.fromBytes("secret-r7", caller); - Arrays.fill(caller, (byte) 0); - - String observed = - handle.readBytes( - bytes -> { - borrowed.set(bytes); - return new String(bytes, StandardCharsets.UTF_8); - }); - - assertThat(observed).isEqualTo("sensitive-token"); - assertThat(handle.revision()).isEqualTo("secret-r7"); - assertThat(handle.toString()).doesNotContain("sensitive-token"); - handle.close(); - assertThat(borrowed.get()).containsOnly((byte) 0); - assertThatThrownBy(() -> handle.readBytes(bytes -> bytes.length)) - .isInstanceOf(IllegalStateException.class) - .hasMessageContaining("closed") - .hasMessageNotContaining("sensitive-token"); - } -} diff --git a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/template/NotificationTemplateRendererTest.java b/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/template/NotificationTemplateRendererTest.java deleted file mode 100644 index 979fe69f..00000000 --- a/src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/template/NotificationTemplateRendererTest.java +++ /dev/null @@ -1,390 +0,0 @@ -package dev.caskeleton.adapter.outbound.notification.template; - -import static org.assertj.core.api.Assertions.assertThat; -import static org.assertj.core.api.Assertions.assertThatThrownBy; - -import dev.caskeleton.application.notification.ConsentCheckMode; -import dev.caskeleton.application.notification.EmailRecipientReference; -import dev.caskeleton.application.notification.NotificationAdmissionClass; -import dev.caskeleton.application.notification.NotificationChannel; -import dev.caskeleton.application.notification.NotificationFrozenPlan; -import dev.caskeleton.application.notification.NotificationIntentDraft; -import dev.caskeleton.application.notification.NotificationIntentId; -import dev.caskeleton.application.notification.NotificationKindId; -import dev.caskeleton.application.notification.NotificationKindPolicy; -import dev.caskeleton.application.notification.NotificationMode; -import dev.caskeleton.application.notification.NotificationRouteId; -import dev.caskeleton.application.notification.NotificationRouteStrategy; -import dev.caskeleton.application.notification.NotificationTemplateParameters; -import dev.caskeleton.application.notification.NotificationTemplateRef; -import dev.caskeleton.application.notification.NotificationTemplateValue; -import dev.caskeleton.application.notification.SlackAudienceReference; -import java.io.ByteArrayInputStream; -import java.io.InputStream; -import java.nio.charset.StandardCharsets; -import java.time.Duration; -import java.time.Instant; -import java.util.List; -import java.util.Locale; -import java.util.Map; -import java.util.Optional; -import java.util.Set; -import org.junit.jupiter.api.Test; - -class NotificationTemplateRendererTest { - - private static final NotificationTemplateRef EMAIL_REF = - new NotificationTemplateRef("contract-email", 1); - private static final NotificationTemplateRef SLACK_REF = - new NotificationTemplateRef("contract-slack", 1); - - @Test - void exactManifestChecksumAndRendererRevisionProduceBoundedEmail() { - NotificationTemplateCatalog catalog = validCatalog(2_000); - NotificationFrozenPlan plan = - emailPlan( - Locale.KOREAN, - Map.of( - "displayName", new NotificationTemplateValue.SafeText(""), - "query", new NotificationTemplateValue.SafeText("alpha beta&gamma")), - catalog.require(EMAIL_REF)); - - RenderedNotification.Email rendered = new LocalEmailRenderer(catalog).render(plan); - - assertThat(rendered.locale()).isEqualTo(Locale.KOREAN); - assertThat(rendered.subject()).isEqualTo("Contract notice for "); - assertThat(rendered.html()) - .contains("<Ada & "Lovelace">") - .contains("alpha%20beta%26gamma") - .doesNotContain(" - new LocalEmailRenderer(catalog) - .render( - emailPlan( - Locale.ENGLISH, - Map.of( - "displayName", new NotificationTemplateValue.SafeText("Ada"), - "query", new NotificationTemplateValue.SafeText("secret-value")), - "0".repeat(64), - manifest.rendererRevision()))) - .isInstanceOf(TemplateRenderingException.class) - .hasMessageContaining("checksum") - .hasMessageNotContaining("secret-value"); - assertThatThrownBy( - () -> - new LocalEmailRenderer(catalog) - .render( - emailPlan( - Locale.ENGLISH, - Map.of( - "displayName", new NotificationTemplateValue.SafeText("Ada"), - "query", new NotificationTemplateValue.SafeText("secret-value")), - manifest.checksum(), - "different-renderer"))) - .isInstanceOf(TemplateRenderingException.class) - .hasMessageContaining("renderer") - .hasMessageNotContaining("secret-value"); - assertThatThrownBy( - () -> - new LocalEmailRenderer(catalog) - .render( - emailPlan( - Locale.ENGLISH, - Map.of("displayName", new NotificationTemplateValue.SafeText("Ada")), - manifest))) - .isInstanceOf(TemplateRenderingException.class) - .hasMessageContaining("parameter"); - assertThatThrownBy( - () -> - new LocalEmailRenderer(roomyCatalog) - .render( - emailPlan( - Locale.ENGLISH, - Map.of( - "displayName", - new NotificationTemplateValue.SafeText("Ada\r\nBcc: victim"), - "query", new NotificationTemplateValue.SafeText("secret-value")), - roomyManifest))) - .isInstanceOf(TemplateRenderingException.class) - .hasMessageContaining("header") - .hasMessageNotContaining("victim"); - assertThatThrownBy( - () -> - new LocalEmailRenderer(catalog) - .render( - emailPlan( - Locale.ENGLISH, - Map.of( - "displayName", - new NotificationTemplateValue.SafeText("A".repeat(100)), - "query", new NotificationTemplateValue.SafeText("secret-value")), - manifest))) - .isInstanceOf(TemplateRenderingException.class) - .hasMessageContaining("bound") - .hasMessageNotContaining("secret-value"); - } - - @Test - void slackBuilderEscapesMrkdwnPlainTextAndBroadcastMentions() { - NotificationTemplateCatalog catalog = validCatalog(2_000); - NotificationTemplateManifest manifest = catalog.require(SLACK_REF); - NotificationFrozenPlan plan = - slackPlan( - Map.of( - "displayName", new NotificationTemplateValue.SafeText("*Ada* "), - "audience", new NotificationTemplateValue.SafeText(" & guests"), - "mention", new NotificationTemplateValue.SafeText("@here <@U123>")), - manifest); - - RenderedNotification.Slack rendered = new SlackBlockKitRenderer(catalog).render(plan); - - assertThat(rendered.blocks()).hasSize(3); - assertThat(rendered.blocks().get(0).type()).isEqualTo(RenderedNotification.TextType.MRKDWN); - assertThat(rendered.blocks().get(0).verbatim()).isTrue(); - assertThat(rendered.blocks().get(0).text()) - .contains("\\*Ada\\* <admin>") - .doesNotContain(""); - assertThat(rendered.blocks().get(1).type()).isEqualTo(RenderedNotification.TextType.PLAIN_TEXT); - assertThat(rendered.blocks().get(1).text()) - .contains("<!channel> & guests") - .doesNotContain(""); - assertThat(rendered.blocks().get(2).text()) - .contains("@\u200Bhere <@\u200BU123>") - .doesNotContain("<@U123>"); - assertThat(rendered.maximumDepth()).isLessThanOrEqualTo(8); - } - - @Test - void htmlContextsCannotCrossIntoActiveAttributesOrMarkup() { - assertThatThrownBy( - () -> - LocalEmailRenderer.validateHtmlContexts( - "")) - .isInstanceOf(TemplateRenderingException.class) - .hasMessageContaining("attribute"); - assertThatThrownBy( - () -> - LocalEmailRenderer.validateHtmlContexts( - "
")) - .isInstanceOf(TemplateRenderingException.class) - .hasMessageContaining("attribute"); - assertThatThrownBy( - () -> - LocalEmailRenderer.validateHtmlContexts( - "")) - .isInstanceOf(TemplateRenderingException.class) - .hasMessageContaining("attribute"); - assertThatThrownBy( - () -> - LocalEmailRenderer.validateHtmlContexts( - "open")) - .isInstanceOf(TemplateRenderingException.class) - .hasMessageContaining("HTTPS link"); - LocalEmailRenderer.validateHtmlContexts( - "

{{displayName|html_text}}

" - + "open"); - } - - @Test - void includeDirectivesAndUnknownResourcesAreRejectedWithoutFileOrNetworkFallback() { - String path = "notification/templates/email/unsafe.txt"; - ClassLoader loader = - new ClassLoader(null) { - @Override - public InputStream getResourceAsStream(String name) { - if (path.equals(name)) { - return new ByteArrayInputStream( - "{{> file:/etc/passwd}}".getBytes(StandardCharsets.UTF_8)); - } - return null; - } - }; - NotificationTemplateManifest.ResourceSet resources = - NotificationTemplateManifest.ResourceSet.email(path, path, path); - String checksum = - NotificationTemplateCatalog.checksum(loader, Map.of(Locale.ENGLISH, resources)); - NotificationTemplateManifest manifest = - new NotificationTemplateManifest( - new NotificationTemplateRef("unsafe-email", 1), - NotificationChannel.EMAIL, - "email-renderer-r1", - checksum, - Set.of(Locale.ENGLISH), - Locale.ENGLISH, - Set.of(), - 1_000, - Map.of(Locale.ENGLISH, resources)); - - assertThatThrownBy(() -> new NotificationTemplateCatalog(loader, List.of(manifest))) - .isInstanceOf(TemplateRenderingException.class) - .hasMessageContaining("directive") - .hasMessageNotContaining("/etc/passwd"); - } - - private static NotificationTemplateCatalog validCatalog(int emailMaximumBytes) { - ClassLoader loader = NotificationTemplateRendererTest.class.getClassLoader(); - NotificationTemplateManifest.ResourceSet emailResources = - NotificationTemplateManifest.ResourceSet.email( - "notification/templates/email/contract-v1.subject.txt", - "notification/templates/email/contract-v1.text.txt", - "notification/templates/email/contract-v1.html"); - NotificationTemplateManifest.ResourceSet slackResources = - NotificationTemplateManifest.ResourceSet.slack( - "notification/templates/slack/contract-v1.txt"); - NotificationTemplateManifest email = - new NotificationTemplateManifest( - EMAIL_REF, - NotificationChannel.EMAIL, - "email-renderer-r1", - NotificationTemplateCatalog.checksum( - loader, Map.of(Locale.ENGLISH, emailResources, Locale.KOREAN, emailResources)), - Set.of(Locale.ENGLISH, Locale.KOREAN), - Locale.ENGLISH, - Set.of("displayName", "query"), - emailMaximumBytes, - Map.of(Locale.ENGLISH, emailResources, Locale.KOREAN, emailResources)); - NotificationTemplateManifest slack = - new NotificationTemplateManifest( - SLACK_REF, - NotificationChannel.SLACK, - "slack-renderer-r1", - NotificationTemplateCatalog.checksum(loader, Map.of(Locale.ENGLISH, slackResources)), - Set.of(Locale.ENGLISH), - Locale.ENGLISH, - Set.of("displayName", "audience", "mention"), - 2_000, - Map.of(Locale.ENGLISH, slackResources)); - return new NotificationTemplateCatalog(loader, List.of(slack, email)); - } - - private static NotificationFrozenPlan emailPlan( - Locale locale, - Map values, - NotificationTemplateManifest manifest) { - return emailPlan(locale, values, manifest.checksum(), manifest.rendererRevision()); - } - - private static NotificationFrozenPlan emailPlan( - Locale locale, - Map values, - String checksum, - String rendererRevision) { - return plan( - EMAIL_REF, - NotificationChannel.EMAIL, - locale, - new EmailRecipientReference("recipient-ref-42"), - values, - checksum, - rendererRevision); - } - - private static NotificationFrozenPlan slackPlan( - Map values, NotificationTemplateManifest manifest) { - return plan( - SLACK_REF, - NotificationChannel.SLACK, - Locale.ENGLISH, - new SlackAudienceReference("workspace-ref-42", "audience-ref-42"), - values, - manifest.checksum(), - manifest.rendererRevision()); - } - - private static NotificationFrozenPlan plan( - NotificationTemplateRef templateRef, - NotificationChannel channel, - Locale locale, - dev.caskeleton.application.notification.NotificationRecipientReference recipient, - Map values, - String checksum, - String rendererRevision) { - NotificationKindPolicy policy = - new NotificationKindPolicy( - new NotificationKindId("contract-notice"), - channel, - new NotificationRouteId( - channel == NotificationChannel.EMAIL ? "email-route" : "slack-route"), - templateRef, - NotificationMode.DURABLE_ASYNC, - NotificationAdmissionClass.TRANSACTIONAL, - NotificationRouteStrategy.SINGLE, - ConsentCheckMode.SNAPSHOT_AT_APPEND, - 1, - 1, - 1, - 0, - channel == NotificationChannel.EMAIL ? 1 : 0, - channel == NotificationChannel.EMAIL ? 2 : 1, - Duration.ofHours(1)); - Instant now = Instant.parse("2026-07-29T00:00:00Z"); - NotificationIntentDraft draft = - new NotificationIntentDraft( - new NotificationIntentId("intent-42"), - policy, - locale, - recipient, - new NotificationTemplateParameters(values), - "scope-42", - "operation-42", - Optional.empty(), - "correlation-42", - Optional.empty(), - now, - now.plusSeconds(60)); - return NotificationFrozenPlan.from( - draft, - locale, - new NotificationFrozenPlan.BindingSnapshot( - 1, - "a".repeat(64), - checksum, - rendererRevision, - List.of( - new NotificationFrozenPlan.FrozenTarget( - 0, - "target-42", - channel == NotificationChannel.EMAIL - ? "aws-ses-v2-durable-single-local-sns-v1" - : "slack-web-api-durable-single-local-v1", - "binding-r1", - "credential-r1")), - channel == NotificationChannel.EMAIL, - Duration.ofSeconds(5))); - } -} diff --git a/src/adapter/outbound/objectstorage/README.md b/src/adapter/outbound/objectstorage/README.md index b009f7e1..405f192a 100644 --- a/src/adapter/outbound/objectstorage/README.md +++ b/src/adapter/outbound/objectstorage/README.md @@ -10,6 +10,9 @@ The allowed production dependencies are owned by in `docs/superpowers/specs/2026-07-28-objectstorage-production-capability-design.md`, and exact evidence claims in `docs/registries/object-storage-readiness.yaml`. +For when to use this capability rather than the HTTP Fileserver platform, see +[`docs/storage-capability-boundary.md`](../../../docs/storage-capability-boundary.md). + ## Current readiness Batch B implements the provider-neutral namespace/control kernel and diff --git a/src/adapter/outbound/objectstorage/build.gradle b/src/adapter/outbound/objectstorage/build.gradle index f45f2a4b..bdfd79bd 100644 --- a/src/adapter/outbound/objectstorage/build.gradle +++ b/src/adapter/outbound/objectstorage/build.gradle @@ -19,18 +19,11 @@ plugins { description = 'Outbound adapter: object storage (S3/MinIO + local filesystem)' -// The three qualification source sets compile against `main` only. -// -// They used to name `'test'` as well, which is what ADR-BUILD-001's testFixtures migration exists to -// remove: a source set that reaches into another source set's output directory instead of a -// consumable variant. The migration's answer elsewhere in this repository is `java-test-fixtures`, -// and that is deliberately NOT what happened here, because there is nothing to publish — these three -// source sets import no type from `dev.caskeleton` at all (they drive MinIO and S3 through the AWS -// SDK), so the `test` edge was carrying nothing and a `testFixtures` variant would have been an -// empty one. Verified by compiling all three with the edge removed. +// MinIO/Testcontainers exercises are one physical INTEGRATION runtime. Contract/fault are +// qualification meanings over that source set, not separate test kinds. The AWS sandbox keeps its +// own source set because credentials/network authority make it a materially different environment. auxiliarySourceSets { - sourceSet('objectStorageMinioContractTest') { compilesAgainst 'main' } - sourceSet('objectStorageMinioFaultTest') { compilesAgainst 'main' } + sourceSet('integrationTest') { compilesAgainst 'main' } sourceSet('objectStorageAwsQualificationTest') { compilesAgainst 'main' } } @@ -42,6 +35,7 @@ dependencyManagement { dependencies { implementation project(':application-core') + implementation project(':application-objectstorage') implementation project(':shared-contract') implementation 'org.springframework.boot:spring-boot-autoconfigure' @@ -50,12 +44,10 @@ dependencies { implementation 'software.amazon.awssdk:netty-nio-client' - // test-only: Testcontainers MinIO integration test for the S3 backend. Uses the core - // GenericContainer (no dedicated module) so the S3 round-trip runs against a real MinIO when - // Docker is available and is skipped (disabledWithoutDocker) otherwise. - testImplementation 'org.testcontainers:testcontainers' - testImplementation 'org.testcontainers:testcontainers-junit-jupiter' - testImplementation 'org.testcontainers:testcontainers-toxiproxy' + // Real MinIO/Toxiproxy infrastructure belongs only to the integration lane. + integrationTestImplementation 'org.testcontainers:testcontainers' + integrationTestImplementation 'org.testcontainers:testcontainers-junit-jupiter' + integrationTestImplementation 'org.testcontainers:testcontainers-toxiproxy' testImplementation libs.archunit.junit5 testImplementation libs.jqwik } @@ -70,9 +62,8 @@ tasks.named('test') { def objectStorageMinioContractQualification = extensions.getByName('strictQualification').register( 'objectStorageMinioContractTest', - sourceSets.objectStorageMinioContractTest, + sourceSets.integrationTest, [ - 'dev.caskeleton.adapter.outbound.objectstorage.qualification.MinioDirectTransferContractTest', 'dev.caskeleton.adapter.outbound.objectstorage.qualification.MinioManagedObjectContractTest' ], 'Runs the non-skipping exact-release MinIO managed object contract.' @@ -83,9 +74,8 @@ objectStorageMinioContractQualification.configure { def objectStorageMinioFaultQualification = extensions.getByName('strictQualification').register( 'objectStorageMinioFaultTest', - sourceSets.objectStorageMinioFaultTest, + sourceSets.integrationTest, [ - 'dev.caskeleton.adapter.outbound.objectstorage.qualification.MinioDirectTransferFaultTest', 'dev.caskeleton.adapter.outbound.objectstorage.qualification.MinioManagedObjectFaultTest' ], 'Runs the non-skipping digest-pinned MinIO/Toxiproxy fault contract.' @@ -94,6 +84,11 @@ objectStorageMinioFaultQualification.configure { shouldRunAfter objectStorageMinioContractQualification } +tasks.named('check') { + dependsOn objectStorageMinioContractQualification + dependsOn objectStorageMinioFaultQualification +} + extensions.getByName('strictQualification').register( 'objectStorageAwsQualificationTest', sourceSets.objectStorageAwsQualificationTest, diff --git a/src/adapter/outbound/objectstorage/gradle.lockfile b/src/adapter/outbound/objectstorage/gradle.lockfile index 493644f4..1a4b6cc5 100644 --- a/src/adapter/outbound/objectstorage/gradle.lockfile +++ b/src/adapter/outbound/objectstorage/gradle.lockfile @@ -1,217 +1,218 @@ # This is a Gradle generated file for dependency locking. # Manual edits can break the build and are not advised. # This file is expected to be part of source control. -biz.aQute.bnd:biz.aQute.bnd.annotation:7.1.0=objectStorageAwsQualificationTestCompileClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioFaultTestCompileClasspath,testCompileClasspath -ch.qos.logback:logback-classic:1.5.38=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -ch.qos.logback:logback-core:1.5.38=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.fasterxml.jackson.core:jackson-annotations:2.21=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor -com.github.docker-java:docker-java-api:3.7.1=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.github.docker-java:docker-java-transport-zerodep:3.7.1=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.github.docker-java:docker-java-transport:3.7.1=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor +biz.aQute.bnd:biz.aQute.bnd.annotation:7.1.0=integrationTestCompileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioFaultTestCompileClasspath,testCompileClasspath +ch.qos.logback:logback-classic:1.5.38=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +ch.qos.logback:logback-core:1.5.38=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +com.fasterxml.jackson.core:jackson-annotations:2.21=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,integrationTestAnnotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor +com.github.docker-java:docker-java-api:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath +com.github.docker-java:docker-java-transport-zerodep:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath +com.github.docker-java:docker-java-transport:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath +com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,integrationTestAnnotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor com.github.spotbugs:spotbugs-annotations:4.10.2=spotbugs com.github.spotbugs:spotbugs:4.10.2=spotbugs com.github.stephenc.jcip:jcip-annotations:1.0-1=spotbugs -com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor -com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor -com.google.auto:auto-common:1.2.2=annotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor +com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,integrationTestAnnotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor +com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,integrationTestAnnotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor +com.google.auto:auto-common:1.2.2=annotationProcessor,integrationTestAnnotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor com.google.code.findbugs:jsr305:3.0.2=checkstyle,spotbugs -com.google.code.gson:gson:2.13.2=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,spotbugs,testCompileClasspath,testRuntimeClasspath -com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_annotations:2.41.0=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,spotbugs,testCompileClasspath,testRuntimeClasspath +com.google.code.gson:gson:2.13.2=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,spotbugs +com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.38.0=objectStorageAwsQualificationTestCompileClasspath,testCompileClasspath +com.google.errorprone:error_prone_annotations:2.41.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,spotbugs com.google.errorprone:error_prone_annotations:2.47.0=checkstyle -com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor -com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor -com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor -com.google.guava:guava:33.5.0-jre=annotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor +com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,integrationTestAnnotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor +com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor +com.google.guava:guava:33.5.0-jre=annotationProcessor,integrationTestAnnotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor com.google.guava:guava:33.6.0-jre=checkstyle -com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor -com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor -com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor +com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor +com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor +com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,integrationTestAnnotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins -com.jayway.jsonpath:json-path:2.10.0=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +com.jayway.jsonpath:json-path:2.10.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath com.puppycrawl.tools:checkstyle:13.5.0=checkstyle -com.tngtech.archunit:archunit-junit5-api:1.3.0=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.tngtech.archunit:archunit-junit5-engine-api:1.3.0=objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestRuntimeClasspath,testRuntimeClasspath -com.tngtech.archunit:archunit-junit5-engine:1.3.0=objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestRuntimeClasspath,testRuntimeClasspath -com.tngtech.archunit:archunit-junit5:1.3.0=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.tngtech.archunit:archunit:1.3.0=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.vaadin.external.google:android-json:0.0.20131108.vaadin1=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +com.tngtech.archunit:archunit-junit5-api:1.3.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +com.tngtech.archunit:archunit-junit5-engine-api:1.3.0=integrationTestRuntimeClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestRuntimeClasspath,testRuntimeClasspath +com.tngtech.archunit:archunit-junit5-engine:1.3.0=integrationTestRuntimeClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestRuntimeClasspath,testRuntimeClasspath +com.tngtech.archunit:archunit-junit5:1.3.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +com.tngtech.archunit:archunit:1.3.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +com.vaadin.external.google:android-json:0.0.20131108.vaadin1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath commons-beanutils:commons-beanutils:1.11.0=checkstyle -commons-codec:commons-codec:1.19.0=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +commons-codec:commons-codec:1.19.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testRuntimeClasspath commons-collections:commons-collections:3.2.2=checkstyle -commons-io:commons-io:2.20.0=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +commons-io:commons-io:2.20.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath commons-io:commons-io:2.21.0=spotbugs -commons-logging:commons-logging:1.3.6=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -eu.rekawek.toxiproxy:toxiproxy-java:2.1.11=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +commons-logging:commons-logging:1.3.6=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +eu.rekawek.toxiproxy:toxiproxy-java:2.1.11=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath info.picocli:picocli:4.7.7=checkstyle -io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor -io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor -io.micrometer:micrometer-commons:1.16.7=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.micrometer:micrometer-observation:1.16.7=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-buffer:4.2.17.Final=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-codec-base:4.2.17.Final=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-codec-compression:4.2.17.Final=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-codec-http2:4.2.17.Final=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-codec-http:4.2.17.Final=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-codec-marshalling:4.2.17.Final=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-codec-protobuf:4.2.17.Final=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-codec:4.2.17.Final=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-common:4.2.17.Final=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-handler:4.2.17.Final=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-resolver:4.2.17.Final=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-transport-classes-epoll:4.2.17.Final=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-transport-native-unix-common:4.2.17.Final=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-transport:4.2.17.Final=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -jakarta.activation:jakarta.activation-api:2.1.4=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -jakarta.annotation:jakarta.annotation-api:3.0.0=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -jakarta.xml.bind:jakarta.xml.bind-api:4.0.5=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -javax.inject:javax.inject:1=annotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor +io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,integrationTestAnnotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor +io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,integrationTestAnnotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor +io.micrometer:micrometer-commons:1.16.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.micrometer:micrometer-observation:1.16.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-buffer:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-base:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-compression:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-http2:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-http:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-marshalling:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-protobuf:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-common:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-handler:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-resolver:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-transport-classes-epoll:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-transport-native-unix-common:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-transport:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +jakarta.activation:jakarta.activation-api:2.1.4=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +jakarta.annotation:jakarta.annotation-api:3.0.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +jakarta.xml.bind:jakarta.xml.bind-api:4.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +javax.inject:javax.inject:1=annotationProcessor,integrationTestAnnotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor jaxen:jaxen:2.0.6=spotbugs -net.bytebuddy:byte-buddy-agent:1.17.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.bytebuddy:byte-buddy:1.17.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.java.dev.jna:jna:5.18.1=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.jqwik:jqwik-api:1.9.1=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.jqwik:jqwik-engine:1.9.1=objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestRuntimeClasspath,testRuntimeClasspath -net.jqwik:jqwik-time:1.9.1=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.jqwik:jqwik-web:1.9.1=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.jqwik:jqwik:1.9.1=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.minidev:accessors-smart:2.6.0=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.minidev:json-smart:2.6.0=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +net.bytebuddy:byte-buddy-agent:1.17.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +net.bytebuddy:byte-buddy:1.17.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +net.java.dev.jna:jna:5.18.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath +net.jqwik:jqwik-api:1.9.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +net.jqwik:jqwik-engine:1.9.1=integrationTestRuntimeClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestRuntimeClasspath,testRuntimeClasspath +net.jqwik:jqwik-time:1.9.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +net.jqwik:jqwik-web:1.9.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +net.jqwik:jqwik:1.9.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +net.minidev:accessors-smart:2.6.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +net.minidev:json-smart:2.6.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs org.antlr:antlr4-runtime:4.13.2=checkstyle org.apache.bcel:bcel:6.12.0=spotbugs -org.apache.commons:commons-compress:1.28.0=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.apache.commons:commons-lang3:3.20.0=checkstyle,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,spotbugs,testCompileClasspath,testRuntimeClasspath +org.apache.commons:commons-compress:1.28.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath +org.apache.commons:commons-lang3:3.20.0=checkstyle,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,spotbugs org.apache.commons:commons-text:1.15.0=spotbugs org.apache.commons:commons-text:1.3=checkstyle -org.apache.httpcomponents:httpclient:4.5.13=checkstyle,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.apache.httpcomponents:httpcore:4.4.16=checkstyle,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.apache.logging.log4j:log4j-api:2.25.5=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,spotbugs,testCompileClasspath,testRuntimeClasspath +org.apache.httpcomponents:httpclient:4.5.13=checkstyle,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testRuntimeClasspath +org.apache.httpcomponents:httpcore:4.4.16=checkstyle,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testRuntimeClasspath +org.apache.logging.log4j:log4j-api:2.25.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,spotbugs,testCompileClasspath,testRuntimeClasspath org.apache.logging.log4j:log4j-core:2.25.5=spotbugs -org.apache.logging.log4j:log4j-to-slf4j:2.25.5=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.apache.logging.log4j:log4j-to-slf4j:2.25.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.apache.maven.doxia:doxia-core:1.12.0=checkstyle org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle -org.apache.tomcat.embed:tomcat-embed-core:11.0.24=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.apache.tomcat.embed:tomcat-embed-el:11.0.24=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.apache.tomcat.embed:tomcat-embed-websocket:11.0.24=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.apache.tomcat.embed:tomcat-embed-core:11.0.24=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.apache.tomcat.embed:tomcat-embed-el:11.0.24=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.apache.tomcat.embed:tomcat-embed-websocket:11.0.24=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.apache.xbean:xbean-reflect:3.7=checkstyle -org.apiguardian:apiguardian-api:1.1.2=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.assertj:assertj-core:3.27.7=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.awaitility:awaitility:4.3.0=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.apiguardian:apiguardian-api:1.1.2=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.assertj:assertj-core:3.27.7=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.awaitility:awaitility:4.3.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle org.codehaus.plexus:plexus-component-annotations:2.1.0=checkstyle org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle org.codehaus.plexus:plexus-utils:3.3.0=checkstyle org.dom4j:dom4j:2.2.0=spotbugs -org.hamcrest:hamcrest:3.0=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.hamcrest:hamcrest:3.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.javassist:javassist:3.28.0-GA=checkstyle -org.jetbrains:annotations:17.0.0=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestAnnotationProcessor,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-api:6.0.3=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-engine:6.0.3=objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestRuntimeClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-params:6.0.3=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter:6.0.3=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-commons:6.0.3=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-engine:6.0.3=objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestRuntimeClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-launcher:6.0.3=objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestRuntimeClasspath,testRuntimeClasspath -org.junit:junit-bom:6.0.3=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.jetbrains:annotations:17.0.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath +org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,integrationTestAnnotationProcessor,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestAnnotationProcessor,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-api:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-engine:6.0.3=integrationTestRuntimeClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestRuntimeClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-params:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-commons:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-engine:6.0.3=integrationTestRuntimeClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestRuntimeClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-launcher:6.0.3=integrationTestRuntimeClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestRuntimeClasspath,testRuntimeClasspath +org.junit:junit-bom:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.junit:junit-bom:6.1.0=spotbugs -org.mockito:mockito-core:5.20.0=mockitoAgent,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.mockito:mockito-junit-jupiter:5.20.0=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.objenesis:objenesis:3.3=objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestRuntimeClasspath,testRuntimeClasspath -org.opentest4j:opentest4j:1.3.0=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.osgi:org.osgi.annotation.bundle:2.0.0=objectStorageAwsQualificationTestCompileClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioFaultTestCompileClasspath,testCompileClasspath -org.osgi:org.osgi.annotation.versioning:1.1.2=objectStorageAwsQualificationTestCompileClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioFaultTestCompileClasspath,testCompileClasspath -org.osgi:org.osgi.resource:1.0.0=objectStorageAwsQualificationTestCompileClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioFaultTestCompileClasspath,testCompileClasspath -org.osgi:org.osgi.service.serviceloader:1.0.0=objectStorageAwsQualificationTestCompileClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioFaultTestCompileClasspath,testCompileClasspath +org.mockito:mockito-core:5.20.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,mockitoAgent,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.mockito:mockito-junit-jupiter:5.20.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.objenesis:objenesis:3.3=integrationTestRuntimeClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestRuntimeClasspath,testRuntimeClasspath +org.opentest4j:opentest4j:1.3.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.osgi:org.osgi.annotation.bundle:2.0.0=integrationTestCompileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioFaultTestCompileClasspath,testCompileClasspath +org.osgi:org.osgi.annotation.versioning:1.1.2=integrationTestCompileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioFaultTestCompileClasspath,testCompileClasspath +org.osgi:org.osgi.resource:1.0.0=integrationTestCompileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioFaultTestCompileClasspath,testCompileClasspath +org.osgi:org.osgi.service.serviceloader:1.0.0=integrationTestCompileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioFaultTestCompileClasspath,testCompileClasspath org.ow2.asm:asm-analysis:9.10.1=spotbugs org.ow2.asm:asm-commons:9.10.1=spotbugs org.ow2.asm:asm-tree:9.10.1=spotbugs org.ow2.asm:asm-util:9.10.1=spotbugs org.ow2.asm:asm:9.10.1=spotbugs -org.ow2.asm:asm:9.7.1=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.pcollections:pcollections:4.0.1=annotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor -org.reactivestreams:reactive-streams:1.0.4=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.ow2.asm:asm:9.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.pcollections:pcollections:4.0.1=annotationProcessor,integrationTestAnnotationProcessor,objectStorageAwsQualificationTestAnnotationProcessor,objectStorageMinioContractTestAnnotationProcessor,objectStorageMinioFaultTestAnnotationProcessor,testAnnotationProcessor +org.reactivestreams:reactive-streams:1.0.4=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.reflections:reflections:0.10.2=checkstyle -org.rnorth.duct-tape:duct-tape:1.0.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.skyscreamer:jsonassert:1.5.3=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.slf4j:jul-to-slf4j:2.0.18=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.slf4j:slf4j-api:2.0.18=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testRuntimeClasspath +org.rnorth.duct-tape:duct-tape:1.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath +org.skyscreamer:jsonassert:1.5.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.slf4j:jul-to-slf4j:2.0.18=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.slf4j:slf4j-api:2.0.18=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testRuntimeClasspath org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j org.slf4j:slf4j-simple:2.0.18=checkstyle -org.springframework.boot:spring-boot-autoconfigure:4.0.8=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-autoconfigure:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-configuration-processor:4.0.8=annotationProcessor -org.springframework.boot:spring-boot-http-converter:4.0.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-jackson:4.0.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-resttestclient:4.0.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-servlet:4.0.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-jackson-test:4.0.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-jackson:4.0.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-logging:4.0.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-test:4.0.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-tomcat-runtime:4.0.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-tomcat:4.0.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-webmvc-test:4.0.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-webmvc:4.0.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter:4.0.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-test-autoconfigure:4.0.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-test:4.0.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-tomcat:4.0.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-web-server:4.0.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-webmvc-test:4.0.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-webmvc:4.0.8=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot:4.0.8=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-aop:7.0.9=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-beans:7.0.9=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-context:7.0.9=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-core:7.0.9=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-expression:7.0.9=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-test:7.0.9=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-web:7.0.9=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-webmvc:7.0.9=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers-junit-jupiter:2.0.5=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers-toxiproxy:2.0.5=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers:2.0.5=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-http-converter:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-jackson:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-resttestclient:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-servlet:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-jackson-test:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-jackson:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-logging:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-test:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-tomcat-runtime:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-tomcat:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-webmvc-test:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-webmvc:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-test-autoconfigure:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-test:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-tomcat:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-web-server:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-webmvc-test:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-webmvc:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-aop:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-beans:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-context:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-core:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-expression:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-test:7.0.9=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-web:7.0.9=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-webmvc:7.0.9=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.testcontainers:testcontainers-junit-jupiter:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath +org.testcontainers:testcontainers-toxiproxy:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath +org.testcontainers:testcontainers:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs -org.xmlunit:xmlunit-core:2.10.4=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.yaml:snakeyaml:2.5=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:annotations:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:apache-client:2.30.0=objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:arns:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:auth:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:aws-core:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:aws-query-protocol:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:aws-xml-protocol:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:checksums-spi:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:checksums:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:crt-core:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:endpoints-spi:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:http-auth-aws-eventstream:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:http-auth-aws:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:http-auth-spi:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:http-auth:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:http-client-spi:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:identity-spi:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:json-utils:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:metrics-spi:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:netty-nio-client:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:profiles:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:protocol-core:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:regions:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:retries-spi:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:retries:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:s3:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:sdk-core:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:third-party-jackson-core:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:utils:2.30.0=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.eventstream:eventstream:1.0.1=compileClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -tools.jackson.core:jackson-core:3.1.5=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -tools.jackson.core:jackson-databind:3.1.5=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -tools.jackson:jackson-bom:3.1.5=objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.xmlunit:xmlunit-core:2.10.4=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.yaml:snakeyaml:2.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:annotations:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:apache-client:2.30.0=integrationTestRuntimeClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testRuntimeClasspath +software.amazon.awssdk:arns:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:auth:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:aws-core:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:aws-query-protocol:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:aws-xml-protocol:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:checksums-spi:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:checksums:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:crt-core:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:endpoints-spi:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:http-auth-aws-eventstream:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:http-auth-aws:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:http-auth-spi:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:http-auth:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:http-client-spi:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:identity-spi:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:json-utils:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:metrics-spi:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:netty-nio-client:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:profiles:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:protocol-core:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:regions:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:retries-spi:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:retries:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:s3:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:sdk-core:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:third-party-jackson-core:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:utils:2.30.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.eventstream:eventstream:1.0.1=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +tools.jackson.core:jackson-core:3.1.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +tools.jackson.core:jackson-databind:3.1.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +tools.jackson:jackson-bom:3.1.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,objectStorageAwsQualificationTestCompileClasspath,objectStorageAwsQualificationTestRuntimeClasspath,objectStorageMinioContractTestCompileClasspath,objectStorageMinioContractTestRuntimeClasspath,objectStorageMinioFaultTestCompileClasspath,objectStorageMinioFaultTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath empty= diff --git a/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/S3ObjectStorageAdapterIT.java b/src/adapter/outbound/objectstorage/src/integrationTest/java/dev/caskeleton/adapter/outbound/objectstorage/S3ObjectStorageAdapterIT.java similarity index 100% rename from src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/S3ObjectStorageAdapterIT.java rename to src/adapter/outbound/objectstorage/src/integrationTest/java/dev/caskeleton/adapter/outbound/objectstorage/S3ObjectStorageAdapterIT.java diff --git a/src/adapter/outbound/objectstorage/src/objectStorageMinioContractTest/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/MinioManagedObjectContractTest.java b/src/adapter/outbound/objectstorage/src/integrationTest/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/MinioManagedObjectContractTest.java similarity index 100% rename from src/adapter/outbound/objectstorage/src/objectStorageMinioContractTest/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/MinioManagedObjectContractTest.java rename to src/adapter/outbound/objectstorage/src/integrationTest/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/MinioManagedObjectContractTest.java diff --git a/src/adapter/outbound/objectstorage/src/objectStorageMinioFaultTest/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/MinioManagedObjectFaultTest.java b/src/adapter/outbound/objectstorage/src/integrationTest/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/MinioManagedObjectFaultTest.java similarity index 100% rename from src/adapter/outbound/objectstorage/src/objectStorageMinioFaultTest/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/MinioManagedObjectFaultTest.java rename to src/adapter/outbound/objectstorage/src/integrationTest/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/MinioManagedObjectFaultTest.java diff --git a/src/adapter/outbound/objectstorage/src/integrationTest/resources/object-storage/minio-provider-evidence.json b/src/adapter/outbound/objectstorage/src/integrationTest/resources/object-storage/minio-provider-evidence.json new file mode 100644 index 00000000..f4e41f21 --- /dev/null +++ b/src/adapter/outbound/objectstorage/src/integrationTest/resources/object-storage/minio-provider-evidence.json @@ -0,0 +1,25 @@ +{ + "schema": 1, + "providerType": "s3-compatible-minio-community-release-2024-01-16t16-07-38z", + "providerVersion": "release-2024-01-16t16-07-38z-sdk-2.30.0", + "image": "minio/minio@sha256:4c4a4876193f030c81f57aabb22bcb9a73462010eb61fcab66908e03e5484af8", + "toxiproxyImage": "ghcr.io/shopify/toxiproxy@sha256:9378ed52a28bc50edc1350f936f518f31fa95f0d15917d6eb40b8e376d1a214e", + "profile": "managed-common", + "status": "UNSUPPORTED", + "excludedProfiles": [ + "managed-single-create-only", + "conditional-control-create", + "managed-multipart-create-only", + "direct-single-create-only", + "direct-multipart-create-only" + ], + "limitations": [ + "PutObject If-None-Match was accepted and overwrote an existing object", + "stale PutObject If-Match returned HTTP 412 but create-if-absent control CAS is not safe", + "CompleteMultipartUpload accepted If-None-Match despite a pre-existing target and overwrote it", + "managed immutable create, conditional control creation, and multipart create-only are disabled", + "local single-node container evidence only", + "not AWS evidence", + "not production TLS or deployment-topology evidence" + ] +} diff --git a/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageBindingCompiler.java b/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageBindingCompiler.java index 07516605..cc2afe46 100644 --- a/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageBindingCompiler.java +++ b/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageBindingCompiler.java @@ -6,6 +6,7 @@ import dev.caskeleton.adapter.outbound.objectstorage.kernel.ObjectPolicySnapshot import dev.caskeleton.adapter.outbound.objectstorage.kernel.ObjectRouteToken; import dev.caskeleton.adapter.outbound.objectstorage.provider.ObjectStorageProvider; import dev.caskeleton.adapter.outbound.objectstorage.provider.ObjectStorageProviderDescriptor; +import dev.caskeleton.adapter.outbound.objectstorage.readiness.ObjectStorageDeploymentReadiness; import dev.caskeleton.application.objectstorage.identity.ObjectDestinationId; import dev.caskeleton.application.objectstorage.model.ObjectCapabilityRequirement; import dev.caskeleton.application.objectstorage.model.ObjectPublicationRequirement; @@ -26,12 +27,18 @@ public final class ObjectStorageBindingCompiler { private final Set activeProfiles; private final boolean scanSeamAvailable; private final Clock clock; + private final Set deployableProviderTypes; public ObjectStorageBindingCompiler( List contributions, Set activeProfiles, boolean scanSeamAvailable) { - this(contributions, activeProfiles, scanSeamAvailable, Clock.systemUTC()); + this( + contributions, + activeProfiles, + scanSeamAvailable, + Clock.systemUTC(), + ObjectStorageDeploymentReadiness.providerTypes()); } public ObjectStorageBindingCompiler( @@ -39,6 +46,27 @@ public final class ObjectStorageBindingCompiler { Set activeProfiles, boolean scanSeamAvailable, Clock clock) { + this( + contributions, + activeProfiles, + scanSeamAvailable, + clock, + ObjectStorageDeploymentReadiness.providerTypes()); + } + + /** + * Explicit readiness vocabulary seam used by provider-model tests. + * + *

Production composition uses the constructors above and therefore the tracked deployment + * readiness set. A model test may widen the set to exercise an unqualified provider without + * turning that provider into a deployable runtime option. + */ + public ObjectStorageBindingCompiler( + List contributions, + Set activeProfiles, + boolean scanSeamAvailable, + Clock clock, + Set deployableProviderTypes) { Objects.requireNonNull(contributions, "contributions must be non-null"); Map indexed = new LinkedHashMap<>(); for (ObjectStorageProviderContribution contribution : contributions) { @@ -53,6 +81,10 @@ public final class ObjectStorageBindingCompiler { this.activeProfiles = Set.copyOf(activeProfiles); this.scanSeamAvailable = scanSeamAvailable; this.clock = Objects.requireNonNull(clock, "clock must be non-null"); + this.deployableProviderTypes = + Set.copyOf( + Objects.requireNonNull( + deployableProviderTypes, "deployable provider types must be non-null")); } public CompiledBindings compile(ObjectStorageCapabilitySettings settings) { @@ -85,6 +117,10 @@ public final class ObjectStorageBindingCompiler { ObjectStorageProviderSettings source = Objects.requireNonNull(entry.getValue(), "provider settings must be non-null"); String providerType = canonicalId("provider type", source.type()); + if (!deployableProviderTypes.contains(providerType)) { + throw new IllegalArgumentException( + "object-storage provider type has no deployable readiness evidence: " + providerType); + } String version = bounded("provider version", source.version(), 128); ObjectStorageProviderContribution contribution = contributions.get(providerType); if (contribution == null diff --git a/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageScanMaintenanceConfig.java b/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageScanMaintenanceConfig.java index 41a53fae..2055619b 100644 --- a/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageScanMaintenanceConfig.java +++ b/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageScanMaintenanceConfig.java @@ -6,6 +6,7 @@ import org.springframework.context.annotation.Configuration; /** Explicit scanner-workflow composition; absent from the normal application context. */ @Configuration(proxyBeanMethods = false) +@ConditionalOnProperty(prefix = "app.object-storage", name = "enabled", havingValue = "true") public class ObjectStorageScanMaintenanceConfig { @Bean diff --git a/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/direct/DirectGrantReplayCache.java b/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/direct/DirectGrantReplayCache.java new file mode 100644 index 00000000..a865d7dd --- /dev/null +++ b/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/direct/DirectGrantReplayCache.java @@ -0,0 +1,65 @@ +package dev.caskeleton.adapter.outbound.objectstorage.direct; + +import java.time.Clock; +import java.time.Instant; +import java.util.Iterator; +import java.util.LinkedHashMap; +import java.util.Map; +import java.util.Objects; +import java.util.Optional; + +/** Bounded process-local cache for replaying still-live upload bearer material. */ +final class DirectGrantReplayCache { + + private final int maximumEntries; + private final Clock clock; + private final LinkedHashMap entries = new LinkedHashMap<>(16, 0.75f, true); + + DirectGrantReplayCache(int maximumEntries, Clock clock) { + if (maximumEntries < 1) { + throw new IllegalArgumentException("direct grant replay cache bound must be positive"); + } + this.maximumEntries = maximumEntries; + this.clock = Objects.requireNonNull(clock, "clock must be non-null"); + } + + synchronized Optional get(String sessionId) { + Instant now = clock.instant(); + removeExpired(now); + Entry entry = entries.get(sessionId); + return entry == null ? Optional.empty() : Optional.of(entry.material()); + } + + synchronized void put( + String sessionId, DirectGrantProvider.DirectGrantMaterial material, Instant expiresAt) { + Objects.requireNonNull(sessionId, "session id must be non-null"); + Objects.requireNonNull(material, "grant material must be non-null"); + Objects.requireNonNull(expiresAt, "expiry must be non-null"); + Instant now = clock.instant(); + removeExpired(now); + if (!expiresAt.isAfter(now)) { + return; + } + entries.put(sessionId, new Entry(material, expiresAt)); + while (entries.size() > maximumEntries) { + Iterator> iterator = entries.entrySet().iterator(); + iterator.next(); + iterator.remove(); + } + } + + synchronized void remove(String sessionId) { + entries.remove(sessionId); + } + + synchronized int size() { + removeExpired(clock.instant()); + return entries.size(); + } + + private void removeExpired(Instant now) { + entries.entrySet().removeIf(entry -> !entry.getValue().expiresAt().isAfter(now)); + } + + private record Entry(DirectGrantProvider.DirectGrantMaterial material, Instant expiresAt) {} +} diff --git a/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/direct/DirectTransferCoordinator.java b/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/direct/DirectTransferCoordinator.java index 768779d2..702b2599 100644 --- a/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/direct/DirectTransferCoordinator.java +++ b/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/direct/DirectTransferCoordinator.java @@ -27,9 +27,7 @@ import java.security.NoSuchAlgorithmException; import java.time.Clock; import java.time.Instant; import java.util.Arrays; -import java.util.Map; import java.util.Objects; -import java.util.concurrent.ConcurrentHashMap; /** * Direct grant state machine. It persists only non-secret generation evidence and retains bearer @@ -42,9 +40,10 @@ public final class DirectTransferCoordinator private final ObjectControlStore store; private final DirectTransferPolicy policy; private final DirectGrantProvider provider; + static final int DEFAULT_REPLAY_CACHE_ENTRIES = 1024; + private final Clock clock; - private final Map issued = - new ConcurrentHashMap<>(); + private final DirectGrantReplayCache issued; public DirectTransferCoordinator( ObjectRouteToken route, @@ -57,6 +56,7 @@ public final class DirectTransferCoordinator this.policy = Objects.requireNonNull(policy, "policy must be non-null"); this.provider = Objects.requireNonNull(provider, "provider must be non-null"); this.clock = Objects.requireNonNull(clock, "clock must be non-null"); + this.issued = new DirectGrantReplayCache(DEFAULT_REPLAY_CACHE_ENTRIES, clock); } @Override @@ -81,7 +81,8 @@ public final class DirectTransferCoordinator current = replace(key, current, prepared); } if (current.session().state() == DirectGrantSessionState.GRANT_ISSUED) { - DirectGrantProvider.DirectGrantMaterial cached = issued.get(sessionId.canonicalText()); + DirectGrantProvider.DirectGrantMaterial cached = + issued.get(sessionId.canonicalText()).orElse(null); if (cached == null) { throw new IllegalStateException( "issued direct grant bearer material is unavailable after process restart"); @@ -95,7 +96,8 @@ public final class DirectTransferCoordinator policy.validateSignedGrant(material.requestUri(), current.session().expiresAt()); ObjectDirectSessionRecord issuedRecord = replace(key, current, current.session().issue(clock.instant())); - issued.put(sessionId.canonicalText(), material); + issued.put( + sessionId.canonicalText(), material, issuedRecord.session().expiresAt()); return uploadGrant(issuedRecord.session(), material); } @@ -185,7 +187,6 @@ public final class DirectTransferCoordinator } ObjectDirectSessionRecord issuedRecord = replace(key, stored, prepared.replace(prepared.session().issue(clock.instant()))); - issued.put(sessionId.canonicalText(), material); return new DirectDownloadGrant( sessionId, material.requestUri(), diff --git a/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/filesystem/LocalDevObjectControlStore.java b/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/filesystem/LocalDevObjectControlStore.java index 91cae220..4c293490 100644 --- a/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/filesystem/LocalDevObjectControlStore.java +++ b/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/filesystem/LocalDevObjectControlStore.java @@ -14,7 +14,6 @@ import java.nio.file.Path; import java.nio.file.StandardCopyOption; import java.nio.file.StandardOpenOption; import java.util.Optional; -import java.util.concurrent.ConcurrentHashMap; /** * Single-process local create/CAS store; it deliberately does not claim multi-node linearizability. @@ -23,7 +22,8 @@ public final class LocalDevObjectControlStore implements ObjectControlStore { private final LocalObjectPathGuard pathGuard; private final CanonicalJsonObjectControlRecordCodec codec; - private final ConcurrentHashMap locks = new ConcurrentHashMap<>(); + private static final int LOCK_STRIPES = 256; + private final Object[] locks = lockStripes(); public LocalDevObjectControlStore( LocalObjectPathGuard pathGuard, CanonicalJsonObjectControlRecordCodec codec) { @@ -66,7 +66,7 @@ public final class LocalDevObjectControlStore implements ObjectControlStore { @Override public StoredControlRecord compareAndSet(String key, ObjectControlMutation mutation) { - Object lock = locks.computeIfAbsent(key, ignored -> new Object()); + Object lock = locks[Math.floorMod(key.hashCode(), locks.length)]; synchronized (lock) { StoredControlRecord current = read(key) @@ -104,6 +104,12 @@ public final class LocalDevObjectControlStore implements ObjectControlStore { } } + private static Object[] lockStripes() { + Object[] stripes = new Object[LOCK_STRIPES]; + java.util.Arrays.setAll(stripes, ignored -> new Object()); + return stripes; + } + private static void writeFully(FileChannel channel, byte[] bytes) throws IOException { java.nio.ByteBuffer buffer = java.nio.ByteBuffer.wrap(bytes); while (buffer.hasRemaining()) { diff --git a/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/readiness/ObjectStorageDeploymentReadiness.java b/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/readiness/ObjectStorageDeploymentReadiness.java new file mode 100644 index 00000000..b35f4d8d --- /dev/null +++ b/src/adapter/outbound/objectstorage/src/main/java/dev/caskeleton/adapter/outbound/objectstorage/readiness/ObjectStorageDeploymentReadiness.java @@ -0,0 +1,26 @@ +package dev.caskeleton.adapter.outbound.objectstorage.readiness; + +import java.util.Set; + +/** + * Provider types that current tracked readiness evidence permits a runtime composition to deploy. + * + *

This is intentionally narrower than the set of provider implementations present in the leaf. A + * provider can exist as modelled/tested code without being qualified for deployment. Promotion + * requires updating the canonical readiness registry and this runtime set in the same change; the + * registry contract test uses this set as its provider vocabulary so the two cannot drift silently. + */ +public final class ObjectStorageDeploymentReadiness { + + private static final Set DEPLOYABLE_PROVIDER_TYPES = Set.of("filesystem-local-dev"); + + private ObjectStorageDeploymentReadiness() {} + + public static Set providerTypes() { + return DEPLOYABLE_PROVIDER_TYPES; + } + + public static boolean permits(String providerType) { + return DEPLOYABLE_PROVIDER_TYPES.contains(providerType); + } +} diff --git a/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageCapabilityConfigTest.java b/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageCapabilityConfigTest.java index 11f1d10f..8cc7d090 100644 --- a/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageCapabilityConfigTest.java +++ b/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageCapabilityConfigTest.java @@ -98,16 +98,13 @@ class ObjectStorageCapabilityConfigTest { AtomicInteger constructed = new AtomicInteger(); AtomicInteger closed = new AtomicInteger(); CountingContribution contribution = new CountingContribution(constructed, closed, false); + ObjectStorageCapabilityAssembler assembler = + testAssembler(java.util.List.of(contribution), java.util.Set.of("counting")); - new ApplicationContextRunner() - .withUserConfiguration(ObjectStorageCapabilityConfig.class) - .withBean(ObjectStorageProviderContribution.class, () -> contribution) - .withPropertyValues(countingProviderProperties(root.resolve("counting"), true)) - .run( - context -> { - assertThat(context).hasNotFailed(); - assertThat(constructed).hasValue(1); - }); + try (ObjectStorageCapabilityAssembler.AssembledCapability ignored = + assembler.assemble(countingSettings(root.resolve("counting")))) { + assertThat(constructed).hasValue(1); + } assertThat(closed).hasValue(1); } @@ -117,19 +114,20 @@ class ObjectStorageCapabilityConfigTest { AtomicInteger constructed = new AtomicInteger(); AtomicInteger closed = new AtomicInteger(); CountingContribution contribution = new CountingContribution(constructed, closed, false); + var local = + new dev.caskeleton.adapter.outbound.objectstorage.filesystem + .FilesystemLocalDevProviderContribution(); + ObjectStorageCapabilityAssembler assembler = + testAssembler( + java.util.List.of(local, contribution), + java.util.Set.of("filesystem-local-dev", "counting")); - new ApplicationContextRunner() - .withUserConfiguration(ObjectStorageCapabilityConfig.class) - .withBean(ObjectStorageProviderContribution.class, () -> contribution) - .withPropertyValues( - combined( - providerProperties(root.resolve("selected-local"), true), - countingProviderDefinition(root.resolve("unselected-counting")))) - .run( - context -> { - assertThat(context).hasNotFailed(); - assertThat(constructed).hasValue(0); - }); + try (ObjectStorageCapabilityAssembler.AssembledCapability ignored = + assembler.assemble( + localSelectedWithUnselectedCounting( + root.resolve("selected-local"), root.resolve("unselected-counting")))) { + assertThat(constructed).hasValue(0); + } assertThat(closed).hasValue(0); assertThat(root.resolve("unselected-counting")).doesNotExist(); @@ -185,17 +183,15 @@ class ObjectStorageCapabilityConfigTest { AtomicInteger constructed = new AtomicInteger(); AtomicInteger closed = new AtomicInteger(); CountingContribution contribution = new CountingContribution(constructed, closed, true); + ObjectStorageCapabilityAssembler assembler = + testAssembler(java.util.List.of(contribution), java.util.Set.of("counting")); - new ApplicationContextRunner() - .withUserConfiguration(ObjectStorageCapabilityConfig.class) - .withBean(ObjectStorageProviderContribution.class, () -> contribution) - .withPropertyValues(countingProviderProperties(root.resolve("failing"), true)) - .run( - context -> { - assertThat(context).hasFailed(); - assertThat(constructed).hasValue(1); - }); - + assertThat( + org.assertj.core.api.Assertions.catchThrowable( + () -> assembler.assemble(countingSettings(root.resolve("failing"))))) + .isInstanceOf(IllegalStateException.class) + .hasMessage("selected construction failed"); + assertThat(constructed).hasValue(1); assertThat(closed).hasValue(1); } @@ -275,6 +271,71 @@ class ObjectStorageCapabilityConfigTest { }); } + private static ObjectStorageCapabilityAssembler testAssembler( + java.util.List contributions, + java.util.Set deployableProviderTypes) { + return new ObjectStorageCapabilityAssembler( + contributions, + new ObjectStorageBindingCompiler( + contributions, + java.util.Set.of("test"), + false, + java.time.Clock.systemUTC(), + deployableProviderTypes)); + } + + private static ObjectStorageCapabilitySettings countingSettings(Path root) { + return settings( + "counting", + new ObjectStorageProviderSettings( + "counting", + "v1", + root.toString(), + org.springframework.util.unit.DataSize.ofKilobytes(1), + org.springframework.util.unit.DataSize.ofBytes(64), + null), + "counting"); + } + + private static ObjectStorageCapabilitySettings localSelectedWithUnselectedCounting( + Path localRoot, Path countingRoot) { + Map providers = + Map.of( + "local", + new ObjectStorageProviderSettings( + "filesystem-local-dev", + "jdk-21", + localRoot.toString(), + org.springframework.util.unit.DataSize.ofKilobytes(1), + org.springframework.util.unit.DataSize.ofBytes(64), + null), + "counting", + new ObjectStorageProviderSettings( + "counting", + "v1", + countingRoot.toString(), + org.springframework.util.unit.DataSize.ofKilobytes(1), + org.springframework.util.unit.DataSize.ofBytes(64), + null)); + return new ObjectStorageCapabilitySettings( + true, "poster", providers, Map.of("poster", destination("local")), null); + } + + private static ObjectStorageCapabilitySettings settings( + String providerId, ObjectStorageProviderSettings provider, String destinationProviderRef) { + return new ObjectStorageCapabilitySettings( + true, + "poster", + Map.of(providerId, provider), + Map.of("poster", destination(destinationProviderRef)), + null); + } + + private static ObjectStorageDestinationSettings destination(String providerRef) { + return new ObjectStorageDestinationSettings( + providerRef, "0123456789ab", "binding-v1", "policy-v1", null, null, null, null, null, null); + } + private static String[] providerProperties(Path root, boolean enabled) { return new String[] { "app.object-storage.enabled=" + enabled, @@ -307,16 +368,6 @@ class ObjectStorageCapabilityConfigTest { }; } - private static String[] countingProviderDefinition(Path root) { - return new String[] { - "app.object-storage.providers.counting.type=counting", - "app.object-storage.providers.counting.version=v1", - "app.object-storage.providers.counting.root=" + root, - "app.object-storage.providers.counting.maximum-object-bytes=1KB", - "app.object-storage.providers.counting.chunk-bytes=64B" - }; - } - private static String[] combined(String[] first, String[] second) { String[] combined = java.util.Arrays.copyOf(first, first.length + second.length); System.arraycopy(second, 0, combined, first.length, second.length); diff --git a/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageEnvManifestTest.java b/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageEnvManifestTest.java new file mode 100644 index 00000000..204fd710 --- /dev/null +++ b/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageEnvManifestTest.java @@ -0,0 +1,134 @@ +package dev.caskeleton.adapter.outbound.objectstorage.config; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.adapter.outbound.objectstorage.s3.S3ProviderCapabilityConfig; +import dev.caskeleton.adapter.outbound.objectstorage.s3.S3ProviderSettings; +import java.io.IOException; +import java.lang.reflect.ParameterizedType; +import java.lang.reflect.RecordComponent; +import java.lang.reflect.Type; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.LinkedHashMap; +import java.util.Map; +import java.util.Set; +import java.util.TreeSet; +import org.junit.jupiter.api.Test; + +class ObjectStorageEnvManifestTest { + + private static final Map MAP_PLACEHOLDERS = + Map.of( + "providers", "PROVIDER", + "destinations", "DESTINATION", + "capability-profiles", "PROFILE"); + + @Test + void manifestMatchesTheBoundObjectStorageSurface() throws Exception { + Map manifest = readManifest(findManifest()); + + Set expected = new TreeSet<>(); + collectRecord(ObjectStorageCapabilitySettings.class, "", expected); + collectRecord(LegacyObjectAdoptionSettings.class, "legacy-adoption", expected); + expected.add("scan-maintenance.enabled"); + + assertThat(manifest.keySet()).containsExactlyInAnyOrderElementsOf(expected); + manifest.forEach( + (field, env) -> + assertThat(env) + .as("environment template for %s", field) + .isEqualTo(toEnvironmentName(field))); + } + + private static void collectRecord(Class recordType, String prefix, Set fields) { + for (RecordComponent component : recordType.getRecordComponents()) { + String name = kebab(component.getName()); + String path = prefix.isEmpty() ? name : prefix + "." + name; + Class type = component.getType(); + + if (Map.class.isAssignableFrom(type)) { + String placeholder = MAP_PLACEHOLDERS.get(name); + if (placeholder == null) { + throw new IllegalStateException("missing manifest placeholder for map field " + path); + } + Class valueType = mapValueType(component.getGenericType()); + String mapPath = path + "[" + placeholder + "]"; + if (isObjectStorageRecord(valueType)) { + collectRecord(valueType, mapPath, fields); + } else { + fields.add(mapPath); + } + } else if (isObjectStorageRecord(type)) { + collectRecord(type, path, fields); + } else { + fields.add(path); + } + } + } + + private static boolean isObjectStorageRecord(Class type) { + return type.isRecord() + && (type == ObjectStorageCapabilitySettings.Legacy.class + || type == ObjectStorageProviderSettings.class + || type == ObjectStorageDestinationSettings.class + || type == S3ProviderSettings.class + || type == S3ProviderSettings.Credentials.class + || type == S3ProviderSettings.Timeouts.class + || type == S3ProviderSettings.Pool.class + || type == S3ProviderSettings.Retry.class + || type == S3ProviderCapabilityConfig.class); + } + + private static Class mapValueType(Type genericType) { + if (!(genericType instanceof ParameterizedType parameterized)) { + throw new IllegalStateException("map field is not parameterized: " + genericType); + } + Type value = parameterized.getActualTypeArguments()[1]; + if (value instanceof Class valueClass) { + return valueClass; + } + throw new IllegalStateException("map value is not a concrete class: " + value); + } + + private static String kebab(String value) { + return value.replaceAll("([a-z0-9])([A-Z])", "$1-$2").toLowerCase(java.util.Locale.ROOT); + } + + private static String toEnvironmentName(String field) { + return "APP_OBJECT_STORAGE_" + + field + .replace("[", "_") + .replace("]", "") + .replace('.', '_') + .replace('-', '_') + .toUpperCase(java.util.Locale.ROOT); + } + + private static Map readManifest(Path path) throws IOException { + Map result = new LinkedHashMap<>(); + String pendingField = null; + for (String line : Files.readAllLines(path)) { + String trimmed = line.trim(); + if (trimmed.startsWith("- field: ")) { + pendingField = trimmed.substring("- field: ".length()).trim(); + } else if (trimmed.startsWith("env: ") && pendingField != null) { + result.put(pendingField, trimmed.substring("env: ".length()).trim()); + pendingField = null; + } + } + return result; + } + + private static Path findManifest() { + Path cursor = Path.of("").toAbsolutePath(); + while (cursor != null) { + Path candidate = cursor.resolve("docs/objectstorage/env-fields.yaml"); + if (Files.isRegularFile(candidate)) { + return candidate; + } + cursor = cursor.getParent(); + } + throw new IllegalStateException("docs/objectstorage/env-fields.yaml was not found"); + } +} diff --git a/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageScanMaintenanceConfigTest.java b/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageScanMaintenanceConfigTest.java index b455e767..37c6ea5d 100644 --- a/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageScanMaintenanceConfigTest.java +++ b/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/config/ObjectStorageScanMaintenanceConfigTest.java @@ -20,6 +20,19 @@ class ObjectStorageScanMaintenanceConfigTest { .run(context -> assertThat(context).doesNotHaveBean(ObjectScanMaintenancePort.class)); } + @Test + void scanMaintenanceCannotActivateWhenTheRootCapabilityIsDisabled() { + new ApplicationContextRunner() + .withUserConfiguration(ObjectStorageScanMaintenanceConfig.class) + .withPropertyValues( + "app.object-storage.enabled=false", "app.object-storage.scan-maintenance.enabled=true") + .run( + context -> { + assertThat(context).hasNotFailed(); + assertThat(context).doesNotHaveBean(ObjectScanMaintenancePort.class); + }); + } + @Test void explicitScannerWorkflowExposesOnlyItsNarrowPort() { new ApplicationContextRunner() diff --git a/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/direct/DirectGrantReplayCacheTest.java b/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/direct/DirectGrantReplayCacheTest.java new file mode 100644 index 00000000..335e794e --- /dev/null +++ b/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/direct/DirectGrantReplayCacheTest.java @@ -0,0 +1,67 @@ +package dev.caskeleton.adapter.outbound.objectstorage.direct; + +import static org.assertj.core.api.Assertions.assertThat; + +import java.net.URI; +import java.time.Clock; +import java.time.Instant; +import java.time.ZoneId; +import java.time.ZoneOffset; +import java.util.Map; +import java.util.concurrent.atomic.AtomicReference; +import org.junit.jupiter.api.Test; + +class DirectGrantReplayCacheTest { + + @Test + void cacheEvictsEldestAndExpiredBearerMaterial() { + MutableClock clock = new MutableClock(Instant.parse("2026-09-22T00:00:00Z")); + DirectGrantReplayCache cache = new DirectGrantReplayCache(1, clock); + + cache.put("one", material("one"), clock.instant().plusSeconds(10)); + cache.put("two", material("two"), clock.instant().plusSeconds(10)); + + assertThat(cache.get("one")).isEmpty(); + assertThat(cache.get("two")).isPresent(); + assertThat(cache.size()).isOne(); + + clock.advanceTo(clock.instant().plusSeconds(11)); + + assertThat(cache.get("two")).isEmpty(); + assertThat(cache.size()).isZero(); + } + + private static DirectGrantProvider.DirectGrantMaterial material(String id) { + return new DirectGrantProvider.DirectGrantMaterial( + URI.create("https://storage.example.test/" + id), + Map.of("x-grant", id), + Instant.parse("2026-09-22T01:00:00Z")); + } + + private static final class MutableClock extends Clock { + private final AtomicReference instant; + + private MutableClock(Instant initial) { + instant = new AtomicReference<>(initial); + } + + void advanceTo(Instant next) { + instant.set(next); + } + + @Override + public ZoneId getZone() { + return ZoneOffset.UTC; + } + + @Override + public Clock withZone(ZoneId zone) { + return this; + } + + @Override + public Instant instant() { + return instant.get(); + } + } +} diff --git a/src/adapter/outbound/objectstorage/src/objectStorageMinioContractTest/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/MinioDirectTransferContractTest.java b/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/MinioDirectTransferContractTest.java similarity index 100% rename from src/adapter/outbound/objectstorage/src/objectStorageMinioContractTest/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/MinioDirectTransferContractTest.java rename to src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/MinioDirectTransferContractTest.java diff --git a/src/adapter/outbound/objectstorage/src/objectStorageMinioFaultTest/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/MinioDirectTransferFaultTest.java b/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/MinioDirectTransferFaultTest.java similarity index 100% rename from src/adapter/outbound/objectstorage/src/objectStorageMinioFaultTest/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/MinioDirectTransferFaultTest.java rename to src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/qualification/MinioDirectTransferFaultTest.java diff --git a/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/readiness/ObjectStorageReadinessRegistryTest.java b/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/readiness/ObjectStorageReadinessRegistryTest.java index ee44b498..644ef8e9 100644 --- a/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/readiness/ObjectStorageReadinessRegistryTest.java +++ b/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/readiness/ObjectStorageReadinessRegistryTest.java @@ -20,7 +20,8 @@ class ObjectStorageReadinessRegistryTest { private static final Set AVAILABLE_TASKS = Set.of(":application-core:check", ":adapter:outbound:objectstorage:check"); - private static final Set KNOWN_PROVIDERS = Set.of("filesystem-local-dev"); + private static final Set KNOWN_PROVIDERS = + ObjectStorageDeploymentReadiness.providerTypes(); @Test void registryHasTheFrozenNineCardsAndOnlyEvidencedClaims() throws Exception { diff --git a/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/s3/S3ProviderCompositionTest.java b/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/s3/S3ProviderCompositionTest.java index fa7c910a..755ce0b9 100644 --- a/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/s3/S3ProviderCompositionTest.java +++ b/src/adapter/outbound/objectstorage/src/test/java/dev/caskeleton/adapter/outbound/objectstorage/s3/S3ProviderCompositionTest.java @@ -29,7 +29,7 @@ class S3ProviderCompositionTest { Clock.fixed(Instant.parse("2026-07-28T00:00:00Z"), ZoneOffset.UTC); @Test - void disabledUnselectedAndInvalidBindingsConstructNoS3Resource() { + void defaultRuntimeCompilerRejectsS3UntilTrackedReadinessPromotesIt() { S3AsyncClient client = mock(S3AsyncClient.class); SdkAsyncHttpClient http = mock(SdkAsyncHttpClient.class); AtomicInteger constructions = new AtomicInteger(); @@ -38,6 +38,24 @@ class S3ProviderCompositionTest { ObjectStorageBindingCompiler compiler = new ObjectStorageBindingCompiler(List.of(contribution), Set.of("prod"), false, CLOCK); + assertThatIllegalArgumentException() + .isThrownBy(() -> compiler.compile(settings())) + .withMessageContaining("no deployable readiness evidence"); + assertThat(constructions).hasValue(0); + verifyNoInteractions(client, http); + } + + @Test + void disabledUnselectedAndInvalidBindingsConstructNoS3Resource() { + S3AsyncClient client = mock(S3AsyncClient.class); + SdkAsyncHttpClient http = mock(SdkAsyncHttpClient.class); + AtomicInteger constructions = new AtomicInteger(); + S3ObjectStorageProviderContribution contribution = + contribution(client, http, constructions, Map.of()); + ObjectStorageBindingCompiler compiler = + new ObjectStorageBindingCompiler( + List.of(contribution), Set.of("prod"), false, CLOCK, contribution.providerTypes()); + assertThat( compiler .compile(new ObjectStorageCapabilitySettings(false, null, null, null, null)) @@ -63,7 +81,8 @@ class S3ProviderCompositionTest { S3ObjectStorageProviderContribution contribution = contribution(client, http, constructions, Map.of()); ObjectStorageBindingCompiler compiler = - new ObjectStorageBindingCompiler(List.of(contribution), Set.of("test"), false, CLOCK); + new ObjectStorageBindingCompiler( + List.of(contribution), Set.of("test"), false, CLOCK, contribution.providerTypes()); ObjectStorageCapabilityAssembler assembler = new ObjectStorageCapabilityAssembler(List.of(contribution), compiler); @@ -97,7 +116,8 @@ class S3ProviderCompositionTest { policy -> presigner, ignored -> null); ObjectStorageBindingCompiler compiler = - new ObjectStorageBindingCompiler(List.of(contribution), Set.of("test"), false, CLOCK); + new ObjectStorageBindingCompiler( + List.of(contribution), Set.of("test"), false, CLOCK, contribution.providerTypes()); ObjectStorageCapabilityAssembler assembler = new ObjectStorageCapabilityAssembler(List.of(contribution), compiler); diff --git a/src/adapter/outbound/persistence-jpa/CLAUDE.md b/src/adapter/outbound/persistence-jpa/CLAUDE.md index c868447b..0eab70da 100644 --- a/src/adapter/outbound/persistence-jpa/CLAUDE.md +++ b/src/adapter/outbound/persistence-jpa/CLAUDE.md @@ -28,6 +28,7 @@ packages. | Platform package | Owns | |---|---| +| `autoconfigure` | package-private Boot composition root/runtime: vendor and optional-store imports, transaction executor/retry wiring, and composition factories. It is intentionally not exported as public API | | `api` (+ `.capability`, `.error`, `.query`, `.transaction`) | framework-free contracts: operation and query names, the stable error hierarchy, transaction and retry profiles, keyset cursors | | `transaction` | commit evidence, the Spring executor, full-transaction retry, completion-unknown reconciliation | | `springdata` | repository fragments, safe sort, fetch plans, keyset execution, stream guard | @@ -38,6 +39,26 @@ packages. | `experimental` | multi-tenancy, RLS, read replica, forward-compatibility lanes — all flag-gated | | `testkit` (`src/testkit/java`) | ArchUnit rules, fixtures, query/plan assertions, PostgreSQL matrix, failure injection | +### Spring composition ownership + +`META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports` publishes two +package-private entries: `PersistenceJpaAutoConfiguration` and `PersistenceJpaRuntimeConfig`. +Because Boot loads those candidates independently, **both** require +`ca-skeleton.persistence-jpa.enabled=true`. The first owns vendor/entity/repository and +capability-store imports. The second additionally honors `app.jpa-platform.addons-enabled` and is +ordered after Spring's datasource/JPA transaction-manager auto-configuration so +`@ConditionalOnBean` sees the actual transaction manager before deciding whether to create +`SpringJpaTransactionExecutor` and `FullTransactionRetryCoordinator`. Never rely on the first +candidate's condition to gate the sibling import candidate. + +The same split applies to owner-safe PostgreSQL idempotency: this leaf constructs the concrete PostgreSQL store behind IdempotencyStorePortV2, while app-bootstrap owns provider selection, TTL/lease/codec policy, executor construction, and exclusivity validation. + +Do not move application deployment policy into this leaf merely because it mentions JPA. +`app-bootstrap/autoconfigure/jpa` intentionally retains migration startup sequencing, resolved +datasource/version validation, OSIV/DDL safety, and the sanitized management endpoint/report. The +leaf must have zero imports from `dev.caskeleton.bootstrap`, and new composition helpers under +`autoconfigure` remain package-private so `verifyJpaApiSurface` does not grow by wiring accident. + ### Non-negotiables - No `GenericRepository` and no platform base repository. Domains own their repositories. @@ -79,6 +100,7 @@ nobody tested. - Persistence mappers. - Repository adapter implementations. - Outbox transport-only compatibility: raw `NewOutboxEvent` append belongs only to `LegacyOutboxAppendPort`; canonical `OutboxAppendPort` persists `ValidatedIntegrationEvent` exact bytes. Partial canonical metadata must fail closed and this path must not activate `POLLING_V2`. +- Owner-safe outbox V2 storage is canonical-aligned but remains a dark candidate: `NewOutboxEventV2` wraps one `ValidatedIntegrationEvent`, the PostgreSQL V2 event row preserves exact envelope `BYTEA` plus tenant/hash/revision metadata, aggregate ordering is tenant-scoped, and `ClaimedOutboxDelivery` reconstructs the canonical event without re-encoding. Pre-canonical or partially canonical rows fail closed. `PostgreSqlPollingDeliveryAdapter` is not a Spring component, no V2 scheduler is composed, and production publication authority remains `LEGACY_POLLING` until a separate cutover proves backlog/drain readiness. - `TransactionPort` implementation (`SpringTransactionPort`) — the bridge between application transactional intent and Spring's `PlatformTransactionManager`. - Audit-metadata base + actor seam (`audit/AuditableEntity`, `audit/AuditContextPort`, @@ -101,9 +123,10 @@ four SPI beans: `config/PersistenceVendorSettings` binds the selector to an enum, so an unknown value fails at startup instead of loading neither composition and surfacing as a missing `OutboxClaimRepository`. -The profiles state the choice: `application-local.yml` selects H2, `application-dev.yml` and -`application-prod.yml` select PostgreSQL, and `PersistenceVendorProdSafetyValidator` (app-bootstrap) -refuses H2 under prod whatever property source supplies it. +The profiles state the choice: `application-local.yml`, `application-dev.yml` and +`application-prod.yml` all default to PostgreSQL. H2 is an explicit developer opt-out selected by +the `bootRunH2` task. `PersistenceVendorProdSafetyValidator` (app-bootstrap) refuses H2 under prod +whatever property source supplies it. H2 is the local-development datastore, not a second production target. It has no migration tree, so tables that exist only in migrations — capability schema registry, polling-delivery and inbox @@ -141,8 +164,10 @@ should not exist. - Presentation DTOs. - Business policy decisions. - Use case orchestration hidden inside persistence adapters. -- Repository adapters owning `@Transactional` boundaries — the application use case owns - the transaction via `TransactionPort` (see +- Repository adapters opening `@Transactional` around application workflows — the application + use case owns cross-port transactions via `TransactionPort`. Adapter-local transactions are + allowed only when the port method itself defines a storage protocol that must be atomic (for + example durable-operation claim/read or live-event position allocation + insert). See [application-core/CLAUDE.md](../../../application-core/CLAUDE.md)). - **DB drivers** (`org.postgresql..`, `org.h2..`) or **`org.flywaydb.database.postgresql..`** — those are vendor-specific and belong only in this module's matching vendor package (`.postgresql`, @@ -222,7 +247,7 @@ framework-neutral `shared.error.PersistenceFailureException` carrying one of the an empty result means an unknown SQLState — rethrow the original so the web catch-all answers a generic `INTERNAL` envelope (no leak). - The category SSOT is the 10-value `Category` enum — there is **no** `PERSISTENCE` - category (branch-note §Audit CATEGORY_DRIFT). + category (design record §Audit CATEGORY_DRIFT). ## Persistence auditing contract (feature-persistence-auditing-contract) @@ -247,12 +272,11 @@ fields under `..domain..`). `created_at`, no `updated_at`) do NOT extend `AuditableEntity`. `version`/optimistic-lock is owned by feature-persistence-failure-baseline / feature-transaction-concurrency-contract, not by this audit base. -- **Growth path (D1, deferred).** Migrate to Spring Data JPA Auditing - (`@EntityListeners(AuditingEntityListener)` + `@CreatedDate`/`@LastModifiedDate`/… on the - base, `@EnableJpaAuditing(dateTimeProviderRef, auditorAwareRef)` in the composition root, - `DateTimeProvider` wrapping the same `Clock`, `AuditorAware` delegating to - `AuditContextPort`) when manual set risks omission. Bulk/native `@Query` UPDATEs bypass - both capture paths — stamp audit explicitly there if added. +- **Growth path (D1, deferred).** There is no second auditing implementation in the tree. If + manual stamping becomes too error-prone, migrate the canonical `AuditableEntity` contract + atomically to Spring Data listeners while preserving its `created_*`/`updated_*` schema, actor + bound, `Clock`, and `AuditContextPort` semantics. Bulk/native `@Query` UPDATEs bypass listeners + too, so they must continue to stamp audit columns explicitly. ## MapStruct generated mapper exemption (D9 of feature-architecture-enforcement-rules) diff --git a/src/adapter/outbound/persistence-jpa/README.md b/src/adapter/outbound/persistence-jpa/README.md index 96881cf5..01ba9500 100644 --- a/src/adapter/outbound/persistence-jpa/README.md +++ b/src/adapter/outbound/persistence-jpa/README.md @@ -49,13 +49,13 @@ write template을 재사용한다. 차이는 실행 전 precondition이다. - `version`/optimistic-lock 은 여기 두지 않는다. 이 베이스는 audit 전용으로 남기고, 낙관적 잠금 정책은 개별 영속성 모델이 소유한다. -### Growth path (D1, deferred — 여기 와이어링 안 됨) -audited 애그리거트 수가 늘어 수동 세팅이 누락 위험을 키우면 Spring Data JPA Auditing 으로 이전한다: -필드에 `@CreatedDate`/`@LastModifiedDate`/`@CreatedBy`/`@LastModifiedBy` + -`@EntityListeners(AuditingEntityListener.class)` 를 붙이고, 컴포지션 루트에 -`@EnableJpaAuditing(dateTimeProviderRef=..., auditorAwareRef=...)` 를 둔다. `DateTimeProvider` 가 -같은 `Clock`(D4)을, `AuditorAware` 가 `AuditContextPort`(D5)를 감싼다. bulk/native `@Query` -UPDATE 는 두 캡처 경로를 모두 우회하므로 거기서는 audit 를 명시적으로 찍어야 한다. +### Growth path (D1, deferred — 구현 복제본 없음) +audited 애그리거트 수가 늘어 수동 세팅이 누락 위험을 키우면 Spring Data JPA Auditing 으로 이전할 +수 있다. 다만 현재 leaf에는 두 번째 audit 모델을 미리 보관하지 않는다. 전환할 때 +`AuditableEntity`의 **같은 `created_*`/`updated_*` 스키마와 256자 actor 계약**을 유지한 채 +`@EntityListeners(AuditingEntityListener.class)`와 composition-owned `AuditorAware` / +`DateTimeProvider`를 원자적으로 도입한다. bulk/native `@Query` UPDATE는 어느 방식에서도 listener를 +우회하므로 audit column을 statement에서 명시적으로 갱신해야 한다. ### actor seam 을 왜 별도 포트로 격리하나 `AuditContextPort` 는 퍼시스턴스가 "누가 행위하는가"에 대해 의존하는 단 하나의 seam 이다. @@ -162,8 +162,12 @@ claim 시 canonical column이 전부 null이면 legacy `OutboxEvent`, 전부 존 ### 트랜잭션 경계 계약 - **append**: 호출자의 `TransactionPort.inWrite()` 경계 안에서 호출되어야 하며, 내부에서 새 트랜잭션을 열지 않는다. `@Repository` 가 빈만 등록하고 TX 는 use case 가 소유한다. -- **No `@Transactional`**: 이 코드베이스의 퍼시스턴스 어댑터는 `@Transactional` 을 선언하지 - 않는다. 유일한 트랜잭션 경계는 use case 가 소유한 `TransactionPort` 다(CLAUDE.md "Forbidden"). +- **Application write 경계에는 adapter-local `@Transactional`을 추가하지 않는다**: + 여러 port를 하나의 원자 작업으로 묶는 경계는 use case의 `TransactionPort`가 소유한다. + 예외는 **adapter 자체가 하나의 저장소 프로토콜을 구현하는 내부 원자 단위**다. 예를 들어 durable + operation의 claim은 `UPDATE ... RETURNING` 후 같은 claim을 읽어야 하고, live-event append는 + position allocator와 event insert가 함께 commit돼야 한다. 이런 메서드의 로컬 transaction은 + application transaction을 대체하는 것이 아니라 port 자체의 atomic semantics다. ### claim 계약 — vendor SPI (`OutboxClaimRepository`) row claim 은 vendor 별 락 전략이 필요해 `OutboxClaimRepository` SPI 로 추출했다. canonical diff --git a/src/adapter/outbound/persistence-jpa/build.gradle b/src/adapter/outbound/persistence-jpa/build.gradle index 84210711..2dc5b28e 100644 --- a/src/adapter/outbound/persistence-jpa/build.gradle +++ b/src/adapter/outbound/persistence-jpa/build.gradle @@ -35,6 +35,8 @@ auxiliarySourceSets { dependencies { implementation project(':application-core') + implementation project(':application-notification') + implementation project(':application-fileserver') implementation project(':shared-contract') implementation 'org.springframework.boot:spring-boot-starter-data-jpa' @@ -70,6 +72,9 @@ dependencies { testImplementation 'org.hibernate.orm:hibernate-envers' testImplementation libs.archunit.junit5 + // Application-owned provider-neutral contract kit. The adapter supplies real PostgreSQL + // implementations; the fixture supplies only the port semantics every implementation must obey. + postgresqlIntegrationTestImplementation testFixtures(project(':application-core')) postgresqlIntegrationTestImplementation 'org.testcontainers:testcontainers-postgresql' postgresqlIntegrationTestImplementation 'org.testcontainers:testcontainers-junit-jupiter' postgresqlIntegrationTestImplementation 'org.testcontainers:testcontainers-toxiproxy' @@ -111,7 +116,7 @@ dependencies { tasks.named('postgresqlSecurityBaselineIntegrationTest') { // Cross-leaf task edge: see the handoff. verifyCleanArchitectureDependencies inspects // configurations, not the task graph, so this edge is invisible to it. - dependsOn project(':adapter:inbound:web').tasks.named('jpaPersistenceRedactionContractTest') + dependsOn ':adapter:inbound:web:jpaPersistenceRedactionContractTest' } // Which JPA lanes block a release is declared by .github/workflows/jpa-release.yml. @@ -142,13 +147,12 @@ tasks.named('test') { // public surface with the most adopters was the one nothing had an opinion about. The convention // plugin is opt-in per leaf, and opting in was simply never done here. // -// This is a record, not a budget, and the distinction matters. A snapshot shrinks nothing on its -// own: the GraphQL surface grew from 373 types to 398 while under one, each addition approved and -// none refused. What the baseline buys is that growth is visible in review at the moment it -// happens and that the number is available to argue with — not that the number cannot rise. A -// ceiling the approval flag cannot lift is a separate decision nobody has taken yet. -// `api` is the surface an adopter is meant to reach; everything else here is a candidate to become -// internal at that point. +// This baseline is also a hard growth ceiling. Updating the committed surface may record removals +// freely, but a larger type count is rejected unless the reviewer separately supplies +// -PraiseJpaApiSurfaceCeiling in addition to the normal change approval. That makes "one more +// public type" a deliberate compatibility-budget decision rather than a routine baseline refresh. +// `api` is the intended adopter surface; implementation packages remain candidates for further +// internalization, and every removal pays down that compatibility debt. apiSurface { label = 'Jpa' baseline = rootProject.file('../docs/architecture/jpa-api-surface.txt') @@ -168,4 +172,5 @@ apiSurface { // the ca.jpa-qualification plugin from build-tools, which the root applies. tasks.named('check') { dependsOn rootProject.tasks.named('verifyJpaReadinessRegistry') + dependsOn tasks.named('verifySetConfigParameterBinding') } diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/PersistenceOperationName.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/PersistenceOperationName.java index dad1a125..273f491f 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/PersistenceOperationName.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/PersistenceOperationName.java @@ -1,5 +1,6 @@ package dev.caskeleton.adapter.outbound.persistence.api; +import java.io.Serializable; import java.util.regex.Pattern; /** @@ -10,7 +11,7 @@ import java.util.regex.Pattern; * format is fixed by the design and validated in the canonical constructor, which is what keeps * metric cardinality bounded at the type level rather than by convention. */ -public record PersistenceOperationName(String value) { +public record PersistenceOperationName(String value) implements Serializable { /** Design §9.1 — the exact accepted shape of an operation name. */ private static final Pattern FORMAT = Pattern.compile("[a-z][a-z0-9.-]{2,95}"); diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/CheckConstraintViolationException.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/CheckConstraintViolationException.java index 00de31ea..1a57fd63 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/CheckConstraintViolationException.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/CheckConstraintViolationException.java @@ -12,7 +12,7 @@ public final class CheckConstraintViolationException extends JpaPersistenceExcep private static final long serialVersionUID = 1L; - private final transient ConstraintViolationDetails details; + private final ConstraintViolationDetails details; public CheckConstraintViolationException( JpaFailureContext context, ConstraintViolationDetails details, Throwable cause) { diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/ConstraintCode.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/ConstraintCode.java index e9192122..2f1ece68 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/ConstraintCode.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/ConstraintCode.java @@ -1,5 +1,6 @@ package dev.caskeleton.adapter.outbound.persistence.api.error; +import java.io.Serializable; import java.util.regex.Pattern; /** @@ -14,7 +15,7 @@ import java.util.regex.Pattern; * ConstraintViolationDetails} is a core contract and the core may not depend on a vendor module. * See {@code docs/jpa/repository-adaptation.md} §4. */ -public record ConstraintCode(String value) { +public record ConstraintCode(String value) implements Serializable { private static final Pattern FORMAT = Pattern.compile("[a-z][a-z0-9.-]{2,95}"); diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/ConstraintViolationDetails.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/ConstraintViolationDetails.java index 24862ec4..e56326f9 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/ConstraintViolationDetails.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/ConstraintViolationDetails.java @@ -1,5 +1,6 @@ package dev.caskeleton.adapter.outbound.persistence.api.error; +import java.io.Serializable; import java.util.Objects; import java.util.Optional; import java.util.regex.Pattern; @@ -12,7 +13,8 @@ import java.util.regex.Pattern; * physical name the server reported; it is optional, bounded, and intended for operators rather * than for business logic, so that renaming an index never silently changes application behaviour. */ -public record ConstraintViolationDetails(ConstraintCode code, String databaseConstraintName) { +public record ConstraintViolationDetails(ConstraintCode code, String databaseConstraintName) + implements Serializable { /** Physical constraint names come from the server and are bounded before they are exposed. */ private static final Pattern DATABASE_NAME = Pattern.compile("[A-Za-z0-9._-]{1,128}"); diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/ForeignKeyViolationException.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/ForeignKeyViolationException.java index 541dc7c2..e7447095 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/ForeignKeyViolationException.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/ForeignKeyViolationException.java @@ -11,7 +11,7 @@ public final class ForeignKeyViolationException extends JpaPersistenceException private static final long serialVersionUID = 1L; - private final transient ConstraintViolationDetails details; + private final ConstraintViolationDetails details; public ForeignKeyViolationException( JpaFailureContext context, ConstraintViolationDetails details, Throwable cause) { diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/JpaFailureContext.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/JpaFailureContext.java index 3f79511d..119ebffb 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/JpaFailureContext.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/JpaFailureContext.java @@ -1,6 +1,7 @@ package dev.caskeleton.adapter.outbound.persistence.api.error; import dev.caskeleton.adapter.outbound.persistence.api.PersistenceOperationName; +import java.io.Serializable; import java.time.Duration; import java.util.Objects; import java.util.regex.Pattern; @@ -25,7 +26,8 @@ public record JpaFailureContext( boolean retryable, boolean completionUnknown, Duration elapsed, - String traceId) { + String traceId) + implements Serializable { /** SQLSTATE is five alphanumeric characters; anything else is not a SQLSTATE. */ private static final Pattern SQL_STATE = Pattern.compile("[0-9A-Za-z]{5}"); diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/JpaPersistenceException.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/JpaPersistenceException.java index 4d5af3f7..0fffa7f5 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/JpaPersistenceException.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/JpaPersistenceException.java @@ -15,8 +15,8 @@ public class JpaPersistenceException extends RuntimeException { private static final long serialVersionUID = 1L; - private final transient JpaFailureContext context; - private final transient FailureCategory category; + private final JpaFailureContext context; + private final FailureCategory category; public JpaPersistenceException( FailureCategory category, JpaFailureContext context, Throwable cause) { diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/NotNullConstraintViolationException.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/NotNullConstraintViolationException.java index 8ce632cf..d8ab5244 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/NotNullConstraintViolationException.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/NotNullConstraintViolationException.java @@ -12,7 +12,7 @@ public final class NotNullConstraintViolationException extends JpaPersistenceExc private static final long serialVersionUID = 1L; - private final transient ConstraintViolationDetails details; + private final ConstraintViolationDetails details; public NotNullConstraintViolationException( JpaFailureContext context, ConstraintViolationDetails details, Throwable cause) { diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/TransactionCompletionUnknownException.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/TransactionCompletionUnknownException.java index d7261b84..31e66b19 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/TransactionCompletionUnknownException.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/TransactionCompletionUnknownException.java @@ -25,8 +25,8 @@ public final class TransactionCompletionUnknownException extends JpaPersistenceE /** Transaction keys are application-chosen correlation ids, bounded before they are exposed. */ private static final Pattern TRANSACTION_KEY = Pattern.compile("[A-Za-z0-9._:-]{1,128}"); - private final transient String transactionKey; - private final transient TransactionCompletionEvidence evidence; + private final String transactionKey; + private final TransactionCompletionEvidence evidence; public TransactionCompletionUnknownException( JpaFailureContext context, diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/UniqueConstraintViolationException.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/UniqueConstraintViolationException.java index aad69005..37509977 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/UniqueConstraintViolationException.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/api/error/UniqueConstraintViolationException.java @@ -13,7 +13,7 @@ public final class UniqueConstraintViolationException extends JpaPersistenceExce private static final long serialVersionUID = 1L; - private final transient ConstraintViolationDetails details; + private final ConstraintViolationDetails details; public UniqueConstraintViolationException( JpaFailureContext context, ConstraintViolationDetails details, Throwable cause) { diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/auditing/AuditMetadata.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/auditing/AuditMetadata.java deleted file mode 100644 index 05fbb4e4..00000000 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/auditing/AuditMetadata.java +++ /dev/null @@ -1,90 +0,0 @@ -package dev.caskeleton.adapter.outbound.persistence.auditing; - -import jakarta.persistence.Column; -import jakarta.persistence.Embeddable; -import java.time.Instant; -import java.util.Objects; -import org.springframework.data.annotation.CreatedBy; -import org.springframework.data.annotation.CreatedDate; -import org.springframework.data.annotation.LastModifiedBy; -import org.springframework.data.annotation.LastModifiedDate; - -/** - * Opt-in technical audit columns (design §10.2). - * - *

An {@code @Embeddable} rather than a mandatory {@code BaseEntity}. A platform-wide base class - * forces four columns onto every table including the ones where they are meaningless — join tables, - * immutable event records, outbox rows — and, worse, it puts the platform in the entity hierarchy, - * so a later platform change reshapes every domain aggregate. - * - *

This is technical auditing: who last touched the row, mechanically. It is not - * business audit and not entity history. Business audit answers "what did the user do and why" and - * belongs to the domain; entity history answers "what did this row look like at revision N" and - * belongs to Envers (design §35). Conflating them produces an audit trail that satisfies neither - * requirement. - * - *

{@code createdAt}/{@code createdBy} are {@code updatable = false}: a create stamp that a later - * update can rewrite is not a create stamp. - */ -@Embeddable -public class AuditMetadata { - - @CreatedDate - @Column(name = "created_at", updatable = false) - private Instant createdAt; - - @CreatedBy - @Column(name = "created_by", updatable = false, length = 64) - private String createdBy; - - @LastModifiedDate - @Column(name = "modified_at") - private Instant modifiedAt; - - @LastModifiedBy - @Column(name = "modified_by", length = 64) - private String modifiedBy; - - protected AuditMetadata() { - // required by the persistence provider - } - - /** When the row was first written. */ - public Instant createdAt() { - return createdAt; - } - - /** The bounded actor identity that first wrote the row. */ - public String createdBy() { - return createdBy; - } - - /** When the row was last modified. */ - public Instant modifiedAt() { - return modifiedAt; - } - - /** The bounded actor identity that last modified the row. */ - public String modifiedBy() { - return modifiedBy; - } - - @Override - public boolean equals(Object other) { - if (this == other) { - return true; - } - if (!(other instanceof AuditMetadata audit)) { - return false; - } - return Objects.equals(createdAt, audit.createdAt) - && Objects.equals(createdBy, audit.createdBy) - && Objects.equals(modifiedAt, audit.modifiedAt) - && Objects.equals(modifiedBy, audit.modifiedBy); - } - - @Override - public int hashCode() { - return Objects.hash(createdAt, createdBy, modifiedAt, modifiedBy); - } -} diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/auditing/JpaAuditingConfiguration.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/auditing/JpaAuditingConfiguration.java deleted file mode 100644 index 7513fe3f..00000000 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/auditing/JpaAuditingConfiguration.java +++ /dev/null @@ -1,48 +0,0 @@ -package dev.caskeleton.adapter.outbound.persistence.auditing; - -import java.time.Clock; -import java.util.Objects; -import java.util.Optional; -import org.springframework.data.auditing.DateTimeProvider; - -/** - * The wiring an application must supply to switch technical auditing on (design §10.2). - * - *

Deliberately not a Spring {@code @Configuration}. Auditing is opt-in, and an adapter leaf that - * auto-enabled it would stamp audit columns on every entity in every application that merely has - * this module on the classpath — including the ones whose tables have no such columns, where the - * result is a startup failure rather than a feature. - * - *

The composition root builds these two beans and enables auditing itself, which keeps the - * decision where {@code AGENTS.md} puts composition. - */ -public final class JpaAuditingConfiguration { - - private final Clock clock; - private final JpaAuditorProvider auditorProvider; - - public JpaAuditingConfiguration(Clock clock, JpaAuditorProvider auditorProvider) { - this.clock = Objects.requireNonNull(clock, "clock"); - this.auditorProvider = Objects.requireNonNull(auditorProvider, "auditorProvider"); - } - - /** - * The time source audit stamps come from. - * - *

It wraps the injected {@link Clock} rather than reading {@code Instant.now()} so that a test - * can fix the clock and assert the stamp, which is otherwise untestable. - */ - public DateTimeProvider dateTimeProvider() { - return () -> Optional.of(clock.instant()); - } - - /** The actor source audit stamps come from. */ - public JpaAuditorProvider auditorProvider() { - return auditorProvider; - } - - /** The clock audit stamps are read from. */ - public Clock clock() { - return clock; - } -} diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/auditing/JpaAuditorProvider.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/auditing/JpaAuditorProvider.java deleted file mode 100644 index 8d4b4959..00000000 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/auditing/JpaAuditorProvider.java +++ /dev/null @@ -1,51 +0,0 @@ -package dev.caskeleton.adapter.outbound.persistence.auditing; - -import java.util.Objects; -import java.util.Optional; -import java.util.function.Supplier; -import java.util.regex.Pattern; -import org.springframework.data.domain.AuditorAware; - -/** - * Supplies the bounded actor identity Spring Data stamps onto audited rows (design §10.2). - * - *

The identity is opaque and bounded — a user id or a system actor name, never a display name, - * an email, or a principal object. Those are PII, and an audit column is copied into every backup, - * every replica, and every export of that table. - * - *

Background work gets an explicit system actor rather than an empty column. "Who changed this" - * answered by a null is indistinguishable from a bug in the auditing setup. - */ -public final class JpaAuditorProvider implements AuditorAware { - - /** The actor recorded for scheduled jobs, migrations, and other unattended work. */ - public static final String SYSTEM_ACTOR = "system"; - - private static final Pattern ACTOR = Pattern.compile("[A-Za-z0-9._:-]{1,64}"); - - private final Supplier> currentActor; - - public JpaAuditorProvider(Supplier> currentActor) { - this.currentActor = Objects.requireNonNull(currentActor, "currentActor"); - } - - /** A provider that always records the system actor. */ - public static JpaAuditorProvider system() { - return new JpaAuditorProvider(() -> Optional.of(SYSTEM_ACTOR)); - } - - @Override - public Optional getCurrentAuditor() { - return currentActor.get().map(JpaAuditorProvider::bound).or(() -> Optional.of(SYSTEM_ACTOR)); - } - - /** - * Bounds an actor identity. - * - *

An identity that is not already bounded is replaced rather than truncated: truncating an - * email still leaves most of it in the column. - */ - private static String bound(String actor) { - return actor != null && ACTOR.matcher(actor).matches() ? actor : SYSTEM_ACTOR; - } -} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaObservabilityAutoConfiguration.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/JpaObservabilityAutoConfiguration.java similarity index 94% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaObservabilityAutoConfiguration.java rename to src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/JpaObservabilityAutoConfiguration.java index 2c9fcb1d..96ae817b 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaObservabilityAutoConfiguration.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/JpaObservabilityAutoConfiguration.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.jpa; +package dev.caskeleton.adapter.outbound.persistence.autoconfigure; import dev.caskeleton.adapter.outbound.persistence.api.query.NoopQueryObservation; import dev.caskeleton.adapter.outbound.persistence.api.query.QueryObservation; @@ -23,7 +23,7 @@ import java.util.Optional; * two data sources in the same application, and a default of {@code "default"} makes them * indistinguishable exactly when someone is trying to tell them apart. */ -public final class JpaObservabilityAutoConfiguration { +final class JpaObservabilityAutoConfiguration { private final Optional registry; private final String persistenceUnit; @@ -32,8 +32,7 @@ public final class JpaObservabilityAutoConfiguration { * @param registry the meter registry, or empty when the application installs none * @param persistenceUnit the bounded name distinguishing this persistence unit from others */ - public JpaObservabilityAutoConfiguration( - Optional registry, String persistenceUnit) { + JpaObservabilityAutoConfiguration(Optional registry, String persistenceUnit) { this.registry = Objects.requireNonNull(registry, "registry"); this.persistenceUnit = Objects.requireNonNull(persistenceUnit, "persistenceUnit"); } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaTransactionAutoConfiguration.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/JpaTransactionAutoConfiguration.java similarity index 97% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaTransactionAutoConfiguration.java rename to src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/JpaTransactionAutoConfiguration.java index cde53f37..33f363c6 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaTransactionAutoConfiguration.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/JpaTransactionAutoConfiguration.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.autoconfigure.jpa; +package dev.caskeleton.adapter.outbound.persistence.autoconfigure; import dev.caskeleton.adapter.outbound.persistence.api.error.VendorFailureTranslator; import dev.caskeleton.adapter.outbound.persistence.api.transaction.JpaRetryPolicy; @@ -37,14 +37,14 @@ import org.springframework.transaction.PlatformTransactionManager; * PolicyTransactionPort.inTransaction(TransactionRequest, Supplier)}; the retry coordinator below * is what implements it, not a second way to ask for the same thing. */ -public final class JpaTransactionAutoConfiguration { +final class JpaTransactionAutoConfiguration { /** How long a logical operation may keep retrying before the budget is spent regardless. */ public static final Duration DEFAULT_MAX_RETRY_ELAPSED = Duration.ofSeconds(30); private final Clock clock; - public JpaTransactionAutoConfiguration(Clock clock) { + JpaTransactionAutoConfiguration(Clock clock) { this.clock = Objects.requireNonNull(clock, "clock"); } diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PersistenceJpaAutoConfiguration.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PersistenceJpaAutoConfiguration.java new file mode 100644 index 00000000..b077ff59 --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PersistenceJpaAutoConfiguration.java @@ -0,0 +1,29 @@ +package dev.caskeleton.adapter.outbound.persistence.autoconfigure; + +import dev.caskeleton.adapter.outbound.persistence.config.JpaAdapterComponentsConfig; +import dev.caskeleton.adapter.outbound.persistence.config.PersistenceVendorSettings; +import dev.caskeleton.adapter.outbound.persistence.fileserver.FileserverJpaPersistenceConfig; +import dev.caskeleton.adapter.outbound.persistence.h2.H2PersistenceConfig; +import dev.caskeleton.adapter.outbound.persistence.notification.configuration.NotificationJpaPersistenceFacade; +import dev.caskeleton.adapter.outbound.persistence.postgresql.PostgreSqlPersistenceConfig; +import org.springframework.boot.autoconfigure.AutoConfiguration; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.context.annotation.Import; + +/** Capability-owned Spring entry point for relational persistence. */ +@AutoConfiguration +@ConditionalOnProperty( + prefix = "ca-skeleton.persistence-jpa", + name = "enabled", + havingValue = "true") +@EnableConfigurationProperties(PersistenceVendorSettings.class) +@Import({ + JpaAdapterComponentsConfig.class, + PostgreSqlPersistenceConfig.class, + H2PersistenceConfig.class, + FileserverJpaPersistenceConfig.class, + NotificationJpaPersistenceFacade.class, + PostgreSqlIdempotencyStoreConfig.class +}) +class PersistenceJpaAutoConfiguration {} diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PersistenceJpaRuntimeConfig.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PersistenceJpaRuntimeConfig.java new file mode 100644 index 00000000..0ce18dee --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PersistenceJpaRuntimeConfig.java @@ -0,0 +1,77 @@ +package dev.caskeleton.adapter.outbound.persistence.autoconfigure; + +import dev.caskeleton.adapter.outbound.persistence.api.error.VendorFailureTranslator; +import dev.caskeleton.adapter.outbound.persistence.api.transaction.RetryEventListener; +import dev.caskeleton.adapter.outbound.persistence.hibernate.HibernateProviderPolicy; +import dev.caskeleton.adapter.outbound.persistence.security.PostgreSqlRuntimeRoleVerifier; +import dev.caskeleton.adapter.outbound.persistence.transaction.FullTransactionRetryCoordinator; +import dev.caskeleton.adapter.outbound.persistence.transaction.SpringJpaTransactionExecutor; +import java.time.Clock; +import org.springframework.beans.factory.ObjectProvider; +import org.springframework.boot.autoconfigure.AutoConfiguration; +import org.springframework.boot.autoconfigure.condition.ConditionalOnBean; +import org.springframework.boot.autoconfigure.condition.ConditionalOnClass; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.transaction.PlatformTransactionManager; + +/** Reusable JPA provider/runtime composition owned by the persistence leaf. */ +@AutoConfiguration( + afterName = { + "org.springframework.boot.hibernate.autoconfigure.HibernateJpaAutoConfiguration", + "org.springframework.boot.jdbc.autoconfigure.DataSourceTransactionManagerAutoConfiguration" + }) +@ConditionalOnClass(javax.sql.DataSource.class) +@ConditionalOnProperty( + prefix = "ca-skeleton.persistence-jpa", + name = "enabled", + havingValue = "true") +@ConditionalOnProperty(prefix = "app.jpa-platform", name = "addons-enabled", matchIfMissing = true) +class PersistenceJpaRuntimeConfig { + + @Bean + @ConditionalOnMissingBean + HibernateProviderPolicy hibernateProviderPolicy() { + return HibernateProviderPolicy.fromClasspath(); + } + + @Bean + @ConditionalOnMissingBean + PostgreSqlRuntimeRoleVerifier postgreSqlRuntimeRoleVerifier() { + return new PostgreSqlRuntimeRoleVerifier(); + } + + @Bean + @ConditionalOnMissingBean + RetryEventListener jpaRetryEventListener() { + return RetryEventListener.noop(); + } + + @Bean + @ConditionalOnMissingBean + @ConditionalOnBean(PlatformTransactionManager.class) + SpringJpaTransactionExecutor jpaTransactionExecutor( + PlatformTransactionManager transactionManager, + Clock clock, + ObjectProvider vendorFailures) { + JpaTransactionAutoConfiguration composition = new JpaTransactionAutoConfiguration(clock); + VendorFailureTranslator vendor = vendorFailures.getIfAvailable(); + return vendor == null + ? composition.transactionExecutor(transactionManager) + : composition.transactionExecutor(transactionManager, vendor); + } + + @Bean + @ConditionalOnMissingBean + @ConditionalOnBean(SpringJpaTransactionExecutor.class) + FullTransactionRetryCoordinator jpaRetryCoordinator( + SpringJpaTransactionExecutor executor, RetryEventListener retryListener, Clock clock) { + return new JpaTransactionAutoConfiguration(clock) + .retryCoordinator( + executor, + dev.caskeleton.adapter.outbound.persistence.api.transaction.RetryProfile + .boundedContention("jpa-platform-default", 3), + retryListener); + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PostgreSqlIdempotencyStoreConfig.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PostgreSqlIdempotencyStoreConfig.java new file mode 100644 index 00000000..5c51d603 --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PostgreSqlIdempotencyStoreConfig.java @@ -0,0 +1,21 @@ +package dev.caskeleton.adapter.outbound.persistence.autoconfigure; + +import dev.caskeleton.adapter.outbound.persistence.postgresql.idempotency.PostgreSqlOwnerSafeIdempotencyStore; +import dev.caskeleton.application.idempotency.v2.IdempotencyStorePortV2; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.jdbc.core.JdbcOperations; + +/** Concrete PostgreSQL owner-safe idempotency store composition. */ +@Configuration(proxyBeanMethods = false) +@ConditionalOnProperty( + name = "ca-skeleton.capabilities.idempotency.provider", + havingValue = "postgresql") +class PostgreSqlIdempotencyStoreConfig { + + @Bean + IdempotencyStorePortV2 postgreSqlOwnerSafeIdempotencyStore(JdbcOperations jdbc) { + return new PostgreSqlOwnerSafeIdempotencyStore(jdbc); + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/config/JpaAdapterComponentsConfig.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/config/JpaAdapterComponentsConfig.java index 4a7f1a35..35713251 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/config/JpaAdapterComponentsConfig.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/config/JpaAdapterComponentsConfig.java @@ -61,7 +61,9 @@ import org.springframework.context.annotation.Configuration; "dev.caskeleton.adapter.outbound.persistence.audit", "dev.caskeleton.adapter.outbound.persistence.failure", "dev.caskeleton.adapter.outbound.persistence.idempotency", + "dev.caskeleton.adapter.outbound.persistence.liveevent", "dev.caskeleton.adapter.outbound.persistence.lock", + "dev.caskeleton.adapter.outbound.persistence.operation", "dev.caskeleton.adapter.outbound.persistence.outbox", "dev.caskeleton.adapter.outbound.persistence.transaction" }) diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/envers/HibernateEnversHistoryReader.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/envers/HibernateEnversHistoryReader.java index a489793f..8f213fed 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/envers/HibernateEnversHistoryReader.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/envers/HibernateEnversHistoryReader.java @@ -1,12 +1,11 @@ package dev.caskeleton.adapter.outbound.persistence.envers; import jakarta.persistence.EntityManager; -import java.time.Instant; -import java.util.ArrayList; import java.util.List; import java.util.Objects; import org.hibernate.envers.AuditReader; import org.hibernate.envers.AuditReaderFactory; +import org.hibernate.envers.RevisionMapping; import org.hibernate.envers.query.AuditEntity; /** @@ -19,6 +18,10 @@ import org.hibernate.envers.query.AuditEntity; *

Envers is {@code compileOnly} for this leaf, so a deployment that has not opted in never loads * this class. The guard reports its absence at startup rather than letting the first history read * fail with a missing class. + * + *

Revision history is read with one Envers query that projects the entity snapshot, revision + * number and revision timestamp together. Calling {@code find()} and {@code getRevisionDate()} once + * per revision turns a history page into 1+N database round trips as the entity accumulates changes. */ public final class HibernateEnversHistoryReader implements EnversHistoryReader { @@ -39,18 +42,27 @@ public final class HibernateEnversHistoryReader implements EnversHistoryReader { } AuditReader reader = AuditReaderFactory.get(entityManager); - List revisionNumbers = reader.getRevisions(entityType, id); - List> revisions = new ArrayList<>(revisionNumbers.size()); - for (Number revisionNumber : revisionNumbers) { - T entity = reader.find(entityType, id, revisionNumber); - Instant recordedAt = reader.getRevisionDate(revisionNumber).toInstant(); - revisions.add( - new EntityRevision<>( - revisionNumber.longValue(), - entity, - new EnversRevisionMetadata(null, null, recordedAt))); - } - return List.copyOf(revisions); + List rows = + reader + .createQuery() + .forRevisionsOfEntity(entityType, false, true) + .add(AuditEntity.id().eq(id)) + .addOrder(AuditEntity.revisionNumber().asc()) + .getResultList(); + + return rows.stream() + .map( + raw -> { + Object[] row = (Object[]) raw; + @SuppressWarnings("unchecked") + T entity = (T) row[0]; + RevisionMapping revision = (RevisionMapping) row[1]; + return new EntityRevision<>( + revision.getId(), + entity, + new EnversRevisionMetadata(null, null, revision.getRevisionDate().toInstant())); + }) + .toList(); } /** The revision numbers recorded for one entity instance, oldest first. */ diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/fileserver/FileEntityMapper.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/fileserver/FileEntityMapper.java index eb9a2306..b6840b14 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/fileserver/FileEntityMapper.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/fileserver/FileEntityMapper.java @@ -13,7 +13,7 @@ import dev.caskeleton.application.fileserver.api.metadata.QuotaReservation; import dev.caskeleton.application.fileserver.api.metadata.QuotaReservationStatus; import dev.caskeleton.application.fileserver.api.metadata.QuotaScope; import dev.caskeleton.application.fileserver.api.metadata.UploadSession; -import dev.caskeleton.application.fileserver.api.transfer.UploadProtocol; +import dev.caskeleton.application.fileserver.api.transfer.UploadMode; import java.util.Optional; import java.util.OptionalLong; @@ -39,7 +39,6 @@ final class FileEntityMapper { toOptionalLong(entity.getExpectedSize()), toOptionalLong(entity.getActualSize()), Optional.ofNullable(entity.getSha256()), - Optional.ofNullable(entity.getStrongEtag()), Optional.ofNullable(entity.getPublishedAt()), Optional.ofNullable(entity.getLastErrorCode()), entity.getVersion(), @@ -51,7 +50,7 @@ final class FileEntityMapper { return new UploadSession( UploadId.of(entity.getUploadId()), FileId.of(entity.getFileId()), - UploadProtocol.valueOf(entity.getProtocol()), + uploadMode(entity.getProtocol()), toOptionalLong(entity.getExpectedLength()), entity.getCommittedOffset(), entity.getExpiresAt(), @@ -75,6 +74,16 @@ final class FileEntityMapper { entity.getVersion()); } + private static UploadMode uploadMode(String legacyProtocol) { + return switch (legacyProtocol) { + case "RAW", "MULTIPART" -> UploadMode.SINGLE_SHOT; + case "BATCH" -> UploadMode.BATCH; + case "TUS_1_0" -> UploadMode.RESUMABLE; + case "HTTPBIS_DRAFT12" -> UploadMode.EXPERIMENTAL_RESUMABLE; + default -> throw new IllegalArgumentException("unknown persisted upload protocol"); + }; + } + private static OptionalLong toOptionalLong(Long value) { return value == null ? OptionalLong.empty() : OptionalLong.of(value); } diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/fileserver/JpaFileMetadataStore.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/fileserver/JpaFileMetadataStore.java index 62492d5f..f453fdad 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/fileserver/JpaFileMetadataStore.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/fileserver/JpaFileMetadataStore.java @@ -96,7 +96,7 @@ public class JpaFileMetadataStore implements FileMetadataStore { mutation.contentKey().map(ContentKey::value).orElse(null), mutation.actualSize().isPresent() ? mutation.actualSize().getAsLong() : null, mutation.sha256().orElse(null), - mutation.strongEtag().orElse(null), + mutation.sha256().map(value -> "\"" + value + "\"").orElse(null), mutation.verifiedMediaType().orElse(null), mutation.publishedAt().orElse(null), mutation.lastErrorCode().orElse(null), diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/fileserver/JpaUploadSessionStore.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/fileserver/JpaUploadSessionStore.java index 9d61f5e9..1465f5ed 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/fileserver/JpaUploadSessionStore.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/fileserver/JpaUploadSessionStore.java @@ -54,7 +54,7 @@ public class JpaUploadSessionStore implements UploadSessionStore { new UploadSessionEntity( draft.uploadId().value(), draft.fileId().value(), - draft.protocol().name(), + legacyProtocol(draft.mode()), draft.expectedLength().isPresent() ? draft.expectedLength().getAsLong() : null, draft.expiresAt(), clock.instant()); @@ -154,4 +154,14 @@ public class JpaUploadSessionStore implements UploadSessionStore { FileserverFailureContext.forUpload( FileserverErrorCode.CONCURRENT_MODIFICATION, uploadId, true, false, false)); } + + private static String legacyProtocol( + dev.caskeleton.application.fileserver.api.transfer.UploadMode mode) { + return switch (mode) { + case SINGLE_SHOT -> "RAW"; + case BATCH -> "BATCH"; + case RESUMABLE -> "TUS_1_0"; + case EXPERIMENTAL_RESUMABLE -> "HTTPBIS_DRAFT12"; + }; + } } diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/h2/H2FailureTranslator.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/h2/H2FailureTranslator.java new file mode 100644 index 00000000..099512b1 --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/h2/H2FailureTranslator.java @@ -0,0 +1,63 @@ +package dev.caskeleton.adapter.outbound.persistence.h2; + +import dev.caskeleton.adapter.outbound.persistence.api.PersistenceOperationName; +import dev.caskeleton.adapter.outbound.persistence.api.error.DeadlockDetectedException; +import dev.caskeleton.adapter.outbound.persistence.api.error.FailureCategory; +import dev.caskeleton.adapter.outbound.persistence.api.error.JpaFailureContext; +import dev.caskeleton.adapter.outbound.persistence.api.error.JpaPersistenceException; +import dev.caskeleton.adapter.outbound.persistence.api.error.SerializationFailureException; +import dev.caskeleton.adapter.outbound.persistence.api.error.SqlExceptionSqlStateResolver; +import dev.caskeleton.adapter.outbound.persistence.api.error.SqlStateResolver; +import dev.caskeleton.adapter.outbound.persistence.api.error.VendorFailureTranslator; +import java.time.Duration; +import java.util.Objects; + +/** + * Classifies the contention SQLSTATEs the local H2 composition can surface. + * + *

H2 is not the production concurrency-fidelity database, but the local runtime still uses the + * same full-transaction retry coordinator. Leaving this SPI absent made every H2 contention failure + * bypass that coordinator entirely, so local behaviour contradicted the platform contract. + */ +final class H2FailureTranslator implements VendorFailureTranslator { + + private final SqlStateResolver sqlStateResolver; + + public H2FailureTranslator() { + this(new SqlExceptionSqlStateResolver()); + } + + H2FailureTranslator(SqlStateResolver sqlStateResolver) { + this.sqlStateResolver = Objects.requireNonNull(sqlStateResolver, "sqlStateResolver"); + } + + @Override + public JpaPersistenceException translate( + Throwable failure, + PersistenceOperationName operation, + int attempt, + Duration elapsed, + String traceId) { + Objects.requireNonNull(failure, "failure"); + Objects.requireNonNull(operation, "operation"); + + String sqlState = sqlStateResolver.resolve(failure).orElse(JpaFailureContext.NO_SQL_STATE); + Duration boundedElapsed = elapsed == null ? Duration.ZERO : elapsed; + + return switch (sqlState) { + case "40001" -> + new SerializationFailureException( + JpaFailureContext.retryable(operation, sqlState, attempt, boundedElapsed, traceId), + failure); + case "40P01" -> + new DeadlockDetectedException( + JpaFailureContext.retryable(operation, sqlState, attempt, boundedElapsed, traceId), + failure); + default -> + new JpaPersistenceException( + FailureCategory.UNKNOWN, + JpaFailureContext.terminal(operation, sqlState, attempt, boundedElapsed, traceId), + failure); + }; + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/h2/H2PersistenceConfig.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/h2/H2PersistenceConfig.java index e59f4cd6..45641dee 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/h2/H2PersistenceConfig.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/h2/H2PersistenceConfig.java @@ -1,5 +1,6 @@ package dev.caskeleton.adapter.outbound.persistence.h2; +import dev.caskeleton.adapter.outbound.persistence.api.error.VendorFailureTranslator; import dev.caskeleton.adapter.outbound.persistence.config.PersistenceJpaConfig; import dev.caskeleton.adapter.outbound.persistence.config.PersistenceVendorSettings; import dev.caskeleton.adapter.outbound.persistence.failure.SqlStateErrorMapping; @@ -55,6 +56,11 @@ public class H2PersistenceConfig { return new H2SqlStateErrorMapping(); } + @Bean + public VendorFailureTranslator h2VendorFailureTranslator() { + return new H2FailureTranslator(); + } + @Bean public TransactionLocalTimeoutConfigurer transactionLocalTimeoutConfigurer( JdbcOperations jdbcOperations) { diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/hibernate/batch/HibernateBatchConfigurationGuard.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/hibernate/batch/HibernateBatchConfigurationGuard.java index 420871e3..d8c8b934 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/hibernate/batch/HibernateBatchConfigurationGuard.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/hibernate/batch/HibernateBatchConfigurationGuard.java @@ -4,6 +4,7 @@ import jakarta.persistence.GeneratedValue; import jakarta.persistence.GenerationType; import jakarta.persistence.Id; import java.lang.reflect.Field; +import java.util.Map; import java.util.Objects; import java.util.Optional; @@ -45,6 +46,34 @@ public final class HibernateBatchConfigurationGuard { } } + /** + * Validates the SessionFactory settings a profile cannot change per Session. + * + *

The executor applies {@code jdbcBatchSize} directly to the Hibernate Session. Insert/update + * ordering is a SessionFactory setting, so a profile that asks for it must find it enabled in the + * actual runtime rather than assuming an application property was copied correctly. + */ + void validateRuntime(JpaBatchProfile profile, Map properties) { + Objects.requireNonNull(profile, "profile"); + Objects.requireNonNull(properties, "properties"); + if (profile.orderInserts() && !enabled(properties, "hibernate.order_inserts")) { + throw new IllegalStateException( + "batch profile '" + profile.name() + "' requires hibernate.order_inserts=true"); + } + if (profile.orderUpdates() && !enabled(properties, "hibernate.order_updates")) { + throw new IllegalStateException( + "batch profile '" + profile.name() + "' requires hibernate.order_updates=true"); + } + } + + private static boolean enabled(Map properties, String key) { + Object value = properties.get(key); + if (value instanceof Boolean enabled) { + return enabled; + } + return value != null && Boolean.parseBoolean(value.toString()); + } + /** Whether the entity's identifier is generated by an identity column. */ public boolean usesIdentityGeneration(Class entityType) { return identifierField(entityType) diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/hibernate/batch/HibernateJpaBatchExecutor.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/hibernate/batch/HibernateJpaBatchExecutor.java index 711267eb..4ac3ba4f 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/hibernate/batch/HibernateJpaBatchExecutor.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/hibernate/batch/HibernateJpaBatchExecutor.java @@ -23,11 +23,13 @@ public final class HibernateJpaBatchExecutor implements JpaBatchExecutor { private final EntityManager entityManager; private final HibernateStatisticsCollector statistics; + private final HibernateBatchConfigurationGuard configurationGuard; public HibernateJpaBatchExecutor( EntityManager entityManager, HibernateStatisticsCollector statistics) { this.entityManager = Objects.requireNonNull(entityManager, "entityManager"); this.statistics = Objects.requireNonNull(statistics, "statistics"); + this.configurationGuard = new HibernateBatchConfigurationGuard(); } @Override @@ -41,42 +43,58 @@ public final class HibernateJpaBatchExecutor implements JpaBatchExecutor { "batch persistence requires an active transaction owned by the application service"); } - HibernateStatisticsSnapshot before = statistics.snapshot(); - long processed = 0L; - long maxManagedEntities = 0L; - - for (T item : items) { - persister.accept(item); - processed++; - maxManagedEntities = Math.max(maxManagedEntities, managedEntityCount()); - boolean flushDue = processed % profile.flushSize() == 0L; - boolean clearDue = processed % profile.clearSize() == 0L; - // Clearing detaches every managed entity, and a detached entity that was never flushed is - // simply gone: no INSERT is issued and nothing reports a problem. With flushSize=100 and - // clearSize=150, the clear at 150 arrives when the flush condition is false, so rows 101–150 - // were dropped while the executor returned processed=300 and the table held 250. - // - // So a clear always flushes first. The two knobs stay independent — which is what the API - // offers — and the invariant that makes independence safe is enforced here rather than left - // to a caller choosing multiples. - if (flushDue || clearDue) { - entityManager.flush(); - } - if (clearDue) { - entityManager.clear(); - } + configurationGuard.validateRuntime( + profile, entityManager.getEntityManagerFactory().getProperties()); + if (!statistics.batchInstrumented()) { + throw new IllegalStateException( + "JDBC batch instrumentation is required before Hibernate batch execution; " + + "a zero batch counter cannot prove batching happened"); } - entityManager.flush(); - entityManager.clear(); + HibernateStatisticsSnapshot before = statistics.snapshot(); + Session session = entityManager.unwrap(Session.class); + Integer previousJdbcBatchSize = session.getJdbcBatchSize(); + session.setJdbcBatchSize(profile.jdbcBatchSize()); - HibernateStatisticsSnapshot delta = statistics.snapshot().minus(before); - return new BatchExecutionResult( - profile, - processed, - delta.flushes(), - delta.preparedStatements(), - delta.jdbcBatches(), - maxManagedEntities); + try { + long processed = 0L; + long maxManagedEntities = 0L; + + for (T item : items) { + persister.accept(item); + processed++; + maxManagedEntities = Math.max(maxManagedEntities, managedEntityCount(session)); + boolean flushDue = processed % profile.flushSize() == 0L; + boolean clearDue = processed % profile.clearSize() == 0L; + // Clearing detaches every managed entity, and a detached entity that was never flushed is + // simply gone: no INSERT is issued and nothing reports a problem. With flushSize=100 and + // clearSize=150, the clear at 150 arrives when the flush condition is false, so rows + // 101–150 + // were dropped while the executor returned processed=300 and the table held 250. + // + // So a clear always flushes first. The two knobs stay independent — which is what the API + // offers — and the invariant that makes independence safe is enforced here rather than left + // to a caller choosing multiples. + if (flushDue || clearDue) { + entityManager.flush(); + } + if (clearDue) { + entityManager.clear(); + } + } + entityManager.flush(); + entityManager.clear(); + + HibernateStatisticsSnapshot delta = statistics.snapshot().minus(before); + return new BatchExecutionResult( + profile, + processed, + delta.flushes(), + delta.preparedStatements(), + delta.jdbcBatches(), + maxManagedEntities); + } finally { + session.setJdbcBatchSize(previousJdbcBatchSize); + } } /** @@ -85,8 +103,7 @@ public final class HibernateJpaBatchExecutor implements JpaBatchExecutor { *

Hibernate exposes this only through its own {@code Session}; JPA has no equivalent. The * number is the evidence that the clear boundary is doing its job, so it is worth the unwrap. */ - private long managedEntityCount() { - Session session = entityManager.unwrap(Session.class); + private static long managedEntityCount(Session session) { return session.getStatistics().getEntityCount(); } } diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/idempotency/IdempotencyReaper.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/idempotency/IdempotencyReaper.java index 6d437e23..efadc178 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/idempotency/IdempotencyReaper.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/idempotency/IdempotencyReaper.java @@ -15,8 +15,7 @@ import org.springframework.transaction.annotation.Transactional; @Component @ConditionalOnProperty( name = "ca-skeleton.capabilities.idempotency.provider", - havingValue = "jdbc", - matchIfMissing = true) + havingValue = "jdbc") public class IdempotencyReaper { private static final Logger log = LoggerFactory.getLogger(IdempotencyReaper.class); diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/idempotency/IdempotencyStoreAdapter.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/idempotency/IdempotencyStoreAdapter.java index 280bcc60..3a44f862 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/idempotency/IdempotencyStoreAdapter.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/idempotency/IdempotencyStoreAdapter.java @@ -28,8 +28,7 @@ import org.springframework.stereotype.Repository; @Repository @ConditionalOnProperty( name = "ca-skeleton.capabilities.idempotency.provider", - havingValue = "jdbc", - matchIfMissing = true) + havingValue = "jdbc") public class IdempotencyStoreAdapter implements IdempotencyStorePort { /** §F threshold: payloads up to this size are stored inline in the DB row. */ diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/liveevent/JpaLiveEventReplayAdapter.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/liveevent/JpaLiveEventReplayAdapter.java index 4ea0f80e..6d7c4ee0 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/liveevent/JpaLiveEventReplayAdapter.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/liveevent/JpaLiveEventReplayAdapter.java @@ -11,9 +11,12 @@ import java.time.Instant; import java.util.List; import java.util.Objects; import java.util.Optional; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; import org.springframework.data.domain.Limit; +import org.springframework.jdbc.core.JdbcOperations; import org.springframework.stereotype.Repository; -import org.springframework.transaction.annotation.Transactional; +import org.springframework.transaction.support.TransactionSynchronizationManager; /** * Retained live-event history, on PostgreSQL. @@ -28,19 +31,37 @@ import org.springframework.transaction.annotation.Transactional; * cursor would receive the newer event as though it were the one it asked to continue after — with * nothing in the data to say so. * - *

The append is transactional and reads the high-water mark inside the same transaction. Two - * concurrent appends to one stream would otherwise both read the same maximum and both write it, - * which the primary key turns into a constraint violation rather than a duplicate — and a - * constraint violation is the right outcome, because the alternative is two events sharing a - * position. + *

Position allocation is a PostgreSQL atomic upsert against a one-row-per-stream counter. Two + * concurrent writers to one stream therefore serialize at that row and receive different positions. + * The counter update and event insert share this method's transaction, so a failed event insert + * also rolls the allocation back. */ @Repository +@ConditionalOnProperty( + prefix = "ca-skeleton.realtime.replay", + name = "enabled", + havingValue = "true") +@ConditionalOnProperty( + prefix = "ca-skeleton.persistence", + name = "vendor", + havingValue = "postgresql", + matchIfMissing = true) public class JpaLiveEventReplayAdapter implements LiveEventReplayPort { /** The most one replay call will load, whatever the caller asks for. */ public static final int MAX_REPLAY_LIMIT = 500; + static final String ALLOCATE_POSITION_SQL = + """ + INSERT INTO live_event_stream_position (stream_id, last_position) + VALUES (?, 1) + ON CONFLICT (stream_id) DO UPDATE + SET last_position = live_event_stream_position.last_position + 1 + RETURNING last_position + """; + private final LiveEventJpaRepository repository; + private final JdbcOperations jdbc; private final Clock clock; private final Duration retention; @@ -48,12 +69,17 @@ public class JpaLiveEventReplayAdapter implements LiveEventReplayPort { * An adapter over the event log. * * @param repository the Spring Data access + * @param jdbc JDBC access used by the atomic per-stream position allocator * @param clock the clock retention is measured against * @param retention how long an appended event stays replayable */ public JpaLiveEventReplayAdapter( - LiveEventJpaRepository repository, Clock clock, Duration retention) { + LiveEventJpaRepository repository, + JdbcOperations jdbc, + Clock clock, + @Value("${ca-skeleton.realtime.replay.retention}") Duration retention) { this.repository = Objects.requireNonNull(repository, "repository"); + this.jdbc = Objects.requireNonNull(jdbc, "jdbc"); this.clock = Objects.requireNonNull(clock, "clock"); this.retention = Objects.requireNonNull(retention, "retention"); if (retention.isNegative() || retention.isZero()) { @@ -72,19 +98,21 @@ public class JpaLiveEventReplayAdapter implements LiveEventReplayPort { * @param payload the encoded event * @return the assigned position */ - @Transactional public long append(String streamId, String payload) { + requireCallerTransaction("append"); Objects.requireNonNull(streamId, "streamId"); Objects.requireNonNull(payload, "payload"); Instant now = clock.instant(); - Long highest = repository.highestEverAssigned(streamId); - long position = highest == null ? 1L : highest + 1L; + Long allocated = jdbc.queryForObject(ALLOCATE_POSITION_SQL, Long.class, streamId); + if (allocated == null) { + throw new IllegalStateException("live-event position allocator returned no position"); + } + long position = allocated; repository.save(new LiveEventEntity(streamId, position, payload, now, now.plus(retention))); return position; } @Override - @Transactional(readOnly = true) public ReplayWindow window(String streamId) { Objects.requireNonNull(streamId, "streamId"); Instant now = clock.instant(); @@ -97,7 +125,6 @@ public class JpaLiveEventReplayAdapter implements LiveEventReplayPort { } @Override - @Transactional(readOnly = true) public List replayAfter(String streamId, long afterPosition, int limit) { Objects.requireNonNull(streamId, "streamId"); if (afterPosition < 0) { @@ -128,8 +155,15 @@ public class JpaLiveEventReplayAdapter implements LiveEventReplayPort { * * @return how many went */ - @Transactional public int sweepExpired() { + requireCallerTransaction("sweepExpired"); return repository.sweepExpired(clock.instant()); } + + private static void requireCallerTransaction(String operation) { + if (!TransactionSynchronizationManager.isActualTransactionActive()) { + throw new IllegalStateException( + "live-event " + operation + " requires an active caller transaction"); + } + } } diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/liveevent/LiveEventJpaRepository.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/liveevent/LiveEventJpaRepository.java index 72fd84b9..cf9ea4ce 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/liveevent/LiveEventJpaRepository.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/liveevent/LiveEventJpaRepository.java @@ -65,16 +65,6 @@ public interface LiveEventJpaRepository """) Long latestRetained(@Param("streamId") String streamId, @Param("now") Instant now); - /** - * The highest position ever assigned to a stream, retained or not. - * - *

Ignores retention on purpose. Positions must never be reused: assigning a swept position - * again would give two different events the same address, and a client holding the older cursor - * would silently receive the newer event as though it were the one it asked to continue after. - */ - @Query("select max(e.id.position) from LiveEventEntity e where e.id.streamId = :streamId") - Long highestEverAssigned(@Param("streamId") String streamId); - /** * Removes expired rows. * diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/NotificationSchemaActivation.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/NotificationSchemaActivation.java index 091ebdf7..dfede0d3 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/NotificationSchemaActivation.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/NotificationSchemaActivation.java @@ -1,5 +1,6 @@ package dev.caskeleton.adapter.outbound.persistence.notification; +import org.springframework.beans.factory.SmartInitializingSingleton; import org.springframework.jdbc.core.JdbcOperations; /** @@ -21,7 +22,7 @@ import org.springframework.jdbc.core.JdbcOperations; * on every notification would put a round trip on the send path to answer a question that cannot * change while the process runs. */ -public final class NotificationSchemaActivation { +public final class NotificationSchemaActivation implements SmartInitializingSingleton { static final String CAPABILITY_ID = "jpa-notification-platform-v4"; @@ -55,6 +56,11 @@ public final class NotificationSchemaActivation { * * @throws IllegalStateException naming the stream, the history table and the promotion step */ + @Override + public void afterSingletonsInstantiated() { + requireActive(); + } + public void requireActive() { Integer active; try { diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/configuration/NotificationJpaPersistenceFacade.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/configuration/NotificationJpaPersistenceFacade.java index ff9bc934..790ce9b6 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/configuration/NotificationJpaPersistenceFacade.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/configuration/NotificationJpaPersistenceFacade.java @@ -104,9 +104,7 @@ public class NotificationJpaPersistenceFacade { */ @Bean public NotificationSchemaActivation notificationSchemaActivation(JdbcOperations jdbc) { - NotificationSchemaActivation activation = new NotificationSchemaActivation(jdbc); - activation.requireActive(); - return activation; + return new NotificationSchemaActivation(jdbc); } /** @@ -120,9 +118,9 @@ public class NotificationJpaPersistenceFacade { */ @Bean public dev.caskeleton.application.notification.platform.dispatch.ReconciliationJobStorePort - reconciliationJobStore(JdbcOperations jdbc) { + reconciliationJobStore(JdbcOperations jdbc, Clock clock) { return new dev.caskeleton.adapter.outbound.persistence.notification.platform - .JdbcReconciliationJobStore(jdbc); + .JdbcReconciliationJobStore(jdbc, clock); } /** diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/AdminAuditJpaRepository.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/AdminAuditJpaRepository.java index 1c645275..9429560f 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/AdminAuditJpaRepository.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/AdminAuditJpaRepository.java @@ -2,7 +2,7 @@ package dev.caskeleton.adapter.outbound.persistence.notification.platform; import java.util.Optional; import java.util.UUID; -import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.repository.Repository; /* * Top-level, not nested inside a holder class. Spring Data does not discover nested repository @@ -14,7 +14,7 @@ import org.springframework.data.jpa.repository.JpaRepository; */ /** Operator audit records, doubling as the admin idempotency record. */ -public interface AdminAuditJpaRepository extends JpaRepository { +public interface AdminAuditJpaRepository extends Repository { /** Previous result for an operation id. */ Optional findByOperationId(String operationId); @@ -46,6 +46,43 @@ public interface AdminAuditJpaRepository extends JpaRepository findCompletedByOperationId( + @org.springframework.data.repository.query.Param("operationId") String operationId); + + /** Finalizes the row created by {@link #claimOperation}. */ + @org.springframework.data.jpa.repository.Modifying( + clearAutomatically = true, + flushAutomatically = true) + @org.springframework.data.jpa.repository.Query( + value = + "UPDATE notification_admin_audit" + + " SET reason_code = :reasonCode," + + " tenant_id = :tenantId," + + " dry_run = :dryRun," + + " attributes = CAST(:attributes AS jsonb)," + + " occurred_at = :now," + + " phase = 'COMPLETED'" + + " WHERE operation_id = :operationId" + + " AND action = :action" + + " AND actor_ref = :actorRef" + + " AND phase = 'CLAIMED'", + nativeQuery = true) + int completeOperation( + @org.springframework.data.repository.query.Param("operationId") String operationId, + @org.springframework.data.repository.query.Param("action") String action, + @org.springframework.data.repository.query.Param("actorRef") String actorRef, + @org.springframework.data.repository.query.Param("reasonCode") String reasonCode, + @org.springframework.data.repository.query.Param("tenantId") String tenantId, + @org.springframework.data.repository.query.Param("dryRun") boolean dryRun, + @org.springframework.data.repository.query.Param("attributes") String attributes, + @org.springframework.data.repository.query.Param("now") java.time.Instant now); + /** The phase and fingerprint of an operation somebody else claimed. */ @org.springframework.data.jpa.repository.Query( value = diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/AdminOperationResultPayloadCodec.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/AdminOperationResultPayloadCodec.java new file mode 100644 index 00000000..0af23f9d --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/AdminOperationResultPayloadCodec.java @@ -0,0 +1,143 @@ +package dev.caskeleton.adapter.outbound.persistence.notification.platform; + +import dev.caskeleton.application.notification.platform.admin.AdminOperationResult; +import dev.caskeleton.application.notification.platform.api.DeliveryAttemptId; +import dev.caskeleton.application.notification.platform.api.NotificationId; +import dev.caskeleton.application.notification.platform.api.RecipientDeliveryId; +import java.io.ByteArrayInputStream; +import java.io.ByteArrayOutputStream; +import java.io.DataInputStream; +import java.io.DataOutputStream; +import java.io.IOException; +import java.nio.charset.StandardCharsets; +import java.util.ArrayList; +import java.util.Base64; +import java.util.List; +import java.util.Optional; +import java.util.UUID; + +/** + * Versioned persistence codec for an admin operation's exact replay result. + * + *

The table already owns an {@code attributes jsonb} column. The payload itself is length-framed + * binary and then Base64URL encoded inside a tiny JSON envelope, so arbitrary reason strings cannot + * create delimiter collisions and no application-wide JSON mapper becomes a persistence contract. + */ +final class AdminOperationResultPayloadCodec { + + private static final int VERSION = 1; + private static final int MAX_FIELD_BYTES = 1_048_576; + private static final String PREFIX = "{\"v\":1,\"payload\":\""; + private static final String SUFFIX = "\"}"; + + String encode(AdminOperationResult result) { + try { + ByteArrayOutputStream bytes = new ByteArrayOutputStream(); + try (DataOutputStream out = new DataOutputStream(bytes)) { + out.writeInt(VERSION); + writeString(out, result.operationId()); + out.writeBoolean(result.dryRun()); + out.writeInt(result.affected()); + writeOptionalUuid(out, result.notificationId().map(NotificationId::value)); + writeOptionalUuid(out, result.recipientDeliveryId().map(RecipientDeliveryId::value)); + writeOptionalUuid(out, result.newAttemptId().map(DeliveryAttemptId::value)); + out.writeInt(result.reasonCodes().size()); + for (String reason : result.reasonCodes()) { + writeString(out, reason); + } + } + String encoded = Base64.getUrlEncoder().withoutPadding().encodeToString(bytes.toByteArray()); + return PREFIX + encoded + SUFFIX; + } catch (IOException impossible) { + throw new IllegalStateException("in-memory admin result encoding failed", impossible); + } + } + + AdminOperationResult decode(String json) { + if (json == null || !json.startsWith(PREFIX) || !json.endsWith(SUFFIX)) { + throw new IllegalStateException("stored admin result payload has an unsupported shape"); + } + String encoded = json.substring(PREFIX.length(), json.length() - SUFFIX.length()); + final byte[] bytes; + try { + bytes = Base64.getUrlDecoder().decode(encoded); + } catch (IllegalArgumentException invalidBase64) { + throw new IllegalStateException("stored admin result payload is not valid Base64URL", invalidBase64); + } + + try (DataInputStream in = new DataInputStream(new ByteArrayInputStream(bytes))) { + int version = in.readInt(); + if (version != VERSION) { + throw new IllegalStateException("unsupported admin result payload version " + version); + } + String operationId = readString(in); + boolean dryRun = in.readBoolean(); + int affected = in.readInt(); + Optional notificationId = + readOptionalUuid(in).map(NotificationId::new); + Optional recipientDeliveryId = + readOptionalUuid(in).map(RecipientDeliveryId::new); + Optional newAttemptId = + readOptionalUuid(in).map(DeliveryAttemptId::new); + int reasonCount = in.readInt(); + if (reasonCount < 0 || reasonCount > 1_000) { + throw new IllegalStateException("stored admin result reason count is out of bounds"); + } + List reasons = new ArrayList<>(reasonCount); + for (int index = 0; index < reasonCount; index++) { + reasons.add(readString(in)); + } + if (in.available() != 0) { + throw new IllegalStateException("stored admin result payload contains trailing bytes"); + } + return new AdminOperationResult( + operationId, + dryRun, + affected, + notificationId, + recipientDeliveryId, + newAttemptId, + reasons); + } catch (IOException malformed) { + throw new IllegalStateException("stored admin result payload is truncated", malformed); + } + } + + private static void writeOptionalUuid(DataOutputStream out, Optional value) + throws IOException { + out.writeBoolean(value.isPresent()); + if (value.isPresent()) { + UUID uuid = value.orElseThrow(); + out.writeLong(uuid.getMostSignificantBits()); + out.writeLong(uuid.getLeastSignificantBits()); + } + } + + private static Optional readOptionalUuid(DataInputStream in) throws IOException { + if (!in.readBoolean()) { + return Optional.empty(); + } + return Optional.of(new UUID(in.readLong(), in.readLong())); + } + + private static void writeString(DataOutputStream out, String value) throws IOException { + byte[] bytes = value.getBytes(StandardCharsets.UTF_8); + if (bytes.length > MAX_FIELD_BYTES) { + throw new IllegalArgumentException("admin result field is too large"); + } + out.writeInt(bytes.length); + out.write(bytes); + } + + private static String readString(DataInputStream in) throws IOException { + int length = in.readInt(); + if (length < 0 || length > MAX_FIELD_BYTES) { + throw new IllegalStateException("stored admin result field length is out of bounds"); + } + byte[] bytes = in.readNBytes(length); + if (bytes.length != length) { + throw new IllegalStateException("stored admin result field is truncated"); + } + return new String(bytes, StandardCharsets.UTF_8); + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/ConsentJpaRepository.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/ConsentJpaRepository.java index 5fd221ba..1c42bace 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/ConsentJpaRepository.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/ConsentJpaRepository.java @@ -2,7 +2,7 @@ package dev.caskeleton.adapter.outbound.persistence.notification.platform; import java.util.List; import java.util.UUID; -import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.repository.Repository; /* * Top-level, not nested inside a holder class. Spring Data does not discover nested repository @@ -14,7 +14,10 @@ import org.springframework.data.jpa.repository.JpaRepository; */ /** Recorded consent decisions. */ -public interface ConsentJpaRepository extends JpaRepository { +public interface ConsentJpaRepository extends Repository { + + // Explicitly exposed base operations only; no inherited tenant-blind CRUD surface. + ConsentEntity saveAndFlush(ConsentEntity entity); /** Consent history for a recipient. */ List findByTenantIdAndRecipientRefOrderByRecordedAtAsc( diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/ContactPointJpaRepository.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/ContactPointJpaRepository.java index d26b75ab..f12aab2d 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/ContactPointJpaRepository.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/ContactPointJpaRepository.java @@ -2,10 +2,13 @@ package dev.caskeleton.adapter.outbound.persistence.notification.platform; import java.util.Optional; import java.util.UUID; -import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.repository.Repository; /** Contact point repository. Every finder carries the tenant boundary. */ -public interface ContactPointJpaRepository extends JpaRepository { +public interface ContactPointJpaRepository extends Repository { + + // Explicitly exposed base operations only; no inherited tenant-blind CRUD surface. + ContactPointEntity saveAndFlush(ContactPointEntity entity); /** Identity lookup inside one tenant. */ Optional findByTenantIdAndId(String tenantId, UUID id); diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/DeduplicationClaimJpaRepository.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/DeduplicationClaimJpaRepository.java index feee7b00..cf526136 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/DeduplicationClaimJpaRepository.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/DeduplicationClaimJpaRepository.java @@ -2,9 +2,9 @@ package dev.caskeleton.adapter.outbound.persistence.notification.platform; import java.util.Optional; import java.util.UUID; -import org.springframework.data.jpa.repository.JpaRepository; import org.springframework.data.jpa.repository.Modifying; import org.springframework.data.jpa.repository.Query; +import org.springframework.data.repository.Repository; import org.springframework.data.repository.query.Param; /* @@ -18,7 +18,7 @@ import org.springframework.data.repository.query.Param; /** Per-window deduplication claims. */ public interface DeduplicationClaimJpaRepository - extends JpaRepository { + extends Repository { /** Existing claim for one window. */ Optional diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/JdbcReconciliationJobStore.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/JdbcReconciliationJobStore.java index 778d608d..d2e7dae3 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/JdbcReconciliationJobStore.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/JdbcReconciliationJobStore.java @@ -5,6 +5,7 @@ import dev.caskeleton.application.notification.platform.api.ProviderProfileId; import dev.caskeleton.application.notification.platform.dispatch.ReconciliationJob; import dev.caskeleton.application.notification.platform.dispatch.ReconciliationJobStorePort; import java.sql.Timestamp; +import java.time.Clock; import java.time.Instant; import java.util.List; import java.util.Objects; @@ -75,14 +76,17 @@ public final class JdbcReconciliationJobStore implements ReconciliationJobStoreP rows.getTimestamp("updated_at").toInstant()); private final JdbcOperations jdbc; + private final Clock clock; /** * Creates the store. * * @param jdbc the database + * @param clock the time source for durable timestamps */ - public JdbcReconciliationJobStore(JdbcOperations jdbc) { + public JdbcReconciliationJobStore(JdbcOperations jdbc, Clock clock) { this.jdbc = Objects.requireNonNull(jdbc, "jdbc"); + this.clock = Objects.requireNonNull(clock, "clock"); } @Override @@ -91,7 +95,7 @@ public final class JdbcReconciliationJobStore implements ReconciliationJobStoreP Objects.requireNonNull(attemptId, "attemptId"); Objects.requireNonNull(providerProfileId, "providerProfileId"); Objects.requireNonNull(dueAt, "dueAt"); - Timestamp now = Timestamp.from(Instant.now()); + Timestamp now = Timestamp.from(clock.instant()); List scheduled = jdbc.query( SCHEDULE, @@ -128,7 +132,7 @@ public final class JdbcReconciliationJobStore implements ReconciliationJobStoreP // so a long provider message truncated by the driver is worse than one truncated here. result == null ? null : result.substring(0, Math.min(result.length(), 40)), Timestamp.from(nextCheckAt), - Timestamp.from(Instant.now()), + Timestamp.from(clock.instant()), job.id()); } diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/JpaAdminOperationStore.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/JpaAdminOperationStore.java index 6f1a1287..6e75ab53 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/JpaAdminOperationStore.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/JpaAdminOperationStore.java @@ -20,6 +20,7 @@ public final class JpaAdminOperationStore implements AdminOperationStorePort { private final AdminAuditJpaRepository audits; private final NotificationIdGeneratorPort ids; private final Clock clock; + private final AdminOperationResultPayloadCodec results = new AdminOperationResultPayloadCodec(); public JpaAdminOperationStore( AdminAuditJpaRepository audits, NotificationIdGeneratorPort ids, Clock clock) { @@ -75,17 +76,16 @@ public final class JpaAdminOperationStore implements AdminOperationStorePort { public Optional findByOperationId(String operationId) { Objects.requireNonNull(operationId, "operationId"); return audits - .findByOperationId(operationId) + .findCompletedByOperationId(operationId) .map( - entity -> - new AdminOperationResult( - entity.operationId(), - entity.dryRun(), - 0, - Optional.empty(), - Optional.empty(), - Optional.empty(), - List.of("REPLAYED"))); + entity -> { + AdminOperationResult result = results.decode(entity.attributes()); + if (!operationId.equals(result.operationId())) { + throw new IllegalStateException( + "stored admin result operation id does not match its audit row"); + } + return result; + }); } @Override @@ -93,17 +93,20 @@ public final class JpaAdminOperationStore implements AdminOperationStorePort { Objects.requireNonNull(result, "result"); Objects.requireNonNull(actor, "actor"); Objects.requireNonNull(action, "action"); - audits.saveAndFlush( - new AdminAuditEntity( - ids.nextId(), + int completed = + audits.completeOperation( result.operationId(), action, actor.actorRef(), result.reasonCodes().isEmpty() ? null : result.reasonCodes().get(0), actor.tenantId().map(tenant -> tenant.value()).orElse(null), - "{}", result.dryRun(), - clock.instant())); + results.encode(result), + clock.instant()); + if (completed != 1) { + throw new IllegalStateException( + "admin operation result cannot complete a missing or non-claimed operation"); + } return result; } } diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/JpaDeliveryAttemptStore.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/JpaDeliveryAttemptStore.java index 9f375322..b9fe384d 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/JpaDeliveryAttemptStore.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/JpaDeliveryAttemptStore.java @@ -158,22 +158,24 @@ public final class JpaDeliveryAttemptStore return attempts .findById(attemptId.value()) .map( - entity -> - new DeliveryProjection( - toRecord(entity).submissionOutcome(), - toRecord(entity).deliveryOutcome(), - toRecord(entity).evidenceLevel(), - new dev.caskeleton.application.notification.platform.callback.EngagementFacts( - entity.engagementOpened(), - entity.engagementClicked(), - entity.engagementRead(), - Optional.ofNullable(entity.engagementLastAt())), - new dev.caskeleton.application.notification.platform.callback.SuppressionFacts( - entity.suppressionHardBounced(), - entity.suppressionComplained(), - entity.suppressionProviderSuppressed(), - entity.suppressionUserOptedOut(), - entity.suppressionInvalidTarget()))) + entity -> { + DeliveryAttemptRecord record = toRecord(entity); + return new DeliveryProjection( + record.submissionOutcome(), + record.deliveryOutcome(), + record.evidenceLevel(), + new dev.caskeleton.application.notification.platform.callback.EngagementFacts( + entity.engagementOpened(), + entity.engagementClicked(), + entity.engagementRead(), + Optional.ofNullable(entity.engagementLastAt())), + new dev.caskeleton.application.notification.platform.callback.SuppressionFacts( + entity.suppressionHardBounced(), + entity.suppressionComplained(), + entity.suppressionProviderSuppressed(), + entity.suppressionUserOptedOut(), + entity.suppressionInvalidTarget())); + }) .orElseGet(DeliveryProjection::empty); } diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/JpaProviderEventLedger.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/JpaProviderEventLedger.java index 9f8b5c5a..caae1018 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/JpaProviderEventLedger.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/JpaProviderEventLedger.java @@ -1,11 +1,11 @@ package dev.caskeleton.adapter.outbound.persistence.notification.platform; import dev.caskeleton.application.notification.platform.api.DeliveryAttemptId; +import dev.caskeleton.application.notification.platform.api.NormalizedEventType; +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; import dev.caskeleton.application.notification.platform.api.ProviderProfileId; import dev.caskeleton.application.notification.platform.callback.AppendEventResult; import dev.caskeleton.application.notification.platform.callback.DeliveryAttemptResolverPort; -import dev.caskeleton.application.notification.platform.callback.NormalizedEventType; -import dev.caskeleton.application.notification.platform.callback.NormalizedProviderEvent; import dev.caskeleton.application.notification.platform.callback.ProjectionResult; import dev.caskeleton.application.notification.platform.callback.ProjectionStatus; import dev.caskeleton.application.notification.platform.callback.ProviderEventLedger; diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/JpaTemplateRegistry.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/JpaTemplateRegistry.java index 33e89dc0..9c098ef1 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/JpaTemplateRegistry.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/JpaTemplateRegistry.java @@ -16,6 +16,7 @@ import dev.caskeleton.application.notification.platform.template.TemplateStatus; import dev.caskeleton.application.notification.platform.template.TemplateVersionConflictException; import dev.caskeleton.application.notification.platform.template.VariableSchema; import java.time.Clock; +import java.time.Instant; import java.util.List; import java.util.Locale; import java.util.Objects; @@ -61,18 +62,13 @@ public final class JpaTemplateRegistry implements TemplateRegistry { public NotificationTemplateVersion get(TemplateSelection selection) { Objects.requireNonNull(selection, "selection"); TenantId tenant = tenants.currentTenant(); - // A pinned selection names no channel, so every channel is probed; the coordinate is unique - // across channels in practice, and probing is cheaper than forcing callers to carry one. - return java.util.Arrays.stream(Channel.values()) - .map( - channel -> - versions.findByTenantIdAndTemplateIdAndVersionAndChannelAndLocale( - tenant.value(), - selection.templateId(), - selection.version(), - channel.name(), - selection.locale().toLanguageTag())) - .flatMap(Optional::stream) + return versions + .findPinned( + tenant.value(), + selection.templateId(), + selection.version(), + selection.locale().toLanguageTag()) + .stream() .findFirst() .map(this::toVersion) .orElseThrow(JpaTemplateRegistry::notFound); @@ -150,11 +146,16 @@ public final class JpaTemplateRegistry implements TemplateRegistry { public void disable(String templateId, long version) { Objects.requireNonNull(templateId, "templateId"); TenantId tenant = tenants.currentTenant(); + Instant disabledAt = clock.instant(); for (Channel channel : Channel.values()) { versions .findByTenantIdAndTemplateIdAndVersionAndChannel( tenant.value(), templateId, version, channel.name()) - .forEach(entity -> entity.disable(clock.instant())); + .forEach( + entity -> { + entity.disable(disabledAt); + versions.saveAndFlush(entity); + }); } } diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/PreferenceJpaRepository.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/PreferenceJpaRepository.java index 8c8ad5e2..b04c9d7b 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/PreferenceJpaRepository.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/PreferenceJpaRepository.java @@ -2,7 +2,7 @@ package dev.caskeleton.adapter.outbound.persistence.notification.platform; import java.util.Optional; import java.util.UUID; -import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.repository.Repository; /* * Top-level, not nested inside a holder class. Spring Data does not discover nested repository @@ -14,7 +14,10 @@ import org.springframework.data.jpa.repository.JpaRepository; */ /** Recipient channel preferences. */ -public interface PreferenceJpaRepository extends JpaRepository { +public interface PreferenceJpaRepository extends Repository { + + // Explicitly exposed base operations only; no inherited tenant-blind CRUD surface. + PreferenceEntity saveAndFlush(PreferenceEntity entity); /** Preference for a recipient inside a tenant. */ Optional findByTenantIdAndRecipientRef(String tenantId, String recipientRef); diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/RecipientClaimSql.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/RecipientClaimSql.java index ad80da64..7304cf6f 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/RecipientClaimSql.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/RecipientClaimSql.java @@ -72,6 +72,6 @@ public final class RecipientClaimSql { * @return the same statement with {@code ?} in place of every {@code :name} */ public static String positional(String namedSql) { - return namedSql.replaceAll(":[A-Za-z][A-Za-z0-9]*", "?"); + return namedSql.replaceAll("(? { +public interface RecipientDeliveryJpaRepository extends Repository { + + // Explicitly exposed base operations only; no inherited tenant-blind CRUD surface. + java.util.Optional findById(UUID id); + + RecipientDeliveryEntity saveAndFlush(RecipientDeliveryEntity entity); + + java.util.List saveAll(Iterable entities); /** * Jobs of one request, inside a tenant. @@ -70,14 +76,14 @@ public interface RecipientDeliveryJpaRepository @Modifying(clearAutomatically = true, flushAutomatically = true) @Query( value = - "UPDATE notification_recipient_delivery " - + "SET delivery_state = :deliveryState, submission_outcome = :submissionOutcome, " - + "delivery_outcome = :deliveryOutcome, evidence_level = :evidenceLevel, " - + "ambiguous_attempt_exists = :ambiguousAttemptExists, duplicate_risk = :duplicateRisk, " - + "route_cursor = :routeCursor, attempt_count = :attemptCount, " - + "last_failure_category = :lastFailureCategory, next_dispatch_at = :nextDispatchAt, " - + "version = version + 1, updated_at = :now " - + "WHERE id = :id AND lease_owner = :owner AND lease_fence = :fence", + "UPDATE notification_recipient_delivery SET delivery_state = :deliveryState," + + " submission_outcome = :submissionOutcome, delivery_outcome = :deliveryOutcome," + + " evidence_level = :evidenceLevel, ambiguous_attempt_exists =" + + " :ambiguousAttemptExists, duplicate_risk = :duplicateRisk, route_cursor =" + + " :routeCursor, attempt_count = :attemptCount, last_failure_category =" + + " :lastFailureCategory, next_dispatch_at = :nextDispatchAt, version = version + 1," + + " updated_at = :now WHERE id = :id AND lease_owner = :owner AND lease_fence =" + + " :fence", nativeQuery = true) int saveProjectionHeldBy( @Param("id") UUID id, diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/SuppressionJpaRepository.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/SuppressionJpaRepository.java index 5f2e13ed..83ac52cd 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/SuppressionJpaRepository.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/SuppressionJpaRepository.java @@ -4,12 +4,17 @@ import java.time.Instant; import java.util.List; import java.util.Optional; import java.util.UUID; -import org.springframework.data.jpa.repository.JpaRepository; import org.springframework.data.jpa.repository.Query; +import org.springframework.data.repository.Repository; import org.springframework.data.repository.query.Param; /** Suppression repository. */ -public interface SuppressionJpaRepository extends JpaRepository { +public interface SuppressionJpaRepository extends Repository { + + // Explicitly exposed base operations only; no inherited tenant-blind CRUD surface. + SuppressionEntity saveAndFlush(SuppressionEntity entity); + + void delete(SuppressionEntity entity); /** Entries whose window contains the given instant. */ @Query( diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/TemplateVersionJpaRepository.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/TemplateVersionJpaRepository.java index 85eb14ed..1c3f1cf9 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/TemplateVersionJpaRepository.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/TemplateVersionJpaRepository.java @@ -3,7 +3,9 @@ package dev.caskeleton.adapter.outbound.persistence.notification.platform; import java.util.List; import java.util.Optional; import java.util.UUID; -import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.jpa.repository.Query; +import org.springframework.data.repository.Repository; +import org.springframework.data.repository.query.Param; /* * Top-level, not nested inside a holder class. Spring Data does not discover nested repository @@ -15,12 +17,34 @@ import org.springframework.data.jpa.repository.JpaRepository; */ /** Rendered template versions by coordinate. */ -public interface TemplateVersionJpaRepository extends JpaRepository { +public interface TemplateVersionJpaRepository extends Repository { + + // Explicitly exposed base operations only; no inherited tenant-blind CRUD surface. + TemplateVersionEntity saveAndFlush(TemplateVersionEntity entity); /** Exact coordinate lookup. */ Optional findByTenantIdAndTemplateIdAndVersionAndChannelAndLocale( String tenantId, String templateId, long version, String channel, String locale); + /** + * Pinned lookup when the application selection has not yet chosen a channel. + * + *

The CASE order preserves the historical {@code Channel.values()} preference without issuing + * one query per channel. + */ + @Query( + "SELECT t FROM TemplateVersionEntity t " + + "WHERE t.tenantId = :tenantId AND t.templateId = :templateId " + + "AND t.version = :version AND t.locale = :locale " + + "ORDER BY CASE t.channel " + + "WHEN 'EMAIL' THEN 0 WHEN 'SMS' THEN 1 WHEN 'PUSH' THEN 2 " + + "WHEN 'WEB_PUSH' THEN 3 WHEN 'IN_APP' THEN 4 WHEN 'WEBHOOK' THEN 5 ELSE 99 END") + List findPinned( + @Param("tenantId") String tenantId, + @Param("templateId") String templateId, + @Param("version") long version, + @Param("locale") String locale); + /** Every locale of one version, for the fallback chain. */ List findByTenantIdAndTemplateIdAndVersionAndChannel( String tenantId, String templateId, long version, String channel); diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/inbox/InboxItemJpaRepository.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/inbox/InboxItemJpaRepository.java index 3f844710..4c62e94d 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/inbox/InboxItemJpaRepository.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/inbox/InboxItemJpaRepository.java @@ -4,13 +4,16 @@ import java.time.Instant; import java.util.List; import java.util.Optional; import java.util.UUID; -import org.springframework.data.jpa.repository.JpaRepository; import org.springframework.data.jpa.repository.Modifying; import org.springframework.data.jpa.repository.Query; +import org.springframework.data.repository.Repository; import org.springframework.data.repository.query.Param; /** Inbox repository with keyset pagination and a row-derived unread count. */ -public interface InboxItemJpaRepository extends JpaRepository { +public interface InboxItemJpaRepository extends Repository { + + // Explicit persistence write; broad CRUD methods are intentionally not inherited. + InboxItemEntity saveAndFlush(InboxItemEntity entity); /** Ownership-scoped lookup. */ Optional findByTenantIdAndOwnerRefAndId( diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/inbox/JpaNotificationInbox.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/inbox/JpaNotificationInbox.java index 19c98241..7cf44901 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/inbox/JpaNotificationInbox.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/inbox/JpaNotificationInbox.java @@ -82,6 +82,7 @@ public final class JpaNotificationInbox implements NotificationInbox { public InboxPage list(InboxQuery query) { Objects.requireNonNull(query, "query"); String states = stateArray(query); + int fetchLimit = Math.addExact(query.limit(), 1); List rows = query .after() @@ -93,20 +94,19 @@ public final class JpaNotificationInbox implements NotificationInbox { states, cursor.createdAt(), cursor.id(), - query.limit())) + fetchLimit)) .orElseGet( () -> items.firstPage( query.principal().tenantId().value(), query.principal().ownerRef(), states, - query.limit())); + fetchLimit)); - List mapped = rows.stream().map(this::toItem).toList(); + boolean hasNext = rows.size() > query.limit(); + List mapped = rows.stream().limit(query.limit()).map(this::toItem).toList(); Optional next = - mapped.size() < query.limit() - ? Optional.empty() - : Optional.of(mapped.get(mapped.size() - 1).cursor()); + hasNext ? Optional.of(mapped.get(mapped.size() - 1).cursor()) : Optional.empty(); return new InboxPage(mapped, next); } diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/operation/DurableOperationStoreAdapter.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/operation/DurableOperationStoreAdapter.java index 97d1dc0a..30deb1c7 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/operation/DurableOperationStoreAdapter.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/operation/DurableOperationStoreAdapter.java @@ -16,7 +16,7 @@ import java.util.List; import java.util.Optional; import org.springframework.dao.DataIntegrityViolationException; import org.springframework.stereotype.Repository; -import org.springframework.transaction.annotation.Transactional; +import org.springframework.transaction.support.TransactionSynchronizationManager; /** * The PostgreSQL-backed {@link DurableOperationStorePort}. @@ -41,8 +41,8 @@ public class DurableOperationStoreAdapter implements DurableOperationStorePort { } @Override - @Transactional public DurableOperation submit(DurableOperationSubmission submission) { + requireCallerTransaction("submit"); String tenant = submission.tenantId() == null ? "" : submission.tenantId(); try { DurableOperationEntity saved = @@ -79,7 +79,6 @@ public class DurableOperationStoreAdapter implements DurableOperationStorePort { } @Override - @Transactional(readOnly = true) public Optional find( DurableOperationId operationId, String principal, Instant now) { return repository @@ -89,9 +88,9 @@ public class DurableOperationStoreAdapter implements DurableOperationStorePort { } @Override - @Transactional public Optional claimNext( String workerId, Duration leaseDuration, Instant now) { + requireCallerTransaction("claimNext"); List claimed = repository.claimNext(workerId, now.plus(leaseDuration), now); if (claimed.isEmpty()) { return Optional.empty(); @@ -112,16 +111,16 @@ public class DurableOperationStoreAdapter implements DurableOperationStorePort { } @Override - @Transactional public boolean heartbeat( DurableOperationId operationId, String workerId, Duration leaseDuration, Instant now) { + requireCallerTransaction("heartbeat"); return repository.heartbeat(operationId.value(), workerId, now.plus(leaseDuration), now) == 1; } @Override - @Transactional public boolean reportProgress( DurableOperationId operationId, String workerId, OperationProgressSnapshot progress) { + requireCallerTransaction("reportProgress"); return repository.reportProgress( operationId.value(), workerId, @@ -132,22 +131,22 @@ public class DurableOperationStoreAdapter implements DurableOperationStorePort { } @Override - @Transactional public boolean succeed( DurableOperationId operationId, String workerId, String resultReference, Instant completedAt) { + requireCallerTransaction("succeed"); return repository.succeed(operationId.value(), workerId, resultReference, completedAt) == 1; } @Override - @Transactional public boolean fail( DurableOperationId operationId, String workerId, OperationFailure failure, Instant completedAt) { + requireCallerTransaction("fail"); return repository.fail( operationId.value(), workerId, @@ -159,23 +158,30 @@ public class DurableOperationStoreAdapter implements DurableOperationStorePort { } @Override - @Transactional public boolean cancel(DurableOperationId operationId, String principal, Instant canceledAt) { + requireCallerTransaction("cancel"); return repository.cancel(operationId.value(), principal, canceledAt) == 1; } @Override - @Transactional public List reclaimExpiredLeases(Instant now) { + requireCallerTransaction("reclaimExpiredLeases"); return repository.reclaimExpiredLeases(now).stream().map(DurableOperationId::new).toList(); } @Override - @Transactional public List expireStaleOperations(Instant now) { + requireCallerTransaction("expireStaleOperations"); return repository.expireStaleOperations(now).stream().map(DurableOperationId::new).toList(); } + private static void requireCallerTransaction(String operation) { + if (!TransactionSynchronizationManager.isActualTransactionActive()) { + throw new IllegalStateException( + "durable operation " + operation + " requires an active caller transaction"); + } + } + private static DurableOperation expireIfStale(DurableOperation operation, Instant now) { // Reported as EXPIRED on read even before the sweeper has run. A poller asking after the TTL // must not be shown RUNNING for a record nothing will ever advance again. diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxReaper.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxReaper.java index e21db4a2..1fcf92c7 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxReaper.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxReaper.java @@ -5,6 +5,7 @@ import java.time.Duration; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.beans.factory.annotation.Value; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; import org.springframework.scheduling.annotation.Scheduled; import org.springframework.stereotype.Component; import org.springframework.transaction.annotation.Transactional; @@ -14,6 +15,7 @@ import org.springframework.transaction.annotation.Transactional; * table growth. See README "outbox" for retention/scheduling rationale. */ @Component +@ConditionalOnProperty(prefix = "ca-skeleton.outbox", name = "enabled", havingValue = "true") public class OutboxReaper { private static final Logger log = LoggerFactory.getLogger(OutboxReaper.class); diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxStoreAdapter.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxStoreAdapter.java index 37c0692f..097bf024 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxStoreAdapter.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxStoreAdapter.java @@ -27,7 +27,9 @@ import java.util.HexFormat; import java.util.List; import java.util.Map; import java.util.Optional; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; import org.springframework.stereotype.Repository; +import org.springframework.transaction.support.TransactionSynchronizationManager; /** * JPA-backed {@link LegacyOutboxAppendPort} + {@link OutboxStorePort}. {@link #append} and the @@ -37,6 +39,7 @@ import org.springframework.stereotype.Repository; * contracts. */ @Repository +@ConditionalOnProperty(prefix = "ca-skeleton.outbox", name = "enabled", havingValue = "true") public class OutboxStoreAdapter implements LegacyOutboxAppendPort, OutboxStorePort { private final OutboxEventJpaRepository repository; @@ -50,6 +53,7 @@ public class OutboxStoreAdapter implements LegacyOutboxAppendPort, OutboxStorePo @Override public void append(NewOutboxEvent event) { + requireTransaction("append"); OutboxEventEntity entity = new OutboxEventEntity(); entity.setEventId(event.eventId()); entity.setAggregateId(event.aggregateId()); @@ -67,6 +71,7 @@ public class OutboxStoreAdapter implements LegacyOutboxAppendPort, OutboxStorePo @Override public List claimBatch(int batchSize, Instant now, Duration inFlightTimeout) { + requireTransaction("claimBatch"); List eligible = claimRepository.claimEligible(now, batchSize); return eligible.stream() .map( @@ -86,6 +91,7 @@ public class OutboxStoreAdapter implements LegacyOutboxAppendPort, OutboxStorePo */ @Override public void markPublished(String eventId) { + requireTransaction("markPublished"); repository .findById(eventId) .orElseThrow(() -> new IllegalStateException("outbox row not found for eventId=" + eventId)) @@ -98,6 +104,7 @@ public class OutboxStoreAdapter implements LegacyOutboxAppendPort, OutboxStorePo */ @Override public void markFailed(String eventId, Instant nextAttemptAt) { + requireTransaction("markFailed"); OutboxEventEntity entity = repository .findById(eventId) @@ -113,12 +120,20 @@ public class OutboxStoreAdapter implements LegacyOutboxAppendPort, OutboxStorePo */ @Override public void markDead(String eventId) { + requireTransaction("markDead"); repository .findById(eventId) .orElseThrow(() -> new IllegalStateException("outbox row not found for eventId=" + eventId)) .setStatus(OutboxEventStatus.DEAD.name()); } + private static void requireTransaction(String operation) { + if (!TransactionSynchronizationManager.isActualTransactionActive()) { + throw new IllegalStateException( + "outbox " + operation + " requires an active caller transaction"); + } + } + @Override public Map countByStatus() { List rows = repository.countGroupedByStatus(); diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/PostgreSqlSqlStateErrorMapping.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/PostgreSqlSqlStateErrorMapping.java index f44cea4a..49908953 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/PostgreSqlSqlStateErrorMapping.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/PostgreSqlSqlStateErrorMapping.java @@ -13,6 +13,7 @@ public class PostgreSqlSqlStateErrorMapping implements SqlStateErrorMapping { private static final Map MAPPINGS = Map.of( "40P01", OperationalError.DB_DEADLOCK, + "55P03", OperationalError.DB_LOCK_TIMEOUT, "25P03", OperationalError.DB_IDLE_IN_TX_TIMEOUT, "57014", OperationalError.DB_QUERY_CANCELED); diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/idempotency/PostgreSqlOwnerSafeIdempotencyStore.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/idempotency/PostgreSqlOwnerSafeIdempotencyStore.java index dad9804e..dc576383 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/idempotency/PostgreSqlOwnerSafeIdempotencyStore.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/idempotency/PostgreSqlOwnerSafeIdempotencyStore.java @@ -55,8 +55,8 @@ import org.springframework.jdbc.core.JdbcOperations; * regardless of which idempotency provider was selected: {@code provider=jdbc} would acquire an * owner-safe V2 store it never asked for, and {@code provider=redis} a second one beside its own. * Both counts are what {@code IdempotencyProviderSelectionConfig} refuses, so a scan-registered - * store means neither selection can start. The composition root builds it for {@code - * provider=postgresql} and only there. + * store means neither selection can start. The persistence leaf composition root builds it for + * {@code provider=postgresql} and only while the JPA capability is enabled. */ public class PostgreSqlOwnerSafeIdempotencyStore implements IdempotencyStorePortV2 { diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/inbox/PostgreSqlSameStoreInboxAdapter.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/inbox/PostgreSqlSameStoreInboxAdapter.java index 13986367..e864e67d 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/inbox/PostgreSqlSameStoreInboxAdapter.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/inbox/PostgreSqlSameStoreInboxAdapter.java @@ -10,6 +10,7 @@ import dev.caskeleton.application.inbox.InboxState; import dev.caskeleton.application.inbox.InboxStorePort; import dev.caskeleton.application.inbox.InboxTransitionOutcome; import dev.caskeleton.application.transaction.OperationId; +import java.nio.ByteBuffer; import java.nio.charset.StandardCharsets; import java.security.MessageDigest; import java.security.NoSuchAlgorithmException; @@ -24,7 +25,6 @@ import java.util.List; import java.util.Objects; import java.util.Optional; import javax.sql.DataSource; -import org.springframework.beans.factory.annotation.Autowired; import org.springframework.jdbc.core.JdbcOperations; import org.springframework.jdbc.core.JdbcTemplate; import org.springframework.transaction.support.TransactionSynchronizationManager; @@ -200,7 +200,6 @@ public class PostgreSqlSameStoreInboxAdapter implements InboxStorePort { private final JdbcOperations jdbc; private final SecureRandom secureRandom; - @Autowired public PostgreSqlSameStoreInboxAdapter(DataSource dataSource) { this(dataSource, new JdbcTemplate(dataSource), new SecureRandom()); } @@ -414,7 +413,7 @@ public class PostgreSqlSameStoreInboxAdapter implements InboxStorePort { } private void expireProcessing(InboxRow row) { - String resultDigest = sha256("EXPIRED_PROCESSING|" + row.claimOperationId()); + String resultDigest = digestFields("EXPIRED_PROCESSING", row.claimOperationId()); int updated = jdbc.update( EXPIRE_PROCESSING_SQL, @@ -549,23 +548,23 @@ public class PostgreSqlSameStoreInboxAdapter implements InboxStorePort { } private static String transitionDigest(String kind, OperationId operationId, InboxOwner owner) { - return sha256( - kind - + '|' - + operationId.value() - + '|' - + owner.ownerToken() - + '|' - + owner.attempt() - + '|' - + owner.stateRevision()); + return digestFields( + kind, + operationId.value(), + owner.ownerToken(), + Long.toString(owner.attempt()), + Long.toString(owner.stateRevision())); } - private static String sha256(String value) { + static String digestFields(String... fields) { try { - return HexFormat.of() - .formatHex( - MessageDigest.getInstance("SHA-256").digest(value.getBytes(StandardCharsets.UTF_8))); + MessageDigest digest = MessageDigest.getInstance("SHA-256"); + for (String field : fields) { + byte[] bytes = Objects.toString(field, "").getBytes(StandardCharsets.UTF_8); + digest.update(ByteBuffer.allocate(Integer.BYTES).putInt(bytes.length).array()); + digest.update(bytes); + } + return HexFormat.of().formatHex(digest.digest()); } catch (NoSuchAlgorithmException exception) { throw new IllegalStateException("SHA-256 unavailable", exception); } diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/outbox/CanonicalOutboxEventRowMapper.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/outbox/CanonicalOutboxEventRowMapper.java new file mode 100644 index 00000000..7022e5e6 --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/outbox/CanonicalOutboxEventRowMapper.java @@ -0,0 +1,130 @@ +package dev.caskeleton.adapter.outbound.persistence.postgresql.outbox; + +import dev.caskeleton.application.messaging.contract.ContractId; +import dev.caskeleton.application.messaging.contract.LogicalDestinationId; +import dev.caskeleton.application.messaging.contract.Sha256; +import dev.caskeleton.application.messaging.event.AggregateIdentity; +import dev.caskeleton.application.messaging.event.AggregateOrder; +import dev.caskeleton.application.messaging.event.EventId; +import dev.caskeleton.application.messaging.event.ValidatedIntegrationEvent; +import java.nio.ByteBuffer; +import java.nio.charset.CharacterCodingException; +import java.nio.charset.CodingErrorAction; +import java.nio.charset.StandardCharsets; +import java.sql.ResultSet; +import java.sql.SQLException; +import java.time.OffsetDateTime; +import java.util.Arrays; +import java.util.HexFormat; +import java.util.Optional; + +/** Shared fail-closed mapping for canonical rows in the dark owner-safe V2 outbox candidate. */ +final class CanonicalOutboxEventRowMapper { + + private CanonicalOutboxEventRowMapper() {} + + static String compatibilityPayload(ValidatedIntegrationEvent event) { + return strictUtf8(event.envelopeBytes(), event.eventId().value()); + } + + static ValidatedIntegrationEvent read(ResultSet resultSet) throws SQLException { + String eventId = resultSet.getString("event_id"); + byte[] envelopeBytes = resultSet.getBytes("envelope_bytes"); + Integer envelopeVersion = resultSet.getObject("envelope_version", Integer.class); + String tenantScope = resultSet.getString("tenant_scope"); + String schemaSetHash = resultSet.getString("schema_set_hash"); + String envelopeSha256 = resultSet.getString("envelope_sha256"); + String envelopeSchemaHash = resultSet.getString("envelope_schema_hash"); + String payloadSchemaHash = resultSet.getString("payload_schema_hash"); + String contractCatalogRevision = resultSet.getString("contract_catalog_revision"); + String destinationBindingRevision = resultSet.getString("destination_binding_revision"); + + if (envelopeBytes == null + || envelopeVersion == null + || tenantScope == null + || schemaSetHash == null + || envelopeSha256 == null + || envelopeSchemaHash == null + || payloadSchemaHash == null + || contractCatalogRevision == null + || destinationBindingRevision == null) { + throw new IllegalStateException( + "outbox V2 row is pre-canonical or incomplete for eventId=" + eventId); + } + + String payload = resultSet.getString("payload"); + String payloadDigest = resultSet.getString("payload_digest"); + String compatibilityPayload = strictUtf8(envelopeBytes, eventId); + if (!compatibilityPayload.equals(payload) || !envelopeSha256.equals(payloadDigest)) { + throw new IllegalStateException( + "canonical outbox V2 compatibility projection mismatch for eventId=" + eventId); + } + + String traceParent = resultSet.getString("trace_parent"); + if (traceParent != null) { + throw new IllegalStateException( + "canonical outbox V2 row must not invent trace context for eventId=" + eventId); + } + + String partitionKey = resultSet.getString("partition_key"); + try { + return new ValidatedIntegrationEvent( + new EventId(eventId), + new ContractId(resultSet.getString("event_type")), + envelopeVersion, + resultSet.getInt("event_schema"), + new LogicalDestinationId(resultSet.getString("logical_destination")), + new AggregateIdentity( + tenantScope, + resultSet.getString("aggregate_type"), + resultSet.getString("aggregate_id")), + new AggregateOrder( + resultSet.getLong("aggregate_version"), resultSet.getInt("event_ordinal")), + resultSet.getObject("occurred_at", OffsetDateTime.class).toInstant(), + resultSet.getString("correlation_id"), + Optional.ofNullable(resultSet.getString("causation_id")), + partitionKey, + partitionKey.getBytes(StandardCharsets.US_ASCII), + envelopeBytes, + resultSet.getString("content_type"), + digest(schemaSetHash, "schema_set_hash", eventId), + digest(envelopeSha256, "envelope_sha256", eventId), + digest(envelopeSchemaHash, "envelope_schema_hash", eventId), + digest(payloadSchemaHash, "payload_schema_hash", eventId), + contractCatalogRevision, + destinationBindingRevision); + } catch (IllegalArgumentException exception) { + throw new IllegalStateException( + "invalid canonical outbox V2 metadata for eventId=" + eventId, exception); + } + } + + private static Sha256 digest(String hex, String field, String eventId) { + try { + return new Sha256(HexFormat.of().parseHex(hex)); + } catch (IllegalArgumentException exception) { + throw new IllegalStateException( + "invalid " + field + " for canonical outbox V2 eventId=" + eventId, exception); + } + } + + private static String strictUtf8(byte[] bytes, String eventId) { + try { + String decoded = + StandardCharsets.UTF_8 + .newDecoder() + .onMalformedInput(CodingErrorAction.REPORT) + .onUnmappableCharacter(CodingErrorAction.REPORT) + .decode(ByteBuffer.wrap(bytes)) + .toString(); + if (!Arrays.equals(decoded.getBytes(StandardCharsets.UTF_8), bytes)) { + throw new IllegalArgumentException( + "canonical envelope UTF-8 projection does not round-trip for eventId=" + eventId); + } + return decoded; + } catch (CharacterCodingException exception) { + throw new IllegalArgumentException( + "canonical envelope must be valid UTF-8 for eventId=" + eventId, exception); + } + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/outbox/PostgreSqlImmutableOutboxAppendAdapter.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/outbox/PostgreSqlImmutableOutboxAppendAdapter.java index 6ad95156..a1da6cac 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/outbox/PostgreSqlImmutableOutboxAppendAdapter.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/outbox/PostgreSqlImmutableOutboxAppendAdapter.java @@ -1,25 +1,21 @@ package dev.caskeleton.adapter.outbound.persistence.postgresql.outbox; +import dev.caskeleton.application.messaging.event.ValidatedIntegrationEvent; import dev.caskeleton.application.outbox.v2.NewOutboxEventV2; import dev.caskeleton.application.outbox.v2.OutboxAppendOutcome; import dev.caskeleton.application.outbox.v2.OutboxAppendPortV2; import dev.caskeleton.application.outbox.v2.OutboxAppendReceipt; import dev.caskeleton.application.outbox.v2.OutboxDispatchAuthority; import dev.caskeleton.application.outbox.v2.OutboxPublicationAuthority; -import java.nio.charset.StandardCharsets; -import java.security.MessageDigest; -import java.security.NoSuchAlgorithmException; import java.sql.ResultSet; import java.sql.SQLException; import java.time.Instant; import java.time.LocalDate; import java.time.OffsetDateTime; -import java.util.HexFormat; import java.util.List; import java.util.Objects; import java.util.Optional; import javax.sql.DataSource; -import org.springframework.beans.factory.annotation.Autowired; import org.springframework.jdbc.core.JdbcOperations; import org.springframework.jdbc.core.JdbcTemplate; import org.springframework.transaction.support.TransactionSynchronizationManager; @@ -71,6 +67,7 @@ public class PostgreSqlImmutableOutboxAppendAdapter implements OutboxAppendPortV """ insert into outbox_event_identity_v2 ( event_id, + tenant_scope, aggregate_type, aggregate_id, aggregate_version, @@ -78,7 +75,7 @@ public class PostgreSqlImmutableOutboxAppendAdapter implements OutboxAppendPortV retention_bucket, created_at ) - select ?, ?, ?, ?, ?, (db_now at time zone 'UTC')::date, db_now + select ?, ?, ?, ?, ?, ?, (db_now at time zone 'UTC')::date, db_now from (select clock_timestamp() as db_now) authority on conflict do nothing returning retention_bucket, created_at @@ -106,8 +103,17 @@ public class PostgreSqlImmutableOutboxAppendAdapter implements OutboxAppendPortV payload, payload_digest, trace_parent, - created_at - ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, null, ?) + created_at, + tenant_scope, + envelope_version, + envelope_bytes, + schema_set_hash, + envelope_sha256, + envelope_schema_hash, + payload_schema_hash, + contract_catalog_revision, + destination_binding_revision + ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, null, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) """; private static final String FIND_EVENT_SQL = @@ -128,7 +134,18 @@ public class PostgreSqlImmutableOutboxAppendAdapter implements OutboxAppendPortV event.correlation_id, event.causation_id, event.occurred_at, - event.payload_digest + event.payload, + event.payload_digest, + event.trace_parent, + event.tenant_scope, + event.envelope_version, + event.envelope_bytes, + event.schema_set_hash, + event.envelope_sha256, + event.envelope_schema_hash, + event.payload_schema_hash, + event.contract_catalog_revision, + event.destination_binding_revision from outbox_event_identity_v2 identity left join outbox_event_log_v2 event on event.event_id = identity.event_id @@ -140,7 +157,8 @@ public class PostgreSqlImmutableOutboxAppendAdapter implements OutboxAppendPortV """ select event_id from outbox_event_identity_v2 - where aggregate_type = ? + where tenant_scope = ? + and aggregate_type = ? and aggregate_id = ? and aggregate_version = ? and event_ordinal = ? @@ -149,7 +167,6 @@ public class PostgreSqlImmutableOutboxAppendAdapter implements OutboxAppendPortV private final DataSource dataSource; private final JdbcOperations jdbc; - @Autowired public PostgreSqlImmutableOutboxAppendAdapter(DataSource dataSource) { this(dataSource, new JdbcTemplate(dataSource)); } @@ -163,6 +180,8 @@ public class PostgreSqlImmutableOutboxAppendAdapter implements OutboxAppendPortV public OutboxAppendReceipt append(NewOutboxEventV2 event) { Objects.requireNonNull(event, "event"); requireSameResourcePrimaryWriteTransaction(); + ValidatedIntegrationEvent canonical = event.event(); + String compatibilityPayload = CanonicalOutboxEventRowMapper.compatibilityPayload(canonical); requireActiveCapability(); PublicationControl control = lockPublicationControl(); OutboxDispatchAuthority dispatchAuthority = dispatchAuthority(control.authority()); @@ -175,6 +194,7 @@ public class PostgreSqlImmutableOutboxAppendAdapter implements OutboxAppendPortV resultSet.getObject("retention_bucket", LocalDate.class), resultSet.getObject("created_at", OffsetDateTime.class).toInstant()), event.eventId(), + event.event().aggregate().tenantScope(), event.aggregateType(), event.aggregateId(), event.aggregateVersion(), @@ -184,7 +204,6 @@ public class PostgreSqlImmutableOutboxAppendAdapter implements OutboxAppendPortV return classifyExisting(event); } IdentityInsert identity = inserted.getFirst(); - String payloadDigest = sha256(event.payload()); int envelopeInserted = jdbc.update( INSERT_EVENT_SQL, @@ -204,9 +223,18 @@ public class PostgreSqlImmutableOutboxAppendAdapter implements OutboxAppendPortV event.correlationId(), event.causationId(), OffsetDateTime.ofInstant(event.occurredAt(), java.time.ZoneOffset.UTC), - event.payload(), - payloadDigest, - OffsetDateTime.ofInstant(identity.createdAt(), java.time.ZoneOffset.UTC)); + compatibilityPayload, + canonical.envelopeSha256().toString(), + OffsetDateTime.ofInstant(identity.createdAt(), java.time.ZoneOffset.UTC), + canonical.aggregate().tenantScope(), + canonical.envelopeVersion(), + canonical.envelopeBytes(), + canonical.schemaSetHash().toString(), + canonical.envelopeSha256().toString(), + canonical.envelopeSchemaHash().toString(), + canonical.payloadSchemaHash().toString(), + canonical.contractCatalogRevision(), + canonical.destinationBindingRevision()); if (envelopeInserted != 1) { throw new IllegalStateException("immutable outbox event envelope insert affected no row"); } @@ -238,6 +266,7 @@ public class PostgreSqlImmutableOutboxAppendAdapter implements OutboxAppendPortV jdbc.query( FIND_ORDERING_IDENTITY_SQL, (resultSet, rowNumber) -> resultSet.getString("event_id"), + requested.event().aggregate().tenantScope(), requested.aggregateType(), requested.aggregateId(), requested.aggregateVersion(), @@ -270,23 +299,10 @@ public class PostgreSqlImmutableOutboxAppendAdapter implements OutboxAppendPortV "outbox identity exists without its same-transaction immutable envelope"); } return new StoredEvent( - resultSet.getString("event_id"), - resultSet.getString("aggregate_type"), - resultSet.getString("aggregate_id"), - resultSet.getLong("aggregate_version"), - resultSet.getInt("event_ordinal"), + CanonicalOutboxEventRowMapper.read(resultSet), resultSet.getObject("retention_bucket", LocalDate.class), - resultSet.getString("event_type"), - resultSet.getInt("event_schema"), - resultSet.getString("logical_destination"), - resultSet.getString("partition_key"), resultSet.getLong("publication_epoch"), - OutboxDispatchAuthority.valueOf(dispatch), - resultSet.getString("content_type"), - resultSet.getString("correlation_id"), - resultSet.getString("causation_id"), - resultSet.getObject("occurred_at", OffsetDateTime.class).toInstant(), - resultSet.getString("payload_digest")); + OutboxDispatchAuthority.valueOf(dispatch)); } private PublicationControl lockPublicationControl() { @@ -340,29 +356,7 @@ public class PostgreSqlImmutableOutboxAppendAdapter implements OutboxAppendPortV } private static boolean sameIntent(StoredEvent stored, NewOutboxEventV2 requested) { - return stored.aggregateType().equals(requested.aggregateType()) - && stored.aggregateId().equals(requested.aggregateId()) - && stored.aggregateVersion() == requested.aggregateVersion() - && stored.eventOrdinal() == requested.eventOrdinal() - && stored.eventType().equals(requested.eventType()) - && stored.eventSchema() == requested.eventSchema() - && stored.logicalDestination().equals(requested.logicalDestination()) - && stored.partitionKey().equals(requested.partitionKey()) - && stored.contentType().equals(requested.contentType()) - && stored.correlationId().equals(requested.correlationId()) - && Objects.equals(stored.causationId(), requested.causationId()) - && stored.occurredAt().equals(requested.occurredAt()) - && stored.payloadDigest().equals(sha256(requested.payload())); - } - - private static String sha256(String value) { - try { - return HexFormat.of() - .formatHex( - MessageDigest.getInstance("SHA-256").digest(value.getBytes(StandardCharsets.UTF_8))); - } catch (NoSuchAlgorithmException exception) { - throw new IllegalStateException("SHA-256 unavailable", exception); - } + return stored.event().equals(requested.event()); } private record PublicationControl(long activeEpoch, OutboxPublicationAuthority authority) {} @@ -370,21 +364,13 @@ public class PostgreSqlImmutableOutboxAppendAdapter implements OutboxAppendPortV private record IdentityInsert(LocalDate retentionBucket, Instant createdAt) {} private record StoredEvent( - String eventId, - String aggregateType, - String aggregateId, - long aggregateVersion, - int eventOrdinal, + ValidatedIntegrationEvent event, LocalDate retentionBucket, - String eventType, - int eventSchema, - String logicalDestination, - String partitionKey, long publicationEpoch, - OutboxDispatchAuthority dispatchAuthority, - String contentType, - String correlationId, - String causationId, - Instant occurredAt, - String payloadDigest) {} + OutboxDispatchAuthority dispatchAuthority) { + + String eventId() { + return event.eventId().value(); + } + } } diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/outbox/PostgreSqlPollingDeliveryAdapter.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/outbox/PostgreSqlPollingDeliveryAdapter.java index fef15d75..13455905 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/outbox/PostgreSqlPollingDeliveryAdapter.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/outbox/PostgreSqlPollingDeliveryAdapter.java @@ -6,6 +6,7 @@ import dev.caskeleton.application.outbox.v2.OutboxDeliveryOwner; import dev.caskeleton.application.outbox.v2.OutboxDeliveryTransition; import dev.caskeleton.application.outbox.v2.OutboxDeliveryTransitionOutcome; import dev.caskeleton.application.outbox.v2.OutboxPollingDeliveryPortV2; +import java.nio.ByteBuffer; import java.nio.charset.StandardCharsets; import java.security.MessageDigest; import java.security.NoSuchAlgorithmException; @@ -21,7 +22,6 @@ import java.util.List; import java.util.Objects; import java.util.regex.Pattern; import javax.sql.DataSource; -import org.springframework.beans.factory.annotation.Autowired; import org.springframework.jdbc.core.JdbcOperations; import org.springframework.jdbc.core.JdbcTemplate; import org.springframework.transaction.support.TransactionSynchronizationManager; @@ -99,6 +99,7 @@ public class PostgreSqlPollingDeliveryAdapter implements OutboxPollingDeliveryPo on prior_event.retention_bucket = prior_delivery.retention_bucket and prior_event.event_id = prior_delivery.event_id where prior_delivery.destination = delivery.destination + and prior_event.tenant_scope = event.tenant_scope and prior_event.aggregate_type = event.aggregate_type and prior_event.aggregate_id = event.aggregate_id and ( @@ -137,8 +138,11 @@ public class PostgreSqlPollingDeliveryAdapter implements OutboxPollingDeliveryPo claimed.attempt, claimed.version, claimed.publication_epoch, + claimed.created_at as delivery_created_at, + event.created_at as event_created_at, event.event_type, event.event_schema, + event.logical_destination, event.aggregate_type, event.aggregate_id, event.aggregate_version, @@ -149,7 +153,17 @@ public class PostgreSqlPollingDeliveryAdapter implements OutboxPollingDeliveryPo event.causation_id, event.occurred_at, event.payload, - event.payload_digest + event.payload_digest, + event.trace_parent, + event.tenant_scope, + event.envelope_version, + event.envelope_bytes, + event.schema_set_hash, + event.envelope_sha256, + event.envelope_schema_hash, + event.payload_schema_hash, + event.contract_catalog_revision, + event.destination_binding_revision from claimed join outbox_event_log_v2 event on event.retention_bucket = claimed.retention_bucket @@ -281,7 +295,6 @@ public class PostgreSqlPollingDeliveryAdapter implements OutboxPollingDeliveryPo private final JdbcOperations jdbc; private final SecureRandom secureRandom; - @Autowired public PostgreSqlPollingDeliveryAdapter(DataSource dataSource) { this(dataSource, new JdbcTemplate(dataSource), new SecureRandom()); } @@ -400,21 +413,17 @@ public class PostgreSqlPollingDeliveryAdapter implements OutboxPollingDeliveryPo resultSet.getInt("attempt"), resultSet.getLong("version"), resultSet.getLong("publication_epoch")); + var event = CanonicalOutboxEventRowMapper.read(resultSet); + if (!owner.destination().equals(event.logicalDestinationId().value())) { + throw new IllegalStateException( + "claimed outbox destination does not match canonical event for eventId=" + + owner.eventId()); + } return new ClaimedOutboxDelivery( owner, - resultSet.getString("event_type"), - resultSet.getInt("event_schema"), - resultSet.getString("aggregate_type"), - resultSet.getString("aggregate_id"), - resultSet.getLong("aggregate_version"), - resultSet.getInt("event_ordinal"), - resultSet.getString("partition_key"), - resultSet.getString("content_type"), - resultSet.getString("correlation_id"), - resultSet.getString("causation_id"), - resultSet.getObject("occurred_at", OffsetDateTime.class).toInstant(), - resultSet.getString("payload"), - resultSet.getString("payload_digest")); + event, + resultSet.getObject("event_created_at", OffsetDateTime.class).toInstant(), + resultSet.getObject("delivery_created_at", OffsetDateTime.class).toInstant()); } private OutboxDeliveryTransitionOutcome classifyFailedTransition( @@ -500,29 +509,26 @@ public class PostgreSqlPollingDeliveryAdapter implements OutboxPollingDeliveryPo private static String transitionDigest( String kind, OutboxDeliveryTransition transition, String detail) { OutboxDeliveryOwner owner = transition.owner(); - return sha256( - kind - + '|' - + transition.operationId().value() - + '|' - + owner.eventId() - + '|' - + owner.destination() - + '|' - + owner.claimToken() - + '|' - + owner.attempt() - + '|' - + owner.version() - + '|' - + Objects.toString(detail, "")); + return digestFields( + kind, + transition.operationId().value(), + owner.eventId(), + owner.destination(), + owner.claimToken(), + Integer.toString(owner.attempt()), + Long.toString(owner.version()), + Objects.toString(detail, "")); } - private static String sha256(String value) { + static String digestFields(String... fields) { try { - return HexFormat.of() - .formatHex( - MessageDigest.getInstance("SHA-256").digest(value.getBytes(StandardCharsets.UTF_8))); + MessageDigest digest = MessageDigest.getInstance("SHA-256"); + for (String field : fields) { + byte[] bytes = Objects.toString(field, "").getBytes(StandardCharsets.UTF_8); + digest.update(ByteBuffer.allocate(Integer.BYTES).putInt(bytes.length).array()); + digest.update(bytes); + } + return HexFormat.of().formatHex(digest.digest()); } catch (NoSuchAlgorithmException exception) { throw new IllegalStateException("SHA-256 unavailable", exception); } diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/DefaultJpaRetryPolicy.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/DefaultJpaRetryPolicy.java index 4804a02f..5c192488 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/DefaultJpaRetryPolicy.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/DefaultJpaRetryPolicy.java @@ -7,7 +7,6 @@ import dev.caskeleton.adapter.outbound.persistence.api.transaction.JpaRetryPolic import dev.caskeleton.adapter.outbound.persistence.api.transaction.RetryDecision; import dev.caskeleton.adapter.outbound.persistence.api.transaction.RetryProfile; import dev.caskeleton.adapter.outbound.persistence.api.transaction.TransactionAttempt; -import dev.caskeleton.application.transaction.IrreversibleSideEffectContext; import java.util.Objects; /** @@ -17,8 +16,6 @@ import java.util.Objects; * *

    *
  1. Completion unknown reconciles. It is checked first so no later rule can reach it. - *
  2. An attempt that performed an irreversible external effect fails. Re-running it would repeat - * that effect, and no amount of remaining budget makes that acceptable. *
  3. A failure the translator marked non-retryable fails. The profile's allowlist widens which * categories may be retried; it does not overrule a verdict about this failure. The * allowlist used to be checked first, so a profile that opted into a category could revive a @@ -52,9 +49,6 @@ public final class DefaultJpaRetryPolicy implements JpaRetryPolicy { || failure.category() == FailureCategory.COMPLETION_UNKNOWN) { return RetryDecision.reconcile("transaction completion is unknown"); } - if (IrreversibleSideEffectContext.performed()) { - return RetryDecision.fail("attempt performed an irreversible external side effect"); - } if (!profile.enabled()) { return RetryDecision.fail("retry is not enabled for this transaction profile"); } diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/FullTransactionRetryCoordinator.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/FullTransactionRetryCoordinator.java index 516a4e99..25de0494 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/FullTransactionRetryCoordinator.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/FullTransactionRetryCoordinator.java @@ -31,16 +31,11 @@ public final class FullTransactionRetryCoordinator { private final SpringJpaTransactionExecutor transactionExecutor; - /** - * Fallback policy, used only when a call supplies no retry profile of its own. - * - *

    The coordinator used to apply this policy's eligibility and backoff to every call while - * taking the attempt budget from whatever profile the caller passed. Two profiles then decided - * one retry between them: profile A said which failures are retryable and how long to wait, - * profile B said how many attempts were left. A caller reading either profile would have - * predicted the wrong behaviour. + /* + * The legacy constructor still accepts a fallback policy so existing composition code keeps its + * source shape. TransactionProfile now requires a retry profile, so that fallback is validated + * but never participates in retry decisions. */ - private final JpaRetryPolicy fallbackRetryPolicy; private final RetrySleeper sleeper; private final Clock clock; @@ -55,7 +50,7 @@ public final class FullTransactionRetryCoordinator { Duration defaultMaxElapsed, RetryEventListener listener) { this.transactionExecutor = Objects.requireNonNull(transactionExecutor, "transactionExecutor"); - this.fallbackRetryPolicy = Objects.requireNonNull(fallbackRetryPolicy, "fallbackRetryPolicy"); + Objects.requireNonNull(fallbackRetryPolicy, "fallbackRetryPolicy"); this.sleeper = Objects.requireNonNull(sleeper, "sleeper"); this.clock = Objects.requireNonNull(clock, "clock"); this.defaultMaxElapsed = Objects.requireNonNull(defaultMaxElapsed, "defaultMaxElapsed"); @@ -87,10 +82,7 @@ public final class FullTransactionRetryCoordinator { // One profile decides everything about this call: which failures are retryable, how long to // wait, and how many attempts remain. - JpaRetryPolicy retryPolicy = - profile.retryProfile() == null - ? fallbackRetryPolicy - : DefaultJpaRetryPolicy.forProfile(profile.retryProfile()); + JpaRetryPolicy retryPolicy = DefaultJpaRetryPolicy.forProfile(profile.retryProfile()); RetryBudget budget = RetryBudget.forProfile(profile.retryProfile(), defaultMaxElapsed); Instant operationStartedAt = clock.instant(); diff --git a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/SpringTransactionPort.java b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/SpringTransactionPort.java index f80b2d3c..fc29296e 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/SpringTransactionPort.java +++ b/src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/SpringTransactionPort.java @@ -1,6 +1,5 @@ package dev.caskeleton.adapter.outbound.persistence.transaction; -import com.zaxxer.hikari.HikariDataSource; import dev.caskeleton.adapter.outbound.persistence.failure.PersistenceExceptionTranslator; import dev.caskeleton.adapter.outbound.persistence.failure.StandardSqlStateErrorMapping; import dev.caskeleton.application.transaction.Isolation; @@ -9,13 +8,12 @@ import dev.caskeleton.application.transaction.PolicyTransactionPort; import dev.caskeleton.application.transaction.TransactionMode; import dev.caskeleton.application.transaction.TransactionRequest; import dev.caskeleton.application.transaction.TransactionResult; -import java.sql.SQLException; import java.time.Duration; import java.util.Locale; import java.util.function.LongSupplier; import java.util.function.Supplier; -import javax.sql.DataSource; import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.beans.factory.annotation.Value; import org.springframework.stereotype.Component; import org.springframework.transaction.PlatformTransactionManager; import org.springframework.transaction.TransactionDefinition; @@ -62,14 +60,18 @@ public class SpringTransactionPort implements PolicyTransactionPort { PlatformTransactionManager transactionManager, JpaTransactionSettings settings, TransactionLocalTimeoutConfigurer localTimeoutConfigurer, - DataSource dataSource, + @Value("${spring.datasource.hikari.connection-timeout:5000}") + long connectionAcquisitionTimeoutMillis, PersistenceExceptionTranslator exceptionTranslator) { this( transactionManager, System::nanoTime, - new TransactionDeadlineCalculator(connectionTimeout(dataSource), settings), + new TransactionDeadlineCalculator( + connectionAcquisitionTimeout(connectionAcquisitionTimeoutMillis), settings), TransactionRetryBackoff.production( - settings, connectionTimeout(dataSource), System::nanoTime), + settings, + connectionAcquisitionTimeout(connectionAcquisitionTimeoutMillis), + System::nanoTime), localTimeoutConfigurer, exceptionTranslator); } @@ -179,17 +181,12 @@ public class SpringTransactionPort implements PolicyTransactionPort { return template; } - private static Duration connectionTimeout(DataSource dataSource) { - try { - HikariDataSource hikariDataSource = - dataSource instanceof HikariDataSource hikari - ? hikari - : dataSource.unwrap(HikariDataSource.class); - return Duration.ofMillis(hikariDataSource.getConnectionTimeout()); - } catch (SQLException exception) { - throw new IllegalStateException( - "the JPA transaction deadline policy requires a HikariDataSource", exception); + private static Duration connectionAcquisitionTimeout(long milliseconds) { + if (milliseconds <= 0) { + throw new IllegalArgumentException( + "spring.datasource.hikari.connection-timeout must be a positive millisecond value"); } + return Duration.ofMillis(milliseconds); } private T executeLegacy(TransactionTemplate template, Supplier action) { diff --git a/src/adapter/outbound/persistence-jpa/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/src/adapter/outbound/persistence-jpa/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports new file mode 100644 index 00000000..20d91dbe --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports @@ -0,0 +1,2 @@ +dev.caskeleton.adapter.outbound.persistence.autoconfigure.PersistenceJpaAutoConfiguration +dev.caskeleton.adapter.outbound.persistence.autoconfigure.PersistenceJpaRuntimeConfig diff --git a/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/jpa/outbox-polling/V2__widen_canonical_event_id.sql b/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/jpa/outbox-polling/V2__widen_canonical_event_id.sql new file mode 100644 index 00000000..702f7201 --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/jpa/outbox-polling/V2__widen_canonical_event_id.sql @@ -0,0 +1,13 @@ +-- Canonical EventId permits up to 96 characters. This migration is safe whether storage V2 +-- already widened an existing polling table or polling V1 was installed after storage V2. + +ALTER TABLE outbox_delivery_v2 + DROP CONSTRAINT IF EXISTS fk_outbox_delivery_v2_event; + +ALTER TABLE outbox_delivery_v2 + ALTER COLUMN event_id TYPE varchar(96); + +ALTER TABLE outbox_delivery_v2 + ADD CONSTRAINT fk_outbox_delivery_v2_event + FOREIGN KEY (retention_bucket, event_id) + REFERENCES outbox_event_log_v2 (retention_bucket, event_id); diff --git a/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/jpa/outbox-storage/V1__initialize_or_adopt.sql b/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/jpa/outbox-storage/V1__initialize_or_adopt.sql index 0c49e84c..e4021031 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/jpa/outbox-storage/V1__initialize_or_adopt.sql +++ b/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/jpa/outbox-storage/V1__initialize_or_adopt.sql @@ -135,10 +135,11 @@ CREATE TABLE outbox_event_log_v2 ( CHECK (dispatch_authority IN ('LEGACY_SHADOW', 'POLLING_V2', 'CDC')), CONSTRAINT ck_outbox_event_log_v2_payload_size CHECK (octet_length(payload) BETWEEN 1 AND 1048576) -) PARTITION BY RANGE (retention_bucket); +); -CREATE TABLE outbox_event_log_v2_default - PARTITION OF outbox_event_log_v2 DEFAULT; +-- Retention is lifecycle policy, not a pretend partitioning feature. Until the platform owns a +-- partition creation/rotation job, a plain table is cheaper and avoids parking every row in a +-- DEFAULT partition that later has to be drained before real range partitions can be attached. CREATE INDEX ix_outbox_event_log_v2_aggregate_order ON outbox_event_log_v2 ( @@ -190,25 +191,31 @@ RETURNS trigger LANGUAGE plpgsql AS $$ DECLARE - authority varchar(32); + control_authority varchar(32); + control_state varchar(16); BEGIN - SELECT active_authority - INTO authority + SELECT active_authority, state + INTO control_authority, control_state FROM outbox_publication_control_v2 WHERE scope_id = 'PRIMARY'; - IF authority <> 'LEGACY_POLLING' THEN - RAISE EXCEPTION 'legacy outbox writer is fenced after authority cutover'; + + -- Normal legacy ownership permits the legacy writer. During DRAINING, the legacy relay may + -- still finish or delete rows it already owns, but it may not create new work. Once the new + -- authority is ACTIVE every legacy mutation is fenced. + IF control_authority = 'LEGACY_POLLING' AND control_state = 'ACTIVE' THEN + RETURN NULL; END IF; - IF TG_OP = 'DELETE' THEN - RETURN OLD; + IF control_state = 'DRAINING' AND TG_OP IN ('UPDATE', 'DELETE') THEN + RETURN NULL; END IF; - RETURN NEW; + + RAISE EXCEPTION 'legacy outbox writer is fenced after authority cutover'; END $$; CREATE TRIGGER trg_fence_legacy_outbox_writer BEFORE INSERT OR UPDATE OR DELETE ON outbox_event -FOR EACH ROW EXECUTE FUNCTION fence_legacy_outbox_writer(); +FOR EACH STATEMENT EXECUTE FUNCTION fence_legacy_outbox_writer(); CREATE OR REPLACE FUNCTION reject_outbox_cutover_mutation() RETURNS trigger @@ -243,13 +250,17 @@ WITH legacy AS ( SELECT count(*) AS row_count, count(*) FILTER (WHERE status <> 'PUBLISHED') AS pending_count, + coalesce(min(event_id), '') AS first_event_id, + coalesce(max(event_id), '') AS last_event_id, coalesce( - string_agg( - event_id || ':' || status || ':' || attempt_count::text, - ',' ORDER BY event_id + sum( + hashtextextended( + event_id || ':' || status || ':' || attempt_count::text, + 0 + ) ), - '' - ) AS intent + 0 + ) AS intent_summary FROM outbox_event ), origin AS ( @@ -281,7 +292,19 @@ SELECT 'LEGACY_POLLING', row_count, pending_count, - md5(intent) || md5('outbox-v2:' || intent), + encode( + sha256( + convert_to( + row_count::text + || ':' || pending_count::text + || ':' || first_event_id + || ':' || last_event_id + || ':' || intent_summary::text, + 'UTF8' + ) + ), + 'hex' + ), 'jpa-outbox-storage-v2-schema-revision-2', null, clock_timestamp() diff --git a/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/jpa/outbox-storage/V2__canonical_envelope_alignment.sql b/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/jpa/outbox-storage/V2__canonical_envelope_alignment.sql new file mode 100644 index 00000000..148a72cb --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/jpa/outbox-storage/V2__canonical_envelope_alignment.sql @@ -0,0 +1,159 @@ +DO $$ +BEGIN + IF to_regclass('public.outbox_delivery_v2') IS NOT NULL THEN + ALTER TABLE outbox_delivery_v2 + DROP CONSTRAINT IF EXISTS fk_outbox_delivery_v2_event; + END IF; +END +$$; + +-- Align the dark owner-safe V2 event store with ValidatedIntegrationEvent. +-- Existing pre-canonical V2 rows remain an explicit compatibility generation: all new canonical +-- columns are NULL. New canonical rows must provide the complete shape. + +ALTER TABLE outbox_event_log_v2 + DROP CONSTRAINT fk_outbox_event_log_v2_identity; + +ALTER TABLE outbox_event_identity_v2 + DROP CONSTRAINT uq_outbox_event_identity_v2_aggregate_order, + DROP CONSTRAINT ck_outbox_event_identity_v2_ordinal, + ALTER COLUMN event_id TYPE varchar(96), + ADD COLUMN tenant_scope varchar(96); + +CREATE UNIQUE INDEX uq_outbox_event_identity_v2_legacy_aggregate_order + ON outbox_event_identity_v2 ( + aggregate_type, aggregate_id, aggregate_version, event_ordinal + ) + WHERE tenant_scope IS NULL; + +CREATE UNIQUE INDEX uq_outbox_event_identity_v2_canonical_aggregate_order + ON outbox_event_identity_v2 ( + tenant_scope, aggregate_type, aggregate_id, aggregate_version, event_ordinal + ) + WHERE tenant_scope IS NOT NULL; + +ALTER TABLE outbox_event_identity_v2 + ADD CONSTRAINT ck_outbox_event_identity_v2_ordinal CHECK (event_ordinal >= 0), + ADD CONSTRAINT ck_outbox_event_identity_v2_tenant_scope CHECK ( + tenant_scope IS NULL + OR tenant_scope ~ '^[a-z0-9]+([._:-][a-z0-9]+)*$' + ), + ADD CONSTRAINT uq_outbox_event_identity_v2_canonical_shape UNIQUE ( + event_id, + retention_bucket, + tenant_scope, + aggregate_type, + aggregate_id, + aggregate_version, + event_ordinal + ); + +DO $$ +BEGIN + IF to_regclass('public.outbox_delivery_v2') IS NOT NULL THEN + ALTER TABLE outbox_delivery_v2 + ALTER COLUMN event_id TYPE varchar(96); + END IF; +END +$$; + +ALTER TABLE outbox_event_log_v2 + ALTER COLUMN event_id TYPE varchar(96), + ADD COLUMN tenant_scope varchar(96), + ADD COLUMN envelope_version integer, + ADD COLUMN envelope_bytes bytea, + ADD COLUMN schema_set_hash char(64), + ADD COLUMN envelope_sha256 char(64), + ADD COLUMN envelope_schema_hash char(64), + ADD COLUMN payload_schema_hash char(64), + ADD COLUMN contract_catalog_revision varchar(96), + ADD COLUMN destination_binding_revision varchar(96); + +ALTER TABLE outbox_event_log_v2 + ADD CONSTRAINT fk_outbox_event_log_v2_identity + FOREIGN KEY ( + event_id, + retention_bucket, + tenant_scope, + aggregate_type, + aggregate_id, + aggregate_version, + event_ordinal + ) + REFERENCES outbox_event_identity_v2 ( + event_id, + retention_bucket, + tenant_scope, + aggregate_type, + aggregate_id, + aggregate_version, + event_ordinal + ), + ADD CONSTRAINT ck_outbox_event_log_v2_canonical_shape CHECK ( + ( + tenant_scope IS NULL + AND envelope_version IS NULL + AND envelope_bytes IS NULL + AND schema_set_hash IS NULL + AND envelope_sha256 IS NULL + AND envelope_schema_hash IS NULL + AND payload_schema_hash IS NULL + AND contract_catalog_revision IS NULL + AND destination_binding_revision IS NULL + ) + OR + ( + tenant_scope IS NOT NULL + AND envelope_version IS NOT NULL + AND envelope_bytes IS NOT NULL + AND schema_set_hash IS NOT NULL + AND envelope_sha256 IS NOT NULL + AND envelope_schema_hash IS NOT NULL + AND payload_schema_hash IS NOT NULL + AND contract_catalog_revision IS NOT NULL + AND destination_binding_revision IS NOT NULL + ) + ), + ADD CONSTRAINT ck_outbox_event_log_v2_canonical_values CHECK ( + envelope_bytes IS NULL + OR ( + event_id ~ '^[A-Za-z0-9][A-Za-z0-9._:-]*$' + AND tenant_scope ~ '^[a-z0-9]+([._:-][a-z0-9]+)*$' + AND length(aggregate_type) <= 64 + AND aggregate_type ~ '^[a-z][a-z0-9]*([.-][a-z0-9]+)*$' + AND length(aggregate_id) <= 160 + AND aggregate_id ~ '^[A-Za-z0-9][A-Za-z0-9._:-]*$' + AND event_type ~ '^[a-z][a-z0-9]*(-[a-z0-9]+)*(\.[a-z][a-z0-9]*(-[a-z0-9]+)*)+$' + AND length(logical_destination) <= 96 + AND logical_destination ~ '^[a-z][a-z0-9]*(-[a-z0-9]+)*$' + AND partition_key ~ '^[0-9a-f]{64}$' + AND length(content_type) <= 96 + AND envelope_version > 0 + AND event_schema > 0 + AND aggregate_version > 0 + AND event_ordinal >= 0 + AND schema_set_hash ~ '^[0-9a-f]{64}$' + AND envelope_sha256 ~ '^[0-9a-f]{64}$' + AND envelope_schema_hash ~ '^[0-9a-f]{64}$' + AND payload_schema_hash ~ '^[0-9a-f]{64}$' + AND contract_catalog_revision ~ '^[a-z0-9][a-z0-9._:-]{0,95}$' + AND destination_binding_revision ~ '^[a-z0-9][a-z0-9._:-]{0,95}$' + AND correlation_id ~ '^[A-Za-z0-9][A-Za-z0-9._:-]*$' + AND (causation_id IS NULL OR causation_id ~ '^[A-Za-z0-9][A-Za-z0-9._:-]*$') + AND octet_length(envelope_bytes) BETWEEN 1 AND 1048576 + AND convert_to(payload, 'UTF8') = envelope_bytes + AND payload_digest = envelope_sha256 + AND trace_parent IS NULL + ) + ); + +DO $$ +BEGIN + IF to_regclass('public.outbox_delivery_v2') IS NOT NULL THEN + ALTER TABLE outbox_delivery_v2 + ADD CONSTRAINT fk_outbox_delivery_v2_event + FOREIGN KEY (retention_bucket, event_id) + REFERENCES outbox_event_log_v2 (retention_bucket, event_id); + END IF; +END +$$; diff --git a/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/postgresql/V13__outbox_canonical_transport_compatibility.sql b/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/postgresql/V13__outbox_canonical_transport_compatibility.sql index f00b50b8..84591a9d 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/postgresql/V13__outbox_canonical_transport_compatibility.sql +++ b/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/postgresql/V13__outbox_canonical_transport_compatibility.sql @@ -15,13 +15,13 @@ ALTER TABLE outbox_event ADD COLUMN aggregate_type varchar(64), ADD COLUMN aggregate_sequence bigint, ADD COLUMN event_index integer, - ADD COLUMN partition_key char(64), + ADD COLUMN partition_key varchar(64), ADD COLUMN envelope_bytes bytea, ADD COLUMN content_type varchar(96), - ADD COLUMN schema_set_hash char(64), - ADD COLUMN envelope_sha256 char(64), - ADD COLUMN envelope_schema_hash char(64), - ADD COLUMN payload_schema_hash char(64), + ADD COLUMN schema_set_hash varchar(64), + ADD COLUMN envelope_sha256 varchar(64), + ADD COLUMN envelope_schema_hash varchar(64), + ADD COLUMN payload_schema_hash varchar(64), ADD COLUMN contract_catalog_revision varchar(96), ADD COLUMN destination_binding_revision varchar(96), ADD COLUMN causation_id varchar(128); @@ -68,7 +68,7 @@ ALTER TABLE outbox_event AND contract_catalog_revision IS NOT NULL AND destination_binding_revision IS NOT NULL ) - ), + ) NOT VALID, ADD CONSTRAINT ck_outbox_event_canonical_versions CHECK ( envelope_version IS NULL OR ( @@ -77,10 +77,10 @@ ALTER TABLE outbox_event AND aggregate_sequence > 0 AND event_index >= 0 ) - ), + ) NOT VALID, ADD CONSTRAINT ck_outbox_event_canonical_partition_key CHECK ( partition_key IS NULL OR partition_key ~ '^[0-9a-f]{64}$' - ), + ) NOT VALID, ADD CONSTRAINT ck_outbox_event_canonical_hashes CHECK ( schema_set_hash IS NULL OR ( @@ -89,10 +89,10 @@ ALTER TABLE outbox_event AND envelope_schema_hash ~ '^[0-9a-f]{64}$' AND payload_schema_hash ~ '^[0-9a-f]{64}$' ) - ), + ) NOT VALID, ADD CONSTRAINT ck_outbox_event_canonical_envelope_bytes CHECK ( envelope_bytes IS NULL OR octet_length(envelope_bytes) > 0 - ), + ) NOT VALID, ADD CONSTRAINT ck_outbox_event_canonical_required_text CHECK ( contract_id IS NULL OR ( @@ -104,7 +104,7 @@ ALTER TABLE outbox_event AND btrim(contract_catalog_revision) <> '' AND btrim(destination_binding_revision) <> '' ) - ); + ) NOT VALID; COMMENT ON COLUMN outbox_event.envelope_bytes IS 'Exact canonical ValidatedIntegrationEvent envelope bytes. Never reconstructed from payload.'; diff --git a/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/postgresql/V14__validate_outbox_canonical_constraints.sql b/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/postgresql/V14__validate_outbox_canonical_constraints.sql new file mode 100644 index 00000000..61ff8f09 --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/postgresql/V14__validate_outbox_canonical_constraints.sql @@ -0,0 +1,24 @@ +-- Validate the canonical outbox CHECK constraints separately from V13. +-- +-- V13 adds the constraints as NOT VALID so PostgreSQL does not scan the pre-existing table while +-- holding the stronger ALTER TABLE lock. New and changed rows are still checked immediately. +-- This follow-up performs the existing-row scan with VALIDATE CONSTRAINT, which uses PostgreSQL's +-- less intrusive validation lock and keeps expand/validate as two observable migration steps. + +ALTER TABLE outbox_event + VALIDATE CONSTRAINT ck_outbox_event_canonical_shape; + +ALTER TABLE outbox_event + VALIDATE CONSTRAINT ck_outbox_event_canonical_versions; + +ALTER TABLE outbox_event + VALIDATE CONSTRAINT ck_outbox_event_canonical_partition_key; + +ALTER TABLE outbox_event + VALIDATE CONSTRAINT ck_outbox_event_canonical_hashes; + +ALTER TABLE outbox_event + VALIDATE CONSTRAINT ck_outbox_event_canonical_envelope_bytes; + +ALTER TABLE outbox_event + VALIDATE CONSTRAINT ck_outbox_event_canonical_required_text; diff --git a/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/postgresql/V15__live_event_stream_position.sql b/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/postgresql/V15__live_event_stream_position.sql new file mode 100644 index 00000000..a72f4ff6 --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/postgresql/V15__live_event_stream_position.sql @@ -0,0 +1,22 @@ +-- Atomic per-stream position allocation for retained live events. +-- +-- V12 assigned positions by reading max(position) in Java. Two concurrent writers could observe +-- the same maximum and one transaction then failed on the live_event_log primary key. This counter +-- row makes the database serialize only writers for the same stream. +CREATE TABLE IF NOT EXISTS live_event_stream_position ( + stream_id VARCHAR(128) NOT NULL, + last_position BIGINT NOT NULL, + CONSTRAINT pk_live_event_stream_position PRIMARY KEY (stream_id), + CONSTRAINT ck_live_event_stream_position_non_negative CHECK (last_position >= 0) +); + +-- Upgrade path: preserve the highest position ever assigned before the allocator existed. +INSERT INTO live_event_stream_position (stream_id, last_position) +SELECT stream_id, max(position) +FROM live_event_log +GROUP BY stream_id +ON CONFLICT (stream_id) DO UPDATE +SET last_position = greatest( + live_event_stream_position.last_position, + EXCLUDED.last_position +); diff --git a/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/postgresql/V9__widen_capability_schema_stream.sql b/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/postgresql/V9__widen_capability_schema_stream.sql index 22e1e0e7..6107ad23 100644 --- a/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/postgresql/V9__widen_capability_schema_stream.sql +++ b/src/adapter/outbound/persistence-jpa/src/main/resources/db/migration/postgresql/V9__widen_capability_schema_stream.sql @@ -1,9 +1,10 @@ -- The adoption copy of db/migration/jpa/core/V2: same widening, applied by the default location. -- --- Numbered V9, not V8 or V7. `db/migration/postgresql` and `db/sample-migration` are merged into --- one Flyway location list by the sample composition root, so the two trees share a single version --- space: the sample already owns V2, V7 and V8. A duplicate version is not a merge conflict Flyway --- resolves — it refuses to start at all. +-- Historical note: this migration was originally numbered V9 because the sample application +-- merged its V2/V7/V8 migrations into the same Flyway stream. The sample now owns a separate +-- flyway_sample_schema_history, so future production versions are no longer constrained by sample +-- numbering. This existing version remains V9 because renumbering an applied production migration +-- would invalidate Flyway history. -- -- Both locations create capability_schema_registry, so both have to grow the column. A deployment -- that migrated through only one of them would otherwise still reject a stream path over 32 diff --git a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/liveevent/LiveEventLogContractTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/liveevent/LiveEventLogContractTest.java index 78ea281d..faad6503 100644 --- a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/liveevent/LiveEventLogContractTest.java +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/liveevent/LiveEventLogContractTest.java @@ -17,6 +17,11 @@ import java.time.Duration; import java.time.Instant; import java.util.ArrayList; import java.util.List; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.Future; +import java.util.concurrent.TimeUnit; import org.junit.jupiter.api.AfterAll; import org.junit.jupiter.api.BeforeAll; import org.junit.jupiter.api.BeforeEach; @@ -58,7 +63,8 @@ class LiveEventLogContractTest { Statement statement = connection.createStatement()) { statement.execute("DROP SCHEMA public CASCADE"); statement.execute("CREATE SCHEMA public"); - statement.execute(migration()); + statement.execute(migration("V12__live_event_log.sql")); + statement.execute(migration("V15__live_event_stream_position.sql")); } } @@ -81,32 +87,42 @@ class LiveEventLogContractTest { } @Test - @DisplayName("two writers racing for the same position produce one row, not two") - void concurrentAppendsCannotShareAPosition() throws Exception { - // The property the primary key exists for. Assigning positions in Java without it would let - // both writers read the same maximum and both write it, and the second event would silently - // overwrite the first — two different events at one address, with a client's cursor pointing - // at whichever survived. - List outcomes = new ArrayList<>(); - try (Connection first = support.connection(); - Connection second = support.connection()) { - first.setAutoCommit(false); - second.setAutoCommit(false); - insert(first, "orders", 1, "from-first", NOW); - outcomes.add("first-inserted"); - first.commit(); - try { - insert(second, "orders", 1, "from-second", NOW); - second.commit(); - outcomes.add("second-inserted"); - } catch (SQLException refused) { - second.rollback(); - outcomes.add("second-refused"); - } + @DisplayName("two concurrent writers receive different positions and both commit") + void concurrentWritersAllocateDistinctPositions() throws Exception { + CountDownLatch start = new CountDownLatch(1); + + try (ExecutorService executor = Executors.newFixedThreadPool(2)) { + Future first = + executor.submit(() -> allocateAndAppendAfter(start, "orders", "from-first")); + Future second = + executor.submit(() -> allocateAndAppendAfter(start, "orders", "from-second")); + + start.countDown(); + + assertThat(List.of(first.get(10, TimeUnit.SECONDS), second.get(10, TimeUnit.SECONDS))) + .containsExactlyInAnyOrder(1L, 2L); } - assertThat(outcomes).containsExactly("first-inserted", "second-refused"); - assertThat(payloadAt("orders", 1)).isEqualTo("from-first"); + assertThat(replayAfter("orders", 0, NOW)).containsExactly("from-first", "from-second"); + } + + @Test + @DisplayName("the allocator backfills the highest position when V15 upgrades an existing log") + void allocatorBackfillsExistingHighWaterMark() throws Exception { + append("orders", 1, "a", NOW); + append("orders", 2, "b", NOW); + + try (Connection connection = support.connection(); + Statement statement = connection.createStatement()) { + statement.execute("DROP TABLE live_event_stream_position"); + statement.execute(migration("V15__live_event_stream_position.sql")); + } + + try (Connection connection = support.connection()) { + connection.setAutoCommit(false); + assertThat(allocatePosition(connection, "orders")).isEqualTo(3L); + connection.rollback(); + } } @Test @@ -190,6 +206,33 @@ class LiveEventLogContractTest { assertThat(earliestRetained("nothing-here", NOW)).isNull(); } + private long allocateAndAppendAfter(CountDownLatch start, String streamId, String payload) + throws Exception { + try (Connection connection = support.connection()) { + connection.setAutoCommit(false); + if (!start.await(5, TimeUnit.SECONDS)) { + throw new AssertionError("concurrent live-event writers did not start together"); + } + long position = allocatePosition(connection, streamId); + insert(connection, streamId, position, payload, NOW); + connection.commit(); + return position; + } + } + + private static long allocatePosition(Connection connection, String streamId) throws SQLException { + try (PreparedStatement statement = + connection.prepareStatement(JpaLiveEventReplayAdapter.ALLOCATE_POSITION_SQL)) { + statement.setString(1, streamId); + try (ResultSet rows = statement.executeQuery()) { + if (!rows.next()) { + throw new SQLException("live-event allocator returned no position"); + } + return rows.getLong(1); + } + } + } + private void append(String streamId, long position, String payload, Instant occurredAt) throws SQLException { try (Connection connection = support.connection()) { @@ -263,19 +306,6 @@ class LiveEventLogContractTest { } } - private String payloadAt(String streamId, long position) throws SQLException { - try (Connection connection = support.connection(); - PreparedStatement statement = - connection.prepareStatement( - "SELECT payload FROM live_event_log WHERE stream_id = ? AND position = ?")) { - statement.setString(1, streamId); - statement.setLong(2, position); - try (ResultSet rows = statement.executeQuery()) { - return rows.next() ? rows.getString(1) : null; - } - } - } - private int sweep(Instant now) throws SQLException { try (Connection connection = support.connection(); PreparedStatement statement = @@ -285,14 +315,12 @@ class LiveEventLogContractTest { } } - private static String migration() throws IOException { + private static String migration(String fileName) throws IOException { try (InputStream source = - LiveEventLogContractTest.class.getResourceAsStream( - "/db/migration/postgresql/V12__live_event_log.sql")) { + LiveEventLogContractTest.class.getResourceAsStream("/db/migration/postgresql/" + fileName)) { if (source == null) { throw new IllegalStateException( - "the migration this store is defined by is missing from the classpath, so the test" - + " would create its own idea of the schema and certify that instead"); + "the migration this store is defined by is missing from the classpath: " + fileName); } return new String(source.readAllBytes(), StandardCharsets.UTF_8); } diff --git a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/notification/AdminOperationClaimContractTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/notification/AdminOperationClaimContractTest.java index fc209294..b9f729be 100644 --- a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/notification/AdminOperationClaimContractTest.java +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/notification/AdminOperationClaimContractTest.java @@ -89,6 +89,17 @@ class AdminOperationClaimContractTest { .isEqualTo("CLAIMED"); } + @Test + @DisplayName("a claimed row is completed in place rather than inserted a second time") + void claimedRowCompletesInPlace() throws SQLException { + assertThat(claim("op-1", FINGERPRINT)).isEqualTo(1); + + assertThat(complete("op-1", "done")).isEqualTo(1); + assertThat(phaseOf("op-1")).isEqualTo("COMPLETED"); + assertThat(reasonOf("op-1")).isEqualTo("done"); + assertThat(rowCount("op-1")).isEqualTo(1); + } + @Test @DisplayName("the claim records the fingerprint it was made with") void theClaimRecordsItsFingerprint() throws SQLException { @@ -133,6 +144,36 @@ class AdminOperationClaimContractTest { } } + private int complete(String operationId, String reasonCode) throws SQLException { + try (Connection connection = support.connection(); + PreparedStatement statement = + connection.prepareStatement( + "UPDATE notification_admin_audit" + + " SET reason_code = ?, phase = 'COMPLETED', occurred_at = ?" + + " WHERE operation_id = ? AND phase = 'CLAIMED'")) { + statement.setString(1, reasonCode); + statement.setTimestamp(2, Timestamp.from(NOW.plusSeconds(1))); + statement.setString(3, operationId); + return statement.executeUpdate(); + } + } + + private int rowCount(String operationId) throws SQLException { + try (Connection connection = support.connection(); + PreparedStatement statement = + connection.prepareStatement( + "SELECT count(*) FROM notification_admin_audit WHERE operation_id = ?")) { + statement.setString(1, operationId); + try (ResultSet rows = statement.executeQuery()) { + return rows.next() ? rows.getInt(1) : 0; + } + } + } + + private String reasonOf(String operationId) throws SQLException { + return column(operationId, "reason_code"); + } + private String phaseOf(String operationId) throws SQLException { return column(operationId, "phase"); } diff --git a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/notification/ProjectionFactDurabilityContractTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/notification/ProjectionFactDurabilityContractTest.java index b1d2ea3a..18f81c77 100644 --- a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/notification/ProjectionFactDurabilityContractTest.java +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/notification/ProjectionFactDurabilityContractTest.java @@ -4,8 +4,6 @@ import static org.assertj.core.api.Assertions.assertThat; import dev.caskeleton.adapter.outbound.persistence.platform.JpaPlatformContractSupport; import java.io.IOException; -import java.io.InputStream; -import java.nio.charset.StandardCharsets; import java.sql.Connection; import java.sql.PreparedStatement; import java.sql.ResultSet; @@ -268,28 +266,8 @@ class ProjectionFactDurabilityContractTest { } private static List migrations() throws IOException { - return List.of( - migration("jpa/core", "V1__initialize_or_adopt.sql"), - migration("jpa/core", "V2__widen_capability_schema_stream.sql"), - migration("jpa/notification-platform", "V1__notification_platform_core.sql"), - migration( - "jpa/notification-platform", "V2__notification_platform_contact_template_policy.sql"), - migration("jpa/notification-platform", "V3__notification_platform_inbox_admin.sql"), - migration( - "jpa/notification-platform", "V4__notification_platform_alignment_and_activation.sql"), - migration("jpa/notification-platform", "V5__notification_recipient_expiry.sql"), - migration("jpa/notification-platform", "V6__notification_projection_facts.sql")); + return NotificationFixtures.migrations(); } - private static String migration(String stream, String fileName) throws IOException { - try (InputStream resource = - ProjectionFactDurabilityContractTest.class - .getClassLoader() - .getResourceAsStream("db/migration/" + stream + "/" + fileName)) { - if (resource == null) { - throw new IOException("migration " + fileName + " is missing from the classpath"); - } - return new String(resource.readAllBytes(), StandardCharsets.UTF_8); - } - } + } diff --git a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/notification/RecipientClaimContractTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/notification/RecipientClaimContractTest.java index e3fe86c4..5ee45923 100644 --- a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/notification/RecipientClaimContractTest.java +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/notification/RecipientClaimContractTest.java @@ -5,8 +5,6 @@ import static org.assertj.core.api.Assertions.assertThat; import dev.caskeleton.adapter.outbound.persistence.notification.platform.RecipientClaimSql; import dev.caskeleton.adapter.outbound.persistence.platform.JpaPlatformContractSupport; import java.io.IOException; -import java.io.InputStream; -import java.nio.charset.StandardCharsets; import java.sql.Connection; import java.sql.PreparedStatement; import java.sql.ResultSet; @@ -317,36 +315,8 @@ class RecipientClaimContractTest { } private static List migrations() throws IOException { - // The core stream first: the notification stream's activation block reads - // capability_schema_registry, which core creates. Applying the notification stream alone is - // exactly the operator mistake the activation gate exists to catch, so it fails here too. - // The whole stream, in order. Applying a subset certifies a schema nobody deploys — V4 alters - // tables V2 and V3 create, which is how the first version of this test discovered that it was - // testing a database that could not exist. - return List.of( - migration("jpa/core", "V1__initialize_or_adopt.sql"), - migration("jpa/core", "V2__widen_capability_schema_stream.sql"), - migration("jpa/notification-platform", "V1__notification_platform_core.sql"), - migration( - "jpa/notification-platform", "V2__notification_platform_contact_template_policy.sql"), - migration("jpa/notification-platform", "V3__notification_platform_inbox_admin.sql"), - migration( - "jpa/notification-platform", "V4__notification_platform_alignment_and_activation.sql"), - migration("jpa/notification-platform", "V5__notification_recipient_expiry.sql"), - migration("jpa/notification-platform", "V6__notification_projection_facts.sql"), - migration("jpa/notification-platform", "V7__notification_collapse.sql"), - migration("jpa/notification-platform", "V8__notification_admin_claim.sql")); + return NotificationFixtures.migrations(); } - private static String migration(String stream, String fileName) throws IOException { - try (InputStream resource = - RecipientClaimContractTest.class - .getClassLoader() - .getResourceAsStream("db/migration/" + stream + "/" + fileName)) { - if (resource == null) { - throw new IOException("migration " + fileName + " is missing from the classpath"); - } - return new String(resource.readAllBytes(), StandardCharsets.UTF_8); - } - } + } diff --git a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/platform/EnversHistoryContractTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/platform/EnversHistoryContractTest.java index 2dee1dc8..decae949 100644 --- a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/platform/EnversHistoryContractTest.java +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/platform/EnversHistoryContractTest.java @@ -80,10 +80,15 @@ class EnversHistoryContractTest { entityManager -> entityManager.find(AuditedDocument.class, id).retitle("second")); jpa.inTransactionDo(entityManager -> entityManager.find(AuditedDocument.class, id).redact()); + var before = jpa.statistics().snapshot(); try (EntityManager entityManager = jpa.entityManager()) { var reader = new HibernateEnversHistoryReader(entityManager, POLICY); List> revisions = reader.revisions(AuditedDocument.class, id); + var delta = jpa.statistics().snapshot().minus(before); + assertThat(delta.preparedStatements()) + .as("history page must be one Envers query rather than revision-count-dependent 1+N") + .isEqualTo(1L); assertThat(revisions).hasSize(3); assertThat(revisions) .extracting(r -> r.entity().title()) diff --git a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/platform/JpaAuditingContractTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/platform/JpaAuditingContractTest.java deleted file mode 100644 index c9a6e5e8..00000000 --- a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/platform/JpaAuditingContractTest.java +++ /dev/null @@ -1,62 +0,0 @@ -package dev.caskeleton.adapter.outbound.persistence.platform; - -import static org.assertj.core.api.Assertions.assertThat; - -import dev.caskeleton.adapter.outbound.persistence.auditing.JpaAuditingConfiguration; -import dev.caskeleton.adapter.outbound.persistence.auditing.JpaAuditorProvider; -import java.time.Clock; -import java.time.Instant; -import java.time.ZoneOffset; -import java.util.Optional; -import org.junit.jupiter.api.DisplayName; -import org.junit.jupiter.api.Tag; -import org.junit.jupiter.api.Test; - -/** - * Technical auditing stamps a bounded actor and a fixed clock (design §10.2). - * - *

    Auditing is opt-in and wired by the composition root, so what is contracted here is the seam - * the root wires: the time source is the injected {@link Clock} (otherwise the stamp is untestable) - * and the actor is bounded (otherwise an email lands in a column copied into every backup). - */ -@Tag("jpa-contract") -class JpaAuditingContractTest { - - private final Clock clock = Clock.fixed(Instant.parse("2026-08-11T00:00:00Z"), ZoneOffset.UTC); - - @Test - @DisplayName("the audit stamp comes from the injected clock, not from the wall clock") - void auditStampComesFromTheInjectedClock() { - var configuration = new JpaAuditingConfiguration(clock, JpaAuditorProvider.system()); - - assertThat(configuration.dateTimeProvider().getNow()) - .map(temporal -> Instant.from(temporal)) - .contains(Instant.parse("2026-08-11T00:00:00Z")); - } - - @Test - @DisplayName("a bounded actor is recorded verbatim") - void boundedActorIsRecordedVerbatim() { - var provider = new JpaAuditorProvider(() -> Optional.of("user-42")); - - assertThat(provider.getCurrentAuditor()).contains("user-42"); - } - - @Test - @DisplayName("an unbounded actor is replaced, not truncated") - void unboundedActorIsReplaced() { - var provider = new JpaAuditorProvider(() -> Optional.of("someone@example.test with spaces")); - - assertThat(provider.getCurrentAuditor()) - .as("truncating an email still leaves most of it in the column") - .contains(JpaAuditorProvider.SYSTEM_ACTOR); - } - - @Test - @DisplayName("unattended work is attributed to an explicit system actor, never to null") - void unattendedWorkUsesTheSystemActor() { - var provider = new JpaAuditorProvider(Optional::empty); - - assertThat(provider.getCurrentAuditor()).contains(JpaAuditorProvider.SYSTEM_ACTOR); - } -} diff --git a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/CanonicalOutboxV2TestFixture.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/CanonicalOutboxV2TestFixture.java new file mode 100644 index 00000000..cafdcdcc --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/CanonicalOutboxV2TestFixture.java @@ -0,0 +1,84 @@ +package dev.caskeleton.adapter.outbound.persistence.readiness; + +import dev.caskeleton.application.messaging.contract.ContractId; +import dev.caskeleton.application.messaging.contract.LogicalDestinationId; +import dev.caskeleton.application.messaging.contract.Sha256; +import dev.caskeleton.application.messaging.event.AggregateIdentity; +import dev.caskeleton.application.messaging.event.AggregateOrder; +import dev.caskeleton.application.messaging.event.EventId; +import dev.caskeleton.application.messaging.event.ValidatedIntegrationEvent; +import dev.caskeleton.application.outbox.v2.NewOutboxEventV2; +import java.nio.charset.StandardCharsets; +import java.security.MessageDigest; +import java.security.NoSuchAlgorithmException; +import java.time.Instant; +import java.util.Optional; + +final class CanonicalOutboxV2TestFixture { + + static final String DESTINATION = "portfolio-events"; + + private CanonicalOutboxV2TestFixture() {} + + static NewOutboxEventV2 event( + String eventId, long aggregateSequence, int eventIndex, String envelopeJson) { + return event(eventId, "tenant-a", aggregateSequence, eventIndex, envelopeJson); + } + + static NewOutboxEventV2 event( + String eventId, + String tenantScope, + long aggregateSequence, + int eventIndex, + String envelopeJson) { + return event( + eventId, + tenantScope, + aggregateSequence, + eventIndex, + envelopeJson.getBytes(StandardCharsets.UTF_8)); + } + + static NewOutboxEventV2 event( + String eventId, + String tenantScope, + long aggregateSequence, + int eventIndex, + byte[] envelopeBytes) { + String partitionKey = "a".repeat(64); + return new NewOutboxEventV2( + new ValidatedIntegrationEvent( + new EventId(eventId), + new ContractId("portfolio.worklog.changed"), + 1, + 1, + new LogicalDestinationId(DESTINATION), + new AggregateIdentity(tenantScope, "worklog", "work-log-42"), + new AggregateOrder(aggregateSequence, eventIndex), + Instant.parse("2026-07-28T12:00:00Z"), + "correlation-1", + Optional.empty(), + partitionKey, + partitionKey.getBytes(StandardCharsets.US_ASCII), + envelopeBytes, + "application/json", + sha("schema-set"), + sha(envelopeBytes), + sha("envelope-schema"), + sha("payload-schema"), + "catalog-r1", + "binding-r1")); + } + + private static Sha256 sha(String value) { + return sha(value.getBytes(StandardCharsets.UTF_8)); + } + + private static Sha256 sha(byte[] value) { + try { + return new Sha256(MessageDigest.getInstance("SHA-256").digest(value)); + } catch (NoSuchAlgorithmException exception) { + throw new IllegalStateException("SHA-256 unavailable", exception); + } + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/LegacyOutboxDrainContractTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/LegacyOutboxDrainContractTest.java new file mode 100644 index 00000000..3aa7921a --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/LegacyOutboxDrainContractTest.java @@ -0,0 +1,142 @@ +package dev.caskeleton.adapter.outbound.persistence.readiness; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +import org.flywaydb.core.Flyway; +import org.junit.jupiter.api.Tag; +import org.junit.jupiter.api.Test; +import org.springframework.dao.DataAccessException; +import org.springframework.jdbc.core.JdbcTemplate; + +@Tag("jpa-contract") +class LegacyOutboxDrainContractTest { + + @Test + void drainingLetsTheLegacyRelayFinishExistingRowsButRejectsNewWork() { + try (PostgreSqlReadinessSupport database = PostgreSqlReadinessSupport.start()) { + migrate(database, "classpath:db/migration/postgresql", "flyway_schema_history", false); + migrate(database, "classpath:db/migration/jpa/core", "flyway_jpa_core_history", true); + migrate( + database, + "classpath:db/migration/jpa/outbox-storage", + "flyway_jpa_outbox_storage_history", + true); + + JdbcTemplate jdbc = new JdbcTemplate(database.dataSource()); + jdbc.update( + """ + insert into outbox_event( + event_id, aggregate_id, event_type, payload, occurred_at, status, + attempt_count, next_attempt_at, correlation_id, idempotency_key + ) values ( + 'legacy-existing', 'order-42', 'order.created', '{}', clock_timestamp(), 'PENDING', + 0, clock_timestamp(), 'corr-42', 'idem-42' + ) + """); + + jdbc.update( + """ + update outbox_publication_control_v2 + set active_authority = 'POLLING_V2', + state = 'DRAINING', + revision = revision + 1, + updated_at = clock_timestamp() + where scope_id = 'PRIMARY' + """); + + assertThat( + jdbc.update( + "update outbox_event set status = 'PUBLISHED' " + + "where event_id = 'legacy-existing'")) + .isOne(); + assertThat( + jdbc.queryForObject( + "select status from outbox_event where event_id = 'legacy-existing'", + String.class)) + .isEqualTo("PUBLISHED"); + + assertThatThrownBy( + () -> + jdbc.update( + """ + insert into outbox_event( + event_id, aggregate_id, event_type, payload, occurred_at, status, + attempt_count, next_attempt_at, correlation_id, idempotency_key + ) values ( + 'legacy-new', 'order-43', 'order.created', '{}', clock_timestamp(), + 'PENDING', 0, clock_timestamp(), 'corr-43', 'idem-43' + ) + """)) + .isInstanceOf(DataAccessException.class) + .hasMessageContaining("legacy outbox writer is fenced"); + } + } + + @Test + void installedStorageUsesAStatementFenceARealSha256DigestAndNoFakePartitioning() { + try (PostgreSqlReadinessSupport database = PostgreSqlReadinessSupport.start()) { + migrate(database, "classpath:db/migration/postgresql", "flyway_schema_history", false); + migrate(database, "classpath:db/migration/jpa/core", "flyway_jpa_core_history", true); + migrate( + database, + "classpath:db/migration/jpa/outbox-storage", + "flyway_jpa_outbox_storage_history", + true); + + JdbcTemplate jdbc = new JdbcTemplate(database.dataSource()); + assertThat( + jdbc.queryForObject( + """ + select action_orientation + from information_schema.triggers + where event_object_schema = 'public' + and event_object_table = 'outbox_event' + and trigger_name = 'trg_fence_legacy_outbox_writer' + limit 1 + """, + String.class)) + .isEqualTo("STATEMENT"); + + assertThat( + jdbc.queryForObject( + """ + select exists( + select 1 + from pg_partitioned_table p + join pg_class c on c.oid = p.partrelid + where c.relname = 'outbox_event_log_v2' + ) + """, + Boolean.class)) + .isFalse(); + + assertThat( + jdbc.queryForObject( + """ + select legacy_digest + from outbox_publication_cutover_v2 + where scope_id = 'PRIMARY' and active_epoch = 1 + """, + String.class)) + .matches("[0-9a-f]{64}"); + } + } + + private static void migrate( + PostgreSqlReadinessSupport database, + String location, + String historyTable, + boolean independent) { + Flyway.configure() + .dataSource(database.dataSource()) + .locations(location) + .table(historyTable) + .baselineVersion("0") + .baselineDescription("legacy-outbox-drain-contract") + .baselineOnMigrate(independent) + .outOfOrder(false) + .load() + .migrate(); + } +} diff --git a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/outbox/OutboxContainerTestSupport.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/LegacyOutboxIntegrationSupport.java similarity index 87% rename from src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/outbox/OutboxContainerTestSupport.java rename to src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/LegacyOutboxIntegrationSupport.java index 4555fd7a..4fe81e33 100644 --- a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/outbox/OutboxContainerTestSupport.java +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/LegacyOutboxIntegrationSupport.java @@ -1,7 +1,5 @@ -package dev.caskeleton.bootstrap.integration.outbox; +package dev.caskeleton.adapter.outbound.persistence.readiness; -import com.zaxxer.hikari.HikariConfig; -import com.zaxxer.hikari.HikariDataSource; import dev.caskeleton.adapter.outbound.persistence.outbox.OutboxClaimRepository; import dev.caskeleton.adapter.outbound.persistence.outbox.OutboxEventJpaRepository; import dev.caskeleton.adapter.outbound.persistence.outbox.OutboxStoreAdapter; @@ -19,40 +17,30 @@ import java.util.Properties; import java.util.random.RandomGenerator; import javax.sql.DataSource; import org.flywaydb.core.Flyway; -import org.junit.jupiter.api.Assumptions; import org.springframework.context.annotation.AnnotationConfigApplicationContext; import org.springframework.context.annotation.Configuration; import org.springframework.context.event.ContextClosedEvent; +import org.springframework.core.env.MapPropertySource; import org.springframework.data.jpa.repository.config.EnableJpaRepositories; import org.springframework.orm.jpa.JpaTransactionManager; import org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean; import org.springframework.orm.jpa.SharedEntityManagerCreator; import org.springframework.orm.jpa.vendor.HibernateJpaVendorAdapter; -import org.testcontainers.DockerClientFactory; -import org.testcontainers.postgresql.PostgreSQLContainer; /** - * Shared Testcontainers + Spring context support for outbox integration tests + * Shared real-PostgreSQL + Spring context support for legacy outbox integration tests * (feature-domain-event-outbox-contract Task E). * *

    Does NOT boot the full {@code CaSkeletonApplication}. Builds a minimal {@link * AnnotationConfigApplicationContext} with only the JPA / outbox persistence beans needed for the * outbox integration tests. */ -final class OutboxContainerTestSupport { +final class LegacyOutboxIntegrationSupport { - static final String PG_IMAGE = "postgres:16-alpine"; static final int BATCH_SIZE_CONTRACT = 50; static final Duration IN_FLIGHT_TIMEOUT = Duration.ofSeconds(30); - private OutboxContainerTestSupport() {} - - /** Guard: skip the test if Docker is unavailable (CI without Docker daemon). */ - static void assumeDockerAvailable() { - Assumptions.assumeTrue( - DockerClientFactory.instance().isDockerAvailable(), - "Docker not available — skipping Testcontainers-based outbox integration test"); - } + private LegacyOutboxIntegrationSupport() {} /** * Runs Flyway migrations against the given DataSource. All three migrations (V1 idempotency, V2 @@ -66,17 +54,6 @@ final class OutboxContainerTestSupport { .migrate(); } - /** Creates a HikariDataSource pointing to the given PostgreSQL container. */ - static HikariDataSource dataSource(PostgreSQLContainer pg) { - HikariConfig config = new HikariConfig(); - config.setJdbcUrl(pg.getJdbcUrl()); - config.setUsername(pg.getUsername()); - config.setPassword(pg.getPassword()); - config.setMaximumPoolSize(10); - config.setMinimumIdle(2); - return new HikariDataSource(config); - } - /** * Builds a minimal Spring context containing JPA + outbox persistence beans. * @@ -102,6 +79,12 @@ final class OutboxContainerTestSupport { EntityManagerFactory emf = emfBean.getObject(); AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext(); + ctx.getEnvironment() + .getPropertySources() + .addFirst( + new MapPropertySource( + "legacy-outbox-integration", + java.util.Map.of("ca-skeleton.outbox.enabled", "true"))); // Register DataSource — no destroy (caller owns lifecycle). ctx.registerBean( diff --git a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlDistributedLockIntegrationTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlDistributedLockIntegrationTest.java new file mode 100644 index 00000000..5852b65d --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlDistributedLockIntegrationTest.java @@ -0,0 +1,149 @@ +package dev.caskeleton.adapter.outbound.persistence.readiness; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +import dev.caskeleton.adapter.outbound.persistence.lock.LockRegistryDistributedLockAdapter; +import dev.caskeleton.application.lock.DistributedLock; +import dev.caskeleton.application.lock.LockAcquisitionTimeoutException; +import java.time.Duration; +import java.util.ConcurrentModificationException; +import javax.sql.DataSource; +import org.flywaydb.core.Flyway; +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; +import org.springframework.integration.jdbc.lock.DefaultLockRepository; +import org.springframework.integration.jdbc.lock.JdbcLockRegistry; +import org.springframework.jdbc.datasource.DataSourceTransactionManager; + +/** Real PostgreSQL contract for the Spring Integration JDBC distributed-lock adapter. */ +class PostgreSqlDistributedLockIntegrationTest { + + private static PostgreSqlReadinessSupport postgres; + private static DataSource dataSource; + + @BeforeAll + static void startPostgreSql() { + postgres = PostgreSqlReadinessSupport.start(); + dataSource = postgres.dataSource(); + Flyway.configure() + .dataSource(dataSource) + .locations("classpath:db/migration/postgresql") + .load() + .migrate(); + } + + @AfterAll + static void stopPostgreSql() { + if (postgres != null) { + postgres.close(); + } + } + + @Test + void sameKeyIsMutuallyExclusiveAndReleaseMakesItAcquirable() { + Duration ttl = Duration.ofSeconds(30); + DefaultLockRepository repositoryA = repository(dataSource); + DefaultLockRepository repositoryB = repository(dataSource); + try { + LockRegistryDistributedLockAdapter adapterA = adapter(repositoryA, ttl); + LockRegistryDistributedLockAdapter adapterB = adapter(repositoryB, ttl); + String key = "distributed-lock-mutual-exclusion-" + System.nanoTime(); + + DistributedLock first = adapterA.tryAcquire(key, Duration.ofSeconds(1), ttl); + try { + assertThatThrownBy(() -> adapterB.tryAcquire(key, Duration.ofMillis(100), ttl)) + .isInstanceOf(LockAcquisitionTimeoutException.class); + } finally { + first.close(); + } + + DistributedLock afterRelease = adapterB.tryAcquire(key, Duration.ofSeconds(1), ttl); + assertThat(afterRelease).isNotNull(); + afterRelease.close(); + } finally { + repositoryA.stop(); + repositoryB.stop(); + } + } + + @Test + void expiredLeaseCanBeReclaimedByAnotherInstance() throws Exception { + Duration ttl = Duration.ofSeconds(1); + DefaultLockRepository repositoryA = repository(dataSource); + DefaultLockRepository repositoryB = repository(dataSource); + try { + LockRegistryDistributedLockAdapter adapterA = adapter(repositoryA, ttl); + LockRegistryDistributedLockAdapter adapterB = adapter(repositoryB, ttl); + String key = "distributed-lock-expired-lease-" + System.nanoTime(); + + @SuppressWarnings("unused") + DistributedLock crashedHolder = adapterA.tryAcquire(key, Duration.ofSeconds(1), ttl); + + Thread.sleep(ttl.toMillis() + 500); + DistributedLock reclaimed = acquireWithin(adapterB, key, ttl, ttl.multipliedBy(4)); + reclaimed.close(); + } finally { + repositoryA.stop(); + repositoryB.stop(); + } + } + + @Test + void staleRawHandleCloseSignalsConcurrentModificationAfterLeaseReclaim() throws Exception { + Duration ttl = Duration.ofSeconds(1); + DefaultLockRepository repositoryA = repository(dataSource); + DefaultLockRepository repositoryB = repository(dataSource); + try { + LockRegistryDistributedLockAdapter adapterA = adapter(repositoryA, ttl); + LockRegistryDistributedLockAdapter adapterB = adapter(repositoryB, ttl); + String key = "distributed-lock-stale-close-" + System.nanoTime(); + + DistributedLock stale = adapterA.tryAcquire(key, Duration.ofSeconds(1), ttl); + Thread.sleep(ttl.toMillis() + 500); + + DistributedLock replacement = acquireWithin(adapterB, key, ttl, ttl.multipliedBy(4)); + try { + assertThatThrownBy(stale::close).isInstanceOf(ConcurrentModificationException.class); + } finally { + replacement.close(); + } + } finally { + repositoryA.stop(); + repositoryB.stop(); + } + } + + private static DistributedLock acquireWithin( + LockRegistryDistributedLockAdapter adapter, String key, Duration leaseTtl, Duration bound) + throws InterruptedException { + long deadline = System.nanoTime() + bound.toNanos(); + LockAcquisitionTimeoutException lastTimeout = null; + while (System.nanoTime() < deadline) { + try { + return adapter.tryAcquire(key, Duration.ofMillis(200), leaseTtl); + } catch (LockAcquisitionTimeoutException exception) { + lastTimeout = exception; + Thread.sleep(100); + } + } + throw new AssertionError( + "could not acquire distributed lock within " + bound + " after lease expiry", lastTimeout); + } + + private static LockRegistryDistributedLockAdapter adapter( + DefaultLockRepository repository, Duration ttl) { + return new LockRegistryDistributedLockAdapter(new JdbcLockRegistry(repository, ttl), ttl); + } + + private static DefaultLockRepository repository(DataSource dataSource) { + DefaultLockRepository repository = new DefaultLockRepository(dataSource); + repository.setCheckDatabaseOnStart(false); + repository.setTransactionManager(new DataSourceTransactionManager(dataSource)); + repository.afterPropertiesSet(); + repository.afterSingletonsInstantiated(); + repository.start(); + return repository; + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlFileserverMetadataStoreIntegrationTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlFileserverMetadataStoreIntegrationTest.java index 4c2d09c0..9f10df6a 100644 --- a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlFileserverMetadataStoreIntegrationTest.java +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlFileserverMetadataStoreIntegrationTest.java @@ -21,7 +21,7 @@ import dev.caskeleton.application.fileserver.api.metadata.QuotaScope; import dev.caskeleton.application.fileserver.api.metadata.UploadSession; import dev.caskeleton.application.fileserver.api.metadata.UploadSessionDraft; import dev.caskeleton.application.fileserver.api.metadata.WriterLease; -import dev.caskeleton.application.fileserver.api.transfer.UploadProtocol; +import dev.caskeleton.application.fileserver.api.transfer.UploadMode; import java.time.Clock; import java.time.Duration; import java.time.Instant; @@ -113,7 +113,7 @@ class PostgreSqlFileserverMetadataStoreIntegrationTest { verifying.version(), FileState.VERIFYING, FileState.READY, - FileRecordMutation.publishAt(contentKey, 10, DIGEST, ETAG, Instant.now()))); + FileRecordMutation.publishAt(contentKey, 10, DIGEST, Instant.now()))); CompletableFuture second = async( () -> @@ -122,7 +122,7 @@ class PostgreSqlFileserverMetadataStoreIntegrationTest { verifying.version(), FileState.VERIFYING, FileState.READY, - FileRecordMutation.publishAt(contentKey, 10, DIGEST, ETAG, Instant.now()))); + FileRecordMutation.publishAt(contentKey, 10, DIGEST, Instant.now()))); assertThat(successCount(first, second)).isEqualTo(1); assertThat(concurrentModificationCount(first, second)).isEqualTo(1); @@ -143,13 +143,18 @@ class PostgreSqlFileserverMetadataStoreIntegrationTest { verifying.version(), FileState.VERIFYING, FileState.READY, - FileRecordMutation.publishAt(contentKey, 10, DIGEST, ETAG, publishedAt))); + FileRecordMutation.publishAt(contentKey, 10, DIGEST, publishedAt))); assertThat(published.state()).isEqualTo(FileState.READY); assertThat(published.contentKey()).contains(contentKey); assertThat(published.actualSize()).hasValue(10); assertThat(published.sha256()).contains(DIGEST); - assertThat(published.strongEtag()).contains(ETAG); + assertThat( + jdbc.queryForObject( + "select strong_etag from fs_file where file_id = ?", + String.class, + published.fileId().value())) + .isEqualTo(ETAG); assertThat(published.publishedAt()).contains(publishedAt); assertThat(published.version()).isEqualTo(verifying.version() + 1); } @@ -370,7 +375,6 @@ class PostgreSqlFileserverMetadataStoreIntegrationTest { new ContentKey("ab/cd/" + UUID.randomUUID().toString().replace("-", "")), 10, DIGEST, - ETAG, Instant.now()))); } @@ -382,7 +386,7 @@ class PostgreSqlFileserverMetadataStoreIntegrationTest { new UploadSessionDraft( UploadId.of(UUID.randomUUID()), created.fileId(), - UploadProtocol.RAW, + UploadMode.SINGLE_SHOT, OptionalLong.of(10), Instant.now().plusSeconds(3600))); }); diff --git a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlFileserverReclamationIntegrationTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlFileserverReclamationIntegrationTest.java index b888be24..40ea3d60 100644 --- a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlFileserverReclamationIntegrationTest.java +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlFileserverReclamationIntegrationTest.java @@ -22,7 +22,7 @@ import dev.caskeleton.application.fileserver.api.metadata.FileRecordMutation; import dev.caskeleton.application.fileserver.api.metadata.QuotaScope; import dev.caskeleton.application.fileserver.api.metadata.UploadSession; import dev.caskeleton.application.fileserver.api.metadata.UploadSessionDraft; -import dev.caskeleton.application.fileserver.api.transfer.UploadProtocol; +import dev.caskeleton.application.fileserver.api.transfer.UploadMode; import dev.caskeleton.application.fileserver.cleanup.CleanupItem; import dev.caskeleton.application.fileserver.cleanup.CleanupRequest; import dev.caskeleton.application.fileserver.cleanup.CleanupType; @@ -428,8 +428,7 @@ class PostgreSqlFileserverReclamationIntegrationTest { verifying.version(), FileState.VERIFYING, FileState.READY, - FileRecordMutation.publishAt( - key, 10, "b".repeat(64), "\"" + "b".repeat(64) + "\"", Instant.now())); + FileRecordMutation.publishAt(key, 10, "b".repeat(64), Instant.now())); } private UploadSession insertSession(FileId fileId) { @@ -439,7 +438,7 @@ class PostgreSqlFileserverReclamationIntegrationTest { new UploadSessionDraft( UploadId.of(UUID.randomUUID()), fileId, - UploadProtocol.RAW, + UploadMode.SINGLE_SHOT, OptionalLong.of(1_000), Instant.now().plus(Duration.ofHours(1))))); } diff --git a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/IdempotencyUniqueScopeContractTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlIdempotencyUniqueScopeIntegrationTest.java similarity index 75% rename from src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/IdempotencyUniqueScopeContractTest.java rename to src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlIdempotencyUniqueScopeIntegrationTest.java index cd3a3816..99d3ddf9 100644 --- a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/IdempotencyUniqueScopeContractTest.java +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlIdempotencyUniqueScopeIntegrationTest.java @@ -1,9 +1,7 @@ -package dev.caskeleton.bootstrap.integration; +package dev.caskeleton.adapter.outbound.persistence.readiness; import static org.assertj.core.api.Assertions.assertThat; -import com.zaxxer.hikari.HikariConfig; -import com.zaxxer.hikari.HikariDataSource; import dev.caskeleton.adapter.outbound.persistence.failure.PersistenceExceptionTranslator; import dev.caskeleton.adapter.outbound.persistence.failure.StandardSqlStateErrorMapping; import dev.caskeleton.adapter.outbound.persistence.postgresql.PostgreSqlSqlStateErrorMapping; @@ -18,14 +16,9 @@ import java.util.UUID; import javax.sql.DataSource; import org.flywaydb.core.Flyway; import org.junit.jupiter.api.AfterAll; -import org.junit.jupiter.api.Assumptions; import org.junit.jupiter.api.BeforeAll; import org.junit.jupiter.api.Test; import org.springframework.dao.DataIntegrityViolationException; -import org.testcontainers.DockerClientFactory; -import org.testcontainers.junit.jupiter.Container; -import org.testcontainers.junit.jupiter.Testcontainers; -import org.testcontainers.postgresql.PostgreSQLContainer; /** * PostgreSQL contract test that pins the DDL → unique-scope → SQLState → error-code chain for @@ -34,11 +27,9 @@ import org.testcontainers.postgresql.PostgreSQLContainer; *

    Coverage gap this test fills

    * *
      - *
    • Outbox claim and distributed lock are already verified by real-PostgreSQL Testcontainers - * tests (OutboxRowLifecycleContractTest, OutboxPublisherLeaderElectionContractTest, - * OutboxAppendTransactionalContractTest, DistributedLockProviderContractTest). - *
    • This test fills the remaining gap: the {@code uq_idempotency_scope} unique constraint - * (columns: {@code tenant, principal, idempotency_key, use_case_name}, defined in {@code + *
    • Outbox, lock, and owner-safe idempotency behavior have separate PostgreSQL provider suites. + *
    • This test pins the legacy {@code uq_idempotency_scope} unique constraint (columns: {@code + * tenant, principal, idempotency_key, use_case_name}, defined in {@code * V1__idempotency_record.sql}) is exercised against a real PostgreSQL instance so that a * duplicate insert provably produces SQLState {@code 23505}, and the production {@link * PersistenceExceptionTranslator} chain maps it to {@link @@ -56,38 +47,25 @@ import org.testcontainers.postgresql.PostgreSQLContainer; * * The {@link PersistenceExceptionTranslator} is constructed with {@code List.of(new * StandardSqlStateErrorMapping(), new PostgreSqlSqlStateErrorMapping())} — the same composition - * used at production runtime and mirrored in {@link - * dev.caskeleton.bootstrap.contract.PersistenceFailureMappingContractTest}. This exercises the "DDL - * unique constraint → PG SQLState 23505 → DB_UNIQUE_VIOLATION" end-to-end chain with a real - * PostgreSQL error. + * used by the PostgreSQL persistence adapter. This exercises the "DDL unique constraint → PG + * SQLState 23505 → DB_UNIQUE_VIOLATION" end-to-end chain with a real PostgreSQL error. */ -@Testcontainers -class IdempotencyUniqueScopeContractTest { +class PostgreSqlIdempotencyUniqueScopeIntegrationTest { - @Container static final PostgreSQLContainer PG = PostgreSqlTestContainer.create(); + private static PostgreSqlReadinessSupport postgres; + private static DataSource sharedDataSource; - private static HikariDataSource sharedDataSource; - - /** - * Production TRANSLATOR composition: standard core rows + PostgreSQL vendor rows. Mirrors the - * composition used in {@link - * dev.caskeleton.bootstrap.contract.PersistenceFailureMappingContractTest}. - */ + /** Production translator composition: standard SQLSTATE rows plus PostgreSQL vendor rows. */ private static final PersistenceExceptionTranslator TRANSLATOR = new PersistenceExceptionTranslator( List.of(new StandardSqlStateErrorMapping(), new PostgreSqlSqlStateErrorMapping())); @BeforeAll static void setup() { - Assumptions.assumeTrue( - DockerClientFactory.instance().isDockerAvailable(), - "Docker not available — skipping Testcontainers-based idempotency unique-scope contract test"); + postgres = PostgreSqlReadinessSupport.start(); + sharedDataSource = postgres.dataSource(); - sharedDataSource = hikari(PG); - - // V1 (idempotency_record) + V2 (sample work_log) + V3 (outbox_event) + V4 (int_lock) - // are all under classpath:db/migration (from adapter:outbound:persistence-jpa on the test - // classpath via implementation project(':adapter:outbound:persistence-jpa')). + // The legacy PostgreSQL migration stream owns idempotency_record and its unique scope. Flyway.configure() .dataSource(sharedDataSource) .locations("classpath:db/migration/postgresql") @@ -97,8 +75,8 @@ class IdempotencyUniqueScopeContractTest { @AfterAll static void teardown() { - if (sharedDataSource != null) { - sharedDataSource.close(); + if (postgres != null) { + postgres.close(); } } @@ -210,14 +188,4 @@ class IdempotencyUniqueScopeContractTest { ps.executeUpdate(); } } - - private static HikariDataSource hikari(PostgreSQLContainer pg) { - HikariConfig cfg = new HikariConfig(); - cfg.setJdbcUrl(pg.getJdbcUrl()); - cfg.setUsername(pg.getUsername()); - cfg.setPassword(pg.getPassword()); - cfg.setMaximumPoolSize(5); - cfg.setMinimumIdle(1); - return new HikariDataSource(cfg); - } } diff --git a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/FlywayMigrationCompatibilityContractTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlIntLockMigrationCompatibilityIntegrationTest.java similarity index 67% rename from src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/FlywayMigrationCompatibilityContractTest.java rename to src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlIntLockMigrationCompatibilityIntegrationTest.java index 68753b95..266c3486 100644 --- a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/FlywayMigrationCompatibilityContractTest.java +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlIntLockMigrationCompatibilityIntegrationTest.java @@ -1,9 +1,7 @@ -package dev.caskeleton.bootstrap.integration; +package dev.caskeleton.adapter.outbound.persistence.readiness; import static org.assertj.core.api.Assertions.assertThat; -import com.zaxxer.hikari.HikariConfig; -import com.zaxxer.hikari.HikariDataSource; import java.io.IOException; import java.io.InputStream; import java.nio.charset.StandardCharsets; @@ -14,11 +12,9 @@ import java.sql.SQLException; import javax.sql.DataSource; import org.flywaydb.core.Flyway; import org.junit.jupiter.api.AfterAll; -import org.junit.jupiter.api.Assumptions; +import org.junit.jupiter.api.BeforeAll; import org.junit.jupiter.api.Test; import org.junit.jupiter.api.io.TempDir; -import org.testcontainers.DockerClientFactory; -import org.testcontainers.postgresql.PostgreSQLContainer; /** * Migration compatibility contracts for already-applied PostgreSQL development schemas. @@ -27,7 +23,7 @@ import org.testcontainers.postgresql.PostgreSQLContainer; * validates checksums before serving traffic, so an edited versioned migration fails existing * databases even when a fresh Testcontainers database still passes. */ -class FlywayMigrationCompatibilityContractTest { +class PostgreSqlIntLockMigrationCompatibilityIntegrationTest { private static final String OLD_V4_INT_LOCK = """ @@ -43,27 +39,29 @@ class FlywayMigrationCompatibilityContractTest { ); """; - private static PostgreSQLContainer pg; - private static HikariDataSource dataSource; + private static PostgreSqlReadinessSupport postgres; + + @BeforeAll + static void startPostgreSql() { + postgres = PostgreSqlReadinessSupport.start(); + } @AfterAll - static void stopContainer() { - if (dataSource != null) { - dataSource.close(); - } - if (pg != null) { - pg.stop(); + static void stopPostgreSql() { + if (postgres != null) { + postgres.close(); } } @Test void existingDatabaseWithOriginalV4MigratesForwardToExpiredAfterColumn(@TempDir Path tempDir) throws Exception { - assumeDockerAvailable(); - startContainer(); - Path oldLocation = migrationLocation(tempDir.resolve("old"), OLD_V4_INT_LOCK, null); - Flyway.configure().dataSource(dataSource).locations(flywayPath(oldLocation)).load().migrate(); + Flyway.configure() + .dataSource(postgres.dataSource()) + .locations(flywayPath(oldLocation)) + .load() + .migrate(); Path currentLocation = migrationLocation( @@ -71,32 +69,12 @@ class FlywayMigrationCompatibilityContractTest { resourceText("/db/migration/postgresql/V4__int_lock.sql"), resourceText("/db/migration/postgresql/V5__int_lock_expired_after.sql")); Flyway.configure() - .dataSource(dataSource) + .dataSource(postgres.dataSource()) .locations(flywayPath(currentLocation)) .load() .migrate(); - assertThat(hasExpiredAfterColumn(dataSource)).isTrue(); - } - - private static void assumeDockerAvailable() { - Assumptions.assumeTrue( - DockerClientFactory.instance().isDockerAvailable(), - "Docker not available — skipping Testcontainers-based migration compatibility test"); - } - - private static void startContainer() { - if (pg != null) { - return; - } - pg = PostgreSqlTestContainer.create(); - pg.start(); - - HikariConfig config = new HikariConfig(); - config.setJdbcUrl(pg.getJdbcUrl()); - config.setUsername(pg.getUsername()); - config.setPassword(pg.getPassword()); - dataSource = new HikariDataSource(config); + assertThat(hasExpiredAfterColumn(postgres.dataSource())).isTrue(); } private static Path migrationLocation(Path directory, String v4, String v5) throws IOException { @@ -111,7 +89,7 @@ class FlywayMigrationCompatibilityContractTest { private static String resourceText(String path) throws IOException { try (InputStream stream = - FlywayMigrationCompatibilityContractTest.class.getResourceAsStream(path)) { + PostgreSqlIntLockMigrationCompatibilityIntegrationTest.class.getResourceAsStream(path)) { assertThat(stream).as("migration resource %s", path).isNotNull(); return new String(stream.readAllBytes(), StandardCharsets.UTF_8); } diff --git a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlLegacyOutboxAppendTransactionalIntegrationTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlLegacyOutboxAppendTransactionalIntegrationTest.java new file mode 100644 index 00000000..ac0be38f --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlLegacyOutboxAppendTransactionalIntegrationTest.java @@ -0,0 +1,73 @@ +package dev.caskeleton.adapter.outbound.persistence.readiness; + +import dev.caskeleton.adapter.outbound.persistence.outbox.OutboxEventJpaRepository; +import dev.caskeleton.application.outbox.LegacyOutboxAppendPort; +import dev.caskeleton.application.outbox.testkit.LegacyOutboxAppendContract; +import dev.caskeleton.application.transaction.TransactionPort; +import java.time.Clock; +import java.time.Instant; +import java.time.ZoneOffset; +import javax.sql.DataSource; +import org.junit.jupiter.api.AfterAll; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; +import org.springframework.context.annotation.AnnotationConfigApplicationContext; + +/** + * Integration test #2 — dual-write prohibition: outbox append participates in the caller's + * transaction; on rollback the outbox row is absent. + * + *

      Proves the no-dual-write guarantee (D2): if the business transaction rolls back, the outbox + * row vanishes with it — there is no separate out-of-band insert. + */ +class PostgreSqlLegacyOutboxAppendTransactionalIntegrationTest { + + private static PostgreSqlReadinessSupport postgres; + private static DataSource sharedDataSource; + + @BeforeAll + static void setup() { + postgres = PostgreSqlReadinessSupport.start(); + sharedDataSource = postgres.dataSource(); + LegacyOutboxIntegrationSupport.migrate(sharedDataSource); + } + + @AfterAll + static void cleanup() { + if (postgres != null) { + postgres.close(); + } + } + + @Test + void sameTransactionAppendRollbackRemovesOutboxRowCharacterization() { + Clock clock = Clock.fixed(Instant.now(), ZoneOffset.UTC); + + try (AnnotationConfigApplicationContext ctx = + LegacyOutboxIntegrationSupport.buildContext(sharedDataSource, e -> {}, clock)) { + + TransactionPort tx = ctx.getBean(TransactionPort.class); + LegacyOutboxAppendPort append = ctx.getBean(LegacyOutboxAppendPort.class); + + OutboxEventJpaRepository repo = ctx.getBean(OutboxEventJpaRepository.class); + LegacyOutboxAppendContract.verifyRollbackRemovesEvent( + tx, append, eventId -> repo.findById(eventId).isPresent(), clock); + } + } + + @Test + void outboxRowIsPresentWhenTransactionCommits() { + Clock clock = Clock.fixed(Instant.now(), ZoneOffset.UTC); + + try (AnnotationConfigApplicationContext ctx = + LegacyOutboxIntegrationSupport.buildContext(sharedDataSource, e -> {}, clock)) { + + TransactionPort tx = ctx.getBean(TransactionPort.class); + LegacyOutboxAppendPort append = ctx.getBean(LegacyOutboxAppendPort.class); + + OutboxEventJpaRepository repo = ctx.getBean(OutboxEventJpaRepository.class); + LegacyOutboxAppendContract.verifyCommitPersistsEvent( + tx, append, eventId -> repo.findById(eventId).isPresent(), clock); + } + } +} diff --git a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/outbox/OutboxPublisherLeaderElectionContractTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlLegacyOutboxConcurrentRelayIntegrationTest.java similarity index 83% rename from src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/outbox/OutboxPublisherLeaderElectionContractTest.java rename to src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlLegacyOutboxConcurrentRelayIntegrationTest.java index a0192bdd..c900c0d7 100644 --- a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/outbox/OutboxPublisherLeaderElectionContractTest.java +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlLegacyOutboxConcurrentRelayIntegrationTest.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.integration.outbox; +package dev.caskeleton.adapter.outbound.persistence.readiness; import static org.assertj.core.api.Assertions.assertThat; @@ -8,7 +8,6 @@ import dev.caskeleton.application.outbox.OutboxRelayResult; import dev.caskeleton.application.outbox.PublishPendingOutboxEventsCommand; import dev.caskeleton.application.outbox.PublishPendingOutboxEventsUseCase; import dev.caskeleton.application.transaction.TransactionPort; -import dev.caskeleton.bootstrap.integration.PostgreSqlTestContainer; import java.time.Clock; import java.time.Instant; import java.time.ZoneOffset; @@ -24,9 +23,6 @@ import org.junit.jupiter.api.AfterAll; import org.junit.jupiter.api.BeforeAll; import org.junit.jupiter.api.Test; import org.springframework.context.annotation.AnnotationConfigApplicationContext; -import org.testcontainers.junit.jupiter.Container; -import org.testcontainers.junit.jupiter.Testcontainers; -import org.testcontainers.postgresql.PostgreSQLContainer; /** * Integration test #5 — multi-instance relay (leader-election via SKIP LOCKED). @@ -38,26 +34,22 @@ import org.testcontainers.postgresql.PostgreSQLContainer; * ConcurrentHashMap}. Both relay loops run until the store is drained (claimedCount == 0 for both * instances). Then assert total = 1000, duplicates = 0. */ -@Testcontainers -class OutboxPublisherLeaderElectionContractTest { - - @Container - static final PostgreSQLContainer PG = - PostgreSqlTestContainer.create(OutboxContainerTestSupport.PG_IMAGE); +class PostgreSqlLegacyOutboxConcurrentRelayIntegrationTest { + private static PostgreSqlReadinessSupport postgres; private static DataSource sharedDataSource; @BeforeAll static void setup() { - OutboxContainerTestSupport.assumeDockerAvailable(); - sharedDataSource = OutboxContainerTestSupport.dataSource(PG); - OutboxContainerTestSupport.migrate(sharedDataSource); + postgres = PostgreSqlReadinessSupport.start(); + sharedDataSource = postgres.dataSource(); + LegacyOutboxIntegrationSupport.migrate(sharedDataSource); } @AfterAll - static void cleanup() throws Exception { - if (sharedDataSource instanceof AutoCloseable ac) { - ac.close(); + static void cleanup() { + if (postgres != null) { + postgres.close(); } } @@ -74,7 +66,7 @@ class OutboxPublisherLeaderElectionContractTest { Clock clock = Clock.fixed(t0.plusSeconds(1), ZoneOffset.UTC); AnnotationConfigApplicationContext seedCtx = - OutboxContainerTestSupport.buildContext(sharedDataSource, e -> {}, clock); + LegacyOutboxIntegrationSupport.buildContext(sharedDataSource, e -> {}, clock); TransactionPort seedTx = seedCtx.getBean(TransactionPort.class); LegacyOutboxAppendPort appendPort = seedCtx.getBean(LegacyOutboxAppendPort.class); @@ -102,7 +94,7 @@ class OutboxPublisherLeaderElectionContractTest { // ---- build two independent contexts, each with its own stub publisher ---- AnnotationConfigApplicationContext ctx1 = - OutboxContainerTestSupport.buildContext( + LegacyOutboxIntegrationSupport.buildContext( sharedDataSource, event -> { String prev = publishedByEventId.put(event.eventId(), "instance-1"); @@ -113,7 +105,7 @@ class OutboxPublisherLeaderElectionContractTest { clock); AnnotationConfigApplicationContext ctx2 = - OutboxContainerTestSupport.buildContext( + LegacyOutboxIntegrationSupport.buildContext( sharedDataSource, event -> { String prev = publishedByEventId.put(event.eventId(), "instance-2"); @@ -123,8 +115,8 @@ class OutboxPublisherLeaderElectionContractTest { }, clock); - PublishPendingOutboxEventsUseCase relay1 = OutboxContainerTestSupport.relayUseCase(ctx1); - PublishPendingOutboxEventsUseCase relay2 = OutboxContainerTestSupport.relayUseCase(ctx2); + PublishPendingOutboxEventsUseCase relay1 = LegacyOutboxIntegrationSupport.relayUseCase(ctx1); + PublishPendingOutboxEventsUseCase relay2 = LegacyOutboxIntegrationSupport.relayUseCase(ctx2); // ---- drive both relay loops concurrently until drained ---- ExecutorService executor = Executors.newFixedThreadPool(2); diff --git a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/outbox/OutboxRowLifecycleContractTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlLegacyOutboxRowLifecycleIntegrationTest.java similarity index 92% rename from src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/outbox/OutboxRowLifecycleContractTest.java rename to src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlLegacyOutboxRowLifecycleIntegrationTest.java index 40467334..06b08dd6 100644 --- a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/outbox/OutboxRowLifecycleContractTest.java +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlLegacyOutboxRowLifecycleIntegrationTest.java @@ -1,4 +1,4 @@ -package dev.caskeleton.bootstrap.integration.outbox; +package dev.caskeleton.adapter.outbound.persistence.readiness; import static org.assertj.core.api.Assertions.assertThat; @@ -15,7 +15,6 @@ import dev.caskeleton.application.outbox.OutboxRelayResult; import dev.caskeleton.application.outbox.PublishPendingOutboxEventsCommand; import dev.caskeleton.application.outbox.PublishPendingOutboxEventsUseCase; import dev.caskeleton.application.transaction.TransactionPort; -import dev.caskeleton.bootstrap.integration.PostgreSqlTestContainer; import java.time.Clock; import java.time.Duration; import java.time.Instant; @@ -30,9 +29,6 @@ import org.junit.jupiter.api.AfterAll; import org.junit.jupiter.api.BeforeAll; import org.junit.jupiter.api.Test; import org.springframework.context.annotation.AnnotationConfigApplicationContext; -import org.testcontainers.junit.jupiter.Container; -import org.testcontainers.junit.jupiter.Testcontainers; -import org.testcontainers.postgresql.PostgreSQLContainer; /** * Row lifecycle integration test (feature-domain-event-outbox-contract Task E). @@ -48,26 +44,22 @@ import org.testcontainers.postgresql.PostgreSQLContainer; *

    • Reaper TTL deletion of PUBLISHED rows *
    */ -@Testcontainers -class OutboxRowLifecycleContractTest { - - @Container - static final PostgreSQLContainer PG = - PostgreSqlTestContainer.create(OutboxContainerTestSupport.PG_IMAGE); +class PostgreSqlLegacyOutboxRowLifecycleIntegrationTest { + private static PostgreSqlReadinessSupport postgres; private static DataSource sharedDataSource; @BeforeAll static void setup() { - OutboxContainerTestSupport.assumeDockerAvailable(); - sharedDataSource = OutboxContainerTestSupport.dataSource(PG); - OutboxContainerTestSupport.migrate(sharedDataSource); + postgres = PostgreSqlReadinessSupport.start(); + sharedDataSource = postgres.dataSource(); + LegacyOutboxIntegrationSupport.migrate(sharedDataSource); } @AfterAll - static void cleanup() throws Exception { - if (sharedDataSource instanceof AutoCloseable ac) { - ac.close(); + static void cleanup() { + if (postgres != null) { + postgres.close(); } } @@ -79,7 +71,7 @@ class OutboxRowLifecycleContractTest { void pendingRowTransitionsToPublishedOnSuccessfulRelay() { Clock clock = Clock.fixed(Instant.now(), ZoneOffset.UTC); try (AnnotationConfigApplicationContext ctx = - OutboxContainerTestSupport.buildContext(sharedDataSource, e -> {}, clock)) { + LegacyOutboxIntegrationSupport.buildContext(sharedDataSource, e -> {}, clock)) { TransactionPort tx = ctx.getBean(TransactionPort.class); LegacyOutboxAppendPort append = ctx.getBean(LegacyOutboxAppendPort.class); @@ -92,7 +84,7 @@ class OutboxRowLifecycleContractTest { return null; }); - PublishPendingOutboxEventsUseCase relay = OutboxContainerTestSupport.relayUseCase(ctx); + PublishPendingOutboxEventsUseCase relay = LegacyOutboxIntegrationSupport.relayUseCase(ctx); OutboxRelayResult result = relay.handle(PublishPendingOutboxEventsCommand.INSTANCE); long published = @@ -122,7 +114,7 @@ class OutboxRowLifecycleContractTest { AtomicBoolean fail = new AtomicBoolean(true); try (AnnotationConfigApplicationContext ctx = - OutboxContainerTestSupport.buildContext( + LegacyOutboxIntegrationSupport.buildContext( sharedDataSource, e -> { if (fail.get()) { @@ -142,7 +134,7 @@ class OutboxRowLifecycleContractTest { return null; }); - PublishPendingOutboxEventsUseCase relay = OutboxContainerTestSupport.relayUseCase(ctx); + PublishPendingOutboxEventsUseCase relay = LegacyOutboxIntegrationSupport.relayUseCase(ctx); OutboxRelayResult result = relay.handle(PublishPendingOutboxEventsCommand.INSTANCE); long failed = @@ -179,7 +171,7 @@ class OutboxRowLifecycleContractTest { AtomicInteger publishAttempts = new AtomicInteger(0); try (AnnotationConfigApplicationContext ctx = - OutboxContainerTestSupport.buildContext( + LegacyOutboxIntegrationSupport.buildContext( sharedDataSource, e -> { publishAttempts.incrementAndGet(); @@ -252,7 +244,7 @@ class OutboxRowLifecycleContractTest { Clock clock = Clock.fixed(t0.plusSeconds(1), ZoneOffset.UTC); try (AnnotationConfigApplicationContext ctx = - OutboxContainerTestSupport.buildContext(sharedDataSource, e -> {}, clock)) { + LegacyOutboxIntegrationSupport.buildContext(sharedDataSource, e -> {}, clock)) { TransactionPort tx = ctx.getBean(TransactionPort.class); LegacyOutboxAppendPort append = ctx.getBean(LegacyOutboxAppendPort.class); @@ -270,7 +262,7 @@ class OutboxRowLifecycleContractTest { return null; }); - PublishPendingOutboxEventsUseCase relay = OutboxContainerTestSupport.relayUseCase(ctx); + PublishPendingOutboxEventsUseCase relay = LegacyOutboxIntegrationSupport.relayUseCase(ctx); // --- Relay cycle 1: FIFO gate blocks tail while head is PENDING --- // The NOT EXISTS gate allows only the head (head has no non-PUBLISHED @@ -321,7 +313,7 @@ class OutboxRowLifecycleContractTest { Clock clock = Clock.fixed(occurredAt.plusSeconds(1), ZoneOffset.UTC); try (AnnotationConfigApplicationContext ctx = - OutboxContainerTestSupport.buildContext(sharedDataSource, e -> {}, clock)) { + LegacyOutboxIntegrationSupport.buildContext(sharedDataSource, e -> {}, clock)) { TransactionPort tx = ctx.getBean(TransactionPort.class); LegacyOutboxAppendPort append = ctx.getBean(LegacyOutboxAppendPort.class); @@ -338,7 +330,7 @@ class OutboxRowLifecycleContractTest { }); OutboxRelayResult cycle = - OutboxContainerTestSupport.relayUseCase(ctx) + LegacyOutboxIntegrationSupport.relayUseCase(ctx) .handle(PublishPendingOutboxEventsCommand.INSTANCE); assertThat(cycle.outcomes()) @@ -370,7 +362,7 @@ class OutboxRowLifecycleContractTest { Clock clock = Clock.fixed(t0, ZoneOffset.UTC); try (AnnotationConfigApplicationContext ctx = - OutboxContainerTestSupport.buildContext( + LegacyOutboxIntegrationSupport.buildContext( sharedDataSource, e -> { throw new RuntimeException("forced failure for head"); @@ -396,7 +388,7 @@ class OutboxRowLifecycleContractTest { // Relay cycle 1: head is claimed and fails → transitions to FAILED // with nextAttemptAt = t0 + backoff (far in the future). // Tail is already blocked by the FIFO gate (head is PENDING). - PublishPendingOutboxEventsUseCase relay = OutboxContainerTestSupport.relayUseCase(ctx); + PublishPendingOutboxEventsUseCase relay = LegacyOutboxIntegrationSupport.relayUseCase(ctx); OutboxRelayResult cycle1 = relay.handle(PublishPendingOutboxEventsCommand.INSTANCE); assertThat( @@ -443,7 +435,7 @@ class OutboxRowLifecycleContractTest { Clock clock = Clock.fixed(t0.plusSeconds(1), ZoneOffset.UTC); try (AnnotationConfigApplicationContext ctx = - OutboxContainerTestSupport.buildContext(sharedDataSource, e -> {}, clock)) { + LegacyOutboxIntegrationSupport.buildContext(sharedDataSource, e -> {}, clock)) { TransactionPort tx = ctx.getBean(TransactionPort.class); LegacyOutboxAppendPort append = ctx.getBean(LegacyOutboxAppendPort.class); @@ -461,7 +453,7 @@ class OutboxRowLifecycleContractTest { return null; }); - PublishPendingOutboxEventsUseCase relay = OutboxContainerTestSupport.relayUseCase(ctx); + PublishPendingOutboxEventsUseCase relay = LegacyOutboxIntegrationSupport.relayUseCase(ctx); // Cycle 1: head is claimed and published, tail is blocked. OutboxRelayResult cycle1 = relay.handle(PublishPendingOutboxEventsCommand.INSTANCE); @@ -505,7 +497,7 @@ class OutboxRowLifecycleContractTest { Instant t0 = Instant.now(); try (AnnotationConfigApplicationContext ctx = - OutboxContainerTestSupport.buildContext( + LegacyOutboxIntegrationSupport.buildContext( sharedDataSource, e -> { throw new RuntimeException("always fails"); @@ -586,7 +578,7 @@ class OutboxRowLifecycleContractTest { Clock reclaimClock = Clock.fixed(t0.plus(Duration.ofSeconds(31)), ZoneOffset.UTC); try (AnnotationConfigApplicationContext ctx = - OutboxContainerTestSupport.buildContext(sharedDataSource, e -> {}, claimClock)) { + LegacyOutboxIntegrationSupport.buildContext(sharedDataSource, e -> {}, claimClock)) { TransactionPort tx = ctx.getBean(TransactionPort.class); LegacyOutboxAppendPort append = ctx.getBean(LegacyOutboxAppendPort.class); @@ -617,8 +609,8 @@ class OutboxRowLifecycleContractTest { ctx.getBean(TransactionPort.class), new OutboxBackoffPolicy(RandomGenerator.getDefault()), reclaimClock, - OutboxContainerTestSupport.BATCH_SIZE_CONTRACT, - OutboxContainerTestSupport.IN_FLIGHT_TIMEOUT); + LegacyOutboxIntegrationSupport.BATCH_SIZE_CONTRACT, + LegacyOutboxIntegrationSupport.IN_FLIGHT_TIMEOUT); OutboxRelayResult reclaimResult = reclaimRelay.handle(PublishPendingOutboxEventsCommand.INSTANCE); @@ -643,7 +635,7 @@ class OutboxRowLifecycleContractTest { Clock clock = Clock.fixed(Instant.now(), ZoneOffset.UTC); try (AnnotationConfigApplicationContext ctx = - OutboxContainerTestSupport.buildContext(sharedDataSource, e -> {}, clock)) { + LegacyOutboxIntegrationSupport.buildContext(sharedDataSource, e -> {}, clock)) { TransactionPort tx = ctx.getBean(TransactionPort.class); LegacyOutboxAppendPort append = ctx.getBean(LegacyOutboxAppendPort.class); @@ -707,8 +699,8 @@ class OutboxRowLifecycleContractTest { ctx.getBean(TransactionPort.class), new OutboxBackoffPolicy(RandomGenerator.getDefault()), Clock.fixed(clockInstant, ZoneOffset.UTC), - OutboxContainerTestSupport.BATCH_SIZE_CONTRACT, - OutboxContainerTestSupport.IN_FLIGHT_TIMEOUT); + LegacyOutboxIntegrationSupport.BATCH_SIZE_CONTRACT, + LegacyOutboxIntegrationSupport.IN_FLIGHT_TIMEOUT); } private static NewOutboxEvent newEvent(String eventId, String aggregateId, Clock clock) { diff --git a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlMigrationIntegrationTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlMigrationIntegrationTest.java index 0bf0bfcb..5a07c452 100644 --- a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlMigrationIntegrationTest.java +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlMigrationIntegrationTest.java @@ -48,7 +48,7 @@ class PostgreSqlMigrationIntegrationTest { .migrate(); assertThat(appliedVersions(postgres, "flyway_schema_history")) - .containsExactly("1", "3", "4", "5", "6", "9", "10", "11", "12", "13"); + .containsExactly("1", "3", "4", "5", "6", "9", "10", "11", "12", "13", "14", "15"); Flyway coreStream = Flyway.configure() @@ -216,6 +216,12 @@ class PostgreSqlMigrationIntegrationTest { assertColumn(database, "correlation_id", "character varying", 128); assertColumn(database, "envelope_bytes", "bytea", null); assertColumn(database, "tenant_scope", "character varying", 96); + assertColumn(database, "partition_key", "character varying", 64); + assertColumn(database, "schema_set_hash", "character varying", 64); + assertColumn(database, "envelope_sha256", "character varying", 64); + assertColumn(database, "envelope_schema_hash", "character varying", 64); + assertColumn(database, "payload_schema_hash", "character varying", 64); + assertCanonicalOutboxConstraintsValidated(database); database.execute( """ @@ -268,6 +274,37 @@ class PostgreSqlMigrationIntegrationTest { } } + private static void assertCanonicalOutboxConstraintsValidated(PostgreSqlReadinessSupport database) + throws Exception { + try (Connection connection = database.connection(); + PreparedStatement statement = + connection.prepareStatement( + """ + select conname, convalidated + from pg_constraint + where conrelid = 'outbox_event'::regclass + and conname like 'ck_outbox_event_canonical_%' + order by conname + """); + ResultSet result = statement.executeQuery()) { + List validated = new ArrayList<>(); + while (result.next()) { + assertThat(result.getBoolean("convalidated")) + .as("constraint %s is validated", result.getString("conname")) + .isTrue(); + validated.add(result.getString("conname")); + } + assertThat(validated) + .containsExactly( + "ck_outbox_event_canonical_envelope_bytes", + "ck_outbox_event_canonical_hashes", + "ck_outbox_event_canonical_partition_key", + "ck_outbox_event_canonical_required_text", + "ck_outbox_event_canonical_shape", + "ck_outbox_event_canonical_versions"); + } + } + private static void insertCanonical(PostgreSqlReadinessSupport database, byte[] exactEnvelope) throws Exception { try (Connection connection = database.connection(); diff --git a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlNotificationPersistenceUnitIntegrationTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlNotificationPersistenceUnitIntegrationTest.java index a14e9612..c2e1f85b 100644 --- a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlNotificationPersistenceUnitIntegrationTest.java +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlNotificationPersistenceUnitIntegrationTest.java @@ -3,14 +3,28 @@ package dev.caskeleton.adapter.outbound.persistence.readiness; import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.assertThatCode; +import dev.caskeleton.adapter.outbound.persistence.notification.platform.AdminAuditJpaRepository; +import dev.caskeleton.adapter.outbound.persistence.notification.platform.JpaAdminOperationStore; +import dev.caskeleton.application.notification.platform.admin.AdminActor; +import dev.caskeleton.application.notification.platform.admin.AdminOperationClaim; +import dev.caskeleton.application.notification.platform.admin.AdminOperationResult; +import jakarta.persistence.EntityManager; import jakarta.persistence.EntityManagerFactory; +import java.time.Clock; +import java.time.Instant; +import java.time.ZoneOffset; +import java.util.List; import java.util.Map; +import java.util.Optional; +import java.util.Set; import java.util.UUID; +import java.util.concurrent.atomic.AtomicLong; import javax.sql.DataSource; import org.flywaydb.core.Flyway; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Tag; import org.junit.jupiter.api.Test; +import org.springframework.data.jpa.repository.support.JpaRepositoryFactory; import org.springframework.jdbc.core.JdbcTemplate; import org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean; import org.springframework.orm.jpa.vendor.HibernateJpaVendorAdapter; @@ -90,6 +104,65 @@ class PostgreSqlNotificationPersistenceUnitIntegrationTest { } } + @Test + @DisplayName("an admin claim is completed in place and the next caller replays it") + void adminClaimCompletesInPlaceAndReplays() throws Exception { + try (PostgreSqlReadinessSupport database = PostgreSqlReadinessSupport.start()) { + migrate(database); + JdbcTemplate jdbc = new JdbcTemplate(database.dataSource()); + try (EntityManagerFactory emf = entityManagerFactory(database.dataSource()); + EntityManager entityManager = emf.createEntityManager()) { + AdminAuditJpaRepository repository = + new JpaRepositoryFactory(entityManager).getRepository(AdminAuditJpaRepository.class); + AtomicLong ids = new AtomicLong(); + JpaAdminOperationStore store = + new JpaAdminOperationStore( + repository, + () -> new UUID(0x0000000000007000L, ids.incrementAndGet()), + Clock.fixed(Instant.parse("2026-08-15T09:00:00Z"), ZoneOffset.UTC)); + AdminActor actor = new AdminActor("operator-1", Set.of(), Optional.empty()); + String fingerprint = "a".repeat(64); + AdminOperationResult result = + new AdminOperationResult( + "op-1", + false, + 1, + Optional.empty(), + Optional.empty(), + Optional.empty(), + List.of("done")); + + entityManager.getTransaction().begin(); + AdminOperationClaim first = store.claim("op-1", fingerprint, actor, "ADMIN_PROVIDER_STATE"); + assertThat(first.outcome()).isEqualTo(AdminOperationClaim.Outcome.CLAIMED); + store.save(result, actor, "ADMIN_PROVIDER_STATE"); + entityManager.getTransaction().commit(); + entityManager.clear(); + + entityManager.getTransaction().begin(); + AdminOperationClaim second = + store.claim("op-1", fingerprint, actor, "ADMIN_PROVIDER_STATE"); + entityManager.getTransaction().commit(); + + assertThat(second.outcome()).isEqualTo(AdminOperationClaim.Outcome.REPLAY); + assertThat(second.existing()).isPresent(); + assertThat(second.existing().orElseThrow().operationId()).isEqualTo("op-1"); + assertThat( + jdbc.queryForObject( + "select count(*) from notification_admin_audit where operation_id = ?", + Integer.class, + "op-1")) + .isEqualTo(1); + assertThat( + jdbc.queryForObject( + "select phase from notification_admin_audit where operation_id = ?", + String.class, + "op-1")) + .isEqualTo("COMPLETED"); + } + } + } + @Test @DisplayName("a request with no locale is stored as absent, not as a guessed default") void anAbsentLocaleStaysAbsent() throws Exception { diff --git a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlNotificationSchemaManifestIntegrationTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlNotificationSchemaManifestIntegrationTest.java index 52e51496..bb8568f9 100644 --- a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlNotificationSchemaManifestIntegrationTest.java +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlNotificationSchemaManifestIntegrationTest.java @@ -13,12 +13,16 @@ import java.util.List; import java.util.Locale; import java.util.Map; import java.util.TreeMap; +import dev.caskeleton.adapter.outbound.persistence.notification.NotificationJpaPersistenceConfig; import org.flywaydb.core.Flyway; import org.hibernate.annotations.JdbcTypeCode; import org.hibernate.type.SqlTypes; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Tag; import org.junit.jupiter.api.Test; +import org.springframework.boot.persistence.autoconfigure.EntityScan; +import org.springframework.context.annotation.ClassPathScanningCandidateComponentProvider; +import org.springframework.core.type.filter.AnnotationTypeFilter; import org.springframework.jdbc.core.JdbcTemplate; /** @@ -36,29 +40,6 @@ import org.springframework.jdbc.core.JdbcTemplate; @Tag("jpa-migration") class PostgreSqlNotificationSchemaManifestIntegrationTest { - /** Entities whose tables the notification stream owns. */ - private static final List> ENTITIES = - List.of( - dev.caskeleton.adapter.outbound.persistence.notification.platform - .NotificationRequestEntity.class, - dev.caskeleton.adapter.outbound.persistence.notification.platform.RecipientDeliveryEntity - .class, - dev.caskeleton.adapter.outbound.persistence.notification.platform.DeliveryAttemptEntity - .class, - dev.caskeleton.adapter.outbound.persistence.notification.platform.ProviderEventEntity - .class, - dev.caskeleton.adapter.outbound.persistence.notification.platform.ContactPointEntity - .class, - dev.caskeleton.adapter.outbound.persistence.notification.platform.SuppressionEntity.class, - dev.caskeleton.adapter.outbound.persistence.notification.platform.TemplateVersionEntity - .class, - dev.caskeleton.adapter.outbound.persistence.notification.platform.ConsentEntity.class, - dev.caskeleton.adapter.outbound.persistence.notification.platform.PreferenceEntity.class, - dev.caskeleton.adapter.outbound.persistence.notification.platform.DeduplicationClaimEntity - .class, - dev.caskeleton.adapter.outbound.persistence.notification.platform.AdminAuditEntity.class, - dev.caskeleton.adapter.outbound.persistence.notification.platform.inbox.InboxItemEntity - .class); @Test @DisplayName("every mapped column exists in the migrated schema") @@ -67,7 +48,7 @@ class PostgreSqlNotificationSchemaManifestIntegrationTest { Map> schema = migrateAndDescribe(database); List missing = new ArrayList<>(); - for (Class entity : ENTITIES) { + for (Class entity : notificationEntities()) { String table = tableName(entity); Map columns = schema.getOrDefault(table, Map.of()); assertThat(columns).as("table %s is missing entirely", table).isNotEmpty(); @@ -91,7 +72,7 @@ class PostgreSqlNotificationSchemaManifestIntegrationTest { Map> schema = migrateAndDescribe(database); List untyped = new ArrayList<>(); - for (Class entity : ENTITIES) { + for (Class entity : notificationEntities()) { Map columns = schema.getOrDefault(tableName(entity), Map.of()); mappedColumns(entity) .forEach( @@ -116,7 +97,7 @@ class PostgreSqlNotificationSchemaManifestIntegrationTest { Map> schema = migrateAndDescribe(database); List overlong = new ArrayList<>(); - for (Class entity : ENTITIES) { + for (Class entity : notificationEntities()) { Map columns = schema.getOrDefault(tableName(entity), Map.of()); mappedColumns(entity) .forEach( @@ -151,7 +132,7 @@ class PostgreSqlNotificationSchemaManifestIntegrationTest { Map> schema = migrateAndDescribe(database); List disagreements = new ArrayList<>(); - for (Class entity : ENTITIES) { + for (Class entity : notificationEntities()) { Map columns = schema.getOrDefault(tableName(entity), Map.of()); mappedColumns(entity) .forEach( @@ -230,6 +211,34 @@ class PostgreSqlNotificationSchemaManifestIntegrationTest { return schema; } + + private static List> notificationEntities() { + EntityScan scan = NotificationJpaPersistenceConfig.class.getAnnotation(EntityScan.class); + if (scan == null) { + throw new IllegalStateException("NotificationJpaPersistenceConfig lost @EntityScan"); + } + ClassPathScanningCandidateComponentProvider scanner = + new ClassPathScanningCandidateComponentProvider(false); + scanner.addIncludeFilter(new AnnotationTypeFilter(Entity.class)); + + List> entities = new ArrayList<>(); + for (String basePackage : scan.basePackages()) { + scanner.findCandidateComponents(basePackage).stream() + .map(definition -> definition.getBeanClassName()) + .filter(java.util.Objects::nonNull) + .sorted() + .forEach( + className -> { + try { + entities.add(Class.forName(className)); + } catch (ClassNotFoundException missing) { + throw new IllegalStateException("scanned notification entity is not loadable: " + className, missing); + } + }); + } + return List.copyOf(entities); + } + private static String tableName(Class entity) { Table table = entity.getAnnotation(Table.class); if (table != null && !table.name().isBlank()) { diff --git a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlOptionalStreamLifecycle.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlOptionalStreamLifecycle.java index 34446a87..6828c7b1 100644 --- a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlOptionalStreamLifecycle.java +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlOptionalStreamLifecycle.java @@ -58,7 +58,7 @@ final class PostgreSqlOptionalStreamLifecycle { "outbox_publication_cutover_v2", "outbox_event_identity_v2", "outbox_event_log_v2"), - List.of("0", "1"), + List.of("0", "1", "2"), List.of()); } @@ -69,7 +69,7 @@ final class PostgreSqlOptionalStreamLifecycle { "flyway_jpa_outbox_polling_history", 2, List.of("outbox_delivery_v2"), - List.of("0", "1"), + List.of("0", "1", "2"), List.of(outboxStorage())); } @@ -150,6 +150,71 @@ final class PostgreSqlOptionalStreamLifecycle { verifyInterruptedRecovery(stream); } + static void verifyOutboxStorageUpgradeWithExistingPollingV1() { + try (PostgreSqlReadinessSupport database = PostgreSqlReadinessSupport.start()) { + Stream core = + new Stream( + "jpa-flyway-migration", + "classpath:db/migration/jpa/core", + "flyway_jpa_core_history", + 1, + List.of("capability_schema_registry"), + List.of("0", "1", "2"), + List.of()); + migrateAndActivate(database, core); + + Stream storage = outboxStorage(); + Flyway storageV1 = + Flyway.configure() + .dataSource(database.dataSource()) + .locations(storage.location()) + .table(storage.historyTable()) + .baselineVersion("0") + .baselineDescription("explicit-outbox-storage-v1-upgrade-order") + .baselineOnMigrate(false) + .outOfOrder(false) + .target("1") + .load(); + storageV1.baseline(); + storageV1.migrate(); + JdbcTemplate jdbc = new JdbcTemplate(database.dataSource()); + setLifecycle(jdbc, storage.cardId(), "ACTIVE"); + + Stream polling = outboxPolling(); + Flyway pollingV1 = + Flyway.configure() + .dataSource(database.dataSource()) + .locations(polling.location()) + .table(polling.historyTable()) + .baselineVersion("0") + .baselineDescription("explicit-outbox-polling-v1-upgrade-order") + .baselineOnMigrate(false) + .outOfOrder(false) + .target("1") + .load(); + pollingV1.baseline(); + pollingV1.migrate(); + setLifecycle(jdbc, polling.cardId(), "ACTIVE"); + + Flyway storageLatest = independent(database, storage); + storageLatest.migrate(); + + assertThat(characterMaximumLength(jdbc, "outbox_event_identity_v2", "event_id")) + .isEqualTo(96); + assertThat(characterMaximumLength(jdbc, "outbox_event_log_v2", "event_id")).isEqualTo(96); + assertThat(characterMaximumLength(jdbc, "outbox_delivery_v2", "event_id")).isEqualTo(96); + + Flyway pollingLatest = independent(database, polling); + pollingLatest.migrate(); + pollingLatest.validate(); + + assertThat(appliedVersions(jdbc, storage.historyTable())) + .containsExactlyElementsOf(storage.migratedVersions()); + assertThat(appliedVersions(jdbc, polling.historyTable())) + .containsExactlyElementsOf(polling.migratedVersions()); + } + } + private static void verifyFreshDisabledEnableDisableReEnable(Stream stream) throws Exception { try (PostgreSqlReadinessSupport database = PostgreSqlReadinessSupport.start()) { prepareFreshCoreAndPrerequisites(database, stream); @@ -265,6 +330,20 @@ final class PostgreSqlOptionalStreamLifecycle { "select to_regclass(?) is not null", Boolean.class, "public." + relation)); } + private static int characterMaximumLength(JdbcTemplate jdbc, String table, String column) { + Integer length = + jdbc.queryForObject( + "select character_maximum_length from information_schema.columns " + + "where table_schema = 'public' and table_name = ? and column_name = ?", + Integer.class, + table, + column); + if (length == null) { + throw new IllegalStateException("missing varchar column " + table + "." + column); + } + return length; + } + private static int markerCount(JdbcTemplate jdbc, String cardId) { return jdbc.queryForObject( "select count(*) from capability_schema_registry where capability_id = ?", diff --git a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlOutboxPollingIntegrationTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlOutboxPollingIntegrationTest.java index f70ded4b..9642049a 100644 --- a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlOutboxPollingIntegrationTest.java +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlOutboxPollingIntegrationTest.java @@ -12,7 +12,6 @@ import dev.caskeleton.application.outbox.v2.OutboxDeliveryTransition; import dev.caskeleton.application.outbox.v2.OutboxDeliveryTransitionOutcome; import dev.caskeleton.application.transaction.OperationId; import java.time.Duration; -import java.time.Instant; import java.util.List; import org.flywaydb.core.Flyway; import org.junit.jupiter.api.AfterAll; @@ -110,8 +109,12 @@ class PostgreSqlOutboxPollingIntegrationTest { ignored -> delivery.claimBatch( new OutboxDeliveryClaimRequest( - "portfolio.events", "relay-1", 10, Duration.ofSeconds(30)))); + CanonicalOutboxV2TestFixture.DESTINATION, + "relay-1", + 10, + Duration.ofSeconds(30)))); assertThat(first).extracting(item -> item.owner().eventId()).containsExactly("event-v1"); + assertThat(first.getFirst().event()).isEqualTo(event("event-v1", 1).event()); OutboxDeliveryTransition transition = new OutboxDeliveryTransition(first.getFirst().owner(), new OperationId("publish-event-v1")); @@ -128,10 +131,72 @@ class PostgreSqlOutboxPollingIntegrationTest { ignored -> delivery.claimBatch( new OutboxDeliveryClaimRequest( - "portfolio.events", "relay-1", 10, Duration.ofSeconds(30)))); + CanonicalOutboxV2TestFixture.DESTINATION, + "relay-1", + 10, + Duration.ofSeconds(30)))); assertThat(second).extracting(item -> item.owner().eventId()).containsExactly("event-v2"); } + @Test + void strictAggregateOrderingDoesNotCrossTenantBoundaries() { + transactions.executeWithoutResult( + ignored -> { + append.append( + CanonicalOutboxV2TestFixture.event( + "tenant-a-v1", "tenant-a", 1, 0, "{\"tenant\":\"a\",\"v\":1}")); + append.append( + CanonicalOutboxV2TestFixture.event( + "tenant-a-v2", "tenant-a", 2, 0, "{\"tenant\":\"a\",\"v\":2}")); + append.append( + CanonicalOutboxV2TestFixture.event( + "tenant-b-v1", "tenant-b", 1, 0, "{\"tenant\":\"b\",\"v\":1}")); + }); + + List heads = + transactions.execute( + ignored -> + delivery.claimBatch( + new OutboxDeliveryClaimRequest( + CanonicalOutboxV2TestFixture.DESTINATION, + "relay-tenant", + 10, + Duration.ofSeconds(30)))); + + assertThat(heads) + .extracting(item -> item.owner().eventId()) + .containsExactlyInAnyOrder("tenant-a-v1", "tenant-b-v1"); + assertThat(heads) + .extracting(item -> item.event().aggregate().tenantScope()) + .containsExactlyInAnyOrder("tenant-a", "tenant-b"); + } + + @Test + void preCanonicalRowCannotBeClaimedAsACanonicalDelivery() { + transactions.executeWithoutResult( + ignored -> insertPreCanonicalPollingRow("event-pre-canonical-claim", "{\"legacy\":true}")); + + assertThatThrownBy( + () -> + transactions.execute( + ignored -> + delivery.claimBatch( + new OutboxDeliveryClaimRequest( + CanonicalOutboxV2TestFixture.DESTINATION, + "relay-pre-canonical", + 1, + Duration.ofSeconds(30))))) + .isInstanceOf(IllegalStateException.class) + .hasMessageContaining("pre-canonical") + .hasMessageContaining("event-pre-canonical-claim"); + + assertThat( + jdbc.queryForObject( + "select state from outbox_delivery_v2 where event_id = 'event-pre-canonical-claim'", + String.class)) + .isEqualTo("PENDING"); + } + @Test void publishAckLossReclaimsTheStableEventIdButRejectsTheStaleOwner() { transactions.executeWithoutResult(ignored -> append.append(event("event-ack-loss", 1))); @@ -141,7 +206,10 @@ class PostgreSqlOutboxPollingIntegrationTest { ignored -> delivery.claimBatch( new OutboxDeliveryClaimRequest( - "portfolio.events", "relay-old", 1, Duration.ofMillis(25)))) + CanonicalOutboxV2TestFixture.DESTINATION, + "relay-old", + 1, + Duration.ofMillis(25)))) .getFirst(); jdbc.queryForObject("select pg_sleep(0.05)", Object.class); @@ -151,7 +219,10 @@ class PostgreSqlOutboxPollingIntegrationTest { ignored -> delivery.claimBatch( new OutboxDeliveryClaimRequest( - "portfolio.events", "relay-new", 1, Duration.ofSeconds(30)))) + CanonicalOutboxV2TestFixture.DESTINATION, + "relay-new", + 1, + Duration.ofSeconds(30)))) .getFirst(); assertThat(reclaimed.owner().eventId()).isEqualTo(first.owner().eventId()); @@ -177,7 +248,10 @@ class PostgreSqlOutboxPollingIntegrationTest { ignored -> delivery.claimBatch( new OutboxDeliveryClaimRequest( - "portfolio.events", "relay-1", 10, Duration.ofSeconds(30)))) + CanonicalOutboxV2TestFixture.DESTINATION, + "relay-1", + 10, + Duration.ofSeconds(30)))) .getFirst(); OutboxDeliveryTransition dead = new OutboxDeliveryTransition(head.owner(), new OperationId("dead-head")); @@ -190,7 +264,10 @@ class PostgreSqlOutboxPollingIntegrationTest { ignored -> delivery.claimBatch( new OutboxDeliveryClaimRequest( - "portfolio.events", "relay-1", 10, Duration.ofSeconds(30)))); + CanonicalOutboxV2TestFixture.DESTINATION, + "relay-1", + 10, + Duration.ofSeconds(30)))); assertThat(blocked).isEmpty(); } @@ -199,6 +276,28 @@ class PostgreSqlOutboxPollingIntegrationTest { PostgreSqlOptionalStreamLifecycle.verify(PostgreSqlOptionalStreamLifecycle.outboxPolling()); } + private static void insertPreCanonicalPollingRow(String eventId, String payload) { + jdbc.update( + "insert into outbox_event_identity_v2(" + + "event_id, tenant_scope, aggregate_type, aggregate_id, aggregate_version, " + + "event_ordinal, retention_bucket, created_at" + + ") values (?, null, 'worklog', 'work-log-42', 1, 0, current_date, clock_timestamp())", + eventId); + jdbc.update( + "insert into outbox_event_log_v2(" + + "retention_bucket, event_id, aggregate_type, aggregate_id, aggregate_version, " + + "event_ordinal, event_type, event_schema, logical_destination, partition_key, " + + "publication_epoch, dispatch_authority, content_type, correlation_id, causation_id, " + + "occurred_at, payload, payload_digest, trace_parent, created_at" + + ") values (current_date, ?, 'worklog', 'work-log-42', 1, 0, 'LegacyEvent', 1, ?, " + + "'legacy-key', 2, 'POLLING_V2', 'application/json', 'correlation-1', null, " + + "clock_timestamp(), ?, ?, null, clock_timestamp())", + eventId, + CanonicalOutboxV2TestFixture.DESTINATION, + payload, + "0".repeat(64)); + } + private static void cutoverToPollingV2() { jdbc.queryForObject( "select active_epoch from outbox_publication_control_v2 " @@ -221,21 +320,8 @@ class PostgreSqlOutboxPollingIntegrationTest { } private static NewOutboxEventV2 event(String eventId, long aggregateVersion) { - return new NewOutboxEventV2( - eventId, - "WorkLog", - "work-log-42", - aggregateVersion, - 0, - "WorkLogChanged", - 1, - "portfolio.events", - "work-log-42", - "application/json", - "correlation-1", - null, - Instant.parse("2026-07-28T12:00:00Z"), - "{\"version\":" + aggregateVersion + "}"); + return CanonicalOutboxV2TestFixture.event( + eventId, aggregateVersion, 0, "{\"version\":" + aggregateVersion + "}"); } private static void migrate(String location, String historyTable) { diff --git a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlOutboxStorageIntegrationTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlOutboxStorageIntegrationTest.java index 0975e4ff..06915957 100644 --- a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlOutboxStorageIntegrationTest.java +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlOutboxStorageIntegrationTest.java @@ -8,7 +8,6 @@ import dev.caskeleton.application.outbox.v2.NewOutboxEventV2; import dev.caskeleton.application.outbox.v2.OutboxAppendOutcome; import dev.caskeleton.application.outbox.v2.OutboxAppendReceipt; import dev.caskeleton.application.outbox.v2.OutboxDispatchAuthority; -import java.time.Instant; import java.util.concurrent.CountDownLatch; import java.util.concurrent.Executors; import java.util.concurrent.Future; @@ -116,13 +115,14 @@ class PostgreSqlOutboxStorageIntegrationTest { assertThat(jdbc.queryForObject("select count(*) from outbox_business_probe", Integer.class)) .isZero(); + NewOutboxEventV2 committed = event("event-commit", 1, 0, "{\"ok\":true}"); OutboxAppendReceipt appended = transactions.execute( ignored -> { jdbc.update( "insert into outbox_business_probe(aggregate_id, mutation_count) " + "values ('work-log-42', 1)"); - return adapter.append(event("event-commit", 1, 0, "{\"ok\":true}")); + return adapter.append(committed); }); assertThat(appended.outcome()).isEqualTo(OutboxAppendOutcome.APPENDED); @@ -131,6 +131,26 @@ class PostgreSqlOutboxStorageIntegrationTest { .isEqualTo(1); assertThat(jdbc.queryForObject("select count(*) from outbox_business_probe", Integer.class)) .isEqualTo(1); + assertThat( + jdbc.queryForObject( + "select envelope_bytes from outbox_event_log_v2 where event_id = 'event-commit'", + byte[].class)) + .containsExactly(committed.event().envelopeBytes()); + assertThat( + jdbc.queryForMap( + "select tenant_scope, envelope_version, schema_set_hash, envelope_sha256, " + + "envelope_schema_hash, payload_schema_hash, contract_catalog_revision, " + + "destination_binding_revision from outbox_event_log_v2 " + + "where event_id = 'event-commit'")) + .containsEntry("tenant_scope", committed.event().aggregate().tenantScope()) + .containsEntry("envelope_version", committed.event().envelopeVersion()) + .containsEntry("schema_set_hash", committed.event().schemaSetHash().toString()) + .containsEntry("envelope_sha256", committed.event().envelopeSha256().toString()) + .containsEntry("envelope_schema_hash", committed.event().envelopeSchemaHash().toString()) + .containsEntry("payload_schema_hash", committed.event().payloadSchemaHash().toString()) + .containsEntry("contract_catalog_revision", committed.event().contractCatalogRevision()) + .containsEntry( + "destination_binding_revision", committed.event().destinationBindingRevision()); } @Test @@ -154,7 +174,37 @@ class PostgreSqlOutboxStorageIntegrationTest { } @Test - @Order(4) + @Order(8) + void canonicalEventLogCannotDriftFromItsImmutableTenantAggregateIdentity() { + NewOutboxEventV2 canonical = + CanonicalOutboxV2TestFixture.event( + "event-identity-fk", "tenant-a", 3, 1, "{\"identity\":true}"); + transactions.executeWithoutResult(ignored -> adapter.append(canonical)); + + assertThatThrownBy( + () -> + jdbc.update( + "update outbox_event_log_v2 set tenant_scope = 'tenant-b' " + + "where event_id = 'event-identity-fk'")) + .isInstanceOf(DataAccessException.class); + } + + @Test + @Order(9) + void invalidUtf8EnvelopeFailsBeforeWritingAnIdentity() { + NewOutboxEventV2 invalid = + CanonicalOutboxV2TestFixture.event( + "event-invalid-utf8", "tenant-a", 1, 0, new byte[] {(byte) 0xC3, (byte) 0x28}); + + assertThatThrownBy(() -> transactions.executeWithoutResult(ignored -> adapter.append(invalid))) + .isInstanceOf(IllegalArgumentException.class) + .hasMessageContaining("UTF-8"); + assertThat(jdbc.queryForObject("select count(*) from outbox_event_identity_v2", Integer.class)) + .isZero(); + } + + @Test + @Order(10) void publicationControlShareLockPreventsCutoverFromOvertakingAnAppend() throws Exception { CountDownLatch appendHasLockedControl = new CountDownLatch(1); CountDownLatch allowAppendCommit = new CountDownLatch(1); @@ -207,10 +257,140 @@ class PostgreSqlOutboxStorageIntegrationTest { .hasMessageContaining("legacy outbox writer is fenced"); } + @Test + @Order(4) + void canonicalAggregateOrderingIsTenantScoped() { + OutboxAppendReceipt tenantA = + transactions.execute( + ignored -> + adapter.append( + CanonicalOutboxV2TestFixture.event( + "tenant-a-event", "tenant-a", 11, 0, "{\"tenant\":\"a\"}"))); + OutboxAppendReceipt tenantB = + transactions.execute( + ignored -> + adapter.append( + CanonicalOutboxV2TestFixture.event( + "tenant-b-event", "tenant-b", 11, 0, "{\"tenant\":\"b\"}"))); + + assertThat(tenantA.outcome()).isEqualTo(OutboxAppendOutcome.APPENDED); + assertThat(tenantB.outcome()).isEqualTo(OutboxAppendOutcome.APPENDED); + assertThat(jdbc.queryForObject("select count(*) from outbox_event_identity_v2", Integer.class)) + .isEqualTo(2); + } + @Test @Order(5) + void canonicalEventIdSupportsTheFullNinetySixCharacterBound() { + String eventId = "e".repeat(96); + + OutboxAppendReceipt receipt = + transactions.execute(ignored -> adapter.append(event(eventId, 1, 0, "{\"id\":96}"))); + + assertThat(receipt.outcome()).isEqualTo(OutboxAppendOutcome.APPENDED); + assertThat( + jdbc.queryForObject( + "select event_id from outbox_event_log_v2 where event_id = ?", + String.class, + eventId)) + .isEqualTo(eventId); + } + + @Test + @Order(6) + void canonicalReplayFailsClosedForAPreCanonicalV2Row() { + transactions.executeWithoutResult( + ignored -> + insertPreCanonicalRow( + "event-pre-canonical", "worklog", "work-log-42", 1, 0, "{\"legacy\":true}")); + + assertThatThrownBy( + () -> + transactions.executeWithoutResult( + ignored -> + adapter.append(event("event-pre-canonical", 1, 0, "{\"legacy\":true}")))) + .isInstanceOf(IllegalStateException.class) + .hasMessageContaining("pre-canonical") + .hasMessageContaining("event-pre-canonical"); + } + + @Test + @Order(7) + void databaseRejectsAPartiallyCanonicalV2Row() { + assertThatThrownBy( + () -> + transactions.executeWithoutResult( + ignored -> { + insertIdentity("event-partial", "tenant-a", "worklog", "work-log-42", 1, 0); + jdbc.update( + "insert into outbox_event_log_v2(" + + "retention_bucket, event_id, aggregate_type, aggregate_id, " + + "aggregate_version, event_ordinal, event_type, event_schema, " + + "logical_destination, partition_key, publication_epoch, " + + "dispatch_authority, content_type, correlation_id, causation_id, " + + "occurred_at, payload, payload_digest, trace_parent, created_at, " + + "tenant_scope" + + ") values (current_date, ?, 'worklog', 'work-log-42', 1, 0, " + + "'LegacyEvent', 1, 'legacy.destination', 'legacy-key', 1, " + + "'LEGACY_SHADOW', 'application/json', 'correlation-1', null, " + + "clock_timestamp(), '{}', ?, null, clock_timestamp(), 'tenant-a')", + "event-partial", + "0".repeat(64)); + })) + .isInstanceOf(DataAccessException.class); + } + + @Test + @Order(11) void optionalStreamLifecycleIsNonDestructiveAndRecoversInterruptedMigration() throws Exception { PostgreSqlOptionalStreamLifecycle.verify(PostgreSqlOptionalStreamLifecycle.outboxStorage()); + PostgreSqlOptionalStreamLifecycle.verifyOutboxStorageUpgradeWithExistingPollingV1(); + } + + private static void insertPreCanonicalRow( + String eventId, + String aggregateType, + String aggregateId, + long aggregateVersion, + int eventOrdinal, + String payload) { + insertIdentity(eventId, null, aggregateType, aggregateId, aggregateVersion, eventOrdinal); + jdbc.update( + "insert into outbox_event_log_v2(" + + "retention_bucket, event_id, aggregate_type, aggregate_id, aggregate_version, " + + "event_ordinal, event_type, event_schema, logical_destination, partition_key, " + + "publication_epoch, dispatch_authority, content_type, correlation_id, causation_id, " + + "occurred_at, payload, payload_digest, trace_parent, created_at" + + ") values (current_date, ?, ?, ?, ?, ?, 'LegacyEvent', 1, " + + "'legacy.destination', 'legacy-key', 1, 'LEGACY_SHADOW', 'application/json', " + + "'correlation-1', null, clock_timestamp(), ?, ?, null, clock_timestamp())", + eventId, + aggregateType, + aggregateId, + aggregateVersion, + eventOrdinal, + payload, + "0".repeat(64)); + } + + private static void insertIdentity( + String eventId, + String tenantScope, + String aggregateType, + String aggregateId, + long aggregateVersion, + int eventOrdinal) { + jdbc.update( + "insert into outbox_event_identity_v2(" + + "event_id, tenant_scope, aggregate_type, aggregate_id, aggregate_version, " + + "event_ordinal, retention_bucket, created_at" + + ") values (?, ?, ?, ?, ?, ?, current_date, clock_timestamp())", + eventId, + tenantScope, + aggregateType, + aggregateId, + aggregateVersion, + eventOrdinal); } private static void cutoverToPollingV2() { @@ -236,21 +416,7 @@ class PostgreSqlOutboxStorageIntegrationTest { private static NewOutboxEventV2 event( String eventId, long aggregateVersion, int ordinal, String payload) { - return new NewOutboxEventV2( - eventId, - "WorkLog", - "work-log-42", - aggregateVersion, - ordinal, - "WorkLogChanged", - 1, - "portfolio.events", - "work-log-42", - "application/json", - "correlation-1", - null, - Instant.parse("2026-07-28T12:00:00Z"), - payload); + return CanonicalOutboxV2TestFixture.event(eventId, aggregateVersion, ordinal, payload); } private static void migrate(String location, String historyTable) { diff --git a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlTransactionIntegrationTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlTransactionIntegrationTest.java index 042cf75a..36c6434a 100644 --- a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlTransactionIntegrationTest.java +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlTransactionIntegrationTest.java @@ -312,7 +312,7 @@ class PostgreSqlTransactionIntegrationTest { new DataSourceTransactionManager(database.dataSource()), settings, new PostgreSqlLocalTimeoutConfigurer(jdbc), - database.dataSource(), + database.dataSource().getConnectionTimeout(), translator()); } diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/JpaModuleBoundaryTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/JpaModuleBoundaryTest.java index a1531483..3c147a59 100644 --- a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/JpaModuleBoundaryTest.java +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/JpaModuleBoundaryTest.java @@ -34,13 +34,13 @@ class JpaModuleBoundaryTest { /** Every platform package that is downstream of the core contracts. */ private static final List DOWNSTREAM_OF_API = List.of( + "autoconfigure", "transaction", "springdata", "querydsl", "hibernate", "postgresql", "migration", - "auditing", "envers", "cache", "observation", @@ -55,7 +55,7 @@ class JpaModuleBoundaryTest { * not drag in another. A dependency between two of them would make that opt-in a fiction. */ private static final List INDEPENDENT_CAPABILITIES = - List.of("auditing", "envers", "cache", "observation", "security", "migration", "querydsl"); + List.of("envers", "cache", "observation", "security", "migration", "querydsl"); /** * Every direct child package of the production root, and what it may depend on. @@ -72,8 +72,20 @@ class JpaModuleBoundaryTest { private static final Map> PACKAGE_CATALOG = Map.ofEntries( Map.entry("api", Set.of()), + Map.entry( + "autoconfigure", + Set.of( + "api", + "config", + "fileserver", + "h2", + "hibernate", + "notification", + "observation", + "postgresql", + "security", + "transaction")), Map.entry("audit", Set.of("api")), - Map.entry("auditing", Set.of("api", "audit")), Map.entry("cache", Set.of("api")), Map.entry("config", Set.of("api")), Map.entry("envers", Set.of("api")), @@ -368,6 +380,7 @@ class JpaModuleBoundaryTest { try (java.util.stream.Stream children = java.nio.file.Files.list(root)) { return children .filter(java.nio.file.Files::isDirectory) + .filter(JpaModuleBoundaryTest::containsJavaSource) .map(path -> path.getFileName().toString()) .collect(java.util.stream.Collectors.toCollection(TreeSet::new)); } catch (java.io.IOException unreadable) { @@ -375,6 +388,17 @@ class JpaModuleBoundaryTest { } } + private static boolean containsJavaSource(java.nio.file.Path packageDirectory) { + try (java.util.stream.Stream files = java.nio.file.Files.walk(packageDirectory)) { + return files.anyMatch( + path -> + java.nio.file.Files.isRegularFile(path) + && path.getFileName().toString().endsWith(".java")); + } catch (java.io.IOException unreadable) { + throw new java.io.UncheckedIOException(unreadable); + } + } + private static java.nio.file.Path sourceRoot() { for (java.nio.file.Path directory = java.nio.file.Path.of("").toAbsolutePath(); directory != null; diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/api/error/JpaPersistenceExceptionTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/api/error/JpaPersistenceExceptionTest.java index 85d62ff2..a9ccbf4c 100644 --- a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/api/error/JpaPersistenceExceptionTest.java +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/api/error/JpaPersistenceExceptionTest.java @@ -4,6 +4,10 @@ import static org.assertj.core.api.Assertions.assertThat; import dev.caskeleton.adapter.outbound.persistence.api.PersistenceOperationName; import dev.caskeleton.adapter.outbound.persistence.api.transaction.TransactionCompletionEvidence; +import java.io.ByteArrayInputStream; +import java.io.ByteArrayOutputStream; +import java.io.ObjectInputStream; +import java.io.ObjectOutputStream; import java.time.Duration; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; @@ -41,6 +45,22 @@ class JpaPersistenceExceptionTest { assertThat(failure.category()).isEqualTo(FailureCategory.SERIALIZATION_FAILURE); } + @Test + @DisplayName("bounded failure metadata survives Java exception serialization") + void boundedMetadataSurvivesSerialization() throws Exception { + var failure = + new UniqueConstraintViolationException( + JpaFailureContext.terminal(OPERATION, "23505", 1, Duration.ofMillis(3), null), + ConstraintViolationDetails.of(new ConstraintCode("user.active-email.unique"))); + + var restored = roundTrip(failure); + + assertThat(restored.context()).isEqualTo(failure.context()); + assertThat(restored.category()).isEqualTo(FailureCategory.UNIQUE_CONSTRAINT); + assertThat(restored.details()).isEqualTo(failure.details()); + assertThat(restored.retryable()).isFalse(); + } + @Test @DisplayName("a completion-unknown exception forces the safe context whatever it is given") void completionUnknownForcesSafeContext() { @@ -56,4 +76,16 @@ class JpaPersistenceExceptionTest { assertThat(failure.transactionKey()).contains("payment-42"); assertThat(failure.evidence()).isEqualTo(TransactionCompletionEvidence.UNKNOWN); } + + private static UniqueConstraintViolationException roundTrip( + UniqueConstraintViolationException failure) throws Exception { + ByteArrayOutputStream bytes = new ByteArrayOutputStream(); + try (ObjectOutputStream output = new ObjectOutputStream(bytes)) { + output.writeObject(failure); + } + try (ObjectInputStream input = + new ObjectInputStream(new ByteArrayInputStream(bytes.toByteArray()))) { + return (UniqueConstraintViolationException) input.readObject(); + } + } } diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/auditing/AuditingCandidateStatusTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/auditing/AuditingCandidateStatusTest.java deleted file mode 100644 index e4f6593b..00000000 --- a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/auditing/AuditingCandidateStatusTest.java +++ /dev/null @@ -1,85 +0,0 @@ -package dev.caskeleton.adapter.outbound.persistence.auditing; - -import static org.assertj.core.api.Assertions.assertThat; - -import dev.caskeleton.adapter.outbound.persistence.audit.AuditableEntity; -import jakarta.persistence.Column; -import java.lang.annotation.Annotation; -import java.lang.reflect.Field; -import java.util.Arrays; -import java.util.List; -import java.util.Optional; -import org.junit.jupiter.api.DisplayName; -import org.junit.jupiter.api.Test; -import org.springframework.context.annotation.Configuration; -import org.springframework.stereotype.Component; - -/** - * The second audit mechanism stays a candidate, and stays distinguishable from the first. - * - *

    Two complete technical-audit mechanisms live in this leaf. They disagree on column names, on - * actor length and on when the stamp is captured, and the canonical one is {@link AuditableEntity} - * — the base the sample entities extend and the migrations were written for. The other is - * implemented, tested and composed by nothing. - * - *

    Two things can go wrong quietly. The candidate can acquire a stereotype and start stamping in - * every deployment that has this module on the classpath, including the ones whose tables have no - * such columns — where the result is a startup failure rather than a feature. Or somebody can - * "harmonise" the two by editing one side's column names, at which point the schema a deployed - * table was migrated for and the schema the entity expects diverge with no migration in between. - * Both are silent, so both are asserted. - */ -class AuditingCandidateStatusTest { - - private static final List> COMPOSING_STEREOTYPES = - List.of( - Configuration.class, Component.class, org.springframework.stereotype.Repository.class); - - @Test - @DisplayName("the candidate wiring carries no stereotype, so a scan cannot compose it") - void theCandidateWiringCarriesNoStereotype() { - for (Class stereotype : COMPOSING_STEREOTYPES) { - assertThat(JpaAuditingConfiguration.class.getAnnotation(stereotype)) - .as( - "@%s here would stamp audit columns in every deployment that merely has this module", - stereotype.getSimpleName()) - .isNull(); - } - } - - @Test - @DisplayName("the two mechanisms keep different modification columns, which is why one is chosen") - void theTwoMechanismsKeepDifferentModificationColumns() { - assertThat(columnOf(AuditMetadata.class, "modifiedAt")) - .as("the candidate's own column name; changing it silently rewrites a schema contract") - .contains("modified_at"); - assertThat(columnOf(AuditableEntity.class, "updatedAt")) - .as("the canonical column name the migrations and the sample entities already use") - .contains("updated_at"); - } - - @Test - @DisplayName("the canonical mechanism keeps the wider actor column") - void theCanonicalMechanismKeepsTheWiderActorColumn() { - assertThat(lengthOf(AuditableEntity.class, "updatedBy")).isEqualTo(256); - assertThat(lengthOf(AuditMetadata.class, "modifiedBy")) - .as("the two lengths are one of the reasons promotion needs a migration, not a rename") - .isEqualTo(64); - } - - private static Optional columnOf(Class type, String fieldName) { - return field(type, fieldName).map(field -> field.getAnnotation(Column.class).name()); - } - - private static int lengthOf(Class type, String fieldName) { - return field(type, fieldName) - .map(field -> field.getAnnotation(Column.class).length()) - .orElseThrow(() -> new AssertionError(type.getSimpleName() + " has no " + fieldName)); - } - - private static Optional field(Class type, String fieldName) { - return Arrays.stream(type.getDeclaredFields()) - .filter(field -> field.getName().equals(fieldName)) - .findFirst(); - } -} diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PersistenceJpaAutoConfigurationTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PersistenceJpaAutoConfigurationTest.java new file mode 100644 index 00000000..3ba3a97d --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PersistenceJpaAutoConfigurationTest.java @@ -0,0 +1,84 @@ +package dev.caskeleton.adapter.outbound.persistence.autoconfigure; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.adapter.outbound.persistence.config.JpaAdapterComponentsConfig; +import dev.caskeleton.adapter.outbound.persistence.config.PersistenceVendorSettings; +import dev.caskeleton.adapter.outbound.persistence.fileserver.FileserverJpaPersistenceConfig; +import dev.caskeleton.adapter.outbound.persistence.h2.H2PersistenceConfig; +import dev.caskeleton.adapter.outbound.persistence.notification.configuration.NotificationJpaPersistenceFacade; +import dev.caskeleton.adapter.outbound.persistence.postgresql.PostgreSqlPersistenceConfig; +import java.io.IOException; +import java.io.InputStream; +import java.nio.charset.StandardCharsets; +import java.util.Arrays; +import org.junit.jupiter.api.Test; +import org.springframework.boot.autoconfigure.AutoConfiguration; +import org.springframework.boot.autoconfigure.AutoConfigurations; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.boot.test.context.runner.ApplicationContextRunner; +import org.springframework.context.annotation.Import; +import org.springframework.core.annotation.AnnotatedElementUtils; + +class PersistenceJpaAutoConfigurationTest { + + @Test + void leafRootIsARealBootAutoConfigurationUnderTheMasterSwitch() { + assertThat( + AnnotatedElementUtils.hasAnnotation( + PersistenceJpaAutoConfiguration.class, AutoConfiguration.class)) + .isTrue(); + + ConditionalOnProperty condition = + PersistenceJpaAutoConfiguration.class.getAnnotation(ConditionalOnProperty.class); + assertThat(condition).isNotNull(); + assertThat(condition.prefix()).isEqualTo("ca-skeleton.persistence-jpa"); + assertThat(condition.name()).containsExactly("enabled"); + assertThat(condition.havingValue()).isEqualTo("true"); + } + + @Test + void leafRootOwnsVendorSettingsBinding() { + EnableConfigurationProperties binding = + PersistenceJpaAutoConfiguration.class.getAnnotation(EnableConfigurationProperties.class); + + assertThat(binding).isNotNull(); + assertThat(binding.value()).containsExactly(PersistenceVendorSettings.class); + } + + @Test + void packagePrivateLeafRootLoadsThroughBootAutoConfigurationWhenDisabled() { + new ApplicationContextRunner() + .withConfiguration(AutoConfigurations.of(PersistenceJpaAutoConfiguration.class)) + .run(context -> assertThat(context).hasNotFailed()); + } + + @Test + void leafRootOwnsVendorAndOptionalPersistenceImports() { + Import imports = PersistenceJpaAutoConfiguration.class.getAnnotation(Import.class); + assertThat(imports).isNotNull(); + + assertThat(Arrays.asList(imports.value())) + .contains( + JpaAdapterComponentsConfig.class, + PostgreSqlPersistenceConfig.class, + H2PersistenceConfig.class, + FileserverJpaPersistenceConfig.class, + NotificationJpaPersistenceFacade.class, + PostgreSqlIdempotencyStoreConfig.class); + } + + @Test + void leafJarPublishesThePackagePrivateRoot() throws IOException { + String resource = + "META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports"; + try (InputStream stream = + PersistenceJpaAutoConfigurationTest.class.getClassLoader().getResourceAsStream(resource)) { + assertThat(stream).isNotNull(); + assertThat(new String(stream.readAllBytes(), StandardCharsets.UTF_8)) + .contains(PersistenceJpaAutoConfiguration.class.getName()) + .contains(PersistenceJpaRuntimeConfig.class.getName()); + } + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PersistenceJpaRuntimeConfigTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PersistenceJpaRuntimeConfigTest.java new file mode 100644 index 00000000..e1e390bd --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PersistenceJpaRuntimeConfigTest.java @@ -0,0 +1,181 @@ +package dev.caskeleton.adapter.outbound.persistence.autoconfigure; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +import dev.caskeleton.adapter.outbound.persistence.api.PersistenceOperationName; +import dev.caskeleton.adapter.outbound.persistence.api.error.FailureCategory; +import dev.caskeleton.adapter.outbound.persistence.api.error.JpaPersistenceException; +import dev.caskeleton.adapter.outbound.persistence.api.error.VendorFailureTranslator; +import dev.caskeleton.adapter.outbound.persistence.api.transaction.TransactionProfile; +import dev.caskeleton.adapter.outbound.persistence.hibernate.HibernateProviderPolicy; +import dev.caskeleton.adapter.outbound.persistence.postgresql.constraint.PostgreSqlConstraintCatalog; +import dev.caskeleton.adapter.outbound.persistence.postgresql.error.PostgreSqlExceptionTranslator; +import dev.caskeleton.adapter.outbound.persistence.security.PostgreSqlRuntimeRoleVerifier; +import dev.caskeleton.adapter.outbound.persistence.transaction.FullTransactionRetryCoordinator; +import dev.caskeleton.adapter.outbound.persistence.transaction.SpringJpaTransactionExecutor; +import java.sql.SQLException; +import java.time.Clock; +import java.time.Duration; +import org.junit.jupiter.api.Test; +import org.springframework.boot.autoconfigure.AutoConfigurations; +import org.springframework.boot.test.context.runner.ApplicationContextRunner; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.dao.TransientDataAccessResourceException; +import org.springframework.transaction.PlatformTransactionManager; +import org.springframework.transaction.support.AbstractPlatformTransactionManager; +import org.springframework.transaction.support.DefaultTransactionStatus; + +class PersistenceJpaRuntimeConfigTest { + + private static final PersistenceOperationName OPERATION = + new PersistenceOperationName("order.write"); + private static final TransactionProfile PROFILE = + TransactionProfile.write("order.write", Duration.ofSeconds(3)); + + private final ApplicationContextRunner runner = + new ApplicationContextRunner() + .withConfiguration(AutoConfigurations.of(PersistenceJpaRuntimeConfig.class)) + .withBean(Clock.class, Clock::systemUTC) + .withPropertyValues("ca-skeleton.persistence-jpa.enabled=true"); + + @Test + void masterSwitchOffContributesNoRuntimeBeans() { + new ApplicationContextRunner() + .withConfiguration(AutoConfigurations.of(PersistenceJpaRuntimeConfig.class)) + .withBean(Clock.class, Clock::systemUTC) + .withPropertyValues("ca-skeleton.persistence-jpa.enabled=false") + .run( + context -> + assertThat(context) + .doesNotHaveBean(HibernateProviderPolicy.class) + .doesNotHaveBean(PostgreSqlRuntimeRoleVerifier.class)); + } + + @Test + void addonsSwitchOffContributesNoRuntimeBeansEvenWhenJpaIsOn() { + runner + .withPropertyValues("app.jpa-platform.addons-enabled=false") + .run( + context -> + assertThat(context) + .doesNotHaveBean(HibernateProviderPolicy.class) + .doesNotHaveBean(PostgreSqlRuntimeRoleVerifier.class)); + } + + @Test + void providerRuntimeBeansAreLeafOwned() { + runner.run( + context -> + assertThat(context) + .hasSingleBean(HibernateProviderPolicy.class) + .hasSingleBean(PostgreSqlRuntimeRoleVerifier.class)); + } + + @Test + void transactionManagerBringsExecutorAndRetryCoordinator() { + runner + .withUserConfiguration(TransactionManagerConfiguration.class) + .run( + context -> + assertThat(context) + .hasSingleBean(SpringJpaTransactionExecutor.class) + .hasSingleBean(FullTransactionRetryCoordinator.class)); + } + + @Test + void withoutTransactionManagerRetryBacksOff() { + runner.run( + context -> { + assertThat(context).hasNotFailed(); + assertThat(context).doesNotHaveBean(FullTransactionRetryCoordinator.class); + }); + } + + @Test + void composedVendorTranslatorClassifiesAttemptFailure() { + runner + .withUserConfiguration(TransactionManagerConfiguration.class) + .withBean( + VendorFailureTranslator.class, + () -> PostgreSqlExceptionTranslator.with(PostgreSqlConstraintCatalog.empty())) + .run( + context -> { + SpringJpaTransactionExecutor executor = + context.getBean(SpringJpaTransactionExecutor.class); + + assertThatThrownBy( + () -> + executor.execute( + OPERATION, + PROFILE, + PersistenceJpaRuntimeConfigTest::throwSerializationConflict)) + .isInstanceOfSatisfying( + JpaPersistenceException.class, + classified -> { + assertThat(classified.category()) + .isEqualTo(FailureCategory.SERIALIZATION_FAILURE); + assertThat(classified.retryable()).isTrue(); + }); + }); + } + + @Test + void noVendorTranslatorLeavesFailureUnclassified() { + runner + .withUserConfiguration(TransactionManagerConfiguration.class) + .run( + context -> { + SpringJpaTransactionExecutor executor = + context.getBean(SpringJpaTransactionExecutor.class); + + assertThatThrownBy( + () -> + executor.execute( + OPERATION, + PROFILE, + PersistenceJpaRuntimeConfigTest::throwSerializationConflict)) + .isInstanceOf(TransientDataAccessResourceException.class); + }); + } + + @Test + void applicationOverrideWins() { + runner + .withBean(HibernateProviderPolicy.class, () -> new HibernateProviderPolicy("7.0.0-custom")) + .run( + context -> + assertThat(context.getBean(HibernateProviderPolicy.class).runtimeVersion()) + .isEqualTo("7.0.0-custom")); + } + + private static Object throwSerializationConflict() { + throw new TransientDataAccessResourceException( + "could not serialize access", new SQLException("could not serialize access", "40001")); + } + + @Configuration(proxyBeanMethods = false) + static class TransactionManagerConfiguration { + + @Bean + PlatformTransactionManager transactionManager() { + return new AbstractPlatformTransactionManager() { + @Override + protected Object doGetTransaction() { + return new Object(); + } + + @Override + protected void doBegin( + Object transaction, org.springframework.transaction.TransactionDefinition definition) {} + + @Override + protected void doCommit(DefaultTransactionStatus status) {} + + @Override + protected void doRollback(DefaultTransactionStatus status) {} + }; + } + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PostgreSqlIdempotencyStoreConfigTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PostgreSqlIdempotencyStoreConfigTest.java new file mode 100644 index 00000000..51fe9613 --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/autoconfigure/PostgreSqlIdempotencyStoreConfigTest.java @@ -0,0 +1,36 @@ +package dev.caskeleton.adapter.outbound.persistence.autoconfigure; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.adapter.outbound.persistence.postgresql.idempotency.PostgreSqlOwnerSafeIdempotencyStore; +import dev.caskeleton.application.idempotency.v2.IdempotencyStorePortV2; +import org.junit.jupiter.api.Test; +import org.springframework.boot.test.context.runner.ApplicationContextRunner; +import org.springframework.jdbc.core.JdbcOperations; + +class PostgreSqlIdempotencyStoreConfigTest { + + private final ApplicationContextRunner runner = + new ApplicationContextRunner() + .withUserConfiguration(PostgreSqlIdempotencyStoreConfig.class) + .withBean(JdbcOperations.class, () -> org.mockito.Mockito.mock(JdbcOperations.class)); + + @Test + void postgresqlSelectionComposesTheConcreteStoreBehindTheApplicationPort() { + runner + .withPropertyValues("ca-skeleton.capabilities.idempotency.provider=postgresql") + .run( + context -> { + assertThat(context).hasSingleBean(IdempotencyStorePortV2.class); + assertThat(context.getBean(IdempotencyStorePortV2.class)) + .isInstanceOf(PostgreSqlOwnerSafeIdempotencyStore.class); + }); + } + + @Test + void otherSelectionsDoNotComposeThePostgresqlStore() { + runner + .withPropertyValues("ca-skeleton.capabilities.idempotency.provider=redis") + .run(context -> assertThat(context).doesNotHaveBean(IdempotencyStorePortV2.class)); + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/config/JpaAdapterComponentsConfigTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/config/JpaAdapterComponentsConfigTest.java new file mode 100644 index 00000000..213a51c0 --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/config/JpaAdapterComponentsConfigTest.java @@ -0,0 +1,21 @@ +package dev.caskeleton.adapter.outbound.persistence.config; + +import static org.assertj.core.api.Assertions.assertThat; + +import java.util.Arrays; +import org.junit.jupiter.api.Test; +import org.springframework.context.annotation.ComponentScan; + +class JpaAdapterComponentsConfigTest { + + @Test + void operationAndLiveEventAdaptersAreInsideTheCapabilityOwnedComponentScan() { + ComponentScan scan = JpaAdapterComponentsConfig.class.getAnnotation(ComponentScan.class); + + assertThat(scan).isNotNull(); + assertThat(Arrays.asList(scan.basePackages())) + .contains( + "dev.caskeleton.adapter.outbound.persistence.operation", + "dev.caskeleton.adapter.outbound.persistence.liveevent"); + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/config/PersistenceEntityScanCoverageTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/config/PersistenceEntityScanCoverageTest.java index 56e6e13f..56aff86f 100644 --- a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/config/PersistenceEntityScanCoverageTest.java +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/config/PersistenceEntityScanCoverageTest.java @@ -15,6 +15,7 @@ import java.util.stream.Stream; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; import org.springframework.boot.persistence.autoconfigure.EntityScan; +import org.springframework.context.annotation.ComponentScan; import org.springframework.data.jpa.repository.config.EnableJpaRepositories; /** @@ -54,6 +55,8 @@ class PersistenceEntityScanCoverageTest { /** Sub-packages that hold no JPA entity or repository and therefore need no scan. */ private static final Set NOT_SCANNED = Set.of( + // Spring composition only: no entity or Spring Data repository lives here. + "autoconfigure", // Vendor-selection configuration only. "config", "h2", @@ -82,6 +85,18 @@ class PersistenceEntityScanCoverageTest { .isEmpty(); } + @Test + @DisplayName("always-installed port adapters are included in the component scan") + void operationAndLiveEventAdaptersAreScanned() { + List componentPackages = + List.of(JpaAdapterComponentsConfig.class.getAnnotation(ComponentScan.class).basePackages()); + + assertThat(componentPackages) + .contains( + "dev.caskeleton.adapter.outbound.persistence.operation", + "dev.caskeleton.adapter.outbound.persistence.liveevent"); + } + @Test @DisplayName("no opt-in package is in the always-installed scan") void noOptInPackageIsScannedUnconditionally() { diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/h2/H2FailureTranslatorTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/h2/H2FailureTranslatorTest.java new file mode 100644 index 00000000..bdf4a3d2 --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/h2/H2FailureTranslatorTest.java @@ -0,0 +1,51 @@ +package dev.caskeleton.adapter.outbound.persistence.h2; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.adapter.outbound.persistence.api.PersistenceOperationName; +import dev.caskeleton.adapter.outbound.persistence.api.error.FailureCategory; +import java.sql.SQLException; +import java.time.Duration; +import org.junit.jupiter.api.Test; +import org.springframework.dao.TransientDataAccessResourceException; + +class H2FailureTranslatorTest { + + private static final PersistenceOperationName OPERATION = + new PersistenceOperationName("order.write"); + + private final H2FailureTranslator translator = new H2FailureTranslator(); + + @Test + void serializationFailureIsRetryable() { + var translated = + translator.translate(failure("40001"), OPERATION, 1, Duration.ofMillis(4), null); + + assertThat(translated.category()).isEqualTo(FailureCategory.SERIALIZATION_FAILURE); + assertThat(translated.retryable()).isTrue(); + assertThat(translated.context().sqlState()).isEqualTo("40001"); + } + + @Test + void deadlockStateIsRetryableWhenSurfaced() { + var translated = + translator.translate(failure("40P01"), OPERATION, 2, Duration.ofMillis(7), "trace-1"); + + assertThat(translated.category()).isEqualTo(FailureCategory.DEADLOCK); + assertThat(translated.retryable()).isTrue(); + assertThat(translated.context().transactionAttempt()).isEqualTo(2); + } + + @Test + void unknownStateIsNotInventedIntoARetryableCategory() { + var translated = translator.translate(failure("HY000"), OPERATION, 1, Duration.ZERO, null); + + assertThat(translated.category()).isEqualTo(FailureCategory.UNKNOWN); + assertThat(translated.retryable()).isFalse(); + } + + private static RuntimeException failure(String sqlState) { + return new TransientDataAccessResourceException( + "database contention", new SQLException("driver detail", sqlState)); + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/hibernate/batch/HibernateBatchConfigurationGuardTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/hibernate/batch/HibernateBatchConfigurationGuardTest.java index 86279bfd..bbd0e0c9 100644 --- a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/hibernate/batch/HibernateBatchConfigurationGuardTest.java +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/hibernate/batch/HibernateBatchConfigurationGuardTest.java @@ -5,6 +5,7 @@ import static org.assertj.core.api.Assertions.assertThatThrownBy; import dev.caskeleton.adapter.outbound.persistence.testkit.id.IdentityEntity; import dev.caskeleton.adapter.outbound.persistence.testkit.id.SequenceEntity; +import java.util.Map; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; @@ -51,4 +52,23 @@ class HibernateBatchConfigurationGuardTest { .isInstanceOf(IllegalArgumentException.class) .hasMessageContaining("clearSize"); } + + @Test + @DisplayName("a profile that orders inserts requires Hibernate insert ordering") + void rejectsMissingInsertOrdering() { + var profile = new JpaBatchProfile("import", 50, 50, 50, true, false, true); + + assertThatThrownBy(() -> guard.validateRuntime(profile, Map.of())) + .isInstanceOf(IllegalStateException.class) + .hasMessageContaining("hibernate.order_inserts=true"); + } + + @Test + @DisplayName("runtime ordering accepts string or boolean Hibernate property values") + void acceptsMatchingRuntimeOrdering() { + var profile = new JpaBatchProfile("import", 50, 50, 50, true, true, true); + + guard.validateRuntime( + profile, Map.of("hibernate.order_inserts", "true", "hibernate.order_updates", true)); + } } diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/hibernate/batch/HibernateJpaBatchExecutorTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/hibernate/batch/HibernateJpaBatchExecutorTest.java new file mode 100644 index 00000000..0f2d79b7 --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/hibernate/batch/HibernateJpaBatchExecutorTest.java @@ -0,0 +1,76 @@ +package dev.caskeleton.adapter.outbound.persistence.hibernate.batch; + +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.verifyNoInteractions; +import static org.mockito.Mockito.when; + +import dev.caskeleton.adapter.outbound.persistence.hibernate.HibernateStatisticsCollector; +import dev.caskeleton.adapter.outbound.persistence.hibernate.HibernateStatisticsSnapshot; +import jakarta.persistence.EntityManager; +import jakarta.persistence.EntityManagerFactory; +import java.util.List; +import java.util.Map; +import java.util.function.Consumer; +import org.hibernate.Session; +import org.junit.jupiter.api.Test; + +class HibernateJpaBatchExecutorTest { + + @Test + void appliesTheProfileBatchSizeToTheSessionAndRestoresThePreviousValue() { + EntityManager entityManager = mock(EntityManager.class); + EntityManagerFactory entityManagerFactory = mock(EntityManagerFactory.class); + Session session = mock(Session.class); + HibernateStatisticsCollector statistics = mock(HibernateStatisticsCollector.class); + + when(entityManager.isJoinedToTransaction()).thenReturn(true); + when(entityManager.getEntityManagerFactory()).thenReturn(entityManagerFactory); + when(entityManagerFactory.getProperties()) + .thenReturn( + Map.of( + "hibernate.order_inserts", true, + "hibernate.order_updates", true)); + when(entityManager.unwrap(Session.class)).thenReturn(session); + when(session.getJdbcBatchSize()).thenReturn(7); + when(statistics.batchInstrumented()).thenReturn(true); + when(statistics.snapshot()) + .thenReturn(HibernateStatisticsSnapshot.zero(), HibernateStatisticsSnapshot.zero()); + + new HibernateJpaBatchExecutor(entityManager, statistics) + .persist(JpaBatchProfile.uniform("import", 50), List.of(), ignored -> {}); + + verify(session).setJdbcBatchSize(50); + verify(session).setJdbcBatchSize(7); + } + + @Test + void rejectsAnUninstrumentedBatchRunBeforeThePersisterCanWriteAnything() { + EntityManager entityManager = mock(EntityManager.class); + EntityManagerFactory entityManagerFactory = mock(EntityManagerFactory.class); + HibernateStatisticsCollector statistics = mock(HibernateStatisticsCollector.class); + @SuppressWarnings("unchecked") + Consumer persister = mock(Consumer.class); + + when(entityManager.isJoinedToTransaction()).thenReturn(true); + when(entityManager.getEntityManagerFactory()).thenReturn(entityManagerFactory); + when(entityManagerFactory.getProperties()) + .thenReturn( + Map.of( + "hibernate.order_inserts", true, + "hibernate.order_updates", true)); + when(statistics.batchInstrumented()).thenReturn(false); + when(statistics.snapshot()).thenReturn(HibernateStatisticsSnapshot.zero()); + + HibernateJpaBatchExecutor executor = new HibernateJpaBatchExecutor(entityManager, statistics); + + assertThatThrownBy( + () -> + executor.persist(JpaBatchProfile.uniform("import", 50), List.of("row"), persister)) + .isInstanceOf(IllegalStateException.class) + .hasMessageContaining("JDBC batch instrumentation"); + + verifyNoInteractions(persister); + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/idempotency/IdempotencyActivationContractTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/idempotency/IdempotencyActivationContractTest.java new file mode 100644 index 00000000..8662c514 --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/idempotency/IdempotencyActivationContractTest.java @@ -0,0 +1,22 @@ +package dev.caskeleton.adapter.outbound.persistence.idempotency; + +import static org.assertj.core.api.Assertions.assertThat; + +import org.junit.jupiter.api.Test; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; + +class IdempotencyActivationContractTest { + + @Test + void jdbcIdempotencyRequiresAnExplicitProviderProperty() { + assertExplicit(IdempotencyStoreAdapter.class); + assertExplicit(IdempotencyReaper.class); + } + + private static void assertExplicit(Class type) { + ConditionalOnProperty condition = type.getAnnotation(ConditionalOnProperty.class); + assertThat(condition).isNotNull(); + assertThat(condition.havingValue()).isEqualTo("jdbc"); + assertThat(condition.matchIfMissing()).isFalse(); + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/liveevent/JpaLiveEventReplayAdapterActivationTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/liveevent/JpaLiveEventReplayAdapterActivationTest.java new file mode 100644 index 00000000..1ecef253 --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/liveevent/JpaLiveEventReplayAdapterActivationTest.java @@ -0,0 +1,93 @@ +package dev.caskeleton.adapter.outbound.persistence.liveevent; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.Mockito.mock; + +import java.time.Clock; +import org.junit.jupiter.api.Test; +import org.springframework.boot.convert.ApplicationConversionService; +import org.springframework.boot.test.context.runner.ApplicationContextRunner; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.context.annotation.Import; +import org.springframework.jdbc.core.JdbcOperations; + +class JpaLiveEventReplayAdapterActivationTest { + + private final ApplicationContextRunner runner = + new ApplicationContextRunner() + .withInitializer( + context -> + context + .getBeanFactory() + .setConversionService(ApplicationConversionService.getSharedInstance())) + .withUserConfiguration(TestConfig.class); + + @Test + void replayCapabilityIsDisabledByDefault() { + runner.run( + context -> { + assertThat(context).hasNotFailed(); + assertThat(context).doesNotHaveBean(JpaLiveEventReplayAdapter.class); + }); + } + + @Test + void enabledReplayCapabilityRequiresExplicitRetention() { + runner + .withPropertyValues("ca-skeleton.realtime.replay.enabled=true") + .run( + context -> { + assertThat(context).hasFailed(); + assertThat(context.getStartupFailure()) + .hasMessageContaining("ca-skeleton.realtime.replay.retention"); + }); + } + + @Test + void h2VendorDoesNotCreateThePostgreSqlReplayAdapter() { + runner + .withPropertyValues( + "ca-skeleton.realtime.replay.enabled=true", + "ca-skeleton.realtime.replay.retention=PT1H", + "ca-skeleton.persistence.vendor=h2") + .run( + context -> { + assertThat(context).hasNotFailed(); + assertThat(context).doesNotHaveBean(JpaLiveEventReplayAdapter.class); + }); + } + + @Test + void enabledReplayCapabilityWithRetentionCreatesAdapter() { + runner + .withPropertyValues( + "ca-skeleton.realtime.replay.enabled=true", + "ca-skeleton.realtime.replay.retention=PT1H") + .run( + context -> { + assertThat(context).hasNotFailed(); + assertThat(context).hasSingleBean(JpaLiveEventReplayAdapter.class); + }); + } + + @Configuration(proxyBeanMethods = false) + @Import(JpaLiveEventReplayAdapter.class) + static class TestConfig { + + @Bean + LiveEventJpaRepository liveEventJpaRepository() { + return mock(LiveEventJpaRepository.class); + } + + @Bean + JdbcOperations jdbcOperations() { + return mock(JdbcOperations.class); + } + + @Bean + Clock clock() { + return Clock.systemUTC(); + } + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/lock/DistributedLockPersistenceConfigTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/lock/DistributedLockPersistenceConfigTest.java new file mode 100644 index 00000000..2cffc36e --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/lock/DistributedLockPersistenceConfigTest.java @@ -0,0 +1,48 @@ +package dev.caskeleton.adapter.outbound.persistence.lock; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.Mockito.mock; + +import dev.caskeleton.application.lock.DistributedLockPort; +import javax.sql.DataSource; +import org.junit.jupiter.api.Test; +import org.springframework.boot.test.context.runner.ApplicationContextRunner; +import org.springframework.jdbc.datasource.DataSourceTransactionManager; +import org.springframework.transaction.PlatformTransactionManager; + +class DistributedLockPersistenceConfigTest { + + private final DataSource dataSource = mock(DataSource.class); + + private final ApplicationContextRunner contextRunner = + new ApplicationContextRunner() + .withUserConfiguration(DistributedLockPersistenceConfig.class) + .withBean(DataSource.class, () -> dataSource) + .withBean( + PlatformTransactionManager.class, () -> new DataSourceTransactionManager(dataSource)); + + @Test + void singleInstanceUsesOnlyTheInProcessProvider() { + contextRunner + .withPropertyValues("ca-skeleton.runtime.multi-instance-enabled=false") + .run( + context -> { + assertThat(context).hasSingleBean(DistributedLockPort.class); + assertThat(context).hasBean("inProcessDistributedLock"); + assertThat(context).doesNotHaveBean("jdbcDistributedLock"); + }); + } + + @Test + void multiInstanceBuildsTheJdbcProviderAndNotTheInProcessProvider() { + contextRunner + .withPropertyValues("ca-skeleton.runtime.multi-instance-enabled=true") + .run( + context -> { + assertThat(context).hasBean("jdbcDistributedLock"); + assertThat(context).doesNotHaveBean("inProcessDistributedLock"); + assertThat(context.getBean("jdbcDistributedLock")) + .isInstanceOf(DistributedLockPort.class); + }); + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/migration/OutboxStorageMigrationSafetyTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/migration/OutboxStorageMigrationSafetyTest.java new file mode 100644 index 00000000..64a724a7 --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/migration/OutboxStorageMigrationSafetyTest.java @@ -0,0 +1,57 @@ +package dev.caskeleton.adapter.outbound.persistence.migration; + +import static org.assertj.core.api.Assertions.assertThat; + +import java.io.IOException; +import java.io.InputStream; +import java.nio.charset.StandardCharsets; +import org.junit.jupiter.api.Test; + +class OutboxStorageMigrationSafetyTest { + + private static final String V1 = "db/migration/jpa/outbox-storage/V1__initialize_or_adopt.sql"; + + @Test + void legacyFenceRunsOncePerStatementAndKeepsTheDrainPathOpen() throws IOException { + String migration = normalized(resource(V1)); + + assertThat(migration) + .contains( + "BEFORE INSERT OR UPDATE OR DELETE ON outbox_event FOR EACH STATEMENT EXECUTE FUNCTION" + + " fence_legacy_outbox_writer()"); + assertThat(migration).contains("control_state = 'DRAINING' AND TG_OP IN ('UPDATE', 'DELETE')"); + assertThat(migration) + .doesNotContain( + "BEFORE INSERT OR UPDATE OR DELETE ON outbox_event FOR EACH ROW EXECUTE FUNCTION" + + " fence_legacy_outbox_writer()"); + } + + @Test + void legacyCutoverDigestDoesNotMaterializeTheWholeOutbox() throws IOException { + String migration = normalized(resource(V1)); + + assertThat(migration).doesNotContain("string_agg("); + assertThat(migration).contains("sha256("); + assertThat(migration).contains("encode("); + } + + @Test + void eventLogDoesNotPretendToBePartitionManagedWithoutAPartitionLifecycle() throws IOException { + String migration = normalized(resource(V1)); + + assertThat(migration).doesNotContain("PARTITION BY RANGE"); + assertThat(migration).doesNotContain("PARTITION OF outbox_event_log_v2 DEFAULT"); + } + + private static String normalized(String value) { + return value.replaceAll("\\s+", " ").trim(); + } + + private static String resource(String name) throws IOException { + try (InputStream stream = + OutboxStorageMigrationSafetyTest.class.getClassLoader().getResourceAsStream(name)) { + assertThat(stream).as("missing migration resource %s", name).isNotNull(); + return new String(stream.readAllBytes(), StandardCharsets.UTF_8); + } + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/migration/PostgreSqlConstraintMigrationSafetyTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/migration/PostgreSqlConstraintMigrationSafetyTest.java new file mode 100644 index 00000000..ec96f743 --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/migration/PostgreSqlConstraintMigrationSafetyTest.java @@ -0,0 +1,78 @@ +package dev.caskeleton.adapter.outbound.persistence.migration; + +import static org.assertj.core.api.Assertions.assertThat; + +import java.io.IOException; +import java.io.InputStream; +import java.nio.charset.StandardCharsets; +import org.junit.jupiter.api.Test; + +class PostgreSqlConstraintMigrationSafetyTest { + + private static final String V13 = + "db/migration/postgresql/V13__outbox_canonical_transport_compatibility.sql"; + private static final String V14 = + "db/migration/postgresql/V14__validate_outbox_canonical_constraints.sql"; + + @Test + void canonicalHashColumnsMatchTheJpaVarcharContract() throws IOException { + String migration = resource(V13); + + String normalized = migration.replaceAll("\\s+", " "); + for (String column : + java.util.List.of( + "partition_key", + "schema_set_hash", + "envelope_sha256", + "envelope_schema_hash", + "payload_schema_hash")) { + assertThat(normalized) + .as("%s must validate as the String(length=64) mapping Hibernate sees", column) + .contains("ADD COLUMN " + column + " varchar(64)"); + } + assertThat(migration).doesNotMatch("(?s).*\\bchar\\s*\\(64\\).*"); + } + + @Test + void additiveOutboxChecksAreIntroducedNotValid() throws IOException { + String migration = resource(V13); + + assertThat(count(migration, "ADD CONSTRAINT ck_outbox_event_")).isEqualTo(6); + assertThat(count(migration, "NOT VALID")) + .as( + "adding a validating CHECK to an adopted table scans every existing row while holding " + + "an ACCESS EXCLUSIVE lock; each additive V13 check must be introduced NOT VALID") + .isEqualTo(6); + assertThat(migration).doesNotContain("VALIDATE CONSTRAINT"); + } + + @Test + void canonicalOutboxChecksAreValidatedInTheFollowUpMigration() throws IOException { + String migration = resource(V14); + + assertThat(count(migration, "VALIDATE CONSTRAINT ck_outbox_event_canonical_")) + .as( + "validation belongs in the follow-up migration so V13 can add the checks without " + + "scanning every existing row under the stronger ALTER TABLE lock") + .isEqualTo(6); + assertThat(migration).doesNotContain("ADD CONSTRAINT"); + } + + private static int count(String value, String token) { + int count = 0; + int cursor = 0; + while ((cursor = value.indexOf(token, cursor)) >= 0) { + count++; + cursor += token.length(); + } + return count; + } + + private static String resource(String name) throws IOException { + try (InputStream stream = + PostgreSqlConstraintMigrationSafetyTest.class.getClassLoader().getResourceAsStream(name)) { + assertThat(stream).as("missing migration resource %s", name).isNotNull(); + return new String(stream.readAllBytes(), StandardCharsets.UTF_8); + } + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/notification/configuration/NotificationSchemaActivationLifecycleTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/notification/configuration/NotificationSchemaActivationLifecycleTest.java new file mode 100644 index 00000000..d6bcb1e9 --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/notification/configuration/NotificationSchemaActivationLifecycleTest.java @@ -0,0 +1,31 @@ +package dev.caskeleton.adapter.outbound.persistence.notification.configuration; + +import static org.assertj.core.api.Assertions.assertThatCode; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.verifyNoInteractions; +import static org.mockito.Mockito.when; + +import dev.caskeleton.adapter.outbound.persistence.notification.NotificationSchemaActivation; +import org.junit.jupiter.api.Test; +import org.springframework.jdbc.core.JdbcOperations; + +class NotificationSchemaActivationLifecycleTest { + + @Test + void beanFactoryDoesNotQueryTheDatabaseBeforeSingletonAssemblyFinishes() { + JdbcOperations jdbc = mock(JdbcOperations.class); + NotificationJpaPersistenceFacade facade = new NotificationJpaPersistenceFacade(); + + NotificationSchemaActivation activation = facade.notificationSchemaActivation(jdbc); + + verifyNoInteractions(jdbc); + + when(jdbc.queryForObject(anyString(), org.mockito.ArgumentMatchers.eq(Integer.class))) + .thenReturn(1); + + assertThatCode(activation::afterSingletonsInstantiated).doesNotThrowAnyException(); + verify(jdbc).queryForObject(anyString(), org.mockito.ArgumentMatchers.eq(Integer.class)); + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/NotificationRepositorySurfaceTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/NotificationRepositorySurfaceTest.java index c55d17f3..5dac9f8a 100644 --- a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/NotificationRepositorySurfaceTest.java +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/NotificationRepositorySurfaceTest.java @@ -2,33 +2,58 @@ package dev.caskeleton.adapter.outbound.persistence.notification.platform; import static org.assertj.core.api.Assertions.assertThat; +import dev.caskeleton.adapter.outbound.persistence.notification.platform.inbox.InboxItemJpaRepository; import java.lang.reflect.Method; import java.util.Arrays; import java.util.List; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; -import org.springframework.data.jpa.repository.JpaRepository; +import org.springframework.data.repository.CrudRepository; /** - * A tenant-scoped repository must not inherit tenant-blind methods. + * Tenant-scoped repositories expose only the operations the adapter intentionally chose. * - *

    {@code NotificationRequestJpaRepository} carried a doc comment saying "there is deliberately - * no {@code findById(UUID)} on the public surface" while extending {@code JpaRepository}, which - * supplies exactly that — plus {@code findAll()}, {@code deleteById(UUID)} and {@code count()}. The - * comment described an intention; the interface handed out the opposite. + *

    The architecture rule discovers tenant scope from the repository's generic entity type. This + * focused test names the current production set as a readable surface contract and catches an + * accidental return to {@link CrudRepository} without requiring the composition-level ArchUnit + * suite to run first. */ class NotificationRepositorySurfaceTest { - private static final List TENANT_BLIND_METHODS = - List.of("findById", "findAll", "deleteById", "delete", "deleteAll", "count", "existsById"); + private static final List> TENANT_SCOPED_REPOSITORIES = + List.of( + NotificationRequestJpaRepository.class, + AdminAuditJpaRepository.class, + ConsentJpaRepository.class, + ContactPointJpaRepository.class, + DeduplicationClaimJpaRepository.class, + PreferenceJpaRepository.class, + RecipientDeliveryJpaRepository.class, + SuppressionJpaRepository.class, + TemplateVersionJpaRepository.class, + InboxItemJpaRepository.class); @Test - @DisplayName("the request repository exposes no tenant-blind method") - void theRequestRepositoryExposesNoTenantBlindMethod() { + @DisplayName("no tenant-scoped repository inherits Spring Data broad CRUD") + void noTenantScopedRepositoryInheritsBroadCrud() { + assertThat(TENANT_SCOPED_REPOSITORIES) + .allSatisfy( + repository -> + assertThat(CrudRepository.class.isAssignableFrom(repository)) + .as(repository.getSimpleName() + " must expose only reviewed methods") + .isFalse()); + } + + @Test + @DisplayName("the request repository exposes no tenant-blind lookup method") + void theRequestRepositoryExposesNoTenantBlindLookupMethod() { List exposed = Arrays.stream(NotificationRequestJpaRepository.class.getMethods()) .map(Method::getName) - .filter(TENANT_BLIND_METHODS::contains) + .filter( + name -> + List.of("findById", "findAll", "deleteById", "count", "existsById") + .contains(name)) .distinct() .sorted() .toList(); @@ -39,16 +64,8 @@ class NotificationRepositorySurfaceTest { } @Test - @DisplayName("it is not a JpaRepository, because that is where those methods came from") - void itDoesNotExtendJpaRepository() { - assertThat(JpaRepository.class.isAssignableFrom(NotificationRequestJpaRepository.class)) - .as("the marker Repository declares nothing; JpaRepository declares the whole CRUD surface") - .isFalse(); - } - - @Test - @DisplayName("every declared finder takes the tenant first") - void everyDeclaredFinderTakesTheTenant() { + @DisplayName("every request finder takes the tenant first") + void everyRequestFinderTakesTheTenant() { List withoutTenant = Arrays.stream(NotificationRequestJpaRepository.class.getDeclaredMethods()) .filter(method -> method.getName().startsWith("findBy")) diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/RecipientClaimSqlTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/RecipientClaimSqlTest.java new file mode 100644 index 00000000..7ca8e802 --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/RecipientClaimSqlTest.java @@ -0,0 +1,14 @@ +package dev.caskeleton.adapter.outbound.persistence.notification.platform; + +import static org.assertj.core.api.Assertions.assertThat; + +import org.junit.jupiter.api.Test; + +class RecipientClaimSqlTest { + + @Test + void positionalParametersDoNotRewritePostgreSqlCasts() { + assertThat(RecipientClaimSql.positional("payload::jsonb @> :expected::jsonb")) + .isEqualTo("payload::jsonb @> ?::jsonb"); + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxMasterSwitchWiringContractTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxMasterSwitchWiringContractTest.java new file mode 100644 index 00000000..90c3a4a7 --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxMasterSwitchWiringContractTest.java @@ -0,0 +1,28 @@ +package dev.caskeleton.adapter.outbound.persistence.outbox; + +import static org.assertj.core.api.Assertions.assertThat; + +import org.junit.jupiter.api.Test; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.core.annotation.AnnotatedElementUtils; + +/** Pins the structural outbox-off contract at the JPA adapter boundary. */ +class OutboxMasterSwitchWiringContractTest { + + @Test + void legacyStoreAndReaperRequireTheOutboxMasterSwitch() { + assertOutboxMasterSwitch(OutboxStoreAdapter.class); + assertOutboxMasterSwitch(OutboxReaper.class); + } + + private static void assertOutboxMasterSwitch(Class type) { + ConditionalOnProperty condition = + AnnotatedElementUtils.findMergedAnnotation(type, ConditionalOnProperty.class); + + assertThat(condition).as(type.getSimpleName() + " must be outbox-master-gated").isNotNull(); + assertThat(condition.prefix()).isEqualTo("ca-skeleton.outbox"); + assertThat(condition.name()).containsExactly("enabled"); + assertThat(condition.havingValue()).isEqualTo("true"); + assertThat(condition.matchIfMissing()).isFalse(); + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxReaperWiringTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxReaperWiringTest.java index 64db826b..2374195a 100644 --- a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxReaperWiringTest.java +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxReaperWiringTest.java @@ -70,37 +70,40 @@ class OutboxReaperWiringTest { ctx -> ctx.getBeanFactory() .setConversionService(ApplicationConversionService.getSharedInstance())) - .withUserConfiguration(MinimalConfig.class) - .withBean(OutboxReaper.class); + .withUserConfiguration(MinimalConfig.class, OutboxReaper.class); // ----------------------------------------------------------------------- // 1. Spring wiring — context must start with default P7D retention // ----------------------------------------------------------------------- @Test - void outboxReaperBeanIsCreatedWhenRequiredBeansArePresent() { + void outboxReaperIsAbsentWhenOutboxIsDisabledByDefault() { contextRunner.run( context -> { assertThat(context).hasNotFailed(); - assertThat(context).hasSingleBean(OutboxReaper.class); + assertThat(context).doesNotHaveBean(OutboxReaper.class); }); } @Test - void outboxReaperUsesDefaultP7dRetentionWhenNoPropertyIsSet() { - contextRunner.run( - context -> { - assertThat(context).hasNotFailed(); - OutboxReaper reaper = context.getBean(OutboxReaper.class); - // Verify the reaper was created; retention P7D is injected via @Value default - assertThat(reaper).isNotNull(); - }); + void outboxReaperUsesDefaultP7dRetentionWhenOutboxIsEnabled() { + contextRunner + .withPropertyValues("ca-skeleton.outbox.enabled=true") + .run( + context -> { + assertThat(context).hasNotFailed(); + assertThat(context).hasSingleBean(OutboxReaper.class); + OutboxReaper reaper = context.getBean(OutboxReaper.class); + // Verify the reaper was created; retention P7D is injected via @Value default + assertThat(reaper).isNotNull(); + }); } @Test void outboxReaperUsesConfiguredRetentionWhenPropertyIsSet() { contextRunner - .withPropertyValues("ca-skeleton.outbox.published-retention=P30D") + .withPropertyValues( + "ca-skeleton.outbox.enabled=true", "ca-skeleton.outbox.published-retention=P30D") .run( context -> { assertThat(context).hasNotFailed(); diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxStoreAdapterTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxStoreAdapterTest.java index ff0bfe09..68f40d8e 100644 --- a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxStoreAdapterTest.java +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/outbox/OutboxStoreAdapterTest.java @@ -21,8 +21,11 @@ import java.time.Instant; import java.util.List; import java.util.Map; import java.util.Optional; +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.BeforeEach; import org.junit.jupiter.api.Test; import org.mockito.ArgumentCaptor; +import org.springframework.transaction.support.TransactionSynchronizationManager; /** * Unit tests for {@link OutboxStoreAdapter} — covers append mapping, claim transition, mark @@ -47,6 +50,16 @@ class OutboxStoreAdapterTest { private final OutboxClaimRepository claimRepo = mock(OutboxClaimRepository.class); private final OutboxStoreAdapter adapter = new OutboxStoreAdapter(repo, claimRepo); + @BeforeEach + void openCallerTransactionBoundary() { + TransactionSynchronizationManager.setActualTransactionActive(true); + } + + @AfterEach + void clearCallerTransactionBoundary() { + TransactionSynchronizationManager.clear(); + } + // ---- helper ---- private static NewOutboxEvent newEvent(String eventId) { @@ -123,6 +136,29 @@ class OutboxStoreAdapterTest { // ---- claimBatch ---- + @Test + void claimAndMarkOperationsRejectAMissingCallerTransaction() { + TransactionSynchronizationManager.clear(); + + assertThatThrownBy(() -> adapter.append(newEvent("evt-append-guard"))) + .isInstanceOf(IllegalStateException.class) + .hasMessageContaining("append") + .hasMessageContaining("active caller transaction"); + assertThatThrownBy(() -> adapter.claimBatch(1, NOW, IN_FLIGHT_TIMEOUT)) + .isInstanceOf(IllegalStateException.class) + .hasMessageContaining("claimBatch") + .hasMessageContaining("active caller transaction"); + assertThatThrownBy(() -> adapter.markPublished("evt-guard")) + .isInstanceOf(IllegalStateException.class) + .hasMessageContaining("markPublished"); + assertThatThrownBy(() -> adapter.markFailed("evt-guard", NOW.plusSeconds(1))) + .isInstanceOf(IllegalStateException.class) + .hasMessageContaining("markFailed"); + assertThatThrownBy(() -> adapter.markDead("evt-guard")) + .isInstanceOf(IllegalStateException.class) + .hasMessageContaining("markDead"); + } + @Test void claimBatchTransitionsEntityToInFlightAndReturnsMappedEvent() { OutboxEventEntity entity = pendingEntity("evt-002"); diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/postgresql/PostgreSqlSqlStateErrorMappingTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/postgresql/PostgreSqlSqlStateErrorMappingTest.java index d81b2f3a..3e6adf87 100644 --- a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/postgresql/PostgreSqlSqlStateErrorMappingTest.java +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/postgresql/PostgreSqlSqlStateErrorMappingTest.java @@ -30,9 +30,9 @@ class PostgreSqlSqlStateErrorMappingTest { } @Test - void pgMappingContributesExactlyThreeCodes() { + void pgMappingContributesExactlyFourCodes() { Map codes = pgMapping.exactMappings(); - assertThat(codes).containsOnlyKeys("40P01", "25P03", "57014"); + assertThat(codes).containsOnlyKeys("40P01", "55P03", "25P03", "57014"); } @Test @@ -44,6 +44,15 @@ class PostgreSqlSqlStateErrorMappingTest { assertThat(OperationalError.DB_DEADLOCK.retryable()).isTrue(); } + @Test + void lockNotAvailable55P03MapsToConflictWithoutAutomaticRetry() { + Optional result = translator.translate(daoWithSqlState("55P03")); + assertThat(result).isPresent(); + assertThat(result.get().errorCode()).isEqualTo(OperationalError.DB_LOCK_TIMEOUT); + assertThat(OperationalError.DB_LOCK_TIMEOUT.category()).isEqualTo(Category.CONFLICT); + assertThat(OperationalError.DB_LOCK_TIMEOUT.retryable()).isFalse(); + } + @Test void idleInTxTimeout25P03MapsToTransientRetryable() { Optional result = translator.translate(daoWithSqlState("25P03")); diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/postgresql/inbox/PostgreSqlInboxTransitionDigestTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/postgresql/inbox/PostgreSqlInboxTransitionDigestTest.java new file mode 100644 index 00000000..8aa508ca --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/postgresql/inbox/PostgreSqlInboxTransitionDigestTest.java @@ -0,0 +1,14 @@ +package dev.caskeleton.adapter.outbound.persistence.postgresql.inbox; + +import static org.assertj.core.api.Assertions.assertThat; + +import org.junit.jupiter.api.Test; + +class PostgreSqlInboxTransitionDigestTest { + + @Test + void lengthFramingKeepsDelimiterContainingFieldsUnambiguous() { + assertThat(PostgreSqlSameStoreInboxAdapter.digestFields("a|b", "c")) + .isNotEqualTo(PostgreSqlSameStoreInboxAdapter.digestFields("a", "b|c")); + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/postgresql/outbox/PostgreSqlOutboxTransitionDigestTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/postgresql/outbox/PostgreSqlOutboxTransitionDigestTest.java new file mode 100644 index 00000000..b7b43005 --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/postgresql/outbox/PostgreSqlOutboxTransitionDigestTest.java @@ -0,0 +1,14 @@ +package dev.caskeleton.adapter.outbound.persistence.postgresql.outbox; + +import static org.assertj.core.api.Assertions.assertThat; + +import org.junit.jupiter.api.Test; + +class PostgreSqlOutboxTransitionDigestTest { + + @Test + void lengthFramingKeepsDelimiterContainingFieldsUnambiguous() { + assertThat(PostgreSqlPollingDeliveryAdapter.digestFields("a|b", "c")) + .isNotEqualTo(PostgreSqlPollingDeliveryAdapter.digestFields("a", "b|c")); + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/testkit/JpaAuditMechanismRuleTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/testkit/JpaAuditMechanismRuleTest.java index b411c25f..9986decc 100644 --- a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/testkit/JpaAuditMechanismRuleTest.java +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/testkit/JpaAuditMechanismRuleTest.java @@ -34,7 +34,8 @@ class JpaAuditMechanismRuleTest { void aBulkUpdateThatStampsTheAuditColumnIsAccepted() { assertThat( JpaAuditMechanismRule.bulkUpdateViolation( - "update WorkLogEntity w set w.status = :status, w.updatedAt = :now where w.id = :id", + "update WorkLogEntity w set w.status = :status, w.updatedAt = :now where w.id =" + + " :id", AUDITED)) .isEmpty(); } @@ -58,12 +59,12 @@ class JpaAuditMechanismRuleTest { } @Test - @DisplayName("the Spring Data mechanism's column name counts as stamping too") - void theSpringDataColumnNameCountsAsStamping() { + @DisplayName("the removed Spring Data audit column no longer satisfies the audit policy") + void theRemovedSpringDataColumnDoesNotCountAsStamping() { assertThat( JpaAuditMechanismRule.bulkUpdateViolation( "update PosterEntity p set p.title = :title, p.modifiedAt = :now", AUDITED)) - .as("both mechanisms exist, so both column families satisfy the policy") - .isEmpty(); + .as("only the canonical updated_at/updatedAt audit mechanism remains") + .hasValue("updates audited 'posterentity' without stamping an audit column"); } } diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/testkit/JpaReleaseRenderingTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/testkit/JpaReleaseRenderingTest.java index 93ebab24..9b0e426c 100644 --- a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/testkit/JpaReleaseRenderingTest.java +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/testkit/JpaReleaseRenderingTest.java @@ -85,7 +85,8 @@ class JpaReleaseRenderingTest { } @Test - @DisplayName("the release workflow invokes the registry-driven aggregate instead of duplicating gate tasks") + @DisplayName( + "the release workflow invokes the registry-driven aggregate instead of duplicating gate tasks") void theReleaseWorkflowUsesTheRegistryDrivenAggregate() { String flowed = releaseWorkflow.replaceAll("[\t\n\r ]+", " "); diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/transaction/DefaultJpaRetryPolicyTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/transaction/DefaultJpaRetryPolicyTest.java index 44c0aa37..783f44e6 100644 --- a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/transaction/DefaultJpaRetryPolicyTest.java +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/transaction/DefaultJpaRetryPolicyTest.java @@ -5,7 +5,6 @@ import static org.assertj.core.api.Assertions.assertThat; import dev.caskeleton.adapter.outbound.persistence.api.PersistenceOperationName; import dev.caskeleton.adapter.outbound.persistence.api.error.ConstraintCode; import dev.caskeleton.adapter.outbound.persistence.api.error.ConstraintViolationDetails; -import dev.caskeleton.adapter.outbound.persistence.api.error.DeadlockDetectedException; import dev.caskeleton.adapter.outbound.persistence.api.error.JpaFailureContext; import dev.caskeleton.adapter.outbound.persistence.api.error.SerializationFailureException; import dev.caskeleton.adapter.outbound.persistence.api.error.TransactionCompletionUnknownException; @@ -14,10 +13,8 @@ import dev.caskeleton.adapter.outbound.persistence.api.transaction.RetryDisposit import dev.caskeleton.adapter.outbound.persistence.api.transaction.RetryProfile; import dev.caskeleton.adapter.outbound.persistence.api.transaction.TransactionAttempt; import dev.caskeleton.adapter.outbound.persistence.api.transaction.TransactionCompletionEvidence; -import dev.caskeleton.application.transaction.IrreversibleSideEffectContext; import java.time.Duration; import java.time.Instant; -import org.junit.jupiter.api.AfterEach; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; @@ -32,11 +29,6 @@ class DefaultJpaRetryPolicyTest { private final DefaultJpaRetryPolicy policy = DefaultJpaRetryPolicy.forProfile(RetryProfile.boundedContention("order.write", 3)); - @AfterEach - void clearSideEffects() { - IrreversibleSideEffectContext.clear(); - } - @Test @DisplayName("completion unknown reconciles and is never retried") void completionUnknownReconciles() { @@ -72,20 +64,6 @@ class DefaultJpaRetryPolicyTest { assertThat(policy.classify(failure, ATTEMPT).disposition()).isEqualTo(RetryDisposition.FAIL); } - @Test - @DisplayName("an attempt with an irreversible side effect is never retried") - void irreversibleSideEffectFails() { - IrreversibleSideEffectContext.mark(); - var failure = - new DeadlockDetectedException( - JpaFailureContext.retryable(OPERATION, "40P01", 1, Duration.ZERO, null)); - - var decision = policy.classify(failure, ATTEMPT); - - assertThat(decision.disposition()).isEqualTo(RetryDisposition.FAIL); - assertThat(decision.reason()).contains("irreversible"); - } - @Test @DisplayName("a profile with no retry budget always fails") void disabledProfileAlwaysFails() { diff --git a/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/transaction/PersistenceTransactionOwnershipTest.java b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/transaction/PersistenceTransactionOwnershipTest.java new file mode 100644 index 00000000..b92cca85 --- /dev/null +++ b/src/adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/transaction/PersistenceTransactionOwnershipTest.java @@ -0,0 +1,66 @@ +package dev.caskeleton.adapter.outbound.persistence.transaction; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verifyNoInteractions; + +import dev.caskeleton.adapter.outbound.persistence.liveevent.JpaLiveEventReplayAdapter; +import dev.caskeleton.adapter.outbound.persistence.liveevent.LiveEventJpaRepository; +import dev.caskeleton.adapter.outbound.persistence.operation.DurableOperationJpaRepository; +import dev.caskeleton.adapter.outbound.persistence.operation.DurableOperationStoreAdapter; +import dev.caskeleton.application.operation.DurableOperationId; +import java.lang.reflect.Method; +import java.time.Clock; +import java.time.Duration; +import java.time.Instant; +import java.util.Arrays; +import org.junit.jupiter.api.Test; +import org.springframework.jdbc.core.JdbcOperations; +import org.springframework.transaction.annotation.Transactional; + +class PersistenceTransactionOwnershipTest { + + @Test + void applicationFacingJpaAdaptersDoNotDeclareSpringTransactionBoundaries() { + assertNoTransactionalMethods(DurableOperationStoreAdapter.class); + assertNoTransactionalMethods(JpaLiveEventReplayAdapter.class); + } + + @Test + void durableOperationMutationRequiresTheCallerTransactionBeforeTouchingTheRepository() { + DurableOperationJpaRepository repository = mock(DurableOperationJpaRepository.class); + DurableOperationStoreAdapter adapter = new DurableOperationStoreAdapter(repository); + + assertThatThrownBy( + () -> + adapter.cancel(new DurableOperationId("operation-1"), "principal-1", Instant.EPOCH)) + .isInstanceOf(IllegalStateException.class) + .hasMessageContaining("requires an active caller transaction"); + verifyNoInteractions(repository); + } + + @Test + void liveEventAppendRequiresTheCallerTransactionBeforeAllocatingAPosition() { + LiveEventJpaRepository repository = mock(LiveEventJpaRepository.class); + JdbcOperations jdbc = mock(JdbcOperations.class); + JpaLiveEventReplayAdapter adapter = + new JpaLiveEventReplayAdapter(repository, jdbc, Clock.systemUTC(), Duration.ofHours(1)); + + assertThatThrownBy(() -> adapter.append("stream-1", "{}")) + .isInstanceOf(IllegalStateException.class) + .hasMessageContaining("requires an active caller transaction"); + verifyNoInteractions(repository, jdbc); + } + + private static void assertNoTransactionalMethods(Class type) { + assertThat(type.getAnnotation(Transactional.class)).isNull(); + assertThat( + Arrays.stream(type.getDeclaredMethods()) + .filter(method -> method.getAnnotation(Transactional.class) != null) + .map(Method::getName) + .toList()) + .as("%s must join a caller-owned TransactionPort boundary", type.getSimpleName()) + .isEmpty(); + } +} diff --git a/src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/arch/JpaArchitectureRules.java b/src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/arch/JpaArchitectureRules.java index 0af230c9..0efad192 100644 --- a/src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/arch/JpaArchitectureRules.java +++ b/src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/arch/JpaArchitectureRules.java @@ -95,8 +95,7 @@ public final class JpaArchitectureRules { .as("a tenant-scoped repository declares its own finders") .because( "the inherited CRUD surface is tenant-blind, so every one of its methods is a" - + " cross-tenant read waiting for a caller who forgets to check") - .allowEmptyShould(true); + + " cross-tenant read waiting for a caller who forgets to check"); } /** No platform type may re-implement Spring Data's CRUD repository. */ diff --git a/src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/arch/JpaAuditMechanismRule.java b/src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/arch/JpaAuditMechanismRule.java index 6d691c47..00610326 100644 --- a/src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/arch/JpaAuditMechanismRule.java +++ b/src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/arch/JpaAuditMechanismRule.java @@ -19,24 +19,17 @@ import java.util.Set; import java.util.stream.Collectors; /** - * An entity uses one audit mechanism, or none — never both. + * JPA entities use the canonical explicit audit mechanism, or no technical auditing at all. * - *

    Two exist. {@code audit/AuditableEntity} stamps {@code created_*}/{@code updated_*} explicitly - * at the adapter with a 256-character actor; {@code auditing/AuditMetadata} uses Spring Data's - * annotations, {@code modified_*} columns and a 64-character actor. An entity that picks one gets a - * coherent contract. An entity that picks both gets two writers for one meaning, two column - * families for one fact, and a migration that has to know which entity chose what. - * - *

    The rule does not decide which is canonical — that is JPA-022's open migration decision. It - * makes the choice per entity explicit and singular, so the decision remains one decision. + *

    {@code audit/AuditableEntity} is the sole technical-audit model. A second Spring Data field + * auditing mechanism used to live beside it with different column names and actor bounds; it was + * never composed and has been removed. This rule prevents that split-brain model from quietly + * returning on an entity. */ public final class JpaAuditMechanismRule { private static final String EXPLICIT_BASE = "dev.caskeleton.adapter.outbound.persistence.audit.AuditableEntity"; - private static final String SPRING_DATA_EMBEDDABLE = - "dev.caskeleton.adapter.outbound.persistence.auditing.AuditMetadata"; - private JpaAuditMechanismRule() {} /** The rule. */ @@ -108,11 +101,9 @@ public final class JpaAuditMechanismRule { return false; } - /** Whether {@code entity} uses either audit mechanism. */ + /** Whether {@code entity} uses the canonical audit mechanism. */ private static boolean usesAnAuditMechanism(JavaClass entity) { - return extendsAuditableEntity(entity) - || entity.getAllFields().stream() - .anyMatch(field -> field.getRawType().getName().equals(SPRING_DATA_EMBEDDABLE)); + return extendsAuditableEntity(entity); } /** @@ -158,9 +149,8 @@ public final class JpaAuditMechanismRule { /** The Spring Data annotation carrying the statement text. */ private static final String QUERY = "org.springframework.data.jpa.repository.Query"; - /** The assignments that count as stamping, across both mechanisms' column names. */ - private static final Set AUDIT_COLUMNS = - Set.of("updatedat", "updated_at", "modifiedat", "modified_at"); + /** The assignments that count as stamping the canonical audit model. */ + private static final Set AUDIT_COLUMNS = Set.of("updatedat", "updated_at"); private static final class StampsAuditOnBulkUpdate extends ArchCondition { @@ -196,18 +186,24 @@ public final class JpaAuditMechanismRule { @Override public void check(JavaClass entity, ConditionEvents events) { - boolean explicit = extendsAuditableEntity(entity); - boolean springData = + boolean springDataFieldAudit = entity.getAllFields().stream() - .anyMatch(field -> field.getRawType().getName().equals(SPRING_DATA_EMBEDDABLE)); + .flatMap(field -> field.getAnnotations().stream()) + .map(annotation -> annotation.getRawType().getName()) + .anyMatch( + name -> + name.equals("org.springframework.data.annotation.CreatedDate") + || name.equals("org.springframework.data.annotation.LastModifiedDate") + || name.equals("org.springframework.data.annotation.CreatedBy") + || name.equals("org.springframework.data.annotation.LastModifiedBy")); - if (explicit && springData) { + if (springDataFieldAudit) { events.add( SimpleConditionEvent.violated( entity, entity.getName() - + " extends AuditableEntity and embeds AuditMetadata: one fact, two writers," - + " and two column families")); + + " uses Spring Data field auditing; AuditableEntity is the sole technical" + + " audit mechanism")); } } } diff --git a/src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/arch/TenantScopedRepositoryPredicate.java b/src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/arch/TenantScopedRepositoryPredicate.java index 8c5b1fe1..28e05e8a 100644 --- a/src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/arch/TenantScopedRepositoryPredicate.java +++ b/src/adapter/outbound/persistence-jpa/src/testFixtures/java/dev/caskeleton/adapter/outbound/persistence/testkit/arch/TenantScopedRepositoryPredicate.java @@ -2,6 +2,7 @@ package dev.caskeleton.adapter.outbound.persistence.testkit.arch; import com.tngtech.archunit.base.DescribedPredicate; import com.tngtech.archunit.core.domain.JavaClass; +import com.tngtech.archunit.core.domain.JavaParameterizedType; import com.tngtech.archunit.core.domain.JavaType; import jakarta.persistence.Entity; @@ -27,10 +28,18 @@ public final class TenantScopedRepositoryPredicate extends DescribedPredicateContainers are cached per version for the whole JVM. Starting a fresh server per test class - * turns a matrix run into minutes of container startup, and the thing being verified — server - * behaviour — is identical across classes. - * - *

    The exact server version is recorded rather than assumed from the image tag. An image tag is - * mutable, so {@code postgres:16-alpine} today and tomorrow can be different patch releases, and a - * contract failure attributable to "PostgreSQL 16" is not attributable to anything. - */ -public final class PostgreSqlContractExtension implements BeforeAllCallback, AfterAllCallback { - - private static final Map CONTAINERS = - new LinkedHashMap<>(); - - private final PostgreSqlVersion version; - - public PostgreSqlContractExtension(PostgreSqlVersion version) { - this.version = Objects.requireNonNull(version, "version"); - } - - @Override - public void beforeAll(ExtensionContext context) { - container(); - } - - @Override - public void afterAll(ExtensionContext context) { - // Containers are shared for the JVM lifetime and stopped by the Testcontainers shutdown hook. - // Stopping here would restart the server for the next contract class in the same run. - } - - /** The running container for this extension's version, starting it on first use. */ - public synchronized PostgreSQLContainer container() { - return CONTAINERS.computeIfAbsent( - version, - selected -> { - PostgreSQLContainer container = PostgreSqlContainerFactory.create(selected); - container.start(); - return container; - }); - } - - /** The version this extension runs against. */ - public PostgreSqlVersion version() { - return version; - } - - /** The JDBC URL of the running container. */ - public String jdbcUrl() { - return container().getJdbcUrl(); - } - - /** The exact server version string, as the server reports it. */ - public String serverVersion() { - PostgreSQLContainer container = container(); - return container.getDockerImageName() + " (" + container.getContainerInfo().getId() + ')'; - } -} diff --git a/src/adapter/outbound/persistence-mongo/CLAUDE.md b/src/adapter/outbound/persistence-mongo/CLAUDE.md index b7236930..ff41250d 100644 --- a/src/adapter/outbound/persistence-mongo/CLAUDE.md +++ b/src/adapter/outbound/persistence-mongo/CLAUDE.md @@ -22,11 +22,18 @@ design package's assumed module layout onto this leaf lives in - Opt-in: `MongoPersistenceConfig` re-imports the Mongo auto-configuration (`@ImportAutoConfiguration`) only when `ca-skeleton.persistence-mongo.enabled=true` (default off). `MongoPlatformAutoConfiguration` is gated on the same flag. The connection URI and database come from Spring's standard - `spring.data.mongodb.*` settings; platform profiles come from + `spring.mongodb.*` settings; platform profiles come from `ca-skeleton.persistence-mongo.platform.*`. + The connection source is fail-closed: either `spring.mongodb.uri` / + `SPRING_MONGODB_URI` is non-blank, or the selected typed profile supplies `uri-secret` and the + deployment supplies `MongoCredentialResolver`. The typed profile is not documentation-only: + `MongoProfileClientSettingsAutoConfiguration` applies `MongoClientSettingsFactory` to Boot's actual + `MongoClientSettings.Builder` at lowest precedence, so its TLS, Stable API, timeout and pool + policy overrides generic defaults. - `MongoOptInAutoConfigurationImportFilter`, registered through `META-INF/spring.factories`, blocks Boot 4's classpath-driven sync/reactive/data/repository/health/metrics Mongo auto-configuration when the module enable flag is absent or false. +- Mongo health integration is leaf-owned. MongoRootAutoConfiguration imports the internal MongoPlatformHealthConfiguration, which adapts MongoPlatformHealthIndicator to Boot's HealthIndicator SPI under the stable bean name mongoPlatformHealthContributor. Application Actuator exposure policy still decides external endpoint exposure. ## Allowed @@ -38,13 +45,16 @@ design package's assumed module layout onto this leaf lives in other direction and fails when the two sets differ. - The composition root declares `implementation(project(':adapter:outbound:persistence-mongo'))` — with the reactive starter and the reactivestreams driver excluded, because there is no reactive - port in the shipped Stable scope. The actual Gradle runtime graph is the runtime SSOT; + port in the shipped Stable scope. Consequently `ReactiveExecution`, `reactive/**` and the + driver-side change-stream source are unreachable in the default bootJar; their isolated tests are + library qualification, not proof of shipped runtime reachability. A fork adopting them must remove + both excludes, restore the reactive runtime graph and add a composition-level qualification. + The actual Gradle runtime graph is the runtime SSOT; runtime classpath, so the membership cannot drift from what the jar carries. Property-only activation therefore works here: the switch turns on a module that already ships, and shipping it off is not the same contract as leaving it out, because absence cannot be reversed at deploy time and hides every gating defect. `sample-portfolio` does not carry it. -- External: `spring-boot-starter-data-mongodb` and `-reactive`, `spring-boot-autoconfigure`, - `micrometer-core`, `slf4j-api`, `spring-boot-configuration-processor` (annotation processor). +- External includes the Mongo starters, 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, reactor-test, Testcontainers (`mongodb`, `toxiproxy`). @@ -106,6 +116,12 @@ non-standalone topology and finite positive timeouts; `validate()` enforces all connection string — it hands the value to a caller-supplied function and never returns it, so the credential is a local for one call rather than a field, a bean property or a log line. +When `platform.profiles` is non-empty, adoption is intentionally fail-closed. In one composition +change provide the data-plane `MongoCredentialResolver` plus `MongoTopologyProbe`, +`MongoSecurityProfile`, admin `MongoCredentialReference`, and `MongoSchemaVersionRange`; README.md +contains the complete 17-field production profile example. Supplying profiles piecemeal and +discovering these requirements one startup failure at a time is not an accepted adoption path. + Not shipped: the resolver implementation (a fork wires its own secret store), and the TLS lane (trusted CA, wrong CA, hostname mismatch, expired certificate) which needs a container with real certificates. Rotation ordering — new generation ready, traffic switch, old lease drain, close — is diff --git a/src/adapter/outbound/persistence-mongo/README.md b/src/adapter/outbound/persistence-mongo/README.md index 574b4180..8d5d13f3 100644 --- a/src/adapter/outbound/persistence-mongo/README.md +++ b/src/adapter/outbound/persistence-mongo/README.md @@ -30,13 +30,77 @@ classpath에 들어 있는 모듈을 켜는 master switch다. 허용 집합과 build가 선언한 project dependency가 정확히 같은지 — 를 확인한다. 실제 도메인 Mongo adapter가 application port를 구현하게 되면 build와 registry를 같은 변경에서 함께 넓힌다. -기본값은 비활성이다. +기본값은 비활성이다. 활성화한 배포는 connection source를 명시해야 하며 driver의 +`mongodb://localhost:27017/test` 기본값으로 떨어지는 경로는 startup에서 거부한다. 표준 Boot 4 경로는 +`SPRING_MONGODB_URI`가 relaxed binding으로 `spring.mongodb.uri`에 들어가는 방식이다. ```properties ca-skeleton.persistence-mongo.enabled=true -spring.data.mongodb.uri=mongodb://localhost:27017/portfolio +ca-skeleton.persistence-mongo.active-profile=standard-uri +spring.mongodb.uri=${SPRING_MONGODB_URI} ``` +typed profile을 사용하는 배포는 `SPRING_MONGODB_URI` 대신 선택된 +`ca-skeleton.persistence-mongo.platform.profiles..uri-secret`을 설정하고 +`MongoCredentialResolver`를 제공한다. 이 경우 `MongoClientSettingsFactory`가 같은 Boot client builder에 +connection string, TLS, Stable API, socket/server-selection/operation timeout, pool bound를 적용한다. + +### typed profile 채택 조건 + +`active-profile`은 장식용 설정이 아니다. `MongoProfileClientSettingsAutoConfiguration`이 실제 Boot +`MongoClientSettings.Builder`에 선택된 profile 하나만 적용하며, 존재하지 않는 profile 이름은 +startup/client construction 과정에서 fail-closed 된다. profile map을 하나라도 선언한 배포는 다음 +composition-owned bean을 함께 준비해야 한다. + +- `MongoCredentialResolver` — 선택된 data-plane profile의 `secret://` URI를 한 번만 resolve +- `MongoTopologyProbe` — live data-plane cluster 관측; driver SDAM change가 같은 probe를 갱신 +- `MongoSecurityProfile` — runtime credential/TLS/authentication capability +- admin 역할의 `MongoCredentialReference` +- `MongoSchemaVersionRange` + +즉 client 생성에 필요한 resolver 하나와 platform startup validator가 요구하는 네 입력을 한 번에 +구성해야 한다. production profile의 17개 component는 다음 형태다. + +```yaml +ca-skeleton: + persistence-mongo: + enabled: true + active-profile: primary + platform: + profiles: + primary: + uri-secret: secret://mongodb/primary + topology: REPLICA_SET + production: true + stable-api-strict: true + consistency-default: PRIMARY_MAJORITY + server-selection-timeout: 3s + connect-timeout: 2s + socket-read-timeout: 5s + operation-timeout: 3s + pool-min-size: 2 + pool-max-size: 40 + pool-max-wait-time: 500ms + uuid-representation: STANDARD + decimal-representation: DECIMAL128 + runtime-auto-create-indexes: false + tls-required: true + authentication-required: true +``` + +### reactive / change-stream reachability + +기본 `app-bootstrap`은 `spring-boot-starter-data-mongodb-reactive`와 +`mongodb-driver-reactivestreams`를 의도적으로 exclude한다. 따라서 이 저장소의 shipped runtime에서는 +`ReactiveMongoTemplate`이 존재하지 않고 `MongoPlatformAutoConfiguration.ReactiveExecution`도 활성화될 +수 없다. `reactive/**`, reactive cursor, driver-backed change-stream source는 **leaf에 있는 확장 코드이지 +현재 bootJar의 실행 기능이 아니다**. + +fork가 reactive Mongo를 실제로 채택하려면 두 exclude를 composition에서 제거하고 reactive starter/driver를 +runtime graph에 복구한 뒤, `ReactiveMongoTemplate` 조립과 별도 qualification을 함께 추가해야 한다. +change stream은 그 이후에도 `watch`/resume/cursor lifecycle source가 별도로 필요하다. 단위 테스트에서 +reactive template을 직접 주입해 녹색인 것은 shipped composition reachability 증거가 아니다. + 활성화 시 `MongoPersistenceConfig`가 Spring Boot의 Mongo client 및 data auto-configuration을 명시적으로 가져와 `MongoClient`와 `MongoTemplate`을 구성하고, `MongoPlatformAutoConfiguration`이 플랫폼 정책 bean(startup validator, client generation registry, health indicator)을 등록한다. @@ -49,8 +113,8 @@ client, data, repository, health, metrics Mongo auto-configuration을 default/fa 제외한다. 필터는 Boot 4가 `AutoConfigurationImportFilter`를 찾는 `META-INF/spring.factories`에 등록되어 있으며, `enabled=true`일 때는 후보를 그대로 허용한다. -`MongoPersistenceProperties`는 모듈 opt-in만 소유한다. URI, database, credential은 Spring의 -표준 `spring.data.mongodb.*` 설정을 사용한다. 플랫폼 profile은 +`MongoPersistenceSettings`는 모듈 opt-in만 소유한다. URI, database, credential은 Spring의 +표준 `spring.mongodb.*` 설정을 사용한다. 플랫폼 profile은 `ca-skeleton.persistence-mongo.platform.*` (`MongoPlatformProperties`)이 소유한다. ## 노출 계층 (D1–D4) diff --git a/src/adapter/outbound/persistence-mongo/build.gradle b/src/adapter/outbound/persistence-mongo/build.gradle index a7046eb6..c5e0b3b3 100644 --- a/src/adapter/outbound/persistence-mongo/build.gradle +++ b/src/adapter/outbound/persistence-mongo/build.gradle @@ -32,6 +32,11 @@ dependencies { implementation 'org.springframework.boot:spring-boot-starter-data-mongodb-reactive' // The starter package registers auto-configuration and binds typed properties. implementation 'org.springframework.boot:spring-boot-autoconfigure' + // Actuator health SPI bridge owned by the Mongo starter (MNG-007). + implementation 'org.springframework.boot:spring-boot-health' + // Boot's Health type carries Jackson annotations. Keep the annotation type compile-only, the + // same shape used by cache-redis; the application runtime already owns JSON serialization. + compileOnly 'com.fasterxml.jackson.core:jackson-annotations' // Driver-native observability conventions (design §27) publish through Micrometer. implementation 'io.micrometer:micrometer-core' implementation 'org.slf4j:slf4j-api' @@ -41,12 +46,6 @@ dependencies { // "packages instead of modules" from meaning "no boundary at all". testImplementation libs.archunit.junit5 testImplementation 'io.projectreactor:reactor-test' - // Real replica set / failover / migration lanes (design §29). Test-scoped so no production - // package can reach a container fixture. - testImplementation 'org.testcontainers:testcontainers' - testImplementation 'org.testcontainers:testcontainers-junit-jupiter' - testImplementation 'org.testcontainers:testcontainers-mongodb' - testImplementation 'org.testcontainers:testcontainers-toxiproxy' } // Shared test code lives in src/testFixtures, per ADR-BUILD-001. This leaf is the first migration @@ -64,7 +63,20 @@ dependencies { // unconsumed fixtures are unconsumed, and a leaf that genuinely must not offer them needs a module, // not a third convention. auxiliarySourceSets { - sourceSet('mongoPerformanceTest') { compilesAgainst 'main', 'testFixtures' } + // Provider fixtures are isolated from java-test-fixtures so ordinary unit tests never acquire + // Testcontainers just because a provider lane exists in this leaf. + sourceSet('mongoProviderTestkit') { + compilesAgainst 'main', 'testFixtures' + inherits 'implementation', 'runtimeOnly' + } + sourceSet('mongoIntegrationTest') { + compilesAgainst 'main', 'testFixtures', 'mongoProviderTestkit' + inherits 'implementation', 'runtimeOnly' + } + sourceSet('mongoPerformanceTest') { + compilesAgainst 'main', 'testFixtures', 'mongoProviderTestkit' + inherits 'implementation', 'runtimeOnly' + } } // The fixtures declare what they compile against, rather than inheriting the test configuration. @@ -81,11 +93,23 @@ dependencies { // The ArchUnit rule pack names Spring Data's Repository marker in a rule, so it needs the // type on its compile classpath even though it never calls it. testFixturesImplementation 'org.springframework.data:spring-data-commons' - testFixturesImplementation 'org.testcontainers:testcontainers' - testFixturesImplementation 'org.testcontainers:testcontainers-junit-jupiter' - testFixturesImplementation 'org.testcontainers:testcontainers-mongodb' - testFixturesImplementation 'org.testcontainers:testcontainers-toxiproxy' - testFixturesImplementation libs.toxiproxy.java + + + // Provider-only fixture kit. These dependencies must never appear on ordinary testRuntimeClasspath. + mongoProviderTestkitImplementation 'org.testcontainers:testcontainers' + mongoProviderTestkitImplementation 'org.testcontainers:testcontainers-mongodb' + mongoProviderTestkitImplementation 'org.testcontainers:testcontainers-toxiproxy' + mongoProviderTestkitImplementation libs.toxiproxy.java + + // Source-set outputs do not export their dependency classpath. Provider consumers therefore + // declare the container libraries resolved through provider-fixture signatures explicitly. + mongoIntegrationTestImplementation 'org.testcontainers:testcontainers' + mongoIntegrationTestImplementation 'org.testcontainers:testcontainers-mongodb' + mongoIntegrationTestImplementation 'org.testcontainers:testcontainers-toxiproxy' + mongoIntegrationTestImplementation libs.toxiproxy.java + + mongoPerformanceTestImplementation 'org.testcontainers:testcontainers' + mongoPerformanceTestImplementation 'org.testcontainers:testcontainers-mongodb' } // Docker-backed lanes are excluded from the default unit run: they fail closed without Docker, and @@ -98,12 +122,7 @@ dependencies { // comment. tasks.named('test', Test) { useJUnitPlatform { - excludeTags 'mongodb-contract', - 'mongodb-replicaset', - 'mongodb-failover', - 'mongodb-migration', - 'mongodb-compatibility', - 'mongodb-security-integration' + excludeTags 'mongodb-contract' } } @@ -113,6 +132,7 @@ tasks.named('test', Test) { strictTestLanes { lane('mongoReplicaSetTest') { integration() + sourceSet = 'mongoIntegrationTest' tag = 'mongodb-replicaset' description = 'Single-node replica set contract lane: mapping, atomic write, transaction, ' + 'change stream (design §29).' @@ -125,6 +145,7 @@ strictTestLanes { } lane('mongoFailoverTest') { integration() + sourceSet = 'mongoIntegrationTest' tag = 'mongodb-failover' description = 'Three-node replica set failover lane: primary kill, partition, unknown ' + 'commit, resume (design §29).' @@ -137,6 +158,7 @@ strictTestLanes { } lane('mongoMigrationTest') { integration() + sourceSet = 'mongoIntegrationTest' tag = 'mongodb-migration' description = 'Migration lane: empty / N-1 / oldest-supported snapshots, lock, checkpoint ' + 'restart (design §12).' @@ -149,6 +171,7 @@ strictTestLanes { } lane('mongoCompatibilityTest') { integration() + sourceSet = 'mongoIntegrationTest' tag = 'mongodb-compatibility' description = 'MongoDB 7.0 compatibility and 8.0 primary certification matrix (design §30).' systemProperty 'mongodb.primary.image', @@ -160,6 +183,7 @@ strictTestLanes { } lane('mongoSecurityIntegrationTest') { integration() + sourceSet = 'mongoIntegrationTest' tag = 'mongodb-security-integration' description = 'RBAC, TLS, injection and redaction release gate against a real server ' + '(design §26).' @@ -210,8 +234,8 @@ tasks.named('check') { // verifyMongoApiSurface — every public type this leaf exposes is a committed decision. // -// 311 of this leaf's 313 production files declare a public top-level type. One jar means `public` -// is public to every adopter, so the intended split between contract and implementation — `api` is +// Most production types are language-level public today. One jar means `public` is public to every +// adopter, so the intended split between contract and implementation — `api` is // the surface, the rest is how it is built — is a convention the compiler does not know about. // // The full move of implementation packages under an `internal` root is a separate, mechanical diff --git a/src/adapter/outbound/persistence-mongo/gradle.lockfile b/src/adapter/outbound/persistence-mongo/gradle.lockfile index d0f37f07..23b07974 100644 --- a/src/adapter/outbound/persistence-mongo/gradle.lockfile +++ b/src/adapter/outbound/persistence-mongo/gradle.lockfile @@ -1,193 +1,194 @@ # This is a Gradle generated file for dependency locking. # Manual edits can break the build and are not advised. # This file is expected to be part of source control. -biz.aQute.bnd:biz.aQute.bnd.annotation:7.1.0=compileClasspath,mongoPerformanceTestCompileClasspath,testCompileClasspath,testkitCompileClasspath -ch.qos.logback:logback-classic:1.5.38=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -ch.qos.logback:logback-core:1.5.38=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.fasterxml.jackson.core:jackson-annotations:2.21=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,mongoPerformanceTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.github.docker-java:docker-java-api:3.7.1=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.github.docker-java:docker-java-transport-zerodep:3.7.1=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.github.docker-java:docker-java-transport:3.7.1=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,mongoPerformanceTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +biz.aQute.bnd:biz.aQute.bnd.annotation:7.1.0=compileClasspath,mongoIntegrationTestCompileClasspath,mongoPerformanceTestCompileClasspath,mongoProviderTestkitCompileClasspath,testCompileClasspath,testkitCompileClasspath +ch.qos.logback:logback-classic:1.5.38=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +ch.qos.logback:logback-core:1.5.38=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.fasterxml.jackson.core:jackson-annotations:2.21=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,mongoIntegrationTestAnnotationProcessor,mongoPerformanceTestAnnotationProcessor,mongoProviderTestkitAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.github.docker-java:docker-java-api:3.7.1=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.github.docker-java:docker-java-transport-zerodep:3.7.1=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.github.docker-java:docker-java-transport:3.7.1=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,mongoIntegrationTestAnnotationProcessor,mongoPerformanceTestAnnotationProcessor,mongoProviderTestkitAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor com.github.spotbugs:spotbugs-annotations:4.10.2=spotbugs com.github.spotbugs:spotbugs:4.10.2=spotbugs com.github.stephenc.jcip:jcip-annotations:1.0-1=spotbugs -com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,mongoPerformanceTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,mongoPerformanceTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.google.auto:auto-common:1.2.2=annotationProcessor,mongoPerformanceTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,mongoIntegrationTestAnnotationProcessor,mongoPerformanceTestAnnotationProcessor,mongoProviderTestkitAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,mongoIntegrationTestAnnotationProcessor,mongoPerformanceTestAnnotationProcessor,mongoProviderTestkitAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.auto:auto-common:1.2.2=annotationProcessor,mongoIntegrationTestAnnotationProcessor,mongoPerformanceTestAnnotationProcessor,mongoProviderTestkitAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor com.google.code.findbugs:jsr305:3.0.2=checkstyle,spotbugs -com.google.code.gson:gson:2.13.2=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,spotbugs,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,mongoPerformanceTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.google.errorprone:error_prone_annotations:2.38.0=compileClasspath -com.google.errorprone:error_prone_annotations:2.41.0=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,spotbugs,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.google.code.gson:gson:2.13.2=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,spotbugs,testkitCompileClasspath,testkitRuntimeClasspath +com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,mongoIntegrationTestAnnotationProcessor,mongoPerformanceTestAnnotationProcessor,mongoProviderTestkitAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.38.0=compileClasspath,mongoPerformanceTestCompileClasspath,testCompileClasspath +com.google.errorprone:error_prone_annotations:2.41.0=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,spotbugs,testkitCompileClasspath,testkitRuntimeClasspath com.google.errorprone:error_prone_annotations:2.47.0=checkstyle -com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,mongoPerformanceTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,mongoPerformanceTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,mongoPerformanceTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,mongoPerformanceTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,mongoPerformanceTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.google.guava:guava:33.5.0-jre=annotationProcessor,mongoPerformanceTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,mongoIntegrationTestAnnotationProcessor,mongoPerformanceTestAnnotationProcessor,mongoProviderTestkitAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,mongoIntegrationTestAnnotationProcessor,mongoPerformanceTestAnnotationProcessor,mongoProviderTestkitAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,mongoIntegrationTestAnnotationProcessor,mongoPerformanceTestAnnotationProcessor,mongoProviderTestkitAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,mongoIntegrationTestAnnotationProcessor,mongoPerformanceTestAnnotationProcessor,mongoProviderTestkitAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,mongoIntegrationTestAnnotationProcessor,mongoPerformanceTestAnnotationProcessor,mongoProviderTestkitAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.guava:guava:33.5.0-jre=annotationProcessor,mongoIntegrationTestAnnotationProcessor,mongoPerformanceTestAnnotationProcessor,mongoProviderTestkitAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor com.google.guava:guava:33.6.0-jre=checkstyle -com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,mongoPerformanceTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,mongoPerformanceTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,mongoPerformanceTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,mongoIntegrationTestAnnotationProcessor,mongoPerformanceTestAnnotationProcessor,mongoProviderTestkitAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,mongoIntegrationTestAnnotationProcessor,mongoPerformanceTestAnnotationProcessor,mongoProviderTestkitAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,mongoIntegrationTestAnnotationProcessor,mongoPerformanceTestAnnotationProcessor,mongoProviderTestkitAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins -com.jayway.jsonpath:json-path:2.10.0=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.jayway.jsonpath:json-path:2.10.0=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath com.puppycrawl.tools:checkstyle:13.5.0=checkstyle -com.tngtech.archunit:archunit-junit5-api:1.3.0=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.tngtech.archunit:archunit-junit5-engine-api:1.3.0=mongoPerformanceTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath -com.tngtech.archunit:archunit-junit5-engine:1.3.0=mongoPerformanceTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath -com.tngtech.archunit:archunit-junit5:1.3.0=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.tngtech.archunit:archunit:1.3.0=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -com.vaadin.external.google:android-json:0.0.20131108.vaadin1=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.tngtech.archunit:archunit-junit5-api:1.3.0=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.tngtech.archunit:archunit-junit5-engine-api:1.3.0=mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath +com.tngtech.archunit:archunit-junit5-engine:1.3.0=mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath +com.tngtech.archunit:archunit-junit5:1.3.0=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.tngtech.archunit:archunit:1.3.0=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +com.vaadin.external.google:android-json:0.0.20131108.vaadin1=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath commons-beanutils:commons-beanutils:1.11.0=checkstyle -commons-codec:commons-codec:1.19.0=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +commons-codec:commons-codec:1.19.0=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath commons-collections:commons-collections:3.2.2=checkstyle -commons-io:commons-io:2.20.0=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +commons-io:commons-io:2.20.0=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath commons-io:commons-io:2.21.0=spotbugs -commons-logging:commons-logging:1.3.6=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -eu.rekawek.toxiproxy:toxiproxy-java:2.1.11=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -eu.rekawek.toxiproxy:toxiproxy-java:2.1.7=testFixturesCompileClasspath,testFixturesRuntimeClasspath +commons-logging:commons-logging:1.3.6=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +eu.rekawek.toxiproxy:toxiproxy-java:2.1.11=testkitCompileClasspath,testkitRuntimeClasspath +eu.rekawek.toxiproxy:toxiproxy-java:2.1.7=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath info.picocli:picocli:4.7.7=checkstyle -io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,mongoPerformanceTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,mongoPerformanceTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -io.micrometer:micrometer-commons:1.16.7=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.micrometer:micrometer-core:1.16.7=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.micrometer:micrometer-observation:1.16.7=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.projectreactor:reactor-core:3.8.7=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -io.projectreactor:reactor-test:3.8.7=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -jakarta.activation:jakarta.activation-api:2.1.4=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -jakarta.annotation:jakarta.annotation-api:3.0.0=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -jakarta.xml.bind:jakarta.xml.bind-api:4.0.5=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -javax.inject:javax.inject:1=annotationProcessor,mongoPerformanceTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,mongoIntegrationTestAnnotationProcessor,mongoPerformanceTestAnnotationProcessor,mongoProviderTestkitAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,mongoIntegrationTestAnnotationProcessor,mongoPerformanceTestAnnotationProcessor,mongoProviderTestkitAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +io.micrometer:micrometer-commons:1.16.7=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.micrometer:micrometer-core:1.16.7=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.micrometer:micrometer-observation:1.16.7=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.projectreactor:reactor-core:3.8.7=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +io.projectreactor:reactor-test:3.8.7=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +jakarta.activation:jakarta.activation-api:2.1.4=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +jakarta.annotation:jakarta.annotation-api:3.0.0=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +jakarta.xml.bind:jakarta.xml.bind-api:4.0.5=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +javax.inject:javax.inject:1=annotationProcessor,mongoIntegrationTestAnnotationProcessor,mongoPerformanceTestAnnotationProcessor,mongoProviderTestkitAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor jaxen:jaxen:2.0.6=spotbugs -net.bytebuddy:byte-buddy-agent:1.17.8=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -net.bytebuddy:byte-buddy:1.17.8=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -net.java.dev.jna:jna:5.18.1=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -net.minidev:accessors-smart:2.6.0=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -net.minidev:json-smart:2.6.0=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +net.bytebuddy:byte-buddy-agent:1.17.8=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +net.bytebuddy:byte-buddy:1.17.8=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +net.java.dev.jna:jna:5.18.1=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +net.minidev:accessors-smart:2.6.0=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +net.minidev:json-smart:2.6.0=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs org.antlr:antlr4-runtime:4.13.2=checkstyle org.apache.bcel:bcel:6.12.0=spotbugs -org.apache.commons:commons-compress:1.28.0=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.apache.commons:commons-lang3:3.20.0=checkstyle,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,spotbugs,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.apache.commons:commons-compress:1.28.0=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.apache.commons:commons-lang3:3.20.0=checkstyle,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,spotbugs,testkitCompileClasspath,testkitRuntimeClasspath org.apache.commons:commons-text:1.15.0=spotbugs org.apache.commons:commons-text:1.3=checkstyle org.apache.httpcomponents:httpclient:4.5.13=checkstyle org.apache.httpcomponents:httpcore:4.4.16=checkstyle -org.apache.logging.log4j:log4j-api:2.25.5=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,spotbugs,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.apache.logging.log4j:log4j-api:2.25.5=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,spotbugs,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath org.apache.logging.log4j:log4j-core:2.25.5=spotbugs -org.apache.logging.log4j:log4j-to-slf4j:2.25.5=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.apache.logging.log4j:log4j-to-slf4j:2.25.5=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath org.apache.maven.doxia:doxia-core:1.12.0=checkstyle org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle -org.apache.tomcat.embed:tomcat-embed-core:11.0.24=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.apache.tomcat.embed:tomcat-embed-el:11.0.24=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.apache.tomcat.embed:tomcat-embed-websocket:11.0.24=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.apache.tomcat.embed:tomcat-embed-core:11.0.24=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.apache.tomcat.embed:tomcat-embed-el:11.0.24=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.apache.tomcat.embed:tomcat-embed-websocket:11.0.24=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath org.apache.xbean:xbean-reflect:3.7=checkstyle -org.apiguardian:apiguardian-api:1.1.2=mongoPerformanceTestCompileClasspath,testCompileClasspath,testkitCompileClasspath -org.assertj:assertj-core:3.27.7=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.awaitility:awaitility:4.3.0=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.apiguardian:apiguardian-api:1.1.2=mongoIntegrationTestCompileClasspath,mongoPerformanceTestCompileClasspath,mongoProviderTestkitCompileClasspath,testCompileClasspath,testkitCompileClasspath +org.assertj:assertj-core:3.27.7=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.awaitility:awaitility:4.3.0=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle org.codehaus.plexus:plexus-component-annotations:2.1.0=checkstyle org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle org.codehaus.plexus:plexus-utils:3.3.0=checkstyle org.dom4j:dom4j:2.2.0=spotbugs -org.hamcrest:hamcrest:3.0=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.hdrhistogram:HdrHistogram:2.2.2=mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath +org.hamcrest:hamcrest:3.0=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.hdrhistogram:HdrHistogram:2.2.2=mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath org.javassist:javassist:3.28.0-GA=checkstyle -org.jetbrains:annotations:17.0.0=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,mongoPerformanceTestAnnotationProcessor,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testFixturesAnnotationProcessor,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitAnnotationProcessor,testkitCompileClasspath,testkitRuntimeClasspath -org.junit.jupiter:junit-jupiter-api:6.0.3=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.junit.jupiter:junit-jupiter-engine:6.0.3=mongoPerformanceTestRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath -org.junit.jupiter:junit-jupiter-params:6.0.3=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.junit.jupiter:junit-jupiter:6.0.3=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.junit.platform:junit-platform-commons:6.0.3=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.junit.platform:junit-platform-engine:6.0.3=mongoPerformanceTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath -org.junit.platform:junit-platform-launcher:6.0.3=mongoPerformanceTestRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath -org.junit:junit-bom:6.0.3=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.jetbrains:annotations:17.0.0=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,mongoIntegrationTestAnnotationProcessor,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestAnnotationProcessor,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitAnnotationProcessor,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testFixturesAnnotationProcessor,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitAnnotationProcessor,testkitCompileClasspath,testkitRuntimeClasspath +org.junit.jupiter:junit-jupiter-api:6.0.3=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.junit.jupiter:junit-jupiter-engine:6.0.3=mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath +org.junit.jupiter:junit-jupiter-params:6.0.3=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.junit.jupiter:junit-jupiter:6.0.3=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.junit.platform:junit-platform-commons:6.0.3=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.junit.platform:junit-platform-engine:6.0.3=mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath +org.junit.platform:junit-platform-launcher:6.0.3=mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath +org.junit:junit-bom:6.0.3=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath org.junit:junit-bom:6.1.0=spotbugs -org.latencyutils:LatencyUtils:2.0.3=mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath -org.mockito:mockito-core:5.20.0=mockitoAgent,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.mockito:mockito-junit-jupiter:5.20.0=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.mongodb:bson-record-codec:5.6.5=mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath -org.mongodb:bson:5.6.5=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.mongodb:mongodb-driver-core:5.6.5=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.mongodb:mongodb-driver-reactivestreams:5.6.5=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.mongodb:mongodb-driver-sync:5.6.5=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.objenesis:objenesis:3.3=mongoPerformanceTestRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath -org.opentest4j:opentest4j:1.3.0=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.osgi:org.osgi.annotation.bundle:2.0.0=compileClasspath,mongoPerformanceTestCompileClasspath,testCompileClasspath,testkitCompileClasspath -org.osgi:org.osgi.annotation.versioning:1.1.2=compileClasspath,mongoPerformanceTestCompileClasspath,testCompileClasspath,testkitCompileClasspath -org.osgi:org.osgi.resource:1.0.0=compileClasspath,mongoPerformanceTestCompileClasspath,testCompileClasspath,testkitCompileClasspath -org.osgi:org.osgi.service.serviceloader:1.0.0=compileClasspath,mongoPerformanceTestCompileClasspath,testCompileClasspath,testkitCompileClasspath +org.latencyutils:LatencyUtils:2.0.3=mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath +org.mockito:mockito-core:5.20.0=mockitoAgent,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.mockito:mockito-junit-jupiter:5.20.0=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.mongodb:bson-record-codec:5.6.5=mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath +org.mongodb:bson:5.6.5=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.mongodb:mongodb-driver-core:5.6.5=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.mongodb:mongodb-driver-reactivestreams:5.6.5=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.mongodb:mongodb-driver-sync:5.6.5=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.objenesis:objenesis:3.3=mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitRuntimeClasspath,testRuntimeClasspath,testkitRuntimeClasspath +org.opentest4j:opentest4j:1.3.0=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.osgi:org.osgi.annotation.bundle:2.0.0=compileClasspath,mongoIntegrationTestCompileClasspath,mongoPerformanceTestCompileClasspath,mongoProviderTestkitCompileClasspath,testCompileClasspath,testkitCompileClasspath +org.osgi:org.osgi.annotation.versioning:1.1.2=compileClasspath,mongoIntegrationTestCompileClasspath,mongoPerformanceTestCompileClasspath,mongoProviderTestkitCompileClasspath,testCompileClasspath,testkitCompileClasspath +org.osgi:org.osgi.resource:1.0.0=compileClasspath,mongoIntegrationTestCompileClasspath,mongoPerformanceTestCompileClasspath,mongoProviderTestkitCompileClasspath,testCompileClasspath,testkitCompileClasspath +org.osgi:org.osgi.service.serviceloader:1.0.0=compileClasspath,mongoIntegrationTestCompileClasspath,mongoPerformanceTestCompileClasspath,mongoProviderTestkitCompileClasspath,testCompileClasspath,testkitCompileClasspath org.ow2.asm:asm-analysis:9.10.1=spotbugs org.ow2.asm:asm-commons:9.10.1=spotbugs org.ow2.asm:asm-tree:9.10.1=spotbugs org.ow2.asm:asm-util:9.10.1=spotbugs org.ow2.asm:asm:9.10.1=spotbugs -org.ow2.asm:asm:9.7.1=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.pcollections:pcollections:4.0.1=annotationProcessor,mongoPerformanceTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor -org.reactivestreams:reactive-streams:1.0.4=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.ow2.asm:asm:9.7.1=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.pcollections:pcollections:4.0.1=annotationProcessor,mongoIntegrationTestAnnotationProcessor,mongoPerformanceTestAnnotationProcessor,mongoProviderTestkitAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,testkitAnnotationProcessor +org.reactivestreams:reactive-streams:1.0.4=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath org.reflections:reflections:0.10.2=checkstyle -org.rnorth.duct-tape:duct-tape:1.0.8=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.skyscreamer:jsonassert:1.5.3=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.slf4j:jul-to-slf4j:2.0.18=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.slf4j:slf4j-api:2.0.18=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.rnorth.duct-tape:duct-tape:1.0.8=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.skyscreamer:jsonassert:1.5.3=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.slf4j:jul-to-slf4j:2.0.18=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.slf4j:slf4j-api:2.0.18=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j org.slf4j:slf4j-simple:2.0.18=checkstyle -org.springframework.boot:spring-boot-autoconfigure:4.0.8=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-autoconfigure:4.0.8=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath org.springframework.boot:spring-boot-configuration-processor:4.0.8=annotationProcessor -org.springframework.boot:spring-boot-data-commons:4.0.8=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-data-mongodb:4.0.8=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-http-converter:4.0.8=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-jackson:4.0.8=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-mongodb:4.0.8=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-persistence:4.0.8=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-reactor:4.0.8=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-resttestclient:4.0.8=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-servlet:4.0.8=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-starter-data-mongodb-reactive:4.0.8=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-starter-data-mongodb:4.0.8=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-starter-jackson-test:4.0.8=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-starter-jackson:4.0.8=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-starter-logging:4.0.8=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-starter-mongodb:4.0.8=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-starter-test:4.0.8=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-starter-tomcat-runtime:4.0.8=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-starter-tomcat:4.0.8=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-starter-webmvc-test:4.0.8=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-starter-webmvc:4.0.8=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-starter:4.0.8=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-test-autoconfigure:4.0.8=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-test:4.0.8=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-tomcat:4.0.8=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-transaction:4.0.8=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-web-server:4.0.8=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-webmvc-test:4.0.8=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot-webmvc:4.0.8=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.boot:spring-boot:4.0.8=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.data:spring-data-commons:4.0.7=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework.data:spring-data-mongodb:5.0.7=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework:spring-aop:7.0.9=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework:spring-beans:7.0.9=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework:spring-context:7.0.9=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework:spring-core:7.0.9=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework:spring-expression:7.0.9=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework:spring-test:7.0.9=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework:spring-tx:7.0.9=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework:spring-web:7.0.9=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.springframework:spring-webmvc:7.0.9=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.testcontainers:testcontainers-junit-jupiter:2.0.5=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.testcontainers:testcontainers-mongodb:2.0.5=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.testcontainers:testcontainers-toxiproxy:2.0.5=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.testcontainers:testcontainers:2.0.5=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-data-commons:4.0.8=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-data-mongodb:4.0.8=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-health:4.0.8=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-http-converter:4.0.8=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-jackson:4.0.8=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-mongodb:4.0.8=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-persistence:4.0.8=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-reactor:4.0.8=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-resttestclient:4.0.8=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-servlet:4.0.8=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-starter-data-mongodb-reactive:4.0.8=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-starter-data-mongodb:4.0.8=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-starter-jackson-test:4.0.8=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-starter-jackson:4.0.8=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-starter-logging:4.0.8=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-starter-mongodb:4.0.8=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-starter-test:4.0.8=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-starter-tomcat-runtime:4.0.8=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-starter-tomcat:4.0.8=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-starter-webmvc-test:4.0.8=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-starter-webmvc:4.0.8=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-starter:4.0.8=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-test-autoconfigure:4.0.8=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-test:4.0.8=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-tomcat:4.0.8=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-transaction:4.0.8=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-web-server:4.0.8=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-webmvc-test:4.0.8=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot-webmvc:4.0.8=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.boot:spring-boot:4.0.8=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.data:spring-data-commons:4.0.7=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework.data:spring-data-mongodb:5.0.7=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework:spring-aop:7.0.9=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework:spring-beans:7.0.9=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework:spring-context:7.0.9=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework:spring-core:7.0.9=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework:spring-expression:7.0.9=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework:spring-test:7.0.9=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework:spring-tx:7.0.9=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework:spring-web:7.0.9=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.springframework:spring-webmvc:7.0.9=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.testcontainers:testcontainers-junit-jupiter:2.0.5=testkitCompileClasspath,testkitRuntimeClasspath +org.testcontainers:testcontainers-mongodb:2.0.5=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.testcontainers:testcontainers-toxiproxy:2.0.5=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.testcontainers:testcontainers:2.0.5=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs -org.xmlunit:xmlunit-core:2.10.4=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -org.yaml:snakeyaml:2.5=compileClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -tools.jackson.core:jackson-core:3.1.5=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -tools.jackson.core:jackson-databind:3.1.5=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath -tools.jackson:jackson-bom:3.1.5=mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.xmlunit:xmlunit-core:2.10.4=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +org.yaml:snakeyaml:2.5=compileClasspath,mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +tools.jackson.core:jackson-core:3.1.5=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +tools.jackson.core:jackson-databind:3.1.5=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath +tools.jackson:jackson-bom:3.1.5=mongoIntegrationTestCompileClasspath,mongoIntegrationTestRuntimeClasspath,mongoPerformanceTestCompileClasspath,mongoPerformanceTestRuntimeClasspath,mongoProviderTestkitCompileClasspath,mongoProviderTestkitRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,testkitCompileClasspath,testkitRuntimeClasspath empty= diff --git a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/MongoPlatformHealthConfiguration.java b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/MongoPlatformHealthConfiguration.java new file mode 100644 index 00000000..24a7e744 --- /dev/null +++ b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/MongoPlatformHealthConfiguration.java @@ -0,0 +1,20 @@ +package dev.caskeleton.adapter.outbound.mongo; + +import dev.caskeleton.adapter.outbound.mongo.autoconfigure.MongoPlatformHealthIndicator; +import org.springframework.boot.autoconfigure.condition.ConditionalOnBean; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +/** Internal Actuator health composition for the Mongo platform. */ +@Configuration(proxyBeanMethods = false) +class MongoPlatformHealthConfiguration { + + @Bean("mongoPlatformHealthContributor") + @ConditionalOnBean(MongoPlatformHealthIndicator.class) + @ConditionalOnMissingBean(name = "mongoPlatformHealthContributor") + MongoPlatformHealthContributor mongoPlatformHealthContributor( + MongoPlatformHealthIndicator platform) { + return new MongoPlatformHealthContributor(platform); + } +} diff --git a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/MongoPlatformHealthContributor.java b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/MongoPlatformHealthContributor.java new file mode 100644 index 00000000..809017c7 --- /dev/null +++ b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/MongoPlatformHealthContributor.java @@ -0,0 +1,23 @@ +package dev.caskeleton.adapter.outbound.mongo; + +import dev.caskeleton.adapter.outbound.mongo.autoconfigure.MongoPlatformHealthIndicator; +import java.util.Objects; +import org.springframework.boot.health.contributor.Health; +import org.springframework.boot.health.contributor.HealthIndicator; + +/** Actuator SPI bridge over the platform-owned Mongo health facts. */ +final class MongoPlatformHealthContributor implements HealthIndicator { + + private final MongoPlatformHealthIndicator platform; + + MongoPlatformHealthContributor(MongoPlatformHealthIndicator platform) { + this.platform = Objects.requireNonNull(platform, "platform"); + } + + @Override + public Health health() { + Health.Builder builder = platform.ready() ? Health.up() : Health.down(); + platform.details().forEach(builder::withDetail); + return builder.build(); + } +} diff --git a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/MongoRootAutoConfiguration.java b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/MongoRootAutoConfiguration.java index 5aa66da5..e0d58498 100644 --- a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/MongoRootAutoConfiguration.java +++ b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/MongoRootAutoConfiguration.java @@ -32,6 +32,7 @@ import org.springframework.context.annotation.Import; @Import({ MongoPersistenceConfig.class, MongoPlatformAutoConfiguration.class, - MongoDriverObservabilityAutoConfiguration.class + MongoDriverObservabilityAutoConfiguration.class, + MongoPlatformHealthConfiguration.class }) public class MongoRootAutoConfiguration {} diff --git a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoPlatformHealthIndicator.java b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoPlatformHealthIndicator.java index 8e7bf50f..5c700231 100644 --- a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoPlatformHealthIndicator.java +++ b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoPlatformHealthIndicator.java @@ -55,8 +55,7 @@ public final class MongoPlatformHealthIndicator { /** True when the observed topology differs from what any profile declared. */ public boolean topologyMismatch() { - return properties.profiles().values().stream() - .anyMatch(profile -> profile.topology() != probe.observedTopology()); + return topologyMismatch(probe.observation()); } /** @@ -67,20 +66,30 @@ public final class MongoPlatformHealthIndicator { * from a cluster that is already short of it. {@link #ready()} therefore does not consult this. */ public boolean degradedSecondaryAvailability() { - return probe.observedTopology() != MongoTopology.STANDALONE - && probe.availableSecondaries() < properties.requiredSecondaries(); + return degradedSecondaryAvailability(probe.observation()); } /** The health detail map, containing only bounded, non-sensitive values. */ public Map details() { + MongoTopologyProbe.Observation observation = probe.observation(); Map details = new LinkedHashMap<>(); - details.put("topology", probe.observedTopology().name()); - details.put("serverVersion", probe.serverVersion()); - details.put("topologyMismatch", topologyMismatch()); - details.put("degradedSecondaryAvailability", degradedSecondaryAvailability()); - details.put("availableSecondaries", probe.availableSecondaries()); + details.put("topology", observation.observedTopology().name()); + details.put("serverVersion", observation.serverVersion()); + details.put("topologyMismatch", topologyMismatch(observation)); + details.put("degradedSecondaryAvailability", degradedSecondaryAvailability(observation)); + details.put("availableSecondaries", observation.availableSecondaries()); details.put("requiredSecondaries", properties.requiredSecondaries()); details.put("profiles", properties.profiles().keySet()); return Map.copyOf(details); } + + private boolean topologyMismatch(MongoTopologyProbe.Observation observation) { + return properties.profiles().values().stream() + .anyMatch(profile -> profile.topology() != observation.observedTopology()); + } + + private boolean degradedSecondaryAvailability(MongoTopologyProbe.Observation observation) { + return observation.observedTopology() != MongoTopology.STANDALONE + && observation.availableSecondaries() < properties.requiredSecondaries(); + } } diff --git a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoPlatformSettings.java b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoPlatformSettings.java index 3c170d1c..e0798665 100644 --- a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoPlatformSettings.java +++ b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoPlatformSettings.java @@ -45,14 +45,11 @@ public record MongoPlatformSettings( // configured no platform profile yet must still start, so binding treats "no profiles" as an // empty map instead of a binding failure. profiles = profiles == null ? Map.of() : Map.copyOf(profiles); - // Experimental, and therefore not a switch (MNG-INT-003). The driver-side source — watch, - // resumeAfter/startAfter, cursor lifetime, reconnection — is not shipped; what exists is policy - // and value objects that do not add up to a running consumer. Accepting the flag and ignoring - // it - // would leave an operator believing it took effect, so the value is refused rather than stored: - // zero beans, zero threads, and a `true` that cannot be honoured never becomes one that looks - // honoured. - changeStreams = false; + if (changeStreams) { + throw MongoOperationRejectedException.of( + "config.change-streams", + "change streams are not an activatable platform capability in this composition"); + } // Absent means the platform default, and a negative count is refused rather than clamped: a // requirement of -1 is not a lenient requirement, it is a typo, and reading it as "no // secondaries needed" is how a health view comes to report a cluster it never checked. diff --git a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoTopologyProbe.java b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoTopologyProbe.java index 9c312302..2ac22d1f 100644 --- a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoTopologyProbe.java +++ b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoTopologyProbe.java @@ -1,5 +1,7 @@ package dev.caskeleton.adapter.outbound.mongo.autoconfigure; +import com.mongodb.connection.ClusterDescription; +import com.mongodb.connection.ClusterType; import dev.caskeleton.adapter.outbound.mongo.api.capability.MongoCapability; import dev.caskeleton.adapter.outbound.mongo.api.capability.MongoCapabilitySet; import dev.caskeleton.adapter.outbound.mongo.api.capability.MongoCapabilitySupport; @@ -8,91 +10,106 @@ import dev.caskeleton.adapter.outbound.mongo.api.profile.MongoTopology; import java.util.ArrayList; import java.util.List; import java.util.Objects; +import java.util.concurrent.atomic.AtomicReference; /** - * Derives the capability report from the observed topology (design §7.4, §28). + * Holds the latest topology observation used by startup validation and health. * - *

    Configuration says which topology a deployment believes it has; the probe reports what it - * actually connected to. The startup validator compares the two, because "we configured a replica - * set" and "we are talking to one" are different claims and only the second one determines whether - * transactions work. + *

    The same bean is intentionally mutable: MongoDB topology is not a startup constant. Driver + * SDAM events replace the snapshot when the cluster changes, so an actuator call after a secondary + * disappears does not keep reporting the count observed when the process started. * - *

    Everything here is an observation. Nothing on this class has a default, because a default is - * an answer about a cluster nobody looked at, and the health view that reads these values reports - * them to an operator as fact. + *

    The three-argument constructor remains useful for a startup observation and for tests. A + * composition can also call {@link #observe(MongoTopology, String, int)} from its own probe source; + * the shipped client settings customizer wires driver cluster-description changes into this method + * whenever this bean is present. */ public final class MongoTopologyProbe { - private final MongoTopology observedTopology; - - private final String serverVersion; - - private final int availableSecondaries; + private final AtomicReference current; /** + * Creates the probe from an initial observation. + * * @param observedTopology the topology the client connected to * @param serverVersion the version the connected server reports * @param availableSecondaries how many data-bearing secondaries the client can currently see */ public MongoTopologyProbe( MongoTopology observedTopology, String serverVersion, int availableSecondaries) { - this.observedTopology = Objects.requireNonNull(observedTopology, "observedTopology"); - this.serverVersion = Objects.requireNonNull(serverVersion, "serverVersion"); - if (availableSecondaries < 0) { - throw new IllegalArgumentException("the observed secondary count must not be negative"); - } - this.availableSecondaries = availableSecondaries; + this.current = + new AtomicReference<>(observation(observedTopology, serverVersion, availableSecondaries)); } - /** The topology this client is actually connected to. */ - public MongoTopology observedTopology() { - return observedTopology; - } - - /** The server version this client is actually talking to. */ - public String serverVersion() { - return serverVersion; + /** Replaces the current observation atomically. */ + public void observe( + MongoTopology observedTopology, String serverVersion, int availableSecondaries) { + current.set(observation(observedTopology, serverVersion, availableSecondaries)); } /** - * How many data-bearing secondaries this client can currently see. + * Refreshes topology and secondary availability from a driver SDAM description. * - *

    Part of the probe rather than a number the health bean is handed separately, because it is - * an observation of the same cluster description that produced the topology, and a caller who has - * one has the other. It used to be neither: the health bean was constructed with a literal zero, - * so a healthy five-member set and a set with every secondary down produced identical output. + *

    The MongoDB Java driver does not expose server semantic version through {@link + * ClusterDescription}; the last explicitly observed version is therefore retained while the + * dynamic topology facts are refreshed. */ - public int availableSecondaries() { - return availableSecondaries; + public void observe(ClusterDescription description) { + Objects.requireNonNull(description, "description"); + Observation previous = current.get(); + MongoTopology topology = topologyOf(description.getType(), previous.observedTopology()); + int secondaries = + (int) + description.getServerDescriptions().stream() + .filter(server -> server.isOk() && server.isSecondary()) + .count(); + observe(topology, previous.serverVersion(), secondaries); } - /** The capabilities this topology and version support. */ + /** The topology this client currently sees. */ + public MongoTopology observedTopology() { + return current.get().observedTopology(); + } + + /** The last server version supplied by the topology probe source. */ + public String serverVersion() { + return current.get().serverVersion(); + } + + /** How many data-bearing secondaries the latest observation can see. */ + public int availableSecondaries() { + return current.get().availableSecondaries(); + } + + /** The capabilities supported by the latest topology observation. */ public MongoCapabilitySet capabilities() { + Observation observation = current.get(); + MongoTopology topology = observation.observedTopology(); List supports = new ArrayList<>(); - supports.add(sessionBacked(MongoCapability.TRANSACTION)); - supports.add(sessionBacked(MongoCapability.CAUSAL_SESSION)); - supports.add(sessionBacked(MongoCapability.CHANGE_STREAM)); + supports.add(sessionBacked(MongoCapability.TRANSACTION, topology)); + supports.add(sessionBacked(MongoCapability.CAUSAL_SESSION, topology)); + supports.add(sessionBacked(MongoCapability.CHANGE_STREAM, topology)); supports.add(MongoCapabilitySupport.of(MongoCapability.GEOSPATIAL, MongoSupportLevel.STABLE)); supports.add(MongoCapabilitySupport.of(MongoCapability.TTL_CLEANUP, MongoSupportLevel.STABLE)); supports.add( - observedTopology == MongoTopology.SHARDED || observedTopology == MongoTopology.ATLAS + topology == MongoTopology.SHARDED || topology == MongoTopology.ATLAS ? MongoCapabilitySupport.of(MongoCapability.SHARDING, MongoSupportLevel.ADVANCED) : MongoCapabilitySupport.unsupported( - MongoCapability.SHARDING, "topology is " + observedTopology)); + MongoCapability.SHARDING, "topology is " + topology)); supports.add( MongoCapabilitySupport.of(MongoCapability.TIME_SERIES, MongoSupportLevel.ADVANCED) - .withConstraint(MongoCapabilitySupport.SERVER_VERSION, serverVersion)); + .withConstraint(MongoCapabilitySupport.SERVER_VERSION, observation.serverVersion())); supports.add(MongoCapabilitySupport.of(MongoCapability.CSFLE, MongoSupportLevel.ADVANCED)); supports.add( MongoCapabilitySupport.of( MongoCapability.QUERYABLE_ENCRYPTION, MongoSupportLevel.ADVANCED)); supports.add( - observedTopology == MongoTopology.ATLAS + topology == MongoTopology.ATLAS ? MongoCapabilitySupport.of(MongoCapability.SEARCH, MongoSupportLevel.ADVANCED) : MongoCapabilitySupport.unsupported( MongoCapability.SEARCH, "search requires an Atlas deployment")); supports.add( - observedTopology == MongoTopology.ATLAS + topology == MongoTopology.ATLAS ? MongoCapabilitySupport.of(MongoCapability.VECTOR_SEARCH, MongoSupportLevel.ADVANCED) : MongoCapabilitySupport.unsupported( MongoCapability.VECTOR_SEARCH, "vector search requires an Atlas deployment")); @@ -112,12 +129,40 @@ public final class MongoTopologyProbe { return MongoCapabilitySet.of(supports); } - private MongoCapabilitySupport sessionBacked(MongoCapability capability) { - if (!observedTopology.supportsSessions()) { + Observation observation() { + return current.get(); + } + + private static MongoCapabilitySupport sessionBacked( + MongoCapability capability, MongoTopology topology) { + if (!topology.supportsSessions()) { return MongoCapabilitySupport.unsupported( capability, "topology is STANDALONE, which has no oplog"); } return MongoCapabilitySupport.of(capability, MongoSupportLevel.STABLE) - .withConstraint(MongoCapabilitySupport.TOPOLOGY, observedTopology.name()); + .withConstraint(MongoCapabilitySupport.TOPOLOGY, topology.name()); } + + private static Observation observation( + MongoTopology topology, String serverVersion, int availableSecondaries) { + Objects.requireNonNull(topology, "observedTopology"); + Objects.requireNonNull(serverVersion, "serverVersion"); + if (availableSecondaries < 0) { + throw new IllegalArgumentException("the observed secondary count must not be negative"); + } + return new Observation(topology, serverVersion, availableSecondaries); + } + + private static MongoTopology topologyOf(ClusterType type, MongoTopology previous) { + return switch (type) { + case STANDALONE -> MongoTopology.STANDALONE; + case REPLICA_SET -> + previous == MongoTopology.ATLAS ? MongoTopology.ATLAS : MongoTopology.REPLICA_SET; + case SHARDED -> previous == MongoTopology.ATLAS ? MongoTopology.ATLAS : MongoTopology.SHARDED; + case LOAD_BALANCED, UNKNOWN -> previous; + }; + } + + record Observation( + MongoTopology observedTopology, String serverVersion, int availableSecondaries) {} } diff --git a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/changestream/MongoChangeStreamSubscription.java b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/changestream/MongoChangeStreamSubscription.java index d6a13716..2b1239de 100644 --- a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/changestream/MongoChangeStreamSubscription.java +++ b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/changestream/MongoChangeStreamSubscription.java @@ -10,6 +10,11 @@ import java.util.Objects; *

    Batch size and maximum await time are both bounded. A change stream is a long-lived cursor: an * unbounded batch buys throughput with heap, and an unbounded await time makes a stalled stream * indistinguishable from an idle one, so nothing ever alerts. + * + *

    These two cursor knobs are part of the platform subscription contract for driver-level change + * stream sources. Spring Data MongoDB 5.0.7 does not expose either knob through + * {@code ChangeStreamOptions}; {@code SpringReactiveChangeStreamSource} therefore documents that + * limitation explicitly and is not an activatable release composition. */ public record MongoChangeStreamSubscription( String subscriptionProfile, diff --git a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/changestream/consumer/SpringReactiveChangeStreamSource.java b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/changestream/consumer/SpringReactiveChangeStreamSource.java index 6d2bd659..ac7cfd4d 100644 --- a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/changestream/consumer/SpringReactiveChangeStreamSource.java +++ b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/changestream/consumer/SpringReactiveChangeStreamSource.java @@ -23,6 +23,11 @@ import reactor.core.publisher.Flux; *

    The collection is resolved through the profile registry rather than named directly, so a * subscription cannot watch a collection the platform does not know about — which is also the only * way the physical name stays a deployment decision. + * + *

    Spring Data MongoDB 5.0.7's {@link ChangeStreamOptions} exposes resume/full-document options + * but not driver {@code batchSize} or {@code maxAwaitTime}. This source therefore must not be + * treated as satisfying those subscription bounds; the platform configuration rejects change-stream + * activation until a driver-level source can carry the complete contract. */ public final class SpringReactiveChangeStreamSource implements MongoChangeStreamSource { diff --git a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/client/MongoClientSettingsFactory.java b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/client/MongoClientSettingsFactory.java index 70bb70e5..de063428 100644 --- a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/client/MongoClientSettingsFactory.java +++ b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/client/MongoClientSettingsFactory.java @@ -63,41 +63,51 @@ public final class MongoClientSettingsFactory { * the selected profile is not configured */ public MongoClientSettings create() { + MongoClientSettings.Builder builder = MongoClientSettings.builder(); + customize(builder); + return builder.build(); + } + + /** Applies the selected typed profile to an existing driver builder, including Boot's builder. */ + public void customize(MongoClientSettings.Builder builder) { + Objects.requireNonNull(builder, "builder"); MongoProfileProperties profile = settings.require(activeProfile); MongoCredentialReference reference = new MongoCredentialReference(profile.uriSecret(), MongoPrincipalRole.APP_WRITE); - return credentials.withConnectionString(reference, uri -> build(profile, uri)); + credentials.withConnectionString( + reference, + uri -> { + apply(builder, profile, uri); + return Boolean.TRUE; + }); } - private static MongoClientSettings build(MongoProfileProperties profile, String uri) { - MongoClientSettings.Builder builder = - MongoClientSettings.builder() - .applyConnectionString(new ConnectionString(uri)) - // Pinned from the manifest rather than left to the driver, whose own default has - // changed - // across major versions — a value that moves under a stored document is a migration - // nobody wrote. - .uuidRepresentation(uuidRepresentationOf(profile)) - .applyToSocketSettings( - socket -> - socket - .connectTimeout(profile.connectTimeout().toMillis(), TimeUnit.MILLISECONDS) - .readTimeout(profile.socketReadTimeout().toMillis(), TimeUnit.MILLISECONDS)) - .applyToClusterSettings( - cluster -> - cluster.serverSelectionTimeout( - profile.serverSelectionTimeout().toMillis(), TimeUnit.MILLISECONDS)) - .applyToConnectionPoolSettings( - pool -> - pool.minSize(profile.poolMinSize()) - .maxSize(profile.poolMaxSize()) - .maxWaitTime(profile.poolMaxWaitTime().toMillis(), TimeUnit.MILLISECONDS)); + private static void apply( + MongoClientSettings.Builder builder, MongoProfileProperties profile, String uri) { + builder + .applyConnectionString(new ConnectionString(uri)) + // Pinned from the manifest rather than left to the driver, whose own default has changed + // across major versions — a value that moves under a stored document is a migration nobody + // wrote. + .uuidRepresentation(uuidRepresentationOf(profile)) + .timeout(profile.operationTimeout().toMillis(), TimeUnit.MILLISECONDS) + .applyToSocketSettings( + socket -> + socket + .connectTimeout(profile.connectTimeout().toMillis(), TimeUnit.MILLISECONDS) + .readTimeout(profile.socketReadTimeout().toMillis(), TimeUnit.MILLISECONDS)) + .applyToClusterSettings( + cluster -> + cluster.serverSelectionTimeout( + profile.serverSelectionTimeout().toMillis(), TimeUnit.MILLISECONDS)) + .applyToConnectionPoolSettings( + pool -> + pool.minSize(profile.poolMinSize()) + .maxSize(profile.poolMaxSize()) + .maxWaitTime(profile.poolMaxWaitTime().toMillis(), TimeUnit.MILLISECONDS)); if (profile.tlsRequired()) { - // Stated by the profile, applied here. A profile that declares TLS and connects without it is - // the failure this leaf's production validation exists to prevent, and it cannot prevent it - // from a record the driver never reads. builder.applyToSslSettings(ssl -> ssl.enabled(true)); } if (profile.stableApiStrict()) { @@ -108,7 +118,6 @@ public final class MongoClientSettingsFactory { .deprecationErrors(true) .build()); } - return builder.build(); } private static UuidRepresentation uuidRepresentationOf(MongoProfileProperties profile) { diff --git a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/client/MongoProfileClientSettingsAutoConfiguration.java b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/client/MongoProfileClientSettingsAutoConfiguration.java new file mode 100644 index 00000000..2e060051 --- /dev/null +++ b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/client/MongoProfileClientSettingsAutoConfiguration.java @@ -0,0 +1,90 @@ +package dev.caskeleton.adapter.outbound.mongo.client; + +import com.mongodb.MongoClientSettings; +import com.mongodb.event.ClusterDescriptionChangedEvent; +import com.mongodb.event.ClusterListener; +import dev.caskeleton.adapter.outbound.mongo.autoconfigure.MongoPlatformSettings; +import dev.caskeleton.adapter.outbound.mongo.autoconfigure.MongoTopologyProbe; +import dev.caskeleton.adapter.outbound.mongo.security.MongoCredentialResolver; +import java.util.Objects; +import org.springframework.beans.factory.ObjectProvider; +import org.springframework.boot.autoconfigure.AutoConfiguration; +import org.springframework.boot.autoconfigure.condition.ConditionalOnBean; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.mongodb.autoconfigure.MongoClientSettingsBuilderCustomizer; +import org.springframework.context.annotation.Bean; +import org.springframework.core.Ordered; +import org.springframework.core.env.Environment; + +/** Connects the typed Mongo profile to Spring Boot's actual driver builder. */ +@AutoConfiguration( + beforeName = "org.springframework.boot.mongodb.autoconfigure.MongoAutoConfiguration") +@ConditionalOnProperty( + prefix = "ca-skeleton.persistence-mongo", + name = "enabled", + havingValue = "true") +class MongoProfileClientSettingsAutoConfiguration { + + @Bean("mongoTopologyRefreshCustomizer") + @ConditionalOnBean(MongoTopologyProbe.class) + @ConditionalOnMissingBean(name = "mongoTopologyRefreshCustomizer") + MongoClientSettingsBuilderCustomizer mongoTopologyRefreshCustomizer(MongoTopologyProbe probe) { + Objects.requireNonNull(probe, "probe"); + return builder -> + builder.applyToClusterSettings( + cluster -> + cluster.addClusterListener( + new ClusterListener() { + @Override + public void clusterDescriptionChanged(ClusterDescriptionChangedEvent event) { + probe.observe(event.getNewDescription()); + } + })); + } + + @Bean("mongoProfileClientSettingsCustomizer") + @ConditionalOnMissingBean(name = "mongoProfileClientSettingsCustomizer") + MongoClientSettingsBuilderCustomizer mongoProfileClientSettingsCustomizer( + MongoPlatformSettings settings, + ObjectProvider credentialResolvers, + Environment environment) { + String activeProfile = + environment.getProperty("ca-skeleton.persistence-mongo.active-profile", "").trim(); + return new OrderedProfileCustomizer(settings, activeProfile, credentialResolvers); + } + + private static final class OrderedProfileCustomizer + implements MongoClientSettingsBuilderCustomizer, Ordered { + private final MongoPlatformSettings settings; + private final String activeProfile; + private final ObjectProvider credentialResolvers; + + private OrderedProfileCustomizer( + MongoPlatformSettings settings, + String activeProfile, + ObjectProvider credentialResolvers) { + this.settings = Objects.requireNonNull(settings, "settings"); + this.activeProfile = Objects.requireNonNull(activeProfile, "activeProfile"); + this.credentialResolvers = Objects.requireNonNull(credentialResolvers, "credentialResolvers"); + } + + @Override + public void customize(MongoClientSettings.Builder builder) { + if (settings.profiles().isEmpty()) { + return; + } + MongoCredentialResolver resolver = credentialResolvers.getIfAvailable(); + if (resolver == null) { + throw new IllegalStateException( + "MongoDB typed profiles are configured but no MongoCredentialResolver bean is available"); + } + new MongoClientSettingsFactory(settings, activeProfile, resolver).customize(builder); + } + + @Override + public int getOrder() { + return Ordered.LOWEST_PRECEDENCE; + } + } +} diff --git a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/geo/SpringMongoGeospatialOperations.java b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/geo/SpringMongoGeospatialOperations.java index bc2dbbfa..b863fc82 100644 --- a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/geo/SpringMongoGeospatialOperations.java +++ b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/geo/SpringMongoGeospatialOperations.java @@ -54,7 +54,8 @@ public final class SpringMongoGeospatialOperations implements MongoGeospatialOpe Criteria.where(query.field()) .nearSphere(query.center().toGeoJsonPoint()) .maxDistance(query.maxDistance().toMeters())) - .limit(query.resultLimit()); + .limit(query.resultLimit()) + .maxTimeMsec(access.operationTimeout().toMillis()); return access.rawOperations().find(near, documentType, access.collection()); }) .result() @@ -78,7 +79,8 @@ public final class SpringMongoGeospatialOperations implements MongoGeospatialOpe new Circle(toPoint(query.center()), query.maxDistance().toSpringDistance()); Query within = new Query(Criteria.where(query.field()).withinSphere(circle)) - .limit(query.resultLimit()); + .limit(query.resultLimit()) + .maxTimeMsec(access.operationTimeout().toMillis()); return access.rawOperations().find(within, documentType, access.collection()); }) .result() diff --git a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/DefaultMongoImperativeExecutor.java b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/DefaultMongoImperativeExecutor.java index 9ca5c1f7..c8f6f91f 100644 --- a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/DefaultMongoImperativeExecutor.java +++ b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/DefaultMongoImperativeExecutor.java @@ -4,8 +4,10 @@ import com.mongodb.MongoException; import dev.caskeleton.adapter.outbound.mongo.api.MongoOperationContext; import dev.caskeleton.adapter.outbound.mongo.api.MongoOperationType; import dev.caskeleton.adapter.outbound.mongo.api.error.MongoExecutionOutcome; +import dev.caskeleton.adapter.outbound.mongo.api.error.MongoFailureContext; import dev.caskeleton.adapter.outbound.mongo.api.error.MongoOperationRejectedException; import dev.caskeleton.adapter.outbound.mongo.api.error.MongoPersistenceException; +import dev.caskeleton.adapter.outbound.mongo.api.error.MongoTimeoutException; import dev.caskeleton.adapter.outbound.mongo.api.observation.MongoOperationObservation; import dev.caskeleton.adapter.outbound.mongo.api.observation.MongoOperationObserver; import dev.caskeleton.adapter.outbound.mongo.failure.MongoDriverFailureView; @@ -91,17 +93,13 @@ public final class DefaultMongoImperativeExecutor implements MongoImperativeExec // the metric that answers "are writes being acknowledged" count reads as well. MongoExecutionOutcome outcome = MongoCompletion.successOutcomeFor(operationType); if (elapsed.compareTo(context.timeout()) > 0) { - // The context declares a deadline on every operation and nothing compared anything to it. - // A callback cannot be interrupted mid-driver-call, so this cannot cut the work short — - // but reporting a breach beats reporting success for work that ran past its budget. - observation.success(outcome); - throw MongoOperationRejectedException.of( - context.operationName().value(), - "the operation ran for " - + elapsed.toMillis() - + "ms against a declared timeout of " - + context.timeout().toMillis() - + "ms"); + // The callback has already returned. For a write, the server may therefore have applied + // the mutation even though the caller no longer accepts the elapsed time as success. + // Reporting NOT_SENT here invites a blind replay and can duplicate the write. + throw new MongoTimeoutException( + MongoFailureContext.timedOut( + context.operationName(), operationType, context.timeout()) + .withTraceId(observation.traceId())); } observation.success(outcome); return new MongoOperationResult<>(context, value, outcome, elapsed); @@ -192,5 +190,10 @@ public final class DefaultMongoImperativeExecutor implements MongoImperativeExec public MongoOperations rawOperations() { return operations; } + + @Override + public java.time.Duration operationTimeout() { + return timeout; + } } } diff --git a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/MongoPlatformCollectionAccess.java b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/MongoPlatformCollectionAccess.java index ea227553..be99d0e5 100644 --- a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/MongoPlatformCollectionAccess.java +++ b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/MongoPlatformCollectionAccess.java @@ -1,5 +1,6 @@ package dev.caskeleton.adapter.outbound.mongo.imperative; +import java.time.Duration; import org.springframework.data.mongodb.core.MongoOperations; /** @@ -17,4 +18,7 @@ public interface MongoPlatformCollectionAccess extends MongoCollectionAccess { /** The template bound to the operation's consistency profile, with no collection scoping. */ MongoOperations rawOperations(); + + /** The same finite operation deadline platform executors must attach to raw driver work. */ + Duration operationTimeout(); } diff --git a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/atomic/AtomicUpdateResult.java b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/atomic/AtomicUpdateResult.java index 082693c7..d2a61586 100644 --- a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/atomic/AtomicUpdateResult.java +++ b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/atomic/AtomicUpdateResult.java @@ -19,8 +19,10 @@ public record AtomicUpdateResult( public AtomicUpdateResult { Objects.requireNonNull(outcome, "outcome"); - if (matched < 0 || modified < 0) { - throw new IllegalArgumentException("matched and modified counts must not be negative"); + boolean bothUnavailable = matched == -1 && modified == -1; + if (!bothUnavailable && (matched < 0 || modified < 0)) { + throw new IllegalArgumentException( + "matched and modified counts must both be non-negative or both be -1 when unavailable"); } } @@ -35,6 +37,11 @@ public record AtomicUpdateResult( matched, modified, false, document, MongoExecutionOutcome.WRITE_CONFIRMED); } + /** Counts are unavailable from the driver operation, but the returned document is evidence. */ + public static AtomicUpdateResult countsUnavailable(T document) { + return new AtomicUpdateResult<>(-1, -1, false, document, MongoExecutionOutcome.WRITE_CONFIRMED); + } + /** An upsert created a new document. */ public static AtomicUpdateResult created(T document) { return new AtomicUpdateResult<>(0, 0, true, document, MongoExecutionOutcome.WRITE_CONFIRMED); @@ -45,13 +52,18 @@ public record AtomicUpdateResult( return Optional.ofNullable(document); } - /** True when the filter matched a document. */ + /** Whether matched/modified counts are available for this driver operation. */ + public boolean countsAvailable() { + return matched >= 0; + } + + /** True when the filter matched a document or the operation returned one. */ public boolean matchedAnything() { - return matched > 0 || upserted; + return matched > 0 || upserted || document != null; } /** True when the document already held the target state, so nothing changed. */ public boolean matchedButUnchanged() { - return matched > 0 && modified == 0; + return countsAvailable() && matched > 0 && modified == 0; } } diff --git a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/atomic/MongoAtomicOperationsTemplate.java b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/atomic/MongoAtomicOperationsTemplate.java index 5dade5c4..ac126508 100644 --- a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/atomic/MongoAtomicOperationsTemplate.java +++ b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/atomic/MongoAtomicOperationsTemplate.java @@ -3,6 +3,7 @@ package dev.caskeleton.adapter.outbound.mongo.imperative.atomic; import dev.caskeleton.adapter.outbound.mongo.api.MongoOperationContext; import dev.caskeleton.adapter.outbound.mongo.api.MongoOperationType; import dev.caskeleton.adapter.outbound.mongo.imperative.DefaultMongoImperativeExecutor; +import java.time.Duration; import java.util.Objects; import org.springframework.data.mongodb.core.FindAndModifyOptions; import org.springframework.data.mongodb.core.MongoOperations; @@ -87,14 +88,16 @@ public final class MongoAtomicOperationsTemplate implements MongoAtomicOperation query, updateDefinition, returnMode, - upsert) + upsert, + access.operationTimeout()) : update( access.rawOperations(), access.collection(), documentType, query, updateDefinition, - upsert)) + upsert, + access.operationTimeout())) .result() .orElseGet(AtomicUpdateResult::noMatch); } @@ -106,16 +109,19 @@ public final class MongoAtomicOperationsTemplate implements MongoAtomicOperation Query query, UpdateDefinition update, ReturnDocumentMode returnMode, - boolean upsert) { + boolean upsert, + Duration timeout) { FindAndModifyOptions options = FindAndModifyOptions.options() .returnNew(returnMode == ReturnDocumentMode.AFTER) .upsert(upsert); - T document = operations.findAndModify(query, update, options, documentType, collection); + T document = + operations.findAndModify( + query.maxTimeMsec(timeout.toMillis()), update, options, documentType, collection); if (document == null) { return upsert ? AtomicUpdateResult.created(null) : AtomicUpdateResult.noMatch(); } - return AtomicUpdateResult.applied(1, 1, document); + return AtomicUpdateResult.countsUnavailable(document); } private static AtomicUpdateResult update( @@ -124,11 +130,13 @@ public final class MongoAtomicOperationsTemplate implements MongoAtomicOperation Class documentType, Query query, UpdateDefinition update, - boolean upsert) { + boolean upsert, + Duration timeout) { + Query bounded = query.maxTimeMsec(timeout.toMillis()); var result = upsert - ? operations.upsert(query, update, documentType, collection) - : operations.updateFirst(query, update, documentType, collection); + ? operations.upsert(bounded, update, documentType, collection) + : operations.updateFirst(bounded, update, documentType, collection); if (result.getUpsertedId() != null) { return AtomicUpdateResult.created(null); } diff --git a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/bulk/MongoBulkExecutor.java b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/bulk/MongoBulkExecutor.java index ca2d14c8..f9a7eb1d 100644 --- a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/bulk/MongoBulkExecutor.java +++ b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/imperative/bulk/MongoBulkExecutor.java @@ -2,6 +2,11 @@ package dev.caskeleton.adapter.outbound.mongo.imperative.bulk; import com.mongodb.MongoBulkWriteException; import com.mongodb.bulk.BulkWriteError; +import com.mongodb.client.MongoCollection; +import com.mongodb.client.model.BulkWriteOptions; +import com.mongodb.client.model.UpdateOneModel; +import com.mongodb.client.model.UpdateOptions; +import com.mongodb.client.model.WriteModel; import dev.caskeleton.adapter.outbound.mongo.api.MongoOperationContext; import dev.caskeleton.adapter.outbound.mongo.api.MongoOperationType; import dev.caskeleton.adapter.outbound.mongo.api.error.MongoFailureCategory; @@ -11,8 +16,8 @@ import dev.caskeleton.adapter.outbound.mongo.imperative.atomic.MongoAtomicPolicy import java.util.ArrayList; import java.util.List; import java.util.Objects; -import org.springframework.data.mongodb.core.BulkOperations; -import org.springframework.data.mongodb.core.query.Update; +import java.util.concurrent.TimeUnit; +import org.bson.Document; /** * Executes a bulk plan and preserves what actually happened to each item (design §19.2). @@ -65,30 +70,34 @@ public final class MongoBulkExecutor { context, MongoOperationType.BULK_WRITE, access -> { - BulkOperations bulk = - access.rawOperations().bulkOps(plan.mode().toSpringMode(), access.collection()); + List> writes = new ArrayList<>(plan.items().size()); for (MongoBulkWritePlan.MongoBulkItem item : plan.items()) { - Update update = item.update().toUpdate(); - if (item.upsert()) { - bulk.upsert(item.filter().toQuery(), update); - } else { - bulk.updateOne(item.filter().toQuery(), update); - } + writes.add( + new UpdateOneModel<>( + item.filter().toQuery().getQueryObject(), + item.update().toUpdate().getUpdateObject(), + new UpdateOptions().upsert(item.upsert()))); } + + MongoCollection collection = + access + .rawOperations() + .getCollection(access.collection()) + .withTimeout(access.operationTimeout().toMillis(), TimeUnit.MILLISECONDS); try { - var result = bulk.execute(); + var result = + collection.bulkWrite( + writes, + new BulkWriteOptions().ordered(plan.mode() == MongoBulkMode.ORDERED)); return MongoBulkResult.complete( plan.items().size(), result.getInsertedCount(), result.getModifiedCount(), result.getDeletedCount(), result.getUpserts().size()); + } catch (MongoBulkWriteException failure) { + return toPartialResult(plan, failure); } catch (RuntimeException failure) { - // Catching RuntimeException and then looking for the driver's bulk failure inside - // it: Spring Data wraps bulk errors in its own hierarchy on most paths, and a - // wrapped failure skipped the old `catch (MongoBulkWriteException)` entirely. What - // reached the caller was one generic error without the per-item indexes — the one - // thing this result exists to preserve, lost in the exact case it exists for. return SpringDataBulkFailureExtractor.bulkFailureIn(failure) .map(driverFailure -> toPartialResult(plan, driverFailure)) .orElseThrow(() -> failure); diff --git a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/migration/flamingock/FlamingockLedgerAdapter.java b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/migration/flamingock/FlamingockLedgerAdapter.java index 113c5643..54748e31 100644 --- a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/migration/flamingock/FlamingockLedgerAdapter.java +++ b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/migration/flamingock/FlamingockLedgerAdapter.java @@ -1,34 +1,29 @@ package dev.caskeleton.adapter.outbound.mongo.migration.flamingock; +import dev.caskeleton.adapter.outbound.mongo.api.error.MongoOperationRejectedException; import dev.caskeleton.adapter.outbound.mongo.migration.MongoMigrationCheckpoint; import dev.caskeleton.adapter.outbound.mongo.migration.MongoMigrationChecksum; import dev.caskeleton.adapter.outbound.mongo.migration.MongoMigrationId; import dev.caskeleton.adapter.outbound.mongo.migration.MongoMigrationLedger; import java.time.Instant; -import java.util.LinkedHashMap; -import java.util.Map; import java.util.Objects; import java.util.Optional; import java.util.function.Function; /** - * Presents an engine's audit log as the platform's ledger (design §12.4). + * Read-only bridge from Flamingock's audit log to the platform migration ledger view. * - *

    The engine already records what it applied. Reading its log through this adapter, rather than - * keeping a parallel platform ledger, avoids the failure where the two disagree — which happens the - * first time a migration is applied outside the platform's runner. + *

    Flamingock's lock adapter cannot expose a monotonic acquisition fence. Pretending otherwise + * would let a superseded runner record completion or advance a checkpoint. This adapter therefore + * exposes only facts already durably recorded by the engine and refuses platform-owned writes. * - *

    Checkpoints stay platform-owned, because they describe progress within a change unit - * and no engine models that. + *

    A migration that needs resumable checkpoints or platform-owned completion records must compose + * {@code MongoCollectionMigrationLedger} with a fenced {@code MongoMigrationLock} instead. */ public final class FlamingockLedgerAdapter implements MongoMigrationLedger { private final Function> engineAuditLog; - private final Map checkpoints = new LinkedHashMap<>(); - - private final Map recorded = new LinkedHashMap<>(); - public FlamingockLedgerAdapter( Function> engineAuditLog) { this.engineAuditLog = Objects.requireNonNull(engineAuditLog, "engineAuditLog"); @@ -37,10 +32,6 @@ public final class FlamingockLedgerAdapter implements MongoMigrationLedger { @Override public Optional find(MongoMigrationId migrationId) { Objects.requireNonNull(migrationId, "migrationId"); - AppliedMigration local = recorded.get(migrationId); - if (local != null) { - return Optional.of(local); - } return engineAuditLog .apply(migrationId.value()) .map( @@ -59,19 +50,26 @@ public final class FlamingockLedgerAdapter implements MongoMigrationLedger { String operator, Instant appliedAt, long fence) { - recorded.put( - Objects.requireNonNull(migrationId, "migrationId"), - new AppliedMigration(migrationId, checksum, operator, appliedAt)); + throw unsupportedWrite("record an applied migration"); } @Override public Optional findCheckpoint(MongoMigrationId migrationId) { - return Optional.ofNullable(checkpoints.get(Objects.requireNonNull(migrationId, "migrationId"))); + Objects.requireNonNull(migrationId, "migrationId"); + return Optional.empty(); } @Override public void saveCheckpoint(MongoMigrationCheckpoint checkpoint, long fence) { Objects.requireNonNull(checkpoint, "checkpoint"); - checkpoints.put(checkpoint.migrationId(), checkpoint); + throw unsupportedWrite("save a resumable checkpoint"); + } + + private static MongoOperationRejectedException unsupportedWrite(String operation) { + return MongoOperationRejectedException.of( + "migration.fence", + "Flamingock exposes an unfenced lease, so this adapter cannot " + + operation + + "; use MongoCollectionMigrationLedger with a fenced migration lock"); } } diff --git a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/reactive/cursor/MongoReactiveCursorPublisher.java b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/reactive/cursor/MongoReactiveCursorPublisher.java index 4e976c8b..044d3c12 100644 --- a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/reactive/cursor/MongoReactiveCursorPublisher.java +++ b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/reactive/cursor/MongoReactiveCursorPublisher.java @@ -4,7 +4,9 @@ import dev.caskeleton.adapter.outbound.mongo.api.MongoOperationContext; import dev.caskeleton.adapter.outbound.mongo.query.budget.MongoOperationBudget; import java.util.Objects; import java.util.concurrent.atomic.AtomicBoolean; +import org.bson.Document; import org.springframework.data.mongodb.core.ReactiveMongoOperations; +import org.springframework.data.mongodb.core.convert.MongoConverter; import org.springframework.data.mongodb.core.query.Query; import reactor.core.publisher.Flux; @@ -52,19 +54,31 @@ public final class MongoReactiveCursorPublisher { // so this used to reconfigure the caller's object: a Query held as a field and streamed twice // carried the first call's batch size and deadline into the second, and two concurrent // subscriptions to the same Query overwrote each other's budget. + int probeLimit = + budget.maxResults() == Integer.MAX_VALUE ? Integer.MAX_VALUE : budget.maxResults() + 1; Query bounded = Query.of(query) .cursorBatchSize(batchSize) .maxTimeMsec(budget.maxTimeMillis()) - .limit(budget.maxResults()); - MongoResultBudgetTracker tracker = new MongoResultBudgetTracker(budget, null); + .limit(probeLimit); + MongoConverter converter = operations.getConverter(); + MongoResultBudgetTracker tracker = + new MongoResultBudgetTracker(budget, converter.getCodecRegistry()); return guard.guard( TrackingLease::new, lease -> Flux.from(operations.find(bounded, documentType, collection)) - // Counted client-side as well: a server limit bounds one query, and this bounds the - // stream the caller actually consumes. - .doOnNext(result -> tracker.record(null))); + // Fetch one probe row beyond maxResults so the client-side guard can distinguish + // "exactly at the bound" from "the query had more". The same conversion used by + // Spring + // Data produces a BSON document for the byte budget. + .doOnNext( + result -> { + Document encoded = new Document(); + converter.write(result, encoded); + tracker.record( + encoded.toBsonDocument(Document.class, converter.getCodecRegistry())); + })); } /** diff --git a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/schema/validation/MongoValidatorApplyPolicy.java b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/schema/validation/MongoValidatorApplyPolicy.java index 7da0133d..ba9bd4e9 100644 --- a/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/schema/validation/MongoValidatorApplyPolicy.java +++ b/src/adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/schema/validation/MongoValidatorApplyPolicy.java @@ -29,8 +29,13 @@ public final class MongoValidatorApplyPolicy { * {@code "8.0.4"}, and the previous {@code Set.of("7.0", "8.0").contains(serverVersion)} was * therefore false on every real deployment — the certified lane was a lane nothing was ever in. */ - private static final Set> CERTIFIED_RELEASE_LINES = - Set.of(List.of(7, 0), List.of(8, 0)); + private static final List CERTIFIED_RELEASE_LINES = List.of("7.0", "8.0"); + + private static final Set> CERTIFIED_RELEASE_LINE_PARTS = + CERTIFIED_RELEASE_LINES.stream() + .map(MongoServerVersion::parse) + .map(version -> List.of(version.major(), version.minor())) + .collect(java.util.stream.Collectors.toUnmodifiableSet()); private final String serverVersion; @@ -43,6 +48,11 @@ public final class MongoValidatorApplyPolicy { return new MongoValidatorApplyPolicy(Objects.requireNonNull(serverVersion, "serverVersion")); } + /** The release lines this platform certifies, in stable display order. */ + public static List certifiedReleaseLines() { + return CERTIFIED_RELEASE_LINES; + } + /** The server version this policy was built for. */ public String serverVersion() { return serverVersion; @@ -52,7 +62,7 @@ public final class MongoValidatorApplyPolicy { public boolean certifiedLane() { try { MongoServerVersion parsed = MongoServerVersion.parse(serverVersion); - return CERTIFIED_RELEASE_LINES.contains(List.of(parsed.major(), parsed.minor())); + return CERTIFIED_RELEASE_LINE_PARTS.contains(List.of(parsed.major(), parsed.minor())); } catch (IllegalArgumentException unparseable) { // A version nobody can read is not a certified one. Fail closed: the alternative is treating // an unknown build as one the platform has tested against. diff --git a/src/adapter/outbound/persistence-mongo/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/src/adapter/outbound/persistence-mongo/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports index c015c46f..a0a8deab 100644 --- a/src/adapter/outbound/persistence-mongo/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports +++ b/src/adapter/outbound/persistence-mongo/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports @@ -1 +1,2 @@ dev.caskeleton.adapter.outbound.mongo.MongoRootAutoConfiguration +dev.caskeleton.adapter.outbound.mongo.client.MongoProfileClientSettingsAutoConfiguration diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/compat/MongoVersionCompatibilityLaneTest.java b/src/adapter/outbound/persistence-mongo/src/mongoIntegrationTest/java/dev/caskeleton/adapter/outbound/mongo/compat/MongoVersionCompatibilityLaneTest.java similarity index 100% rename from src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/compat/MongoVersionCompatibilityLaneTest.java rename to src/adapter/outbound/persistence-mongo/src/mongoIntegrationTest/java/dev/caskeleton/adapter/outbound/mongo/compat/MongoVersionCompatibilityLaneTest.java diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/failure/MongoNetworkFaultLaneTest.java b/src/adapter/outbound/persistence-mongo/src/mongoIntegrationTest/java/dev/caskeleton/adapter/outbound/mongo/failure/MongoNetworkFaultLaneTest.java similarity index 100% rename from src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/failure/MongoNetworkFaultLaneTest.java rename to src/adapter/outbound/persistence-mongo/src/mongoIntegrationTest/java/dev/caskeleton/adapter/outbound/mongo/failure/MongoNetworkFaultLaneTest.java diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/migration/MongoMigrationLaneTest.java b/src/adapter/outbound/persistence-mongo/src/mongoIntegrationTest/java/dev/caskeleton/adapter/outbound/mongo/migration/MongoMigrationLaneTest.java similarity index 100% rename from src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/migration/MongoMigrationLaneTest.java rename to src/adapter/outbound/persistence-mongo/src/mongoIntegrationTest/java/dev/caskeleton/adapter/outbound/mongo/migration/MongoMigrationLaneTest.java diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/rs/MongoSingleReplicaSetContainerTest.java b/src/adapter/outbound/persistence-mongo/src/mongoIntegrationTest/java/dev/caskeleton/adapter/outbound/mongo/rs/MongoSingleReplicaSetContainerTest.java similarity index 100% rename from src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/rs/MongoSingleReplicaSetContainerTest.java rename to src/adapter/outbound/persistence-mongo/src/mongoIntegrationTest/java/dev/caskeleton/adapter/outbound/mongo/rs/MongoSingleReplicaSetContainerTest.java diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/rs/MongoThreeNodeReplicaSetTest.java b/src/adapter/outbound/persistence-mongo/src/mongoIntegrationTest/java/dev/caskeleton/adapter/outbound/mongo/rs/MongoThreeNodeReplicaSetTest.java similarity index 100% rename from src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/rs/MongoThreeNodeReplicaSetTest.java rename to src/adapter/outbound/persistence-mongo/src/mongoIntegrationTest/java/dev/caskeleton/adapter/outbound/mongo/rs/MongoThreeNodeReplicaSetTest.java diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/security/MongoSecurityIntegrationLaneTest.java b/src/adapter/outbound/persistence-mongo/src/mongoIntegrationTest/java/dev/caskeleton/adapter/outbound/mongo/security/MongoSecurityIntegrationLaneTest.java similarity index 100% rename from src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/security/MongoSecurityIntegrationLaneTest.java rename to src/adapter/outbound/persistence-mongo/src/mongoIntegrationTest/java/dev/caskeleton/adapter/outbound/mongo/security/MongoSecurityIntegrationLaneTest.java diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/security/MongoTlsLaneTest.java b/src/adapter/outbound/persistence-mongo/src/mongoIntegrationTest/java/dev/caskeleton/adapter/outbound/mongo/security/MongoTlsLaneTest.java similarity index 94% rename from src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/security/MongoTlsLaneTest.java rename to src/adapter/outbound/persistence-mongo/src/mongoIntegrationTest/java/dev/caskeleton/adapter/outbound/mongo/security/MongoTlsLaneTest.java index 3ca3a9db..90fce06a 100644 --- a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/security/MongoTlsLaneTest.java +++ b/src/adapter/outbound/persistence-mongo/src/mongoIntegrationTest/java/dev/caskeleton/adapter/outbound/mongo/security/MongoTlsLaneTest.java @@ -43,7 +43,7 @@ class MongoTlsLaneTest { server.start(); try (MongoClient client = - clientFor(server.connectionString("localhost"), server.certificateAuthorityPem())) { + clientFor(server.connectionString(server.host()), server.certificateAuthorityPem())) { assertThatCode(() -> client.getDatabase("tlslane").runCommand(new Document("ping", 1))) .doesNotThrowAnyException(); } @@ -61,7 +61,7 @@ class MongoTlsLaneTest { // A real authority, generated by the same script, that simply did not sign this server's // certificate — which is what a rotated or swapped CA looks like from the client side. try (MongoClient client = - clientFor(server.connectionString("localhost"), other.certificateAuthorityPem())) { + clientFor(server.connectionString(server.host()), other.certificateAuthorityPem())) { assertThatThrownBy(() -> client.getDatabase("tlslane").runCommand(new Document("ping", 1))) .isInstanceOf(RuntimeException.class); } @@ -76,7 +76,7 @@ class MongoTlsLaneTest { server.start(); try (MongoClient client = - clientFor(server.connectionString("localhost"), server.certificateAuthorityPem())) { + clientFor(server.connectionString(server.host()), server.certificateAuthorityPem())) { assertThatThrownBy(() -> client.getDatabase("tlslane").runCommand(new Document("ping", 1))) .as("a trusted authority is not the same question as the right server") .isInstanceOf(RuntimeException.class); @@ -97,7 +97,8 @@ class MongoTlsLaneTest { server.start(); String authority = server.certificateAuthorityPem(); - try (MongoClient beforeExpiry = clientFor(server.connectionString("localhost"), authority)) { + try (MongoClient beforeExpiry = + clientFor(server.connectionString(server.host()), authority)) { assertThatCode( () -> beforeExpiry.getDatabase("tlslane").runCommand(new Document("ping", 1))) .as("the window is open, so the same certificate must be accepted here") @@ -121,7 +122,7 @@ class MongoTlsLaneTest { throws InterruptedException { long deadline = System.nanoTime() + java.time.Duration.ofMinutes(2).toNanos(); while (System.nanoTime() < deadline) { - try (MongoClient client = clientFor(server.connectionString("localhost"), authority)) { + try (MongoClient client = clientFor(server.connectionString(server.host()), authority)) { client.getDatabase("tlslane").runCommand(new Document("ping", 1)); } Thread.sleep(java.time.Duration.ofSeconds(5)); diff --git a/src/adapter/outbound/persistence-mongo/src/testFixtures/java/dev/caskeleton/adapter/outbound/mongo/testkit/atlas/MongoAtlasLocalContainer.java b/src/adapter/outbound/persistence-mongo/src/mongoProviderTestkit/java/dev/caskeleton/adapter/outbound/mongo/testkit/atlas/MongoAtlasLocalContainer.java similarity index 100% rename from src/adapter/outbound/persistence-mongo/src/testFixtures/java/dev/caskeleton/adapter/outbound/mongo/testkit/atlas/MongoAtlasLocalContainer.java rename to src/adapter/outbound/persistence-mongo/src/mongoProviderTestkit/java/dev/caskeleton/adapter/outbound/mongo/testkit/atlas/MongoAtlasLocalContainer.java diff --git a/src/adapter/outbound/persistence-mongo/src/testFixtures/java/dev/caskeleton/adapter/outbound/mongo/testkit/failover/MongoProxiedReplicaSetNode.java b/src/adapter/outbound/persistence-mongo/src/mongoProviderTestkit/java/dev/caskeleton/adapter/outbound/mongo/testkit/failover/MongoProxiedReplicaSetNode.java similarity index 100% rename from src/adapter/outbound/persistence-mongo/src/testFixtures/java/dev/caskeleton/adapter/outbound/mongo/testkit/failover/MongoProxiedReplicaSetNode.java rename to src/adapter/outbound/persistence-mongo/src/mongoProviderTestkit/java/dev/caskeleton/adapter/outbound/mongo/testkit/failover/MongoProxiedReplicaSetNode.java diff --git a/src/adapter/outbound/persistence-mongo/src/testFixtures/java/dev/caskeleton/adapter/outbound/mongo/testkit/failover/MongoThreeNodeReplicaSet.java b/src/adapter/outbound/persistence-mongo/src/mongoProviderTestkit/java/dev/caskeleton/adapter/outbound/mongo/testkit/failover/MongoThreeNodeReplicaSet.java similarity index 100% rename from src/adapter/outbound/persistence-mongo/src/testFixtures/java/dev/caskeleton/adapter/outbound/mongo/testkit/failover/MongoThreeNodeReplicaSet.java rename to src/adapter/outbound/persistence-mongo/src/mongoProviderTestkit/java/dev/caskeleton/adapter/outbound/mongo/testkit/failover/MongoThreeNodeReplicaSet.java diff --git a/src/adapter/outbound/persistence-mongo/src/testFixtures/java/dev/caskeleton/adapter/outbound/mongo/testkit/failover/ToxiproxyMongoNetworkFaultController.java b/src/adapter/outbound/persistence-mongo/src/mongoProviderTestkit/java/dev/caskeleton/adapter/outbound/mongo/testkit/failover/ToxiproxyMongoNetworkFaultController.java similarity index 100% rename from src/adapter/outbound/persistence-mongo/src/testFixtures/java/dev/caskeleton/adapter/outbound/mongo/testkit/failover/ToxiproxyMongoNetworkFaultController.java rename to src/adapter/outbound/persistence-mongo/src/mongoProviderTestkit/java/dev/caskeleton/adapter/outbound/mongo/testkit/failover/ToxiproxyMongoNetworkFaultController.java diff --git a/src/adapter/outbound/persistence-mongo/src/testFixtures/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoAuthenticatedReplicaSetContainer.java b/src/adapter/outbound/persistence-mongo/src/mongoProviderTestkit/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoAuthenticatedReplicaSetContainer.java similarity index 100% rename from src/adapter/outbound/persistence-mongo/src/testFixtures/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoAuthenticatedReplicaSetContainer.java rename to src/adapter/outbound/persistence-mongo/src/mongoProviderTestkit/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoAuthenticatedReplicaSetContainer.java diff --git a/src/adapter/outbound/persistence-mongo/src/testFixtures/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoReplicaSetFixture.java b/src/adapter/outbound/persistence-mongo/src/mongoProviderTestkit/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoReplicaSetFixture.java similarity index 100% rename from src/adapter/outbound/persistence-mongo/src/testFixtures/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoReplicaSetFixture.java rename to src/adapter/outbound/persistence-mongo/src/mongoProviderTestkit/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoReplicaSetFixture.java diff --git a/src/adapter/outbound/persistence-mongo/src/testFixtures/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoSingleReplicaSetContainer.java b/src/adapter/outbound/persistence-mongo/src/mongoProviderTestkit/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoSingleReplicaSetContainer.java similarity index 100% rename from src/adapter/outbound/persistence-mongo/src/testFixtures/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoSingleReplicaSetContainer.java rename to src/adapter/outbound/persistence-mongo/src/mongoProviderTestkit/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoSingleReplicaSetContainer.java diff --git a/src/adapter/outbound/persistence-mongo/src/testFixtures/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoTlsReplicaSetContainer.java b/src/adapter/outbound/persistence-mongo/src/mongoProviderTestkit/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoTlsReplicaSetContainer.java similarity index 88% rename from src/adapter/outbound/persistence-mongo/src/testFixtures/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoTlsReplicaSetContainer.java rename to src/adapter/outbound/persistence-mongo/src/mongoProviderTestkit/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoTlsReplicaSetContainer.java index 3402a220..ccbbee2f 100644 --- a/src/adapter/outbound/persistence-mongo/src/testFixtures/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoTlsReplicaSetContainer.java +++ b/src/adapter/outbound/persistence-mongo/src/mongoProviderTestkit/java/dev/caskeleton/adapter/outbound/mongo/testkit/rs/MongoTlsReplicaSetContainer.java @@ -3,6 +3,7 @@ package dev.caskeleton.adapter.outbound.mongo.testkit.rs; import java.io.IOException; import java.time.Duration; import java.util.Objects; +import org.testcontainers.DockerClientFactory; import org.testcontainers.containers.Container; import org.testcontainers.containers.GenericContainer; import org.testcontainers.containers.wait.strategy.Wait; @@ -34,22 +35,24 @@ public final class MongoTlsReplicaSetContainer implements AutoCloseable { // wrapper closes it. @SuppressWarnings("resource") private MongoTlsReplicaSetContainer( - String image, String subjectAlternativeName, int validForSeconds) { + String image, String subjectAlternativeNames, int validForSeconds) { this.container = new GenericContainer<>(DockerImageName.parse(image)) .withExposedPorts(MONGO_PORT) - .withCommand("bash", "-c", startupScript(subjectAlternativeName, validForSeconds)) + .withCommand("bash", "-c", startupScript(subjectAlternativeNames, validForSeconds)) .waitingFor(Wait.forListeningPort().withStartupTimeout(Duration.ofMinutes(3))); } /** A server whose certificate names {@code localhost} and is valid for a decade. */ public static MongoTlsReplicaSetContainer trusted() { - return new MongoTlsReplicaSetContainer(image(), "localhost", TEN_YEARS_IN_SECONDS); + return new MongoTlsReplicaSetContainer( + image(), reachableSubjectAlternativeNames(), TEN_YEARS_IN_SECONDS); } /** A server whose certificate names a host nobody will connect to. */ public static MongoTlsReplicaSetContainer withMismatchedHostname() { - return new MongoTlsReplicaSetContainer(image(), "not-the-host.invalid", TEN_YEARS_IN_SECONDS); + return new MongoTlsReplicaSetContainer( + image(), "DNS:not-the-host.invalid", TEN_YEARS_IN_SECONDS); } /** @@ -67,7 +70,19 @@ public final class MongoTlsReplicaSetContainer implements AutoCloseable { if (seconds <= 0) { throw new IllegalArgumentException("the certificate must be valid long enough to connect"); } - return new MongoTlsReplicaSetContainer(image(), "localhost", seconds); + return new MongoTlsReplicaSetContainer(image(), reachableSubjectAlternativeNames(), seconds); + } + + private static String reachableSubjectAlternativeNames() { + String dockerHost = DockerClientFactory.instance().dockerHostIpAddress(); + if (dockerHost == null || dockerHost.isBlank() || "localhost".equalsIgnoreCase(dockerHost)) { + return "DNS:localhost,IP:127.0.0.1"; + } + String hostEntry = + dockerHost.matches("[0-9.]+") || dockerHost.contains(":") + ? "IP:" + dockerHost + : "DNS:" + dockerHost; + return "DNS:localhost,IP:127.0.0.1," + hostEntry; } private static final int TEN_YEARS_IN_SECONDS = 10 * 365 * 24 * 60 * 60; @@ -84,7 +99,7 @@ public final class MongoTlsReplicaSetContainer implements AutoCloseable { * connection when the handshake fails turns every certificate failure below into a passing test * over an unencrypted socket. */ - private static String startupScript(String subjectAlternativeName, int validForSeconds) { + private static String startupScript(String subjectAlternativeNames, int validForSeconds) { // Signed through `openssl ca` rather than `openssl x509 -req` because only the former takes an // explicit validity window on the OpenSSL this image ships; `-days` cannot express a window // measured in seconds, and a window measured in seconds is what the expiry case needs. @@ -95,9 +110,7 @@ public final class MongoTlsReplicaSetContainer implements AutoCloseable { + " && openssl req -x509 -newkey rsa:2048 -nodes -keyout ca.key -out ca.crt -days 3650" + " -subj '/CN=fixture-ca'" + " && openssl req -newkey rsa:2048 -nodes -keyout server.key -out server.csr" - + " -subj '/CN=" - + subjectAlternativeName - + "'" + + " -subj '/CN=localhost'" + " && printf '%s\\n'" + " '[ca]' 'default_ca=fixture'" + " '[fixture]' 'dir=/tls' 'database=/tls/index.txt' 'serial=/tls/serial'" @@ -107,8 +120,8 @@ public final class MongoTlsReplicaSetContainer implements AutoCloseable { + " 'stateOrProvinceName=optional' 'localityName=optional' 'organizationName=optional'" + " 'organizationalUnitName=optional'" + " '[ext]' 'basicConstraints=CA:FALSE'" - + " 'subjectAltName=DNS:" - + subjectAlternativeName + + " 'subjectAltName=" + + subjectAlternativeNames + "' > ca.cnf" + " && openssl ca -batch -notext -config ca.cnf -extensions ext -in server.csr" + " -out server.crt" diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/MongoNamespaceContractTest.java b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/MongoNamespaceContractTest.java index 4d0c4aa5..621b0e2e 100644 --- a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/MongoNamespaceContractTest.java +++ b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/MongoNamespaceContractTest.java @@ -51,6 +51,27 @@ class MongoNamespaceContractTest { .isEmpty(); } + @Test + @DisplayName("operator-facing Mongo documentation names only the Boot 4 canonical namespace") + void operatorDocumentationDoesNotRecommendTheDeprecatedNamespace() { + Path module = repositoryRoot().resolve("src/adapter/outbound/persistence-mongo"); + List documents = List.of(module.resolve("README.md"), module.resolve("CLAUDE.md")); + + assertThat(documents) + .allSatisfy(path -> assertThat(Files.isRegularFile(path)).as(path.toString()).isTrue()); + + List offenders = + documents.stream() + .filter(path -> read(path).contains(RETIRED_NAMESPACE)) + .map(path -> path.getFileName().toString()) + .sorted() + .toList(); + + assertThat(offenders) + .as("operator docs must direct deployments to spring.mongodb.* on Spring Boot 4") + .isEmpty(); + } + @Test @DisplayName("no shipped resource binds the deprecated namespace") void noShippedResourceBindsTheDeprecatedNamespace() { diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/MongoPlatformHealthContributorTest.java b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/MongoPlatformHealthContributorTest.java new file mode 100644 index 00000000..52060252 --- /dev/null +++ b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/MongoPlatformHealthContributorTest.java @@ -0,0 +1,64 @@ +package dev.caskeleton.adapter.outbound.mongo; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.adapter.outbound.mongo.api.profile.MongoTopology; +import dev.caskeleton.adapter.outbound.mongo.autoconfigure.MongoPlatformHealthIndicator; +import dev.caskeleton.adapter.outbound.mongo.autoconfigure.MongoPlatformSettings; +import dev.caskeleton.adapter.outbound.mongo.autoconfigure.MongoTopologyProbe; +import org.junit.jupiter.api.Test; +import org.springframework.boot.health.contributor.HealthIndicator; +import org.springframework.boot.test.context.runner.ApplicationContextRunner; + +class MongoPlatformHealthContributorTest { + + @Test + void contributorImplementsTheActuatorHealthSpi() { + assertThat(HealthIndicator.class).isAssignableFrom(MongoPlatformHealthContributor.class); + } + + @Test + void configurationPublishesTheExistingBeanNameAndBacksOffForAnOverride() { + MongoPlatformHealthIndicator platform = + new MongoPlatformHealthIndicator( + new MongoTopologyProbe(MongoTopology.REPLICA_SET, "8.0.0", 2), + MongoPlatformSettings.empty()); + + new ApplicationContextRunner() + .withUserConfiguration(MongoPlatformHealthConfiguration.class) + .withBean(MongoPlatformHealthIndicator.class, () -> platform) + .run( + context -> { + assertThat(context).hasBean("mongoPlatformHealthContributor"); + assertThat(context.getBean("mongoPlatformHealthContributor")) + .isInstanceOf(HealthIndicator.class); + }); + + HealthIndicator override = + () -> org.springframework.boot.health.contributor.Health.up().build(); + new ApplicationContextRunner() + .withUserConfiguration(MongoPlatformHealthConfiguration.class) + .withBean(MongoPlatformHealthIndicator.class, () -> platform) + .withBean("mongoPlatformHealthContributor", HealthIndicator.class, () -> override) + .run( + context -> + assertThat(context.getBean("mongoPlatformHealthContributor")).isSameAs(override)); + } + + @Test + void contributorPreservesThePlatformHealthDetails() { + MongoPlatformHealthIndicator platform = + new MongoPlatformHealthIndicator( + new MongoTopologyProbe(MongoTopology.REPLICA_SET, "8.0.0", 1), + MongoPlatformSettings.empty()); + + var health = new MongoPlatformHealthContributor(platform).health(); + + assertThat(health.getStatus().getCode()).isEqualTo("UP"); + assertThat(health.getDetails()) + .containsEntry("serverVersion", "8.0.0") + .containsEntry("availableSecondaries", 1) + .containsEntry("requiredSecondaries", 2) + .containsEntry("degradedSecondaryAvailability", true); + } +} diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/architecture/MongoModuleBoundaryTest.java b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/architecture/MongoModuleBoundaryTest.java index ac4b7e73..a69aa4f3 100644 --- a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/architecture/MongoModuleBoundaryTest.java +++ b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/architecture/MongoModuleBoundaryTest.java @@ -327,12 +327,15 @@ class MongoModuleBoundaryTest { assertThat(cycles).isEmpty(); } - private static boolean reaches(String from, String target, java.util.Set visited) { + private static boolean reaches(String from, String target, java.util.Set path) { + if (!path.add(from)) { + return false; + } for (String next : ALLOWED_EDGES.getOrDefault(from, java.util.Set.of())) { if (next.equals(target)) { return true; } - if (visited.add(next) && reaches(next, target, visited)) { + if (reaches(next, target, new java.util.TreeSet<>(path))) { return true; } } diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoPlatformHealthMeasuresTheClusterTest.java b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoPlatformHealthMeasuresTheClusterTest.java index 96e52e49..f49a2dd5 100644 --- a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoPlatformHealthMeasuresTheClusterTest.java +++ b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoPlatformHealthMeasuresTheClusterTest.java @@ -38,6 +38,22 @@ class MongoPlatformHealthMeasuresTheClusterTest { .isFalse(); } + @Test + @DisplayName("health reads the latest probe snapshot rather than the startup value") + void healthReadsTheLatestProbeSnapshot() { + MongoTopologyProbe probe = new MongoTopologyProbe(MongoTopology.REPLICA_SET, "8.0", 2); + MongoPlatformHealthIndicator health = + new MongoPlatformAutoConfiguration().mongoPlatformHealthIndicator(probe, settings(2)); + + assertThat(health.details()).containsEntry("availableSecondaries", 2); + assertThat(health.degradedSecondaryAvailability()).isFalse(); + + probe.observe(MongoTopology.REPLICA_SET, "8.0", 0); + + assertThat(health.details()).containsEntry("availableSecondaries", 0); + assertThat(health.degradedSecondaryAvailability()).isTrue(); + } + @Test @DisplayName("the requirement is what the deployment declared, not a constant") void theRequirementIsWhatTheDeploymentDeclared() { diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoReactiveWiringTest.java b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoReactiveWiringTest.java index fc910aa0..0875a756 100644 --- a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoReactiveWiringTest.java +++ b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoReactiveWiringTest.java @@ -55,7 +55,7 @@ class MongoReactiveWiringTest { private static ReactiveMongoTemplate template() { return new ReactiveMongoTemplate( new org.springframework.data.mongodb.core.SimpleReactiveMongoDatabaseFactory( - com.mongodb.reactivestreams.client.MongoClients.create("mongodb://localhost:27017"), + mock(com.mongodb.reactivestreams.client.MongoClient.class), "wiring-test")); } @@ -64,9 +64,9 @@ class MongoReactiveWiringTest { void aReactiveTemplateAssemblesTheReactivePath() { runner // A real template over a real factory, not a mock. The binder derives one template per - // consistency profile by constructing `new ReactiveMongoTemplate(factory, converter)`, so a - // mock fails on a null factory and the test would be about Mockito rather than about the - // wiring. Nothing connects: the driver is lazy and no operation runs here. + // consistency profile by constructing `new ReactiveMongoTemplate(factory, converter)`. + // Only the driver client is mocked so the hermetic wiring test creates no cluster-monitor + // threads. .withBean(ReactiveMongoTemplate.class, MongoReactiveWiringTest::template) .run( context -> diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoStartupValidationTest.java b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoStartupValidationTest.java index 8f27a8ca..fc7fe824 100644 --- a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoStartupValidationTest.java +++ b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/MongoStartupValidationTest.java @@ -1,6 +1,7 @@ package dev.caskeleton.adapter.outbound.mongo.autoconfigure; import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; import java.lang.reflect.Method; import java.util.Arrays; @@ -62,22 +63,18 @@ class MongoStartupValidationTest { .isFalse(); assertThat(MongoPlatformSettings.empty().changeStreams()) .as( - "experimental: zero beans and zero threads. A server that supports change streams is not " - + "a platform that ships them.") + "experimental: zero beans and zero threads. A server that supports change streams is" + + " not a platform that ships them.") .isFalse(); } @Test @DisplayName("change streams cannot be switched on by configuration") void changeStreamsCannotBeSwitchedOn() { - MongoPlatformSettings asked = new MongoPlatformSettings(java.util.Map.of(), true, true, null); - - assertThat(asked.transactions()).as("transactions are a real switch").isTrue(); - assertThat(asked.changeStreams()) - .as( - "change streams are not; accepting the flag and ignoring it would leave an operator " - + "believing it took effect, so the record refuses to carry a true it cannot honour") - .isFalse(); + assertThatThrownBy(() -> new MongoPlatformSettings(java.util.Map.of(), true, true, null)) + .isInstanceOf( + dev.caskeleton.adapter.outbound.mongo.api.error.MongoOperationRejectedException.class) + .hasMessageContaining("change streams"); } private static java.util.Optional beanMethod(String name) { diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/ReactiveWiringCarriesTheContextTest.java b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/ReactiveWiringCarriesTheContextTest.java index 9ceb5219..831bf5f7 100644 --- a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/ReactiveWiringCarriesTheContextTest.java +++ b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/autoconfigure/ReactiveWiringCarriesTheContextTest.java @@ -55,8 +55,7 @@ class ReactiveWiringCarriesTheContextTest { () -> new ReactiveMongoTemplate( new org.springframework.data.mongodb.core.SimpleReactiveMongoDatabaseFactory( - com.mongodb.reactivestreams.client.MongoClients.create( - "mongodb://localhost:27017"), + mock(com.mongodb.reactivestreams.client.MongoClient.class), "wiring-context-test"))) .run( context -> { diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/client/MongoClientSettingsFactoryTest.java b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/client/MongoClientSettingsFactoryTest.java index c669128d..4194ff39 100644 --- a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/client/MongoClientSettingsFactoryTest.java +++ b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/client/MongoClientSettingsFactoryTest.java @@ -47,6 +47,9 @@ class MongoClientSettingsFactoryTest { .isEqualTo(profile.socketReadTimeout().toMillis()); assertThat(settings.getClusterSettings().getServerSelectionTimeout(TimeUnit.MILLISECONDS)) .isEqualTo(profile.serverSelectionTimeout().toMillis()); + assertThat(settings.getTimeout(TimeUnit.MILLISECONDS)) + .as("overall operation timeout, not the driver's implicit default") + .isEqualTo(profile.operationTimeout().toMillis()); assertThat(settings.getConnectionPoolSettings().getMinSize()).isEqualTo(profile.poolMinSize()); assertThat(settings.getConnectionPoolSettings().getMaxSize()).isEqualTo(profile.poolMaxSize()); assertThat(settings.getConnectionPoolSettings().getMaxWaitTime(TimeUnit.MILLISECONDS)) @@ -81,6 +84,30 @@ class MongoClientSettingsFactoryTest { .isEqualTo(org.bson.UuidRepresentation.STANDARD); } + @Test + @DisplayName("the same typed profile can customize the builder Spring Boot actually uses") + void typedProfileCustomizesAnExistingDriverBuilder() { + MongoProfileProperties profile = profile(); + MongoClientSettings.Builder builder = MongoClientSettings.builder(); + + new MongoClientSettingsFactory( + settingsWith(profile), ACTIVE, resolver(new java.util.ArrayList<>())) + .customize(builder); + + MongoClientSettings settings = builder.build(); + assertThat(settings.getSocketSettings().getConnectTimeout(TimeUnit.MILLISECONDS)) + .isEqualTo(profile.connectTimeout().toMillis()); + assertThat(settings.getSocketSettings().getReadTimeout(TimeUnit.MILLISECONDS)) + .isEqualTo(profile.socketReadTimeout().toMillis()); + assertThat(settings.getClusterSettings().getServerSelectionTimeout(TimeUnit.MILLISECONDS)) + .isEqualTo(profile.serverSelectionTimeout().toMillis()); + assertThat(settings.getConnectionPoolSettings().getMinSize()).isEqualTo(profile.poolMinSize()); + assertThat(settings.getConnectionPoolSettings().getMaxSize()).isEqualTo(profile.poolMaxSize()); + assertThat(settings.getSslSettings().isEnabled()).isTrue(); + assertThat(settings.getServerApi()).isNotNull(); + assertThat(settings.getServerApi().getStrict()).contains(true); + } + @Test @DisplayName("only the active profile's secret is resolved") void onlyTheActiveProfilesSecretIsResolved() { diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/client/MongoProfileClientSettingsAutoConfigurationTest.java b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/client/MongoProfileClientSettingsAutoConfigurationTest.java new file mode 100644 index 00000000..3c9efd37 --- /dev/null +++ b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/client/MongoProfileClientSettingsAutoConfigurationTest.java @@ -0,0 +1,165 @@ +package dev.caskeleton.adapter.outbound.mongo.client; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +import com.mongodb.MongoClientSettings; +import dev.caskeleton.adapter.outbound.mongo.api.profile.MongoTopology; +import dev.caskeleton.adapter.outbound.mongo.autoconfigure.MongoPlatformSettings; +import dev.caskeleton.adapter.outbound.mongo.autoconfigure.MongoProfileProperties; +import dev.caskeleton.adapter.outbound.mongo.autoconfigure.MongoTopologyProbe; +import dev.caskeleton.adapter.outbound.mongo.security.MongoCredentialReference; +import dev.caskeleton.adapter.outbound.mongo.security.MongoCredentialResolver; +import java.util.Map; +import java.util.concurrent.TimeUnit; +import java.util.function.Function; +import org.junit.jupiter.api.Test; +import org.springframework.boot.mongodb.autoconfigure.MongoClientSettingsBuilderCustomizer; +import org.springframework.boot.test.context.runner.ApplicationContextRunner; + +class MongoProfileClientSettingsAutoConfigurationTest { + + private static final String ACTIVE = "primary"; + private static final String URI = "mongodb://mongo:27017/app?replicaSet=rs0"; + + @Test + void typedProfileCustomizerReachesTheBootDriverBuilder() { + MongoProfileProperties profile = MongoProfileProperties.production("secret://mongodb/primary"); + + new ApplicationContextRunner() + .withUserConfiguration(MongoProfileClientSettingsAutoConfiguration.class) + .withBean( + MongoPlatformSettings.class, + () -> new MongoPlatformSettings(Map.of(ACTIVE, profile), false, false, null)) + .withBean(MongoCredentialResolver.class, () -> resolver(URI)) + .withPropertyValues( + "ca-skeleton.persistence-mongo.enabled=true", + "ca-skeleton.persistence-mongo.active-profile=" + ACTIVE) + .run( + context -> { + assertThat(context).hasSingleBean(MongoClientSettingsBuilderCustomizer.class); + MongoClientSettings.Builder builder = MongoClientSettings.builder(); + + context.getBean(MongoClientSettingsBuilderCustomizer.class).customize(builder); + + MongoClientSettings settings = builder.build(); + assertThat(settings.getSocketSettings().getConnectTimeout(TimeUnit.MILLISECONDS)) + .isEqualTo(profile.connectTimeout().toMillis()); + assertThat( + settings + .getClusterSettings() + .getServerSelectionTimeout(TimeUnit.MILLISECONDS)) + .isEqualTo(profile.serverSelectionTimeout().toMillis()); + assertThat(settings.getConnectionPoolSettings().getMaxSize()) + .isEqualTo(profile.poolMaxSize()); + assertThat(settings.getSslSettings().isEnabled()).isTrue(); + assertThat(settings.getServerApi()).isNotNull(); + assertThat(settings.getServerApi().getStrict()).contains(true); + }); + } + + @Test + void unknownActiveProfileFailsClosedInsteadOfSelectingNothing() { + MongoProfileProperties profile = MongoProfileProperties.production("secret://mongodb/primary"); + + new ApplicationContextRunner() + .withUserConfiguration(MongoProfileClientSettingsAutoConfiguration.class) + .withBean( + MongoPlatformSettings.class, + () -> new MongoPlatformSettings(Map.of(ACTIVE, profile), false, false, null)) + .withBean(MongoCredentialResolver.class, () -> resolver(URI)) + .withPropertyValues( + "ca-skeleton.persistence-mongo.enabled=true", + "ca-skeleton.persistence-mongo.active-profile=primry") + .run( + context -> + assertThatThrownBy( + () -> + context + .getBean(MongoClientSettingsBuilderCustomizer.class) + .customize(MongoClientSettings.builder())) + .hasMessageContaining("primry") + .hasMessageContaining("not configured")); + } + + @Test + void topologyRefreshCustomizerFeedsDriverClusterChangesIntoTheHealthProbe() { + MongoTopologyProbe probe = new MongoTopologyProbe(MongoTopology.REPLICA_SET, "8.0", 2); + + new ApplicationContextRunner() + .withUserConfiguration(MongoProfileClientSettingsAutoConfiguration.class) + .withBean(MongoPlatformSettings.class, MongoPlatformSettings::empty) + .withBean(MongoTopologyProbe.class, () -> probe) + .withPropertyValues("ca-skeleton.persistence-mongo.enabled=true") + .run( + context -> { + MongoClientSettingsBuilderCustomizer customizer = + context.getBean( + "mongoTopologyRefreshCustomizer", MongoClientSettingsBuilderCustomizer.class); + MongoClientSettings.Builder builder = MongoClientSettings.builder(); + customizer.customize(builder); + + com.mongodb.event.ClusterListener listener = + builder.build().getClusterSettings().getClusterListeners().getFirst(); + com.mongodb.connection.ClusterDescription description = + new com.mongodb.connection.ClusterDescription( + com.mongodb.connection.ClusterConnectionMode.MULTIPLE, + com.mongodb.connection.ClusterType.REPLICA_SET, + java.util.List.of()); + listener.clusterDescriptionChanged( + new com.mongodb.event.ClusterDescriptionChangedEvent( + new com.mongodb.connection.ClusterId(), description, description)); + + assertThat(probe.observedTopology()).isEqualTo(MongoTopology.REPLICA_SET); + assertThat(probe.availableSecondaries()).isZero(); + }); + } + + @Test + void standardUriPathDoesNotRequireACredentialResolverWhenNoTypedProfilesExist() { + new ApplicationContextRunner() + .withUserConfiguration(MongoProfileClientSettingsAutoConfiguration.class) + .withBean(MongoPlatformSettings.class, MongoPlatformSettings::empty) + .withPropertyValues( + "ca-skeleton.persistence-mongo.enabled=true", + "ca-skeleton.persistence-mongo.active-profile=standard-uri") + .run( + context -> { + MongoClientSettings.Builder builder = MongoClientSettings.builder(); + context.getBean(MongoClientSettingsBuilderCustomizer.class).customize(builder); + assertThat(builder.build().getServerApi()).isNull(); + }); + } + + @Test + void typedProfilesFailClosedWhenNoCredentialResolverIsInstalled() { + MongoProfileProperties profile = MongoProfileProperties.production("secret://mongodb/primary"); + + new ApplicationContextRunner() + .withUserConfiguration(MongoProfileClientSettingsAutoConfiguration.class) + .withBean( + MongoPlatformSettings.class, + () -> new MongoPlatformSettings(Map.of(ACTIVE, profile), false, false, null)) + .withPropertyValues( + "ca-skeleton.persistence-mongo.enabled=true", + "ca-skeleton.persistence-mongo.active-profile=" + ACTIVE) + .run( + context -> + assertThatThrownBy( + () -> + context + .getBean(MongoClientSettingsBuilderCustomizer.class) + .customize(MongoClientSettings.builder())) + .hasMessageContaining("MongoCredentialResolver")); + } + + private static MongoCredentialResolver resolver(String uri) { + return new MongoCredentialResolver() { + @Override + public T withConnectionString( + MongoCredentialReference reference, Function use) { + return use.apply(uri); + } + }; + } +} diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/imperative/DefaultMongoImperativeExecutorDeadlineTest.java b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/imperative/DefaultMongoImperativeExecutorDeadlineTest.java new file mode 100644 index 00000000..ba7814a0 --- /dev/null +++ b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/imperative/DefaultMongoImperativeExecutorDeadlineTest.java @@ -0,0 +1,86 @@ +package dev.caskeleton.adapter.outbound.mongo.imperative; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.catchThrowable; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +import dev.caskeleton.adapter.outbound.mongo.api.MongoOperationContext; +import dev.caskeleton.adapter.outbound.mongo.api.MongoOperationType; +import dev.caskeleton.adapter.outbound.mongo.api.consistency.MongoConsistencyProfile; +import dev.caskeleton.adapter.outbound.mongo.api.error.MongoExecutionOutcome; +import dev.caskeleton.adapter.outbound.mongo.api.error.MongoFailureContext; +import dev.caskeleton.adapter.outbound.mongo.api.error.MongoTimeoutException; +import dev.caskeleton.adapter.outbound.mongo.api.observation.MongoOperationObservation; +import dev.caskeleton.adapter.outbound.mongo.api.observation.MongoOperationObserver; +import dev.caskeleton.adapter.outbound.mongo.failure.MongoFailureTranslator; +import java.time.Duration; +import java.util.ArrayList; +import java.util.List; +import org.junit.jupiter.api.Test; +import org.springframework.data.mongodb.core.MongoTemplate; + +class DefaultMongoImperativeExecutorDeadlineTest { + + @Test + void completedWritePastItsDeadlineIsAmbiguousRatherThanReportedNotSent() { + MongoConsistencyBinder consistency = mock(MongoConsistencyBinder.class); + when(consistency.templateFor(any())).thenReturn(mock(MongoTemplate.class)); + RecordingObserver observer = new RecordingObserver(); + DefaultMongoImperativeExecutor executor = + new DefaultMongoImperativeExecutor( + consistency, + MongoCollectionProfileRegistry.builder().register("orders", "orders").build(), + mock(MongoFailureTranslator.class), + observer); + MongoOperationContext context = + MongoOperationContext.of( + "order.update", + "primary", + "orders", + MongoConsistencyProfile.PRIMARY_MAJORITY, + Duration.ofNanos(1)); + + Throwable thrown = + catchThrowable( + () -> executor.executeInternal(context, MongoOperationType.UPDATE, access -> "done")); + + assertThat(thrown).isInstanceOf(MongoTimeoutException.class); + MongoTimeoutException failure = (MongoTimeoutException) thrown; + assertThat(failure.outcome()).isEqualTo(MongoExecutionOutcome.WRITE_RESULT_UNKNOWN); + assertThat(failure.ambiguous()).isTrue(); + assertThat(failure.failureContext().operationType()).isEqualTo(MongoOperationType.UPDATE); + assertThat(observer.successes).isEmpty(); + assertThat(observer.failures).containsExactly(failure.failureContext()); + } + + private static final class RecordingObserver implements MongoOperationObserver { + private final List successes = new ArrayList<>(); + private final List failures = new ArrayList<>(); + + @Override + public MongoOperationObservation start( + MongoOperationContext context, MongoOperationType operationType) { + return new MongoOperationObservation() { + @Override + public void success(MongoExecutionOutcome outcome) { + successes.add(outcome); + } + + @Override + public void failure(MongoFailureContext failureContext) { + failures.add(failureContext); + } + + @Override + public String traceId() { + return "trace-deadline"; + } + + @Override + public void close() {} + }; + } + } +} diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/imperative/atomic/MongoAtomicOperationsTemplateTest.java b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/imperative/atomic/MongoAtomicOperationsTemplateTest.java index 89a38653..164fe6a3 100644 --- a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/imperative/atomic/MongoAtomicOperationsTemplateTest.java +++ b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/imperative/atomic/MongoAtomicOperationsTemplateTest.java @@ -75,10 +75,16 @@ class MongoAtomicOperationsTemplateTest { @Test void matchedButUnchangedIsDistinguishableFromNoMatch() { AtomicUpdateResult unchanged = AtomicUpdateResult.applied(1, 0, null); + AtomicUpdateResult unknownCounts = AtomicUpdateResult.countsUnavailable("after"); AtomicUpdateResult noMatch = AtomicUpdateResult.noMatch(); assertThat(unchanged.matchedButUnchanged()).isTrue(); assertThat(unchanged.matchedAnything()).isTrue(); + assertThat(unknownCounts.countsAvailable()).isFalse(); + assertThat(unknownCounts.matched()).isEqualTo(-1); + assertThat(unknownCounts.modified()).isEqualTo(-1); + assertThat(unknownCounts.matchedAnything()).isTrue(); + assertThat(unknownCounts.matchedButUnchanged()).isFalse(); assertThat(noMatch.matchedAnything()).isFalse(); } diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/migration/flamingock/FlamingockMongoMigrationAdapterTest.java b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/migration/flamingock/FlamingockMongoMigrationAdapterTest.java index 8aab7156..cdddbc9b 100644 --- a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/migration/flamingock/FlamingockMongoMigrationAdapterTest.java +++ b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/migration/flamingock/FlamingockMongoMigrationAdapterTest.java @@ -6,6 +6,7 @@ import static org.assertj.core.api.Assertions.assertThatThrownBy; import dev.caskeleton.adapter.outbound.mongo.api.error.MongoOperationRejectedException; import dev.caskeleton.adapter.outbound.mongo.migration.MongoMigration; +import dev.caskeleton.adapter.outbound.mongo.migration.MongoMigrationCheckpoint; import dev.caskeleton.adapter.outbound.mongo.migration.MongoMigrationChecksum; import dev.caskeleton.adapter.outbound.mongo.migration.MongoMigrationContext; import dev.caskeleton.adapter.outbound.mongo.migration.MongoMigrationId; @@ -13,6 +14,7 @@ import dev.caskeleton.adapter.outbound.mongo.migration.MongoMigrationPostconditi import dev.caskeleton.adapter.outbound.mongo.migration.MongoMigrationPrecondition; import dev.caskeleton.adapter.outbound.mongo.migration.MongoMigrationResult; import java.time.Duration; +import java.time.Instant; import java.util.Optional; import java.util.concurrent.atomic.AtomicBoolean; import org.junit.jupiter.api.Tag; @@ -86,6 +88,24 @@ class FlamingockMongoMigrationAdapterTest { assertThat(ledger.find(new MongoMigrationId("20260811-011"))).isEmpty(); } + @Test + void theUnfencedFlamingockLedgerRefusesPlatformOwnedWrites() { + FlamingockLedgerAdapter ledger = new FlamingockLedgerAdapter(id -> Optional.empty()); + MongoMigrationId id = new MongoMigrationId("20260811-010"); + + assertThatThrownBy( + () -> + ledger.recordApplied( + id, new MongoMigrationChecksum("sha256:1"), "operator", Instant.EPOCH, 1L)) + .isInstanceOf(MongoOperationRejectedException.class) + .hasMessageContaining("unfenced lease"); + assertThatThrownBy( + () -> ledger.saveCheckpoint(MongoMigrationCheckpoint.start(id, Instant.EPOCH), 1L)) + .isInstanceOf(MongoOperationRejectedException.class) + .hasMessageContaining("unfenced lease"); + assertThat(ledger.findCheckpoint(id)).isEmpty(); + } + private static MongoMigration migration(String id, String checksum) { return new MongoMigration() { diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/reactive/ReactiveBinderCarriesRuntimeContractTest.java b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/reactive/ReactiveBinderCarriesRuntimeContractTest.java index da68937a..4137ab8f 100644 --- a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/reactive/ReactiveBinderCarriesRuntimeContractTest.java +++ b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/reactive/ReactiveBinderCarriesRuntimeContractTest.java @@ -35,11 +35,12 @@ class ReactiveBinderCarriesRuntimeContractTest { private static ReactiveMongoTemplate sourceTemplate() { // A real template over a real factory: the binder derives by constructing - // `new ReactiveMongoTemplate(factory, converter)`, so a mock would fail on a null factory. The - // driver is lazy and no operation runs here, so nothing connects. + // `new ReactiveMongoTemplate(factory, converter)`, so mocking the template would lose the + // contract under test. The client itself is mocked so this hermetic test creates no driver + // monitor threads. return new ReactiveMongoTemplate( new SimpleReactiveMongoDatabaseFactory( - com.mongodb.reactivestreams.client.MongoClients.create("mongodb://localhost:27017"), + org.mockito.Mockito.mock(com.mongodb.reactivestreams.client.MongoClient.class), "reactive-contract-test")); } diff --git a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/reactive/cursor/MongoCursorQueryIsolationTest.java b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/reactive/cursor/MongoCursorQueryIsolationTest.java index ae30f644..9bbcceca 100644 --- a/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/reactive/cursor/MongoCursorQueryIsolationTest.java +++ b/src/adapter/outbound/persistence-mongo/src/test/java/dev/caskeleton/adapter/outbound/mongo/reactive/cursor/MongoCursorQueryIsolationTest.java @@ -3,18 +3,24 @@ package dev.caskeleton.adapter.outbound.mongo.reactive.cursor; import static org.assertj.core.api.Assertions.assertThat; import static org.mockito.ArgumentMatchers.any; import static org.mockito.ArgumentMatchers.eq; +import static org.mockito.Mockito.doAnswer; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.when; +import com.mongodb.MongoClientSettings; import dev.caskeleton.adapter.outbound.mongo.api.MongoOperationContext; import dev.caskeleton.adapter.outbound.mongo.api.consistency.MongoConsistencyProfile; import dev.caskeleton.adapter.outbound.mongo.query.budget.MongoOperationBudget; import java.time.Duration; +import org.bson.Document; +import org.bson.conversions.Bson; +import org.junit.jupiter.api.BeforeEach; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Tag; import org.junit.jupiter.api.Test; import org.mockito.ArgumentCaptor; import org.springframework.data.mongodb.core.ReactiveMongoOperations; +import org.springframework.data.mongodb.core.convert.MongoConverter; import org.springframework.data.mongodb.core.query.Query; import reactor.core.publisher.Flux; @@ -30,6 +36,22 @@ import reactor.core.publisher.Flux; class MongoCursorQueryIsolationTest { private final ReactiveMongoOperations operations = mock(ReactiveMongoOperations.class); + private final MongoConverter converter = mock(MongoConverter.class); + + @BeforeEach + void converterWritesBoundedBson() { + when(operations.getConverter()).thenReturn(converter); + when(converter.getCodecRegistry()).thenReturn(MongoClientSettings.getDefaultCodecRegistry()); + doAnswer( + invocation -> { + Object value = invocation.getArgument(0); + Document target = (Document) invocation.getArgument(1, Bson.class); + target.put("value", String.valueOf(value)); + return null; + }) + .when(converter) + .write(any(), any(Bson.class)); + } @Test @DisplayName("streaming does not reconfigure the caller's query") @@ -74,6 +96,7 @@ class MongoCursorQueryIsolationTest { assertThat(executed.getAllValues()) .extracting(query -> query.getMeta().getCursorBatchSize()) .containsExactly(10, 5); + assertThat(executed.getAllValues()).extracting(Query::getLimit).containsExactly(101, 101); } private static MongoOperationContext context() { diff --git a/src/adapter/outbound/persistence-mongo/src/testFixtures/java/dev/caskeleton/adapter/outbound/mongo/testkit/compat/MongoVersionMatrix.java b/src/adapter/outbound/persistence-mongo/src/testFixtures/java/dev/caskeleton/adapter/outbound/mongo/testkit/compat/MongoVersionMatrix.java index e323742f..e260a687 100644 --- a/src/adapter/outbound/persistence-mongo/src/testFixtures/java/dev/caskeleton/adapter/outbound/mongo/testkit/compat/MongoVersionMatrix.java +++ b/src/adapter/outbound/persistence-mongo/src/testFixtures/java/dev/caskeleton/adapter/outbound/mongo/testkit/compat/MongoVersionMatrix.java @@ -1,5 +1,6 @@ package dev.caskeleton.adapter.outbound.mongo.testkit.compat; +import dev.caskeleton.adapter.outbound.mongo.schema.validation.MongoValidatorApplyPolicy; import java.util.List; import java.util.Objects; @@ -24,7 +25,7 @@ public record MongoVersionMatrix(List stableVersions, String primaryCert /** MongoDB 7.0 compatibility and 8.0 primary certification. */ public static MongoVersionMatrix standard() { - return new MongoVersionMatrix(List.of("7.0", "8.0"), "8.0"); + return new MongoVersionMatrix(MongoValidatorApplyPolicy.certifiedReleaseLines(), "8.0"); } /** True when a version is one of the certified lanes. */ diff --git a/src/adapter/outbound/redis-runtime/build.gradle b/src/adapter/outbound/redis-runtime/build.gradle new file mode 100644 index 00000000..6e09bfd9 --- /dev/null +++ b/src/adapter/outbound/redis-runtime/build.gradle @@ -0,0 +1,15 @@ +plugins { + id 'ca.spring-library' + id 'ca.spring-config' +} + +description = 'Redis runtime substrate: topology client, connection lifecycle, gateway and opt-in runtime configuration' + +dependencies { + implementation 'org.springframework.boot:spring-boot-autoconfigure' + implementation 'org.springframework.boot:spring-boot-health' + compileOnly 'com.fasterxml.jackson.core:jackson-annotations' + implementation 'io.lettuce:lettuce-core' + implementation 'io.projectreactor:reactor-core' + implementation 'org.slf4j:slf4j-api' +} diff --git a/src/adapter/outbound/redis-runtime/gradle.lockfile b/src/adapter/outbound/redis-runtime/gradle.lockfile new file mode 100644 index 00000000..062d16a3 --- /dev/null +++ b/src/adapter/outbound/redis-runtime/gradle.lockfile @@ -0,0 +1,164 @@ +# This is a Gradle generated file for dependency locking. +# Manual edits can break the build and are not advised. +# This file is expected to be part of source control. +biz.aQute.bnd:biz.aQute.bnd.annotation:7.1.0=testCompileClasspath +ch.qos.logback:logback-classic:1.5.38=testCompileClasspath,testRuntimeClasspath +ch.qos.logback:logback-core:1.5.38=testCompileClasspath,testRuntimeClasspath +com.fasterxml.jackson.core:jackson-annotations:2.21=compileClasspath,testCompileClasspath,testRuntimeClasspath +com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,testAnnotationProcessor +com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,testAnnotationProcessor +com.github.spotbugs:spotbugs-annotations:4.10.2=spotbugs +com.github.spotbugs:spotbugs:4.10.2=spotbugs +com.github.stephenc.jcip:jcip-annotations:1.0-1=spotbugs +com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,testAnnotationProcessor +com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,testAnnotationProcessor +com.google.auto:auto-common:1.2.2=annotationProcessor,testAnnotationProcessor +com.google.code.findbugs:jsr305:3.0.2=checkstyle,spotbugs +com.google.code.gson:gson:2.13.2=spotbugs +com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.38.0=testCompileClasspath +com.google.errorprone:error_prone_annotations:2.41.0=spotbugs +com.google.errorprone:error_prone_annotations:2.47.0=checkstyle +com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,testAnnotationProcessor +com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.guava:guava:33.5.0-jre=annotationProcessor,testAnnotationProcessor +com.google.guava:guava:33.6.0-jre=checkstyle +com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,testAnnotationProcessor +com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins +com.jayway.jsonpath:json-path:2.10.0=testCompileClasspath,testRuntimeClasspath +com.puppycrawl.tools:checkstyle:13.5.0=checkstyle +com.vaadin.external.google:android-json:0.0.20131108.vaadin1=testCompileClasspath,testRuntimeClasspath +commons-beanutils:commons-beanutils:1.11.0=checkstyle +commons-collections:commons-collections:3.2.2=checkstyle +commons-io:commons-io:2.21.0=spotbugs +commons-logging:commons-logging:1.3.6=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +info.picocli:picocli:4.7.7=checkstyle +io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,testAnnotationProcessor +io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,testAnnotationProcessor +io.lettuce:lettuce-core:6.8.2.RELEASE=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.micrometer:micrometer-commons:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.micrometer:micrometer-observation:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-buffer:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-base:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-dns:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-common:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-handler:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-resolver-dns:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-resolver:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-transport-native-unix-common:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-transport:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.projectreactor:reactor-core:3.8.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +jakarta.activation:jakarta.activation-api:2.1.4=testCompileClasspath,testRuntimeClasspath +jakarta.annotation:jakarta.annotation-api:3.0.0=testCompileClasspath,testRuntimeClasspath +jakarta.xml.bind:jakarta.xml.bind-api:4.0.5=testCompileClasspath,testRuntimeClasspath +javax.inject:javax.inject:1=annotationProcessor,testAnnotationProcessor +jaxen:jaxen:2.0.6=spotbugs +net.bytebuddy:byte-buddy-agent:1.17.8=testCompileClasspath,testRuntimeClasspath +net.bytebuddy:byte-buddy:1.17.8=testCompileClasspath,testRuntimeClasspath +net.minidev:accessors-smart:2.6.0=testCompileClasspath,testRuntimeClasspath +net.minidev:json-smart:2.6.0=testCompileClasspath,testRuntimeClasspath +net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs +org.antlr:antlr4-runtime:4.13.2=checkstyle +org.apache.bcel:bcel:6.12.0=spotbugs +org.apache.commons:commons-lang3:3.20.0=checkstyle,spotbugs +org.apache.commons:commons-text:1.15.0=spotbugs +org.apache.commons:commons-text:1.3=checkstyle +org.apache.httpcomponents:httpclient:4.5.13=checkstyle +org.apache.httpcomponents:httpcore:4.4.16=checkstyle +org.apache.logging.log4j:log4j-api:2.25.5=spotbugs,testCompileClasspath,testRuntimeClasspath +org.apache.logging.log4j:log4j-core:2.25.5=spotbugs +org.apache.logging.log4j:log4j-to-slf4j:2.25.5=testCompileClasspath,testRuntimeClasspath +org.apache.maven.doxia:doxia-core:1.12.0=checkstyle +org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle +org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle +org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle +org.apache.tomcat.embed:tomcat-embed-core:11.0.24=testCompileClasspath,testRuntimeClasspath +org.apache.tomcat.embed:tomcat-embed-el:11.0.24=testCompileClasspath,testRuntimeClasspath +org.apache.tomcat.embed:tomcat-embed-websocket:11.0.24=testCompileClasspath,testRuntimeClasspath +org.apache.xbean:xbean-reflect:3.7=checkstyle +org.apiguardian:apiguardian-api:1.1.2=testCompileClasspath +org.assertj:assertj-core:3.27.7=testCompileClasspath,testRuntimeClasspath +org.awaitility:awaitility:4.3.0=testCompileClasspath,testRuntimeClasspath +org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle +org.codehaus.plexus:plexus-component-annotations:2.1.0=checkstyle +org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle +org.codehaus.plexus:plexus-utils:3.3.0=checkstyle +org.dom4j:dom4j:2.2.0=spotbugs +org.hamcrest:hamcrest:3.0=testCompileClasspath,testRuntimeClasspath +org.javassist:javassist:3.28.0-GA=checkstyle +org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-api:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-engine:6.0.3=testRuntimeClasspath +org.junit.jupiter:junit-jupiter-params:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-commons:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-engine:6.0.3=testRuntimeClasspath +org.junit.platform:junit-platform-launcher:6.0.3=testRuntimeClasspath +org.junit:junit-bom:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit:junit-bom:6.1.0=spotbugs +org.mockito:mockito-core:5.20.0=mockitoAgent,testCompileClasspath,testRuntimeClasspath +org.mockito:mockito-junit-jupiter:5.20.0=testCompileClasspath,testRuntimeClasspath +org.objenesis:objenesis:3.3=testRuntimeClasspath +org.opentest4j:opentest4j:1.3.0=testCompileClasspath,testRuntimeClasspath +org.osgi:org.osgi.annotation.bundle:2.0.0=testCompileClasspath +org.osgi:org.osgi.annotation.versioning:1.1.2=testCompileClasspath +org.osgi:org.osgi.resource:1.0.0=testCompileClasspath +org.osgi:org.osgi.service.serviceloader:1.0.0=testCompileClasspath +org.ow2.asm:asm-analysis:9.10.1=spotbugs +org.ow2.asm:asm-commons:9.10.1=spotbugs +org.ow2.asm:asm-tree:9.10.1=spotbugs +org.ow2.asm:asm-util:9.10.1=spotbugs +org.ow2.asm:asm:9.10.1=spotbugs +org.ow2.asm:asm:9.7.1=testCompileClasspath,testRuntimeClasspath +org.pcollections:pcollections:4.0.1=annotationProcessor,testAnnotationProcessor +org.reactivestreams:reactive-streams:1.0.4=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.reflections:reflections:0.10.2=checkstyle +org.skyscreamer:jsonassert:1.5.3=testCompileClasspath,testRuntimeClasspath +org.slf4j:jul-to-slf4j:2.0.18=testCompileClasspath,testRuntimeClasspath +org.slf4j:slf4j-api:2.0.18=compileClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testRuntimeClasspath +org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j +org.slf4j:slf4j-simple:2.0.18=checkstyle +org.springframework.boot:spring-boot-autoconfigure:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-configuration-processor:4.0.8=annotationProcessor +org.springframework.boot:spring-boot-health:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-http-converter:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-jackson:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-resttestclient:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-servlet:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-jackson-test:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-jackson:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-logging:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-test:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-tomcat-runtime:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-tomcat:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-webmvc-test:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-webmvc:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-test-autoconfigure:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-test:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-tomcat:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-web-server:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-webmvc-test:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-webmvc:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-aop:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-beans:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-context:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-core:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-expression:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-test:7.0.9=testCompileClasspath,testRuntimeClasspath +org.springframework:spring-web:7.0.9=testCompileClasspath,testRuntimeClasspath +org.springframework:spring-webmvc:7.0.9=testCompileClasspath,testRuntimeClasspath +org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs +org.xmlunit:xmlunit-core:2.10.4=testCompileClasspath,testRuntimeClasspath +org.yaml:snakeyaml:2.5=testCompileClasspath,testRuntimeClasspath +redis.clients.authentication:redis-authx-core:0.1.1-beta2=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +tools.jackson.core:jackson-core:3.1.5=testCompileClasspath,testRuntimeClasspath +tools.jackson.core:jackson-databind:3.1.5=testCompileClasspath,testRuntimeClasspath +tools.jackson:jackson-bom:3.1.5=testCompileClasspath,testRuntimeClasspath +empty= diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisDeploymentMode.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisDeploymentMode.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisDeploymentMode.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisDeploymentMode.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisVersion.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisVersion.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisVersion.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisVersion.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/CommandAccess.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/CommandAccess.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/CommandAccess.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/CommandAccess.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/CommandId.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/CommandId.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/CommandId.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/CommandId.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/CommandSupport.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/CommandSupport.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/CommandSupport.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/CommandSupport.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/KeySpec.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/KeySpec.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/KeySpec.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/KeySpec.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/PersistentKeyPermit.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/PersistentKeyPermit.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/PersistentKeyPermit.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/PersistentKeyPermit.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/RedisCommandDescriptor.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/RedisCommandDescriptor.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/RedisCommandDescriptor.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/RedisCommandDescriptor.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/RedisRiskLevel.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/RedisRiskLevel.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/RedisRiskLevel.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/RedisRiskLevel.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/TimeoutProfile.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/TimeoutProfile.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/TimeoutProfile.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/TimeoutProfile.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisCommandRejectedException.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisCommandRejectedException.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisCommandRejectedException.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisCommandRejectedException.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisFailureMetadata.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisFailureMetadata.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisFailureMetadata.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisFailureMetadata.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisOperationException.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisOperationException.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisOperationException.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisOperationException.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisKeyRules.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisKeyRules.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisKeyRules.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisKeyRules.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisNamespace.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisNamespace.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisNamespace.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisNamespace.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BitFieldOverflow.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BitFieldOverflow.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BitFieldOverflow.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BitFieldOverflow.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BitFieldSubcommand.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BitFieldSubcommand.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BitFieldSubcommand.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BitFieldSubcommand.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BitmapOperation.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BitmapOperation.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BitmapOperation.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BitmapOperation.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/Distance.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/Distance.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/Distance.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/Distance.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/DistanceUnit.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/DistanceUnit.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/DistanceUnit.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/DistanceUnit.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/Expiration.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/Expiration.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/Expiration.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/Expiration.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ExpirationCondition.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ExpirationCondition.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ExpirationCondition.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ExpirationCondition.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/GeoPoint.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/GeoPoint.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/GeoPoint.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/GeoPoint.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/GeoSearchRequest.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/GeoSearchRequest.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/GeoSearchRequest.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/GeoSearchRequest.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/LexRange.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/LexRange.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/LexRange.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/LexRange.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ListSide.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ListSide.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ListSide.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ListSide.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/LongRange.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/LongRange.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/LongRange.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/LongRange.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PageRequest.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PageRequest.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PageRequest.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PageRequest.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ScoreRange.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ScoreRange.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ScoreRange.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ScoreRange.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/SortDirection.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/SortDirection.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/SortDirection.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/SortDirection.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/SortedSetAddOptions.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/SortedSetAddOptions.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/SortedSetAddOptions.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/SortedSetAddOptions.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamAppendOptions.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamAppendOptions.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamAppendOptions.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamAppendOptions.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamDeletionOutcome.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamDeletionOutcome.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamDeletionOutcome.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamDeletionOutcome.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamDeletionPolicy.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamDeletionPolicy.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamDeletionPolicy.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamDeletionPolicy.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamId.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamId.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamId.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamId.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamTrimPolicy.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamTrimPolicy.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamTrimPolicy.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamTrimPolicy.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/RedisSlotCalculator.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/RedisSlotCalculator.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/RedisSlotCalculator.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/RedisSlotCalculator.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisCorrectnessRoles.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisCorrectnessRoles.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisCorrectnessRoles.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisCorrectnessRoles.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisCredentialResolver.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisCredentialResolver.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisCredentialResolver.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisCredentialResolver.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisHealthContributor.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisHealthContributor.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisHealthContributor.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisHealthContributor.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisSdkAutoConfiguration.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisSdkAutoConfiguration.java similarity index 99% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisSdkAutoConfiguration.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisSdkAutoConfiguration.java index a699afb7..7a8c2177 100644 --- a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisSdkAutoConfiguration.java +++ b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisSdkAutoConfiguration.java @@ -276,7 +276,7 @@ public class RedisSdkAutoConfiguration { limits.put(RedisConnectionKind.REGULAR, settings.getCapacity().getMaximumInFlightCommands()); limits.put(RedisConnectionKind.BLOCKING, settings.getBlocking().getMaxConnections()); limits.put(RedisConnectionKind.TRANSACTION, settings.getTransaction().getMaxConnections()); - limits.put(RedisConnectionKind.SCRIPT, settings.getCapacity().getMaximumInFlightCommands()); + limits.put(RedisConnectionKind.SCRIPT, settings.getCapacity().getMaximumScriptConnections()); limits.put( RedisConnectionKind.PUBSUB, Math.max(1, settings.getPubsub().getBufferCapacity() / 64)); limits.put(RedisConnectionKind.ADMIN, settings.getAdmin().isEnabled() ? 2 : 1); diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisSdkSettings.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisSdkSettings.java similarity index 97% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisSdkSettings.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisSdkSettings.java index 2f577f0c..72555553 100644 --- a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisSdkSettings.java +++ b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisSdkSettings.java @@ -32,7 +32,6 @@ public class RedisSdkSettings { private RedisDeploymentMode mode = RedisDeploymentMode.STANDALONE; private List nodes = new ArrayList<>(List.of("localhost:6379")); private int database; - private boolean acknowledgedWriteLossAccepted; private final Namespace namespace = new Namespace(); private final Timeouts timeout = new Timeouts(); private final Limits limits = new Limits(); @@ -685,12 +684,16 @@ public class RedisSdkSettings { public static class Capacity { private int maximumInFlightCommands = 64; + private int maximumScriptConnections = 8; private long maximumInFlightBytes = 4L * 1024 * 1024; private long maximumReplyBytes = 16L * 1024 * 1024; private boolean rejectWhenDisconnected = true; void validate() { - if (maximumInFlightCommands < 1 || maximumInFlightBytes < 1 || maximumReplyBytes < 1) { + if (maximumInFlightCommands < 1 + || maximumScriptConnections < 1 + || maximumInFlightBytes < 1 + || maximumReplyBytes < 1) { throw new IllegalStateException("every Redis capacity ceiling must be positive"); } } @@ -703,6 +706,14 @@ public class RedisSdkSettings { this.maximumInFlightCommands = maximumInFlightCommands; } + public int getMaximumScriptConnections() { + return maximumScriptConnections; + } + + public void setMaximumScriptConnections(int maximumScriptConnections) { + this.maximumScriptConnections = maximumScriptConnections; + } + public long getMaximumInFlightBytes() { return maximumInFlightBytes; } @@ -880,23 +891,6 @@ public class RedisSdkSettings { this.database = database; } - /** - * Reports whether this deployment has declared that it accepts losing acknowledged writes. - * - *

    Leave this false unless the trade is deliberate. A replicated deployment without {@code - * min-replicas-to-write} discards writes it told the caller had succeeded, and no client-side - * signal exists for it; see {@link RedisCapabilityProbe#requireWriteDurability}. - * - * @return {@code true} when the loss is accepted - */ - public boolean isAcknowledgedWriteLossAccepted() { - return acknowledgedWriteLossAccepted; - } - - public void setAcknowledgedWriteLossAccepted(boolean acknowledgedWriteLossAccepted) { - this.acknowledgedWriteLossAccepted = acknowledgedWriteLossAccepted; - } - public Namespace getNamespace() { return namespace; } diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisConnectionKind.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisConnectionKind.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisConnectionKind.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisConnectionKind.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisCredentialRole.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisCredentialRole.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisCredentialRole.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisCredentialRole.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisLease.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisLease.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisLease.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisLease.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisRuntimeClient.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisRuntimeClient.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisRuntimeClient.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisRuntimeClient.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisRuntimeOwner.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisRuntimeOwner.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisRuntimeOwner.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisRuntimeOwner.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisTopologyClientFactory.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisTopologyClientFactory.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisTopologyClientFactory.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisTopologyClientFactory.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/GeoSearchHit.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/GeoSearchHit.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/GeoSearchHit.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/GeoSearchHit.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/HashScanPage.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/HashScanPage.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/HashScanPage.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/HashScanPage.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/KeyScanPage.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/KeyScanPage.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/KeyScanPage.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/KeyScanPage.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/KeyedElement.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/KeyedElement.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/KeyedElement.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/KeyedElement.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisCommandGateway.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisCommandGateway.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisCommandGateway.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisCommandGateway.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/MemberScanPage.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/MemberScanPage.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/MemberScanPage.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/MemberScanPage.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisCommandGateway.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisCommandGateway.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisCommandGateway.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisCommandGateway.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisPubSubGateway.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisPubSubGateway.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisPubSubGateway.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisPubSubGateway.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/ScoredMemberPage.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/ScoredMemberPage.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/ScoredMemberPage.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/ScoredMemberPage.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamClaimPage.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamClaimPage.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamClaimPage.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamClaimPage.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamEntry.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamEntry.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamEntry.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamEntry.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamPendingEntry.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamPendingEntry.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamPendingEntry.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamPendingEntry.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamPendingOverview.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamPendingOverview.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamPendingOverview.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamPendingOverview.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/WritePresence.java b/src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/WritePresence.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/WritePresence.java rename to src/adapter/outbound/redis-runtime/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/WritePresence.java diff --git a/src/adapter/outbound/cache-redis/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/src/adapter/outbound/redis-runtime/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports rename to src/adapter/outbound/redis-runtime/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports diff --git a/src/adapter/outbound/redis-sdk/build.gradle b/src/adapter/outbound/redis-sdk/build.gradle new file mode 100644 index 00000000..cf30b8c8 --- /dev/null +++ b/src/adapter/outbound/redis-sdk/build.gradle @@ -0,0 +1,13 @@ +plugins { + id 'ca.spring-library' +} + +description = 'Optional typed Redis SDK: guarded typed operations, admin/raw surfaces and extensions' + +dependencies { + implementation project(':adapter:outbound:redis-runtime') + implementation 'org.springframework:spring-core' + implementation 'io.lettuce:lettuce-core' + implementation 'io.projectreactor:reactor-core' + implementation 'org.slf4j:slf4j-api' +} diff --git a/src/adapter/outbound/redis-sdk/gradle.lockfile b/src/adapter/outbound/redis-sdk/gradle.lockfile new file mode 100644 index 00000000..8c5ab46a --- /dev/null +++ b/src/adapter/outbound/redis-sdk/gradle.lockfile @@ -0,0 +1,163 @@ +# This is a Gradle generated file for dependency locking. +# Manual edits can break the build and are not advised. +# This file is expected to be part of source control. +biz.aQute.bnd:biz.aQute.bnd.annotation:7.1.0=testCompileClasspath +ch.qos.logback:logback-classic:1.5.38=testCompileClasspath,testRuntimeClasspath +ch.qos.logback:logback-core:1.5.38=testCompileClasspath,testRuntimeClasspath +com.fasterxml.jackson.core:jackson-annotations:2.21=testCompileClasspath,testRuntimeClasspath +com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,testAnnotationProcessor +com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,testAnnotationProcessor +com.github.spotbugs:spotbugs-annotations:4.10.2=spotbugs +com.github.spotbugs:spotbugs:4.10.2=spotbugs +com.github.stephenc.jcip:jcip-annotations:1.0-1=spotbugs +com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,testAnnotationProcessor +com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,testAnnotationProcessor +com.google.auto:auto-common:1.2.2=annotationProcessor,testAnnotationProcessor +com.google.code.findbugs:jsr305:3.0.2=checkstyle,spotbugs +com.google.code.gson:gson:2.13.2=spotbugs +com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.38.0=testCompileClasspath +com.google.errorprone:error_prone_annotations:2.41.0=spotbugs +com.google.errorprone:error_prone_annotations:2.47.0=checkstyle +com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,testAnnotationProcessor +com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.guava:guava:33.5.0-jre=annotationProcessor,testAnnotationProcessor +com.google.guava:guava:33.6.0-jre=checkstyle +com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,testAnnotationProcessor +com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins +com.jayway.jsonpath:json-path:2.10.0=testCompileClasspath,testRuntimeClasspath +com.puppycrawl.tools:checkstyle:13.5.0=checkstyle +com.vaadin.external.google:android-json:0.0.20131108.vaadin1=testCompileClasspath,testRuntimeClasspath +commons-beanutils:commons-beanutils:1.11.0=checkstyle +commons-collections:commons-collections:3.2.2=checkstyle +commons-io:commons-io:2.21.0=spotbugs +commons-logging:commons-logging:1.3.6=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +info.picocli:picocli:4.7.7=checkstyle +io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,testAnnotationProcessor +io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,testAnnotationProcessor +io.lettuce:lettuce-core:6.8.2.RELEASE=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.micrometer:micrometer-commons:1.16.7=runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.micrometer:micrometer-observation:1.16.7=runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-buffer:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-base:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-dns:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-common:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-handler:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-resolver-dns:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-resolver:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-transport-native-unix-common:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-transport:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.projectreactor:reactor-core:3.8.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +jakarta.activation:jakarta.activation-api:2.1.4=testCompileClasspath,testRuntimeClasspath +jakarta.annotation:jakarta.annotation-api:3.0.0=testCompileClasspath,testRuntimeClasspath +jakarta.xml.bind:jakarta.xml.bind-api:4.0.5=testCompileClasspath,testRuntimeClasspath +javax.inject:javax.inject:1=annotationProcessor,testAnnotationProcessor +jaxen:jaxen:2.0.6=spotbugs +net.bytebuddy:byte-buddy-agent:1.17.8=testCompileClasspath,testRuntimeClasspath +net.bytebuddy:byte-buddy:1.17.8=testCompileClasspath,testRuntimeClasspath +net.minidev:accessors-smart:2.6.0=testCompileClasspath,testRuntimeClasspath +net.minidev:json-smart:2.6.0=testCompileClasspath,testRuntimeClasspath +net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs +org.antlr:antlr4-runtime:4.13.2=checkstyle +org.apache.bcel:bcel:6.12.0=spotbugs +org.apache.commons:commons-lang3:3.20.0=checkstyle,spotbugs +org.apache.commons:commons-text:1.15.0=spotbugs +org.apache.commons:commons-text:1.3=checkstyle +org.apache.httpcomponents:httpclient:4.5.13=checkstyle +org.apache.httpcomponents:httpcore:4.4.16=checkstyle +org.apache.logging.log4j:log4j-api:2.25.5=spotbugs,testCompileClasspath,testRuntimeClasspath +org.apache.logging.log4j:log4j-core:2.25.5=spotbugs +org.apache.logging.log4j:log4j-to-slf4j:2.25.5=testCompileClasspath,testRuntimeClasspath +org.apache.maven.doxia:doxia-core:1.12.0=checkstyle +org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle +org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle +org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle +org.apache.tomcat.embed:tomcat-embed-core:11.0.24=testCompileClasspath,testRuntimeClasspath +org.apache.tomcat.embed:tomcat-embed-el:11.0.24=testCompileClasspath,testRuntimeClasspath +org.apache.tomcat.embed:tomcat-embed-websocket:11.0.24=testCompileClasspath,testRuntimeClasspath +org.apache.xbean:xbean-reflect:3.7=checkstyle +org.apiguardian:apiguardian-api:1.1.2=testCompileClasspath +org.assertj:assertj-core:3.27.7=testCompileClasspath,testRuntimeClasspath +org.awaitility:awaitility:4.3.0=testCompileClasspath,testRuntimeClasspath +org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle +org.codehaus.plexus:plexus-component-annotations:2.1.0=checkstyle +org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle +org.codehaus.plexus:plexus-utils:3.3.0=checkstyle +org.dom4j:dom4j:2.2.0=spotbugs +org.hamcrest:hamcrest:3.0=testCompileClasspath,testRuntimeClasspath +org.javassist:javassist:3.28.0-GA=checkstyle +org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-api:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-engine:6.0.3=testRuntimeClasspath +org.junit.jupiter:junit-jupiter-params:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-commons:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-engine:6.0.3=testRuntimeClasspath +org.junit.platform:junit-platform-launcher:6.0.3=testRuntimeClasspath +org.junit:junit-bom:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit:junit-bom:6.1.0=spotbugs +org.mockito:mockito-core:5.20.0=mockitoAgent,testCompileClasspath,testRuntimeClasspath +org.mockito:mockito-junit-jupiter:5.20.0=testCompileClasspath,testRuntimeClasspath +org.objenesis:objenesis:3.3=testRuntimeClasspath +org.opentest4j:opentest4j:1.3.0=testCompileClasspath,testRuntimeClasspath +org.osgi:org.osgi.annotation.bundle:2.0.0=testCompileClasspath +org.osgi:org.osgi.annotation.versioning:1.1.2=testCompileClasspath +org.osgi:org.osgi.resource:1.0.0=testCompileClasspath +org.osgi:org.osgi.service.serviceloader:1.0.0=testCompileClasspath +org.ow2.asm:asm-analysis:9.10.1=spotbugs +org.ow2.asm:asm-commons:9.10.1=spotbugs +org.ow2.asm:asm-tree:9.10.1=spotbugs +org.ow2.asm:asm-util:9.10.1=spotbugs +org.ow2.asm:asm:9.10.1=spotbugs +org.ow2.asm:asm:9.7.1=testCompileClasspath,testRuntimeClasspath +org.pcollections:pcollections:4.0.1=annotationProcessor,testAnnotationProcessor +org.reactivestreams:reactive-streams:1.0.4=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.reflections:reflections:0.10.2=checkstyle +org.skyscreamer:jsonassert:1.5.3=testCompileClasspath,testRuntimeClasspath +org.slf4j:jul-to-slf4j:2.0.18=testCompileClasspath,testRuntimeClasspath +org.slf4j:slf4j-api:2.0.18=compileClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testRuntimeClasspath +org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j +org.slf4j:slf4j-simple:2.0.18=checkstyle +org.springframework.boot:spring-boot-autoconfigure:4.0.8=runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-health:4.0.8=runtimeClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-http-converter:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-jackson:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-resttestclient:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-servlet:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-jackson-test:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-jackson:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-logging:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-test:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-tomcat-runtime:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-tomcat:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-webmvc-test:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-webmvc:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-test-autoconfigure:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-test:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-tomcat:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-web-server:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-webmvc-test:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-webmvc:4.0.8=testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot:4.0.8=runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-aop:7.0.9=runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-beans:7.0.9=runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-context:7.0.9=runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-core:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-expression:7.0.9=runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-test:7.0.9=testCompileClasspath,testRuntimeClasspath +org.springframework:spring-web:7.0.9=testCompileClasspath,testRuntimeClasspath +org.springframework:spring-webmvc:7.0.9=testCompileClasspath,testRuntimeClasspath +org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs +org.xmlunit:xmlunit-core:2.10.4=testCompileClasspath,testRuntimeClasspath +org.yaml:snakeyaml:2.5=testCompileClasspath,testRuntimeClasspath +redis.clients.authentication:redis-authx-core:0.1.1-beta2=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +tools.jackson.core:jackson-core:3.1.5=testCompileClasspath,testRuntimeClasspath +tools.jackson.core:jackson-databind:3.1.5=testCompileClasspath,testRuntimeClasspath +tools.jackson:jackson-bom:3.1.5=testCompileClasspath,testRuntimeClasspath +empty= diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/admin/ClientSummary.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/admin/ClientSummary.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/admin/ClientSummary.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/admin/ClientSummary.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/admin/LettuceRedisAdminOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/admin/LettuceRedisAdminOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/admin/LettuceRedisAdminOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/admin/LettuceRedisAdminOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/admin/RedisAdminOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/admin/RedisAdminOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/admin/RedisAdminOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/admin/RedisAdminOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/admin/SlowLogEntry.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/admin/SlowLogEntry.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/admin/SlowLogEntry.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/admin/SlowLogEntry.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/ReactiveRedisOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/ReactiveRedisOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/ReactiveRedisOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/ReactiveRedisOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisCapabilities.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisCapabilities.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisCapabilities.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisCapabilities.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisCapability.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisCapability.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisCapability.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisCapability.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/RedisOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/codec/RedisCodec.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/codec/RedisCodec.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/codec/RedisCodec.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/codec/RedisCodec.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/codec/RedisEnvelope.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/codec/RedisEnvelope.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/codec/RedisEnvelope.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/codec/RedisEnvelope.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/codec/RedisPayloadCodec.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/codec/RedisPayloadCodec.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/codec/RedisPayloadCodec.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/codec/RedisPayloadCodec.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/AdvancedOperationPermit.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/AdvancedOperationPermit.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/AdvancedOperationPermit.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/AdvancedOperationPermit.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/MultiKeyPermit.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/MultiKeyPermit.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/MultiKeyPermit.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/MultiKeyPermit.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/OperationBudget.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/OperationBudget.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/OperationBudget.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/OperationBudget.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/RedisPermitVerifier.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/RedisPermitVerifier.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/RedisPermitVerifier.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/RedisPermitVerifier.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/RedisPolicyAuthority.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/RedisPolicyAuthority.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/RedisPolicyAuthority.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/command/RedisPolicyAuthority.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisAccessDeniedException.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisAccessDeniedException.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisAccessDeniedException.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisAccessDeniedException.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisAmbiguousExecutionException.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisAmbiguousExecutionException.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisAmbiguousExecutionException.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisAmbiguousExecutionException.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisBusyException.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisBusyException.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisBusyException.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisBusyException.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisCapabilityUnavailableException.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisCapabilityUnavailableException.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisCapabilityUnavailableException.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisCapabilityUnavailableException.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisConnectionException.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisConnectionException.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisConnectionException.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisConnectionException.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisCrossSlotException.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisCrossSlotException.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisCrossSlotException.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisCrossSlotException.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisDataTypeMismatchException.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisDataTypeMismatchException.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisDataTypeMismatchException.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisDataTypeMismatchException.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisNoScriptException.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisNoScriptException.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisNoScriptException.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisNoScriptException.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisRedirectionException.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisRedirectionException.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisRedirectionException.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisRedirectionException.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisSerializationException.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisSerializationException.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisSerializationException.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisSerializationException.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisTimeoutException.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisTimeoutException.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisTimeoutException.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/error/RedisTimeoutException.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/BitmapKey.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/BitmapKey.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/BitmapKey.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/BitmapKey.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/GeoKey.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/GeoKey.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/GeoKey.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/GeoKey.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/HashKey.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/HashKey.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/HashKey.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/HashKey.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/HyperLogLogKey.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/HyperLogLogKey.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/HyperLogLogKey.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/HyperLogLogKey.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/ListKey.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/ListKey.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/ListKey.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/ListKey.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/QualifiedRedisKey.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/QualifiedRedisKey.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/QualifiedRedisKey.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/QualifiedRedisKey.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisKeyName.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisKeyName.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisKeyName.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisKeyName.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisKeyRenderer.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisKeyRenderer.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisKeyRenderer.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisKeyRenderer.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisSlotTag.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisSlotTag.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisSlotTag.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisSlotTag.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisTypedKey.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisTypedKey.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisTypedKey.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/RedisTypedKey.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/SetKey.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/SetKey.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/SetKey.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/SetKey.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/SortedSetKey.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/SortedSetKey.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/SortedSetKey.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/SortedSetKey.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/StreamKey.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/StreamKey.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/StreamKey.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/StreamKey.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/TypedRedisKeys.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/TypedRedisKeys.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/TypedRedisKeys.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/TypedRedisKeys.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/ValueKey.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/ValueKey.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/ValueKey.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/key/ValueKey.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BatchItemResult.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BatchItemResult.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BatchItemResult.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BatchItemResult.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BatchOptions.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BatchOptions.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BatchOptions.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BatchOptions.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BitFieldResult.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BitFieldResult.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BitFieldResult.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/BitFieldResult.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ClaimResult.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ClaimResult.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ClaimResult.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ClaimResult.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ExpirationResult.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ExpirationResult.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ExpirationResult.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ExpirationResult.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ExpirationUpdatePolicy.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ExpirationUpdatePolicy.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ExpirationUpdatePolicy.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ExpirationUpdatePolicy.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/GeoLocation.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/GeoLocation.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/GeoLocation.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/GeoLocation.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/GeoSearchResult.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/GeoSearchResult.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/GeoSearchResult.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/GeoSearchResult.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/KeyedValue.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/KeyedValue.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/KeyedValue.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/KeyedValue.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PendingQuery.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PendingQuery.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PendingQuery.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PendingQuery.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PendingRecord.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PendingRecord.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PendingRecord.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PendingRecord.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PendingSummary.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PendingSummary.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PendingSummary.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PendingSummary.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PubSubChannel.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PubSubChannel.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PubSubChannel.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PubSubChannel.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PubSubPattern.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PubSubPattern.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PubSubPattern.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/PubSubPattern.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RankRange.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RankRange.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RankRange.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RankRange.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBatch.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBatch.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBatch.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBatch.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBatchOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBatchOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBatchOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBatchOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBatchResult.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBatchResult.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBatchResult.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBatchResult.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBitFieldOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBitFieldOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBitFieldOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBitFieldOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBitmapOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBitmapOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBitmapOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBitmapOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBlockingListOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBlockingListOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBlockingListOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBlockingListOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBlockingStreamOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBlockingStreamOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBlockingStreamOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisBlockingStreamOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisDataType.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisDataType.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisDataType.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisDataType.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisGeoOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisGeoOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisGeoOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisGeoOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisHashFieldExpirationOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisHashFieldExpirationOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisHashFieldExpirationOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisHashFieldExpirationOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisHashOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisHashOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisHashOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisHashOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisHyperLogLogOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisHyperLogLogOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisHyperLogLogOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisHyperLogLogOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisKeyOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisKeyOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisKeyOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisKeyOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisListOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisListOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisListOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisListOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisMessageHandler.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisMessageHandler.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisMessageHandler.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisMessageHandler.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisPubSubOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisPubSubOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisPubSubOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisPubSubOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisSetOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisSetOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisSetOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisSetOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisShardedPubSubOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisShardedPubSubOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisShardedPubSubOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisShardedPubSubOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisSortedSetOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisSortedSetOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisSortedSetOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisSortedSetOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisStreamDeletionOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisStreamDeletionOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisStreamDeletionOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisStreamDeletionOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisStreamOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisStreamOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisStreamOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisStreamOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisValueOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisValueOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisValueOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RedisValueOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RenameMode.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RenameMode.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RenameMode.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/RenameMode.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ScanPage.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ScanPage.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ScanPage.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ScanPage.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ScanRequest.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ScanRequest.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ScanRequest.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ScanRequest.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ScoredValue.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ScoredValue.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ScoredValue.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ScoredValue.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ShardedPubSubChannel.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ShardedPubSubChannel.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ShardedPubSubChannel.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/ShardedPubSubChannel.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamConsumer.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamConsumer.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamConsumer.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamConsumer.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamGroup.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamGroup.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamGroup.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamGroup.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamRange.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamRange.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamRange.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamRange.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamReadOffset.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamReadOffset.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamReadOffset.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamReadOffset.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamRecord.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamRecord.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamRecord.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/StreamRecord.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/Subscription.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/Subscription.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/Subscription.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/operations/Subscription.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBatchOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBatchOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBatchOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBatchOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBitFieldOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBitFieldOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBitFieldOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBitFieldOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBitmapOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBitmapOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBitmapOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBitmapOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBlockingListOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBlockingListOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBlockingListOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBlockingListOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBlockingStreamOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBlockingStreamOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBlockingStreamOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisBlockingStreamOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisGeoOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisGeoOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisGeoOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisGeoOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisHashFieldExpirationOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisHashFieldExpirationOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisHashFieldExpirationOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisHashFieldExpirationOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisHashOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisHashOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisHashOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisHashOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisHyperLogLogOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisHyperLogLogOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisHyperLogLogOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisHyperLogLogOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisKeyOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisKeyOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisKeyOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisKeyOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisListOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisListOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisListOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisListOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisPubSubOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisPubSubOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisPubSubOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisPubSubOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisSetOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisSetOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisSetOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisSetOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisShardedPubSubOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisShardedPubSubOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisShardedPubSubOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisShardedPubSubOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisSortedSetOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisSortedSetOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisSortedSetOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisSortedSetOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisStreamOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisStreamOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisStreamOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisStreamOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisValueOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisValueOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisValueOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/api/reactive/ReactiveRedisValueOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/ClusterRedirect.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/ClusterRedirect.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/ClusterRedirect.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/ClusterRedirect.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/ClusterScanCursor.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/ClusterScanCursor.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/ClusterScanCursor.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/ClusterScanCursor.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/ClusterTopologyObserver.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/ClusterTopologyObserver.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/ClusterTopologyObserver.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/ClusterTopologyObserver.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/SameSlotValidator.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/SameSlotValidator.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/SameSlotValidator.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/cluster/SameSlotValidator.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/ConfiguredRedisPermitVerifier.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/ConfiguredRedisPermitVerifier.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/ConfiguredRedisPermitVerifier.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/ConfiguredRedisPermitVerifier.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/ConfiguredRedisPolicyAuthority.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/ConfiguredRedisPolicyAuthority.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/ConfiguredRedisPolicyAuthority.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/ConfiguredRedisPolicyAuthority.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/GrantedAdvancedOperationPermit.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/GrantedAdvancedOperationPermit.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/GrantedAdvancedOperationPermit.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/GrantedAdvancedOperationPermit.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/GrantedMultiKeyPermit.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/GrantedMultiKeyPermit.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/GrantedMultiKeyPermit.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/GrantedMultiKeyPermit.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/GrantedPersistentKeyPermit.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/GrantedPersistentKeyPermit.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/GrantedPersistentKeyPermit.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/GrantedPersistentKeyPermit.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisCapabilityProbe.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisCapabilityProbe.java similarity index 98% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisCapabilityProbe.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisCapabilityProbe.java index 0bb89c57..f31e3704 100644 --- a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisCapabilityProbe.java +++ b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisCapabilityProbe.java @@ -148,7 +148,7 @@ public final class RedisCapabilityProbe { + " deployment, so a promotion silently discards writes this client was told" + " succeeded. Set min-replicas-to-write to at least 1 with a bounded" + " min-replicas-max-lag, or set" - + " app.redis.acknowledged-write-loss-accepted=true to" + + " an explicit caller-level waiver to RedisStartupProbe to" + " record that this deployment accepts the loss."); } if (minReplicasMaxLagSeconds < 1) { @@ -162,7 +162,7 @@ public final class RedisCapabilityProbe { + " deployment, which places no bound on how stale those replicas may be: a write is" + " acknowledged as soon as enough replicas are attached, however far behind they" + " are. Set min-replicas-max-lag to a positive number of seconds, or set" - + " app.redis.acknowledged-write-loss-accepted=true to" + + " an explicit caller-level waiver to RedisStartupProbe to" + " record that this deployment accepts the loss."); } } diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisStartupProbe.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisStartupProbe.java similarity index 83% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisStartupProbe.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisStartupProbe.java index 9ac874da..45cbb43d 100644 --- a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisStartupProbe.java +++ b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/config/RedisStartupProbe.java @@ -38,7 +38,11 @@ public final class RedisStartupProbe { } /** - * Confirms the server matches what the deployment declared. + * Confirms the server without waiving replicated-write durability. + * + *

    The shipped runtime does not expose a configuration switch that silently weakens this + * guarantee. A caller that deliberately accepts acknowledged-write loss must use the overload + * that carries the waiver as an explicit argument. * * @param settings the validated settings * @param serverFacts what the server reported @@ -49,6 +53,24 @@ public final class RedisStartupProbe { RedisSdkSettings settings, ServerFacts serverFacts, Collection requiredCapabilities) { + return confirm(settings, serverFacts, requiredCapabilities, false); + } + + /** + * Confirms the server matches what the deployment declared. + * + * @param settings the validated settings + * @param serverFacts what the server reported + * @param requiredCapabilities capabilities the deployment explicitly enabled + * @param acknowledgedWriteLossAccepted explicit caller decision to waive replicated-write + * durability + * @return the confirmed capability snapshot + */ + public RedisCapabilities confirm( + RedisSdkSettings settings, + ServerFacts serverFacts, + Collection requiredCapabilities, + boolean acknowledgedWriteLossAccepted) { Objects.requireNonNull(settings, "settings must be non-null"); Objects.requireNonNull(serverFacts, "server facts must be non-null"); RedisCapabilities capabilities = @@ -62,7 +84,7 @@ public final class RedisStartupProbe { settings.getMode(), serverFacts.minReplicasToWrite(), serverFacts.minReplicasMaxLagSeconds(), - settings.isAcknowledgedWriteLossAccepted()); + acknowledgedWriteLossAccepted); return capabilities; } @@ -133,8 +155,8 @@ public final class RedisStartupProbe { "the server did not report '" + key + "'. Write durability cannot be confirmed without it; grant the admin account" - + " +config|get, or set app.redis.acknowledged-write-loss-accepted=true to record" - + " that this deployment accepts losing acknowledged writes."); + + " +config|get, or make an explicit caller-level durability waiver when" + + " invoking RedisStartupProbe."); } return Integer.parseInt(value.strip()); } diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/ExtensionCommandRunner.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/ExtensionCommandRunner.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/ExtensionCommandRunner.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/ExtensionCommandRunner.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/json/JsonPath.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/json/JsonPath.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/json/JsonPath.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/json/JsonPath.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/json/LettuceRedisJsonOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/json/LettuceRedisJsonOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/json/LettuceRedisJsonOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/json/LettuceRedisJsonOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/json/RedisJsonOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/json/RedisJsonOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/json/RedisJsonOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/json/RedisJsonOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/probabilistic/LettuceRedisProbabilisticOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/probabilistic/LettuceRedisProbabilisticOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/probabilistic/LettuceRedisProbabilisticOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/probabilistic/LettuceRedisProbabilisticOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/probabilistic/RedisProbabilisticOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/probabilistic/RedisProbabilisticOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/probabilistic/RedisProbabilisticOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/probabilistic/RedisProbabilisticOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/LettuceRedisSearchOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/LettuceRedisSearchOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/LettuceRedisSearchOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/LettuceRedisSearchOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/RedisSearchOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/RedisSearchOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/RedisSearchOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/RedisSearchOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchField.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchField.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchField.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchField.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchFieldType.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchFieldType.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchFieldType.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchFieldType.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchHit.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchHit.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchHit.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchHit.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchIndex.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchIndex.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchIndex.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchIndex.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchQuery.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchQuery.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchQuery.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/search/SearchQuery.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/timeseries/LettuceRedisTimeSeriesOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/timeseries/LettuceRedisTimeSeriesOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/timeseries/LettuceRedisTimeSeriesOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/timeseries/LettuceRedisTimeSeriesOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/timeseries/RedisTimeSeriesOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/timeseries/RedisTimeSeriesOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/timeseries/RedisTimeSeriesOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/timeseries/RedisTimeSeriesOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/timeseries/TimeSeriesAggregation.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/timeseries/TimeSeriesAggregation.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/timeseries/TimeSeriesAggregation.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/timeseries/TimeSeriesAggregation.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/timeseries/TimeSeriesSample.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/timeseries/TimeSeriesSample.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/timeseries/TimeSeriesSample.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/extensions/timeseries/TimeSeriesSample.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/ByteArrayCodec.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/ByteArrayCodec.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/ByteArrayCodec.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/ByteArrayCodec.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/DoubleCodec.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/DoubleCodec.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/DoubleCodec.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/DoubleCodec.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/JsonEnvelopeFraming.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/JsonEnvelopeFraming.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/JsonEnvelopeFraming.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/JsonEnvelopeFraming.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/LongCodec.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/LongCodec.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/LongCodec.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/LongCodec.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/RedisCodecRegistry.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/RedisCodecRegistry.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/RedisCodecRegistry.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/RedisCodecRegistry.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/Utf8StringCodec.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/Utf8StringCodec.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/Utf8StringCodec.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/Utf8StringCodec.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/VersionedJsonCodec.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/VersionedJsonCodec.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/VersionedJsonCodec.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/codec/VersionedJsonCodec.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/CommandAdmission.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/CommandAdmission.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/CommandAdmission.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/CommandAdmission.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/CommandExecutionContext.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/CommandExecutionContext.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/CommandExecutionContext.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/CommandExecutionContext.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/CommandPolicyGuard.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/CommandPolicyGuard.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/CommandPolicyGuard.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/CommandPolicyGuard.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/CommandRequest.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/CommandRequest.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/CommandRequest.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/CommandRequest.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/ExecutionCertainty.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/ExecutionCertainty.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/ExecutionCertainty.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/ExecutionCertainty.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/LettuceExceptionTranslator.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/LettuceExceptionTranslator.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/LettuceExceptionTranslator.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/LettuceExceptionTranslator.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/QueueingRedisCommandExecutor.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/QueueingRedisCommandExecutor.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/QueueingRedisCommandExecutor.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/QueueingRedisCommandExecutor.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/ReactiveRedisCommandExecutor.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/ReactiveRedisCommandExecutor.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/ReactiveRedisCommandExecutor.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/ReactiveRedisCommandExecutor.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisCommandCatalog.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisCommandCatalog.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisCommandCatalog.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisCommandCatalog.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisCommandMetadataDiff.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisCommandMetadataDiff.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisCommandMetadataDiff.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisCommandMetadataDiff.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisCommandPolicy.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisCommandPolicy.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisCommandPolicy.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisCommandPolicy.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisCommandPolicyLoader.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisCommandPolicyLoader.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisCommandPolicyLoader.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisCommandPolicyLoader.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisServerCommandMetadata.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisServerCommandMetadata.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisServerCommandMetadata.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/RedisServerCommandMetadata.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/SyncRedisCommandExecutor.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/SyncRedisCommandExecutor.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/SyncRedisCommandExecutor.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/command/SyncRedisCommandExecutor.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisConnectionLease.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisConnectionLease.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisConnectionLease.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisConnectionLease.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisConnectionRegistry.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisConnectionRegistry.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisConnectionRegistry.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/RedisConnectionRegistry.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/SentinelFailoverObserver.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/SentinelFailoverObserver.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/SentinelFailoverObserver.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/connection/SentinelFailoverObserver.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/observability/NoThrowObservationSink.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/observability/NoThrowObservationSink.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/observability/NoThrowObservationSink.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/observability/NoThrowObservationSink.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/observability/RedisObservation.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/observability/RedisObservation.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/observability/RedisObservation.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/observability/RedisObservation.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/AtomicCounterScripts.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/AtomicCounterScripts.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/AtomicCounterScripts.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/AtomicCounterScripts.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/BatchExecution.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/BatchExecution.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/BatchExecution.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/BatchExecution.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/BitmapOperationRequests.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/BitmapOperationRequests.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/BitmapOperationRequests.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/BitmapOperationRequests.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/GeoOperationRequests.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/GeoOperationRequests.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/GeoOperationRequests.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/GeoOperationRequests.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/HashOperationRequests.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/HashOperationRequests.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/HashOperationRequests.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/HashOperationRequests.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/HyperLogLogOperationRequests.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/HyperLogLogOperationRequests.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/HyperLogLogOperationRequests.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/HyperLogLogOperationRequests.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/KeyOperationRequests.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/KeyOperationRequests.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/KeyOperationRequests.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/KeyOperationRequests.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBatchOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBatchOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBatchOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBatchOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBitFieldOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBitFieldOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBitFieldOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBitFieldOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBitmapOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBitmapOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBitmapOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBitmapOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBlockingListOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBlockingListOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBlockingListOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBlockingListOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBlockingStreamOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBlockingStreamOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBlockingStreamOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisBlockingStreamOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisGeoOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisGeoOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisGeoOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisGeoOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisHashFieldExpirationOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisHashFieldExpirationOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisHashFieldExpirationOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisHashFieldExpirationOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisHashOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisHashOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisHashOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisHashOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisHyperLogLogOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisHyperLogLogOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisHyperLogLogOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisHyperLogLogOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisKeyOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisKeyOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisKeyOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisKeyOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisListOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisListOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisListOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisListOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisPubSubOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisPubSubOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisPubSubOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisPubSubOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisSetOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisSetOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisSetOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisSetOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisShardedPubSubOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisShardedPubSubOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisShardedPubSubOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisShardedPubSubOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisSortedSetOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisSortedSetOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisSortedSetOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisSortedSetOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisStreamOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisStreamOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisStreamOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisStreamOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisValueOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisValueOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisValueOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceReactiveRedisValueOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBatch.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBatch.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBatch.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBatch.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBatchOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBatchOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBatchOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBatchOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBitFieldOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBitFieldOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBitFieldOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBitFieldOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBitmapOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBitmapOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBitmapOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBitmapOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBlockingListOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBlockingListOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBlockingListOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBlockingListOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBlockingStreamOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBlockingStreamOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBlockingStreamOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisBlockingStreamOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisGeoOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisGeoOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisGeoOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisGeoOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisHashFieldExpirationOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisHashFieldExpirationOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisHashFieldExpirationOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisHashFieldExpirationOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisHashOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisHashOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisHashOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisHashOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisHyperLogLogOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisHyperLogLogOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisHyperLogLogOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisHyperLogLogOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisKeyOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisKeyOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisKeyOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisKeyOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisListOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisListOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisListOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisListOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisPubSubOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisPubSubOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisPubSubOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisPubSubOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisSetOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisSetOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisSetOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisSetOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisShardedPubSubOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisShardedPubSubOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisShardedPubSubOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisShardedPubSubOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisSortedSetOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisSortedSetOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisSortedSetOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisSortedSetOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisStreamDeletionOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisStreamDeletionOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisStreamDeletionOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisStreamDeletionOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisStreamOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisStreamOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisStreamOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisStreamOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisValueOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisValueOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisValueOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LettuceRedisValueOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/ListOperationRequests.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/ListOperationRequests.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/ListOperationRequests.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/ListOperationRequests.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LiveSubscription.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LiveSubscription.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LiveSubscription.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/LiveSubscription.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/PubSubOperationRequests.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/PubSubOperationRequests.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/PubSubOperationRequests.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/PubSubOperationRequests.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisOperationContext.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisOperationContext.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisOperationContext.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisOperationContext.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisOperationLimits.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisOperationLimits.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisOperationLimits.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/RedisOperationLimits.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/SetOperationRequests.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/SetOperationRequests.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/SetOperationRequests.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/SetOperationRequests.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/SortedSetOperationRequests.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/SortedSetOperationRequests.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/SortedSetOperationRequests.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/SortedSetOperationRequests.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamOperationRequests.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamOperationRequests.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamOperationRequests.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/StreamOperationRequests.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/SubscriptionFlux.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/SubscriptionFlux.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/SubscriptionFlux.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/SubscriptionFlux.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/ValueOperationRequests.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/ValueOperationRequests.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/ValueOperationRequests.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/lettuce/operations/ValueOperationRequests.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/LettuceRedisFunctionOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/LettuceRedisFunctionOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/LettuceRedisFunctionOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/LettuceRedisFunctionOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/LettuceRedisScriptOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/LettuceRedisScriptOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/LettuceRedisScriptOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/LettuceRedisScriptOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/LettuceRedisTransactionOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/LettuceRedisTransactionOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/LettuceRedisTransactionOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/LettuceRedisTransactionOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/QueuedReply.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/QueuedReply.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/QueuedReply.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/QueuedReply.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisArgument.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisArgument.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisArgument.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisArgument.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisFunctionOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisFunctionOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisFunctionOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisFunctionOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisResultDecoder.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisResultDecoder.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisResultDecoder.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisResultDecoder.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisScriptOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisScriptOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisScriptOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisScriptOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisScriptRegistry.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisScriptRegistry.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisScriptRegistry.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisScriptRegistry.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisTransactionCallback.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisTransactionCallback.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisTransactionCallback.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisTransactionCallback.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisTransactionOperations.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisTransactionOperations.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisTransactionOperations.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisTransactionOperations.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisTransactionQueue.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisTransactionQueue.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisTransactionQueue.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisTransactionQueue.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisTransactionRunner.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisTransactionRunner.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisTransactionRunner.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RedisTransactionRunner.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RegisteredRedisFunction.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RegisteredRedisFunction.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RegisteredRedisFunction.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RegisteredRedisFunction.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RegisteredRedisScript.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RegisteredRedisScript.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RegisteredRedisScript.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/RegisteredRedisScript.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/TransactionOptions.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/TransactionOptions.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/TransactionOptions.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/TransactionOptions.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/TransactionResult.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/TransactionResult.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/TransactionResult.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/programmability/TransactionResult.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/ApprovedRawCommand.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/ApprovedRawCommand.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/ApprovedRawCommand.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/ApprovedRawCommand.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/LettuceRedisRawGateway.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/LettuceRedisRawGateway.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/LettuceRedisRawGateway.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/LettuceRedisRawGateway.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RawCommandApprovals.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RawCommandApprovals.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RawCommandApprovals.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RawCommandApprovals.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RawCommandPolicyToken.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RawCommandPolicyToken.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RawCommandPolicyToken.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RawCommandPolicyToken.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RawMovableKeys.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RawMovableKeys.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RawMovableKeys.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RawMovableKeys.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RawReplyDecoder.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RawReplyDecoder.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RawReplyDecoder.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RawReplyDecoder.java diff --git a/src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RedisRawGateway.java b/src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RedisRawGateway.java similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RedisRawGateway.java rename to src/adapter/outbound/redis-sdk/src/main/java/dev/caskeleton/adapter/outbound/cache/redis/sdk/raw/RedisRawGateway.java diff --git a/src/adapter/outbound/cache-redis/src/main/resources/redis-sdk/redis-command-policy.yml b/src/adapter/outbound/redis-sdk/src/main/resources/redis-sdk/redis-command-policy.yml similarity index 100% rename from src/adapter/outbound/cache-redis/src/main/resources/redis-sdk/redis-command-policy.yml rename to src/adapter/outbound/redis-sdk/src/main/resources/redis-sdk/redis-command-policy.yml diff --git a/src/adapter/outbound/support/build.gradle b/src/adapter/outbound/support/build.gradle index b4b7342f..2ef72a78 100644 --- a/src/adapter/outbound/support/build.gradle +++ b/src/adapter/outbound/support/build.gradle @@ -5,6 +5,7 @@ plugins { // Shared base for outbound integration adapters: correlation, fail-open dependency // logging, and the @Configuration seam. Depended on by messaging/cache/notification/httpclient. dependencies { + implementation project(':application-core') implementation 'org.springframework.boot:spring-boot-autoconfigure' implementation 'org.slf4j:slf4j-api' } diff --git a/src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/CapabilityStartupValidationException.java b/src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/CapabilityStartupValidationException.java new file mode 100644 index 00000000..033c4ad2 --- /dev/null +++ b/src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/CapabilityStartupValidationException.java @@ -0,0 +1,30 @@ +package dev.caskeleton.adapter.outbound.support; + +import org.springframework.boot.ExitCodeGenerator; + +/** + * Configuration failure raised by an optional capability before it can start. + * + *

    The type deliberately lives below the composition root so capability-owned auto-configuration + * can fail closed without depending on app-bootstrap. Exit 78 matches the repository's + * configuration-error contract. + */ +public final class CapabilityStartupValidationException extends IllegalStateException + implements ExitCodeGenerator { + + private static final long serialVersionUID = 1L; + private static final int CONFIGURATION_EXIT_CODE = 78; + + public CapabilityStartupValidationException(String message) { + this(message, null); + } + + public CapabilityStartupValidationException(String message, Throwable cause) { + super(message, cause); + } + + @Override + public int getExitCode() { + return CONFIGURATION_EXIT_CODE; + } +} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/EnvironmentSecretSource.java b/src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/EnvironmentSecretSource.java similarity index 59% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/EnvironmentSecretSource.java rename to src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/EnvironmentSecretSource.java index 79f8a2ba..3d28233e 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/EnvironmentSecretSource.java +++ b/src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/EnvironmentSecretSource.java @@ -1,18 +1,17 @@ -package dev.caskeleton.bootstrap.runtime; +package dev.caskeleton.adapter.outbound.support; +import dev.caskeleton.application.outbound.SecretSourcePort; +import java.util.Objects; import java.util.Optional; import org.springframework.core.env.Environment; -/** - * Default {@link SecretSource} ({@link SecretSourceStrategy#ENVIRONMENT}): resolves secrets from - * the Spring {@link Environment}. See README for the design rationale. - */ -public final class EnvironmentSecretSource implements SecretSource { +/** Spring Environment-backed implementation of the application-owned secret source port. */ +public final class EnvironmentSecretSource implements SecretSourcePort { private final Environment environment; public EnvironmentSecretSource(Environment environment) { - this.environment = environment; + this.environment = Objects.requireNonNull(environment, "environment"); } @Override diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/StrictSettingsBinder.java b/src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/StrictSettingsBinder.java similarity index 95% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/StrictSettingsBinder.java rename to src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/StrictSettingsBinder.java index aa9e7be0..385867d3 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/StrictSettingsBinder.java +++ b/src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/StrictSettingsBinder.java @@ -1,6 +1,5 @@ -package dev.caskeleton.bootstrap.autoconfigure; +package dev.caskeleton.adapter.outbound.support; -import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; import java.util.function.Predicate; import org.springframework.boot.context.properties.bind.BindHandler; import org.springframework.boot.context.properties.bind.Bindable; @@ -77,7 +76,7 @@ public final class StrictSettingsBinder { .bind(prefix, Bindable.of(type), strict) .orElseThrow( () -> - StartupFailures.envValidation( + new CapabilityStartupValidationException( prefix + " could not be bound although the capability is enabled")); } } diff --git a/src/adapter/outbound/support/src/test/java/dev/caskeleton/adapter/outbound/support/CapabilityStartupValidationExceptionTest.java b/src/adapter/outbound/support/src/test/java/dev/caskeleton/adapter/outbound/support/CapabilityStartupValidationExceptionTest.java new file mode 100644 index 00000000..dcf51b39 --- /dev/null +++ b/src/adapter/outbound/support/src/test/java/dev/caskeleton/adapter/outbound/support/CapabilityStartupValidationExceptionTest.java @@ -0,0 +1,18 @@ +package dev.caskeleton.adapter.outbound.support; + +import static org.assertj.core.api.Assertions.assertThat; + +import org.junit.jupiter.api.Test; + +class CapabilityStartupValidationExceptionTest { + + @Test + void configurationFailureRetainsIllegalStateCompatibilityAndConfigExitCode() { + CapabilityStartupValidationException failure = + new CapabilityStartupValidationException("invalid capability configuration"); + + assertThat(failure).isInstanceOf(IllegalStateException.class); + assertThat(failure.getExitCode()).isEqualTo(78); + assertThat(failure.getMessage()).isEqualTo("invalid capability configuration"); + } +} diff --git a/src/adapter/outbound/support/src/test/java/dev/caskeleton/adapter/outbound/support/EnvironmentSecretSourceTest.java b/src/adapter/outbound/support/src/test/java/dev/caskeleton/adapter/outbound/support/EnvironmentSecretSourceTest.java new file mode 100644 index 00000000..897c5e51 --- /dev/null +++ b/src/adapter/outbound/support/src/test/java/dev/caskeleton/adapter/outbound/support/EnvironmentSecretSourceTest.java @@ -0,0 +1,27 @@ +package dev.caskeleton.adapter.outbound.support; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.application.outbound.SecretSourcePort; +import org.junit.jupiter.api.Test; +import org.springframework.mock.env.MockEnvironment; + +class EnvironmentSecretSourceTest { + + @Test + void resolvesAPresentSecret() { + MockEnvironment environment = new MockEnvironment().withProperty("APP_X", "value"); + SecretSourcePort source = new EnvironmentSecretSource(environment); + + assertThat(source.resolve("APP_X")).contains("value"); + } + + @Test + void absentAndBlankValuesAreBothUnavailable() { + MockEnvironment environment = new MockEnvironment().withProperty("APP_BLANK", " "); + SecretSourcePort source = new EnvironmentSecretSource(environment); + + assertThat(source.resolve("APP_MISSING")).as("absent -> empty").isEmpty(); + assertThat(source.resolve("APP_BLANK")).as("blank -> empty").isEmpty(); + } +} diff --git a/src/app-bootstrap/CLAUDE.md b/src/app-bootstrap/CLAUDE.md index 92e4c7b5..14912f03 100644 --- a/src/app-bootstrap/CLAUDE.md +++ b/src/app-bootstrap/CLAUDE.md @@ -77,8 +77,14 @@ different answers for the same question. - A capability that needs more than one configuration gets a root class holding the master switch, `@EnableConfigurationProperties`, and an `@Import` of the per-concern classes. Scan nothing: `@Import` from a gated root is what keeps the master switch load-bearing rather than advisory. - `autoconfigure/redis/RedisCapabilityConfig` and `notification/NotificationRootAutoConfiguration` - are the two worked examples. + `autoconfigure/redis/RedisCapabilityConfig` is the bootstrap-owned example. Optional adapter + capabilities that own reusable Spring composition publish their own root instead. Notification + uses `adapter:outbound:notification`'s `NotificationPlatformAutoConfiguration`; JPA uses the + package-private `PersistenceJpaAutoConfiguration` plus `PersistenceJpaRuntimeConfig` from + `adapter:outbound:persistence-jpa`. `autoconfigure/jpa/` therefore contains only application + startup/deployment policy layered over that leaf runtime — migration sequencing, resolved + datasource validation, OSIV/DDL safety, and the management view. + Mongo follows the same rule: the persistence-mongo leaf owns MongoRootAutoConfiguration and its internal health bridge; bootstrap owns no Mongo-specific production health configuration. - Shared helpers of a split capability get their own type named for what they are, not a `*Util` bucket — `autoconfigure/redis/RedisKeys` is the reference. diff --git a/src/app-bootstrap/README.md b/src/app-bootstrap/README.md index be9311ee..5f40e57d 100644 --- a/src/app-bootstrap/README.md +++ b/src/app-bootstrap/README.md @@ -12,7 +12,7 @@ SSOT 는 [CLAUDE.md](CLAUDE.md) 다. 같은 runtime membership 목록을 다시 저장하지 않는다. `verifyRuntimeModuleRegistry`가 resolved `runtimeClasspath`에 registry 밖 project가 침투하지 않았는지만 검증한다. -`conditionalTransportTest`는 GraphQL/gRPC/WebSocket 세 leaf를 test-only classpath에서 함께 resolve하는 +`conditionalTransportBuildContractTest`는 GraphQL/gRPC/WebSocket 세 leaf를 test-only classpath에서 함께 resolve하는 qualification composition이다. 현재 GraphQL은 app-bootstrap의 실제 dependency이고 master switch로 활성화되며, gRPC/WebSocket은 production dependency가 아니다. optional leaf를 실제 app에 채택하려면 `app-bootstrap/build.gradle`의 dependency, architecture의 `allowed_dependencies`, typed settings/보안 @@ -279,11 +279,11 @@ refresh 완료 전에 실패시킨다. throw 하여 context 가 시작을 거부한다. - **prod 안전 토글은 잘못 켜져 있으면 PROFILE_MISMATCH(exit 71)로 죽인다.** prod 프로파일에서 내부 상세 노출/요청 본문 캡처 토글이 켜져 있으면 구조화된 startup-failure 로그와 함께 부팅을 중단한다. -- **multi-instance 가 켜지면 조율 bean 이 모두 존재해야 한다.** `APP_MULTI_INSTANCE_ENABLED=true`일 - 때 `REQUIRED_MULTI_INSTANCE_BEANS`(distributed lock / cache stampede protection / outbox leader - election / distributed rate limiter / migration startup job)가 하나라도 빠지면 - REQUIRED_ADAPTER_DISABLED(exit 72)로 실패시킨다. 이 bean 들은 각각 다른 브랜치가 소유하고, 이 - 검증기는 존재 여부만 단언한다. +- **multi-instance 가 켜지면 실제 cross-instance lock provider가 조립되어 있어야 한다.** + `APP_MULTI_INSTANCE_ENABLED=true`일 때 `distributedLockProvider`가 없거나 + `DistributedLockPort` 타입이 아니면 REQUIRED_ADAPTER_DISABLED(exit 72)로 실패시킨다. cache refresh + coordination은 optional efficiency이고, rate-limit/outbox는 각 capability가 켜졌을 때 자기 provider + 계약으로 검증하므로 이 전역 스위치가 사용하지 않는 capability까지 강제로 요구하지 않는다. - **prod 판정은 대소문자 무시다.** `SPRING_PROFILES_ACTIVE=PROD` 오타도 prod-safety 가드를 발동시켜야 하므로 `equalsIgnoreCase`로 비교한다. @@ -421,8 +421,11 @@ refresh 완료 전에 실패시킨다. inProcessDistributedLock`(in-process `DefaultLockRegistry`)이 그대로 선택된다.** 이 경로는 의도적 으로 계측하지 않는다 — `lock.acquisition` 카운터는 인스턴스 간 분산 조율을 관측할 때만 의미가 있고, JVM 안의 단순 뮤텍스에는 무의미하기 때문이다. -- **빈 이름 `"distributedLockProvider"`는 `StartupSafetyValidator`가 이름으로 조회해 검증하는 - 계약이다.** 절대 이름을 바꾸지 말 것. +- **빈 이름 `"distributedLockProvider"`는 `StartupSafetyValidator`가 이름과 + `DistributedLockPort` 타입을 함께 검증하는 계약이다.** `APP_MULTI_INSTANCE_ENABLED=true`는 이 + cross-instance lock provider를 선택한다. cache refresh / rate-limit / outbox 같은 다른 capability의 + 분산 보장은 각 capability가 켜졌을 때 자기 계약으로 검증하며, 이 스위치가 존재하지 않는 sibling + capability까지 암묵적으로 켜지는 것으로 해석하지 않는다. ### MeteredDistributedLockPort - **`DistributedLockPort`를 감싸는 얇은 Micrometer 데코레이터다.** `tryAcquire` 호출마다 @@ -467,10 +470,10 @@ refresh 완료 전에 실패시킨다. - **`outboxRelayScheduler` 빈은 `ca-skeleton.outbox.relay-enabled`로 게이팅한다(기본 true, `matchIfMissing=true`).** 릴레이를 끄고 싶을 때 빈 자체가 만들어지지 않게 하기 위함. 키가 없으면 켜진 것으로 본다. -- **`outboxLeaderElection` 토큰 빈은 조건 없이(unconditional) 항상 등록한다.** `StartupSafetyValidator` - 가 `APP_MULTI_INSTANCE_ENABLED=true`일 때 이 빈을 반드시 찾을 수 있어야 하기 때문이다. SKIP - LOCKED 는 멀티 인스턴스 여부와 무관하게 언제나 릴레이의 리더십 메커니즘이라, `@ConditionalOnProperty` - 로 끌 수 있게 만들면 단순 조정 기능이 아니라 릴레이 정확성 자체가 깨진다. +- **`outboxLeaderElection` 토큰 빈은 outbox capability 안에서 조건 없이 등록한다.** SKIP LOCKED 는 + 멀티 인스턴스 전역 스위치와 무관하게 outbox relay 자체의 리더십/claim 메커니즘이라, outbox가 켜진 + 상태에서 별도 하위 토글로 끌 수 있게 만들지 않는다. 이 토큰은 outbox 조립의 자기 설명용 marker이지 + `APP_MULTI_INSTANCE_ENABLED`의 전역 필수 빈이 아니다. - **`outboxMetrics` 빈은 `MeterRegistry`가 없을 때 no-op 이다.** Actuator 가 클래스패스에 없는 환경에서도 와이어링이 깨지지 않도록 `ObjectProvider`로 레지스트리를 선택적으로 주입한다. @@ -561,7 +564,7 @@ refresh 완료 전에 실패시킨다. 이하만이라는 정책 때문이다. `INFO` 이하는 확률 `rate`로 보존하고 나머지는 `FilterReply.DENY`로 버린다. - **단일 `rate` 노브로 제어한다.** `APP_LOG_SAMPLING_RATE`(logback `springProperty`)에서 주입되고, - 운영자가 프로파일별로 설정한다(prod `0.1` = INFO 10% 샘플링, staging/dev/local `1.0` = 전부 보존). + 운영자가 런타임별로 설정한다(prod `0.1` = INFO 10% 샘플링, dev/local `1.0` = 전부 보존). 고트래픽 vs 일반 엔드포인트의 더 세밀한 분기는 이 전역 rate 위에 마커 기반 확장으로 문서화만 되어 있고 여기서는 구현하지 않았다. - **검증은 "경고 후 기본값(warn-and-default)" 방식이다.** `rate`가 `[0.0, 1.0]` 범위를 벗어나면 @@ -691,8 +694,8 @@ refresh 완료 전에 실패시킨다. `APP_TRACING_ENABLED` → `enabled`, `APP_TRACING_SAMPLE_RATE` → `sampleRate`, `OTEL_EXPORTER_OTLP_ENDPOINT` → `exporter.otlpEndpoint`. - **`sampleRate`가 blank 이면 숫자 검증을 건너뛴다.** blank 는 "값이 잘못됐다"가 아니라 "프로파일별 - 기본값에 위임하라"는 신호이기 때문이다. 실제 프로파일별 기본값(prod=0.01, staging=0.10, - dev/local=1.0)은 `TracingSampleRateResolver`가 소유하고, resolved 된 값은 + 기본값에 위임하라"는 신호이기 때문이다. 실제 런타임별 기본값(prod=0.01, dev/local=1.0)은 `TracingSampleRateResolver`가 적용하고, + profile vocabulary 자체는 `RuntimeEnvironment`가 소유한다. resolved 된 값은 `TracingSamplingEnvironmentPostProcessor`가 Spring Boot 네이티브 `management.tracing.sampling.probability`로 브리지한다. - **검증은 시작 시 fail-fast 다.** `sampleRate`가 non-blank 인데 [0.0, 1.0] float 이 아니면 시작이 @@ -704,20 +707,19 @@ refresh 완료 전에 실패시킨다. 위한 것이다. ### TracingSampleRateResolver -- **프로파일별 트레이싱 샘플 비율 SSOT 다.** prod=0.01(1%), staging=0.10(10%), dev/local=1.0(100%), - 그 외=1.0. `APP_TRACING_SAMPLE_RATE`가 non-blank 이고 [0,1] float 로 파싱되면 프로파일 기본값을 +- **런타임별 트레이싱 샘플 정책을 적용한다.** prod=0.01(1%), dev/local=1.0(100%)이며, + 런타임 이름의 SSOT는 `RuntimeEnvironment`다. shipped runtime이 아닌 값은 1.0 안전값을 사용한다. `APP_TRACING_SAMPLE_RATE`가 non-blank 이고 [0,1] float 로 파싱되면 프로파일 기본값을 override 한다. - **Spring 의존성이 전혀 없는 순수 Java 로 작성했다.** 어떤 컨텍스트도 없이 단위 테스트할 수 있고, `EnvironmentPostProcessor`(컨텍스트 생성 이전 단계)와 `TracingConfig`(빈 생성 단계) 양쪽에서 동일 로직을 재사용하기 위함이다. ### TracingSamplingRateGauge -- **`tracing.sampling.rate` 게이지를 등록한다.** metric 계약: type=gauge, tag=`profile`(prod/staging/ - dev/local 허용), value=resolved effective sample rate(double in [0.0, 1.0]). -- **오직 active Spring profile 의 시리즈 하나만 방출하므로 cardinality 는 1이다.** tag 는 프로파일 - 이름을 정규화하지 않고 그대로 쓴다. 따라서 비표준 프로파일(예: "qa")로 띄워도 시리즈 하나는 정상 - 방출되고, 단지 4-value allowlist 를 벗어날 뿐이다 — 이는 런타임 에러가 아니라 레지스트리 문서상의 - 관심사다. +- **`tracing.sampling.rate` 게이지를 등록한다.** metric 계약: type=gauge, tag=`profile`(prod/dev/local + 허용), value=resolved effective sample rate(double in [0.0, 1.0]). +- **deployable `RuntimeEnvironment`가 정확히 하나 해석될 때만 시리즈 하나를 방출한다.** + test/profileless/unknown 컨텍스트를 `local`로 가장하지 않으며, shipped app은 그보다 앞선 profile + validator에서 잘못된 런타임 환경을 거부한다. - **`MeterRegistry`를 `ObjectProvider`로 조회하며, Actuator 미탑재로 빈이 없으면 등록을 조용히 건너뛴다.** 이는 `BackgroundJobMetrics` / `OutboxMetrics`의 선례를 그대로 따른다. @@ -780,15 +782,16 @@ refresh 완료 전에 실패시킨다. 책임 밖이라 여기서 중복 강제하지 않는다. ### RuntimeSafetySettings -- **시작 시 `StartupSafetyValidator`가 강제하는 운영 안전 토글이다.** `ca-skeleton.runtime.*` - 바인딩(원천 `APP_ERROR_DETAIL_EXPOSURE_ENABLED`, `APP_LOG_BODY_CAPTURE_ENABLED`, - `APP_MULTI_INSTANCE_ENABLED`, 모두 기본값 `false`). -- **`errorDetailExposureEnabled` / `logBodyCaptureEnabled`는 prod-unsafe 토글이다.** `prod` - 프로파일에서 둘 중 하나라도 켜면 시작이 실패한다. 그래야 내부 에러 상세나 요청 본문 캡처가 - 프로덕션에서 조용히 켜진 채 남는 일이 없다. -- **`multiInstanceEnabled`가 `true`면 인스턴스 조율 capability 빈들(lock / cache-stampede / leader / - rate-limit / migration)이 모두 존재하는지 단언하고, 하나라도 없으면 시작을 실패시킨다.** 멀티 - 인스턴스 모드를 켜놓고 조율 인프라가 빠진 채 기동되는 위험한 상태를 막기 위함이다. +- **시작 시 `StartupSafetyValidator`가 강제하는 운영 안전 설정이다.** 현재 구현된 runtime + contract는 `APP_MULTI_INSTANCE_ENABLED`이며, 활성화 시 cross-instance `DistributedLockPort`가 + 실제로 조립됐는지 검증한다. +- 내부 error detail 노출과 request/response body logging은 shipped 구현이 없으므로 예약 토글도 + 두지 않는다. body 로그 안전성은 `RequestLoggingFilter`가 body를 읽지 않는 계약으로 검증한다. +- **`multiInstanceEnabled`가 `true`면 shipped cross-instance `DistributedLockPort`가 실제로 + 조립됐는지 단언하고, 없거나 이름만 맞춘 잘못된 타입이면 시작을 실패시킨다.** 이 스위치는 JPA-backed + distributed lock 선택자다. cache refresh coordination은 optional efficiency이고, rate-limit/outbox는 + 각 capability의 활성화 계약이 자기 분산 보장을 검증하므로 여기서 사용하지 않는 기능까지 강제로 + 요구하지 않는다. --- @@ -829,7 +832,7 @@ app-bootstrap 은 합성 루트라 "왜 이 의존성이, 왜 이 scope 로" 결 JPA/Hikari 가 compile 경로로 오지 않는다. outbox contract 테스트가 minimal Spring context 를 직접 만들어 이들이 컴파일 시점에 필요하다. - **`spring-integration-jdbc`** — `JdbcLockRegistry`/`DefaultLockRepository`도 rdbms 의 - `implementation`이라 안 샌다. `DistributedLockProviderContractTest`가 같은 Testcontainers PG + `implementation`이라 안 샌다. `PostgreSqlDistributedLockIntegrationTest`가 persistence-jpa Testcontainers PG DataSource 에 대해 독립 registry 두 개(= 두 인스턴스 시뮬레이션)를 직접 만들어 상호배제·리스 만료를 검증한다. 테스트 전용 — production 와이어링은 전부 `DistributedLockPersistenceConfig`(rdbms) 소유. - **`spring-boot-starter-json`** — `JacksonAutoConfiguration`은 jackson-databind 가 test 경로에 있어야 diff --git a/src/app-bootstrap/build.gradle b/src/app-bootstrap/build.gradle index 9ed68a60..133a993a 100644 --- a/src/app-bootstrap/build.gradle +++ b/src/app-bootstrap/build.gradle @@ -38,8 +38,10 @@ auxiliarySourceSets { strictTestLanes { lane('integrationTest') { integration() - description = 'Testcontainers-backed real-PostgreSQL integration contracts.' + description = 'Runs composition-root integration checks against real required providers.' sourceSet = 'integrationTest' + requires 'dev.caskeleton.bootstrap.integration.fileserver.FileserverCompositionIntegrationTest' + requires 'dev.caskeleton.bootstrap.integration.objectstorage.ObjectStorageCompositionIntegrationTest' } lane('architectureTest') { architecture() @@ -60,14 +62,18 @@ strictTestLanes { } } +tasks.named('check') { + dependsOn tasks.named('systemTestLaneCheck') +} + // architectureTest and systemTest compile against test fixtures but intentionally mirror // the ordinary test runtime rather than their compile classpath. `runtimeFrom 'test'` above keeps // testCompileOnly analysis dependencies out of these behavioral lanes. sourceSets { - conditionalTransportTest { - java.srcDir 'src/conditionalTransportTest/java' - resources.srcDir 'src/conditionalTransportTest/resources' + conditionalTransportBuildContractTest { + java.srcDir 'src/conditionalTransportBuildContractTest/java' + resources.srcDir 'src/conditionalTransportBuildContractTest/resources' compileClasspath += sourceSets.main.output runtimeClasspath += sourceSets.main.output } @@ -76,6 +82,8 @@ sourceSets { dependencies { implementation project(':domain-core') implementation project(':application-core') + implementation project(':application-notification') + implementation project(':application-fileserver') implementation project(':adapter:outbound:persistence-jpa') // The JPA rule pack, for the production architecture suite. Test scope only: the rules are @@ -108,6 +116,7 @@ dependencies { // MessagingMembershipQualificationTest holds that distinction so it cannot be forgotten. implementation project(':messaging:messaging-spring-boot-starter') implementation project(':adapter:outbound:cache-redis') + implementation project(':adapter:outbound:redis-runtime') implementation project(':adapter:outbound:notification') implementation project(':adapter:outbound:fileserver') implementation project(':adapter:outbound:httpclient') @@ -145,6 +154,7 @@ dependencies { implementation 'org.springframework.boot:spring-boot-starter-security' // test-only: ArchUnit needs actuator types to verify the health-shape guardrail. See README. + testImplementation project(':adapter:outbound:messaging-kafka') testImplementation 'org.springframework.boot:spring-boot-starter-actuator' // test-only: @WithMockUser for the actuator security authorization tests. See README. testImplementation 'org.springframework.security:spring-security-test' @@ -153,6 +163,13 @@ dependencies { // so `:app-bootstrap:test` cannot start a container — the source-set boundary is what enforces // BOOT-014, and a dependency left on the test classpath would let the boundary be crossed back // by a single import. + integrationTestImplementation project(':adapter:outbound:objectstorage') + integrationTestImplementation project(':application-objectstorage') + // objectstorage intentionally imports the AWS SDK BOM only at its own module scope. This + // qualification composition consumes the leaf from a separate source set, so it repeats the + // platform here rather than widening app-bootstrap's production dependency-management surface. + integrationTestImplementation platform("software.amazon.awssdk:bom:${libs.versions.awsSdk.get()}") + integrationTestImplementation 'org.testcontainers:testcontainers' integrationTestImplementation 'org.testcontainers:testcontainers-postgresql' integrationTestImplementation 'org.testcontainers:testcontainers-junit-jupiter' // test-only, compile-only: TestcontainersUsingFixture declares a PostgreSQLContainer *field type* @@ -168,10 +185,6 @@ dependencies { testImplementation 'org.springframework.boot:spring-boot-starter-data-jpa' testImplementation 'com.zaxxer:HikariCP' - // integration-lane-only: JdbcLockRegistry for the distributed-lock contract test (two simulated - // instances). Nothing under src/test imports org.springframework.integration. - integrationTestImplementation 'org.springframework.integration:spring-integration-jdbc' - testImplementation libs.archunit.junit5 // test-only: jackson-databind for the deserialization-policy boundary test. See README. testImplementation 'org.springframework.boot:spring-boot-starter-json' @@ -213,13 +226,13 @@ dependencies { testImplementation 'org.junit.platform:junit-platform-testkit' // Explicit qualification-only composition. These projects remain absent from main // api/implementation/compileOnly/runtimeOnly and therefore from both shipped runtime graphs. - conditionalTransportTestImplementation project(':adapter:inbound:graphql') - conditionalTransportTestImplementation project(':adapter:inbound:grpc') - conditionalTransportTestImplementation project(':adapter:inbound:websocket') - conditionalTransportTestImplementation 'org.junit.jupiter:junit-jupiter' - conditionalTransportTestImplementation 'org.assertj:assertj-core' - conditionalTransportTestImplementation 'org.yaml:snakeyaml' - conditionalTransportTestRuntimeOnly 'org.junit.platform:junit-platform-launcher' + conditionalTransportBuildContractTestImplementation project(':adapter:inbound:graphql') + conditionalTransportBuildContractTestImplementation project(':adapter:inbound:grpc') + conditionalTransportBuildContractTestImplementation project(':adapter:inbound:websocket') + conditionalTransportBuildContractTestImplementation 'org.junit.jupiter:junit-jupiter' + conditionalTransportBuildContractTestImplementation 'org.assertj:assertj-core' + conditionalTransportBuildContractTestImplementation 'org.yaml:snakeyaml' + conditionalTransportBuildContractTestRuntimeOnly 'org.junit.platform:junit-platform-launcher' } def repositoryRootForContractTests = rootProject.projectDir.parentFile.absolutePath @@ -243,10 +256,10 @@ tasks.named('test', Test) { def conditionalTransportCompositionQualification = extensions.getByName('strictQualification').register( - 'conditionalTransportCompositionTest', - sourceSets.conditionalTransportTest, + 'conditionalTransportBuildContractTest', + sourceSets.conditionalTransportBuildContractTest, [ - 'dev.caskeleton.bootstrap.transport.ConditionalTransportCompositionContractTest' + 'dev.caskeleton.bootstrap.transport.ConditionalTransportBuildContractTest' ], 'Proves the explicit test-only GraphQL/gRPC/WebSocket opt-in classpath.' ) diff --git a/src/app-bootstrap/gradle.lockfile b/src/app-bootstrap/gradle.lockfile index 10396e6c..a0a2df18 100644 --- a/src/app-bootstrap/gradle.lockfile +++ b/src/app-bootstrap/gradle.lockfile @@ -2,57 +2,57 @@ # Manual edits can break the build and are not advised. # This file is expected to be part of source control. aopalliance:aopalliance:1.0=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -at.yawk.lz4:lz4-java:1.10.1=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath +at.yawk.lz4:lz4-java:1.10.1=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath biz.aQute.bnd:biz.aQute.bnd.annotation:7.1.0=architectureTestCompileClasspath,compileClasspath,integrationTestCompileClasspath,systemTestCompileClasspath,testCompileClasspath -ch.qos.logback:logback-classic:1.5.38=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -ch.qos.logback:logback-core:1.5.38=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +ch.qos.logback:logback-classic:1.5.38=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +ch.qos.logback:logback-core:1.5.38=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath com.approvaltests:approvaltests-util:31.0.0=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath com.approvaltests:approvaltests:31.0.0=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath com.ethlo.time:itu:1.14.0=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -com.fasterxml.jackson.core:jackson-annotations:2.21=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +com.fasterxml.jackson.core:jackson-annotations:2.21=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath com.fasterxml.jackson.core:jackson-core:2.21.5=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath com.fasterxml.jackson.core:jackson-databind:2.21.5=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath com.fasterxml.jackson.dataformat:jackson-dataformat-yaml:2.21.5=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.21.5=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath com.fasterxml.jackson:jackson-bom:2.21.5=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.fasterxml:classmate:1.7.3=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor +com.fasterxml:classmate:1.7.3=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportBuildContractTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor com.github.docker-java:docker-java-api:3.7.1=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath com.github.docker-java:docker-java-transport-zerodep:3.7.1=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath com.github.docker-java:docker-java-transport:3.7.1=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor -com.github.luben:zstd-jni:1.5.6-10=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath +com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportBuildContractTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor +com.github.luben:zstd-jni:1.5.6-10=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath com.github.spotbugs:spotbugs-annotations:4.10.2=spotbugs com.github.spotbugs:spotbugs:4.10.2=spotbugs com.github.stephenc.jcip:jcip-annotations:1.0-1=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,spotbugs,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.google.android:annotations:4.1.1.4=conditionalTransportTestRuntimeClasspath -com.google.api.grpc:proto-google-common-protos:2.41.0=conditionalTransportTestRuntimeClasspath -com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor -com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor -com.google.auto:auto-common:1.2.2=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor -com.google.code.findbugs:jsr305:3.0.2=checkstyle,conditionalTransportTestRuntimeClasspath,spotbugs -com.google.code.gson:gson:2.13.2=architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestRuntimeClasspath,spotbugs,systemTestRuntimeClasspath,testRuntimeClasspath -com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor +com.google.android:annotations:4.1.1.4=conditionalTransportBuildContractTestRuntimeClasspath +com.google.api.grpc:proto-google-common-protos:2.41.0=conditionalTransportBuildContractTestRuntimeClasspath +com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportBuildContractTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor +com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportBuildContractTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor +com.google.auto:auto-common:1.2.2=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportBuildContractTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor +com.google.code.findbugs:jsr305:3.0.2=checkstyle,conditionalTransportBuildContractTestRuntimeClasspath,spotbugs +com.google.code.gson:gson:2.13.2=architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestRuntimeClasspath,spotbugs,systemTestRuntimeClasspath,testRuntimeClasspath +com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportBuildContractTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor com.google.errorprone:error_prone_annotations:2.38.0=architectureTestCompileClasspath,compileClasspath,integrationTestCompileClasspath,systemTestCompileClasspath,testCompileClasspath -com.google.errorprone:error_prone_annotations:2.41.0=architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestRuntimeClasspath,spotbugs,systemTestRuntimeClasspath,testRuntimeClasspath +com.google.errorprone:error_prone_annotations:2.41.0=architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestRuntimeClasspath,spotbugs,systemTestRuntimeClasspath,testRuntimeClasspath com.google.errorprone:error_prone_annotations:2.47.0=checkstyle -com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor -com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor -com.google.guava:failureaccess:1.0.2=conditionalTransportTestRuntimeClasspath -com.google.guava:failureaccess:1.0.3=annotationProcessor,architectureTestAnnotationProcessor,checkstyle,conditionalTransportTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor -com.google.guava:guava:33.2.1-jre=conditionalTransportTestRuntimeClasspath -com.google.guava:guava:33.5.0-jre=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportBuildContractTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportBuildContractTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportBuildContractTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor +com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportBuildContractTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor +com.google.guava:failureaccess:1.0.2=conditionalTransportBuildContractTestRuntimeClasspath +com.google.guava:failureaccess:1.0.3=annotationProcessor,architectureTestAnnotationProcessor,checkstyle,conditionalTransportBuildContractTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor +com.google.guava:guava:33.2.1-jre=conditionalTransportBuildContractTestRuntimeClasspath +com.google.guava:guava:33.5.0-jre=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportBuildContractTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor com.google.guava:guava:33.6.0-jre=checkstyle -com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,architectureTestAnnotationProcessor,checkstyle,conditionalTransportTestAnnotationProcessor,conditionalTransportTestRuntimeClasspath,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor -com.google.j2objc:j2objc-annotations:2.8=conditionalTransportTestRuntimeClasspath -com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,architectureTestAnnotationProcessor,checkstyle,conditionalTransportTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor -com.google.protobuf:protobuf-java-util:3.25.5=conditionalTransportTestRuntimeClasspath -com.google.protobuf:protobuf-java:3.25.5=conditionalTransportTestRuntimeClasspath -com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor -com.graphql-java:graphql-java:25.0=architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -com.graphql-java:java-dataloader:6.0.0=architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath +com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,architectureTestAnnotationProcessor,checkstyle,conditionalTransportBuildContractTestAnnotationProcessor,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor +com.google.j2objc:j2objc-annotations:2.8=conditionalTransportBuildContractTestRuntimeClasspath +com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,architectureTestAnnotationProcessor,checkstyle,conditionalTransportBuildContractTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor +com.google.protobuf:protobuf-java-util:3.25.5=conditionalTransportBuildContractTestRuntimeClasspath +com.google.protobuf:protobuf-java:3.25.5=conditionalTransportBuildContractTestRuntimeClasspath +com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportBuildContractTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor +com.graphql-java:graphql-java:25.0=architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath +com.graphql-java:java-dataloader:6.0.0=architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath com.h2database:h2:2.4.240=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins com.jayway.jsonpath:json-path:2.10.0=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath @@ -62,7 +62,6 @@ com.nimbusds:lang-tag:1.7=architectureTestCompileClasspath,architectureTestRunti com.nimbusds:nimbus-jose-jwt:10.4=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath com.nimbusds:oauth2-oidc-sdk:11.26.1=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath com.puppycrawl.tools:checkstyle:13.5.0=checkstyle -com.rabbitmq:amqp-client:5.27.1=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath com.squareup.okhttp3:okhttp-jvm:5.2.1=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath com.squareup.okhttp3:okhttp:5.2.1=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath com.squareup.okio:okio-jvm:3.16.1=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath @@ -80,14 +79,14 @@ commons-codec:commons-codec:1.19.0=architectureTestCompileClasspath,architecture commons-collections:commons-collections:3.2.2=checkstyle commons-io:commons-io:2.20.0=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath commons-io:commons-io:2.21.0=spotbugs -commons-logging:commons-logging:1.3.6=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +commons-logging:commons-logging:1.3.6=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath eu.rekawek.toxiproxy:toxiproxy-java:2.1.11=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath info.picocli:picocli:4.7.7=checkstyle io.cloudevents:cloudevents-api:4.0.1=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath io.cloudevents:cloudevents-core:4.0.1=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath io.github.cdimascio:dotenv-java:3.0.0=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor -io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor +io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportBuildContractTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor +io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportBuildContractTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor io.github.resilience4j:resilience4j-bulkhead:2.2.0=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath io.github.resilience4j:resilience4j-circuitbreaker:2.2.0=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath io.github.resilience4j:resilience4j-core:2.2.0=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath @@ -95,21 +94,21 @@ io.github.resilience4j:resilience4j-micrometer:2.2.0=architectureTestRuntimeClas io.github.resilience4j:resilience4j-ratelimiter:2.2.0=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath io.github.resilience4j:resilience4j-retry:2.2.0=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath io.github.resilience4j:resilience4j-timelimiter:2.2.0=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -io.grpc:grpc-api:1.68.1=conditionalTransportTestRuntimeClasspath -io.grpc:grpc-context:1.68.1=conditionalTransportTestRuntimeClasspath -io.grpc:grpc-core:1.68.1=conditionalTransportTestRuntimeClasspath -io.grpc:grpc-netty-shaded:1.68.1=conditionalTransportTestRuntimeClasspath -io.grpc:grpc-protobuf-lite:1.68.1=conditionalTransportTestRuntimeClasspath -io.grpc:grpc-protobuf:1.68.1=conditionalTransportTestRuntimeClasspath -io.grpc:grpc-services:1.68.1=conditionalTransportTestRuntimeClasspath -io.grpc:grpc-stub:1.68.1=conditionalTransportTestRuntimeClasspath -io.grpc:grpc-util:1.68.1=conditionalTransportTestRuntimeClasspath +io.grpc:grpc-api:1.68.1=conditionalTransportBuildContractTestRuntimeClasspath +io.grpc:grpc-context:1.68.1=conditionalTransportBuildContractTestRuntimeClasspath +io.grpc:grpc-core:1.68.1=conditionalTransportBuildContractTestRuntimeClasspath +io.grpc:grpc-netty-shaded:1.68.1=conditionalTransportBuildContractTestRuntimeClasspath +io.grpc:grpc-protobuf-lite:1.68.1=conditionalTransportBuildContractTestRuntimeClasspath +io.grpc:grpc-protobuf:1.68.1=conditionalTransportBuildContractTestRuntimeClasspath +io.grpc:grpc-services:1.68.1=conditionalTransportBuildContractTestRuntimeClasspath +io.grpc:grpc-stub:1.68.1=conditionalTransportBuildContractTestRuntimeClasspath +io.grpc:grpc-util:1.68.1=conditionalTransportBuildContractTestRuntimeClasspath io.lettuce:lettuce-core:6.8.2.RELEASE=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -io.micrometer:context-propagation:1.2.1=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -io.micrometer:micrometer-commons:1.16.7=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +io.micrometer:context-propagation:1.2.1=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +io.micrometer:micrometer-commons:1.16.7=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath io.micrometer:micrometer-core:1.16.7=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath io.micrometer:micrometer-jakarta9:1.16.7=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -io.micrometer:micrometer-observation:1.16.7=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +io.micrometer:micrometer-observation:1.16.7=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath io.micrometer:micrometer-registry-prometheus:1.16.7=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath io.micrometer:micrometer-tracing-bridge-otel:1.6.7=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath io.micrometer:micrometer-tracing:1.6.7=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath @@ -121,11 +120,11 @@ io.netty:netty-codec-dns:4.2.17.Final=architectureTestRuntimeClasspath,integrati io.netty:netty-codec-http2:4.2.17.Final=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath io.netty:netty-codec-http3:4.2.17.Final=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath io.netty:netty-codec-http:4.2.17.Final=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -io.netty:netty-codec-marshalling:4.2.17.Final=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath +io.netty:netty-codec-marshalling:4.2.17.Final=integrationTestRuntimeClasspath io.netty:netty-codec-native-quic:4.2.17.Final=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -io.netty:netty-codec-protobuf:4.2.17.Final=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath +io.netty:netty-codec-protobuf:4.2.17.Final=integrationTestRuntimeClasspath io.netty:netty-codec-socks:4.2.17.Final=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -io.netty:netty-codec:4.2.17.Final=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath +io.netty:netty-codec:4.2.17.Final=integrationTestRuntimeClasspath io.netty:netty-common:4.2.17.Final=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath io.netty:netty-handler-proxy:4.2.17.Final=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath io.netty:netty-handler:4.2.17.Final=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath @@ -152,10 +151,10 @@ io.opentelemetry:opentelemetry-sdk-logs:1.55.0=architectureTestCompileClasspath, io.opentelemetry:opentelemetry-sdk-metrics:1.55.0=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath io.opentelemetry:opentelemetry-sdk-trace:1.55.0=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath io.opentelemetry:opentelemetry-sdk:1.55.0=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -io.perfmark:perfmark-api:0.27.0=conditionalTransportTestRuntimeClasspath +io.perfmark:perfmark-api:0.27.0=conditionalTransportBuildContractTestRuntimeClasspath io.projectreactor.netty:reactor-netty-core:1.3.7=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath io.projectreactor.netty:reactor-netty-http:1.3.7=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -io.projectreactor:reactor-core:3.8.7=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +io.projectreactor:reactor-core:3.8.7=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath io.prometheus:prometheus-metrics-config:1.4.3=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath io.prometheus:prometheus-metrics-core:1.4.3=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath io.prometheus:prometheus-metrics-exposition-formats:1.4.3=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath @@ -167,21 +166,21 @@ io.swagger.core.v3:swagger-annotations-jakarta:2.2.38=architectureTestRuntimeCla io.swagger.core.v3:swagger-core-jakarta:2.2.38=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath io.swagger.core.v3:swagger-models-jakarta:2.2.38=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath jakarta.activation:jakarta.activation-api:2.1.4=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -jakarta.annotation:jakarta.annotation-api:3.0.0=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +jakarta.annotation:jakarta.annotation-api:3.0.0=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath jakarta.inject:jakarta.inject-api:2.0.1=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath jakarta.mail:jakarta.mail-api:2.1.5=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath jakarta.persistence:jakarta.persistence-api:3.2.0=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath jakarta.servlet:jakarta.servlet-api:6.1.0=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath jakarta.transaction:jakarta.transaction-api:2.0.1=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -jakarta.validation:jakarta.validation-api:3.1.1=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +jakarta.validation:jakarta.validation-api:3.1.1=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath jakarta.websocket:jakarta.websocket-api:2.2.0=architectureTestCompileClasspath,integrationTestCompileClasspath,systemTestCompileClasspath,testCompileClasspath jakarta.ws.rs:jakarta.ws.rs-api:4.0.0=architectureTestCompileClasspath,integrationTestCompileClasspath,systemTestCompileClasspath,testCompileClasspath jakarta.xml.bind:jakarta.xml.bind-api:4.0.5=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -javax.inject:javax.inject:1=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor +javax.inject:javax.inject:1=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportBuildContractTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor jaxen:jaxen:2.0.6=spotbugs me.paulschwarz:spring-dotenv:4.0.0=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath net.bytebuddy:byte-buddy-agent:1.17.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.bytebuddy:byte-buddy:1.17.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestCompileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +net.bytebuddy:byte-buddy:1.17.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestCompileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath net.java.dev.jna:jna:5.18.1=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath net.logstash.logback:logstash-logback-encoder:8.0=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath net.minidev:accessors-smart:2.6.0=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath @@ -199,28 +198,28 @@ org.apache.groovy:groovy:5.0.8=architectureTestCompileClasspath,integrationTestC org.apache.httpcomponents.client5:httpclient5:5.5.2=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.apache.httpcomponents.core5:httpcore5-h2:5.3.6=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.apache.httpcomponents.core5:httpcore5:5.3.6=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.apache.httpcomponents:httpclient:4.5.13=checkstyle -org.apache.httpcomponents:httpcore:4.4.16=checkstyle -org.apache.kafka:kafka-clients:4.1.2=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.apache.logging.log4j:log4j-api:2.25.5=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,spotbugs,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.apache.httpcomponents:httpclient:4.5.13=checkstyle,integrationTestRuntimeClasspath +org.apache.httpcomponents:httpcore:4.4.16=checkstyle,integrationTestRuntimeClasspath +org.apache.kafka:kafka-clients:4.1.2=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath +org.apache.logging.log4j:log4j-api:2.25.5=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,spotbugs,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.apache.logging.log4j:log4j-core:2.25.5=spotbugs -org.apache.logging.log4j:log4j-to-slf4j:2.25.5=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.apache.logging.log4j:log4j-to-slf4j:2.25.5=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.apache.maven.doxia:doxia-core:1.12.0=checkstyle org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle -org.apache.tomcat.embed:tomcat-embed-core:11.0.24=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.apache.tomcat.embed:tomcat-embed-el:11.0.24=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.apache.tomcat.embed:tomcat-embed-websocket:11.0.24=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.apache.tomcat.embed:tomcat-embed-core:11.0.24=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.apache.tomcat.embed:tomcat-embed-el:11.0.24=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.apache.tomcat.embed:tomcat-embed-websocket:11.0.24=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.apache.xbean:xbean-reflect:3.7=checkstyle -org.apiguardian:apiguardian-api:1.1.2=architectureTestCompileClasspath,conditionalTransportTestCompileClasspath,integrationTestCompileClasspath,systemTestCompileClasspath,testCompileClasspath +org.apiguardian:apiguardian-api:1.1.2=architectureTestCompileClasspath,conditionalTransportBuildContractTestCompileClasspath,integrationTestCompileClasspath,systemTestCompileClasspath,testCompileClasspath org.aspectj:aspectjweaver:1.9.25.1=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.assertj:assertj-core:3.27.7=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestCompileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.assertj:assertj-core:3.27.7=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestCompileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.attoparser:attoparser:2.0.7.RELEASE=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.awaitility:awaitility:4.3.0=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.checkerframework:checker-qual:3.42.0=conditionalTransportTestRuntimeClasspath +org.checkerframework:checker-qual:3.42.0=conditionalTransportBuildContractTestRuntimeClasspath org.checkerframework:checker-qual:3.55.1=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.codehaus.mojo:animal-sniffer-annotations:1.24=conditionalTransportTestRuntimeClasspath +org.codehaus.mojo:animal-sniffer-annotations:1.24=conditionalTransportBuildContractTestRuntimeClasspath org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle org.codehaus.plexus:plexus-component-annotations:2.1.0=checkstyle org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle @@ -228,13 +227,6 @@ org.codehaus.plexus:plexus-utils:3.3.0=checkstyle org.dom4j:dom4j:2.2.0=spotbugs org.eclipse.angus:angus-activation:2.0.3=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.eclipse.angus:angus-mail:2.0.5=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.eclipse.jetty.compression:jetty-compression-common:12.1.12=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.eclipse.jetty.compression:jetty-compression-gzip:12.1.12=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.eclipse.jetty:jetty-alpn-client:12.1.12=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.eclipse.jetty:jetty-client:12.1.12=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.eclipse.jetty:jetty-http:12.1.12=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.eclipse.jetty:jetty-io:12.1.12=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.eclipse.jetty:jetty-util:12.1.12=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.flywaydb:flyway-core:11.14.1=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.flywaydb:flyway-database-postgresql:11.14.1=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.glassfish.jaxb:jaxb-core:4.0.9=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath @@ -245,23 +237,23 @@ org.hdrhistogram:HdrHistogram:2.2.2=architectureTestRuntimeClasspath,integration org.hibernate.models:hibernate-models:1.0.1=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.hibernate.orm:hibernate-core:7.2.24.Final=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.hibernate.orm:hibernate-envers:7.2.24.Final=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.hibernate.validator:hibernate-validator:9.0.1.Final=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.hibernate.validator:hibernate-validator:9.0.1.Final=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.javassist:javassist:3.28.0-GA=checkstyle org.javassist:javassist:3.29.0-GA=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.jboss.logging:jboss-logging:3.6.3.Final=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.jboss.logging:jboss-logging:3.6.3.Final=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.jetbrains.kotlin:kotlin-stdlib:2.2.21=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.jetbrains:annotations:13.0=productionRuntimeClasspath,runtimeClasspath org.jetbrains:annotations:17.0.0=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.jspecify:jspecify:1.0.1=annotationProcessor,architectureTestAnnotationProcessor,architectureTestCompileClasspath,architectureTestRuntimeClasspath,checkstyle,compileClasspath,conditionalTransportTestAnnotationProcessor,conditionalTransportTestCompileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestAnnotationProcessor,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestAnnotationProcessor,systemTestCompileClasspath,systemTestRuntimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-api:6.0.3=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestCompileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-engine:6.0.3=architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestRuntimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-params:6.0.3=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestCompileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter:6.0.3=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestCompileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-commons:6.0.3=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestCompileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-engine:6.0.3=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-launcher:6.0.3=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.jspecify:jspecify:1.0.1=annotationProcessor,architectureTestAnnotationProcessor,architectureTestCompileClasspath,architectureTestRuntimeClasspath,checkstyle,compileClasspath,conditionalTransportBuildContractTestAnnotationProcessor,conditionalTransportBuildContractTestCompileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestAnnotationProcessor,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestAnnotationProcessor,systemTestCompileClasspath,systemTestRuntimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-api:6.0.3=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestCompileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-engine:6.0.3=architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestRuntimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-params:6.0.3=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestCompileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter:6.0.3=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestCompileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-commons:6.0.3=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestCompileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-engine:6.0.3=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-launcher:6.0.3=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.junit.platform:junit-platform-testkit:6.0.3=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit:junit-bom:6.0.3=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestCompileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit:junit-bom:6.0.3=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestCompileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.junit:junit-bom:6.1.0=spotbugs org.latencyutils:LatencyUtils:2.0.3=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.mockito:mockito-core:5.20.0=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,mockitoAgent,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath @@ -272,7 +264,7 @@ org.mongodb:mongodb-driver-core:5.6.5=architectureTestRuntimeClasspath,integrati org.mongodb:mongodb-driver-sync:5.6.5=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.objenesis:objenesis:3.3=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.openapitools:jackson-databind-nullable:0.2.6=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.opentest4j:opentest4j:1.3.0=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestCompileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.opentest4j:opentest4j:1.3.0=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestCompileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.osgi:org.osgi.annotation.bundle:2.0.0=architectureTestCompileClasspath,compileClasspath,integrationTestCompileClasspath,systemTestCompileClasspath,testCompileClasspath org.osgi:org.osgi.annotation.versioning:1.1.2=architectureTestCompileClasspath,compileClasspath,integrationTestCompileClasspath,systemTestCompileClasspath,testCompileClasspath org.osgi:org.osgi.resource:1.0.0=architectureTestCompileClasspath,compileClasspath,integrationTestCompileClasspath,systemTestCompileClasspath,testCompileClasspath @@ -283,34 +275,32 @@ org.ow2.asm:asm-tree:9.10.1=spotbugs org.ow2.asm:asm-util:9.10.1=spotbugs org.ow2.asm:asm:9.10.1=spotbugs org.ow2.asm:asm:9.7.1=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.pcollections:pcollections:4.0.1=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor +org.pcollections:pcollections:4.0.1=annotationProcessor,architectureTestAnnotationProcessor,conditionalTransportBuildContractTestAnnotationProcessor,integrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor org.postgresql:postgresql:42.7.13=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.reactivestreams:reactive-streams:1.0.4=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.reactivestreams:reactive-streams:1.0.4=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.reflections:reflections:0.10.2=checkstyle org.rnorth.duct-tape:duct-tape:1.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.skyscreamer:jsonassert:1.5.3=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.slf4j:jul-to-slf4j:2.0.18=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.slf4j:slf4j-api:2.0.18=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.slf4j:jul-to-slf4j:2.0.18=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.slf4j:slf4j-api:2.0.18=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j org.slf4j:slf4j-simple:2.0.18=checkstyle org.springdoc:springdoc-openapi-starter-common:3.0.0=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.springdoc:springdoc-openapi-starter-webmvc-api:3.0.0=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.springframework.amqp:spring-amqp:4.0.5=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.springframework.amqp:spring-rabbit:4.0.5=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-actuator-autoconfigure:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-actuator:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-autoconfigure:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-autoconfigure:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-configuration-processor:4.0.8=annotationProcessor org.springframework.boot:spring-boot-data-commons:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-data-jpa-test:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-data-jpa:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-data-mongodb:4.0.8=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-flyway:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-graphql:4.0.8=architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-graphql:4.0.8=architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-health:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-hibernate:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-http-converter:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-jackson:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-http-converter:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-jackson:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-jdbc-test:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-jdbc:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-jpa-test:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath @@ -320,54 +310,53 @@ org.springframework.boot:spring-boot-micrometer-metrics:4.0.8=architectureTestCo org.springframework.boot:spring-boot-micrometer-observation:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-mongodb:4.0.8=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-persistence:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-reactor:4.0.8=architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-reactor:4.0.8=architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-resttestclient:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-security-oauth2-resource-server:4.0.8=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-security:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-servlet:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-servlet:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-sql:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-starter-actuator:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-starter-data-jpa:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-starter-data-mongodb:4.0.8=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-starter-flyway:4.0.8=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-graphql:4.0.8=architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-graphql:4.0.8=architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-starter-jackson-test:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-jackson:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-jackson:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-starter-jdbc:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-starter-json:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-logging:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-logging:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-starter-mail:4.0.8=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-starter-micrometer-metrics:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-starter-mongodb:4.0.8=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-starter-oauth2-resource-server:4.0.8=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-starter-security:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-starter-test:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-tomcat-runtime:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-tomcat:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-validation:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-tomcat-runtime:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-tomcat:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-validation:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-starter-web:4.0.8=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-starter-webmvc-test:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-webmvc:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-websocket:4.0.8=conditionalTransportTestRuntimeClasspath -org.springframework.boot:spring-boot-starter:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-webmvc:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-starter-websocket:4.0.8=conditionalTransportBuildContractTestRuntimeClasspath +org.springframework.boot:spring-boot-starter:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-test-autoconfigure:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-test:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-tomcat:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-tomcat:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-transaction:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-validation:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-web-server:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-validation:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-web-server:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-webmvc-test:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-webmvc:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-websocket:4.0.8=conditionalTransportTestRuntimeClasspath -org.springframework.boot:spring-boot:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-webmvc:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-websocket:4.0.8=conditionalTransportBuildContractTestRuntimeClasspath +org.springframework.boot:spring-boot:4.0.8=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.cloud:spring-cloud-context:4.1.4=architectureTestCompileClasspath,integrationTestCompileClasspath,systemTestCompileClasspath,testCompileClasspath org.springframework.data:spring-data-commons:4.0.7=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.data:spring-data-jpa:4.0.7=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.data:spring-data-mongodb:5.0.7=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.springframework.graphql:spring-graphql:2.0.5=architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.springframework.integration:spring-integration-core:7.0.6=architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.springframework.integration:spring-integration-jdbc:7.0.6=architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.springframework.kafka:spring-kafka:4.0.7=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath +org.springframework.graphql:spring-graphql:2.0.5=architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath +org.springframework.integration:spring-integration-core:7.0.6=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath +org.springframework.integration:spring-integration-jdbc:7.0.6=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.springframework.security:spring-security-config:7.0.7=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.security:spring-security-core:7.0.7=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.security:spring-security-crypto:7.0.7=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath @@ -378,22 +367,22 @@ org.springframework.security:spring-security-oauth2-resource-server:7.0.7=archit org.springframework.security:spring-security-test:7.0.7=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.security:spring-security-web:7.0.7=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.session:spring-session-core:4.0.5=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.springframework:spring-aop:7.0.9=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-aop:7.0.9=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework:spring-aspects:7.0.9=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-beans:7.0.9=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-beans:7.0.9=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework:spring-context-support:7.0.9=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.springframework:spring-context:7.0.9=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-core:7.0.9=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-expression:7.0.9=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-context:7.0.9=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-core:7.0.9=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-expression:7.0.9=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework:spring-jdbc:7.0.9=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-messaging:7.0.9=architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath +org.springframework:spring-messaging:7.0.9=architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.springframework:spring-orm:7.0.9=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework:spring-test:7.0.9=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework:spring-tx:7.0.9=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-web:7.0.9=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-webflux:7.0.9=architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.springframework:spring-webmvc:7.0.9=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-websocket:7.0.9=architectureTestCompileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,systemTestCompileClasspath,testCompileClasspath +org.springframework:spring-web:7.0.9=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-webflux:7.0.9=architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath +org.springframework:spring-webmvc:7.0.9=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-websocket:7.0.9=architectureTestCompileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,systemTestCompileClasspath,testCompileClasspath org.testcontainers:testcontainers-database-commons:2.0.5=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.testcontainers:testcontainers-jdbc:2.0.5=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.testcontainers:testcontainers-junit-jupiter:2.0.5=architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath @@ -402,12 +391,43 @@ org.testcontainers:testcontainers-toxiproxy:2.0.5=architectureTestRuntimeClasspa org.testcontainers:testcontainers:2.0.5=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.thymeleaf:thymeleaf:3.1.5.RELEASE=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.unbescape:unbescape:1.1.6.RELEASE=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -org.xerial.snappy:snappy-java:1.1.10.7=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath +org.xerial.snappy:snappy-java:1.1.10.7=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs org.xmlunit:xmlunit-core:2.10.4=architectureTestCompileClasspath,architectureTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.yaml:snakeyaml:2.5=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportTestCompileClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.yaml:snakeyaml:2.5=architectureTestCompileClasspath,architectureTestRuntimeClasspath,compileClasspath,conditionalTransportBuildContractTestCompileClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath redis.clients.authentication:redis-authx-core:0.1.1-beta2=architectureTestRuntimeClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath -tools.jackson.core:jackson-core:3.1.5=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -tools.jackson.core:jackson-databind:3.1.5=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -tools.jackson:jackson-bom:3.1.5=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +software.amazon.awssdk:annotations:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:apache-client:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:arns:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:auth:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:aws-core:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:aws-query-protocol:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:aws-xml-protocol:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:bom:2.30.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath +software.amazon.awssdk:checksums-spi:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:checksums:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:crt-core:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:endpoints-spi:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:http-auth-aws-eventstream:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:http-auth-aws:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:http-auth-spi:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:http-auth:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:http-client-spi:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:identity-spi:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:json-utils:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:metrics-spi:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:netty-nio-client:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:profiles:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:protocol-core:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:regions:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:retries-spi:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:retries:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:s3:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:sdk-core:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:third-party-jackson-core:2.30.0=integrationTestRuntimeClasspath +software.amazon.awssdk:utils:2.30.0=integrationTestRuntimeClasspath +software.amazon.eventstream:eventstream:1.0.1=integrationTestRuntimeClasspath +tools.jackson.core:jackson-core:3.1.5=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +tools.jackson.core:jackson-databind:3.1.5=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +tools.jackson:jackson-bom:3.1.5=architectureTestCompileClasspath,architectureTestRuntimeClasspath,conditionalTransportBuildContractTestRuntimeClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath empty=developmentOnly,testAndDevelopmentOnly diff --git a/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/ApplicationBoundaryArchitectureTest.java b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/ApplicationBoundaryArchitectureTest.java index db0b306e..c968fc01 100644 --- a/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/ApplicationBoundaryArchitectureTest.java +++ b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/ApplicationBoundaryArchitectureTest.java @@ -780,6 +780,104 @@ class ApplicationBoundaryArchitectureTest { }; } + @ArchTest + static final ArchRule APPLICATION_FILESERVER_TYPES_DO_NOT_OWN_HTTP_TRANSPORT = + classes() + .that() + .resideInAPackage("dev.caskeleton.application.fileserver..") + .should(notOwnFileserverHttpTransportVocabulary()) + .as( + "fileserver application types keep only transport-neutral file/range semantics; " + + "HTTP headers, status, validators and named wire protocols belong to inbound adapters") + .allowEmptyShould(true); + + private static ArchCondition notOwnFileserverHttpTransportVocabulary() { + Set forbiddenTypes = + Set.of( + "ConditionalRequest", + "ConditionalRequestEvaluator", + "DefaultConditionalRequestEvaluator", + "HttpRangeResolver", + "DefaultHttpRangeResolver", + "ContentDispositionFactory", + "DownloadDecision", + "UploadProtocol"); + Set forbiddenFields = + Set.of( + "contentDisposition", + "cacheControl", + "ifMatch", + "ifNoneMatch", + "ifModifiedSince", + "ifUnmodifiedSince", + "ifRange", + "range", + "strongEtag", + "expectedEtag", + "TUS_1_0", + "HTTPBIS_DRAFT12"); + return new ArchCondition<>("not own HTTP-shaped fileserver transport vocabulary") { + @Override + public void check(JavaClass item, ConditionEvents events) { + if (forbiddenTypes.contains(item.getSimpleName())) { + events.add( + SimpleConditionEvent.violated( + item, + item.getName() + + " is HTTP transport policy implemented inside application-core")); + } + item.getFields().stream() + .filter( + field -> + forbiddenFields.contains(field.getName()) + || ("status".equals(field.getName()) + && item.getPackageName().contains(".fileserver.download"))) + .forEach( + field -> + events.add( + SimpleConditionEvent.violated( + field, + item.getName() + + " declares HTTP transport field " + + field.getName() + + "; translate it at the inbound boundary"))); + } + }; + } + + @ArchTest + static final ArchRule APPLICATION_CALLBACK_TYPES_DO_NOT_OWN_RAW_HTTP_TRANSPORT = + classes() + .that() + .resideInAPackage("dev.caskeleton.application.notification.platform..") + .and() + .haveSimpleNameContaining("Callback") + .should(notDeclareCallbackHttpTransportFields()) + .as( + "provider callback URL, HTTP method, headers and content type stop at the adapter " + + "boundary; application callback types receive only verified semantic data") + .allowEmptyShould(true); + + private static ArchCondition notDeclareCallbackHttpTransportFields() { + Set forbidden = Set.of("externalUrl", "httpMethod", "headers", "contentType"); + return new ArchCondition<>("not declare raw provider-callback HTTP transport fields") { + @Override + public void check(JavaClass item, ConditionEvents events) { + item.getFields().stream() + .filter(field -> forbidden.contains(field.getName())) + .forEach( + field -> + events.add( + SimpleConditionEvent.violated( + field, + item.getName() + + " declares transport field " + + field.getName() + + "; raw HTTP belongs to an adapter"))); + } + }; + } + @ArchTest static final ArchRule APPLICATION_METHODS_DO_NOT_ACCEPT_WEB_DTOS = methods() diff --git a/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/ArchRuleDiscoveryContractTest.java b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/ArchRuleDiscoveryContractTest.java index 195d5b49..7c5f3288 100644 --- a/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/ArchRuleDiscoveryContractTest.java +++ b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/ArchRuleDiscoveryContractTest.java @@ -76,8 +76,11 @@ class ArchRuleDiscoveryContractTest { */ private static final List DECLARED_RULES = List.of( + "ACTIVE_PROFILES_ARE_READ_ONLY_BY_THE_SNAPSHOT_BRIDGE", "AGGREGATE_ROOT_SETTERS_ARE_NOT_PUBLIC", "APPLICATION_AND_DOMAIN_DO_NOT_DEPEND_ON_SPRING_SECURITY", + "APPLICATION_CALLBACK_TYPES_DO_NOT_OWN_RAW_HTTP_TRANSPORT", + "APPLICATION_FILESERVER_TYPES_DO_NOT_OWN_HTTP_TRANSPORT", "APPLICATION_DOES_NOT_DEPEND_ON_ADAPTERS_OR_TRANSPORT", "APPLICATION_DOES_NOT_DEPEND_ON_APPLICATION_CONTEXT", "APPLICATION_DOES_NOT_DEPEND_ON_OPTIONAL_ADAPTERS", @@ -99,6 +102,7 @@ class ArchRuleDiscoveryContractTest { "DOMAIN_EVENTS_ARE_TRANSPORT_FREE", "DOMAIN_HAS_NO_LOGGER", "DOMAIN_IS_PURE", + "FILESERVER_CONFIGURATIONS_DECLARE_AT_MOST_EIGHT_BEANS", "EXTERNAL_OUTBOUND_CALLS_REQUIRE_EXTERNAL_OUTBOUND_ALLOWED_CAPABILITY", "IDENTIFIER_ADAPTER_DOES_NOT_DEPEND_ON_OTHER_ADAPTERS_OR_BOOTSTRAP", "INBOUND_ADAPTERS_DEPEND_ON_PORTS_NOT_APPLICATION_SERVICES", diff --git a/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/ArchitectureViolationFixtureTest.java b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/ArchitectureViolationFixtureTest.java index e73a6b63..369966ef 100644 --- a/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/ArchitectureViolationFixtureTest.java +++ b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/ArchitectureViolationFixtureTest.java @@ -34,8 +34,7 @@ import org.junit.jupiter.api.Test; * *

    Without this layer, a rule that silently no-matches in production (e.g. a predicate * referencing a package nothing in the codebase happens to populate) would pass vacuously — exactly - * the regression caught in {@code - * raw/errors/archunit-test-scope-sample-ticket-inclusion-2026-05-28}. + * the regression this violations-as-data fixture layer exists to prevent. * *

    Pattern reference: Spring Modulith's {@code modules.detectViolations().getMessages()} on an * {@code example/ninvalid} fixture package ({@code diff --git a/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/CleanArchitectureRuleSupport.java b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/CleanArchitectureRuleSupport.java index 5c202774..00d7bd9f 100644 --- a/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/CleanArchitectureRuleSupport.java +++ b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/CleanArchitectureRuleSupport.java @@ -2,6 +2,7 @@ package dev.caskeleton.bootstrap.architecture; import com.tngtech.archunit.base.DescribedPredicate; import com.tngtech.archunit.core.domain.JavaClass; +import dev.caskeleton.adapter.inbound.web.testkit.arch.WebControllerPredicates; /** * Predicates and matchers used by more than one of the split architecture suites. @@ -27,20 +28,7 @@ final class CleanArchitectureRuleSupport { * the endpoint an external provider posts to. */ static final DescribedPredicate ARE_CONTROLLERS = - new DescribedPredicate<>("annotated as a Spring controller, or filed as one") { - @Override - public boolean test(JavaClass candidate) { - return candidate.isAnnotatedWith("org.springframework.web.bind.annotation.RestController") - || candidate.isAnnotatedWith("org.springframework.stereotype.Controller") - || candidate.isMetaAnnotatedWith( - "org.springframework.web.bind.annotation.RestController") - // The package stays in the predicate as well as the annotation. A class filed under - // ..controller.. is claiming the role whether or not Spring is currently routing to - // it, and dropping the package would narrow a rule this change exists to widen. - || (candidate.getPackageName().contains(".adapter.inbound.web") - && candidate.getPackageName().contains(".controller")); - } - }; + WebControllerPredicates.ARE_CONTROLLERS; static boolean matches(Object value, String mediaType) { if (value == null) { diff --git a/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/CompositionRootBoundaryArchitectureTest.java b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/CompositionRootBoundaryArchitectureTest.java index 95666fa6..a4ac3204 100644 --- a/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/CompositionRootBoundaryArchitectureTest.java +++ b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/CompositionRootBoundaryArchitectureTest.java @@ -31,10 +31,10 @@ import com.tngtech.archunit.lang.ArchRule; * composition root is a legitimate participant in rather than a consumer of. Extending the rule * there would forbid the composition root from implementing contracts that exist for it. * - *

    Bootstrap-local interfaces are also outside it. {@code EnvironmentSecretSource} implements - * {@code dev.caskeleton.bootstrap.runtime.SecretSource}, a port this leaf declares and owns; a - * strategy over a leaf's own interface is not a misplaced adapter, and an earlier reading that - * counted it as one was simply wrong about where the interface lived. + *

    Secret resolution now follows the same boundary. {@code SecretSourcePort} is application-owned + * and the Spring Environment implementation lives in {@code adapter:outbound:support}; bootstrap + * selects that implementation but does not implement the port. The explicit decorator allowlist + * below is therefore the only production exception to this rule. */ @AnalyzeClasses( packages = "dev.caskeleton.bootstrap", diff --git a/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/DisabledAdapterArchitectureTest.java b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/DisabledAdapterArchitectureTest.java index 8013cb2b..d575b67c 100644 --- a/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/DisabledAdapterArchitectureTest.java +++ b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/DisabledAdapterArchitectureTest.java @@ -3,6 +3,8 @@ package dev.caskeleton.bootstrap.architecture; import static com.tngtech.archunit.lang.syntax.ArchRuleDefinition.methods; import static com.tngtech.archunit.lang.syntax.ArchRuleDefinition.noClasses; +import com.tngtech.archunit.core.domain.Dependency; +import com.tngtech.archunit.core.domain.JavaClass; import com.tngtech.archunit.core.domain.JavaMethod; import com.tngtech.archunit.junit.AnalyzeClasses; import com.tngtech.archunit.junit.ArchTest; @@ -10,13 +12,15 @@ import com.tngtech.archunit.lang.ArchCondition; import com.tngtech.archunit.lang.ArchRule; import com.tngtech.archunit.lang.ConditionEvents; import com.tngtech.archunit.lang.SimpleConditionEvent; +import java.util.HashSet; +import java.util.Set; /** * feature-integration-adapter-templates Layer 2 (D3 / §구현 가이드 §3) — static isolation + gating guard * for the optional integration adapters (Kafka / Redis / Slack / Google Email / Fileserver). Owner: * this branch. * - *

    What this layer statically guarantees, and its documented limit (branch-note L111 / D3 Open + *

    What this layer statically guarantees, and its documented limit (design record L111 / D3 Open * Risk): ArchUnit can prove (1) the application layer never imports an optional adapter package, * and (2) every resource-owning optional-adapter {@code @Bean} is gated by * {@code @ConditionalOnProperty}. Redis's exact resource-free observation and zero-binding registry @@ -33,16 +37,24 @@ import com.tngtech.archunit.lang.SimpleConditionEvent; class DisabledAdapterArchitectureTest { private static final String[] OPTIONAL_ADAPTER_PACKAGES = { - "..adapter.outbound.messaging.kafka..", + "..adapter.outbound.messaging..", "..adapter.outbound.cache.redis..", - "..adapter.outbound.notification.slack..", - "..adapter.outbound.notification.email..", - "..adapter.outbound.fileserver.." + "..adapter.outbound.notification..", + "..adapter.outbound.fileserver..", + "..adapter.outbound.httpclient..", + "..adapter.outbound.mongo..", + "..adapter.outbound.objectstorage..", + "..adapter.outbound.persistence..", + "..adapter.inbound.graphql..", + "..adapter.inbound.websocket..", + "..adapter.inbound.grpc.." }; private static final String BEAN = "org.springframework.context.annotation.Bean"; private static final String CONDITIONAL_ON_PROPERTY = "org.springframework.boot.autoconfigure.condition.ConditionalOnProperty"; + private static final String CONDITIONAL_ON_PROPERTIES = + "org.springframework.boot.autoconfigure.condition.ConditionalOnProperties"; /** * Layer 2 isolation — the application layer must never import an optional adapter package, so a @@ -58,11 +70,11 @@ class DisabledAdapterArchitectureTest { .dependOnClassesThat() .resideInAnyPackage(OPTIONAL_ADAPTER_PACKAGES) .as( - "D3 APPLICATION_DOES_NOT_DEPEND_ON_OPTIONAL_ADAPTERS: the application layer must " - + "not import an optional adapter package " - + "(Kafka/Redis/Slack/Google Email/Fileserver) — " - + "the static half of the disabled-adapter detection. Runtime activity is " - + "delegated to Layer 3 (feature-integration-adapter-templates D3)") + "D3 APPLICATION_DOES_NOT_DEPEND_ON_OPTIONAL_ADAPTERS: the application layer must not" + + " import an optional adapter package" + + " (messaging/cache/notification/fileserver/httpclient/persistence/objectstorage/GraphQL/WebSocket/gRPC)" + + " — the static half of the disabled-adapter detection. Runtime activity is" + + " delegated to Layer 3 (feature-integration-adapter-templates D3)") .allowEmptyShould(true); /** @@ -82,8 +94,9 @@ class DisabledAdapterArchitectureTest { .should(beGatedByAConditionalOnProperty()) .as( "D3 OPTIONAL_ADAPTER_BEANS_ARE_GATED_BY_CONDITIONAL_ON_PROPERTY: every @Bean in an" - + " optional adapter package (Kafka/Redis/Slack/Google Email/Fileserver) must" - + " declare @ConditionalOnProperty(app...enabled) — Layer 1" + + " optional adapter package" + + " (messaging/cache/notification/fileserver/httpclient/persistence/objectstorage/GraphQL/WebSocket/gRPC)" + + " must declare @ConditionalOnProperty(app...enabled) — Layer 1" + " disabled-default must not be bypassable by an ungated bean. ArchUnit reaches" + " the annotation presence only; runtime activation is Layer 3's job" + " (feature-integration-adapter-templates D3, L111)") @@ -98,14 +111,41 @@ class DisabledAdapterArchitectureTest { * be accidentally left ungated. Requiring the annotation on every method instead would push * adapters towards repeating the switch per bean, which is how the copies drift apart. */ + private static boolean isStructurallyGated(JavaClass type, Set visited) { + if (!visited.add(type.getName())) { + return false; + } + if (type.isAnnotatedWith(CONDITIONAL_ON_PROPERTY) + || type.isAnnotatedWith(CONDITIONAL_ON_PROPERTIES)) { + return true; + } + if (type.getEnclosingClass() + .filter(enclosing -> isStructurallyGated(enclosing, visited)) + .isPresent()) { + return true; + } + for (Dependency dependency : type.getDirectDependenciesToSelf()) { + JavaClass origin = dependency.getOriginClass(); + if (!origin.getName().startsWith("dev.caskeleton.")) { + continue; + } + if (isStructurallyGated(origin, new HashSet<>(visited))) { + return true; + } + } + return false; + } + private static ArchCondition beGatedByAConditionalOnProperty() { return new ArchCondition<>( - "be gated by @ConditionalOnProperty on the method or its declaring configuration class") { + "be gated directly or reachable only through a gated production configuration") { @Override public void check(JavaMethod method, ConditionEvents events) { - boolean gatedOnMethod = method.isAnnotatedWith(CONDITIONAL_ON_PROPERTY); - boolean gatedOnClass = method.getOwner().isAnnotatedWith(CONDITIONAL_ON_PROPERTY); - if (gatedOnMethod || gatedOnClass) { + boolean gatedOnMethod = + method.isAnnotatedWith(CONDITIONAL_ON_PROPERTY) + || method.isAnnotatedWith(CONDITIONAL_ON_PROPERTIES); + boolean structurallyGated = isStructurallyGated(method.getOwner(), new HashSet<>()); + if (gatedOnMethod || structurallyGated) { return; } events.add( diff --git a/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/FileserverCompositionArchitectureTest.java b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/FileserverCompositionArchitectureTest.java new file mode 100644 index 00000000..f24066a4 --- /dev/null +++ b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/FileserverCompositionArchitectureTest.java @@ -0,0 +1,52 @@ +package dev.caskeleton.bootstrap.architecture; + +import static com.tngtech.archunit.lang.syntax.ArchRuleDefinition.classes; + +import com.tngtech.archunit.core.domain.JavaClass; +import com.tngtech.archunit.core.domain.JavaMethod; +import com.tngtech.archunit.junit.AnalyzeClasses; +import com.tngtech.archunit.junit.ArchTest; +import com.tngtech.archunit.lang.ArchCondition; +import com.tngtech.archunit.lang.ArchRule; +import com.tngtech.archunit.lang.ConditionEvents; +import com.tngtech.archunit.lang.SimpleConditionEvent; +import org.springframework.context.annotation.Bean; + +/** BOOT-007: Fileserver composition stays split by concern instead of regrowing god configs. */ +@AnalyzeClasses( + packages = "dev.caskeleton.bootstrap.autoconfigure.fileserver", + importOptions = ProductionClassImportOption.class) +class FileserverCompositionArchitectureTest { + + @ArchTest + static final ArchRule FILESERVER_CONFIGURATIONS_DECLARE_AT_MOST_EIGHT_BEANS = + classes() + .that() + .resideInAPackage("dev.caskeleton.bootstrap.autoconfigure.fileserver") + .should(declareAtMostEightBeanMethods()) + .as( + "BOOT-007: one Fileserver composition class declares at most eight @Bean methods; " + + "larger or mixed port families split into package-private concern configs") + .allowEmptyShould(true); + + private static ArchCondition declareAtMostEightBeanMethods() { + return new ArchCondition<>("declare at most eight @Bean methods") { + @Override + public void check(JavaClass item, ConditionEvents events) { + long count = + item.getMethods().stream() + .filter(FileserverCompositionArchitectureTest::isBeanMethod) + .count(); + if (count > 8) { + events.add( + SimpleConditionEvent.violated( + item, item.getFullName() + " declares " + count + " @Bean methods")); + } + } + }; + } + + private static boolean isBeanMethod(JavaMethod method) { + return method.isAnnotatedWith(Bean.class); + } +} diff --git a/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/ForbiddenApiArchitectureTest.java b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/ForbiddenApiArchitectureTest.java index d6226bb6..71fde10c 100644 --- a/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/ForbiddenApiArchitectureTest.java +++ b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/ForbiddenApiArchitectureTest.java @@ -67,7 +67,7 @@ class ForbiddenApiArchitectureTest { // tenancy.shared package of its own and only began tripping this rule when that leaf // joined the composition root's analysis scope. "dev.caskeleton.adapter.outbound.mongo.advanced.tenancy.shared", - // The five master switches and their strict parse. Operational rather than domain: + // The registered master switches and their strict parse. Operational rather than domain: // it names environment keys and rejects unreadable values, and it lives here because // the environment post-processor needs it before a Spring context exists, so it must // not depend on Spring. 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 new file mode 100644 index 00000000..443a96f9 --- /dev/null +++ b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/RuntimeProfileAccessArchitectureTest.java @@ -0,0 +1,32 @@ +package dev.caskeleton.bootstrap.architecture; + +import static com.tngtech.archunit.lang.syntax.ArchRuleDefinition.noClasses; + +import com.tngtech.archunit.junit.AnalyzeClasses; +import com.tngtech.archunit.junit.ArchTest; +import com.tngtech.archunit.lang.ArchRule; +import dev.caskeleton.bootstrap.runtime.RuntimeProfileSnapshot; +import org.springframework.core.env.Environment; + +/** BOOT-002: Spring active-profile extraction has one composition-root owner. */ +@AnalyzeClasses( + packages = "dev.caskeleton.bootstrap", + importOptions = ProductionClassImportOption.class) +class RuntimeProfileAccessArchitectureTest { + + @ArchTest + static final ArchRule ACTIVE_PROFILES_ARE_READ_ONLY_BY_THE_SNAPSHOT_BRIDGE = + noClasses() + .that() + .resideInAPackage("dev.caskeleton.bootstrap..") + .and() + .doNotHaveFullyQualifiedName(RuntimeProfileSnapshot.class.getName()) + .should() + .callMethod(Environment.class, "getActiveProfiles") + .as( + "BOOT-002: app-bootstrap production code must read Spring active profiles through " + + "RuntimeProfileSnapshot; RuntimeEnvironment remains the vocabulary/semantics " + + "SSOT and direct Environment#getActiveProfiles calls re-create profile-policy " + + "drift.") + .allowEmptyShould(true); +} diff --git a/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/StartupFailureContractArchitectureTest.java b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/StartupFailureContractArchitectureTest.java index d8911db9..afeb5af5 100644 --- a/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/StartupFailureContractArchitectureTest.java +++ b/src/app-bootstrap/src/architectureTest/java/dev/caskeleton/bootstrap/architecture/StartupFailureContractArchitectureTest.java @@ -54,14 +54,6 @@ class StartupFailureContractArchitectureTest { private static final String TRACING_SETTINGS = "dev.caskeleton.bootstrap.autoconfigure.tracing.TracingSettings"; - /** - * {@code HttpClientEnvironmentKeys} — an internal invariant. Its unreachable branch says the - * environment-variable template cannot express a list nested three deep; no settings record nests - * that far, and a deployment cannot cause it. - */ - private static final String HTTP_CLIENT_ENVIRONMENT_KEYS = - "dev.caskeleton.bootstrap.autoconfigure.httpclient.HttpClientEnvironmentKeys"; - /** * {@code RedisKeys} — two JCE invariants ("HmacSHA256 must be available", "a Mac must be * cloneable"). A JVM without HmacSHA256 is not a misconfigured deployment. @@ -103,12 +95,7 @@ class StartupFailureContractArchitectureTest { private static final DescribedPredicate ALLOWLISTED = new DescribedPredicate<>("allowlisted from the StartupFailures contract") { private final List prefixes = - List.of( - TRACING_SETTINGS, - HTTP_CLIENT_ENVIRONMENT_KEYS, - REDIS_KEYS, - STARTUP_FAILURES, - STARTUP_FAILURE_EXCEPTION); + List.of(TRACING_SETTINGS, REDIS_KEYS, STARTUP_FAILURES, STARTUP_FAILURE_EXCEPTION); @Override public boolean test(JavaClass candidate) { diff --git a/src/app-bootstrap/src/conditionalTransportTest/java/dev/caskeleton/bootstrap/transport/ConditionalTransportCompositionContractTest.java b/src/app-bootstrap/src/conditionalTransportBuildContractTest/java/dev/caskeleton/bootstrap/transport/ConditionalTransportBuildContractTest.java similarity index 81% rename from src/app-bootstrap/src/conditionalTransportTest/java/dev/caskeleton/bootstrap/transport/ConditionalTransportCompositionContractTest.java rename to src/app-bootstrap/src/conditionalTransportBuildContractTest/java/dev/caskeleton/bootstrap/transport/ConditionalTransportBuildContractTest.java index daec60cf..6b3b8d5f 100644 --- a/src/app-bootstrap/src/conditionalTransportTest/java/dev/caskeleton/bootstrap/transport/ConditionalTransportCompositionContractTest.java +++ b/src/app-bootstrap/src/conditionalTransportBuildContractTest/java/dev/caskeleton/bootstrap/transport/ConditionalTransportBuildContractTest.java @@ -16,7 +16,7 @@ import org.junit.jupiter.api.Test; * shipped deliberately and is controlled by its master switch. Runtime behavior is proven by the * named compose qualification lanes. */ -class ConditionalTransportCompositionContractTest { +class ConditionalTransportBuildContractTest { /** Transports that must not reach any runtime: no membership, and no composition-root edge. */ private static final Map BUILD_ONLY_TRANSPORTS = @@ -60,9 +60,22 @@ class ConditionalTransportCompositionContractTest { assertThat(bootstrapBuild).contains("project(':adapter:inbound:graphql')"); SWITCH_GATED_TRANSPORTS .values() - .forEach(ConditionalTransportCompositionContractTest::assertThatCodeLoads); + .forEach(ConditionalTransportBuildContractTest::assertThatCodeLoads); assertThat(shippedApplicationYaml()).contains("classpath:config/graphql.yml"); - assertThat(shippedGraphQlYaml()).contains("${APP_GRAPHQL_ENABLED:false}"); + assertThat(shippedGraphQlYaml()) + .contains("${APP_GRAPHQL_ENABLED:false}") + .contains("${APP_GRAPHQL_DEPLOYMENT_MODE:}") + .contains("${APP_GRAPHQL_EXECUTION_PROFILE:BLOCKING_MVC}") + .contains("${APP_GRAPHQL_VALIDATION_POLICY_VERSION:v1}") + .contains("${APP_GRAPHQL_OBSERVED_OPERATION_NAMES:}") + .contains("${APP_GRAPHQL_GRAPHIQL_ENABLED:false}") + .contains("${APP_GRAPHQL_INTROSPECTION_ENABLED:false}") + .contains("${APP_GRAPHQL_MAXIMUM_PAGE_SIZE:100}") + .contains("${APP_GRAPHQL_MAXIMUM_COMPLEXITY:10000}") + .contains("${APP_GRAPHQL_PREPARSED_CACHE_ENTRIES:1000}") + .contains("${APP_GRAPHQL_PREPARSED_CACHE_WEIGHT:10000000}") + .contains("${APP_GRAPHQL_PREPARSED_CACHE_EXPIRE_AFTER_ACCESS:30m}") + .doesNotContain("APP_GRAPHQL_CURSOR_KEY_IDS"); } @Test @@ -74,8 +87,8 @@ class ConditionalTransportCompositionContractTest { assertThat(lanes) .as( - "a switch-gated transport's real proof is a running application with the switch off and " - + "the route absent; this file is where those lanes are declared, and they are " + "a switch-gated transport's real proof is a running application with the switch off and" + + " the route absent; this file is where those lanes are declared, and they are " + "blocking") .contains("\"off-local\"") .contains("\"off-dev\"") diff --git a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/DistributedLockProviderContractTest.java b/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/DistributedLockProviderContractTest.java deleted file mode 100644 index d6e5a6bd..00000000 --- a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/DistributedLockProviderContractTest.java +++ /dev/null @@ -1,454 +0,0 @@ -package dev.caskeleton.bootstrap.integration; - -import static org.assertj.core.api.Assertions.assertThat; -import static org.assertj.core.api.Assertions.assertThatCode; -import static org.assertj.core.api.Assertions.assertThatThrownBy; - -import com.zaxxer.hikari.HikariConfig; -import com.zaxxer.hikari.HikariDataSource; -import dev.caskeleton.adapter.outbound.persistence.lock.DistributedLockPersistenceConfig; -import dev.caskeleton.adapter.outbound.persistence.lock.LockRegistryDistributedLockAdapter; -import dev.caskeleton.adapter.outbound.persistence.lock.LockSettings; -import dev.caskeleton.application.lock.DistributedLock; -import dev.caskeleton.application.lock.DistributedLockPort; -import dev.caskeleton.application.lock.LockAcquisitionTimeoutException; -import dev.caskeleton.bootstrap.autoconfigure.lock.DistributedLockConfig; -import dev.caskeleton.bootstrap.autoconfigure.lock.MeteredDistributedLockPort; -import io.micrometer.core.instrument.MeterRegistry; -import io.micrometer.core.instrument.simple.SimpleMeterRegistry; -import java.time.Duration; -import java.util.ConcurrentModificationException; -import java.util.Map; -import javax.sql.DataSource; -import org.flywaydb.core.Flyway; -import org.junit.jupiter.api.AfterAll; -import org.junit.jupiter.api.Assumptions; -import org.junit.jupiter.api.BeforeAll; -import org.junit.jupiter.api.Test; -import org.springframework.beans.factory.ObjectProvider; -import org.springframework.beans.factory.support.DefaultListableBeanFactory; -import org.springframework.boot.context.properties.EnableConfigurationProperties; -import org.springframework.context.annotation.AnnotationConfigApplicationContext; -import org.springframework.context.annotation.Bean; -import org.springframework.context.annotation.Configuration; -import org.springframework.core.env.MapPropertySource; -import org.springframework.integration.jdbc.lock.DefaultLockRepository; -import org.springframework.integration.jdbc.lock.JdbcLockRegistry; -import org.springframework.jdbc.datasource.DataSourceTransactionManager; -import org.testcontainers.DockerClientFactory; -import org.testcontainers.postgresql.PostgreSQLContainer; - -/** - * Testcontainers contract test for {@code distributedLockProvider} bean wiring and distributed-lock - * behavioral guarantees (feature-distributed-lock-contract). - * - *

    Scope

    - * - *
      - *
    • D1 bean presence — with {@code multi-instance-enabled=true}, a bean named {@code - * distributedLockProvider} of type {@link DistributedLockPort} must exist; with the flag - * false/absent, {@code inProcessDistributedLock} exists and {@code distributedLockProvider} - * does NOT. - *
    • D3 mutual exclusion — two independent lock instances over the same container - * DataSource cannot hold the same key simultaneously. - *
    • D5 lease expiry — after the lease TTL elapses, the second instance can acquire a key - * that was held by a crashed first instance. - *
    • D4 release ordering — {@code close()} on the handle releases the lock so a - * subsequent acquire by another instance succeeds. - *
    • SI-LOCK-C5 lease-expiry close() handling — after the lease TTL expires, (a) the raw - * adapter's {@code close()} throws {@link java.util.ConcurrentModificationException}, and (b) - * the {@link MeteredDistributedLockPort} absorbs it and increments {@code lock.lease.expired} - * without re-throwing. - *
    - * - *

    The whole class is guarded by {@link #assumeDockerAvailable()} so it SKIPs (not fails) in - * environments without Docker. The behavioral D3/D5 tests construct two independent {@link - * LockRegistryDistributedLockAdapter} instances directly (two {@link DefaultLockRepository} + - * {@link JdbcLockRegistry} over the SAME DataSource), simulating two application instances without - * Spring context overhead. - * - *

    Note on compile classpath: {@code spring-integration-jdbc} is an {@code implementation} dep of - * {@code adapter-persistence}. Since the D3/D5 tests need to construct SI objects directly, {@code - * spring-integration-jdbc} is added as {@code testImplementation} in {@code - * app-bootstrap/build.gradle}. - */ -class DistributedLockProviderContractTest { - - static final String PG_IMAGE = "postgres:16-alpine"; - - // Shared container — started once for all tests in this class. - static PostgreSQLContainer pg; - static HikariDataSource sharedDataSource; - - @BeforeAll - static void startContainer() { - assumeDockerAvailable(); - pg = PostgreSqlTestContainer.create(PG_IMAGE); - pg.start(); - - sharedDataSource = hikari(pg); - - // Flyway migrates V1 (idempotency), V2 (legacy work_log migration on - // app-bootstrap test classpath), V3 (outbox), V4 (INT_LOCK). - Flyway.configure() - .dataSource(sharedDataSource) - .locations("classpath:db/migration/postgresql") - .load() - .migrate(); - } - - @AfterAll - static void stopContainer() { - if (sharedDataSource != null) { - sharedDataSource.close(); - } - if (pg != null) { - pg.stop(); - } - } - - // ====================================================================== - // D1 — bean presence: multi-instance=true provides distributedLockProvider - // ====================================================================== - - @Test - void d1MultiInstanceTrueProvidesDistributedLockProviderBean() { - try (AnnotationConfigApplicationContext ctx = buildContext(true)) { - assertThat(ctx.containsBean("distributedLockProvider")) - .as("distributedLockProvider bean must exist when multi-instance-enabled=true (D1)") - .isTrue(); - assertThat(ctx.getBean("distributedLockProvider")) - .as("distributedLockProvider must implement DistributedLockPort") - .isInstanceOf(DistributedLockPort.class); - } - } - - @Test - void d1MultiInstanceFalseProvidesInProcessDistributedLockNotDistributedLockProvider() { - try (AnnotationConfigApplicationContext ctx = buildContext(false)) { - assertThat(ctx.containsBean("inProcessDistributedLock")) - .as("inProcessDistributedLock bean must exist when multi-instance-enabled=false") - .isTrue(); - assertThat(ctx.containsBean("distributedLockProvider")) - .as( - "distributedLockProvider must NOT exist when multi-instance-enabled=false (in-process default)") - .isFalse(); - } - } - - // ====================================================================== - // D3 — mutual exclusion: two independent adapters over the same DataSource - // ====================================================================== - - @Test - void d3MutualExclusionSecondAcquireOnSameKeyThrowsTimeout() throws Exception { - // Two independent DefaultLockRepository + JdbcLockRegistry instances over the - // same DataSource simulate two application instances. - Duration ttl = Duration.ofSeconds(30); - DefaultLockRepository repoA = buildRepository(sharedDataSource); - DefaultLockRepository repoB = buildRepository(sharedDataSource); - try { - LockRegistryDistributedLockAdapter adapterA = - new LockRegistryDistributedLockAdapter(new JdbcLockRegistry(repoA, ttl), ttl); - LockRegistryDistributedLockAdapter adapterB = - new LockRegistryDistributedLockAdapter(new JdbcLockRegistry(repoB, ttl), ttl); - - String key = "d3-mutual-exclusion-" + System.nanoTime(); - Duration shortWait = Duration.ofMillis(100); - - // A acquires. - DistributedLock lockA = adapterA.tryAcquire(key, Duration.ofSeconds(1), ttl); - try { - // B must time out while A holds the lock. - assertThatThrownBy(() -> adapterB.tryAcquire(key, shortWait, ttl)) - .as("D3: second instance must not acquire key held by first instance") - .isInstanceOf(LockAcquisitionTimeoutException.class); - } finally { - lockA.close(); - } - - // D4 release ordering: after A releases, B can acquire. - DistributedLock lockB = adapterB.tryAcquire(key, Duration.ofSeconds(1), ttl); - assertThat(lockB) - .as("D4: after close(), another instance must be able to acquire the key") - .isNotNull(); - lockB.close(); - } finally { - repoA.stop(); - repoB.stop(); - } - } - - // ====================================================================== - // D5 — lease expiry: expired row is reclaimed by another instance - // ====================================================================== - - @Test - void d5LeaseExpiryAllowsSecondInstanceToAcquireAfterTtl() throws Exception { - // Short TTL (1 s) so the lease expires quickly. - Duration shortTtl = Duration.ofSeconds(1); - DefaultLockRepository repoA = buildRepository(sharedDataSource); - DefaultLockRepository repoB = buildRepository(sharedDataSource); - try { - LockRegistryDistributedLockAdapter adapterA = - new LockRegistryDistributedLockAdapter(new JdbcLockRegistry(repoA, shortTtl), shortTtl); - LockRegistryDistributedLockAdapter adapterB = - new LockRegistryDistributedLockAdapter(new JdbcLockRegistry(repoB, shortTtl), shortTtl); - - String key = "d5-lease-expiry-" + System.nanoTime(); - - // A acquires and does NOT release (simulating a crash — intentional discard). - @SuppressWarnings("unused") - DistributedLock crashedLockA = adapterA.tryAcquire(key, Duration.ofSeconds(1), shortTtl); - // crashedLockA is intentionally not closed — simulates a JVM crash that never - // calls close(). The TTL is the only mechanism that frees the row. - - // Sleep past the TTL boundary so the lease has elapsed. - Thread.sleep(shortTtl.toMillis() + 500); - - // Bounded poll: try to acquire B until success or the bound is hit. - // Polls up to shortTtl × 4 total, in 200 ms increments, to avoid a single - // post-sleep attempt that is fragile under slow CI environments. - Duration pollBound = shortTtl.multipliedBy(4); - long pollDeadline = System.currentTimeMillis() + pollBound.toMillis(); - DistributedLock lockB = null; - LockAcquisitionTimeoutException lastTimeout = null; - while (lockB == null && System.currentTimeMillis() < pollDeadline) { - try { - lockB = adapterB.tryAcquire(key, Duration.ofMillis(200), shortTtl); - } catch (LockAcquisitionTimeoutException e) { - lastTimeout = e; - Thread.sleep(100); - } - } - if (lockB == null) { - throw new AssertionError( - "D5: adapterB could not acquire key '" - + key - + "' within " - + pollBound - + " after TTL expiry", - lastTimeout); - } - lockB.close(); - } finally { - repoA.stop(); - repoB.stop(); - } - } - - // ====================================================================== - // SI-LOCK-C5 — lease-expiry close() handling - // ====================================================================== - - /** - * (a) Documents the raw SI behavior: after TTL expires, the raw adapter handle's {@code close()} - * throws {@link java.util.ConcurrentModificationException} because the INT_LOCK row was - * reclaimed. - * - *

    This test intentionally verifies the exception the decorator must absorb - * (branch-note §Edge / SI-LOCK-C5). - */ - @Test - void siLockC5RawAdapterCloseThrowsCMEAfterLeaseExpires() throws Exception { - Duration shortTtl = Duration.ofSeconds(1); - DefaultLockRepository repoA = buildRepository(sharedDataSource); - try { - LockRegistryDistributedLockAdapter adapterA = - new LockRegistryDistributedLockAdapter(new JdbcLockRegistry(repoA, shortTtl), shortTtl); - - String key = "c5-raw-cme-" + System.nanoTime(); - DistributedLock handle = adapterA.tryAcquire(key, Duration.ofSeconds(1), shortTtl); - - // Let the lease expire — another instance can reclaim the row. - Thread.sleep(shortTtl.toMillis() + 500); - - // Acquire from a second adapter to reclaim the row (makes CME deterministic). - DefaultLockRepository repoB = buildRepository(sharedDataSource); - try { - LockRegistryDistributedLockAdapter adapterB = - new LockRegistryDistributedLockAdapter(new JdbcLockRegistry(repoB, shortTtl), shortTtl); - // Intentional discard — we only need B to reclaim the row, not track the handle. - @SuppressWarnings("unused") - DistributedLock reclaimHandle = adapterB.tryAcquire(key, Duration.ofSeconds(2), shortTtl); - } finally { - repoB.stop(); - } - - // Now closing A's handle should throw CME (row was reclaimed by B). - assertThatThrownBy(handle::close) - .as( - "SI-LOCK-C5: raw adapter close() must throw ConcurrentModificationException " - + "when the lease expired and the row was reclaimed") - .isInstanceOf(ConcurrentModificationException.class); - } finally { - repoA.stop(); - } - } - - /** - * (b) Verifies the {@link MeteredDistributedLockPort} absorbs the {@link - * java.util.ConcurrentModificationException} from lease expiry: the metered handle's {@code - * close()} does NOT throw, and the {@code lock.lease.expired} counter increments by 1. - */ - @Test - void siLockC5MeteredPortSwallowsCMEAndIncrementsLeaseExpiredCounter() throws Exception { - Duration shortTtl = Duration.ofSeconds(1); - DefaultLockRepository repoA = buildRepository(sharedDataSource); - - SimpleMeterRegistry meterRegistry = new SimpleMeterRegistry(); - LockRegistryDistributedLockAdapter rawAdapter = - new LockRegistryDistributedLockAdapter(new JdbcLockRegistry(repoA, shortTtl), shortTtl); - MeteredDistributedLockPort meteredPort = - new MeteredDistributedLockPort(rawAdapter, providerOf(meterRegistry)); - - try { - String key = "c5-metered-" + System.nanoTime(); - DistributedLock handle = meteredPort.tryAcquire(key, Duration.ofSeconds(1), shortTtl); - - // Let the lease expire. - Thread.sleep(shortTtl.toMillis() + 500); - - // Acquire from a second adapter to reclaim the row (makes CME deterministic). - DefaultLockRepository repoB = buildRepository(sharedDataSource); - try { - LockRegistryDistributedLockAdapter adapterB = - new LockRegistryDistributedLockAdapter(new JdbcLockRegistry(repoB, shortTtl), shortTtl); - // Intentional discard — only need to reclaim the row. - @SuppressWarnings("unused") - DistributedLock reclaimHandle = adapterB.tryAcquire(key, Duration.ofSeconds(2), shortTtl); - } finally { - repoB.stop(); - } - - // The metered handle must NOT throw (SI-LOCK-C5 — 정상 흐름 복귀). - assertThatCode(handle::close) - .as("SI-LOCK-C5: MeteredDistributedLockPort.close() must not throw when lease expired") - .doesNotThrowAnyException(); - - // The lease-expired counter must have incremented. - // Use the literal "lock.lease.expired" (metrics.yaml §Distributed lock) — the constant - // is package-private in MeteredDistributedLockPort; the pinning test in - // MeteredDistributedLockPortTest.lock_lease_expired_constant_matches_registry_name() - // ensures the constant value stays in sync with this literal. - assertThat(meterRegistry.get("lock.lease.expired").counter().count()) - .as("lock.lease.expired counter must be 1 after one CME on close()") - .isEqualTo(1.0); - } finally { - repoA.stop(); - } - } - - // ====================================================================== - // helpers - // ====================================================================== - - private static void assumeDockerAvailable() { - Assumptions.assumeTrue( - DockerClientFactory.instance().isDockerAvailable(), - "Docker not available — skipping Testcontainers-based distributed lock contract test"); - } - - private static HikariDataSource hikari(PostgreSQLContainer pg) { - HikariConfig config = new HikariConfig(); - config.setJdbcUrl(pg.getJdbcUrl()); - config.setUsername(pg.getUsername()); - config.setPassword(pg.getPassword()); - config.setMaximumPoolSize(10); - config.setMinimumIdle(2); - return new HikariDataSource(config); - } - - private static DefaultLockRepository buildRepository(DataSource dataSource) { - DefaultLockRepository repo = new DefaultLockRepository(dataSource); - // INT_LOCK is provisioned by Flyway V4 — skip the DDL check. - repo.setCheckDatabaseOnStart(false); - // DefaultLockRepository implements InitializingBean (afterPropertiesSet) AND - // SmartInitializingSingleton (afterSingletonsInstantiated). The transaction templates - // (readCommittedTransactionTemplate etc.) are built in afterSingletonsInstantiated — - // that lifecycle callback fires automatically in a Spring context but must be invoked - // explicitly when constructing outside one. We set the transaction manager first so - // afterSingletonsInstantiated can wire it without needing an ApplicationContext. - repo.setTransactionManager(new DataSourceTransactionManager(dataSource)); - repo.afterPropertiesSet(); - repo.afterSingletonsInstantiated(); - repo.start(); - return repo; - } - - /** - * Builds a minimal Spring context with {@link DistributedLockPersistenceConfig}, {@link - * DistributedLockConfig}, {@link LockSettings}, the Testcontainers DataSource, and a {@link - * DataSourceTransactionManager}. - * - *

    The DataSource lifecycle is owned by the test ({@code sharedDataSource}); the context's - * destroy method is suppressed for the DataSource bean. - */ - private static AnnotationConfigApplicationContext buildContext(boolean multiInstanceEnabled) { - AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext(); - - // Register DataSource (no destroy — owned by the test). - ctx.registerBean( - "dataSource", DataSource.class, () -> sharedDataSource, bd -> bd.setDestroyMethodName("")); - - // PlatformTransactionManager (required by DefaultLockRepository). - ctx.registerBean( - "transactionManager", - DataSourceTransactionManager.class, - () -> new DataSourceTransactionManager(sharedDataSource)); - - // LockSettings: default values (3s wait, 30s TTL). - ctx.register(LockSettingsPropertiesConfig.class); - - // adapter-persistence config (creates inProcessDistributedLock or jdbcDistributedLock). - ctx.register(DistributedLockPersistenceConfig.class); - - // app-bootstrap config (creates distributedLockProvider when multi-instance=true). - ctx.register(DistributedLockConfig.class); - - // Set the multi-instance flag. - ctx.getEnvironment() - .getPropertySources() - .addFirst( - new MapPropertySource( - "test-props", - Map.of( - "ca-skeleton.runtime.multi-instance-enabled", - String.valueOf(multiInstanceEnabled)))); - - ctx.refresh(); - return ctx; - } - - /** - * Builds a real Spring {@link ObjectProvider}; a null registry yields the no-op (absent) case. - */ - private static ObjectProvider providerOf(MeterRegistry registry) { - DefaultListableBeanFactory beanFactory = new DefaultListableBeanFactory(); - if (registry != null) { - beanFactory.registerSingleton("meterRegistry", registry); - } - return beanFactory.getBeanProvider(MeterRegistry.class); - } - - /** - * Minimal @Configuration that enables LockSettings binding. {@code LockSettings} uses default - * values when no ca-skeleton.lock.* properties are bound, so no explicit property values are - * needed. - */ - @Configuration - @EnableConfigurationProperties(LockSettings.class) - static class LockSettingsPropertiesConfig { - - /** - * Provide an empty {@link MeterRegistry} provider so {@link MeteredDistributedLockPort} - * resolves to a no-op (Micrometer is on compile classpath but no registry bean is wired in this - * minimal context). - */ - @Bean - ObjectProvider meterRegistryProvider() { - DefaultListableBeanFactory empty = new DefaultListableBeanFactory(); - return empty.getBeanProvider(MeterRegistry.class); - } - } -} diff --git a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/fileserver/FileserverRoundTripContractTest.java b/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/fileserver/FileserverCompositionIntegrationTest.java similarity index 86% rename from src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/fileserver/FileserverRoundTripContractTest.java rename to src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/fileserver/FileserverCompositionIntegrationTest.java index f57ed283..6dea7552 100644 --- a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/fileserver/FileserverRoundTripContractTest.java +++ b/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/fileserver/FileserverCompositionIntegrationTest.java @@ -2,7 +2,6 @@ package dev.caskeleton.bootstrap.integration.fileserver; import static org.assertj.core.api.Assertions.assertThat; import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; -import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.head; import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post; import dev.caskeleton.adapter.inbound.web.fileserver.mapper.RawUploadRequestMapper; @@ -33,7 +32,6 @@ import java.util.stream.Stream; import org.flywaydb.core.Flyway; import org.junit.jupiter.api.AfterAll; import org.junit.jupiter.api.Test; -import org.junit.jupiter.api.condition.EnabledIf; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.boot.SpringBootConfiguration; import org.springframework.boot.autoconfigure.EnableAutoConfiguration; @@ -51,7 +49,6 @@ import org.springframework.test.context.DynamicPropertySource; import org.springframework.test.web.servlet.MockMvc; import org.springframework.test.web.servlet.MvcResult; import org.springframework.transaction.PlatformTransactionManager; -import org.testcontainers.DockerClientFactory; import org.testcontainers.junit.jupiter.Container; import org.testcontainers.junit.jupiter.Testcontainers; import org.testcontainers.postgresql.PostgreSQLContainer; @@ -59,7 +56,7 @@ import tools.jackson.databind.JsonNode; import tools.jackson.databind.ObjectMapper; /** - * Proves the Fileserver's seams against real infrastructure: HTTP in, real filesystem, real + * Proves the Fileserver composition against real infrastructure: HTTP in, real filesystem, real * PostgreSQL, HTTP out. * *

    Why this test exists

    @@ -69,8 +66,8 @@ import tools.jackson.databind.ObjectMapper; * against a real database, the web layer against standalone MockMvc. None of that exercises the * joins. A content key written by the metadata store and read by the download gateway, a digest * computed while streaming and compared against the persisted column, an ETag minted at publish and - * matched on a conditional request: each of those crosses two modules that were only ever proven - * separately. + * returned by the assembled download path: each of those crosses modules that are otherwise proven + * separately. HTTP range/conditional/HEAD semantics stay owned by adapter:inbound:web. * *

    Why a focused context rather than a full application boot

    * @@ -91,7 +88,7 @@ import tools.jackson.databind.ObjectMapper; */ @Testcontainers @SpringBootTest( - classes = FileserverRoundTripContractTest.FileserverRuntime.class, + classes = FileserverCompositionIntegrationTest.FileserverRuntime.class, properties = { // No configuration file carries this name, so application.yml is never loaded and the // environment is exactly the list below. @@ -116,11 +113,7 @@ import tools.jackson.databind.ObjectMapper; }) @AutoConfigureMockMvc(addFilters = false) @WithMockUser(authorities = {"ROLE_FILE_READ", "ROLE_FILE_WRITE"}) -@EnabledIf( - value = "dockerAvailable", - disabledReason = - "Docker not available — skipping the real-infrastructure Fileserver round trip") -class FileserverRoundTripContractTest { +class FileserverCompositionIntegrationTest { private static final String CORE_CAPABILITY = "jpa-flyway-migration"; private static final String FILESERVER_CAPABILITY = "jpa-fileserver-metadata-v1"; @@ -142,10 +135,6 @@ class FileserverRoundTripContractTest { @Autowired private ObjectMapper objectMapper; - static boolean dockerAvailable() { - return DockerClientFactory.instance().isDockerAvailable(); - } - /** * Applies the operator-owned schema streams and points the runtime at the container. * @@ -174,7 +163,7 @@ class FileserverRoundTripContractTest { } try (Stream tree = Files.walk(STORAGE_ROOT)) { tree.sorted(Comparator.reverseOrder()) - .forEach(FileserverRoundTripContractTest::deleteQuietly); + .forEach(FileserverCompositionIntegrationTest::deleteQuietly); } } @@ -231,57 +220,6 @@ class FileserverRoundTripContractTest { .isEqualTo(uploaded.get("etag").stringValue()); } - /** A {@code HEAD} answers the same headers as the {@code GET} and no body. */ - @Test - void headAnswersTheDownloadHeadersWithoutABody() throws Exception { - String fileId = upload(CONTENT, "head.txt").get("fileId").stringValue(); - - MvcResult body = mockMvc.perform(get("/v1/files/{fileId}/content", fileId)).andReturn(); - MvcResult headers = mockMvc.perform(head("/v1/files/{fileId}/content", fileId)).andReturn(); - - assertThat(headers.getResponse().getStatus()).isEqualTo(200); - assertThat(headers.getResponse().getContentAsByteArray()).isEmpty(); - assertThat(headers.getResponse().getHeader(HttpHeaders.ETAG)) - .isEqualTo(body.getResponse().getHeader(HttpHeaders.ETAG)); - assertThat(headers.getResponse().getHeader(HttpHeaders.CONTENT_LENGTH)) - .isEqualTo(body.getResponse().getHeader(HttpHeaders.CONTENT_LENGTH)); - } - - /** A range request serves the exact interior slice, sourced from the real file on disk. */ - @Test - void rangeRequestServesTheExactSlice() throws Exception { - String fileId = upload(CONTENT, "ranged.txt").get("fileId").stringValue(); - - MvcResult sliced = - mockMvc - .perform( - get("/v1/files/{fileId}/content", fileId).header(HttpHeaders.RANGE, "bytes=6-19")) - .andReturn(); - - assertThat(sliced.getResponse().getStatus()).isEqualTo(206); - assertThat(sliced.getResponse().getContentAsByteArray()) - .isEqualTo(java.util.Arrays.copyOfRange(CONTENT, 6, 20)); - assertThat(sliced.getResponse().getHeader(HttpHeaders.CONTENT_RANGE)) - .isEqualTo("bytes 6-19/" + CONTENT.length); - } - - /** The ETag the upload minted is the one a conditional request matches. */ - @Test - void conditionalRequestWithTheMintedEtagIsNotModified() throws Exception { - JsonNode uploaded = upload(CONTENT, "conditional.txt"); - String fileId = uploaded.get("fileId").stringValue(); - - MvcResult unchanged = - mockMvc - .perform( - get("/v1/files/{fileId}/content", fileId) - .header(HttpHeaders.IF_NONE_MATCH, uploaded.get("etag").stringValue())) - .andReturn(); - - assertThat(unchanged.getResponse().getStatus()).isEqualTo(304); - assertThat(unchanged.getResponse().getContentAsByteArray()).isEmpty(); - } - /** * A caller without the read role is refused. * diff --git a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/objectstorage/ObjectStorageCompositionIntegrationTest.java b/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/objectstorage/ObjectStorageCompositionIntegrationTest.java new file mode 100644 index 00000000..db61e106 --- /dev/null +++ b/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/objectstorage/ObjectStorageCompositionIntegrationTest.java @@ -0,0 +1,90 @@ +package dev.caskeleton.bootstrap.integration.objectstorage; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.adapter.outbound.objectstorage.config.ObjectStorageCapabilityConfig; +import dev.caskeleton.application.storage.ObjectStoragePort; +import java.nio.charset.StandardCharsets; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.SpringBootConfiguration; +import org.springframework.boot.autoconfigure.EnableAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.context.annotation.Import; +import org.springframework.test.context.DynamicPropertyRegistry; +import org.springframework.test.context.DynamicPropertySource; +import org.testcontainers.containers.GenericContainer; +import org.testcontainers.junit.jupiter.Container; +import org.testcontainers.junit.jupiter.Testcontainers; +import org.testcontainers.utility.DockerImageName; + +/** + * Composition-level object-storage contract against real MinIO. + * + *

    The default bootJar intentionally does not ship the object-storage leaf. This test is the + * explicit integration composition that proves the leaf can be selected, enabled and used through + * its application port without adding a test-only HTTP endpoint to production. + */ +@Testcontainers +@SpringBootTest( + classes = ObjectStorageCompositionIntegrationTest.ObjectStorageRuntime.class, + properties = { + "spring.config.name=object-storage-composition", + "spring.main.banner-mode=off", + "app.object-storage.enabled=false", + "app.object-storage.legacy.enabled=true", + "app.object-storage.legacy.backend=s3", + "app.object-storage.legacy.bucket=composition-contract", + "app.object-storage.legacy.region=us-east-1", + "app.object-storage.legacy.access-key=caskeleton", + "app.object-storage.legacy.secret-key=caskeleton-secret", + "app.object-storage.legacy.path-style-access=true", + "app.object-storage.legacy.auto-create-bucket=true" + }) +@SuppressWarnings("removal") +class ObjectStorageCompositionIntegrationTest { + + private static final DockerImageName MINIO_IMAGE = + DockerImageName.parse( + "minio/minio@sha256:4c4a4876193f030c81f57aabb22bcb9a73462010eb61fcab66908e03e5484af8"); + + @Container + static final GenericContainer MINIO = + new GenericContainer<>(MINIO_IMAGE) + .withExposedPorts(9000) + .withEnv("MINIO_ROOT_USER", "caskeleton") + .withEnv("MINIO_ROOT_PASSWORD", "caskeleton-secret") + .withCommand("server", "/data"); + + @Autowired private ObjectStoragePort objects; + + @DynamicPropertySource + static void minioEndpoint(DynamicPropertyRegistry registry) { + registry.add( + "app.object-storage.legacy.endpoint", + () -> "http://" + MINIO.getHost() + ":" + MINIO.getMappedPort(9000)); + } + + @Test + void selectedObjectStorageLeafRoundTripsThroughTheApplicationPort() { + String key = "composition/round-trip.txt"; + byte[] body = "object-storage composition round trip".getBytes(StandardCharsets.UTF_8); + + var stored = objects.put(key, body, "text/plain"); + + assertThat(stored.key()).isEqualTo(key); + assertThat(stored.size()).isEqualTo(body.length); + assertThat(objects.exists(key)).isTrue(); + assertThat(objects.get(key)).contains(body); + + objects.delete(key); + + assertThat(objects.exists(key)).isFalse(); + assertThat(objects.get(key)).isEmpty(); + } + + @SpringBootConfiguration + @EnableAutoConfiguration + @Import(ObjectStorageCapabilityConfig.class) + static class ObjectStorageRuntime {} +} diff --git a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/outbox/OutboxAppendTransactionalContractTest.java b/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/outbox/OutboxAppendTransactionalContractTest.java deleted file mode 100644 index 724b8228..00000000 --- a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/outbox/OutboxAppendTransactionalContractTest.java +++ /dev/null @@ -1,124 +0,0 @@ -package dev.caskeleton.bootstrap.integration.outbox; - -import static org.assertj.core.api.Assertions.assertThat; - -import dev.caskeleton.adapter.outbound.persistence.outbox.OutboxEventJpaRepository; -import dev.caskeleton.application.outbox.LegacyOutboxAppendPort; -import dev.caskeleton.application.outbox.NewOutboxEvent; -import dev.caskeleton.application.transaction.TransactionPort; -import dev.caskeleton.bootstrap.integration.PostgreSqlTestContainer; -import java.time.Clock; -import java.time.Instant; -import java.time.ZoneOffset; -import javax.sql.DataSource; -import org.junit.jupiter.api.AfterAll; -import org.junit.jupiter.api.BeforeAll; -import org.junit.jupiter.api.Test; -import org.springframework.context.annotation.AnnotationConfigApplicationContext; -import org.testcontainers.junit.jupiter.Container; -import org.testcontainers.junit.jupiter.Testcontainers; -import org.testcontainers.postgresql.PostgreSQLContainer; - -/** - * Integration test #2 — dual-write prohibition: outbox append participates in the caller's - * transaction; on rollback the outbox row is absent. - * - *

    Proves the no-dual-write guarantee (D2): if the business transaction rolls back, the outbox - * row vanishes with it — there is no separate out-of-band insert. - */ -@Testcontainers -class OutboxAppendTransactionalContractTest { - - @Container - static final PostgreSQLContainer PG = - PostgreSqlTestContainer.create(OutboxContainerTestSupport.PG_IMAGE); - - private static DataSource sharedDataSource; - - @BeforeAll - static void setup() { - OutboxContainerTestSupport.assumeDockerAvailable(); - sharedDataSource = OutboxContainerTestSupport.dataSource(PG); - OutboxContainerTestSupport.migrate(sharedDataSource); - } - - @AfterAll - static void cleanup() throws Exception { - if (sharedDataSource instanceof AutoCloseable ac) { - ac.close(); - } - } - - @Test - void sameTransactionAppendRollbackRemovesOutboxRowCharacterization() { - Clock clock = Clock.fixed(Instant.now(), ZoneOffset.UTC); - - try (AnnotationConfigApplicationContext ctx = - OutboxContainerTestSupport.buildContext(sharedDataSource, e -> {}, clock)) { - - TransactionPort tx = ctx.getBean(TransactionPort.class); - LegacyOutboxAppendPort append = ctx.getBean(LegacyOutboxAppendPort.class); - - String eventId = "txn-rollback-" + System.nanoTime(); - - // Append inside a transaction that rolls back by throwing - try { - tx.inWrite( - () -> { - append.append( - new NewOutboxEvent( - eventId, - "TestEvent", - "agg-rollback-" + eventId, - "{\"rollback\":true}", - clock.instant(), - "corr-" + eventId, - eventId)); - // Force rollback - throw new RuntimeException("intentional rollback"); - }); - } catch (RuntimeException ignored) { - // expected - } - - // Query specifically for this eventId via the store adapter's JPA repo - OutboxEventJpaRepository repo = ctx.getBean(OutboxEventJpaRepository.class); - assertThat(repo.findById(eventId)) - .as("outbox row must not exist after transaction rollback (D2 dual-write prohibition)") - .isEmpty(); - } - } - - @Test - void outboxRowIsPresentWhenTransactionCommits() { - Clock clock = Clock.fixed(Instant.now(), ZoneOffset.UTC); - - try (AnnotationConfigApplicationContext ctx = - OutboxContainerTestSupport.buildContext(sharedDataSource, e -> {}, clock)) { - - TransactionPort tx = ctx.getBean(TransactionPort.class); - LegacyOutboxAppendPort append = ctx.getBean(LegacyOutboxAppendPort.class); - - String eventId = "txn-commit-" + System.nanoTime(); - - tx.inWrite( - () -> { - append.append( - new NewOutboxEvent( - eventId, - "TestEvent", - "agg-commit-" + eventId, - "{\"committed\":true}", - clock.instant(), - "corr-" + eventId, - eventId)); - return null; - }); - - OutboxEventJpaRepository repo = ctx.getBean(OutboxEventJpaRepository.class); - assertThat(repo.findById(eventId)) - .as("outbox row must exist after successful transaction commit") - .isPresent(); - } - } -} diff --git a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/outbox/package-info.java b/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/outbox/package-info.java deleted file mode 100644 index 2024b23b..00000000 --- a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/outbox/package-info.java +++ /dev/null @@ -1,16 +0,0 @@ -/** - * Outbox integration tests — Testcontainers-backed real-PostgreSQL outbox contract verification. - * - *

    Tests in this package require a running Docker daemon. They verify the outbox event lifecycle - * (PENDING → IN_FLIGHT → PUBLISHED / FAILED / DEAD), transactional append guarantees, - * leader-election relay behavior (SKIP LOCKED), and reaper TTL deletion against a real PostgreSQL - * instance. - * - *

    Test Level Matrix: {@code integration} — all tests here depend on {@code org.testcontainers..} - * (see parent package-info for the taxonomy rule that classifies Testcontainers usage at this - * level). - * - *

    Support class: {@link dev.caskeleton.bootstrap.integration.outbox.OutboxContainerTestSupport} - * — shared Testcontainers + Spring context bootstrap for the outbox integration tests. - */ -package dev.caskeleton.bootstrap.integration.outbox; diff --git a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/package-info.java b/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/package-info.java index ea28462e..f6bfb611 100644 --- a/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/package-info.java +++ b/src/app-bootstrap/src/integrationTest/java/dev/caskeleton/bootstrap/integration/package-info.java @@ -1,15 +1,12 @@ /** - * Integration test level — Testcontainers-backed real-service tests. + * Composition-root integration level. * - *

    Tests in this package require a running Docker daemon. They boot real external services - * (PostgreSQL via Testcontainers) and exercise cross-layer behaviors (DDL → persistence adapter → - * application port) that cannot be verified with in-memory fakes. + *

    Tests here may start real required providers, but they do not own provider semantics. Those + * contracts belong to the adapter leaves. This source set proves that production composition joins + * the already-qualified application, adapter, persistence, and transport boundaries correctly. * - *

    Test Level Matrix: {@code integration} — tests here depend on {@code org.testcontainers..} and - * are intentionally classified at the integration level by the ArchUnit rule {@code - * CONTRACT_AND_ARCHITECTURE_TESTS_DO_NOT_DEPEND_ON_TESTCONTAINERS} - * (feature-test-taxonomy-fixture-contract §테스트 계약 #4 / D3). Unit-level and contract-level tests - * must NOT depend on Testcontainers; such tests belong in their respective packages under {@code - * dev.caskeleton.bootstrap.contract} or {@code dev.caskeleton.bootstrap.architecture}. + *

    Docker/provider absence is a failure for this required lane, not an approved skip. + * Deterministic bean/settings composition remains under {@code src/test}; packaged-candidate + * journeys belong to {@code systemTest}. */ package dev.caskeleton.bootstrap.integration; diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/CaSkeletonApplication.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/CaSkeletonApplication.java index 1ef586e6..6d1e8616 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/CaSkeletonApplication.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/CaSkeletonApplication.java @@ -59,20 +59,12 @@ import org.springframework.context.annotation.FilterType; basePackages = { "dev.caskeleton.bootstrap.async", "dev.caskeleton.bootstrap.autoconfigure.fileserver", - "dev.caskeleton.bootstrap.autoconfigure.httpclient", "dev.caskeleton.bootstrap.concurrency", - "dev.caskeleton.bootstrap.autoconfigure.idempotency", - "dev.caskeleton.bootstrap.autoconfigure.outbox", - "dev.caskeleton.bootstrap.autoconfigure.redis", "dev.caskeleton.bootstrap.runtime", "dev.caskeleton.bootstrap.security", "dev.caskeleton.bootstrap.settings", - "dev.caskeleton.bootstrap.autoconfigure.tracing", - "dev.caskeleton.adapter.inbound.grpc", "dev.caskeleton.adapter.inbound.web", - "dev.caskeleton.adapter.inbound.websocket", "dev.caskeleton.adapter.outbound.cache.redis", - "dev.caskeleton.adapter.outbound.fileserver", "dev.caskeleton.adapter.outbound.objectstorage", "dev.caskeleton.application", "dev.caskeleton.domain", @@ -101,6 +93,7 @@ public class CaSkeletonApplication { "dev\\.caskeleton\\.bootstrap\\.autoconfigure\\..*" + "|dev\\.caskeleton\\.bootstrap\\.notification\\..*" + "|dev\\.caskeleton\\.adapter\\.inbound\\.web\\.fileserver\\.admin\\..*" + + "|dev\\.caskeleton\\.adapter\\.outbound\\.httpclient\\.autoconfigure\\..*" + "|dev\\.caskeleton\\.adapter\\.outbound\\.mongo\\..*" + "|dev\\.caskeleton\\.adapter\\.outbound\\.messaging\\..*" + "|dev\\.caskeleton\\.adapter\\.outbound\\.notification\\..*" diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/activation/AdapterActivationEndpoint.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/activation/AdapterActivationEndpoint.java index 8370d3a4..91e9ee4f 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/activation/AdapterActivationEndpoint.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/activation/AdapterActivationEndpoint.java @@ -1,6 +1,7 @@ package dev.caskeleton.bootstrap.activation; import dev.caskeleton.bootstrap.autoconfigure.jpa.DataSourceRequirement; +import dev.caskeleton.bootstrap.runtime.RuntimeProfileSnapshot; import dev.caskeleton.shared.activation.MasterSwitch; import java.util.LinkedHashMap; import java.util.Map; @@ -42,9 +43,9 @@ public class AdapterActivationEndpoint { masterSwitch.property(), "true".equalsIgnoreCase(environment.getProperty(masterSwitch.property(), "false"))); } - String[] active = environment.getActiveProfiles(); + var profiles = RuntimeProfileSnapshot.from(environment).activeProfiles(); return new AdapterActivationReport( - active.length == 0 ? "" : active[0], + profiles.isEmpty() ? "" : profiles.get(0), switches, DataSourceRequirement.reasons(environment), resolvedVendor()); diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/activation/CapabilityDependencyEnvironmentValidator.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/activation/CapabilityDependencyEnvironmentValidator.java index a606c1e8..6942e7c6 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/activation/CapabilityDependencyEnvironmentValidator.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/activation/CapabilityDependencyEnvironmentValidator.java @@ -1,8 +1,6 @@ package dev.caskeleton.bootstrap.activation; -import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; import dev.caskeleton.bootstrap.runtime.startup.StartupOrder; -import java.util.List; import org.springframework.boot.EnvironmentPostProcessor; import org.springframework.boot.SpringApplication; import org.springframework.core.Ordered; @@ -42,15 +40,7 @@ public class CapabilityDependencyEnvironmentValidator implements EnvironmentPost @Override public void postProcessEnvironment( ConfigurableEnvironment environment, SpringApplication application) { - List violations = CapabilityDependencyValidator.violations(environment); - if (violations.isEmpty()) { - return; - } - throw StartupFailures.requiredAdapterDisabled( - "This deployment enables capabilities whose dependencies are off:" - + System.lineSeparator() - + String.join( - System.lineSeparator(), violations.stream().map(v -> " - " + v).toList())); + CapabilityDependencyValidator.requireSatisfied(environment); } @Override diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/activation/CapabilityDependencyStartupCheck.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/activation/CapabilityDependencyStartupCheck.java index 6c089837..198bbcf2 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/activation/CapabilityDependencyStartupCheck.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/activation/CapabilityDependencyStartupCheck.java @@ -1,7 +1,5 @@ package dev.caskeleton.bootstrap.activation; -import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; -import java.util.List; import org.springframework.beans.factory.InitializingBean; import org.springframework.core.env.Environment; @@ -24,14 +22,6 @@ public class CapabilityDependencyStartupCheck implements InitializingBean { @Override public void afterPropertiesSet() { - List violations = CapabilityDependencyValidator.violations(environment); - if (violations.isEmpty()) { - return; - } - throw StartupFailures.requiredAdapterDisabled( - "This deployment enables capabilities whose dependencies are off:" - + System.lineSeparator() - + String.join( - System.lineSeparator(), violations.stream().map(v -> " - " + v).toList())); + CapabilityDependencyValidator.requireSatisfied(environment); } } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/activation/CapabilityDependencyValidator.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/activation/CapabilityDependencyValidator.java index d0c53f3e..642cff13 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/activation/CapabilityDependencyValidator.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/activation/CapabilityDependencyValidator.java @@ -1,7 +1,10 @@ package dev.caskeleton.bootstrap.activation; +import dev.caskeleton.bootstrap.runtime.RuntimeProfileSnapshot; +import dev.caskeleton.bootstrap.runtime.startup.StartupPhase; +import dev.caskeleton.bootstrap.runtime.startup.StartupValidationContext; import dev.caskeleton.shared.activation.MasterSwitch; -import java.util.ArrayList; +import dev.caskeleton.shared.runtime.RuntimeEnvironment; import java.util.List; import java.util.Locale; import java.util.Map; @@ -24,11 +27,11 @@ import org.springframework.core.env.Environment; public final class CapabilityDependencyValidator { /** Which GraphQL deployment modes each runtime environment permits. */ - private static final Map> PERMITTED_GRAPHQL_MODES = + private static final Map> PERMITTED_GRAPHQL_MODES = Map.of( - "local", Set.of("LOCAL"), - "dev", Set.of("DEV"), - "prod", Set.of("PRODUCTION_INTERNAL", "PRODUCTION_PUBLIC")); + RuntimeEnvironment.LOCAL, Set.of("LOCAL"), + RuntimeEnvironment.DEV, Set.of("DEV"), + RuntimeEnvironment.PROD, Set.of("PRODUCTION_INTERNAL", "PRODUCTION_PUBLIC")); private CapabilityDependencyValidator() {} @@ -39,7 +42,8 @@ public final class CapabilityDependencyValidator { * @return the violations; empty when the active capability graph is consistent */ public static List violations(Environment environment) { - List violations = new ArrayList<>(); + StartupValidationContext violations = + StartupValidationContext.forPhase(StartupPhase.ADAPTER_ENABLEMENT); boolean jpa = isOn(environment, MasterSwitch.PERSISTENCE_JPA.property()); boolean mongo = isOn(environment, MasterSwitch.PERSISTENCE_MONGO.property()); @@ -51,40 +55,42 @@ public final class CapabilityDependencyValidator { String broker = environment.getProperty("app.messaging.broker", "").trim(); if (outbox && !jpa) { - violations.add( + violations.reject( "ca-skeleton.outbox.enabled=true needs relational persistence to store rows; set " + MasterSwitch.PERSISTENCE_JPA.property() + "=true or turn the outbox off."); } if (outbox && !messaging) { - violations.add( + violations.reject( "ca-skeleton.outbox.enabled=true needs somewhere to publish; set " + MasterSwitch.MESSAGING.property() + "=true or turn the outbox off."); } if (relay && !outbox) { - violations.add( + violations.reject( "ca-skeleton.outbox.relay-enabled=true only starts the scheduler for a capability that is " + "off; set ca-skeleton.outbox.enabled=true or turn the relay off."); } if (messaging && broker.isEmpty()) { - violations.add( + violations.reject( "app.messaging.enabled=true needs a transport; set app.messaging.broker to a registered " + "broker id."); } - if ("jdbc" - .equalsIgnoreCase( - environment.getProperty( - "ca-skeleton.capabilities.idempotency.provider", "disabled")) + String idempotencyProvider = + environment.getProperty("ca-skeleton.capabilities.idempotency.provider", "disabled").trim(); + if (("jdbc".equalsIgnoreCase(idempotencyProvider) + || "postgresql".equalsIgnoreCase(idempotencyProvider)) && !jpa) { - violations.add( - "ca-skeleton.capabilities.idempotency.provider=jdbc needs a database; set " + violations.reject( + "ca-skeleton.capabilities.idempotency.provider=" + + idempotencyProvider + + " needs relational persistence; set " + MasterSwitch.PERSISTENCE_JPA.property() + "=true or choose another provider."); } - if (isOn(environment, "ca-skeleton.lock.multi-instance-enabled") && !jpa) { - violations.add( - "ca-skeleton.lock.multi-instance-enabled=true needs a database for the lock registry; set " + if (isOn(environment, "ca-skeleton.runtime.multi-instance-enabled") && !jpa) { + violations.reject( + "ca-skeleton.runtime.multi-instance-enabled=true needs a database for the lock registry; set " + MasterSwitch.PERSISTENCE_JPA.property() + "=true or turn multi-instance locking off."); } @@ -93,27 +99,56 @@ public final class CapabilityDependencyValidator { .equalsIgnoreCase( environment.getProperty("ca-skeleton.notification.platform.persistence", "jpa")) && !jpa) { - violations.add( + violations.reject( MasterSwitch.NOTIFICATION_PLATFORM.property() + "=true stores requests relationally, and no other store is implemented; set " + MasterSwitch.PERSISTENCE_JPA.property() + "=true."); } - if (mongo - && environment - .getProperty( - MasterSwitch.PERSISTENCE_MONGO.property().replace(".enabled", ".active-profile"), - "") - .isBlank()) { - violations.add( - MasterSwitch.PERSISTENCE_MONGO.property() - + "=true needs exactly one profile; set " - + "ca-skeleton.persistence-mongo.active-profile."); + if (mongo) { + String activeMongoProfile = + environment + .getProperty( + MasterSwitch.PERSISTENCE_MONGO.property().replace(".enabled", ".active-profile"), + "") + .trim(); + if (activeMongoProfile.isBlank()) { + violations.reject( + MasterSwitch.PERSISTENCE_MONGO.property() + + "=true needs exactly one profile; set " + + "ca-skeleton.persistence-mongo.active-profile."); + } else { + String standardUri = environment.getProperty("spring.mongodb.uri", "").trim(); + String profileSecretProperty = + "ca-skeleton.persistence-mongo.platform.profiles." + activeMongoProfile + ".uri-secret"; + String profileSecret = environment.getProperty(profileSecretProperty, "").trim(); + if (standardUri.isBlank() && profileSecret.isBlank()) { + violations.reject( + MasterSwitch.PERSISTENCE_MONGO.property() + + "=true has no explicit MongoDB connection source; set spring.mongodb.uri " + + "(SPRING_MONGODB_URI) or " + + profileSecretProperty + + "."); + } + } } if (graphQl) { - violations.addAll(graphQlModeViolations(environment)); + violations.rejectAll(graphQlModeViolations(environment)); } - return List.copyOf(violations); + return violations.violations(); + } + + /** + * Rejects the deployment when any capability dependency is unsatisfied. + * + *

    Both the EnvironmentPostProcessor path and the bean fallback delegate here, so phase, + * aggregation and operator-facing failure formatting cannot drift between startup entry points. + */ + public static void requireSatisfied(Environment environment) { + StartupValidationContext violations = + StartupValidationContext.forPhase(StartupPhase.ADAPTER_ENABLEMENT) + .rejectAll(violations(environment)); + violations.failIfViolated("This deployment enables capabilities whose dependencies are off"); } private static List graphQlModeViolations(Environment environment) { @@ -124,20 +159,24 @@ public final class CapabilityDependencyValidator { + "=true needs an explicit safety posture; set backend.graphql.deployment-mode to one " + "of LOCAL, DEV, PRODUCTION_INTERNAL, PRODUCTION_PUBLIC."); } - String runtime = activeRuntimeEnvironment(environment); - Set permitted = PERMITTED_GRAPHQL_MODES.get(runtime); - if (permitted == null) { + RuntimeProfileSnapshot profiles = RuntimeProfileSnapshot.from(environment); + List activeProfiles = profiles.activeProfiles(); + RuntimeEnvironment runtime = profiles.resolve().orElse(null); + if (runtime == null) { return List.of( "backend.graphql.deployment-mode cannot be checked because the runtime environment '" - + runtime - + "' is not one of local, dev, prod."); + + String.join(",", activeProfiles) + + "' is not one of " + + RuntimeEnvironment.deployableProfileNames() + + "."); } + Set permitted = PERMITTED_GRAPHQL_MODES.get(runtime); if (!permitted.contains(mode.toUpperCase(Locale.ROOT))) { return List.of( "backend.graphql.deployment-mode=" + mode + " is not permitted in the " - + runtime + + runtime.profileName() + " runtime; permitted here: " + permitted.stream().sorted().toList() + "."); @@ -145,11 +184,6 @@ public final class CapabilityDependencyValidator { return List.of(); } - private static String activeRuntimeEnvironment(Environment environment) { - String[] active = environment.getActiveProfiles(); - return active.length == 0 ? "" : active[0]; - } - private static boolean isOn(Environment environment, String property) { return "true".equalsIgnoreCase(environment.getProperty(property, "false")); } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/activation/RuntimeEnvironmentProfileValidator.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/activation/RuntimeEnvironmentProfileValidator.java index 37f7c022..70393a4b 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/activation/RuntimeEnvironmentProfileValidator.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/activation/RuntimeEnvironmentProfileValidator.java @@ -1,5 +1,6 @@ package dev.caskeleton.bootstrap.activation; +import dev.caskeleton.bootstrap.runtime.RuntimeProfileSnapshot; import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; import dev.caskeleton.bootstrap.runtime.startup.StartupOrder; import dev.caskeleton.shared.runtime.RuntimeEnvironment; @@ -17,7 +18,7 @@ import org.springframework.core.env.ConfigurableEnvironment; * meant an in-memory database that loses every write on restart. The failure had no symptom until * the data was already gone. * - *

    Feature selection is not expressed here. That is what the five master switches are for, and a + *

    Feature selection is not expressed here. That is what the registered master switches are for, and a * supplementary profile used as a feature flag is how a profile list stops being a statement about * where the application is running. * @@ -42,9 +43,10 @@ public class RuntimeEnvironmentProfileValidator implements EnvironmentPostProces if (!isDeployableArtifact(application)) { return; } - List active = List.of(environment.getActiveProfiles()); + RuntimeProfileSnapshot profiles = RuntimeProfileSnapshot.from(environment); + List active = profiles.activeProfiles(); - if (RuntimeEnvironment.isTestContext(active)) { + if (profiles.isTestContext()) { return; } if (active.isEmpty()) { @@ -54,7 +56,7 @@ public class RuntimeEnvironmentProfileValidator implements EnvironmentPostProces + "; there is no default, because a profile that is guessed is a deployment nobody " + "chose."); } - List environments = RuntimeEnvironment.activeIn(active); + List environments = profiles.environments(); if (environments.size() > 1) { throw StartupFailures.envValidation( "SPRING_PROFILES_ACTIVE names more than one environment " diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/common/BootstrapClockAutoConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/common/BootstrapClockAutoConfiguration.java new file mode 100644 index 00000000..25a0d8fd --- /dev/null +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/common/BootstrapClockAutoConfiguration.java @@ -0,0 +1,25 @@ +package dev.caskeleton.bootstrap.autoconfigure.common; + +import java.time.Clock; +import org.springframework.boot.autoconfigure.AutoConfiguration; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.context.annotation.Bean; + +/** + * Application-wide wall-clock composition. + * + *

    Clock is infrastructure shared by persistence, outbox, fileserver, notification, Redis and + * other capabilities. It must therefore exist independently of whether any optional capability is + * enabled. Adopters may replace it with their own bean; the shipped default is UTC. + */ +@AutoConfiguration( + beforeName = + "dev.caskeleton.adapter.inbound.graphql.autoconfigure.GraphQlRootAutoConfiguration") +public class BootstrapClockAutoConfiguration { + + @Bean + @ConditionalOnMissingBean(Clock.class) + Clock applicationClock() { + return Clock.systemUTC(); + } +} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverCleanupWorker.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverCleanupWorker.java index b40c555a..2613787e 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverCleanupWorker.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverCleanupWorker.java @@ -1,5 +1,7 @@ package dev.caskeleton.bootstrap.autoconfigure.fileserver; +import static net.logstash.logback.argument.StructuredArguments.kv; + import dev.caskeleton.application.fileserver.cleanup.CleanupBatchResult; import dev.caskeleton.application.fileserver.cleanup.CleanupService; import org.slf4j.Logger; @@ -52,10 +54,23 @@ public class FileserverCleanupWorker { result.skippedActiveLease(), result.skippedStateChanged(), result.failed(), - result.reclaimedBytes()); + result.reclaimedBytes(), + kv("capability", "fileserver"), + kv("operation", "cleanup"), + kv("cleanup.deleted", result.deleted()), + kv("cleanup.skipped_active_lease", result.skippedActiveLease()), + kv("cleanup.skipped_state_changed", result.skippedStateChanged()), + kv("cleanup.failed", result.failed()), + kv("cleanup.reclaimed_bytes", result.reclaimedBytes())); } } catch (RuntimeException failure) { - LOG.warn("fileserver.cleanup batch failed; the next run retries the same queue", failure); + LOG.warn( + "fileserver.cleanup batch failed; the next run retries the same queue", + kv("capability", "fileserver"), + kv("operation", "cleanup"), + kv("warning.kind", "scheduled-task-failed"), + kv("retry.disposition", "next-run"), + failure); } } } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverCorePolicyConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverCorePolicyConfiguration.java new file mode 100644 index 00000000..b061eb9d --- /dev/null +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverCorePolicyConfiguration.java @@ -0,0 +1,44 @@ +package dev.caskeleton.bootstrap.autoconfigure.fileserver; + +import dev.caskeleton.adapter.inbound.web.fileserver.config.FileserverWebProperties; +import dev.caskeleton.adapter.inbound.web.fileserver.config.TransferExecutorProperties; +import dev.caskeleton.application.fileserver.api.StorageNamespace; +import dev.caskeleton.application.fileserver.upload.UploadPolicy; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +@Configuration(proxyBeanMethods = false) +class FileserverCorePolicyConfiguration { + + @Bean + @ConditionalOnMissingBean + FileserverWebProperties fileserverWebProperties(FileserverPlatformSettings properties) { + return new FileserverWebProperties( + StorageNamespace.of(properties.defaultNamespace()), + properties.upload().ttl(), + properties.upload().maxParts(), + properties.upload().requireContentLength()); + } + + @Bean + @ConditionalOnMissingBean + TransferExecutorProperties fileserverTransferExecutorProperties( + FileserverPlatformSettings properties) { + return new TransferExecutorProperties( + properties.transfer().coreSize(), + properties.transfer().maxSize(), + properties.transfer().queueCapacity(), + properties.transfer().awaitSeconds()); + } + + @Bean + @ConditionalOnMissingBean + UploadPolicy fileserverUploadPolicy(FileserverPlatformSettings properties) { + return new UploadPolicy( + properties.upload().maxFileSize().toBytes(), + properties.upload().initialReservation().toBytes(), + properties.upload().reservationTtl(), + properties.upload().leaseDuration()); + } +} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverDownloadLifecycleConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverDownloadLifecycleConfiguration.java new file mode 100644 index 00000000..959a7020 --- /dev/null +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverDownloadLifecycleConfiguration.java @@ -0,0 +1,64 @@ +package dev.caskeleton.bootstrap.autoconfigure.fileserver; + +import dev.caskeleton.application.fileserver.api.metadata.FileMetadataStore; +import dev.caskeleton.application.fileserver.api.security.FileAccessPolicy; +import dev.caskeleton.application.fileserver.api.security.OriginalFilenamePolicy; +import dev.caskeleton.application.fileserver.cleanup.CleanupQueue; +import dev.caskeleton.application.fileserver.download.DefaultDownloadApplicationService; +import dev.caskeleton.application.fileserver.download.DownloadApplicationService; +import dev.caskeleton.application.fileserver.download.DownloadContentGateway; +import dev.caskeleton.application.fileserver.download.ZeroCopyDownloadGateway; +import dev.caskeleton.application.fileserver.lifecycle.CopyContentGateway; +import dev.caskeleton.application.fileserver.lifecycle.DefaultFileLifecycleService; +import dev.caskeleton.application.fileserver.lifecycle.FileLifecycleService; +import dev.caskeleton.application.fileserver.observability.FileserverMetricsPort; +import dev.caskeleton.application.fileserver.upload.UploadIdentifierFactory; +import dev.caskeleton.application.transaction.TransactionPort; +import java.time.Clock; +import java.util.Optional; +import org.springframework.beans.factory.ObjectProvider; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +@Configuration(proxyBeanMethods = false) +class FileserverDownloadLifecycleConfiguration { + + @Bean + @ConditionalOnMissingBean + DownloadApplicationService fileserverDownloadService( + FileMetadataStore metadataStore, + DownloadContentGateway contentGateway, + FileAccessPolicy accessPolicy, + ZeroCopyDownloadGateway zeroCopyGateway, + ObjectProvider metrics) { + return new DefaultDownloadApplicationService( + metadataStore, + contentGateway, + accessPolicy, + Optional.of(zeroCopyGateway), + FileserverMetricsSupport.metricsOrNoop(metrics)); + } + + @Bean + @ConditionalOnMissingBean + FileLifecycleService fileserverLifecycleService( + FileMetadataStore metadataStore, + CopyContentGateway copyGateway, + FileAccessPolicy accessPolicy, + OriginalFilenamePolicy filenamePolicy, + CleanupQueue cleanupQueue, + UploadIdentifierFactory identifierFactory, + TransactionPort transactions, + Clock clock) { + return new DefaultFileLifecycleService( + metadataStore, + copyGateway, + accessPolicy, + filenamePolicy, + cleanupQueue, + identifierFactory, + transactions, + clock); + } +} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverHttpDownloadConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverHttpDownloadConfiguration.java new file mode 100644 index 00000000..b52f4f39 --- /dev/null +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverHttpDownloadConfiguration.java @@ -0,0 +1,72 @@ +package dev.caskeleton.bootstrap.autoconfigure.fileserver; + +import dev.caskeleton.adapter.inbound.web.fileserver.http.DefaultHttpRangeResolver; +import dev.caskeleton.adapter.inbound.web.fileserver.http.HttpContentDispositionFactory; +import dev.caskeleton.adapter.inbound.web.fileserver.http.HttpDownloadPlanner; +import dev.caskeleton.adapter.inbound.web.fileserver.http.HttpDownloadPolicy; +import dev.caskeleton.adapter.inbound.web.fileserver.http.HttpRangePolicy; +import dev.caskeleton.adapter.inbound.web.fileserver.http.HttpRangeResolver; +import dev.caskeleton.adapter.inbound.web.fileserver.http.MvcConditionalRequestFactory; +import dev.caskeleton.adapter.inbound.web.fileserver.http.MvcDownloadResponseWriter; +import dev.caskeleton.adapter.inbound.web.fileserver.http.ZeroCopyEligibility; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +/** HTTP-only download policy and rendering helpers. */ +@Configuration(proxyBeanMethods = false) +class FileserverHttpDownloadConfiguration { + + @Bean + @ConditionalOnMissingBean + MvcConditionalRequestFactory fileserverConditionalRequestFactory() { + return new MvcConditionalRequestFactory(); + } + + @Bean + @ConditionalOnMissingBean + HttpRangeResolver fileserverHttpRangeResolver() { + return new DefaultHttpRangeResolver(); + } + + @Bean + @ConditionalOnMissingBean + HttpContentDispositionFactory fileserverHttpContentDispositionFactory() { + return new HttpContentDispositionFactory(); + } + + @Bean + @ConditionalOnMissingBean + HttpDownloadPolicy fileserverHttpDownloadPolicy(FileserverPlatformSettings properties) { + HttpRangePolicy rangePolicy = + properties.download().maxRanges() <= 1 + ? HttpRangePolicy.single(properties.download().maxRangeBytes().toBytes()) + : HttpRangePolicy.multi( + properties.download().maxRanges(), properties.download().maxRangeBytes().toBytes()); + return new HttpDownloadPolicy( + rangePolicy, properties.download().cacheControl(), properties.download().inlineAllowed()); + } + + @Bean + @ConditionalOnMissingBean + HttpDownloadPlanner fileserverHttpDownloadPlanner( + HttpRangeResolver rangeResolver, + HttpContentDispositionFactory dispositionFactory, + HttpDownloadPolicy policy) { + return new HttpDownloadPlanner(rangeResolver, dispositionFactory, policy); + } + + @Bean + @ConditionalOnMissingBean + MvcDownloadResponseWriter fileserverDownloadResponseWriter() { + return new MvcDownloadResponseWriter(); + } + + @Bean + @ConditionalOnMissingBean + ZeroCopyEligibility fileserverZeroCopyEligibility(FileserverPlatformSettings properties) { + return new ZeroCopyEligibility( + properties.download().zeroCopyEnabled(), + properties.download().zeroCopyMinimumBytes().toBytes()); + } +} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverLocalStorageCoreConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverLocalStorageCoreConfiguration.java new file mode 100644 index 00000000..60e9bb2d --- /dev/null +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverLocalStorageCoreConfiguration.java @@ -0,0 +1,111 @@ +package dev.caskeleton.bootstrap.autoconfigure.fileserver; + +import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalBlockingContentStore; +import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalStorageCapabilityProbe; +import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalStorageProbeResult; +import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalStorageProperties; +import dev.caskeleton.adapter.outbound.persistence.fileserver.FileserverSchemaActivation; +import dev.caskeleton.application.fileserver.api.content.PublishMode; +import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; +import java.nio.file.Path; +import java.util.Locale; +import org.springframework.boot.autoconfigure.condition.ConditionalOnBean; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.jdbc.core.JdbcOperations; + +@Configuration(proxyBeanMethods = false) +class FileserverLocalStorageCoreConfiguration { + + /** + * The three storage invariants are pinned, not configured. + * + *

    Staging and content on one file store, a refusal to follow symbolic links, and a force + * before publish are what make an atomic publish atomic and a namespace a boundary. A deployment + * that could switch them off would be running a different capability under the same name and the + * same tests, so they are constants here rather than settings. + */ + @Bean + @ConditionalOnMissingBean + LocalStorageProperties fileserverStorageProperties(FileserverPlatformSettings settings) { + FileserverPlatformSettings.Storage storage = settings.storage(); + requireStorageRootIsIsolated(storage); + return new LocalStorageProperties( + storage.root(), + publishMode(storage.publishMode()), + true, + true, + (int) storage.bufferSize().toBytes(), + settings.upload().maxFileSize().toBytes(), + true); + } + + /** + * Refuses to start until the Fileserver schema stream is applied and promoted. + * + *

    Paired with the storage probe below: one proves the volume can hold the bytes, the other + * proves the database sanctions the records. A capability that starts with either unproven fails + * on a user's first upload instead of on the deployment that caused it. + */ + @Bean + @ConditionalOnMissingBean + @ConditionalOnBean(JdbcOperations.class) + FileserverSchemaActivation fileserverSchemaActivation(JdbcOperations jdbc) { + FileserverSchemaActivation activation = new FileserverSchemaActivation(jdbc); + activation.requireActive(); + return activation; + } + + @Bean + @ConditionalOnMissingBean + LocalStorageProbeResult fileserverStorageProbeResult(LocalStorageProperties properties) { + LocalStorageProbeResult result = new LocalStorageCapabilityProbe(properties).run(); + if (!result.mandatoryChecksPassed()) { + throw StartupFailures.envValidation( + "fileserver storage root failed a mandatory capability probe: " + + result.failures() + + "; the capability refuses to start rather than publish files it cannot place " + + "atomically"); + } + return result; + } + + @Bean + @ConditionalOnMissingBean + LocalBlockingContentStore fileserverContentStore( + LocalStorageProperties properties, LocalStorageProbeResult probeResult) { + return new LocalBlockingContentStore(properties, probeResult); + } + + /** + * Refuses a storage root that overlaps something the process already serves or reads. + * + *

    A root under a web root turns every upload into a published file; a root under a + * configuration directory turns one into a configuration change. Both are checked here because + * the path is only known once, at binding time. + */ + private static void requireStorageRootIsIsolated(FileserverPlatformSettings.Storage storage) { + Path root = storage.root().toAbsolutePath().normalize(); + for (Path forbidden : storage.forbiddenRootAncestors()) { + Path ancestor = forbidden.toAbsolutePath().normalize(); + if (root.startsWith(ancestor)) { + throw StartupFailures.envValidation( + "fileserver storage root must not live under a configured forbidden ancestor"); + } + } + } + + private static PublishMode publishMode(String configured) { + String canonical = configured.trim().toUpperCase(Locale.ROOT).replace('-', '_'); + try { + return PublishMode.valueOf(canonical); + } catch (IllegalArgumentException unknown) { + throw StartupFailures.envValidation( + FileserverPlatformSettings.PREFIX + + ".storage.publish-mode must be one of atomic-move-required, " + + "atomic-move-preferred, metadata-pointer", + unknown); + } + } +} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverMaintenanceServiceConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverMaintenanceServiceConfiguration.java new file mode 100644 index 00000000..40d9b6a9 --- /dev/null +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverMaintenanceServiceConfiguration.java @@ -0,0 +1,106 @@ +package dev.caskeleton.bootstrap.autoconfigure.fileserver; + +import dev.caskeleton.application.fileserver.admin.AdminAuditPort; +import dev.caskeleton.application.fileserver.admin.DefaultFileserverAdminService; +import dev.caskeleton.application.fileserver.admin.FileserverAdminService; +import dev.caskeleton.application.fileserver.admin.OrphanScanPort; +import dev.caskeleton.application.fileserver.admin.StorageHealthPort; +import dev.caskeleton.application.fileserver.api.metadata.FileMetadataStore; +import dev.caskeleton.application.fileserver.api.metadata.UploadSessionStore; +import dev.caskeleton.application.fileserver.api.security.FileAccessPolicy; +import dev.caskeleton.application.fileserver.cleanup.CleanupContentGateway; +import dev.caskeleton.application.fileserver.cleanup.CleanupQueue; +import dev.caskeleton.application.fileserver.cleanup.CleanupService; +import dev.caskeleton.application.fileserver.cleanup.DefaultCleanupService; +import dev.caskeleton.application.fileserver.cleanup.QuotaReclaimGateway; +import dev.caskeleton.application.fileserver.observability.FileserverMetricsPort; +import dev.caskeleton.application.fileserver.observability.SafeFileFingerprint; +import dev.caskeleton.application.fileserver.recovery.DefaultFileReconciliationService; +import dev.caskeleton.application.fileserver.recovery.FileReconciliationService; +import dev.caskeleton.application.fileserver.recovery.ReconciliationContentProbe; +import dev.caskeleton.application.fileserver.recovery.RecoveryQueue; +import dev.caskeleton.application.transaction.TransactionPort; +import java.time.Clock; +import org.springframework.beans.factory.ObjectProvider; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +@Configuration(proxyBeanMethods = false) +class FileserverMaintenanceServiceConfiguration { + + @Bean + @ConditionalOnMissingBean + CleanupService fileserverCleanupService( + CleanupQueue queue, + CleanupContentGateway contentGateway, + FileMetadataStore metadataStore, + UploadSessionStore sessionStore, + QuotaReclaimGateway quotaGateway, + FileserverPlatformSettings settings, + ObjectProvider metrics, + TransactionPort transactions, + Clock clock) { + return new DefaultCleanupService( + queue, + contentGateway, + metadataStore, + sessionStore, + quotaGateway, + settings.cleanup().retryBackoff(), + FileserverMetricsSupport.metricsOrNoop(metrics), + transactions, + clock); + } + + @Bean + @ConditionalOnMissingBean + FileReconciliationService fileserverReconciliationService( + FileMetadataStore metadataStore, + ReconciliationContentProbe contentProbe, + RecoveryQueue recoveryQueue, + TransactionPort transactions, + Clock clock) { + return new DefaultFileReconciliationService( + metadataStore, contentProbe, recoveryQueue, transactions, clock); + } + + /** + * The management plane, gated on its own switch. + * + *

    Admin is a separate decision from the data plane: a deployment that serves files does not + * automatically want an endpoint that can force-delete them. + */ + @Bean + @ConditionalOnMissingBean + @ConditionalOnProperty( + prefix = "app.fileserver-platform.admin", + name = "enabled", + havingValue = "true") + FileserverAdminService fileserverAdminService( + StorageHealthPort healthPort, + OrphanScanPort orphanScanPort, + FileMetadataStore metadataStore, + UploadSessionStore sessionStore, + CleanupQueue cleanupQueue, + CleanupService cleanupService, + FileAccessPolicy accessPolicy, + AdminAuditPort auditPort, + SafeFileFingerprint fingerprint, + TransactionPort transactions, + Clock clock) { + return new DefaultFileserverAdminService( + healthPort, + orphanScanPort, + metadataStore, + sessionStore, + cleanupQueue, + cleanupService, + accessPolicy, + auditPort, + fingerprint, + transactions, + clock); + } +} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverMetricsSupport.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverMetricsSupport.java new file mode 100644 index 00000000..f1d7f739 --- /dev/null +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverMetricsSupport.java @@ -0,0 +1,22 @@ +package dev.caskeleton.bootstrap.autoconfigure.fileserver; + +import dev.caskeleton.application.fileserver.observability.FileserverMetricsPort; +import org.springframework.beans.factory.ObjectProvider; + +/** Shared optional-metrics selection for Fileserver application-service assembly. */ +final class FileserverMetricsSupport { + + private FileserverMetricsSupport() {} + + /** + * Instrumentation is optional; the services are not. + * + *

    Metrics can be switched off, and when they are there is no {@code FileserverMetricsPort} + * bean. Injecting it directly would make every service depend on telemetry being enabled, so the + * no-op stands in — which is also what stops the ports from being dead code the way they were + * when nothing called them at all. + */ + static FileserverMetricsPort metricsOrNoop(ObjectProvider metrics) { + return metrics.getIfAvailable(FileserverMetricsPort::noop); + } +} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverNginxConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverNginxConfiguration.java new file mode 100644 index 00000000..8786553a --- /dev/null +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverNginxConfiguration.java @@ -0,0 +1,37 @@ +package dev.caskeleton.bootstrap.autoconfigure.fileserver; + +import dev.caskeleton.adapter.inbound.web.fileserver.nginx.DefaultNginxInternalUriMapper; +import dev.caskeleton.adapter.inbound.web.fileserver.nginx.NginxDelegationProperties; +import dev.caskeleton.adapter.inbound.web.fileserver.nginx.NginxDownloadStrategy; +import dev.caskeleton.adapter.inbound.web.fileserver.nginx.NginxInternalUriMapper; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +@Configuration(proxyBeanMethods = false) +class FileserverNginxConfiguration { + + @Bean + @ConditionalOnMissingBean + NginxDelegationProperties fileserverNginxDelegationProperties( + FileserverPlatformSettings properties) { + return new NginxDelegationProperties( + properties.nginx().enabled(), + properties.nginx().internalPrefix(), + properties.nginx().objectSuffix(), + properties.nginx().minimumSize().toBytes()); + } + + @Bean + @ConditionalOnMissingBean + NginxInternalUriMapper fileserverNginxInternalUriMapper(NginxDelegationProperties properties) { + return new DefaultNginxInternalUriMapper(properties); + } + + @Bean + @ConditionalOnMissingBean + NginxDownloadStrategy fileserverNginxDownloadStrategy( + NginxDelegationProperties properties, NginxInternalUriMapper uriMapper) { + return new NginxDownloadStrategy(properties, uriMapper); + } +} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverObservabilityConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverObservabilityConfiguration.java new file mode 100644 index 00000000..f0bd1b1e --- /dev/null +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverObservabilityConfiguration.java @@ -0,0 +1,52 @@ +package dev.caskeleton.bootstrap.autoconfigure.fileserver; + +import dev.caskeleton.adapter.outbound.fileserver.platform.observability.MicrometerFileserverMetrics; +import dev.caskeleton.application.fileserver.observability.FileserverMetricsPort; +import dev.caskeleton.application.fileserver.observability.SafeFileFingerprint; +import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; +import io.micrometer.core.instrument.MeterRegistry; +import java.nio.charset.StandardCharsets; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Conditional; +import org.springframework.context.annotation.Configuration; + +@Configuration(proxyBeanMethods = false) +class FileserverObservabilityConfiguration { + + /** + * Telemetry fingerprinting. + * + *

    Absent a configured key the capability is not silently downgraded to an unkeyed hash — which + * would be reversible for an enumerable identifier space. The key is required, and startup fails + * without one — but only when something actually consumes a fingerprint. There are two such + * consumers, telemetry and the management-plane audit trail, so the bean exists when either is on + * rather than being tied to metrics alone: an audit trail that pseudonymised its actors with an + * unkeyed 32-bit hash was the reason this had to be widened. + */ + @Bean + @ConditionalOnMissingBean + @Conditional(FileserverFingerprintConsumerCondition.class) + SafeFileFingerprint fileserverFingerprint(FileserverPlatformSettings properties) { + String key = properties.observability().fingerprintKey(); + if (key == null || key.isBlank()) { + throw StartupFailures.envValidation( + FileserverPlatformSettings.PREFIX + + ".observability.fingerprint-key must be configured while metrics are enabled: an " + + "unkeyed digest of an enumerable identifier is reversible"); + } + return new SafeFileFingerprint(key.getBytes(StandardCharsets.UTF_8)); + } + + @Bean + @ConditionalOnMissingBean + @ConditionalOnProperty( + prefix = FileserverPlatformSettings.PREFIX + ".observability", + name = "metrics-enabled", + havingValue = "true", + matchIfMissing = true) + FileserverMetricsPort fileserverMetrics(MeterRegistry registry) { + return new MicrometerFileserverMetrics(registry); + } +} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverPlatformAutoConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverPlatformAutoConfiguration.java index c0ad290b..ca9332ce 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverPlatformAutoConfiguration.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverPlatformAutoConfiguration.java @@ -1,64 +1,17 @@ package dev.caskeleton.bootstrap.autoconfigure.fileserver; -import dev.caskeleton.adapter.inbound.web.fileserver.config.FileserverWebProperties; -import dev.caskeleton.adapter.inbound.web.fileserver.config.TransferExecutorProperties; -import dev.caskeleton.adapter.inbound.web.fileserver.draft12.Draft12Properties; -import dev.caskeleton.adapter.inbound.web.fileserver.http.MvcConditionalRequestFactory; -import dev.caskeleton.adapter.inbound.web.fileserver.http.MvcDownloadResponseWriter; -import dev.caskeleton.adapter.inbound.web.fileserver.http.ZeroCopyEligibility; -import dev.caskeleton.adapter.inbound.web.fileserver.mapper.MultipartUploadRequestMapper; -import dev.caskeleton.adapter.inbound.web.fileserver.mapper.RawUploadRequestMapper; -import dev.caskeleton.adapter.inbound.web.fileserver.nginx.DefaultNginxInternalUriMapper; -import dev.caskeleton.adapter.inbound.web.fileserver.nginx.NginxDelegationProperties; -import dev.caskeleton.adapter.inbound.web.fileserver.nginx.NginxDownloadStrategy; -import dev.caskeleton.adapter.inbound.web.fileserver.nginx.NginxInternalUriMapper; -import dev.caskeleton.adapter.inbound.web.fileserver.problem.FileserverProblemFactory; -import dev.caskeleton.adapter.inbound.web.fileserver.security.FileserverRequestContextFactory; -import dev.caskeleton.adapter.inbound.web.fileserver.tus.TusChecksumVerifier; -import dev.caskeleton.adapter.inbound.web.fileserver.tus.TusProperties; -import dev.caskeleton.adapter.inbound.web.fileserver.tus.TusRequestParser; -import dev.caskeleton.adapter.outbound.fileserver.platform.observability.MicrometerFileserverMetrics; -import dev.caskeleton.application.fileserver.api.StorageNamespace; -import dev.caskeleton.application.fileserver.api.transfer.ConditionalRequestEvaluator; -import dev.caskeleton.application.fileserver.api.transfer.ContentDispositionFactory; -import dev.caskeleton.application.fileserver.api.transfer.DefaultConditionalRequestEvaluator; -import dev.caskeleton.application.fileserver.api.transfer.DefaultHttpRangeResolver; -import dev.caskeleton.application.fileserver.api.transfer.HttpRangeResolver; -import dev.caskeleton.application.fileserver.api.transfer.RangeBudget; -import dev.caskeleton.application.fileserver.download.DownloadPolicy; -import dev.caskeleton.application.fileserver.observability.FileserverMetricsPort; -import dev.caskeleton.application.fileserver.observability.SafeFileFingerprint; -import dev.caskeleton.application.fileserver.upload.UploadPolicy; -import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; -import io.micrometer.core.instrument.MeterRegistry; -import java.nio.charset.StandardCharsets; -import java.util.List; import org.springframework.boot.autoconfigure.AutoConfiguration; import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; import org.springframework.context.annotation.Bean; -import org.springframework.context.annotation.Conditional; import org.springframework.context.annotation.Import; import org.springframework.core.env.Environment; /** - * The one entry point through which the HTTP Fileserver platform exists at all. + * Master-gated Fileserver platform entry point. * - *

    This is an auto-configuration rather than a component-scanned {@code @Configuration}, and it - * lives in a package the composition root's scan explicitly excludes. That is the whole point: when - * the master switch is absent or false, the class is never processed, so none of the configurations - * it imports are discovered either. The previous shape — child configurations sitting inside the - * scanned package — meant the storage probe, the authorization policy, and the service graph were - * assembled whatever the master switch said, which is not an optional capability but a mandatory - * one with a switch that only controlled its controllers. - * - *

    Consequently every sub-feature switch is evaluated inside a graph that already requires the - * master switch. Turning on the admin plane, tus, the experimental draft, or the cleanup worker in - * a deployment that never enabled the Fileserver now does nothing at all, rather than half-building - * a bean graph that fails on its first missing collaborator. - * - *

    The policy objects are built here rather than read inside the application layer, which is what - * keeps that layer free of configuration types. + *

    This class owns only activation and strict settings binding. Concern-specific assembly stays + * in package-private child configurations reachable exclusively through this gated root. */ @AutoConfiguration @ConditionalOnProperty( @@ -66,6 +19,12 @@ import org.springframework.core.env.Environment; name = "enabled", havingValue = "true") @Import({ + FileserverCorePolicyConfiguration.class, + FileserverWebAssemblyConfiguration.class, + FileserverHttpDownloadConfiguration.class, + FileserverNginxConfiguration.class, + FileserverProtocolConfiguration.class, + FileserverObservabilityConfiguration.class, FileserverStorageConfiguration.class, FileserverSecurityConfiguration.class, FileserverServiceConfiguration.class, @@ -87,234 +46,4 @@ public class FileserverPlatformAutoConfiguration { FileserverPlatformSettings fileserverPlatformSettings(Environment environment) { return FileserverPlatformSettingsBinder.bind(environment); } - - @Bean - @ConditionalOnMissingBean - FileserverWebProperties fileserverWebProperties(FileserverPlatformSettings properties) { - return new FileserverWebProperties( - StorageNamespace.of(properties.defaultNamespace()), - properties.upload().ttl(), - properties.upload().maxParts(), - properties.upload().requireContentLength()); - } - - @Bean - @ConditionalOnMissingBean - TransferExecutorProperties fileserverTransferExecutorProperties( - FileserverPlatformSettings properties) { - return new TransferExecutorProperties( - properties.transfer().coreSize(), - properties.transfer().maxSize(), - properties.transfer().queueCapacity(), - properties.transfer().awaitSeconds()); - } - - @Bean - @ConditionalOnMissingBean - UploadPolicy fileserverUploadPolicy(FileserverPlatformSettings properties) { - return new UploadPolicy( - properties.upload().maxFileSize().toBytes(), - properties.upload().initialReservation().toBytes(), - properties.upload().reservationTtl(), - properties.upload().leaseDuration()); - } - - /** - * Range budget. - * - *

    The byte ceiling applies to the single-range profile too. Treating {@code max-ranges=1} as - * "unbounded bytes" made {@code max-range-bytes} silently inert in the default configuration — - * the one almost every deployment runs — so the setting described a limit nobody had. - */ - @Bean - @ConditionalOnMissingBean - DownloadPolicy fileserverDownloadPolicy(FileserverPlatformSettings properties) { - RangeBudget budget = - properties.download().maxRanges() <= 1 - ? RangeBudget.single(properties.download().maxRangeBytes().toBytes()) - : RangeBudget.multi( - properties.download().maxRanges(), properties.download().maxRangeBytes().toBytes()); - return new DownloadPolicy( - budget, properties.download().cacheControl(), properties.download().inlineAllowed()); - } - - @Bean - @ConditionalOnMissingBean - HttpRangeResolver fileserverRangeResolver() { - return new DefaultHttpRangeResolver(); - } - - @Bean - @ConditionalOnMissingBean - ConditionalRequestEvaluator fileserverConditionalEvaluator(HttpRangeResolver rangeResolver) { - return new DefaultConditionalRequestEvaluator(rangeResolver); - } - - @Bean - @ConditionalOnMissingBean - ContentDispositionFactory fileserverContentDispositionFactory() { - return new ContentDispositionFactory(); - } - - @Bean - @ConditionalOnMissingBean - FileserverRequestContextFactory fileserverRequestContextFactory( - FileserverPlatformSettings properties) { - return new FileserverRequestContextFactory(properties.instanceId()); - } - - @Bean - @ConditionalOnMissingBean - FileserverProblemFactory fileserverProblemFactory() { - return new FileserverProblemFactory(); - } - - @Bean - @ConditionalOnMissingBean - RawUploadRequestMapper fileserverRawUploadRequestMapper(FileserverPlatformSettings properties) { - return new RawUploadRequestMapper(properties.upload().requireContentLength()); - } - - @Bean - @ConditionalOnMissingBean - MultipartUploadRequestMapper fileserverMultipartUploadRequestMapper() { - return new MultipartUploadRequestMapper(); - } - - @Bean - @ConditionalOnMissingBean - MvcConditionalRequestFactory fileserverConditionalRequestFactory() { - return new MvcConditionalRequestFactory(); - } - - @Bean - @ConditionalOnMissingBean - MvcDownloadResponseWriter fileserverDownloadResponseWriter() { - return new MvcDownloadResponseWriter(); - } - - @Bean - @ConditionalOnMissingBean - ZeroCopyEligibility fileserverZeroCopyEligibility(FileserverPlatformSettings properties) { - return new ZeroCopyEligibility( - properties.download().zeroCopyEnabled(), - properties.download().zeroCopyMinimumBytes().toBytes()); - } - - @Bean - @ConditionalOnMissingBean - NginxDelegationProperties fileserverNginxDelegationProperties( - FileserverPlatformSettings properties) { - return new NginxDelegationProperties( - properties.nginx().enabled(), - properties.nginx().internalPrefix(), - properties.nginx().objectSuffix(), - properties.nginx().minimumSize().toBytes()); - } - - @Bean - @ConditionalOnMissingBean - NginxInternalUriMapper fileserverNginxInternalUriMapper(NginxDelegationProperties properties) { - return new DefaultNginxInternalUriMapper(properties); - } - - @Bean - @ConditionalOnMissingBean - NginxDownloadStrategy fileserverNginxDownloadStrategy( - NginxDelegationProperties properties, NginxInternalUriMapper uriMapper) { - return new NginxDownloadStrategy(properties, uriMapper); - } - - /** - * tus support objects, contributed only when both this switch and the master switch are on. - * - *

    The nesting is the fix: previously the protocol's own flag was the only condition, so - * enabling tus in a deployment with the Fileserver off produced a controller with no service - * behind it. - */ - @Bean - @ConditionalOnMissingBean - @ConditionalOnProperty( - prefix = FileserverPlatformSettings.PREFIX + ".tus", - name = "enabled", - havingValue = "true") - TusProperties fileserverTusProperties(FileserverPlatformSettings properties) { - return new TusProperties( - TusProperties.RESUMABLE_VERSION, - List.of("creation", "expiration", "checksum", "termination"), - properties.upload().maxFileSize().toBytes(), - properties.upload().ttl()); - } - - @Bean - @ConditionalOnMissingBean - @ConditionalOnProperty( - prefix = FileserverPlatformSettings.PREFIX + ".tus", - name = "enabled", - havingValue = "true") - TusRequestParser fileserverTusRequestParser(TusProperties tusProperties) { - return new TusRequestParser(tusProperties); - } - - @Bean - @ConditionalOnMissingBean - @ConditionalOnProperty( - prefix = FileserverPlatformSettings.PREFIX + ".tus", - name = "enabled", - havingValue = "true") - TusChecksumVerifier fileserverTusChecksumVerifier() { - return new TusChecksumVerifier(); - } - - /** - * Settings for the experimental draft, which previously had no production binding at all. - * - *

    The controller existed and could be switched on, but nothing built the properties it needs, - * so the switch produced a startup failure rather than a protocol. - */ - @Bean - @ConditionalOnMissingBean - @ConditionalOnProperty( - prefix = FileserverPlatformSettings.PREFIX + ".httpbis-draft12", - name = "enabled", - havingValue = "true") - Draft12Properties fileserverDraft12Properties(FileserverPlatformSettings properties) { - return new Draft12Properties( - true, properties.upload().maxFileSize().toBytes(), properties.upload().ttl(), false); - } - - /** - * Telemetry fingerprinting. - * - *

    Absent a configured key the capability is not silently downgraded to an unkeyed hash — which - * would be reversible for an enumerable identifier space. The key is required, and startup fails - * without one — but only when something actually consumes a fingerprint. There are two such - * consumers, telemetry and the management-plane audit trail, so the bean exists when either is on - * rather than being tied to metrics alone: an audit trail that pseudonymised its actors with an - * unkeyed 32-bit hash was the reason this had to be widened. - */ - @Bean - @ConditionalOnMissingBean - @Conditional(FileserverFingerprintConsumerCondition.class) - SafeFileFingerprint fileserverFingerprint(FileserverPlatformSettings properties) { - String key = properties.observability().fingerprintKey(); - if (key == null || key.isBlank()) { - throw StartupFailures.envValidation( - FileserverPlatformSettings.PREFIX - + ".observability.fingerprint-key must be configured while metrics are enabled: an " - + "unkeyed digest of an enumerable identifier is reversible"); - } - return new SafeFileFingerprint(key.getBytes(StandardCharsets.UTF_8)); - } - - @Bean - @ConditionalOnMissingBean - @ConditionalOnProperty( - prefix = FileserverPlatformSettings.PREFIX + ".observability", - name = "metrics-enabled", - havingValue = "true", - matchIfMissing = true) - FileserverMetricsPort fileserverMetrics(MeterRegistry registry) { - return new MicrometerFileserverMetrics(registry); - } } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverPlatformSettingsBinder.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverPlatformSettingsBinder.java index 599e24fb..a0d6ada8 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverPlatformSettingsBinder.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverPlatformSettingsBinder.java @@ -1,6 +1,6 @@ package dev.caskeleton.bootstrap.autoconfigure.fileserver; -import dev.caskeleton.bootstrap.autoconfigure.StrictSettingsBinder; +import dev.caskeleton.adapter.outbound.support.StrictSettingsBinder; import org.springframework.core.env.Environment; /** diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverProtocolConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverProtocolConfiguration.java new file mode 100644 index 00000000..73e34585 --- /dev/null +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverProtocolConfiguration.java @@ -0,0 +1,73 @@ +package dev.caskeleton.bootstrap.autoconfigure.fileserver; + +import dev.caskeleton.adapter.inbound.web.fileserver.draft12.Draft12Properties; +import dev.caskeleton.adapter.inbound.web.fileserver.tus.TusChecksumVerifier; +import dev.caskeleton.adapter.inbound.web.fileserver.tus.TusProperties; +import dev.caskeleton.adapter.inbound.web.fileserver.tus.TusRequestParser; +import java.util.List; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +@Configuration(proxyBeanMethods = false) +class FileserverProtocolConfiguration { + + /** + * tus support objects, contributed only when both this switch and the master switch are on. + * + *

    The nesting is the fix: previously the protocol's own flag was the only condition, so + * enabling tus in a deployment with the Fileserver off produced a controller with no service + * behind it. + */ + @Bean + @ConditionalOnMissingBean + @ConditionalOnProperty( + prefix = FileserverPlatformSettings.PREFIX + ".tus", + name = "enabled", + havingValue = "true") + TusProperties fileserverTusProperties(FileserverPlatformSettings properties) { + return new TusProperties( + TusProperties.RESUMABLE_VERSION, + List.of("creation", "expiration", "checksum", "termination"), + properties.upload().maxFileSize().toBytes(), + properties.upload().ttl()); + } + + @Bean + @ConditionalOnMissingBean + @ConditionalOnProperty( + prefix = FileserverPlatformSettings.PREFIX + ".tus", + name = "enabled", + havingValue = "true") + TusRequestParser fileserverTusRequestParser(TusProperties tusProperties) { + return new TusRequestParser(tusProperties); + } + + @Bean + @ConditionalOnMissingBean + @ConditionalOnProperty( + prefix = FileserverPlatformSettings.PREFIX + ".tus", + name = "enabled", + havingValue = "true") + TusChecksumVerifier fileserverTusChecksumVerifier() { + return new TusChecksumVerifier(); + } + + /** + * Settings for the experimental draft, which previously had no production binding at all. + * + *

    The controller existed and could be switched on, but nothing built the properties it needs, + * so the switch produced a startup failure rather than a protocol. + */ + @Bean + @ConditionalOnMissingBean + @ConditionalOnProperty( + prefix = FileserverPlatformSettings.PREFIX + ".httpbis-draft12", + name = "enabled", + havingValue = "true") + Draft12Properties fileserverDraft12Properties(FileserverPlatformSettings properties) { + return new Draft12Properties( + true, properties.upload().maxFileSize().toBytes(), properties.upload().ttl(), false); + } +} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverSecurityConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverSecurityConfiguration.java index bcc76234..c4939522 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverSecurityConfiguration.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverSecurityConfiguration.java @@ -7,6 +7,7 @@ import dev.caskeleton.adapter.outbound.fileserver.platform.security.UnenforcedFi import dev.caskeleton.application.fileserver.admin.AdminAuditPort; import dev.caskeleton.application.fileserver.api.security.FileAccessPolicy; import dev.caskeleton.application.fileserver.observability.FileserverAuditPort; +import dev.caskeleton.bootstrap.runtime.RuntimeProfileSnapshot; import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; import dev.caskeleton.shared.runtime.RuntimeEnvironment; import java.util.LinkedHashSet; @@ -78,7 +79,7 @@ public class FileserverSecurityConfiguration { } private static FileAccessPolicy unenforcedOrFail(Environment environment) { - if (RuntimeEnvironment.isProductionActive(List.of(environment.getActiveProfiles()))) { + if (RuntimeProfileSnapshot.from(environment).isProduction()) { throw StartupFailures.profileMismatch( "app.fileserver-platform.security.access-policy=unenforced authorizes every file " + "operation and must not be active under the '" diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverServiceConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverServiceConfiguration.java index 06d7937d..c4886b33 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverServiceConfiguration.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverServiceConfiguration.java @@ -1,314 +1,13 @@ package dev.caskeleton.bootstrap.autoconfigure.fileserver; -import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalBlockingContentStore; -import dev.caskeleton.adapter.outbound.identifier.RandomUploadIdentifierFactory; -import dev.caskeleton.application.fileserver.admin.AdminAuditPort; -import dev.caskeleton.application.fileserver.admin.DefaultFileserverAdminService; -import dev.caskeleton.application.fileserver.admin.FileserverAdminService; -import dev.caskeleton.application.fileserver.admin.OrphanScanPort; -import dev.caskeleton.application.fileserver.admin.StorageHealthPort; -import dev.caskeleton.application.fileserver.api.metadata.FileMetadataStore; -import dev.caskeleton.application.fileserver.api.metadata.FileQuotaService; -import dev.caskeleton.application.fileserver.api.metadata.UploadSessionStore; -import dev.caskeleton.application.fileserver.api.security.FileAccessPolicy; -import dev.caskeleton.application.fileserver.api.security.OriginalFilenamePolicy; -import dev.caskeleton.application.fileserver.api.transfer.ConditionalRequestEvaluator; -import dev.caskeleton.application.fileserver.api.transfer.ContentDispositionFactory; -import dev.caskeleton.application.fileserver.cleanup.CleanupContentGateway; -import dev.caskeleton.application.fileserver.cleanup.CleanupQueue; -import dev.caskeleton.application.fileserver.cleanup.CleanupService; -import dev.caskeleton.application.fileserver.cleanup.DefaultCleanupService; -import dev.caskeleton.application.fileserver.cleanup.QuotaReclaimGateway; -import dev.caskeleton.application.fileserver.concurrency.DefaultWriterLeaseCoordinator; -import dev.caskeleton.application.fileserver.concurrency.WriterLeaseCoordinator; -import dev.caskeleton.application.fileserver.download.DefaultDownloadApplicationService; -import dev.caskeleton.application.fileserver.download.DownloadApplicationService; -import dev.caskeleton.application.fileserver.download.DownloadContentGateway; -import dev.caskeleton.application.fileserver.download.DownloadPolicy; -import dev.caskeleton.application.fileserver.download.ZeroCopyDownloadGateway; -import dev.caskeleton.application.fileserver.lifecycle.CopyContentGateway; -import dev.caskeleton.application.fileserver.lifecycle.DefaultFileLifecycleService; -import dev.caskeleton.application.fileserver.lifecycle.FileLifecycleService; -import dev.caskeleton.application.fileserver.observability.FileserverMetricsPort; -import dev.caskeleton.application.fileserver.observability.SafeFileFingerprint; -import dev.caskeleton.application.fileserver.quota.DefaultTransferAdmissionController; -import dev.caskeleton.application.fileserver.quota.StorageUsageProbe; -import dev.caskeleton.application.fileserver.quota.TransferAdmissionController; -import dev.caskeleton.application.fileserver.quota.TransferAdmissionProperties; -import dev.caskeleton.application.fileserver.recovery.DefaultFileReconciliationService; -import dev.caskeleton.application.fileserver.recovery.FileReconciliationService; -import dev.caskeleton.application.fileserver.recovery.ReconciliationContentProbe; -import dev.caskeleton.application.fileserver.recovery.RecoveryQueue; -import dev.caskeleton.application.fileserver.upload.DefaultFinalizeUploadService; -import dev.caskeleton.application.fileserver.upload.DefaultSingleShotUploadService; -import dev.caskeleton.application.fileserver.upload.DefaultUploadApplicationService; -import dev.caskeleton.application.fileserver.upload.FileVerificationService; -import dev.caskeleton.application.fileserver.upload.FinalizeUploadService; -import dev.caskeleton.application.fileserver.upload.QuotaCommitGateway; -import dev.caskeleton.application.fileserver.upload.SingleShotUploadService; -import dev.caskeleton.application.fileserver.upload.UploadApplicationService; -import dev.caskeleton.application.fileserver.upload.UploadContentGateway; -import dev.caskeleton.application.fileserver.upload.UploadIdentifierFactory; -import dev.caskeleton.application.fileserver.upload.UploadPolicy; -import dev.caskeleton.application.fileserver.upload.UploadStorageGateway; -import dev.caskeleton.application.transaction.TransactionPort; -import java.time.Clock; -import java.util.Optional; -import org.springframework.beans.factory.ObjectProvider; -import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; -import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; -import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; +import org.springframework.context.annotation.Import; -/** - * Assembles the application services from their ports. - * - *

    Every service here is a plain object built by constructor. The application layer never - * discovers its collaborators, so this class is the single place where the capability's shape is - * decided — which also means a missing port is a startup failure with a readable bean name rather - * than a null at the first upload. - * - *

    The effective publish mode handed to finalization comes from the store rather than from - * configuration, because the store already reconciled the configured intent against what the - * startup probe could prove. - */ +/** Application-service composition aggregator split by runtime concern. */ @Configuration(proxyBeanMethods = false) -public class FileserverServiceConfiguration { - - /** - * Instrumentation is optional; the services are not. - * - *

    Metrics can be switched off, and when they are there is no {@code FileserverMetricsPort} - * bean. Injecting it directly would make every service depend on telemetry being enabled, so the - * no-op stands in — which is also what stops the ports from being dead code the way they were - * when nothing called them at all. - */ - private static FileserverMetricsPort metricsOrNoop( - ObjectProvider metrics) { - return metrics.getIfAvailable(FileserverMetricsPort::noop); - } - - @Bean - @ConditionalOnMissingBean - UploadIdentifierFactory fileserverIdentifierFactory() { - return new RandomUploadIdentifierFactory(); - } - - @Bean - @ConditionalOnMissingBean - TransferAdmissionProperties fileserverAdmissionProperties(FileserverPlatformSettings settings) { - FileserverPlatformSettings.Quota quota = settings.quota(); - return new TransferAdmissionProperties( - quota.instanceUploadPermits(), - quota.scopeUploadPermits(), - quota.directDownloadPermits(), - quota.softHighWater(), - quota.hardHighWater()); - } - - @Bean - @ConditionalOnMissingBean - TransferAdmissionController fileserverAdmissionController( - TransferAdmissionProperties properties, - StorageUsageProbe usageProbe, - FileserverPlatformSettings settings) { - return new DefaultTransferAdmissionController( - properties, usageProbe, settings.upload().maxFileSize().toBytes()); - } - - @Bean - @ConditionalOnMissingBean - UploadApplicationService fileserverUploadService( - FileMetadataStore metadataStore, - UploadSessionStore sessionStore, - WriterLeaseCoordinator leaseCoordinator, - UploadStorageGateway storageGateway, - FileQuotaService quotaService, - TransferAdmissionController admissionController, - FileAccessPolicy accessPolicy, - OriginalFilenamePolicy filenamePolicy, - CleanupQueue cleanupQueue, - UploadIdentifierFactory identifierFactory, - UploadPolicy uploadPolicy, - ObjectProvider metrics, - TransactionPort transactions, - Clock clock) { - return new DefaultUploadApplicationService( - metadataStore, - sessionStore, - leaseCoordinator, - storageGateway, - quotaService, - admissionController, - accessPolicy, - filenamePolicy, - cleanupQueue, - identifierFactory, - uploadPolicy, - metricsOrNoop(metrics), - transactions, - clock); - } - - @Bean - @ConditionalOnMissingBean - FinalizeUploadService fileserverFinalizeService( - FileMetadataStore metadataStore, - UploadSessionStore sessionStore, - UploadContentGateway contentGateway, - FileVerificationService verificationService, - QuotaCommitGateway quotaGateway, - CleanupQueue cleanupQueue, - RecoveryQueue recoveryQueue, - LocalBlockingContentStore store, - TransactionPort transactions, - Clock clock) { - return new DefaultFinalizeUploadService( - metadataStore, - sessionStore, - contentGateway, - verificationService, - quotaGateway, - cleanupQueue, - recoveryQueue, - store.effectivePublishMode(), - transactions, - clock); - } - - @Bean - @ConditionalOnMissingBean - SingleShotUploadService fileserverSingleShotUploadService( - UploadApplicationService uploadService, FinalizeUploadService finalizeService) { - return new DefaultSingleShotUploadService(uploadService, finalizeService); - } - - @Bean - @ConditionalOnMissingBean - DownloadApplicationService fileserverDownloadService( - FileMetadataStore metadataStore, - DownloadContentGateway contentGateway, - FileAccessPolicy accessPolicy, - ConditionalRequestEvaluator conditionalEvaluator, - ContentDispositionFactory dispositionFactory, - DownloadPolicy policy, - ZeroCopyDownloadGateway zeroCopyGateway, - ObjectProvider metrics) { - return new DefaultDownloadApplicationService( - metadataStore, - contentGateway, - accessPolicy, - conditionalEvaluator, - dispositionFactory, - policy, - Optional.of(zeroCopyGateway), - metricsOrNoop(metrics)); - } - - @Bean - @ConditionalOnMissingBean - FileLifecycleService fileserverLifecycleService( - FileMetadataStore metadataStore, - CopyContentGateway copyGateway, - FileAccessPolicy accessPolicy, - OriginalFilenamePolicy filenamePolicy, - CleanupQueue cleanupQueue, - UploadIdentifierFactory identifierFactory, - TransactionPort transactions, - Clock clock) { - return new DefaultFileLifecycleService( - metadataStore, - copyGateway, - accessPolicy, - filenamePolicy, - cleanupQueue, - identifierFactory, - transactions, - clock); - } - - @Bean - @ConditionalOnMissingBean - CleanupService fileserverCleanupService( - CleanupQueue queue, - CleanupContentGateway contentGateway, - FileMetadataStore metadataStore, - UploadSessionStore sessionStore, - QuotaReclaimGateway quotaGateway, - FileserverPlatformSettings settings, - ObjectProvider metrics, - TransactionPort transactions, - Clock clock) { - return new DefaultCleanupService( - queue, - contentGateway, - metadataStore, - sessionStore, - quotaGateway, - settings.cleanup().retryBackoff(), - metricsOrNoop(metrics), - transactions, - clock); - } - - @Bean - @ConditionalOnMissingBean - FileReconciliationService fileserverReconciliationService( - FileMetadataStore metadataStore, - ReconciliationContentProbe contentProbe, - RecoveryQueue recoveryQueue, - TransactionPort transactions, - Clock clock) { - return new DefaultFileReconciliationService( - metadataStore, contentProbe, recoveryQueue, transactions, clock); - } - - @Bean - @ConditionalOnMissingBean - WriterLeaseCoordinator fileserverWriterLeaseCoordinator( - UploadSessionStore sessionStore, - UploadPolicy uploadPolicy, - TransactionPort transactions, - Clock clock) { - return new DefaultWriterLeaseCoordinator( - sessionStore, uploadPolicy.leaseDuration(), transactions, clock); - } - - /** - * The management plane, gated on its own switch. - * - *

    Admin is a separate decision from the data plane: a deployment that serves files does not - * automatically want an endpoint that can force-delete them. - */ - @Bean - @ConditionalOnMissingBean - @ConditionalOnProperty( - prefix = "app.fileserver-platform.admin", - name = "enabled", - havingValue = "true") - FileserverAdminService fileserverAdminService( - StorageHealthPort healthPort, - OrphanScanPort orphanScanPort, - FileMetadataStore metadataStore, - UploadSessionStore sessionStore, - CleanupQueue cleanupQueue, - CleanupService cleanupService, - FileAccessPolicy accessPolicy, - AdminAuditPort auditPort, - SafeFileFingerprint fingerprint, - TransactionPort transactions, - Clock clock) { - return new DefaultFileserverAdminService( - healthPort, - orphanScanPort, - metadataStore, - sessionStore, - cleanupQueue, - cleanupService, - accessPolicy, - auditPort, - fingerprint, - transactions, - clock); - } -} +@Import({ + FileserverUploadServiceConfiguration.class, + FileserverDownloadLifecycleConfiguration.class, + FileserverMaintenanceServiceConfiguration.class +}) +class FileserverServiceConfiguration {} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverStartupConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverStartupConfiguration.java index d93e62e8..c13b16bd 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverStartupConfiguration.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverStartupConfiguration.java @@ -7,8 +7,7 @@ import dev.caskeleton.adapter.outbound.fileserver.platform.security.UnenforcedFi import dev.caskeleton.application.fileserver.api.metadata.FileMetadataStore; import dev.caskeleton.application.fileserver.api.security.FileAccessPolicy; import dev.caskeleton.application.fileserver.upload.FileVerificationService; -import dev.caskeleton.shared.runtime.RuntimeEnvironment; -import java.util.List; +import dev.caskeleton.bootstrap.runtime.RuntimeProfileSnapshot; import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; @@ -86,6 +85,6 @@ public class FileserverStartupConfiguration { } private static boolean isProductionProfile(Environment environment) { - return RuntimeEnvironment.isProductionActive(List.of(environment.getActiveProfiles())); + return RuntimeProfileSnapshot.from(environment).isProduction(); } } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverStorageConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverStorageConfiguration.java index fd947c93..f7b82083 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverStorageConfiguration.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverStorageConfiguration.java @@ -1,286 +1,14 @@ package dev.caskeleton.bootstrap.autoconfigure.fileserver; -import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalBlockingContentStore; -import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalCleanupContentGateway; -import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalCopyContentGateway; -import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalDownloadContentGateway; -import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalOrphanScanAdapter; -import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalReconciliationContentProbe; -import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalStorageCapabilityProbe; -import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalStorageHealthAdapter; -import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalStorageProbeResult; -import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalStorageProperties; -import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalStorageUsageProbe; -import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalUploadContentGateway; -import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalUploadStorageGateway; -import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalZeroCopyDownloadGateway; -import dev.caskeleton.adapter.outbound.fileserver.platform.verification.FilenamePolicyVerifier; -import dev.caskeleton.adapter.outbound.fileserver.platform.verification.LengthVerifier; -import dev.caskeleton.adapter.outbound.fileserver.platform.verification.LocalVerificationContentReader; -import dev.caskeleton.adapter.outbound.fileserver.platform.verification.MediaTypeVerifier; -import dev.caskeleton.adapter.outbound.fileserver.platform.verification.ScriptableContentPolicy; -import dev.caskeleton.adapter.outbound.fileserver.platform.verification.Sha256Verifier; -import dev.caskeleton.adapter.outbound.fileserver.platform.verification.VerificationContentReader; -import dev.caskeleton.adapter.outbound.fileserver.platform.verification.VerificationCoordinator; -import dev.caskeleton.adapter.outbound.persistence.fileserver.FileserverSchemaActivation; -import dev.caskeleton.application.fileserver.admin.ContentReferenceLedger; -import dev.caskeleton.application.fileserver.admin.OrphanScanPort; -import dev.caskeleton.application.fileserver.admin.StorageHealthPort; -import dev.caskeleton.application.fileserver.api.DefaultFileStateMachine; -import dev.caskeleton.application.fileserver.api.FileStateMachine; -import dev.caskeleton.application.fileserver.api.content.PublishMode; -import dev.caskeleton.application.fileserver.api.metadata.FileMetadataStore; -import dev.caskeleton.application.fileserver.api.metadata.UploadSessionStore; -import dev.caskeleton.application.fileserver.api.security.FileVerifier; -import dev.caskeleton.application.fileserver.api.security.OriginalFilenamePolicy; -import dev.caskeleton.application.fileserver.cleanup.CleanupContentGateway; -import dev.caskeleton.application.fileserver.download.DownloadContentGateway; -import dev.caskeleton.application.fileserver.download.ZeroCopyDownloadGateway; -import dev.caskeleton.application.fileserver.lifecycle.CopyContentGateway; -import dev.caskeleton.application.fileserver.quota.StorageUsageProbe; -import dev.caskeleton.application.fileserver.recovery.ReconciliationContentProbe; -import dev.caskeleton.application.fileserver.recovery.StagingUploadLocator; -import dev.caskeleton.application.fileserver.upload.FileVerificationService; -import dev.caskeleton.application.fileserver.upload.UploadContentGateway; -import dev.caskeleton.application.fileserver.upload.UploadStorageGateway; -import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; -import java.nio.file.Path; -import java.time.Clock; -import java.util.List; -import java.util.Locale; -import org.springframework.boot.autoconfigure.condition.ConditionalOnBean; -import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; -import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; -import org.springframework.jdbc.core.JdbcOperations; +import org.springframework.context.annotation.Import; -/** - * Binds the application's storage ports to the local filesystem platform. - * - *

    The capability probe runs once, at startup, and its result is a bean rather than a repeated - * call: every downstream decision — which publish strategy is legal, what the admin plane may - * advertise — has to be made from one consistent set of facts about the volume. Re-probing per - * request would let the answer change underneath a half-finished publish. - * - *

    Startup fails when the mandatory checks did not pass. A file capability that cannot create a - * file atomically, cannot keep staging and content on one FileStore, or follows symlinks is not - * degraded — it is unsafe, and starting anyway would defer that discovery to the first upload. - */ +/** Storage composition aggregator; concrete concerns remain separately reviewable. */ @Configuration(proxyBeanMethods = false) -public class FileserverStorageConfiguration { - - /** - * The three storage invariants are pinned, not configured. - * - *

    Staging and content on one file store, a refusal to follow symbolic links, and a force - * before publish are what make an atomic publish atomic and a namespace a boundary. A deployment - * that could switch them off would be running a different capability under the same name and the - * same tests, so they are constants here rather than settings. - */ - @Bean - @ConditionalOnMissingBean - LocalStorageProperties fileserverStorageProperties(FileserverPlatformSettings settings) { - FileserverPlatformSettings.Storage storage = settings.storage(); - requireStorageRootIsIsolated(storage); - return new LocalStorageProperties( - storage.root(), - publishMode(storage.publishMode()), - true, - true, - (int) storage.bufferSize().toBytes(), - settings.upload().maxFileSize().toBytes(), - true); - } - - /** - * Refuses to start until the Fileserver schema stream is applied and promoted. - * - *

    Paired with the storage probe below: one proves the volume can hold the bytes, the other - * proves the database sanctions the records. A capability that starts with either unproven fails - * on a user's first upload instead of on the deployment that caused it. - */ - @Bean - @ConditionalOnMissingBean - @ConditionalOnBean(JdbcOperations.class) - FileserverSchemaActivation fileserverSchemaActivation(JdbcOperations jdbc) { - FileserverSchemaActivation activation = new FileserverSchemaActivation(jdbc); - activation.requireActive(); - return activation; - } - - @Bean - @ConditionalOnMissingBean - LocalStorageProbeResult fileserverStorageProbeResult(LocalStorageProperties properties) { - LocalStorageProbeResult result = new LocalStorageCapabilityProbe(properties).run(); - if (!result.mandatoryChecksPassed()) { - throw StartupFailures.envValidation( - "fileserver storage root failed a mandatory capability probe: " - + result.failures() - + "; the capability refuses to start rather than publish files it cannot place " - + "atomically"); - } - return result; - } - - @Bean - @ConditionalOnMissingBean - LocalBlockingContentStore fileserverContentStore( - LocalStorageProperties properties, LocalStorageProbeResult probeResult) { - return new LocalBlockingContentStore(properties, probeResult); - } - - @Bean - @ConditionalOnMissingBean - UploadStorageGateway fileserverUploadStorageGateway(LocalBlockingContentStore store) { - return new LocalUploadStorageGateway(store); - } - - @Bean - @ConditionalOnMissingBean - UploadContentGateway fileserverUploadContentGateway( - LocalBlockingContentStore store, - FileMetadataStore metadataStore, - UploadSessionStore sessionStore, - FileserverPlatformSettings settings) { - return new LocalUploadContentGateway( - store, metadataStore, sessionStore, settings.upload().maxFileSize().toBytes()); - } - - @Bean - @ConditionalOnMissingBean - DownloadContentGateway fileserverDownloadContentGateway(LocalBlockingContentStore store) { - return new LocalDownloadContentGateway(store); - } - - @Bean - @ConditionalOnMissingBean - CopyContentGateway fileserverCopyContentGateway( - LocalBlockingContentStore store, FileserverPlatformSettings settings) { - return new LocalCopyContentGateway(store, settings.upload().maxFileSize().toBytes()); - } - - @Bean - @ConditionalOnMissingBean - CleanupContentGateway fileserverCleanupContentGateway(LocalBlockingContentStore store) { - return new LocalCleanupContentGateway(store); - } - - @Bean - @ConditionalOnMissingBean - ZeroCopyDownloadGateway fileserverZeroCopyDownloadGateway(LocalBlockingContentStore store) { - return new LocalZeroCopyDownloadGateway(store); - } - - @Bean - @ConditionalOnMissingBean - StorageHealthPort fileserverStorageHealth( - LocalStorageProperties properties, - LocalStorageProbeResult probeResult, - LocalBlockingContentStore store) { - return new LocalStorageHealthAdapter(properties, probeResult, store); - } - - @Bean - @ConditionalOnMissingBean - OrphanScanPort fileserverOrphanScan( - ContentReferenceLedger ledger, - LocalStorageProperties properties, - FileserverPlatformSettings settings, - Clock clock) { - return new LocalOrphanScanAdapter( - ledger, properties, settings.admin().orphanMinimumAge(), clock); - } - - @Bean - @ConditionalOnMissingBean - StorageUsageProbe fileserverStorageUsageProbe(LocalStorageProperties properties) { - return new LocalStorageUsageProbe(properties.root()); - } - - @Bean - @ConditionalOnMissingBean - ReconciliationContentProbe fileserverReconciliationProbe( - LocalBlockingContentStore store, StagingUploadLocator stagingLocator) { - return new LocalReconciliationContentProbe(store, stagingLocator); - } - - @Bean - @ConditionalOnMissingBean - OriginalFilenamePolicy fileserverFilenamePolicy() { - return OriginalFilenamePolicy.standard(); - } - - /** - * The transition table, shared by everything that changes a file's state. - * - *

    One instance rather than one per store. The metadata store rejects an illegal transition - * before it reaches SQL, and a second copy of the table is a second place for the legal edges to - * drift. - */ - @Bean - @ConditionalOnMissingBean - FileStateMachine fileserverStateMachine() { - return new DefaultFileStateMachine(); - } - - @Bean - @ConditionalOnMissingBean - VerificationContentReader fileserverVerificationContentReader(LocalBlockingContentStore store) { - return new LocalVerificationContentReader(store); - } - - /** - * The verification chain, in the order the design fixes. - * - *

    Order does not change the verdict — precedence over the collected results does that — but it - * does decide how much work a doomed upload causes. The cheap structural checks run before the - * ones that read content. - */ - @Bean - @ConditionalOnMissingBean - FileVerificationService fileserverVerificationService( - VerificationContentReader contentReader, - OriginalFilenamePolicy filenamePolicy, - FileserverPlatformSettings settings) { - List verifiers = - List.of( - new LengthVerifier(settings.upload().maxFileSize().toBytes()), - new Sha256Verifier(), - new FilenamePolicyVerifier(filenamePolicy), - new MediaTypeVerifier(contentReader, settings.verification().requireMediaTypeVerdict()), - new ScriptableContentPolicy( - contentReader, settings.verification().inlineSafeProfile())); - return new VerificationCoordinator(verifiers, settings.verification().timeout()); - } - - /** - * Refuses a storage root that overlaps something the process already serves or reads. - * - *

    A root under a web root turns every upload into a published file; a root under a - * configuration directory turns one into a configuration change. Both are checked here because - * the path is only known once, at binding time. - */ - private static void requireStorageRootIsIsolated(FileserverPlatformSettings.Storage storage) { - Path root = storage.root().toAbsolutePath().normalize(); - for (Path forbidden : storage.forbiddenRootAncestors()) { - Path ancestor = forbidden.toAbsolutePath().normalize(); - if (root.startsWith(ancestor)) { - throw StartupFailures.envValidation( - "fileserver storage root must not live under a configured forbidden ancestor"); - } - } - } - - private static PublishMode publishMode(String configured) { - String canonical = configured.trim().toUpperCase(Locale.ROOT).replace('-', '_'); - try { - return PublishMode.valueOf(canonical); - } catch (IllegalArgumentException unknown) { - throw StartupFailures.envValidation( - FileserverPlatformSettings.PREFIX - + ".storage.publish-mode must be one of atomic-move-required, " - + "atomic-move-preferred, metadata-pointer", - unknown); - } - } -} +@Import({ + FileserverLocalStorageCoreConfiguration.class, + FileserverStorageGatewayConfiguration.class, + FileserverStorageOperationsConfiguration.class, + FileserverVerificationConfiguration.class +}) +class FileserverStorageConfiguration {} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverStorageGatewayConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverStorageGatewayConfiguration.java new file mode 100644 index 00000000..1e8bb60d --- /dev/null +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverStorageGatewayConfiguration.java @@ -0,0 +1,66 @@ +package dev.caskeleton.bootstrap.autoconfigure.fileserver; + +import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalBlockingContentStore; +import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalCleanupContentGateway; +import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalCopyContentGateway; +import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalDownloadContentGateway; +import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalUploadContentGateway; +import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalUploadStorageGateway; +import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalZeroCopyDownloadGateway; +import dev.caskeleton.application.fileserver.api.metadata.FileMetadataStore; +import dev.caskeleton.application.fileserver.api.metadata.UploadSessionStore; +import dev.caskeleton.application.fileserver.cleanup.CleanupContentGateway; +import dev.caskeleton.application.fileserver.download.DownloadContentGateway; +import dev.caskeleton.application.fileserver.download.ZeroCopyDownloadGateway; +import dev.caskeleton.application.fileserver.lifecycle.CopyContentGateway; +import dev.caskeleton.application.fileserver.upload.UploadContentGateway; +import dev.caskeleton.application.fileserver.upload.UploadStorageGateway; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +@Configuration(proxyBeanMethods = false) +class FileserverStorageGatewayConfiguration { + + @Bean + @ConditionalOnMissingBean + UploadStorageGateway fileserverUploadStorageGateway(LocalBlockingContentStore store) { + return new LocalUploadStorageGateway(store); + } + + @Bean + @ConditionalOnMissingBean + UploadContentGateway fileserverUploadContentGateway( + LocalBlockingContentStore store, + FileMetadataStore metadataStore, + UploadSessionStore sessionStore, + FileserverPlatformSettings settings) { + return new LocalUploadContentGateway( + store, metadataStore, sessionStore, settings.upload().maxFileSize().toBytes()); + } + + @Bean + @ConditionalOnMissingBean + DownloadContentGateway fileserverDownloadContentGateway(LocalBlockingContentStore store) { + return new LocalDownloadContentGateway(store); + } + + @Bean + @ConditionalOnMissingBean + CopyContentGateway fileserverCopyContentGateway( + LocalBlockingContentStore store, FileserverPlatformSettings settings) { + return new LocalCopyContentGateway(store, settings.upload().maxFileSize().toBytes()); + } + + @Bean + @ConditionalOnMissingBean + CleanupContentGateway fileserverCleanupContentGateway(LocalBlockingContentStore store) { + return new LocalCleanupContentGateway(store); + } + + @Bean + @ConditionalOnMissingBean + ZeroCopyDownloadGateway fileserverZeroCopyDownloadGateway(LocalBlockingContentStore store) { + return new LocalZeroCopyDownloadGateway(store); + } +} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverStorageOperationsConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverStorageOperationsConfiguration.java new file mode 100644 index 00000000..81ae13f6 --- /dev/null +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverStorageOperationsConfiguration.java @@ -0,0 +1,56 @@ +package dev.caskeleton.bootstrap.autoconfigure.fileserver; + +import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalBlockingContentStore; +import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalOrphanScanAdapter; +import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalReconciliationContentProbe; +import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalStorageHealthAdapter; +import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalStorageProbeResult; +import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalStorageProperties; +import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalStorageUsageProbe; +import dev.caskeleton.application.fileserver.admin.ContentReferenceLedger; +import dev.caskeleton.application.fileserver.admin.OrphanScanPort; +import dev.caskeleton.application.fileserver.admin.StorageHealthPort; +import dev.caskeleton.application.fileserver.quota.StorageUsageProbe; +import dev.caskeleton.application.fileserver.recovery.ReconciliationContentProbe; +import dev.caskeleton.application.fileserver.recovery.StagingUploadLocator; +import java.time.Clock; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +@Configuration(proxyBeanMethods = false) +class FileserverStorageOperationsConfiguration { + + @Bean + @ConditionalOnMissingBean + StorageHealthPort fileserverStorageHealth( + LocalStorageProperties properties, + LocalStorageProbeResult probeResult, + LocalBlockingContentStore store) { + return new LocalStorageHealthAdapter(properties, probeResult, store); + } + + @Bean + @ConditionalOnMissingBean + OrphanScanPort fileserverOrphanScan( + ContentReferenceLedger ledger, + LocalStorageProperties properties, + FileserverPlatformSettings settings, + Clock clock) { + return new LocalOrphanScanAdapter( + ledger, properties, settings.admin().orphanMinimumAge(), clock); + } + + @Bean + @ConditionalOnMissingBean + StorageUsageProbe fileserverStorageUsageProbe(LocalStorageProperties properties) { + return new LocalStorageUsageProbe(properties.root()); + } + + @Bean + @ConditionalOnMissingBean + ReconciliationContentProbe fileserverReconciliationProbe( + LocalBlockingContentStore store, StagingUploadLocator stagingLocator) { + return new LocalReconciliationContentProbe(store, stagingLocator); + } +} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverUploadServiceConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverUploadServiceConfiguration.java new file mode 100644 index 00000000..b470a91d --- /dev/null +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverUploadServiceConfiguration.java @@ -0,0 +1,147 @@ +package dev.caskeleton.bootstrap.autoconfigure.fileserver; + +import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalBlockingContentStore; +import dev.caskeleton.adapter.outbound.identifier.RandomUploadIdentifierFactory; +import dev.caskeleton.application.fileserver.api.metadata.FileMetadataStore; +import dev.caskeleton.application.fileserver.api.metadata.FileQuotaService; +import dev.caskeleton.application.fileserver.api.metadata.UploadSessionStore; +import dev.caskeleton.application.fileserver.api.security.FileAccessPolicy; +import dev.caskeleton.application.fileserver.api.security.OriginalFilenamePolicy; +import dev.caskeleton.application.fileserver.cleanup.CleanupQueue; +import dev.caskeleton.application.fileserver.concurrency.DefaultWriterLeaseCoordinator; +import dev.caskeleton.application.fileserver.concurrency.WriterLeaseCoordinator; +import dev.caskeleton.application.fileserver.observability.FileserverMetricsPort; +import dev.caskeleton.application.fileserver.quota.DefaultTransferAdmissionController; +import dev.caskeleton.application.fileserver.quota.StorageUsageProbe; +import dev.caskeleton.application.fileserver.quota.TransferAdmissionController; +import dev.caskeleton.application.fileserver.quota.TransferAdmissionProperties; +import dev.caskeleton.application.fileserver.recovery.RecoveryQueue; +import dev.caskeleton.application.fileserver.upload.DefaultFinalizeUploadService; +import dev.caskeleton.application.fileserver.upload.DefaultSingleShotUploadService; +import dev.caskeleton.application.fileserver.upload.DefaultUploadApplicationService; +import dev.caskeleton.application.fileserver.upload.FileVerificationService; +import dev.caskeleton.application.fileserver.upload.FinalizeUploadService; +import dev.caskeleton.application.fileserver.upload.QuotaCommitGateway; +import dev.caskeleton.application.fileserver.upload.SingleShotUploadService; +import dev.caskeleton.application.fileserver.upload.UploadApplicationService; +import dev.caskeleton.application.fileserver.upload.UploadContentGateway; +import dev.caskeleton.application.fileserver.upload.UploadIdentifierFactory; +import dev.caskeleton.application.fileserver.upload.UploadPolicy; +import dev.caskeleton.application.fileserver.upload.UploadStorageGateway; +import dev.caskeleton.application.transaction.PolicyTransactionPort; +import dev.caskeleton.application.transaction.TransactionPort; +import java.time.Clock; +import org.springframework.beans.factory.ObjectProvider; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +@Configuration(proxyBeanMethods = false) +class FileserverUploadServiceConfiguration { + + @Bean + @ConditionalOnMissingBean + UploadIdentifierFactory fileserverIdentifierFactory() { + return new RandomUploadIdentifierFactory(); + } + + @Bean + @ConditionalOnMissingBean + TransferAdmissionProperties fileserverAdmissionProperties(FileserverPlatformSettings settings) { + FileserverPlatformSettings.Quota quota = settings.quota(); + return new TransferAdmissionProperties( + quota.instanceUploadPermits(), + quota.scopeUploadPermits(), + quota.directDownloadPermits(), + quota.softHighWater(), + quota.hardHighWater()); + } + + @Bean + @ConditionalOnMissingBean + TransferAdmissionController fileserverAdmissionController( + TransferAdmissionProperties properties, + StorageUsageProbe usageProbe, + FileserverPlatformSettings settings) { + return new DefaultTransferAdmissionController( + properties, usageProbe, settings.upload().maxFileSize().toBytes()); + } + + @Bean + @ConditionalOnMissingBean + UploadApplicationService fileserverUploadService( + FileMetadataStore metadataStore, + UploadSessionStore sessionStore, + WriterLeaseCoordinator leaseCoordinator, + UploadStorageGateway storageGateway, + FileQuotaService quotaService, + TransferAdmissionController admissionController, + FileAccessPolicy accessPolicy, + OriginalFilenamePolicy filenamePolicy, + CleanupQueue cleanupQueue, + UploadIdentifierFactory identifierFactory, + UploadPolicy uploadPolicy, + ObjectProvider metrics, + PolicyTransactionPort transactions, + Clock clock) { + return new DefaultUploadApplicationService( + metadataStore, + sessionStore, + leaseCoordinator, + storageGateway, + quotaService, + admissionController, + accessPolicy, + filenamePolicy, + cleanupQueue, + identifierFactory, + uploadPolicy, + FileserverMetricsSupport.metricsOrNoop(metrics), + transactions, + clock); + } + + @Bean + @ConditionalOnMissingBean + FinalizeUploadService fileserverFinalizeService( + FileMetadataStore metadataStore, + UploadSessionStore sessionStore, + UploadContentGateway contentGateway, + FileVerificationService verificationService, + QuotaCommitGateway quotaGateway, + CleanupQueue cleanupQueue, + RecoveryQueue recoveryQueue, + LocalBlockingContentStore store, + PolicyTransactionPort transactions, + Clock clock) { + return new DefaultFinalizeUploadService( + metadataStore, + sessionStore, + contentGateway, + verificationService, + quotaGateway, + cleanupQueue, + recoveryQueue, + store.effectivePublishMode(), + transactions, + clock); + } + + @Bean + @ConditionalOnMissingBean + SingleShotUploadService fileserverSingleShotUploadService( + UploadApplicationService uploadService, FinalizeUploadService finalizeService) { + return new DefaultSingleShotUploadService(uploadService, finalizeService); + } + + @Bean + @ConditionalOnMissingBean + WriterLeaseCoordinator fileserverWriterLeaseCoordinator( + UploadSessionStore sessionStore, + UploadPolicy uploadPolicy, + TransactionPort transactions, + Clock clock) { + return new DefaultWriterLeaseCoordinator( + sessionStore, uploadPolicy.leaseDuration(), transactions, clock); + } +} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverVerificationConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverVerificationConfiguration.java new file mode 100644 index 00000000..06ecddf8 --- /dev/null +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverVerificationConfiguration.java @@ -0,0 +1,73 @@ +package dev.caskeleton.bootstrap.autoconfigure.fileserver; + +import dev.caskeleton.adapter.outbound.fileserver.platform.local.LocalBlockingContentStore; +import dev.caskeleton.adapter.outbound.fileserver.platform.verification.FilenamePolicyVerifier; +import dev.caskeleton.adapter.outbound.fileserver.platform.verification.LengthVerifier; +import dev.caskeleton.adapter.outbound.fileserver.platform.verification.LocalVerificationContentReader; +import dev.caskeleton.adapter.outbound.fileserver.platform.verification.MediaTypeVerifier; +import dev.caskeleton.adapter.outbound.fileserver.platform.verification.ScriptableContentPolicy; +import dev.caskeleton.adapter.outbound.fileserver.platform.verification.Sha256Verifier; +import dev.caskeleton.adapter.outbound.fileserver.platform.verification.VerificationContentReader; +import dev.caskeleton.adapter.outbound.fileserver.platform.verification.VerificationCoordinator; +import dev.caskeleton.application.fileserver.api.DefaultFileStateMachine; +import dev.caskeleton.application.fileserver.api.FileStateMachine; +import dev.caskeleton.application.fileserver.api.security.FileVerifier; +import dev.caskeleton.application.fileserver.api.security.OriginalFilenamePolicy; +import dev.caskeleton.application.fileserver.upload.FileVerificationService; +import java.util.List; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +@Configuration(proxyBeanMethods = false) +class FileserverVerificationConfiguration { + + @Bean + @ConditionalOnMissingBean + OriginalFilenamePolicy fileserverFilenamePolicy() { + return OriginalFilenamePolicy.standard(); + } + + /** + * The transition table, shared by everything that changes a file's state. + * + *

    One instance rather than one per store. The metadata store rejects an illegal transition + * before it reaches SQL, and a second copy of the table is a second place for the legal edges to + * drift. + */ + @Bean + @ConditionalOnMissingBean + FileStateMachine fileserverStateMachine() { + return new DefaultFileStateMachine(); + } + + @Bean + @ConditionalOnMissingBean + VerificationContentReader fileserverVerificationContentReader(LocalBlockingContentStore store) { + return new LocalVerificationContentReader(store); + } + + /** + * The verification chain, in the order the design fixes. + * + *

    Order does not change the verdict — precedence over the collected results does that — but it + * does decide how much work a doomed upload causes. The cheap structural checks run before the + * ones that read content. + */ + @Bean + @ConditionalOnMissingBean + FileVerificationService fileserverVerificationService( + VerificationContentReader contentReader, + OriginalFilenamePolicy filenamePolicy, + FileserverPlatformSettings settings) { + List verifiers = + List.of( + new LengthVerifier(settings.upload().maxFileSize().toBytes()), + new Sha256Verifier(), + new FilenamePolicyVerifier(filenamePolicy), + new MediaTypeVerifier(contentReader, settings.verification().requireMediaTypeVerdict()), + new ScriptableContentPolicy( + contentReader, settings.verification().inlineSafeProfile())); + return new VerificationCoordinator(verifiers, settings.verification().timeout()); + } +} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverWebAssemblyConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverWebAssemblyConfiguration.java new file mode 100644 index 00000000..58573453 --- /dev/null +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverWebAssemblyConfiguration.java @@ -0,0 +1,38 @@ +package dev.caskeleton.bootstrap.autoconfigure.fileserver; + +import dev.caskeleton.adapter.inbound.web.fileserver.mapper.MultipartUploadRequestMapper; +import dev.caskeleton.adapter.inbound.web.fileserver.mapper.RawUploadRequestMapper; +import dev.caskeleton.adapter.inbound.web.fileserver.problem.FileserverProblemFactory; +import dev.caskeleton.adapter.inbound.web.fileserver.security.FileserverRequestContextFactory; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +@Configuration(proxyBeanMethods = false) +class FileserverWebAssemblyConfiguration { + + @Bean + @ConditionalOnMissingBean + FileserverRequestContextFactory fileserverRequestContextFactory( + FileserverPlatformSettings properties) { + return new FileserverRequestContextFactory(properties.instanceId()); + } + + @Bean + @ConditionalOnMissingBean + FileserverProblemFactory fileserverProblemFactory() { + return new FileserverProblemFactory(); + } + + @Bean + @ConditionalOnMissingBean + RawUploadRequestMapper fileserverRawUploadRequestMapper(FileserverPlatformSettings properties) { + return new RawUploadRequestMapper(properties.upload().requireContentLength()); + } + + @Bean + @ConditionalOnMissingBean + MultipartUploadRequestMapper fileserverMultipartUploadRequestMapper() { + return new MultipartUploadRequestMapper(); + } +} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyConfig.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyConfig.java index 018dcb92..c11b647d 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyConfig.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyConfig.java @@ -4,6 +4,7 @@ import dev.caskeleton.application.idempotency.IdempotencyExecutor; import dev.caskeleton.application.idempotency.IdempotencyStorePort; import java.time.Clock; import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.scheduling.annotation.EnableScheduling; @@ -12,19 +13,13 @@ import org.springframework.scheduling.annotation.EnableScheduling; * Wires idempotency execution. {@code @EnableScheduling} activates the {@code IdempotencyReaper}'s * scheduled purge. See README for the design rationale. */ -@Configuration +@Configuration(proxyBeanMethods = false) @EnableScheduling +@EnableConfigurationProperties(IdempotencySettings.class) +@ConditionalOnProperty(name = "ca-skeleton.capabilities.idempotency.provider", havingValue = "jdbc") public class IdempotencyConfig { @Bean - public Clock systemClock() { - return Clock.systemUTC(); - } - - @Bean - @ConditionalOnProperty( - name = "ca-skeleton.capabilities.idempotency.provider", - havingValue = "jdbc") public IdempotencyExecutor idempotencyExecutor( IdempotencyStorePort store, Clock clock, IdempotencySettings properties) { return new IdempotencyExecutor(store, clock, properties.ttl()); diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderSelectionConfig.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderSelectionConfig.java index 58c8ca94..1d6b4642 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderSelectionConfig.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderSelectionConfig.java @@ -7,9 +7,10 @@ import dev.caskeleton.application.idempotency.v2.IdempotencyStorePortV2; import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; import org.springframework.beans.factory.ObjectProvider; import org.springframework.beans.factory.SmartInitializingSingleton; +import org.springframework.boot.autoconfigure.AutoConfiguration; import org.springframework.boot.context.properties.EnableConfigurationProperties; import org.springframework.context.annotation.Bean; -import org.springframework.context.annotation.Configuration; +import org.springframework.context.annotation.Import; /** * Fail-fast exclusivity guard for the JDBC V1 provider and the two owner-safe V2 providers. @@ -33,8 +34,9 @@ import org.springframework.context.annotation.Configuration; * application.idempotency.v2} over the contract the stores implement, so the requirement is real * again rather than a demand nothing could satisfy. */ -@Configuration(proxyBeanMethods = false) +@AutoConfiguration @EnableConfigurationProperties(IdempotencyProviderSettings.class) +@Import({IdempotencyConfig.class, PostgreSqlIdempotencyProviderConfig.class}) public class IdempotencyProviderSelectionConfig { @Bean diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderSettings.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderSettings.java index c77da6f5..fa2b7da5 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderSettings.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderSettings.java @@ -9,7 +9,7 @@ public record IdempotencyProviderSettings(Provider provider) { @ConstructorBinding public IdempotencyProviderSettings { - provider = provider == null ? Provider.JDBC : provider; + provider = provider == null ? Provider.DISABLED : provider; } /** diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/PostgreSqlIdempotencyProviderConfig.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/PostgreSqlIdempotencyProviderConfig.java index 1ba12fdc..528740ca 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/PostgreSqlIdempotencyProviderConfig.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/PostgreSqlIdempotencyProviderConfig.java @@ -1,28 +1,19 @@ package dev.caskeleton.bootstrap.autoconfigure.idempotency; -import dev.caskeleton.adapter.outbound.persistence.postgresql.idempotency.PostgreSqlOwnerSafeIdempotencyStore; import dev.caskeleton.application.idempotency.v2.IdempotencyExecutorV2; import dev.caskeleton.application.idempotency.v2.IdempotencyStorePortV2; import java.time.Duration; import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.springframework.boot.context.properties.EnableConfigurationProperties; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; -import org.springframework.jdbc.core.JdbcOperations; /** - * Composes the owner-safe V2 request-replay store on the primary PostgreSQL data source. + * Composes the application-owned V2 request-replay lifecycle over the selected PostgreSQL store. * - *

    This is the selector the store never had. It carries no Spring stereotype of its own — both - * composition roots scan {@code dev.caskeleton.adapter}, and a stereotype there would register the - * store in every deployment including the ones running another provider or another vendor entirely - * — so the store can only become a bean here, under an explicit provider choice. - * - *

    The two conditions the choice needs are not both checkable at composition time. The property - * is checked here; the vendor and the capability's schema activation are checked by the store's - * guard before any statement runs, because both are facts about the database rather than about the - * configuration, and a startup probe would answer them once for a connection pool that outlives the - * answer. A wrong vendor or an unsanctioned stream therefore fails the first mutation closed rather - * than corrupting a row. + *

    The concrete store is assembled by the JPA leaf under the same provider selector and exposed + * only as {@code IdempotencyStorePortV2}. This application configuration owns the lifecycle policy + * layered over that port; it does not construct or import the PostgreSQL implementation. * *

    The lifecycle bounds come from the single registered idempotency TTL rather than from five new * keys. The processing lease is deliberately not derived from it: a lease is how long one attempt @@ -30,6 +21,7 @@ import org.springframework.jdbc.core.JdbcOperations; * not of how long its result stays replayable. */ @Configuration(proxyBeanMethods = false) +@EnableConfigurationProperties(IdempotencySettings.class) @ConditionalOnProperty( name = "ca-skeleton.capabilities.idempotency.provider", havingValue = "postgresql") @@ -49,17 +41,6 @@ public class PostgreSqlIdempotencyProviderConfig { /** The replay policy revision this schema stream enforces. */ private static final int POLICY_REVISION = 2; - /** - * The owner-safe store, on the application's own primary data source. - * - * @param jdbc the primary {@code JdbcOperations}; the store's transaction guard identifies its - * data source from it so a transaction opened on a different one cannot pass - */ - @Bean - IdempotencyStorePortV2 postgreSqlOwnerSafeIdempotencyStore(JdbcOperations jdbc) { - return new PostgreSqlOwnerSafeIdempotencyStore(jdbc); - } - /** * The request-replay lifecycle driven over the store. * diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/DataSourceRequirement.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/DataSourceRequirement.java index bf7d81af..592ab04a 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/DataSourceRequirement.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/DataSourceRequirement.java @@ -33,13 +33,14 @@ public final class DataSourceRequirement { if (isOn(environment, "ca-skeleton.outbox.enabled")) { reasons.add("ca-skeleton.outbox.enabled=true"); } - if ("jdbc" - .equalsIgnoreCase( - environment.getProperty("ca-skeleton.capabilities.idempotency.provider", "disabled"))) { - reasons.add("ca-skeleton.capabilities.idempotency.provider=jdbc"); + String idempotencyProvider = + environment.getProperty("ca-skeleton.capabilities.idempotency.provider", "disabled").trim(); + if ("jdbc".equalsIgnoreCase(idempotencyProvider) + || "postgresql".equalsIgnoreCase(idempotencyProvider)) { + reasons.add("ca-skeleton.capabilities.idempotency.provider=" + idempotencyProvider); } - if (isOn(environment, "ca-skeleton.lock.multi-instance-enabled")) { - reasons.add("ca-skeleton.lock.multi-instance-enabled=true"); + if (isOn(environment, "ca-skeleton.runtime.multi-instance-enabled")) { + reasons.add("ca-skeleton.runtime.multi-instance-enabled=true"); } if (isOn(environment, MasterSwitch.NOTIFICATION_PLATFORM.property()) && !"none" diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaDangerousConfigurationGuard.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaDangerousConfigurationGuard.java index 6d60e038..4a3a20f4 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaDangerousConfigurationGuard.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaDangerousConfigurationGuard.java @@ -1,8 +1,9 @@ package dev.caskeleton.bootstrap.autoconfigure.jpa; import dev.caskeleton.adapter.outbound.persistence.migration.FlywaySchemaPolicy; +import dev.caskeleton.bootstrap.runtime.RuntimeProfileSnapshot; import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; -import java.util.Arrays; +import java.util.List; import java.util.Objects; import org.springframework.core.env.Environment; @@ -66,10 +67,10 @@ public final class JpaDangerousConfigurationGuard { /** Whether the active profiles are all local convenience profiles. */ public boolean isLocalConvenience(Environment environment) { - String[] active = environment.getActiveProfiles(); - if (active.length == 0) { + List active = RuntimeProfileSnapshot.from(environment).activeProfiles(); + if (active.isEmpty()) { return false; } - return Arrays.stream(active).allMatch(safety::isLocalConvenience); + return active.stream().allMatch(safety::isLocalConvenience); } } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaOffAutoConfigurationImportFilter.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaOffAutoConfigurationImportFilter.java index e21cfb50..3df03cd5 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaOffAutoConfigurationImportFilter.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaOffAutoConfigurationImportFilter.java @@ -30,8 +30,7 @@ public final class JpaOffAutoConfigurationImportFilter "org.springframework.boot.jdbc.autoconfigure.health.DataSourceHealthContributorAutoConfiguration", "org.springframework.boot.jdbc.autoconfigure.metrics.DataSourcePoolMetricsAutoConfiguration", "org.springframework.boot.hibernate.autoconfigure.HibernateJpaAutoConfiguration", - "org.springframework.boot.jpa.autoconfigure.JpaBaseConfiguration", - "org.springframework.boot.data.jpa.autoconfigure.JpaRepositoriesAutoConfiguration", + "org.springframework.boot.data.jpa.autoconfigure.DataJpaRepositoriesAutoConfiguration", "org.springframework.boot.flyway.autoconfigure.FlywayAutoConfiguration"); private Environment environment; diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformAutoConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformAutoConfiguration.java index aa74a72a..c1ff1f08 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformAutoConfiguration.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformAutoConfiguration.java @@ -54,12 +54,18 @@ public final class JpaPlatformAutoConfiguration { public List capabilities() { return List.of( CapabilitySupport.stable(JpaCapability.TRANSACTION_RETRY), - CapabilitySupport.stable(JpaCapability.COMPLETION_EVIDENCE), + CapabilitySupport.advanced( + JpaCapability.COMPLETION_EVIDENCE, + "requires an application-owned completion-evidence/reconciliation composition"), CapabilitySupport.stable(JpaCapability.KEYSET_PAGINATION), - CapabilitySupport.stable(JpaCapability.BATCH), + CapabilitySupport.advanced( + JpaCapability.BATCH, + "requires hibernate.jdbc.batch_size > 0, ordering settings, statistics and JDBC batch instrumentation"), CapabilitySupport.stable(JpaCapability.SCHEMA_GATE), CapabilitySupport.stable(JpaCapability.RUNTIME_ROLE_VERIFICATION), - CapabilitySupport.stable(JpaCapability.OBSERVABILITY), + CapabilitySupport.advanced( + JpaCapability.OBSERVABILITY, + "requires explicit metrics/statistics collector composition"), CapabilitySupport.advanced( JpaCapability.POSTGRESQL_NATIVE_WRITE, "requires a registered statement"), CapabilitySupport.advanced(JpaCapability.POSTGRESQL_WORK_CLAIM, "requires a named queue"), diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformRuntimeAutoConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformRuntimeAutoConfiguration.java index 7cf25703..f6b60cee 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformRuntimeAutoConfiguration.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformRuntimeAutoConfiguration.java @@ -1,16 +1,10 @@ package dev.caskeleton.bootstrap.autoconfigure.jpa; -import dev.caskeleton.adapter.outbound.persistence.api.error.VendorFailureTranslator; -import dev.caskeleton.adapter.outbound.persistence.api.transaction.RetryEventListener; import dev.caskeleton.adapter.outbound.persistence.hibernate.HibernateProviderPolicy; import dev.caskeleton.adapter.outbound.persistence.security.PostgreSqlRuntimeRoleVerifier; -import dev.caskeleton.adapter.outbound.persistence.transaction.FullTransactionRetryCoordinator; -import dev.caskeleton.adapter.outbound.persistence.transaction.SpringJpaTransactionExecutor; -import java.time.Clock; import java.util.function.Supplier; import javax.sql.DataSource; import org.springframework.beans.factory.InitializingBean; -import org.springframework.beans.factory.ObjectProvider; import org.springframework.boot.autoconfigure.condition.ConditionalOnBean; import org.springframework.boot.autoconfigure.condition.ConditionalOnClass; import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; @@ -18,46 +12,18 @@ import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; import org.springframework.boot.context.properties.EnableConfigurationProperties; import org.springframework.context.annotation.Bean; import org.springframework.core.env.Environment; -import org.springframework.transaction.PlatformTransactionManager; /** - * Registers the Stable JPA platform as beans, which is what "auto-configuration" was missing. + * Application-owned JPA startup safety and management composition. * - *

    Three classes in this package were named {@code ...AutoConfiguration} and were plain - * factories: no {@code @AutoConfiguration}, no {@code @Bean}, and no entry in {@code - * AutoConfiguration.imports} — while {@code CaSkeletonApplication} deliberately excludes this - * package from component scanning, because auto-configuration is the only way it is meant to be - * entered. So the capability report listed transaction retry, completion evidence and observability - * as Stable, and the running context contained none of them. A developer could deploy code relying - * on retry that was never retried. + *

    The persistence leaf owns provider selection, vendor beans, transaction execution and retry. + * This configuration consumes those collaborators only to apply application deployment policy: + * unsafe JPA settings fail startup, the resolved datasource is reported through a sanitized + * actuator view, and application-owned safety settings stay in the composition root. * - *

    This class is the registration. The factories stay: they hold the composition decisions, and - * an application that wires its own composition root can still call them directly. What changes is - * that a default application now gets the beans. - * - *

    Whether this application has relational persistence at all is decided by {@code - * PersistenceJpaRootAutoConfiguration}, which imports this class. The condition below is narrower - * than it used to look: it gates the add-on beans this class contributes, and was renamed from - * {@code app.jpa-platform.enabled} because that name read like a whole-adapter switch while gating - * three convenience beans and defaulting to on. - * - *

    Conditions match what each bean actually needs. No {@code DataSource} means there is no - * database to report on; a foreign {@code PlatformTransactionManager} — a JTA setup, a chained - * manager — is kept, and the retry coordinator is built over whatever manager is present rather - * than replacing it. - * - *

    This class used to carry {@code @ConditionalOnBean(DataSource.class)}. It is imported by - * {@code PersistenceJpaRootAutoConfiguration} rather than auto-configured, so that condition was - * evaluated while the class was parsed — before the datasource bean definition existed — and was - * therefore false in every real deployment. All eight beans below silently disappeared, and nothing - * reported it because nothing depended on any of them. It surfaced only when the datasource - * validator was finally wired to a caller and the JPA Compose lane answered "No qualifying bean". - * - *

    The condition is removed rather than reordered: this class is reached only through the JPA - * root, which already carries the master switch, so "is there a datasource" has been answered yes - * by the time it is parsed. A bean here that needs one takes it as a parameter, and a missing - * datasource with the switch on is then a loud failure — which is the outcome that was wanted, - * rather than the layer vanishing. + *

    The add-on switch remains for these application-level diagnostics and guards. It does not + * control whether relational persistence exists; the capability master switch is {@code + * ca-skeleton.persistence-jpa.enabled} and is owned by the persistence leaf. */ @org.springframework.context.annotation.Configuration(proxyBeanMethods = false) @ConditionalOnClass(DataSource.class) @@ -65,25 +31,6 @@ import org.springframework.transaction.PlatformTransactionManager; @EnableConfigurationProperties(JpaSafetySettings.class) public class JpaPlatformRuntimeAutoConfiguration { - /** - * The Hibernate version policy, read from the provider actually on the classpath. - * - *

    A bean rather than a constructor call inside the composition, so an application pinning a - * different provider version can replace it without replacing the whole composition. - */ - @Bean - @ConditionalOnMissingBean - public HibernateProviderPolicy hibernateProviderPolicy() { - return HibernateProviderPolicy.fromClasspath(); - } - - /** The runtime-role privilege verifier. */ - @Bean - @ConditionalOnMissingBean - public PostgreSqlRuntimeRoleVerifier postgreSqlRuntimeRoleVerifier() { - return new PostgreSqlRuntimeRoleVerifier(); - } - /** The composition factory, exposed so an application can reuse its decisions. */ @Bean @ConditionalOnMissingBean @@ -139,56 +86,6 @@ public class JpaPlatformRuntimeAutoConfiguration { return new JpaPlatformEndpoint(reportSupplier); } - /** - * The programmatic transaction boundary, over whichever manager the application installed. - * - *

    The composed vendor's translator is taken when one exists. Without it the executor's chain - * has no SQLSTATE stage, so a serialization failure or deadlock stays a raw {@code - * DataAccessException}, never becomes the {@code JpaPersistenceException} the retry coordinator - * catches, and contention is not retried at all. - * - * @param vendorFailures the composed vendor's SQLSTATE translator, when a vendor registered one - */ - @Bean - @ConditionalOnMissingBean - @ConditionalOnBean(PlatformTransactionManager.class) - public SpringJpaTransactionExecutor jpaTransactionExecutor( - PlatformTransactionManager transactionManager, - Clock clock, - ObjectProvider vendorFailures) { - JpaTransactionAutoConfiguration composition = new JpaTransactionAutoConfiguration(clock); - VendorFailureTranslator vendor = vendorFailures.getIfAvailable(); - return vendor == null - ? composition.transactionExecutor(transactionManager) - : composition.transactionExecutor(transactionManager, vendor); - } - - /** The whole-transaction retry coordinator. */ - @Bean - @ConditionalOnMissingBean - @ConditionalOnBean(SpringJpaTransactionExecutor.class) - public FullTransactionRetryCoordinator jpaRetryCoordinator( - SpringJpaTransactionExecutor executor, RetryEventListener retryListener, Clock clock) { - return new JpaTransactionAutoConfiguration(clock) - .retryCoordinator( - executor, - dev.caskeleton.adapter.outbound.persistence.api.transaction.RetryProfile - .boundedContention("jpa-platform-default", 3), - retryListener); - } - - /** - * The retry listener. - * - *

    The interface's methods all have defaults, so an empty implementation is the honest "no - * observer wired" value; an application that wants retry telemetry supplies its own bean. - */ - @Bean - @ConditionalOnMissingBean - public RetryEventListener jpaRetryEventListener() { - return new RetryEventListener() {}; - } - /** Runs the dangerous-configuration guard during refresh. */ @Bean public InitializingBean jpaPlatformStartupCheck( diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaSafetySettings.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaSafetySettings.java index 53128480..b364e205 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaSafetySettings.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaSafetySettings.java @@ -1,5 +1,6 @@ package dev.caskeleton.bootstrap.autoconfigure.jpa; +import dev.caskeleton.shared.runtime.RuntimeEnvironment; import java.util.Set; import org.springframework.boot.context.properties.ConfigurationProperties; import org.springframework.boot.context.properties.bind.DefaultValue; @@ -15,8 +16,7 @@ import org.springframework.boot.context.properties.bind.DefaultValue; * *

    {@code localConvenienceProfiles} names the profiles where Open Session In View may be left on * — a developer running a template locally, and nothing else. It is a list rather than a boolean so - * that "on in local" cannot silently mean "on in staging" the first time someone reuses the profile - * name. + * that "on in local" cannot silently expand to another runtime environment when policy changes. */ @ConfigurationProperties(prefix = "app.jpa-platform") public record JpaSafetySettings( @@ -25,7 +25,8 @@ public record JpaSafetySettings( Set schemaMutatingProfiles) { /** The profiles that may run with OSIV enabled, when nothing else is configured. */ - public static final Set DEFAULT_LOCAL_PROFILES = Set.of("local", "test"); + public static final Set DEFAULT_LOCAL_PROFILES = + Set.of(RuntimeEnvironment.LOCAL.profileName(), RuntimeEnvironment.testProfileName()); public JpaSafetySettings { localConvenienceProfiles = diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/startup/MigrationStartupConfig.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/MigrationStartupConfig.java similarity index 86% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/startup/MigrationStartupConfig.java rename to src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/MigrationStartupConfig.java index a0827ffb..26c7fed1 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/startup/MigrationStartupConfig.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/MigrationStartupConfig.java @@ -1,5 +1,8 @@ -package dev.caskeleton.bootstrap.runtime.startup; +package dev.caskeleton.bootstrap.autoconfigure.jpa; +import dev.caskeleton.bootstrap.runtime.startup.FlywayProdSafetyValidator; +import dev.caskeleton.bootstrap.runtime.startup.MigrationStartupRunner; +import dev.caskeleton.bootstrap.runtime.startup.RequiredEnvironmentValidator; import dev.caskeleton.bootstrap.settings.RuntimeSafetySettings; import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; import org.springframework.boot.flyway.autoconfigure.FlywayMigrationStrategy; diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/PersistenceJpaRootAutoConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/PersistenceJpaRootAutoConfiguration.java index 66ac96aa..09790d80 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/PersistenceJpaRootAutoConfiguration.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/PersistenceJpaRootAutoConfiguration.java @@ -1,12 +1,6 @@ package dev.caskeleton.bootstrap.autoconfigure.jpa; -import dev.caskeleton.adapter.outbound.persistence.config.JpaAdapterComponentsConfig; import dev.caskeleton.adapter.outbound.persistence.config.PersistenceVendorSettings; -import dev.caskeleton.adapter.outbound.persistence.fileserver.FileserverJpaPersistenceConfig; -import dev.caskeleton.adapter.outbound.persistence.h2.H2PersistenceConfig; -import dev.caskeleton.adapter.outbound.persistence.notification.configuration.NotificationJpaPersistenceFacade; -import dev.caskeleton.adapter.outbound.persistence.postgresql.PostgreSqlPersistenceConfig; -import dev.caskeleton.bootstrap.runtime.startup.MigrationStartupConfig; import javax.sql.DataSource; import org.springframework.beans.factory.InitializingBean; import org.springframework.boot.autoconfigure.AutoConfiguration; @@ -16,89 +10,32 @@ import org.springframework.context.annotation.Import; import org.springframework.core.env.Environment; /** - * The one place that decides whether this application has relational persistence. + * Application startup policy layered over the leaf-owned relational persistence capability. * - *

    Every JPA configuration is reached through this import rather than through the component scan, - * so a bean added to any of them next month is gated without anyone remembering to repeat a - * condition. That is the difference between a capability that is off and a capability whose known - * beans are individually conditioned. + *

    The persistence leaf owns entity/repository discovery, vendor selection, optional capability + * persistence registrations, and reusable transaction/retry runtime. This root deliberately does + * not reconstruct those implementation details. * - *

    Both vendor configurations are named here, and each is the leaf\'s real entry point: a vendor - * config imports the core JPA config, not the reverse. Inverting that to give this class a single - * import produced a package cycle inside the leaf, so the export surface admits the two vendor - * packages instead. They are mutually exclusive on {@code ca-skeleton.persistence.vendor}, so - * naming both lets the selector decide which one assembles while the decision about - * whether there is a database stays here, in one place. - * - *

    The notification facade is named here only now that the payload is protected at rest. - * Importing it makes {@code JpaNotificationRequestStore} reachable, and that store used to write - * the accepted request's template variables to {@code notification_request.variables_payload} in - * plaintext — caller content that can be a reset code, an order total or an address (NTF-INT-007). - * It was wired here once before that was true; the at-rest contract test failed on exactly that - * fact, which is what it was written to do, and the wiring was reverted rather than the test - * relaxed. The envelope came first, {@code NotificationRecordMapper} now takes the protection as a - * required constructor argument, and only then does this import become a wiring rather than an - * exposure. - * - *

    {@code FileserverJpaPersistenceConfig} is named for a related reason. Its six entities map six - * {@code fs_*} tables that live only in {@code db/migration/jpa/fileserver}, a stream applied only - * when that capability is on, while the primary Flyway location creates none of them. They used to - * be in the unconditional entity scan, so {@code ddl-auto=validate} against real PostgreSQL failed - * on {@code fs_cleanup_item} in every deployment that had switched the capability off — which was - * every JPA-on Compose lane. The scan now carries the capability's own condition, and this is the - * only place that knows both that the capability is on and that a JPA vendor is composed. Neither - * the leaf's {@code config} package nor a component scan can register it: {@code config} may depend - * on {@code api} alone, and the whole persistence package is excluded from the root's scan. + *

    What remains application-owned is startup/deployment policy: migration startup sequencing, + * resolved datasource validation, OSIV/DDL safety, and the sanitized management view. The root + * carries the same master switch so those checks never bind or run while JPA is disabled; bean + * dependencies, not a reference to leaf-internal auto-configuration classes, provide runtime + * ordering. */ @AutoConfiguration @ConditionalOnProperty( prefix = "ca-skeleton.persistence-jpa", name = "enabled", havingValue = "true") -@Import({ - JpaAdapterComponentsConfig.class, - PostgreSqlPersistenceConfig.class, - H2PersistenceConfig.class, - FileserverJpaPersistenceConfig.class, - NotificationJpaPersistenceFacade.class, - MigrationStartupConfig.class, - JpaPlatformRuntimeAutoConfiguration.class -}) +@Import({MigrationStartupConfig.class, JpaPlatformRuntimeAutoConfiguration.class}) public class PersistenceJpaRootAutoConfiguration { /** - * Runs the datasource validator, which nothing used to run (JPA-INT-002). + * Validates the datasource the application actually resolved. * - *

    {@code JpaDataSourceProfileValidator} was created as a bean and never invoked: both of its - * methods were reachable only from their own unit test. A validator nobody calls is a comment — - * and this one would have failed every deployment if called, because the namespace it read was - * supplied by nothing. The two defects cancelled, which is the only reason the application - * started. - * - *

    Invoked from here rather than from the platform configuration so it runs exactly when JPA is - * on and never when it is off, and as an {@link InitializingBean} so the failure lands during - * startup rather than at whoever sends the first request. - * - *

    The vendor is read from the {@link Environment} rather than injected as {@code - * PersistenceVendorSettings}, because that type is not a registered bean here: the composition - * root's {@code @ConfigurationPropertiesScan} deliberately excludes the persistence package so an - * optional capability cannot bind — or reject — its detail settings in a deployment that never - * switched it on. The default matches {@code PostgreSqlPersistenceConfig}'s {@code matchIfMissing - * = true}: an unset selector is PostgreSQL, which is the vendor this configuration was - * unconditional about before the selector existed. - * - *

    The validator is constructed here rather than injected. It is stateless, and the bean that - * used to supply it comes from {@code JpaPlatformRuntimeAutoConfiguration}, which carries - * {@code @ConditionalOnBean(DataSource.class)} on a plain {@code @Configuration} imported by this - * root — a condition evaluated during configuration-class parsing, before the datasource bean - * definition is registered. That class therefore drops out silently in the real application, - * taking the whole JPA add-on layer with it. Depending on a bean from it would make this check - * disappear for the same reason the thing it checks disappeared. The condition-ordering defect is - * recorded separately; it is not this task's to fix quietly. - * - * @param dataSource the resolved datasource, injected so the database checked is the one in use - * @param environment the resolved environment, for the vendor selector - * @return the startup check + *

    The vendor selector is read from the environment because the persistence settings tree is + * intentionally bound only by the enabled leaf. PostgreSQL validation opens the resolved + * datasource during startup; H2 local-development selection skips the PostgreSQL product check. */ @Bean public InitializingBean jpaResolvedDataSourceCheck( diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/lock/DistributedLockConfig.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/lock/DistributedLockConfig.java index ac962913..86fdabe4 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/lock/DistributedLockConfig.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/lock/DistributedLockConfig.java @@ -4,16 +4,16 @@ import dev.caskeleton.application.lock.DistributedLockPort; import io.micrometer.core.instrument.MeterRegistry; import org.springframework.beans.factory.ObjectProvider; import org.springframework.beans.factory.annotation.Qualifier; +import org.springframework.boot.autoconfigure.AutoConfiguration; import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; import org.springframework.context.annotation.Bean; -import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.Primary; /** * Composition-root wiring for the distributed-lock metrics decorator. See README for the design * rationale. */ -@Configuration(proxyBeanMethods = false) +@AutoConfiguration public class DistributedLockConfig { /** diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/lock/MeteredDistributedLockPort.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/lock/MeteredDistributedLockPort.java index ba135f98..7e58bb0a 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/lock/MeteredDistributedLockPort.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/lock/MeteredDistributedLockPort.java @@ -1,5 +1,7 @@ package dev.caskeleton.bootstrap.autoconfigure.lock; +import static net.logstash.logback.argument.StructuredArguments.kv; + import dev.caskeleton.application.lock.DistributedLock; import dev.caskeleton.application.lock.DistributedLockPort; import dev.caskeleton.application.lock.LockAcquisitionTimeoutException; @@ -67,6 +69,8 @@ public final class MeteredDistributedLockPort implements DistributedLockPort { "distributed lock '{}' had already been released by lease expiry before close() " + "— another instance may have entered the critical section (D6 efficiency-lock boundary)", key, + kv("capability", "distributed-lock"), + kv("warning.kind", "lease-expired-before-close"), e); incrementLeaseExpired(); } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/mongo/MongoPlatformHealthConfig.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/mongo/MongoPlatformHealthConfig.java deleted file mode 100644 index e05bd94d..00000000 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/mongo/MongoPlatformHealthConfig.java +++ /dev/null @@ -1,37 +0,0 @@ -package dev.caskeleton.bootstrap.autoconfigure.mongo; - -import dev.caskeleton.adapter.outbound.mongo.autoconfigure.MongoPlatformHealthIndicator; -import org.springframework.boot.autoconfigure.condition.ConditionalOnBean; -import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; -import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; -import org.springframework.context.annotation.Bean; -import org.springframework.context.annotation.Configuration; - -/** - * Registers the Mongo platform's Actuator health contributor. - * - *

    Conditioned on the master switch as well as on the adapter's bean: with Mongo off there is no - * {@code MongoPlatformHealthIndicator} to delegate to, and a health entry for a capability the - * deployment does not run is a question an operator has to answer for nothing. - */ -@Configuration(proxyBeanMethods = false) -@ConditionalOnProperty( - prefix = "ca-skeleton.persistence-mongo", - name = "enabled", - havingValue = "true") -public class MongoPlatformHealthConfig { - - /** - * Returns the Actuator-visible contributor for the Mongo platform. - * - * @param platform the adapter's health view - * @return the contributor - */ - @Bean("mongoPlatformHealthContributor") - @ConditionalOnBean(MongoPlatformHealthIndicator.class) - @ConditionalOnMissingBean(MongoPlatformHealthContributor.class) - public MongoPlatformHealthContributor mongoPlatformHealthContributor( - MongoPlatformHealthIndicator platform) { - return new MongoPlatformHealthContributor(platform); - } -} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/mongo/MongoPlatformHealthContributor.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/mongo/MongoPlatformHealthContributor.java deleted file mode 100644 index c5136913..00000000 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/mongo/MongoPlatformHealthContributor.java +++ /dev/null @@ -1,47 +0,0 @@ -package dev.caskeleton.bootstrap.autoconfigure.mongo; - -import dev.caskeleton.adapter.outbound.mongo.autoconfigure.MongoPlatformHealthIndicator; -import java.util.Objects; -import org.springframework.boot.health.contributor.Health; -import org.springframework.boot.health.contributor.HealthIndicator; - -/** - * Puts the Mongo platform's health where Actuator can read it. - * - *

    {@code MongoPlatformHealthIndicator} computes everything an operator needs — topology - * mismatch, secondary availability, the bounded detail map — and was named as though Actuator would - * surface it. It implements neither {@code HealthIndicator} nor {@code HealthContributor}, so - * Actuator never saw it: the platform had a health view that nothing could read, and a name that - * said otherwise. - * - *

    The adapter is not the place to fix that. It carries no Actuator dependency, and the delivery - * platform already established the shape this follows: the adapter computes the facts, the - * composition root — which owns the management surface — decides how they map onto {@code Health}. - * See {@code NotificationHealthEndpoint}. - * - *

    Degraded secondary availability reports UP with detail rather than DOWN, matching the - * adapter's own reasoning: majority writes still succeed while a majority of voting members is - * reachable, and taking the instance out of rotation for a replica-set problem removes capacity - * from a cluster that is already short of it. A topology mismatch is the case that fails readiness, - * because this instance is talking to a cluster nobody declared. - */ -public class MongoPlatformHealthContributor implements HealthIndicator { - - private final MongoPlatformHealthIndicator platform; - - /** - * Creates the contributor. - * - * @param platform the adapter's health view - */ - public MongoPlatformHealthContributor(MongoPlatformHealthIndicator platform) { - this.platform = Objects.requireNonNull(platform, "platform"); - } - - @Override - public Health health() { - Health.Builder builder = platform.ready() ? Health.up() : Health.down(); - platform.details().forEach(builder::withDetail); - return builder.build(); - } -} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformDispatchConfig.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationApplicationCompositionAutoConfiguration.java similarity index 70% rename from src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformDispatchConfig.java rename to src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationApplicationCompositionAutoConfiguration.java index 0e23488f..210c77f5 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformDispatchConfig.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationApplicationCompositionAutoConfiguration.java @@ -1,14 +1,13 @@ package dev.caskeleton.bootstrap.autoconfigure.notification; -import dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationPlatformSettings; +import dev.caskeleton.adapter.inbound.web.notification.platform.callback.ProviderCallbackIngress; +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackAdapterRegistry; import dev.caskeleton.adapter.outbound.notification.platform.dispatch.NotificationDispatchProperties; -import dev.caskeleton.adapter.outbound.notification.platform.dispatch.ProviderRuntimeRegistry; import dev.caskeleton.application.notification.platform.callback.CallbackPayloadProtectionPort; import dev.caskeleton.application.notification.platform.callback.DeliveryAttemptResolverPort; import dev.caskeleton.application.notification.platform.callback.DeliveryProjectionStorePort; import dev.caskeleton.application.notification.platform.callback.IngestProviderCallbackApplicationUseCase; import dev.caskeleton.application.notification.platform.callback.NotificationSideEffectPort; -import dev.caskeleton.application.notification.platform.callback.ProviderCallbackAdapterRegistry; import dev.caskeleton.application.notification.platform.callback.ProviderEventLedger; import dev.caskeleton.application.notification.platform.callback.ProviderEventProjectionService; import dev.caskeleton.application.notification.platform.callback.ProviderEventProjectorRegistry; @@ -25,45 +24,31 @@ import dev.caskeleton.application.notification.platform.dispatch.NotificationSub import dev.caskeleton.application.notification.platform.dispatch.ProviderDispatchGatewayPort; import dev.caskeleton.application.notification.platform.dispatch.RecipientDeliveryStorePort; import dev.caskeleton.application.notification.platform.dispatch.RecipientLeaseStorePort; -import dev.caskeleton.application.notification.platform.dispatch.ReconciliationGatewayPort; import dev.caskeleton.application.notification.platform.dispatch.ReconciliationService; import dev.caskeleton.application.notification.platform.dispatch.RequestFingerprint; -import dev.caskeleton.application.notification.platform.dispatch.SyntheticEventFingerprint; import dev.caskeleton.application.notification.platform.dispatch.TemplateRendererRegistry; import dev.caskeleton.application.notification.platform.dispatch.TenantContextPort; -import dev.caskeleton.application.notification.platform.observation.NotificationAuditPort; import dev.caskeleton.application.notification.platform.observation.NotificationMetricsPort; import dev.caskeleton.application.notification.platform.observation.NotificationSecurityAuditPort; -import dev.caskeleton.application.notification.platform.policy.NotificationEligibilityPolicy; import dev.caskeleton.application.notification.platform.policy.NotificationRetryPolicy; import dev.caskeleton.application.notification.platform.policy.RoutingDecisionEngine; +import dev.caskeleton.application.notification.platform.port.in.IngestProviderCallbackUseCase; import dev.caskeleton.application.notification.platform.template.TemplateRegistry; import dev.caskeleton.application.transaction.TransactionPort; import java.time.Clock; -import java.time.Duration; -import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; +import org.springframework.boot.autoconfigure.AutoConfiguration; import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; import org.springframework.context.annotation.Bean; -import org.springframework.context.annotation.Configuration; -/** - * Submission, dispatch and the services that record what happened. - * - *

    The path a notification travels once it has been accepted, and the callback and reconciliation - * services that correct the record afterwards. - * - *

    Split out of one 690-line composition class holding 42 beans. A configuration that assembles - * codecs, security, templates, policy, providers and workers at once has no boundary a reader can - * use: every change to any of them is a change to the same file, and nothing states which beans - * belong together (NTF-022). - */ -@Configuration(proxyBeanMethods = false) +/** Application-owned Notification orchestration and transaction-bound use-case assembly. */ +@AutoConfiguration( + afterName = + "dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationPlatformAutoConfiguration") @ConditionalOnProperty( prefix = "ca-skeleton.notification.platform", name = "enabled", havingValue = "true") -public class NotificationPlatformDispatchConfig { - +public class NotificationApplicationCompositionAutoConfiguration { /** N2 orchestration. */ @Bean public NotificationSubmissionService notificationOrchestrator( @@ -117,6 +102,7 @@ public class NotificationPlatformDispatchConfig { * @param protector the encryption and keyed-lookup boundary * @param tenants the ambient tenant * @param ids the identifier source for the contact point and correlation ids + * @param fingerprints canonical SHA-256 fingerprinting used when the caller supplies no key * @param transactions the write boundary for registration * @param clock the registration time source * @return the use case @@ -129,11 +115,12 @@ public class NotificationPlatformDispatchConfig { dev.caskeleton.application.notification.platform.security.ContactPointProtector protector, TenantContextPort tenants, NotificationIdGeneratorPort ids, + RequestFingerprint fingerprints, TransactionPort transactions, Clock clock) { return new dev.caskeleton.application.notification.platform.dispatch .AcceptNotificationApplicationUseCase( - submit, contactPoints, protector, tenants, ids, transactions, clock); + submit, contactPoints, protector, tenants, ids, fingerprints, transactions, clock); } /** @@ -210,45 +197,6 @@ public class NotificationPlatformDispatchConfig { .GetNotificationApplicationUseCase(service, transactions); } - /** - * The operator plane, and the narrow port it reaches runtimes through. - * - *

    Neither had a bean. The admin service existed in the outbound adapter, fully written, doing - * authorization and transaction orchestration, and nothing constructed it — so every operator - * capability the platform documented was unreachable. - * - * @param runtimes the provider runtime registry - * @return the control port - */ - @Bean - public dev.caskeleton.application.notification.platform.admin.ProviderRuntimeControlPort - providerRuntimeControl(ProviderRuntimeRegistry runtimes) { - return new dev.caskeleton.adapter.outbound.notification.platform.dispatch - .RegistryProviderRuntimeControl(runtimes); - } - - /** - * Operator authority, tenant scope and duplicate-risk approval. - * - * @return the guard - */ - @Bean - public dev.caskeleton.application.notification.platform.admin.AdminAuthorizationGuard - adminAuthorizationGuard() { - return new dev.caskeleton.application.notification.platform.admin.AdminAuthorizationGuard(); - } - - /** - * The approval an ambiguous redrive requires. - * - * @return the guard - */ - @Bean - public dev.caskeleton.application.notification.platform.admin.DuplicateRiskGuard - duplicateRiskGuard() { - return new dev.caskeleton.application.notification.platform.admin.DuplicateRiskGuard(); - } - /** * The N4 operator plane. * @@ -263,6 +211,7 @@ public class NotificationPlatformDispatchConfig { * @param audit the audit sink * @param transactions the transaction boundary * @param ids the identifier generator the suppression rows use + * @param digests stable SHA-256 used to bind an operation id to its command * @param clock the clock * @return the admin service */ @@ -283,6 +232,7 @@ public class NotificationPlatformDispatchConfig { dev.caskeleton.application.notification.platform.observation.NotificationAuditPort audit, TransactionPort transactions, NotificationIdGeneratorPort ids, + dev.caskeleton.application.notification.platform.dispatch.MessageDigestPort digests, Clock clock) { return new dev.caskeleton.application.notification.platform.admin .NotificationAdminApplicationService( @@ -297,62 +247,10 @@ public class NotificationPlatformDispatchConfig { audit, transactions, ids, + digests, clock); } - /** Pre-provider guard chain. */ - @Bean - public DispatchPipeline dispatchPipeline( - ContactPointStorePort contactPoints, - NotificationEligibilityPolicy eligibility, - NotificationMetricsPort metrics) { - return new DispatchPipeline(contactPoints, eligibility, metrics); - } - - /** Attempt row factory. */ - @Bean - public DeliveryAttemptFactory deliveryAttemptFactory(NotificationIdGeneratorPort ids) { - return new DeliveryAttemptFactory(ids); - } - - /** Outcome recorder. */ - @Bean - public DispatchOutcomeRecorder dispatchOutcomeRecorder( - DeliveryAttemptStorePort attempts, - RecipientDeliveryStorePort recipients, - dev.caskeleton.application.notification.platform.dispatch.ReconciliationJobStorePort - reconciliationJobs, - dev.caskeleton.application.notification.platform.callback.ProviderEventLedger ledger, - dev.caskeleton.application.notification.platform.callback.ProviderEventProjectionService - projection, - NotificationMetricsPort metrics, - NotificationDispatchProperties properties) { - return new DispatchOutcomeRecorder( - attempts, - recipients, - reconciliationJobs, - ledger, - projection, - metrics, - properties.leaseDuration()); - } - - /** Dispatch runtime bounds. */ - @Bean - @ConditionalOnMissingBean - public NotificationDispatchProperties notificationDispatchProperties( - NotificationPlatformSettings settings) { - return new NotificationDispatchProperties( - settings.dispatch().claimBatchSize(), - settings.dispatch().leaseDuration(), - settings.dispatch().pollInterval(), - settings.dispatch().maxGlobalConcurrency(), - settings.dispatch().maxAdditionalAttempts(), - Duration.ofSeconds(2), - settings.dispatch().maxQueueAge(), - Duration.ofSeconds(20)); - } - /** Dispatch orchestration. */ @Bean public NotificationDispatchService notificationDispatchService( @@ -402,41 +300,30 @@ public class NotificationPlatformDispatchConfig { ledger, projectors, resolver, projections, sideEffects, transactions, metrics); } - /** Callback ingestion. */ + /** Semantic callback ingestion after provider verification has completed. */ @Bean public IngestProviderCallbackApplicationUseCase providerCallbackIngestionService( - ProviderCallbackAdapterRegistry adapters, ProviderEventLedger ledger, dev.caskeleton.application.transaction.TransactionPort transactions, CallbackPayloadProtectionPort payloadProtection, - NotificationSecurityAuditPort securityAudit, NotificationMetricsPort metrics, Clock clock) { return new IngestProviderCallbackApplicationUseCase( - adapters, ledger, transactions, payloadProtection, securityAudit, metrics, clock); + ledger, transactions, payloadProtection, metrics, clock); } - /** Provider status correction. */ + /** + * The adapter-to-adapter callback bridge owned by the composition root. + * + *

    Raw HTTP remains in the inbound adapter, provider signature verification remains in the + * outbound provider integration, and only the verified semantic callback crosses the application + * port. + */ @Bean - public ReconciliationService reconciliationService( - DeliveryAttemptStorePort attempts, - RecipientDeliveryStorePort recipients, - ReconciliationGatewayPort gateway, - ProviderEventLedger ledger, - ProviderEventProjectionService projection, - NotificationAuditPort audit, - NotificationMetricsPort metrics, - SyntheticEventFingerprint syntheticEventFingerprints, - Clock clock) { - return new ReconciliationService( - attempts, - recipients, - gateway, - ledger, - projection, - audit, - metrics, - syntheticEventFingerprints, - clock); + public ProviderCallbackIngress providerCallbackIngress( + ProviderCallbackAdapterRegistry adapters, + IngestProviderCallbackUseCase ingestion, + NotificationSecurityAuditPort securityAudit) { + return new ProviderCallbackIngressBridge(adapters, ingestion, securityAudit); } } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationRootAutoConfiguration.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationRootAutoConfiguration.java deleted file mode 100644 index cd152a3c..00000000 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationRootAutoConfiguration.java +++ /dev/null @@ -1,55 +0,0 @@ -package dev.caskeleton.bootstrap.autoconfigure.notification; - -import dev.caskeleton.adapter.outbound.notification.NotificationConfig; -import dev.caskeleton.adapter.outbound.notification.NotificationRoutesSettings; -import dev.caskeleton.adapter.outbound.notification.email.google.GoogleEmailNotificationAdapterConfig; -import dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationPlatformAutoConfiguration; -import dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationPlatformSettings; -import dev.caskeleton.adapter.outbound.notification.slack.webhook.SlackNotificationAdapterConfig; -import org.springframework.boot.autoconfigure.AutoConfiguration; -import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; -import org.springframework.boot.context.properties.EnableConfigurationProperties; -import org.springframework.context.annotation.Import; - -/** - * The one place that decides whether this application sends notifications. - * - *

    Two things were reached through the composition root's broad scan rather than through any - * import: the platform's secrets configuration and its registries. So a deployment with the - * notification master off still bound notification settings and still asked for a keyring — and the - * off invariant is not "the workers are quiet", it is "the capability owns nothing". Narrowing the - * scan removed them; naming them here is what keeps them working when the switch is on. - * - *

    The legacy route configurations are imported too. They are on their way out under NTF-INT-004, - * and until the delivery platform is the only runtime they still have to assemble when the - * capability is enabled — a migration is not a reason to leave a working path unreachable. - * - *

    {@link NotificationPlatformAutoConfiguration} is named here for a blunter reason: nothing - * named it before. Its name says auto-configuration, but it is a plain {@code @Configuration}, so - * it cannot register itself, and the notification leaf ships no {@code AutoConfiguration.imports}. - * The only thing in the repository that loaded it was a test doing {@code - * AutoConfigurations.of(...)}, which is how six beans — the variables codec, the template engine - * and its validator, the contact point protector, the HTTP gateway — passed their tests while - * existing in no running application. The local-notification-ingest lane found it the first time - * the JPA persistence facade was assembled for real: {@code NotificationRecordMapper} asked for the - * variables codec and startup failed. - */ -@AutoConfiguration -@ConditionalOnProperty( - prefix = "ca-skeleton.notification.platform", - name = "enabled", - havingValue = "true") -@EnableConfigurationProperties({ - NotificationPlatformSettings.class, - NotificationRoutesSettings.class -}) -@Import({ - NotificationPlatformAutoConfiguration.class, - NotificationPlatformRuntimeConfig.class, - NotificationPlatformSecretsConfig.class, - NotificationPlatformRegistriesConfig.class, - NotificationConfig.class, - SlackNotificationAdapterConfig.class, - GoogleEmailNotificationAdapterConfig.class -}) -public class NotificationRootAutoConfiguration {} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/ProviderCallbackIngressBridge.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/ProviderCallbackIngressBridge.java new file mode 100644 index 00000000..19770881 --- /dev/null +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/notification/ProviderCallbackIngressBridge.java @@ -0,0 +1,95 @@ +package dev.caskeleton.bootstrap.autoconfigure.notification; + +import dev.caskeleton.adapter.inbound.web.notification.platform.callback.ProviderCallbackHttpRequest; +import dev.caskeleton.adapter.inbound.web.notification.platform.callback.ProviderCallbackIngress; +import dev.caskeleton.adapter.outbound.notification.platform.callback.CallbackLimits; +import dev.caskeleton.adapter.outbound.notification.platform.callback.CallbackVerificationResult; +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackAdapter; +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackAdapterRegistry; +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackVerificationRequest; +import dev.caskeleton.application.notification.platform.api.CallbackIngestionResult; +import dev.caskeleton.application.notification.platform.api.error.CallbackValidationException; +import dev.caskeleton.application.notification.platform.api.error.FailureCategory; +import dev.caskeleton.application.notification.platform.api.error.NotificationFailureCode; +import dev.caskeleton.application.notification.platform.api.error.NotificationFailureDescriptor; +import dev.caskeleton.application.notification.platform.observation.NotificationSecurityAuditPort; +import dev.caskeleton.application.notification.platform.port.in.IngestProviderCallbackCommand; +import dev.caskeleton.application.notification.platform.port.in.IngestProviderCallbackUseCase; +import java.util.Objects; + +/** + * Composition-only bridge from raw inbound HTTP to provider verification and semantic ingestion. + * + *

    This class is intentionally in the composition root. The inbound web adapter must not depend + * on the outbound notification adapter, and the outbound adapter must not depend on the web + * transport. Bootstrap is the one place allowed to know both and connect them. + */ +final class ProviderCallbackIngressBridge implements ProviderCallbackIngress { + + private final ProviderCallbackAdapterRegistry adapters; + private final IngestProviderCallbackUseCase ingestion; + private final NotificationSecurityAuditPort securityAudit; + + ProviderCallbackIngressBridge( + ProviderCallbackAdapterRegistry adapters, + IngestProviderCallbackUseCase ingestion, + NotificationSecurityAuditPort securityAudit) { + this.adapters = Objects.requireNonNull(adapters, "adapters"); + this.ingestion = Objects.requireNonNull(ingestion, "ingestion"); + this.securityAudit = Objects.requireNonNull(securityAudit, "securityAudit"); + } + + @Override + public CallbackIngestionResult ingest(ProviderCallbackHttpRequest request) { + Objects.requireNonNull(request, "request"); + + CallbackLimits limits = adapters.limitsFor(request.providerProfileId()); + if (request.bodyLength() > limits.maxBodyBytes()) { + securityAudit.callbackRejectedByLimit(request.providerProfileId(), "BODY_TOO_LARGE"); + throw rejected(NotificationFailureCode.CALLBACK_PAYLOAD_REJECTED); + } + if (!limits.acceptsContentType(request.contentType().orElse(null))) { + securityAudit.callbackRejectedByLimit(request.providerProfileId(), "CONTENT_TYPE_REJECTED"); + throw rejected(NotificationFailureCode.CALLBACK_PAYLOAD_REJECTED); + } + + ProviderCallbackAdapter adapter = adapters.require(request.providerProfileId()); + if (!adapter.providerId().equals(request.providerId())) { + securityAudit.callbackRejectedByLimit( + request.providerProfileId(), "PROVIDER_PROFILE_MISMATCH"); + throw rejected(NotificationFailureCode.CALLBACK_PAYLOAD_REJECTED); + } + + ProviderCallbackVerificationRequest verificationRequest = + new ProviderCallbackVerificationRequest( + request.providerId(), + request.providerProfileId(), + request.externalUrl(), + request.httpMethod(), + request.contentType(), + request.headers(), + request.body(), + request.receivedAt()); + + CallbackVerificationResult verification = adapter.verify(verificationRequest); + if (!verification.valid()) { + securityAudit.callbackSignatureRejected( + request.providerProfileId(), verification.reasonCode()); + throw rejected(NotificationFailureCode.CALLBACK_SIGNATURE_INVALID); + } + + var verified = verification.verifiedCallback().orElseThrow(); + return ingestion.handle( + new IngestProviderCallbackCommand( + request.providerId(), + request.providerProfileId(), + adapter.normalize(verified), + request.body())); + } + + private static CallbackValidationException rejected(String code) { + return new CallbackValidationException( + NotificationFailureDescriptor.preDispatch( + code, FailureCategory.CALLBACK_VALIDATION_FAILURE)); + } +} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxCanonicalTransportRequirementValidator.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxCanonicalTransportRequirementValidator.java index db090754..48db55a3 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxCanonicalTransportRequirementValidator.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxCanonicalTransportRequirementValidator.java @@ -1,5 +1,6 @@ package dev.caskeleton.bootstrap.autoconfigure.outbox; +import dev.caskeleton.application.messaging.event.IntegrationEventEncoderPort; import dev.caskeleton.application.messaging.event.IntegrationEventPublishPort; import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; import java.util.Objects; @@ -18,11 +19,15 @@ public final class OutboxCanonicalTransportRequirementValidator implements Initi private final OutboxSettings settings; private final IntegrationEventPublishPort publisher; + private final IntegrationEventEncoderPort encoder; public OutboxCanonicalTransportRequirementValidator( - OutboxSettings settings, IntegrationEventPublishPort publisher) { + OutboxSettings settings, + IntegrationEventPublishPort publisher, + IntegrationEventEncoderPort encoder) { this.settings = Objects.requireNonNull(settings, "settings must not be null"); this.publisher = publisher; + this.encoder = encoder; } @Override @@ -31,15 +36,27 @@ public final class OutboxCanonicalTransportRequirementValidator implements Initi } public void validate() { - if (!settings.canonicalTransportEnabled() || publisher != null) { + if (!settings.canonicalTransportEnabled()) { return; } - throw StartupFailures.requiredAdapterDisabled( - CANONICAL_KEY - + "=true requires an IntegrationEventPublishPort so canonical claimed rows cannot be " - + "consumed by the relay without a platform publication route. Configure the canonical " - + "messaging bridge (including app.messaging.producer-id) or set " - + CANONICAL_KEY - + "=false."); + if (publisher == null) { + throw StartupFailures.requiredAdapterDisabled( + CANONICAL_KEY + + "=true requires an IntegrationEventPublishPort so canonical claimed rows cannot be " + + "consumed by the relay without a platform publication route. Configure the canonical " + + "messaging bridge (including app.messaging.producer-id) or set " + + CANONICAL_KEY + + "=false."); + } + if (encoder == null) { + throw StartupFailures.requiredAdapterDisabled( + CANONICAL_KEY + + "=true also requires an IntegrationEventEncoderPort. The repository ships a " + + "JsonSchemaIntegrationEventEncoder implementation, but the Stable composition does " + + "not compile an application contract catalog or schema registry automatically. " + + "Provide the encoder as part of the application messaging composition or set " + + CANONICAL_KEY + + "=false."); + } } } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxConfig.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxConfig.java index d7e055f0..7f545908 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxConfig.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxConfig.java @@ -1,5 +1,6 @@ package dev.caskeleton.bootstrap.autoconfigure.outbox; +import dev.caskeleton.application.messaging.event.IntegrationEventEncoderPort; import dev.caskeleton.application.messaging.event.IntegrationEventPublishPort; import dev.caskeleton.application.outbox.OutboxBackoffPolicy; import dev.caskeleton.application.outbox.OutboxMessagePublishPort; @@ -12,10 +13,10 @@ import java.time.Clock; import java.util.SplittableRandom; import java.util.random.RandomGenerator; import org.springframework.beans.factory.ObjectProvider; +import org.springframework.boot.autoconfigure.AutoConfiguration; import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; import org.springframework.boot.context.properties.EnableConfigurationProperties; import org.springframework.context.annotation.Bean; -import org.springframework.context.annotation.Configuration; /** * Composition-root wiring for the transactional outbox relay: assembles the relay use case manually @@ -27,7 +28,7 @@ import org.springframework.context.annotation.Configuration; * off still assembled settings, a validator, an RNG, a leader token, and outbox metrics over a * store port that a database-less deployment does not have. */ -@Configuration +@AutoConfiguration @ConditionalOnProperty(prefix = "ca-skeleton.outbox", name = "enabled", havingValue = "true") @EnableConfigurationProperties(OutboxSettings.class) public class OutboxConfig { @@ -48,9 +49,10 @@ public class OutboxConfig { @Bean public OutboxCanonicalTransportRequirementValidator outboxCanonicalTransportRequirementValidator( OutboxSettings settings, - ObjectProvider canonicalPublisherProvider) { + ObjectProvider canonicalPublisherProvider, + ObjectProvider encoderProvider) { return new OutboxCanonicalTransportRequirementValidator( - settings, canonicalPublisherProvider.getIfAvailable()); + settings, canonicalPublisherProvider.getIfAvailable(), encoderProvider.getIfAvailable()); } /** diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxRelayScheduler.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxRelayScheduler.java index 5985272f..5b9d80a5 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxRelayScheduler.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxRelayScheduler.java @@ -1,5 +1,7 @@ package dev.caskeleton.bootstrap.autoconfigure.outbox; +import static net.logstash.logback.argument.StructuredArguments.kv; + import dev.caskeleton.application.outbox.OutboxRelayResult; import dev.caskeleton.application.outbox.PublishPendingOutboxEventsCommand; import dev.caskeleton.application.outbox.PublishPendingOutboxEventsUseCase; @@ -50,6 +52,9 @@ public class OutboxRelayScheduler { log.error( "outbox relay scheduler: unexpected error in relay cycle — " + "relay will retry on the next tick", + kv("capability", "outbox"), + kv("operation", "relay"), + kv("retry.disposition", "next-tick"), ex); } } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisActivationValidator.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisActivationValidator.java index 5b21d899..0c84346e 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisActivationValidator.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisActivationValidator.java @@ -41,6 +41,7 @@ public class RedisActivationValidator implements SmartInitializingSingleton { @Override public void afterSingletonsInstantiated() { if (isRedisGloballyEnabled()) { + validateIdempotencyKeyVersion(); return; } StartupValidationContext contradictions = @@ -62,6 +63,28 @@ public class RedisActivationValidator implements SmartInitializingSingleton { + "provider. A role selector never activates Redis on its own."); } + private void validateIdempotencyKeyVersion() { + if (!"redis" + .equalsIgnoreCase( + environment.getProperty( + "ca-skeleton.capabilities.idempotency.provider", "disabled"))) { + return; + } + int keyVersion = + environment.getProperty( + "ca-skeleton.capabilities.idempotency.key-version", Integer.class, 1); + if (keyVersion == 1) { + return; + } + + StartupValidationContext.forPhase(StartupPhase.ADAPTER_ENABLEMENT) + .reject("ca-skeleton.capabilities.idempotency.key-version=" + keyVersion) + .failIfViolated( + "Redis idempotency key-version rotation is unsupported without dual-read", + "keep ca-skeleton.capabilities.idempotency.key-version=1 until a migration can read " + + "the previous keyspace during the replay-retention window."); + } + private boolean isRedisGloballyEnabled() { return Boolean.parseBoolean( environment.getProperty(SecretSourceValidator.REDIS_ENABLED_PROPERTY, "false")); diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisCacheConfig.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisCacheConfig.java index 91c76e99..91c9108b 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisCacheConfig.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisCacheConfig.java @@ -4,7 +4,7 @@ import dev.caskeleton.adapter.outbound.cache.redis.cache.RedisCacheRegionAdapter import dev.caskeleton.adapter.outbound.cache.redis.sdk.config.RedisSdkSettings; import dev.caskeleton.adapter.outbound.cache.redis.sdk.lettuce.connection.RedisRuntimeOwner; import dev.caskeleton.application.cache.CacheRegionPort; -import dev.caskeleton.bootstrap.runtime.SecretSource; +import dev.caskeleton.application.outbound.SecretSourcePort; import java.time.Clock; import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; import org.springframework.context.annotation.Bean; @@ -38,7 +38,7 @@ class RedisCacheConfig { RedisRuntimeOwner owner, RedisSdkSettings sdk, RedisCapabilitySettings capabilities, - SecretSource secretSource, + SecretSourcePort secretSource, Clock clock) { RedisCapabilitySettings.Cache cache = capabilities.getCache(); cache.validate(); diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisCapabilityConfig.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisCapabilityConfig.java index 14a1cd35..84d54fde 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisCapabilityConfig.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisCapabilityConfig.java @@ -1,11 +1,14 @@ package dev.caskeleton.bootstrap.autoconfigure.redis; import dev.caskeleton.adapter.outbound.cache.redis.sdk.config.RedisSdkAutoConfiguration; -import dev.caskeleton.bootstrap.runtime.SecretSource; +import dev.caskeleton.adapter.outbound.cache.redis.sdk.config.RedisSdkSettings; +import dev.caskeleton.adapter.outbound.cache.redis.sdk.lettuce.connection.RedisRuntimeOwner; +import dev.caskeleton.application.outbound.SecretSourcePort; +import org.springframework.boot.autoconfigure.AutoConfiguration; +import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; import org.springframework.boot.context.properties.EnableConfigurationProperties; import org.springframework.context.annotation.Bean; -import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.Import; /** @@ -33,7 +36,7 @@ import org.springframework.context.annotation.Import; * that makes the ACL pattern meaningful: one prefix, {@code {environment}:{service}:{domain}}, that * the deployment's {@code ~} pattern can actually fence. */ -@Configuration(proxyBeanMethods = false) +@AutoConfiguration(after = RedisSdkAutoConfiguration.class) @EnableConfigurationProperties(RedisCapabilitySettings.class) // The global switch, not a role selector. A role selector says which capability composes; it // never says Redis exists, and RedisActivationValidator refuses the contradiction of one @@ -62,7 +65,18 @@ public class RedisCapabilityConfig { * @return the SDK's view of it */ @Bean - RedisSdkAutoConfiguration.RedisSecretSource redisSdkSecretSource(SecretSource secretSource) { + RedisSdkAutoConfiguration.RedisSecretSource redisSdkSecretSource(SecretSourcePort secretSource) { return secretSource::resolve; } + + @Bean + @ConditionalOnMissingBean(RedisSemanticScriptAclProbe.class) + RedisSemanticScriptAclProbe redisSemanticScriptAclProbe( + RedisRuntimeOwner owner, RedisCapabilitySettings capabilities, RedisSdkSettings sdk) { + byte[] probeKey = + (RedisKeys.namespaceOf(sdk).prefix() + ":probe:{semantic-script}:acl") + .getBytes(java.nio.charset.StandardCharsets.UTF_8); + return new RedisSemanticScriptAclProbe( + owner, capabilities, probeKey, sdk.getTimeout().getScript()); + } } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisCapabilitySettings.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisCapabilitySettings.java index 068a263f..457f3103 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisCapabilitySettings.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisCapabilitySettings.java @@ -248,7 +248,6 @@ public class RedisCapabilitySettings { private Duration refillPeriod = Duration.ofSeconds(1); private long maximumCost = 10; private Duration cleanupGrace = Duration.ofSeconds(5); - private Duration maximumClockRegression = Duration.ofMillis(250); public String getRevision() { return revision; @@ -321,14 +320,6 @@ public class RedisCapabilitySettings { public void setCleanupGrace(Duration cleanupGrace) { this.cleanupGrace = cleanupGrace; } - - public Duration getMaximumClockRegression() { - return maximumClockRegression; - } - - public void setMaximumClockRegression(Duration maximumClockRegression) { - this.maximumClockRegression = maximumClockRegression; - } } } @@ -389,7 +380,7 @@ public class RedisCapabilitySettings { /** Owner-safe request replay (V2) provider composition. */ public static class Idempotency { - private String provider = "jdbc"; + private String provider = "disabled"; private int keyVersion = 1; private Duration commandTimeout = Duration.ofMillis(200); private Duration processingLease = Duration.ofSeconds(30); diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisKeys.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisKeys.java index 19aa3c25..bdca27f4 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisKeys.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisKeys.java @@ -2,7 +2,7 @@ package dev.caskeleton.bootstrap.autoconfigure.redis; import dev.caskeleton.adapter.outbound.cache.redis.sdk.api.key.RedisNamespace; import dev.caskeleton.adapter.outbound.cache.redis.sdk.config.RedisSdkSettings; -import dev.caskeleton.bootstrap.runtime.SecretSource; +import dev.caskeleton.application.outbound.SecretSourcePort; import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; import java.nio.charset.StandardCharsets; @@ -37,7 +37,7 @@ final class RedisKeys { record KeyDigest(javax.crypto.Mac prototype) { static KeyDigest of( - SecretSource secretSource, String reference, String capability, RedisSdkSettings sdk) { + SecretSourcePort secretSource, String reference, String capability, RedisSdkSettings sdk) { String name = secretName(reference, capability); String material = secretSource diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisRateLimitConfig.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisRateLimitConfig.java index e7905454..a801c63f 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisRateLimitConfig.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisRateLimitConfig.java @@ -12,6 +12,7 @@ import dev.caskeleton.shared.ratelimit.RateLimitFailurePolicy; import dev.caskeleton.shared.ratelimit.RateLimitPolicy; import dev.caskeleton.shared.ratelimit.RateParameters; import java.time.Clock; +import java.time.Duration; import java.util.LinkedHashMap; import java.util.Locale; import java.util.Map; @@ -35,7 +36,7 @@ class RedisRateLimitConfig { * @param owner the Redis runtime owner * @param sdk the Redis SDK settings, which own the namespace * @param capabilities the capability settings - * @param clock the clock decision windows are measured against + * @param clock the local clock used for caller deadlines and response reset instants * @return the rate limit port */ @Bean @@ -127,7 +128,7 @@ class RedisRateLimitConfig { parameters, policy.getMaximumCost(), policy.getCleanupGrace(), - policy.getMaximumClockRegression(), + Duration.ZERO, RateLimitFailurePolicy.FAIL_CLOSED); } } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisSemanticScriptAclProbe.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisSemanticScriptAclProbe.java new file mode 100644 index 00000000..a2c11f4b --- /dev/null +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisSemanticScriptAclProbe.java @@ -0,0 +1,80 @@ +package dev.caskeleton.bootstrap.autoconfigure.redis; + +import dev.caskeleton.adapter.outbound.cache.redis.sdk.lettuce.connection.RedisConnectionKind; +import dev.caskeleton.adapter.outbound.cache.redis.sdk.lettuce.connection.RedisLease; +import dev.caskeleton.adapter.outbound.cache.redis.sdk.lettuce.connection.RedisRuntimeOwner; +import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; +import java.nio.charset.StandardCharsets; +import java.time.Duration; +import java.util.List; +import java.util.Objects; +import java.util.concurrent.TimeUnit; +import org.springframework.beans.factory.SmartInitializingSingleton; + +/** + * Fails startup when a selected semantic capability needs the SCRIPT lane but its effective Redis + * account cannot actually execute registered programs. + */ +final class RedisSemanticScriptAclProbe implements SmartInitializingSingleton { + + private static final byte[] PROBE_SCRIPT = "return {1}".getBytes(StandardCharsets.UTF_8); + + private final RedisRuntimeOwner owner; + private final RedisCapabilitySettings capabilities; + private final byte[] probeKey; + private final Duration timeout; + + RedisSemanticScriptAclProbe( + RedisRuntimeOwner owner, + RedisCapabilitySettings capabilities, + byte[] probeKey, + Duration timeout) { + this.owner = Objects.requireNonNull(owner, "owner must be non-null"); + this.capabilities = Objects.requireNonNull(capabilities, "capabilities must be non-null"); + this.probeKey = Objects.requireNonNull(probeKey, "probe key must be non-null").clone(); + this.timeout = Objects.requireNonNull(timeout, "timeout must be non-null"); + } + + @Override + public void afterSingletonsInstantiated() { + if (!scriptCapabilitySelected()) { + return; + } + try (RedisLease lease = owner.borrow(RedisConnectionKind.SCRIPT)) { + String digest = + lease + .gateway() + .loadScript(PROBE_SCRIPT) + .toCompletableFuture() + .get(timeout.toNanos(), TimeUnit.NANOSECONDS); + List reply = + lease + .gateway() + .evaluateRegisteredForList(digest, probeKey, List.of()) + .toCompletableFuture() + .get(timeout.toNanos(), TimeUnit.NANOSECONDS); + if (reply.size() != 1 + || !(reply.get(0) instanceof Number number) + || number.longValue() != 1L) { + throw StartupFailures.envValidation( + "Redis semantic SCRIPT capability is selected but the SCRIPT ACL probe returned an " + + "unexpected reply"); + } + } catch (InterruptedException interrupted) { + Thread.currentThread().interrupt(); + throw StartupFailures.envValidation("Redis SCRIPT ACL probe was interrupted", interrupted); + } catch (Exception failure) { + throw StartupFailures.envValidation( + "Redis semantic SCRIPT capability is selected but SCRIPT LOAD/EVALSHA is unavailable; " + + "configure the ADVANCED Redis credential role or grant the effective account the " + + "required script permissions", + failure); + } + } + + private boolean scriptCapabilitySelected() { + return capabilities.getRateLimit().redisSelected() + || capabilities.getLease().redisSelected() + || capabilities.getIdempotency().redisSelected(); + } +} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingConfig.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingConfig.java index 57d32136..d68513cf 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingConfig.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingConfig.java @@ -1,5 +1,7 @@ package dev.caskeleton.bootstrap.autoconfigure.tracing; +import dev.caskeleton.bootstrap.runtime.RuntimeProfileSnapshot; +import dev.caskeleton.shared.runtime.RuntimeEnvironment; import dev.caskeleton.shared.tracing.SpanErrorRecorder; import io.micrometer.core.instrument.MeterRegistry; import io.micrometer.tracing.Tracer; @@ -11,15 +13,15 @@ import io.opentelemetry.sdk.trace.SdkTracerProvider; import io.opentelemetry.sdk.trace.samplers.Sampler; import java.util.List; import org.springframework.beans.factory.ObjectProvider; +import org.springframework.boot.autoconfigure.AutoConfiguration; import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; import org.springframework.boot.context.properties.EnableConfigurationProperties; import org.springframework.context.annotation.Bean; -import org.springframework.context.annotation.Configuration; import org.springframework.core.env.Environment; /** Composition-root wiring for distributed tracing. See README for the design rationale. */ -@Configuration +@AutoConfiguration @EnableConfigurationProperties(TracingSettings.class) public class TracingConfig { @@ -39,16 +41,18 @@ public class TracingConfig { @Bean public TracingSamplingRateGaugeRegistrar tracingSamplingRateGaugeRegistrar() { - String activeProfile = resolveActiveProfile(); + RuntimeProfileSnapshot profiles = RuntimeProfileSnapshot.from(environment); + List activeProfiles = profiles.activeProfiles(); double effectiveRate = - new TracingSampleRateResolver().resolve(activeProfile, properties.sampleRate()); - TracingSamplingRateGauge.register(activeProfile, effectiveRate, meterRegistryProvider); - return new TracingSamplingRateGaugeRegistrar(activeProfile, effectiveRate); - } - - private String resolveActiveProfile() { - String[] profiles = environment.getActiveProfiles(); - return (profiles != null && profiles.length > 0) ? profiles[0] : "local"; + new TracingSampleRateResolver().resolve(activeProfiles, properties.sampleRate()); + var runtimeEnvironment = profiles.resolve(); + runtimeEnvironment.ifPresent( + runtime -> + TracingSamplingRateGauge.register( + runtime.profileName(), effectiveRate, meterRegistryProvider)); + return new TracingSamplingRateGaugeRegistrar( + runtimeEnvironment.map(RuntimeEnvironment::profileName).orElse("unresolved"), + effectiveRate); } @Bean @@ -60,7 +64,9 @@ public class TracingConfig { matchIfMissing = true) Tracer micrometerTracer() { double sampleRate = - new TracingSampleRateResolver().resolve(resolveActiveProfile(), properties.sampleRate()); + new TracingSampleRateResolver() + .resolve( + RuntimeProfileSnapshot.from(environment).activeProfiles(), properties.sampleRate()); SdkTracerProvider tracerProvider = SdkTracerProvider.builder() .setSampler(Sampler.parentBased(Sampler.traceIdRatioBased(sampleRate))) diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingSampleRateResolver.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingSampleRateResolver.java index 8d235798..a24a4a0e 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingSampleRateResolver.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingSampleRateResolver.java @@ -1,49 +1,58 @@ package dev.caskeleton.bootstrap.autoconfigure.tracing; -import java.util.Locale; +import dev.caskeleton.shared.runtime.RuntimeEnvironment; +import java.util.Collection; -/** - * Resolves the effective tracing sample rate from the active profile and the configured override. - * Plain Java, no Spring dependency, so it is reusable from both the {@code - * EnvironmentPostProcessor} and bean phases. See README for the design rationale. - */ +/** Resolves the effective tracing sample rate from the canonical runtime environment. */ public final class TracingSampleRateResolver { + private static final double PRODUCTION_DEFAULT = 0.01d; + private static final double NON_PRODUCTION_DEFAULT = 1.0d; + /** - * Resolves the default sample rate for an active Spring profile. - * - * @param profile Spring active profile name; {@code null}/blank treated as "anything else" + * Resolves a configured override, otherwise the default for the canonical runtime environment. */ - public static double defaultRateForProfile(String profile) { - if (profile == null) { - return 1.0; + public double resolve(Collection activeProfiles, String configuredRate) { + if (configuredRate != null && !configuredRate.isBlank()) { + try { + double parsed = Double.parseDouble(configuredRate.trim()); + if (parsed >= 0.0d && parsed <= 1.0d) { + return parsed; + } + } catch (NumberFormatException ignored) { + // Invalid configured values are rejected by TracingSettings during normal boot. Keeping the + // resolver defensive preserves the existing pure-function contract for direct callers. + } } - return switch (profile.trim().toLowerCase(Locale.ROOT)) { - case "prod" -> 0.01; - case "staging" -> 0.10; - case "dev" -> 1.0; - case "local" -> 1.0; - default -> 1.0; - }; + return defaultRateForProfiles(activeProfiles); + } + + /** Backward-compatible single-profile entry used by focused unit tests and simple callers. */ + public double resolve(String activeProfile, String configuredRate) { + return resolve( + activeProfile == null ? java.util.List.of() : java.util.List.of(activeProfile), + configuredRate); + } + + /** Default for the currently active shipped runtime environment. */ + public static double defaultRateForProfiles(Collection activeProfiles) { + return RuntimeEnvironment.resolve(activeProfiles) + .map(TracingSampleRateResolver::defaultRateForEnvironment) + .orElse(NON_PRODUCTION_DEFAULT); } /** - * A configured override wins over the per-profile default. - * - * @param configuredRate raw string from {@code APP_TRACING_SAMPLE_RATE}; may be blank - * @return effective sample rate in [0.0, 1.0] + * Backward-compatible single-profile helper. Unknown/test/profileless values are non-production. */ - public double resolve(String profile, String configuredRate) { - if (configuredRate != null && !configuredRate.isBlank()) { - try { - double v = Double.parseDouble(configuredRate.trim()); - if (v >= 0.0 && v <= 1.0) { - return v; - } - } catch (NumberFormatException ignored) { - // fall through to profile default - } - } - return defaultRateForProfile(profile); + public static double defaultRateForProfile(String profile) { + return defaultRateForProfiles( + profile == null ? java.util.List.of() : java.util.List.of(profile)); + } + + private static double defaultRateForEnvironment(RuntimeEnvironment environment) { + return switch (environment) { + case PROD -> PRODUCTION_DEFAULT; + case LOCAL, DEV -> NON_PRODUCTION_DEFAULT; + }; } } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingSamplingEnvironmentPostProcessor.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingSamplingEnvironmentPostProcessor.java index bd43309f..6b0452ce 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingSamplingEnvironmentPostProcessor.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingSamplingEnvironmentPostProcessor.java @@ -1,6 +1,8 @@ package dev.caskeleton.bootstrap.autoconfigure.tracing; +import dev.caskeleton.bootstrap.runtime.RuntimeProfileSnapshot; import dev.caskeleton.bootstrap.runtime.startup.StartupOrder; +import java.util.List; import java.util.Map; import org.springframework.boot.EnvironmentPostProcessor; import org.springframework.boot.SpringApplication; @@ -27,10 +29,9 @@ public class TracingSamplingEnvironmentPostProcessor implements EnvironmentPostP if (environment.containsProperty(NATIVE_KEY)) { return; } - String[] profiles = environment.getActiveProfiles(); - String profile = (profiles != null && profiles.length > 0) ? profiles[0] : "local"; + List activeProfiles = RuntimeProfileSnapshot.from(environment).activeProfiles(); String configured = environment.getProperty(CA_SAMPLE_RATE_KEY); - double rate = resolver.resolve(profile, configured); + double rate = resolver.resolve(activeProfiles, configured); environment .getPropertySources() .addLast( diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/logging/ResolvedProfileLoggingContextListener.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/logging/ResolvedProfileLoggingContextListener.java index 8bf0495c..b8fc4a6e 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/logging/ResolvedProfileLoggingContextListener.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/logging/ResolvedProfileLoggingContextListener.java @@ -1,6 +1,8 @@ package dev.caskeleton.bootstrap.logging; import ch.qos.logback.classic.LoggerContext; +import dev.caskeleton.bootstrap.runtime.RuntimeProfileSnapshot; +import java.util.List; import org.slf4j.ILoggerFactory; import org.slf4j.LoggerFactory; import org.springframework.boot.context.event.ApplicationEnvironmentPreparedEvent; @@ -24,9 +26,9 @@ import org.springframework.core.env.ConfigurableEnvironment; * the same event Boot's own logging initialiser answers — this listener runs after it, so the value * is corrected before the application logs anything of its own. * - *

    It corrects rather than replaces. The XML default still applies while Logback starts, so a - * line emitted before this point carries the environment's answer instead of nothing; there is no - * window where the field is empty. + *

    It corrects rather than replaces. Before the environment is ready the XML uses the honest + * sentinel {@code unresolved}; it no longer guesses {@code local}. Once the environment-prepared + * event fires, this listener replaces that sentinel with the resolved profile. * *

    Registered in {@code META-INF/spring.factories}. A listener for this event cannot be a bean: * the event fires long before there is a context to hold one. @@ -40,8 +42,8 @@ public class ResolvedProfileLoggingContextListener @Override public void onApplicationEvent(ApplicationEnvironmentPreparedEvent event) { ConfigurableEnvironment environment = event.getEnvironment(); - String[] active = environment.getActiveProfiles(); - if (active.length == 0) { + List active = RuntimeProfileSnapshot.from(environment).activeProfiles(); + if (active.isEmpty()) { // Nothing to correct to. A profileless deployment is refused elsewhere, at startup, with a // message about the profile rather than about logging; overwriting the field with "default" // here would replace that diagnosis with a plausible-looking log field. diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/logging/StartupFailureSpringBootLogFilter.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/logging/StartupFailureSpringBootLogFilter.java index 0890d626..d7275b9a 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/logging/StartupFailureSpringBootLogFilter.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/logging/StartupFailureSpringBootLogFilter.java @@ -28,7 +28,7 @@ public class StartupFailureSpringBootLogFilter extends TurboFilter { @Override public FilterReply decide( Marker marker, Logger logger, Level level, String format, Object[] params, Throwable t) { - if (!isStarted() || !StartupFailureLogState.startupFailureReported()) { + if (!isStarted() || !StartupFailureLogState.startupFailureReported(getContext())) { return FilterReply.NEUTRAL; } if (logger == null) { diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/JpaSchemaSafetyValidator.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/JpaSchemaSafetyValidator.java index 44310479..cfe4b670 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/JpaSchemaSafetyValidator.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/JpaSchemaSafetyValidator.java @@ -1,8 +1,6 @@ package dev.caskeleton.bootstrap.runtime; import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; -import dev.caskeleton.shared.runtime.RuntimeEnvironment; -import java.util.List; import java.util.Locale; import java.util.Set; import org.springframework.beans.factory.SmartInitializingSingleton; @@ -50,6 +48,6 @@ public class JpaSchemaSafetyValidator implements SmartInitializingSingleton { } private boolean isProdActive() { - return RuntimeEnvironment.isProductionActive(List.of(environment.getActiveProfiles())); + return RuntimeProfileSnapshot.from(environment).isProduction(); } } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/PersistenceVendorProdSafetyValidator.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/PersistenceVendorProdSafetyValidator.java index 42ac0d6c..6ef5126a 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/PersistenceVendorProdSafetyValidator.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/PersistenceVendorProdSafetyValidator.java @@ -1,8 +1,6 @@ package dev.caskeleton.bootstrap.runtime; import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; -import dev.caskeleton.shared.runtime.RuntimeEnvironment; -import java.util.List; import java.util.Locale; import org.springframework.beans.factory.SmartInitializingSingleton; import org.springframework.core.env.Environment; @@ -80,6 +78,6 @@ public final class PersistenceVendorProdSafetyValidator implements SmartInitiali } private boolean isProdActive() { - return RuntimeEnvironment.isProductionActive(List.of(environment.getActiveProfiles())); + return RuntimeProfileSnapshot.from(environment).isProduction(); } } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/PostgreSqlTransportSecurityValidator.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/PostgreSqlTransportSecurityValidator.java index 349ec989..e353ec3e 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/PostgreSqlTransportSecurityValidator.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/PostgreSqlTransportSecurityValidator.java @@ -1,7 +1,6 @@ package dev.caskeleton.bootstrap.runtime; import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; -import dev.caskeleton.shared.runtime.RuntimeEnvironment; import java.util.ArrayList; import java.util.List; import java.util.Locale; @@ -84,6 +83,6 @@ public final class PostgreSqlTransportSecurityValidator implements SmartInitiali } private boolean isProdActive() { - return RuntimeEnvironment.isProductionActive(List.of(environment.getActiveProfiles())); + return RuntimeProfileSnapshot.from(environment).isProduction(); } } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/RuntimeProfileSnapshot.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/RuntimeProfileSnapshot.java new file mode 100644 index 00000000..610f5e80 --- /dev/null +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/RuntimeProfileSnapshot.java @@ -0,0 +1,48 @@ +package dev.caskeleton.bootstrap.runtime; + +import dev.caskeleton.shared.runtime.RuntimeEnvironment; +import java.util.List; +import java.util.Objects; +import java.util.Optional; +import org.springframework.core.env.Environment; + +/** + * Immutable snapshot of Spring's active profiles at one composition-root decision point. + * + *

    This is the only app-bootstrap production type that reads {@link + * Environment#getActiveProfiles()}. Runtime vocabulary and interpretation remain owned by the + * framework-free {@link RuntimeEnvironment}; this type only bridges Spring's environment API to + * that contract. + */ +public record RuntimeProfileSnapshot(List activeProfiles) { + + public RuntimeProfileSnapshot { + activeProfiles = List.copyOf(Objects.requireNonNull(activeProfiles, "activeProfiles")); + } + + /** Captures the current Spring active-profile order without interpreting it. */ + public static RuntimeProfileSnapshot from(Environment environment) { + Objects.requireNonNull(environment, "environment"); + return new RuntimeProfileSnapshot(List.of(environment.getActiveProfiles())); + } + + /** Runtime environments named by this profile set, preserving profile order. */ + public List environments() { + return RuntimeEnvironment.activeIn(activeProfiles); + } + + /** The single runtime environment when exactly one is named. */ + public Optional resolve() { + return RuntimeEnvironment.resolve(activeProfiles); + } + + /** Whether this snapshot names the production runtime environment. */ + public boolean isProduction() { + return RuntimeEnvironment.isProductionActive(activeProfiles); + } + + /** Whether this snapshot includes the test-only profile. */ + public boolean isTestContext() { + return RuntimeEnvironment.isTestContext(activeProfiles); + } +} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/RuntimeSafetyConfig.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/RuntimeSafetyConfig.java index 426de3c1..72fe9857 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/RuntimeSafetyConfig.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/RuntimeSafetyConfig.java @@ -15,8 +15,8 @@ public class RuntimeSafetyConfig { @Bean StartupSafetyValidator startupSafetyValidator( - Environment environment, RuntimeSafetySettings settings, ListableBeanFactory beanFactory) { - return new StartupSafetyValidator(environment, settings, beanFactory); + RuntimeSafetySettings settings, ListableBeanFactory beanFactory) { + return new StartupSafetyValidator(settings, beanFactory); } @Bean diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/SecretSource.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/SecretSource.java deleted file mode 100644 index 4935c50b..00000000 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/SecretSource.java +++ /dev/null @@ -1,18 +0,0 @@ -package dev.caskeleton.bootstrap.runtime; - -import java.util.Optional; - -/** - * Backend seam for secret resolution (the concrete backend is chosen by {@link - * SecretSourceFactory}). See README for the design rationale. - */ -public interface SecretSource { - - /** - * A blank value MUST be treated as absent so a present-but-empty secret cannot pass a presence - * check. - * - * @return the resolved non-blank value, or empty when absent/blank - */ - Optional resolve(String key); -} diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/SecretSourceConfig.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/SecretSourceConfig.java index 12f49578..70b661fd 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/SecretSourceConfig.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/SecretSourceConfig.java @@ -1,5 +1,6 @@ package dev.caskeleton.bootstrap.runtime; +import dev.caskeleton.application.outbound.SecretSourcePort; import dev.caskeleton.bootstrap.autoconfigure.redis.RedisActivationValidator; import org.springframework.boot.context.properties.EnableConfigurationProperties; import org.springframework.context.annotation.Bean; @@ -15,13 +16,14 @@ import org.springframework.core.env.ConfigurableEnvironment; public class SecretSourceConfig { @Bean - SecretSource secretSource(SecretSourceSettings properties, ConfigurableEnvironment environment) { + SecretSourcePort secretSource( + SecretSourceSettings properties, ConfigurableEnvironment environment) { return SecretSourceFactory.create(properties.strategy(), environment); } @Bean SecretSourceValidator secretSourceValidator( - ConfigurableEnvironment environment, SecretSource secretSource) { + ConfigurableEnvironment environment, SecretSourcePort secretSource) { return new SecretSourceValidator(environment, secretSource); } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/SecretSourceFactory.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/SecretSourceFactory.java index 6c7dad2b..4846be1d 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/SecretSourceFactory.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/SecretSourceFactory.java @@ -1,16 +1,18 @@ package dev.caskeleton.bootstrap.runtime; +import dev.caskeleton.adapter.outbound.support.EnvironmentSecretSource; +import dev.caskeleton.application.outbound.SecretSourcePort; import org.springframework.core.env.Environment; /** - * Builds the configured {@link SecretSource} backend; the {@code switch} below is the one extension - * point for adding a backend. See README for the design rationale. + * Builds the configured {@link SecretSourcePort} backend; the {@code switch} below is the one + * extension point for adding a backend. See README for the design rationale. */ public final class SecretSourceFactory { private SecretSourceFactory() {} - public static SecretSource create(SecretSourceStrategy strategy, Environment environment) { + public static SecretSourcePort create(SecretSourceStrategy strategy, Environment environment) { return switch (strategy) { case ENVIRONMENT -> new EnvironmentSecretSource(environment); }; diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/SecretSourceStrategy.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/SecretSourceStrategy.java index 92da8a45..4fda31a8 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/SecretSourceStrategy.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/SecretSourceStrategy.java @@ -7,7 +7,7 @@ package dev.caskeleton.bootstrap.runtime; public enum SecretSourceStrategy { ENVIRONMENT - // Future backends (each: new SecretSource impl + factory case): + // Future backends (each: new SecretSourcePort implementation + factory case): // VAULT, // HashiCorp Vault // AWS_SECRETS_MANAGER, // AWS Secrets Manager // GCP_SECRET_MANAGER // GCP Secret Manager 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 640ac834..6c6b0ffe 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 @@ -1,9 +1,11 @@ package dev.caskeleton.bootstrap.runtime; -import dev.caskeleton.bootstrap.runtime.startup.StartupFailures; -import dev.caskeleton.shared.runtime.RuntimeEnvironment; -import java.util.ArrayList; +import dev.caskeleton.application.outbound.SecretSourcePort; +import dev.caskeleton.bootstrap.runtime.startup.StartupPhase; +import dev.caskeleton.bootstrap.runtime.startup.StartupValidationContext; +import java.util.LinkedHashSet; import java.util.List; +import java.util.Set; import org.springframework.beans.factory.SmartInitializingSingleton; import org.springframework.core.env.ConfigurableEnvironment; import org.springframework.core.env.EnumerablePropertySource; @@ -35,9 +37,6 @@ public class SecretSourceValidator implements SmartInitializingSingleton { public static final List REQUIRED_PROD_SECRETS = List.of( "APP_DATASOURCE_PASSWORD", - "APP_SECURITY_JWT_SIGNING_KEY", - "APP_SECURITY_OAUTH_CLIENT_SECRET", - "APP_EXTERNAL_API_KEY", "APP_CACHE_REDIS_PASSWORD", "APP_CACHE_REDIS_KEY_HMAC_SECRET", "APP_RATE_LIMIT_REDIS_PASSWORD", @@ -49,67 +48,56 @@ public class SecretSourceValidator implements SmartInitializingSingleton { "APP_PRIVACY_PSEUDONYMIZATION_SALT"); private final ConfigurableEnvironment environment; - private final SecretSource secretSource; + private final SecretSourcePort secretSource; - public SecretSourceValidator(ConfigurableEnvironment environment, SecretSource secretSource) { + public SecretSourceValidator(ConfigurableEnvironment environment, SecretSourcePort secretSource) { this.environment = environment; this.secretSource = secretSource; } @Override public void afterSingletonsInstantiated() { - validateNoLocalDevSentinelInProd(); - validateRequiredSecretsPresent(); - } - - private void validateNoLocalDevSentinelInProd() { if (!isProdActive()) { return; } - List offenders = new ArrayList<>(); + + StartupValidationContext validation = + StartupValidationContext.forPhase(StartupPhase.ENV_VALIDATION); + collectLocalDevSentinelViolations(validation); + collectMissingSecretViolations(validation); + validation.failIfViolated( + "prod secret/config-source contract is invalid", + "inject real non-blank secrets from the secret manager / mounted environment; " + + "local/dev sentinel credentials are forbidden in prod."); + } + + private void collectLocalDevSentinelViolations(StartupValidationContext validation) { + Set offenders = new LinkedHashSet<>(); for (PropertySource source : environment.getPropertySources()) { if (source instanceof EnumerablePropertySource enumerable) { for (String name : enumerable.getPropertyNames()) { Object value = enumerable.getProperty(name); - if (value instanceof String text - && text.startsWith(LOCAL_DEV_SENTINEL_PREFIX) - && !offenders.contains(name)) { + if (value instanceof String text && text.startsWith(LOCAL_DEV_SENTINEL_PREFIX)) { offenders.add(name); } } } } - if (!offenders.isEmpty()) { - throw StartupFailures.envValidation( - "prod profile forbids '" - + LOCAL_DEV_SENTINEL_PREFIX - + "' sentinel credential " - + "values, but these keys carry one: " - + offenders - + " — inject real secrets from the secret manager / mounted env for prod."); + for (String offender : offenders) { + validation.reject( + "'" + LOCAL_DEV_SENTINEL_PREFIX + "' sentinel credential is configured for " + offender); } } - private void validateRequiredSecretsPresent() { - if (!isProdActive()) { - return; - } - List missing = new ArrayList<>(); + private void collectMissingSecretViolations(StartupValidationContext validation) { for (String key : REQUIRED_PROD_SECRETS) { if (isRedisMaterial(key) && !isRedisRoleSelected(key)) { continue; } if (secretSource.resolve(key).isEmpty()) { - missing.add(key); + validation.reject(key + " is missing/blank"); } } - if (!missing.isEmpty()) { - throw StartupFailures.envValidation( - "prod profile requires these secrets to be injected, but they are missing/blank: " - + missing - + " — booting with an empty secret is forbidden " - + "(feature-secrets-config-source-contract §테스트 계약)."); - } } /** @@ -170,6 +158,6 @@ public class SecretSourceValidator implements SmartInitializingSingleton { } private boolean isProdActive() { - return RuntimeEnvironment.isProductionActive(List.of(environment.getActiveProfiles())); + return RuntimeProfileSnapshot.from(environment).isProduction(); } } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/StartupSafetyValidator.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/StartupSafetyValidator.java index 49ae8023..b42831e5 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/StartupSafetyValidator.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/StartupSafetyValidator.java @@ -1,13 +1,11 @@ package dev.caskeleton.bootstrap.runtime; +import dev.caskeleton.application.lock.DistributedLockPort; import dev.caskeleton.bootstrap.runtime.startup.StartupPhase; import dev.caskeleton.bootstrap.runtime.startup.StartupValidationContext; import dev.caskeleton.bootstrap.settings.RuntimeSafetySettings; -import dev.caskeleton.shared.runtime.RuntimeEnvironment; -import java.util.List; import org.springframework.beans.factory.ListableBeanFactory; import org.springframework.beans.factory.SmartInitializingSingleton; -import org.springframework.core.env.Environment; /** * Fail-fast startup guard for env-combination invariants. Implemented as a {@link @@ -17,75 +15,51 @@ import org.springframework.core.env.Environment; */ public class StartupSafetyValidator implements SmartInitializingSingleton { - /** - * Bean names every instance-coordination capability must register when {@code - * APP_MULTI_INSTANCE_ENABLED=true}; this validator only asserts their presence. - */ - static final List REQUIRED_MULTI_INSTANCE_BEANS = - List.of( - "distributedLockProvider", // distributed lock (JdbcLockRegistry) - "cacheStampedeProtection", // cache stampede protection (Redisson RLock) - "outboxLeaderElection", // outbox leader election (SKIP LOCKED) - "distributedRateLimiter", // distributed rate limiter (Redis counter) - "migrationStartupRunner" // platform migration startup job - ); + /** Shipped cross-instance lock provider selected by multi-instance mode. */ + static final String DISTRIBUTED_LOCK_PROVIDER_BEAN = "distributedLockProvider"; - private final Environment environment; private final RuntimeSafetySettings settings; private final ListableBeanFactory beanFactory; public StartupSafetyValidator( - Environment environment, RuntimeSafetySettings settings, ListableBeanFactory beanFactory) { - this.environment = environment; + RuntimeSafetySettings settings, ListableBeanFactory beanFactory) { this.settings = settings; this.beanFactory = beanFactory; } @Override public void afterSingletonsInstantiated() { - validateProdSafety(); validateMultiInstance(); } - /** Under the {@code prod} profile, internal-detail and body-capture toggles must be off. */ - private void validateProdSafety() { - if (!isProdActive()) { - return; - } - StartupValidationContext unsafe = StartupValidationContext.forPhase(StartupPhase.PROFILE_CHECK); - if (settings.errorDetailExposureEnabled()) { - unsafe.reject("APP_ERROR_DETAIL_EXPOSURE_ENABLED"); - } - if (settings.logBodyCaptureEnabled()) { - unsafe.reject("APP_LOG_BODY_CAPTURE_ENABLED"); - } - // The phase the context was opened for is what selects PROFILE_MISMATCH (exit 71); the - // classification is no longer restated at the throw site. - unsafe.failIfViolated( - "prod profile forbids these toggles being enabled", - "set them to false for the prod profile."); - } - - /** When multi-instance is on, every instance-coordination capability bean must exist. */ + /** + * When multi-instance mode is on, the application lock boundary must resolve to the shipped + * cross-instance provider. + * + *

    Other capabilities own their own distributed semantics. Cache refresh coordination is + * optional efficiency, rate limiting is validated by its transport/provider contract, and outbox + * coordination exists only when outbox itself is enabled. + */ private void validateMultiInstance() { if (!settings.multiInstanceEnabled()) { return; } - StartupValidationContext missing = + StartupValidationContext invalid = StartupValidationContext.forPhase(StartupPhase.ADAPTER_ENABLEMENT); - for (String beanName : REQUIRED_MULTI_INSTANCE_BEANS) { - if (!beanFactory.containsBean(beanName)) { - missing.reject(beanName); - } + if (!beanFactory.containsBean(DISTRIBUTED_LOCK_PROVIDER_BEAN)) { + invalid.reject(DISTRIBUTED_LOCK_PROVIDER_BEAN + " (missing)"); + } else if (!beanFactory.isTypeMatch( + DISTRIBUTED_LOCK_PROVIDER_BEAN, DistributedLockPort.class)) { + invalid.reject( + DISTRIBUTED_LOCK_PROVIDER_BEAN + + " (must implement " + + DistributedLockPort.class.getName() + + ")"); } // ADAPTER_ENABLEMENT (exit 72) follows from the context's phase. - missing.failIfViolated( - "APP_MULTI_INSTANCE_ENABLED=true requires the instance-coordination beans " - + REQUIRED_MULTI_INSTANCE_BEANS - + ", but these are missing"); + invalid.failIfViolated( + "APP_MULTI_INSTANCE_ENABLED=true requires the cross-instance DistributedLockPort"); } - private boolean isProdActive() { - return RuntimeEnvironment.isProductionActive(List.of(environment.getActiveProfiles())); - } + } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/startup/FlywayProdSafetyValidator.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/startup/FlywayProdSafetyValidator.java index c46959a2..267c8fe7 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/startup/FlywayProdSafetyValidator.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/startup/FlywayProdSafetyValidator.java @@ -1,7 +1,6 @@ package dev.caskeleton.bootstrap.runtime.startup; -import dev.caskeleton.shared.runtime.RuntimeEnvironment; -import java.util.List; +import dev.caskeleton.bootstrap.runtime.RuntimeProfileSnapshot; import org.springframework.beans.factory.SmartInitializingSingleton; import org.springframework.core.env.Environment; @@ -54,6 +53,6 @@ public class FlywayProdSafetyValidator implements SmartInitializingSingleton { } private boolean isProdActive() { - return RuntimeEnvironment.isProductionActive(List.of(environment.getActiveProfiles())); + return RuntimeProfileSnapshot.from(environment).isProduction(); } } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/startup/StartupFailureExceptionReporter.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/startup/StartupFailureExceptionReporter.java index 2e2d1828..f15b93e2 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/startup/StartupFailureExceptionReporter.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/startup/StartupFailureExceptionReporter.java @@ -1,5 +1,6 @@ package dev.caskeleton.bootstrap.runtime.startup; +import dev.caskeleton.adapter.outbound.support.CapabilityStartupValidationException; import org.springframework.boot.SpringBootExceptionReporter; /** @@ -18,6 +19,13 @@ public class StartupFailureExceptionReporter implements SpringBootExceptionRepor if (current instanceof StartupFailureException) { return true; } + if (current instanceof CapabilityStartupValidationException capabilityFailure) { + StartupFailures.emit( + StartupErrorCode.STARTUP_VALIDATION_FAILED, + capabilityFailure.getMessage(), + capabilityFailure.getCause()); + return true; + } if (current.getCause() == current) { break; } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/startup/StartupFailureLogState.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/startup/StartupFailureLogState.java index c4e294c8..b1104141 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/startup/StartupFailureLogState.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/runtime/startup/StartupFailureLogState.java @@ -1,23 +1,32 @@ package dev.caskeleton.bootstrap.runtime.startup; -import java.util.concurrent.atomic.AtomicBoolean; +import ch.qos.logback.core.Context; +import java.util.Objects; +import org.slf4j.LoggerFactory; -/** Process-local marker that the canonical startup failure log has already been emitted. */ +/** Logger-context-local marker that the canonical startup failure log has already been emitted. */ public final class StartupFailureLogState { - private static final AtomicBoolean STARTUP_FAILURE_REPORTED = new AtomicBoolean(false); + private static final String CONTEXT_KEY = + StartupFailureLogState.class.getName() + ".startupFailureReported"; private StartupFailureLogState() {} + /** Marks the current Logback context when Logback is the active SLF4J provider. */ public static void markStartupFailureReported() { - STARTUP_FAILURE_REPORTED.set(true); + Object loggerFactory = LoggerFactory.getILoggerFactory(); + if (loggerFactory instanceof Context context) { + markStartupFailureReported(context); + } } - public static boolean startupFailureReported() { - return STARTUP_FAILURE_REPORTED.get(); + /** Marks one explicit logging context. */ + public static void markStartupFailureReported(Context context) { + Objects.requireNonNull(context, "context").putObject(CONTEXT_KEY, true); } - public static void clearForTest() { - STARTUP_FAILURE_REPORTED.set(false); + /** Whether the canonical startup failure has been emitted in this logging context. */ + public static boolean startupFailureReported(Context context) { + return context != null && Boolean.TRUE.equals(context.getObject(CONTEXT_KEY)); } } diff --git a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/settings/RuntimeSafetySettings.java b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/settings/RuntimeSafetySettings.java index 4bf6ab58..dc685283 100644 --- a/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/settings/RuntimeSafetySettings.java +++ b/src/app-bootstrap/src/main/java/dev/caskeleton/bootstrap/settings/RuntimeSafetySettings.java @@ -4,13 +4,11 @@ import org.springframework.boot.context.properties.ConfigurationProperties; import org.springframework.boot.context.properties.bind.DefaultValue; /** - * Operational safety toggles bound from {@code ca-skeleton.runtime.*} (all default {@code false} - * except migrationOnStartup which defaults to {@code true}), enforced at startup by {@code - * StartupSafetyValidator}. See README for the design rationale. + * Operational runtime settings bound from {@code ca-skeleton.runtime.*}. + * + *

    Only implemented controls belong here. Internal error-detail exposure and HTTP body logging + * have no runtime implementation and therefore no reserved configuration switch. */ @ConfigurationProperties(prefix = "ca-skeleton.runtime") public record RuntimeSafetySettings( - boolean errorDetailExposureEnabled, - boolean logBodyCaptureEnabled, - boolean multiInstanceEnabled, - @DefaultValue("true") boolean migrationOnStartup) {} + boolean multiInstanceEnabled, @DefaultValue("true") boolean migrationOnStartup) {} diff --git a/src/app-bootstrap/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports b/src/app-bootstrap/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports index 643c527d..d31c553b 100644 --- a/src/app-bootstrap/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports +++ b/src/app-bootstrap/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports @@ -1,6 +1,11 @@ +dev.caskeleton.bootstrap.autoconfigure.common.BootstrapClockAutoConfiguration dev.caskeleton.bootstrap.autoconfigure.fileserver.FileserverPlatformAutoConfiguration -dev.caskeleton.bootstrap.autoconfigure.httpclient.HttpClientPlatformAutoConfiguration dev.caskeleton.bootstrap.autoconfigure.jpa.PersistenceJpaRootAutoConfiguration dev.caskeleton.bootstrap.autoconfigure.messaging.DisabledMessagingSentinelAutoConfiguration -dev.caskeleton.bootstrap.autoconfigure.notification.NotificationRootAutoConfiguration dev.caskeleton.bootstrap.activation.AdapterActivationAutoConfiguration +dev.caskeleton.bootstrap.autoconfigure.notification.NotificationApplicationCompositionAutoConfiguration +dev.caskeleton.bootstrap.autoconfigure.redis.RedisCapabilityConfig +dev.caskeleton.bootstrap.autoconfigure.outbox.OutboxConfig +dev.caskeleton.bootstrap.autoconfigure.lock.DistributedLockConfig +dev.caskeleton.bootstrap.autoconfigure.idempotency.IdempotencyProviderSelectionConfig +dev.caskeleton.bootstrap.autoconfigure.tracing.TracingConfig diff --git a/src/app-bootstrap/src/main/resources/application-local.yml b/src/app-bootstrap/src/main/resources/application-local.yml index ea72615b..6e1629c8 100644 --- a/src/app-bootstrap/src/main/resources/application-local.yml +++ b/src/app-bootstrap/src/main/resources/application-local.yml @@ -212,7 +212,7 @@ app: # provided. The switch decides whether there is a broker; this decides which one. broker: ${APP_MESSAGING_BROKER:} notification: - slack: - provider: ${APP_NOTIFICATION_SLACK_PROVIDER:} - email: - provider: ${APP_NOTIFICATION_EMAIL_PROVIDER:} + slack-webhook: + enabled: ${APP_NOTIFICATION_SLACK_WEBHOOK_ENABLED:false} + google-email: + enabled: ${APP_NOTIFICATION_GOOGLE_EMAIL_ENABLED:false} diff --git a/src/app-bootstrap/src/main/resources/application.yml b/src/app-bootstrap/src/main/resources/application.yml index 37d38464..26e7ddb2 100644 --- a/src/app-bootstrap/src/main/resources/application.yml +++ b/src/app-bootstrap/src/main/resources/application.yml @@ -203,7 +203,7 @@ spring: # and the configured limit described a policy nobody could reach. max-file-size: ${APP_FILESERVER_PLATFORM_UPLOAD_MAX_FILE_SIZE:100MB} max-request-size: ${APP_FILESERVER_PLATFORM_UPLOAD_MAX_REQUEST_SIZE:110MB} - # Jackson deserialization policy (feature-boundary-validation-mapping-contract B1). + # Jackson deserialization policy and the single runtime JsonMapper SSOT (feature-boundary-validation-mapping-contract B1). # Every request DTO crosses this boundary; the switches make malformed payloads # fail at the edge rather than silently coercing or dropping fields. jackson: diff --git a/src/app-bootstrap/src/main/resources/config/capabilities.yml b/src/app-bootstrap/src/main/resources/config/capabilities.yml index e2dc450f..52461818 100644 --- a/src/app-bootstrap/src/main/resources/config/capabilities.yml +++ b/src/app-bootstrap/src/main/resources/config/capabilities.yml @@ -25,22 +25,22 @@ ca-skeleton: # every read misses and every miss writes. minimum-hard-ttl: ${APP_CACHE_REDIS_MINIMUM_HARD_TTL:1s} idempotency: - # disabled | jdbc | redis. JDBC is the existing V1 provider; Redis is the owner-safe V2 - # provider. They are mutually exclusive and no V1-to-V2 facade is inferred. + # disabled | jdbc | redis | postgresql. JDBC is the existing V1 provider; Redis and + # PostgreSQL are owner-safe V2 providers. They are mutually exclusive. provider: ${APP_IDEMPOTENCY_PROVIDER:disabled} - key-hmac-secret-reference: secret://environment/APP_IDEMPOTENCY_REDIS_KEY_HMAC_SECRET key-version: 1 command-timeout: ${APP_IDEMPOTENCY_REDIS_COMMAND_TIMEOUT:200ms} processing-lease: ${APP_IDEMPOTENCY_PROCESSING_LEASE:30s} replay-ttl: ${APP_IDEMPOTENCY_TTL:24h} failure-retention: ${APP_IDEMPOTENCY_FAILURE_RETENTION:24h} + # Redis V2 codec identity. PostgreSQL V2 currently owns its json.v1 codec in its provider + # composition and does not consume this Redis-specific setting. response-codec-id: json-v2 # Numeric: the owner-safe claim writes this into the record and compares it there. policy-revision: 2 lease: # disabled | redis. This is EFFICIENCY_ONLY and never supplies fencing. provider: ${APP_LEASE_PROVIDER:disabled} - key-hmac-secret-reference: secret://environment/APP_LEASE_REDIS_KEY_HMAC_SECRET key-version: 1 command-timeout: ${APP_LEASE_REDIS_COMMAND_TIMEOUT:200ms} contention-retry-after: ${APP_LEASE_REDIS_CONTENTION_RETRY_AFTER:50ms} @@ -67,5 +67,9 @@ ca-skeleton: refill-period: ${APP_RATE_LIMIT_REFILL_PERIOD:1s} maximum-cost: ${APP_RATE_LIMIT_MAXIMUM_COST:10} cleanup-grace: ${APP_RATE_LIMIT_CLEANUP_GRACE:5s} - maximum-clock-regression: ${APP_RATE_LIMIT_MAXIMUM_CLOCK_REGRESSION:250ms} - security: + realtime: + replay: + # PostgreSQL-backed retained event history. Disabled unless a composition actually publishes + # events into the store and exposes replay/resume semantics. + enabled: ${APP_REALTIME_REPLAY_ENABLED:false} + retention: ${APP_REALTIME_REPLAY_RETENTION:1h} diff --git a/src/app-bootstrap/src/main/resources/config/fileserver.yml b/src/app-bootstrap/src/main/resources/config/fileserver.yml index 5be8547c..7dac305e 100644 --- a/src/app-bootstrap/src/main/resources/config/fileserver.yml +++ b/src/app-bootstrap/src/main/resources/config/fileserver.yml @@ -33,17 +33,6 @@ app: # While enabled=false none of the detail below is bound: FileserverPlatformAutoConfiguration # binds the block itself, and it is not processed until the master switch is true. Unknown keys # under this prefix are refused rather than ignored. - # Outbound HTTP Client platform. Only the master switch lives here. - # - # The per-client surface is an indexed list, and templating one element would materialise a - # nameless client in every deployment — which the settings' own aggregate validation refuses, so - # the template could not be left in place. Clients are therefore declared straight from the - # environment as APP_HTTPCLIENT_CLIENTS_0_*, registered in - # docs/httpclient/env-fields.yaml, and an APP_HTTPCLIENT_ variable absent from that - # registry fails startup rather than being ignored. - # - # While enabled=false none of it is bound: HttpClientPlatformAutoConfiguration binds the block - # itself and is not processed until the master switch is true. fileserver-platform: enabled: ${APP_FILESERVER_PLATFORM_ENABLED:false} # Writer-lease owner. Must be unique per instance in a multi-instance deployment; the startup diff --git a/src/app-bootstrap/src/main/resources/config/graphql.yml b/src/app-bootstrap/src/main/resources/config/graphql.yml index a3a1d550..5044fb80 100644 --- a/src/app-bootstrap/src/main/resources/config/graphql.yml +++ b/src/app-bootstrap/src/main/resources/config/graphql.yml @@ -10,3 +10,15 @@ backend: # (local->LOCAL, dev->DEV, prod->PRODUCTION_INTERNAL|PRODUCTION_PUBLIC). Replaces the # production boolean and environment enum, which could disagree with each other. deployment-mode: ${APP_GRAPHQL_DEPLOYMENT_MODE:} + execution-profile: ${APP_GRAPHQL_EXECUTION_PROFILE:BLOCKING_MVC} + validation-policy-version: ${APP_GRAPHQL_VALIDATION_POLICY_VERSION:v1} + observed-operation-names: ${APP_GRAPHQL_OBSERVED_OPERATION_NAMES:} + console: + graphiql-enabled: ${APP_GRAPHQL_GRAPHIQL_ENABLED:false} + introspection-enabled: ${APP_GRAPHQL_INTROSPECTION_ENABLED:false} + limits: + maximum-page-size: ${APP_GRAPHQL_MAXIMUM_PAGE_SIZE:100} + maximum-complexity: ${APP_GRAPHQL_MAXIMUM_COMPLEXITY:10000} + preparsed-cache-entries: ${APP_GRAPHQL_PREPARSED_CACHE_ENTRIES:1000} + preparsed-cache-weight: ${APP_GRAPHQL_PREPARSED_CACHE_WEIGHT:10000000} + preparsed-cache-expire-after-access: ${APP_GRAPHQL_PREPARSED_CACHE_EXPIRE_AFTER_ACCESS:30m} diff --git a/src/app-bootstrap/src/main/resources/config/httpclient.yml b/src/app-bootstrap/src/main/resources/config/httpclient.yml index 980c9386..bbd276da 100644 --- a/src/app-bootstrap/src/main/resources/config/httpclient.yml +++ b/src/app-bootstrap/src/main/resources/config/httpclient.yml @@ -2,6 +2,11 @@ # # application.yml 이 spring.config.import 로 취합한다. 이 파일의 값은 application.yml 보다 # 낮고 application-{profile}.yml 보다도 낮으므로, 배포별 오버라이드는 그대로 우선한다. +# +# Only the master switch is templated here. Per-client settings are indexed and bind directly from +# APP_HTTPCLIENT_CLIENTS_N_* according to docs/httpclient/env-fields.yaml; materialising a nameless +# list element in YAML would make an otherwise-disabled deployment invalid. When the master switch +# is false the platform settings are not bound. app: httpclient: enabled: ${APP_HTTPCLIENT_ENABLED:false} diff --git a/src/app-bootstrap/src/main/resources/config/messaging.yml b/src/app-bootstrap/src/main/resources/config/messaging.yml index 2d752237..9cfc3fb6 100644 --- a/src/app-bootstrap/src/main/resources/config/messaging.yml +++ b/src/app-bootstrap/src/main/resources/config/messaging.yml @@ -10,6 +10,9 @@ app: # Active message broker id (e.g. kafka). Blank = messaging disabled (fail-fast on use). # Selects the single MessageBroker; adding a broker is new files only (MessagingConfig). broker: ${APP_MESSAGING_BROKER:} + # Stable logical producer identity for the canonical IntegrationEventPublishPort bridge. + # Blank keeps the canonical bridge absent; identity is never inferred from host/pod/process. + producer-id: ${APP_MESSAGING_PRODUCER_ID:} kafka: # CSV of host:port; required (non-empty) only when broker=kafka. Bound + # validated by KafkaAdapterSettings (format) + KafkaAdapterConfig (required-when-active). diff --git a/src/app-bootstrap/src/main/resources/config/notification.yml b/src/app-bootstrap/src/main/resources/config/notification.yml index 33d46077..22279d63 100644 --- a/src/app-bootstrap/src/main/resources/config/notification.yml +++ b/src/app-bootstrap/src/main/resources/config/notification.yml @@ -2,6 +2,11 @@ # # application.yml 이 spring.config.import 로 취합한다. 이 파일의 값은 application.yml 보다 # 낮고 application-{profile}.yml 보다도 낮으므로, 배포별 오버라이드는 그대로 우선한다. +# +# Notification platform is disabled by default. Disabled means no provider runtime, schema activation +# check, scheduler thread, or notification secret is required. Enabling SERVING mode needs the +# notification schema and at least one assembled provider profile; see +# docs/notification/configuration-reference.md. Inline defaults keep an unused platform inert. ca-skeleton: notification: platform: @@ -18,10 +23,23 @@ ca-skeleton: poll-interval: ${APP_NOTIFICATION_PLATFORM_POLL_INTERVAL:1s} max-global-concurrency: ${APP_NOTIFICATION_PLATFORM_MAX_CONCURRENCY:64} max-additional-attempts: ${APP_NOTIFICATION_PLATFORM_MAX_ADDITIONAL_ATTEMPTS:4} + estimated-dispatch-duration: ${APP_NOTIFICATION_PLATFORM_ESTIMATED_DISPATCH_DURATION:2s} max-queue-age: ${APP_NOTIFICATION_PLATFORM_MAX_QUEUE_AGE:24h} + # Must fit within the deployment's pod termination grace; workers use this exact bound. + shutdown-grace: ${APP_NOTIFICATION_PLATFORM_SHUTDOWN_GRACE:20s} # An ambiguous attempt means the request reached the provider and the outcome could not be # read. Falling back would risk sending the same notification twice, so it is off. allow-ambiguous-fallback: ${APP_NOTIFICATION_PLATFORM_ALLOW_AMBIGUOUS_FALLBACK:false} + # Readiness is deployment-specific: throughput and operational SLOs determine what backlog + # is acceptable. These defaults preserve the original behavior but are no longer hard-coded. + serving-thresholds: + max-backlog-depth: ${APP_NOTIFICATION_PLATFORM_MAX_BACKLOG_DEPTH:100000} + max-oldest-due-age: ${APP_NOTIFICATION_PLATFORM_MAX_OLDEST_DUE_AGE:10m} + max-stuck-leases: ${APP_NOTIFICATION_PLATFORM_MAX_STUCK_LEASES:50} + max-pending-projections: ${APP_NOTIFICATION_PLATFORM_MAX_PENDING_PROJECTIONS:50000} + max-failed-projections: ${APP_NOTIFICATION_PLATFORM_MAX_FAILED_PROJECTIONS:1000} + max-oldest-pending-projection-age: ${APP_NOTIFICATION_PLATFORM_MAX_OLDEST_PENDING_PROJECTION_AGE:15m} + max-oldest-reconciliation-age: ${APP_NOTIFICATION_PLATFORM_MAX_OLDEST_RECONCILIATION_AGE:30m} callbacks: enabled: ${APP_NOTIFICATION_PLATFORM_CALLBACKS_ENABLED:false} # Ceiling is 65508 = the ciphertext column minus the AES-GCM nonce and tag. A larger value @@ -74,19 +92,30 @@ ca-skeleton: timeout: ${APP_NOTIFICATION_PLATFORM_SMTP_TIMEOUT:10s} max-concurrency: ${APP_NOTIFICATION_PLATFORM_SMTP_MAX_CONCURRENCY:4} rate-per-second: ${APP_NOTIFICATION_PLATFORM_SMTP_RATE_PER_SECOND:10} - # What the relay is, as opposed to which profile uses it. Host, port and credentials stay - # spring.mail.*; these are the parts Spring's mail properties have no word for. + ses: + type: SES + enabled: ${APP_NOTIFICATION_PLATFORM_SES_ENABLED:false} + primary-for-channel: ${APP_NOTIFICATION_PLATFORM_SES_PRIMARY:false} + environment: ${APP_NOTIFICATION_PLATFORM_SES_ENVIRONMENT:PRODUCTION} + # This is the SecretMaterialProvider key id backing credential generation 1. + credential-profile: ${APP_NOTIFICATION_PLATFORM_SES_CREDENTIAL_KEY_ID:} + timeout: ${APP_NOTIFICATION_PLATFORM_SES_TIMEOUT:10s} + max-concurrency: ${APP_NOTIFICATION_PLATFORM_SES_MAX_CONCURRENCY:8} + rate-per-second: ${APP_NOTIFICATION_PLATFORM_SES_RATE_PER_SECOND:20} + ses: + endpoint: ${APP_NOTIFICATION_PLATFORM_SES_ENDPOINT:https://email.us-east-1.amazonaws.com} + region: ${APP_NOTIFICATION_PLATFORM_SES_REGION:us-east-1} + sender-identity: ${APP_NOTIFICATION_PLATFORM_SES_SENDER_IDENTITY:} + access-key-id: ${APP_NOTIFICATION_PLATFORM_SES_ACCESS_KEY_ID:} + configuration-set: ${APP_NOTIFICATION_PLATFORM_SES_CONFIGURATION_SET:} + # Relay address, credentials, TLS and socket timeouts are owned by spring.mail.* and + # validated against the actual JavaMailSender when SMTP is assembled. Keeping a second copy + # here would let validation describe a transport that is not the one sending mail. smtp: - # STARTTLS_REQUIRED | IMPLICIT_TLS. There is no plaintext member: the type refuses an - # unencrypted relay by construction rather than by a validator somebody has to run. - tls-mode: ${APP_NOTIFICATION_PLATFORM_SMTP_TLS_MODE:STARTTLS_REQUIRED} # example.invalid is reserved by RFC 2606 and resolves nowhere, so a deployment that forgot # to set one gets a traceable bounce rather than mail apparently from an address it does not # own. sender-identity: ${APP_NOTIFICATION_PLATFORM_SMTP_SENDER_IDENTITY:no-reply@example.invalid} - connect-timeout: ${APP_NOTIFICATION_PLATFORM_SMTP_CONNECT_TIMEOUT:5s} - read-timeout: ${APP_NOTIFICATION_PLATFORM_SMTP_READ_TIMEOUT:10s} - write-timeout: ${APP_NOTIFICATION_PLATFORM_SMTP_WRITE_TIMEOUT:10s} max-concurrency: ${APP_NOTIFICATION_PLATFORM_SMTP_DISPATCH_CONCURRENCY:4} # ---- Key material ------------------------------------------------------- # Eight purposes, eight keys, each base64 of at least 32 bytes and each distinct from every @@ -134,12 +163,12 @@ ca-skeleton: app: notification: - # Active provider id per kind; blank = that kind disabled (fail-fast on use). - # Add a provider = new files only (NotificationConfig); select it here. + # R0 compatibility provider gates. These booleans are the properties the provider + # configurations actually consume; the removed provider-id selectors were never read. # This is the R0 legacy seam. The delivery platform is the separate # ca-skeleton.notification.platform tree below. - slack: - provider: ${APP_NOTIFICATION_SLACK_PROVIDER:} - email: - provider: ${APP_NOTIFICATION_EMAIL_PROVIDER:} + slack-webhook: + enabled: ${APP_NOTIFICATION_SLACK_WEBHOOK_ENABLED:false} + google-email: + enabled: ${APP_NOTIFICATION_GOOGLE_EMAIL_ENABLED:false} diff --git a/src/app-bootstrap/src/main/resources/config/observability.yml b/src/app-bootstrap/src/main/resources/config/observability.yml index 7c500b4a..6b2076ef 100644 --- a/src/app-bootstrap/src/main/resources/config/observability.yml +++ b/src/app-bootstrap/src/main/resources/config/observability.yml @@ -154,7 +154,7 @@ ca-skeleton: # SpanErrorRecorder with its own bean. # D4 disabled-fallback: even when enabled=false, RequestLoggingFilter always # generates a W3C traceparent so meta.traceId and log trace_id are never null. - # D6 per-profile defaults: prod=0.01 / staging=0.10 / dev·local=1.0. + # D6 per-runtime defaults: prod=0.01 / dev·local=1.0 (RuntimeEnvironment SSOT). # APP_TRACING_SAMPLE_RATE overrides the per-profile default when set. tracing: # true | false (boolean_strict). Tracing seam on/off. @@ -165,11 +165,3 @@ ca-skeleton: exporter: # url_or_empty: blank = exporter off (D1 SEAM default); non-blank must be a valid URL. otlp-endpoint: ${OTEL_EXPORTER_OTLP_ENDPOINT:} - -# feature-integration-adapter-templates — optional integration adapter toggles. -# The `app...enabled` flags feed Spring @ConditionalOnProperty (Layer 1): -# disabled (default): messaging binds a fail-fast Disabled* sentinel bean; cache/notification -# contribute nothing and fail fast in their router (CacheStoreRouter / RoutingNotifier) on -# unbound access. Enabled registers the real adapter -# (which needs its project-supplied integration client bean). Domain namespace, NOT a -# generic `app.adapter.*` prefix (branch-note §Audit A1). Env keys are the registry SSOT. diff --git a/src/app-bootstrap/src/main/resources/config/persistence.yml b/src/app-bootstrap/src/main/resources/config/persistence.yml index eef4eedd..96611165 100644 --- a/src/app-bootstrap/src/main/resources/config/persistence.yml +++ b/src/app-bootstrap/src/main/resources/config/persistence.yml @@ -2,6 +2,20 @@ # # application.yml 이 spring.config.import 로 취합한다. 이 파일의 값은 application.yml 보다 # 낮고 application-{profile}.yml 보다도 낮으므로, 배포별 오버라이드는 그대로 우선한다. +spring: + jpa: + properties: + hibernate: + # Advanced JPA batch/fetch/measurement knobs. Defaults preserve Hibernate's off state. + # JpaBatchExecutor requires batch_size > 0 and generate_statistics=true so it can prove + # batching happened instead of trusting a configuration value. + jdbc: + batch_size: ${APP_JPA_HIBERNATE_BATCH_SIZE:0} + order_inserts: ${APP_JPA_HIBERNATE_ORDER_INSERTS:false} + order_updates: ${APP_JPA_HIBERNATE_ORDER_UPDATES:false} + default_batch_fetch_size: ${APP_JPA_HIBERNATE_DEFAULT_BATCH_FETCH_SIZE:0} + generate_statistics: ${APP_JPA_HIBERNATE_GENERATE_STATISTICS:false} + ca-skeleton: # The five optional adapters ship in this artifact and are off unless a deployment says otherwise, # so one jar serves every environment and an operator turns a capability on with one variable. Off @@ -17,11 +31,34 @@ ca-skeleton: # Required non-blank when the switch above is true. Exactly one profile: the runtime builds one # sync client and one pool, and never resolves a non-selected profile's secret. active-profile: ${APP_PERSISTENCE_MONGO_ACTIVE_PROFILE:} - # Canonical HTTP capability activation. Bindings are the sole activation SSOT: provider - # definitions alone are inert, and the current NOT_IMPLEMENTED readiness card rejects ACTIVE - # before any client/executor/pool resource can be created. + # Connection source must also be explicit. Standard deployments set the Spring-native + # SPRING_MONGODB_URI (Boot 4 -> spring.mongodb.uri); typed-profile deployments instead set + # ca-skeleton.persistence-mongo.platform.profiles..uri-secret and supply a + # MongoCredentialResolver. Startup refuses the driver localhost/test fallback when neither exists. + # + # Complete production profile example (17 MongoProfileProperties components): + # platform: + # profiles: + # production: + # uri-secret: secret://mongo/production + # topology: REPLICA_SET + # production: true + # stable-api-strict: true + # consistency-default: PRIMARY_MAJORITY + # server-selection-timeout: 3s + # connect-timeout: 2s + # socket-read-timeout: 5s + # operation-timeout: 3s + # pool-min-size: 2 + # pool-max-size: 40 + # pool-max-wait-time: 500ms + # uuid-representation: STANDARD + # decimal-representation: DECIMAL128 + # runtime-auto-create-indexes: false + # tls-required: true + # authentication-required: true persistence: - vendor: postgresql + vendor: ${APP_PERSISTENCE_VENDOR:postgresql} # JPA named-policy deadline envelope. JpaTransactionSettings validates the hierarchy; # SpringPolicyTransactionPort intersects these limits with the caller's absolute CallBudget # and the actual Hikari connection timeout before acquiring a transaction. diff --git a/src/app-bootstrap/src/main/resources/config/ratelimit.yml b/src/app-bootstrap/src/main/resources/config/ratelimit.yml index 04b3efa4..448ffc24 100644 --- a/src/app-bootstrap/src/main/resources/config/ratelimit.yml +++ b/src/app-bootstrap/src/main/resources/config/ratelimit.yml @@ -12,6 +12,3 @@ app: caller-deadline-budget: 2s # remote-addr-only | forwarded-headers-trusted (trusted ingress only) client-ip-mode: ${APP_RATE_LIMIT_CLIENT_IP_MODE:remote-addr-only} - # Logical-cache-name → backendId routing (CacheStoreRouter). No keys by default — - # forks add e.g. `bindings: { worklog: redis }` or env APP_CACHE_BINDINGS_WORKLOG=redis. - # A binding to a backend that is not enabled fails startup (Layer 3 moved to router). diff --git a/src/app-bootstrap/src/main/resources/config/redis.yml b/src/app-bootstrap/src/main/resources/config/redis.yml index 31092396..a29166e2 100644 --- a/src/app-bootstrap/src/main/resources/config/redis.yml +++ b/src/app-bootstrap/src/main/resources/config/redis.yml @@ -9,7 +9,3 @@ app: # cache or session selects *which* Redis capabilities compose, never *whether* Redis exists. redis: enabled: ${APP_REDIS_ENABLED:false} - # Fileserver R2 exact destination/provider composition. Disabled by default: while false, - # these blank attestation placeholders do not create directories, probe a filesystem, or - # contribute FilePublicationPort. Enabling fails closed unless every local-persistent - # attestation value matches the pre-provisioned root. No implicit local fallback exists. diff --git a/src/app-bootstrap/src/main/resources/config/runtime.yml b/src/app-bootstrap/src/main/resources/config/runtime.yml index 974ce6c9..6ec46cdf 100644 --- a/src/app-bootstrap/src/main/resources/config/runtime.yml +++ b/src/app-bootstrap/src/main/resources/config/runtime.yml @@ -8,12 +8,7 @@ ca-skeleton: app-name: ${APP_NAME} runtime: # feature-env-driven-runtime-configuration D8: enforced at startup by - # StartupSafetyValidator. The two prod-unsafe toggles fail startup if true under # the prod profile; multi-instance fails startup if its coordination beans are absent. - # true | false (internal error detail in responses — forbidden under prod) - error-detail-exposure-enabled: ${APP_ERROR_DETAIL_EXPOSURE_ENABLED:false} - # true | false (request/response body capture in logs — forbidden under prod) - log-body-capture-enabled: ${APP_LOG_BODY_CAPTURE_ENABLED:false} # true | false (requires the 5 instance-coordination beans when true) multi-instance-enabled: ${APP_MULTI_INSTANCE_ENABLED:false} # true | false (whether to run Flyway migrations automatically at startup) @@ -25,31 +20,9 @@ ca-skeleton: lock: wait-time: 3s lease-ttl: 30s - # Which RDBMS vendor composition the persistence adapter registers: postgresql | h2. Bound to - # PersistenceVendorSettings (adapter-persistence), which rejects any other value at startup. - # - # A property rather than a profile check, because the vendor belongs to the datastore and not to - # the environment that happens to use it. The profiles then state their choice: - # application-local.yml selects h2, application-dev.yml and application-prod.yml select - # postgresql, and prod additionally refuses h2 through PersistenceVendorProdSafetyValidator. - # - # The value here is the default for a deployment that activates no profile at all — PostgreSQL, - # the vendor every deployment ran before this selector existed. - # Notification delivery platform. Disabled by default, and disabled means nothing is bound: no - # provider runtime, no schema activation check, no scheduler thread, no secret required. Enabling - # it needs a real database with the notification schema stream applied and at least one provider - # profile with credentials — see docs/notification/configuration-reference.md, which is the - # reference this tree is kept in step with. - # - # Every value carries an inline default so that a deployment leaving the platform off never has to - # supply an environment variable for a subsystem it is not running. The tree existed only as - # relaxed-binding environment variables until 2026-08-15: a template user could not discover which - # profile, secret, callback and activation settings had to line up, because nothing wrote them - # down together. presentation: # feature-api-contract-baseline D2: API version prefix. Default is the URI # prefix "/v1" (major-version path, AIP-185); override via env, or set "" for - # no prefix. The supplemental "X-Api-Version" header never overrides the path. api-base-path: ${PRESENTATION_API_BASE_PATH:/v1} async: # feature-background-job-async-contract D7 — @Async ThreadPoolTaskExecutor pool sizing. diff --git a/src/app-bootstrap/src/main/resources/config/security.yml b/src/app-bootstrap/src/main/resources/config/security.yml index df1de715..c18afa29 100644 --- a/src/app-bootstrap/src/main/resources/config/security.yml +++ b/src/app-bootstrap/src/main/resources/config/security.yml @@ -34,11 +34,9 @@ ca-skeleton: # alternative). Keys are RAW IdP role names (no ROLE_ prefix — that prefix only # exists on Spring authorities, not on the principal's raw role set), looked up # case-insensitively. Values are explicitly enumerated `resource:action` permissions - # (no wildcards — least-privilege, OWASP-AUTHZ-C4). The values below are the - # sample-portfolio demonstration (§5): `user` may read/write, only `admin` may close. + # (no wildcards — least-privilege, OWASP-AUTHZ-C4). The production defaults only grant + # platform-owned permissions; sample-domain permissions live in sample-portfolio fixtures. role-permissions: - user: worklog:read,worklog:write - admin: worklog:read,worklog:write,worklog:close # The notification platform's own two permissions, granted to two roles rather than one. # Publishing a template changes what every future submission renders, so a service that may # send notifications is not thereby a service that may rewrite them; a deployment that wants diff --git a/src/app-bootstrap/src/main/resources/config/server.yml b/src/app-bootstrap/src/main/resources/config/server.yml index 16014fdf..d60157fd 100644 --- a/src/app-bootstrap/src/main/resources/config/server.yml +++ b/src/app-bootstrap/src/main/resources/config/server.yml @@ -8,7 +8,7 @@ server: # graceful | immediate shutdown: ${APP_SERVER_SHUTDOWN:graceful} # none | native | framework (trust X-Forwarded-* behind LB/proxy) - forward-headers-strategy: ${APP_SERVER_FORWARD_HEADERS_STRATEGY:framework} + forward-headers-strategy: ${APP_SERVER_FORWARD_HEADERS_STRATEGY:none} tomcat: threads: # integer >= 1 diff --git a/src/app-bootstrap/src/main/resources/logback-spring.xml b/src/app-bootstrap/src/main/resources/logback-spring.xml index d6c55223..21aad2d0 100644 --- a/src/app-bootstrap/src/main/resources/logback-spring.xml +++ b/src/app-bootstrap/src/main/resources/logback-spring.xml @@ -6,17 +6,13 @@ + source="SPRING_PROFILES_ACTIVE" defaultValue="unresolved"/> @@ -72,7 +68,7 @@ - + diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/activation/AdapterActivationInventory.java b/src/app-bootstrap/src/systemTest/java/dev/caskeleton/bootstrap/activation/AdapterActivationInventory.java similarity index 100% rename from src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/activation/AdapterActivationInventory.java rename to src/app-bootstrap/src/systemTest/java/dev/caskeleton/bootstrap/activation/AdapterActivationInventory.java diff --git a/src/app-bootstrap/src/systemTest/java/dev/caskeleton/bootstrap/activation/BootstrapCapabilityReachabilitySystemTest.java b/src/app-bootstrap/src/systemTest/java/dev/caskeleton/bootstrap/activation/BootstrapCapabilityReachabilitySystemTest.java new file mode 100644 index 00000000..73a6d380 --- /dev/null +++ b/src/app-bootstrap/src/systemTest/java/dev/caskeleton/bootstrap/activation/BootstrapCapabilityReachabilitySystemTest.java @@ -0,0 +1,183 @@ +package dev.caskeleton.bootstrap.activation; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.adapter.outbound.cache.redis.sdk.config.RedisSdkSettings; +import dev.caskeleton.adapter.outbound.httpclient.autoconfigure.HttpClientPlatformSettings; +import dev.caskeleton.adapter.outbound.httpclient.service.HttpServiceRegistry; +import dev.caskeleton.adapter.outbound.messaging.kafka.KafkaSender; +import dev.caskeleton.application.idempotency.IdempotencyExecutor; +import dev.caskeleton.application.idempotency.v2.IdempotencyExecutorV2; +import dev.caskeleton.bootstrap.autoconfigure.lock.MeteredDistributedLockPort; +import dev.caskeleton.bootstrap.autoconfigure.outbox.OutboxMetrics; +import dev.caskeleton.bootstrap.autoconfigure.outbox.OutboxRelayScheduler; +import dev.caskeleton.bootstrap.autoconfigure.redis.RedisCapabilitySettings; +import io.micrometer.tracing.Tracer; +import java.lang.reflect.Proxy; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.support.BeanDefinitionRegistry; +import org.springframework.beans.factory.support.RootBeanDefinition; +import org.springframework.context.ConfigurableApplicationContext; +import org.springframework.core.ResolvableType; +import org.springframework.scheduling.config.TaskManagementConfigUtils; + +/** + * Shipped-root proof for bootstrap-owned capability auto-configurations. + * + *

    The unit tests exercise each configuration in isolation. This test boots the real application + * scan plus Boot auto-configuration discovery and proves that making the roots reachable did not + * turn their disabled state into runtime work. + */ +class BootstrapCapabilityReachabilitySystemTest { + + @Test + void allOffDeploymentDiscoversRootsWithoutCreatingOptionalRuntimeWork() { + try (ConfigurableApplicationContext context = + ShippedCompositionHarness.shippedComposition("local") + .run(ShippedCompositionHarness.allOffArguments())) { + assertThat(context.getBeansOfType(RedisCapabilitySettings.class)).isEmpty(); + assertThat(context.getBeansOfType(HttpClientPlatformSettings.class)).isEmpty(); + assertThat(context.getBeansOfType(OutboxRelayScheduler.class)).isEmpty(); + assertThat(context.getBeansOfType(MeteredDistributedLockPort.class)).isEmpty(); + assertThat(context.getBeansOfType(IdempotencyExecutor.class)).isEmpty(); + assertThat(context.getBeansOfType(IdempotencyExecutorV2.class)).isEmpty(); + assertThat( + context.containsBean( + TaskManagementConfigUtils.SCHEDULED_ANNOTATION_PROCESSOR_BEAN_NAME)) + .isFalse(); + assertThat(context.getBeansOfType(Tracer.class)).isEmpty(); + } + } + + @Test + void redisRootIsReachableFromTheShippedCompositionWhenEnabled() { + try (ConfigurableApplicationContext context = + ShippedCompositionHarness.shippedComposition("local") + .run( + ShippedCompositionHarness.allOffExcept( + "--app.redis.enabled=true", + "--app.redis.authentication.anonymous-access-accepted=true"))) { + assertThat(context.getBeansOfType(RedisSdkSettings.class)).hasSize(1); + assertThat(context.getBeansOfType(RedisCapabilitySettings.class)).hasSize(1); + } + } + + @Test + void tracingRootIsReachableFromTheShippedCompositionWhenEnabled() { + try (ConfigurableApplicationContext context = + ShippedCompositionHarness.shippedComposition("local") + .run(ShippedCompositionHarness.allOffExcept("--ca-skeleton.tracing.enabled=true"))) { + assertThat(context.getBeansOfType(Tracer.class)).hasSize(1); + } + } + + @Test + void httpClientRootIsReachableFromTheShippedCompositionWhenEnabled() { + try (ConfigurableApplicationContext context = + ShippedCompositionHarness.shippedComposition("local") + .run( + ShippedCompositionHarness.allOffExcept( + "--app.httpclient.enabled=true", + "--app.httpclient.clients[0].name=payment", + "--app.httpclient.clients[0].base-url=https://payment.test", + "--app.httpclient.clients[0].allowed-hosts[0]=payment.test", + "--app.httpclient.clients[0].allowed-ports[0]=443", + "--app.httpclient.clients[0].request.max-body-bytes=1024", + "--app.httpclient.clients[0].tls.profile-id=payment"))) { + assertThat(context.getBeansOfType(HttpClientPlatformSettings.class)).hasSize(1); + assertThat(context.getBeansOfType(HttpServiceRegistry.class)).hasSize(1); + } + } + + @Test + void distributedLockRootIsReachableFromTheShippedCompositionWhenEnabled() { + try (ConfigurableApplicationContext context = + ShippedCompositionHarness.shippedComposition("local") + .run( + ShippedCompositionHarness.allOffWithH2( + "reachability_lock", "--ca-skeleton.runtime.multi-instance-enabled=true"))) { + assertThat(context.containsBean("jdbcDistributedLock")).isTrue(); + assertThat(context.containsBean("distributedLockProvider")).isTrue(); + assertThat(context.getBean("distributedLockProvider")) + .isInstanceOf(MeteredDistributedLockPort.class); + } + } + + @Test + void jdbcIdempotencyRootIsReachableFromTheShippedCompositionWhenEnabled() { + try (ConfigurableApplicationContext context = + ShippedCompositionHarness.shippedComposition("local") + .run( + ShippedCompositionHarness.allOffWithH2( + "reachability_idempotency", + "--ca-skeleton.capabilities.idempotency.provider=jdbc"))) { + assertThat(context.getBeansOfType(IdempotencyExecutor.class)).hasSize(1); + assertThat( + context.containsBean( + TaskManagementConfigUtils.SCHEDULED_ANNOTATION_PROCESSOR_BEAN_NAME)) + .isTrue(); + } + } + + @Test + void outboxRootIsReachableFromTheShippedCompositionWhenEnabled() { + var builder = + ShippedCompositionHarness.shippedComposition("local") + .initializers(BootstrapCapabilityReachabilitySystemTest::registerNoOpKafkaSeams); + + try (ConfigurableApplicationContext context = + builder.run( + ShippedCompositionHarness.allOffWithH2( + "reachability_outbox", + "--ca-skeleton.outbox.enabled=true", + "--ca-skeleton.outbox.relay-enabled=false", + "--app.messaging.enabled=true", + "--app.messaging.broker=kafka", + "--app.messaging.kafka.brokers[0]=unused.invalid:9092", + "--spring.kafka.bootstrap-servers=unused.invalid:9092"))) { + assertThat(context.containsBean("outboxLeaderElection")).isTrue(); + assertThat(context.getBeansOfType(OutboxMetrics.class)).hasSize(1); + assertThat(context.getBeansOfType(OutboxRelayScheduler.class)).isEmpty(); + } + } + + private static void registerNoOpKafkaSeams(ConfigurableApplicationContext context) { + Class producer = loadKafkaProducerType(); + RootBeanDefinition definition = new RootBeanDefinition(); + definition.setTargetType( + ResolvableType.forClassWithGenerics(producer, byte[].class, byte[].class)); + definition.setInstanceSupplier(BootstrapCapabilityReachabilitySystemTest::noOpKafkaProducer); + ((BeanDefinitionRegistry) context.getBeanFactory()) + .registerBeanDefinition("kafkaSeamProducer", definition); + context + .getBeanFactory() + .registerSingleton("reachabilityKafkaSender", (KafkaSender) message -> {}); + } + + private static Class loadKafkaProducerType() { + try { + return Class.forName("org.apache.kafka.clients.producer.Producer"); + } catch (ClassNotFoundException missingKafkaClient) { + throw new LinkageError("shipped Kafka client is not loadable", missingKafkaClient); + } + } + + private static Object noOpKafkaProducer() { + Class producer = loadKafkaProducerType(); + return Proxy.newProxyInstance( + producer.getClassLoader(), + new Class[] {producer}, + (proxy, method, arguments) -> { + if (method.getName().equals("toString")) { + return "reachability-noop-kafka-producer"; + } + if (method.getName().equals("hashCode")) { + return System.identityHashCode(proxy); + } + if (method.getName().equals("equals")) { + return proxy == arguments[0]; + } + return null; + }); + } +} diff --git a/src/app-bootstrap/src/systemTest/java/dev/caskeleton/bootstrap/activation/FiveAdapterOffInventoryTest.java b/src/app-bootstrap/src/systemTest/java/dev/caskeleton/bootstrap/activation/FiveAdapterOffInventoryTest.java index e5537d15..44c73127 100644 --- a/src/app-bootstrap/src/systemTest/java/dev/caskeleton/bootstrap/activation/FiveAdapterOffInventoryTest.java +++ b/src/app-bootstrap/src/systemTest/java/dev/caskeleton/bootstrap/activation/FiveAdapterOffInventoryTest.java @@ -13,7 +13,7 @@ import org.junit.jupiter.api.Test; import org.springframework.context.ConfigurableApplicationContext; /** - * With all five master switches off, the application must hold nothing that belongs to any of them. + * With all registered master switches off, the application must hold nothing that belongs to any of them. * *

    This boots the real composition root rather than an {@code ApplicationContextRunner}, because * the two things most likely to defeat a master switch are exactly the two a runner does not have: diff --git a/src/app-bootstrap/src/systemTest/java/dev/caskeleton/bootstrap/activation/ShippedCompositionHarness.java b/src/app-bootstrap/src/systemTest/java/dev/caskeleton/bootstrap/activation/ShippedCompositionHarness.java index 7bd93104..eb4ffd94 100644 --- a/src/app-bootstrap/src/systemTest/java/dev/caskeleton/bootstrap/activation/ShippedCompositionHarness.java +++ b/src/app-bootstrap/src/systemTest/java/dev/caskeleton/bootstrap/activation/ShippedCompositionHarness.java @@ -3,6 +3,8 @@ package dev.caskeleton.bootstrap.activation; import dev.caskeleton.bootstrap.CaSkeletonApplication; import java.io.IOException; import java.net.URL; +import java.util.LinkedHashMap; +import java.util.Map; import org.springframework.boot.WebApplicationType; import org.springframework.boot.builder.SpringApplicationBuilder; import org.springframework.boot.context.TypeExcludeFilter; @@ -103,11 +105,74 @@ public final class ShippedCompositionHarness { "--backend.graphql.enabled=false", "--ca-skeleton.outbox.enabled=false", "--ca-skeleton.outbox.relay-enabled=false", + "--app.redis.enabled=false", + "--ca-skeleton.runtime.multi-instance-enabled=false", "--ca-skeleton.capabilities.idempotency.provider=disabled", + "--ca-skeleton.tracing.enabled=false", "--management.endpoint.health.group.readiness.include=readinessState" }; } + /** + * Starts from the all-off deployment and replaces selected command-line properties by key. + * + *

    Spring's command-line parser treats duplicate option names as a multi-value property, which + * is not a reliable way to say "the later value wins". Building one argument per key keeps each + * reachability test explicit without copying the all-off inventory. + * + * @param overrides command-line arguments in {@code --key=value} form + * @return one argument per key, with overrides replacing the all-off value + */ + public static String[] allOffExcept(String... overrides) { + Map arguments = new LinkedHashMap<>(); + for (String argument : allOffArguments()) { + arguments.put(argumentKey(argument), argument); + } + for (String override : overrides) { + arguments.put(argumentKey(override), override); + } + return arguments.values().toArray(String[]::new); + } + + private static String argumentKey(String argument) { + if (argument == null || !argument.startsWith("--") || !argument.contains("=")) { + throw new IllegalArgumentException("expected --key=value argument, got: " + argument); + } + return argument.substring(2, argument.indexOf('=')); + } + + /** + * Starts from the all-off deployment with the repository's explicit local H2 opt-out enabled. + * + *

    This mirrors {@code bootRunH2}: H2 is a wiring/behaviour lane only, Flyway stays off and + * Hibernate owns the ephemeral schema. A unique database name keeps independently runnable system + * tests from sharing an in-memory schema. + * + * @param databaseName unique in-memory database name + * @param overrides additional command-line overrides + * @return one argument per key + */ + public static String[] allOffWithH2(String databaseName, String... overrides) { + String[] h2 = + new String[] { + "--ca-skeleton.persistence-jpa.enabled=true", + "--ca-skeleton.persistence.vendor=h2", + "--spring.datasource.url=jdbc:h2:mem:" + + databaseName + + ";MODE=PostgreSQL;DATABASE_TO_LOWER=TRUE;DB_CLOSE_DELAY=-1", + "--spring.datasource.username=sa", + "--spring.datasource.password=", + "--spring.datasource.driver-class-name=org.h2.Driver", + "--spring.flyway.enabled=false", + "--spring.jpa.hibernate.ddl-auto=create-drop", + "--ca-skeleton.runtime.migration-on-startup=false" + }; + String[] combined = new String[h2.length + overrides.length]; + System.arraycopy(h2, 0, combined, 0, h2.length); + System.arraycopy(overrides, 0, combined, h2.length, overrides.length); + return allOffExcept(combined); + } + /** * Excludes any candidate whose class file lives in a test output directory. * diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/adapter/outbound/DisabledAdapterSentinelTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/adapter/outbound/DisabledAdapterSentinelTest.java index b8bca9e6..497ee36d 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/adapter/outbound/DisabledAdapterSentinelTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/adapter/outbound/DisabledAdapterSentinelTest.java @@ -5,7 +5,7 @@ import static org.assertj.core.api.Assertions.assertThatThrownBy; import dev.caskeleton.adapter.outbound.messaging.core.DisabledMessagePublisher; import dev.caskeleton.adapter.outbound.messaging.core.OutboundMessage; import dev.caskeleton.adapter.outbound.notification.core.RoutingNotifier; -import dev.caskeleton.application.notification.Channel; +import dev.caskeleton.application.notification.NotificationChannel; import dev.caskeleton.application.notification.Notification; import dev.caskeleton.shared.error.AdapterDisabledException; import java.util.List; @@ -39,7 +39,7 @@ class DisabledAdapterSentinelTest { void unwiredNotificationEmailFailsFast() { // router-fail-fast: no providers, no routes → AdapterDisabledException on first call assertThatThrownBy( - () -> new RoutingNotifier(List.of(), Map.of()).notify(Channel.EMAIL, STUB_NOTIFICATION)) + () -> new RoutingNotifier(List.of(), Map.of()).notify(NotificationChannel.EMAIL, STUB_NOTIFICATION)) .isInstanceOf(AdapterDisabledException.class) .extracting("adapterName") .isEqualTo("notification"); @@ -50,7 +50,7 @@ class DisabledAdapterSentinelTest { assertThatThrownBy( () -> new RoutingNotifier(List.of(), Map.of()) - .notify(Channel.SLACK, "alerts", STUB_NOTIFICATION)) + .notify(NotificationChannel.SLACK, "alerts", STUB_NOTIFICATION)) .isInstanceOf(AdapterDisabledException.class) .extracting("adapterName") .isEqualTo("notification"); diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/adapter/outbound/OptionalAdapterBeanGatingTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/adapter/outbound/OptionalAdapterBeanGatingTest.java index 375a03f4..80ee33b6 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/adapter/outbound/OptionalAdapterBeanGatingTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/adapter/outbound/OptionalAdapterBeanGatingTest.java @@ -6,6 +6,7 @@ import static org.assertj.core.api.Assertions.assertThatThrownBy; import dev.caskeleton.adapter.outbound.fileserver.FileExportConfig; import dev.caskeleton.adapter.outbound.fileserver.FileserverR2Config; +import dev.caskeleton.adapter.outbound.httpclient.autoconfigure.HttpClientPlatformAutoConfiguration; import dev.caskeleton.adapter.outbound.httpclient.profile.ClientRuntimeRegistry; import dev.caskeleton.adapter.outbound.messaging.MessagingConfig; import dev.caskeleton.adapter.outbound.messaging.core.DisabledMessagePublisher; @@ -26,12 +27,11 @@ import dev.caskeleton.adapter.outbound.notification.slack.webhook.SlackClient; import dev.caskeleton.adapter.outbound.notification.slack.webhook.SlackNotificationAdapterConfig; import dev.caskeleton.adapter.outbound.support.OutboundSupportConfig; import dev.caskeleton.application.filepublication.FilePublicationPort; -import dev.caskeleton.application.notification.Channel; +import dev.caskeleton.application.notification.NotificationChannel; import dev.caskeleton.application.notification.Notification; import dev.caskeleton.application.notification.NotificationPort; import dev.caskeleton.application.outbox.OutboxMessagePublishPort; import dev.caskeleton.application.outbox.OutboxRelayFailureReportPort; -import dev.caskeleton.bootstrap.autoconfigure.httpclient.HttpClientPlatformAutoConfiguration; import dev.caskeleton.shared.error.AdapterDisabledException; import dev.caskeleton.shared.ratelimit.EdgeRateLimitPort; import org.junit.jupiter.api.Test; @@ -103,7 +103,7 @@ class OptionalAdapterBeanGatingTest { // notification D4: zero providers boot fine, unbound route fails fast in RoutingNotifier NotificationPort notificationPort = context.getBean(NotificationPort.class); assertThat(notificationPort).isInstanceOf(RoutingNotifier.class); - assertThatThrownBy(() -> notificationPort.notify(Channel.EMAIL, STUB_NOTIFICATION)) + assertThatThrownBy(() -> notificationPort.notify(NotificationChannel.EMAIL, STUB_NOTIFICATION)) .isInstanceOf(AdapterDisabledException.class) .extracting("adapterName") .isEqualTo("notification"); @@ -144,7 +144,7 @@ class OptionalAdapterBeanGatingTest { NotificationPort port = context.getBean(NotificationPort.class); assertThat(port).isInstanceOf(RoutingNotifier.class); // stub SlackClient is a no-op — call succeeds without exception - assertThatCode(() -> port.notify(Channel.SLACK, STUB_NOTIFICATION)) + assertThatCode(() -> port.notify(NotificationChannel.SLACK, STUB_NOTIFICATION)) .doesNotThrowAnyException(); }); } @@ -161,7 +161,7 @@ class OptionalAdapterBeanGatingTest { assertThat(context.getBeansOfType(NotificationProvider.class)).hasSize(1); NotificationPort port = context.getBean(NotificationPort.class); assertThat(port).isInstanceOf(RoutingNotifier.class); - assertThatCode(() -> port.notify(Channel.EMAIL, STUB_NOTIFICATION)) + assertThatCode(() -> port.notify(NotificationChannel.EMAIL, STUB_NOTIFICATION)) .doesNotThrowAnyException(); }); } diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/activation/CapabilityDependencyValidatorTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/activation/CapabilityDependencyValidatorTest.java index a5ae3245..1cb5ba03 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/activation/CapabilityDependencyValidatorTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/activation/CapabilityDependencyValidatorTest.java @@ -1,7 +1,10 @@ package dev.caskeleton.bootstrap.activation; import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import dev.caskeleton.bootstrap.runtime.startup.RequiredAdapterDisabledException; +import dev.caskeleton.bootstrap.runtime.startup.StartupErrorCode; import java.util.List; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; @@ -65,13 +68,31 @@ class CapabilityDependencyValidatorTest { } @Test - @DisplayName("the multi-instance lock needs a database") - void multiInstanceLockNeedsPersistence() { + @DisplayName("the PostgreSQL owner-safe idempotency provider needs JPA") + void postgresqlIdempotencyNeedsPersistence() { MockEnvironment environment = - allOff().withProperty("ca-skeleton.lock.multi-instance-enabled", "true"); + allOff().withProperty("ca-skeleton.capabilities.idempotency.provider", "postgresql"); assertThat(CapabilityDependencyValidator.violations(environment)) - .anySatisfy(v -> assertThat(v).contains("ca-skeleton.persistence-jpa.enabled")); + .anySatisfy( + violation -> + assertThat(violation) + .contains("provider=postgresql") + .contains("ca-skeleton.persistence-jpa.enabled")); + } + + @Test + @DisplayName("the canonical multi-instance runtime switch needs JPA") + void multiInstanceLockNeedsPersistence() { + MockEnvironment environment = + allOff().withProperty("ca-skeleton.runtime.multi-instance-enabled", "true"); + + assertThat(CapabilityDependencyValidator.violations(environment)) + .anySatisfy( + violation -> + assertThat(violation) + .contains("ca-skeleton.runtime.multi-instance-enabled") + .contains("ca-skeleton.persistence-jpa.enabled")); } @Test @@ -95,6 +116,51 @@ class CapabilityDependencyValidatorTest { .anySatisfy(v -> assertThat(v).contains("ca-skeleton.persistence-mongo.active-profile")); } + @Test + @DisplayName( + "Mongo on refuses the driver localhost/test fallback when no connection source exists") + void mongoNeedsAnExplicitConnectionSource() { + MockEnvironment environment = + allOff() + .withProperty("ca-skeleton.persistence-mongo.enabled", "true") + .withProperty("ca-skeleton.persistence-mongo.active-profile", "primary"); + + assertThat(CapabilityDependencyValidator.violations(environment)) + .anySatisfy( + violation -> + assertThat(violation) + .contains("spring.mongodb.uri") + .contains("platform.profiles.primary.uri-secret")); + } + + @Test + @DisplayName("Mongo standard URI is an explicit connection source") + void mongoAcceptsTheStandardSpringUriConnectionSource() { + MockEnvironment environment = + allOff() + .withProperty("ca-skeleton.persistence-mongo.enabled", "true") + .withProperty("ca-skeleton.persistence-mongo.active-profile", "primary") + .withProperty("spring.mongodb.uri", "mongodb://mongo:27017/app"); + + assertThat(CapabilityDependencyValidator.violations(environment)) + .noneSatisfy(violation -> assertThat(violation).contains("connection source")); + } + + @Test + @DisplayName("Mongo active profile URI secret is an explicit connection source") + void mongoAcceptsTheTypedProfileSecretConnectionSource() { + MockEnvironment environment = + allOff() + .withProperty("ca-skeleton.persistence-mongo.enabled", "true") + .withProperty("ca-skeleton.persistence-mongo.active-profile", "primary") + .withProperty( + "ca-skeleton.persistence-mongo.platform.profiles.primary.uri-secret", + "secret://mongodb/primary-uri"); + + assertThat(CapabilityDependencyValidator.violations(environment)) + .noneSatisfy(violation -> assertThat(violation).contains("connection source")); + } + @Test @DisplayName("GraphQL on needs a deployment mode") void graphQlNeedsADeploymentMode() { @@ -133,6 +199,30 @@ class CapabilityDependencyValidatorTest { assertThat(CapabilityDependencyValidator.violations(environment)).isEmpty(); } + @Test + @DisplayName( + "requireSatisfied raises one typed adapter-enablement failure containing every dependency") + void requireSatisfiedAggregatesThroughTheTypedStartupContext() { + MockEnvironment environment = allOff().withProperty("ca-skeleton.outbox.enabled", "true"); + + assertThatThrownBy(() -> CapabilityDependencyValidator.requireSatisfied(environment)) + .isInstanceOfSatisfying( + RequiredAdapterDisabledException.class, + failure -> { + assertThat(failure.errorCode()).isEqualTo(StartupErrorCode.REQUIRED_ADAPTER_DISABLED); + assertThat(failure.getMessage()) + .contains("dependencies are off") + .contains("ca-skeleton.persistence-jpa.enabled") + .contains("app.messaging.enabled"); + }); + } + + @Test + @DisplayName("requireSatisfied returns quietly when the dependency graph is consistent") + void requireSatisfiedAcceptsAConsistentGraph() { + CapabilityDependencyValidator.requireSatisfied(allOff()); + } + @Test @DisplayName("a satisfied outbox graph is accepted") void aSatisfiedOutboxGraphIsAccepted() { diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/activation/MasterSwitchRegistryContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/activation/MasterSwitchRegistryContractTest.java index ec4d36c3..d918475a 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/activation/MasterSwitchRegistryContractTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/activation/MasterSwitchRegistryContractTest.java @@ -62,8 +62,8 @@ class MasterSwitchRegistryContractTest { for (String demoted : new String[] { "APP_MESSAGING_BROKER", - "APP_NOTIFICATION_SLACK_PROVIDER", - "APP_NOTIFICATION_EMAIL_PROVIDER" + "APP_NOTIFICATION_SLACK_WEBHOOK_ENABLED", + "APP_NOTIFICATION_GOOGLE_EMAIL_ENABLED" }) { if (!registry.contains("name: " + demoted)) { continue; diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/activation/ShippedRuntimeFacadePresenceTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/activation/ShippedRuntimeFacadePresenceTest.java index 5853d8cc..196e343f 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/activation/ShippedRuntimeFacadePresenceTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/activation/ShippedRuntimeFacadePresenceTest.java @@ -7,7 +7,7 @@ import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; /** - * All five adapters ship in one artifact, and are off because a switch says so. + * All master-gated runtime capabilities ship in one artifact, and are off because a switch says so. * *

    An adapter whose classes are absent also holds no beans, which makes it indistinguishable from * a correctly gated one in any bean-inventory test — and it is not the same thing at all. An diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/common/BootstrapClockAutoConfigurationTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/common/BootstrapClockAutoConfigurationTest.java new file mode 100644 index 00000000..61218454 --- /dev/null +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/common/BootstrapClockAutoConfigurationTest.java @@ -0,0 +1,66 @@ +package dev.caskeleton.bootstrap.autoconfigure.common; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.bootstrap.autoconfigure.idempotency.IdempotencyConfig; +import java.time.Clock; +import java.time.Instant; +import java.time.ZoneOffset; +import java.util.Arrays; +import org.junit.jupiter.api.Test; +import org.springframework.boot.autoconfigure.AutoConfiguration; +import org.springframework.boot.autoconfigure.AutoConfigurations; +import org.springframework.boot.context.annotation.ImportCandidates; +import org.springframework.boot.test.context.runner.ApplicationContextRunner; +import org.springframework.context.annotation.Bean; + +class BootstrapClockAutoConfigurationTest { + + private static final String CONFIGURATION = + "dev.caskeleton.bootstrap.autoconfigure.common.BootstrapClockAutoConfiguration"; + + @Test + void shippedAutoConfigurationImportsDiscoverTheApplicationClockRoot() { + assertThat( + ImportCandidates.load(AutoConfiguration.class, getClass().getClassLoader()) + .getCandidates()) + .contains(CONFIGURATION); + } + + @Test + void theApplicationClockExistsWithoutAnyOptionalCapability() throws Exception { + new ApplicationContextRunner() + .withConfiguration(AutoConfigurations.of(configurationClass())) + .run( + context -> { + assertThat(context).hasSingleBean(Clock.class); + assertThat(context.getBean(Clock.class).getZone()).isEqualTo(ZoneOffset.UTC); + }); + } + + @Test + void idempotencyCompositionDoesNotOwnTheApplicationClock() { + assertThat(Arrays.stream(IdempotencyConfig.class.getDeclaredMethods())) + .noneMatch( + method -> + method.getReturnType() == Clock.class && method.isAnnotationPresent(Bean.class)); + } + + @Test + void anAdopterClockWinsOverTheDefault() throws Exception { + Clock adopterClock = Clock.fixed(Instant.parse("2026-09-18T00:00:00Z"), ZoneOffset.UTC); + + new ApplicationContextRunner() + .withConfiguration(AutoConfigurations.of(configurationClass())) + .withBean(Clock.class, () -> adopterClock) + .run( + context -> { + assertThat(context).hasSingleBean(Clock.class); + assertThat(context.getBean(Clock.class)).isSameAs(adopterClock); + }); + } + + private static Class configurationClass() throws ClassNotFoundException { + return Class.forName(CONFIGURATION); + } +} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverAssemblyFixture.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverAssemblyFixture.java index 5ea5828c..34aaf629 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverAssemblyFixture.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverAssemblyFixture.java @@ -11,7 +11,9 @@ import dev.caskeleton.application.fileserver.cleanup.QuotaReclaimGateway; import dev.caskeleton.application.fileserver.recovery.RecoveryQueue; import dev.caskeleton.application.fileserver.recovery.StagingUploadLocator; import dev.caskeleton.application.fileserver.upload.QuotaCommitGateway; -import dev.caskeleton.application.transaction.TransactionPort; +import dev.caskeleton.application.transaction.PolicyTransactionPort; +import dev.caskeleton.application.transaction.TransactionRequest; +import dev.caskeleton.application.transaction.TransactionResult; import java.io.IOException; import java.io.UncheckedIOException; import java.nio.file.Files; @@ -50,8 +52,8 @@ public abstract class FileserverAssemblyFixture { * — what this proves is that the wiring supplies one at all. */ @Bean - TransactionPort transactions() { - return new TransactionPort() { + PolicyTransactionPort transactions() { + return new PolicyTransactionPort() { @Override public T inWrite(java.util.function.Supplier action) { return action.get(); @@ -71,6 +73,12 @@ public abstract class FileserverAssemblyFixture { public T inNew(java.util.function.Supplier action) { return action.get(); } + + @Override + public TransactionResult inTransaction( + TransactionRequest request, java.util.function.Supplier action) { + return new TransactionResult.Committed<>(action.get(), request.operationId()); + } }; } diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverPlatformAutoConfigurationTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverPlatformAutoConfigurationTest.java index 951f26a8..cd8cfadb 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverPlatformAutoConfigurationTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/fileserver/FileserverPlatformAutoConfigurationTest.java @@ -5,8 +5,8 @@ import static org.assertj.core.api.Assertions.assertThat; import dev.caskeleton.adapter.inbound.web.fileserver.config.BlockingTransferExecutor; import dev.caskeleton.adapter.inbound.web.fileserver.config.FileserverWebProperties; import dev.caskeleton.adapter.inbound.web.fileserver.config.MvcTransferExecutorConfiguration; +import dev.caskeleton.adapter.inbound.web.fileserver.http.HttpDownloadPolicy; import dev.caskeleton.adapter.inbound.web.fileserver.nginx.NginxDelegationProperties; -import dev.caskeleton.application.fileserver.download.DownloadPolicy; import dev.caskeleton.application.fileserver.observability.FileserverMetricsPort; import dev.caskeleton.application.fileserver.observability.SafeFileFingerprint; import dev.caskeleton.application.fileserver.upload.UploadPolicy; @@ -98,7 +98,7 @@ class FileserverPlatformAutoConfigurationTest { .withPropertyValues("app.fileserver-platform.download.max-range-bytes=4MB") .run( context -> - assertThat(context.getBean(DownloadPolicy.class).rangeBudget().maxTotalBytes()) + assertThat(context.getBean(HttpDownloadPolicy.class).rangePolicy().maxTotalBytes()) .isEqualTo(4L * 1024 * 1024)); } @@ -154,14 +154,14 @@ class FileserverPlatformAutoConfigurationTest { assertThat(context).hasSingleBean(FileserverPlatformSettings.class); assertThat(context).hasSingleBean(FileserverWebProperties.class); assertThat(context).hasSingleBean(UploadPolicy.class); - assertThat(context).hasSingleBean(DownloadPolicy.class); + assertThat(context).hasSingleBean(HttpDownloadPolicy.class); assertThat(context).hasSingleBean(BlockingTransferExecutor.class); assertThat(context).hasSingleBean(SafeFileFingerprint.class); - DownloadPolicy download = context.getBean(DownloadPolicy.class); + HttpDownloadPolicy download = context.getBean(HttpDownloadPolicy.class); assertThat(download.cacheControl()).isEqualTo("private, no-store"); assertThat(download.inlineAllowed()).isFalse(); - assertThat(download.rangeBudget().allowsMultipleRanges()).isFalse(); + assertThat(download.rangePolicy().allowsMultipleRanges()).isFalse(); assertThat(context.getBean(NginxDelegationProperties.class).enabled()).isFalse(); assertThat(context.getBean(FileserverWebProperties.class).maxBatchParts()) .isEqualTo(16); @@ -211,8 +211,8 @@ class FileserverPlatformAutoConfigurationTest { "app.fileserver-platform.nginx.enabled=true") .run( context -> { - assertThat(context.getBean(DownloadPolicy.class).inlineAllowed()).isTrue(); - assertThat(context.getBean(DownloadPolicy.class).rangeBudget().maxRanges()) + assertThat(context.getBean(HttpDownloadPolicy.class).inlineAllowed()).isTrue(); + assertThat(context.getBean(HttpDownloadPolicy.class).rangePolicy().maxRanges()) .isEqualTo(4); assertThat(context.getBean(UploadPolicy.class).maximumFileSize()) .isEqualTo(1024L * 1024); diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderCompositionTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderCompositionTest.java index 3832799a..d5669d45 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderCompositionTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderCompositionTest.java @@ -2,15 +2,14 @@ package dev.caskeleton.bootstrap.autoconfigure.idempotency; import static org.assertj.core.api.Assertions.assertThat; -import dev.caskeleton.application.idempotency.IdempotencyExecutor; import dev.caskeleton.application.idempotency.IdempotencyStorePort; import dev.caskeleton.application.idempotency.v2.IdempotencyExecutorV2; import dev.caskeleton.application.idempotency.v2.IdempotencyStorePortV2; +import java.time.Clock; import java.time.Duration; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; import org.springframework.boot.test.context.runner.ApplicationContextRunner; -import org.springframework.jdbc.core.JdbcOperations; /** * What each provider selection actually composes, counted. @@ -27,10 +26,10 @@ class IdempotencyProviderCompositionTest { private final ApplicationContextRunner runner = new ApplicationContextRunner() - .withUserConfiguration( - PostgreSqlIdempotencyProviderConfig.class, IdempotencyProviderSelectionConfig.class) - .withBean(JdbcOperations.class, () -> org.mockito.Mockito.mock(JdbcOperations.class)) - .withBean(IdempotencySettings.class, () -> new IdempotencySettings(null, null)); + .withConfiguration( + org.springframework.boot.autoconfigure.AutoConfigurations.of( + IdempotencyProviderSelectionConfig.class)) + .withBean(Clock.class, Clock::systemUTC); @Test @DisplayName("disabled composes no idempotency store at all") @@ -52,8 +51,6 @@ class IdempotencyProviderCompositionTest { .withPropertyValues("ca-skeleton.capabilities.idempotency.provider=jdbc") .withBean( IdempotencyStorePort.class, () -> org.mockito.Mockito.mock(IdempotencyStorePort.class)) - .withBean( - IdempotencyExecutor.class, () -> org.mockito.Mockito.mock(IdempotencyExecutor.class)) .run( context -> { assertThat(context).hasNotFailed(); @@ -85,6 +82,7 @@ class IdempotencyProviderCompositionTest { void postgresqlComposesExactlyOnePair() { runner .withPropertyValues("ca-skeleton.capabilities.idempotency.provider=postgresql") + .withBean(IdempotencyStorePortV2.class, RedisLikeStore::new) .run( context -> { assertThat(context) @@ -92,10 +90,7 @@ class IdempotencyProviderCompositionTest { .hasNotFailed(); assertThat(context.getBeansOfType(IdempotencyStorePortV2.class)).hasSize(1); assertThat(context.getBeansOfType(IdempotencyExecutorV2.class)).hasSize(1); - assertThat(context.getBean(IdempotencyStorePortV2.class)) - .isInstanceOf( - dev.caskeleton.adapter.outbound.persistence.postgresql.idempotency - .PostgreSqlOwnerSafeIdempotencyStore.class); + assertThat(context.getBeansOfType(IdempotencyExecutorV2.class)).hasSize(1); }); } diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderScanCollisionTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderScanCollisionTest.java index de75e828..d90396ba 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderScanCollisionTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderScanCollisionTest.java @@ -8,7 +8,6 @@ import dev.caskeleton.application.idempotency.v2.IdempotencyStorePortV2; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; import org.springframework.boot.test.context.runner.ApplicationContextRunner; -import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.ComponentScan; import org.springframework.context.annotation.Configuration; import org.springframework.jdbc.core.JdbcOperations; @@ -19,20 +18,21 @@ import org.springframework.jdbc.core.JdbcOperations; *

    Every other test of this guard hands it the beans it expects. That is precisely the shape of * test that cannot see the defect it is guarding against, because the question is not "does the * guard count correctly" but "what is in the context to count". {@code CaSkeletonApplication} scans - * {@code dev.caskeleton.adapter}, and {@code PostgreSqlOwnerSafeIdempotencyStore} is a - * {@code @Repository} implementing the owner-safe V2 contract — so it is registered in every - * deployment, whichever provider was selected, and no test in the repository booted a context that - * would notice. + * {@code dev.caskeleton.adapter}. Historically the PostgreSQL owner-safe store carried a repository + * stereotype, so it was registered in every deployment regardless of provider choice. The store is + * now stereotype-free and composed only by the JPA leaf under {@code provider=postgresql}; this + * test keeps the original scan-collision regression pinned. * - *

    Both selections are asserted, because the collision breaks both: {@code jdbc} acquires a V2 - * store it never asked for, and {@code redis} acquires a second one beside its own. + *

    Both JDBC and Redis selections are asserted so a future stereotype or scan-visible factory + * cannot silently reintroduce an owner-safe V2 store into a provider that did not select it. */ class IdempotencyProviderScanCollisionTest { private final ApplicationContextRunner runner = new ApplicationContextRunner() .withUserConfiguration(ScannedPersistence.class, IdempotencyProviderSelectionConfig.class) - .withBean(JdbcOperations.class, () -> org.mockito.Mockito.mock(JdbcOperations.class)); + .withBean(JdbcOperations.class, () -> org.mockito.Mockito.mock(JdbcOperations.class)) + .withBean(java.time.Clock.class, java.time.Clock::systemUTC); @Test @DisplayName("the default JDBC provider composes exactly its own V1 pair and no V2 store") @@ -41,13 +41,13 @@ class IdempotencyProviderScanCollisionTest { .withPropertyValues("ca-skeleton.capabilities.idempotency.provider=jdbc") .withBean( IdempotencyStorePort.class, () -> org.mockito.Mockito.mock(IdempotencyStorePort.class)) - .withBean( - IdempotencyExecutor.class, () -> org.mockito.Mockito.mock(IdempotencyExecutor.class)) .run( context -> { assertThat(context) .as("the default provider must not acquire an owner-safe V2 store by scan") .hasNotFailed(); + assertThat(context).hasSingleBean(IdempotencyStorePort.class); + assertThat(context).hasSingleBean(IdempotencyExecutor.class); assertThat(context.getBeansOfType(IdempotencyStorePortV2.class)).isEmpty(); }); } @@ -94,13 +94,7 @@ class IdempotencyProviderScanCollisionTest { /** Exactly what the composition root scans, narrowed to the package under test. */ @Configuration(proxyBeanMethods = false) @ComponentScan("dev.caskeleton.adapter.outbound.persistence.postgresql.idempotency") - static class ScannedPersistence { - - @Bean - IdempotencySettings idempotencySettings() { - return new IdempotencySettings(null, null); - } - } + static class ScannedPersistence {} /** Stands in for the Redis V2 store, whose own composition is covered elsewhere. */ private static final class RedisLikeStore implements IdempotencyStorePortV2 { diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderSettingsTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderSettingsTest.java new file mode 100644 index 00000000..413c2740 --- /dev/null +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyProviderSettingsTest.java @@ -0,0 +1,15 @@ +package dev.caskeleton.bootstrap.autoconfigure.idempotency; + +import static org.assertj.core.api.Assertions.assertThat; + +import org.junit.jupiter.api.Test; + +class IdempotencyProviderSettingsTest { + + @Test + void absentProviderDefaultsToDisabledLikeTheShippedConfiguration() { + IdempotencyProviderSettings settings = new IdempotencyProviderSettings(null); + + assertThat(settings.provider()).isEqualTo(IdempotencyProviderSettings.Provider.DISABLED); + } +} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyShippedAutoConfigurationTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyShippedAutoConfigurationTest.java new file mode 100644 index 00000000..5a34ea9f --- /dev/null +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/idempotency/IdempotencyShippedAutoConfigurationTest.java @@ -0,0 +1,48 @@ +package dev.caskeleton.bootstrap.autoconfigure.idempotency; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.application.idempotency.IdempotencyExecutor; +import dev.caskeleton.application.idempotency.IdempotencyStorePort; +import java.time.Clock; +import org.junit.jupiter.api.Test; +import org.springframework.boot.autoconfigure.AutoConfigurations; +import org.springframework.boot.test.context.runner.ApplicationContextRunner; +import org.springframework.scheduling.config.TaskManagementConfigUtils; + +class IdempotencyShippedAutoConfigurationTest { + + private final ApplicationContextRunner runner = + new ApplicationContextRunner() + .withConfiguration(AutoConfigurations.of(IdempotencyProviderSelectionConfig.class)); + + @Test + void disabledProviderDoesNotEnableSchedulingOrCreateAnExecutor() { + runner + .withPropertyValues("ca-skeleton.capabilities.idempotency.provider=disabled") + .run( + context -> { + assertThat(context).hasNotFailed(); + assertThat(context).doesNotHaveBean(IdempotencyExecutor.class); + assertThat(context) + .doesNotHaveBean( + TaskManagementConfigUtils.SCHEDULED_ANNOTATION_PROCESSOR_BEAN_NAME); + }); + } + + @Test + void jdbcProviderImportsItsExecutorAndEnablesScheduling() { + runner + .withPropertyValues("ca-skeleton.capabilities.idempotency.provider=jdbc") + .withBean( + IdempotencyStorePort.class, () -> org.mockito.Mockito.mock(IdempotencyStorePort.class)) + .withBean(Clock.class, Clock::systemUTC) + .run( + context -> { + assertThat(context).hasNotFailed(); + assertThat(context).hasSingleBean(IdempotencyExecutor.class); + assertThat(context) + .hasBean(TaskManagementConfigUtils.SCHEDULED_ANNOTATION_PROCESSOR_BEAN_NAME); + }); + } +} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/jpa/CapabilityEntityScanRegistrationTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/jpa/CapabilityEntityScanRegistrationTest.java index 15c3dbe2..7e561f9e 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/jpa/CapabilityEntityScanRegistrationTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/jpa/CapabilityEntityScanRegistrationTest.java @@ -2,52 +2,17 @@ package dev.caskeleton.bootstrap.autoconfigure.jpa; import static org.assertj.core.api.Assertions.assertThat; -import dev.caskeleton.adapter.outbound.persistence.fileserver.FileserverJpaPersistenceConfig; import dev.caskeleton.bootstrap.CaSkeletonApplication; -import java.util.List; import java.util.regex.Pattern; -import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; import org.springframework.context.annotation.ComponentScan; import org.springframework.context.annotation.FilterType; -import org.springframework.context.annotation.Import; -/** - * A capability's entity scan is registered here, because nothing else can register it. - * - *

    Two facts combine into a trap. The composition root's component scan excludes {@code - * dev.caskeleton.adapter.outbound.persistence..*} — deliberately, so an optional capability cannot - * assemble itself by being on the classpath. And the leaf's own {@code config} package may depend - * on {@code api} alone, so it cannot import a capability configuration either. - * - *

    So moving an entity scan out of the unconditional list is only half the change. The other half - * is an import from this class, and forgetting it produces a configuration that compiles, passes - * its own gating test, and is registered nowhere — the capability's entities then absent whether it - * is switched on or off. That is not hypothetical: it is the state {@code - * NotificationJpaPersistenceConfig} is in, recorded below rather than quietly tolerated. - */ +/** Application scan must not bypass capability-owned persistence auto-configuration. */ class CapabilityEntityScanRegistrationTest { @Test - @DisplayName("the fileserver entity scan is imported by the JPA composition root") - void theFileserverScanIsRegistered() { - List> imported = - List.of(PersistenceJpaRootAutoConfiguration.class.getAnnotation(Import.class).value()); - - assertThat(imported) - .as( - "its six entities map six fs_* tables that exist only in db/migration/jpa/fileserver; " - + "unscanned when the capability is on means the first upload fails, and scanned " - + "when it is off meant ddl-auto=validate failed the boot on fs_cleanup_item") - .contains(FileserverJpaPersistenceConfig.class); - } - - @Test - @DisplayName("the persistence package really is outside the component scan") - void thePersistencePackageIsExcludedFromTheComponentScan() { - // Read from the annotation rather than from the constant behind it: the annotation is what - // Spring acts on, and a test that agreed with a field the scanner never consulted would be - // checking the documentation. + void persistencePackageRemainsOutsideTheBroadComponentScan() { boolean excluded = java.util.Arrays.stream( CaSkeletonApplication.class.getAnnotation(ComponentScan.class).excludeFilters()) @@ -61,37 +26,7 @@ class CapabilityEntityScanRegistrationTest { assertThat(excluded) .as( - "if this ever stops excluding the package, the import above becomes redundant and the " - + "capability starts assembling from the classpath again — which is the condition " - + "the exclusion exists to prevent") + "persistence must be reached through the leaf auto-configuration, not broad classpath scan") .isTrue(); } - - @Test - @DisplayName("the notification facade is wired, over a payload that is protected at rest") - void theNotificationPersistenceFacadeIsWiredOverAProtectedPayload() { - boolean wired = - List.of(PersistenceJpaRootAutoConfiguration.class.getAnnotation(Import.class).value()) - .stream() - .anyMatch(imported -> imported.getName().contains(".persistence.notification")); - - assertThat(wired) - .as( - "wired only after the envelope. This assertion was false while the store wrote template " - + "variables in plaintext — the wave forbids connecting wiring over a known security " - + "finding on a runtime path, so the first attempt was reverted rather than the " - + "at-rest test relaxed. NotificationRecordMapper now takes the protection as a " - + "required argument, so the import is a wiring rather than an exposure.") - .isTrue(); - - assertThat( - dev.caskeleton.adapter.outbound.persistence.notification.configuration - .NotificationJpaPersistenceFacade.class - .getAnnotation(Import.class)) - .as( - "the entity scan travels with the stores it serves, so the facade cannot arrive without " - + "the mappings they need — the defect that left the capability with entity metadata " - + "nowhere, whether it was switched on or off") - .isNotNull(); - } } diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/jpa/DataSourceRequirementTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/jpa/DataSourceRequirementTest.java new file mode 100644 index 00000000..c9923998 --- /dev/null +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/jpa/DataSourceRequirementTest.java @@ -0,0 +1,28 @@ +package dev.caskeleton.bootstrap.autoconfigure.jpa; + +import static org.assertj.core.api.Assertions.assertThat; + +import org.junit.jupiter.api.Test; +import org.springframework.mock.env.MockEnvironment; + +class DataSourceRequirementTest { + + @Test + void canonicalMultiInstanceRuntimeSwitchRequiresADataSource() { + MockEnvironment environment = + new MockEnvironment().withProperty("ca-skeleton.runtime.multi-instance-enabled", "true"); + + assertThat(DataSourceRequirement.reasons(environment)) + .contains("ca-skeleton.runtime.multi-instance-enabled=true"); + } + + @Test + void postgresqlIdempotencyIsADataSourceConsumer() { + MockEnvironment environment = + new MockEnvironment() + .withProperty("ca-skeleton.capabilities.idempotency.provider", "postgresql"); + + assertThat(DataSourceRequirement.reasons(environment)) + .contains("ca-skeleton.capabilities.idempotency.provider=postgresql"); + } +} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformAutoConfigurationTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformAutoConfigurationTest.java index 355edb6d..56d3a321 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformAutoConfigurationTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformAutoConfigurationTest.java @@ -81,12 +81,26 @@ class JpaPlatformAutoConfigurationTest { assertThat(capabilities) .filteredOn(CapabilitySupport::usableByDefault) .extracting(CapabilitySupport::capability) - .contains( - JpaCapability.TRANSACTION_RETRY, - JpaCapability.COMPLETION_EVIDENCE, - JpaCapability.SCHEMA_GATE) + .contains(JpaCapability.TRANSACTION_RETRY, JpaCapability.SCHEMA_GATE) .doesNotContain( - JpaCapability.POSTGRESQL_COPY, JpaCapability.ENVERS, JpaCapability.L2_CACHE); + JpaCapability.COMPLETION_EVIDENCE, + JpaCapability.BATCH, + JpaCapability.OBSERVABILITY, + JpaCapability.POSTGRESQL_COPY, + JpaCapability.ENVERS, + JpaCapability.L2_CACHE); + } + + @Test + @DisplayName("unassembled evidence, batch, and observability primitives are Advanced") + void unassembledPlatformPrimitivesAreAdvanced() { + assertThat(configuration.capabilities()) + .filteredOn( + capability -> + capability.capability() == JpaCapability.COMPLETION_EVIDENCE + || capability.capability() == JpaCapability.BATCH + || capability.capability() == JpaCapability.OBSERVABILITY) + .allSatisfy(capability -> assertThat(capability.level()).isEqualTo(SupportLevel.ADVANCED)); } @Test diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformRuntimeAutoConfigurationTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformRuntimeAutoConfigurationTest.java index 1033b630..18f5ba39 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformRuntimeAutoConfigurationTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformRuntimeAutoConfigurationTest.java @@ -1,63 +1,35 @@ package dev.caskeleton.bootstrap.autoconfigure.jpa; import static org.assertj.core.api.Assertions.assertThat; -import static org.assertj.core.api.Assertions.assertThatThrownBy; -import dev.caskeleton.adapter.outbound.persistence.api.PersistenceOperationName; -import dev.caskeleton.adapter.outbound.persistence.api.error.FailureCategory; -import dev.caskeleton.adapter.outbound.persistence.api.error.JpaPersistenceException; -import dev.caskeleton.adapter.outbound.persistence.api.error.VendorFailureTranslator; -import dev.caskeleton.adapter.outbound.persistence.api.transaction.TransactionProfile; import dev.caskeleton.adapter.outbound.persistence.hibernate.HibernateProviderPolicy; -import dev.caskeleton.adapter.outbound.persistence.postgresql.constraint.PostgreSqlConstraintCatalog; -import dev.caskeleton.adapter.outbound.persistence.postgresql.error.PostgreSqlExceptionTranslator; import dev.caskeleton.adapter.outbound.persistence.security.PostgreSqlRuntimeRoleVerifier; -import dev.caskeleton.adapter.outbound.persistence.transaction.FullTransactionRetryCoordinator; -import dev.caskeleton.adapter.outbound.persistence.transaction.SpringJpaTransactionExecutor; -import java.sql.SQLException; +import java.lang.reflect.Proxy; +import java.sql.Connection; +import java.sql.DatabaseMetaData; import java.time.Clock; -import java.time.Duration; import javax.sql.DataSource; -import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; import org.springframework.boot.autoconfigure.AutoConfigurations; import org.springframework.boot.test.context.runner.ApplicationContextRunner; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; -import org.springframework.dao.TransientDataAccessResourceException; -import org.springframework.jdbc.datasource.SimpleDriverDataSource; -import org.springframework.transaction.PlatformTransactionManager; -import org.springframework.transaction.support.AbstractPlatformTransactionManager; -import org.springframework.transaction.support.DefaultTransactionStatus; +import org.springframework.jdbc.datasource.AbstractDataSource; -/** - * Whether the platform is in the bean graph, which is the only question that ever mattered. - * - *

    Three classes named {@code ...AutoConfiguration} were plain factories with no - * {@code @AutoConfiguration}, no {@code @Bean} and no {@code AutoConfiguration.imports} entry, - * while the composition root excluded their package from component scanning. The capability report - * listed transaction retry and completion evidence as Stable and a default context contained - * neither. The existing tests constructed the factories directly, so they passed against a graph - * that had none of this in it. - */ class JpaPlatformRuntimeAutoConfigurationTest { - private static final PersistenceOperationName OPERATION = - new PersistenceOperationName("order.write"); - - private static final TransactionProfile PROFILE = - TransactionProfile.write("order.write", Duration.ofSeconds(3)); - private final ApplicationContextRunner runner = new ApplicationContextRunner() .withConfiguration(AutoConfigurations.of(JpaPlatformRuntimeAutoConfiguration.class)) - .withBean(Clock.class, Clock::systemUTC); + .withBean(Clock.class, Clock::systemUTC) + .withBean(HibernateProviderPolicy.class, HibernateProviderPolicy::fromClasspath) + .withBean(PostgreSqlRuntimeRoleVerifier.class, PostgreSqlRuntimeRoleVerifier::new); @Test - @DisplayName("with a DataSource, the platform beans exist") - void withADataSourceThePlatformBeansExist() { + void applicationSafetyAndManagementBeansExistWhenAddonIsEnabled() { runner .withUserConfiguration(DataSourceConfiguration.class) + .withPropertyValues("spring.jpa.open-in-view=false") .run( context -> assertThat(context) @@ -65,50 +37,11 @@ class JpaPlatformRuntimeAutoConfigurationTest { .hasSingleBean(JpaDangerousConfigurationGuard.class) .hasSingleBean(JpaDataSourceProfileValidator.class) .hasSingleBean(JpaPlatformEndpoint.class) - .hasSingleBean(HibernateProviderPolicy.class) - .hasSingleBean(PostgreSqlRuntimeRoleVerifier.class)); + .hasSingleBean(JpaSafetySettings.class)); } - /** - * With the switch on and no datasource, the failure is loud. - * - *

    This case used to assert that nothing was built, and what made that true was a class-level - * {@code @ConditionalOnBean(DataSource.class)} — the annotation that made the whole layer vanish - * in the real application. It vanished there and not here because this runner registers the class - * through {@code AutoConfigurations.of(...)}, where {@code @ConditionalOnBean} is evaluated after - * the datasource definition exists, while {@code PersistenceJpaRootAutoConfiguration} imports it - * as a plain {@code @Configuration}, where it is evaluated during parsing and answers no. - * - *

    So the test passed against a registration shape the application does not use, and eight - * beans were absent from every deployment with nothing reporting it. The condition is gone; what - * remains true, and what should be true, is that asking for relational persistence without a - * datasource fails rather than quietly delivering less. - */ @Test - @DisplayName("without a DataSource the context fails rather than silently building less") - void withoutADataSourceTheContextFails() { - runner.run( - context -> - assertThat(context) - .as( - "the alternative is the state this repository was in: a JPA-on deployment with " - + "no platform report, no dangerous-configuration guard and no datasource " - + "validator, and no message saying so") - .hasFailed()); - } - - /** - * The add-on switch, which is all this one ever was. - * - *

    It used to be spelled {@code app.jpa-platform.enabled} and read like a whole-adapter switch, - * while gating three convenience beans and defaulting to on — so a deployment that set it to - * false still opened a pool, scanned entities and ran a migration. Whether this application has - * relational persistence at all is now decided by {@code PersistenceJpaRootAutoConfiguration}, - * and this name says what it actually controls. - */ - @Test - @DisplayName("the add-on switch turns the platform add-ons off") - void theAddOnSwitchTurnsTheAddOnsOff() { + void addonSwitchTurnsOnlyApplicationSafetyAndManagementOff() { runner .withUserConfiguration(DataSourceConfiguration.class) .withPropertyValues("app.jpa-platform.addons-enabled=false") @@ -116,167 +49,95 @@ class JpaPlatformRuntimeAutoConfigurationTest { context -> assertThat(context) .doesNotHaveBean(JpaPlatformAutoConfiguration.class) - .doesNotHaveBean(JpaDangerousConfigurationGuard.class)); + .doesNotHaveBean(JpaDangerousConfigurationGuard.class) + .doesNotHaveBean(JpaPlatformEndpoint.class)); } @Test - @DisplayName("the switch defaults to on, which is what the record already claimed") - void theSwitchDefaultsToOn() { + void safetySettingsDefaultToEnabled() { runner .withUserConfiguration(DataSourceConfiguration.class) + .withPropertyValues("spring.jpa.open-in-view=false") .run( context -> { assertThat(context).hasSingleBean(JpaSafetySettings.class); - assertThat(context.getBean(JpaSafetySettings.class).enabled()) - .as("a primitive boolean binds to false when absent; @DefaultValue fixes that") - .isTrue(); + assertThat(context.getBean(JpaSafetySettings.class).enabled()).isTrue(); }); } - @Test - @DisplayName("a transaction manager brings the executor and the retry coordinator") - void aTransactionManagerBringsTheRetryCoordinator() { - runner - .withUserConfiguration(DataSourceConfiguration.class, TransactionManagerConfiguration.class) - .run( - context -> - assertThat(context) - .hasSingleBean(SpringJpaTransactionExecutor.class) - .hasSingleBean(FullTransactionRetryCoordinator.class)); - } - - @Test - @DisplayName("without a transaction manager, retry backs off instead of failing the context") - void withoutATransactionManagerRetryBacksOff() { - runner - .withUserConfiguration(DataSourceConfiguration.class) - .run( - context -> { - assertThat(context).hasNotFailed(); - assertThat(context) - .as("an application with no transaction manager still gets the rest") - .doesNotHaveBean(FullTransactionRetryCoordinator.class); - }); - } - - /** - * The executor classifies with the vendor the composition actually installed. - * - *

    It used to be built with {@code PersistenceFailureTranslatorChain.withoutCatalogs()} — a - * chain whose vendor stage returns the failure unchanged — no matter which vendor was composed. A - * 40001 therefore stayed a raw {@code DataAccessException}, never became the {@code - * JpaPersistenceException} the retry coordinator catches, and serialization conflicts went - * unretried in every deployment that had a database. Nothing failed; the retry simply did not - * happen. - */ - @Test - @DisplayName("a composed vendor translator classifies what an attempt threw") - void aComposedVendorTranslatorClassifiesTheAttemptFailure() { - runner - .withUserConfiguration(DataSourceConfiguration.class, TransactionManagerConfiguration.class) - .withBean( - VendorFailureTranslator.class, - () -> PostgreSqlExceptionTranslator.with(PostgreSqlConstraintCatalog.empty())) - .run( - context -> { - SpringJpaTransactionExecutor executor = - context.getBean(SpringJpaTransactionExecutor.class); - - assertThatThrownBy( - () -> - executor.execute( - OPERATION, - PROFILE, - JpaPlatformRuntimeAutoConfigurationTest::throwSerializationConflict)) - .isInstanceOfSatisfying( - JpaPersistenceException.class, - classified -> { - assertThat(classified.category()) - .isEqualTo(FailureCategory.SERIALIZATION_FAILURE); - assertThat(classified.retryable()) - .as("an unretryable serialization failure is a retry that never runs") - .isTrue(); - }); - }); - } - - @Test - @DisplayName("with no vendor composed, the same failure is left exactly as it was thrown") - void withNoVendorComposedTheFailureIsLeftAlone() { - runner - .withUserConfiguration(DataSourceConfiguration.class, TransactionManagerConfiguration.class) - .run( - context -> { - SpringJpaTransactionExecutor executor = - context.getBean(SpringJpaTransactionExecutor.class); - - assertThatThrownBy( - () -> - executor.execute( - OPERATION, - PROFILE, - JpaPlatformRuntimeAutoConfigurationTest::throwSerializationConflict)) - .as("no vendor rows means no classification, rather than an invented one") - .isInstanceOf(TransientDataAccessResourceException.class); - }); - } - - /** Work that fails the way PostgreSQL fails a serializable transaction under contention. */ - private static Object throwSerializationConflict() { - throw new TransientDataAccessResourceException( - "could not serialize access", new SQLException("could not serialize access", "40001")); - } - - @Test - @DisplayName("an application's own beans win") - void anApplicationsOwnBeansWin() { - runner - .withUserConfiguration(DataSourceConfiguration.class) - .withBean(HibernateProviderPolicy.class, () -> new HibernateProviderPolicy("7.0.0-custom")) - .run( - context -> - assertThat(context.getBean(HibernateProviderPolicy.class).runtimeVersion()) - .as("@ConditionalOnMissingBean must actually back off") - .isEqualTo("7.0.0-custom")); - } - @Configuration(proxyBeanMethods = false) static class DataSourceConfiguration { - /** Never connected to: every assertion here is about the bean graph, not about a database. */ @Bean DataSource dataSource() { - return new SimpleDriverDataSource(); - } - } - - @Configuration(proxyBeanMethods = false) - static class TransactionManagerConfiguration { - - @Bean - PlatformTransactionManager transactionManager() { - return new AbstractPlatformTransactionManager() { + DatabaseMetaData metadata = + (DatabaseMetaData) + Proxy.newProxyInstance( + DatabaseMetaData.class.getClassLoader(), + new Class[] {DatabaseMetaData.class}, + (proxy, method, args) -> + switch (method.getName()) { + case "getDatabaseProductName" -> "PostgreSQL"; + case "getDatabaseMajorVersion" -> 18; + case "getDatabaseProductVersion" -> "18.0"; + case "getUserName" -> "app_runtime"; + default -> defaultValue(method.getReturnType()); + }); + Connection connection = + (Connection) + Proxy.newProxyInstance( + Connection.class.getClassLoader(), + new Class[] {Connection.class}, + (proxy, method, args) -> + switch (method.getName()) { + case "getMetaData" -> metadata; + case "close" -> null; + case "createStatement" -> + throw new java.sql.SQLException("fixture unavailable"); + default -> defaultValue(method.getReturnType()); + }); + return new AbstractDataSource() { @Override - protected Object doGetTransaction() { - return new Object(); + public Connection getConnection() { + return connection; } @Override - protected void doBegin( - Object transaction, org.springframework.transaction.TransactionDefinition definition) { - // Nothing to begin: this manager exists so the conditions can see one. - } - - @Override - protected void doCommit(DefaultTransactionStatus status) { - // No-op. - } - - @Override - protected void doRollback(DefaultTransactionStatus status) { - // No-op. + public Connection getConnection(String username, String password) { + return connection; } }; } + + private static Object defaultValue(Class type) { + if (!type.isPrimitive()) { + return null; + } + if (type == boolean.class) { + return false; + } + if (type == int.class) { + return 0; + } + if (type == long.class) { + return 0L; + } + if (type == double.class) { + return 0D; + } + if (type == float.class) { + return 0F; + } + if (type == short.class) { + return (short) 0; + } + if (type == byte.class) { + return (byte) 0; + } + if (type == char.class) { + return (char) 0; + } + return null; + } } } diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/jpa/PersistenceJpaRootAutoConfigurationOrderingTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/jpa/PersistenceJpaRootAutoConfigurationOrderingTest.java new file mode 100644 index 00000000..7e2e05c7 --- /dev/null +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/jpa/PersistenceJpaRootAutoConfigurationOrderingTest.java @@ -0,0 +1,23 @@ +package dev.caskeleton.bootstrap.autoconfigure.jpa; + +import static org.assertj.core.api.Assertions.assertThat; + +import java.util.Arrays; +import org.junit.jupiter.api.Test; +import org.springframework.boot.autoconfigure.AutoConfiguration; + +class PersistenceJpaRootAutoConfigurationOrderingTest { + + @Test + void bootstrapDoesNotOrderAgainstLeafInternalAutoConfigurationClasses() { + AutoConfiguration root = + PersistenceJpaRootAutoConfiguration.class.getAnnotation(AutoConfiguration.class); + + assertThat(Arrays.asList(root.after())).isEmpty(); + assertThat(root.afterName()) + .noneMatch( + name -> + name.startsWith( + "dev.caskeleton.adapter.outbound.persistence.autoconfigure.")); + } +} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/lock/DistributedLockConfigTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/lock/DistributedLockConfigTest.java new file mode 100644 index 00000000..5c49f3e4 --- /dev/null +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/lock/DistributedLockConfigTest.java @@ -0,0 +1,46 @@ +package dev.caskeleton.bootstrap.autoconfigure.lock; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.application.lock.DistributedLockPort; +import org.junit.jupiter.api.Test; +import org.springframework.boot.test.context.runner.ApplicationContextRunner; +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; + +class DistributedLockConfigTest { + + private final ApplicationContextRunner contextRunner = + new ApplicationContextRunner() + .withUserConfiguration(DistributedLockConfig.class, JdbcProviderFixture.class); + + @Test + void multiInstanceWrapsTheJdbcProviderAsThePrimaryDistributedProvider() { + contextRunner + .withPropertyValues("ca-skeleton.runtime.multi-instance-enabled=true") + .run( + context -> { + assertThat(context).hasBean("jdbcDistributedLock"); + assertThat(context).hasBean("distributedLockProvider"); + assertThat(context.getBean("distributedLockProvider")) + .isInstanceOf(MeteredDistributedLockPort.class); + assertThat(context.getBean(DistributedLockPort.class)) + .isSameAs(context.getBean("distributedLockProvider")); + }); + } + + @Test + void singleInstanceDoesNotCreateTheBootstrapDistributedProvider() { + contextRunner + .withPropertyValues("ca-skeleton.runtime.multi-instance-enabled=false") + .run(context -> assertThat(context).doesNotHaveBean("distributedLockProvider")); + } + + @Configuration(proxyBeanMethods = false) + static class JdbcProviderFixture { + @Bean("jdbcDistributedLock") + DistributedLockPort jdbcDistributedLock() { + return (key, waitTime, leaseTtl) -> () -> {}; + } + } +} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/mongo/MongoPlatformHealthContributorTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/mongo/MongoPlatformHealthContributorTest.java deleted file mode 100644 index ac3974ad..00000000 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/mongo/MongoPlatformHealthContributorTest.java +++ /dev/null @@ -1,29 +0,0 @@ -package dev.caskeleton.bootstrap.autoconfigure.mongo; - -import static org.assertj.core.api.Assertions.assertThat; - -import org.junit.jupiter.api.DisplayName; -import org.junit.jupiter.api.Test; -import org.springframework.boot.health.contributor.HealthIndicator; - -/** - * The Mongo health view is reachable through Actuator's SPI. - * - *

    Asserted as a type relationship rather than through a running endpoint, because the defect was - * a type relationship: {@code MongoPlatformHealthIndicator} computed every fact correctly, was - * named as though Actuator surfaced it, and implemented no contributor interface — so it was a - * health view nothing could read. Tests of its {@code ready()} and {@code details()} passed - * throughout. - */ -class MongoPlatformHealthContributorTest { - - @Test - @DisplayName("the contributor implements the interface Actuator actually looks for") - void theContributorIsAHealthIndicator() { - assertThat(HealthIndicator.class) - .as( - "a class that only computes health and implements no contributor SPI is invisible to " - + "the management surface, which is what this repository shipped") - .isAssignableFrom(MongoPlatformHealthContributor.class); - } -} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationAutoConfigurationTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationAutoConfigurationTest.java index f7d207d3..9097c2f3 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationAutoConfigurationTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationAutoConfigurationTest.java @@ -3,151 +3,14 @@ package dev.caskeleton.bootstrap.autoconfigure.notification; import static org.assertj.core.api.Assertions.assertThat; import dev.caskeleton.adapter.inbound.web.notification.platform.callback.NotificationCallbackMvcController; -import dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationPlatformAutoConfiguration; -import dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationPlatformSettings; -import dev.caskeleton.adapter.outbound.notification.platform.provider.http.NotificationHttpGateway; -import dev.caskeleton.adapter.outbound.notification.platform.security.AesGcmContactPointProtector; -import dev.caskeleton.application.notification.platform.admin.NotificationAdminService; -import dev.caskeleton.application.notification.platform.dispatch.MessageDigestPort; -import dev.caskeleton.application.notification.platform.security.ContactPointProtector; -import dev.caskeleton.application.notification.platform.security.SecretKeyMaterial; -import dev.caskeleton.application.notification.platform.security.SecretMaterialProvider; -import dev.caskeleton.application.notification.platform.security.SecretPurpose; -import dev.caskeleton.application.notification.platform.template.TemplateVariableValidator; -import java.util.Arrays; import org.junit.jupiter.api.Test; -import org.springframework.boot.autoconfigure.AutoConfigurations; -import org.springframework.boot.test.context.runner.ApplicationContextRunner; import org.springframework.boot.test.context.runner.ReactiveWebApplicationContextRunner; import org.springframework.boot.test.context.runner.WebApplicationContextRunner; -import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; -/** - * Startup guardrails of the platform's conditional wiring. - * - *

    The theme is that a misconfiguration must fail the boot, not the first delivery. A platform - * that starts happily and then refuses every notification at 02:00 is strictly worse than one that - * refuses to start at deploy time, when someone is watching. - */ +/** Cross-layer callback activation evidence kept at the application composition boundary. */ class NotificationAutoConfigurationTest { - private final ApplicationContextRunner runner = - new ApplicationContextRunner() - .withConfiguration(AutoConfigurations.of(NotificationPlatformAutoConfiguration.class)); - - @Test - void thePlatformContributesNothingUntilItIsExplicitlyEnabled() { - runner.run( - context -> { - assertThat(context).hasNotFailed(); - assertThat(context).doesNotHaveBean(MessageDigestPort.class); - assertThat(context).doesNotHaveBean(TemplateVariableValidator.class); - assertThat(context).doesNotHaveBean(NotificationHttpGateway.class); - }); - } - - @Test - void enablingThePlatformContributesItsDefaultRuntimeBeans() { - enabled() - .run( - context -> { - assertThat(context).hasSingleBean(MessageDigestPort.class); - assertThat(context).hasSingleBean(TemplateVariableValidator.class); - assertThat(context).hasSingleBean(NotificationHttpGateway.class); - }); - } - - @Test - void contactPointProtectionIsUnconditionalAndFailsLoudlyWithoutKeyMaterial() { - // Was "appears only once key material exists", asserted by loading this configuration with no - // secret provider and expecting the bean to be absent. The mechanism behind that — - // @ConditionalOnBean - // on a plain @Configuration an auto-configuration imports — is evaluated during parsing and - // answers - // according to what happens to be registered at that instant. Here it answered "absent" and the - // test passed; in the application it also answered "absent", the bean vanished, and startup - // failed - // on an unsatisfied dependency several layers away. - // - // The property that replaces it is stronger and true in both places: the protector exists - // whenever - // the platform does, and a composition without key material fails at startup naming what is - // missing. - enabled() - .run( - context -> { - assertThat(context).hasSingleBean(ContactPointProtector.class); - assertThat(context.getBean(ContactPointProtector.class)) - .isInstanceOf(AesGcmContactPointProtector.class); - }); - - runner - .withPropertyValues("ca-skeleton.notification.platform.enabled=true") - .run( - context -> - assertThat(context) - .as( - "without a secret provider the platform must refuse to start rather than " - + "quietly omit the component that encrypts contact points") - .hasFailed()); - } - - @Test - void adminOperationsAreAbsentByDefaultRatherThanPresentAndUnguarded() { - enabled().run(context -> assertThat(context).doesNotHaveBean(NotificationAdminService.class)); - } - - @Test - void aWebPushProfileWithoutAVapidKeyFailsStartup() { - enabled() - .withPropertyValues( - "ca-skeleton.notification.platform.providers.webpush.type=WEB_PUSH", - "ca-skeleton.notification.platform.providers.webpush.enabled=true", - "ca-skeleton.notification.platform.providers.webpush.environment=PRODUCTION", - "ca-skeleton.notification.platform.providers.webpush.credential-profile=default", - "ca-skeleton.notification.platform.providers.webpush.timeout=5s", - "ca-skeleton.notification.platform.providers.webpush.max-concurrency=4", - "ca-skeleton.notification.platform.providers.webpush.rate-per-second=10") - .run( - context -> - // The validation failure is wrapped by the binder, so assert on the whole chain. - assertThat(context).getFailure().hasStackTraceContaining("VAPID")); - } - - @Test - void ambiguousFallbackCannotBeTurnedOnByConfiguration() { - enabled() - .withPropertyValues( - "ca-skeleton.notification.platform.dispatch.allow-ambiguous-fallback=true", - "ca-skeleton.notification.platform.dispatch.claim-batch-size=100", - "ca-skeleton.notification.platform.dispatch.lease-duration=30s", - "ca-skeleton.notification.platform.dispatch.poll-interval=250ms", - "ca-skeleton.notification.platform.dispatch.max-global-concurrency=8", - "ca-skeleton.notification.platform.dispatch.max-additional-attempts=3", - "ca-skeleton.notification.platform.dispatch.max-queue-age=1h") - .run( - context -> - assertThat(context) - .getFailure() - .hasStackTraceContaining("allow-ambiguous-fallback")); - } - - @Test - void anUnboundedClaimBatchIsRefusedAtStartup() { - enabled() - .withPropertyValues( - "ca-skeleton.notification.platform.dispatch.claim-batch-size=100000", - "ca-skeleton.notification.platform.dispatch.lease-duration=30s", - "ca-skeleton.notification.platform.dispatch.poll-interval=250ms", - "ca-skeleton.notification.platform.dispatch.max-global-concurrency=8", - "ca-skeleton.notification.platform.dispatch.max-additional-attempts=3", - "ca-skeleton.notification.platform.dispatch.max-queue-age=1h") - .run( - context -> - assertThat(context).getFailure().hasStackTraceContaining("claim-batch-size")); - } - @Test void theServletCallbackControllerIsAbsentWhileCallbacksAreDisabled() { new WebApplicationContextRunner() @@ -159,8 +22,6 @@ class NotificationAutoConfigurationTest { @Test void theServletControllerNeverRegistersInAReactiveApplication() { - // Annotated controllers are honoured by WebFlux too, so without the servlet condition a - // reactive deployment would map both transports onto the same callback path. new ReactiveWebApplicationContextRunner() .withUserConfiguration(MvcCallbackConfiguration.class) .withPropertyValues("ca-skeleton.notification.platform.callbacks.enabled=true") @@ -169,58 +30,7 @@ class NotificationAutoConfigurationTest { assertThat(context).doesNotHaveBean(NotificationCallbackMvcController.class)); } - /** - * The platform, enabled, with the key material the real composition always supplies. - * - *

    {@code SecretsConfiguration} is here rather than added per test because leaving it out - * models a deployment that cannot exist: {@code NotificationRootAutoConfiguration} imports the - * platform configuration and {@code NotificationPlatformSecretsConfig} together, under one master - * switch, so key material is present exactly when this configuration is. A runner without it was - * testing an assembly the application never performs — and it was the reason the contact point - * protector carried an unreliable {@code @ConditionalOnBean}, which resolved to "absent" in the - * running application and took the bean with it. - */ - private ApplicationContextRunner enabled() { - return runner - .withPropertyValues("ca-skeleton.notification.platform.enabled=true") - .withUserConfiguration(SecretsConfiguration.class); - } - - /** Registers the servlet controller as a candidate so its conditions are actually evaluated. */ @Configuration(proxyBeanMethods = false) @org.springframework.context.annotation.Import(NotificationCallbackMvcController.class) static class MvcCallbackConfiguration {} - - /** Deterministic key material so the protector has something to bind to. */ - @Configuration(proxyBeanMethods = false) - static class SecretsConfiguration { - - @Bean - SecretMaterialProvider secrets() { - return new SecretMaterialProvider() { - - @Override - public SecretKeyMaterial activeKey(SecretPurpose purpose) { - return key(purpose); - } - - @Override - public SecretKeyMaterial keyById(String keyId) { - return key(SecretPurpose.CONTACT_ENCRYPTION); - } - - private SecretKeyMaterial key(SecretPurpose purpose) { - byte[] material = new byte[32]; - Arrays.fill(material, (byte) 0x2A); - return new SecretKeyMaterial( - purpose.name().toLowerCase(java.util.Locale.ROOT), purpose, material); - } - }; - } - } - - /** Referenced so the settings type is loaded by this test's compilation unit. */ - static Class settingsType() { - return NotificationPlatformSettings.class; - } } diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformReachabilityTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformReachabilityTest.java deleted file mode 100644 index 085df98a..00000000 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/NotificationPlatformReachabilityTest.java +++ /dev/null @@ -1,89 +0,0 @@ -package dev.caskeleton.bootstrap.autoconfigure.notification; - -import static org.assertj.core.api.Assertions.assertThat; - -import dev.caskeleton.adapter.outbound.notification.platform.autoconfigure.NotificationPlatformAutoConfiguration; -import org.junit.jupiter.api.DisplayName; -import org.junit.jupiter.api.Test; -import org.springframework.boot.autoconfigure.AutoConfiguration; -import org.springframework.context.annotation.Configuration; -import org.springframework.context.annotation.Import; -import org.springframework.core.annotation.AnnotatedElementUtils; - -/** - * Every configuration class the notification capability owns is reachable from something that - * registers it (NTF-INT-006). - * - *

    This exists because one of them was not, and nothing said so. {@code - * NotificationPlatformAutoConfiguration} is named like an auto-configuration but annotated - * {@code @Configuration}, so Spring never registers it on its own, and the notification leaf ships - * no {@code META-INF/spring/...AutoConfiguration.imports}. It was imported by no root and scanned - * by no package. The six beans it declares — the variables codec, the message digest, the template - * engine and its variable validator, the contact point protector, the HTTP gateway — therefore - * existed in no running application. - * - *

    Its own test passed throughout, because that test builds an {@code ApplicationContextRunner} - * with {@code AutoConfigurations.of(NotificationPlatformAutoConfiguration.class)} — it supplies the - * registration the runtime was missing, and then verifies the beans it just caused to exist. That - * is the failure this file is aimed at: a green unit test over a class the composition root does - * not reach says nothing about the deployment. - * - *

    The local-notification-ingest Compose lane is what surfaced it, at the first moment the JPA - * persistence facade was assembled for real: {@code NotificationRecordMapper} required {@code - * NotificationVariablesCodecPort} and the application refused to start. - * - *

    So the assertion is about the composition, not about beans: the root must name it. A test that - * instead started a context and looked for the codec could be satisfied by any other definition of - * that bean appearing anywhere, which is the same mistake one level up. - */ -class NotificationPlatformReachabilityTest { - - @Test - @DisplayName("the registered root imports the platform configuration") - void theRegisteredRootImportsThePlatformConfiguration() { - Import imports = NotificationRootAutoConfiguration.class.getAnnotation(Import.class); - - assertThat(imports) - .as("NotificationRootAutoConfiguration is the entry in AutoConfiguration.imports") - .isNotNull(); - assertThat(imports.value()) - .as( - "NotificationPlatformAutoConfiguration is a plain @Configuration in an adapter leaf with " - + "no imports file of its own, so an import from the registered root is the only " - + "thing that can put it in a running application") - .contains(NotificationPlatformAutoConfiguration.class); - } - - @Test - @DisplayName("it is a plain @Configuration, which is why the import is required") - void itIsAPlainConfiguration() { - assertThat(NotificationPlatformAutoConfiguration.class.getAnnotation(Configuration.class)) - .as( - "if this becomes a real @AutoConfiguration with an imports entry, the import above is " - + "double registration and this test should change with it") - .isNotNull(); - } - - @Test - @DisplayName("the root's imports are unique, so nothing is registered twice") - void theRootsImportsAreUnique() { - Class[] imported = - NotificationRootAutoConfiguration.class.getAnnotation(Import.class).value(); - - assertThat(imported) - .as("a duplicate import is how a bean gets two definitions and the later one wins silently") - .doesNotHaveDuplicates(); - assertThat(imported) - .as("every import must actually be a configuration class, not a marker or a bean type") - .allSatisfy( - candidate -> - assertThat( - AnnotatedElementUtils.hasAnnotation(candidate, Configuration.class) - || AnnotatedElementUtils.hasAnnotation( - candidate, AutoConfiguration.class)) - .as( - "%s carries neither @Configuration nor @AutoConfiguration", - candidate.getName()) - .isTrue()); - } -} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/ProviderCallbackIngressBridgeTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/ProviderCallbackIngressBridgeTest.java new file mode 100644 index 00000000..59166f8a --- /dev/null +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/notification/ProviderCallbackIngressBridgeTest.java @@ -0,0 +1,276 @@ +package dev.caskeleton.bootstrap.autoconfigure.notification; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +import dev.caskeleton.adapter.inbound.web.notification.platform.callback.ProviderCallbackHttpRequest; +import dev.caskeleton.adapter.outbound.notification.platform.callback.CallbackLimits; +import dev.caskeleton.adapter.outbound.notification.platform.callback.CallbackVerificationResult; +import dev.caskeleton.adapter.outbound.notification.platform.callback.MapProviderCallbackAdapterRegistry; +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackAdapter; +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackAdapterRegistry; +import dev.caskeleton.adapter.outbound.notification.platform.callback.ProviderCallbackVerificationRequest; +import dev.caskeleton.adapter.outbound.notification.platform.callback.VerifiedCallback; +import dev.caskeleton.adapter.outbound.notification.platform.provider.ses.SesCallbackAdapter; +import dev.caskeleton.adapter.outbound.notification.platform.provider.ses.SesEventNormalizer; +import dev.caskeleton.adapter.outbound.notification.platform.provider.ses.SnsSignatureVerifier; +import dev.caskeleton.adapter.outbound.notification.platform.template.NotificationJsonMapper; +import dev.caskeleton.application.notification.platform.api.CallbackIngestionResult; +import dev.caskeleton.application.notification.platform.api.NormalizedEventType; +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; +import dev.caskeleton.application.notification.platform.api.ProviderId; +import dev.caskeleton.application.notification.platform.api.ProviderProfileId; +import dev.caskeleton.application.notification.platform.api.error.CallbackValidationException; +import dev.caskeleton.application.notification.platform.observation.NotificationSecurityAuditPort; +import dev.caskeleton.application.notification.platform.port.in.IngestProviderCallbackCommand; +import dev.caskeleton.application.notification.platform.port.in.IngestProviderCallbackUseCase; +import java.nio.charset.StandardCharsets; +import java.security.KeyPairGenerator; +import java.security.Signature; +import java.time.Instant; +import java.util.Base64; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.Optional; +import java.util.Set; +import org.junit.jupiter.api.Test; + +class ProviderCallbackIngressBridgeTest { + + private static final ProviderId TWILIO = new ProviderId("twilio"); + private static final ProviderProfileId PROFILE = new ProviderProfileId("twilio-primary"); + private static final Instant RECEIVED_AT = Instant.parse("2026-09-19T00:00:00Z"); + + @Test + void providerMismatchIsRejectedBeforeSignatureVerification() { + RecordingAdapter adapter = new RecordingAdapter(new ProviderId("ses"), true); + RecordingAudit audit = new RecordingAudit(); + RecordingIngestion ingestion = new RecordingIngestion(); + ProviderCallbackIngressBridge bridge = bridge(adapter, ingestion, audit, 1024); + + assertThatThrownBy(() -> bridge.ingest(request("application/json", "{}"))) + .isInstanceOf(CallbackValidationException.class); + + assertThat(adapter.verifications).isZero(); + assertThat(audit.limitReasons).containsExactly("PROVIDER_PROFILE_MISMATCH"); + assertThat(ingestion.callbacks).isEmpty(); + } + + @Test + void invalidSignatureIsAuditedAndNeverReachesApplication() { + RecordingAdapter adapter = new RecordingAdapter(TWILIO, false); + RecordingAudit audit = new RecordingAudit(); + RecordingIngestion ingestion = new RecordingIngestion(); + ProviderCallbackIngressBridge bridge = bridge(adapter, ingestion, audit, 1024); + + assertThatThrownBy(() -> bridge.ingest(request("application/json", "{}"))) + .isInstanceOf(CallbackValidationException.class); + + assertThat(adapter.verifications).isEqualTo(1); + assertThat(audit.signatureReasons).containsExactly("SIGNATURE_MISMATCH"); + assertThat(ingestion.callbacks).isEmpty(); + } + + @Test + void validCallbackCrossesTheApplicationBoundaryAsVerifiedSemanticData() { + RecordingAdapter adapter = new RecordingAdapter(TWILIO, true); + RecordingAudit audit = new RecordingAudit(); + RecordingIngestion ingestion = new RecordingIngestion(); + ProviderCallbackIngressBridge bridge = bridge(adapter, ingestion, audit, 1024); + byte[] raw = "MessageStatus=delivered".getBytes(StandardCharsets.UTF_8); + + CallbackIngestionResult result = + bridge.ingest( + new ProviderCallbackHttpRequest( + TWILIO, + PROFILE, + "https://callback.example/internal/notification/callbacks/twilio/twilio-primary", + "POST", + Optional.of("application/x-www-form-urlencoded"), + Map.of("x-twilio-signature", List.of("signed")), + raw, + RECEIVED_AT)); + + assertThat(result).isEqualTo(new CallbackIngestionResult(1, 0)); + assertThat(ingestion.callbacks).hasSize(1); + IngestProviderCallbackCommand callback = ingestion.callbacks.getFirst(); + assertThat(callback.providerId()).isEqualTo(TWILIO); + assertThat(callback.providerProfileId()).isEqualTo(PROFILE); + assertThat(callback.events()).hasSize(1); + assertThat(callback.rawPayload()).isEqualTo(raw); + assertThat(audit.limitReasons).isEmpty(); + assertThat(audit.signatureReasons).isEmpty(); + } + + @Test + void validSesCallbackCrossesTheShippedBridgeThroughTheRealVerifier() throws Exception { + var keyPair = KeyPairGenerator.getInstance("RSA").generateKeyPair(); + SnsSignatureVerifier verifier = + new SnsSignatureVerifier(certificateUrl -> keyPair.getPublic(), "amazonaws.com"); + SesCallbackAdapter adapter = new SesCallbackAdapter(verifier, new SesEventNormalizer()); + ProviderProfileId profile = new ProviderProfileId("ses-events"); + ProviderId provider = new ProviderId("ses"); + + Map envelope = new LinkedHashMap<>(); + envelope.put("Type", "Notification"); + envelope.put("MessageId", "sns-message-1"); + envelope.put("TopicArn", "arn:aws:sns:us-east-1:123456789012:notifications"); + envelope.put("Timestamp", RECEIVED_AT.toString()); + envelope.put( + "Message", + "{\"eventType\":\"Delivery\",\"mail\":{\"messageId\":\"ses-request-1\"}," + + "\"delivery\":{\"timestamp\":\"" + + RECEIVED_AT + + "\"}}"); + envelope.put( + "SigningCertURL", "https://sns.us-east-1.amazonaws.com/SimpleNotificationService-test.pem"); + envelope.put("SignatureVersion", "2"); + + Signature signer = Signature.getInstance("SHA256withRSA"); + signer.initSign(keyPair.getPrivate()); + signer.update(SnsSignatureVerifier.canonicalString(envelope).getBytes(StandardCharsets.UTF_8)); + envelope.put("Signature", Base64.getEncoder().encodeToString(signer.sign())); + + byte[] raw = NotificationJsonMapper.mapper().writeValueAsBytes(envelope); + ProviderCallbackAdapterRegistry registry = + new MapProviderCallbackAdapterRegistry( + Map.of(profile, adapter), new CallbackLimits(4_096, Set.of("application/json"))); + RecordingAudit audit = new RecordingAudit(); + RecordingIngestion ingestion = new RecordingIngestion(); + ProviderCallbackIngressBridge bridge = + new ProviderCallbackIngressBridge(registry, ingestion, audit); + + CallbackIngestionResult result = + bridge.ingest( + new ProviderCallbackHttpRequest( + provider, + profile, + "https://callback.example/internal/notification/callbacks/ses/ses-events", + "POST", + Optional.of("application/json"), + Map.of(), + raw, + RECEIVED_AT)); + + assertThat(result).isEqualTo(new CallbackIngestionResult(1, 0)); + assertThat(ingestion.callbacks).hasSize(1); + assertThat(ingestion.callbacks.getFirst().providerId()).isEqualTo(provider); + assertThat(ingestion.callbacks.getFirst().events()) + .extracting(NormalizedProviderEvent::type) + .containsExactly(NormalizedEventType.DELIVERY_CONFIRMED); + assertThat(audit.signatureReasons).isEmpty(); + assertThat(audit.limitReasons).isEmpty(); + } + + @Test + void rawHttpLimitsAreEnforcedBeforeTheProviderAdapterRuns() { + RecordingAdapter adapter = new RecordingAdapter(TWILIO, true); + RecordingAudit audit = new RecordingAudit(); + RecordingIngestion ingestion = new RecordingIngestion(); + ProviderCallbackIngressBridge bridge = bridge(adapter, ingestion, audit, 4); + + assertThatThrownBy(() -> bridge.ingest(request("application/json", "12345"))) + .isInstanceOf(CallbackValidationException.class); + + assertThat(adapter.verifications).isZero(); + assertThat(audit.limitReasons).containsExactly("BODY_TOO_LARGE"); + } + + private static ProviderCallbackIngressBridge bridge( + RecordingAdapter adapter, + RecordingIngestion ingestion, + RecordingAudit audit, + long maxBodyBytes) { + ProviderCallbackAdapterRegistry registry = + new ProviderCallbackAdapterRegistry() { + @Override + public ProviderCallbackAdapter require(ProviderProfileId profileId) { + return adapter; + } + + @Override + public CallbackLimits limitsFor(ProviderProfileId profileId) { + return new CallbackLimits( + maxBodyBytes, Set.of("application/json", "application/x-www-form-urlencoded")); + } + }; + return new ProviderCallbackIngressBridge(registry, ingestion, audit); + } + + private static ProviderCallbackHttpRequest request(String contentType, String body) { + return new ProviderCallbackHttpRequest( + TWILIO, + PROFILE, + "https://callback.example/internal/notification/callbacks/twilio/twilio-primary", + "POST", + Optional.of(contentType), + Map.of(), + body.getBytes(StandardCharsets.UTF_8), + RECEIVED_AT); + } + + private static final class RecordingAdapter implements ProviderCallbackAdapter { + + private final ProviderId providerId; + private final boolean valid; + private int verifications; + + private RecordingAdapter(ProviderId providerId, boolean valid) { + this.providerId = providerId; + this.valid = valid; + } + + @Override + public ProviderId providerId() { + return providerId; + } + + @Override + public CallbackVerificationResult verify(ProviderCallbackVerificationRequest request) { + verifications++; + return valid + ? CallbackVerificationResult.valid(new VerifiedCallback(request, Map.of())) + : CallbackVerificationResult.invalid("SIGNATURE_MISMATCH"); + } + + @Override + public List normalize(VerifiedCallback callback) { + return List.of( + new NormalizedProviderEvent( + NormalizedEventType.DELIVERY_CONFIRMED, + "delivered", + Optional.of("event-1"), + Optional.of("request-1"), + Optional.of(RECEIVED_AT), + Map.of())); + } + } + + private static final class RecordingIngestion implements IngestProviderCallbackUseCase { + + private final List callbacks = new java.util.ArrayList<>(); + + @Override + public CallbackIngestionResult handle(IngestProviderCallbackCommand command) { + callbacks.add(command); + return new CallbackIngestionResult(1, 0); + } + } + + private static final class RecordingAudit implements NotificationSecurityAuditPort { + + private final List signatureReasons = new java.util.ArrayList<>(); + private final List limitReasons = new java.util.ArrayList<>(); + + @Override + public void callbackSignatureRejected(ProviderProfileId profileId, String reasonCode) { + signatureReasons.add(reasonCode); + } + + @Override + public void callbackRejectedByLimit(ProviderProfileId profileId, String reasonCode) { + limitReasons.add(reasonCode); + } + } +} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxCanonicalTransportCompositionTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxCanonicalTransportCompositionTest.java index 4dd9d409..35f38718 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxCanonicalTransportCompositionTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxCanonicalTransportCompositionTest.java @@ -3,6 +3,7 @@ package dev.caskeleton.bootstrap.autoconfigure.outbox; import static org.assertj.core.api.Assertions.assertThat; import static org.mockito.Mockito.mock; +import dev.caskeleton.application.messaging.event.IntegrationEventEncoderPort; import dev.caskeleton.application.messaging.event.IntegrationEventPublishPort; import dev.caskeleton.application.outbox.OutboxPublishOutcome; import dev.caskeleton.application.outbox.OutboxStorePort; @@ -42,16 +43,33 @@ class OutboxCanonicalTransportCompositionTest { } @Test - void canonicalTransportOnWithPublisherStartsWithoutCreatingAnotherScheduler() { + void canonicalTransportOnWithPublisherButWithoutEncoderFailsClosed() { runner .withPropertyValues("ca-skeleton.outbox.canonical-transport-enabled=true") .withBean( IntegrationEventPublishPort.class, () -> event -> CompletableFuture.completedFuture(OutboxPublishOutcome.CONFIRMED)) + .run( + context -> { + assertThat(context).hasFailed(); + assertThat(context.getStartupFailure()) + .hasMessageContaining("IntegrationEventEncoderPort"); + }); + } + + @Test + void canonicalTransportOnWithPublisherAndEncoderStartsWithoutCreatingAnotherScheduler() { + runner + .withPropertyValues("ca-skeleton.outbox.canonical-transport-enabled=true") + .withBean( + IntegrationEventPublishPort.class, + () -> event -> CompletableFuture.completedFuture(OutboxPublishOutcome.CONFIRMED)) + .withBean(IntegrationEventEncoderPort.class, () -> draft -> null) .run( context -> { assertThat(context).hasNotFailed(); assertThat(context).hasSingleBean(IntegrationEventPublishPort.class); + assertThat(context).hasSingleBean(IntegrationEventEncoderPort.class); assertThat(context).doesNotHaveBean(OutboxRelayScheduler.class); }); } diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxCanonicalTransportRequirementValidatorTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxCanonicalTransportRequirementValidatorTest.java index 08d84805..622c4b8a 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxCanonicalTransportRequirementValidatorTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/outbox/OutboxCanonicalTransportRequirementValidatorTest.java @@ -3,6 +3,7 @@ package dev.caskeleton.bootstrap.autoconfigure.outbox; import static org.assertj.core.api.Assertions.assertThatCode; import static org.assertj.core.api.Assertions.assertThatThrownBy; +import dev.caskeleton.application.messaging.event.IntegrationEventEncoderPort; import dev.caskeleton.application.messaging.event.IntegrationEventPublishPort; import dev.caskeleton.application.outbox.OutboxPublishOutcome; import java.util.concurrent.CompletableFuture; @@ -15,7 +16,7 @@ class OutboxCanonicalTransportRequirementValidatorTest { OutboxSettings settings = new OutboxSettings(true, true, null, null, null, null, null); assertThatThrownBy( - () -> new OutboxCanonicalTransportRequirementValidator(settings, null).validate()) + () -> new OutboxCanonicalTransportRequirementValidator(settings, null, null).validate()) .isInstanceOf(IllegalStateException.class) .hasMessageContaining("canonical-transport-enabled") .hasMessageContaining("IntegrationEventPublishPort"); @@ -26,10 +27,24 @@ class OutboxCanonicalTransportRequirementValidatorTest { OutboxSettings settings = new OutboxSettings(true, false, null, null, null, null, null); assertThatCode( - () -> new OutboxCanonicalTransportRequirementValidator(settings, null).validate()) + () -> new OutboxCanonicalTransportRequirementValidator(settings, null, null).validate()) .doesNotThrowAnyException(); } + @Test + void enabledCanonicalTransportWithPublisherButWithoutEncoderFailsStartup() { + OutboxSettings settings = new OutboxSettings(true, true, null, null, null, null, null); + IntegrationEventPublishPort publisher = + event -> CompletableFuture.completedFuture(OutboxPublishOutcome.CONFIRMED); + + assertThatThrownBy( + () -> + new OutboxCanonicalTransportRequirementValidator(settings, publisher, null) + .validate()) + .isInstanceOf(IllegalStateException.class) + .hasMessageContaining("IntegrationEventEncoderPort"); + } + @Test void enabledCanonicalTransportWithPublisherStarts() { OutboxSettings settings = new OutboxSettings(true, true, null, null, null, null, null); @@ -37,7 +52,7 @@ class OutboxCanonicalTransportRequirementValidatorTest { event -> CompletableFuture.completedFuture(OutboxPublishOutcome.CONFIRMED); assertThatCode( - () -> new OutboxCanonicalTransportRequirementValidator(settings, publisher).validate()) + () -> new OutboxCanonicalTransportRequirementValidator(settings, publisher, draft -> null).validate()) .doesNotThrowAnyException(); } } diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisActivationValidatorTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisActivationValidatorTest.java index f3699174..5c7c1d96 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisActivationValidatorTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisActivationValidatorTest.java @@ -130,6 +130,25 @@ class RedisActivationValidatorTest { .run(context -> assertThat(context).hasNotFailed()); } + @Test + @DisplayName("Redis idempotency refuses a key-version rotation until dual-read exists") + void idempotencyKeyVersionRotationFailsClosed() { + runner + .withPropertyValues( + "app.redis.enabled=true", + "ca-skeleton.capabilities.idempotency.provider=redis", + "ca-skeleton.capabilities.idempotency.key-version=2") + .run( + context -> { + assertThat(context).hasFailed(); + assertThat(context.getStartupFailure()) + .isInstanceOf(RequiredAdapterDisabledException.class) + .hasStackTraceContaining( + "ca-skeleton.capabilities.idempotency.key-version=2") + .hasStackTraceContaining("unsupported without dual-read"); + }); + } + @Configuration static class ValidatorConfig { @Bean diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisCapabilityCompositionTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisCapabilityCompositionTest.java index 7a555ef2..e0dee699 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisCapabilityCompositionTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisCapabilityCompositionTest.java @@ -1,15 +1,17 @@ package dev.caskeleton.bootstrap.autoconfigure.redis; import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.Mockito.mock; import dev.caskeleton.adapter.outbound.cache.redis.sdk.config.RedisSdkAutoConfiguration; import dev.caskeleton.adapter.outbound.cache.redis.sdk.lettuce.connection.RedisRuntimeOwner; import dev.caskeleton.application.cache.CacheRegionPort; import dev.caskeleton.application.idempotency.v2.IdempotencyStorePortV2; import dev.caskeleton.application.lease.DistributedLeasePort; -import dev.caskeleton.bootstrap.runtime.SecretSource; +import dev.caskeleton.application.outbound.SecretSourcePort; import dev.caskeleton.shared.ratelimit.EdgeRateLimitPort; import java.time.Clock; +import java.time.Duration; import java.util.Optional; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; @@ -35,6 +37,15 @@ class RedisCapabilityCompositionTest { private final ApplicationContextRunner runner = new ApplicationContextRunner() .withConfiguration(AutoConfigurations.of(RedisSdkAutoConfiguration.class)) + .withBean( + "compositionOnlyRedisSemanticScriptAclProbe", + RedisSemanticScriptAclProbe.class, + () -> + new RedisSemanticScriptAclProbe( + mock(RedisRuntimeOwner.class), + new RedisCapabilitySettings(), + new byte[] {0}, + Duration.ofSeconds(1))) .withUserConfiguration(RedisCapabilityConfig.class, Support.class) .withPropertyValues( "app.redis.enabled=true", @@ -145,7 +156,7 @@ class RedisCapabilityCompositionTest { static class Support { @Bean - SecretSource secretSource() { + SecretSourcePort secretSource() { return name -> Optional.of("fixture-secret-" + name); } diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisSemanticScriptAclProbeTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisSemanticScriptAclProbeTest.java new file mode 100644 index 00000000..04a8d2f3 --- /dev/null +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/redis/RedisSemanticScriptAclProbeTest.java @@ -0,0 +1,137 @@ +package dev.caskeleton.bootstrap.autoconfigure.redis; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatCode; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +import dev.caskeleton.adapter.outbound.cache.redis.sdk.api.RedisDeploymentMode; +import dev.caskeleton.adapter.outbound.cache.redis.sdk.lettuce.connection.RedisConnectionKind; +import dev.caskeleton.adapter.outbound.cache.redis.sdk.lettuce.connection.RedisRuntimeClient; +import dev.caskeleton.adapter.outbound.cache.redis.sdk.lettuce.connection.RedisRuntimeOwner; +import dev.caskeleton.adapter.outbound.cache.redis.sdk.lettuce.operations.RedisCommandGateway; +import dev.caskeleton.bootstrap.runtime.startup.StartupValidationException; +import java.lang.reflect.Proxy; +import java.nio.charset.StandardCharsets; +import java.time.Duration; +import java.util.EnumMap; +import java.util.List; +import java.util.Optional; +import java.util.concurrent.CompletableFuture; +import java.util.concurrent.atomic.AtomicInteger; +import org.junit.jupiter.api.Test; + +class RedisSemanticScriptAclProbeTest { + + @Test + void noScriptCapabilitySelectedDoesNotTouchRedis() { + RedisCapabilitySettings capabilities = new RedisCapabilitySettings(); + AtomicInteger opened = new AtomicInteger(); + RedisRuntimeOwner owner = owner(gateway(false), opened); + + RedisSemanticScriptAclProbe probe = + new RedisSemanticScriptAclProbe( + owner, + capabilities, + "prod:svc:shared:probe".getBytes(StandardCharsets.UTF_8), + Duration.ofSeconds(1)); + + assertThatCode(probe::afterSingletonsInstantiated).doesNotThrowAnyException(); + assertThat(opened).hasValue(0); + } + + @Test + void selectedScriptCapabilityMustLoadAndEvaluateAProgram() { + RedisCapabilitySettings capabilities = new RedisCapabilitySettings(); + capabilities.getRateLimit().setProvider("redis"); + AtomicInteger opened = new AtomicInteger(); + RedisRuntimeOwner owner = owner(gateway(false), opened); + + RedisSemanticScriptAclProbe probe = + new RedisSemanticScriptAclProbe( + owner, + capabilities, + "prod:svc:shared:probe".getBytes(StandardCharsets.UTF_8), + Duration.ofSeconds(1)); + + assertThatCode(probe::afterSingletonsInstantiated).doesNotThrowAnyException(); + assertThat(opened).hasValue(1); + } + + @Test + void missingScriptAclFailsStartupInsteadOfDeferringToFirstRequest() { + RedisCapabilitySettings capabilities = new RedisCapabilitySettings(); + capabilities.getLease().setProvider("redis"); + RedisRuntimeOwner owner = owner(gateway(true), new AtomicInteger()); + + RedisSemanticScriptAclProbe probe = + new RedisSemanticScriptAclProbe( + owner, + capabilities, + "prod:svc:shared:probe".getBytes(StandardCharsets.UTF_8), + Duration.ofSeconds(1)); + + assertThatThrownBy(probe::afterSingletonsInstantiated) + .isInstanceOf(StartupValidationException.class) + .hasMessageContaining("SCRIPT LOAD/EVALSHA is unavailable") + .hasRootCauseInstanceOf(RuntimeException.class); + } + + private static RedisRuntimeOwner owner(RedisCommandGateway gateway, AtomicInteger opened) { + RedisRuntimeClient client = + new RedisRuntimeClient() { + @Override + public RedisDeploymentMode mode() { + return RedisDeploymentMode.STANDALONE; + } + + @Override + public RedisLaneConnection openLane( + RedisConnectionKind kind, Optional routingKey) { + opened.incrementAndGet(); + return new RedisLaneConnection() { + @Override + public RedisCommandGateway gateway() { + return gateway; + } + + @Override + public boolean open() { + return true; + } + + @Override + public void close() {} + }; + } + + @Override + public void close() {} + }; + EnumMap limits = new EnumMap<>(RedisConnectionKind.class); + for (RedisConnectionKind kind : RedisConnectionKind.values()) { + limits.put(kind, 1); + } + return new RedisRuntimeOwner(client, limits, Duration.ofSeconds(1)); + } + + private static RedisCommandGateway gateway(boolean denyScripts) { + return (RedisCommandGateway) + Proxy.newProxyInstance( + RedisCommandGateway.class.getClassLoader(), + new Class[] {RedisCommandGateway.class}, + (proxy, method, arguments) -> + switch (method.getName()) { + case "loadScript" -> + denyScripts + ? CompletableFuture.failedFuture( + new RuntimeException("NOPERM script load denied")) + : CompletableFuture.completedFuture("probe-digest"); + case "evaluateRegisteredForList" -> + CompletableFuture.completedFuture(List.of(1L)); + case "toString" -> "RedisSemanticScriptAclProbeTestGateway"; + default -> + throw new UnsupportedOperationException( + "unexpected gateway method: " + method.getName()); + }); + } +} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingActivationContextTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingActivationContextTest.java index 60307e98..f07070ba 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingActivationContextTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingActivationContextTest.java @@ -3,6 +3,7 @@ package dev.caskeleton.bootstrap.autoconfigure.tracing; import static org.assertj.core.api.Assertions.assertThat; import dev.caskeleton.shared.tracing.SpanErrorRecorder; +import io.micrometer.core.instrument.MeterRegistry; import io.micrometer.tracing.Tracer; import org.junit.jupiter.api.Test; import org.springframework.beans.factory.annotation.Autowired; @@ -59,6 +60,18 @@ class TracingActivationContextTest { .isNotNull(); } + @Test + void profilelessSliceIsNotRelabeledAsLocalOrPublishedAsARuntimeGauge() { + TracingConfig.TracingSamplingRateGaugeRegistrar registrar = + context.getBean(TracingConfig.TracingSamplingRateGaugeRegistrar.class); + + assertThat(registrar.activeProfile()).isEqualTo("unresolved"); + MeterRegistry registry = context.getBeanProvider(MeterRegistry.class).getIfAvailable(); + if (registry != null) { + assertThat(registry.find(TracingSamplingRateGauge.METRIC_NAME).gauge()).isNull(); + } + } + @Test void contextLoadsWithBlankExporterEndpoint() { // Validates that blank OTEL_EXPORTER_OTLP_ENDPOINT does not cause startup failure. diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingSampleRateResolverTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingSampleRateResolverTest.java index 208f2689..3167a234 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingSampleRateResolverTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingSampleRateResolverTest.java @@ -21,11 +21,6 @@ class TracingSampleRateResolverTest { assertThat(TracingSampleRateResolver.defaultRateForProfile("prod")).isEqualTo(0.01); } - @Test - void stagingProfileDefaultIsTenPercent() { - assertThat(TracingSampleRateResolver.defaultRateForProfile("staging")).isEqualTo(0.10); - } - @Test void devProfileDefaultIsOneHundredPercent() { assertThat(TracingSampleRateResolver.defaultRateForProfile("dev")).isEqualTo(1.0); @@ -37,7 +32,7 @@ class TracingSampleRateResolverTest { } @ParameterizedTest - @ValueSource(strings = {"qa", "test", "integration", ""}) + @ValueSource(strings = {"staging", "qa", "test", "integration", ""}) void unknownProfileDefaultIsOneHundredPercent(String profile) { assertThat(TracingSampleRateResolver.defaultRateForProfile(profile)).isEqualTo(1.0); } @@ -74,7 +69,7 @@ class TracingSampleRateResolverTest { @Test void nullConfiguredRateFallsThroughToProfileDefault() { - assertThat(resolver.resolve("staging", null)).isEqualTo(0.10); + assertThat(resolver.resolve("prod", null)).isEqualTo(0.01); } @Test @@ -85,6 +80,13 @@ class TracingSampleRateResolverTest { @Test void nonNumericConfiguredRateFallsThroughToProfileDefault() { - assertThat(resolver.resolve("staging", "not-a-number")).isEqualTo(0.10); + assertThat(resolver.resolve("prod", "not-a-number")).isEqualTo(0.01); + } + + @Test + void multipleOrUnknownProfilesDoNotInventALocalRuntime() { + assertThat(resolver.resolve(java.util.List.of("local", "prod"), null)).isEqualTo(1.0); + assertThat(resolver.resolve(java.util.List.of("staging"), null)).isEqualTo(1.0); + assertThat(resolver.resolve(java.util.List.of(), null)).isEqualTo(1.0); } } diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingSamplingEnvironmentPostProcessorTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingSamplingEnvironmentPostProcessorTest.java index 53980fb4..635a9277 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingSamplingEnvironmentPostProcessorTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/autoconfigure/tracing/TracingSamplingEnvironmentPostProcessorTest.java @@ -26,6 +26,15 @@ class TracingSamplingEnvironmentPostProcessorTest { assertThat(env.getProperty("management.tracing.sampling.probability")).isEqualTo("0.01"); } + @Test + void profilelessContextDoesNotInventALocalRuntimeButUsesTheSafeNonProductionRate() { + MockEnvironment env = new MockEnvironment(); + + epp.postProcessEnvironment(env, new SpringApplication()); + + assertThat(env.getProperty("management.tracing.sampling.probability")).isEqualTo("1.0"); + } + @Test void explicitRateWins() { MockEnvironment env = new MockEnvironment(); diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/AutoConfigurationReachabilityParityTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/AutoConfigurationReachabilityParityTest.java new file mode 100644 index 00000000..2f44f2ed --- /dev/null +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/AutoConfigurationReachabilityParityTest.java @@ -0,0 +1,193 @@ +package dev.caskeleton.bootstrap.contract; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +import dev.caskeleton.adapter.inbound.graphql.autoconfigure.GraphQlOffAutoConfigurationImportFilter; +import dev.caskeleton.adapter.outbound.mongo.MongoOptInAutoConfigurationImportFilter; +import dev.caskeleton.bootstrap.CaSkeletonApplication; +import dev.caskeleton.bootstrap.autoconfigure.jpa.JpaOffAutoConfigurationImportFilter; +import java.lang.reflect.Field; +import java.lang.reflect.Modifier; +import java.util.Arrays; +import java.util.LinkedHashSet; +import java.util.Set; +import java.util.function.Predicate; +import java.util.regex.Pattern; +import java.util.stream.Collectors; +import org.junit.jupiter.api.Test; +import org.springframework.boot.autoconfigure.AutoConfiguration; +import org.springframework.boot.context.annotation.ImportCandidates; +import org.springframework.context.annotation.ClassPathScanningCandidateComponentProvider; +import org.springframework.context.annotation.ComponentScan; +import org.springframework.context.annotation.FilterType; +import org.springframework.context.annotation.Import; +import org.springframework.core.annotation.AnnotatedElementUtils; +import org.springframework.core.type.filter.AnnotationTypeFilter; +import org.springframework.stereotype.Component; + +/** + * Generic deployment-reachability parity for project auto-configuration. + * + *

    A configuration can be perfectly green when supplied directly to {@code + * ApplicationContextRunner} and still be absent from every shipped application. These checks bind + * source-level ownership to Boot discovery and to the composition root's structural scan exclusion. + */ +class AutoConfigurationReachabilityParityTest { + + private static final String GRAPHQL_PREFIX = "org.springframework.boot.graphql.autoconfigure."; + private static final String MONGO_PREFIX = "org.springframework.boot.mongodb.autoconfigure."; + private static final String DATA_MONGO_PREFIX = + "org.springframework.boot.data.mongodb.autoconfigure."; + + @Test + void everyProjectAutoConfigurationOnTheShippedClasspathIsABootImportCandidate() { + Set annotated = projectAutoConfigurations(); + Set candidates = bootCandidates(); + + requireRegistered(annotated, candidates); + + assertThat(annotated).isNotEmpty(); + } + + @Test + void componentScannableChildrenImportedByProjectRootsStayBehindTheStructuralExclusion() { + Set importedChildren = componentScannableImportedChildren(); + Predicate excluded = compositionRootScanExclusion(); + + requireExcluded(importedChildren, excluded); + + assertThat(importedChildren).isNotEmpty(); + } + + @Test + void offImportFiltersReferenceCurrentBootCandidates() { + Set candidates = bootCandidates(); + + requireTargetsExist(targets(JpaOffAutoConfigurationImportFilter.class), candidates); + assertThat(targets(GraphQlOffAutoConfigurationImportFilter.class)) + .isEqualTo(candidatesWithPrefix(candidates, GRAPHQL_PREFIX)); + assertThat(targets(MongoOptInAutoConfigurationImportFilter.class)) + .isEqualTo( + candidates.stream() + .filter(name -> name.startsWith(MONGO_PREFIX) || name.startsWith(DATA_MONGO_PREFIX)) + .collect(Collectors.toCollection(LinkedHashSet::new))); + } + + @Test + void parityAssertionsFailClosedForMissingImportScannedChildAndStaleFilterTarget() { + assertThatThrownBy(() -> requireRegistered(Set.of("example.MissingRoot"), Set.of())) + .isInstanceOf(AssertionError.class) + .hasMessageContaining("MissingRoot"); + assertThatThrownBy(() -> requireExcluded(Set.of("example.ScannedChild"), name -> false)) + .isInstanceOf(AssertionError.class) + .hasMessageContaining("ScannedChild"); + assertThatThrownBy(() -> requireTargetsExist(Set.of("example.StaleBootTarget"), Set.of())) + .isInstanceOf(AssertionError.class) + .hasMessageContaining("StaleBootTarget"); + } + + private static Set projectAutoConfigurations() { + ClassPathScanningCandidateComponentProvider scanner = + new ClassPathScanningCandidateComponentProvider(false); + scanner.addIncludeFilter(new AnnotationTypeFilter(AutoConfiguration.class)); + return scanner.findCandidateComponents("dev.caskeleton").stream() + .map(definition -> definition.getBeanClassName()) + .collect(Collectors.toCollection(LinkedHashSet::new)); + } + + private static Set bootCandidates() { + return new LinkedHashSet<>( + ImportCandidates.load( + AutoConfiguration.class, + AutoConfigurationReachabilityParityTest.class.getClassLoader()) + .getCandidates()); + } + + private static Set componentScannableImportedChildren() { + Set children = new LinkedHashSet<>(); + for (String rootName : bootCandidates()) { + if (!rootName.startsWith("dev.caskeleton.")) { + continue; + } + Class root = load(rootName); + Import directImport = root.getAnnotation(Import.class); + if (directImport == null) { + continue; + } + for (Class imported : directImport.value()) { + if (AnnotatedElementUtils.hasAnnotation(imported, Component.class)) { + children.add(imported.getName()); + } + } + } + return children; + } + + private static Predicate compositionRootScanExclusion() { + ComponentScan scan = CaSkeletonApplication.class.getAnnotation(ComponentScan.class); + Set exclusions = + Arrays.stream(scan.excludeFilters()) + .filter(filter -> filter.type() == FilterType.REGEX) + .flatMap(filter -> Arrays.stream(filter.pattern())) + .map(Pattern::compile) + .collect(Collectors.toCollection(LinkedHashSet::new)); + return className -> + exclusions.stream().anyMatch(pattern -> pattern.matcher(className).matches()); + } + + private static Set candidatesWithPrefix(Set candidates, String prefix) { + return candidates.stream() + .filter(name -> name.startsWith(prefix)) + .collect(Collectors.toCollection(LinkedHashSet::new)); + } + + @SuppressWarnings("unchecked") + private static Set targets(Class filterType) { + for (Field field : filterType.getDeclaredFields()) { + if (Modifier.isStatic(field.getModifiers()) && Set.class.equals(field.getType())) { + try { + field.setAccessible(true); + return new LinkedHashSet<>((Set) field.get(null)); + } catch (ReflectiveOperationException exception) { + throw new LinkageError("cannot read target set from " + filterType.getName(), exception); + } + } + } + throw new AssertionError("no static target Set found in " + filterType.getName()); + } + + private static Class load(String className) { + try { + return Class.forName(className); + } catch (ClassNotFoundException exception) { + throw new AssertionError("Boot candidate is not loadable: " + className, exception); + } + } + + private static void requireRegistered(Set roots, Set candidates) { + Set missing = new LinkedHashSet<>(roots); + missing.removeAll(candidates); + if (!missing.isEmpty()) { + throw new AssertionError("AutoConfiguration.imports is missing project roots: " + missing); + } + } + + private static void requireExcluded(Set children, Predicate excluded) { + Set leaking = + children.stream() + .filter(excluded.negate()) + .collect(Collectors.toCollection(LinkedHashSet::new)); + if (!leaking.isEmpty()) { + throw new AssertionError("imported children can leak through component scan: " + leaking); + } + } + + private static void requireTargetsExist(Set targets, Set candidates) { + Set stale = new LinkedHashSet<>(targets); + stale.removeAll(candidates); + if (!stale.isEmpty()) { + throw new AssertionError("off-import filter contains stale Boot targets: " + stale); + } + } +} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/BootstrapCapabilityAutoConfigurationReachabilityTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/BootstrapCapabilityAutoConfigurationReachabilityTest.java new file mode 100644 index 00000000..b6912e0b --- /dev/null +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/BootstrapCapabilityAutoConfigurationReachabilityTest.java @@ -0,0 +1,47 @@ +package dev.caskeleton.bootstrap.contract; + +import static org.assertj.core.api.Assertions.assertThat; + +import java.util.List; +import org.junit.jupiter.api.Test; +import org.springframework.boot.autoconfigure.AutoConfiguration; +import org.springframework.boot.context.annotation.ImportCandidates; + +/** + * Deployment reachability contract for bootstrap-owned capability roots. + * + *

    Supplying a configuration class manually to ApplicationContextRunner proves its bean methods, + * not that the shipped application can ever discover it. Every root below lives under a package + * excluded from component scan, so Boot's AutoConfiguration.imports resource is its only production + * entry point. + */ +class BootstrapCapabilityAutoConfigurationReachabilityTest { + + private static final List REQUIRED_ROOTS = + List.of( + "dev.caskeleton.bootstrap.autoconfigure.redis.RedisCapabilityConfig", + "dev.caskeleton.bootstrap.autoconfigure.outbox.OutboxConfig", + "dev.caskeleton.bootstrap.autoconfigure.lock.DistributedLockConfig", + "dev.caskeleton.bootstrap.autoconfigure.idempotency.IdempotencyProviderSelectionConfig", + "dev.caskeleton.bootstrap.autoconfigure.tracing.TracingConfig"); + + @Test + void everyBootstrapOwnedCapabilityRootIsDiscoverableByBoot() { + List candidates = + ImportCandidates.load(AutoConfiguration.class, getClass().getClassLoader()).getCandidates(); + + assertThat(candidates).containsAll(REQUIRED_ROOTS); + } + + @Test + void everyDiscoverableBootstrapCapabilityRootIsAnAutoConfiguration() throws Exception { + for (String className : REQUIRED_ROOTS) { + Class root = Class.forName(className); + assertThat(root.isAnnotationPresent(AutoConfiguration.class)) + .as( + "%s must be a Boot auto-configuration, not a manually supplied test configuration", + className) + .isTrue(); + } + } +} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/ConditionalTransportQualificationContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/ConditionalTransportQualificationContractTest.java index e4408509..20128a51 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/ConditionalTransportQualificationContractTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/ConditionalTransportQualificationContractTest.java @@ -2,11 +2,13 @@ package dev.caskeleton.bootstrap.contract; import static org.assertj.core.api.Assertions.assertThat; +import dev.caskeleton.bootstrap.CaSkeletonApplication; import java.io.IOException; import java.nio.file.Files; import java.nio.file.Path; import java.nio.file.Paths; import org.junit.jupiter.api.Test; +import org.springframework.boot.context.properties.ConfigurationPropertiesScan; /** * The opt-in inbound transports qualify without skips, and the root only aggregates. @@ -60,6 +62,18 @@ class ConditionalTransportQualificationContractTest { .doesNotContain("WebSocketBoundaryQualificationTest"); } + @Test + void optionalTransportsAreNotSettingsScannedByTheShippedComposition() { + ConfigurationPropertiesScan scan = + CaSkeletonApplication.class.getAnnotation(ConfigurationPropertiesScan.class); + + assertThat(scan).isNotNull(); + assertThat(scan.basePackages()) + .doesNotContain( + "dev.caskeleton.adapter.inbound.grpc", + "dev.caskeleton.adapter.inbound.websocket"); + } + @Test void theReleaseBlockingQualityJobInvokesTheAggregate() throws IOException { String workflow = 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 ef50db6c..c8ccba5d 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 @@ -223,6 +223,57 @@ class DeveloperExperienceContractTest { assertDockerDependencyCacheContract("src/Dockerfile", read("src/Dockerfile")); } + @Test + void dockerDependencyCacheStagesEveryIncludedBuildBeforeGradle() throws IOException { + String settings = read("src/settings.gradle"); + String dockerfile = read("src/Dockerfile"); + int firstGradleInvocation = dockerfile.indexOf("./gradlew"); + + assertThat(firstGradleInvocation).isPositive(); + String dependencyCachePrefix = dockerfile.substring(0, firstGradleInvocation); + Matcher includedBuilds = + Pattern.compile("includeBuild\\(['\"]([^'\"]+)['\"]\\)").matcher(settings); + + int includedBuildCount = 0; + while (includedBuilds.find()) { + includedBuildCount++; + String includedBuild = includedBuilds.group(1); + assertThat(dependencyCachePrefix) + .as( + "included build %s must be copied completely before the Docker dependency-resolution " + + "Gradle invocation", + includedBuild) + .contains("COPY " + includedBuild + "/ ./" + includedBuild + "/"); + } + + assertThat(includedBuildCount) + .as("settings.gradle must expose at least one included build for this contract") + .isPositive(); + } + + @Test + void architectureWorkflowSelectorsUseTheArchitectureSourceSetTask() throws IOException { + String staleSelector = ":app-bootstrap:test --tests 'dev.caskeleton.bootstrap.architecture.*'"; + + assertThat(read(".github/workflows/fileserver-pr.yml")) + .as( + "the fileserver PR workflow must execute architecture tests through their source-set" + + " task") + .contains(":app-bootstrap:architectureTest") + .doesNotContain(staleSelector); + + assertThat(read(".github/workflows/release.yml")) + .as("the release workflow delegates repository architecture policy to releaseCheck") + .contains("./gradlew :releaseCheck") + .doesNotContain(staleSelector); + + assertThat(read("CLAUDE.md")) + .as("the operator/developer command must match the shipped architecture source set") + .contains("./gradlew :app-bootstrap:architectureTest") + .doesNotContain( + "./gradlew :app-bootstrap:test --tests 'dev.caskeleton.bootstrap.architecture.*'"); + } + @Test void dockerBuildConsumesOnlyTheGradleStagedExecutableJar() throws IOException { String dockerfile = "src/Dockerfile"; diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DistributedTracingContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DistributedTracingContractTest.java index b38b8495..b2fac644 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DistributedTracingContractTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/DistributedTracingContractTest.java @@ -186,10 +186,9 @@ class DistributedTracingContractTest { /** * Asserts the {@code tracing.sampling.rate} row in {@code metrics.yaml} is a {@code gauge} with - * tag {@code profile} {@code cardinality_limit: 4} and {@code allowed_values: [prod, staging, - * dev, local]}; AND registers {@link TracingSamplingRateGauge} against a {@link - * SimpleMeterRegistry} and asserts exactly one {@code tracing.sampling.rate} series exists - * (cardinality 1 ≤ 4). + * tag {@code profile} {@code cardinality_limit: 3} and {@code allowed_values: [prod, dev, + * local]}; AND registers {@link TracingSamplingRateGauge} against a {@link SimpleMeterRegistry} + * and asserts exactly one {@code tracing.sampling.rate} series exists (cardinality 1 ≤ 4). */ @Test void tracingSamplingRateGaugeRegistryContract() { @@ -216,14 +215,14 @@ class DistributedTracingContractTest { () -> new AssertionError("tracing.sampling.rate must have a 'profile' tag")); assertThat(profileTag.get("cardinality_limit")) - .as("profile tag cardinality_limit must be 4") - .isEqualTo(4); + .as("profile tag cardinality_limit must be 3") + .isEqualTo(3); @SuppressWarnings("unchecked") List allowed = (List) profileTag.get("allowed_values"); assertThat(allowed) - .as("profile tag allowed_values must be [prod, staging, dev, local]") - .containsExactlyInAnyOrder("prod", "staging", "dev", "local"); + .as("profile tag allowed_values must match RuntimeEnvironment deployable profiles") + .containsExactlyInAnyOrder("prod", "dev", "local"); } @Test diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/EnvProfileMatrixContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/EnvProfileMatrixContractTest.java index e71d749b..015ea0c8 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/EnvProfileMatrixContractTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/EnvProfileMatrixContractTest.java @@ -11,90 +11,28 @@ import java.util.regex.Pattern; import org.junit.jupiter.api.Test; /** - * Base contract #7 (env profile matrix) of the contract-verification suite. Pins the env-matrix - * safety baseline at the registry/config level — complementing the behavioral {@code - * StartupSafetyValidatorTest}, which exercises the same invariants by booting an {@code - * ApplicationContextRunner} under the {@code prod} profile. + * Pins the runtime profile selector to one source of truth. * - *

    Three invariants: - * - *

      - *
    1. the prod-unsafe toggles ({@code APP_ERROR_DETAIL_EXPOSURE_ENABLED}, {@code - * APP_LOG_BODY_CAPTURE_ENABLED}) ship disabled in {@code src/.env}; - *
    2. both toggles are registered in {@code env-keys.yaml} with the {@code - * prod_profile_must_be_false} validation — the matrix constraint that {@code - * StartupSafetyValidator} enforces at startup; - *
    3. the profile selector is {@code SPRING_PROFILES_ACTIVE} alone — {@code APP_PROFILE} was - * dropped (env-keys.yaml D6, 2026-06-06) and must not reappear as a registered key, so the - * active-profile matrix has a single source of truth. - *
    - * - *

    Registry and runtime-default assertions load their checked-in resources fail-closed. + *

    Reserved switches for unimplemented error-detail exposure and body logging are intentionally + * absent; profile-matrix tests must not treat nonexistent features as safety controls. */ class EnvProfileMatrixContractTest { - private static final String ERROR_DETAIL_TOGGLE = "APP_ERROR_DETAIL_EXPOSURE_ENABLED"; - private static final String BODY_CAPTURE_TOGGLE = "APP_LOG_BODY_CAPTURE_ENABLED"; - private static final String PROD_SAFE_CONSTRAINT = "prod_profile_must_be_false"; - - @Test - void prodUnsafeTogglesShipDisabledInEnv() throws IOException { - Path env = resources().requireTrackedFile("src/.env.example"); - String text = Files.readString(env); - - assertThat(envValue(text, ERROR_DETAIL_TOGGLE)) - .as( - "%s must ship false — internal error detail exposure is prod-forbidden", - ERROR_DETAIL_TOGGLE) - .isEqualTo("false"); - assertThat(envValue(text, BODY_CAPTURE_TOGGLE)) - .as( - "%s must ship false — request/response body capture is prod-forbidden", - BODY_CAPTURE_TOGGLE) - .isEqualTo("false"); - } - - @Test - void prodUnsafeTogglesCarryProdMustBeFalseConstraint() throws IOException { - Path registry = resources().requireTrackedFile("docs/registries/env-keys.yaml"); - String text = Files.readString(registry); - - for (String toggle : new String[] {ERROR_DETAIL_TOGGLE, BODY_CAPTURE_TOGGLE}) { - String block = registryBlock(text, toggle); - assertThat(block).as("env-keys.yaml must register %s", toggle).isNotNull(); - assertThat(block) - .as("%s must carry the %s matrix constraint", toggle, PROD_SAFE_CONSTRAINT) - .contains(PROD_SAFE_CONSTRAINT); - } - } - @Test void profileSelectorIsSpringProfilesActiveOnly() throws IOException { RepositoryContractResources resources = resources(); Path registry = resources.requireTrackedFile("docs/registries/env-keys.yaml"); assertThat(registryBlock(Files.readString(registry), "APP_PROFILE")) - .as( - "APP_PROFILE must not be a registered env key — the profile selector is " - + "SPRING_PROFILES_ACTIVE alone (env-keys.yaml D6, 2026-06-06)") + .as("APP_PROFILE must not be a registered env key") .isNull(); Path env = resources.requireTrackedFile("src/.env.example"); assertThat(envValue(Files.readString(env), "APP_PROFILE")) - .as("src/.env must not declare APP_PROFILE — SPRING_PROFILES_ACTIVE is the sole selector") + .as("src/.env must not declare APP_PROFILE") .isNull(); } - /** - * The selector has no environment default, and saying so is the contract. - * - *

    This used to assert the opposite — a {@code :local} fallback, so early binding always had a - * value. The value it always had was the problem: a jar started with no profile became a local - * deployment silently, and before persistence was gated that also meant an in-memory database - * that loses every write on restart. The placeholder still resolves, to empty, because an - * unresolvable one fails during property resolution with a message about a missing value rather - * than {@code RuntimeEnvironmentProfileValidator} naming the three permitted profiles. - */ @Test void profileSelectorHasNoEnvironmentDefault() throws IOException { Path applicationYaml = @@ -106,18 +44,12 @@ class EnvProfileMatrixContractTest { .doesNotContain("active: ${SPRING_PROFILES_ACTIVE:local}"); } - /** Value of {@code KEY=...} in an env file, or {@code null} when the key is absent. */ private static String envValue(String envText, String key) { - Matcher m = + Matcher matcher = Pattern.compile("^" + Pattern.quote(key) + "=(.*)$", Pattern.MULTILINE).matcher(envText); - return m.find() ? m.group(1).trim() : null; + return matcher.find() ? matcher.group(1).trim() : null; } - /** - * Returns the YAML block from {@code - name: KEY} up to the next {@code - name:} entry (or end of - * file), or {@code null} when the key is not a registered entry. Comment lines that merely - * mention the key do not match the anchored {@code - name:} start. - */ private static String registryBlock(String registryText, String key) { Matcher start = Pattern.compile("(?m)^\\s*-\\s*name:\\s*" + Pattern.quote(key) + "\\s*$") diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/ErrorCodeRegistryMappingTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/ErrorCodeRegistryMappingTest.java index 4a014e64..c4a86338 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/ErrorCodeRegistryMappingTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/ErrorCodeRegistryMappingTest.java @@ -24,7 +24,7 @@ import org.yaml.snakeyaml.Yaml; * ApiErrorCode} enums: for every code present in both the registry and an enum, the * statuses must agree. It also pins that the transport-standard codes this branch owns * (405/406/412/413/414/415) are actually present in the registry — a missing row is a FAIL, never a - * silent SKIP (branch-note §Edge). + * silent SKIP (design record §Edge). */ class ErrorCodeRegistryMappingTest { @@ -54,7 +54,7 @@ class ErrorCodeRegistryMappingTest { @Test void transportStandardCodesOwnedByThisBranchAreRegisteredWithMatchingStatus() { - // branch-note §Edge: a missing row is a FAIL (drift), not a silent pass. + // design record §Edge: a missing row is a FAIL (drift), not a silent pass. Map expected = Map.of( "METHOD_NOT_ALLOWED", 405, diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/HeaderRegistryRuntimeAlignmentTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/HeaderRegistryRuntimeAlignmentTest.java new file mode 100644 index 00000000..01c71604 --- /dev/null +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/HeaderRegistryRuntimeAlignmentTest.java @@ -0,0 +1,80 @@ +package dev.caskeleton.bootstrap.contract; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +import dev.caskeleton.adapter.inbound.web.ratelimit.RateLimitWebConfig; +import dev.caskeleton.adapter.inbound.web.security.UntrustedTenantInputException; +import dev.caskeleton.adapter.inbound.web.security.WebTenantContextResolver; +import dev.caskeleton.bootstrap.contract.support.RepositoryContractResources; +import java.io.InputStream; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.List; +import java.util.Map; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; +import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; +import org.yaml.snakeyaml.Yaml; + +class HeaderRegistryRuntimeAlignmentTest { + + private static List> headers; + + @BeforeAll + static void loadRegistry() throws Exception { + Path path = + RepositoryContractResources.fromSystemProperty() + .requireTrackedFile("docs/registries/headers.yaml"); + try (InputStream input = Files.newInputStream(path)) { + @SuppressWarnings("unchecked") + Map root = new Yaml().load(input); + @SuppressWarnings("unchecked") + List> rows = (List>) root.get("headers"); + headers = rows; + } + } + + @Test + void unsupportedTenantAndApiVersionHeadersAreNotAdvertisedAsSupportedSurface() { + assertThat(names()).doesNotContain("X-Tenant-Id", "X-Api-Version"); + + WebTenantContextResolver resolver = new WebTenantContextResolver(); + assertThatThrownBy(() -> resolver.rejectTenantInput(Map.of("X-Tenant-Id", "tenant-attacker"))) + .isInstanceOf(UntrustedTenantInputException.class); + } + + @Test + void deprecationDatesUseTheHttpDateWireType() { + assertThat(row("Deprecation").get("type")).isEqualTo("http-date"); + assertThat(row("Sunset").get("type")).isEqualTo("http-date"); + assertThat(row("X-RateLimit-Reset").get("type")).isEqualTo("rfc3339-date"); + } + + @Test + void rateLimitHeadersAreGeneratedOnlyInsideTheEnabledRateLimitCapability() { + for (String name : List.of("X-RateLimit-Limit", "X-RateLimit-Remaining", "X-RateLimit-Reset")) { + assertThat(row(name).get("generated_if_missing")).isEqualTo(true); + } + + ConditionalOnProperty activation = + RateLimitWebConfig.class.getAnnotation(ConditionalOnProperty.class); + assertThat(activation).isNotNull(); + assertThat(activation.prefix()).isEqualTo("app.rate-limit"); + assertThat(activation.name()).containsExactly("enabled"); + assertThat(activation.havingValue()).isEqualTo("true"); + } + + private static java.util.Set names() { + return headers.stream() + .map(row -> String.valueOf(row.get("name"))) + .collect(java.util.stream.Collectors.toSet()); + } + + private static Map row(String name) { + return headers.stream() + .filter(row -> name.equals(row.get("name"))) + .findFirst() + .orElseThrow(() -> new AssertionError("headers.yaml must contain " + name)); + } +} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/MongoShippedCompositionContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/MongoShippedCompositionContractTest.java new file mode 100644 index 00000000..8f0003ca --- /dev/null +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/MongoShippedCompositionContractTest.java @@ -0,0 +1,27 @@ +package dev.caskeleton.bootstrap.contract; + +import static org.assertj.core.api.Assertions.assertThat; + +import org.junit.jupiter.api.Test; +import org.springframework.util.ClassUtils; + +class MongoShippedCompositionContractTest { + + @Test + void shippedCompositionCarriesTheReactiveApiButNotTheReactiveDriver() { + ClassLoader classLoader = getClass().getClassLoader(); + + // Spring Data MongoDB packages imperative and reactive templates in the same artifact, so the + // API type being loadable is not runtime reachability evidence. + assertThat( + ClassUtils.isPresent( + "org.springframework.data.mongodb.core.ReactiveMongoTemplate", classLoader)) + .isTrue(); + + // The default app-bootstrap explicitly excludes the reactive-streams Mongo driver. Without it, + // Boot cannot construct the ReactiveMongoTemplate bean required by ReactiveExecution. + assertThat( + ClassUtils.isPresent("com.mongodb.reactivestreams.client.MongoClient", classLoader)) + .isFalse(); + } +} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/OptionalAdapterConditionalExecutionContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/OptionalAdapterConditionalExecutionContractTest.java index 4a72b279..35e44995 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/OptionalAdapterConditionalExecutionContractTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/OptionalAdapterConditionalExecutionContractTest.java @@ -35,13 +35,13 @@ class OptionalAdapterConditionalExecutionContractTest { @Test @EnabledIfSlackNotificationConfigured void slackNotificationAdapterRunsOnlyWhenConfigured() { - assertThat(System.getenv("APP_NOTIFICATION_SLACK_PROVIDER")).isNotBlank(); + assertThat(System.getenv("APP_NOTIFICATION_SLACK_WEBHOOK_ENABLED")).isEqualTo("true"); } @Test @EnabledIfEmailNotificationConfigured void emailNotificationAdapterRunsOnlyWhenConfigured() { - assertThat(System.getenv("APP_NOTIFICATION_EMAIL_PROVIDER")).isNotBlank(); + assertThat(System.getenv("APP_NOTIFICATION_GOOGLE_EMAIL_ENABLED")).isEqualTo("true"); } @Test diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/PiiTokenBodyForbiddenContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/PiiTokenBodyForbiddenContractTest.java index 2771e734..498f9a9a 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/PiiTokenBodyForbiddenContractTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/PiiTokenBodyForbiddenContractTest.java @@ -26,8 +26,8 @@ import org.slf4j.LoggerFactory; *

  4. token / secret — {@link LogMaskingPatterns} (the SSOT both the pattern-layout and * JSON-encoder paths use) masks every enumerated secret shape so a captured log line carries * zero unmasked secrets; - *
  5. body — request/response body capture is forbidden by default ({@code - * APP_LOG_BODY_CAPTURE_ENABLED=false}), so bodies never reach the log. + *
  6. body — the shipped request logging filter does not read or wrap request bodies, so + * there is no dormant body-capture switch that can expose payloads accidentally. * * *

    The {@code UNMASKED_SECRET} detector encodes the "masked regex 매칭 0건" measure: it matches a @@ -110,25 +110,23 @@ class PiiTokenBodyForbiddenContractTest { } @Test - void requestBodyCaptureIsDisabledByDefault() throws IOException { - Path env = - RepositoryContractResources.fromSystemProperty().requireTrackedFile("src/.env.example"); + void requestLoggingHasNoBodyCapturePath() throws IOException { + Path filter = + RepositoryContractResources.fromSystemProperty() + .requireTrackedFile( + "src/adapter/inbound/web/src/main/java/" + + "dev/caskeleton/adapter/inbound/web/filter/RequestLoggingFilter.java"); + String source = Files.readString(filter); - String value = readEnv(env, "APP_LOG_BODY_CAPTURE_ENABLED"); - assertThat(value) - .as( - "APP_LOG_BODY_CAPTURE_ENABLED must default to false — request/response body " - + "capture in logs is forbidden unless explicitly allowlisted (§7 body)") - .isEqualTo("false"); + assertThat(source) + .doesNotContain("getInputStream(") + .doesNotContain("getReader(") + .doesNotContain("ContentCachingRequestWrapper") + .doesNotContain("ContentCachingResponseWrapper"); } private static long countUnmasked(String text) { return UNMASKED_SECRET.matcher(text).results().count(); } - private static String readEnv(Path envFile, String key) throws IOException { - Pattern line = Pattern.compile("^" + Pattern.quote(key) + "=(.*)$", Pattern.MULTILINE); - Matcher m = line.matcher(Files.readString(envFile)); - return m.find() ? m.group(1).trim() : null; - } } diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/ProfileSeparationContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/ProfileSeparationContractTest.java index 1a7c6ba6..1e8de49e 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/ProfileSeparationContractTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/ProfileSeparationContractTest.java @@ -113,8 +113,8 @@ class ProfileSeparationContractTest { Map base = ShippedConfiguration.tree(); assertThat(vendorOf(base)) - .as("a deployment that activates no profile must not silently get H2") - .isEqualTo("postgresql"); + .as("the profileless vendor remains overrideable while defaulting to PostgreSQL") + .isEqualTo("${APP_PERSISTENCE_VENDOR:postgresql}"); } private static Map profile(String profile) throws IOException { diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/RuntimeProfileLoggingContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/RuntimeProfileLoggingContractTest.java new file mode 100644 index 00000000..ac39f20b --- /dev/null +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/RuntimeProfileLoggingContractTest.java @@ -0,0 +1,25 @@ +package dev.caskeleton.bootstrap.contract; + +import static org.assertj.core.api.Assertions.assertThat; + +import java.io.IOException; +import java.io.InputStream; +import java.nio.charset.StandardCharsets; +import org.junit.jupiter.api.Test; + +/** Logback must not invent a deployable runtime before Spring resolves one. */ +class RuntimeProfileLoggingContractTest { + + @Test + void earlyLoggingUsesUnresolvedInsteadOfGuessingLocal() throws IOException { + try (InputStream stream = + RuntimeProfileLoggingContractTest.class.getResourceAsStream("/logback-spring.xml")) { + assertThat(stream).isNotNull(); + String logback = new String(stream.readAllBytes(), StandardCharsets.UTF_8); + + assertThat(logback) + .contains("source=\"SPRING_PROFILES_ACTIVE\" defaultValue=\"unresolved\"") + .doesNotContain("source=\"SPRING_PROFILES_ACTIVE\" defaultValue=\"local\""); + } + } +} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/SecretReloadContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/SecretReloadContractTest.java index ec7af70d..b511e24b 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/SecretReloadContractTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/SecretReloadContractTest.java @@ -20,10 +20,10 @@ import org.springframework.core.env.MutablePropertySources; * auto-reload into the bound bean — config is startup-bound ({@code SPRING-EXTCONFIG-C5}), there is * no in-process refresh machinery. * - *

    Branch-note Claims To Verify: "AWSCURRENT 변경 시 application 까지 자동 전파 안 되고 restart 필요". This is - * the local stand-in for that claim — we cannot drive a real secret manager here, so we assert (a) - * a startup-bound {@code @ConfigurationProperties} value is immutable against a post-refresh {@code - * Environment} mutation, and (b) the Spring Cloud refresh-scope machinery is absent from the + *

    design record Claims To Verify: "AWSCURRENT 변경 시 application 까지 자동 전파 안 되고 restart 필요". This + * is the local stand-in for that claim — we cannot drive a real secret manager here, so we assert + * (a) a startup-bound {@code @ConfigurationProperties} value is immutable against a post-refresh + * {@code Environment} mutation, and (b) the Spring Cloud refresh-scope machinery is absent from the * runtime classpath entirely ({@code spring-cloud-context} is {@code testCompileOnly}), so no * auto-reload path exists. */ diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/messaging/MessagingMembershipQualificationTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/messaging/MessagingMembershipQualificationTest.java index a4db74b4..796fdd61 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/messaging/MessagingMembershipQualificationTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/messaging/MessagingMembershipQualificationTest.java @@ -6,105 +6,80 @@ import java.io.IOException; import java.io.UncheckedIOException; import java.nio.file.Files; import java.nio.file.Path; -import java.util.List; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; -/** - * What shipping the messaging platform put on the runtime, and what of it is qualified - * (MSG-INT-003). - * - *

    The starter is now an {@code app-bootstrap} dependency, because the artifact contract is that - * all five adapters are present and off by a switch rather than absent from the build — an adapter - * whose classes are missing cannot be turned on by an operator at all. Adding it resolved eighteen - * leaves onto the runtime classpath in one step, which the wave predicted and called intended. - * - *

    Those eighteen are not equally proven, and this test exists so that difference stays written - * down instead of being absorbed by the word "shipped": - * - *

      - *
    • Qualified. The Kafka publish path, by {@code - * MessagingLiveRoundTripQualificationTest} against a real broker — the broker acknowledges, - * and the test asserts the acknowledgement rather than that the call returned. - *
    • Shipped, inactive, unqualified. The Rabbit transport, the JDBC inbox and outbox - * reliability adapters, the claim check and the admin plane. Each has unit tests over fakes - * and none has a live round trip. They contribute nothing until the master switch is on - * and a deployment selects them. - *
    - * - *

    This is the shape the design permits — a capability may ship inactive and explicitly - * unqualified — and not the shape it forbids, which is calling an unqualified transport ready - * because it is on the classpath. The difference is entirely in whether anyone wrote it down. - */ +/** Build-time membership contract for the messaging core and broker capabilities (MSG-INT-003). */ class MessagingMembershipQualificationTest { @Test - @DisplayName("the Kafka path is qualified by a live broker round trip, not by unit tests") - void theKafkaPathIsQualifiedByALiveRoundTrip() { + @DisplayName("the Kafka capability is qualified by a live broker round trip") + void theKafkaCapabilityIsQualifiedByALiveRoundTrip() { Path qualification = repositoryRoot() .resolve( - "src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/" + "src/messaging/messaging-spring-boot-starter/src/integrationTest/java/dev/caskeleton/messaging/" + "autoconfigure/MessagingLiveRoundTripQualificationTest.java"); assertThat(Files.exists(qualification)) - .as("shipping the starter without this would be a promotion on the strength of fakes") + .as("Kafka capability promotion must not rest on unit fakes") .isTrue(); - assertThat(read(qualification)) - .as("it must assert the broker accepted, not that the call returned") - .contains("brokerAccepted()"); + assertThat(read(qualification)).contains("brokerAccepted()"); + assertThat( + read( + repositoryRoot() + .resolve("src/messaging/messaging-spring-boot-starter/build.gradle"))) + .contains( + "integrationTestImplementation project(':messaging:messaging-spring-boot-starter-kafka')"); } @Test - @DisplayName("the facade ships, so 'off' is a switch rather than a missing class") - void theFacadeShips() { - assertThat(read(repositoryRoot().resolve("src/app-bootstrap/build.gradle"))) - .as( - "ShippedRuntimeFacadePresenceTest asserts the class is loadable; this asserts the edge " - + "that puts it there, so the two cannot drift into a jar that carries the class by " - + "accident of some transitive dependency") - .contains("project(':messaging:messaging-spring-boot-starter')"); + @DisplayName("the default composition ships the broker-neutral core, not either broker capability") + void defaultCompositionShipsOnlyTheBrokerNeutralCore() { + String bootstrap = read(repositoryRoot().resolve("src/app-bootstrap/build.gradle")); + + assertThat(bootstrap) + .contains("implementation project(':messaging:messaging-spring-boot-starter')") + .doesNotContain( + "implementation project(':messaging:messaging-spring-boot-starter-kafka')", + "implementation project(':messaging:messaging-spring-boot-starter-rabbit')", + "implementation project(':adapter:outbound:messaging-kafka')"); } @Test - @DisplayName("every resolved messaging leaf is a registered runtime member") - void everyResolvedLeafIsRegistered() { - String registry = read(repositoryRoot().resolve("src/config/architecture/modules.json")); - - // The closure gate reports all eighteen; a partially registered closure would mean leaves on - // the - // bootJar that the registry says belong to no runtime, which is the state the gate exists to - // refuse. Naming a few of them here keeps this readable without restating the registry. - for (String leaf : - List.of( - "messaging-spring-boot-starter", - "messaging-kafka", - "messaging-rabbit", - "messaging-admin-runtime")) { - assertThat(registry) - .as("%s resolves onto the runtime classpath and must be registered as a member", leaf) - .contains("\"" + leaf + "\""); - } - } - - @Test - @DisplayName("the unqualified transports are named, so 'shipped' is not read as 'ready'") - void theUnqualifiedTransportsAreNamed() { - // Deliberately asserted against this file. The record of what is unqualified has to live - // somewhere a change to the qualification state would have to touch, and a comment in a build - // file is not that place — it is the first thing a dependency edit rewrites without thinking. - String self = + @DisplayName("the core starter has no production edge to either broker leaf") + void coreStarterIsBrokerNeutral() { + String starter = read( repositoryRoot() - .resolve( - "src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/messaging/" - + "MessagingMembershipQualificationTest.java")); + .resolve("src/messaging/messaging-spring-boot-starter/build.gradle")); - assertThat(self) - .as("each unqualified family stays named until it has a live round trip of its own") - .contains("Rabbit transport") - .contains("JDBC inbox and outbox") - .contains("admin plane"); + assertThat(starter) + .doesNotContain( + "implementation project(':messaging:messaging-kafka')", + "implementation project(':messaging:messaging-rabbit')"); + } + + @Test + @DisplayName("Kafka and Rabbit capability leaves are registered as separate build-time modules") + void brokerCapabilitiesAreRegisteredSeparately() { + String registry = read(repositoryRoot().resolve("src/config/architecture/modules.json")); + + assertThat(registry) + .contains("\"messaging-spring-boot-starter-kafka\"") + .contains("\"messaging-spring-boot-starter-rabbit\"") + .contains("\"adapter-outbound-messaging-kafka\""); + } + + @Test + @DisplayName("Rabbit remains explicitly unselectable until a production transport exists") + void rabbitQualificationStateIsExplicit() { + String matrix = read(repositoryRoot().resolve("docs/messaging/support-matrix.md")); + + assertThat(matrix) + .contains("RabbitMQ") + .contains("현재 starter에서 선택 불가") + .contains("RabbitChannelPublisher"); } private static String read(Path path) { diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/support/conditional/EnabledIfEmailNotificationConfigured.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/support/conditional/EnabledIfEmailNotificationConfigured.java index 09723dc5..5350e178 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/support/conditional/EnabledIfEmailNotificationConfigured.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/support/conditional/EnabledIfEmailNotificationConfigured.java @@ -8,17 +8,17 @@ import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable; /** * Gates an optional-adapter contract test to the email-notification-configured env matrix. {@code - * APP_NOTIFICATION_EMAIL_PROVIDER} is a provider name (string), so the match is {@code .+}. Reports - * DISABLED (= SKIPPED, never FAILED) when the provider is unset + * APP_NOTIFICATION_GOOGLE_EMAIL_ENABLED} is a boolean provider switch, so the match is {@code + * true}. Reports DISABLED (= SKIPPED, never FAILED) when the provider is unset * (feature-contract-verification-test-suite D3). */ @Target({ElementType.TYPE, ElementType.METHOD}) @Retention(RetentionPolicy.RUNTIME) @EnabledIfEnvironmentVariable( - named = "APP_NOTIFICATION_EMAIL_PROVIDER", - matches = ".+", + named = "APP_NOTIFICATION_GOOGLE_EMAIL_ENABLED", + matches = "true", disabledReason = "No email notification provider configured " - + "(APP_NOTIFICATION_EMAIL_PROVIDER unset) — optional-adapter contract test runs " + + "(APP_NOTIFICATION_GOOGLE_EMAIL_ENABLED unset) — optional-adapter contract test runs " + "only when an email provider is set") public @interface EnabledIfEmailNotificationConfigured {} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/support/conditional/EnabledIfSlackNotificationConfigured.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/support/conditional/EnabledIfSlackNotificationConfigured.java index e2d08ffe..94188e1c 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/support/conditional/EnabledIfSlackNotificationConfigured.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/contract/support/conditional/EnabledIfSlackNotificationConfigured.java @@ -8,17 +8,16 @@ import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable; /** * Gates an optional-adapter contract test to the Slack-notification-configured env matrix. {@code - * APP_NOTIFICATION_SLACK_PROVIDER} is a provider name (string), so the match is {@code .+}. Reports - * DISABLED (= SKIPPED, never FAILED) when the provider is unset + * APP_NOTIFICATION_SLACK_WEBHOOK_ENABLED} is a boolean provider switch, so the match is {@code + * true}. Reports DISABLED (= SKIPPED, never FAILED) when the provider is unset * (feature-contract-verification-test-suite D3). */ @Target({ElementType.TYPE, ElementType.METHOD}) @Retention(RetentionPolicy.RUNTIME) @EnabledIfEnvironmentVariable( - named = "APP_NOTIFICATION_SLACK_PROVIDER", - matches = ".+", + named = "APP_NOTIFICATION_SLACK_WEBHOOK_ENABLED", + matches = "true", disabledReason = - "No Slack notification provider configured " - + "(APP_NOTIFICATION_SLACK_PROVIDER unset) — optional-adapter contract test runs " - + "only when a Slack provider is set") + "No Slack notification provider configured (APP_NOTIFICATION_SLACK_WEBHOOK_ENABLED unset) —" + + " optional-adapter contract test runs only when a Slack provider is set") public @interface EnabledIfSlackNotificationConfigured {} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/logging/StartupFailureSpringBootLogFilterTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/logging/StartupFailureSpringBootLogFilterTest.java index 81290cee..c93685e4 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/logging/StartupFailureSpringBootLogFilterTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/logging/StartupFailureSpringBootLogFilterTest.java @@ -8,7 +8,6 @@ import ch.qos.logback.classic.LoggerContext; import ch.qos.logback.core.spi.FilterReply; import dev.caskeleton.bootstrap.runtime.startup.StartupFailureLogState; import org.junit.jupiter.api.AfterEach; -import org.junit.jupiter.api.BeforeEach; import org.junit.jupiter.api.Test; class StartupFailureSpringBootLogFilterTest { @@ -22,14 +21,8 @@ class StartupFailureSpringBootLogFilterTest { private final Logger failureAnalysisLogger = context.getLogger("org.springframework.boot.diagnostics.LoggingFailureAnalysisReporter"); - @BeforeEach - void clearState() { - StartupFailureLogState.clearForTest(); - } - @AfterEach - void resetState() { - StartupFailureLogState.clearForTest(); + void stopContext() { context.stop(); } @@ -44,7 +37,7 @@ class StartupFailureSpringBootLogFilterTest { @Test void dropsDuplicateSpringBootFailureMessagesAfterStartupFailureWasReported() { StartupFailureSpringBootLogFilter filter = startedFilter(); - StartupFailureLogState.markStartupFailureReported(); + StartupFailureLogState.markStartupFailureReported(context); assertThat(decide(filter, "Application run failed")).isEqualTo(FilterReply.DENY); assertThat(decide(filter, "Unable to close ApplicationContext")).isEqualTo(FilterReply.DENY); @@ -53,7 +46,7 @@ class StartupFailureSpringBootLogFilterTest { @Test void dropsContextRefreshCancellationAfterStartupFailureWasReported() { StartupFailureSpringBootLogFilter filter = startedFilter(); - StartupFailureLogState.markStartupFailureReported(); + StartupFailureLogState.markStartupFailureReported(context); assertThat( filter.decide( @@ -69,7 +62,7 @@ class StartupFailureSpringBootLogFilterTest { @Test void dropsFailureAnalysisReporterAfterStartupFailureWasReported() { StartupFailureSpringBootLogFilter filter = startedFilter(); - StartupFailureLogState.markStartupFailureReported(); + StartupFailureLogState.markStartupFailureReported(context); assertThat( filter.decide( @@ -87,7 +80,7 @@ class StartupFailureSpringBootLogFilterTest { @Test void keepsOtherSpringBootMessagesAfterStartupFailureWasReported() { StartupFailureSpringBootLogFilter filter = startedFilter(); - StartupFailureLogState.markStartupFailureReported(); + StartupFailureLogState.markStartupFailureReported(context); assertThat(decide(filter, "Started CaSkeletonApplication")).isEqualTo(FilterReply.NEUTRAL); } @@ -95,7 +88,7 @@ class StartupFailureSpringBootLogFilterTest { @Test void keepsDuplicateMessagesFromOtherLoggers() { StartupFailureSpringBootLogFilter filter = startedFilter(); - StartupFailureLogState.markStartupFailureReported(); + StartupFailureLogState.markStartupFailureReported(context); Logger otherLogger = context.getLogger("dev.caskeleton.bootstrap.runtime.startup"); assertThat( @@ -109,6 +102,19 @@ class StartupFailureSpringBootLogFilterTest { .isEqualTo(FilterReply.NEUTRAL); } + @Test + void startupFailureMarkerIsIsolatedPerLoggerContext() { + LoggerContext otherContext = new LoggerContext(); + try { + StartupFailureLogState.markStartupFailureReported(context); + + assertThat(StartupFailureLogState.startupFailureReported(context)).isTrue(); + assertThat(StartupFailureLogState.startupFailureReported(otherContext)).isFalse(); + } finally { + otherContext.stop(); + } + } + private StartupFailureSpringBootLogFilter startedFilter() { StartupFailureSpringBootLogFilter filter = new StartupFailureSpringBootLogFilter(); filter.setContext(context); diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/BootstrapStructuredRuntimeLoggingTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/BootstrapStructuredRuntimeLoggingTest.java new file mode 100644 index 00000000..caa5bd8e --- /dev/null +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/BootstrapStructuredRuntimeLoggingTest.java @@ -0,0 +1,158 @@ +package dev.caskeleton.bootstrap.runtime; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.when; + +import ch.qos.logback.classic.Level; +import ch.qos.logback.classic.Logger; +import ch.qos.logback.classic.LoggerContext; +import ch.qos.logback.classic.spi.ILoggingEvent; +import ch.qos.logback.core.read.ListAppender; +import dev.caskeleton.application.fileserver.cleanup.CleanupBatchResult; +import dev.caskeleton.application.fileserver.cleanup.CleanupService; +import dev.caskeleton.application.lock.DistributedLock; +import dev.caskeleton.application.lock.DistributedLockPort; +import dev.caskeleton.application.outbox.PublishPendingOutboxEventsCommand; +import dev.caskeleton.application.outbox.PublishPendingOutboxEventsUseCase; +import dev.caskeleton.bootstrap.autoconfigure.fileserver.FileserverCleanupWorker; +import dev.caskeleton.bootstrap.autoconfigure.lock.MeteredDistributedLockPort; +import dev.caskeleton.bootstrap.autoconfigure.outbox.OutboxMetrics; +import dev.caskeleton.bootstrap.autoconfigure.outbox.OutboxRelayScheduler; +import io.micrometer.core.instrument.MeterRegistry; +import java.time.Clock; +import java.time.Duration; +import java.util.Arrays; +import java.util.ConcurrentModificationException; +import java.util.stream.Collectors; +import org.junit.jupiter.api.Test; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.ObjectProvider; +import org.springframework.beans.factory.support.DefaultListableBeanFactory; + +class BootstrapStructuredRuntimeLoggingTest { + + @Test + void fileserverCleanupSuccessCarriesBoundedOutcomeFields() { + CleanupService cleanup = (maxItems, maxBytes) -> new CleanupBatchResult(1, 2, 3, 4, 5L); + + try (CapturedLogger captured = capture(FileserverCleanupWorker.class)) { + new FileserverCleanupWorker(cleanup, 10, 1_024L).runBatch(); + + ILoggingEvent event = captured.singleEvent(); + assertThat(event.getLevel()).isEqualTo(Level.INFO); + assertThat(event.getFormattedMessage()).contains("deleted=1").contains("reclaimedBytes=5"); + assertThat(renderedArguments(event)) + .contains("capability=fileserver") + .contains("operation=cleanup") + .contains("cleanup.deleted=1") + .contains("cleanup.failed=4") + .contains("cleanup.reclaimed_bytes=5"); + } + } + + @Test + void fileserverCleanupFailureCarriesRetryDisposition() { + CleanupService cleanup = + (maxItems, maxBytes) -> { + throw new IllegalStateException("storage unavailable"); + }; + + try (CapturedLogger captured = capture(FileserverCleanupWorker.class)) { + new FileserverCleanupWorker(cleanup, 10, 1_024L).runBatch(); + + ILoggingEvent event = captured.singleEvent(); + assertThat(event.getLevel()).isEqualTo(Level.WARN); + assertThat(renderedArguments(event)) + .contains("capability=fileserver") + .contains("operation=cleanup") + .contains("warning.kind=scheduled-task-failed") + .contains("retry.disposition=next-run"); + assertThat(event.getThrowableProxy()).isNotNull(); + } + } + + @Test + void outboxRelayUnexpectedFailureCarriesNextTickDispositionWithoutInventedErrorCode() { + PublishPendingOutboxEventsUseCase relay = mock(PublishPendingOutboxEventsUseCase.class); + OutboxMetrics metrics = mock(OutboxMetrics.class); + when(relay.handle(PublishPendingOutboxEventsCommand.INSTANCE)) + .thenThrow(new IllegalStateException("unexpected")); + + try (CapturedLogger captured = capture(OutboxRelayScheduler.class)) { + new OutboxRelayScheduler(relay, metrics, Clock.systemUTC()).relay(); + + ILoggingEvent event = captured.singleEvent(); + assertThat(event.getLevel()).isEqualTo(Level.ERROR); + String arguments = renderedArguments(event); + assertThat(arguments) + .contains("capability=outbox") + .contains("operation=relay") + .contains("retry.disposition=next-tick") + .doesNotContain("error.code="); + assertThat(event.getThrowableProxy()).isNotNull(); + } + } + + @Test + void leaseExpiryWarningCarriesBoundedClassificationWithoutStructuredLockKey() { + DistributedLock expiringHandle = + () -> { + throw new ConcurrentModificationException("lease expired"); + }; + DistributedLockPort delegate = (key, waitTime, leaseTtl) -> expiringHandle; + + try (CapturedLogger captured = capture(MeteredDistributedLockPort.class)) { + MeteredDistributedLockPort port = + new MeteredDistributedLockPort(delegate, absentMeterRegistry()); + DistributedLock lock = + port.tryAcquire("customer:unbounded-123", Duration.ofSeconds(1), Duration.ofSeconds(10)); + lock.close(); + + ILoggingEvent event = captured.singleEvent(); + assertThat(event.getLevel()).isEqualTo(Level.WARN); + assertThat(event.getFormattedMessage()).contains("customer:unbounded-123"); + assertThat(renderedArguments(event)) + .contains("capability=distributed-lock") + .contains("warning.kind=lease-expired-before-close") + .doesNotContain("lock.key="); + assertThat(event.getThrowableProxy()).isNotNull(); + } + } + + private static ObjectProvider absentMeterRegistry() { + return new DefaultListableBeanFactory().getBeanProvider(MeterRegistry.class); + } + + private static CapturedLogger capture(Class owner) { + Logger logger = (Logger) LoggerFactory.getLogger(owner); + ListAppender appender = new ListAppender<>(); + appender.setContext((LoggerContext) LoggerFactory.getILoggerFactory()); + appender.start(); + logger.addAppender(appender); + return new CapturedLogger(logger, appender); + } + + private static String renderedArguments(ILoggingEvent event) { + Object[] arguments = event.getArgumentArray(); + if (arguments == null) { + return ""; + } + return Arrays.stream(arguments).map(String::valueOf).collect(Collectors.joining(" | ")); + } + + private record CapturedLogger(Logger logger, ListAppender appender) + implements AutoCloseable { + + ILoggingEvent singleEvent() { + assertThat(appender.list).hasSize(1); + return appender.list.get(0); + } + + @Override + public void close() { + logger.detachAppender(appender); + appender.stop(); + } + } +} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/OperationalContractRuntimeTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/OperationalContractRuntimeTest.java index 27f2b1b0..f0b05583 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/OperationalContractRuntimeTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/OperationalContractRuntimeTest.java @@ -8,17 +8,27 @@ import static org.springframework.test.web.servlet.result.MockMvcResultMatchers. import dev.caskeleton.adapter.inbound.web.controller.HealthcheckController; import dev.caskeleton.adapter.inbound.web.envelope.EnvelopeBodyAdvice; import dev.caskeleton.adapter.inbound.web.error.GlobalExceptionHandler; +import dev.caskeleton.adapter.inbound.web.filter.CacheControlFilter; +import dev.caskeleton.adapter.inbound.web.filter.RequestLoggingFilter; +import dev.caskeleton.adapter.inbound.web.mvc.autoconfigure.WebMvcPlatformAutoConfiguration; +import dev.caskeleton.adapter.inbound.web.mvc.error.WebMvcProblemExceptionHandler; +import dev.caskeleton.adapter.inbound.web.mvc.filter.WebMvcEvidenceFilter; +import dev.caskeleton.adapter.inbound.web.mvc.filter.WebMvcRequestIdFilter; import dev.caskeleton.adapter.inbound.web.settings.PresentationSettings; import dev.caskeleton.bootstrap.CaSkeletonApplication; import dev.caskeleton.bootstrap.logging.PseudonymizationConfig; import java.util.Map; import org.junit.jupiter.api.Test; import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.ImportAutoConfiguration; import org.springframework.boot.context.properties.EnableConfigurationProperties; +import org.springframework.boot.web.servlet.FilterRegistrationBean; +import org.springframework.boot.web.servlet.ServletContextInitializerBeans; import org.springframework.boot.webmvc.test.autoconfigure.AutoConfigureMockMvc; import org.springframework.boot.webmvc.test.autoconfigure.WebMvcTest; import org.springframework.context.ApplicationContext; import org.springframework.context.annotation.Import; +import org.springframework.core.env.Environment; import org.springframework.test.context.ActiveProfiles; import org.springframework.test.context.TestPropertySource; import org.springframework.test.web.servlet.MockMvc; @@ -41,6 +51,7 @@ import org.springframework.web.bind.annotation.RestController; */ @WebMvcTest(CaSkeletonApplication.class) @AutoConfigureMockMvc(addFilters = false) +@ImportAutoConfiguration(WebMvcPlatformAutoConfiguration.class) // RequestLoggingFilter (a @Component filter the broad CaSkeletonApplication slice scan // instantiates) now requires a UserPrincipalPseudonymizerPort; PseudonymizationConfig supplies it // (and binds PrivacySettings from the test salt) so the slice context can be built. @@ -72,6 +83,8 @@ class OperationalContractRuntimeTest { @Autowired private MockMvc mockMvc; + @Autowired private Environment environment; + @Test void operationalContractBeansAreWiredIntoTheApplicationContext() { assertThat(ctx.getBeansOfType(EnvelopeBodyAdvice.class)) @@ -79,8 +92,47 @@ class OperationalContractRuntimeTest { .isNotEmpty(); assertThat(ctx.getBeansOfType(GlobalExceptionHandler.class)) .as( - "GlobalExceptionHandler must be component-scanned into the CaSkeletonApplication context") + "GlobalExceptionHandler must be component-scanned into the CaSkeletonApplication" + + " context") .isNotEmpty(); + assertThat(environment.getProperty("spring.mvc.problemdetails.enabled", Boolean.class)) + .as("the shipped servlet contract pins Spring problem details off") + .isFalse(); + assertThat(ctx.getBeansOfType(WebMvcProblemExceptionHandler.class)) + .as("the shipped envelope contract must not activate the optional problem-document advice") + .isEmpty(); + } + + @Test + void productionServletFiltersHaveTheDeclaredRelativeOrder() { + java.util.Set> expected = + java.util.Set.of( + WebMvcRequestIdFilter.class, + WebMvcEvidenceFilter.class, + CacheControlFilter.class, + RequestLoggingFilter.class); + Map, Integer> registrationOrders = new java.util.LinkedHashMap<>(); + + for (var initializer : new ServletContextInitializerBeans(ctx)) { + if (initializer instanceof FilterRegistrationBean registration) { + Class filterType = registration.getFilter().getClass(); + if (expected.contains(filterType)) { + registrationOrders.put(filterType, registration.getOrder()); + } + } + } + + assertThat(registrationOrders.keySet()) + .as("Boot must adapt all four production Filter beans into servlet registrations") + .containsExactlyInAnyOrderElementsOf(expected); + assertThat(registrationOrders.get(WebMvcRequestIdFilter.class)) + .isLessThan(registrationOrders.get(WebMvcEvidenceFilter.class)); + assertThat(registrationOrders.get(WebMvcRequestIdFilter.class)) + .isLessThan(registrationOrders.get(CacheControlFilter.class)); + assertThat(registrationOrders.get(WebMvcEvidenceFilter.class)) + .isLessThan(registrationOrders.get(RequestLoggingFilter.class)); + assertThat(registrationOrders.get(CacheControlFilter.class)) + .isLessThan(registrationOrders.get(RequestLoggingFilter.class)); } @Test diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/RuntimeProfileSnapshotTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/RuntimeProfileSnapshotTest.java new file mode 100644 index 00000000..0a1fc1df --- /dev/null +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/RuntimeProfileSnapshotTest.java @@ -0,0 +1,59 @@ +package dev.caskeleton.bootstrap.runtime; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.shared.runtime.RuntimeEnvironment; +import org.junit.jupiter.api.Test; +import org.springframework.mock.env.MockEnvironment; + +class RuntimeProfileSnapshotTest { + + @Test + void capturesProfileOrderAndSupplementaryProfilesWithoutReinterpretingThem() { + MockEnvironment environment = new MockEnvironment(); + environment.setActiveProfiles("prod", "eu-west"); + + RuntimeProfileSnapshot snapshot = RuntimeProfileSnapshot.from(environment); + + assertThat(snapshot.activeProfiles()).containsExactly("prod", "eu-west"); + assertThat(snapshot.environments()).containsExactly(RuntimeEnvironment.PROD); + assertThat(snapshot.resolve()).contains(RuntimeEnvironment.PROD); + assertThat(snapshot.isProduction()).isTrue(); + } + + @Test + void profilelessContextRemainsUnresolvedAndNonProduction() { + RuntimeProfileSnapshot snapshot = RuntimeProfileSnapshot.from(new MockEnvironment()); + + assertThat(snapshot.activeProfiles()).isEmpty(); + assertThat(snapshot.environments()).isEmpty(); + assertThat(snapshot.resolve()).isEmpty(); + assertThat(snapshot.isProduction()).isFalse(); + assertThat(snapshot.isTestContext()).isFalse(); + } + + @Test + void testProfileIsRecognisedButNeverPromotedToADeployableEnvironment() { + MockEnvironment environment = new MockEnvironment(); + environment.setActiveProfiles("test"); + + RuntimeProfileSnapshot snapshot = RuntimeProfileSnapshot.from(environment); + + assertThat(snapshot.isTestContext()).isTrue(); + assertThat(snapshot.resolve()).isEmpty(); + assertThat(snapshot.environments()).isEmpty(); + } + + @Test + void snapshotIsDetachedFromLaterEnvironmentMutation() { + MockEnvironment environment = new MockEnvironment(); + environment.setActiveProfiles("dev"); + RuntimeProfileSnapshot snapshot = RuntimeProfileSnapshot.from(environment); + + environment.setActiveProfiles("prod"); + + assertThat(snapshot.activeProfiles()).containsExactly("dev"); + assertThat(snapshot.resolve()).contains(RuntimeEnvironment.DEV); + assertThat(snapshot.isProduction()).isFalse(); + } +} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/SecretSourceTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/SecretSourceTest.java index 16f7071b..13978e18 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/SecretSourceTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/SecretSourceTest.java @@ -2,19 +2,20 @@ package dev.caskeleton.bootstrap.runtime; import static org.assertj.core.api.Assertions.assertThat; +import dev.caskeleton.adapter.outbound.support.EnvironmentSecretSource; +import dev.caskeleton.application.outbound.SecretSourcePort; import org.junit.jupiter.api.Test; import org.springframework.mock.env.MockEnvironment; /** - * Behaviour pins for the swappable secret backend (feature-secrets-config-source-contract D5): the - * factory selects the default implementation, and the {@link EnvironmentSecretSource} treats blank - * as absent. + * Composition pins for the swappable secret backend: the bootstrap strategy selects a concrete + * outbound adapter, while backend behavior is tested in adapter:outbound:support. */ class SecretSourceTest { @Test void factoryReturnsTheEnvironmentBackendForTheDefaultStrategy() { - SecretSource source = + SecretSourcePort source = SecretSourceFactory.create(SecretSourceStrategy.ENVIRONMENT, new MockEnvironment()); assertThat(source).isInstanceOf(EnvironmentSecretSource.class); @@ -27,21 +28,4 @@ class SecretSourceTest { assertThat(SecretSourceFactory.create(strategy, environment)).isNotNull(); } } - - @Test - void environmentSourceResolvesAPresentSecret() { - MockEnvironment environment = new MockEnvironment().withProperty("APP_X", "value"); - SecretSource source = new EnvironmentSecretSource(environment); - - assertThat(source.resolve("APP_X")).contains("value"); - } - - @Test - void environmentSourceTreatsAbsentAndBlankAsEmpty() { - MockEnvironment environment = new MockEnvironment().withProperty("APP_BLANK", " "); - SecretSource source = new EnvironmentSecretSource(environment); - - assertThat(source.resolve("APP_MISSING")).as("absent → empty").isEmpty(); - assertThat(source.resolve("APP_BLANK")).as("blank → empty (cannot pass presence)").isEmpty(); - } } 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 9ee61d2c..37cbe4f6 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 @@ -26,9 +26,6 @@ class SecretSourceValidatorTest { private static String[] allRequiredSecretsPresent() { return new String[] { "APP_DATASOURCE_PASSWORD=real-db-password", - "APP_SECURITY_JWT_SIGNING_KEY=real-jwt-key", - "APP_SECURITY_OAUTH_CLIENT_SECRET=real-oauth-secret", - "APP_EXTERNAL_API_KEY=real-api-key", "APP_CACHE_REDIS_PASSWORD=real-redis-password", "APP_CACHE_REDIS_KEY_HMAC_SECRET=real-redis-key-hmac-secret", "APP_RATE_LIMIT_REDIS_PASSWORD=real-rate-limit-redis-password", @@ -45,14 +42,37 @@ class SecretSourceValidatorTest { .withInitializer(ctx -> ctx.getEnvironment().setActiveProfiles("prod")) .withPropertyValues(allRequiredSecretsPresent()) // required secrets all present, but one carries the dev sentinel prefix - .withPropertyValues("APP_EXTERNAL_API_KEY=__LOCAL_DEV_FAKE_API_KEY") + .withPropertyValues("APP_DATASOURCE_PASSWORD=__LOCAL_DEV_FAKE_DB_PASSWORD") .run( context -> { assertThat(context).hasFailed(); assertThat(context.getStartupFailure()) .isInstanceOf(StartupValidationException.class) .hasStackTraceContaining("__LOCAL_DEV_") - .hasStackTraceContaining("APP_EXTERNAL_API_KEY"); + .hasStackTraceContaining("APP_DATASOURCE_PASSWORD"); + }); + } + + @Test + void prodReportsSentinelAndMissingSecretInOneStartupFailure() { + String[] baselineSecrets = + Arrays.stream(allRequiredSecretsPresent()) + .filter(value -> !value.startsWith("APP_PRIVACY_PSEUDONYMIZATION_SALT=")) + .toArray(String[]::new); + + runner + .withInitializer(ctx -> ctx.getEnvironment().setActiveProfiles("prod")) + .withPropertyValues(baselineSecrets) + .withPropertyValues("APP_DATASOURCE_PASSWORD=__LOCAL_DEV_FAKE_DB_PASSWORD") + .run( + context -> { + assertThat(context).hasFailed(); + assertThat(context.getStartupFailure()) + .isInstanceOf(StartupValidationException.class) + .hasStackTraceContaining("__LOCAL_DEV_") + .hasStackTraceContaining("APP_DATASOURCE_PASSWORD") + .hasStackTraceContaining("APP_PRIVACY_PSEUDONYMIZATION_SALT") + .hasStackTraceContaining("missing/blank"); }); } diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/StartupSafetyValidatorTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/StartupSafetyValidatorTest.java index c095514b..94178a4f 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/StartupSafetyValidatorTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/StartupSafetyValidatorTest.java @@ -2,7 +2,7 @@ package dev.caskeleton.bootstrap.runtime; import static org.assertj.core.api.Assertions.assertThat; -import dev.caskeleton.bootstrap.runtime.startup.ProfileMismatchException; +import dev.caskeleton.application.lock.DistributedLockPort; import dev.caskeleton.bootstrap.runtime.startup.RequiredAdapterDisabledException; import dev.caskeleton.bootstrap.runtime.startup.StartupFailureException; import dev.caskeleton.bootstrap.settings.RuntimeSafetySettings; @@ -13,86 +13,20 @@ import org.springframework.boot.test.context.assertj.AssertableApplicationContex import org.springframework.boot.test.context.runner.ApplicationContextRunner; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; -import org.springframework.core.env.Environment; /** - * Contract test for the D8 startup fail-fast guard (feature-env-driven-runtime-configuration). - * Pairs with the {@link StartupSafetyValidator} runtime mechanism so a regression in either the - * prod-unsafe-toggle check or the multi-instance bean-presence check fails the build. + * Contract test for the runtime startup safety guard. + * + *

    Only implemented runtime controls belong here. Reserved switches for error-detail exposure and + * HTTP body logging were removed because no shipped code consumed them. */ class StartupSafetyValidatorTest { private final ApplicationContextRunner runner = new ApplicationContextRunner().withUserConfiguration(ValidatorConfig.class); - // ---- prod-unsafe toggles ------------------------------------------------- - @Test - void prodProfileWithErrorDetailExposureEnabledFailsStartup() { - runner - .withInitializer(ctx -> ctx.getEnvironment().setActiveProfiles("prod")) - .withPropertyValues("ca-skeleton.runtime.error-detail-exposure-enabled=true") - .run( - context -> { - assertThat(context).hasFailed(); - assertThat(context.getStartupFailure()) - .hasStackTraceContaining("APP_ERROR_DETAIL_EXPOSURE_ENABLED"); - // feature-migration-startup-contract D7: prod-toggle mismatch exits 71. - StartupFailureException ex = startupFailure(context, ProfileMismatchException.class); - assertThat(ex.getExitCode()).isEqualTo(71); - }); - } - - @Test - void prodProfileWithBodyLoggingEnabledFailsStartup() { - runner - .withInitializer(ctx -> ctx.getEnvironment().setActiveProfiles("prod")) - .withPropertyValues("ca-skeleton.runtime.log-body-capture-enabled=true") - .run( - context -> { - assertThat(context).hasFailed(); - assertThat(context.getStartupFailure()) - .hasStackTraceContaining("APP_LOG_BODY_CAPTURE_ENABLED"); - }); - } - - @Test - void prodProfileWithBothUnsafeTogglesEnabledFailsStartupNamingBoth() { - runner - .withInitializer(ctx -> ctx.getEnvironment().setActiveProfiles("prod")) - .withPropertyValues( - "ca-skeleton.runtime.error-detail-exposure-enabled=true", - "ca-skeleton.runtime.log-body-capture-enabled=true") - .run( - context -> { - assertThat(context).hasFailed(); - assertThat(context.getStartupFailure()) - .hasStackTraceContaining("APP_ERROR_DETAIL_EXPOSURE_ENABLED") - .hasStackTraceContaining("APP_LOG_BODY_CAPTURE_ENABLED"); - }); - } - - @Test - void prodProfileWithAllTogglesOffStartsCleanly() { - runner - .withInitializer(ctx -> ctx.getEnvironment().setActiveProfiles("prod")) - .run(context -> assertThat(context).hasNotFailed()); - } - - @Test - void nonProdProfileWithUnsafeTogglesOnIsAllowed() { - runner - .withInitializer(ctx -> ctx.getEnvironment().setActiveProfiles("local")) - .withPropertyValues( - "ca-skeleton.runtime.error-detail-exposure-enabled=true", - "ca-skeleton.runtime.log-body-capture-enabled=true") - .run(context -> assertThat(context).hasNotFailed()); - } - - // ---- multi-instance bean-presence --------------------------------------- - - @Test - void multiInstanceEnabledWithMissingCoordinationBeansFailsStartup() { + void multiInstanceEnabledWithMissingDistributedLockProviderFailsStartup() { runner .withPropertyValues("ca-skeleton.runtime.multi-instance-enabled=true") .run( @@ -101,7 +35,6 @@ class StartupSafetyValidatorTest { assertThat(context.getStartupFailure()) .hasStackTraceContaining("APP_MULTI_INSTANCE_ENABLED") .hasStackTraceContaining("distributedLockProvider"); - // feature-migration-startup-contract D7: missing required bean exits 72. StartupFailureException ex = startupFailure(context, RequiredAdapterDisabledException.class); assertThat(ex.getExitCode()).isEqualTo(72); @@ -109,27 +42,40 @@ class StartupSafetyValidatorTest { } @Test - void multiInstanceEnabledWithAllCoordinationBeansStartsCleanly() { + void multiInstanceEnabledWithTypedDistributedLockProviderStartsCleanly() { runner .withPropertyValues("ca-skeleton.runtime.multi-instance-enabled=true") - .withUserConfiguration(CoordinationBeans.class) + .withUserConfiguration(DistributedLockBean.class) .run(context -> assertThat(context).hasNotFailed()); } + @Test + void multiInstanceEnabledRejectsANameOnlyPlaceholder() { + runner + .withPropertyValues("ca-skeleton.runtime.multi-instance-enabled=true") + .withUserConfiguration(WrongTypeDistributedLockBean.class) + .run( + context -> { + assertThat(context).hasFailed(); + assertThat(context.getStartupFailure()) + .hasStackTraceContaining("distributedLockProvider") + .hasStackTraceContaining(DistributedLockPort.class.getName()); + }); + } + @Test void multiInstanceDisabledIsAllowed() { runner.run(context -> assertThat(context).hasNotFailed()); } - /** Walks the startup-failure chain to the expected typed exception regardless of wrapping. */ private static StartupFailureException startupFailure( AssertableApplicationContext context, Class type) { - Throwable t = context.getStartupFailure(); - while (t != null && !type.isInstance(t)) { - t = t.getCause(); + Throwable failure = context.getStartupFailure(); + while (failure != null && !type.isInstance(failure)) { + failure = failure.getCause(); } - assertThat(t).isInstanceOf(type); - return (StartupFailureException) t; + assertThat(failure).isInstanceOf(type); + return (StartupFailureException) failure; } @Configuration @@ -137,36 +83,24 @@ class StartupSafetyValidatorTest { static class ValidatorConfig { @Bean StartupSafetyValidator startupSafetyValidator( - Environment environment, RuntimeSafetySettings settings, ListableBeanFactory beanFactory) { - return new StartupSafetyValidator(environment, settings, beanFactory); + RuntimeSafetySettings settings, ListableBeanFactory beanFactory) { + return new StartupSafetyValidator(settings, beanFactory); } } @Configuration - static class CoordinationBeans { + static class DistributedLockBean { + @Bean + DistributedLockPort distributedLockProvider() { + return (key, waitTime, leaseTtl) -> () -> {}; + } + } + + @Configuration + static class WrongTypeDistributedLockBean { @Bean Object distributedLockProvider() { return new Object(); } - - @Bean - Object cacheStampedeProtection() { - return new Object(); - } - - @Bean - Object outboxLeaderElection() { - return new Object(); - } - - @Bean - Object distributedRateLimiter() { - return new Object(); - } - - @Bean - Object migrationStartupRunner() { - return new Object(); - } } } diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/startup/FlywayProdSafetyValidatorTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/startup/FlywayProdSafetyValidatorTest.java index d212d2f6..70c8b0bd 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/startup/FlywayProdSafetyValidatorTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/startup/FlywayProdSafetyValidatorTest.java @@ -13,7 +13,7 @@ import org.springframework.core.env.Environment; * D2 / D4 enforcement (PROFILE_MISMATCH, exit 71): under the {@code prod} profile the Flyway * audit-trail safety nets must stay on — {@code baseline-on-migrate} and {@code out-of-order} * forbidden true, {@code clean-disabled} forbidden false. Enabling any of them under prod is a - * profile/setting conflict and must fail the boot fast (branch-note §2: runtime fail-fast, + * profile/setting conflict and must fail the boot fast (design record §2: runtime fail-fast, * homologous to env-driven {@code validateProdSafety()}). Non-prod keeps the freedom. */ class FlywayProdSafetyValidatorTest { diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/startup/MigrationStartupRunnerTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/startup/MigrationStartupRunnerTest.java index f3b2e120..d4e4eeca 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/startup/MigrationStartupRunnerTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/startup/MigrationStartupRunnerTest.java @@ -34,7 +34,7 @@ import org.springframework.context.SmartLifecycle; class MigrationStartupRunnerTest { private final RuntimeSafetySettings settings = - new RuntimeSafetySettings(false, false, false, true); + new RuntimeSafetySettings(false, true); private final MigrationStartupRunner runner = new MigrationStartupRunner(settings); @Test @@ -107,7 +107,7 @@ class MigrationStartupRunnerTest { @Test void migrateWhenMigrationOnStartupIsFalseBypassesMigrationExecution() { - RuntimeSafetySettings bypassSettings = new RuntimeSafetySettings(false, false, false, false); + RuntimeSafetySettings bypassSettings = new RuntimeSafetySettings(false, false); MigrationStartupRunner bypassRunner = new MigrationStartupRunner(bypassSettings); Flyway flyway = mock(Flyway.class); diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/startup/StartupFailureExceptionReporterTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/startup/StartupFailureExceptionReporterTest.java index a2619b67..a557c495 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/startup/StartupFailureExceptionReporterTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/startup/StartupFailureExceptionReporterTest.java @@ -2,6 +2,7 @@ package dev.caskeleton.bootstrap.runtime.startup; import static org.assertj.core.api.Assertions.assertThat; +import dev.caskeleton.adapter.outbound.support.CapabilityStartupValidationException; import org.junit.jupiter.api.Test; import org.springframework.beans.factory.BeanCreationException; @@ -19,6 +20,16 @@ class StartupFailureExceptionReporterTest { assertThat(reporter.reportException(wrapped)).isTrue(); } + @Test + void reportsWrappedCapabilityStartupValidationAsAlreadyHandled() { + CapabilityStartupValidationException capabilityFailure = + new CapabilityStartupValidationException("invalid HTTP client configuration"); + BeanCreationException wrapped = + new BeanCreationException("httpClientPlatformSettings", "failed", capabilityFailure); + + assertThat(reporter.reportException(wrapped)).isTrue(); + } + @Test void ignoresNonStartupFailuresSoSpringBootCanReportThemNormally() { RuntimeException ordinaryFailure = new RuntimeException("ordinary failure"); diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/startup/StartupFailureExceptionTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/startup/StartupFailureExceptionTest.java index 70357703..f2934043 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/startup/StartupFailureExceptionTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/startup/StartupFailureExceptionTest.java @@ -12,7 +12,7 @@ import org.springframework.boot.ExitCodeGenerator; * SpringBootExceptionHandler} reads {@code getExitCode()} off the failing exception and calls * {@code System.exit(code)} — no {@code main()} change is required (and wrapping main with {@code * System.exit(SpringApplication.exit(run(...)))} would instead close the context and exit 0 on a - * healthy boot, killing a long-running server — see branch-note F2 deviation). + * healthy boot, killing a long-running server — see design record F2 deviation). */ class StartupFailureExceptionTest { diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/startup/StartupOrderContractTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/startup/StartupOrderContractTest.java new file mode 100644 index 00000000..aa3e878e --- /dev/null +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/runtime/startup/StartupOrderContractTest.java @@ -0,0 +1,94 @@ +package dev.caskeleton.bootstrap.runtime.startup; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.bootstrap.activation.CapabilityDependencyEnvironmentValidator; +import dev.caskeleton.bootstrap.activation.MasterSwitchEnvironmentPostProcessor; +import dev.caskeleton.bootstrap.activation.RuntimeEnvironmentProfileValidator; +import dev.caskeleton.bootstrap.autoconfigure.jpa.DatabaseReadinessGroupPostProcessor; +import dev.caskeleton.bootstrap.autoconfigure.redis.RedisReadinessGroupPostProcessor; +import dev.caskeleton.bootstrap.autoconfigure.tracing.TracingSamplingEnvironmentPostProcessor; +import java.io.IOException; +import java.io.InputStream; +import java.util.Arrays; +import java.util.LinkedHashMap; +import java.util.Map; +import java.util.Properties; +import org.junit.jupiter.api.Test; +import org.springframework.boot.EnvironmentPostProcessor; +import org.springframework.boot.context.config.ConfigDataEnvironmentPostProcessor; +import org.springframework.core.Ordered; + +class StartupOrderContractTest { + + @Test + void everyRegisteredEnvironmentPostProcessorHasTheExpectedCentralOrder() throws Exception { + Map expected = + Map.of( + RedisReadinessGroupPostProcessor.class.getName(), StartupOrder.READINESS_REDIS, + DatabaseReadinessGroupPostProcessor.class.getName(), StartupOrder.READINESS_DATABASE, + MasterSwitchEnvironmentPostProcessor.class.getName(), + StartupOrder.MASTER_SWITCH_NORMALISATION, + RuntimeEnvironmentProfileValidator.class.getName(), + StartupOrder.RUNTIME_ENVIRONMENT_PROFILE, + CapabilityDependencyEnvironmentValidator.class.getName(), + StartupOrder.CAPABILITY_DEPENDENCY, + TracingSamplingEnvironmentPostProcessor.class.getName(), StartupOrder.TRACING_SAMPLING); + + Map actual = registeredEnvironmentPostProcessorOrders(); + + assertThat(actual) + .as( + "every EnvironmentPostProcessor registered by app-bootstrap must declare one deliberate " + + "StartupOrder position; adding or removing a processor changes this contract") + .containsExactlyInAnyOrderEntriesOf(expected); + } + + @Test + void readinessBandRunsImmediatelyAfterConfigDataInDeterministicOrder() { + assertThat(StartupOrder.READINESS_REDIS) + .isEqualTo(ConfigDataEnvironmentPostProcessor.ORDER + 1); + assertThat(StartupOrder.READINESS_DATABASE) + .isEqualTo(ConfigDataEnvironmentPostProcessor.ORDER + 2); + assertThat(StartupOrder.READINESS_REDIS).isLessThan(StartupOrder.READINESS_DATABASE); + } + + @Test + void validationAndDefaultingBandIsStrictlyOrdered() { + assertThat(StartupOrder.MASTER_SWITCH_NORMALISATION) + .isLessThan(StartupOrder.RUNTIME_ENVIRONMENT_PROFILE); + assertThat(StartupOrder.RUNTIME_ENVIRONMENT_PROFILE) + .isLessThan(StartupOrder.CAPABILITY_DEPENDENCY); + assertThat(StartupOrder.CAPABILITY_DEPENDENCY).isLessThan(StartupOrder.TRACING_SAMPLING); + assertThat(StartupOrder.TRACING_SAMPLING).isEqualTo(Ordered.LOWEST_PRECEDENCE); + } + + private static Map registeredEnvironmentPostProcessorOrders() throws Exception { + Properties factories = loadAppBootstrapSpringFactories(); + String raw = factories.getProperty(EnvironmentPostProcessor.class.getName(), "").trim(); + + Map orders = new LinkedHashMap<>(); + for (String className : + Arrays.stream(raw.split(",")).map(String::trim).filter(name -> !name.isEmpty()).toList()) { + Class type = Class.forName(className); + assertThat(type) + .as(className + " must implement Ordered rather than inherit an implicit tie") + .isAssignableTo(Ordered.class); + Object instance = type.getDeclaredConstructor().newInstance(); + orders.put(className, ((Ordered) instance).getOrder()); + } + return orders; + } + + private static Properties loadAppBootstrapSpringFactories() throws IOException { + try (InputStream input = + StartupOrderContractTest.class.getResourceAsStream("/META-INF/spring.factories")) { + assertThat(input) + .as("app-bootstrap META-INF/spring.factories must be on the test classpath") + .isNotNull(); + Properties factories = new Properties(); + factories.load(input); + return factories; + } + } +} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/settings/JacksonDeserializationPolicyTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/settings/JacksonDeserializationPolicyTest.java index dc8d9197..1500b2e9 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/settings/JacksonDeserializationPolicyTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/settings/JacksonDeserializationPolicyTest.java @@ -16,7 +16,7 @@ import tools.jackson.databind.cfg.EnumFeature; * Pins the Jackson deserialization policy from {@code feature-boundary-validation-mapping-contract} * B1. * - *

    The branch note records the four switches that protect the request boundary: + *

    The design record records the four switches that protect the request boundary: * *

      *
    • {@code FAIL_ON_UNKNOWN_PROPERTIES=true} diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/settings/JacksonSerializationPolicyTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/settings/JacksonSerializationPolicyTest.java index c7b62846..6a63e60e 100644 --- a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/settings/JacksonSerializationPolicyTest.java +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/settings/JacksonSerializationPolicyTest.java @@ -34,7 +34,7 @@ import tools.jackson.databind.cfg.DateTimeFeature; * application.yml} key would surface here). The second block exercises the wired {@link * ObjectMapper} so a dropped {@code jackson-datatype-jsr310} dependency / missing {@code * JavaTimeModule} registration — which would silently turn {@code OffsetDateTime} into a {@code - * [2026,5,21,...]} array (branch note §엣지·실패·의존) — fails the build instead of leaking at runtime. + * [2026,5,21,...]} array (design record §엣지·실패·의존) — fails the build instead of leaking at runtime. */ class JacksonSerializationPolicyTest { diff --git a/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/settings/WebJsonMapperCompositionTest.java b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/settings/WebJsonMapperCompositionTest.java new file mode 100644 index 00000000..317fccce --- /dev/null +++ b/src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/settings/WebJsonMapperCompositionTest.java @@ -0,0 +1,42 @@ +package dev.caskeleton.bootstrap.settings; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.adapter.inbound.web.mvc.autoconfigure.WebMvcPlatformAutoConfiguration; +import dev.caskeleton.adapter.inbound.web.webflux.autoconfigure.WebFluxPlatformAutoConfiguration; +import org.junit.jupiter.api.Test; +import org.springframework.boot.autoconfigure.AutoConfigurations; +import org.springframework.boot.jackson.autoconfigure.JacksonAutoConfiguration; +import org.springframework.boot.test.context.runner.ReactiveWebApplicationContextRunner; +import org.springframework.boot.test.context.runner.WebApplicationContextRunner; +import tools.jackson.databind.json.JsonMapper; + +/** Pins one Jackson runtime owner for both servlet and reactive web compositions. */ +class WebJsonMapperCompositionTest { + + @Test + void servletCompositionHasExactlyOneJsonMapper() { + new WebApplicationContextRunner() + .withConfiguration( + AutoConfigurations.of( + JacksonAutoConfiguration.class, WebMvcPlatformAutoConfiguration.class)) + .run( + context -> { + assertThat(context).hasNotFailed().hasSingleBean(JsonMapper.class); + assertThat(context).doesNotHaveBean("webStrictObjectMapper"); + }); + } + + @Test + void reactiveCompositionHasExactlyOneJsonMapper() { + new ReactiveWebApplicationContextRunner() + .withConfiguration( + AutoConfigurations.of( + JacksonAutoConfiguration.class, WebFluxPlatformAutoConfiguration.class)) + .run( + context -> { + assertThat(context).hasNotFailed().hasSingleBean(JsonMapper.class); + assertThat(context).doesNotHaveBean("webStrictObjectMapper"); + }); + } +} diff --git a/src/app-bootstrap/src/test/resources/application-test.yml b/src/app-bootstrap/src/test/resources/application-test.yml index 50e378e1..8d829bbf 100644 --- a/src/app-bootstrap/src/test/resources/application-test.yml +++ b/src/app-bootstrap/src/test/resources/application-test.yml @@ -106,8 +106,6 @@ ca-skeleton: bootstrap: app-name: ca-skeleton-test runtime: - error-detail-exposure-enabled: false - log-body-capture-enabled: false multi-instance-enabled: false presentation: # Empty prefix so the probe controller path resolves without an /api prefix. diff --git a/src/application-core/CLAUDE.md b/src/application-core/CLAUDE.md index d5aea8bf..043d7517 100644 --- a/src/application-core/CLAUDE.md +++ b/src/application-core/CLAUDE.md @@ -5,7 +5,7 @@ - Module ID: `application-core` - Gradle path: `:application-core` - Focused test (derived from Gradle path): `./gradlew :application-core:test --console=plain` -- Runtime baseline: Java 21; repository framework baseline: Spring Boot 4.0.0. +- Runtime baseline: Java 21; repository framework baseline: the Spring Boot 4.x version pinned by the shared version catalog. - Registry SSOT: `src/config/architecture/modules.json`. Package root: `dev.caskeleton.application`. @@ -61,6 +61,7 @@ Package root: `dev.caskeleton.application`. | `command.Command` | Marker for write intents. Plain immutable types built from domain values. | | `query.Query` | Marker for read intents. Plain immutable types built from domain values. | | `transaction.TransactionPort` | Outbound port for join-capable write/read, physical root-only write, and independent write boundaries. Implemented by `adapter-persistence`. | +| `outbound.SecretSourcePort` | Framework-free outbound secret-resolution seam. Deployment selects a backend in app-bootstrap; concrete environment/cloud/vault readers belong to outbound adapter leaves. | | `transaction.NestedRootTransactionRejectedException` | Fail-fast signal raised before action/provider side effects when `inRootWrite` detects an actual ambient transaction. | | `transaction.TransactionMode` | `WRITE` / `READ_ONLY` / `REQUIRES_NEW`. `NESTED` and `NEVER` are intentionally absent. | | `transaction.Isolation` | `READ_COMMITTED` (pinned default) / `REPEATABLE_READ` / `SERIALIZABLE`. `READ_UNCOMMITTED` is forbidden (not declared); the vendor default is never used (engine defaults differ — PostgreSQL READ COMMITTED vs MySQL InnoDB REPEATABLE READ). Routing the stricter levels through `TransactionPort` is a `planned` joint change with `feature-application-port-usecase-contract`; the shipped call path pins `READ_COMMITTED`. | @@ -83,29 +84,6 @@ the two namespaces are zero, enforced by ## Notification R1 application boundary -- `dev.caskeleton.application.notification` owns only framework-free semantic values, code-owned - kind policy, narrow outbound ports, dispatch/receipt/admission/reconciliation orchestration and - writer-cutover command contracts. -- Feature/application code creates a typed `NotificationIntentDraft`; `NotificationPlanPort` - returns the application-owned immutable `NotificationFrozenPlan`, which is the only planning - handoff consumed by append or inline attempt ports. Provider SDK, transport DTO, persistence - entity, compiled adapter binding and raw recipient/template payload types are forbidden here. -- Provider calls run outside database transactions. Dispatch and reconciliation use bounded - claim/authorize/finalize transactions with opaque claim/version/execution tokens; an - `INDETERMINATE` submission is terminal and must not be blindly retried. -- Receipt reduction is order-independent and keeps delivery acceptance monotonic. Only hard bounce - and complaint facts may request technical suppression; consent/unsubscribe policy is outside this - capability. -- Writer-cutover operations that must prove a physical commit use `inRootWrite`. Route/profile - registries are application-owned exact inputs; signed inventory/quiescence verification is - delegated to narrow verifier ports and the persistence operation must enforce locked durable - state/journal invariants. -- This is the R1 application contract proven with fakes. It does not claim PostgreSQL schema/locking, - provider protocol, cryptographic verifier, or runtime wiring qualification; those belong to the - notification/persistence/bootstrap adapters. - -## Notification R1 application boundary - - `dev.caskeleton.application.notification` owns only framework-free semantic values, code-owned kind policy, narrow outbound ports, dispatch/receipt/admission/reconciliation orchestration and writer-cutover command contracts. @@ -256,7 +234,7 @@ The read side has two equally-valid shapes; pick per read, do not force one: ```bash cd src ./gradlew :application-core:test -./gradlew :app-bootstrap:test --tests '*CleanArchitectureTest' +./gradlew :app-bootstrap:architectureTest ``` The messaging types above establish semantic contract R1 only. They do not claim JSON Schema diff --git a/src/application-core/build.gradle b/src/application-core/build.gradle index 35af4c61..48887ba6 100644 --- a/src/application-core/build.gradle +++ b/src/application-core/build.gradle @@ -1,5 +1,6 @@ plugins { id 'ca.java-library' + id 'java-test-fixtures' } // Framework-free application use-case contract. Runtime dependencies are project-only; @@ -8,8 +9,6 @@ plugins { dependencies { implementation project(':shared-contract') - // Property-based verification for bounded object-storage identity and value contracts. - testImplementation libs.jqwik } def messagingApplicationContractQualification = extensions.getByName('strictQualification').register( diff --git a/src/application-core/gradle.lockfile b/src/application-core/gradle.lockfile index e882aefc..d651dd99 100644 --- a/src/application-core/gradle.lockfile +++ b/src/application-core/gradle.lockfile @@ -2,45 +2,45 @@ # Manual edits can break the build and are not advised. # This file is expected to be part of source control. com.github.ben-manes.caffeine:caffeine:3.2.3=redisPolicyContractTestAnnotationProcessor -com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,testAnnotationProcessor -com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor +com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor com.github.spotbugs:spotbugs-annotations:4.10.2=spotbugs com.github.spotbugs:spotbugs:4.10.2=spotbugs com.github.stephenc.jcip:jcip-annotations:1.0-1=spotbugs -com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor -com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor -com.google.auto:auto-common:1.2.2=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor +com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.auto:auto-common:1.2.2=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor com.google.code.findbugs:jsr305:3.0.2=checkstyle,spotbugs com.google.code.gson:gson:2.13.2=spotbugs -com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor com.google.errorprone:error_prone_annotations:2.41.0=spotbugs com.google.errorprone:error_prone_annotations:2.47.0=checkstyle -com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor -com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor -com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor -com.google.guava:guava:33.5.0-jre=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.guava:guava:33.5.0-jre=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor com.google.guava:guava:33.6.0-jre=checkstyle -com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor -com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor -com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor +com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins com.puppycrawl.tools:checkstyle:13.5.0=checkstyle commons-beanutils:commons-beanutils:1.11.0=checkstyle commons-collections:commons-collections:3.2.2=checkstyle commons-io:commons-io:2.21.0=spotbugs info.picocli:picocli:4.7.7=checkstyle -io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor -io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor -javax.inject:javax.inject:1=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor +io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +javax.inject:javax.inject:1=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor jaxen:jaxen:2.0.6=spotbugs net.bytebuddy:byte-buddy:1.17.8=redisPolicyContractTestCompileClasspath,redisPolicyContractTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.jqwik:jqwik-api:1.9.1=redisPolicyContractTestCompileClasspath,redisPolicyContractTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.jqwik:jqwik-engine:1.9.1=redisPolicyContractTestRuntimeClasspath,testRuntimeClasspath -net.jqwik:jqwik-time:1.9.1=redisPolicyContractTestCompileClasspath,redisPolicyContractTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.jqwik:jqwik-web:1.9.1=redisPolicyContractTestCompileClasspath,redisPolicyContractTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.jqwik:jqwik:1.9.1=redisPolicyContractTestCompileClasspath,redisPolicyContractTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +net.jqwik:jqwik-api:1.9.1=redisPolicyContractTestCompileClasspath,redisPolicyContractTestRuntimeClasspath +net.jqwik:jqwik-engine:1.9.1=redisPolicyContractTestRuntimeClasspath +net.jqwik:jqwik-time:1.9.1=redisPolicyContractTestCompileClasspath,redisPolicyContractTestRuntimeClasspath +net.jqwik:jqwik-web:1.9.1=redisPolicyContractTestCompileClasspath,redisPolicyContractTestRuntimeClasspath +net.jqwik:jqwik:1.9.1=redisPolicyContractTestCompileClasspath,redisPolicyContractTestRuntimeClasspath net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs org.antlr:antlr4-runtime:4.13.2=checkstyle org.apache.bcel:bcel:6.12.0=spotbugs @@ -56,7 +56,7 @@ org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle org.apache.xbean:xbean-reflect:3.7=checkstyle -org.apiguardian:apiguardian-api:1.1.2=redisPolicyContractTestCompileClasspath,redisPolicyContractTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.apiguardian:apiguardian-api:1.1.2=redisPolicyContractTestCompileClasspath,redisPolicyContractTestRuntimeClasspath,testCompileClasspath org.assertj:assertj-core:3.27.6=redisPolicyContractTestCompileClasspath,redisPolicyContractTestRuntimeClasspath org.assertj:assertj-core:3.27.7=testCompileClasspath,testRuntimeClasspath org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle @@ -66,7 +66,7 @@ org.codehaus.plexus:plexus-utils:3.3.0=checkstyle org.dom4j:dom4j:2.2.0=spotbugs org.javassist:javassist:3.28.0-GA=checkstyle org.jspecify:jspecify:1.0.0=redisPolicyContractTestAnnotationProcessor,redisPolicyContractTestCompileClasspath -org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,testAnnotationProcessor,testCompileClasspath +org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,testAnnotationProcessor,testCompileClasspath,testFixturesAnnotationProcessor org.junit.jupiter:junit-jupiter-api:6.0.1=redisPolicyContractTestCompileClasspath,redisPolicyContractTestRuntimeClasspath org.junit.jupiter:junit-jupiter-api:6.0.3=testCompileClasspath,testRuntimeClasspath org.junit.jupiter:junit-jupiter-engine:6.0.1=redisPolicyContractTestRuntimeClasspath @@ -91,10 +91,10 @@ org.ow2.asm:asm-commons:9.10.1=spotbugs org.ow2.asm:asm-tree:9.10.1=spotbugs org.ow2.asm:asm-util:9.10.1=spotbugs org.ow2.asm:asm:9.10.1=spotbugs -org.pcollections:pcollections:4.0.1=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor +org.pcollections:pcollections:4.0.1=annotationProcessor,redisPolicyContractTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor org.reflections:reflections:0.10.2=checkstyle org.slf4j:slf4j-api:2.0.18=spotbugs,spotbugsSlf4j org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j org.slf4j:slf4j-simple:2.0.18=checkstyle org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs -empty=compileClasspath,runtimeClasspath +empty=compileClasspath,runtimeClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath diff --git a/src/application-core/src/main/java/dev/caskeleton/application/cache/CacheAsideExecutor.java b/src/application-core/src/main/java/dev/caskeleton/application/cache/CacheAsideExecutor.java index 8eaadd44..9b8c9712 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/cache/CacheAsideExecutor.java +++ b/src/application-core/src/main/java/dev/caskeleton/application/cache/CacheAsideExecutor.java @@ -12,7 +12,11 @@ import java.util.Objects; *

      When optional refresh coordination is enabled, the soft-lease owner refreshes synchronously. * This executor does not schedule an asynchronous stale-while-revalidate task. A valid stale * contender or a valid stale request facing coordination failure returns immediately instead. + * + * @deprecated the shipped runtime does not compose this executor. The algorithm remains available + * as a verified reference, but callers must not assume template-level production support. */ +@Deprecated public final class CacheAsideExecutor { private final CacheAsidePolicy policy; @@ -155,10 +159,6 @@ public final class CacheAsideExecutor { CacheRefreshClaimAttempt attempt = Objects.requireNonNull( refreshCoordinator.newAttempt(), "cache refresh claim attempt must be non-null"); - if (!attempt.usable()) { - throw new IllegalStateException( - "enabled cache refresh coordinator returned an unusable attempt"); - } CacheRefreshClaimOutcome claim = claimWithOneUncertainRetry(key, attempt); if (claim instanceof CacheRefreshClaimOutcome.Contended) { SourceAttempt deferred = staleDeferral(stale, claim); @@ -260,7 +260,7 @@ public final class CacheAsideExecutor { } private boolean shouldCoordinate(StaleCandidate stale, boolean hardMiss) { - if (refreshCoordinator == null || !refreshCoordinator.enabled()) { + if (refreshCoordinator == null) { return false; } return stale != null diff --git a/src/application-core/src/main/java/dev/caskeleton/application/cache/CacheRefreshCoordinationPort.java b/src/application-core/src/main/java/dev/caskeleton/application/cache/CacheRefreshCoordinationPort.java index 0c3b9a56..22f3443e 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/cache/CacheRefreshCoordinationPort.java +++ b/src/application-core/src/main/java/dev/caskeleton/application/cache/CacheRefreshCoordinationPort.java @@ -12,10 +12,6 @@ import java.time.Duration; */ public interface CacheRefreshCoordinationPort { - default boolean enabled() { - return true; - } - CacheRefreshClaimAttempt newAttempt(); CacheRefreshClaimOutcome claim(K key, CacheRefreshClaimAttempt attempt, Duration leaseTimeToLive); diff --git a/src/application-core/src/main/java/dev/caskeleton/application/cache/DisabledCacheRefreshCoordinationPort.java b/src/application-core/src/main/java/dev/caskeleton/application/cache/DisabledCacheRefreshCoordinationPort.java index 726f8144..2cd1c2a5 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/cache/DisabledCacheRefreshCoordinationPort.java +++ b/src/application-core/src/main/java/dev/caskeleton/application/cache/DisabledCacheRefreshCoordinationPort.java @@ -16,11 +16,6 @@ public final class DisabledCacheRefreshCoordinationPort return (DisabledCacheRefreshCoordinationPort) INSTANCE; } - @Override - public boolean enabled() { - return false; - } - @Override public CacheRefreshClaimAttempt newAttempt() { return CacheRefreshClaimAttempt.unavailable(); diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileexport/ExportedFile.java b/src/application-core/src/main/java/dev/caskeleton/application/fileexport/ExportedFile.java index d4a4fc5f..6a7e7972 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileexport/ExportedFile.java +++ b/src/application-core/src/main/java/dev/caskeleton/application/fileexport/ExportedFile.java @@ -1,23 +1,32 @@ package dev.caskeleton.application.fileexport; +import dev.caskeleton.application.filepublication.PublishedFileReference; +import java.util.Objects; + /** - * Immutable receipt for a file written through {@link FileExportPort}. Framework-neutral value - * object (no Spring / IO types) so the application layer stays decoupled from the export backend. + * Legacy receipt for a file written through {@link FileExportPort}. * - * @param fileName the name the file was written under (never null/blank) - * @param path the absolute path the file was written to (never null/blank) + *

      The original contract exposed the server's absolute filesystem path. That made the application + * boundary depend on deployment topology and produced a value that is meaningless for SFTP, NFS + * aliases or clustered storage. The compatibility receipt now carries only an opaque publication + * reference. + * + * @param fileName the logical name the file was written under (never null/blank) + * @param reference an opaque reference that never exposes a filesystem path or provider location * @param byteSize the written file size in bytes (never negative) * @param rowCount the number of data rows written, excluding the header (never negative) + * @deprecated use the streaming {@link + * dev.caskeleton.application.filepublication.FilePublicationPort} contract instead */ -public record ExportedFile(String fileName, String path, long byteSize, long rowCount) { +@Deprecated(forRemoval = true) +public record ExportedFile( + String fileName, PublishedFileReference reference, long byteSize, long rowCount) { public ExportedFile { if (fileName == null || fileName.isBlank()) { throw new IllegalArgumentException("ExportedFile.fileName must be non-null and non-blank"); } - if (path == null || path.isBlank()) { - throw new IllegalArgumentException("ExportedFile.path must be non-null and non-blank"); - } + Objects.requireNonNull(reference, "reference"); if (byteSize < 0) { throw new IllegalArgumentException( "ExportedFile.byteSize must be non-negative, was " + byteSize); diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileexport/FileExportPort.java b/src/application-core/src/main/java/dev/caskeleton/application/fileexport/FileExportPort.java index b0f34395..44b5be76 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileexport/FileExportPort.java +++ b/src/application-core/src/main/java/dev/caskeleton/application/fileexport/FileExportPort.java @@ -3,35 +3,31 @@ package dev.caskeleton.application.fileexport; import java.util.List; /** - * Outbound port for exporting tabular data as a delimited file — the "file server" boundary (a - * stand-in for an NFS mount, shared file server, or SFTP drop). The application layer hands over - * plain strings, so use cases stay decoupled from the export format and the destination filesystem. - * The adapter is selected by configuration ({@code app.file-export}); see the {@code - * adapter:outbound:fileserver} README for the on-disk layout and the CSV-escaping contract. + * Legacy outbound port for exporting already-materialized tabular data as CSV. * - *

      The contract is deliberately domain-neutral: no framework or domain type crosses it. A caller - * supplies a bare {@code fileName}, an optional {@code header} row, and the data {@code rows} as - * lists of already-stringified field values; the adapter owns file placement, RFC-4180 escaping, - * and byte encoding, and returns an {@link ExportedFile} receipt. + *

      This contract requires the caller to materialize every row in memory before the adapter is + * invoked. The replacement {@link dev.caskeleton.application.filepublication.FilePublicationPort} + * streams rows through a {@link dev.caskeleton.application.filepublication.TabularRowProducer} and + * returns an opaque publication reference. + * + * @deprecated use {@link dev.caskeleton.application.filepublication.FilePublicationPort}; this + * compatibility port retains whole-result materialization and will be removed */ +@Deprecated(forRemoval = true) +@SuppressWarnings("removal") public interface FileExportPort { /** * Writes {@code header} + {@code rows} as a CSV file named {@code fileName} under the adapter's - * configured base directory, overwriting any existing file at that name. + * configured base directory. * - *

      Every field is escaped per RFC-4180: a field containing a comma, double-quote, carriage - * return, or line feed is wrapped in double-quotes with embedded quotes doubled. A {@code null} - * field is written as an empty field. The file is UTF-8 encoded. + *

      Every field is escaped per RFC-4180. A {@code null} field is written as an empty field. The + * file is UTF-8 encoded. * - * @param fileName the target file name (not a path); must be non-null and non-blank and must not - * escape the base directory (no path separators that resolve outside it) - * @param header the column names written as the first line; must be non-null (may be empty, in - * which case no header line is written) - * @param rows the data rows, each a list of field values in column order; must be non-null (may - * be empty); individual field values may be {@code null} - * @return an {@link ExportedFile} receipt (file name, absolute path, byte size, row count) - * @throws IllegalArgumentException if {@code fileName} is blank or escapes the base directory + * @param fileName the target logical file name; must be non-null and non-blank + * @param header the column names written as the first line; must be non-null + * @param rows the already-materialized data rows; must be non-null + * @return a legacy receipt containing an opaque reference, byte size and row count */ ExportedFile exportCsv(String fileName, List header, List> rows); } diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/RangeNotSatisfiableException.java b/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/RangeNotSatisfiableException.java deleted file mode 100644 index 5a064438..00000000 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/RangeNotSatisfiableException.java +++ /dev/null @@ -1,34 +0,0 @@ -package dev.caskeleton.application.fileserver.api.error; - -/** - * No requested byte range intersects the current representation. - * - *

      The representation length travels with the failure so the transport can emit the unsatisfiable - * {@code Content-Range} form (an asterisk in place of the range, then a slash and the - * representation length) without re-reading metadata. - */ -public final class RangeNotSatisfiableException extends FileserverException { - - private static final long serialVersionUID = 1L; - - private final long representationLength; - - public RangeNotSatisfiableException( - String message, long representationLength, FileserverFailureContext context) { - super(message, context); - this.representationLength = representationLength; - } - - /** Unsatisfiable range over a representation of {@code representationLength} bytes. */ - public static RangeNotSatisfiableException of(long representationLength) { - return new RangeNotSatisfiableException( - "requested range is not satisfiable", - representationLength, - FileserverFailureContext.of(FileserverErrorCode.RANGE_NOT_SATISFIABLE, false)); - } - - /** Length of the representation the range was evaluated against. */ - public long representationLength() { - return representationLength; - } -} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/ConditionalRequestEvaluator.java b/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/ConditionalRequestEvaluator.java deleted file mode 100644 index e0b8886d..00000000 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/ConditionalRequestEvaluator.java +++ /dev/null @@ -1,13 +0,0 @@ -package dev.caskeleton.application.fileserver.api.transfer; - -/** - * Applies the conditional and range rules in the exact order the design fixes. - * - *

      Order is the contract: {@code If-Match} and {@code If-Unmodified-Since} first, then {@code - * If-None-Match} and {@code If-Modified-Since}, then range parsing, then {@code If-Range}. - */ -public interface ConditionalRequestEvaluator { - - DownloadDecision evaluate( - ConditionalRequest request, FileRepresentation representation, RangeBudget budget); -} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/DefaultConditionalRequestEvaluator.java b/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/DefaultConditionalRequestEvaluator.java deleted file mode 100644 index bfb29740..00000000 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/DefaultConditionalRequestEvaluator.java +++ /dev/null @@ -1,127 +0,0 @@ -package dev.caskeleton.application.fileserver.api.transfer; - -import dev.caskeleton.application.fileserver.api.error.RangeNotSatisfiableException; -import java.time.Instant; -import java.util.List; -import java.util.Optional; - -/** - * The design's response-decision order, implemented once. - * - *

      A mismatched {@code If-Range} silently degrades to the full representation rather than - * failing, because the client's cached validator is simply stale. An unsatisfiable {@code Range} - * still surfaces as {@code 416} so the client learns the real representation length. - */ -public final class DefaultConditionalRequestEvaluator implements ConditionalRequestEvaluator { - - private final HttpRangeResolver rangeResolver; - - public DefaultConditionalRequestEvaluator(HttpRangeResolver rangeResolver) { - this.rangeResolver = rangeResolver; - } - - @Override - public DownloadDecision evaluate( - ConditionalRequest request, FileRepresentation representation, RangeBudget budget) { - if (failsIfMatch(request, representation) || failsIfUnmodifiedSince(request, representation)) { - return DownloadDecision.preconditionFailed(representation); - } - if (matchesIfNoneMatch(request, representation) - || isNotModifiedSince(request, representation)) { - return DownloadDecision.notModified(representation); - } - - boolean bodyExpected = !request.headOnly(); - if (request.range().isEmpty()) { - return DownloadDecision.full(representation, bodyExpected); - } - if (!ifRangeMatches(request, representation)) { - return DownloadDecision.full(representation, bodyExpected); - } - - ResolvedRanges resolved = - rangeResolver.resolve(request.range().get(), representation.length(), budget); - if (!resolved.isPartial()) { - return DownloadDecision.full(representation, bodyExpected); - } - return DownloadDecision.partial(representation, resolved.ranges(), bodyExpected); - } - - /** - * {@code If-Match} guards a lost update; a wildcard always matches an existing representation. - */ - private static boolean failsIfMatch( - ConditionalRequest request, FileRepresentation representation) { - Optional ifMatch = request.ifMatch(); - if (ifMatch.isEmpty()) { - return false; - } - String value = ifMatch.get().trim(); - if ("*".equals(value)) { - return false; - } - return !containsStrongEtag(value, representation.strongEtag()); - } - - private static boolean failsIfUnmodifiedSince( - ConditionalRequest request, FileRepresentation representation) { - return request.ifUnmodifiedSince().isPresent() - && representation.lastModified().isAfter(request.ifUnmodifiedSince().get()); - } - - private static boolean matchesIfNoneMatch( - ConditionalRequest request, FileRepresentation representation) { - Optional ifNoneMatch = request.ifNoneMatch(); - if (ifNoneMatch.isEmpty()) { - return false; - } - String value = ifNoneMatch.get().trim(); - return "*".equals(value) || containsStrongEtag(value, representation.strongEtag()); - } - - /** - * {@code If-Modified-Since} is only consulted when no entity tag was supplied. - * - *

      An entity tag is the stronger validator, so honouring both would let a coarse timestamp - * override it. - */ - private static boolean isNotModifiedSince( - ConditionalRequest request, FileRepresentation representation) { - if (request.ifNoneMatch().isPresent() || request.ifModifiedSince().isEmpty()) { - return false; - } - Instant since = request.ifModifiedSince().get(); - return !representation.lastModified().isAfter(since); - } - - private static boolean ifRangeMatches( - ConditionalRequest request, FileRepresentation representation) { - Optional ifRange = request.ifRange(); - return ifRange.isEmpty() - || containsStrongEtag(ifRange.get().trim(), representation.strongEtag()); - } - - /** - * Compares against a strong validator list. - * - *

      A weak entity tag never satisfies a range or update precondition, so the {@code W/} form is - * deliberately not accepted here. - */ - private static boolean containsStrongEtag(String headerValue, String strongEtag) { - for (String candidate : List.of(headerValue.split(","))) { - String trimmed = candidate.trim(); - if (trimmed.startsWith("W/")) { - continue; - } - if (trimmed.equals(strongEtag)) { - return true; - } - } - return false; - } - - /** Re-exposes the unsatisfiable-range failure type so adapters do not import the resolver. */ - public static long representationLengthOf(RangeNotSatisfiableException exception) { - return exception.representationLength(); - } -} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/DownloadDecision.java b/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/DownloadDecision.java deleted file mode 100644 index 0c403db1..00000000 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/DownloadDecision.java +++ /dev/null @@ -1,51 +0,0 @@ -package dev.caskeleton.application.fileserver.api.transfer; - -import dev.caskeleton.application.fileserver.api.ByteRange; -import java.util.List; -import java.util.Objects; - -/** - * The framework-neutral outcome of evaluating one download request. - * - *

      MVC, WebFlux, and the Nginx delegation path all render this same decision, which is what makes - * their status codes and headers provably identical. - */ -public record DownloadDecision( - int status, List ranges, FileRepresentation representation, boolean bodyExpected) { - - public DownloadDecision { - Objects.requireNonNull(ranges, "ranges"); - Objects.requireNonNull(representation, "representation"); - if (status < 100 || status > 599) { - throw new IllegalArgumentException("status must be a valid HTTP status code"); - } - ranges = List.copyOf(ranges); - } - - public static DownloadDecision full(FileRepresentation representation, boolean bodyExpected) { - return new DownloadDecision(200, List.of(), representation, bodyExpected); - } - - public static DownloadDecision partial( - FileRepresentation representation, List ranges, boolean bodyExpected) { - return new DownloadDecision(206, ranges, representation, bodyExpected); - } - - public static DownloadDecision notModified(FileRepresentation representation) { - return new DownloadDecision(304, List.of(), representation, false); - } - - public static DownloadDecision preconditionFailed(FileRepresentation representation) { - return new DownloadDecision(412, List.of(), representation, false); - } - - /** Number of bytes the body will carry; zero when no body is expected. */ - public long contentLength() { - if (!bodyExpected) { - return 0; - } - return ranges.isEmpty() - ? representation.length() - : ranges.stream().mapToLong(ByteRange::length).sum(); - } -} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/FileRepresentation.java b/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/FileRepresentation.java deleted file mode 100644 index 1d674f73..00000000 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/FileRepresentation.java +++ /dev/null @@ -1,23 +0,0 @@ -package dev.caskeleton.application.fileserver.api.transfer; - -import java.time.Instant; -import java.util.Objects; - -/** - * The current representation a conditional request is evaluated against. - * - *

      {@code lastModified} is the metadata publication instant, never a filesystem timestamp: on a - * network filesystem the latter is not authoritative. - */ -public record FileRepresentation( - String strongEtag, Instant lastModified, long length, String mediaType) { - - public FileRepresentation { - Objects.requireNonNull(strongEtag, "strongEtag"); - Objects.requireNonNull(lastModified, "lastModified"); - Objects.requireNonNull(mediaType, "mediaType"); - if (length < 0) { - throw new IllegalArgumentException("length must not be negative"); - } - } -} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/HttpRangeResolver.java b/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/HttpRangeResolver.java deleted file mode 100644 index e90099e2..00000000 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/HttpRangeResolver.java +++ /dev/null @@ -1,13 +0,0 @@ -package dev.caskeleton.application.fileserver.api.transfer; - -/** - * Parses and normalizes an HTTP {@code Range} header. - * - *

      MVC, WebFlux, and the Nginx delegation path all use this one resolver so their answers cannot - * drift apart. Suffix and open-ended forms are resolved against the current representation length - * before anything downstream sees them. - */ -public interface HttpRangeResolver { - - ResolvedRanges resolve(String rangeHeader, long representationLength, RangeBudget budget); -} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/RangeBudget.java b/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/RangeBudget.java deleted file mode 100644 index a255f180..00000000 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/RangeBudget.java +++ /dev/null @@ -1,48 +0,0 @@ -package dev.caskeleton.application.fileserver.api.transfer; - -/** - * Ceiling on what one Range request may ask for. - * - *

      The budget is what turns a range request into a bounded operation: without a cap on the number - * of ranges and on the total requested bytes, a single request can amplify into far more work than - * the representation itself. - */ -public record RangeBudget(int maxRanges, long maxTotalBytes, boolean mergeOverlaps) { - - private static final int DESIGN_MAX_RANGES = 8; - - public RangeBudget { - if (maxRanges < 1 || maxRanges > DESIGN_MAX_RANGES) { - throw new IllegalArgumentException("maxRanges must be between 1 and 8"); - } - if (maxTotalBytes <= 0) { - throw new IllegalArgumentException("maxTotalBytes must be positive"); - } - } - - /** Public default: exactly one range per request, still bounded in bytes. */ - public static RangeBudget single(long maxTotalBytes) { - return new RangeBudget(1, maxTotalBytes, false); - } - - /** - * One range per request with no byte ceiling. - * - *

      For call sites that genuinely have no budget to enforce — a contract test, or a caller that - * bounds the response some other way. A deployment profile should use {@link #single(long)}: a - * configured byte limit that only applies once multi-range is switched on is a limit almost - * nobody has. - */ - public static RangeBudget unbounded() { - return new RangeBudget(1, Long.MAX_VALUE, false); - } - - /** Opt-in multi-range profile with overlap merging, capped at the design maximum. */ - public static RangeBudget multi(int maxRanges, long maxTotalBytes) { - return new RangeBudget(maxRanges, maxTotalBytes, true); - } - - public boolean allowsMultipleRanges() { - return maxRanges > 1; - } -} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/UploadProtocol.java b/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/UploadProtocol.java deleted file mode 100644 index 5df945e4..00000000 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/transfer/UploadProtocol.java +++ /dev/null @@ -1,16 +0,0 @@ -package dev.caskeleton.application.fileserver.api.transfer; - -/** - * Wire protocol that created and drives an upload resource. - * - *

      The protocol is recorded on the session so offset, expiry, and termination semantics stay - * bound to the contract the client actually spoke. Stable and experimental protocols never share a - * value. - */ -public enum UploadProtocol { - RAW, - MULTIPART, - BATCH, - TUS_1_0, - HTTPBIS_DRAFT12 -} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/DownloadDescriptor.java b/src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/DownloadDescriptor.java deleted file mode 100644 index 2aa53ad8..00000000 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/DownloadDescriptor.java +++ /dev/null @@ -1,62 +0,0 @@ -package dev.caskeleton.application.fileserver.download; - -import dev.caskeleton.application.fileserver.api.ByteRange; -import dev.caskeleton.application.fileserver.api.ContentKey; -import dev.caskeleton.application.fileserver.api.FileId; -import dev.caskeleton.application.fileserver.api.transfer.FileRepresentation; -import java.util.List; -import java.util.Objects; - -/** - * Everything a transport needs to render one download, and nothing more. - * - *

      MVC, WebFlux, and the Nginx delegation path all render this same value, which is what makes - * their status codes and headers provably identical. The content key is present because the - * transport has to open or delegate the bytes; it is never written into a response header by this - * layer. - */ -public record DownloadDescriptor( - FileId fileId, - int status, - FileRepresentation representation, - List ranges, - ContentKey contentKey, - String contentDisposition, - String cacheControl, - boolean bodyExpected) { - - public DownloadDescriptor { - Objects.requireNonNull(fileId, "fileId"); - Objects.requireNonNull(representation, "representation"); - Objects.requireNonNull(ranges, "ranges"); - Objects.requireNonNull(contentKey, "contentKey"); - Objects.requireNonNull(contentDisposition, "contentDisposition"); - Objects.requireNonNull(cacheControl, "cacheControl"); - if (status < 100 || status > 599) { - throw new IllegalArgumentException("status must be a valid HTTP status code"); - } - ranges = List.copyOf(ranges); - } - - public boolean isPartial() { - return status == 206; - } - - /** The single range a {@code 206} answers with; only defined for a partial descriptor. */ - public ByteRange singleRange() { - if (ranges.size() != 1) { - throw new IllegalStateException("descriptor does not carry exactly one range"); - } - return ranges.get(0); - } - - /** Bytes the body will carry; zero whenever no body is expected (HEAD, 304, 412). */ - public long contentLength() { - if (!bodyExpected) { - return 0; - } - return ranges.isEmpty() - ? representation.length() - : ranges.stream().mapToLong(ByteRange::length).sum(); - } -} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/DownloadPolicy.java b/src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/DownloadPolicy.java deleted file mode 100644 index 9b7e5e88..00000000 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/DownloadPolicy.java +++ /dev/null @@ -1,27 +0,0 @@ -package dev.caskeleton.application.fileserver.download; - -import dev.caskeleton.application.fileserver.api.transfer.RangeBudget; -import java.util.Objects; - -/** - * Bounded download policy values the decision needs. - * - *

      The starter binds these from properties so the application layer never reads configuration - * itself. {@code cacheControl} defaults to the private profile because an authorized download of a - * tenant object must not become a shared-cache entry. - */ -public record DownloadPolicy(RangeBudget rangeBudget, String cacheControl, boolean inlineAllowed) { - - public DownloadPolicy { - Objects.requireNonNull(rangeBudget, "rangeBudget"); - Objects.requireNonNull(cacheControl, "cacheControl"); - if (cacheControl.isBlank()) { - throw new IllegalArgumentException("cacheControl must be non-blank"); - } - } - - /** Design default: single Range, {@code private, no-store}, attachment only. */ - public static DownloadPolicy standard() { - return new DownloadPolicy(RangeBudget.unbounded(), "private, no-store", false); - } -} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/DownloadRequest.java b/src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/DownloadRequest.java deleted file mode 100644 index 5bf382cf..00000000 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/DownloadRequest.java +++ /dev/null @@ -1,26 +0,0 @@ -package dev.caskeleton.application.fileserver.download; - -import dev.caskeleton.application.fileserver.api.FileId; -import dev.caskeleton.application.fileserver.api.transfer.ConditionalRequest; -import java.util.Objects; - -/** - * Transport-neutral download intent. - * - *

      {@code inlineRequested} is only ever a hint: the disposition factory still downgrades a - * scriptable media type to an attachment, so a caller cannot talk the server into serving stored - * HTML inline. - */ -public record DownloadRequest( - FileId fileId, ConditionalRequest conditional, boolean inlineRequested) { - - public DownloadRequest { - Objects.requireNonNull(fileId, "fileId"); - Objects.requireNonNull(conditional, "conditional"); - } - - /** Unconditional attachment GET of the whole representation. */ - public static DownloadRequest of(FileId fileId) { - return new DownloadRequest(fileId, ConditionalRequest.plainGet(), false); - } -} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/lease/LeaseWatchdog.java b/src/application-core/src/main/java/dev/caskeleton/application/lease/LeaseWatchdog.java index eee38236..83eca45b 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/lease/LeaseWatchdog.java +++ b/src/application-core/src/main/java/dev/caskeleton/application/lease/LeaseWatchdog.java @@ -21,7 +21,11 @@ import java.util.function.Consumer; * *

      A watchdog reduces duplicate work only. It does not remove process pauses, Redis failover, or * the requirement for a correctness authority at the protected resource. + * + * @deprecated the shipped runtime does not compose this scheduler. Keep it as a verified reference + * only unless an application explicitly owns its lifecycle and integration. */ +@Deprecated public final class LeaseWatchdog implements AutoCloseable { private static final int MAXIMUM_WORKERS = 32; diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/Channel.java b/src/application-core/src/main/java/dev/caskeleton/application/notification/Channel.java deleted file mode 100644 index 7d56a0fd..00000000 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/Channel.java +++ /dev/null @@ -1,13 +0,0 @@ -package dev.caskeleton.application.notification; - -/** - * Notification channel discriminator — identifies the delivery medium (e.g. email, Slack) - * independently of the provider. The adapter resolves the provider list via {@code - * app.notification.routes..}. See README. - */ -public enum Channel { - /** Electronic mail channel. */ - EMAIL, - /** Slack messaging channel. */ - SLACK -} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/IngestProviderCallbackApplicationUseCase.java b/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/IngestProviderCallbackApplicationUseCase.java deleted file mode 100644 index 0c484487..00000000 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/IngestProviderCallbackApplicationUseCase.java +++ /dev/null @@ -1,164 +0,0 @@ -package dev.caskeleton.application.notification.platform.callback; - -import dev.caskeleton.application.notification.platform.api.CallbackIngestionResult; -import dev.caskeleton.application.notification.platform.api.CallbackRequest; -import dev.caskeleton.application.notification.platform.api.error.CallbackValidationException; -import dev.caskeleton.application.notification.platform.api.error.FailureCategory; -import dev.caskeleton.application.notification.platform.api.error.NotificationFailureCode; -import dev.caskeleton.application.notification.platform.api.error.NotificationFailureDescriptor; -import dev.caskeleton.application.notification.platform.observation.NotificationMetricName; -import dev.caskeleton.application.notification.platform.observation.NotificationMetricsPort; -import dev.caskeleton.application.notification.platform.observation.NotificationSecurityAuditPort; -import java.time.Clock; -import java.util.ArrayList; -import java.util.List; -import java.util.Map; -import java.util.Objects; -import java.util.Optional; - -/** - * The callback pipeline, in the one order that is safe. - * - *

      Limits, then signature, then one transactional durable append. Projection is a worker's job, - * not this path's: the endpoint promises the provider a fast 2xx once the event is durable, and - * projecting inline broke that promise in both directions — a projector that threw failed a - * callback the provider had already been told was accepted, and a slow projector held the - * provider's connection open while it ran. - * - *

      Appending before projecting is what makes a fast 2xx honest: the provider is told the event is - * safely recorded, and a projector defect becomes a replay problem instead of a lost event. - */ -@dev.caskeleton.application.capability.UseCaseCapability( - transactionMode = dev.caskeleton.application.transaction.TransactionMode.WRITE, - idempotency = dev.caskeleton.application.capability.Idempotency.IDEMPOTENT, - repositoryAccess = dev.caskeleton.application.capability.RepositoryAccess.WRITE_REPOSITORY, - // The ledger append is the write; the callback adapter it consults verifies a signature and may - // fetch a provider certificate, which is an outbound call this use case genuinely makes. - externalOutboundAllowed = true) -@dev.caskeleton.application.security.RequiresPermission("notification-callback:ingest") -public class IngestProviderCallbackApplicationUseCase - implements dev.caskeleton.application.notification.platform.port.in - .IngestProviderCallbackUseCase { - - private final ProviderCallbackAdapterRegistry adapters; - private final ProviderEventLedger ledger; - private final dev.caskeleton.application.transaction.TransactionPort transactions; - private final CallbackPayloadProtectionPort payloadProtection; - private final NotificationSecurityAuditPort securityAudit; - private final NotificationMetricsPort metrics; - private final Clock clock; - - public IngestProviderCallbackApplicationUseCase( - ProviderCallbackAdapterRegistry adapters, - ProviderEventLedger ledger, - dev.caskeleton.application.transaction.TransactionPort transactions, - CallbackPayloadProtectionPort payloadProtection, - NotificationSecurityAuditPort securityAudit, - NotificationMetricsPort metrics, - Clock clock) { - this.adapters = Objects.requireNonNull(adapters, "adapters"); - this.ledger = Objects.requireNonNull(ledger, "ledger"); - this.transactions = Objects.requireNonNull(transactions, "transactions"); - this.payloadProtection = Objects.requireNonNull(payloadProtection, "payloadProtection"); - this.securityAudit = Objects.requireNonNull(securityAudit, "securityAudit"); - this.metrics = Objects.requireNonNull(metrics, "metrics"); - this.clock = Objects.requireNonNull(clock, "clock"); - } - - @Override - public CallbackIngestionResult handle( - dev.caskeleton.application.notification.platform.port.in.IngestProviderCallbackCommand - command) { - Objects.requireNonNull(command, "command"); - return ingest(command.request()); - } - - /** Ingest one callback. */ - @Override - public CallbackIngestionResult ingest(CallbackRequest request) { - Objects.requireNonNull(request, "request"); - - CallbackLimits limits = adapters.limitsFor(request.providerProfileId()); - if (request.bodyLength() > limits.maxBodyBytes()) { - securityAudit.callbackRejectedByLimit(request.providerProfileId(), "BODY_TOO_LARGE"); - throw new CallbackValidationException( - NotificationFailureDescriptor.preDispatch( - NotificationFailureCode.CALLBACK_PAYLOAD_REJECTED, - FailureCategory.CALLBACK_VALIDATION_FAILURE)); - } - if (!limits.acceptsContentType(request.contentType().orElse(null))) { - securityAudit.callbackRejectedByLimit(request.providerProfileId(), "CONTENT_TYPE_REJECTED"); - throw new CallbackValidationException( - NotificationFailureDescriptor.preDispatch( - NotificationFailureCode.CALLBACK_PAYLOAD_REJECTED, - FailureCategory.CALLBACK_VALIDATION_FAILURE)); - } - - ProviderCallbackAdapter adapter = adapters.require(request.providerProfileId()); - // The URL names a provider and the path names a profile, and the two are supplied by the - // caller. Binding them before verification means a caller cannot present one provider's - // callback against another provider's profile and have the platform fetch that provider's - // certificate to check it — which is work, and a lookup, done on an unauthenticated request's - // say-so. - if (!adapter.providerId().equals(request.providerId())) { - securityAudit.callbackRejectedByLimit( - request.providerProfileId(), "PROVIDER_PROFILE_MISMATCH"); - throw new CallbackValidationException( - NotificationFailureDescriptor.preDispatch( - NotificationFailureCode.CALLBACK_PAYLOAD_REJECTED, - FailureCategory.CALLBACK_VALIDATION_FAILURE)); - } - CallbackVerificationResult verification = adapter.verify(request); - if (!verification.valid()) { - // A rejected signature is a security event, not a provider event: writing it to the ledger - // would let anyone who can reach the endpoint fill the delivery history with noise. - securityAudit.callbackSignatureRejected( - request.providerProfileId(), verification.reasonCode()); - throw new CallbackValidationException( - NotificationFailureDescriptor.preDispatch( - NotificationFailureCode.CALLBACK_SIGNATURE_INVALID, - FailureCategory.CALLBACK_VALIDATION_FAILURE)); - } - - List normalized = - adapter.normalize(verification.verifiedCallback().orElseThrow()); - byte[] rawBody = request.body(); - String rawDigest = payloadProtection.digest(rawBody); - byte[] ciphertext = payloadProtection.protectRawPayload(rawBody); - - List events = new ArrayList<>(normalized.size()); - for (NormalizedProviderEvent event : normalized) { - events.add( - new VerifiedProviderEvent( - request.providerProfileId(), - event, - Optional.empty(), - ProviderEventSource.CALLBACK, - true, - clock.instant(), - ciphertext, - rawDigest, - payloadProtection.fingerprint(request.providerProfileId(), event, rawDigest))); - } - - // One write transaction around the whole batch. Appending event by event let a failure part - // way through commit the events before it and lose the rest, and the caller was told nothing - // about the split. - AppendEventResult append = transactions.inWrite(() -> ledger.appendAll(events)); - - // Deliberately not projected here. The endpoint's contract is "durable append, then a fast - // 2xx", and projecting synchronously broke it in both directions: a projector that threw - // failed the callback the provider had already been promised was accepted, and a slow - // projector held the provider's connection open. The events are PENDING and - // ProviderEventReplayWorker drains them. - - metrics.increment( - NotificationMetricName.CALLBACK, - Map.of( - "provider", - request.providerId().value(), - "result", - append.created() ? "APPENDED" : "DUPLICATE")); - return new CallbackIngestionResult(append.newEvents().size(), append.duplicates().size()); - } -} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderCallbackAdapter.java b/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderCallbackAdapter.java deleted file mode 100644 index 76cb0410..00000000 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderCallbackAdapter.java +++ /dev/null @@ -1,18 +0,0 @@ -package dev.caskeleton.application.notification.platform.callback; - -import dev.caskeleton.application.notification.platform.api.CallbackRequest; -import dev.caskeleton.application.notification.platform.api.ProviderId; -import java.util.List; - -/** Provider-specific callback verification and normalization. */ -public interface ProviderCallbackAdapter { - - /** Provider family this adapter handles. */ - ProviderId providerId(); - - /** Verify the signature over the exact received bytes and external URL. */ - CallbackVerificationResult verify(CallbackRequest request); - - /** Translate a verified callback into zero or more stable events. */ - List normalize(VerifiedCallback callback); -} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderCallbackAdapterRegistry.java b/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderCallbackAdapterRegistry.java deleted file mode 100644 index dc3f467e..00000000 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderCallbackAdapterRegistry.java +++ /dev/null @@ -1,13 +0,0 @@ -package dev.caskeleton.application.notification.platform.callback; - -import dev.caskeleton.application.notification.platform.api.ProviderProfileId; - -/** Binds a configured profile to the adapter that speaks its provider protocol. */ -public interface ProviderCallbackAdapterRegistry { - - /** Adapter for a profile, or a configuration failure when none is registered. */ - ProviderCallbackAdapter require(ProviderProfileId profileId); - - /** Limits that apply to a profile's callback endpoint. */ - CallbackLimits limitsFor(ProviderProfileId profileId); -} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/VerifiedCallback.java b/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/VerifiedCallback.java deleted file mode 100644 index 4dcaa6cf..00000000 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/VerifiedCallback.java +++ /dev/null @@ -1,15 +0,0 @@ -package dev.caskeleton.application.notification.platform.callback; - -import dev.caskeleton.application.notification.platform.api.CallbackRequest; -import java.util.Map; -import java.util.Objects; - -/** A callback whose signature has been validated, plus the canonical parameters used to do it. */ -public record VerifiedCallback(CallbackRequest request, Map canonicalParameters) { - - public VerifiedCallback { - Objects.requireNonNull(request, "request"); - canonicalParameters = - Map.copyOf(Objects.requireNonNull(canonicalParameters, "canonicalParameters")); - } -} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/IngestProviderCallbackCommand.java b/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/IngestProviderCallbackCommand.java deleted file mode 100644 index 54347ce5..00000000 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/IngestProviderCallbackCommand.java +++ /dev/null @@ -1,18 +0,0 @@ -package dev.caskeleton.application.notification.platform.port.in; - -import dev.caskeleton.application.command.Command; -import dev.caskeleton.application.notification.platform.api.CallbackRequest; -import java.util.Objects; - -/** - * One provider callback, as a command. - * - * @param request the verified-on-arrival callback request - */ -public record IngestProviderCallbackCommand(CallbackRequest request) implements Command { - - /** Validates the command. */ - public IngestProviderCallbackCommand { - Objects.requireNonNull(request, "request"); - } -} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/IngestProviderCallbackUseCase.java b/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/IngestProviderCallbackUseCase.java deleted file mode 100644 index a73998de..00000000 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/IngestProviderCallbackUseCase.java +++ /dev/null @@ -1,42 +0,0 @@ -package dev.caskeleton.application.notification.platform.port.in; - -import dev.caskeleton.application.notification.platform.api.CallbackIngestionResult; -import dev.caskeleton.application.notification.platform.api.CallbackRequest; -import dev.caskeleton.application.usecase.CommandUseCase; - -/** - * The inbound port a callback endpoint depends on. - * - *

      The MVC controller injected {@code IngestProviderCallbackApplicationUseCase} — a concrete - * application class — so the transport was coupled to an implementation and the platform's - * mandatory use-case fitness gate never saw the entrypoint. That gate is what declares transaction - * mode, repository access, idempotency and whether external outbound calls are permitted; an - * orchestration that does not implement the marker simply is not checked, and nothing noticed - * because the existing ArchUnit rules only inspect types that already implement it. - * - *

      One operation, not four. {@code NotificationOrchestrator} mixes submit, schedule, cancel and - * get on one interface, which makes a class-level capability declaration impossible to state - * honestly: a read and a write cannot share one transaction mode. - */ -public interface IngestProviderCallbackUseCase - extends CommandUseCase { - - /** - * Ingests one verified provider callback. - * - * @param command the callback to ingest - * @return how many events were appended and how many were duplicates - */ - @Override - CallbackIngestionResult handle(IngestProviderCallbackCommand command); - - /** - * Convenience for callers holding a raw request. - * - * @param request the callback - * @return the ingestion result - */ - default CallbackIngestionResult ingest(CallbackRequest request) { - return handle(new IngestProviderCallbackCommand(request)); - } -} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/outbound/SecretSourcePort.java b/src/application-core/src/main/java/dev/caskeleton/application/outbound/SecretSourcePort.java new file mode 100644 index 00000000..151d19d0 --- /dev/null +++ b/src/application-core/src/main/java/dev/caskeleton/application/outbound/SecretSourcePort.java @@ -0,0 +1,21 @@ +package dev.caskeleton.application.outbound; + +import java.util.Optional; + +/** + * Outbound secret-resolution boundary used by application composition and capability adapters. + * + *

      The contract deliberately says nothing about environment variables, Vault, cloud secret + * managers, Spring, or any other backend. A blank value is absent so presence validation cannot be + * bypassed with an empty secret. + */ +public interface SecretSourcePort { + + /** + * Resolves one secret key. + * + * @param key backend-neutral secret key selected by deployment policy + * @return the non-blank value, or empty when the backend has no usable value + */ + Optional resolve(String key); +} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/ClaimedOutboxDelivery.java b/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/ClaimedOutboxDelivery.java index ba9d7cf2..d6819972 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/ClaimedOutboxDelivery.java +++ b/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/ClaimedOutboxDelivery.java @@ -1,35 +1,20 @@ package dev.caskeleton.application.outbox.v2; +import dev.caskeleton.application.messaging.event.ValidatedIntegrationEvent; import java.time.Instant; import java.util.Objects; -/** Immutable message envelope plus the mutable delivery owner handle. */ +/** Exact canonical event plus mutable delivery ownership and immutable DB creation facts. */ public record ClaimedOutboxDelivery( OutboxDeliveryOwner owner, - String eventType, - int eventSchema, - String aggregateType, - String aggregateId, - long aggregateVersion, - int eventOrdinal, - String partitionKey, - String contentType, - String correlationId, - String causationId, - Instant occurredAt, - String payload, - String payloadDigest) { + ValidatedIntegrationEvent event, + Instant eventCreatedAt, + Instant deliveryCreatedAt) { public ClaimedOutboxDelivery { Objects.requireNonNull(owner, "owner"); - Objects.requireNonNull(eventType, "eventType"); - Objects.requireNonNull(aggregateType, "aggregateType"); - Objects.requireNonNull(aggregateId, "aggregateId"); - Objects.requireNonNull(partitionKey, "partitionKey"); - Objects.requireNonNull(contentType, "contentType"); - Objects.requireNonNull(correlationId, "correlationId"); - Objects.requireNonNull(occurredAt, "occurredAt"); - Objects.requireNonNull(payload, "payload"); - Objects.requireNonNull(payloadDigest, "payloadDigest"); + Objects.requireNonNull(event, "event"); + Objects.requireNonNull(eventCreatedAt, "eventCreatedAt"); + Objects.requireNonNull(deliveryCreatedAt, "deliveryCreatedAt"); } } diff --git a/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/NewOutboxEventV2.java b/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/NewOutboxEventV2.java index 5b500afd..aa6b5989 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/NewOutboxEventV2.java +++ b/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/NewOutboxEventV2.java @@ -1,66 +1,70 @@ package dev.caskeleton.application.outbox.v2; -import java.nio.charset.StandardCharsets; -import java.time.Instant; +import dev.caskeleton.application.messaging.event.ValidatedIntegrationEvent; import java.util.Objects; /** - * Immutable outbox event intent pinned before any whole-transaction retry begins. + * Owner-safe V2 append intent. * - *

      The aggregate version plus deterministic event ordinal is the ordering authority. The stable - * partition key is mandatory because this baseline advertises ordered destinations only. + *

      The canonical integration event is the semantic and wire authority. This wrapper exists only + * because the V2 append port returns an owner-safe append receipt; it must not grow a second raw + * event model. */ -public record NewOutboxEventV2( - String eventId, - String aggregateType, - String aggregateId, - long aggregateVersion, - int eventOrdinal, - String eventType, - int eventSchema, - String logicalDestination, - String partitionKey, - String contentType, - String correlationId, - String causationId, - Instant occurredAt, - String payload) { - - private static final int MAXIMUM_PAYLOAD_BYTES = 1024 * 1024; +public record NewOutboxEventV2(ValidatedIntegrationEvent event) { public NewOutboxEventV2 { - requireBounded("event ID", eventId, 64); - requireBounded("aggregate type", aggregateType, 128); - requireBounded("aggregate ID", aggregateId, 256); - if (aggregateVersion < 1) { - throw new IllegalArgumentException("aggregate version must be positive"); - } - if (eventOrdinal < 0 || eventOrdinal > 1023) { - throw new IllegalArgumentException("event ordinal must be between 0 and 1023"); - } - requireBounded("event type", eventType, 256); - if (eventSchema < 1) { - throw new IllegalArgumentException("event schema must be positive"); - } - requireBounded("logical destination", logicalDestination, 256); - requireBounded("partition key", partitionKey, 256); - requireBounded("content type", contentType, 128); - requireBounded("correlation ID", correlationId, 128); - if (causationId != null) { - requireBounded("causation ID", causationId, 128); - } - Objects.requireNonNull(occurredAt, "occurredAt"); - Objects.requireNonNull(payload, "payload"); - if (payload.isBlank() - || payload.getBytes(StandardCharsets.UTF_8).length > MAXIMUM_PAYLOAD_BYTES) { - throw new IllegalArgumentException( - "payload must be non-blank and at most " + MAXIMUM_PAYLOAD_BYTES + " UTF-8 bytes"); - } + Objects.requireNonNull(event, "event"); } - private static void requireBounded(String name, String value, int maximumLength) { - if (value == null || value.isBlank() || value.length() > maximumLength) { - throw new IllegalArgumentException(name + " must contain 1-" + maximumLength + " characters"); - } + public String eventId() { + return event.eventId().value(); + } + + public String aggregateType() { + return event.aggregate().aggregateType(); + } + + public String aggregateId() { + return event.aggregate().aggregateId(); + } + + public long aggregateVersion() { + return event.order().sequence(); + } + + public int eventOrdinal() { + return event.order().eventIndex(); + } + + public String eventType() { + return event.contractId().value(); + } + + public int eventSchema() { + return event.payloadVersion(); + } + + public String logicalDestination() { + return event.logicalDestinationId().value(); + } + + public String partitionKey() { + return event.partitionKeyText(); + } + + public String contentType() { + return event.contentType(); + } + + public String correlationId() { + return event.correlationId(); + } + + public String causationId() { + return event.causationId().orElse(null); + } + + public java.time.Instant occurredAt() { + return event.occurredAt(); } } diff --git a/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/OutboxPublicationAdmissionPort.java b/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/OutboxPublicationAdmissionPort.java new file mode 100644 index 00000000..8013f6ad --- /dev/null +++ b/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/OutboxPublicationAdmissionPort.java @@ -0,0 +1,15 @@ +package dev.caskeleton.application.outbox.v2; + +import java.util.Optional; + +/** Bounded worker admission boundary used before a polling worker claims any database row. */ +public interface OutboxPublicationAdmissionPort { + + Optional tryAcquire(String destination); + + /** One acquired admission slot. Implementations must release the same slot exactly once. */ + @FunctionalInterface + interface Permit { + void release(); + } +} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/OutboxV2RetryPolicy.java b/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/OutboxV2RetryPolicy.java new file mode 100644 index 00000000..8898a6bc --- /dev/null +++ b/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/OutboxV2RetryPolicy.java @@ -0,0 +1,134 @@ +package dev.caskeleton.application.outbox.v2; + +import java.time.DateTimeException; +import java.time.Duration; +import java.time.Instant; +import java.util.Objects; +import java.util.Optional; +import java.util.random.RandomGenerator; + +/** + * Finite automatic-publication budget for the owner-safe V2 polling candidate. + * + *

      Age is anchored to immutable database timestamps, never to the first attempt. Retry scheduling + * is therefore stable across worker restarts and claim churn. + */ +public final class OutboxV2RetryPolicy { + + private static final Duration MAXIMUM_POLICY_DURATION = Duration.ofDays(30); + + private final int maximumAttempts; + private final Duration baseDelay; + private final Duration maximumDelay; + private final Duration maximumAutomaticPublicationAge; + private final Duration sameEventHorizon; + private final Duration publishTimeout; + private final Duration transitionSafetyMargin; + private final RandomGenerator random; + + public OutboxV2RetryPolicy( + int maximumAttempts, + Duration baseDelay, + Duration maximumDelay, + Duration maximumAutomaticPublicationAge, + Duration sameEventHorizon, + Duration publishTimeout, + Duration transitionSafetyMargin, + RandomGenerator random) { + if (maximumAttempts < 1 || maximumAttempts > 100) { + throw new IllegalArgumentException("maximumAttempts must be between 1 and 100"); + } + this.maximumAttempts = maximumAttempts; + this.baseDelay = positiveBounded(baseDelay, "baseDelay"); + this.maximumDelay = positiveBounded(maximumDelay, "maximumDelay"); + if (this.maximumDelay.compareTo(this.baseDelay) < 0) { + throw new IllegalArgumentException("maximumDelay must be greater than or equal to baseDelay"); + } + this.maximumAutomaticPublicationAge = + positiveBounded(maximumAutomaticPublicationAge, "maximumAutomaticPublicationAge"); + this.sameEventHorizon = positiveBounded(sameEventHorizon, "sameEventHorizon"); + this.publishTimeout = positiveBounded(publishTimeout, "publishTimeout"); + this.transitionSafetyMargin = positiveBounded(transitionSafetyMargin, "transitionSafetyMargin"); + this.random = Objects.requireNonNull(random, "random"); + } + + public int maximumAttempts() { + return maximumAttempts; + } + + public Duration publishTimeout() { + return publishTimeout; + } + + public Duration requiredClaimLease() { + try { + return publishTimeout.plus(transitionSafetyMargin); + } catch (ArithmeticException exception) { + throw new IllegalStateException("publication lease budget cannot be represented", exception); + } + } + + public Instant automaticDeadline(ClaimedOutboxDelivery delivery) { + Objects.requireNonNull(delivery, "delivery"); + try { + Instant deliveryDeadline = delivery.deliveryCreatedAt().plus(maximumAutomaticPublicationAge); + Instant sameEventDeadline = delivery.eventCreatedAt().plus(sameEventHorizon); + return deliveryDeadline.isBefore(sameEventDeadline) ? deliveryDeadline : sameEventDeadline; + } catch (DateTimeException | ArithmeticException exception) { + throw new IllegalStateException("outbox automatic deadline cannot be represented", exception); + } + } + + public boolean mayAttempt(ClaimedOutboxDelivery delivery, Instant now) { + Objects.requireNonNull(now, "now"); + return delivery.owner().attempt() <= maximumAttempts + && now.isBefore(automaticDeadline(delivery)); + } + + public Optional nextRetryAt(ClaimedOutboxDelivery delivery, Instant now) { + Objects.requireNonNull(delivery, "delivery"); + Objects.requireNonNull(now, "now"); + if (delivery.owner().attempt() >= maximumAttempts) { + return Optional.empty(); + } + + Instant deadline = automaticDeadline(delivery); + if (!now.isBefore(deadline)) { + return Optional.empty(); + } + + long baseMillis = baseDelay.toMillis(); + long maximumMillis = maximumDelay.toMillis(); + int exponent = Math.min(delivery.owner().attempt() - 1, 30); + long exponentialMillis; + try { + exponentialMillis = Math.multiplyExact(baseMillis, 1L << exponent); + } catch (ArithmeticException overflow) { + exponentialMillis = maximumMillis; + } + exponentialMillis = Math.min(exponentialMillis, maximumMillis); + long jitterMillis = random.nextLong(baseMillis + 1L); + long delayMillis; + try { + delayMillis = Math.min(maximumMillis, Math.addExact(exponentialMillis, jitterMillis)); + } catch (ArithmeticException overflow) { + delayMillis = maximumMillis; + } + + final Instant candidate; + try { + candidate = now.plusMillis(delayMillis); + } catch (DateTimeException | ArithmeticException exception) { + return Optional.empty(); + } + return candidate.isBefore(deadline) ? Optional.of(candidate) : Optional.empty(); + } + + private static Duration positiveBounded(Duration value, String name) { + Objects.requireNonNull(value, name); + if (value.isZero() || value.isNegative() || value.compareTo(MAXIMUM_POLICY_DURATION) > 0) { + throw new IllegalArgumentException(name + " must be positive and at most PT720H"); + } + return value; + } +} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/PublishNextOutboxDeliveryCommand.java b/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/PublishNextOutboxDeliveryCommand.java new file mode 100644 index 00000000..a6164a02 --- /dev/null +++ b/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/PublishNextOutboxDeliveryCommand.java @@ -0,0 +1,17 @@ +package dev.caskeleton.application.outbox.v2; + +import dev.caskeleton.application.command.Command; +import java.time.Duration; + +/** Scheduler command for one bounded owner-safe V2 publication attempt. */ +public record PublishNextOutboxDeliveryCommand( + String destination, String claimOwner, Duration claimLease) implements Command { + + public PublishNextOutboxDeliveryCommand { + new OutboxDeliveryClaimRequest(destination, claimOwner, 1, claimLease); + } + + OutboxDeliveryClaimRequest claimRequest() { + return new OutboxDeliveryClaimRequest(destination, claimOwner, 1, claimLease); + } +} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/PublishNextOutboxDeliveryResult.java b/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/PublishNextOutboxDeliveryResult.java new file mode 100644 index 00000000..14a4abfb --- /dev/null +++ b/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/PublishNextOutboxDeliveryResult.java @@ -0,0 +1,58 @@ +package dev.caskeleton.application.outbox.v2; + +import dev.caskeleton.application.outbox.OutboxPublishOutcome; +import java.time.Instant; +import java.util.Objects; +import java.util.Optional; + +/** One-record relay result. Empty event/outcome fields are used only before a row is claimed. */ +public record PublishNextOutboxDeliveryResult( + Status status, + Optional eventId, + Optional publishOutcome, + Optional transitionOutcome, + Optional nextAttemptAt) { + + public PublishNextOutboxDeliveryResult { + Objects.requireNonNull(status, "status"); + Objects.requireNonNull(eventId, "eventId"); + Objects.requireNonNull(publishOutcome, "publishOutcome"); + Objects.requireNonNull(transitionOutcome, "transitionOutcome"); + Objects.requireNonNull(nextAttemptAt, "nextAttemptAt"); + } + + public static PublishNextOutboxDeliveryResult notAdmitted() { + return empty(Status.NOT_ADMITTED); + } + + public static PublishNextOutboxDeliveryResult noDelivery() { + return empty(Status.NO_DELIVERY); + } + + static PublishNextOutboxDeliveryResult transitioned( + Status status, + ClaimedOutboxDelivery delivery, + OutboxPublishOutcome publishOutcome, + OutboxDeliveryTransitionOutcome transitionOutcome, + Optional nextAttemptAt) { + return new PublishNextOutboxDeliveryResult( + status, + Optional.of(delivery.owner().eventId()), + Optional.of(publishOutcome), + Optional.of(transitionOutcome), + nextAttemptAt); + } + + private static PublishNextOutboxDeliveryResult empty(Status status) { + return new PublishNextOutboxDeliveryResult( + status, Optional.empty(), Optional.empty(), Optional.empty(), Optional.empty()); + } + + public enum Status { + NOT_ADMITTED, + NO_DELIVERY, + PUBLISHED, + RETRY_SCHEDULED, + DEAD + } +} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/PublishNextOutboxDeliveryUseCase.java b/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/PublishNextOutboxDeliveryUseCase.java new file mode 100644 index 00000000..aaaba58f --- /dev/null +++ b/src/application-core/src/main/java/dev/caskeleton/application/outbox/v2/PublishNextOutboxDeliveryUseCase.java @@ -0,0 +1,242 @@ +package dev.caskeleton.application.outbox.v2; + +import dev.caskeleton.application.capability.Idempotency; +import dev.caskeleton.application.capability.RepositoryAccess; +import dev.caskeleton.application.capability.UseCaseCapability; +import dev.caskeleton.application.messaging.event.IntegrationEventPublishPort; +import dev.caskeleton.application.outbox.OutboxPublishOutcome; +import dev.caskeleton.application.security.RequiresPermission; +import dev.caskeleton.application.transaction.OperationId; +import dev.caskeleton.application.transaction.TransactionMode; +import dev.caskeleton.application.transaction.TransactionPort; +import dev.caskeleton.application.usecase.CommandUseCase; +import java.nio.charset.StandardCharsets; +import java.security.MessageDigest; +import java.security.NoSuchAlgorithmException; +import java.time.Clock; +import java.time.Instant; +import java.util.HexFormat; +import java.util.List; +import java.util.Objects; +import java.util.Optional; +import java.util.concurrent.ExecutionException; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.TimeoutException; + +/** + * Unwired owner-safe V2 polling publication policy. One invocation processes at most one record. + */ +@RequiresPermission("outbox:relay") +@UseCaseCapability( + transactionMode = TransactionMode.REQUIRES_NEW, + idempotency = Idempotency.NOT_IDEMPOTENT, + repositoryAccess = RepositoryAccess.WRITE_REPOSITORY, + externalOutboundAllowed = true) +public class PublishNextOutboxDeliveryUseCase + implements CommandUseCase { + + static final String AMBIGUOUS_ERROR = "OUTBOX_PUBLISH_AMBIGUOUS"; + static final String AMBIGUOUS_BUDGET_ERROR = "OUTBOX_AMBIGUOUS_BUDGET_EXHAUSTED"; + static final String BEFORE_SEND_REJECTION = "OUTBOX_REJECTED_BEFORE_SEND"; + static final String AFTER_BROKER_REJECTION = "OUTBOX_REJECTED_AFTER_BROKER"; + static final String DEADLINE_ERROR = "OUTBOX_AUTOMATIC_DEADLINE_EXHAUSTED"; + + private final OutboxPublicationAdmissionPort admission; + private final OutboxPollingDeliveryPortV2 deliveries; + private final IntegrationEventPublishPort publisher; + private final TransactionPort transactions; + private final OutboxV2RetryPolicy retryPolicy; + private final Clock clock; + + public PublishNextOutboxDeliveryUseCase( + OutboxPublicationAdmissionPort admission, + OutboxPollingDeliveryPortV2 deliveries, + IntegrationEventPublishPort publisher, + TransactionPort transactions, + OutboxV2RetryPolicy retryPolicy, + Clock clock) { + this.admission = Objects.requireNonNull(admission, "admission"); + this.deliveries = Objects.requireNonNull(deliveries, "deliveries"); + this.publisher = Objects.requireNonNull(publisher, "publisher"); + this.transactions = Objects.requireNonNull(transactions, "transactions"); + this.retryPolicy = Objects.requireNonNull(retryPolicy, "retryPolicy"); + this.clock = Objects.requireNonNull(clock, "clock"); + } + + @Override + public PublishNextOutboxDeliveryResult handle(PublishNextOutboxDeliveryCommand command) { + Objects.requireNonNull(command, "command"); + if (command.claimLease().compareTo(retryPolicy.requiredClaimLease()) <= 0) { + throw new IllegalArgumentException( + "claimLease must exceed publishTimeout + transitionSafetyMargin"); + } + + Optional admitted = + admission.tryAcquire(command.destination()); + if (admitted.isEmpty()) { + return PublishNextOutboxDeliveryResult.notAdmitted(); + } + + OutboxPublicationAdmissionPort.Permit permit = admitted.orElseThrow(); + try { + List claimed = + transactions.inNew(() -> deliveries.claimBatch(command.claimRequest())); + if (claimed.size() > 1) { + throw new IllegalStateException( + "one-record outbox relay claimed " + claimed.size() + " records"); + } + if (claimed.isEmpty()) { + return PublishNextOutboxDeliveryResult.noDelivery(); + } + + ClaimedOutboxDelivery delivery = claimed.getFirst(); + Instant beforePublish = clock.instant(); + if (!retryPolicy.mayAttempt(delivery, beforePublish)) { + return markDead( + delivery, + OutboxPublishOutcome.AMBIGUOUS, + DEADLINE_ERROR, + PublishNextOutboxDeliveryResult.Status.DEAD); + } + + OutboxPublishOutcome outcome = publish(delivery); + return applyOutcome(delivery, outcome); + } finally { + permit.release(); + } + } + + private OutboxPublishOutcome publish(ClaimedOutboxDelivery delivery) { + try { + return Objects.requireNonNull( + publisher + .publish(delivery.event()) + .toCompletableFuture() + .get(retryPolicy.publishTimeout().toMillis(), TimeUnit.MILLISECONDS), + "publish outcome"); + } catch (InterruptedException interrupted) { + Thread.currentThread().interrupt(); + return OutboxPublishOutcome.AMBIGUOUS; + } catch (ExecutionException | TimeoutException | RuntimeException uncertain) { + return OutboxPublishOutcome.AMBIGUOUS; + } + } + + private PublishNextOutboxDeliveryResult applyOutcome( + ClaimedOutboxDelivery delivery, OutboxPublishOutcome outcome) { + return switch (outcome) { + case CONFIRMED -> markPublished(delivery, outcome); + case AMBIGUOUS -> retryOrDead(delivery, outcome); + case REJECTED_BEFORE_SEND -> + markDead( + delivery, + outcome, + BEFORE_SEND_REJECTION, + PublishNextOutboxDeliveryResult.Status.DEAD); + case REJECTED_AFTER_BROKER -> + markDead( + delivery, + outcome, + AFTER_BROKER_REJECTION, + PublishNextOutboxDeliveryResult.Status.DEAD); + }; + } + + private PublishNextOutboxDeliveryResult retryOrDead( + ClaimedOutboxDelivery delivery, OutboxPublishOutcome outcome) { + Instant now = clock.instant(); + Optional nextAttemptAt = retryPolicy.nextRetryAt(delivery, now); + if (nextAttemptAt.isEmpty()) { + return markDead( + delivery, outcome, AMBIGUOUS_BUDGET_ERROR, PublishNextOutboxDeliveryResult.Status.DEAD); + } + + OutboxDeliveryTransition transition = transition(delivery, "RETRY_WAIT", AMBIGUOUS_ERROR); + OutboxDeliveryTransitionOutcome transitioned = + transactions.inNew( + () -> + deliveries.markRetryable(transition, nextAttemptAt.orElseThrow(), AMBIGUOUS_ERROR)); + requireTransition( + transitioned, OutboxDeliveryTransitionOutcome.RETRY_SCHEDULED, transition.operationId()); + return PublishNextOutboxDeliveryResult.transitioned( + PublishNextOutboxDeliveryResult.Status.RETRY_SCHEDULED, + delivery, + outcome, + transitioned, + nextAttemptAt); + } + + private PublishNextOutboxDeliveryResult markPublished( + ClaimedOutboxDelivery delivery, OutboxPublishOutcome outcome) { + OutboxDeliveryTransition transition = transition(delivery, "PUBLISHED", null); + OutboxDeliveryTransitionOutcome transitioned = + transactions.inNew(() -> deliveries.markPublished(transition)); + requireTransition( + transitioned, OutboxDeliveryTransitionOutcome.PUBLISHED, transition.operationId()); + return PublishNextOutboxDeliveryResult.transitioned( + PublishNextOutboxDeliveryResult.Status.PUBLISHED, + delivery, + outcome, + transitioned, + Optional.empty()); + } + + private PublishNextOutboxDeliveryResult markDead( + ClaimedOutboxDelivery delivery, + OutboxPublishOutcome outcome, + String errorCode, + PublishNextOutboxDeliveryResult.Status status) { + OutboxDeliveryTransition transition = transition(delivery, "DEAD", errorCode); + OutboxDeliveryTransitionOutcome transitioned = + transactions.inNew(() -> deliveries.markDead(transition, errorCode)); + requireTransition(transitioned, OutboxDeliveryTransitionOutcome.DEAD, transition.operationId()); + return PublishNextOutboxDeliveryResult.transitioned( + status, delivery, outcome, transitioned, Optional.empty()); + } + + private static void requireTransition( + OutboxDeliveryTransitionOutcome actual, + OutboxDeliveryTransitionOutcome expected, + OperationId operationId) { + if (actual != expected + && actual != OutboxDeliveryTransitionOutcome.ALREADY_APPLIED_SAME_OPERATION) { + throw new IllegalStateException( + "outbox V2 transition " + + operationId.value() + + " expected " + + expected + + " but was " + + actual); + } + } + + private static OutboxDeliveryTransition transition( + ClaimedOutboxDelivery delivery, String target, String errorCode) { + return new OutboxDeliveryTransition( + delivery.owner(), + operationId(delivery.owner(), target, errorCode == null ? "-" : errorCode)); + } + + static OperationId operationId(OutboxDeliveryOwner owner, String target, String errorCode) { + String material = + owner.eventId() + + "|" + + owner.publicationEpoch() + + "|" + + owner.attempt() + + "|" + + target + + "|" + + errorCode; + try { + String digest = + HexFormat.of() + .formatHex( + MessageDigest.getInstance("SHA-256") + .digest(material.getBytes(StandardCharsets.UTF_8))); + return new OperationId("outbox-v2-" + digest); + } catch (NoSuchAlgorithmException impossible) { + throw new IllegalStateException("SHA-256 unavailable", impossible); + } + } +} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/transaction/IrreversibleSideEffectContext.java b/src/application-core/src/main/java/dev/caskeleton/application/transaction/IrreversibleSideEffectContext.java deleted file mode 100644 index 5826a83e..00000000 --- a/src/application-core/src/main/java/dev/caskeleton/application/transaction/IrreversibleSideEffectContext.java +++ /dev/null @@ -1,43 +0,0 @@ -package dev.caskeleton.application.transaction; - -/** - * Marks that the current attempt performed an effect that cannot be undone by a rollback (design - * §19.2). - * - *

      Database rollback only reverses database work. A use case that sent an email, charged a card, - * published to a broker, or wrote to object storage has already changed the world, and re-running - * it does it twice. A use case that cannot avoid such an effect calls {@link #mark()} before - * performing it; the retry policy then refuses to re-run that attempt no matter what the failure - * was. - * - *

      In application-core because the use case is what calls {@link #mark()}, immediately before the - * effect it cannot undo. While this lived in the persistence adapter, marking an irreversible - * effect required a use case to import that adapter, so the one call site that matters was the one - * the architecture forbade. - * - *

      The right fix is usually to move the effect out of the transaction entirely — the design - * forbids waiting on external calls inside a DB transaction. This flag exists for the cases where - * that refactor has not happened yet, so the unsafe retry is prevented rather than merely - * documented. - */ -public final class IrreversibleSideEffectContext { - - private static final ThreadLocal PERFORMED = new ThreadLocal<>(); - - private IrreversibleSideEffectContext() {} - - /** Declares that this attempt has performed an effect a rollback cannot reverse. */ - public static void mark() { - PERFORMED.set(Boolean.TRUE); - } - - /** Whether the current attempt declared an irreversible effect. */ - public static boolean performed() { - return Boolean.TRUE.equals(PERFORMED.get()); - } - - /** Clears the marker; the retry coordinator calls this between attempts. */ - public static void clear() { - PERFORMED.remove(); - } -} diff --git a/src/application-core/src/test/java/dev/caskeleton/application/cache/CacheAsideExecutorTest.java b/src/application-core/src/test/java/dev/caskeleton/application/cache/CacheAsideExecutorTest.java index 8f1c244d..0e41eefb 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/cache/CacheAsideExecutorTest.java +++ b/src/application-core/src/test/java/dev/caskeleton/application/cache/CacheAsideExecutorTest.java @@ -18,6 +18,7 @@ import java.util.concurrent.atomic.AtomicInteger; import java.util.concurrent.atomic.AtomicReference; import org.junit.jupiter.api.Test; +@SuppressWarnings("deprecation") class CacheAsideExecutorTest { private static final Instant NOW = Instant.parse("2026-07-28T00:00:00Z"); diff --git a/src/application-core/src/test/java/dev/caskeleton/application/cache/CacheRefreshCoordinationContractTest.java b/src/application-core/src/test/java/dev/caskeleton/application/cache/CacheRefreshCoordinationContractTest.java index c56877f9..e7f2ef61 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/cache/CacheRefreshCoordinationContractTest.java +++ b/src/application-core/src/test/java/dev/caskeleton/application/cache/CacheRefreshCoordinationContractTest.java @@ -27,7 +27,6 @@ class CacheRefreshCoordinationContractTest { CacheRefreshCoordinationPort disabled = DisabledCacheRefreshCoordinationPort.instance(); CacheRefreshClaimAttempt attempt = disabled.newAttempt(); - assertThat(disabled.enabled()).isFalse(); assertThat(attempt.usable()).isFalse(); assertThat(disabled.claim("key", attempt, Duration.ofSeconds(10))) .isEqualTo(new CacheRefreshClaimOutcome.Disabled()); diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/transfer/ConditionalRequestEvaluatorTest.java b/src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/transfer/ConditionalRequestEvaluatorTest.java deleted file mode 100644 index c7d20c19..00000000 --- a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/transfer/ConditionalRequestEvaluatorTest.java +++ /dev/null @@ -1,213 +0,0 @@ -package dev.caskeleton.application.fileserver.api.transfer; - -import static org.assertj.core.api.Assertions.assertThat; -import static org.assertj.core.api.Assertions.assertThatThrownBy; - -import dev.caskeleton.application.fileserver.api.ByteRange; -import dev.caskeleton.application.fileserver.api.error.RangeNotSatisfiableException; -import java.time.Instant; -import java.util.Optional; -import org.junit.jupiter.api.Test; - -class ConditionalRequestEvaluatorTest { - - private static final Instant PUBLISHED = Instant.parse("2026-08-07T10:00:00Z"); - - private final ConditionalRequestEvaluator evaluator = - new DefaultConditionalRequestEvaluator(new DefaultHttpRangeResolver()); - - @Test - void mismatchedIfRangeFallsBackToFullResponse() { - DownloadDecision result = - evaluator.evaluate( - requestWithIfRange("\"old\"", "bytes=0-9"), - representation("\"new\"", 100), - RangeBudget.unbounded()); - - assertThat(result.status()).isEqualTo(200); - assertThat(result.ranges()).isEmpty(); - } - - @Test - void matchingIfRangeStillServesThePartialResponse() { - DownloadDecision result = - evaluator.evaluate( - requestWithIfRange("\"new\"", "bytes=0-9"), - representation("\"new\"", 100), - RangeBudget.unbounded()); - - assertThat(result.status()).isEqualTo(206); - assertThat(result.ranges()).containsExactly(new ByteRange(0, 9)); - assertThat(result.contentLength()).isEqualTo(10); - } - - @Test - void ifMatchFailureIsPreconditionFailed() { - DownloadDecision result = - evaluator.evaluate( - conditional(builder -> builder.ifMatch = Optional.of("\"other\"")), - representation("\"current\"", 100), - RangeBudget.unbounded()); - - assertThat(result.status()).isEqualTo(412); - assertThat(result.bodyExpected()).isFalse(); - } - - @Test - void aWildcardIfMatchAlwaysMatchesAnExistingRepresentation() { - DownloadDecision result = - evaluator.evaluate( - conditional(builder -> builder.ifMatch = Optional.of("*")), - representation("\"current\"", 100), - RangeBudget.unbounded()); - - assertThat(result.status()).isEqualTo(200); - } - - @Test - void ifNoneMatchOnTheCurrentValidatorIsNotModified() { - DownloadDecision result = - evaluator.evaluate( - conditional(builder -> builder.ifNoneMatch = Optional.of("\"current\"")), - representation("\"current\"", 100), - RangeBudget.unbounded()); - - assertThat(result.status()).isEqualTo(304); - assertThat(result.contentLength()).isZero(); - } - - @Test - void aWeakValidatorNeverSatisfiesAPrecondition() { - DownloadDecision result = - evaluator.evaluate( - conditional(builder -> builder.ifMatch = Optional.of("W/\"current\"")), - representation("\"current\"", 100), - RangeBudget.unbounded()); - - assertThat(result.status()).isEqualTo(412); - } - - @Test - void ifModifiedSinceIsOnlyConsultedWithoutAnEntityTag() { - DownloadDecision withoutEtag = - evaluator.evaluate( - conditional(builder -> builder.ifModifiedSince = Optional.of(PUBLISHED)), - representation("\"current\"", 100), - RangeBudget.unbounded()); - DownloadDecision withEtag = - evaluator.evaluate( - conditional( - builder -> { - builder.ifModifiedSince = Optional.of(PUBLISHED); - builder.ifNoneMatch = Optional.of("\"stale\""); - }), - representation("\"current\"", 100), - RangeBudget.unbounded()); - - assertThat(withoutEtag.status()).isEqualTo(304); - assertThat(withEtag.status()).isEqualTo(200); - } - - @Test - void ifUnmodifiedSinceRejectsAChangedRepresentation() { - DownloadDecision result = - evaluator.evaluate( - conditional( - builder -> builder.ifUnmodifiedSince = Optional.of(PUBLISHED.minusSeconds(60))), - representation("\"current\"", 100), - RangeBudget.unbounded()); - - assertThat(result.status()).isEqualTo(412); - } - - @Test - void preconditionsAreEvaluatedBeforeCacheValidators() { - DownloadDecision result = - evaluator.evaluate( - conditional( - builder -> { - builder.ifMatch = Optional.of("\"other\""); - builder.ifNoneMatch = Optional.of("\"current\""); - }), - representation("\"current\"", 100), - RangeBudget.unbounded()); - - assertThat(result.status()).isEqualTo(412); - } - - @Test - void headSharesEveryDecisionButCarriesNoBody() { - DownloadDecision get = - evaluator.evaluate( - ConditionalRequest.rangeGet("bytes=2-4"), - representation("\"current\"", 10), - RangeBudget.unbounded()); - DownloadDecision head = - evaluator.evaluate( - conditional( - builder -> { - builder.range = Optional.of("bytes=2-4"); - builder.headOnly = true; - }), - representation("\"current\"", 10), - RangeBudget.unbounded()); - - assertThat(head.status()).isEqualTo(get.status()); - assertThat(head.ranges()).isEqualTo(get.ranges()); - assertThat(head.bodyExpected()).isFalse(); - assertThat(head.contentLength()).isZero(); - } - - @Test - void anUnsatisfiableRangeStillSurfacesAsSixteen() { - assertThatThrownBy( - () -> - evaluator.evaluate( - ConditionalRequest.rangeGet("bytes=500-600"), - representation("\"current\"", 100), - RangeBudget.unbounded())) - .isInstanceOf(RangeNotSatisfiableException.class) - .satisfies( - failure -> - assertThat( - DefaultConditionalRequestEvaluator.representationLengthOf( - (RangeNotSatisfiableException) failure)) - .isEqualTo(100L)); - } - - private static FileRepresentation representation(String etag, long length) { - return new FileRepresentation(etag, PUBLISHED, length, "application/octet-stream"); - } - - private static ConditionalRequest requestWithIfRange(String ifRange, String range) { - return conditional( - builder -> { - builder.ifRange = Optional.of(ifRange); - builder.range = Optional.of(range); - }); - } - - private static ConditionalRequest conditional(java.util.function.Consumer customizer) { - Builder builder = new Builder(); - customizer.accept(builder); - return new ConditionalRequest( - builder.ifMatch, - builder.ifNoneMatch, - builder.ifModifiedSince, - builder.ifUnmodifiedSince, - builder.ifRange, - builder.range, - builder.headOnly); - } - - /** Mutable holder so each scenario names only the headers it cares about. */ - private static final class Builder { - private Optional ifMatch = Optional.empty(); - private Optional ifNoneMatch = Optional.empty(); - private Optional ifModifiedSince = Optional.empty(); - private Optional ifUnmodifiedSince = Optional.empty(); - private Optional ifRange = Optional.empty(); - private Optional range = Optional.empty(); - private boolean headOnly; - } -} diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/transfer/HttpRangeResolverTest.java b/src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/transfer/HttpRangeResolverTest.java deleted file mode 100644 index 45977301..00000000 --- a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/transfer/HttpRangeResolverTest.java +++ /dev/null @@ -1,107 +0,0 @@ -package dev.caskeleton.application.fileserver.api.transfer; - -import static org.assertj.core.api.Assertions.assertThat; -import static org.assertj.core.api.Assertions.assertThatThrownBy; - -import dev.caskeleton.application.fileserver.api.ByteRange; -import dev.caskeleton.application.fileserver.api.error.RangeNotSatisfiableException; -import org.junit.jupiter.api.Test; -import org.junit.jupiter.params.ParameterizedTest; -import org.junit.jupiter.params.provider.CsvSource; -import org.junit.jupiter.params.provider.ValueSource; - -class HttpRangeResolverTest { - - private final HttpRangeResolver resolver = new DefaultHttpRangeResolver(); - - @ParameterizedTest - @CsvSource({"bytes=0-9,0,9", "bytes=90-,90,99", "bytes=-10,90,99"}) - void resolvesSingleRanges(String header, long start, long end) { - ResolvedRanges result = resolver.resolve(header, 100, RangeBudget.unbounded()); - - assertThat(result.ranges()).containsExactly(new ByteRange(start, end)); - } - - @Test - void resolvesFirstMiddleSuffixAndEndRanges() { - assertThat(resolver.resolve("bytes=0-0", 100, RangeBudget.unbounded()).ranges()) - .containsExactly(new ByteRange(0, 0)); - assertThat(resolver.resolve("bytes=45-54", 100, RangeBudget.unbounded()).ranges()) - .containsExactly(new ByteRange(45, 54)); - assertThat(resolver.resolve("bytes=99-99", 100, RangeBudget.unbounded()).ranges()) - .containsExactly(new ByteRange(99, 99)); - assertThat(resolver.resolve("bytes=-1", 100, RangeBudget.unbounded()).ranges()) - .containsExactly(new ByteRange(99, 99)); - } - - @Test - void clampsAnOpenEndedRangeToTheRepresentation() { - assertThat(resolver.resolve("bytes=90-500", 100, RangeBudget.unbounded()).ranges()) - .containsExactly(new ByteRange(90, 99)); - assertThat(resolver.resolve("bytes=-500", 100, RangeBudget.unbounded()).ranges()) - .containsExactly(new ByteRange(0, 99)); - } - - @Test - void unsatisfiableRangeCarriesRepresentationLength() { - assertThatThrownBy(() -> resolver.resolve("bytes=100-200", 100, RangeBudget.unbounded())) - .isInstanceOf(RangeNotSatisfiableException.class) - .extracting("representationLength") - .isEqualTo(100L); - } - - @Test - void anAbsentOrUnknownUnitServesTheFullRepresentation() { - assertThat(resolver.resolve(null, 100, RangeBudget.unbounded()).isPartial()).isFalse(); - assertThat(resolver.resolve(" ", 100, RangeBudget.unbounded()).isPartial()).isFalse(); - assertThat(resolver.resolve("items=0-9", 100, RangeBudget.unbounded()).isPartial()).isFalse(); - } - - @ParameterizedTest - @ValueSource(strings = {"bytes=abc-def", "bytes=0", "bytes=--5", "bytes=1-2-3"}) - void aMalformedSpecifierIsRejectedRatherThanGuessed(String header) { - assertThatThrownBy(() -> resolver.resolve(header, 100, RangeBudget.unbounded())) - .isInstanceOf(RangeNotSatisfiableException.class); - } - - @Test - void moreRangesThanTheBudgetAllowsAreRejectedBeforeAnyContentOpen() { - String bomb = "bytes=0-0,2-2,4-4,6-6,8-8,10-10,12-12,14-14,16-16"; - - assertThatThrownBy(() -> resolver.resolve(bomb, 100, RangeBudget.unbounded())) - .isInstanceOf(RangeNotSatisfiableException.class); - assertThatThrownBy(() -> resolver.resolve(bomb, 100, RangeBudget.multi(8, 1 << 20))) - .isInstanceOf(RangeNotSatisfiableException.class); - } - - @Test - void multiRangeProfileMergesOverlapsWithinItsBudget() { - ResolvedRanges result = - resolver.resolve("bytes=0-9,5-19,40-49", 100, RangeBudget.multi(8, 1 << 20)); - - assertThat(result.ranges()).containsExactly(new ByteRange(0, 19), new ByteRange(40, 49)); - assertThat(result.totalBytes()).isEqualTo(30); - } - - @Test - void aTotalByteBudgetCapsAmplification() { - assertThatThrownBy(() -> resolver.resolve("bytes=0-99", 100, RangeBudget.multi(8, 10))) - .isInstanceOf(RangeNotSatisfiableException.class); - } - - @Test - void anEmptyRepresentationCannotSatisfyASuffixRange() { - assertThatThrownBy(() -> resolver.resolve("bytes=-10", 0, RangeBudget.unbounded())) - .isInstanceOf(RangeNotSatisfiableException.class); - } - - @Test - void budgetsRejectValuesOutsideTheDesignEnvelope() { - assertThatThrownBy(() -> new RangeBudget(0, 100, false)) - .isInstanceOf(IllegalArgumentException.class); - assertThatThrownBy(() -> new RangeBudget(9, 100, false)) - .isInstanceOf(IllegalArgumentException.class); - assertThat(RangeBudget.unbounded().allowsMultipleRanges()).isFalse(); - assertThat(RangeBudget.multi(8, 100).allowsMultipleRanges()).isTrue(); - } -} diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/download/DownloadApplicationServiceTest.java b/src/application-core/src/test/java/dev/caskeleton/application/fileserver/download/DownloadApplicationServiceTest.java deleted file mode 100644 index 58674ccb..00000000 --- a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/download/DownloadApplicationServiceTest.java +++ /dev/null @@ -1,218 +0,0 @@ -package dev.caskeleton.application.fileserver.download; - -import static org.assertj.core.api.Assertions.assertThat; -import static org.assertj.core.api.Assertions.assertThatThrownBy; - -import dev.caskeleton.application.fileserver.api.ByteRange; -import dev.caskeleton.application.fileserver.api.FileId; -import dev.caskeleton.application.fileserver.api.error.FileAccessDeniedException; -import dev.caskeleton.application.fileserver.api.error.FileNotFoundException; -import dev.caskeleton.application.fileserver.api.error.FileNotReadyException; -import dev.caskeleton.application.fileserver.api.metadata.FileRecord; -import dev.caskeleton.application.fileserver.api.security.FileOperation; -import dev.caskeleton.application.fileserver.api.transfer.ConditionalRequest; -import dev.caskeleton.application.fileserver.api.transfer.ContentDispositionFactory; -import dev.caskeleton.application.fileserver.api.transfer.DefaultConditionalRequestEvaluator; -import dev.caskeleton.application.fileserver.api.transfer.DefaultHttpRangeResolver; -import dev.caskeleton.application.fileserver.testkit.FakeDownloadContentGateway; -import dev.caskeleton.application.fileserver.testkit.FakeFileAccessPolicy; -import dev.caskeleton.application.fileserver.testkit.FileserverFixtures; -import dev.caskeleton.application.fileserver.testkit.InMemoryFileMetadataStore; -import dev.caskeleton.application.fileserver.testkit.ReadyFileFixture; -import java.nio.ByteBuffer; -import java.nio.channels.ReadableByteChannel; -import java.time.Instant; -import java.util.Optional; -import java.util.UUID; -import org.junit.jupiter.api.Test; - -class DownloadApplicationServiceTest { - - private static final String DIGEST = "b".repeat(64); - private static final long SIZE = 10; - - private final InMemoryFileMetadataStore metadata = new InMemoryFileMetadataStore(); - private final FakeDownloadContentGateway content = new FakeDownloadContentGateway(); - private final FakeFileAccessPolicy accessPolicy = new FakeFileAccessPolicy(); - - private final DownloadApplicationService service = - new DefaultDownloadApplicationService( - metadata, - content, - accessPolicy, - new DefaultConditionalRequestEvaluator(new DefaultHttpRangeResolver()), - new ContentDispositionFactory(), - DownloadPolicy.standard()); - - @Test - void aReadyFileIsDescribedAsAFullTwoHundred() { - FileRecord ready = ReadyFileFixture.ready(metadata, SIZE, DIGEST); - - DownloadDescriptor descriptor = - service.describe(DownloadRequest.of(ready.fileId()), FileserverFixtures.context()); - - assertThat(descriptor.status()).isEqualTo(200); - assertThat(descriptor.contentLength()).isEqualTo(SIZE); - assertThat(descriptor.representation().strongEtag()).isEqualTo("\"" + DIGEST + "\""); - assertThat(descriptor.cacheControl()).isEqualTo("private, no-store"); - assertThat(descriptor.contentDisposition()).startsWith("attachment;"); - } - - @Test - void authorizationRunsBeforeTheStateCheckAndBeforeAnyOpen() { - FileRecord verifying = ReadyFileFixture.verifying(metadata, SIZE, DIGEST); - accessPolicy.deny(FileOperation.DOWNLOAD); - - assertThatThrownBy( - () -> - service.describe( - DownloadRequest.of(verifying.fileId()), FileserverFixtures.context())) - .isInstanceOf(FileAccessDeniedException.class); - - assertThat(content.neverOpened()).isTrue(); - } - - @Test - void aNonReadyFileIsAConflictAndIsNeverOpened() { - FileRecord verifying = ReadyFileFixture.verifying(metadata, SIZE, DIGEST); - - assertThatThrownBy( - () -> - service.describe( - DownloadRequest.of(verifying.fileId()), FileserverFixtures.context())) - .isInstanceOf(FileNotReadyException.class); - - assertThat(content.neverOpened()).isTrue(); - } - - @Test - void anUnknownFileIsNotFound() { - assertThatThrownBy( - () -> - service.describe( - DownloadRequest.of(FileId.of(UUID.randomUUID())), FileserverFixtures.context())) - .isInstanceOf(FileNotFoundException.class); - } - - @Test - void aSatisfiableRangeBecomesASinglePartialDescriptor() { - FileRecord ready = ReadyFileFixture.ready(metadata, SIZE, DIGEST); - - DownloadDescriptor descriptor = - service.describe( - new DownloadRequest(ready.fileId(), ConditionalRequest.rangeGet("bytes=2-4"), false), - FileserverFixtures.context()); - - assertThat(descriptor.status()).isEqualTo(206); - assertThat(descriptor.singleRange()).isEqualTo(ByteRange.of(2, 4)); - assertThat(descriptor.contentLength()).isEqualTo(3); - } - - @Test - void aMatchingIfNoneMatchIsNotModifiedAndNeverOpensContent() { - FileRecord ready = ReadyFileFixture.ready(metadata, SIZE, DIGEST); - - DownloadDescriptor descriptor = - service.describe( - new DownloadRequest( - ready.fileId(), - conditional(Optional.empty(), Optional.of("\"" + DIGEST + "\""), Optional.empty()), - false), - FileserverFixtures.context()); - - assertThat(descriptor.status()).isEqualTo(304); - assertThat(descriptor.bodyExpected()).isFalse(); - assertThat(content.neverOpened()).isTrue(); - } - - @Test - void aFailedIfMatchIsAPreconditionFailureAndNeverOpensContent() { - FileRecord ready = ReadyFileFixture.ready(metadata, SIZE, DIGEST); - - DownloadDescriptor descriptor = - service.describe( - new DownloadRequest( - ready.fileId(), - conditional(Optional.of("\"other\""), Optional.empty(), Optional.empty()), - false), - FileserverFixtures.context()); - - assertThat(descriptor.status()).isEqualTo(412); - assertThat(content.neverOpened()).isTrue(); - } - - @Test - void aHeadRequestKeepsTheStatusAndDropsTheBody() { - FileRecord ready = ReadyFileFixture.ready(metadata, SIZE, DIGEST); - - DownloadDescriptor head = - service.describe( - new DownloadRequest( - ready.fileId(), - new ConditionalRequest( - Optional.empty(), - Optional.empty(), - Optional.empty(), - Optional.empty(), - Optional.empty(), - Optional.empty(), - true), - false), - FileserverFixtures.context()); - - assertThat(head.status()).isEqualTo(200); - assertThat(head.bodyExpected()).isFalse(); - assertThat(head.representation().length()).isEqualTo(SIZE); - } - - @Test - void anInlineRequestIsIgnoredUnderTheStandardAttachmentOnlyPolicy() { - FileRecord ready = ReadyFileFixture.ready(metadata, SIZE, DIGEST); - - DownloadDescriptor descriptor = - service.describe( - new DownloadRequest(ready.fileId(), ConditionalRequest.plainGet(), true), - FileserverFixtures.context()); - - assertThat(descriptor.contentDisposition()).startsWith("attachment;"); - } - - @Test - void openingContentReadsExactlyTheDescribedRange() throws Exception { - FileRecord ready = ReadyFileFixture.ready(metadata, SIZE, DIGEST); - content.store(new byte[] {0, 1, 2, 3, 4, 5, 6, 7, 8, 9}); - - DownloadDescriptor descriptor = - service.describe( - new DownloadRequest(ready.fileId(), ConditionalRequest.rangeGet("bytes=2-4"), false), - FileserverFixtures.context()); - ByteBuffer buffer = ByteBuffer.allocate(8); - try (ReadableByteChannel channel = service.openContent(descriptor, descriptor.singleRange())) { - channel.read(buffer); - } - - assertThat(buffer.array()).startsWith(new byte[] {2, 3, 4}); - assertThat(content.opened()).containsExactly(ByteRange.of(2, 4)); - } - - @Test - void metadataReadIsItsOwnAuthorizedOperation() { - FileRecord ready = ReadyFileFixture.ready(metadata, SIZE, DIGEST); - - assertThat(service.describeFile(ready.fileId(), FileserverFixtures.context()).isDownloadable()) - .isTrue(); - assertThat(accessPolicy.invocations()).containsExactly(FileOperation.READ_METADATA); - } - - private static ConditionalRequest conditional( - Optional ifMatch, Optional ifNoneMatch, Optional ifModifiedSince) { - return new ConditionalRequest( - ifMatch, - ifNoneMatch, - ifModifiedSince, - Optional.empty(), - Optional.empty(), - Optional.empty(), - false); - } -} diff --git a/src/application-core/src/test/java/dev/caskeleton/application/idempotency/IdempotencyScopeTest.java b/src/application-core/src/test/java/dev/caskeleton/application/idempotency/IdempotencyScopeTest.java index 08cdcd43..0f321f83 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/idempotency/IdempotencyScopeTest.java +++ b/src/application-core/src/test/java/dev/caskeleton/application/idempotency/IdempotencyScopeTest.java @@ -30,7 +30,7 @@ class IdempotencyScopeTest { @Test void missingPrincipalIsRejectedToPreventGlobalCollision() { - // branch-note §실패 모드: a scope-less key would replay another caller's response. + // design record §실패 모드: a scope-less key would replay another caller's response. assertThatThrownBy(() -> IdempotencyScope.of(" ", "key-1", "UseCase")) .isInstanceOf(IdempotencyScopeMissingException.class) .satisfies( diff --git a/src/application-core/src/test/java/dev/caskeleton/application/lease/LeaseWatchdogTest.java b/src/application-core/src/test/java/dev/caskeleton/application/lease/LeaseWatchdogTest.java index 4e08c89b..8b4ae942 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/lease/LeaseWatchdogTest.java +++ b/src/application-core/src/test/java/dev/caskeleton/application/lease/LeaseWatchdogTest.java @@ -11,6 +11,7 @@ import java.util.concurrent.RejectedExecutionException; import java.util.concurrent.atomic.AtomicInteger; import org.junit.jupiter.api.Test; +@SuppressWarnings("deprecation") class LeaseWatchdogTest { private static final Instant NOW = Instant.parse("2026-07-29T10:00:00Z"); diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/callback/CallbackIngestionAtomicityTest.java b/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/callback/CallbackIngestionAtomicityTest.java deleted file mode 100644 index 0e5663fc..00000000 --- a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/callback/CallbackIngestionAtomicityTest.java +++ /dev/null @@ -1,302 +0,0 @@ -package dev.caskeleton.application.notification.platform.callback; - -import static org.assertj.core.api.Assertions.assertThat; -import static org.assertj.core.api.Assertions.assertThatThrownBy; - -import dev.caskeleton.application.notification.platform.api.CallbackRequest; -import dev.caskeleton.application.notification.platform.api.DeliveryAttemptId; -import dev.caskeleton.application.notification.platform.api.ProviderId; -import dev.caskeleton.application.notification.platform.api.ProviderProfileId; -import dev.caskeleton.application.notification.platform.api.error.CallbackValidationException; -import dev.caskeleton.application.notification.platform.observation.NotificationMetricsPort; -import dev.caskeleton.application.transaction.TransactionPort; -import java.time.Clock; -import java.time.Instant; -import java.time.ZoneOffset; -import java.util.ArrayList; -import java.util.List; -import java.util.Map; -import java.util.Optional; -import java.util.function.Supplier; -import org.junit.jupiter.api.DisplayName; -import org.junit.jupiter.api.Test; - -/** - * What the callback endpoint promises the provider, and when. - * - *

      The comment said "durable append, then a fast 2xx". The code appended and then projected - * synchronously, so a projector that threw failed a callback the provider had already been told was - * accepted — and the provider, seeing a 5xx, redelivered an event that was already in the ledger. A - * slow projector held the provider's connection open for as long as it ran. - * - *

      The append itself was not one unit either: events were inserted one at a time with no - * transaction of this path's own, so a failure part way through a batch committed the events before - * it and told the caller nothing about the split. - */ -class CallbackIngestionAtomicityTest { - - private static final Instant NOW = Instant.parse("2026-08-15T09:00:00Z"); - private static final ProviderId SES = new ProviderId("ses"); - private static final ProviderProfileId PROFILE = new ProviderProfileId("email-main"); - - private final RecordingLedger ledger = new RecordingLedger(); - private final RecordingTransactions transactions = new RecordingTransactions(); - - @Test - @DisplayName("the append runs inside one transaction") - void theAppendRunsInsideOneTransaction() { - service(SES).ingest(request(SES)); - - assertThat(transactions.writes) - .as("event-at-a-time appends could commit the first and lose the rest") - .isEqualTo(1); - assertThat(ledger.appended).hasSize(1); - } - - @Test - @DisplayName("the endpoint returns once the event is durable, without projecting it") - void theEndpointReturnsOnceTheEventIsDurable() { - service(SES).ingest(request(SES)); - - assertThat(ledger.appended).as("the event is durable when the endpoint returns").hasSize(1); - // The strongest available statement: the service has no projector to call. It used to take one - // and invoke it inline, so a projector that threw failed a callback the provider had already - // been told was accepted, and the provider redelivered an event already in the ledger. - assertThat(IngestProviderCallbackApplicationUseCase.class.getDeclaredFields()) - .noneMatch(field -> field.getType().equals(ProviderEventProjectionService.class)); - } - - @Test - @DisplayName( - "a callback presented against another provider's profile is refused before verifying") - void aMismatchedProviderIsRefusedBeforeVerifying() { - RecordingAdapter adapter = new RecordingAdapter(new ProviderId("twilio")); - - assertThatThrownBy(() -> service(adapter).ingest(request(SES))) - .isInstanceOf(CallbackValidationException.class); - assertThat(adapter.verifications) - .as( - "verifying would fetch that provider's certificate on an unauthenticated caller's" - + " say-so") - .isZero(); - assertThat(ledger.appended).isEmpty(); - } - - @Test - @DisplayName("a matching provider is verified and appended") - void aMatchingProviderIsVerifiedAndAppended() { - RecordingAdapter adapter = new RecordingAdapter(SES); - - service(adapter).ingest(request(SES)); - - assertThat(adapter.verifications).isEqualTo(1); - assertThat(ledger.appended).hasSize(1); - } - - private IngestProviderCallbackApplicationUseCase service(ProviderId adapterProvider) { - return service(new RecordingAdapter(adapterProvider)); - } - - private IngestProviderCallbackApplicationUseCase service(RecordingAdapter adapter) { - return new IngestProviderCallbackApplicationUseCase( - new SingleAdapterRegistry(adapter), - ledger, - transactions, - new PassThroughProtection(), - new DiscardingSecurityAudit(), - new DiscardingMetrics(), - Clock.fixed(NOW, ZoneOffset.UTC)); - } - - private static CallbackRequest request(ProviderId providerId) { - return new CallbackRequest( - providerId, - PROFILE, - "https://callbacks.example/notifications/ses", - "POST", - Optional.of("application/json"), - Map.of("content-type", List.of("application/json")), - "{}".getBytes(java.nio.charset.StandardCharsets.UTF_8), - NOW); - } - - /** Counts write boundaries, so "one transaction" is a fact rather than a claim. */ - private static final class RecordingTransactions implements TransactionPort { - - private int writes; - - @Override - public T inWrite(Supplier action) { - writes++; - return action.get(); - } - - @Override - public T inRootWrite(Supplier action) { - return inWrite(action); - } - - @Override - public T inRead(Supplier action) { - return action.get(); - } - - @Override - public T inNew(Supplier action) { - return inWrite(action); - } - } - - private static final class RecordingAdapter implements ProviderCallbackAdapter { - - private final ProviderId providerId; - private int verifications; - - private RecordingAdapter(ProviderId providerId) { - this.providerId = providerId; - } - - @Override - public ProviderId providerId() { - return providerId; - } - - @Override - public CallbackVerificationResult verify(CallbackRequest request) { - verifications++; - return CallbackVerificationResult.valid(new VerifiedCallback(request, Map.of())); - } - - @Override - public List normalize(VerifiedCallback callback) { - return List.of( - new NormalizedProviderEvent( - NormalizedEventType.DELIVERY_CONFIRMED, - "delivered", - Optional.of("event-1"), - Optional.of("request-1"), - Optional.of(NOW), - Map.of())); - } - } - - private record SingleAdapterRegistry(RecordingAdapter adapter) - implements ProviderCallbackAdapterRegistry { - - @Override - public ProviderCallbackAdapter require(ProviderProfileId profileId) { - return adapter; - } - - @Override - public CallbackLimits limitsFor(ProviderProfileId profileId) { - return new CallbackLimits(65_536L, java.util.Set.of("application/json")); - } - } - - private static final class RecordingLedger implements ProviderEventLedger { - - private final List appended = new ArrayList<>(); - - @Override - public AppendEventResult append(VerifiedProviderEvent event) { - return appendAll(List.of(event)); - } - - @Override - public AppendEventResult appendAll(List events) { - appended.addAll(events); - return new AppendEventResult(List.of(), List.of()); - } - - @Override - public List pendingProjection(int limit) { - return List.of(); - } - - @Override - public void markApplied(ProviderEventRecordId eventId, ProjectionResult result) { - // Not part of this contract. - } - - @Override - public void markFailed(ProviderEventRecordId eventId, String errorCode) { - // Not part of this contract. - } - - @Override - public List unmatched(int limit) { - return List.of(); - } - - @Override - public List bindUnmatched( - ProviderProfileId providerProfileId, - String providerRequestId, - DeliveryAttemptId attemptId) { - return List.of(); - } - - @Override - public boolean bindAttempt(ProviderEventRecordId eventId, DeliveryAttemptId attemptId) { - return false; - } - - @Override - public List eventsForAttempt(DeliveryAttemptId attemptId) { - return List.of(); - } - } - - private static final class PassThroughProtection implements CallbackPayloadProtectionPort { - - @Override - public byte[] protectRawPayload(byte[] rawPayload) { - return rawPayload; - } - - @Override - public String digest(byte[] rawPayload) { - return "0".repeat(64); - } - - @Override - public String fingerprint( - ProviderProfileId profileId, NormalizedProviderEvent event, String rawDigest) { - return "1".repeat(64); - } - } - - private static final class DiscardingSecurityAudit - implements dev.caskeleton.application.notification.platform.observation - .NotificationSecurityAuditPort { - - @Override - public void callbackSignatureRejected(ProviderProfileId profileId, String reasonCode) { - // Not asserted here. - } - - @Override - public void callbackRejectedByLimit(ProviderProfileId profileId, String reasonCode) { - // Not asserted here. - } - } - - private static final class DiscardingMetrics implements NotificationMetricsPort { - - @Override - public void increment(String metricName, Map tags) { - // Not asserted here. - } - - @Override - public void record(String metricName, Map tags, java.time.Duration value) { - // Not asserted here. - } - - @Override - public void gauge(String metricName, Map tags, double value) { - // Not asserted here. - } - } -} diff --git a/src/application-core/src/test/java/dev/caskeleton/application/outbox/v2/OutboxDeliveryV2ContractTest.java b/src/application-core/src/test/java/dev/caskeleton/application/outbox/v2/OutboxDeliveryV2ContractTest.java index 7d03a64e..d89969aa 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/outbox/v2/OutboxDeliveryV2ContractTest.java +++ b/src/application-core/src/test/java/dev/caskeleton/application/outbox/v2/OutboxDeliveryV2ContractTest.java @@ -4,6 +4,7 @@ import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.assertThatThrownBy; import dev.caskeleton.application.transaction.OperationId; +import java.time.Instant; import java.time.LocalDate; import org.junit.jupiter.api.Test; @@ -41,6 +42,28 @@ class OutboxDeliveryV2ContractTest { .hasMessageContaining("attempt"); } + @Test + void claimedDeliveryCarriesTheExactCanonicalEvent() { + OutboxDeliveryOwner owner = + new OutboxDeliveryOwner( + LocalDate.parse("2026-07-28"), + "event-1", + "portfolio-events", + "relay-1", + "a".repeat(64), + 1, + 2, + 1); + var canonical = OutboxV2ContractTest.canonicalEvent(); + + Instant createdAt = Instant.parse("2026-07-28T12:00:00Z"); + ClaimedOutboxDelivery claimed = + new ClaimedOutboxDelivery(owner, canonical, createdAt, createdAt); + + assertThat(claimed.owner()).isSameAs(owner); + assertThat(claimed.event()).isSameAs(canonical); + } + @Test void completionRequestRequiresStableOperationIdentity() { OutboxDeliveryTransition transition = diff --git a/src/application-core/src/test/java/dev/caskeleton/application/outbox/v2/OutboxV2ContractTest.java b/src/application-core/src/test/java/dev/caskeleton/application/outbox/v2/OutboxV2ContractTest.java index a9ef11c2..4ac18a8f 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/outbox/v2/OutboxV2ContractTest.java +++ b/src/application-core/src/test/java/dev/caskeleton/application/outbox/v2/OutboxV2ContractTest.java @@ -1,76 +1,67 @@ package dev.caskeleton.application.outbox.v2; import static org.assertj.core.api.Assertions.assertThat; -import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.assertj.core.api.Assertions.assertThatNullPointerException; +import dev.caskeleton.application.messaging.contract.ContractId; +import dev.caskeleton.application.messaging.contract.LogicalDestinationId; +import dev.caskeleton.application.messaging.contract.Sha256; +import dev.caskeleton.application.messaging.event.AggregateIdentity; +import dev.caskeleton.application.messaging.event.AggregateOrder; +import dev.caskeleton.application.messaging.event.EventId; +import dev.caskeleton.application.messaging.event.ValidatedIntegrationEvent; +import java.nio.charset.StandardCharsets; import java.time.Instant; +import java.util.Optional; import org.junit.jupiter.api.Test; class OutboxV2ContractTest { @Test - void eventRequiresPinnedAggregateVersionOrdinalAndBoundedEnvelopeIdentity() { - NewOutboxEventV2 event = - new NewOutboxEventV2( - "event-1", - "WorkLog", - "work-log-42", - 7, - 0, - "WorkLogCreated", - 1, - "portfolio.events", - "work-log-42", - "application/json", - "correlation-1", - null, - Instant.parse("2026-07-28T12:00:00Z"), - "{\"id\":\"42\"}"); + void appendIntentWrapsTheCanonicalEventWithoutASecondRawPayloadModel() { + ValidatedIntegrationEvent canonical = canonicalEvent(); + NewOutboxEventV2 event = new NewOutboxEventV2(canonical); + assertThat(event.event()).isSameAs(canonical); + assertThat(event.eventId()).isEqualTo("event-1"); assertThat(event.aggregateVersion()).isEqualTo(7); - assertThat(event.eventOrdinal()).isZero(); - - assertThatThrownBy( - () -> - new NewOutboxEventV2( - "event-1", - "WorkLog", - "work-log-42", - 0, - 0, - "WorkLogCreated", - 1, - "portfolio.events", - "work-log-42", - "application/json", - "correlation-1", - null, - Instant.parse("2026-07-28T12:00:00Z"), - "{}")) - .isInstanceOf(IllegalArgumentException.class) - .hasMessageContaining("aggregate version"); + assertThat(event.eventOrdinal()).isEqualTo(2); + assertThat(event.eventType()).isEqualTo("portfolio.worklog.changed"); + assertThat(event.eventSchema()).isEqualTo(3); + assertThat(event.logicalDestination()).isEqualTo("portfolio-events"); + assertThat(event.partitionKey()).isEqualTo("a".repeat(64)); } @Test - void orderedDestinationDescriptorRequiresAStablePartitionKey() { - assertThatThrownBy( - () -> - new NewOutboxEventV2( - "event-1", - "WorkLog", - "work-log-42", - 1, - 0, - "WorkLogCreated", - 1, - "portfolio.events", - null, - "application/json", - "correlation-1", - null, - Instant.parse("2026-07-28T12:00:00Z"), - "{}")) - .isInstanceOf(IllegalArgumentException.class) - .hasMessageContaining("partition key"); + void appendIntentCannotExistWithoutACanonicalEvent() { + assertThatNullPointerException() + .isThrownBy(() -> new NewOutboxEventV2(null)) + .withMessage("event"); + } + + static ValidatedIntegrationEvent canonicalEvent() { + String partition = "a".repeat(64); + Sha256 zero = new Sha256(new byte[32]); + return new ValidatedIntegrationEvent( + new EventId("event-1"), + new ContractId("portfolio.worklog.changed"), + 1, + 3, + new LogicalDestinationId("portfolio-events"), + new AggregateIdentity("tenant-a", "worklog", "work-log-42"), + new AggregateOrder(7, 2), + Instant.parse("2026-07-28T12:00:00Z"), + "correlation-1", + Optional.empty(), + partition, + partition.getBytes(StandardCharsets.US_ASCII), + "{\"wire\":\"exact\"}".getBytes(StandardCharsets.UTF_8), + "application/json", + zero, + zero, + zero, + zero, + "catalog-r1", + "binding-r1"); } } diff --git a/src/application-core/src/test/java/dev/caskeleton/application/testsupport/CompiledPackageScanner.java b/src/application-core/src/test/java/dev/caskeleton/application/testsupport/CompiledPackageScanner.java new file mode 100644 index 00000000..76f57033 --- /dev/null +++ b/src/application-core/src/test/java/dev/caskeleton/application/testsupport/CompiledPackageScanner.java @@ -0,0 +1,66 @@ +package dev.caskeleton.application.testsupport; + +import java.io.IOException; +import java.io.UncheckedIOException; +import java.net.URISyntaxException; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.List; +import java.util.jar.JarFile; +import java.util.stream.Stream; + +/** Scans compiled classes from either a classes directory or the project's packaged JAR. */ +public final class CompiledPackageScanner { + + private CompiledPackageScanner() {} + + public static List classNamesUnder(Class anchor, String packageName) { + try { + Path codeSource = Path.of(anchor.getProtectionDomain().getCodeSource().getLocation().toURI()); + String packagePath = packageName.replace('.', '/'); + if (Files.isDirectory(codeSource)) { + return fromDirectory(codeSource.resolve(packagePath), packageName); + } + if (Files.isRegularFile(codeSource)) { + return fromJar(codeSource, packagePath); + } + throw new IOException("unsupported compiled-code location: " + codeSource); + } catch (URISyntaxException | IOException unreadable) { + throw new UncheckedIOException( + new IOException("cannot scan compiled package " + packageName, unreadable)); + } + } + + private static List fromDirectory(Path packageRoot, String packageName) + throws IOException { + if (!Files.isDirectory(packageRoot)) { + return List.of(); + } + try (Stream files = Files.walk(packageRoot)) { + return files + .filter(path -> path.toString().endsWith(".class")) + .map( + path -> + packageName + + "." + + packageRoot + .relativize(path) + .toString() + .replace(java.io.File.separatorChar, '.') + .replaceAll("\\.class$", "")) + .toList(); + } + } + + private static List fromJar(Path jarPath, String packagePath) throws IOException { + String prefix = packagePath.endsWith("/") ? packagePath : packagePath + "/"; + try (JarFile jar = new JarFile(jarPath.toFile())) { + return jar.stream() + .map(entry -> entry.getName()) + .filter(name -> name.startsWith(prefix)) + .filter(name -> name.endsWith(".class")) + .map(name -> name.substring(0, name.length() - ".class".length()).replace('/', '.')) + .toList(); + } + } +} diff --git a/src/application-core/src/testFixtures/java/dev/caskeleton/application/outbox/testkit/LegacyOutboxAppendContract.java b/src/application-core/src/testFixtures/java/dev/caskeleton/application/outbox/testkit/LegacyOutboxAppendContract.java new file mode 100644 index 00000000..0842b578 --- /dev/null +++ b/src/application-core/src/testFixtures/java/dev/caskeleton/application/outbox/testkit/LegacyOutboxAppendContract.java @@ -0,0 +1,100 @@ +package dev.caskeleton.application.outbox.testkit; + +import dev.caskeleton.application.outbox.LegacyOutboxAppendPort; +import dev.caskeleton.application.outbox.NewOutboxEvent; +import dev.caskeleton.application.transaction.TransactionPort; +import java.time.Clock; +import java.util.Objects; +import java.util.UUID; +import java.util.function.Predicate; + +/** + * Provider-neutral contract kit for the compatibility outbox append boundary. + * + *

      The contract is intentionally expressed only in application-owned types. A persistence adapter + * supplies its transaction port, append port, and a probe that can observe whether the event became + * durable. No Spring, JPA, SQL, or provider type is part of this fixture. + */ +public final class LegacyOutboxAppendContract { + + private LegacyOutboxAppendContract() {} + + /** + * Verifies that an append performed inside a caller-owned write transaction disappears when that + * same transaction rolls back. + */ + public static void verifyRollbackRemovesEvent( + TransactionPort transactions, + LegacyOutboxAppendPort append, + Predicate eventExists, + Clock clock) { + requireInputs(transactions, append, eventExists, clock); + String eventId = "legacy-outbox-contract-rollback-" + UUID.randomUUID(); + + try { + transactions.inWrite( + () -> { + append.append(event(eventId, "rollback", clock)); + throw new ExpectedRollback(); + }); + throw new AssertionError("write transaction swallowed the contract rollback signal"); + } catch (ExpectedRollback expected) { + // The signal exists only to force the caller-owned transaction to roll back. + } + + if (eventExists.test(eventId)) { + throw new AssertionError( + "legacy outbox append survived caller transaction rollback for event " + eventId); + } + } + + /** Verifies that an append becomes durable when the caller-owned write transaction commits. */ + public static void verifyCommitPersistsEvent( + TransactionPort transactions, + LegacyOutboxAppendPort append, + Predicate eventExists, + Clock clock) { + requireInputs(transactions, append, eventExists, clock); + String eventId = "legacy-outbox-contract-commit-" + UUID.randomUUID(); + + transactions.inWrite( + () -> { + append.append(event(eventId, "commit", clock)); + return null; + }); + + if (!eventExists.test(eventId)) { + throw new AssertionError( + "legacy outbox append was not durable after caller transaction commit for event " + + eventId); + } + } + + private static NewOutboxEvent event(String eventId, String scenario, Clock clock) { + return new NewOutboxEvent( + eventId, + "LegacyOutboxContractEvent", + "aggregate-" + eventId, + "{\"scenario\":\"" + scenario + "\"}", + clock.instant(), + "correlation-" + eventId, + eventId); + } + + private static void requireInputs( + TransactionPort transactions, + LegacyOutboxAppendPort append, + Predicate eventExists, + Clock clock) { + Objects.requireNonNull(transactions, "transactions"); + Objects.requireNonNull(append, "append"); + Objects.requireNonNull(eventExists, "eventExists"); + Objects.requireNonNull(clock, "clock"); + } + + private static final class ExpectedRollback extends RuntimeException { + private ExpectedRollback() { + super("expected contract rollback", null, false, false); + } + } +} diff --git a/src/application-fileserver/build.gradle b/src/application-fileserver/build.gradle new file mode 100644 index 00000000..081717b6 --- /dev/null +++ b/src/application-fileserver/build.gradle @@ -0,0 +1,10 @@ +plugins { + id 'ca.java-library' +} + +// Optional fileserver application product. Shared error codes are part of its public failure +// contract, so shared-contract is an explicit API edge rather than an accidental transitive one. +dependencies { + implementation project(':application-core') + implementation project(':shared-contract') +} diff --git a/src/application-fileserver/gradle.lockfile b/src/application-fileserver/gradle.lockfile new file mode 100644 index 00000000..e2c95854 --- /dev/null +++ b/src/application-fileserver/gradle.lockfile @@ -0,0 +1,84 @@ +# This is a Gradle generated file for dependency locking. +# Manual edits can break the build and are not advised. +# This file is expected to be part of source control. +com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,testAnnotationProcessor +com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,testAnnotationProcessor +com.github.spotbugs:spotbugs-annotations:4.10.2=spotbugs +com.github.spotbugs:spotbugs:4.10.2=spotbugs +com.github.stephenc.jcip:jcip-annotations:1.0-1=spotbugs +com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,testAnnotationProcessor +com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,testAnnotationProcessor +com.google.auto:auto-common:1.2.2=annotationProcessor,testAnnotationProcessor +com.google.code.findbugs:jsr305:3.0.2=checkstyle,spotbugs +com.google.code.gson:gson:2.13.2=spotbugs +com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.41.0=spotbugs +com.google.errorprone:error_prone_annotations:2.47.0=checkstyle +com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,testAnnotationProcessor +com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.guava:guava:33.5.0-jre=annotationProcessor,testAnnotationProcessor +com.google.guava:guava:33.6.0-jre=checkstyle +com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,testAnnotationProcessor +com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins +com.puppycrawl.tools:checkstyle:13.5.0=checkstyle +commons-beanutils:commons-beanutils:1.11.0=checkstyle +commons-collections:commons-collections:3.2.2=checkstyle +commons-io:commons-io:2.21.0=spotbugs +info.picocli:picocli:4.7.7=checkstyle +io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,testAnnotationProcessor +io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,testAnnotationProcessor +javax.inject:javax.inject:1=annotationProcessor,testAnnotationProcessor +jaxen:jaxen:2.0.6=spotbugs +net.bytebuddy:byte-buddy:1.17.8=testCompileClasspath,testRuntimeClasspath +net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs +org.antlr:antlr4-runtime:4.13.2=checkstyle +org.apache.bcel:bcel:6.12.0=spotbugs +org.apache.commons:commons-lang3:3.20.0=checkstyle,spotbugs +org.apache.commons:commons-text:1.15.0=spotbugs +org.apache.commons:commons-text:1.3=checkstyle +org.apache.httpcomponents:httpclient:4.5.13=checkstyle +org.apache.httpcomponents:httpcore:4.4.16=checkstyle +org.apache.logging.log4j:log4j-api:2.25.5=spotbugs +org.apache.logging.log4j:log4j-core:2.25.5=spotbugs +org.apache.maven.doxia:doxia-core:1.12.0=checkstyle +org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle +org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle +org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle +org.apache.xbean:xbean-reflect:3.7=checkstyle +org.apiguardian:apiguardian-api:1.1.2=testCompileClasspath +org.assertj:assertj-core:3.27.7=testCompileClasspath,testRuntimeClasspath +org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle +org.codehaus.plexus:plexus-component-annotations:2.1.0=checkstyle +org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle +org.codehaus.plexus:plexus-utils:3.3.0=checkstyle +org.dom4j:dom4j:2.2.0=spotbugs +org.javassist:javassist:3.28.0-GA=checkstyle +org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,testAnnotationProcessor,testCompileClasspath +org.junit.jupiter:junit-jupiter-api:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-engine:6.0.3=testRuntimeClasspath +org.junit.jupiter:junit-jupiter-params:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-commons:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-engine:6.0.3=testRuntimeClasspath +org.junit.platform:junit-platform-launcher:6.0.3=testRuntimeClasspath +org.junit:junit-bom:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit:junit-bom:6.1.0=spotbugs +org.mockito:mockito-core:5.20.0=mockitoAgent +org.opentest4j:opentest4j:1.3.0=testCompileClasspath,testRuntimeClasspath +org.ow2.asm:asm-analysis:9.10.1=spotbugs +org.ow2.asm:asm-commons:9.10.1=spotbugs +org.ow2.asm:asm-tree:9.10.1=spotbugs +org.ow2.asm:asm-util:9.10.1=spotbugs +org.ow2.asm:asm:9.10.1=spotbugs +org.pcollections:pcollections:4.0.1=annotationProcessor,testAnnotationProcessor +org.reflections:reflections:0.10.2=checkstyle +org.slf4j:slf4j-api:2.0.18=spotbugs,spotbugsSlf4j +org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j +org.slf4j:slf4j-simple:2.0.18=checkstyle +org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs +empty=compileClasspath,runtimeClasspath diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/AdminAuditPort.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/AdminAuditPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/AdminAuditPort.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/AdminAuditPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/AdminAuditRecord.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/AdminAuditRecord.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/AdminAuditRecord.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/AdminAuditRecord.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/ContentReferenceLedger.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/ContentReferenceLedger.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/ContentReferenceLedger.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/ContentReferenceLedger.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/DefaultFileserverAdminService.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/DefaultFileserverAdminService.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/DefaultFileserverAdminService.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/DefaultFileserverAdminService.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/FileserverAdminService.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/FileserverAdminService.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/FileserverAdminService.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/FileserverAdminService.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/ForceDeleteCommand.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/ForceDeleteCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/ForceDeleteCommand.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/ForceDeleteCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/IncompleteUploadView.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/IncompleteUploadView.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/IncompleteUploadView.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/IncompleteUploadView.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/OrphanObject.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/OrphanObject.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/OrphanObject.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/OrphanObject.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/OrphanReconcileCommand.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/OrphanReconcileCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/OrphanReconcileCommand.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/OrphanReconcileCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/OrphanReconcileReport.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/OrphanReconcileReport.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/OrphanReconcileReport.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/OrphanReconcileReport.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/OrphanScanPort.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/OrphanScanPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/OrphanScanPort.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/OrphanScanPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/RuntimeCapabilityReport.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/RuntimeCapabilityReport.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/RuntimeCapabilityReport.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/RuntimeCapabilityReport.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/StorageHealthPort.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/StorageHealthPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/StorageHealthPort.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/StorageHealthPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/StorageHealthReport.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/StorageHealthReport.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/admin/StorageHealthReport.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/admin/StorageHealthReport.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/ByteRange.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/ByteRange.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/ByteRange.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/ByteRange.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/ContentKey.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/ContentKey.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/ContentKey.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/ContentKey.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/DefaultFileStateMachine.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/DefaultFileStateMachine.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/DefaultFileStateMachine.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/DefaultFileStateMachine.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/FileId.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/FileId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/FileId.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/FileId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/FileState.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/FileState.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/FileState.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/FileState.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/FileStateMachine.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/FileStateMachine.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/FileStateMachine.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/FileStateMachine.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/StorageNamespace.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/StorageNamespace.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/StorageNamespace.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/StorageNamespace.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/UploadId.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/UploadId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/UploadId.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/UploadId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/AppendResult.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/AppendResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/AppendResult.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/AppendResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/AsyncContentStore.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/AsyncContentStore.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/AsyncContentStore.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/AsyncContentStore.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/BlockingContentStore.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/BlockingContentStore.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/BlockingContentStore.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/BlockingContentStore.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/CapacityAwareContentStore.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/CapacityAwareContentStore.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/CapacityAwareContentStore.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/CapacityAwareContentStore.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/ContentMetadata.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/ContentMetadata.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/ContentMetadata.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/ContentMetadata.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/ContentStoreCapabilities.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/ContentStoreCapabilities.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/ContentStoreCapabilities.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/ContentStoreCapabilities.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/CopyCapableContentStore.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/CopyCapableContentStore.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/CopyCapableContentStore.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/CopyCapableContentStore.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/CopyPrecondition.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/CopyPrecondition.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/CopyPrecondition.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/CopyPrecondition.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/CreateContentCommand.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/CreateContentCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/CreateContentCommand.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/CreateContentCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/DelegatedDownloadDescriptor.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/DelegatedDownloadDescriptor.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/DelegatedDownloadDescriptor.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/DelegatedDownloadDescriptor.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/DelegatedDownloadStore.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/DelegatedDownloadStore.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/DelegatedDownloadStore.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/DelegatedDownloadStore.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/DeletePrecondition.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/DeletePrecondition.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/DeletePrecondition.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/DeletePrecondition.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/DeleteResult.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/DeleteResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/DeleteResult.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/DeleteResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/FinalizeContentCommand.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/FinalizeContentCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/FinalizeContentCommand.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/FinalizeContentCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/PublishMode.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/PublishMode.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/PublishMode.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/PublishMode.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/StorageCapacity.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/StorageCapacity.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/StorageCapacity.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/StorageCapacity.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/StoredContent.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/StoredContent.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/StoredContent.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/StoredContent.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/UploadHandle.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/UploadHandle.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/UploadHandle.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/UploadHandle.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/WriteFence.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/WriteFence.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/content/WriteFence.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/content/WriteFence.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/AmbiguousCompletionException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/AmbiguousCompletionException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/AmbiguousCompletionException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/AmbiguousCompletionException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/AtomicPublishUnsupportedException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/AtomicPublishUnsupportedException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/AtomicPublishUnsupportedException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/AtomicPublishUnsupportedException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/ConcurrentFileModificationException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/ConcurrentFileModificationException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/ConcurrentFileModificationException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/ConcurrentFileModificationException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/FileAccessDeniedException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/FileAccessDeniedException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/FileAccessDeniedException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/FileAccessDeniedException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/FileAlreadyExistsException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/FileAlreadyExistsException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/FileAlreadyExistsException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/FileAlreadyExistsException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/FileNotFoundException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/FileNotFoundException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/FileNotFoundException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/FileNotFoundException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/FileNotReadyException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/FileNotReadyException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/FileNotReadyException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/FileNotReadyException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/FileTooLargeException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/FileTooLargeException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/FileTooLargeException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/FileTooLargeException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/FileserverErrorCode.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/FileserverErrorCode.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/FileserverErrorCode.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/FileserverErrorCode.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/FileserverException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/FileserverException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/FileserverException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/FileserverException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/FileserverFailureContext.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/FileserverFailureContext.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/FileserverFailureContext.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/FileserverFailureContext.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/IntegrityMismatchException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/IntegrityMismatchException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/IntegrityMismatchException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/IntegrityMismatchException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/InvalidPathException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/InvalidPathException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/InvalidPathException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/InvalidPathException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/MalformedRequestException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/MalformedRequestException.java similarity index 79% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/MalformedRequestException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/MalformedRequestException.java index ae4f72b3..716d5b2e 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/MalformedRequestException.java +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/MalformedRequestException.java @@ -3,9 +3,9 @@ package dev.caskeleton.application.fileserver.api.error; /** * A request's headers or their combination are not valid for the operation. * - *

      This is separate from {@link UnsupportedMediaTypeException} on purpose: a missing protocol - * version and an unsupported content type are different failures, and collapsing them would make - * the emitted code disagree with the exception a reader sees in a stack trace. + *

      This is separate from {@link UnsupportedMediaTypeException} on purpose: a missing request + * invariant version and an unsupported content type are different failures, and collapsing them + * would make the emitted code disagree with the exception a reader sees in a stack trace. */ public final class MalformedRequestException extends FileserverException { diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/MalwareDetectedException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/MalwareDetectedException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/MalwareDetectedException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/MalwareDetectedException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/PartialWriteException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/PartialWriteException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/PartialWriteException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/PartialWriteException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/PathOutsideNamespaceException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/PathOutsideNamespaceException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/PathOutsideNamespaceException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/PathOutsideNamespaceException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/QuotaExceededException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/QuotaExceededException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/QuotaExceededException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/QuotaExceededException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/StorageFullException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/StorageFullException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/StorageFullException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/StorageFullException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/StorageUnavailableException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/StorageUnavailableException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/StorageUnavailableException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/StorageUnavailableException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/TransferAdmissionRejectedException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/TransferAdmissionRejectedException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/TransferAdmissionRejectedException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/TransferAdmissionRejectedException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/TransferTimeoutException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/TransferTimeoutException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/TransferTimeoutException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/TransferTimeoutException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/UnsupportedMediaTypeException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/UnsupportedMediaTypeException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/UnsupportedMediaTypeException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/UnsupportedMediaTypeException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/UploadExpiredException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/UploadExpiredException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/UploadExpiredException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/UploadExpiredException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/UploadOffsetMismatchException.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/UploadOffsetMismatchException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/error/UploadOffsetMismatchException.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/error/UploadOffsetMismatchException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileDescriptor.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileDescriptor.java similarity index 76% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileDescriptor.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileDescriptor.java index 6ee27c58..281c574d 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileDescriptor.java +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileDescriptor.java @@ -6,12 +6,7 @@ import dev.caskeleton.application.fileserver.api.StorageNamespace; import java.time.Instant; import java.util.Objects; -/** - * Public metadata view of a file. - * - *

      The descriptor never carries a physical path, a content key, a raw scanner response, or raw - * user metadata. {@code originalFilename} is untrusted display data only. - */ +/** Public metadata view of a file, without transport-specific validators. */ public record FileDescriptor( FileId fileId, StorageNamespace namespace, @@ -20,7 +15,6 @@ public record FileDescriptor( String mediaType, long size, String sha256, - String strongEtag, Instant publishedAt, long version) { diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileMetadataStore.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileMetadataStore.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileMetadataStore.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileMetadataStore.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileQuotaService.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileQuotaService.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileQuotaService.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileQuotaService.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecord.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecord.java similarity index 95% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecord.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecord.java index 2a432662..c61dec55 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecord.java +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecord.java @@ -26,7 +26,6 @@ public record FileRecord( OptionalLong expectedSize, OptionalLong actualSize, Optional sha256, - Optional strongEtag, Optional publishedAt, Optional lastErrorCode, long version, @@ -44,7 +43,6 @@ public record FileRecord( Objects.requireNonNull(expectedSize, "expectedSize"); Objects.requireNonNull(actualSize, "actualSize"); Objects.requireNonNull(sha256, "sha256"); - Objects.requireNonNull(strongEtag, "strongEtag"); Objects.requireNonNull(publishedAt, "publishedAt"); Objects.requireNonNull(lastErrorCode, "lastErrorCode"); Objects.requireNonNull(createdAt, "createdAt"); @@ -69,7 +67,6 @@ public record FileRecord( verifiedMediaType.orElse("application/octet-stream"), actualSize.orElse(0L), sha256.orElse(""), - strongEtag.orElse(""), publishedAt.orElse(null), version); } diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecordDraft.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecordDraft.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecordDraft.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecordDraft.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecordMutation.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecordMutation.java similarity index 62% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecordMutation.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecordMutation.java index 2d8980ed..9a671c7a 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecordMutation.java +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecordMutation.java @@ -16,7 +16,6 @@ public record FileRecordMutation( Optional contentKey, OptionalLong actualSize, Optional sha256, - Optional strongEtag, Optional verifiedMediaType, Optional publishedAt, Optional lastErrorCode) { @@ -25,13 +24,11 @@ public record FileRecordMutation( Objects.requireNonNull(contentKey, "contentKey"); Objects.requireNonNull(actualSize, "actualSize"); Objects.requireNonNull(sha256, "sha256"); - Objects.requireNonNull(strongEtag, "strongEtag"); Objects.requireNonNull(verifiedMediaType, "verifiedMediaType"); Objects.requireNonNull(publishedAt, "publishedAt"); Objects.requireNonNull(lastErrorCode, "lastErrorCode"); } - /** Transition that changes state only. */ public static FileRecordMutation none() { return new FileRecordMutation( Optional.empty(), @@ -39,41 +36,20 @@ public record FileRecordMutation( Optional.empty(), Optional.empty(), Optional.empty(), - Optional.empty(), Optional.empty()); } - /** Publish mutation written together with the READY transition. */ - public static FileRecordMutation publish( - ContentKey contentKey, long actualSize, String sha256, String strongEtag) { - return new FileRecordMutation( - Optional.of(contentKey), - OptionalLong.of(actualSize), - Optional.of(sha256), - Optional.of(strongEtag), - Optional.empty(), - Optional.of(Instant.now()), - Optional.empty()); - } - - /** Publish mutation with an explicit publication instant, for deterministic tests and replay. */ public static FileRecordMutation publishAt( - ContentKey contentKey, - long actualSize, - String sha256, - String strongEtag, - Instant publishedAt) { + ContentKey contentKey, long actualSize, String sha256, Instant publishedAt) { return new FileRecordMutation( Optional.of(contentKey), OptionalLong.of(actualSize), Optional.of(sha256), - Optional.of(strongEtag), Optional.empty(), Optional.of(publishedAt), Optional.empty()); } - /** Records the streamed byte count and digest without publishing anything. */ public static FileRecordMutation uploaded(long actualSize, String sha256) { return new FileRecordMutation( Optional.empty(), @@ -81,38 +57,27 @@ public record FileRecordMutation( Optional.of(sha256), Optional.empty(), Optional.empty(), - Optional.empty(), Optional.empty()); } - /** - * The same mutation with the verifier's media type attached. - * - *

      Lets a publish carry the verified type in the one statement that makes the file readable, - * instead of a follow-up write. An absent verdict leaves the column alone rather than clearing - * it, which is the same omission rule the rest of this type follows. - */ public FileRecordMutation withVerifiedMediaType(Optional mediaType) { Objects.requireNonNull(mediaType, "mediaType"); return mediaType.isEmpty() ? this : new FileRecordMutation( - contentKey, actualSize, sha256, strongEtag, mediaType, publishedAt, lastErrorCode); + contentKey, actualSize, sha256, mediaType, publishedAt, lastErrorCode); } - /** Records the verifier-established media type. */ public static FileRecordMutation verified(String verifiedMediaType) { return new FileRecordMutation( Optional.empty(), OptionalLong.empty(), Optional.empty(), - Optional.empty(), Optional.of(verifiedMediaType), Optional.empty(), Optional.empty()); } - /** Records a stable failure code that the recovery policy later reads. */ public static FileRecordMutation failure(String lastErrorCode) { return new FileRecordMutation( Optional.empty(), @@ -120,7 +85,6 @@ public record FileRecordMutation( Optional.empty(), Optional.empty(), Optional.empty(), - Optional.empty(), Optional.of(lastErrorCode)); } } diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecoveryQuery.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecoveryQuery.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecoveryQuery.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/FileRecoveryQuery.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/QuotaReservation.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/QuotaReservation.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/QuotaReservation.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/QuotaReservation.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/QuotaReservationStatus.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/QuotaReservationStatus.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/QuotaReservationStatus.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/QuotaReservationStatus.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/QuotaScope.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/QuotaScope.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/QuotaScope.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/QuotaScope.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/UploadSession.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/UploadSession.java similarity index 96% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/UploadSession.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/UploadSession.java index 8ae7f576..14d3c22d 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/UploadSession.java +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/UploadSession.java @@ -2,7 +2,7 @@ package dev.caskeleton.application.fileserver.api.metadata; import dev.caskeleton.application.fileserver.api.FileId; import dev.caskeleton.application.fileserver.api.UploadId; -import dev.caskeleton.application.fileserver.api.transfer.UploadProtocol; +import dev.caskeleton.application.fileserver.api.transfer.UploadMode; import java.time.Instant; import java.util.Objects; import java.util.Optional; @@ -22,7 +22,7 @@ import java.util.UUID; public record UploadSession( UploadId uploadId, FileId fileId, - UploadProtocol protocol, + UploadMode mode, OptionalLong expectedLength, long committedOffset, Instant expiresAt, @@ -37,7 +37,7 @@ public record UploadSession( public UploadSession { Objects.requireNonNull(uploadId, "uploadId"); Objects.requireNonNull(fileId, "fileId"); - Objects.requireNonNull(protocol, "protocol"); + Objects.requireNonNull(mode, "mode"); Objects.requireNonNull(expectedLength, "expectedLength"); Objects.requireNonNull(expiresAt, "expiresAt"); Objects.requireNonNull(leaseOwner, "leaseOwner"); diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/UploadSessionDraft.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/UploadSessionDraft.java similarity index 89% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/UploadSessionDraft.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/UploadSessionDraft.java index c4f9a228..a4dad42f 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/UploadSessionDraft.java +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/UploadSessionDraft.java @@ -2,7 +2,7 @@ package dev.caskeleton.application.fileserver.api.metadata; import dev.caskeleton.application.fileserver.api.FileId; import dev.caskeleton.application.fileserver.api.UploadId; -import dev.caskeleton.application.fileserver.api.transfer.UploadProtocol; +import dev.caskeleton.application.fileserver.api.transfer.UploadMode; import java.time.Instant; import java.util.Objects; import java.util.OptionalLong; @@ -11,14 +11,14 @@ import java.util.OptionalLong; public record UploadSessionDraft( UploadId uploadId, FileId fileId, - UploadProtocol protocol, + UploadMode mode, OptionalLong expectedLength, Instant expiresAt) { public UploadSessionDraft { Objects.requireNonNull(uploadId, "uploadId"); Objects.requireNonNull(fileId, "fileId"); - Objects.requireNonNull(protocol, "protocol"); + Objects.requireNonNull(mode, "mode"); Objects.requireNonNull(expectedLength, "expectedLength"); Objects.requireNonNull(expiresAt, "expiresAt"); } diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/UploadSessionStore.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/UploadSessionStore.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/UploadSessionStore.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/UploadSessionStore.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/WriterLease.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/WriterLease.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/metadata/WriterLease.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/metadata/WriterLease.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/security/FileAccessPolicy.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/security/FileAccessPolicy.java similarity index 52% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/security/FileAccessPolicy.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/security/FileAccessPolicy.java index a951ee9f..fab04a4b 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/security/FileAccessPolicy.java +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/security/FileAccessPolicy.java @@ -6,9 +6,14 @@ import java.util.Optional; /** * Authorization hook the Fileserver calls on every public operation. * - *

      The Fileserver contains no business authorization rule of its own. The starter must not create - * an allow-all implementation in a production profile: a missing policy is a startup failure, not a - * silent permit. + *

      The Fileserver contains no business authorization rule of its own. A composition may implement + * this policy by delegating coarse permission checks to application-core's AuthorizationPort and + * object-specific decisions to ObjectAccessPolicy, but this interface remains product-specific: + * CREATE runs before a FileDescriptor exists and FileOperation is part of the fileserver contract. + * The core layer therefore cannot invent a universal operation-to-permission/object mapping. + * + *

      The starter must not create an allow-all implementation in a production profile: a missing + * policy is a startup failure, not a silent permit. */ public interface FileAccessPolicy { diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/security/FileAccessSubject.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/security/FileAccessSubject.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/security/FileAccessSubject.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/security/FileAccessSubject.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/security/FileOperation.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/security/FileOperation.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/security/FileOperation.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/security/FileOperation.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/security/FileVerifier.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/security/FileVerifier.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/security/FileVerifier.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/security/FileVerifier.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/security/OriginalFilenamePolicy.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/security/OriginalFilenamePolicy.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/security/OriginalFilenamePolicy.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/security/OriginalFilenamePolicy.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/security/RequestContext.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/security/RequestContext.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/security/RequestContext.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/security/RequestContext.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/security/SanitizedFilename.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/security/SanitizedFilename.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/security/SanitizedFilename.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/security/SanitizedFilename.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/security/VerificationRequest.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/security/VerificationRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/security/VerificationRequest.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/security/VerificationRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/security/VerificationResult.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/security/VerificationResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/security/VerificationResult.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/security/VerificationResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/security/VerificationVerdict.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/security/VerificationVerdict.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/api/security/VerificationVerdict.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/security/VerificationVerdict.java diff --git a/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/transfer/FileRepresentation.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/transfer/FileRepresentation.java new file mode 100644 index 00000000..b9713489 --- /dev/null +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/transfer/FileRepresentation.java @@ -0,0 +1,26 @@ +package dev.caskeleton.application.fileserver.api.transfer; + +import java.time.Instant; +import java.util.Objects; + +/** + * Immutable application view of readable file content. + * + *

      The application exposes content facts only: digest, publication time, length and verified + * media type. HTTP validators and conditional-request semantics are derived by inbound adapters. + */ +public record FileRepresentation( + String sha256, Instant publishedAt, long length, String mediaType) { + + public FileRepresentation { + Objects.requireNonNull(sha256, "sha256"); + Objects.requireNonNull(publishedAt, "publishedAt"); + Objects.requireNonNull(mediaType, "mediaType"); + if (sha256.isBlank()) { + throw new IllegalArgumentException("sha256 must be non-blank"); + } + if (length < 0) { + throw new IllegalArgumentException("length must not be negative"); + } + } +} diff --git a/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/transfer/UploadMode.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/transfer/UploadMode.java new file mode 100644 index 00000000..15c0e756 --- /dev/null +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/api/transfer/UploadMode.java @@ -0,0 +1,14 @@ +package dev.caskeleton.application.fileserver.api.transfer; + +/** + * Application-level shape of an upload session. + * + *

      The mode describes lifecycle semantics only. Wire protocol names such as TUS or a particular + * HTTP draft are inbound-adapter concerns and are deliberately not represented here. + */ +public enum UploadMode { + SINGLE_SHOT, + BATCH, + RESUMABLE, + EXPERIMENTAL_RESUMABLE +} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupBatchResult.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupBatchResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupBatchResult.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupBatchResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupContentGateway.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupContentGateway.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupContentGateway.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupContentGateway.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupItem.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupItem.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupItem.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupItem.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupQueue.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupQueue.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupQueue.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupQueue.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupRequest.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupRequest.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupService.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupService.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupService.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupService.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupType.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupType.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupType.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/cleanup/CleanupType.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/cleanup/DefaultCleanupService.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/cleanup/DefaultCleanupService.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/cleanup/DefaultCleanupService.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/cleanup/DefaultCleanupService.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/cleanup/QuotaReclaimGateway.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/cleanup/QuotaReclaimGateway.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/cleanup/QuotaReclaimGateway.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/cleanup/QuotaReclaimGateway.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/concurrency/DefaultWriterLeaseCoordinator.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/concurrency/DefaultWriterLeaseCoordinator.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/concurrency/DefaultWriterLeaseCoordinator.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/concurrency/DefaultWriterLeaseCoordinator.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/concurrency/LeaseFence.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/concurrency/LeaseFence.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/concurrency/LeaseFence.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/concurrency/LeaseFence.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/concurrency/LeaseHeartbeat.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/concurrency/LeaseHeartbeat.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/concurrency/LeaseHeartbeat.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/concurrency/LeaseHeartbeat.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/concurrency/WriterLeaseCoordinator.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/concurrency/WriterLeaseCoordinator.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/concurrency/WriterLeaseCoordinator.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/concurrency/WriterLeaseCoordinator.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/DefaultDownloadApplicationService.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/download/DefaultDownloadApplicationService.java similarity index 58% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/DefaultDownloadApplicationService.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/download/DefaultDownloadApplicationService.java index 130960d3..e0b00469 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/DefaultDownloadApplicationService.java +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/download/DefaultDownloadApplicationService.java @@ -12,9 +12,6 @@ import dev.caskeleton.application.fileserver.api.security.FileAccessPolicy; import dev.caskeleton.application.fileserver.api.security.FileOperation; import dev.caskeleton.application.fileserver.api.security.RequestContext; import dev.caskeleton.application.fileserver.api.security.SanitizedFilename; -import dev.caskeleton.application.fileserver.api.transfer.ConditionalRequestEvaluator; -import dev.caskeleton.application.fileserver.api.transfer.ContentDispositionFactory; -import dev.caskeleton.application.fileserver.api.transfer.DownloadDecision; import dev.caskeleton.application.fileserver.api.transfer.FileRepresentation; import dev.caskeleton.application.fileserver.observability.FileserverMetricsPort; import dev.caskeleton.application.fileserver.observability.SizeBucket; @@ -24,62 +21,41 @@ import java.nio.channels.WritableByteChannel; import java.util.Optional; /** - * The design's download decision order, made once for every transport. + * Authorizes download access and exposes immutable content facts. * - *

      Authorization runs before the record is even projected, READY is required before a validator - * is evaluated, and content is opened only by {@link #openContent}. A {@code 304}, {@code 412}, or - * {@code 416} answer therefore provably never touches storage. + *

      HTTP conditional requests, range parsing, status selection and response headers deliberately + * do not live here. The application proves the file exists, is readable and authorized; an inbound + * transport may then derive its wire response before opening content. */ public final class DefaultDownloadApplicationService implements DownloadApplicationService { private final FileMetadataStore metadataStore; private final DownloadContentGateway contentGateway; private final FileAccessPolicy accessPolicy; - private final ConditionalRequestEvaluator conditionalEvaluator; - private final ContentDispositionFactory dispositionFactory; - private final DownloadPolicy policy; private final Optional zeroCopyGateway; private final FileserverMetricsPort metrics; public DefaultDownloadApplicationService( FileMetadataStore metadataStore, DownloadContentGateway contentGateway, - FileAccessPolicy accessPolicy, - ConditionalRequestEvaluator conditionalEvaluator, - ContentDispositionFactory dispositionFactory, - DownloadPolicy policy) { + FileAccessPolicy accessPolicy) { this( metadataStore, contentGateway, accessPolicy, - conditionalEvaluator, - dispositionFactory, - policy, Optional.empty(), FileserverMetricsPort.noop()); } - /** - * Adds an optional direct-transfer path. - * - *

      The gateway is optional rather than required because a store that cannot transfer must - * change nothing a client observes; absence and refusal take the same streaming path. - */ public DefaultDownloadApplicationService( FileMetadataStore metadataStore, DownloadContentGateway contentGateway, FileAccessPolicy accessPolicy, - ConditionalRequestEvaluator conditionalEvaluator, - ContentDispositionFactory dispositionFactory, - DownloadPolicy policy, Optional zeroCopyGateway, FileserverMetricsPort metrics) { this.metadataStore = metadataStore; this.contentGateway = contentGateway; this.accessPolicy = accessPolicy; - this.conditionalEvaluator = conditionalEvaluator; - this.dispositionFactory = dispositionFactory; - this.policy = policy; this.zeroCopyGateway = zeroCopyGateway; this.metrics = metrics; } @@ -99,19 +75,22 @@ public final class DefaultDownloadApplicationService implements DownloadApplicat FileOperation.DOWNLOAD, context.subject(), Optional.of(record.toDescriptor())); requireReadable(record); - FileRepresentation representation = representationOf(record); - DownloadDecision decision = - conditionalEvaluator.evaluate(request.conditional(), representation, policy.rangeBudget()); + FileRepresentation representation = + new FileRepresentation( + record.sha256().orElseThrow(DefaultDownloadApplicationService::readyWithoutValidator), + record + .publishedAt() + .orElseThrow(DefaultDownloadApplicationService::readyWithoutValidator), + record + .actualSize() + .orElseThrow(DefaultDownloadApplicationService::readyWithoutValidator), + record.verifiedMediaType().orElse("application/octet-stream")); return new DownloadDescriptor( record.fileId(), - decision.status(), representation, - decision.ranges(), record.contentKey().orElseThrow(DefaultDownloadApplicationService::readyWithoutKey), - disposition(record, representation, request.inlineRequested()), - policy.cacheControl(), - decision.bodyExpected() && !request.conditional().headOnly()); + new SanitizedFilename(record.originalName())); } @Override @@ -126,11 +105,13 @@ public final class DefaultDownloadApplicationService implements DownloadApplicat zeroCopyGateway .map(gateway -> gateway.transferTo(descriptor.contentKey(), range, sink)) .orElseGet(ZeroCopyTransferResult::notStarted); - // "How often does the fast path actually fire, and how often does it stop half way" is the one - // question this optimization has to be able to answer. + String transferShape = + range.startInclusive() == 0 && range.length() == descriptor.representation().length() + ? "full" + : "partial"; metrics.recordDownload( "zero-copy", - descriptor.isPartial() ? "partial" : "full", + transferShape, result.outcome().name().toLowerCase(java.util.Locale.ROOT), SizeBucket.of(range.length()), java.time.Duration.ZERO, @@ -138,36 +119,6 @@ public final class DefaultDownloadApplicationService implements DownloadApplicat return result; } - /** - * Builds the representation the validators are evaluated against. - * - *

      {@code lastModified} is the metadata publication instant; a filesystem timestamp is not - * authoritative on a network filesystem and is never used here. - */ - private static FileRepresentation representationOf(FileRecord record) { - return new FileRepresentation( - record.strongEtag().orElseThrow(DefaultDownloadApplicationService::readyWithoutValidator), - record.publishedAt().orElseThrow(DefaultDownloadApplicationService::readyWithoutValidator), - record.actualSize().orElseThrow(DefaultDownloadApplicationService::readyWithoutValidator), - record.verifiedMediaType().orElse("application/octet-stream")); - } - - /** - * Chooses the disposition. - * - *

      An inline request is honoured only when the policy allows it at all, and the factory still - * downgrades a scriptable media type: serving stored HTML or SVG inline from an upload origin is - * a stored cross-site scripting primitive. - */ - private String disposition( - FileRecord record, FileRepresentation representation, boolean inlineRequested) { - SanitizedFilename filename = new SanitizedFilename(record.originalName()); - if (inlineRequested && policy.inlineAllowed()) { - return dispositionFactory.inlineOrAttachment(filename, representation.mediaType()); - } - return dispositionFactory.attachment(filename); - } - private FileRecord requireRecord(FileId fileId) { return metadataStore .find(fileId) @@ -179,7 +130,6 @@ public final class DefaultDownloadApplicationService implements DownloadApplicat FileserverErrorCode.FILE_NOT_FOUND, fileId, false))); } - /** Only READY exposes readable immutable content; every other state is a conflict, not a 404. */ private static void requireReadable(FileRecord record) { if (!record.state().isPubliclyReadable()) { throw new FileNotReadyException( diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/DownloadApplicationService.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/download/DownloadApplicationService.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/DownloadApplicationService.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/download/DownloadApplicationService.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/DownloadContentGateway.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/download/DownloadContentGateway.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/DownloadContentGateway.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/download/DownloadContentGateway.java diff --git a/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/download/DownloadDescriptor.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/download/DownloadDescriptor.java new file mode 100644 index 00000000..ddca1339 --- /dev/null +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/download/DownloadDescriptor.java @@ -0,0 +1,27 @@ +package dev.caskeleton.application.fileserver.download; + +import dev.caskeleton.application.fileserver.api.ContentKey; +import dev.caskeleton.application.fileserver.api.FileId; +import dev.caskeleton.application.fileserver.api.security.SanitizedFilename; +import dev.caskeleton.application.fileserver.api.transfer.FileRepresentation; +import java.util.Objects; + +/** + * Authorized immutable content that a transport may render or transfer. + * + *

      No HTTP status, conditional header, cache directive or content-disposition value crosses this + * boundary. Inbound transports derive those from the representation and their own policy. + */ +public record DownloadDescriptor( + FileId fileId, + FileRepresentation representation, + ContentKey contentKey, + SanitizedFilename filename) { + + public DownloadDescriptor { + Objects.requireNonNull(fileId, "fileId"); + Objects.requireNonNull(representation, "representation"); + Objects.requireNonNull(contentKey, "contentKey"); + Objects.requireNonNull(filename, "filename"); + } +} diff --git a/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/download/DownloadRequest.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/download/DownloadRequest.java new file mode 100644 index 00000000..fa734c3e --- /dev/null +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/download/DownloadRequest.java @@ -0,0 +1,16 @@ +package dev.caskeleton.application.fileserver.download; + +import dev.caskeleton.application.fileserver.api.FileId; +import java.util.Objects; + +/** Transport-neutral request to authorize and describe one readable file. */ +public record DownloadRequest(FileId fileId) { + + public DownloadRequest { + Objects.requireNonNull(fileId, "fileId"); + } + + public static DownloadRequest of(FileId fileId) { + return new DownloadRequest(fileId); + } +} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/ZeroCopyDownloadGateway.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/download/ZeroCopyDownloadGateway.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/ZeroCopyDownloadGateway.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/download/ZeroCopyDownloadGateway.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/ZeroCopyTransferResult.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/download/ZeroCopyTransferResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/download/ZeroCopyTransferResult.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/download/ZeroCopyTransferResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/lifecycle/CopyContentGateway.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/lifecycle/CopyContentGateway.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/lifecycle/CopyContentGateway.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/lifecycle/CopyContentGateway.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/lifecycle/CopyFileCommand.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/lifecycle/CopyFileCommand.java similarity index 67% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/lifecycle/CopyFileCommand.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/lifecycle/CopyFileCommand.java index 0b9d4e31..e0418f2f 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/lifecycle/CopyFileCommand.java +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/lifecycle/CopyFileCommand.java @@ -8,19 +8,20 @@ import java.util.Optional; /** * Intent to copy a READY file into a namespace. * - *

      {@code expectedEtag} is the caller's {@code If-Match} assertion about the source. Copying from - * a representation that has since changed would silently duplicate content the caller never saw. + *

      {@code expectedSha256} is an optional immutable-content version asserted by the caller. + * Transport adapters translate their own validator syntax into this raw digest before invoking the + * use case. */ public record CopyFileCommand( FileId sourceFileId, StorageNamespace targetNamespace, Optional targetFilename, - Optional expectedEtag) { + Optional expectedSha256) { public CopyFileCommand { Objects.requireNonNull(sourceFileId, "sourceFileId"); Objects.requireNonNull(targetNamespace, "targetNamespace"); Objects.requireNonNull(targetFilename, "targetFilename"); - Objects.requireNonNull(expectedEtag, "expectedEtag"); + Objects.requireNonNull(expectedSha256, "expectedSha256"); } } diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/lifecycle/DefaultFileLifecycleService.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/lifecycle/DefaultFileLifecycleService.java similarity index 90% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/lifecycle/DefaultFileLifecycleService.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/lifecycle/DefaultFileLifecycleService.java index 5b7de933..c4e59d90 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/lifecycle/DefaultFileLifecycleService.java +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/lifecycle/DefaultFileLifecycleService.java @@ -69,11 +69,11 @@ public final class DefaultFileLifecycleService implements FileLifecycleService { @Override public DeleteOutcome delete( - FileId fileId, Optional expectedEtag, RequestContext context) { + FileId fileId, Optional expectedSha256, RequestContext context) { FileRecord record = requireRecord(fileId); accessPolicy.authorize( FileOperation.DELETE, context.subject(), Optional.of(record.toDescriptor())); - requireEtagMatches(record, expectedEtag); + requireDigestMatches(record, expectedSha256); if (record.state() == FileState.DELETED) { return new DeleteOutcome(fileId, false); @@ -109,7 +109,7 @@ public final class DefaultFileLifecycleService implements FileLifecycleService { FileRecord source = requireRecord(command.sourceFileId()); accessPolicy.authorize( FileOperation.COPY, context.subject(), Optional.of(source.toDescriptor())); - requireEtagMatches(source, command.expectedEtag()); + requireDigestMatches(source, command.expectedSha256()); requireReadable(source); SanitizedFilename filename = @@ -145,12 +145,12 @@ public final class DefaultFileLifecycleService implements FileLifecycleService { public FileView move( FileId fileId, StorageNamespace targetNamespace, - Optional expectedEtag, + Optional expectedSha256, RequestContext context) { FileRecord record = requireRecord(fileId); accessPolicy.authorize( FileOperation.MOVE, context.subject(), Optional.of(record.toDescriptor())); - requireEtagMatches(record, expectedEtag); + requireDigestMatches(record, expectedSha256); requireReadable(record); return FileView.of( @@ -194,11 +194,7 @@ public final class DefaultFileLifecycleService implements FileLifecycleService { FileState.VERIFYING, FileState.READY, FileRecordMutation.publishAt( - copied.contentKey(), - copied.size(), - copied.sha256(), - "\"" + copied.sha256() + "\"", - clock.instant())); + copied.contentKey(), copied.size(), copied.sha256(), clock.instant())); } /** @@ -226,20 +222,12 @@ public final class DefaultFileLifecycleService implements FileLifecycleService { }); } - /** - * Enforces the caller's {@code If-Match} assertion. - * - *

      The validator is the strong entity tag the caller was served, not an internal row version: a - * client can only assert about what it actually saw. A wildcard matches any existing record. - * Without this check two operators deleting concurrently would both succeed, and neither would - * learn that the representation they acted on was already gone. - */ - private static void requireEtagMatches(FileRecord record, Optional expectedEtag) { - if (expectedEtag.isEmpty()) { + /** Enforces a transport-neutral content-version precondition over the immutable SHA-256. */ + private static void requireDigestMatches(FileRecord record, Optional expectedSha256) { + if (expectedSha256.isEmpty()) { return; } - String expected = expectedEtag.get().trim(); - if ("*".equals(expected) || expected.equals(record.strongEtag().orElse(null))) { + if (expectedSha256.orElseThrow().equals(record.sha256().orElse(null))) { return; } throw new ConcurrentFileModificationException( diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/lifecycle/DeleteOutcome.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/lifecycle/DeleteOutcome.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/lifecycle/DeleteOutcome.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/lifecycle/DeleteOutcome.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/lifecycle/FileLifecycleService.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/lifecycle/FileLifecycleService.java similarity index 86% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/lifecycle/FileLifecycleService.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/lifecycle/FileLifecycleService.java index 1c36a2b6..cc4c9966 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/lifecycle/FileLifecycleService.java +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/lifecycle/FileLifecycleService.java @@ -15,13 +15,13 @@ import java.util.Optional; */ public interface FileLifecycleService { - DeleteOutcome delete(FileId fileId, Optional expectedEtag, RequestContext context); + DeleteOutcome delete(FileId fileId, Optional expectedSha256, RequestContext context); FileView copy(CopyFileCommand command, RequestContext context); FileView move( FileId fileId, StorageNamespace targetNamespace, - Optional expectedEtag, + Optional expectedSha256, RequestContext context); } diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverAuditEvent.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverAuditEvent.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverAuditEvent.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverAuditEvent.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverAuditPort.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverAuditPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverAuditPort.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverAuditPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverMetricsPort.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverMetricsPort.java similarity index 93% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverMetricsPort.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverMetricsPort.java index c1ca3cd5..b7cc367e 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverMetricsPort.java +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverMetricsPort.java @@ -1,6 +1,6 @@ package dev.caskeleton.application.fileserver.observability; -import dev.caskeleton.application.fileserver.api.transfer.UploadProtocol; +import dev.caskeleton.application.fileserver.api.transfer.UploadMode; import java.time.Duration; /** @@ -14,7 +14,7 @@ import java.time.Duration; public interface FileserverMetricsPort { void recordUpload( - UploadProtocol protocol, + UploadMode mode, String storageType, String resultCode, SizeBucket sizeBucket, @@ -33,7 +33,7 @@ public interface FileserverMetricsPort { void recordInterruption(TransferDirection direction, String reason); - void recordOffsetMismatch(UploadProtocol protocol, String clientType); + void recordOffsetMismatch(UploadMode mode, String clientType); void recordChecksumFailure(String algorithm, String stage); diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverSpans.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverSpans.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverSpans.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/observability/FileserverSpans.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/observability/NoopFileserverMetrics.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/observability/NoopFileserverMetrics.java similarity index 93% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/observability/NoopFileserverMetrics.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/observability/NoopFileserverMetrics.java index 59174367..73af4408 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/observability/NoopFileserverMetrics.java +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/observability/NoopFileserverMetrics.java @@ -1,6 +1,6 @@ package dev.caskeleton.application.fileserver.observability; -import dev.caskeleton.application.fileserver.api.transfer.UploadProtocol; +import dev.caskeleton.application.fileserver.api.transfer.UploadMode; import java.time.Duration; /** @@ -13,7 +13,7 @@ final class NoopFileserverMetrics implements FileserverMetricsPort { @Override public void recordUpload( - UploadProtocol protocol, + UploadMode mode, String storageType, String resultCode, SizeBucket sizeBucket, @@ -44,7 +44,7 @@ final class NoopFileserverMetrics implements FileserverMetricsPort { } @Override - public void recordOffsetMismatch(UploadProtocol protocol, String clientType) { + public void recordOffsetMismatch(UploadMode mode, String clientType) { // Intentionally empty. } diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/observability/SafeFileFingerprint.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/observability/SafeFileFingerprint.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/observability/SafeFileFingerprint.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/observability/SafeFileFingerprint.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/observability/SizeBucket.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/observability/SizeBucket.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/observability/SizeBucket.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/observability/SizeBucket.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/observability/TransferDirection.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/observability/TransferDirection.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/observability/TransferDirection.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/observability/TransferDirection.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/quota/DefaultTransferAdmissionController.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/quota/DefaultTransferAdmissionController.java similarity index 82% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/quota/DefaultTransferAdmissionController.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/quota/DefaultTransferAdmissionController.java index 90833768..320ed582 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/quota/DefaultTransferAdmissionController.java +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/quota/DefaultTransferAdmissionController.java @@ -7,9 +7,9 @@ import dev.caskeleton.application.fileserver.api.error.QuotaExceededException; import dev.caskeleton.application.fileserver.api.error.StorageFullException; import dev.caskeleton.application.fileserver.api.error.TransferAdmissionRejectedException; import dev.caskeleton.application.fileserver.api.metadata.QuotaScope; +import java.util.HashMap; import java.util.Map; import java.util.OptionalDouble; -import java.util.concurrent.ConcurrentHashMap; import java.util.concurrent.Semaphore; import java.util.concurrent.atomic.AtomicBoolean; @@ -22,12 +22,15 @@ import java.util.concurrent.atomic.AtomicBoolean; */ public final class DefaultTransferAdmissionController implements TransferAdmissionController { + static final int MAX_TRACKED_SCOPES = 4_096; + private final TransferAdmissionProperties properties; private final StorageUsageProbe usageProbe; private final long maximumFileSize; private final Semaphore instanceUploads; private final Semaphore directDownloads; - private final Map scopeUploads = new ConcurrentHashMap<>(); + private final Map scopeUploads = new HashMap<>(); + private final Semaphore overflowScopeUploads; public DefaultTransferAdmissionController( TransferAdmissionProperties properties, StorageUsageProbe usageProbe, long maximumFileSize) { @@ -39,6 +42,7 @@ public final class DefaultTransferAdmissionController implements TransferAdmissi this.maximumFileSize = maximumFileSize; this.instanceUploads = new Semaphore(properties.instanceUploadPermits()); this.directDownloads = new Semaphore(properties.directDownloadPermits()); + this.overflowScopeUploads = new Semaphore(properties.scopeUploadPermits()); } @Override @@ -98,8 +102,27 @@ public final class DefaultTransferAdmissionController implements TransferAdmissi } private Semaphore scopePermits(QuotaScope scope) { - return scopeUploads.computeIfAbsent( - scope.canonicalKey(), ignored -> new Semaphore(properties.scopeUploadPermits())); + String key = scope.canonicalKey(); + synchronized (scopeUploads) { + Semaphore existing = scopeUploads.get(key); + if (existing != null) { + return existing; + } + if (scopeUploads.size() >= MAX_TRACKED_SCOPES) { + // Do not evict a live semaphore: it may still have held permits. New high-cardinality + // scopes share one conservative fallback instead of growing this map without a bound. + return overflowScopeUploads; + } + Semaphore created = new Semaphore(properties.scopeUploadPermits()); + scopeUploads.put(key, created); + return created; + } + } + + int trackedScopeCount() { + synchronized (scopeUploads) { + return scopeUploads.size(); + } } /** Releases each held semaphore exactly once, however many times {@code close} is called. */ diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/quota/StorageUsageProbe.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/quota/StorageUsageProbe.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/quota/StorageUsageProbe.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/quota/StorageUsageProbe.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/quota/TransferAdmissionController.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/quota/TransferAdmissionController.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/quota/TransferAdmissionController.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/quota/TransferAdmissionController.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/quota/TransferAdmissionProperties.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/quota/TransferAdmissionProperties.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/quota/TransferAdmissionProperties.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/quota/TransferAdmissionProperties.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/quota/TransferPermit.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/quota/TransferPermit.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/quota/TransferPermit.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/quota/TransferPermit.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/recovery/DefaultFileReconciliationService.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/recovery/DefaultFileReconciliationService.java similarity index 99% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/recovery/DefaultFileReconciliationService.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/recovery/DefaultFileReconciliationService.java index 677489ac..5581897d 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/recovery/DefaultFileReconciliationService.java +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/recovery/DefaultFileReconciliationService.java @@ -151,7 +151,6 @@ public final class DefaultFileReconciliationService implements FileReconciliatio key, record.actualSize().getAsLong(), record.sha256().get(), - "\"" + record.sha256().get() + "\"", clock.instant()))); return ReconciliationResult.resolved( record.fileId(), diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/recovery/FileReconciliationService.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/recovery/FileReconciliationService.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/recovery/FileReconciliationService.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/recovery/FileReconciliationService.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/recovery/ProbeOutcome.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/recovery/ProbeOutcome.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/recovery/ProbeOutcome.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/recovery/ProbeOutcome.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/recovery/ReconciliationContentProbe.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/recovery/ReconciliationContentProbe.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/recovery/ReconciliationContentProbe.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/recovery/ReconciliationContentProbe.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/recovery/ReconciliationResult.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/recovery/ReconciliationResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/recovery/ReconciliationResult.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/recovery/ReconciliationResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/recovery/ReconciliationStatus.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/recovery/ReconciliationStatus.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/recovery/ReconciliationStatus.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/recovery/ReconciliationStatus.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/recovery/RecoveryQueue.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/recovery/RecoveryQueue.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/recovery/RecoveryQueue.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/recovery/RecoveryQueue.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/recovery/StagingUploadLocator.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/recovery/StagingUploadLocator.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/recovery/StagingUploadLocator.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/recovery/StagingUploadLocator.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/AppendUploadResult.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/AppendUploadResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/AppendUploadResult.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/AppendUploadResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/CreateUploadRequest.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/CreateUploadRequest.java similarity index 92% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/CreateUploadRequest.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/CreateUploadRequest.java index e8d76c6c..a16c34a0 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/CreateUploadRequest.java +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/CreateUploadRequest.java @@ -1,7 +1,7 @@ package dev.caskeleton.application.fileserver.upload; import dev.caskeleton.application.fileserver.api.StorageNamespace; -import dev.caskeleton.application.fileserver.api.transfer.UploadProtocol; +import dev.caskeleton.application.fileserver.api.transfer.UploadMode; import java.time.Instant; import java.util.Objects; import java.util.Optional; @@ -19,7 +19,7 @@ public record CreateUploadRequest( Optional claimedMediaType, OptionalLong expectedLength, Optional expectedSha256, - UploadProtocol protocol, + UploadMode mode, Instant expiresAt) { public CreateUploadRequest { @@ -28,7 +28,7 @@ public record CreateUploadRequest( Objects.requireNonNull(claimedMediaType, "claimedMediaType"); Objects.requireNonNull(expectedLength, "expectedLength"); Objects.requireNonNull(expectedSha256, "expectedSha256"); - Objects.requireNonNull(protocol, "protocol"); + Objects.requireNonNull(mode, "mode"); Objects.requireNonNull(expiresAt, "expiresAt"); } } diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultFinalizeUploadService.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultFinalizeUploadService.java similarity index 96% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultFinalizeUploadService.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultFinalizeUploadService.java index 77ea8ac7..502972af 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultFinalizeUploadService.java +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultFinalizeUploadService.java @@ -27,7 +27,7 @@ import dev.caskeleton.application.fileserver.cleanup.CleanupQueue; import dev.caskeleton.application.fileserver.cleanup.CleanupRequest; import dev.caskeleton.application.fileserver.cleanup.CleanupType; import dev.caskeleton.application.fileserver.recovery.RecoveryQueue; -import dev.caskeleton.application.transaction.TransactionPort; +import dev.caskeleton.application.transaction.PolicyTransactionPort; import java.time.Clock; import java.time.Instant; import java.util.Locale; @@ -53,7 +53,7 @@ public final class DefaultFinalizeUploadService implements FinalizeUploadService private final CleanupQueue cleanupQueue; private final RecoveryQueue recoveryQueue; private final PublishMode publishMode; - private final TransactionPort transactions; + private final PolicyTransactionPort transactions; private final Clock clock; public DefaultFinalizeUploadService( @@ -65,7 +65,7 @@ public final class DefaultFinalizeUploadService implements FinalizeUploadService CleanupQueue cleanupQueue, RecoveryQueue recoveryQueue, PublishMode publishMode, - TransactionPort transactions, + PolicyTransactionPort transactions, Clock clock) { this.metadataStore = metadataStore; this.sessionStore = sessionStore; @@ -307,7 +307,6 @@ public final class DefaultFinalizeUploadService implements FinalizeUploadService published.contentKey(), published.size(), published.sha256(), - strongEtag(published.sha256()), publishedAt) .withVerifiedMediaType(verdict.verifiedMediaType())); // Same boundary as the READY commit: a finished file whose reservation was never @@ -318,10 +317,14 @@ public final class DefaultFinalizeUploadService implements FinalizeUploadService } catch (RuntimeException exception) { // The object is on the volume and the record does not say so — the definition of an ambiguous // completion. Enqueued in its own boundary, because the one that failed took nothing with it. - transactions.inWrite( - () -> { - recoveryQueue.enqueue(verifying.fileId(), "READY_COMMIT_UNCONFIRMED"); - }); + try { + FileserverCompensationTransaction.run( + transactions, + "fileserver-ready-recovery-" + verifying.fileId().value(), + () -> recoveryQueue.enqueue(verifying.fileId(), "READY_COMMIT_UNCONFIRMED")); + } catch (RuntimeException recoveryWriteFailure) { + exception.addSuppressed(recoveryWriteFailure); + } throw new AmbiguousCompletionException( "content was published but the READY commit could not be confirmed", exception, @@ -353,9 +356,4 @@ public final class DefaultFinalizeUploadService implements FinalizeUploadService FileRecordMutation.failure(reasonCode)); }); } - - /** Strong validator over the immutable READY bytes. */ - static String strongEtag(String sha256) { - return "\"" + sha256 + "\""; - } } diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultSingleShotUploadService.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultSingleShotUploadService.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultSingleShotUploadService.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultSingleShotUploadService.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultUploadApplicationService.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultUploadApplicationService.java similarity index 95% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultUploadApplicationService.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultUploadApplicationService.java index d6b71a23..f5f94a71 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultUploadApplicationService.java +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultUploadApplicationService.java @@ -36,7 +36,7 @@ import dev.caskeleton.application.fileserver.observability.FileserverMetricsPort import dev.caskeleton.application.fileserver.observability.SizeBucket; import dev.caskeleton.application.fileserver.quota.TransferAdmissionController; import dev.caskeleton.application.fileserver.quota.TransferPermit; -import dev.caskeleton.application.transaction.TransactionPort; +import dev.caskeleton.application.transaction.PolicyTransactionPort; import java.nio.channels.ReadableByteChannel; import java.time.Clock; import java.time.Duration; @@ -72,7 +72,7 @@ public final class DefaultUploadApplicationService implements UploadApplicationS private final UploadIdentifierFactory identifierFactory; private final UploadPolicy uploadPolicy; private final FileserverMetricsPort metrics; - private final TransactionPort transactions; + private final PolicyTransactionPort transactions; private final Clock clock; public DefaultUploadApplicationService( @@ -88,7 +88,7 @@ public final class DefaultUploadApplicationService implements UploadApplicationS UploadIdentifierFactory identifierFactory, UploadPolicy uploadPolicy, FileserverMetricsPort metrics, - TransactionPort transactions, + PolicyTransactionPort transactions, Clock clock) { this.transactions = transactions; this.metadataStore = metadataStore; @@ -139,7 +139,7 @@ public final class DefaultUploadApplicationService implements UploadApplicationS new UploadSessionDraft( uploadId, fileId, - request.protocol(), + request.mode(), request.expectedLength(), request.expiresAt())); return new CreatedUpload(reservation, record, session); @@ -151,11 +151,17 @@ public final class DefaultUploadApplicationService implements UploadApplicationS } catch (RuntimeException exception) { // Staging sits outside the boundary above because it has to — it is a filesystem call — so // it is the one failure here that still compensates by hand instead of rolling back. - transactions.inWrite( - () -> { - failRecord(created.record(), "UPLOAD_CREATE_FAILED"); - quotaService.release(created.reservation()); - }); + try { + FileserverCompensationTransaction.run( + transactions, + "fileserver-upload-create-compensation-" + uploadId.value(), + () -> { + failRecord(created.record(), "UPLOAD_CREATE_FAILED"); + quotaService.release(created.reservation()); + }); + } catch (RuntimeException compensationFailure) { + exception.addSuppressed(compensationFailure); + } throw exception; } @@ -211,10 +217,10 @@ public final class DefaultUploadApplicationService implements UploadApplicationS UploadSession committed = leaseCoordinator.commitOffset( fence.current(), expectedOffset, appended.committedOffset()); - // Recorded here rather than at the transport, because this is where the protocol, the + // Recorded here rather than at the transport, because this is where the mode, the // durable result and the byte count are all facts rather than inferences. metrics.recordUpload( - session.protocol(), + session.mode(), STORAGE_TYPE, "committed", SizeBucket.of(appended.appendedBytes()), @@ -223,7 +229,7 @@ public final class DefaultUploadApplicationService implements UploadApplicationS return new AppendUploadResult( committed.committedOffset(), appended.appendedBytes(), appended.sha256()); } catch (UploadOffsetMismatchException mismatch) { - metrics.recordOffsetMismatch(session.protocol(), "client"); + metrics.recordOffsetMismatch(session.mode(), "client"); throw mismatch; } finally { leaseCoordinator.release(fence.current()); diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/FileVerificationService.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/FileVerificationService.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/FileVerificationService.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/FileVerificationService.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/FileView.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/FileView.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/FileView.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/FileView.java diff --git a/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/FileserverCompensationTransaction.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/FileserverCompensationTransaction.java new file mode 100644 index 00000000..2a31487f --- /dev/null +++ b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/FileserverCompensationTransaction.java @@ -0,0 +1,60 @@ +package dev.caskeleton.application.fileserver.upload; + +import dev.caskeleton.application.outbound.CallBudget; +import dev.caskeleton.application.transaction.OperationId; +import dev.caskeleton.application.transaction.PolicyTransactionPort; +import dev.caskeleton.application.transaction.TransactionPolicyId; +import dev.caskeleton.application.transaction.TransactionRequest; +import dev.caskeleton.application.transaction.TransactionResult; +import java.time.Duration; +import java.util.Objects; +import java.util.Optional; + +/** Policy-based REQUIRES_NEW boundary for fileserver compensation/recovery writes. */ +final class FileserverCompensationTransaction { + + private static final Duration BUDGET = Duration.ofSeconds(30); + + private FileserverCompensationTransaction() {} + + static void run(PolicyTransactionPort transactions, String operationId, Runnable action) { + Objects.requireNonNull(transactions, "transactions"); + Objects.requireNonNull(operationId, "operationId"); + Objects.requireNonNull(action, "action"); + + TransactionRequest request = + new TransactionRequest( + TransactionPolicyId.MAINTENANCE_NEW, + CallBudget.fromNow(BUDGET), + Optional.empty(), + Optional.of(new OperationId(operationId))); + + TransactionResult result = + transactions.inTransaction( + request, + () -> { + action.run(); + return null; + }); + + if (result instanceof TransactionResult.Committed) { + return; + } + if (result + instanceof TransactionResult.CommittedWithPostCommitFailure committedWithFailure) { + throw committedWithFailure.operationalFailure(); + } + if (result instanceof TransactionResult.DeterminateRollback rollback) { + throw rollback.failure(); + } + if (result instanceof TransactionResult.Indeterminate indeterminate) { + throw new IllegalStateException( + "fileserver compensation transaction outcome is indeterminate at " + + indeterminate.lastObservedPhase() + + " for operationId=" + + operationId); + } + throw new IllegalStateException( + "MAINTENANCE_NEW compensation unexpectedly participated in an outer transaction"); + } +} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/FinalizeUploadRequest.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/FinalizeUploadRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/FinalizeUploadRequest.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/FinalizeUploadRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/FinalizeUploadService.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/FinalizeUploadService.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/FinalizeUploadService.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/FinalizeUploadService.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/QuotaCommitGateway.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/QuotaCommitGateway.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/QuotaCommitGateway.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/QuotaCommitGateway.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/SingleShotUploadService.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/SingleShotUploadService.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/SingleShotUploadService.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/SingleShotUploadService.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/UploadApplicationService.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/UploadApplicationService.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/UploadApplicationService.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/UploadApplicationService.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/UploadContentGateway.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/UploadContentGateway.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/UploadContentGateway.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/UploadContentGateway.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/UploadIdentifierFactory.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/UploadIdentifierFactory.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/UploadIdentifierFactory.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/UploadIdentifierFactory.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/UploadPolicy.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/UploadPolicy.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/UploadPolicy.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/UploadPolicy.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/UploadSessionView.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/UploadSessionView.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/UploadSessionView.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/UploadSessionView.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/UploadStorageGateway.java b/src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/UploadStorageGateway.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/fileserver/upload/UploadStorageGateway.java rename to src/application-fileserver/src/main/java/dev/caskeleton/application/fileserver/upload/UploadStorageGateway.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/admin/FileserverAdminServiceTest.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/admin/FileserverAdminServiceTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/admin/FileserverAdminServiceTest.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/admin/FileserverAdminServiceTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/FileStateMachineTest.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/api/FileStateMachineTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/FileStateMachineTest.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/api/FileStateMachineTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/ValueObjectTest.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/api/ValueObjectTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/ValueObjectTest.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/api/ValueObjectTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/content/ContentStoreApiArchitectureTest.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/api/content/ContentStoreApiArchitectureTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/content/ContentStoreApiArchitectureTest.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/api/content/ContentStoreApiArchitectureTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/error/FileserverExceptionTest.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/api/error/FileserverExceptionTest.java similarity index 94% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/error/FileserverExceptionTest.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/api/error/FileserverExceptionTest.java index 870d22e0..e05da46d 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/error/FileserverExceptionTest.java +++ b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/api/error/FileserverExceptionTest.java @@ -67,14 +67,6 @@ class FileserverExceptionTest { assertThat(exception.code().httpStatus()).isEqualTo(409); } - @Test - void unsatisfiableRangeCarriesRepresentationLength() { - RangeNotSatisfiableException exception = RangeNotSatisfiableException.of(100); - - assertThat(exception.representationLength()).isEqualTo(100L); - assertThat(exception.code().httpStatus()).isEqualTo(416); - } - @ParameterizedTest @EnumSource(FileserverErrorCode.class) void everyCodeMapsToADesignStatusAndAStableProblemUrn(FileserverErrorCode code) { diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/metadata/MetadataPortContractTest.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/api/metadata/MetadataPortContractTest.java similarity index 95% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/metadata/MetadataPortContractTest.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/api/metadata/MetadataPortContractTest.java index cc34917a..aea6a706 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/metadata/MetadataPortContractTest.java +++ b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/api/metadata/MetadataPortContractTest.java @@ -60,11 +60,10 @@ class MetadataPortContractTest { } @Test - void publishMutationCarriesKeySizeDigestAndEtag() { + void publishMutationCarriesKeySizeAndDigest() { ContentKey key = new ContentKey("ab/cd/0123456789abcdef"); - FileRecordMutation mutation = - FileRecordMutation.publishAt(key, 10, "a".repeat(64), "\"" + "a".repeat(64) + "\"", NOW); + FileRecordMutation mutation = FileRecordMutation.publishAt(key, 10, "a".repeat(64), NOW); assertThat(mutation.contentKey()).contains(key); assertThat(mutation.actualSize()).hasValue(10); @@ -104,7 +103,6 @@ class MetadataPortContractTest { Optional.empty(), Optional.empty(), Optional.empty(), - Optional.empty(), 0, NOW, NOW); @@ -142,7 +140,7 @@ class MetadataPortContractTest { new UploadSession( UploadId.of(UUID.randomUUID()), FileId.of(UUID.randomUUID()), - dev.caskeleton.application.fileserver.api.transfer.UploadProtocol.RAW, + dev.caskeleton.application.fileserver.api.transfer.UploadMode.SINGLE_SHOT, OptionalLong.of(3), 3, NOW.plusSeconds(60), @@ -179,7 +177,6 @@ class MetadataPortContractTest { OptionalLong.of(10), OptionalLong.of(10), Optional.of("a".repeat(64)), - Optional.of("\"" + "a".repeat(64) + "\""), Optional.of(NOW), Optional.empty(), 3, diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/security/OriginalFilenamePolicyTest.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/api/security/OriginalFilenamePolicyTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/api/security/OriginalFilenamePolicyTest.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/api/security/OriginalFilenamePolicyTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/cleanup/CleanupServiceTest.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/cleanup/CleanupServiceTest.java similarity index 98% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/cleanup/CleanupServiceTest.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/cleanup/CleanupServiceTest.java index 5391c4bd..db35d8d7 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/cleanup/CleanupServiceTest.java +++ b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/cleanup/CleanupServiceTest.java @@ -12,7 +12,7 @@ import dev.caskeleton.application.fileserver.api.metadata.FileRecord; import dev.caskeleton.application.fileserver.api.metadata.UploadSession; import dev.caskeleton.application.fileserver.api.metadata.UploadSessionDraft; import dev.caskeleton.application.fileserver.api.metadata.WriterLease; -import dev.caskeleton.application.fileserver.api.transfer.UploadProtocol; +import dev.caskeleton.application.fileserver.api.transfer.UploadMode; import dev.caskeleton.application.fileserver.observability.FileserverMetricsPort; import dev.caskeleton.application.fileserver.testkit.DirectTransactions; import dev.caskeleton.application.fileserver.testkit.FakeCleanupContentGateway; @@ -114,7 +114,7 @@ class CleanupServiceTest { new UploadSessionDraft( uploadId, fileId, - UploadProtocol.RAW, + UploadMode.SINGLE_SHOT, OptionalLong.of(SIZE), FileserverFixtures.NOW.plusSeconds(3600))); // What cancel does before it queues the item, in the same transaction. @@ -143,7 +143,7 @@ class CleanupServiceTest { new UploadSessionDraft( uploadId, fileId, - UploadProtocol.RAW, + UploadMode.SINGLE_SHOT, OptionalLong.of(SIZE), FileserverFixtures.NOW.plusSeconds(3600))); content.storeStaging(uploadId); @@ -171,7 +171,7 @@ class CleanupServiceTest { new UploadSessionDraft( uploadId, fileId, - UploadProtocol.RAW, + UploadMode.SINGLE_SHOT, OptionalLong.of(SIZE), FileserverFixtures.NOW.plusSeconds(3600))); sessions.terminate(uploadId); @@ -227,7 +227,7 @@ class CleanupServiceTest { new UploadSessionDraft( uploadId, fileId, - UploadProtocol.RAW, + UploadMode.SINGLE_SHOT, OptionalLong.of(SIZE), FileserverFixtures.NOW.plusSeconds(3600))); sessions.terminate(uploadId); @@ -306,7 +306,7 @@ class CleanupServiceTest { new UploadSessionDraft( uploadId, fileId, - UploadProtocol.RAW, + UploadMode.SINGLE_SHOT, OptionalLong.of(SIZE), FileserverFixtures.NOW.plusSeconds(3600))); WriterLease lease = diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/concurrency/MultiInstanceWriterLeaseTest.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/concurrency/MultiInstanceWriterLeaseTest.java similarity index 99% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/concurrency/MultiInstanceWriterLeaseTest.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/concurrency/MultiInstanceWriterLeaseTest.java index c7af73dd..2af70630 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/concurrency/MultiInstanceWriterLeaseTest.java +++ b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/concurrency/MultiInstanceWriterLeaseTest.java @@ -9,7 +9,7 @@ import dev.caskeleton.application.fileserver.api.error.ConcurrentFileModificatio import dev.caskeleton.application.fileserver.api.metadata.UploadSession; import dev.caskeleton.application.fileserver.api.metadata.UploadSessionDraft; import dev.caskeleton.application.fileserver.api.metadata.WriterLease; -import dev.caskeleton.application.fileserver.api.transfer.UploadProtocol; +import dev.caskeleton.application.fileserver.api.transfer.UploadMode; import dev.caskeleton.application.fileserver.testkit.DirectTransactions; import dev.caskeleton.application.fileserver.testkit.FileserverFixtures; import dev.caskeleton.application.fileserver.testkit.InMemoryUploadSessionStore; @@ -35,7 +35,7 @@ class MultiInstanceWriterLeaseTest { new UploadSessionDraft( UPLOAD_ID, FileId.of(UUID.nameUUIDFromBytes(new byte[] {8})), - UploadProtocol.RAW, + UploadMode.SINGLE_SHOT, OptionalLong.of(6), FileserverFixtures.NOW.plusSeconds(3600))); } diff --git a/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/download/DownloadApplicationServiceTest.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/download/DownloadApplicationServiceTest.java new file mode 100644 index 00000000..dd1453e6 --- /dev/null +++ b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/download/DownloadApplicationServiceTest.java @@ -0,0 +1,109 @@ +package dev.caskeleton.application.fileserver.download; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +import dev.caskeleton.application.fileserver.api.ByteRange; +import dev.caskeleton.application.fileserver.api.FileId; +import dev.caskeleton.application.fileserver.api.error.FileAccessDeniedException; +import dev.caskeleton.application.fileserver.api.error.FileNotFoundException; +import dev.caskeleton.application.fileserver.api.error.FileNotReadyException; +import dev.caskeleton.application.fileserver.api.metadata.FileRecord; +import dev.caskeleton.application.fileserver.api.security.FileOperation; +import dev.caskeleton.application.fileserver.testkit.FakeDownloadContentGateway; +import dev.caskeleton.application.fileserver.testkit.FakeFileAccessPolicy; +import dev.caskeleton.application.fileserver.testkit.FileserverFixtures; +import dev.caskeleton.application.fileserver.testkit.InMemoryFileMetadataStore; +import dev.caskeleton.application.fileserver.testkit.ReadyFileFixture; +import java.nio.ByteBuffer; +import java.nio.channels.ReadableByteChannel; +import java.util.UUID; +import org.junit.jupiter.api.Test; + +class DownloadApplicationServiceTest { + + private static final String DIGEST = "b".repeat(64); + private static final long SIZE = 10; + + private final InMemoryFileMetadataStore metadata = new InMemoryFileMetadataStore(); + private final FakeDownloadContentGateway content = new FakeDownloadContentGateway(); + private final FakeFileAccessPolicy accessPolicy = new FakeFileAccessPolicy(); + + private final DownloadApplicationService service = + new DefaultDownloadApplicationService(metadata, content, accessPolicy); + + @Test + void readyFileExposesOnlyImmutableContentFacts() { + FileRecord ready = ReadyFileFixture.ready(metadata, SIZE, DIGEST); + + DownloadDescriptor descriptor = + service.describe(DownloadRequest.of(ready.fileId()), FileserverFixtures.context()); + + assertThat(descriptor.representation().length()).isEqualTo(SIZE); + assertThat(descriptor.representation().sha256()).isEqualTo(DIGEST); + assertThat(descriptor.contentKey()).isEqualTo(ready.contentKey().orElseThrow()); + assertThat(descriptor.filename().value()).isEqualTo(ready.originalName()); + } + + @Test + void authorizationRunsBeforeStateCheckAndBeforeAnyContentOpen() { + FileRecord verifying = ReadyFileFixture.verifying(metadata, SIZE, DIGEST); + accessPolicy.deny(FileOperation.DOWNLOAD); + + assertThatThrownBy( + () -> + service.describe( + DownloadRequest.of(verifying.fileId()), FileserverFixtures.context())) + .isInstanceOf(FileAccessDeniedException.class); + + assertThat(content.neverOpened()).isTrue(); + } + + @Test + void nonReadyFileIsRejectedAndNeverOpened() { + FileRecord verifying = ReadyFileFixture.verifying(metadata, SIZE, DIGEST); + + assertThatThrownBy( + () -> + service.describe( + DownloadRequest.of(verifying.fileId()), FileserverFixtures.context())) + .isInstanceOf(FileNotReadyException.class); + + assertThat(content.neverOpened()).isTrue(); + } + + @Test + void unknownFileIsNotFound() { + assertThatThrownBy( + () -> + service.describe( + DownloadRequest.of(FileId.of(UUID.randomUUID())), FileserverFixtures.context())) + .isInstanceOf(FileNotFoundException.class); + } + + @Test + void openingContentReadsExactlyTheExplicitApplicationRange() throws Exception { + FileRecord ready = ReadyFileFixture.ready(metadata, SIZE, DIGEST); + content.store(new byte[] {0, 1, 2, 3, 4, 5, 6, 7, 8, 9}); + + DownloadDescriptor descriptor = + service.describe(DownloadRequest.of(ready.fileId()), FileserverFixtures.context()); + ByteRange range = ByteRange.of(2, 4); + ByteBuffer buffer = ByteBuffer.allocate(8); + try (ReadableByteChannel channel = service.openContent(descriptor, range)) { + channel.read(buffer); + } + + assertThat(buffer.array()).startsWith(new byte[] {2, 3, 4}); + assertThat(content.opened()).containsExactly(range); + } + + @Test + void metadataReadIsItsOwnAuthorizedOperation() { + FileRecord ready = ReadyFileFixture.ready(metadata, SIZE, DIGEST); + + assertThat(service.describeFile(ready.fileId(), FileserverFixtures.context()).isDownloadable()) + .isTrue(); + assertThat(accessPolicy.invocations()).containsExactly(FileOperation.READ_METADATA); + } +} diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/lifecycle/FileLifecycleServiceTest.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/lifecycle/FileLifecycleServiceTest.java similarity index 99% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/lifecycle/FileLifecycleServiceTest.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/lifecycle/FileLifecycleServiceTest.java index cb83053d..2e5238ac 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/lifecycle/FileLifecycleServiceTest.java +++ b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/lifecycle/FileLifecycleServiceTest.java @@ -182,7 +182,7 @@ class FileLifecycleServiceTest { service.move( ready.fileId(), StorageNamespace.of("tenant-b"), - Optional.of("\"" + DIGEST + "\""), + Optional.of(DIGEST), FileserverFixtures.context()); assertThat(moved.descriptor().namespace()).isEqualTo(StorageNamespace.of("tenant-b")); diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/observability/FileserverObservabilityTest.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/observability/FileserverObservabilityTest.java similarity index 97% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/observability/FileserverObservabilityTest.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/observability/FileserverObservabilityTest.java index 980952d8..affc9182 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/observability/FileserverObservabilityTest.java +++ b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/observability/FileserverObservabilityTest.java @@ -3,7 +3,7 @@ package dev.caskeleton.application.fileserver.observability; import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.assertThatThrownBy; -import dev.caskeleton.application.fileserver.api.transfer.UploadProtocol; +import dev.caskeleton.application.fileserver.api.transfer.UploadMode; import java.lang.reflect.Method; import java.nio.charset.StandardCharsets; import java.time.Duration; @@ -124,7 +124,7 @@ class FileserverObservabilityTest { FileserverMetricsPort metrics = FileserverMetricsPort.noop(); metrics.recordUpload( - UploadProtocol.RAW, "LOCAL", "READY", SizeBucket.MEDIUM, Duration.ofMillis(10), 1024); + UploadMode.SINGLE_SHOT, "LOCAL", "READY", SizeBucket.MEDIUM, Duration.ofMillis(10), 1024); metrics.recordDownload("DIRECT", "FULL", "OK", SizeBucket.SMALL, Duration.ofMillis(5), 512); metrics.recordAccessDenial("DOWNLOAD", "TENANT_MISMATCH"); diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/quota/TransferAdmissionControllerTest.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/quota/TransferAdmissionControllerTest.java similarity index 84% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/quota/TransferAdmissionControllerTest.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/quota/TransferAdmissionControllerTest.java index 0d6b1b62..db23c33c 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/quota/TransferAdmissionControllerTest.java +++ b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/quota/TransferAdmissionControllerTest.java @@ -144,6 +144,40 @@ class TransferAdmissionControllerTest { permits.forEach(TransferPermit::close); } + @Test + void scopeSemaphoreRegistryIsBoundedAndOverflowScopesShareConservativeCapacity() { + for (int index = 0; + index < DefaultTransferAdmissionController.MAX_TRACKED_SCOPES + 32; + index++) { + try (TransferPermit ignored = controller.acquireUpload(scope("tenant-" + index), 10)) { + assertThat(ignored.isHeld()).isTrue(); + } + } + + assertThat(controller.trackedScopeCount()) + .isEqualTo(DefaultTransferAdmissionController.MAX_TRACKED_SCOPES); + + List overflow = new ArrayList<>(); + for (int index = 0; + index < TransferAdmissionProperties.standard().scopeUploadPermits(); + index++) { + overflow.add( + controller.acquireUpload( + scope("overflow-" + (DefaultTransferAdmissionController.MAX_TRACKED_SCOPES + index)), + 10)); + } + + assertThatThrownBy( + () -> + controller.acquireUpload( + scope( + "overflow-blocked-" + + DefaultTransferAdmissionController.MAX_TRACKED_SCOPES), + 10)) + .isInstanceOf(QuotaExceededException.class); + overflow.forEach(TransferPermit::close); + } + @Test void directDownloadPermitsAreBoundedIndependentlyOfUploads() { DefaultTransferAdmissionController narrow = diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/recovery/FileReconciliationServiceTest.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/recovery/FileReconciliationServiceTest.java similarity index 99% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/recovery/FileReconciliationServiceTest.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/recovery/FileReconciliationServiceTest.java index dfacb1d4..7fbb409c 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/recovery/FileReconciliationServiceTest.java +++ b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/recovery/FileReconciliationServiceTest.java @@ -199,7 +199,6 @@ class FileReconciliationServiceTest { java.util.Optional.of(KEY), java.util.OptionalLong.of(10), java.util.Optional.of(FileserverFixtures.DIGEST), - java.util.Optional.of("\"" + FileserverFixtures.DIGEST + "\""), java.util.Optional.empty(), java.util.Optional.empty(), java.util.Optional.empty()); diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/DirectTransactions.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/DirectTransactions.java similarity index 72% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/DirectTransactions.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/DirectTransactions.java index 149dcd06..fb16782f 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/DirectTransactions.java +++ b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/DirectTransactions.java @@ -1,6 +1,8 @@ package dev.caskeleton.application.fileserver.testkit; -import dev.caskeleton.application.transaction.TransactionPort; +import dev.caskeleton.application.transaction.PolicyTransactionPort; +import dev.caskeleton.application.transaction.TransactionRequest; +import dev.caskeleton.application.transaction.TransactionResult; import java.util.ArrayList; import java.util.List; import java.util.function.Supplier; @@ -14,7 +16,7 @@ import java.util.function.Supplier; * {@link #openedWrites()} lets a test assert that two writes which must commit together were asked * for inside one boundary rather than two. */ -public final class DirectTransactions implements TransactionPort { +public final class DirectTransactions implements PolicyTransactionPort { private final List opened = new ArrayList<>(); @@ -50,4 +52,10 @@ public final class DirectTransactions implements TransactionPort { opened.add("new"); return action.get(); } + + @Override + public TransactionResult inTransaction(TransactionRequest request, Supplier action) { + opened.add("policy:" + request.policyId().name()); + return new TransactionResult.Committed<>(action.get(), request.operationId()); + } } diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeAdminPorts.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeAdminPorts.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeAdminPorts.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeAdminPorts.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeCleanupContentGateway.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeCleanupContentGateway.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeCleanupContentGateway.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeCleanupContentGateway.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeCopyContentGateway.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeCopyContentGateway.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeCopyContentGateway.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeCopyContentGateway.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeDownloadContentGateway.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeDownloadContentGateway.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeDownloadContentGateway.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeDownloadContentGateway.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeFileAccessPolicy.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeFileAccessPolicy.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeFileAccessPolicy.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeFileAccessPolicy.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeFileQuotaService.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeFileQuotaService.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeFileQuotaService.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeFileQuotaService.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeQuotaCommitGateway.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeQuotaCommitGateway.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeQuotaCommitGateway.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeQuotaCommitGateway.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeReconciliationContentProbe.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeReconciliationContentProbe.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeReconciliationContentProbe.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeReconciliationContentProbe.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeUploadContentGateway.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeUploadContentGateway.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeUploadContentGateway.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeUploadContentGateway.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeUploadStorageGateway.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeUploadStorageGateway.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeUploadStorageGateway.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FakeUploadStorageGateway.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FileserverFixtures.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FileserverFixtures.java similarity index 98% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FileserverFixtures.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FileserverFixtures.java index a945bd00..a6146be6 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/FileserverFixtures.java +++ b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/FileserverFixtures.java @@ -7,7 +7,7 @@ import dev.caskeleton.application.fileserver.api.metadata.FileRecordDraft; import dev.caskeleton.application.fileserver.api.metadata.UploadSession; import dev.caskeleton.application.fileserver.api.security.FileAccessSubject; import dev.caskeleton.application.fileserver.api.security.RequestContext; -import dev.caskeleton.application.fileserver.api.transfer.UploadProtocol; +import dev.caskeleton.application.fileserver.api.transfer.UploadMode; import java.time.Instant; import java.util.Optional; import java.util.OptionalLong; @@ -36,7 +36,7 @@ public final class FileserverFixtures { return new UploadSession( UploadId.of(UUID.randomUUID()), fileId, - UploadProtocol.RAW, + UploadMode.SINGLE_SHOT, OptionalLong.of(expectedLength), committedOffset, NOW.plusSeconds(3600), diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryCleanupQueue.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryCleanupQueue.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryCleanupQueue.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryCleanupQueue.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryFileMetadataStore.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryFileMetadataStore.java similarity index 98% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryFileMetadataStore.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryFileMetadataStore.java index 51740f03..38277087 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryFileMetadataStore.java +++ b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryFileMetadataStore.java @@ -59,7 +59,6 @@ public final class InMemoryFileMetadataStore implements FileMetadataStore { Optional.empty(), Optional.empty(), Optional.empty(), - Optional.empty(), 0, now, now); @@ -127,7 +126,6 @@ public final class InMemoryFileMetadataStore implements FileMetadataStore { current.expectedSize(), mutation.actualSize().isPresent() ? mutation.actualSize() : current.actualSize(), mutation.sha256().or(current::sha256), - mutation.strongEtag().or(current::strongEtag), mutation.publishedAt().or(current::publishedAt), mutation.lastErrorCode().or(current::lastErrorCode), current.version() + 1, @@ -164,7 +162,6 @@ public final class InMemoryFileMetadataStore implements FileMetadataStore { current.expectedSize(), current.actualSize(), current.sha256(), - current.strongEtag(), current.publishedAt(), current.lastErrorCode(), current.version() + 1, diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryRecoveryQueue.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryRecoveryQueue.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryRecoveryQueue.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryRecoveryQueue.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryUploadSessionStore.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryUploadSessionStore.java similarity index 98% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryUploadSessionStore.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryUploadSessionStore.java index 97f9a44c..244d1b06 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryUploadSessionStore.java +++ b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/InMemoryUploadSessionStore.java @@ -39,7 +39,7 @@ public final class InMemoryUploadSessionStore implements UploadSessionStore { new UploadSession( draft.uploadId(), draft.fileId(), - draft.protocol(), + draft.mode(), draft.expectedLength(), 0, draft.expiresAt(), @@ -208,7 +208,7 @@ public final class InMemoryUploadSessionStore implements UploadSessionStore { return new UploadSession( current.uploadId(), current.fileId(), - current.protocol(), + current.mode(), current.expectedLength(), committedOffset, current.expiresAt(), @@ -226,7 +226,7 @@ public final class InMemoryUploadSessionStore implements UploadSessionStore { return new UploadSession( current.uploadId(), current.fileId(), - current.protocol(), + current.mode(), current.expectedLength(), current.committedOffset(), current.expiresAt(), diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/ReadyFileFixture.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/ReadyFileFixture.java similarity index 94% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/ReadyFileFixture.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/ReadyFileFixture.java index 0a7cff58..71ede035 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/ReadyFileFixture.java +++ b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/ReadyFileFixture.java @@ -29,11 +29,7 @@ public final class ReadyFileFixture { FileState.VERIFYING, FileState.READY, FileRecordMutation.publishAt( - ContentKey.of(CONTENT_KEY), - size, - sha256, - "\"" + sha256 + "\"", - Instant.parse("2026-08-07T10:00:00Z"))); + ContentKey.of(CONTENT_KEY), size, sha256, Instant.parse("2026-08-07T10:00:00Z"))); } /** diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/RecordingQuotaReclaimGateway.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/RecordingQuotaReclaimGateway.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/RecordingQuotaReclaimGateway.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/RecordingQuotaReclaimGateway.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/SequentialUploadIdentifierFactory.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/SequentialUploadIdentifierFactory.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/testkit/SequentialUploadIdentifierFactory.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/testkit/SequentialUploadIdentifierFactory.java diff --git a/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/upload/DefaultSingleShotUploadServiceTest.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/upload/DefaultSingleShotUploadServiceTest.java new file mode 100644 index 00000000..b0f7691b --- /dev/null +++ b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/upload/DefaultSingleShotUploadServiceTest.java @@ -0,0 +1,143 @@ +package dev.caskeleton.application.fileserver.upload; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +import dev.caskeleton.application.fileserver.api.FileId; +import dev.caskeleton.application.fileserver.api.UploadId; +import dev.caskeleton.application.fileserver.api.error.AmbiguousCompletionException; +import dev.caskeleton.application.fileserver.api.metadata.UploadSession; +import dev.caskeleton.application.fileserver.api.security.RequestContext; +import dev.caskeleton.application.fileserver.api.transfer.UploadMode; +import dev.caskeleton.application.fileserver.testkit.FileserverFixtures; +import java.io.ByteArrayInputStream; +import java.nio.channels.Channels; +import java.nio.channels.ReadableByteChannel; +import java.util.Optional; +import java.util.OptionalLong; +import java.util.UUID; +import org.junit.jupiter.api.Test; + +class DefaultSingleShotUploadServiceTest { + + private static final UploadId UPLOAD_ID = + UploadId.of(UUID.fromString("00000000-0000-7000-8000-000000000041")); + private static final FileId FILE_ID = + FileId.of(UUID.fromString("00000000-0000-7000-8000-000000000042")); + + @Test + void appendFailureCancelsTheCreatedUploadBeforePropagating() { + RuntimeException failure = new IllegalStateException("append failed"); + RecordingUploadService upload = new RecordingUploadService(failure); + DefaultSingleShotUploadService service = + new DefaultSingleShotUploadService(upload, new NeverFinalize()); + + assertThatThrownBy(() -> upload(service)).isSameAs(failure); + assertThat(upload.cancelCalls).isEqualTo(1); + } + + @Test + void ambiguousFinalizeIsLeftForReconciliationInsteadOfBlindCancellation() { + RecordingUploadService upload = new RecordingUploadService(null); + AmbiguousCompletionException ambiguous = + AmbiguousCompletionException.forUpload("publish outcome unknown", UPLOAD_ID); + DefaultSingleShotUploadService service = + new DefaultSingleShotUploadService(upload, new AmbiguousFinalize(ambiguous)); + + assertThatThrownBy(() -> upload(service)).isSameAs(ambiguous); + assertThat(upload.cancelCalls).isZero(); + } + + private static void upload(DefaultSingleShotUploadService service) { + try (ReadableByteChannel content = + Channels.newChannel(new ByteArrayInputStream(new byte[] {1, 2, 3}))) { + service.upload( + new CreateUploadRequest( + FileserverFixtures.NAMESPACE, + "report.bin", + Optional.of("application/octet-stream"), + OptionalLong.of(3), + Optional.empty(), + UploadMode.SINGLE_SHOT, + FileserverFixtures.NOW.plusSeconds(3600)), + content, + 3, + FinalizeUploadRequest.synchronousWithoutDigest(), + FileserverFixtures.context()); + } catch (java.io.IOException impossible) { + throw new IllegalStateException(impossible); + } + } + + private static final class RecordingUploadService implements UploadApplicationService { + private final RuntimeException appendFailure; + private int cancelCalls; + + RecordingUploadService(RuntimeException appendFailure) { + this.appendFailure = appendFailure; + } + + @Override + public UploadSessionView create(CreateUploadRequest request, RequestContext context) { + return new UploadSessionView( + UPLOAD_ID, FILE_ID, 0, OptionalLong.of(3), FileserverFixtures.NOW.plusSeconds(3600)); + } + + @Override + public AppendUploadResult append( + UploadId uploadId, + long expectedOffset, + ReadableByteChannel content, + long contentLength, + RequestContext context) { + if (appendFailure != null) { + throw appendFailure; + } + return new AppendUploadResult(3, 3, FileserverFixtures.DIGEST); + } + + @Override + public UploadSessionView status(UploadId uploadId, RequestContext context) { + throw new UnsupportedOperationException(); + } + + @Override + public void cancel(UploadId uploadId, RequestContext context) { + cancelCalls++; + } + } + + private static final class NeverFinalize implements FinalizeUploadService { + @Override + public FileView finalizeUpload( + UploadSession session, FinalizeUploadRequest request, RequestContext context) { + throw new AssertionError("finalize must not run after append failure"); + } + + @Override + public FileView finalizeUpload( + UploadId uploadId, FinalizeUploadRequest request, RequestContext context) { + throw new AssertionError("finalize must not run after append failure"); + } + } + + private static final class AmbiguousFinalize implements FinalizeUploadService { + private final AmbiguousCompletionException failure; + + AmbiguousFinalize(AmbiguousCompletionException failure) { + this.failure = failure; + } + + @Override + public FileView finalizeUpload( + UploadSession session, FinalizeUploadRequest request, RequestContext context) { + throw new UnsupportedOperationException(); + } + + @Override + public FileView finalizeUpload( + UploadId uploadId, FinalizeUploadRequest request, RequestContext context) { + throw failure; + } + } +} diff --git a/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/upload/FileserverCompensationTransactionTest.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/upload/FileserverCompensationTransactionTest.java new file mode 100644 index 00000000..609c460a --- /dev/null +++ b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/upload/FileserverCompensationTransactionTest.java @@ -0,0 +1,122 @@ +package dev.caskeleton.application.fileserver.upload; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +import dev.caskeleton.application.transaction.PolicyTransactionPort; +import dev.caskeleton.application.transaction.TransactionPhase; +import dev.caskeleton.application.transaction.TransactionRequest; +import dev.caskeleton.application.transaction.TransactionResult; +import java.util.Optional; +import java.util.concurrent.atomic.AtomicBoolean; +import java.util.function.Supplier; +import org.junit.jupiter.api.Test; + +class FileserverCompensationTransactionTest { + + @Test + void committedCompensationReturnsNormally() { + AtomicBoolean invoked = new AtomicBoolean(); + + FileserverCompensationTransaction.run( + new StubTransactions(ResultMode.COMMITTED), + "fileserver-compensation-1", + () -> invoked.set(true)); + + assertThat(invoked).isTrue(); + } + + @Test + void determinateRollbackPropagatesTheRollbackFailure() { + IllegalStateException failure = new IllegalStateException("rolled back"); + + assertThatThrownBy( + () -> + FileserverCompensationTransaction.run( + new StubTransactions(ResultMode.ROLLBACK, failure), + "fileserver-compensation-2", + () -> {})) + .isSameAs(failure); + } + + @Test + void indeterminateOutcomeIsNeverReportedAsSuccessfulCompensation() { + assertThatThrownBy( + () -> + FileserverCompensationTransaction.run( + new StubTransactions(ResultMode.INDETERMINATE), + "fileserver-compensation-3", + () -> {})) + .isInstanceOf(IllegalStateException.class) + .hasMessageContaining("indeterminate") + .hasMessageContaining("fileserver-compensation-3"); + } + + @Test + void postCommitOperationalFailureIsSurfacedWithoutTreatingTheCommitAsRollback() { + IllegalStateException failure = new IllegalStateException("post-commit callback failed"); + + assertThatThrownBy( + () -> + FileserverCompensationTransaction.run( + new StubTransactions(ResultMode.POST_COMMIT_FAILURE, failure), + "fileserver-compensation-4", + () -> {})) + .isSameAs(failure); + } + + private enum ResultMode { + COMMITTED, + POST_COMMIT_FAILURE, + ROLLBACK, + INDETERMINATE + } + + private static final class StubTransactions implements PolicyTransactionPort { + private final ResultMode mode; + private final RuntimeException rollbackFailure; + + private StubTransactions(ResultMode mode) { + this(mode, new IllegalStateException("rollback")); + } + + private StubTransactions(ResultMode mode, RuntimeException rollbackFailure) { + this.mode = mode; + this.rollbackFailure = rollbackFailure; + } + + @Override + public TransactionResult inTransaction(TransactionRequest request, Supplier action) { + return switch (mode) { + case COMMITTED -> new TransactionResult.Committed<>(action.get(), request.operationId()); + case POST_COMMIT_FAILURE -> + new TransactionResult.CommittedWithPostCommitFailure<>( + action.get(), request.operationId(), rollbackFailure); + case ROLLBACK -> new TransactionResult.DeterminateRollback<>(rollbackFailure); + case INDETERMINATE -> + new TransactionResult.Indeterminate<>( + request.operationId(), TransactionPhase.COMMIT_REQUESTED, Optional.empty()); + }; + } + + @Override + public T inWrite(Supplier action) { + return action.get(); + } + + @Override + public T inRootWrite(Supplier action) { + return action.get(); + } + + @Override + public T inRead(Supplier action) { + return action.get(); + } + + @Override + public T inNew(Supplier action) { + return action.get(); + } + } +} diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/upload/FinalizeUploadServiceTest.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/upload/FinalizeUploadServiceTest.java similarity index 96% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/upload/FinalizeUploadServiceTest.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/upload/FinalizeUploadServiceTest.java index f1140d9b..87e559df 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/upload/FinalizeUploadServiceTest.java +++ b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/upload/FinalizeUploadServiceTest.java @@ -38,6 +38,7 @@ class FinalizeUploadServiceTest { private final InMemoryCleanupQueue cleanup = new InMemoryCleanupQueue(); private final InMemoryRecoveryQueue recovery = new InMemoryRecoveryQueue(); + private final DirectTransactions transactions = new DirectTransactions(); private VerificationResult verdict = VerificationResult.accept("ALL_CHECKS_PASSED"); private FinalizeUploadService service; @@ -53,7 +54,7 @@ class FinalizeUploadServiceTest { cleanup, recovery, PublishMode.ATOMIC_MOVE_PREFERRED, - new DirectTransactions(), + transactions, Clock.fixed(FileserverFixtures.NOW, ZoneOffset.UTC)); } @@ -73,7 +74,7 @@ class FinalizeUploadServiceTest { assertThat(content.contentExists(stored.contentKey().orElseThrow())).isTrue(); assertThat(stored.actualSize()).hasValue(10); assertThat(stored.sha256()).contains(FileserverFixtures.DIGEST); - assertThat(stored.strongEtag()).contains("\"" + FileserverFixtures.DIGEST + "\""); + assertThat(stored.sha256()).contains(FileserverFixtures.DIGEST); assertThat(stored.publishedAt()).contains(FileserverFixtures.NOW); } @@ -208,6 +209,9 @@ class FinalizeUploadServiceTest { }); assertThat(recovery.reasons()).containsValue("READY_COMMIT_UNCONFIRMED"); + assertThat(transactions.openedWrites()) + .as("recovery must survive the failed ambient READY transaction") + .endsWith("policy:MAINTENANCE_NEW"); assertThat(metadata.find(verifyingRecord.fileId()).orElseThrow().state()) .isNotEqualTo(FileState.READY); assertThat(quota.anyCommitted()).isFalse(); diff --git a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/upload/UploadApplicationServiceTest.java b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/upload/UploadApplicationServiceTest.java similarity index 96% rename from src/application-core/src/test/java/dev/caskeleton/application/fileserver/upload/UploadApplicationServiceTest.java rename to src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/upload/UploadApplicationServiceTest.java index 077a7cdf..ea2e290a 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/fileserver/upload/UploadApplicationServiceTest.java +++ b/src/application-fileserver/src/test/java/dev/caskeleton/application/fileserver/upload/UploadApplicationServiceTest.java @@ -13,7 +13,7 @@ import dev.caskeleton.application.fileserver.api.error.UploadExpiredException; import dev.caskeleton.application.fileserver.api.error.UploadOffsetMismatchException; import dev.caskeleton.application.fileserver.api.security.FileOperation; import dev.caskeleton.application.fileserver.api.security.OriginalFilenamePolicy; -import dev.caskeleton.application.fileserver.api.transfer.UploadProtocol; +import dev.caskeleton.application.fileserver.api.transfer.UploadMode; import dev.caskeleton.application.fileserver.concurrency.DefaultWriterLeaseCoordinator; import dev.caskeleton.application.fileserver.observability.FileserverMetricsPort; import dev.caskeleton.application.fileserver.quota.DefaultTransferAdmissionController; @@ -48,6 +48,7 @@ class UploadApplicationServiceTest { private final FakeFileQuotaService quota = new FakeFileQuotaService(); private final FakeFileAccessPolicy accessPolicy = new FakeFileAccessPolicy(); private final InMemoryCleanupQueue cleanup = new InMemoryCleanupQueue(); + private final DirectTransactions transactions = new DirectTransactions(); private final UploadApplicationService service = serviceAt(FileserverFixtures.NOW); @@ -125,7 +126,7 @@ class UploadApplicationServiceTest { Optional.of("application/octet-stream"), OptionalLong.of(3), Optional.empty(), - UploadProtocol.RAW, + UploadMode.SINGLE_SHOT, FileserverFixtures.NOW.plusSeconds(3600)), FileserverFixtures.context()); @@ -142,6 +143,9 @@ class UploadApplicationServiceTest { .isInstanceOf(StorageUnavailableException.class); assertThat(quota.anyReleased()).isTrue(); + assertThat(transactions.openedWrites()) + .as("filesystem-create compensation must commit independently of an ambient transaction") + .endsWith("policy:MAINTENANCE_NEW"); assertThat(metadata.findRecoverable(recoveryQuery()).stream().map(record -> record.state())) .containsOnly(FileState.FAILED); } @@ -217,7 +221,7 @@ class UploadApplicationServiceTest { Optional.empty(), OptionalLong.of(MAX_FILE + 1), Optional.empty(), - UploadProtocol.RAW, + UploadMode.SINGLE_SHOT, FileserverFixtures.NOW.plusSeconds(3600)), FileserverFixtures.context())) .isInstanceOf(FileTooLargeException.class); @@ -281,7 +285,7 @@ class UploadApplicationServiceTest { new SequentialUploadIdentifierFactory(), UploadPolicy.standard(), FileserverMetricsPort.noop(), - new DirectTransactions(), + transactions, clock); } @@ -302,7 +306,7 @@ class UploadApplicationServiceTest { Optional.of("application/octet-stream"), OptionalLong.of(expectedLength), Optional.empty(), - UploadProtocol.RAW, + UploadMode.SINGLE_SHOT, FileserverFixtures.NOW.plusSeconds(3600)); } diff --git a/src/application-notification/build.gradle b/src/application-notification/build.gradle new file mode 100644 index 00000000..6ed7f34f --- /dev/null +++ b/src/application-notification/build.gradle @@ -0,0 +1,9 @@ +plugins { + id 'ca.java-library' +} + +// Optional notification application product. The generic application contracts remain in +// application-core; this leaf contains the notification platform policy/use cases only. +dependencies { + implementation project(':application-core') +} diff --git a/src/application-notification/gradle.lockfile b/src/application-notification/gradle.lockfile new file mode 100644 index 00000000..e2c95854 --- /dev/null +++ b/src/application-notification/gradle.lockfile @@ -0,0 +1,84 @@ +# This is a Gradle generated file for dependency locking. +# Manual edits can break the build and are not advised. +# This file is expected to be part of source control. +com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,testAnnotationProcessor +com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,testAnnotationProcessor +com.github.spotbugs:spotbugs-annotations:4.10.2=spotbugs +com.github.spotbugs:spotbugs:4.10.2=spotbugs +com.github.stephenc.jcip:jcip-annotations:1.0-1=spotbugs +com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,testAnnotationProcessor +com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,testAnnotationProcessor +com.google.auto:auto-common:1.2.2=annotationProcessor,testAnnotationProcessor +com.google.code.findbugs:jsr305:3.0.2=checkstyle,spotbugs +com.google.code.gson:gson:2.13.2=spotbugs +com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.41.0=spotbugs +com.google.errorprone:error_prone_annotations:2.47.0=checkstyle +com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,testAnnotationProcessor +com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.guava:guava:33.5.0-jre=annotationProcessor,testAnnotationProcessor +com.google.guava:guava:33.6.0-jre=checkstyle +com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,testAnnotationProcessor +com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins +com.puppycrawl.tools:checkstyle:13.5.0=checkstyle +commons-beanutils:commons-beanutils:1.11.0=checkstyle +commons-collections:commons-collections:3.2.2=checkstyle +commons-io:commons-io:2.21.0=spotbugs +info.picocli:picocli:4.7.7=checkstyle +io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,testAnnotationProcessor +io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,testAnnotationProcessor +javax.inject:javax.inject:1=annotationProcessor,testAnnotationProcessor +jaxen:jaxen:2.0.6=spotbugs +net.bytebuddy:byte-buddy:1.17.8=testCompileClasspath,testRuntimeClasspath +net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs +org.antlr:antlr4-runtime:4.13.2=checkstyle +org.apache.bcel:bcel:6.12.0=spotbugs +org.apache.commons:commons-lang3:3.20.0=checkstyle,spotbugs +org.apache.commons:commons-text:1.15.0=spotbugs +org.apache.commons:commons-text:1.3=checkstyle +org.apache.httpcomponents:httpclient:4.5.13=checkstyle +org.apache.httpcomponents:httpcore:4.4.16=checkstyle +org.apache.logging.log4j:log4j-api:2.25.5=spotbugs +org.apache.logging.log4j:log4j-core:2.25.5=spotbugs +org.apache.maven.doxia:doxia-core:1.12.0=checkstyle +org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle +org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle +org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle +org.apache.xbean:xbean-reflect:3.7=checkstyle +org.apiguardian:apiguardian-api:1.1.2=testCompileClasspath +org.assertj:assertj-core:3.27.7=testCompileClasspath,testRuntimeClasspath +org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle +org.codehaus.plexus:plexus-component-annotations:2.1.0=checkstyle +org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle +org.codehaus.plexus:plexus-utils:3.3.0=checkstyle +org.dom4j:dom4j:2.2.0=spotbugs +org.javassist:javassist:3.28.0-GA=checkstyle +org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,testAnnotationProcessor,testCompileClasspath +org.junit.jupiter:junit-jupiter-api:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-engine:6.0.3=testRuntimeClasspath +org.junit.jupiter:junit-jupiter-params:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-commons:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-engine:6.0.3=testRuntimeClasspath +org.junit.platform:junit-platform-launcher:6.0.3=testRuntimeClasspath +org.junit:junit-bom:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit:junit-bom:6.1.0=spotbugs +org.mockito:mockito-core:5.20.0=mockitoAgent +org.opentest4j:opentest4j:1.3.0=testCompileClasspath,testRuntimeClasspath +org.ow2.asm:asm-analysis:9.10.1=spotbugs +org.ow2.asm:asm-commons:9.10.1=spotbugs +org.ow2.asm:asm-tree:9.10.1=spotbugs +org.ow2.asm:asm-util:9.10.1=spotbugs +org.ow2.asm:asm:9.10.1=spotbugs +org.pcollections:pcollections:4.0.1=annotationProcessor,testAnnotationProcessor +org.reflections:reflections:0.10.2=checkstyle +org.slf4j:slf4j-api:2.0.18=spotbugs,spotbugsSlf4j +org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j +org.slf4j:slf4j-simple:2.0.18=checkstyle +org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs +empty=compileClasspath,runtimeClasspath diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/ApplyNotificationReceiptCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/ApplyNotificationReceiptCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/ApplyNotificationReceiptCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/ApplyNotificationReceiptCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/ApplyNotificationReceiptResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/ApplyNotificationReceiptResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/ApplyNotificationReceiptResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/ApplyNotificationReceiptResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/ApplyNotificationReceiptUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/ApplyNotificationReceiptUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/ApplyNotificationReceiptUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/ApplyNotificationReceiptUseCase.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/ConsentCheckMode.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/ConsentCheckMode.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/ConsentCheckMode.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/ConsentCheckMode.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/EmailRecipientReference.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/EmailRecipientReference.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/EmailRecipientReference.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/EmailRecipientReference.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesOperation.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesOperation.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesOperation.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesOperation.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesUseCase.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/InlineNotificationAttemptPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/InlineNotificationAttemptPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/InlineNotificationAttemptPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/InlineNotificationAttemptPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NormalizedNotificationReceiptCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NormalizedNotificationReceiptCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NormalizedNotificationReceiptCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NormalizedNotificationReceiptCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/Notification.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/Notification.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/Notification.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/Notification.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationAdmissionClass.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationAdmissionClass.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationAdmissionClass.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationAdmissionClass.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationAdmissionGateCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationAdmissionGateCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationAdmissionGateCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationAdmissionGateCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationAdmissionGateUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationAdmissionGateUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationAdmissionGateUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationAdmissionGateUseCase.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationAdmissionReadinessPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationAdmissionReadinessPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationAdmissionReadinessPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationAdmissionReadinessPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationAppendResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationAppendResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationAppendResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationAppendResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationApplicationException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationApplicationException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationApplicationException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationApplicationException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationAttemptId.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationAttemptId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationAttemptId.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationAttemptId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationCanonicalWriterFenceGuard.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationCanonicalWriterFenceGuard.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationCanonicalWriterFenceGuard.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationCanonicalWriterFenceGuard.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationCanonicalWriterFencePort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationCanonicalWriterFencePort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationCanonicalWriterFencePort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationCanonicalWriterFencePort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationCanonicalWriterRouteSet.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationCanonicalWriterRouteSet.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationCanonicalWriterRouteSet.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationCanonicalWriterRouteSet.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationCapabilityCompatibilityValidator.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationCapabilityCompatibilityValidator.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationCapabilityCompatibilityValidator.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationCapabilityCompatibilityValidator.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationChannel.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationChannel.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationChannel.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationChannel.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationDeliveryId.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationDeliveryId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationDeliveryId.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationDeliveryId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationDeliveryStorePort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationDeliveryStorePort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationDeliveryStorePort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationDeliveryStorePort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationDispatchCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationDispatchCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationDispatchCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationDispatchCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationDispatchResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationDispatchResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationDispatchResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationDispatchResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationDispatchUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationDispatchUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationDispatchUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationDispatchUseCase.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationEvidenceTrustSnapshot.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationEvidenceTrustSnapshot.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationEvidenceTrustSnapshot.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationEvidenceTrustSnapshot.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationFaultScope.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationFaultScope.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationFaultScope.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationFaultScope.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationFrozenPlan.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationFrozenPlan.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationFrozenPlan.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationFrozenPlan.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationIntentAppendPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationIntentAppendPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationIntentAppendPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationIntentAppendPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationIntentDraft.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationIntentDraft.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationIntentDraft.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationIntentDraft.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationIntentId.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationIntentId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationIntentId.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationIntentId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationKindId.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationKindId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationKindId.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationKindId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationKindPolicy.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationKindPolicy.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationKindPolicy.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationKindPolicy.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationLegacyWriterPermitCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationLegacyWriterPermitCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationLegacyWriterPermitCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationLegacyWriterPermitCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationLegacyWriterPermitResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationLegacyWriterPermitResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationLegacyWriterPermitResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationLegacyWriterPermitResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationLegacyWriterPermitUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationLegacyWriterPermitUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationLegacyWriterPermitUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationLegacyWriterPermitUseCase.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationMaintenanceCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationMaintenanceCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationMaintenanceCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationMaintenanceCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationMaintenanceResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationMaintenanceResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationMaintenanceResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationMaintenanceResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationMaintenanceStorePort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationMaintenanceStorePort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationMaintenanceStorePort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationMaintenanceStorePort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationMaintenanceUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationMaintenanceUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationMaintenanceUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationMaintenanceUseCase.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationMode.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationMode.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationMode.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationMode.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationOperationsSnapshot.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationOperationsSnapshot.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationOperationsSnapshot.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationOperationsSnapshot.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationOperationsSnapshotPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationOperationsSnapshotPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationOperationsSnapshotPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationOperationsSnapshotPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationOperationsSnapshotQuery.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationOperationsSnapshotQuery.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationOperationsSnapshotQuery.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationOperationsSnapshotQuery.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationOperationsSnapshotUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationOperationsSnapshotUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationOperationsSnapshotUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationOperationsSnapshotUseCase.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationPlanPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationPlanPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationPlanPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationPlanPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationPlanningResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationPlanningResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationPlanningResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationPlanningResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationPort.java similarity index 85% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationPort.java index 105c3f75..fdd482ff 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationPort.java +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationPort.java @@ -14,7 +14,7 @@ public interface NotificationPort { * @param channel delivery channel (compile-safe) * @param notification content to deliver (contains PII — never log this value) */ - default void notify(Channel channel, Notification notification) { + default void notify(NotificationChannel channel, Notification notification) { notify(channel, "default", notification); } @@ -25,5 +25,5 @@ public interface NotificationPort { * @param route logical route name bound in {@code app.notification.routes} * @param notification content to deliver (contains PII — never log this value) */ - void notify(Channel channel, String route, Notification notification); + void notify(NotificationChannel channel, String route, Notification notification); } diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationProviderAttemptPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationProviderAttemptPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationProviderAttemptPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationProviderAttemptPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationProviderCapabilityDescriptor.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationProviderCapabilityDescriptor.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationProviderCapabilityDescriptor.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationProviderCapabilityDescriptor.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationReasonCode.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationReasonCode.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationReasonCode.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationReasonCode.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationReceiptEventId.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationReceiptEventId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationReceiptEventId.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationReceiptEventId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationReceiptFact.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationReceiptFact.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationReceiptFact.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationReceiptFact.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationReceiptIngressCapabilityDescriptor.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationReceiptIngressCapabilityDescriptor.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationReceiptIngressCapabilityDescriptor.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationReceiptIngressCapabilityDescriptor.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationReceiptProjection.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationReceiptProjection.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationReceiptProjection.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationReceiptProjection.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationReceiptStorePort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationReceiptStorePort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationReceiptStorePort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationReceiptStorePort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationRecipientReference.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationRecipientReference.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationRecipientReference.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationRecipientReference.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationReconciliationPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationReconciliationPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationReconciliationPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationReconciliationPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationRequestResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationRequestResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationRequestResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationRequestResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationRouteId.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationRouteId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationRouteId.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationRouteId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationRouteStrategy.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationRouteStrategy.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationRouteStrategy.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationRouteStrategy.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationSignedEvidenceHeader.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationSignedEvidenceHeader.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationSignedEvidenceHeader.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationSignedEvidenceHeader.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationStoreCapabilityDescriptor.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationStoreCapabilityDescriptor.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationStoreCapabilityDescriptor.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationStoreCapabilityDescriptor.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationTechnicalSuppressionPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationTechnicalSuppressionPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationTechnicalSuppressionPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationTechnicalSuppressionPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationTemplateParameters.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationTemplateParameters.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationTemplateParameters.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationTemplateParameters.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationTemplateRef.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationTemplateRef.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationTemplateRef.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationTemplateRef.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationTemplateValue.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationTemplateValue.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationTemplateValue.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationTemplateValue.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationWriterCutoverPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationWriterCutoverPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationWriterCutoverPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationWriterCutoverPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationWriterInventoryEvidence.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationWriterInventoryEvidence.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationWriterInventoryEvidence.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationWriterInventoryEvidence.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationWriterInventoryEvidenceVerifierPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationWriterInventoryEvidenceVerifierPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationWriterInventoryEvidenceVerifierPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationWriterInventoryEvidenceVerifierPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationWriterOwnership.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationWriterOwnership.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationWriterOwnership.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationWriterOwnership.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationWriterQuiescenceAttestationPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationWriterQuiescenceAttestationPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationWriterQuiescenceAttestationPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationWriterQuiescenceAttestationPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationWriterRouteSet.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationWriterRouteSet.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/NotificationWriterRouteSet.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/NotificationWriterRouteSet.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/ProviderAttemptOutcome.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/ProviderAttemptOutcome.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/ProviderAttemptOutcome.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/ProviderAttemptOutcome.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/ReconcileNotificationDeliveriesCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/ReconcileNotificationDeliveriesCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/ReconcileNotificationDeliveriesCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/ReconcileNotificationDeliveriesCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/ReconcileNotificationDeliveriesResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/ReconcileNotificationDeliveriesResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/ReconcileNotificationDeliveriesResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/ReconcileNotificationDeliveriesResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/ReconcileNotificationDeliveriesUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/ReconcileNotificationDeliveriesUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/ReconcileNotificationDeliveriesUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/ReconcileNotificationDeliveriesUseCase.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationOperation.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationOperation.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationOperation.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationOperation.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationUseCase.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/RetryDisposition.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/RetryDisposition.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/RetryDisposition.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/RetryDisposition.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/SignedNotificationWriterInventoryManifest.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/SignedNotificationWriterInventoryManifest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/SignedNotificationWriterInventoryManifest.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/SignedNotificationWriterInventoryManifest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/SignedNotificationWriterQuiescenceManifest.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/SignedNotificationWriterQuiescenceManifest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/SignedNotificationWriterQuiescenceManifest.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/SignedNotificationWriterQuiescenceManifest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/SlackAudienceReference.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/SlackAudienceReference.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/SlackAudienceReference.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/SlackAudienceReference.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/SubmissionCertainty.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/SubmissionCertainty.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/SubmissionCertainty.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/SubmissionCertainty.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipOperation.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipOperation.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipOperation.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipOperation.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipUseCase.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/TargetAttemptOutcome.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/TargetAttemptOutcome.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/TargetAttemptOutcome.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/TargetAttemptOutcome.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsOperation.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsOperation.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsOperation.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsOperation.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsUseCase.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminAccessDeniedException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminAccessDeniedException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminAccessDeniedException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminAccessDeniedException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminActor.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminActor.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminActor.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminActor.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminAuthorizationGuard.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminAuthorizationGuard.java similarity index 73% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminAuthorizationGuard.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminAuthorizationGuard.java index 29561f81..d4c4dd62 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminAuthorizationGuard.java +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminAuthorizationGuard.java @@ -12,9 +12,12 @@ import java.util.Optional; * authorization rule there is a rule no application test can reach and no architecture rule about * application policy can see. * - *

      Application authority never grants an operator authority. The two planes are separated so that - * a compromised application credential cannot redrive a message or lift a suppression — the actions - * whose whole purpose is to override the platform's own safety decisions. + *

      Application-core AuthorizationPort remains the canonical permission PEP for ordinary + * application operations, and ObjectAccessPolicy remains the canonical object-access axis. This + * guard is intentionally not an adapter over either one: application authority never grants an + * operator authority. The two planes are separated so that a compromised application credential + * cannot redrive a message or lift a suppression — the actions whose whole purpose is to override + * the platform's own safety decisions. */ public final class AdminAuthorizationGuard { diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationClaim.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationClaim.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationClaim.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationClaim.java diff --git a/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationCommandFingerprint.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationCommandFingerprint.java new file mode 100644 index 00000000..6da6ba16 --- /dev/null +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationCommandFingerprint.java @@ -0,0 +1,89 @@ +package dev.caskeleton.application.notification.platform.admin; + +import dev.caskeleton.application.notification.platform.dispatch.MessageDigestPort; +import java.nio.charset.StandardCharsets; +import java.util.HexFormat; +import java.util.Objects; + +/** + * Stable SHA-256 identity of an operator command, excluding the operation id itself. + * + *

      The operation id is the idempotency key. The fingerprint answers the separate question: + * whether a repeated key names the same command. Every field is length-framed so user supplied + * reason text cannot imitate a field boundary. + */ +final class AdminOperationCommandFingerprint { + + private final MessageDigestPort digests; + + AdminOperationCommandFingerprint(MessageDigestPort digests) { + this.digests = Objects.requireNonNull(digests, "digests"); + } + + String of(RedriveCommand command) { + Objects.requireNonNull(command, "command"); + StringBuilder canonical = action("REDRIVE"); + field(canonical, "attemptId", command.attemptId().value().toString()); + field(canonical, "reason", command.reason()); + field(canonical, "approveDuplicateRisk", Boolean.toString(command.approveDuplicateRisk())); + return digest(canonical); + } + + String of(ReconcileCommand command) { + Objects.requireNonNull(command, "command"); + StringBuilder canonical = action("RECONCILE"); + command.attemptIds().stream() + .map(id -> id.value().toString()) + .sorted() + .forEach(value -> field(canonical, "attemptId", value)); + field(canonical, "reason", command.reason()); + return digest(canonical); + } + + String of(SuppressCommand command) { + Objects.requireNonNull(command, "command"); + StringBuilder canonical = action(command.remove() ? "SUPPRESS_REMOVE" : "SUPPRESS_ADD"); + field(canonical, "tenantId", command.tenantId().value()); + field(canonical, "scope", command.scope().name()); + field(canonical, "reason", command.reason().name()); + field(canonical, "targetFingerprint", command.targetFingerprint()); + field( + canonical, + "expiresAt", + command.expiresAt().map(value -> Long.toString(value.toEpochMilli())).orElse("-")); + field(canonical, "reasonText", command.reasonText()); + return digest(canonical); + } + + String of(SetProviderStateCommand command) { + Objects.requireNonNull(command, "command"); + StringBuilder canonical = action("PROVIDER_STATE"); + field(canonical, "profileId", command.profileId().value()); + field(canonical, "desiredState", command.desiredState().name()); + field(canonical, "reason", command.reason()); + return digest(canonical); + } + + private String digest(StringBuilder canonical) { + byte[] bytes = canonical.toString().getBytes(StandardCharsets.UTF_8); + return HexFormat.of().formatHex(digests.sha256(bytes)); + } + + private static StringBuilder action(String action) { + StringBuilder canonical = new StringBuilder(256); + field(canonical, "action", action); + return canonical; + } + + private static void field(StringBuilder canonical, String name, String value) { + canonical + .append(name.length()) + .append(':') + .append(name) + .append(':') + .append(value.length()) + .append(':') + .append(value) + .append('\n'); + } +} diff --git a/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationConflictException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationConflictException.java new file mode 100644 index 00000000..390e34b2 --- /dev/null +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationConflictException.java @@ -0,0 +1,11 @@ +package dev.caskeleton.application.notification.platform.admin; + +/** One admin operation id was reused for a different command. */ +final class AdminOperationConflictException extends RuntimeException { + + private static final long serialVersionUID = 1L; + + AdminOperationConflictException(String operationId) { + super("admin operation id was reused for a different command: " + operationId); + } +} diff --git a/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationExecutor.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationExecutor.java new file mode 100644 index 00000000..668ef4d3 --- /dev/null +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationExecutor.java @@ -0,0 +1,44 @@ +package dev.caskeleton.application.notification.platform.admin; + +import dev.caskeleton.application.transaction.TransactionPort; +import java.util.Objects; +import java.util.function.Supplier; + +/** Serializes one destructive admin operation by its caller-supplied operation id. */ +final class AdminOperationExecutor { + + private final AdminOperationStorePort operations; + private final TransactionPort transactions; + + AdminOperationExecutor(AdminOperationStorePort operations, TransactionPort transactions) { + this.operations = Objects.requireNonNull(operations, "operations"); + this.transactions = Objects.requireNonNull(transactions, "transactions"); + } + + /** + * Claims an idempotent operator action before any side effect. + * + *

      The claim and the operation run inside one write transaction. PostgreSQL's unique claim row + * serializes a concurrent caller on the operation id; the loser observes the committed result + * instead of reaching the side effect. + */ + AdminOperationResult execute( + String operationId, + String commandFingerprint, + AdminActor actor, + String action, + Supplier operation) { + Objects.requireNonNull(operation, "operation"); + return transactions.inWrite( + () -> { + AdminOperationClaim claim = + operations.claim(operationId, commandFingerprint, actor, action); + return switch (claim.outcome()) { + case CLAIMED -> operation.get(); + case REPLAY -> claim.existing().orElseThrow(); + case IN_PROGRESS -> throw new AdminOperationInProgressException(operationId); + case CONFLICT -> throw new AdminOperationConflictException(operationId); + }; + }); + } +} diff --git a/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationInProgressException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationInProgressException.java new file mode 100644 index 00000000..04949c64 --- /dev/null +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationInProgressException.java @@ -0,0 +1,11 @@ +package dev.caskeleton.application.notification.platform.admin; + +/** The same admin operation id is currently held by another caller. */ +final class AdminOperationInProgressException extends RuntimeException { + + private static final long serialVersionUID = 1L; + + AdminOperationInProgressException(String operationId) { + super("admin operation is already in progress: " + operationId); + } +} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationStorePort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationStorePort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationStorePort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/AdminOperationStorePort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/DuplicateRiskApprovalRequiredException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/DuplicateRiskApprovalRequiredException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/DuplicateRiskApprovalRequiredException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/DuplicateRiskApprovalRequiredException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/DuplicateRiskGuard.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/DuplicateRiskGuard.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/DuplicateRiskGuard.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/DuplicateRiskGuard.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminApplicationService.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminApplicationService.java similarity index 74% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminApplicationService.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminApplicationService.java index d990d2f0..205f39d0 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminApplicationService.java +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminApplicationService.java @@ -8,6 +8,7 @@ import dev.caskeleton.application.notification.platform.api.error.NotificationFa import dev.caskeleton.application.notification.platform.api.error.ProviderConfigurationException; import dev.caskeleton.application.notification.platform.callback.DeliveryAttemptSnapshot; import dev.caskeleton.application.notification.platform.dispatch.DeliveryAttemptStorePort; +import dev.caskeleton.application.notification.platform.dispatch.MessageDigestPort; import dev.caskeleton.application.notification.platform.dispatch.RecipientDeliveryStorePort; import dev.caskeleton.application.notification.platform.dispatch.ReconciliationService; import dev.caskeleton.application.notification.platform.observation.NotificationAuditEvent; @@ -52,8 +53,9 @@ public final class NotificationAdminApplicationService implements NotificationAd private final SuppressionStorePort suppressions; private final ProviderRuntimeControlPort runtimes; private final AdminOperationStorePort operations; + private final AdminOperationExecutor operationExecutor; + private final AdminOperationCommandFingerprint commandFingerprints; private final NotificationAuditPort audit; - private final TransactionPort transactions; private final dev.caskeleton.application.notification.platform.dispatch .NotificationIdGeneratorPort ids; @@ -71,6 +73,7 @@ public final class NotificationAdminApplicationService implements NotificationAd NotificationAuditPort audit, TransactionPort transactions, dev.caskeleton.application.notification.platform.dispatch.NotificationIdGeneratorPort ids, + MessageDigestPort digests, Clock clock) { this.authorization = Objects.requireNonNull(authorization, "authorization"); this.duplicateRiskGuard = Objects.requireNonNull(duplicateRiskGuard, "duplicateRiskGuard"); @@ -80,8 +83,12 @@ public final class NotificationAdminApplicationService implements NotificationAd this.suppressions = Objects.requireNonNull(suppressions, "suppressions"); this.runtimes = Objects.requireNonNull(runtimes, "runtimes"); this.operations = Objects.requireNonNull(operations, "operations"); + this.operationExecutor = + new AdminOperationExecutor( + this.operations, Objects.requireNonNull(transactions, "transactions")); + this.commandFingerprints = + new AdminOperationCommandFingerprint(Objects.requireNonNull(digests, "digests")); this.audit = Objects.requireNonNull(audit, "audit"); - this.transactions = Objects.requireNonNull(transactions, "transactions"); this.ids = Objects.requireNonNull(ids, "ids"); this.clock = Objects.requireNonNull(clock, "clock"); } @@ -91,11 +98,6 @@ public final class NotificationAdminApplicationService implements NotificationAd Objects.requireNonNull(command, "command"); authorization.require(actor, NotificationAdminAuthority.REDRIVE); - Optional replayed = operations.findByOperationId(command.operationId()); - if (replayed.isPresent()) { - return replayed.get(); - } - DeliveryAttemptSnapshot original = attempts .snapshot(command.attemptId()) @@ -114,7 +116,11 @@ public final class NotificationAdminApplicationService implements NotificationAd List.of("DRY_RUN")); } - return transactions.inWrite( + return operationExecutor.execute( + command.operationId(), + commandFingerprints.of(command), + actor, + "ADMIN_REDRIVE", () -> { // The logical identities are preserved and only the attempt is new, so the history stays // one story rather than becoming two unrelated notifications. @@ -151,10 +157,6 @@ public final class NotificationAdminApplicationService implements NotificationAd Objects.requireNonNull(command, "command"); authorization.require(actor, NotificationAdminAuthority.RECONCILE); - Optional replayed = operations.findByOperationId(command.operationId()); - if (replayed.isPresent()) { - return replayed.get(); - } if (command.dryRun()) { return new AdminOperationResult( command.operationId(), @@ -166,32 +168,39 @@ public final class NotificationAdminApplicationService implements NotificationAd List.of("DRY_RUN")); } - List reasons = new ArrayList<>(); - int reconciled = 0; - for (DeliveryAttemptId attemptId : command.attemptIds()) { - reconciliation.reconcile(attemptId); - reconciled++; - } - reasons.add(command.reason()); + return operationExecutor.execute( + command.operationId(), + commandFingerprints.of(command), + actor, + "ADMIN_RECONCILE", + () -> { + List reasons = new ArrayList<>(); + int reconciled = 0; + for (DeliveryAttemptId attemptId : command.attemptIds()) { + reconciliation.reconcile(attemptId); + reconciled++; + } + reasons.add(command.reason()); - AdminOperationResult result = - new AdminOperationResult( - command.operationId(), - false, - reconciled, - Optional.empty(), - Optional.empty(), - Optional.empty(), - List.copyOf(reasons)); - audit.record( - new NotificationAuditEvent( - "ADMIN_RECONCILE", - actor.actorRef(), - Optional.of(command.reason()), - Optional.of(command.operationId()), - clock.instant(), - Map.of())); - return operations.save(result, actor, "ADMIN_RECONCILE"); + AdminOperationResult result = + new AdminOperationResult( + command.operationId(), + false, + reconciled, + Optional.empty(), + Optional.empty(), + Optional.empty(), + List.copyOf(reasons)); + audit.record( + new NotificationAuditEvent( + "ADMIN_RECONCILE", + actor.actorRef(), + Optional.of(command.reason()), + Optional.of(command.operationId()), + clock.instant(), + Map.of())); + return operations.save(result, actor, "ADMIN_RECONCILE"); + }); } @Override @@ -200,10 +209,6 @@ public final class NotificationAdminApplicationService implements NotificationAd authorization.require(actor, NotificationAdminAuthority.SUPPRESS); authorization.requireTenant(actor, command.tenantId()); - Optional replayed = operations.findByOperationId(command.operationId()); - if (replayed.isPresent()) { - return replayed.get(); - } if (command.dryRun()) { return new AdminOperationResult( command.operationId(), @@ -215,7 +220,12 @@ public final class NotificationAdminApplicationService implements NotificationAd List.of("DRY_RUN")); } - return transactions.inWrite( + String action = command.remove() ? "ADMIN_SUPPRESS_REMOVE" : "ADMIN_SUPPRESS_ADD"; + return operationExecutor.execute( + command.operationId(), + commandFingerprints.of(command), + actor, + action, () -> { int affected; if (command.remove()) { @@ -269,8 +279,7 @@ public final class NotificationAdminApplicationService implements NotificationAd Optional.of(command.operationId()), clock.instant(), Map.of())); - return operations.save( - result, actor, command.remove() ? "ADMIN_SUPPRESS_REMOVE" : "ADMIN_SUPPRESS_ADD"); + return operations.save(result, actor, action); }); } @@ -279,10 +288,6 @@ public final class NotificationAdminApplicationService implements NotificationAd Objects.requireNonNull(command, "command"); authorization.require(actor, NotificationAdminAuthority.PROVIDER_CONTROL); - Optional replayed = operations.findByOperationId(command.operationId()); - if (replayed.isPresent()) { - return replayed.get(); - } if (command.dryRun()) { return new AdminOperationResult( command.operationId(), @@ -294,38 +299,46 @@ public final class NotificationAdminApplicationService implements NotificationAd List.of("DRY_RUN")); } - boolean applied = - runtimes.setState(command.profileId(), command.desiredState(), command.reason()); - if (!applied) { - // The transition was refused — an authentication failure is not cleared by declaring the - // provider healthy, and a healthy runtime is not degraded on request. Recording success for a - // state change that did not happen tells an operator the provider is serving when it is not. - throw new ProviderConfigurationException( - NotificationFailureDescriptor.preDispatch( - NotificationFailureCode.PROVIDER_CONFIGURATION_INVALID, - FailureCategory.AUTHORIZATION)); - } + return operationExecutor.execute( + command.operationId(), + commandFingerprints.of(command), + actor, + "ADMIN_PROVIDER_STATE", + () -> { + boolean applied = + runtimes.setState(command.profileId(), command.desiredState(), command.reason()); + if (!applied) { + // The transition was refused — an authentication failure is not cleared by declaring + // the provider healthy, and a healthy runtime is not degraded on request. Recording + // success for a state change that did not happen tells an operator the provider is + // serving when it is not. + throw new ProviderConfigurationException( + NotificationFailureDescriptor.preDispatch( + NotificationFailureCode.PROVIDER_CONFIGURATION_INVALID, + FailureCategory.AUTHORIZATION)); + } - AdminOperationResult result = - new AdminOperationResult( - command.operationId(), - false, - 1, - Optional.empty(), - Optional.empty(), - Optional.empty(), - List.of(command.reason())); - audit.record( - new NotificationAuditEvent( - "ADMIN_PROVIDER_STATE", - actor.actorRef(), - Optional.of(command.reason()), - Optional.of(command.operationId()), - clock.instant(), - Map.of( - "providerProfile", command.profileId().value(), - "status", command.desiredState().name()))); - return operations.save(result, actor, "ADMIN_PROVIDER_STATE"); + AdminOperationResult result = + new AdminOperationResult( + command.operationId(), + false, + 1, + Optional.empty(), + Optional.empty(), + Optional.empty(), + List.of(command.reason())); + audit.record( + new NotificationAuditEvent( + "ADMIN_PROVIDER_STATE", + actor.actorRef(), + Optional.of(command.reason()), + Optional.of(command.operationId()), + clock.instant(), + Map.of( + "providerProfile", command.profileId().value(), + "status", command.desiredState().name()))); + return operations.save(result, actor, "ADMIN_PROVIDER_STATE"); + }); } /** Current state of a provider runtime, for the health endpoint. */ diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminAuthority.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminAuthority.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminAuthority.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminAuthority.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminService.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminService.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminService.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminService.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/ProviderRuntimeControlPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/ProviderRuntimeControlPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/ProviderRuntimeControlPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/ProviderRuntimeControlPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/ReconcileCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/ReconcileCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/ReconcileCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/ReconcileCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/RedriveCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/RedriveCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/RedriveCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/RedriveCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/SetProviderStateCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/SetProviderStateCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/SetProviderStateCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/SetProviderStateCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/SuppressCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/SuppressCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/admin/SuppressCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/admin/SuppressCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/CallbackIngestionResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/CallbackIngestionResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/CallbackIngestionResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/CallbackIngestionResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/CancelCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/CancelCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/CancelCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/CancelCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/CancelResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/CancelResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/CancelResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/CancelResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/ChannelPreferenceOverride.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/ChannelPreferenceOverride.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/ChannelPreferenceOverride.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/ChannelPreferenceOverride.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/CollapseScope.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/CollapseScope.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/CollapseScope.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/CollapseScope.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/CollapseSpec.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/CollapseSpec.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/CollapseSpec.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/CollapseSpec.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/ContactPointId.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/ContactPointId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/ContactPointId.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/ContactPointId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/ContactPointSelector.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/ContactPointSelector.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/ContactPointSelector.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/ContactPointSelector.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/CorrelationId.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/CorrelationId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/CorrelationId.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/CorrelationId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/DeduplicationAction.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/DeduplicationAction.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/DeduplicationAction.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/DeduplicationAction.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/DeduplicationSpec.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/DeduplicationSpec.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/DeduplicationSpec.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/DeduplicationSpec.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/DeliveryAttemptId.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/DeliveryAttemptId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/DeliveryAttemptId.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/DeliveryAttemptId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/EncodedNotificationPlan.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/EncodedNotificationPlan.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/EncodedNotificationPlan.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/EncodedNotificationPlan.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/IdempotencyKey.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/IdempotencyKey.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/IdempotencyKey.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/IdempotencyKey.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/NormalizedEventType.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/NormalizedEventType.java similarity index 88% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/NormalizedEventType.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/NormalizedEventType.java index e2f54582..5a5b56b4 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/NormalizedEventType.java +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/NormalizedEventType.java @@ -1,4 +1,4 @@ -package dev.caskeleton.application.notification.platform.callback; +package dev.caskeleton.application.notification.platform.api; /** * Stable event vocabulary. diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/NormalizedProviderEvent.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/NormalizedProviderEvent.java similarity index 95% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/NormalizedProviderEvent.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/NormalizedProviderEvent.java index c145d1a6..dbd47d1b 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/NormalizedProviderEvent.java +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/NormalizedProviderEvent.java @@ -1,4 +1,4 @@ -package dev.caskeleton.application.notification.platform.callback; +package dev.caskeleton.application.notification.platform.api; import java.time.Instant; import java.util.Map; diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationAcceptance.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationAcceptance.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationAcceptance.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationAcceptance.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationId.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationId.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationOrchestrator.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationOrchestrator.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationOrchestrator.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationOrchestrator.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationPlan.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationPlan.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationPlan.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationPlan.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationReceipt.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationReceipt.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationReceipt.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationReceipt.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationSnapshot.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationSnapshot.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationSnapshot.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationSnapshot.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationVariable.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationVariable.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationVariable.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/NotificationVariable.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/ProviderEventId.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/ProviderEventId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/ProviderEventId.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/ProviderEventId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/ProviderId.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/ProviderId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/ProviderId.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/ProviderId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/ProviderProfileId.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/ProviderProfileId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/ProviderProfileId.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/ProviderProfileId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/RecipientDeliveryId.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/RecipientDeliveryId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/RecipientDeliveryId.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/RecipientDeliveryId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/RecipientSpec.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/RecipientSpec.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/RecipientSpec.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/RecipientSpec.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/RequestStatus.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/RequestStatus.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/RequestStatus.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/RequestStatus.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/TemplateSelection.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/TemplateSelection.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/TemplateSelection.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/TemplateSelection.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/TenantId.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/TenantId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/TenantId.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/TenantId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/AttachmentDisposition.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/AttachmentDisposition.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/AttachmentDisposition.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/AttachmentDisposition.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/AttachmentRef.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/AttachmentRef.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/AttachmentRef.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/AttachmentRef.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/EmailContent.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/EmailContent.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/EmailContent.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/EmailContent.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/EmailOptions.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/EmailOptions.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/EmailOptions.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/EmailOptions.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/InAppAction.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/InAppAction.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/InAppAction.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/InAppAction.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/InAppContent.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/InAppContent.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/InAppContent.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/InAppContent.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/MobilePushContent.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/MobilePushContent.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/MobilePushContent.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/MobilePushContent.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/NotificationContent.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/NotificationContent.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/NotificationContent.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/NotificationContent.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/PushPresentation.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/PushPresentation.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/PushPresentation.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/PushPresentation.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/SmsContent.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/SmsContent.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/SmsContent.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/SmsContent.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/SmsOptions.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/SmsOptions.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/SmsOptions.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/SmsOptions.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/WebPushContent.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/WebPushContent.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/WebPushContent.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/WebPushContent.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/WebPushOptions.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/WebPushOptions.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/content/WebPushOptions.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/content/WebPushOptions.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/AttemptConfirmation.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/AttemptConfirmation.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/AttemptConfirmation.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/AttemptConfirmation.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/DeliveryOutcome.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/DeliveryOutcome.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/DeliveryOutcome.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/DeliveryOutcome.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/EvidenceLevel.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/EvidenceLevel.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/EvidenceLevel.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/EvidenceLevel.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/RecipientDeliveryState.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/RecipientDeliveryState.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/RecipientDeliveryState.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/RecipientDeliveryState.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/SubmissionOutcome.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/SubmissionOutcome.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/SubmissionOutcome.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/delivery/SubmissionOutcome.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/AmbiguousSubmissionException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/AmbiguousSubmissionException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/AmbiguousSubmissionException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/AmbiguousSubmissionException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/AttachmentIntegrityException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/AttachmentIntegrityException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/AttachmentIntegrityException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/AttachmentIntegrityException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/AttachmentUnavailableException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/AttachmentUnavailableException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/AttachmentUnavailableException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/AttachmentUnavailableException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/CallbackProjectionException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/CallbackProjectionException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/CallbackProjectionException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/CallbackProjectionException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/CallbackValidationException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/CallbackValidationException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/CallbackValidationException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/CallbackValidationException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/FailureCategory.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/FailureCategory.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/FailureCategory.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/FailureCategory.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/IdempotencyConflictException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/IdempotencyConflictException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/IdempotencyConflictException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/IdempotencyConflictException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/InvalidContactPointException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/InvalidContactPointException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/InvalidContactPointException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/InvalidContactPointException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationCapacityException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationCapacityException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationCapacityException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationCapacityException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationExpiredException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationExpiredException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationExpiredException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationExpiredException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationFailureCode.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationFailureCode.java similarity index 97% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationFailureCode.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationFailureCode.java index 8abf24dd..cfab75a3 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationFailureCode.java +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationFailureCode.java @@ -34,6 +34,7 @@ public final class NotificationFailureCode { public static final String CALLBACK_PROJECTION_FAILED = "CALLBACK_PROJECTION_FAILED"; public static final String RECONCILIATION_FAILED = "RECONCILIATION_FAILED"; public static final String CAPACITY_REJECTED = "CAPACITY_REJECTED"; + public static final String DISPATCH_LEASE_LOST = "DISPATCH_LEASE_LOST"; public static final String ATTACHMENT_UNAVAILABLE = "ATTACHMENT_UNAVAILABLE"; public static final String ATTACHMENT_INTEGRITY_FAILED = "ATTACHMENT_INTEGRITY_FAILED"; @@ -63,6 +64,7 @@ public final class NotificationFailureCode { CALLBACK_PROJECTION_FAILED, RECONCILIATION_FAILED, CAPACITY_REJECTED, + DISPATCH_LEASE_LOST, ATTACHMENT_UNAVAILABLE, ATTACHMENT_INTEGRITY_FAILED); diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationFailureDescriptor.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationFailureDescriptor.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationFailureDescriptor.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationFailureDescriptor.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationSuppressedException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationSuppressedException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationSuppressedException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationSuppressedException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationValidationException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationValidationException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationValidationException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/NotificationValidationException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderAuthenticationException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderAuthenticationException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderAuthenticationException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderAuthenticationException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderAuthorizationException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderAuthorizationException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderAuthorizationException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderAuthorizationException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderConfigurationException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderConfigurationException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderConfigurationException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderConfigurationException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderPayloadLimitException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderPayloadLimitException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderPayloadLimitException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderPayloadLimitException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderPermanentException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderPermanentException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderPermanentException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderPermanentException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderRejectedException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderRejectedException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderRejectedException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderRejectedException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderThrottledException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderThrottledException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderThrottledException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderThrottledException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderTransientException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderTransientException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderTransientException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderTransientException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderUnavailableException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderUnavailableException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderUnavailableException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/ProviderUnavailableException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/ReconciliationException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/ReconciliationException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/ReconciliationException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/ReconciliationException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/TemplateNotFoundException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/TemplateNotFoundException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/TemplateNotFoundException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/TemplateNotFoundException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/TemplateRenderingException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/TemplateRenderingException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/TemplateRenderingException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/TemplateRenderingException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/TemplateVariableValidationException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/TemplateVariableValidationException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/error/TemplateVariableValidationException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/error/TemplateVariableValidationException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/routing/Channel.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/routing/Channel.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/routing/Channel.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/routing/Channel.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/routing/DeliveryStrategy.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/routing/DeliveryStrategy.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/routing/DeliveryStrategy.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/routing/DeliveryStrategy.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/routing/ExplicitChannel.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/routing/ExplicitChannel.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/routing/ExplicitChannel.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/routing/ExplicitChannel.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/routing/OrderedFallback.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/routing/OrderedFallback.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/api/routing/OrderedFallback.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/api/routing/OrderedFallback.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/AppendEventResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/AppendEventResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/AppendEventResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/AppendEventResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/CallbackPayloadProtectionPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/CallbackPayloadProtectionPort.java similarity index 88% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/CallbackPayloadProtectionPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/CallbackPayloadProtectionPort.java index 25cf6ff3..75a01c10 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/CallbackPayloadProtectionPort.java +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/CallbackPayloadProtectionPort.java @@ -1,5 +1,7 @@ package dev.caskeleton.application.notification.platform.callback; +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; + /** Bounded, encrypted retention of raw callback payloads. */ public interface CallbackPayloadProtectionPort { diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/DeliveryAttemptResolverPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/DeliveryAttemptResolverPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/DeliveryAttemptResolverPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/DeliveryAttemptResolverPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/DeliveryAttemptSnapshot.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/DeliveryAttemptSnapshot.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/DeliveryAttemptSnapshot.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/DeliveryAttemptSnapshot.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/DeliveryProjection.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/DeliveryProjection.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/DeliveryProjection.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/DeliveryProjection.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/DeliveryProjectionStorePort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/DeliveryProjectionStorePort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/DeliveryProjectionStorePort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/DeliveryProjectionStorePort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/EngagementFacts.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/EngagementFacts.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/EngagementFacts.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/EngagementFacts.java diff --git a/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/IngestProviderCallbackApplicationUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/IngestProviderCallbackApplicationUseCase.java new file mode 100644 index 00000000..71568782 --- /dev/null +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/IngestProviderCallbackApplicationUseCase.java @@ -0,0 +1,89 @@ +package dev.caskeleton.application.notification.platform.callback; + +import dev.caskeleton.application.notification.platform.api.CallbackIngestionResult; +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; +import dev.caskeleton.application.notification.platform.observation.NotificationMetricName; +import dev.caskeleton.application.notification.platform.observation.NotificationMetricsPort; +import java.time.Clock; +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.Objects; +import java.util.Optional; + +/** + * Durably records a callback that an adapter has already authenticated and normalized. + * + *

      HTTP method, external URL, headers, media type, body limits and provider signatures are + * transport/provider concerns and never enter this use case. The application receives semantic + * events plus the exact raw bytes it must protect as durable evidence. + * + *

      Projection is a worker's job, not this path's: the endpoint promises the provider a fast 2xx + * once the event is durable, and projecting inline broke that promise in both directions. + */ +@dev.caskeleton.application.capability.UseCaseCapability( + transactionMode = dev.caskeleton.application.transaction.TransactionMode.WRITE, + idempotency = dev.caskeleton.application.capability.Idempotency.IDEMPOTENT, + repositoryAccess = dev.caskeleton.application.capability.RepositoryAccess.WRITE_REPOSITORY, + externalOutboundAllowed = true) +@dev.caskeleton.application.security.RequiresPermission("notification-callback:ingest") +public class IngestProviderCallbackApplicationUseCase + implements dev.caskeleton.application.notification.platform.port.in + .IngestProviderCallbackUseCase { + + private final ProviderEventLedger ledger; + private final dev.caskeleton.application.transaction.TransactionPort transactions; + private final CallbackPayloadProtectionPort payloadProtection; + private final NotificationMetricsPort metrics; + private final Clock clock; + + public IngestProviderCallbackApplicationUseCase( + ProviderEventLedger ledger, + dev.caskeleton.application.transaction.TransactionPort transactions, + CallbackPayloadProtectionPort payloadProtection, + NotificationMetricsPort metrics, + Clock clock) { + this.ledger = Objects.requireNonNull(ledger, "ledger"); + this.transactions = Objects.requireNonNull(transactions, "transactions"); + this.payloadProtection = Objects.requireNonNull(payloadProtection, "payloadProtection"); + this.metrics = Objects.requireNonNull(metrics, "metrics"); + this.clock = Objects.requireNonNull(clock, "clock"); + } + + @Override + public CallbackIngestionResult handle( + dev.caskeleton.application.notification.platform.port.in.IngestProviderCallbackCommand + command) { + Objects.requireNonNull(command, "command"); + + byte[] rawBody = command.rawPayload(); + String rawDigest = payloadProtection.digest(rawBody); + byte[] ciphertext = payloadProtection.protectRawPayload(rawBody); + + List events = new ArrayList<>(command.events().size()); + for (NormalizedProviderEvent event : command.events()) { + events.add( + new VerifiedProviderEvent( + command.providerProfileId(), + event, + Optional.empty(), + ProviderEventSource.CALLBACK, + true, + clock.instant(), + ciphertext, + rawDigest, + payloadProtection.fingerprint(command.providerProfileId(), event, rawDigest))); + } + + AppendEventResult append = transactions.inWrite(() -> ledger.appendAll(events)); + + metrics.increment( + NotificationMetricName.CALLBACK, + Map.of( + "provider", + command.providerId().value(), + "result", + append.created() ? "APPENDED" : "DUPLICATE")); + return new CallbackIngestionResult(append.newEvents().size(), append.duplicates().size()); + } +} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/NotificationSideEffectPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/NotificationSideEffectPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/NotificationSideEffectPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/NotificationSideEffectPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProjectionResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProjectionResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProjectionResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProjectionResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProjectionStatus.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProjectionStatus.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProjectionStatus.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProjectionStatus.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventLedger.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventLedger.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventLedger.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventLedger.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventProjectionService.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventProjectionService.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventProjectionService.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventProjectionService.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventProjector.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventProjector.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventProjector.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventProjector.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventProjectorRegistry.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventProjectorRegistry.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventProjectorRegistry.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventProjectorRegistry.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventRecord.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventRecord.java similarity index 95% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventRecord.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventRecord.java index cddf5212..899a2d4a 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventRecord.java +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventRecord.java @@ -1,6 +1,7 @@ package dev.caskeleton.application.notification.platform.callback; import dev.caskeleton.application.notification.platform.api.DeliveryAttemptId; +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; import dev.caskeleton.application.notification.platform.api.ProviderProfileId; import java.time.Instant; import java.util.Objects; diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventRecordId.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventRecordId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventRecordId.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventRecordId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventSource.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventSource.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventSource.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderEventSource.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderRequestIdHash.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderRequestIdHash.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderRequestIdHash.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/ProviderRequestIdHash.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/StandardDeliveryProjector.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/StandardDeliveryProjector.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/StandardDeliveryProjector.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/StandardDeliveryProjector.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/SuppressionFacts.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/SuppressionFacts.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/SuppressionFacts.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/SuppressionFacts.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/VerifiedProviderEvent.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/VerifiedProviderEvent.java similarity index 97% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/VerifiedProviderEvent.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/VerifiedProviderEvent.java index c4d1bcc9..90fbc493 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/callback/VerifiedProviderEvent.java +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/callback/VerifiedProviderEvent.java @@ -1,6 +1,7 @@ package dev.caskeleton.application.notification.platform.callback; import dev.caskeleton.application.notification.platform.api.DeliveryAttemptId; +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; import dev.caskeleton.application.notification.platform.api.ProviderProfileId; import java.time.Instant; import java.util.Arrays; diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/ApnsDeviceToken.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/ApnsDeviceToken.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/ApnsDeviceToken.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/ApnsDeviceToken.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/ApnsEnvironment.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/ApnsEnvironment.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/ApnsEnvironment.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/ApnsEnvironment.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/ContactPointStatus.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/ContactPointStatus.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/ContactPointStatus.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/ContactPointStatus.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/ContactPointType.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/ContactPointType.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/ContactPointType.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/ContactPointType.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/ContactPointValue.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/ContactPointValue.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/ContactPointValue.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/ContactPointValue.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/EmailAddress.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/EmailAddress.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/EmailAddress.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/EmailAddress.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/FcmInstallationId.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/FcmInstallationId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/FcmInstallationId.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/FcmInstallationId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/InAppRecipientRef.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/InAppRecipientRef.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/InAppRecipientRef.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/InAppRecipientRef.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/LegacyFcmRegistrationToken.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/LegacyFcmRegistrationToken.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/LegacyFcmRegistrationToken.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/LegacyFcmRegistrationToken.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/MobilePushTarget.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/MobilePushTarget.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/MobilePushTarget.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/MobilePushTarget.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/PhoneNumber.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/PhoneNumber.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/PhoneNumber.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/PhoneNumber.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/WebPushSubscriptionValue.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/WebPushSubscriptionValue.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/contact/WebPushSubscriptionValue.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/contact/WebPushSubscriptionValue.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/AcceptNotificationApplicationUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/AcceptNotificationApplicationUseCase.java similarity index 78% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/AcceptNotificationApplicationUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/AcceptNotificationApplicationUseCase.java index 27deb0ae..b38eedb3 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/AcceptNotificationApplicationUseCase.java +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/AcceptNotificationApplicationUseCase.java @@ -65,7 +65,13 @@ public class AcceptNotificationApplicationUseCase implements AcceptNotificationU private final ContactPointStorePort contactPoints; private final ContactPointProtector protector; private final TenantContextPort tenants; + private static final IdempotencyKey DERIVED_KEY_PLACEHOLDER = + new IdempotencyKey("derived-key-placeholder"); + private final NotificationIdGeneratorPort ids; + private final RequestFingerprint fingerprints; + private final CanonicalNotificationPlanEncoder planEncoder = + new CanonicalNotificationPlanEncoder(); private final TransactionPort transactions; private final Clock clock; @@ -77,6 +83,7 @@ public class AcceptNotificationApplicationUseCase implements AcceptNotificationU * @param protector the encryption and keyed-lookup boundary * @param tenants the ambient tenant, used when the command names none * @param ids the identifier source; a use case never mints an identifier itself + * @param fingerprints stable SHA-256 fingerprinting over the canonical notification plan * @param transactions the write boundary this use case owns for registration * @param clock the time source for registration timestamps */ @@ -86,6 +93,7 @@ public class AcceptNotificationApplicationUseCase implements AcceptNotificationU ContactPointProtector protector, TenantContextPort tenants, NotificationIdGeneratorPort ids, + RequestFingerprint fingerprints, TransactionPort transactions, Clock clock) { this.submit = Objects.requireNonNull(submit, "submit"); @@ -97,6 +105,7 @@ public class AcceptNotificationApplicationUseCase implements AcceptNotificationU // a port so it is time-ordered and substitutable; a use case that mints its own produces random // v4 values whose index locality is the opposite of what the stores are built for. this.ids = Objects.requireNonNull(ids, "ids"); + this.fingerprints = Objects.requireNonNull(fingerprints, "fingerprints"); this.transactions = Objects.requireNonNull(transactions, "transactions"); this.clock = Objects.requireNonNull(clock, "clock"); } @@ -109,29 +118,24 @@ public class AcceptNotificationApplicationUseCase implements AcceptNotificationU ContactPointValue value = parse(command.channel(), command.address()); ContactPointId contactPointId = registerOrReuse(tenantId, command.recipientRef(), value); - NotificationPlan plan = - new NotificationPlan( - tenantId, - new IdempotencyKey(command.idempotencyKey().orElseGet(() -> derivedKey(command))), - command.category(), - new TemplateSelection( - command.templateId(), command.templateVersion(), command.locale()), - command.variables(), - List.of( - new RecipientSpec( - command.recipientRef(), - Optional.of(command.locale()), - Optional.empty(), - List.of(new ContactPointSelector(command.channel(), contactPointId)), - Optional.empty())), - new ExplicitChannel(command.channel()), - Optional.empty(), - Optional.empty(), - Optional.empty(), - Optional.empty(), - new CorrelationId(ids.nextId().toString()), - Map.of()); + CorrelationId correlationId = new CorrelationId(ids.nextId().toString()); + IdempotencyKey idempotencyKey = + command + .idempotencyKey() + .map(IdempotencyKey::new) + .orElseGet( + () -> { + NotificationPlan provisional = + plan( + command, + tenantId, + contactPointId, + DERIVED_KEY_PLACEHOLDER, + correlationId); + return new IdempotencyKey(fingerprints.of(planEncoder.encode(provisional))); + }); + NotificationPlan plan = plan(command, tenantId, contactPointId, idempotencyKey, correlationId); return submit.handle(new SubmitNotificationCommand(plan)); } @@ -176,21 +180,38 @@ public class AcceptNotificationApplicationUseCase implements AcceptNotificationU } /** - * An idempotency key for a caller that supplied none. + * Builds the submission plan once contact-point identity and request identity are known. * - *

      Derived from the request's own identity — recipient, channel, template and variables — so - * two retries of the same request collapse and two different requests do not. It deliberately - * excludes the address: the key is stored, and the fingerprint of the recipient reference is - * enough to tell two recipients apart without putting a contact point in an idempotency column. + *

      The canonical encoder deliberately excludes both the idempotency key and correlation id. + * That lets a caller that supplied no key be fingerprinted from the exact same semantic plan + * without creating a circular hash input. */ - private static String derivedKey(AcceptNotificationCommand command) { - return Integer.toHexString( - Objects.hash( - command.recipientRef(), - command.channel(), - command.templateId(), - command.templateVersion(), - command.variables())); + private static NotificationPlan plan( + AcceptNotificationCommand command, + TenantId tenantId, + ContactPointId contactPointId, + IdempotencyKey idempotencyKey, + CorrelationId correlationId) { + return new NotificationPlan( + tenantId, + idempotencyKey, + command.category(), + new TemplateSelection(command.templateId(), command.templateVersion(), command.locale()), + command.variables(), + List.of( + new RecipientSpec( + command.recipientRef(), + Optional.of(command.locale()), + Optional.empty(), + List.of(new ContactPointSelector(command.channel(), contactPointId)), + Optional.empty())), + new ExplicitChannel(command.channel()), + Optional.empty(), + Optional.empty(), + Optional.empty(), + Optional.empty(), + correlationId, + Map.of()); } /** diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ApplicationReceiptServiceImpl.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ApplicationReceiptServiceImpl.java similarity index 96% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ApplicationReceiptServiceImpl.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ApplicationReceiptServiceImpl.java index 6a075ef5..3ef39961 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ApplicationReceiptServiceImpl.java +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ApplicationReceiptServiceImpl.java @@ -1,8 +1,8 @@ package dev.caskeleton.application.notification.platform.dispatch; +import dev.caskeleton.application.notification.platform.api.NormalizedEventType; +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; import dev.caskeleton.application.notification.platform.callback.DeliveryAttemptSnapshot; -import dev.caskeleton.application.notification.platform.callback.NormalizedEventType; -import dev.caskeleton.application.notification.platform.callback.NormalizedProviderEvent; import dev.caskeleton.application.notification.platform.callback.ProviderEventLedger; import dev.caskeleton.application.notification.platform.callback.ProviderEventProjectionService; import dev.caskeleton.application.notification.platform.callback.ProviderEventSource; diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/AttachmentIntegrityGuard.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/AttachmentIntegrityGuard.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/AttachmentIntegrityGuard.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/AttachmentIntegrityGuard.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/CancelNotificationApplicationUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/CancelNotificationApplicationUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/CancelNotificationApplicationUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/CancelNotificationApplicationUseCase.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/CanonicalNotificationPlanEncoder.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/CanonicalNotificationPlanEncoder.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/CanonicalNotificationPlanEncoder.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/CanonicalNotificationPlanEncoder.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/CanonicalNotificationPlanWriter.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/CanonicalNotificationPlanWriter.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/CanonicalNotificationPlanWriter.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/CanonicalNotificationPlanWriter.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ContactPointRecord.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ContactPointRecord.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ContactPointRecord.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ContactPointRecord.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ContactPointStorePort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ContactPointStorePort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ContactPointStorePort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ContactPointStorePort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DeliveryAttemptFactory.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DeliveryAttemptFactory.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DeliveryAttemptFactory.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DeliveryAttemptFactory.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DeliveryAttemptRecord.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DeliveryAttemptRecord.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DeliveryAttemptRecord.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DeliveryAttemptRecord.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DeliveryAttemptStorePort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DeliveryAttemptStorePort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DeliveryAttemptStorePort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DeliveryAttemptStorePort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DispatchGuardOutcome.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DispatchGuardOutcome.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DispatchGuardOutcome.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DispatchGuardOutcome.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DispatchOutcomeRecorder.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DispatchOutcomeRecorder.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DispatchOutcomeRecorder.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DispatchOutcomeRecorder.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DispatchPipeline.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DispatchPipeline.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DispatchPipeline.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DispatchPipeline.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DuplicateIdempotencyKeyException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DuplicateIdempotencyKeyException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DuplicateIdempotencyKeyException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/DuplicateIdempotencyKeyException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/GetNotificationApplicationUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/GetNotificationApplicationUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/GetNotificationApplicationUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/GetNotificationApplicationUseCase.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/MessageDigestPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/MessageDigestPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/MessageDigestPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/MessageDigestPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationDispatchService.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationDispatchService.java similarity index 92% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationDispatchService.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationDispatchService.java index af9d4ac4..564b82cb 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationDispatchService.java +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationDispatchService.java @@ -160,8 +160,12 @@ public final class NotificationDispatchService { if (!leases.stillHeld(lease)) { // Checked immediately before the side effect, which is the last moment it can still be - // prevented. Everything above is database work another holder would simply redo; a provider - // submission is not — once it leaves, the recipient has the notification twice. + // prevented. The provider call has not started, so this attempt is safe to close as + // NOT_SUBMITTED. Only the attempt row is touched here: the recipient lease now belongs to + // another worker, and writing the stale recipient snapshot could overwrite that newer lease. + Instant completedAt = clock.instant(); + transactions.inWrite( + () -> attempts.recordOutcome(leaseLostBeforeProviderSubmit(attempt, completedAt))); return; } @@ -195,6 +199,37 @@ public final class NotificationDispatchService { NotificationRequestStatusPolicy.rollUp(states)); } + private static DeliveryAttemptRecord leaseLostBeforeProviderSubmit( + DeliveryAttemptRecord attempt, Instant completedAt) { + Duration elapsed = Duration.between(attempt.startedAt(), completedAt); + if (elapsed.isNegative()) { + elapsed = Duration.ZERO; + } + return new DeliveryAttemptRecord( + attempt.id(), + attempt.recipientDeliveryId(), + attempt.contactPointId(), + attempt.attemptNo(), + attempt.channel(), + attempt.providerId(), + attempt.providerProfileId(), + Optional.empty(), + ProviderExecutionEvidence.notStarted(), + SubmissionOutcome.NOT_SUBMITTED, + dev.caskeleton.application.notification.platform.api.delivery.DeliveryOutcome.UNKNOWN, + dev.caskeleton.application.notification.platform.api.delivery.AttemptConfirmation.REJECTED, + dev.caskeleton.application.notification.platform.api.delivery.EvidenceLevel.NONE, + Optional.empty(), + Optional.of(NotificationFailureCode.DISPATCH_LEASE_LOST), + Optional.empty(), + Optional.empty(), + attempt.startedAt(), + Optional.of(completedAt), + Optional.of(elapsed), + attempt.credentialGeneration(), + attempt.renderedContentDigest()); + } + private ProviderSubmissionResult submitOutsideTransaction( DeliveryAttemptRecord attempt, ProviderProfileSnapshot profile, diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationIdGeneratorPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationIdGeneratorPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationIdGeneratorPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationIdGeneratorPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRequestInsertOutcome.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRequestInsertOutcome.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRequestInsertOutcome.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRequestInsertOutcome.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRequestRecord.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRequestRecord.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRequestRecord.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRequestRecord.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRequestStatusPolicy.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRequestStatusPolicy.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRequestStatusPolicy.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRequestStatusPolicy.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRequestStorePort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRequestStorePort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRequestStorePort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRequestStorePort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRoutePlannerPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRoutePlannerPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRoutePlannerPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRoutePlannerPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRoutingPlanCodecPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRoutingPlanCodecPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRoutingPlanCodecPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationRoutingPlanCodecPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationSubmissionService.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationSubmissionService.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationSubmissionService.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationSubmissionService.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationVariablesCodecPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationVariablesCodecPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationVariablesCodecPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/NotificationVariablesCodecPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/PolicyRoutePlanner.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/PolicyRoutePlanner.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/PolicyRoutePlanner.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/PolicyRoutePlanner.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ProviderDispatchGatewayPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ProviderDispatchGatewayPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ProviderDispatchGatewayPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ProviderDispatchGatewayPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ProviderProfileCatalogPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ProviderProfileCatalogPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ProviderProfileCatalogPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ProviderProfileCatalogPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ProviderRequestIdHasherPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ProviderRequestIdHasherPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ProviderRequestIdHasherPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ProviderRequestIdHasherPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/PublishNotificationTemplateApplicationUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/PublishNotificationTemplateApplicationUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/PublishNotificationTemplateApplicationUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/PublishNotificationTemplateApplicationUseCase.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RecipientDeliveryRecord.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RecipientDeliveryRecord.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RecipientDeliveryRecord.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RecipientDeliveryRecord.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RecipientDeliveryStorePort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RecipientDeliveryStorePort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RecipientDeliveryStorePort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RecipientDeliveryStorePort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RecipientLease.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RecipientLease.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RecipientLease.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RecipientLease.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RecipientLeaseStorePort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RecipientLeaseStorePort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RecipientLeaseStorePort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RecipientLeaseStorePort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationGatewayPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationGatewayPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationGatewayPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationGatewayPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationJob.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationJob.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationJob.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationJob.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationJobStorePort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationJobStorePort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationJobStorePort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationJobStorePort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationService.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationService.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationService.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationService.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RequestFingerprint.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RequestFingerprint.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RequestFingerprint.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/RequestFingerprint.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ScheduleNotificationApplicationUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ScheduleNotificationApplicationUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ScheduleNotificationApplicationUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/ScheduleNotificationApplicationUseCase.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/SubmitNotificationApplicationUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/SubmitNotificationApplicationUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/SubmitNotificationApplicationUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/SubmitNotificationApplicationUseCase.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/SyntheticEventFingerprint.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/SyntheticEventFingerprint.java similarity index 98% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/SyntheticEventFingerprint.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/SyntheticEventFingerprint.java index 0e9aee32..966a6a21 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/SyntheticEventFingerprint.java +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/SyntheticEventFingerprint.java @@ -1,8 +1,8 @@ package dev.caskeleton.application.notification.platform.dispatch; import dev.caskeleton.application.notification.platform.api.DeliveryAttemptId; +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; import dev.caskeleton.application.notification.platform.api.ProviderProfileId; -import dev.caskeleton.application.notification.platform.callback.NormalizedProviderEvent; import java.nio.charset.StandardCharsets; import java.util.HexFormat; import java.util.Objects; diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/TemplateRendererRegistry.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/TemplateRendererRegistry.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/TemplateRendererRegistry.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/TemplateRendererRegistry.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/TenantContextPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/TenantContextPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/dispatch/TenantContextPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/dispatch/TenantContextPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/email/EmailNotification.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/email/EmailNotification.java similarity index 90% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/email/EmailNotification.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/email/EmailNotification.java index c24367b9..d3004a5f 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/email/EmailNotification.java +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/email/EmailNotification.java @@ -3,6 +3,7 @@ package dev.caskeleton.application.notification.platform.email; import dev.caskeleton.application.notification.platform.api.ContactPointId; import dev.caskeleton.application.notification.platform.api.CorrelationId; import dev.caskeleton.application.notification.platform.api.IdempotencyKey; +import dev.caskeleton.application.notification.platform.api.NotificationVariable; import dev.caskeleton.application.notification.platform.api.TemplateSelection; import dev.caskeleton.application.notification.platform.api.TenantId; import java.time.Instant; @@ -16,7 +17,7 @@ public record EmailNotification( IdempotencyKey idempotencyKey, ContactPointId recipient, TemplateSelection template, - Map variables, + Map variables, Optional expiresAt, CorrelationId correlationId) { diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/email/EmailNotifier.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/email/EmailNotifier.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/email/EmailNotifier.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/email/EmailNotifier.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/CreateInboxItemCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/CreateInboxItemCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/CreateInboxItemCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/CreateInboxItemCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxContentCodecPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxContentCodecPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxContentCodecPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxContentCodecPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxCursor.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxCursor.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxCursor.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxCursor.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxItem.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxItem.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxItem.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxItem.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxItemCreated.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxItemCreated.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxItemCreated.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxItemCreated.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxItemId.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxItemId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxItemId.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxItemId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxItemState.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxItemState.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxItemState.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxItemState.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxMutationResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxMutationResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxMutationResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxMutationResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxPage.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxPage.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxPage.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxPage.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxPrincipal.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxPrincipal.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxPrincipal.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxPrincipal.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxQuery.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxQuery.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxQuery.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/InboxQuery.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/MarkAllReadCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/MarkAllReadCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/MarkAllReadCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/MarkAllReadCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/NotificationInbox.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/NotificationInbox.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/NotificationInbox.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/NotificationInbox.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/NotificationInboxSignalPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/NotificationInboxSignalPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/inbox/NotificationInboxSignalPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/inbox/NotificationInboxSignalPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/observation/CardinalityGuard.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/observation/CardinalityGuard.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/observation/CardinalityGuard.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/observation/CardinalityGuard.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/observation/IllegalMetricTagException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/observation/IllegalMetricTagException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/observation/IllegalMetricTagException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/observation/IllegalMetricTagException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationAuditEvent.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationAuditEvent.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationAuditEvent.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationAuditEvent.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationAuditPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationAuditPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationAuditPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationAuditPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationMetricName.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationMetricName.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationMetricName.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationMetricName.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationMetricsPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationMetricsPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationMetricsPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationMetricsPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationSecurityAuditPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationSecurityAuditPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationSecurityAuditPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationSecurityAuditPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationServingState.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationServingState.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationServingState.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationServingState.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationServingStatePort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationServingStatePort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationServingStatePort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/observation/NotificationServingStatePort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/observation/SensitiveValueDetector.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/observation/SensitiveValueDetector.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/observation/SensitiveValueDetector.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/observation/SensitiveValueDetector.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/CompositeNotificationEligibilityPolicy.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/CompositeNotificationEligibilityPolicy.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/CompositeNotificationEligibilityPolicy.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/CompositeNotificationEligibilityPolicy.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/ConsentRecord.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/ConsentRecord.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/ConsentRecord.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/ConsentRecord.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/ConsentStorePort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/ConsentStorePort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/ConsentStorePort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/ConsentStorePort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/DeduplicationResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/DeduplicationResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/DeduplicationResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/DeduplicationResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/DeduplicationService.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/DeduplicationService.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/DeduplicationService.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/DeduplicationService.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/DeduplicationStorePort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/DeduplicationStorePort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/DeduplicationStorePort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/DeduplicationStorePort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/DefaultNotificationRetryPolicy.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/DefaultNotificationRetryPolicy.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/DefaultNotificationRetryPolicy.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/DefaultNotificationRetryPolicy.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/EligibilityResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/EligibilityResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/EligibilityResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/EligibilityResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/JitterSource.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/JitterSource.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/JitterSource.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/JitterSource.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/NotificationContext.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/NotificationContext.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/NotificationContext.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/NotificationContext.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/NotificationEligibilityPolicy.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/NotificationEligibilityPolicy.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/NotificationEligibilityPolicy.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/NotificationEligibilityPolicy.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/NotificationRetryPolicy.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/NotificationRetryPolicy.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/NotificationRetryPolicy.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/NotificationRetryPolicy.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/PreferenceRecord.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/PreferenceRecord.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/PreferenceRecord.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/PreferenceRecord.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/PreferenceStorePort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/PreferenceStorePort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/PreferenceStorePort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/PreferenceStorePort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/RecipientIdentity.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/RecipientIdentity.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/RecipientIdentity.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/RecipientIdentity.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/RetryBackoff.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/RetryBackoff.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/RetryBackoff.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/RetryBackoff.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/RetryBudget.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/RetryBudget.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/RetryBudget.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/RetryBudget.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/RetryContext.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/RetryContext.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/RetryContext.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/RetryContext.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/RetryDecision.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/RetryDecision.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/RetryDecision.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/RetryDecision.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/RouteCandidate.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/RouteCandidate.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/RouteCandidate.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/RouteCandidate.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/RoutingContext.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/RoutingContext.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/RoutingContext.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/RoutingContext.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/RoutingDecision.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/RoutingDecision.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/RoutingDecision.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/RoutingDecision.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/RoutingDecisionEngine.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/RoutingDecisionEngine.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/RoutingDecisionEngine.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/RoutingDecisionEngine.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionEntry.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionEntry.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionEntry.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionEntry.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionId.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionId.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionReason.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionReason.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionReason.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionReason.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionScope.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionScope.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionScope.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionScope.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionSource.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionSource.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionSource.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionSource.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionStorePort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionStorePort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionStorePort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/policy/SuppressionStorePort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/AcceptNotificationCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/AcceptNotificationCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/AcceptNotificationCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/AcceptNotificationCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/AcceptNotificationUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/AcceptNotificationUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/AcceptNotificationUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/AcceptNotificationUseCase.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/CancelNotificationCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/CancelNotificationCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/CancelNotificationCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/CancelNotificationCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/CancelNotificationUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/CancelNotificationUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/CancelNotificationUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/CancelNotificationUseCase.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/GetNotificationQuery.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/GetNotificationQuery.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/GetNotificationQuery.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/GetNotificationQuery.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/GetNotificationUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/GetNotificationUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/GetNotificationUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/GetNotificationUseCase.java diff --git a/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/IngestProviderCallbackCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/IngestProviderCallbackCommand.java new file mode 100644 index 00000000..792c8130 --- /dev/null +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/IngestProviderCallbackCommand.java @@ -0,0 +1,74 @@ +package dev.caskeleton.application.notification.platform.port.in; + +import dev.caskeleton.application.command.Command; +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; +import dev.caskeleton.application.notification.platform.api.ProviderId; +import dev.caskeleton.application.notification.platform.api.ProviderProfileId; +import java.util.Arrays; +import java.util.List; +import java.util.Objects; + +/** + * One adapter-verified, normalized provider callback. + * + *

      Signature verification, provider/profile selection, HTTP URL/header handling and content-type + * validation have already happened at the adapter boundary. The command carries only semantic + * provider identity, normalized events and the exact raw bytes the application must protect as + * durable evidence. + * + * @param providerId verified provider family + * @param providerProfileId verified configured provider profile + * @param events normalized provider events + * @param rawPayload exact callback bytes retained as protected evidence + */ +@SuppressWarnings("ArrayRecordComponent") // defensive copies on construction and on every accessor +public record IngestProviderCallbackCommand( + ProviderId providerId, + ProviderProfileId providerProfileId, + List events, + byte[] rawPayload) + implements Command { + + /** Validates and defensively copies the command. */ + public IngestProviderCallbackCommand { + Objects.requireNonNull(providerId, "providerId"); + Objects.requireNonNull(providerProfileId, "providerProfileId"); + events = List.copyOf(Objects.requireNonNull(events, "events")); + rawPayload = Objects.requireNonNull(rawPayload, "rawPayload").clone(); + } + + @Override + public byte[] rawPayload() { + return rawPayload.clone(); + } + + @Override + public boolean equals(Object other) { + if (this == other) { + return true; + } + if (!(other instanceof IngestProviderCallbackCommand value)) { + return false; + } + return providerId.equals(value.providerId) + && providerProfileId.equals(value.providerProfileId) + && events.equals(value.events) + && Arrays.equals(rawPayload, value.rawPayload); + } + + @Override + public int hashCode() { + return Objects.hash(providerId, providerProfileId, events, Arrays.hashCode(rawPayload)); + } + + @Override + public String toString() { + return "IngestProviderCallbackCommand[provider=" + + providerId + + ", profile=" + + providerProfileId + + ", events=" + + events.size() + + ", payload=redacted]"; + } +} diff --git a/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/IngestProviderCallbackUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/IngestProviderCallbackUseCase.java new file mode 100644 index 00000000..3cc85818 --- /dev/null +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/IngestProviderCallbackUseCase.java @@ -0,0 +1,18 @@ +package dev.caskeleton.application.notification.platform.port.in; + +import dev.caskeleton.application.notification.platform.api.CallbackIngestionResult; +import dev.caskeleton.application.usecase.CommandUseCase; + +/** The inbound port for durably ingesting an adapter-verified provider callback. */ +public interface IngestProviderCallbackUseCase + extends CommandUseCase { + + /** + * Ingests one verified provider callback. + * + * @param command the semantic callback to ingest + * @return how many events were appended and how many were duplicates + */ + @Override + CallbackIngestionResult handle(IngestProviderCallbackCommand command); +} diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/PublishNotificationTemplateCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/PublishNotificationTemplateCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/PublishNotificationTemplateCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/PublishNotificationTemplateCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/PublishNotificationTemplateUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/PublishNotificationTemplateUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/PublishNotificationTemplateUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/PublishNotificationTemplateUseCase.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/ScheduleNotificationCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/ScheduleNotificationCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/ScheduleNotificationCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/ScheduleNotificationCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/ScheduleNotificationUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/ScheduleNotificationUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/ScheduleNotificationUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/ScheduleNotificationUseCase.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/SubmitNotificationCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/SubmitNotificationCommand.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/SubmitNotificationCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/SubmitNotificationCommand.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/SubmitNotificationUseCase.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/SubmitNotificationUseCase.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/port/in/SubmitNotificationUseCase.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/port/in/SubmitNotificationUseCase.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/AttachmentAccessContext.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/AttachmentAccessContext.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/AttachmentAccessContext.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/AttachmentAccessContext.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/AttachmentResolver.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/AttachmentResolver.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/AttachmentResolver.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/AttachmentResolver.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/BatchNotificationProviderAdapter.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/BatchNotificationProviderAdapter.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/BatchNotificationProviderAdapter.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/BatchNotificationProviderAdapter.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/CollapseCapability.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/CollapseCapability.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/CollapseCapability.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/CollapseCapability.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/EvidenceCertainty.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/EvidenceCertainty.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/EvidenceCertainty.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/EvidenceCertainty.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/EvidenceFact.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/EvidenceFact.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/EvidenceFact.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/EvidenceFact.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/NotificationProviderAdapter.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/NotificationProviderAdapter.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/NotificationProviderAdapter.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/NotificationProviderAdapter.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderCallNotStartedException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderCallNotStartedException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderCallNotStartedException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderCallNotStartedException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderCapabilities.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderCapabilities.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderCapabilities.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderCapabilities.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderCollapseMapping.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderCollapseMapping.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderCollapseMapping.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderCollapseMapping.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderExecutionEvidence.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderExecutionEvidence.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderExecutionEvidence.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderExecutionEvidence.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderFailure.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderFailure.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderFailure.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderFailure.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderProfileSnapshot.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderProfileSnapshot.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderProfileSnapshot.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderProfileSnapshot.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderRuntimeState.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderRuntimeState.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderRuntimeState.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderRuntimeState.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderSubmission.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderSubmission.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderSubmission.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderSubmission.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderSubmissionResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderSubmissionResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderSubmissionResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ProviderSubmissionResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ReconciliationCapability.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ReconciliationCapability.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ReconciliationCapability.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ReconciliationCapability.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ReconciliationResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ReconciliationResult.java similarity index 92% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ReconciliationResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ReconciliationResult.java index bb656810..18fdde49 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ReconciliationResult.java +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ReconciliationResult.java @@ -1,6 +1,6 @@ package dev.caskeleton.application.notification.platform.provider; -import dev.caskeleton.application.notification.platform.callback.NormalizedProviderEvent; +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; import java.time.Instant; import java.util.Objects; diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ResolvedAttachment.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ResolvedAttachment.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/ResolvedAttachment.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/ResolvedAttachment.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/TraceContext.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/TraceContext.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/provider/TraceContext.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/provider/TraceContext.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/push/ApplicationIdentity.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/push/ApplicationIdentity.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/push/ApplicationIdentity.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/push/ApplicationIdentity.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/push/ApplicationReceipt.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/push/ApplicationReceipt.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/push/ApplicationReceipt.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/push/ApplicationReceipt.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/push/ApplicationReceiptService.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/push/ApplicationReceiptService.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/push/ApplicationReceiptService.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/push/ApplicationReceiptService.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/push/MobilePushNotification.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/push/MobilePushNotification.java similarity index 90% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/push/MobilePushNotification.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/push/MobilePushNotification.java index ca2c7957..94fe2f90 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/push/MobilePushNotification.java +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/push/MobilePushNotification.java @@ -3,6 +3,7 @@ package dev.caskeleton.application.notification.platform.push; import dev.caskeleton.application.notification.platform.api.ContactPointId; import dev.caskeleton.application.notification.platform.api.CorrelationId; import dev.caskeleton.application.notification.platform.api.IdempotencyKey; +import dev.caskeleton.application.notification.platform.api.NotificationVariable; import dev.caskeleton.application.notification.platform.api.TemplateSelection; import dev.caskeleton.application.notification.platform.api.TenantId; import java.time.Instant; @@ -19,7 +20,7 @@ public record MobilePushNotification( IdempotencyKey idempotencyKey, ContactPointId recipient, TemplateSelection template, - Map variables, + Map variables, Optional expiresAt, CorrelationId correlationId) { diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/push/MobilePushNotifier.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/push/MobilePushNotifier.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/push/MobilePushNotifier.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/push/MobilePushNotifier.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/push/ReceiptAuthorizationException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/push/ReceiptAuthorizationException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/push/ReceiptAuthorizationException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/push/ReceiptAuthorizationException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/push/ReceiptKind.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/push/ReceiptKind.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/push/ReceiptKind.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/push/ReceiptKind.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/push/ReceiptResult.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/push/ReceiptResult.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/push/ReceiptResult.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/push/ReceiptResult.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/AccessContext.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/AccessContext.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/AccessContext.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/AccessContext.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/ContactPointProtector.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/ContactPointProtector.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/ContactPointProtector.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/ContactPointProtector.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/NotificationPayloadProtection.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/NotificationPayloadProtection.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/NotificationPayloadProtection.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/NotificationPayloadProtection.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/NotificationPayloadUnreadableException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/NotificationPayloadUnreadableException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/NotificationPayloadUnreadableException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/NotificationPayloadUnreadableException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/NotificationRedactor.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/NotificationRedactor.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/NotificationRedactor.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/NotificationRedactor.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/ProtectedContactPoint.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/ProtectedContactPoint.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/ProtectedContactPoint.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/ProtectedContactPoint.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/SafeDiagnosticContext.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/SafeDiagnosticContext.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/SafeDiagnosticContext.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/SafeDiagnosticContext.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/SecretKeyMaterial.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/SecretKeyMaterial.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/SecretKeyMaterial.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/SecretKeyMaterial.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/SecretMaterialProvider.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/SecretMaterialProvider.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/SecretMaterialProvider.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/SecretMaterialProvider.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/SecretPurpose.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/SecretPurpose.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/SecretPurpose.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/SecretPurpose.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/SensitiveValueClassifier.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/SensitiveValueClassifier.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/SensitiveValueClassifier.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/SensitiveValueClassifier.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/SensitiveValueKind.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/SensitiveValueKind.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/SensitiveValueKind.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/SensitiveValueKind.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/UnsafeDiagnosticFieldException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/UnsafeDiagnosticFieldException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/security/UnsafeDiagnosticFieldException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/security/UnsafeDiagnosticFieldException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/sms/E164PhoneNumberParser.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/sms/E164PhoneNumberParser.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/sms/E164PhoneNumberParser.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/sms/E164PhoneNumberParser.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/sms/GsmAlphabet.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/sms/GsmAlphabet.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/sms/GsmAlphabet.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/sms/GsmAlphabet.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/sms/InvalidPhoneNumberException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/sms/InvalidPhoneNumberException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/sms/InvalidPhoneNumberException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/sms/InvalidPhoneNumberException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsEncoding.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsEncoding.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsEncoding.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsEncoding.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsEstimate.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsEstimate.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsEstimate.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsEstimate.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsNotification.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsNotification.java similarity index 90% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsNotification.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsNotification.java index 7d4efd92..aec0e4bf 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsNotification.java +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsNotification.java @@ -3,6 +3,7 @@ package dev.caskeleton.application.notification.platform.sms; import dev.caskeleton.application.notification.platform.api.ContactPointId; import dev.caskeleton.application.notification.platform.api.CorrelationId; import dev.caskeleton.application.notification.platform.api.IdempotencyKey; +import dev.caskeleton.application.notification.platform.api.NotificationVariable; import dev.caskeleton.application.notification.platform.api.TemplateSelection; import dev.caskeleton.application.notification.platform.api.TenantId; import java.time.Instant; @@ -16,7 +17,7 @@ public record SmsNotification( IdempotencyKey idempotencyKey, ContactPointId recipient, TemplateSelection template, - Map variables, + Map variables, Optional expiresAt, CorrelationId correlationId) { diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsNotifier.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsNotifier.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsNotifier.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsNotifier.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsSegmentEstimator.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsSegmentEstimator.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsSegmentEstimator.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/sms/SmsSegmentEstimator.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/NotificationTemplateRenderer.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/NotificationTemplateRenderer.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/NotificationTemplateRenderer.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/NotificationTemplateRenderer.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/NotificationTemplateVersion.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/NotificationTemplateVersion.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/NotificationTemplateVersion.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/NotificationTemplateVersion.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/RenderCommand.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/RenderCommand.java similarity index 77% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/RenderCommand.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/RenderCommand.java index 6d87d0a6..7782c941 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/RenderCommand.java +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/RenderCommand.java @@ -8,7 +8,12 @@ import java.util.Map; import java.util.Objects; import java.util.Optional; -/** Everything a renderer is allowed to see. */ +/** + * Everything a renderer is allowed to see. + * + *

      The raw Object map is intentional here: typed NotificationVariable values have already been + * projected one-way into renderer values. This boundary must not be reused as a submission API. + */ public record RenderCommand( TemplateSelection selection, Channel channel, diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/RenderedNotificationContent.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/RenderedNotificationContent.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/RenderedNotificationContent.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/RenderedNotificationContent.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateContentCodecPort.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateContentCodecPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateContentCodecPort.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateContentCodecPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateContentDefinition.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateContentDefinition.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateContentDefinition.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateContentDefinition.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateRegistry.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateRegistry.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateRegistry.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateRegistry.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateSlot.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateSlot.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateSlot.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateSlot.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateStatus.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateStatus.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateStatus.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateStatus.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateVariableValidator.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateVariableValidator.java similarity index 50% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateVariableValidator.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateVariableValidator.java index e8e42a0e..0f7963c6 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateVariableValidator.java +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateVariableValidator.java @@ -5,6 +5,11 @@ import java.util.Map; /** JSON Schema 2020-12 validation boundary, implemented by an adapter. */ public interface TemplateVariableValidator { - /** Validate before any provider call; missing or mistyped variables are not retryable. */ + /** + * Validate the one-way renderer projection before any provider call. + * + *

      {@code Object} is intentional at this boundary: submission values are already represented by + * the closed NotificationVariable algebra before they are projected for rendering. + */ void validate(VariableSchema schema, Map variables); } diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateVersionConflictException.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateVersionConflictException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateVersionConflictException.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/TemplateVersionConflictException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/VariableSchema.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/VariableSchema.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/template/VariableSchema.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/template/VariableSchema.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/webpush/WebPushNotification.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/webpush/WebPushNotification.java similarity index 90% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/webpush/WebPushNotification.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/webpush/WebPushNotification.java index d2171bb3..403cd435 100644 --- a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/webpush/WebPushNotification.java +++ b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/webpush/WebPushNotification.java @@ -3,6 +3,7 @@ package dev.caskeleton.application.notification.platform.webpush; import dev.caskeleton.application.notification.platform.api.ContactPointId; import dev.caskeleton.application.notification.platform.api.CorrelationId; import dev.caskeleton.application.notification.platform.api.IdempotencyKey; +import dev.caskeleton.application.notification.platform.api.NotificationVariable; import dev.caskeleton.application.notification.platform.api.TemplateSelection; import dev.caskeleton.application.notification.platform.api.TenantId; import java.time.Instant; @@ -16,7 +17,7 @@ public record WebPushNotification( IdempotencyKey idempotencyKey, ContactPointId recipient, TemplateSelection template, - Map variables, + Map variables, Optional expiresAt, CorrelationId correlationId) { diff --git a/src/application-core/src/main/java/dev/caskeleton/application/notification/platform/webpush/WebPushNotifier.java b/src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/webpush/WebPushNotifier.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/notification/platform/webpush/WebPushNotifier.java rename to src/application-notification/src/main/java/dev/caskeleton/application/notification/platform/webpush/WebPushNotifier.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesUseCaseTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesUseCaseTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesUseCaseTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/InitializeNotificationWriterFencesUseCaseTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationAdmissionGateUseCaseTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationAdmissionGateUseCaseTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationAdmissionGateUseCaseTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationAdmissionGateUseCaseTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationCanonicalWriterFenceGuardTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationCanonicalWriterFenceGuardTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationCanonicalWriterFenceGuardTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationCanonicalWriterFenceGuardTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationCapabilityCompatibilityValidatorTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationCapabilityCompatibilityValidatorTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationCapabilityCompatibilityValidatorTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationCapabilityCompatibilityValidatorTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationDispatchUseCaseTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationDispatchUseCaseTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationDispatchUseCaseTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationDispatchUseCaseTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationKindPolicyTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationKindPolicyTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationKindPolicyTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationKindPolicyTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationLegacyWriterPermitUseCaseTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationLegacyWriterPermitUseCaseTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationLegacyWriterPermitUseCaseTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationLegacyWriterPermitUseCaseTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationMaintenanceUseCaseTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationMaintenanceUseCaseTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationMaintenanceUseCaseTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationMaintenanceUseCaseTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationOperationsSnapshotUseCaseTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationOperationsSnapshotUseCaseTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationOperationsSnapshotUseCaseTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationOperationsSnapshotUseCaseTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationPlanningBoundaryTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationPlanningBoundaryTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationPlanningBoundaryTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationPlanningBoundaryTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationPortBoundaryTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationPortBoundaryTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationPortBoundaryTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationPortBoundaryTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationPortContractTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationPortContractTest.java similarity index 76% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationPortContractTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationPortContractTest.java index 29330f3a..49f2222b 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationPortContractTest.java +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationPortContractTest.java @@ -8,16 +8,16 @@ import java.util.List; import org.junit.jupiter.api.Test; /** - * Contract test for the application-core notification types: {@link Channel}, {@link Notification}, - * and {@link NotificationPort}. + * Contract test for the application-core notification types: {@link NotificationChannel}, {@link + * Notification}, and {@link NotificationPort}. * *

      Verifies: * *

        *
      • {@link Notification} compact constructor rejects nulls (invariant). - *
      • {@link NotificationPort#notify(Channel, Notification)} delegates to the two-arg overload - * with route="default". - *
      • {@link Channel} enum values are stable (EMAIL, SLACK). + *
      • {@link NotificationPort#notify(NotificationChannel, Notification)} delegates to the two-arg + * overload with route="default". + *
      • {@link NotificationChannel} enum values are stable (EMAIL, SLACK). *
      • No Spring/JPA/HTTP import is needed — pure unit test. *
      */ @@ -26,12 +26,12 @@ class NotificationPortContractTest { /** Fake port that records calls for assertion. */ private static final class RecordingPort implements NotificationPort { - record Call(Channel channel, String route, Notification notification) {} + record Call(NotificationChannel channel, String route, Notification notification) {} final List calls = new ArrayList<>(); @Override - public void notify(Channel channel, String route, Notification notification) { + public void notify(NotificationChannel channel, String route, Notification notification) { calls.add(new Call(channel, route, notification)); } } @@ -67,7 +67,8 @@ class NotificationPortContractTest { @Test void channelEnumHasEmailAndSlack() { - assertThat(Channel.values()).containsExactlyInAnyOrder(Channel.EMAIL, Channel.SLACK); + assertThat(NotificationChannel.values()) + .containsExactlyInAnyOrder(NotificationChannel.EMAIL, NotificationChannel.SLACK); } @Test @@ -75,10 +76,10 @@ class NotificationPortContractTest { RecordingPort port = new RecordingPort(); Notification n = new Notification("me@example.com", "s", "b"); - port.notify(Channel.EMAIL, n); + port.notify(NotificationChannel.EMAIL, n); assertThat(port.calls).hasSize(1); - assertThat(port.calls.get(0).channel()).isEqualTo(Channel.EMAIL); + assertThat(port.calls.get(0).channel()).isEqualTo(NotificationChannel.EMAIL); assertThat(port.calls.get(0).route()).isEqualTo("default"); assertThat(port.calls.get(0).notification()).isSameAs(n); } @@ -88,7 +89,7 @@ class NotificationPortContractTest { RecordingPort port = new RecordingPort(); Notification n = new Notification("me@example.com", "s", "b"); - port.notify(Channel.SLACK, "alerts", n); + port.notify(NotificationChannel.SLACK, "alerts", n); assertThat(port.calls).hasSize(1); assertThat(port.calls.get(0).route()).isEqualTo("alerts"); diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationReceiptReducerTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationReceiptReducerTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationReceiptReducerTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationReceiptReducerTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationRequestResultTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationRequestResultTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationRequestResultTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationRequestResultTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationTestFixtures.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationTestFixtures.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationTestFixtures.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationTestFixtures.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationValueContractTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationValueContractTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/NotificationValueContractTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/NotificationValueContractTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/ReconcileNotificationDeliveriesUseCaseTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/ReconcileNotificationDeliveriesUseCaseTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/ReconcileNotificationDeliveriesUseCaseTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/ReconcileNotificationDeliveriesUseCaseTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationUseCaseTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationUseCaseTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationUseCaseTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/RecordNotificationWriterQuiescenceAttestationUseCaseTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipUseCaseTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipUseCaseTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipUseCaseTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/SwitchNotificationWriterOwnershipUseCaseTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsUseCaseTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsUseCaseTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsUseCaseTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/TerminalizeExpiredNotificationWriterPermitsUseCaseTest.java diff --git a/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/admin/AdminAuthorizationGuardTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/admin/AdminAuthorizationGuardTest.java new file mode 100644 index 00000000..b9643988 --- /dev/null +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/admin/AdminAuthorizationGuardTest.java @@ -0,0 +1,49 @@ +package dev.caskeleton.application.notification.platform.admin; + +import static org.assertj.core.api.Assertions.assertThatCode; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +import dev.caskeleton.application.notification.platform.api.TenantId; +import java.util.Optional; +import java.util.Set; +import org.junit.jupiter.api.Test; + +class AdminAuthorizationGuardTest { + + private final AdminAuthorizationGuard guard = new AdminAuthorizationGuard(); + + @Test + void authorityMustBeHeldExplicitly() { + AdminActor actor = + new AdminActor("operator-1", Set.of(NotificationAdminAuthority.REDRIVE), Optional.empty()); + + assertThatCode(() -> guard.require(actor, NotificationAdminAuthority.REDRIVE)) + .doesNotThrowAnyException(); + assertThatThrownBy(() -> guard.require(actor, NotificationAdminAuthority.SUPPRESS)) + .isInstanceOf(AdminAccessDeniedException.class); + } + + @Test + void tenantScopedActorCannotCrossTenantBoundary() { + AdminActor actor = + new AdminActor( + "operator-1", + Set.of(NotificationAdminAuthority.SUPPRESS), + Optional.of(new TenantId("tenant-a"))); + + assertThatCode(() -> guard.requireTenant(actor, new TenantId("tenant-a"))) + .doesNotThrowAnyException(); + assertThatThrownBy(() -> guard.requireTenant(actor, new TenantId("tenant-b"))) + .isInstanceOf(AdminAccessDeniedException.class); + } + + @Test + void globalOperatorMayActAcrossTenants() { + AdminActor global = + new AdminActor( + "global-operator", Set.of(NotificationAdminAuthority.SUPPRESS), Optional.empty()); + + assertThatCode(() -> guard.requireTenant(global, new TenantId("tenant-b"))) + .doesNotThrowAnyException(); + } +} diff --git a/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/admin/AdminOperationCommandFingerprintTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/admin/AdminOperationCommandFingerprintTest.java new file mode 100644 index 00000000..0fe7fd5a --- /dev/null +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/admin/AdminOperationCommandFingerprintTest.java @@ -0,0 +1,51 @@ +package dev.caskeleton.application.notification.platform.admin; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.application.notification.platform.api.DeliveryAttemptId; +import java.security.MessageDigest; +import java.security.NoSuchAlgorithmException; +import java.util.List; +import java.util.UUID; +import org.junit.jupiter.api.Test; + +class AdminOperationCommandFingerprintTest { + + private final AdminOperationCommandFingerprint fingerprints = + new AdminOperationCommandFingerprint(AdminOperationCommandFingerprintTest::sha256); + + @Test + void fingerprintIsStableSha256AndChangesWithCommandMeaning() { + DeliveryAttemptId attempt = new DeliveryAttemptId(UUID.fromString("00000000-0000-0000-0000-1")); + RedriveCommand first = new RedriveCommand("op-1", attempt, "retry", true, false); + RedriveCommand same = new RedriveCommand("another-id", attempt, "retry", true, false); + RedriveCommand changed = new RedriveCommand("op-1", attempt, "different", true, false); + + assertThat(fingerprints.of(first)).matches("[0-9a-f]{64}"); + assertThat(fingerprints.of(same)).isEqualTo(fingerprints.of(first)); + assertThat(fingerprints.of(changed)).isNotEqualTo(fingerprints.of(first)); + } + + @Test + void reconciliationFingerprintIgnoresBatchOrdering() { + DeliveryAttemptId first = + new DeliveryAttemptId(UUID.fromString("00000000-0000-0000-0000-000000000001")); + DeliveryAttemptId second = + new DeliveryAttemptId(UUID.fromString("00000000-0000-0000-0000-000000000002")); + + ReconcileCommand ordered = + new ReconcileCommand("op-1", List.of(first, second), "reconcile", false); + ReconcileCommand reversed = + new ReconcileCommand("op-2", List.of(second, first), "reconcile", false); + + assertThat(fingerprints.of(ordered)).isEqualTo(fingerprints.of(reversed)); + } + + private static byte[] sha256(byte[] bytes) { + try { + return MessageDigest.getInstance("SHA-256").digest(bytes); + } catch (NoSuchAlgorithmException impossible) { + throw new IllegalStateException(impossible); + } + } +} diff --git a/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/admin/AdminOperationExecutorTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/admin/AdminOperationExecutorTest.java new file mode 100644 index 00000000..62612cba --- /dev/null +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/admin/AdminOperationExecutorTest.java @@ -0,0 +1,166 @@ +package dev.caskeleton.application.notification.platform.admin; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +import dev.caskeleton.application.transaction.TransactionPort; +import java.util.Optional; +import java.util.Set; +import java.util.concurrent.atomic.AtomicInteger; +import java.util.function.Supplier; +import org.junit.jupiter.api.Test; + +class AdminOperationExecutorTest { + + private static final AdminActor ACTOR = new AdminActor("operator-1", Set.of(), Optional.empty()); + private static final String FINGERPRINT = "a".repeat(64); + + @Test + void claimedOperationIsTheOnlyOutcomeThatRunsTheSideEffect() { + FakeStore store = new FakeStore(AdminOperationClaim.claimed()); + RecordingTransactions transactions = new RecordingTransactions(); + AdminOperationExecutor executor = new AdminOperationExecutor(store, transactions); + AtomicInteger sideEffects = new AtomicInteger(); + + AdminOperationResult result = + executor.execute( + "op-1", + FINGERPRINT, + ACTOR, + "ADMIN_PROVIDER_STATE", + () -> { + sideEffects.incrementAndGet(); + return result("op-1"); + }); + + assertThat(result.operationId()).isEqualTo("op-1"); + assertThat(sideEffects).hasValue(1); + assertThat(store.claims).isEqualTo(1); + assertThat(transactions.writes).isEqualTo(1); + } + + @Test + void replayReturnsTheStoredResultWithoutRunningTheSideEffect() { + AdminOperationResult previous = result("op-1"); + FakeStore store = new FakeStore(AdminOperationClaim.replay(previous)); + AdminOperationExecutor executor = + new AdminOperationExecutor(store, new RecordingTransactions()); + AtomicInteger sideEffects = new AtomicInteger(); + + AdminOperationResult replayed = + executor.execute( + "op-1", + FINGERPRINT, + ACTOR, + "ADMIN_PROVIDER_STATE", + () -> { + sideEffects.incrementAndGet(); + return result("op-1"); + }); + + assertThat(replayed).isSameAs(previous); + assertThat(sideEffects).hasValue(0); + } + + @Test + void inProgressClaimStopsBeforeTheSideEffect() { + FakeStore store = new FakeStore(AdminOperationClaim.inProgress()); + AdminOperationExecutor executor = + new AdminOperationExecutor(store, new RecordingTransactions()); + AtomicInteger sideEffects = new AtomicInteger(); + + assertThatThrownBy( + () -> + executor.execute( + "op-1", FINGERPRINT, ACTOR, "ADMIN_REDRIVE", sideEffect(sideEffects))) + .isInstanceOf(AdminOperationInProgressException.class); + + assertThat(sideEffects).hasValue(0); + } + + @Test + void conflictingCommandStopsBeforeTheSideEffect() { + FakeStore store = new FakeStore(AdminOperationClaim.conflict()); + AdminOperationExecutor executor = + new AdminOperationExecutor(store, new RecordingTransactions()); + AtomicInteger sideEffects = new AtomicInteger(); + + assertThatThrownBy( + () -> + executor.execute( + "op-1", FINGERPRINT, ACTOR, "ADMIN_REDRIVE", sideEffect(sideEffects))) + .isInstanceOf(AdminOperationConflictException.class); + + assertThat(sideEffects).hasValue(0); + } + + private static Supplier sideEffect(AtomicInteger sideEffects) { + return () -> { + sideEffects.incrementAndGet(); + return result("op-1"); + }; + } + + private static AdminOperationResult result(String operationId) { + return new AdminOperationResult( + operationId, + false, + 1, + Optional.empty(), + Optional.empty(), + Optional.empty(), + java.util.List.of("ok")); + } + + private static final class FakeStore implements AdminOperationStorePort { + private final AdminOperationClaim outcome; + private int claims; + + FakeStore(AdminOperationClaim outcome) { + this.outcome = outcome; + } + + @Override + public Optional findByOperationId(String operationId) { + return Optional.empty(); + } + + @Override + public AdminOperationResult save(AdminOperationResult result, AdminActor actor, String action) { + return result; + } + + @Override + public AdminOperationClaim claim( + String operationId, String commandFingerprint, AdminActor actor, String action) { + claims++; + assertThat(commandFingerprint).isEqualTo(FINGERPRINT); + return outcome; + } + } + + private static final class RecordingTransactions implements TransactionPort { + private int writes; + + @Override + public T inWrite(Supplier action) { + writes++; + return action.get(); + } + + @Override + public T inRootWrite(Supplier action) { + return action.get(); + } + + @Override + public T inRead(Supplier action) { + return action.get(); + } + + @Override + public T inNew(Supplier action) { + return action.get(); + } + } +} diff --git a/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/admin/DuplicateRiskGuardTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/admin/DuplicateRiskGuardTest.java new file mode 100644 index 00000000..4181bbc5 --- /dev/null +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/admin/DuplicateRiskGuardTest.java @@ -0,0 +1,79 @@ +package dev.caskeleton.application.notification.platform.admin; + +import static org.assertj.core.api.Assertions.assertThatCode; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +import dev.caskeleton.application.notification.platform.api.ContactPointId; +import dev.caskeleton.application.notification.platform.api.DeliveryAttemptId; +import dev.caskeleton.application.notification.platform.api.NotificationId; +import dev.caskeleton.application.notification.platform.api.ProviderId; +import dev.caskeleton.application.notification.platform.api.ProviderProfileId; +import dev.caskeleton.application.notification.platform.api.RecipientDeliveryId; +import dev.caskeleton.application.notification.platform.api.TenantId; +import dev.caskeleton.application.notification.platform.api.delivery.AttemptConfirmation; +import dev.caskeleton.application.notification.platform.api.delivery.DeliveryOutcome; +import dev.caskeleton.application.notification.platform.api.delivery.EvidenceLevel; +import dev.caskeleton.application.notification.platform.api.delivery.SubmissionOutcome; +import dev.caskeleton.application.notification.platform.api.routing.Channel; +import dev.caskeleton.application.notification.platform.callback.DeliveryAttemptSnapshot; +import java.time.Instant; +import java.util.Optional; +import java.util.UUID; +import org.junit.jupiter.api.Test; + +class DuplicateRiskGuardTest { + + private static final Instant NOW = Instant.parse("2026-09-20T00:00:00Z"); + private final DuplicateRiskGuard guard = new DuplicateRiskGuard(); + + @Test + void ambiguousAttemptRequiresExplicitApproval() { + DeliveryAttemptSnapshot attempt = + attempt(AttemptConfirmation.AMBIGUOUS, SubmissionOutcome.AMBIGUOUS); + + assertThatThrownBy(() -> guard.verify(attempt, false)) + .isInstanceOf(DuplicateRiskApprovalRequiredException.class); + assertThatCode(() -> guard.verify(attempt, true)).doesNotThrowAnyException(); + } + + @Test + void confirmedAcceptedAttemptAlsoRequiresApprovalBeforeRedrive() { + DeliveryAttemptSnapshot attempt = + attempt(AttemptConfirmation.CONFIRMED, SubmissionOutcome.CONFIRMED_ACCEPTED); + + assertThatThrownBy(() -> guard.verify(attempt, false)) + .isInstanceOf(DuplicateRiskApprovalRequiredException.class); + } + + @Test + void provenNotSubmittedAttemptDoesNotRequireDuplicateApproval() { + DeliveryAttemptSnapshot attempt = + attempt(AttemptConfirmation.REJECTED, SubmissionOutcome.NOT_SUBMITTED); + + assertThatCode(() -> guard.verify(attempt, false)).doesNotThrowAnyException(); + } + + private static DeliveryAttemptSnapshot attempt( + AttemptConfirmation confirmation, SubmissionOutcome submissionOutcome) { + return new DeliveryAttemptSnapshot( + new DeliveryAttemptId(UUID.fromString("00000000-0000-7000-8000-000000000001")), + new RecipientDeliveryId(UUID.fromString("00000000-0000-7000-8000-000000000002")), + new NotificationId(UUID.fromString("00000000-0000-7000-8000-000000000003")), + new TenantId("tenant-a"), + 1, + Channel.EMAIL, + new ProviderId("provider-a"), + new ProviderProfileId("provider-a-primary"), + Optional.empty(), + new ContactPointId(UUID.fromString("00000000-0000-7000-8000-000000000004")), + confirmation, + submissionOutcome, + DeliveryOutcome.UNKNOWN, + EvidenceLevel.PLATFORM_QUEUED, + 1L, + "a".repeat(64), + NOW, + Optional.empty(), + Optional.empty()); + } +} diff --git a/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminApplicationServiceTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminApplicationServiceTest.java new file mode 100644 index 00000000..316f1eae --- /dev/null +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/admin/NotificationAdminApplicationServiceTest.java @@ -0,0 +1,182 @@ +package dev.caskeleton.application.notification.platform.admin; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.application.notification.platform.api.ProviderProfileId; +import dev.caskeleton.application.notification.platform.dispatch.NotificationPlatformNoops; +import dev.caskeleton.application.notification.platform.dispatch.PlatformFakes; +import dev.caskeleton.application.notification.platform.observation.NotificationAuditEvent; +import dev.caskeleton.application.notification.platform.observation.NotificationAuditPort; +import dev.caskeleton.application.notification.platform.policy.SuppressionEntry; +import dev.caskeleton.application.notification.platform.policy.SuppressionId; +import dev.caskeleton.application.notification.platform.policy.SuppressionStorePort; +import dev.caskeleton.application.notification.platform.provider.ProviderRuntimeState; +import java.time.Clock; +import java.time.Instant; +import java.time.ZoneOffset; +import java.util.ArrayList; +import java.util.List; +import java.util.Optional; +import java.util.Set; +import org.junit.jupiter.api.Test; + +class NotificationAdminApplicationServiceTest { + + private static final Clock CLOCK = + Clock.fixed(Instant.parse("2026-09-20T00:00:00Z"), ZoneOffset.UTC); + private static final AdminActor ACTOR = + new AdminActor( + "operator-1", Set.of(NotificationAdminAuthority.PROVIDER_CONTROL), Optional.empty()); + + @Test + void providerStateMutationClaimsBeforeCallingTheRuntime() { + Fixture fixture = new Fixture(); + SetProviderStateCommand command = + new SetProviderStateCommand( + "op-1", + new ProviderProfileId("ses-primary"), + ProviderRuntimeState.DISABLED, + "provider maintenance", + false); + + AdminOperationResult result = fixture.service.setProviderState(command, ACTOR); + + assertThat(result.operationId()).isEqualTo("op-1"); + assertThat(fixture.operations.claims).isEqualTo(1); + assertThat(fixture.operations.saved).isEqualTo(1); + assertThat(fixture.runtime.calls).isEqualTo(1); + assertThat(fixture.runtime.profile).isEqualTo(new ProviderProfileId("ses-primary")); + assertThat(fixture.runtime.state).isEqualTo(ProviderRuntimeState.DISABLED); + assertThat(fixture.audit.events) + .extracting(NotificationAuditEvent::action) + .containsExactly("ADMIN_PROVIDER_STATE"); + } + + @Test + void providerStateDryRunDoesNotClaimOrMutateRuntime() { + Fixture fixture = new Fixture(); + SetProviderStateCommand command = + new SetProviderStateCommand( + "op-dry", + new ProviderProfileId("ses-primary"), + ProviderRuntimeState.DRAINING, + "inspect only", + true); + + AdminOperationResult result = fixture.service.setProviderState(command, ACTOR); + + assertThat(result.dryRun()).isTrue(); + assertThat(fixture.operations.claims).isZero(); + assertThat(fixture.operations.saved).isZero(); + assertThat(fixture.runtime.calls).isZero(); + } + + private static final class Fixture { + private final PlatformFakes.AttemptStore attempts = new PlatformFakes.AttemptStore(); + private final PlatformFakes.RequestStore requests = new PlatformFakes.RequestStore(); + private final PlatformFakes.RecipientStore recipients = + new PlatformFakes.RecipientStore(requests); + private final RecordingRuntime runtime = new RecordingRuntime(); + private final RecordingOperations operations = new RecordingOperations(); + private final RecordingAudit audit = new RecordingAudit(); + private final PlatformFakes.RecordingTransactions transactions = + new PlatformFakes.RecordingTransactions(); + private final NotificationAdminApplicationService service = + new NotificationAdminApplicationService( + new AdminAuthorizationGuard(), + new DuplicateRiskGuard(), + attempts, + recipients, + NotificationPlatformNoops.reconciliation(attempts, recipients, CLOCK), + new UnusedSuppressionStore(), + runtime, + operations, + audit, + transactions, + new PlatformFakes.SequentialIds(), + NotificationAdminApplicationServiceTest::sha256, + CLOCK); + } + + private static final class RecordingRuntime implements ProviderRuntimeControlPort { + private int calls; + private ProviderProfileId profile; + private ProviderRuntimeState state; + + @Override + public boolean setState( + ProviderProfileId profileId, ProviderRuntimeState desiredState, String reason) { + calls++; + profile = profileId; + state = desiredState; + return true; + } + + @Override + public ProviderRuntimeState state(ProviderProfileId profileId) { + return state == null ? ProviderRuntimeState.HEALTHY : state; + } + } + + private static final class RecordingOperations implements AdminOperationStorePort { + private int claims; + private int saved; + + @Override + public Optional findByOperationId(String operationId) { + return Optional.empty(); + } + + @Override + public AdminOperationResult save(AdminOperationResult result, AdminActor actor, String action) { + saved++; + return result; + } + + @Override + public AdminOperationClaim claim( + String operationId, String commandFingerprint, AdminActor actor, String action) { + claims++; + assertThat(commandFingerprint).matches("[0-9a-f]{64}"); + return AdminOperationClaim.claimed(); + } + } + + private static final class RecordingAudit implements NotificationAuditPort { + private final List events = new ArrayList<>(); + + @Override + public void record(NotificationAuditEvent event) { + events.add(event); + } + } + + private static final class UnusedSuppressionStore implements SuppressionStorePort { + @Override + public List activeFor( + dev.caskeleton.application.notification.platform.api.TenantId tenantId, + String targetFingerprint, + Instant at) { + return List.of(); + } + + @Override + public SuppressionEntry upsert(SuppressionEntry entry) { + throw new UnsupportedOperationException(); + } + + @Override + public Optional remove( + dev.caskeleton.application.notification.platform.api.TenantId tenantId, SuppressionId id) { + return Optional.empty(); + } + } + + private static byte[] sha256(byte[] bytes) { + try { + return java.security.MessageDigest.getInstance("SHA-256").digest(bytes); + } catch (java.security.NoSuchAlgorithmException impossible) { + throw new IllegalStateException(impossible); + } + } +} diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/api/NotificationPlanTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/api/NotificationPlanTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/api/NotificationPlanTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/api/NotificationPlanTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/api/PublicApiBoundaryTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/api/PublicApiBoundaryTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/api/PublicApiBoundaryTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/api/PublicApiBoundaryTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/api/PublicApiIsTypedTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/api/PublicApiIsTypedTest.java similarity index 67% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/api/PublicApiIsTypedTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/api/PublicApiIsTypedTest.java index b22b40b8..4a482a73 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/api/PublicApiIsTypedTest.java +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/api/PublicApiIsTypedTest.java @@ -2,15 +2,11 @@ package dev.caskeleton.application.notification.platform.api; import static org.assertj.core.api.Assertions.assertThat; -import java.io.IOException; -import java.io.UncheckedIOException; +import dev.caskeleton.application.testsupport.CompiledPackageScanner; import java.lang.reflect.ParameterizedType; import java.lang.reflect.RecordComponent; import java.lang.reflect.Type; import java.lang.reflect.WildcardType; -import java.net.URISyntaxException; -import java.nio.file.Files; -import java.nio.file.Path; import java.util.ArrayList; import java.util.List; import java.util.stream.Stream; @@ -31,7 +27,13 @@ import org.junit.jupiter.api.Test; */ class PublicApiIsTypedTest { - private static final String API_PACKAGE = "dev.caskeleton.application.notification.platform.api"; + private static final List PUBLIC_RECORD_PACKAGES = + List.of( + "dev.caskeleton.application.notification.platform.api", + "dev.caskeleton.application.notification.platform.email", + "dev.caskeleton.application.notification.platform.sms", + "dev.caskeleton.application.notification.platform.push", + "dev.caskeleton.application.notification.platform.webpush"); @Test @DisplayName("no public API record carries an untyped value at any depth") @@ -108,15 +110,17 @@ class PublicApiIsTypedTest { */ private static List> apiRecords() { List> records = new ArrayList<>(); - for (String name : classNamesUnder(API_PACKAGE)) { - Class type; - try { - type = Class.forName(name); - } catch (ClassNotFoundException | NoClassDefFoundError unavailable) { - continue; - } - if (type.isRecord() && java.lang.reflect.Modifier.isPublic(type.getModifiers())) { - records.add(type); + for (String packageName : PUBLIC_RECORD_PACKAGES) { + for (String name : classNamesUnder(packageName)) { + Class type; + try { + type = Class.forName(name); + } catch (ClassNotFoundException | NoClassDefFoundError unavailable) { + continue; + } + if (type.isRecord() && java.lang.reflect.Modifier.isPublic(type.getModifiers())) { + records.add(type); + } } } return records; @@ -129,34 +133,6 @@ class PublicApiIsTypedTest { * @return every class name below it */ private static List classNamesUnder(String packageName) { - try { - // Anchored on a class that lives in the package being scanned, so the root is the main - // output directory whatever the test output layout is. Anchoring on this test class instead - // pointed at the test output root, where the API package does not exist — and the sweep then - // found nothing and passed. The vacuity guard below is what caught that. - Path root = - Path.of( - NotificationPlan.class.getProtectionDomain().getCodeSource().getLocation().toURI()); - Path packageRoot = root.resolve(packageName.replace('.', '/')); - if (!Files.isDirectory(packageRoot)) { - return List.of(); - } - try (Stream files = Files.walk(packageRoot)) { - return files - .filter(path -> path.toString().endsWith(".class")) - .map( - path -> - packageName - + "." - + packageRoot - .relativize(path) - .toString() - .replace(java.io.File.separatorChar, '.') - .replaceAll("\\.class$", "")) - .toList(); - } - } catch (URISyntaxException | IOException unreadable) { - throw new UncheckedIOException(new IOException("cannot scan " + packageName, unreadable)); - } + return CompiledPackageScanner.classNamesUnder(NotificationPlan.class, packageName); } } diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/api/content/NotificationContentContractTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/api/content/NotificationContentContractTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/api/content/NotificationContentContractTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/api/content/NotificationContentContractTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/api/delivery/EvidenceModelTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/api/delivery/EvidenceModelTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/api/delivery/EvidenceModelTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/api/delivery/EvidenceModelTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/api/error/NotificationExceptionTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/api/error/NotificationExceptionTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/api/error/NotificationExceptionTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/api/error/NotificationExceptionTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/callback/CallbackFixtures.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/callback/CallbackFixtures.java similarity index 95% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/callback/CallbackFixtures.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/callback/CallbackFixtures.java index c61291dd..ed5a0f68 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/callback/CallbackFixtures.java +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/callback/CallbackFixtures.java @@ -2,6 +2,8 @@ package dev.caskeleton.application.notification.platform.callback; import dev.caskeleton.application.notification.platform.api.ContactPointId; import dev.caskeleton.application.notification.platform.api.DeliveryAttemptId; +import dev.caskeleton.application.notification.platform.api.NormalizedEventType; +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; import dev.caskeleton.application.notification.platform.api.NotificationId; import dev.caskeleton.application.notification.platform.api.ProviderId; import dev.caskeleton.application.notification.platform.api.ProviderProfileId; diff --git a/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/callback/CallbackIngestionAtomicityTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/callback/CallbackIngestionAtomicityTest.java new file mode 100644 index 00000000..169287a2 --- /dev/null +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/callback/CallbackIngestionAtomicityTest.java @@ -0,0 +1,193 @@ +package dev.caskeleton.application.notification.platform.callback; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.application.notification.platform.api.DeliveryAttemptId; +import dev.caskeleton.application.notification.platform.api.NormalizedEventType; +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; +import dev.caskeleton.application.notification.platform.api.ProviderId; +import dev.caskeleton.application.notification.platform.api.ProviderProfileId; +import dev.caskeleton.application.notification.platform.observation.NotificationMetricsPort; +import dev.caskeleton.application.notification.platform.port.in.IngestProviderCallbackCommand; +import dev.caskeleton.application.transaction.TransactionPort; +import java.time.Clock; +import java.time.Instant; +import java.time.ZoneOffset; +import java.util.ArrayList; +import java.util.List; +import java.util.Map; +import java.util.Optional; +import java.util.function.Supplier; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; + +/** What the durable callback ingestion use case promises once an adapter has verified the input. */ +class CallbackIngestionAtomicityTest { + + private static final Instant NOW = Instant.parse("2026-08-15T09:00:00Z"); + private static final ProviderId SES = new ProviderId("ses"); + private static final ProviderProfileId PROFILE = new ProviderProfileId("email-main"); + + private final RecordingLedger ledger = new RecordingLedger(); + private final RecordingTransactions transactions = new RecordingTransactions(); + + @Test + @DisplayName("the append runs inside one transaction") + void theAppendRunsInsideOneTransaction() { + service().handle(callback()); + + assertThat(transactions.writes) + .as("event-at-a-time appends could commit the first and lose the rest") + .isEqualTo(1); + assertThat(ledger.appended).hasSize(1); + } + + @Test + @DisplayName("the endpoint may return once the event is durable, without projecting it") + void theEndpointReturnsOnceTheEventIsDurable() { + service().handle(callback()); + + assertThat(ledger.appended).as("the event is durable when ingestion returns").hasSize(1); + assertThat(IngestProviderCallbackApplicationUseCase.class.getDeclaredFields()) + .noneMatch(field -> field.getType().equals(ProviderEventProjectionService.class)); + } + + @Test + @DisplayName("provider verification is not an application dependency") + void providerVerificationIsOutsideTheUseCase() { + assertThat(IngestProviderCallbackApplicationUseCase.class.getDeclaredFields()) + .noneMatch(field -> field.getType().getSimpleName().contains("ProviderCallbackAdapter")); + } + + private IngestProviderCallbackApplicationUseCase service() { + return new IngestProviderCallbackApplicationUseCase( + ledger, + transactions, + new PassThroughProtection(), + new DiscardingMetrics(), + Clock.fixed(NOW, ZoneOffset.UTC)); + } + + private static IngestProviderCallbackCommand callback() { + return new IngestProviderCallbackCommand( + SES, + PROFILE, + List.of( + new NormalizedProviderEvent( + NormalizedEventType.DELIVERY_CONFIRMED, + "delivered", + Optional.of("event-1"), + Optional.of("request-1"), + Optional.of(NOW), + Map.of())), + "{}".getBytes(java.nio.charset.StandardCharsets.UTF_8)); + } + + /** Counts write boundaries, so "one transaction" is a fact rather than a claim. */ + private static final class RecordingTransactions implements TransactionPort { + + private int writes; + + @Override + public T inWrite(Supplier action) { + writes++; + return action.get(); + } + + @Override + public T inRootWrite(Supplier action) { + return inWrite(action); + } + + @Override + public T inRead(Supplier action) { + return action.get(); + } + + @Override + public T inNew(Supplier action) { + return inWrite(action); + } + } + + private static final class RecordingLedger implements ProviderEventLedger { + + private final List appended = new ArrayList<>(); + + @Override + public AppendEventResult append(VerifiedProviderEvent event) { + return appendAll(List.of(event)); + } + + @Override + public AppendEventResult appendAll(List events) { + appended.addAll(events); + return new AppendEventResult(List.of(), List.of()); + } + + @Override + public List pendingProjection(int limit) { + return List.of(); + } + + @Override + public void markApplied(ProviderEventRecordId eventId, ProjectionResult result) {} + + @Override + public void markFailed(ProviderEventRecordId eventId, String errorCode) {} + + @Override + public List unmatched(int limit) { + return List.of(); + } + + @Override + public List bindUnmatched( + ProviderProfileId providerProfileId, + String providerRequestId, + DeliveryAttemptId attemptId) { + return List.of(); + } + + @Override + public boolean bindAttempt(ProviderEventRecordId eventId, DeliveryAttemptId attemptId) { + return false; + } + + @Override + public List eventsForAttempt(DeliveryAttemptId attemptId) { + return List.of(); + } + } + + private static final class PassThroughProtection implements CallbackPayloadProtectionPort { + + @Override + public byte[] protectRawPayload(byte[] rawPayload) { + return rawPayload; + } + + @Override + public String digest(byte[] rawPayload) { + return "0".repeat(64); + } + + @Override + public String fingerprint( + ProviderProfileId profileId, NormalizedProviderEvent event, String rawDigest) { + return "1".repeat(64); + } + } + + private static final class DiscardingMetrics implements NotificationMetricsPort { + + @Override + public void increment(String metricName, Map tags) {} + + @Override + public void record(String metricName, Map tags, java.time.Duration value) {} + + @Override + public void gauge(String metricName, Map tags, double value) {} + } +} diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/callback/ProjectionMergeContractTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/callback/ProjectionMergeContractTest.java similarity index 98% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/callback/ProjectionMergeContractTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/callback/ProjectionMergeContractTest.java index 4f9f879c..3a8eb775 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/callback/ProjectionMergeContractTest.java +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/callback/ProjectionMergeContractTest.java @@ -2,6 +2,7 @@ package dev.caskeleton.application.notification.platform.callback; import static org.assertj.core.api.Assertions.assertThat; +import dev.caskeleton.application.notification.platform.api.NormalizedEventType; import dev.caskeleton.application.notification.platform.api.ProviderId; import dev.caskeleton.application.notification.platform.api.delivery.DeliveryOutcome; import dev.caskeleton.application.notification.platform.api.delivery.EvidenceLevel; diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/callback/ProviderEventLateMatchTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/callback/ProviderEventLateMatchTest.java similarity index 99% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/callback/ProviderEventLateMatchTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/callback/ProviderEventLateMatchTest.java index 7a41cb51..6f76e228 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/callback/ProviderEventLateMatchTest.java +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/callback/ProviderEventLateMatchTest.java @@ -3,6 +3,7 @@ package dev.caskeleton.application.notification.platform.callback; import static org.assertj.core.api.Assertions.assertThat; import dev.caskeleton.application.notification.platform.api.DeliveryAttemptId; +import dev.caskeleton.application.notification.platform.api.NormalizedEventType; import dev.caskeleton.application.notification.platform.api.ProviderId; import dev.caskeleton.application.notification.platform.api.ProviderProfileId; import dev.caskeleton.application.notification.platform.api.delivery.DeliveryOutcome; diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/contact/ContactPointTypeTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/contact/ContactPointTypeTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/contact/ContactPointTypeTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/contact/ContactPointTypeTest.java diff --git a/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/AcceptNotificationApplicationUseCaseTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/AcceptNotificationApplicationUseCaseTest.java new file mode 100644 index 00000000..dbbc0853 --- /dev/null +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/AcceptNotificationApplicationUseCaseTest.java @@ -0,0 +1,177 @@ +package dev.caskeleton.application.notification.platform.dispatch; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.application.notification.platform.api.NotificationId; +import dev.caskeleton.application.notification.platform.api.NotificationPlan; +import dev.caskeleton.application.notification.platform.api.NotificationReceipt; +import dev.caskeleton.application.notification.platform.api.NotificationVariable; +import dev.caskeleton.application.notification.platform.api.RequestStatus; +import dev.caskeleton.application.notification.platform.api.TenantId; +import dev.caskeleton.application.notification.platform.api.routing.Channel; +import dev.caskeleton.application.notification.platform.contact.ContactPointStatus; +import dev.caskeleton.application.notification.platform.contact.ContactPointValue; +import dev.caskeleton.application.notification.platform.port.in.AcceptNotificationCommand; +import dev.caskeleton.application.notification.platform.port.in.SubmitNotificationCommand; +import dev.caskeleton.application.notification.platform.port.in.SubmitNotificationUseCase; +import dev.caskeleton.application.notification.platform.security.AccessContext; +import dev.caskeleton.application.notification.platform.security.ContactPointProtector; +import dev.caskeleton.application.notification.platform.security.ProtectedContactPoint; +import java.time.Clock; +import java.time.Instant; +import java.time.ZoneOffset; +import java.util.ArrayList; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Locale; +import java.util.Map; +import java.util.Optional; +import java.util.UUID; +import org.junit.jupiter.api.Test; + +class AcceptNotificationApplicationUseCaseTest { + + private static final Instant NOW = Instant.parse("2026-09-19T00:00:00Z"); + + @Test + void derivedIdempotencyKeyIsStableSha256OverTheCanonicalPlan() { + CapturingSubmit submit = new CapturingSubmit(); + InMemoryContactPoints contactPoints = new InMemoryContactPoints(); + PlatformFakes.SequentialIds ids = new PlatformFakes.SequentialIds(); + + AcceptNotificationApplicationUseCase useCase = + new AcceptNotificationApplicationUseCase( + submit, + contactPoints, + protector(), + PlatformFakes.tenant("tenant-a"), + ids, + PlatformFakes.fingerprints(), + new PlatformFakes.RecordingTransactions(), + Clock.fixed(NOW, ZoneOffset.UTC)); + + AcceptNotificationCommand command = + command(Map.of("amount", new NotificationVariable.TextValue("10"))); + useCase.handle(command); + useCase.handle(command); + + List keys = submit.plans.stream().map(plan -> plan.idempotencyKey().value()).toList(); + assertThat(keys).hasSize(2); + assertThat(keys.get(0)).matches("[0-9a-f]{64}"); + assertThat(keys.get(0)) + .isEqualTo( + PlatformFakes.fingerprints() + .of(new CanonicalNotificationPlanEncoder().encode(submit.plans.getFirst()))); + assertThat(keys.get(1)).isEqualTo(keys.get(0)); + } + + @Test + void variableInsertionOrderDoesNotChangeTheDerivedKey() { + CapturingSubmit submit = new CapturingSubmit(); + InMemoryContactPoints contactPoints = new InMemoryContactPoints(); + PlatformFakes.SequentialIds ids = new PlatformFakes.SequentialIds(); + + AcceptNotificationApplicationUseCase useCase = + new AcceptNotificationApplicationUseCase( + submit, + contactPoints, + protector(), + PlatformFakes.tenant("tenant-a"), + ids, + PlatformFakes.fingerprints(), + new PlatformFakes.RecordingTransactions(), + Clock.fixed(NOW, ZoneOffset.UTC)); + + Map first = new LinkedHashMap<>(); + first.put("amount", new NotificationVariable.TextValue("10")); + first.put("currency", new NotificationVariable.TextValue("KRW")); + Map second = new LinkedHashMap<>(); + second.put("currency", new NotificationVariable.TextValue("KRW")); + second.put("amount", new NotificationVariable.TextValue("10")); + + useCase.handle(command(first)); + useCase.handle(command(second)); + + assertThat(submit.plans.get(1).idempotencyKey()) + .isEqualTo(submit.plans.get(0).idempotencyKey()); + } + + private static AcceptNotificationCommand command(Map variables) { + return new AcceptNotificationCommand( + Optional.empty(), + "customer-42", + Channel.EMAIL, + "person@example.com", + "payment-receipt", + 1, + Locale.KOREAN, + variables, + Optional.empty(), + "billing"); + } + + private static ContactPointProtector protector() { + return new ContactPointProtector() { + @Override + public ProtectedContactPoint protect(ContactPointValue value) { + return new ProtectedContactPoint( + value.type(), + "test-key", + new byte[] {1}, + value.serialized().getBytes(java.nio.charset.StandardCharsets.UTF_8), + fingerprint(value)); + } + + @Override + public ContactPointValue reveal(ProtectedContactPoint value, AccessContext context) { + throw new UnsupportedOperationException("not used"); + } + + @Override + public String fingerprint(ContactPointValue value) { + return "fp:" + value.normalized(); + } + }; + } + + private static final class CapturingSubmit implements SubmitNotificationUseCase { + private final List plans = new ArrayList<>(); + + @Override + public NotificationReceipt handle(SubmitNotificationCommand command) { + plans.add(command.plan()); + return NotificationReceipt.accepted( + new NotificationId(new UUID(0L, plans.size())), RequestStatus.CREATED, NOW); + } + } + + private static final class InMemoryContactPoints implements ContactPointStorePort { + private final Map byFingerprint = new java.util.HashMap<>(); + + @Override + public Optional find( + TenantId tenantId, dev.caskeleton.application.notification.platform.api.ContactPointId id) { + return byFingerprint.values().stream().filter(record -> record.id().equals(id)).findFirst(); + } + + @Override + public Optional findByFingerprint(TenantId tenantId, String lookupHmac) { + return Optional.ofNullable(byFingerprint.get(lookupHmac)); + } + + @Override + public ContactPointRecord save(ContactPointRecord record) { + byFingerprint.put(record.protectedValue().lookupHmac(), record); + return record; + } + + @Override + public ContactPointRecord updateStatus( + TenantId tenantId, + dev.caskeleton.application.notification.platform.api.ContactPointId id, + ContactPointStatus status, + String reasonCode) { + throw new UnsupportedOperationException("not used"); + } + } +} diff --git a/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/ApplicationReceiptServiceImplTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/ApplicationReceiptServiceImplTest.java new file mode 100644 index 00000000..53776366 --- /dev/null +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/ApplicationReceiptServiceImplTest.java @@ -0,0 +1,87 @@ +package dev.caskeleton.application.notification.platform.dispatch; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +import dev.caskeleton.application.notification.platform.api.ContactPointId; +import dev.caskeleton.application.notification.platform.api.DeliveryAttemptId; +import dev.caskeleton.application.notification.platform.api.NotificationId; +import dev.caskeleton.application.notification.platform.api.ProviderId; +import dev.caskeleton.application.notification.platform.api.ProviderProfileId; +import dev.caskeleton.application.notification.platform.api.RecipientDeliveryId; +import dev.caskeleton.application.notification.platform.api.TenantId; +import dev.caskeleton.application.notification.platform.api.delivery.AttemptConfirmation; +import dev.caskeleton.application.notification.platform.api.delivery.DeliveryOutcome; +import dev.caskeleton.application.notification.platform.api.delivery.EvidenceLevel; +import dev.caskeleton.application.notification.platform.api.delivery.SubmissionOutcome; +import dev.caskeleton.application.notification.platform.api.routing.Channel; +import dev.caskeleton.application.notification.platform.callback.DeliveryAttemptSnapshot; +import dev.caskeleton.application.notification.platform.push.ApplicationIdentity; +import dev.caskeleton.application.notification.platform.push.ApplicationReceipt; +import dev.caskeleton.application.notification.platform.push.ReceiptAuthorizationException; +import dev.caskeleton.application.notification.platform.push.ReceiptKind; +import java.time.Clock; +import java.time.Instant; +import java.time.ZoneOffset; +import java.util.Optional; +import java.util.UUID; +import org.junit.jupiter.api.Test; + +class ApplicationReceiptServiceImplTest { + + private static final Instant NOW = Instant.parse("2026-09-20T00:00:00Z"); + private static final DeliveryAttemptId ATTEMPT_ID = + new DeliveryAttemptId(UUID.fromString("00000000-0000-7000-8000-000000000061")); + + @Test + void unauthenticatedApplicationCannotWriteReceiptEvidence() { + ApplicationReceiptServiceImpl service = + NotificationPlatformNoops.receiptService( + new PlatformFakes.AttemptStore(), Clock.fixed(NOW, ZoneOffset.UTC)); + + assertThatThrownBy( + () -> service.record(receipt(), new ApplicationIdentity("mobile-app", "user-1", false))) + .isInstanceOf(ReceiptAuthorizationException.class); + } + + @Test + void authenticatedMatchingSubjectRecordsAgainstTheExistingAttempt() { + PlatformFakes.AttemptStore attempts = new PlatformFakes.AttemptStore(); + attempts.snapshots.put(ATTEMPT_ID, snapshot()); + ApplicationReceiptServiceImpl service = + NotificationPlatformNoops.receiptService(attempts, Clock.fixed(NOW, ZoneOffset.UTC)); + + var result = service.record(receipt(), new ApplicationIdentity("mobile-app", "user-1", true)); + + assertThat(result.attemptId()).isEqualTo(ATTEMPT_ID); + assertThat(result.created()).isFalse(); + } + + private static ApplicationReceipt receipt() { + return new ApplicationReceipt( + "receipt-1", ATTEMPT_ID, ReceiptKind.READ, "user-1", Optional.of(NOW.minusSeconds(1))); + } + + private static DeliveryAttemptSnapshot snapshot() { + return new DeliveryAttemptSnapshot( + ATTEMPT_ID, + new RecipientDeliveryId(UUID.fromString("00000000-0000-7000-8000-000000000062")), + new NotificationId(UUID.fromString("00000000-0000-7000-8000-000000000063")), + new TenantId("tenant-a"), + 1, + Channel.PUSH, + new ProviderId("fcm"), + new ProviderProfileId("fcm-primary"), + Optional.of("provider-request-1"), + new ContactPointId(UUID.fromString("00000000-0000-7000-8000-000000000064")), + AttemptConfirmation.CONFIRMED, + SubmissionOutcome.CONFIRMED_ACCEPTED, + DeliveryOutcome.UNKNOWN, + EvidenceLevel.PROVIDER_ACCEPTED, + 1L, + "b".repeat(64), + NOW.minusSeconds(30), + Optional.of(NOW.minusSeconds(20)), + Optional.empty()); + } +} diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/dispatch/AttachmentIntegrityGuardTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/AttachmentIntegrityGuardTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/dispatch/AttachmentIntegrityGuardTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/AttachmentIntegrityGuardTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/dispatch/CanonicalPlanEncodingTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/CanonicalPlanEncodingTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/dispatch/CanonicalPlanEncodingTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/CanonicalPlanEncodingTest.java diff --git a/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/DeliveryAttemptFactoryTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/DeliveryAttemptFactoryTest.java new file mode 100644 index 00000000..3f910a8c --- /dev/null +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/DeliveryAttemptFactoryTest.java @@ -0,0 +1,115 @@ +package dev.caskeleton.application.notification.platform.dispatch; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.application.notification.platform.api.ContactPointId; +import dev.caskeleton.application.notification.platform.api.NotificationId; +import dev.caskeleton.application.notification.platform.api.ProviderId; +import dev.caskeleton.application.notification.platform.api.ProviderProfileId; +import dev.caskeleton.application.notification.platform.api.RecipientDeliveryId; +import dev.caskeleton.application.notification.platform.api.TemplateSelection; +import dev.caskeleton.application.notification.platform.api.TenantId; +import dev.caskeleton.application.notification.platform.api.content.EmailContent; +import dev.caskeleton.application.notification.platform.api.content.EmailOptions; +import dev.caskeleton.application.notification.platform.api.delivery.AttemptConfirmation; +import dev.caskeleton.application.notification.platform.api.delivery.DeliveryOutcome; +import dev.caskeleton.application.notification.platform.api.delivery.EvidenceLevel; +import dev.caskeleton.application.notification.platform.api.delivery.RecipientDeliveryState; +import dev.caskeleton.application.notification.platform.api.delivery.SubmissionOutcome; +import dev.caskeleton.application.notification.platform.api.routing.Channel; +import dev.caskeleton.application.notification.platform.policy.RouteCandidate; +import dev.caskeleton.application.notification.platform.provider.ProviderCapabilities; +import dev.caskeleton.application.notification.platform.provider.ProviderExecutionEvidence; +import dev.caskeleton.application.notification.platform.provider.ProviderProfileSnapshot; +import dev.caskeleton.application.notification.platform.template.RenderedNotificationContent; +import java.time.Duration; +import java.time.Instant; +import java.util.List; +import java.util.Locale; +import java.util.Map; +import java.util.Optional; +import java.util.UUID; +import org.junit.jupiter.api.Test; + +class DeliveryAttemptFactoryTest { + + private static final Instant NOW = Instant.parse("2026-09-20T00:00:00Z"); + private static final UUID ATTEMPT_ID = UUID.fromString("00000000-0000-7000-8000-000000000010"); + + @Test + void createsAProvenNotStartedRowBeforeTheProviderCall() { + RouteCandidate route = route(); + ProviderProfileSnapshot profile = profile(); + DeliveryAttemptFactory factory = new DeliveryAttemptFactory(() -> ATTEMPT_ID); + + DeliveryAttemptRecord attempt = + factory.create(recipient(route), route, profile, rendered(), 2, NOW); + + assertThat(attempt.id().value()).isEqualTo(ATTEMPT_ID); + assertThat(attempt.attemptNo()).isEqualTo(2); + assertThat(attempt.submissionOutcome()).isEqualTo(SubmissionOutcome.NOT_SUBMITTED); + assertThat(attempt.deliveryOutcome()).isEqualTo(DeliveryOutcome.UNKNOWN); + assertThat(attempt.confirmation()).isEqualTo(AttemptConfirmation.AMBIGUOUS); + assertThat(attempt.evidenceLevel()).isEqualTo(EvidenceLevel.PLATFORM_QUEUED); + assertThat(attempt.executionEvidence()).isEqualTo(ProviderExecutionEvidence.notStarted()); + assertThat(attempt.providerRequestId()).isEmpty(); + assertThat(attempt.credentialGeneration()).isEqualTo(7L); + assertThat(attempt.renderedContentDigest()).isEqualTo("d".repeat(64)); + } + + private static RouteCandidate route() { + return new RouteCandidate( + 0, + Channel.EMAIL, + new ContactPointId(UUID.fromString("00000000-0000-7000-8000-000000000011")), + new ProviderProfileId("ses-primary"), + true, + true); + } + + private static ProviderProfileSnapshot profile() { + return new ProviderProfileSnapshot( + new ProviderProfileId("ses-primary"), + new ProviderId("ses"), + Channel.EMAIL, + "prod", + 7L, + new ProviderCapabilities( + false, true, true, true, true, false, false, false, 1, 10_000L, Duration.ofHours(1)), + Map.of()); + } + + private static RenderedNotificationContent rendered() { + return new RenderedNotificationContent( + new EmailContent("subject", "body", Optional.empty(), List.of(), EmailOptions.DEFAULT), + "d".repeat(64), + new TemplateSelection("receipt", 1L, Locale.KOREAN), + Locale.KOREAN); + } + + private static RecipientDeliveryRecord recipient(RouteCandidate route) { + return new RecipientDeliveryRecord( + new RecipientDeliveryId(UUID.fromString("00000000-0000-7000-8000-000000000012")), + new NotificationId(UUID.fromString("00000000-0000-7000-8000-000000000013")), + new TenantId("tenant-a"), + "user-1", + Optional.of(Locale.KOREAN), + Optional.empty(), + List.of(route), + 0, + RecipientDeliveryState.READY_TO_DISPATCH, + SubmissionOutcome.NOT_SUBMITTED, + DeliveryOutcome.UNKNOWN, + EvidenceLevel.NONE, + false, + false, + Optional.empty(), + Optional.empty(), + Optional.empty(), + Optional.empty(), + 0, + Optional.empty(), + NOW, + NOW); + } +} diff --git a/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/DispatchOutcomeRecorderTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/DispatchOutcomeRecorderTest.java new file mode 100644 index 00000000..b72cc1db --- /dev/null +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/DispatchOutcomeRecorderTest.java @@ -0,0 +1,342 @@ +package dev.caskeleton.application.notification.platform.dispatch; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.application.notification.platform.api.ContactPointId; +import dev.caskeleton.application.notification.platform.api.DeliveryAttemptId; +import dev.caskeleton.application.notification.platform.api.NotificationId; +import dev.caskeleton.application.notification.platform.api.ProviderId; +import dev.caskeleton.application.notification.platform.api.ProviderProfileId; +import dev.caskeleton.application.notification.platform.api.RecipientDeliveryId; +import dev.caskeleton.application.notification.platform.api.TenantId; +import dev.caskeleton.application.notification.platform.api.delivery.AttemptConfirmation; +import dev.caskeleton.application.notification.platform.api.delivery.DeliveryOutcome; +import dev.caskeleton.application.notification.platform.api.delivery.EvidenceLevel; +import dev.caskeleton.application.notification.platform.api.delivery.RecipientDeliveryState; +import dev.caskeleton.application.notification.platform.api.delivery.SubmissionOutcome; +import dev.caskeleton.application.notification.platform.api.error.FailureCategory; +import dev.caskeleton.application.notification.platform.api.error.NotificationFailureCode; +import dev.caskeleton.application.notification.platform.api.routing.Channel; +import dev.caskeleton.application.notification.platform.callback.AppendEventResult; +import dev.caskeleton.application.notification.platform.callback.DeliveryAttemptResolverPort; +import dev.caskeleton.application.notification.platform.callback.DeliveryAttemptSnapshot; +import dev.caskeleton.application.notification.platform.callback.DeliveryProjection; +import dev.caskeleton.application.notification.platform.callback.DeliveryProjectionStorePort; +import dev.caskeleton.application.notification.platform.callback.NotificationSideEffectPort; +import dev.caskeleton.application.notification.platform.callback.ProjectionResult; +import dev.caskeleton.application.notification.platform.callback.ProviderEventLedger; +import dev.caskeleton.application.notification.platform.callback.ProviderEventProjectionService; +import dev.caskeleton.application.notification.platform.callback.ProviderEventRecord; +import dev.caskeleton.application.notification.platform.callback.ProviderEventRecordId; +import dev.caskeleton.application.notification.platform.callback.ProviderRequestIdHash; +import dev.caskeleton.application.notification.platform.callback.VerifiedProviderEvent; +import dev.caskeleton.application.notification.platform.observation.NotificationMetricName; +import dev.caskeleton.application.notification.platform.provider.ProviderExecutionEvidence; +import dev.caskeleton.application.notification.platform.provider.ProviderFailure; +import dev.caskeleton.application.notification.platform.provider.ProviderSubmissionResult; +import java.time.Duration; +import java.time.Instant; +import java.util.List; +import java.util.Optional; +import java.util.UUID; +import org.junit.jupiter.api.Test; + +class DispatchOutcomeRecorderTest { + + private static final Instant STARTED = Instant.parse("2026-09-20T00:00:00Z"); + private static final Instant COMPLETED = STARTED.plusSeconds(2); + private static final DeliveryAttemptId ATTEMPT_ID = + new DeliveryAttemptId(UUID.fromString("00000000-0000-7000-8000-000000000031")); + private static final RecipientDeliveryId RECIPIENT_ID = + new RecipientDeliveryId(UUID.fromString("00000000-0000-7000-8000-000000000032")); + private static final ProviderProfileId PROFILE = new ProviderProfileId("ses-primary"); + + @Test + void ambiguousSubmissionIsPersistedAndSchedulesReconciliation() { + RecordingAttemptStore attempts = new RecordingAttemptStore(); + RecordingRecipientStore recipients = new RecordingRecipientStore(); + RecordingReconciliationJobs jobs = new RecordingReconciliationJobs(); + PlatformFakes.RecordingMetrics metrics = new PlatformFakes.RecordingMetrics(); + DispatchOutcomeRecorder recorder = + new DispatchOutcomeRecorder( + attempts, + recipients, + jobs, + new NoopLedger(), + noopProjection(), + metrics, + Duration.ofSeconds(30)); + + DeliveryAttemptRecord stored = + recorder.record( + attempt(), + recipient(), + ProviderSubmissionResult.ambiguous( + ProviderFailure.of( + NotificationFailureCode.PROVIDER_RESPONSE_LOST, + FailureCategory.AMBIGUOUS_SUBMISSION, + false), + ProviderExecutionEvidence.responseLost(), + Duration.ofSeconds(2)), + COMPLETED); + + assertThat(stored.confirmation()).isEqualTo(AttemptConfirmation.AMBIGUOUS); + assertThat(stored.submissionOutcome()).isEqualTo(SubmissionOutcome.AMBIGUOUS); + assertThat(stored.executionEvidence()).isEqualTo(ProviderExecutionEvidence.responseLost()); + assertThat(recipients.saved.state()).isEqualTo(RecipientDeliveryState.RECONCILIATION_REQUIRED); + assertThat(recipients.saved.ambiguousAttemptExists()).isTrue(); + assertThat(recipients.saved.duplicateRisk()).isTrue(); + assertThat(jobs.scheduledAttempt).isEqualTo(ATTEMPT_ID); + assertThat(jobs.dueAt).isEqualTo(COMPLETED.plusSeconds(30)); + assertThat(metrics.counters) + .contains(NotificationMetricName.DISPATCH, NotificationMetricName.AMBIGUOUS); + } + + private static DeliveryAttemptRecord attempt() { + return new DeliveryAttemptRecord( + ATTEMPT_ID, + RECIPIENT_ID, + new ContactPointId(UUID.fromString("00000000-0000-7000-8000-000000000033")), + 1, + Channel.EMAIL, + new ProviderId("ses"), + PROFILE, + Optional.empty(), + ProviderExecutionEvidence.notStarted(), + SubmissionOutcome.NOT_SUBMITTED, + DeliveryOutcome.UNKNOWN, + AttemptConfirmation.AMBIGUOUS, + EvidenceLevel.PLATFORM_QUEUED, + Optional.empty(), + Optional.empty(), + Optional.empty(), + Optional.empty(), + STARTED, + Optional.empty(), + Optional.empty(), + 1L, + "a".repeat(64)); + } + + private static RecipientDeliveryRecord recipient() { + return new RecipientDeliveryRecord( + RECIPIENT_ID, + new NotificationId(UUID.fromString("00000000-0000-7000-8000-000000000034")), + new TenantId("tenant-a"), + "user-1", + Optional.empty(), + Optional.empty(), + List.of(), + 0, + RecipientDeliveryState.DISPATCHING, + SubmissionOutcome.NOT_SUBMITTED, + DeliveryOutcome.UNKNOWN, + EvidenceLevel.PLATFORM_QUEUED, + false, + false, + Optional.empty(), + Optional.empty(), + Optional.empty(), + Optional.empty(), + 0, + Optional.empty(), + STARTED, + STARTED); + } + + private static ProviderEventProjectionService noopProjection() { + ProviderEventLedger ledger = new NoopLedger(); + DeliveryAttemptResolverPort resolver = + new DeliveryAttemptResolverPort() { + @Override + public Optional byAttemptId(DeliveryAttemptId attemptId) { + return Optional.empty(); + } + + @Override + public Optional byProviderRequestId( + ProviderProfileId profileId, String providerRequestId) { + return Optional.empty(); + } + + @Override + public Optional byProviderRequestIdHash( + ProviderProfileId profileId, ProviderRequestIdHash providerRequestIdHash) { + return Optional.empty(); + } + }; + DeliveryProjectionStorePort projections = + new DeliveryProjectionStorePort() { + @Override + public DeliveryProjection load(DeliveryAttemptId attemptId) { + return DeliveryProjection.accepted(); + } + + @Override + public void save(DeliveryAttemptId attemptId, DeliveryProjection projection) {} + + @Override + public boolean claimSuppressionSideEffect(DeliveryAttemptId attemptId) { + return false; + } + }; + NotificationSideEffectPort sideEffects = (attempt, facts) -> {}; + return new ProviderEventProjectionService( + ledger, + providerId -> Optional.empty(), + resolver, + projections, + sideEffects, + new PlatformFakes.RecordingTransactions(), + new PlatformFakes.RecordingMetrics()); + } + + private static final class RecordingAttemptStore implements DeliveryAttemptStorePort { + private DeliveryAttemptRecord stored; + + @Override + public DeliveryAttemptRecord insertDispatching(DeliveryAttemptRecord attempt) { + throw new UnsupportedOperationException(); + } + + @Override + public DeliveryAttemptRecord recordOutcome(DeliveryAttemptRecord attempt) { + stored = attempt; + return attempt; + } + + @Override + public Optional find(DeliveryAttemptId id) { + return Optional.ofNullable(stored); + } + + @Override + public List attemptsOf(RecipientDeliveryId recipientDeliveryId) { + return List.of(); + } + + @Override + public Optional snapshot(DeliveryAttemptId id) { + return Optional.empty(); + } + + @Override + public int nextAttemptNo(RecipientDeliveryId recipientDeliveryId) { + return 1; + } + } + + private static final class RecordingRecipientStore implements RecipientDeliveryStorePort { + private RecipientDeliveryRecord saved; + + @Override + public Optional find(RecipientDeliveryId id) { + return Optional.ofNullable(saved); + } + + @Override + public RecipientDeliveryRecord save(RecipientDeliveryRecord record) { + saved = record; + return record; + } + + @Override + public RecipientDeliveryRecord transition( + RecipientDeliveryId id, RecipientDeliveryState state, Optional nextDispatchAt) { + throw new UnsupportedOperationException(); + } + + @Override + public Optional saveHeldBy( + RecipientDeliveryRecord record, RecipientLease lease) { + throw new UnsupportedOperationException(); + } + + @Override + public Optional transitionHeldBy( + RecipientDeliveryId id, + RecipientDeliveryState state, + Optional nextDispatchAt, + RecipientLease lease) { + throw new UnsupportedOperationException(); + } + } + + private static final class RecordingReconciliationJobs implements ReconciliationJobStorePort { + private DeliveryAttemptId scheduledAttempt; + private Instant dueAt; + + @Override + public ReconciliationJob schedule( + DeliveryAttemptId attemptId, ProviderProfileId providerProfileId, Instant dueAt) { + scheduledAttempt = attemptId; + this.dueAt = dueAt; + return new ReconciliationJob( + UUID.fromString("00000000-0000-7000-8000-000000000035"), + attemptId, + providerProfileId, + dueAt, + 0, + Optional.empty(), + COMPLETED, + COMPLETED); + } + + @Override + public List claimDue(int limit, Instant now) { + return List.of(); + } + + @Override + public void reschedule(ReconciliationJob job, String result, Instant nextCheckAt) {} + + @Override + public void complete(ReconciliationJob job) {} + } + + private static final class NoopLedger implements ProviderEventLedger { + @Override + public AppendEventResult append(VerifiedProviderEvent event) { + return new AppendEventResult(List.of(), List.of()); + } + + @Override + public AppendEventResult appendAll(List events) { + return new AppendEventResult(List.of(), List.of()); + } + + @Override + public List pendingProjection(int limit) { + return List.of(); + } + + @Override + public void markApplied(ProviderEventRecordId eventId, ProjectionResult result) {} + + @Override + public void markFailed(ProviderEventRecordId eventId, String errorCode) {} + + @Override + public List unmatched(int limit) { + return List.of(); + } + + @Override + public List bindUnmatched( + ProviderProfileId providerProfileId, + String providerRequestId, + DeliveryAttemptId attemptId) { + return List.of(); + } + + @Override + public boolean bindAttempt(ProviderEventRecordId eventId, DeliveryAttemptId attemptId) { + return false; + } + + @Override + public List eventsForAttempt(DeliveryAttemptId attemptId) { + return List.of(); + } + } +} diff --git a/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/DispatchPipelineTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/DispatchPipelineTest.java new file mode 100644 index 00000000..8f059028 --- /dev/null +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/DispatchPipelineTest.java @@ -0,0 +1,164 @@ +package dev.caskeleton.application.notification.platform.dispatch; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.application.notification.platform.api.ContactPointId; +import dev.caskeleton.application.notification.platform.api.CorrelationId; +import dev.caskeleton.application.notification.platform.api.NotificationId; +import dev.caskeleton.application.notification.platform.api.ProviderProfileId; +import dev.caskeleton.application.notification.platform.api.RecipientDeliveryId; +import dev.caskeleton.application.notification.platform.api.RequestStatus; +import dev.caskeleton.application.notification.platform.api.TemplateSelection; +import dev.caskeleton.application.notification.platform.api.TenantId; +import dev.caskeleton.application.notification.platform.api.delivery.DeliveryOutcome; +import dev.caskeleton.application.notification.platform.api.delivery.EvidenceLevel; +import dev.caskeleton.application.notification.platform.api.delivery.RecipientDeliveryState; +import dev.caskeleton.application.notification.platform.api.delivery.SubmissionOutcome; +import dev.caskeleton.application.notification.platform.api.routing.Channel; +import dev.caskeleton.application.notification.platform.contact.ContactPointStatus; +import dev.caskeleton.application.notification.platform.policy.NotificationEligibilityPolicy; +import dev.caskeleton.application.notification.platform.policy.RouteCandidate; +import java.time.Instant; +import java.util.List; +import java.util.Locale; +import java.util.Map; +import java.util.Optional; +import java.util.UUID; +import org.junit.jupiter.api.Test; + +class DispatchPipelineTest { + + private static final Instant NOW = Instant.parse("2026-09-20T00:00:00Z"); + private static final TenantId TENANT = new TenantId("tenant-a"); + private static final NotificationId NOTIFICATION = + new NotificationId(UUID.fromString("00000000-0000-7000-8000-000000000020")); + private static final ContactPointId CONTACT = + new ContactPointId(UUID.fromString("00000000-0000-7000-8000-000000000021")); + + @Test + void expiredRequestStopsBeforeContactLookup() { + RecordingContactStore contacts = new RecordingContactStore(); + DispatchPipeline pipeline = + new DispatchPipeline( + contacts, + NotificationEligibilityPolicy.permitAll(), + new PlatformFakes.RecordingMetrics()); + + DispatchGuardOutcome result = + pipeline.verify( + TENANT, + NOTIFICATION, + request(Optional.of(NOW.minusSeconds(1)), Optional.empty()), + recipient(), + route(), + NOW); + + assertThat(result) + .isEqualTo(new DispatchGuardOutcome.Blocked(RecipientDeliveryState.EXPIRED, "EXPIRED")); + assertThat(contacts.findCalls).isZero(); + } + + @Test + void missingContactPointFailsBeforeEligibility() { + RecordingContactStore contacts = new RecordingContactStore(); + DispatchPipeline pipeline = + new DispatchPipeline( + contacts, + NotificationEligibilityPolicy.permitAll(), + new PlatformFakes.RecordingMetrics()); + + DispatchGuardOutcome result = + pipeline.verify( + TENANT, + NOTIFICATION, + request(Optional.empty(), Optional.empty()), + recipient(), + route(), + NOW); + + assertThat(result) + .isEqualTo( + new DispatchGuardOutcome.Blocked( + RecipientDeliveryState.FAILED, "CONTACT_POINT_NOT_FOUND")); + assertThat(contacts.findCalls).isEqualTo(1); + } + + private static NotificationRequestRecord request( + Optional expiresAt, Optional notBefore) { + return new NotificationRequestRecord( + NOTIFICATION, + TENANT, + "idem-1", + "f".repeat(64), + "transactional", + new TemplateSelection("receipt", 1L, Locale.KOREAN), + "EXPLICIT", + "", + Optional.empty(), + notBefore, + expiresAt, + Optional.empty(), + RequestStatus.CREATED, + new CorrelationId("corr-1"), + Map.of(), + NOW, + NOW); + } + + private static RecipientDeliveryRecord recipient() { + return new RecipientDeliveryRecord( + new RecipientDeliveryId(UUID.fromString("00000000-0000-7000-8000-000000000022")), + NOTIFICATION, + TENANT, + "user-1", + Optional.of(Locale.KOREAN), + Optional.empty(), + List.of(route()), + 0, + RecipientDeliveryState.READY_TO_DISPATCH, + SubmissionOutcome.NOT_SUBMITTED, + DeliveryOutcome.UNKNOWN, + EvidenceLevel.NONE, + false, + false, + Optional.empty(), + Optional.empty(), + Optional.empty(), + Optional.empty(), + 0, + Optional.empty(), + NOW, + NOW); + } + + private static RouteCandidate route() { + return new RouteCandidate( + 0, Channel.EMAIL, CONTACT, new ProviderProfileId("ses-primary"), true, true); + } + + private static final class RecordingContactStore implements ContactPointStorePort { + private int findCalls; + + @Override + public Optional find(TenantId tenantId, ContactPointId id) { + findCalls++; + return Optional.empty(); + } + + @Override + public Optional findByFingerprint(TenantId tenantId, String lookupHmac) { + throw new UnsupportedOperationException(); + } + + @Override + public ContactPointRecord save(ContactPointRecord record) { + throw new UnsupportedOperationException(); + } + + @Override + public ContactPointRecord updateStatus( + TenantId tenantId, ContactPointId id, ContactPointStatus status, String reasonCode) { + throw new UnsupportedOperationException(); + } + } +} diff --git a/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/NotificationApplicationUseCasesTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/NotificationApplicationUseCasesTest.java new file mode 100644 index 00000000..9c337bbd --- /dev/null +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/NotificationApplicationUseCasesTest.java @@ -0,0 +1,111 @@ +package dev.caskeleton.application.notification.platform.dispatch; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.application.notification.platform.api.CancelCommand; +import dev.caskeleton.application.notification.platform.api.RequestStatus; +import dev.caskeleton.application.notification.platform.api.routing.Channel; +import dev.caskeleton.application.notification.platform.port.in.CancelNotificationCommand; +import dev.caskeleton.application.notification.platform.port.in.GetNotificationQuery; +import dev.caskeleton.application.notification.platform.port.in.ScheduleNotificationCommand; +import dev.caskeleton.application.notification.platform.port.in.SubmitNotificationCommand; +import java.time.Clock; +import java.time.Instant; +import java.time.ZoneOffset; +import java.util.Map; +import org.junit.jupiter.api.Test; + +class NotificationApplicationUseCasesTest { + + private static final Clock CLOCK = + Clock.fixed(Instant.parse("2026-09-20T00:00:00Z"), ZoneOffset.UTC); + + private final PlatformFakes.RequestStore requests = new PlatformFakes.RequestStore(); + private final PlatformFakes.RecipientStore recipients = + new PlatformFakes.RecipientStore(requests); + private final PlatformFakes.AttemptStore attempts = new PlatformFakes.AttemptStore(); + private final PlatformFakes.RecordingTransactions transactions = + new PlatformFakes.RecordingTransactions(); + private final NotificationSubmissionService service = + new NotificationSubmissionService( + requests, + recipients, + attempts, + PlatformFakes.templates(true), + PlatformFakes.fingerprints(), + new CanonicalNotificationPlanWriter( + new PlatformFakes.SequentialIds(), PlatformFakes.routes(Channel.EMAIL)), + transactions, + PlatformFakes.tenant("tenant-a"), + PlatformFakes.deduplication(CLOCK), + new PlatformFakes.RecordingMetrics(), + CLOCK); + + @Test + void submitEntrypointOwnsTheWriteBoundary() { + SubmitNotificationApplicationUseCase useCase = + new SubmitNotificationApplicationUseCase(service, transactions); + + var receipt = + useCase.handle(new SubmitNotificationCommand(PlatformFakes.plan("submit-1", Map.of()))); + + assertThat(requests.byId).containsKey(receipt.notificationId()); + assertThat(transactions.boundaries).containsExactly("WRITE"); + } + + @Test + void scheduleEntrypointPersistsTheDueTimeInsideAWriteBoundary() { + ScheduleNotificationApplicationUseCase useCase = + new ScheduleNotificationApplicationUseCase(service, transactions); + Instant dueAt = CLOCK.instant().plusSeconds(3600); + + var receipt = + useCase.handle( + new ScheduleNotificationCommand(PlatformFakes.plan("schedule-1", Map.of()), dueAt)); + + assertThat(requests.byId.get(receipt.notificationId()).status()) + .isEqualTo(RequestStatus.SCHEDULED); + assertThat( + requests + .recipientsOf( + new dev.caskeleton.application.notification.platform.api.TenantId("tenant-a"), + receipt.notificationId()) + .getFirst() + .nextDispatchAt()) + .contains(dueAt); + assertThat(transactions.boundaries).containsExactly("WRITE"); + } + + @Test + void getEntrypointOwnsAReadBoundary() { + var receipt = + new SubmitNotificationApplicationUseCase(service, transactions) + .handle(new SubmitNotificationCommand(PlatformFakes.plan("get-1", Map.of()))); + transactions.boundaries.clear(); + GetNotificationApplicationUseCase useCase = + new GetNotificationApplicationUseCase(service, transactions); + + var snapshot = useCase.handle(new GetNotificationQuery(receipt.notificationId())); + + assertThat(snapshot.notificationId()).isEqualTo(receipt.notificationId()); + assertThat(transactions.boundaries).containsExactly("READ"); + } + + @Test + void cancelEntrypointOwnsTheMutationBoundary() { + var receipt = + new SubmitNotificationApplicationUseCase(service, transactions) + .handle(new SubmitNotificationCommand(PlatformFakes.plan("cancel-1", Map.of()))); + transactions.boundaries.clear(); + CancelNotificationApplicationUseCase useCase = + new CancelNotificationApplicationUseCase(service, transactions); + + var result = + useCase.handle( + new CancelNotificationCommand( + receipt.notificationId(), new CancelCommand("OPERATOR_REQUEST", false))); + + assertThat(result.canceledRecipients()).isEqualTo(1); + assertThat(transactions.boundaries).containsExactly("WRITE"); + } +} diff --git a/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/NotificationDispatchServiceTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/NotificationDispatchServiceTest.java new file mode 100644 index 00000000..af53f0d9 --- /dev/null +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/NotificationDispatchServiceTest.java @@ -0,0 +1,333 @@ +package dev.caskeleton.application.notification.platform.dispatch; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.application.notification.platform.api.ContactPointId; +import dev.caskeleton.application.notification.platform.api.ProviderId; +import dev.caskeleton.application.notification.platform.api.ProviderProfileId; +import dev.caskeleton.application.notification.platform.api.RecipientDeliveryId; +import dev.caskeleton.application.notification.platform.api.TemplateSelection; +import dev.caskeleton.application.notification.platform.api.TenantId; +import dev.caskeleton.application.notification.platform.api.content.EmailContent; +import dev.caskeleton.application.notification.platform.api.content.EmailOptions; +import dev.caskeleton.application.notification.platform.api.delivery.SubmissionOutcome; +import dev.caskeleton.application.notification.platform.api.error.NotificationFailureCode; +import dev.caskeleton.application.notification.platform.api.routing.Channel; +import dev.caskeleton.application.notification.platform.contact.ContactPointStatus; +import dev.caskeleton.application.notification.platform.contact.ContactPointType; +import dev.caskeleton.application.notification.platform.policy.NotificationEligibilityPolicy; +import dev.caskeleton.application.notification.platform.policy.RetryDecision; +import dev.caskeleton.application.notification.platform.policy.RoutingDecisionEngine; +import dev.caskeleton.application.notification.platform.provider.ProviderCapabilities; +import dev.caskeleton.application.notification.platform.provider.ProviderProfileSnapshot; +import dev.caskeleton.application.notification.platform.provider.ProviderRuntimeState; +import dev.caskeleton.application.notification.platform.provider.ProviderSubmission; +import dev.caskeleton.application.notification.platform.provider.ProviderSubmissionResult; +import dev.caskeleton.application.notification.platform.security.ProtectedContactPoint; +import dev.caskeleton.application.notification.platform.template.NotificationTemplateRenderer; +import dev.caskeleton.application.notification.platform.template.RenderCommand; +import dev.caskeleton.application.notification.platform.template.RenderedNotificationContent; +import java.time.Clock; +import java.time.Duration; +import java.time.Instant; +import java.time.ZoneOffset; +import java.util.List; +import java.util.Locale; +import java.util.Map; +import java.util.Optional; +import java.util.UUID; +import org.junit.jupiter.api.Test; + +class NotificationDispatchServiceTest { + + private static final Instant NOW = Instant.parse("2026-09-20T00:00:00Z"); + + @Test + void missingLeasedRecipientIsReleasedWithoutCallingTheProvider() { + PlatformFakes.RequestStore requests = new PlatformFakes.RequestStore(); + PlatformFakes.RecipientStore recipients = new PlatformFakes.RecipientStore(requests); + PlatformFakes.AttemptStore attempts = new PlatformFakes.AttemptStore(); + PlatformFakes.RecordingTransactions transactions = new PlatformFakes.RecordingTransactions(); + RecordingLeases leases = new RecordingLeases(); + FailingGateway gateway = new FailingGateway(); + NotificationDispatchService service = + new NotificationDispatchService( + requests, + recipients, + attempts, + new DispatchPipeline( + new EmptyContactStore(), + NotificationEligibilityPolicy.permitAll(), + new PlatformFakes.RecordingMetrics()), + new RoutingDecisionEngine(), + context -> new RetryDecision.Stop("unused"), + new DeliveryAttemptFactory(new PlatformFakes.SequentialIds()), + NotificationPlatformNoops.outcomeRecorder(attempts, recipients), + gateway, + channel -> { + throw new AssertionError("renderer must not be reached for a missing recipient"); + }, + leases, + transactions, + Clock.fixed(NOW, ZoneOffset.UTC), + 3, + Duration.ofSeconds(5)); + RecipientLease lease = + new RecipientLease( + new RecipientDeliveryId(UUID.fromString("00000000-0000-7000-8000-000000000071")), + "worker-a", + 1L, + NOW.plusSeconds(30)); + + service.dispatch(lease); + + assertThat(leases.released).containsExactly(lease); + assertThat(transactions.boundaries).containsExactly("READ", "WRITE"); + assertThat(gateway.calls).isZero(); + } + + @Test + void losingTheLeaseAfterAttemptInsertClosesTheAttemptWithoutCallingTheProvider() { + PlatformFakes.RequestStore requests = new PlatformFakes.RequestStore(); + PlatformFakes.RecipientStore recipients = new PlatformFakes.RecipientStore(requests); + PlatformFakes.AttemptStore attempts = new PlatformFakes.AttemptStore(); + PlatformFakes.RecordingTransactions transactions = new PlatformFakes.RecordingTransactions(); + + NotificationSubmissionService submissions = + new NotificationSubmissionService( + requests, + recipients, + attempts, + PlatformFakes.templates(true), + PlatformFakes.fingerprints(), + new CanonicalNotificationPlanWriter( + new PlatformFakes.SequentialIds(), PlatformFakes.routes(Channel.EMAIL)), + transactions, + PlatformFakes.tenant("tenant-a"), + PlatformFakes.deduplication(Clock.fixed(NOW, ZoneOffset.UTC)), + new PlatformFakes.RecordingMetrics(), + Clock.fixed(NOW, ZoneOffset.UTC)); + var receipt = submissions.submit(PlatformFakes.plan("lease-loss", Map.of())); + RecipientDeliveryRecord recipient = + requests.recipientsOf(new TenantId("tenant-a"), receipt.notificationId()).getFirst(); + + RecordingLeases leases = new RecordingLeases(); + ProfileOnlyGateway gateway = new ProfileOnlyGateway(); + NotificationDispatchService service = + new NotificationDispatchService( + requests, + recipients, + attempts, + new DispatchPipeline( + new SingleContactStore(contactPoint()), + NotificationEligibilityPolicy.permitAll(), + new PlatformFakes.RecordingMetrics()), + new RoutingDecisionEngine(), + context -> new RetryDecision.Stop("unused"), + new DeliveryAttemptFactory(new PlatformFakes.SequentialIds()), + NotificationPlatformNoops.outcomeRecorder(attempts, recipients), + gateway, + channel -> renderer(), + leases, + transactions, + Clock.fixed(NOW, ZoneOffset.UTC), + 3, + Duration.ofSeconds(5)); + RecipientLease lease = new RecipientLease(recipient.id(), "worker-a", 1L, NOW.plusSeconds(30)); + + service.dispatch(lease); + + assertThat(gateway.submitCalls).isZero(); + assertThat(attempts.rows).hasSize(1); + DeliveryAttemptRecord stored = attempts.rows.getFirst(); + assertThat(stored.submissionOutcome()).isEqualTo(SubmissionOutcome.NOT_SUBMITTED); + assertThat(stored.failureCode()).contains(NotificationFailureCode.DISPATCH_LEASE_LOST); + assertThat(stored.executionEvidence()) + .isEqualTo( + dev.caskeleton.application.notification.platform.provider.ProviderExecutionEvidence + .notStarted()); + assertThat(requests.recipientsOf(new TenantId("tenant-a"), receipt.notificationId()).getFirst()) + .isEqualTo(recipient); + } + + private static ContactPointRecord contactPoint() { + return new ContactPointRecord( + new ContactPointId(UUID.fromString("00000000-0000-7000-8000-000000000001")), + new TenantId("tenant-a"), + "user-1", + ContactPointType.EMAIL, + Optional.empty(), + Optional.empty(), + "prod", + new ProtectedContactPoint( + ContactPointType.EMAIL, "key-1", new byte[] {1}, new byte[] {2}, "contact-hmac"), + ContactPointStatus.ACTIVE, + true, + Optional.empty(), + Optional.empty(), + Optional.empty(), + Optional.empty(), + NOW, + NOW); + } + + private static NotificationTemplateRenderer renderer() { + return new NotificationTemplateRenderer() { + @Override + public Channel channel() { + return Channel.EMAIL; + } + + @Override + public RenderedNotificationContent render(RenderCommand command) { + return new RenderedNotificationContent( + new EmailContent("subject", "body", Optional.empty(), List.of(), EmailOptions.DEFAULT), + "d".repeat(64), + new TemplateSelection("payment-receipt", 1L, Locale.KOREAN), + Locale.KOREAN); + } + }; + } + + private static ProviderProfileSnapshot profile() { + return new ProviderProfileSnapshot( + new ProviderProfileId("email-primary"), + new ProviderId("ses"), + Channel.EMAIL, + "prod", + 1L, + new ProviderCapabilities( + false, true, true, true, true, false, false, false, 1, 10_000L, Duration.ofHours(1)), + Map.of()); + } + + private static final class SingleContactStore implements ContactPointStorePort { + private final ContactPointRecord contactPoint; + + private SingleContactStore(ContactPointRecord contactPoint) { + this.contactPoint = contactPoint; + } + + @Override + public Optional find(TenantId tenantId, ContactPointId id) { + return contactPoint.tenantId().equals(tenantId) && contactPoint.id().equals(id) + ? Optional.of(contactPoint) + : Optional.empty(); + } + + @Override + public Optional findByFingerprint(TenantId tenantId, String lookupHmac) { + return Optional.empty(); + } + + @Override + public ContactPointRecord save(ContactPointRecord record) { + throw new UnsupportedOperationException(); + } + + @Override + public ContactPointRecord updateStatus( + TenantId tenantId, ContactPointId id, ContactPointStatus status, String reasonCode) { + throw new UnsupportedOperationException(); + } + } + + private static final class ProfileOnlyGateway implements ProviderDispatchGatewayPort { + private int submitCalls; + + @Override + public ProviderProfileSnapshot profile(ProviderProfileId profileId) { + return NotificationDispatchServiceTest.profile(); + } + + @Override + public ProviderRuntimeState state(ProviderProfileId profileId) { + return ProviderRuntimeState.HEALTHY; + } + + @Override + public ProviderSubmissionResult submit(ProviderSubmission submission) { + submitCalls++; + throw new AssertionError("provider submit must not run after the lease is lost"); + } + } + + private static final class EmptyContactStore implements ContactPointStorePort { + @Override + public Optional find(TenantId tenantId, ContactPointId id) { + return Optional.empty(); + } + + @Override + public Optional findByFingerprint(TenantId tenantId, String lookupHmac) { + return Optional.empty(); + } + + @Override + public ContactPointRecord save(ContactPointRecord record) { + throw new UnsupportedOperationException(); + } + + @Override + public ContactPointRecord updateStatus( + TenantId tenantId, ContactPointId id, ContactPointStatus status, String reasonCode) { + throw new UnsupportedOperationException(); + } + } + + private static final class FailingGateway implements ProviderDispatchGatewayPort { + private int calls; + + @Override + public ProviderProfileSnapshot profile(ProviderProfileId profileId) { + calls++; + throw new AssertionError("gateway profile must not be reached"); + } + + @Override + public ProviderRuntimeState state(ProviderProfileId profileId) { + calls++; + throw new AssertionError("gateway state must not be reached"); + } + + @Override + public ProviderSubmissionResult submit(ProviderSubmission submission) { + calls++; + throw new AssertionError("provider submit must not be reached"); + } + } + + private static final class RecordingLeases implements RecipientLeaseStorePort { + private final List released = new java.util.ArrayList<>(); + + @Override + public List claim(String workerId, int limit, Duration leaseDuration) { + return List.of(); + } + + @Override + public Optional renew(RecipientLease lease, Duration leaseDuration) { + return Optional.empty(); + } + + @Override + public void release(RecipientLease lease) { + released.add(lease); + } + + @Override + public boolean stillHeld(RecipientLease lease) { + return false; + } + + @Override + public List expiredDispatching(int limit, Duration olderThan) { + return List.of(); + } + + @Override + public int expireOverdue(int limit) { + return 0; + } + } +} diff --git a/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/NotificationPlatformNoops.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/NotificationPlatformNoops.java new file mode 100644 index 00000000..f813eed0 --- /dev/null +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/NotificationPlatformNoops.java @@ -0,0 +1,214 @@ +package dev.caskeleton.application.notification.platform.dispatch; + +import dev.caskeleton.application.notification.platform.api.DeliveryAttemptId; +import dev.caskeleton.application.notification.platform.api.ProviderProfileId; +import dev.caskeleton.application.notification.platform.callback.AppendEventResult; +import dev.caskeleton.application.notification.platform.callback.DeliveryAttemptResolverPort; +import dev.caskeleton.application.notification.platform.callback.DeliveryAttemptSnapshot; +import dev.caskeleton.application.notification.platform.callback.DeliveryProjection; +import dev.caskeleton.application.notification.platform.callback.DeliveryProjectionStorePort; +import dev.caskeleton.application.notification.platform.callback.NotificationSideEffectPort; +import dev.caskeleton.application.notification.platform.callback.ProjectionResult; +import dev.caskeleton.application.notification.platform.callback.ProviderEventLedger; +import dev.caskeleton.application.notification.platform.callback.ProviderEventProjectionService; +import dev.caskeleton.application.notification.platform.callback.ProviderEventRecord; +import dev.caskeleton.application.notification.platform.callback.ProviderEventRecordId; +import dev.caskeleton.application.notification.platform.callback.ProviderRequestIdHash; +import dev.caskeleton.application.notification.platform.callback.VerifiedProviderEvent; +import dev.caskeleton.application.notification.platform.observation.NotificationAuditPort; +import dev.caskeleton.application.notification.platform.observation.NotificationMetricsPort; +import dev.caskeleton.application.notification.platform.provider.ReconciliationResult; +import java.time.Clock; +import java.util.List; +import java.util.Map; +import java.util.Optional; + +/** Minimal collaborators for application tests that do not exercise reconciliation itself. */ +public final class NotificationPlatformNoops { + + private NotificationPlatformNoops() {} + + public static ReconciliationService reconciliation( + DeliveryAttemptStorePort attempts, RecipientDeliveryStorePort recipients, Clock clock) { + ProviderEventLedger ledger = new NoopLedger(); + return new ReconciliationService( + attempts, + recipients, + new ReconciliationGatewayPort() { + @Override + public boolean supports(ProviderProfileId profileId) { + return false; + } + + @Override + public ReconciliationResult reconcile(DeliveryAttemptSnapshot attempt) { + return new ReconciliationResult.Unsupported(); + } + }, + ledger, + projection(ledger), + audit(), + metrics(), + new SyntheticEventFingerprint(NotificationPlatformNoops::sha256), + clock); + } + + public static DispatchOutcomeRecorder outcomeRecorder( + DeliveryAttemptStorePort attempts, RecipientDeliveryStorePort recipients) { + ProviderEventLedger ledger = new NoopLedger(); + ReconciliationJobStorePort jobs = + new ReconciliationJobStorePort() { + @Override + public ReconciliationJob schedule( + DeliveryAttemptId attemptId, + ProviderProfileId providerProfileId, + java.time.Instant dueAt) { + throw new UnsupportedOperationException(); + } + + @Override + public List claimDue(int limit, java.time.Instant now) { + return List.of(); + } + + @Override + public void reschedule( + ReconciliationJob job, String result, java.time.Instant nextCheckAt) {} + + @Override + public void complete(ReconciliationJob job) {} + }; + return new DispatchOutcomeRecorder( + attempts, + recipients, + jobs, + ledger, + projection(ledger), + metrics(), + java.time.Duration.ofSeconds(30)); + } + + public static ApplicationReceiptServiceImpl receiptService( + DeliveryAttemptStorePort attempts, Clock clock) { + ProviderEventLedger ledger = new NoopLedger(); + return new ApplicationReceiptServiceImpl( + attempts, ledger, projection(ledger), new PlatformFakes.RecordingTransactions(), clock); + } + + public static NotificationAuditPort audit() { + return event -> {}; + } + + public static NotificationMetricsPort metrics() { + return new NotificationMetricsPort() { + @Override + public void increment(String metricName, Map tags) {} + + @Override + public void record(String metricName, Map tags, java.time.Duration value) {} + + @Override + public void gauge(String metricName, Map tags, double value) {} + }; + } + + private static ProviderEventProjectionService projection(ProviderEventLedger ledger) { + DeliveryAttemptResolverPort resolver = + new DeliveryAttemptResolverPort() { + @Override + public Optional byAttemptId(DeliveryAttemptId attemptId) { + return Optional.empty(); + } + + @Override + public Optional byProviderRequestId( + ProviderProfileId profileId, String providerRequestId) { + return Optional.empty(); + } + + @Override + public Optional byProviderRequestIdHash( + ProviderProfileId profileId, ProviderRequestIdHash providerRequestIdHash) { + return Optional.empty(); + } + }; + DeliveryProjectionStorePort projections = + new DeliveryProjectionStorePort() { + @Override + public DeliveryProjection load(DeliveryAttemptId attemptId) { + return DeliveryProjection.accepted(); + } + + @Override + public void save(DeliveryAttemptId attemptId, DeliveryProjection projection) {} + + @Override + public boolean claimSuppressionSideEffect(DeliveryAttemptId attemptId) { + return false; + } + }; + NotificationSideEffectPort sideEffects = (attempt, facts) -> {}; + return new ProviderEventProjectionService( + ledger, + providerId -> Optional.empty(), + resolver, + projections, + sideEffects, + new PlatformFakes.RecordingTransactions(), + metrics()); + } + + private static byte[] sha256(byte[] bytes) { + try { + return java.security.MessageDigest.getInstance("SHA-256").digest(bytes); + } catch (java.security.NoSuchAlgorithmException impossible) { + throw new IllegalStateException(impossible); + } + } + + private static final class NoopLedger implements ProviderEventLedger { + @Override + public AppendEventResult append(VerifiedProviderEvent event) { + return new AppendEventResult(List.of(), List.of()); + } + + @Override + public AppendEventResult appendAll(List events) { + return new AppendEventResult(List.of(), List.of()); + } + + @Override + public List pendingProjection(int limit) { + return List.of(); + } + + @Override + public void markApplied(ProviderEventRecordId eventId, ProjectionResult result) {} + + @Override + public void markFailed(ProviderEventRecordId eventId, String errorCode) {} + + @Override + public List unmatched(int limit) { + return List.of(); + } + + @Override + public List bindUnmatched( + ProviderProfileId providerProfileId, + String providerRequestId, + DeliveryAttemptId attemptId) { + return List.of(); + } + + @Override + public boolean bindAttempt(ProviderEventRecordId eventId, DeliveryAttemptId attemptId) { + return false; + } + + @Override + public List eventsForAttempt(DeliveryAttemptId attemptId) { + return List.of(); + } + } +} diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/dispatch/NotificationSubmissionServiceTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/NotificationSubmissionServiceTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/dispatch/NotificationSubmissionServiceTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/NotificationSubmissionServiceTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/dispatch/PlatformFakes.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/PlatformFakes.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/dispatch/PlatformFakes.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/PlatformFakes.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/dispatch/PreferredOrderRoutingTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/PreferredOrderRoutingTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/dispatch/PreferredOrderRoutingTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/PreferredOrderRoutingTest.java diff --git a/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/PublishNotificationTemplateApplicationUseCaseTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/PublishNotificationTemplateApplicationUseCaseTest.java new file mode 100644 index 00000000..07cac2dc --- /dev/null +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/PublishNotificationTemplateApplicationUseCaseTest.java @@ -0,0 +1,76 @@ +package dev.caskeleton.application.notification.platform.dispatch; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.application.notification.platform.api.TemplateSelection; +import dev.caskeleton.application.notification.platform.api.routing.Channel; +import dev.caskeleton.application.notification.platform.port.in.PublishNotificationTemplateCommand; +import dev.caskeleton.application.notification.platform.template.NotificationTemplateVersion; +import dev.caskeleton.application.notification.platform.template.TemplateRegistry; +import dev.caskeleton.application.notification.platform.template.TemplateSlot; +import java.util.Locale; +import java.util.Map; +import java.util.Optional; +import java.util.Set; +import org.junit.jupiter.api.Test; + +class PublishNotificationTemplateApplicationUseCaseTest { + + @Test + void publishComputesTheDigestAndWritesInsideOneTransaction() { + RecordingTemplates templates = new RecordingTemplates(); + PlatformFakes.RecordingTransactions transactions = new PlatformFakes.RecordingTransactions(); + PublishNotificationTemplateApplicationUseCase useCase = + new PublishNotificationTemplateApplicationUseCase( + templates, PublishNotificationTemplateApplicationUseCaseTest::sha256, transactions); + PublishNotificationTemplateCommand command = + new PublishNotificationTemplateCommand( + "payment-receipt", + 1L, + Channel.EMAIL, + Locale.KOREAN, + Optional.empty(), + Map.of(TemplateSlot.SUBJECT, "결제 영수증", TemplateSlot.TEXT_BODY, "금액 {amount}"), + Set.of("amount"), + Set.of()); + + NotificationTemplateVersion published = useCase.handle(command); + + assertThat(published.contentDigest()).matches("[0-9a-f]{64}"); + assertThat(templates.published).isEqualTo(published); + assertThat(transactions.boundaries).containsExactly("WRITE"); + } + + private static byte[] sha256(byte[] bytes) { + try { + return java.security.MessageDigest.getInstance("SHA-256").digest(bytes); + } catch (java.security.NoSuchAlgorithmException impossible) { + throw new IllegalStateException(impossible); + } + } + + private static final class RecordingTemplates implements TemplateRegistry { + private NotificationTemplateVersion published; + + @Override + public NotificationTemplateVersion get(TemplateSelection selection) { + throw new UnsupportedOperationException(); + } + + @Override + public NotificationTemplateVersion resolve( + String templateId, long version, Channel channel, Locale requestedLocale) { + throw new UnsupportedOperationException(); + } + + @Override + public void publish(NotificationTemplateVersion version) { + published = version; + } + + @Override + public void disable(String templateId, long version) { + throw new UnsupportedOperationException(); + } + } +} diff --git a/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationServiceTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationServiceTest.java new file mode 100644 index 00000000..380c94d6 --- /dev/null +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/ReconciliationServiceTest.java @@ -0,0 +1,83 @@ +package dev.caskeleton.application.notification.platform.dispatch; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.application.notification.platform.api.ContactPointId; +import dev.caskeleton.application.notification.platform.api.DeliveryAttemptId; +import dev.caskeleton.application.notification.platform.api.NotificationId; +import dev.caskeleton.application.notification.platform.api.ProviderId; +import dev.caskeleton.application.notification.platform.api.ProviderProfileId; +import dev.caskeleton.application.notification.platform.api.RecipientDeliveryId; +import dev.caskeleton.application.notification.platform.api.TenantId; +import dev.caskeleton.application.notification.platform.api.delivery.AttemptConfirmation; +import dev.caskeleton.application.notification.platform.api.delivery.DeliveryOutcome; +import dev.caskeleton.application.notification.platform.api.delivery.EvidenceLevel; +import dev.caskeleton.application.notification.platform.api.delivery.SubmissionOutcome; +import dev.caskeleton.application.notification.platform.api.routing.Channel; +import dev.caskeleton.application.notification.platform.callback.DeliveryAttemptSnapshot; +import dev.caskeleton.application.notification.platform.provider.ReconciliationResult; +import java.time.Clock; +import java.time.Instant; +import java.time.ZoneOffset; +import java.util.Optional; +import java.util.UUID; +import org.junit.jupiter.api.Test; + +class ReconciliationServiceTest { + + private static final Instant NOW = Instant.parse("2026-09-20T00:00:00Z"); + + @Test + void unsupportedProviderProfileDoesNotInventAStatus() { + PlatformFakes.AttemptStore attempts = new PlatformFakes.AttemptStore(); + PlatformFakes.RequestStore requests = new PlatformFakes.RequestStore(); + PlatformFakes.RecipientStore recipients = new PlatformFakes.RecipientStore(requests); + DeliveryAttemptSnapshot snapshot = snapshot(); + attempts.snapshots.put(snapshot.attemptId(), snapshot); + ReconciliationService service = + NotificationPlatformNoops.reconciliation( + attempts, recipients, Clock.fixed(NOW, ZoneOffset.UTC)); + + ReconciliationResult result = service.reconcile(snapshot.attemptId()); + + assertThat(result).isInstanceOf(ReconciliationResult.Unsupported.class); + } + + @Test + void unknownAttemptIsUnsupportedRatherThanGuessed() { + PlatformFakes.AttemptStore attempts = new PlatformFakes.AttemptStore(); + PlatformFakes.RequestStore requests = new PlatformFakes.RequestStore(); + ReconciliationService service = + NotificationPlatformNoops.reconciliation( + attempts, new PlatformFakes.RecipientStore(requests), Clock.fixed(NOW, ZoneOffset.UTC)); + + ReconciliationResult result = + service.reconcile( + new DeliveryAttemptId(UUID.fromString("00000000-0000-7000-8000-000000000052"))); + + assertThat(result).isInstanceOf(ReconciliationResult.Unsupported.class); + } + + private static DeliveryAttemptSnapshot snapshot() { + return new DeliveryAttemptSnapshot( + new DeliveryAttemptId(UUID.fromString("00000000-0000-7000-8000-000000000051")), + new RecipientDeliveryId(UUID.fromString("00000000-0000-7000-8000-000000000053")), + new NotificationId(UUID.fromString("00000000-0000-7000-8000-000000000054")), + new TenantId("tenant-a"), + 1, + Channel.EMAIL, + new ProviderId("ses"), + new ProviderProfileId("ses-primary"), + Optional.empty(), + new ContactPointId(UUID.fromString("00000000-0000-7000-8000-000000000055")), + AttemptConfirmation.AMBIGUOUS, + SubmissionOutcome.AMBIGUOUS, + DeliveryOutcome.UNKNOWN, + EvidenceLevel.PLATFORM_QUEUED, + 1L, + "a".repeat(64), + NOW, + Optional.empty(), + Optional.empty()); + } +} diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/dispatch/RequestFingerprintTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/RequestFingerprintTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/dispatch/RequestFingerprintTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/RequestFingerprintTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/dispatch/SyntheticEventFingerprintTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/SyntheticEventFingerprintTest.java similarity index 97% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/dispatch/SyntheticEventFingerprintTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/SyntheticEventFingerprintTest.java index 39a4eb35..0208cc39 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/dispatch/SyntheticEventFingerprintTest.java +++ b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/dispatch/SyntheticEventFingerprintTest.java @@ -3,9 +3,9 @@ package dev.caskeleton.application.notification.platform.dispatch; import static org.assertj.core.api.Assertions.assertThat; import dev.caskeleton.application.notification.platform.api.DeliveryAttemptId; +import dev.caskeleton.application.notification.platform.api.NormalizedEventType; +import dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent; import dev.caskeleton.application.notification.platform.api.ProviderProfileId; -import dev.caskeleton.application.notification.platform.callback.NormalizedEventType; -import dev.caskeleton.application.notification.platform.callback.NormalizedProviderEvent; import java.security.MessageDigest; import java.security.NoSuchAlgorithmException; import java.time.Instant; diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/observation/BoundedObservabilityTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/observation/BoundedObservabilityTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/observation/BoundedObservabilityTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/observation/BoundedObservabilityTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/observation/NotificationObservabilityTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/observation/NotificationObservabilityTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/observation/NotificationObservabilityTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/observation/NotificationObservabilityTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/policy/DeduplicationAndCollapseTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/policy/DeduplicationAndCollapseTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/policy/DeduplicationAndCollapseTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/policy/DeduplicationAndCollapseTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/policy/NotificationEligibilityTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/policy/NotificationEligibilityTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/policy/NotificationEligibilityTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/policy/NotificationEligibilityTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/policy/NotificationRetryPolicyTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/policy/NotificationRetryPolicyTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/policy/NotificationRetryPolicyTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/policy/NotificationRetryPolicyTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/policy/PolicyFixtures.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/policy/PolicyFixtures.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/policy/PolicyFixtures.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/policy/PolicyFixtures.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/policy/RoutingDecisionEngineTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/policy/RoutingDecisionEngineTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/policy/RoutingDecisionEngineTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/policy/RoutingDecisionEngineTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/provider/PreDispatchFailureEvidenceTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/provider/PreDispatchFailureEvidenceTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/provider/PreDispatchFailureEvidenceTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/provider/PreDispatchFailureEvidenceTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/provider/ProviderSpiContractTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/provider/ProviderSpiContractTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/provider/ProviderSpiContractTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/provider/ProviderSpiContractTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/security/NotificationRedactionTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/security/NotificationRedactionTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/security/NotificationRedactionTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/security/NotificationRedactionTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/sms/SmsSegmentEstimatorTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/sms/SmsSegmentEstimatorTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/sms/SmsSegmentEstimatorTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/sms/SmsSegmentEstimatorTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/template/InMemoryTemplateRegistry.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/template/InMemoryTemplateRegistry.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/template/InMemoryTemplateRegistry.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/template/InMemoryTemplateRegistry.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/notification/platform/template/TemplateRegistryContractTest.java b/src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/template/TemplateRegistryContractTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/notification/platform/template/TemplateRegistryContractTest.java rename to src/application-notification/src/test/java/dev/caskeleton/application/notification/platform/template/TemplateRegistryContractTest.java diff --git a/src/application-notification/src/test/java/dev/caskeleton/application/testsupport/CompiledPackageScanner.java b/src/application-notification/src/test/java/dev/caskeleton/application/testsupport/CompiledPackageScanner.java new file mode 100644 index 00000000..76f57033 --- /dev/null +++ b/src/application-notification/src/test/java/dev/caskeleton/application/testsupport/CompiledPackageScanner.java @@ -0,0 +1,66 @@ +package dev.caskeleton.application.testsupport; + +import java.io.IOException; +import java.io.UncheckedIOException; +import java.net.URISyntaxException; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.List; +import java.util.jar.JarFile; +import java.util.stream.Stream; + +/** Scans compiled classes from either a classes directory or the project's packaged JAR. */ +public final class CompiledPackageScanner { + + private CompiledPackageScanner() {} + + public static List classNamesUnder(Class anchor, String packageName) { + try { + Path codeSource = Path.of(anchor.getProtectionDomain().getCodeSource().getLocation().toURI()); + String packagePath = packageName.replace('.', '/'); + if (Files.isDirectory(codeSource)) { + return fromDirectory(codeSource.resolve(packagePath), packageName); + } + if (Files.isRegularFile(codeSource)) { + return fromJar(codeSource, packagePath); + } + throw new IOException("unsupported compiled-code location: " + codeSource); + } catch (URISyntaxException | IOException unreadable) { + throw new UncheckedIOException( + new IOException("cannot scan compiled package " + packageName, unreadable)); + } + } + + private static List fromDirectory(Path packageRoot, String packageName) + throws IOException { + if (!Files.isDirectory(packageRoot)) { + return List.of(); + } + try (Stream files = Files.walk(packageRoot)) { + return files + .filter(path -> path.toString().endsWith(".class")) + .map( + path -> + packageName + + "." + + packageRoot + .relativize(path) + .toString() + .replace(java.io.File.separatorChar, '.') + .replaceAll("\\.class$", "")) + .toList(); + } + } + + private static List fromJar(Path jarPath, String packagePath) throws IOException { + String prefix = packagePath.endsWith("/") ? packagePath : packagePath + "/"; + try (JarFile jar = new JarFile(jarPath.toFile())) { + return jar.stream() + .map(entry -> entry.getName()) + .filter(name -> name.startsWith(prefix)) + .filter(name -> name.endsWith(".class")) + .map(name -> name.substring(0, name.length() - ".class".length()).replace('/', '.')) + .toList(); + } + } +} diff --git a/src/application-objectstorage/build.gradle b/src/application-objectstorage/build.gradle new file mode 100644 index 00000000..fa1d5162 --- /dev/null +++ b/src/application-objectstorage/build.gradle @@ -0,0 +1,11 @@ +plugins { + id 'ca.java-library' +} + +// Optional object-storage application product. Provider SDKs stay in outbound adapters. +dependencies { + implementation project(':application-core') + + // Property-based verification for bounded identity/value contracts moved with this product. + testImplementation libs.jqwik +} diff --git a/src/application-objectstorage/gradle.lockfile b/src/application-objectstorage/gradle.lockfile new file mode 100644 index 00000000..8ec0118c --- /dev/null +++ b/src/application-objectstorage/gradle.lockfile @@ -0,0 +1,89 @@ +# This is a Gradle generated file for dependency locking. +# Manual edits can break the build and are not advised. +# This file is expected to be part of source control. +com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,testAnnotationProcessor +com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,testAnnotationProcessor +com.github.spotbugs:spotbugs-annotations:4.10.2=spotbugs +com.github.spotbugs:spotbugs:4.10.2=spotbugs +com.github.stephenc.jcip:jcip-annotations:1.0-1=spotbugs +com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,testAnnotationProcessor +com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,testAnnotationProcessor +com.google.auto:auto-common:1.2.2=annotationProcessor,testAnnotationProcessor +com.google.code.findbugs:jsr305:3.0.2=checkstyle,spotbugs +com.google.code.gson:gson:2.13.2=spotbugs +com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.41.0=spotbugs +com.google.errorprone:error_prone_annotations:2.47.0=checkstyle +com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,testAnnotationProcessor +com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.guava:guava:33.5.0-jre=annotationProcessor,testAnnotationProcessor +com.google.guava:guava:33.6.0-jre=checkstyle +com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,testAnnotationProcessor +com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins +com.puppycrawl.tools:checkstyle:13.5.0=checkstyle +commons-beanutils:commons-beanutils:1.11.0=checkstyle +commons-collections:commons-collections:3.2.2=checkstyle +commons-io:commons-io:2.21.0=spotbugs +info.picocli:picocli:4.7.7=checkstyle +io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,testAnnotationProcessor +io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,testAnnotationProcessor +javax.inject:javax.inject:1=annotationProcessor,testAnnotationProcessor +jaxen:jaxen:2.0.6=spotbugs +net.bytebuddy:byte-buddy:1.17.8=testCompileClasspath,testRuntimeClasspath +net.jqwik:jqwik-api:1.9.1=testCompileClasspath,testRuntimeClasspath +net.jqwik:jqwik-engine:1.9.1=testRuntimeClasspath +net.jqwik:jqwik-time:1.9.1=testCompileClasspath,testRuntimeClasspath +net.jqwik:jqwik-web:1.9.1=testCompileClasspath,testRuntimeClasspath +net.jqwik:jqwik:1.9.1=testCompileClasspath,testRuntimeClasspath +net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs +org.antlr:antlr4-runtime:4.13.2=checkstyle +org.apache.bcel:bcel:6.12.0=spotbugs +org.apache.commons:commons-lang3:3.20.0=checkstyle,spotbugs +org.apache.commons:commons-text:1.15.0=spotbugs +org.apache.commons:commons-text:1.3=checkstyle +org.apache.httpcomponents:httpclient:4.5.13=checkstyle +org.apache.httpcomponents:httpcore:4.4.16=checkstyle +org.apache.logging.log4j:log4j-api:2.25.5=spotbugs +org.apache.logging.log4j:log4j-core:2.25.5=spotbugs +org.apache.maven.doxia:doxia-core:1.12.0=checkstyle +org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle +org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle +org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle +org.apache.xbean:xbean-reflect:3.7=checkstyle +org.apiguardian:apiguardian-api:1.1.2=testCompileClasspath,testRuntimeClasspath +org.assertj:assertj-core:3.27.7=testCompileClasspath,testRuntimeClasspath +org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle +org.codehaus.plexus:plexus-component-annotations:2.1.0=checkstyle +org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle +org.codehaus.plexus:plexus-utils:3.3.0=checkstyle +org.dom4j:dom4j:2.2.0=spotbugs +org.javassist:javassist:3.28.0-GA=checkstyle +org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,testAnnotationProcessor,testCompileClasspath +org.junit.jupiter:junit-jupiter-api:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-engine:6.0.3=testRuntimeClasspath +org.junit.jupiter:junit-jupiter-params:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-commons:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-engine:6.0.3=testRuntimeClasspath +org.junit.platform:junit-platform-launcher:6.0.3=testRuntimeClasspath +org.junit:junit-bom:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit:junit-bom:6.1.0=spotbugs +org.mockito:mockito-core:5.20.0=mockitoAgent +org.opentest4j:opentest4j:1.3.0=testCompileClasspath,testRuntimeClasspath +org.ow2.asm:asm-analysis:9.10.1=spotbugs +org.ow2.asm:asm-commons:9.10.1=spotbugs +org.ow2.asm:asm-tree:9.10.1=spotbugs +org.ow2.asm:asm-util:9.10.1=spotbugs +org.ow2.asm:asm:9.10.1=spotbugs +org.pcollections:pcollections:4.0.1=annotationProcessor,testAnnotationProcessor +org.reflections:reflections:0.10.2=checkstyle +org.slf4j:slf4j-api:2.0.18=spotbugs,spotbugsSlf4j +org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j +org.slf4j:slf4j-simple:2.0.18=checkstyle +org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs +empty=compileClasspath,runtimeClasspath diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/CancellationView.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/CancellationView.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/CancellationView.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/CancellationView.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectChunkReadException.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectChunkReadException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectChunkReadException.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectChunkReadException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectChunkSink.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectChunkSink.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectChunkSink.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectChunkSink.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectChunkSource.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectChunkSource.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectChunkSource.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectChunkSource.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectChunkWriteException.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectChunkWriteException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectChunkWriteException.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectChunkWriteException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentConsumer.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentConsumer.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentConsumer.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentConsumer.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentConsumptionException.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentConsumptionException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentConsumptionException.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentConsumptionException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentProducer.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentProducer.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentProducer.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentProducer.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentProductionContext.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentProductionContext.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentProductionContext.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentProductionContext.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentProductionException.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentProductionException.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentProductionException.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentProductionException.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentReadContext.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentReadContext.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentReadContext.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/content/ObjectContentReadContext.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/DirectTransferSessionId.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/DirectTransferSessionId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/DirectTransferSessionId.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/DirectTransferSessionId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/MultipartPartNumber.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/MultipartPartNumber.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/MultipartPartNumber.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/MultipartPartNumber.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectDestinationId.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectDestinationId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectDestinationId.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectDestinationId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectId.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectId.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectIdentitySupport.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectIdentitySupport.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectIdentitySupport.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectIdentitySupport.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectOperationEpoch.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectOperationEpoch.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectOperationEpoch.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectOperationEpoch.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectOperationId.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectOperationId.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectOperationId.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectOperationId.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectOperationKey.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectOperationKey.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectOperationKey.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectOperationKey.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectReference.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectReference.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectReference.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectReference.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectStageHandle.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectStageHandle.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectStageHandle.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectStageHandle.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectVersionToken.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectVersionToken.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectVersionToken.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/ObjectVersionToken.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/PartReceiptToken.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/PartReceiptToken.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/identity/PartReceiptToken.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/identity/PartReceiptToken.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/DirectDownloadGrant.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/DirectDownloadGrant.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/DirectDownloadGrant.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/DirectDownloadGrant.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/DirectUploadCompletionReceipt.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/DirectUploadCompletionReceipt.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/DirectUploadCompletionReceipt.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/DirectUploadCompletionReceipt.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/DirectUploadGrant.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/DirectUploadGrant.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/DirectUploadGrant.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/DirectUploadGrant.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/MultipartReceipt.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/MultipartReceipt.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/MultipartReceipt.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/MultipartReceipt.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/MultipartSession.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/MultipartSession.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/MultipartSession.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/MultipartSession.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectCapabilityRequirement.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectCapabilityRequirement.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectCapabilityRequirement.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectCapabilityRequirement.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectContentIdentity.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectContentIdentity.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectContentIdentity.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectContentIdentity.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectDescriptor.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectDescriptor.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectDescriptor.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectDescriptor.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectDigest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectDigest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectDigest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectDigest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectDigestAlgorithm.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectDigestAlgorithm.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectDigestAlgorithm.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectDigestAlgorithm.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectDigestVerification.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectDigestVerification.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectDigestVerification.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectDigestVerification.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectEncryptionRequirement.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectEncryptionRequirement.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectEncryptionRequirement.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectEncryptionRequirement.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectHandoffReceipt.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectHandoffReceipt.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectHandoffReceipt.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectHandoffReceipt.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectMediaType.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectMediaType.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectMediaType.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectMediaType.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectModelSupport.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectModelSupport.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectModelSupport.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectModelSupport.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectMutationOutcome.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectMutationOutcome.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectMutationOutcome.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectMutationOutcome.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectMutationReceipt.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectMutationReceipt.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectMutationReceipt.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectMutationReceipt.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectOperationError.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectOperationError.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectOperationError.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectOperationError.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectOperationResolution.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectOperationResolution.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectOperationResolution.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectOperationResolution.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectPublicationRequirement.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectPublicationRequirement.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectPublicationRequirement.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectPublicationRequirement.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectPublicationState.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectPublicationState.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectPublicationState.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectPublicationState.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectPublishReceipt.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectPublishReceipt.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectPublishReceipt.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectPublishReceipt.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectReadRange.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectReadRange.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectReadRange.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectReadRange.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectReadReceipt.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectReadReceipt.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectReadReceipt.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectReadReceipt.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectRetentionRequirement.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectRetentionRequirement.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectRetentionRequirement.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectRetentionRequirement.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectScanReadReceipt.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectScanReadReceipt.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectScanReadReceipt.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectScanReadReceipt.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectScanState.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectScanState.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectScanState.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectScanState.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectStageReceipt.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectStageReceipt.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectStageReceipt.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectStageReceipt.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectVerificationReceipt.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectVerificationReceipt.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectVerificationReceipt.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/ObjectVerificationReceipt.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/PartUploadGrant.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/PartUploadGrant.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/model/PartUploadGrant.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/model/PartUploadGrant.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/DirectMultipartUploadPort.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/DirectMultipartUploadPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/DirectMultipartUploadPort.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/DirectMultipartUploadPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/DirectObjectDownloadGrantPort.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/DirectObjectDownloadGrantPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/DirectObjectDownloadGrantPort.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/DirectObjectDownloadGrantPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/DirectObjectUploadPort.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/DirectObjectUploadPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/DirectObjectUploadPort.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/DirectObjectUploadPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/ManagedObjectPublicationPort.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/ManagedObjectPublicationPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/ManagedObjectPublicationPort.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/ManagedObjectPublicationPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectInspectionPort.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectInspectionPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectInspectionPort.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectInspectionPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectOperationResolutionPort.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectOperationResolutionPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectOperationResolutionPort.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectOperationResolutionPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectPublicationHandoffPort.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectPublicationHandoffPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectPublicationHandoffPort.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectPublicationHandoffPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectPurgeMaintenancePort.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectPurgeMaintenancePort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectPurgeMaintenancePort.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectPurgeMaintenancePort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectRetirementPort.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectRetirementPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectRetirementPort.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectRetirementPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectScanMaintenancePort.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectScanMaintenancePort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectScanMaintenancePort.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectScanMaintenancePort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectTransferPort.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectTransferPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectTransferPort.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/ObjectTransferPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/StagedObjectPublicationPort.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/StagedObjectPublicationPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/port/StagedObjectPublicationPort.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/port/StagedObjectPublicationPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/DirectDownloadGrantRequest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/DirectDownloadGrantRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/DirectDownloadGrantRequest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/DirectDownloadGrantRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/DirectUploadCompletionRequest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/DirectUploadCompletionRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/DirectUploadCompletionRequest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/DirectUploadCompletionRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/DirectUploadGrantRequest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/DirectUploadGrantRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/DirectUploadGrantRequest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/DirectUploadGrantRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/MultipartAbortRequest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/MultipartAbortRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/MultipartAbortRequest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/MultipartAbortRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/MultipartCompleteRequest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/MultipartCompleteRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/MultipartCompleteRequest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/MultipartCompleteRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/MultipartPartAcknowledgement.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/MultipartPartAcknowledgement.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/MultipartPartAcknowledgement.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/MultipartPartAcknowledgement.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/MultipartStartRequest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/MultipartStartRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/MultipartStartRequest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/MultipartStartRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectAbortAuthorization.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectAbortAuthorization.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectAbortAuthorization.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectAbortAuthorization.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectAbortRequest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectAbortRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectAbortRequest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectAbortRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectFinalizeRequest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectFinalizeRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectFinalizeRequest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectFinalizeRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectHandoffClaimRequest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectHandoffClaimRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectHandoffClaimRequest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectHandoffClaimRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectHandoffReleaseRequest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectHandoffReleaseRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectHandoffReleaseRequest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectHandoffReleaseRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectHandoffRenewRequest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectHandoffRenewRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectHandoffRenewRequest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectHandoffRenewRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectPublishRequest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectPublishRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectPublishRequest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectPublishRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectPurgeRequest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectPurgeRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectPurgeRequest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectPurgeRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectReadRequest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectReadRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectReadRequest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectReadRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectRequestSupport.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectRequestSupport.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectRequestSupport.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectRequestSupport.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectRetireRequest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectRetireRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectRetireRequest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectRetireRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectScanReadRequest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectScanReadRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectScanReadRequest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectScanReadRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectScanVerdictRequest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectScanVerdictRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectScanVerdictRequest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectScanVerdictRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectStageRequest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectStageRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectStageRequest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectStageRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectVerifyRequest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectVerifyRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectVerifyRequest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/ObjectVerifyRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/PartUploadGrantRequest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/PartUploadGrantRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/objectstorage/request/PartUploadGrantRequest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/objectstorage/request/PartUploadGrantRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/storage/ObjectStoragePort.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/storage/ObjectStoragePort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/storage/ObjectStoragePort.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/storage/ObjectStoragePort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/storage/StoredObject.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/storage/StoredObject.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/storage/StoredObject.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/storage/StoredObject.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionApproval.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionApproval.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionApproval.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionApproval.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionApprovalVerifierPort.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionApprovalVerifierPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionApprovalVerifierPort.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionApprovalVerifierPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionPort.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionPort.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionPort.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionPort.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionReceipt.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionReceipt.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionReceipt.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionReceipt.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionRequest.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionRequest.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionRequest.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectAdoptionRequest.java diff --git a/src/application-core/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectLocator.java b/src/application-objectstorage/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectLocator.java similarity index 100% rename from src/application-core/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectLocator.java rename to src/application-objectstorage/src/main/java/dev/caskeleton/application/storage/migration/LegacyObjectLocator.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/objectstorage/ObjectContentContractTest.java b/src/application-objectstorage/src/test/java/dev/caskeleton/application/objectstorage/ObjectContentContractTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/objectstorage/ObjectContentContractTest.java rename to src/application-objectstorage/src/test/java/dev/caskeleton/application/objectstorage/ObjectContentContractTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/objectstorage/ObjectStorageArchitectureContractTest.java b/src/application-objectstorage/src/test/java/dev/caskeleton/application/objectstorage/ObjectStorageArchitectureContractTest.java similarity index 88% rename from src/application-core/src/test/java/dev/caskeleton/application/objectstorage/ObjectStorageArchitectureContractTest.java rename to src/application-objectstorage/src/test/java/dev/caskeleton/application/objectstorage/ObjectStorageArchitectureContractTest.java index 674365a2..343e28e7 100644 --- a/src/application-core/src/test/java/dev/caskeleton/application/objectstorage/ObjectStorageArchitectureContractTest.java +++ b/src/application-objectstorage/src/test/java/dev/caskeleton/application/objectstorage/ObjectStorageArchitectureContractTest.java @@ -8,7 +8,7 @@ import dev.caskeleton.application.objectstorage.model.DirectUploadGrant; import dev.caskeleton.application.objectstorage.model.PartUploadGrant; import dev.caskeleton.application.storage.ObjectStoragePort; import dev.caskeleton.application.storage.StoredObject; -import java.io.IOException; +import dev.caskeleton.application.testsupport.CompiledPackageScanner; import java.lang.annotation.Annotation; import java.lang.reflect.AnnotatedElement; import java.lang.reflect.Constructor; @@ -17,9 +17,6 @@ import java.lang.reflect.Method; import java.lang.reflect.RecordComponent; import java.lang.reflect.Type; import java.net.URI; -import java.net.URISyntaxException; -import java.nio.file.Files; -import java.nio.file.Path; import java.util.ArrayList; import java.util.List; import java.util.Set; @@ -145,23 +142,11 @@ class ObjectStorageArchitectureContractTest { } private static List> topLevelClassesUnder(String packageName) - throws IOException, URISyntaxException, ClassNotFoundException { - String packagePath = packageName.replace('.', '/'); - Path classesRoot = - Path.of( - ObjectDestinationId.class.getProtectionDomain().getCodeSource().getLocation().toURI()); - Path root = classesRoot.resolve(packagePath); + throws ClassNotFoundException { List> classes = new ArrayList<>(); - try (var files = Files.walk(root)) { - for (Path classFile : - files - .filter(path -> path.toString().endsWith(".class")) - .filter(path -> !path.getFileName().toString().contains("$")) - .toList()) { - String relative = - root.relativize(classFile).toString().replace(java.io.File.separator, "."); - String className = - packageName + "." + relative.substring(0, relative.length() - ".class".length()); + for (String className : + CompiledPackageScanner.classNamesUnder(ObjectDestinationId.class, packageName)) { + if (!className.contains("$")) { classes.add(Class.forName(className)); } } diff --git a/src/application-core/src/test/java/dev/caskeleton/application/objectstorage/ObjectStorageIdentityContractTest.java b/src/application-objectstorage/src/test/java/dev/caskeleton/application/objectstorage/ObjectStorageIdentityContractTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/objectstorage/ObjectStorageIdentityContractTest.java rename to src/application-objectstorage/src/test/java/dev/caskeleton/application/objectstorage/ObjectStorageIdentityContractTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/objectstorage/ObjectStoragePortContractTest.java b/src/application-objectstorage/src/test/java/dev/caskeleton/application/objectstorage/ObjectStoragePortContractTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/objectstorage/ObjectStoragePortContractTest.java rename to src/application-objectstorage/src/test/java/dev/caskeleton/application/objectstorage/ObjectStoragePortContractTest.java diff --git a/src/application-core/src/test/java/dev/caskeleton/application/objectstorage/ObjectStorageValueContractTest.java b/src/application-objectstorage/src/test/java/dev/caskeleton/application/objectstorage/ObjectStorageValueContractTest.java similarity index 100% rename from src/application-core/src/test/java/dev/caskeleton/application/objectstorage/ObjectStorageValueContractTest.java rename to src/application-objectstorage/src/test/java/dev/caskeleton/application/objectstorage/ObjectStorageValueContractTest.java diff --git a/src/application-objectstorage/src/test/java/dev/caskeleton/application/testsupport/CompiledPackageScanner.java b/src/application-objectstorage/src/test/java/dev/caskeleton/application/testsupport/CompiledPackageScanner.java new file mode 100644 index 00000000..76f57033 --- /dev/null +++ b/src/application-objectstorage/src/test/java/dev/caskeleton/application/testsupport/CompiledPackageScanner.java @@ -0,0 +1,66 @@ +package dev.caskeleton.application.testsupport; + +import java.io.IOException; +import java.io.UncheckedIOException; +import java.net.URISyntaxException; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.List; +import java.util.jar.JarFile; +import java.util.stream.Stream; + +/** Scans compiled classes from either a classes directory or the project's packaged JAR. */ +public final class CompiledPackageScanner { + + private CompiledPackageScanner() {} + + public static List classNamesUnder(Class anchor, String packageName) { + try { + Path codeSource = Path.of(anchor.getProtectionDomain().getCodeSource().getLocation().toURI()); + String packagePath = packageName.replace('.', '/'); + if (Files.isDirectory(codeSource)) { + return fromDirectory(codeSource.resolve(packagePath), packageName); + } + if (Files.isRegularFile(codeSource)) { + return fromJar(codeSource, packagePath); + } + throw new IOException("unsupported compiled-code location: " + codeSource); + } catch (URISyntaxException | IOException unreadable) { + throw new UncheckedIOException( + new IOException("cannot scan compiled package " + packageName, unreadable)); + } + } + + private static List fromDirectory(Path packageRoot, String packageName) + throws IOException { + if (!Files.isDirectory(packageRoot)) { + return List.of(); + } + try (Stream files = Files.walk(packageRoot)) { + return files + .filter(path -> path.toString().endsWith(".class")) + .map( + path -> + packageName + + "." + + packageRoot + .relativize(path) + .toString() + .replace(java.io.File.separatorChar, '.') + .replaceAll("\\.class$", "")) + .toList(); + } + } + + private static List fromJar(Path jarPath, String packagePath) throws IOException { + String prefix = packagePath.endsWith("/") ? packagePath : packagePath + "/"; + try (JarFile jar = new JarFile(jarPath.toFile())) { + return jar.stream() + .map(entry -> entry.getName()) + .filter(name -> name.startsWith(prefix)) + .filter(name -> name.endsWith(".class")) + .map(name -> name.substring(0, name.length() - ".class".length()).replace('/', '.')) + .toList(); + } + } +} diff --git a/src/build-logic/README.md b/src/build-logic/README.md index 66f3e8c0..446c5b6e 100644 --- a/src/build-logic/README.md +++ b/src/build-logic/README.md @@ -9,6 +9,9 @@ without any check noticing. | Plugin | Owns | | --- | --- | | `ca.architecture-registry` (settings) | project inclusion, directory mapping, and the parsed registry every other reader shares | +| `ca.java-conventions` | Java toolchain/compiler baseline and dependency locking shared by Java leaves | +| `ca.quality-conventions` | Spotless, Checkstyle, Error Prone, SpotBugs/FindSecBugs wiring shared by Java leaves | +| `ca.java-library` / `ca.spring-library` | leaf-level composition of the Java/quality conventions for plain and Spring libraries | | `ca.strict-test-lane` | tagged / named / own-source-set Test lanes that cannot pass without executing something | | `ca.strict-qualification` | qualification lanes that cannot pass without executing every named class, re-checked against the JUnit XML | | `ca.evidence` | the JUnit XML reader and the no-skip / required-class rules built on it | @@ -36,14 +39,13 @@ mechanisms and more than one caller needs each: The remediation design's §10.2 listed eight conventions. Two of them were attempted or assessed and deliberately not built, and the reasons belong next to the code rather than in a review thread. -### `ca.java-leaf` — reverted +### Historical `ca.java-leaf` experiment -Written, measured, reverted. The full reasoning is in `src/build.gradle` beside the static-analysis -block it would have moved. In short: a recorded decision (`feature-static-analysis-quality-contract` -D8) already put that baseline in the root `subprojects {}` block; the block is applied once and -copied nowhere, so extracting it removes no duplication; and build-logic would have to re-declare the -spotless / spotbugs / errorprone / dependency-management coordinates *and their versions*, which -creates a drift surface where there was none. +The original all-in-one `ca.java-leaf` experiment was reverted, but that is historical context, not +the current build shape. The responsibilities were subsequently split into the narrower +`ca.java-conventions` and `ca.quality-conventions` plugins listed above, and leaf plugins compose +those conventions. Dependency/tool versions still come from the shared catalog rather than being +hard-coded per leaf. A content-level baseline of the resolved analysis configuration — compiler args, encoding, release, Checkstyle tool version and config, SpotBugs effort and report level, for every source set of every diff --git a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/ConditionalTransportQualificationPlugin.java b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/ConditionalTransportQualificationPlugin.java index b39f590c..67704f3d 100644 --- a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/ConditionalTransportQualificationPlugin.java +++ b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/ConditionalTransportQualificationPlugin.java @@ -38,7 +38,7 @@ public final class ConditionalTransportQualificationPlugin implements Plugin { EvidenceExtension evidence = diff --git a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/architecture/ArchitectureModuleRule.java b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/architecture/ArchitectureModuleRule.java index 0ab18545..08ba2653 100644 --- a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/architecture/ArchitectureModuleRule.java +++ b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/architecture/ArchitectureModuleRule.java @@ -6,10 +6,14 @@ import java.util.Set; import org.gradle.api.artifacts.Configuration; record ArchitectureModuleRule( - String moduleName, Set allowedDependencies, List productionConfigurations) { + String moduleName, + Set allowedDependencies, + List productionConfigurations, + Configuration compileClasspath) { ArchitectureModuleRule { Objects.requireNonNull(moduleName, "moduleName"); allowedDependencies = Set.copyOf(allowedDependencies); productionConfigurations = List.copyOf(productionConfigurations); + Objects.requireNonNull(compileClasspath, "compileClasspath"); } } 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 cbb50084..957dafd6 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 @@ -8,7 +8,6 @@ import java.util.ArrayList; import java.util.HashSet; import java.util.List; import java.util.Set; -import java.util.TreeSet; import org.gradle.api.Plugin; import org.gradle.api.Project; import org.gradle.api.artifacts.Configuration; @@ -17,23 +16,25 @@ public final class ArchitecturePlugin implements Plugin { private static final List PRODUCTION_DECLARATIONS = List.of("api", "implementation", "compileOnly", "runtimeOnly"); private static final List APPLICATION_CLASSPATHS = - List.of("compileClasspath", "runtimeClasspath", "testCompileClasspath", "testRuntimeClasspath"); + List.of( + "compileClasspath", "runtimeClasspath", "testCompileClasspath", "testRuntimeClasspath"); @Override public void apply(Project project) { Project root = project.getRootProject(); - File registryFile = root.file("config/architecture/modules.json"); + 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 = root.getProjectDir().getParentFile().getCanonicalFile(); + repositoryRoot = mainBuildDirectory.getParentFile().getCanonicalFile(); } catch (IOException exception) { throw new UncheckedIOException("failed to resolve repository root", exception); } ModuleRegistry registry = ModuleRegistry.read(registryFile, repositoryRoot); - List modules = - registry.modulesForBuild("main").stream() - .filter(module -> !module.id().equals("sample-portfolio")) - .toList(); + List modules = registry.modulesForBuild(buildName); List registryViolations = registryViolations(registry, modules); var clean = @@ -57,7 +58,8 @@ public final class ArchitecturePlugin implements Plugin { task -> { task.setGroup("verification"); task.setDescription( - "Verifies application-core has only project production dependencies and no diagnostic frameworks on application classpaths."); + "Verifies all application-* modules have only project production dependencies" + + " and no diagnostic frameworks on application classpaths."); }); var ignoredSources = project @@ -68,81 +70,109 @@ public final class ArchitecturePlugin implements Plugin { task -> { task.setGroup("verification"); task.setDescription( - "Fails when a Java source file lives in a package that Git ignores or would ignore."); + "Fails when a Java source file lives in a package that Git ignores or would" + + " ignore."); task.getBuildRoot().set(root.getLayout().getProjectDirectory()); }); - project.getGradle().projectsEvaluated( - ignored -> { - Set declaredModules = new HashSet<>(); - root.getSubprojects().stream() - .filter(sub -> sub.getChildProjects().isEmpty()) - .filter(sub -> !sub.getPath().equals(":sample-portfolio")) - .forEach(sub -> declaredModules.add(sub.getPath().replaceFirst("^:", ""))); - List rules = new ArrayList<>(); - for (ModuleRegistry.Module module : modules) { - Project owner = root.project(module.gradlePath()); - Set allowed = new HashSet<>(); - for (String dependencyId : module.allowedDependencies()) { - ModuleRegistry.Module dependency = registry.byId(dependencyId); - if (dependency != null && !dependency.id().equals("sample-portfolio")) { - allowed.add(dependency.gradlePath().replaceFirst("^:", "")); - } - } - List configurations = - PRODUCTION_DECLARATIONS.stream() - .map(name -> owner.getConfigurations().findByName(name)) - .filter(java.util.Objects::nonNull) - .toList(); - rules.add( - new ArchitectureModuleRule( - module.gradlePath().replaceFirst("^:", ""), allowed, configurations)); - } - clean.configure( - task -> { - task.getDeclaredModules().set(declaredModules); - task.setRules(rules); - }); - - Project application = root.project(":application-core"); - List production = - PRODUCTION_DECLARATIONS.stream() - .map(name -> application.getConfigurations().findByName(name)) - .filter(java.util.Objects::nonNull) - .toList(); - List classpaths = - APPLICATION_CLASSPATHS.stream() - .map(name -> application.getConfigurations().getByName(name)) - .toList(); - purity.configure( - task -> { - task.setProductionConfigurations(production); - task.setResolvedConfigurations(classpaths); - }); - - List sourceRoots = new ArrayList<>(); - root.getSubprojects().stream() - .filter(sub -> !sub.getPath().equals(":sample-portfolio")) - .forEach( - sub -> { - for (String relative : List.of("src/main/java", "src/test/java")) { - File sourceRoot = sub.file(relative); - if (sourceRoot.isDirectory()) { - sourceRoots.add(sourceRoot); - } - } - }); - ignoredSources.configure(task -> task.getSourceRoots().from(sourceRoots)); - }); - project - .getTasks() - .register( - "architectureCheck", - task -> { - task.setGroup("verification"); - task.setDescription("Runs the repository-wide architecture invariants."); - task.dependsOn(clean, purity, ignoredSources, project.getTasks().named("verifyRuntimeModuleMembership")); + .getGradle() + .projectsEvaluated( + ignored -> { + Set declaredModules = new HashSet<>(); + root.getSubprojects().stream() + .filter(sub -> sub.getChildProjects().isEmpty()) + .forEach(sub -> declaredModules.add(sub.getPath().replaceFirst("^:", ""))); + List rules = new ArrayList<>(); + for (ModuleRegistry.Module module : modules) { + Project owner = root.project(module.gradlePath()); + Set allowed = new HashSet<>(); + for (String dependencyId : module.allowedDependencies()) { + ModuleRegistry.Module dependency = registry.byId(dependencyId); + if (dependency != null) { + allowed.add(dependency.gradlePath().replaceFirst("^:", "")); + } + } + List configurations = + PRODUCTION_DECLARATIONS.stream() + .map(name -> owner.getConfigurations().findByName(name)) + .filter(java.util.Objects::nonNull) + .toList(); + Configuration compileClasspath = + owner.getConfigurations().getByName("compileClasspath"); + rules.add( + new ArchitectureModuleRule( + module.gradlePath().replaceFirst("^:", ""), + allowed, + configurations, + compileClasspath)); + } + clean.configure( + task -> { + task.getDeclaredModules().set(declaredModules); + task.setRules(rules); + }); + + List applicationProjects = + modules.stream() + .filter(module -> module.id().startsWith("application-")) + .map(module -> root.project(module.gradlePath())) + .toList(); + List production = + applicationProjects.stream() + .flatMap( + application -> + PRODUCTION_DECLARATIONS.stream() + .map(name -> application.getConfigurations().findByName(name))) + .filter(java.util.Objects::nonNull) + .toList(); + List classpaths = + applicationProjects.stream() + .flatMap( + application -> + APPLICATION_CLASSPATHS.stream() + .map(name -> application.getConfigurations().getByName(name))) + .toList(); + purity.configure( + task -> { + task.setProductionConfigurations(production); + task.setResolvedConfigurations(classpaths); + }); + + List sourceRoots = new ArrayList<>(); + root.getSubprojects().stream() + .filter(sub -> !sub.getPath().equals(":sample-portfolio")) + .forEach( + sub -> { + for (String relative : List.of("src/main/java", "src/test/java")) { + File sourceRoot = sub.file(relative); + if (sourceRoot.isDirectory()) { + sourceRoots.add(sourceRoot); + } + } + }); + ignoredSources.configure(task -> task.getSourceRoots().from(sourceRoots)); + }); + + var architectureCheck = + project + .getTasks() + .register( + "architectureCheck", + task -> { + task.setGroup("verification"); + task.setDescription("Runs the build's architecture invariants."); + task.dependsOn(clean, purity, ignoredSources); + }); + project + .getGradle() + .projectsEvaluated( + ignored -> { + if (project.getTasks().findByName("verifyRuntimeModuleMembership") != null) { + architectureCheck.configure( + task -> + task.dependsOn(project.getTasks().named("verifyRuntimeModuleMembership"))); + } }); } diff --git a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/architecture/VerifyApplicationCoreDependencyPurityTask.java b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/architecture/VerifyApplicationCoreDependencyPurityTask.java index ee1d19fb..23bb20fb 100644 --- a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/architecture/VerifyApplicationCoreDependencyPurityTask.java +++ b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/architecture/VerifyApplicationCoreDependencyPurityTask.java @@ -11,7 +11,7 @@ import org.gradle.api.tasks.Internal; import org.gradle.api.tasks.TaskAction; import org.gradle.work.DisableCachingByDefault; -@DisableCachingByDefault(because = "Verification inspects and resolves live application-core configurations") +@DisableCachingByDefault(because = "Verification inspects and resolves live application module configurations") public class VerifyApplicationCoreDependencyPurityTask extends DefaultTask { private List productionConfigurations = List.of(); private List resolvedConfigurations = List.of(); @@ -81,7 +81,7 @@ public class VerifyApplicationCoreDependencyPurityTask extends DefaultTask { } getLogger() .lifecycle( - "verifyApplicationCoreDependencyPurity: OK — application-core production declarations are project-only and application classpaths contain no Spring/logging/metrics frameworks."); + "verifyApplicationCoreDependencyPurity: OK — application-* production declarations are project-only and application classpaths contain no Spring/logging/metrics frameworks."); } private static boolean forbiddenGroup(String group) { diff --git a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/architecture/VerifyCleanArchitectureDependenciesTask.java b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/architecture/VerifyCleanArchitectureDependenciesTask.java index d43ef003..1180927f 100644 --- a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/architecture/VerifyCleanArchitectureDependenciesTask.java +++ b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/architecture/VerifyCleanArchitectureDependenciesTask.java @@ -8,6 +8,7 @@ import java.util.TreeSet; import org.gradle.api.DefaultTask; import org.gradle.api.GradleException; import org.gradle.api.artifacts.ProjectDependency; +import org.gradle.api.artifacts.component.ProjectComponentIdentifier; import org.gradle.api.file.RegularFileProperty; import org.gradle.api.provider.ListProperty; import org.gradle.api.provider.SetProperty; @@ -17,7 +18,7 @@ import org.gradle.api.tasks.Internal; import org.gradle.api.tasks.TaskAction; import org.gradle.work.DisableCachingByDefault; -@DisableCachingByDefault(because = "Verification inspects live project dependency declarations") +@DisableCachingByDefault(because = "Verification inspects live declarations and resolved compile classpaths") public abstract class VerifyCleanArchitectureDependenciesTask extends DefaultTask { private List rules = List.of(); @@ -70,6 +71,7 @@ public abstract class VerifyCleanArchitectureDependenciesTask extends DefaultTas + " are not covered by verifyCleanArchitectureDependencies. Add an explicit dependency policy before using them."); } + List dependencyViolations = new ArrayList<>(); for (ArchitectureModuleRule rule : rules) { Set actual = new HashSet<>(); for (var configuration : rule.productionConfigurations()) { @@ -78,18 +80,35 @@ public abstract class VerifyCleanArchitectureDependenciesTask extends DefaultTas .withType(ProjectDependency.class) .forEach(dependency -> actual.add(dependency.getPath().replaceFirst("^:", ""))); } + rule.compileClasspath() + .getIncoming() + .getResolutionResult() + .getAllComponents() + .forEach( + component -> { + if (component.getId() instanceof ProjectComponentIdentifier project) { + String projectPath = project.getProjectPath().replaceFirst("^:", ""); + if (!projectPath.equals(rule.moduleName())) { + actual.add(projectPath); + } + } + }); Set forbidden = new TreeSet<>(actual); forbidden.removeAll(rule.allowedDependencies()); if (!forbidden.isEmpty()) { - throw new GradleException( + dependencyViolations.add( "Module ':" + rule.moduleName() + "' has forbidden project dependencies " + forbidden + ". Allowed dependencies are " - + new TreeSet<>(rule.allowedDependencies()) - + "; all production project edges must be explicitly registered."); + + new TreeSet<>(rule.allowedDependencies())); } } + if (!dependencyViolations.isEmpty()) { + throw new GradleException( + String.join("\n", dependencyViolations) + + "\nDirect and compile-visible production project edges must be explicitly registered."); + } } } diff --git a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/auxiliary/AuxiliarySourceSetExtension.java b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/auxiliary/AuxiliarySourceSetExtension.java index d3462c4d..e4f5c87f 100644 --- a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/auxiliary/AuxiliarySourceSetExtension.java +++ b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/auxiliary/AuxiliarySourceSetExtension.java @@ -25,6 +25,7 @@ public class AuxiliarySourceSetExtension { private void realize(AuxiliarySourceSetSpec spec) { SourceSetContainer sourceSets = owner.getExtensions().getByType(SourceSetContainer.class); SourceSet created = sourceSets.create(spec.getName()); + FileCollection visibleOutputs = owner.files(); for (String visible : spec.getVisibleOutputs()) { SourceSet source = sourceSets.findByName(visible); if (source == null) { @@ -37,11 +38,15 @@ public class AuxiliarySourceSetExtension { + visible + "', which does not exist. Declare it first — source sets are created in declaration order."); } + visibleOutputs = visibleOutputs.plus(source.getOutput()); created.setCompileClasspath(created.getCompileClasspath().plus(source.getOutput())); } if (spec.getRuntimeSourceSets().isEmpty()) { - created.setRuntimeClasspath( - created.getRuntimeClasspath().plus(created.getOutput()).plus(created.getCompileClasspath())); + // A source set that compiles against main/test fixtures must see those outputs at runtime, + // but its compile classpath is not a valid runtime classpath: it can contain compileOnly + // analysis/fixture dependencies. Gradle's own runtimeClasspath already carries this source + // set's output plus its runtime configuration, so add only the explicitly visible outputs. + created.setRuntimeClasspath(created.getRuntimeClasspath().plus(visibleOutputs)); } else { FileCollection runtimeClasspath = created.getOutput(); for (String runtimeSourceName : spec.getRuntimeSourceSets()) { diff --git a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/jpa/JpaTestLanesPlugin.java b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/jpa/JpaTestLanesPlugin.java index 646b0bd2..4f2c83be 100644 --- a/src/build-logic/src/main/java/dev/caskeleton/buildlogic/jpa/JpaTestLanesPlugin.java +++ b/src/build-logic/src/main/java/dev/caskeleton/buildlogic/jpa/JpaTestLanesPlugin.java @@ -17,11 +17,29 @@ public final class JpaTestLanesPlugin implements Plugin { "PostgreSqlSecurityBaselineIntegrationTest", List.of("runtimeRoleCannotCreateInApplicationSchemaOrTempAndUsesTrustedSearchPath")), readiness("postgresqlMigrationIntegrationTest", "PostgreSqlMigrationIntegrationTest"), + readiness( + "postgresqlIntLockMigrationCompatibilityIntegrationTest", + "PostgreSqlIntLockMigrationCompatibilityIntegrationTest"), readiness("postgresqlTransactionIntegrationTest", "PostgreSqlTransactionIntegrationTest"), + readiness( + "postgresqlDistributedLockIntegrationTest", + "PostgreSqlDistributedLockIntegrationTest"), readiness("postgresqlAggregateIntegrationTest", "PostgreSqlAggregateIntegrationTest"), readiness("postgresqlQueryIntegrationTest", "PostgreSqlQueryIntegrationTest"), readiness("postgresqlIdempotencyIntegrationTest", "PostgreSqlIdempotencyIntegrationTest"), + readiness( + "postgresqlIdempotencyUniqueScopeIntegrationTest", + "PostgreSqlIdempotencyUniqueScopeIntegrationTest"), readiness("postgresqlOutboxStorageIntegrationTest", "PostgreSqlOutboxStorageIntegrationTest"), + readiness( + "postgresqlLegacyOutboxAppendTransactionalIntegrationTest", + "PostgreSqlLegacyOutboxAppendTransactionalIntegrationTest"), + readiness( + "postgresqlLegacyOutboxConcurrentRelayIntegrationTest", + "PostgreSqlLegacyOutboxConcurrentRelayIntegrationTest"), + readiness( + "postgresqlLegacyOutboxRowLifecycleIntegrationTest", + "PostgreSqlLegacyOutboxRowLifecycleIntegrationTest"), readiness("postgresqlOutboxPollingIntegrationTest", "PostgreSqlOutboxPollingIntegrationTest"), readiness("postgresqlInboxIntegrationTest", "PostgreSqlInboxIntegrationTest"), readiness( diff --git a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/ConditionalTransportQualificationPluginFunctionalTest.java b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/ConditionalTransportQualificationPluginFunctionalTest.java index 393dbcbd..4f4b2d1c 100644 --- a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/ConditionalTransportQualificationPluginFunctionalTest.java +++ b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/ConditionalTransportQualificationPluginFunctionalTest.java @@ -69,8 +69,8 @@ final class ConditionalTransportQualificationPluginFunctionalTest { writeProducer( projectDirectory, "app-bootstrap", - "conditionalTransportCompositionTest", - "conditionalTransportCompositionTest"); + "conditionalTransportBuildContractTest", + "conditionalTransportBuildContractTest"); return projectDirectory; } 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 new file mode 100644 index 00000000..982c3026 --- /dev/null +++ b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/architecture/CleanArchitectureResolvedClasspathFunctionalTest.java @@ -0,0 +1,167 @@ +package dev.caskeleton.buildlogic.architecture; + +import static java.nio.charset.StandardCharsets.UTF_8; +import static org.assertj.core.api.Assertions.assertThat; + +import java.io.IOException; +import java.nio.file.Files; +import java.nio.file.Path; +import org.gradle.testkit.runner.BuildResult; +import org.gradle.testkit.runner.GradleRunner; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.io.TempDir; + +class CleanArchitectureResolvedClasspathFunctionalTest { + + @Test + void transitiveApiProjectMustBeRegisteredForTheCompileVisibleConsumer(@TempDir Path temporaryRoot) + throws IOException { + Path project = fixture(temporaryRoot, false); + + BuildResult result = runner(project, "verifyCleanArchitectureDependencies").buildAndFail(); + + assertThat(result.getOutput()) + .contains("Module ':c' has forbidden project dependencies [a]") + .contains( + "Direct and compile-visible production project edges must be explicitly registered"); + } + + @Test + void samplePortfolioCompositionRootIsGovernedByTheSameDependencyPolicy( + @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.writeString( + project.resolve("settings.gradle"), + """ + rootProject.name = 'main' + include 'a', 'sample-portfolio' + """, + UTF_8); + Files.writeString( + project.resolve("build.gradle"), + """ + plugins { id 'ca.architecture' } + subprojects { apply plugin: 'java-library' } + project(':sample-portfolio') { + dependencies { implementation project(':a') } + } + """, + UTF_8); + Files.writeString( + project.resolve("config/architecture/modules.json"), + """ + { + "composition_roots": ["sample-portfolio"], + "modules": [ + { + "id": "a", + "gradle_path": ":a", + "source_path": "src/a", + "allowed_dependencies": [] + }, + { + "id": "sample-portfolio", + "gradle_path": ":sample-portfolio", + "source_path": "src/sample-portfolio", + "allowed_dependencies": [] + } + ] + } + """, + UTF_8); + + BuildResult result = runner(project, "verifyCleanArchitectureDependencies").buildAndFail(); + + assertThat(result.getOutput()) + .contains("Module ':sample-portfolio' has forbidden project dependencies [a]"); + } + + @Test + void explicitlyRegisteredCompileVisibleTransitiveProjectPasses(@TempDir Path temporaryRoot) + throws IOException { + Path project = fixture(temporaryRoot, true); + + BuildResult result = runner(project, "verifyCleanArchitectureDependencies").build(); + + assertThat(result.getOutput()).contains("BUILD SUCCESSFUL"); + } + + private static Path fixture(Path temporaryRoot, boolean allowTransitiveA) throws IOException { + Path repository = temporaryRoot.resolve("repository"); + Path project = repository.resolve("src"); + Files.createDirectories(project.resolve("config/architecture")); + for (String module : new String[] {"a", "b", "c"}) { + Files.createDirectories(project.resolve(module)); + } + + Files.writeString( + project.resolve("settings.gradle"), + """ + rootProject.name = 'main' + include 'a', 'b', 'c' + """, + UTF_8); + + Files.writeString( + project.resolve("build.gradle"), + """ + plugins { id 'ca.architecture' } + subprojects { apply plugin: 'java-library' } + project(':b') { + dependencies { api project(':a') } + } + project(':c') { + dependencies { implementation project(':b') } + } + """, + UTF_8); + + String cAllowed = allowTransitiveA ? "[\"b\", \"a\"]" : "[\"b\"]"; + Files.writeString( + project.resolve("config/architecture/modules.json"), + """ + { + "composition_roots": ["c"], + "modules": [ + { + "id": "a", + "gradle_path": ":a", + "source_path": "src/a", + "allowed_dependencies": [] + }, + { + "id": "b", + "gradle_path": ":b", + "source_path": "src/b", + "allowed_dependencies": ["a"] + }, + { + "id": "c", + "gradle_path": ":c", + "source_path": "src/c", + "allowed_dependencies": %s + } + ] + } + """ + .formatted(cAllowed), + UTF_8); + return project; + } + + private static GradleRunner runner(Path project, String... arguments) { + String[] fullArguments = new String[arguments.length + 2]; + fullArguments[0] = "--console=plain"; + fullArguments[1] = "--stacktrace"; + System.arraycopy(arguments, 0, fullArguments, 2, arguments.length); + return GradleRunner.create() + .withProjectDir(project.toFile()) + .withPluginClasspath() + .withArguments(fullArguments); + } +} diff --git a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/auxiliary/AuxiliarySourceSetConventionTest.java b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/auxiliary/AuxiliarySourceSetConventionTest.java index c26c192e..c2863ab1 100644 --- a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/auxiliary/AuxiliarySourceSetConventionTest.java +++ b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/auxiliary/AuxiliarySourceSetConventionTest.java @@ -78,6 +78,43 @@ class AuxiliarySourceSetConventionTest { assertTrue(result.getOutput().contains("contains-test-output=true"), result.getOutput()); } + @Test + void defaultRuntimeKeepsVisibleOutputsWithoutLeakingCompileOnly() throws Exception { + Files.writeString(projectDir.resolve("compile-only-marker.jar"), "compile-only"); + Files.writeString(projectDir.resolve("runtime-only-marker.jar"), "runtime-only"); + Files.writeString( + projectDir.resolve("build.gradle"), + """ + plugins { + id 'java' + id 'ca.auxiliary-source-set' + } + dependencies { + testCompileOnly files('compile-only-marker.jar') + testRuntimeOnly files('runtime-only-marker.jar') + } + auxiliarySourceSets { + sourceSet('integrationTest') { + compilesAgainst 'main' + inherits 'implementation', 'compileOnly', 'runtimeOnly' + } + } + tasks.register('reportRuntime') { + doLast { + def runtime = sourceSets.integrationTest.runtimeClasspath + def names = runtime.files*.name + logger.lifecycle('contains-compile-only=' + names.contains('compile-only-marker.jar')) + logger.lifecycle('contains-runtime-only=' + names.contains('runtime-only-marker.jar')) + logger.lifecycle('contains-main-output=' + runtime.files.containsAll(sourceSets.main.output.files)) + } + } + """); + BuildResult result = runner("reportRuntime", "--console=plain").build(); + assertTrue(result.getOutput().contains("contains-compile-only=false"), result.getOutput()); + assertTrue(result.getOutput().contains("contains-runtime-only=true"), result.getOutput()); + assertTrue(result.getOutput().contains("contains-main-output=true"), result.getOutput()); + } + @Test void unknownVisibleSourceSetFailsWithBothNames() throws Exception { Files.writeString( diff --git a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/jpa/JpaTestLanesPluginFunctionalTest.java b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/jpa/JpaTestLanesPluginFunctionalTest.java index 83d09330..09b37cf8 100644 --- a/src/build-logic/src/test/java/dev/caskeleton/buildlogic/jpa/JpaTestLanesPluginFunctionalTest.java +++ b/src/build-logic/src/test/java/dev/caskeleton/buildlogic/jpa/JpaTestLanesPluginFunctionalTest.java @@ -28,7 +28,7 @@ class JpaTestLanesPluginFunctionalTest { tasks.register('verifyJpaLaneModel') { doLast { - assert strictTestLanes.lanes.size() == 20 + assert strictTestLanes.lanes.size() == 26 def security = strictTestLanes.lanes.getByName('postgresqlSecurityBaselineIntegrationTest') assert security.requiredTests == [ @@ -44,6 +44,48 @@ class JpaTestLanesPluginFunctionalTest { assert readiness.jvmArgs.contains('-Duser.timezone=UTC') assert readiness.jvmArgs.contains('-Djpa.evidence.postgresql.image=postgres:17-alpine') + def movedMigration = strictTestLanes.lanes.getByName( + 'postgresqlIntLockMigrationCompatibilityIntegrationTest') + assert movedMigration.sourceSet == 'postgresqlIntegrationTest' + assert movedMigration.category.toString() == 'INTEGRATION' + assert movedMigration.requiredTests == [ + 'dev.caskeleton.adapter.outbound.persistence.readiness.PostgreSqlIntLockMigrationCompatibilityIntegrationTest' + ] + + def legacyAppend = strictTestLanes.lanes.getByName( + 'postgresqlLegacyOutboxAppendTransactionalIntegrationTest') + assert legacyAppend.requiredTests == [ + 'dev.caskeleton.adapter.outbound.persistence.readiness.PostgreSqlLegacyOutboxAppendTransactionalIntegrationTest' + ] + + def legacyConcurrentRelay = strictTestLanes.lanes.getByName( + 'postgresqlLegacyOutboxConcurrentRelayIntegrationTest') + assert legacyConcurrentRelay.requiredTests == [ + 'dev.caskeleton.adapter.outbound.persistence.readiness.PostgreSqlLegacyOutboxConcurrentRelayIntegrationTest' + ] + + def legacyLifecycle = strictTestLanes.lanes.getByName( + 'postgresqlLegacyOutboxRowLifecycleIntegrationTest') + assert legacyLifecycle.requiredTests == [ + 'dev.caskeleton.adapter.outbound.persistence.readiness.PostgreSqlLegacyOutboxRowLifecycleIntegrationTest' + ] + + def movedLock = strictTestLanes.lanes.getByName( + 'postgresqlDistributedLockIntegrationTest') + assert movedLock.sourceSet == 'postgresqlIntegrationTest' + assert movedLock.category.toString() == 'INTEGRATION' + assert movedLock.requiredTests == [ + 'dev.caskeleton.adapter.outbound.persistence.readiness.PostgreSqlDistributedLockIntegrationTest' + ] + + def movedIdempotency = strictTestLanes.lanes.getByName( + 'postgresqlIdempotencyUniqueScopeIntegrationTest') + assert movedIdempotency.sourceSet == 'postgresqlIntegrationTest' + assert movedIdempotency.category.toString() == 'INTEGRATION' + assert movedIdempotency.requiredTests == [ + 'dev.caskeleton.adapter.outbound.persistence.readiness.PostgreSqlIdempotencyUniqueScopeIntegrationTest' + ] + def readinessTask = tasks.named('postgresqlLifecycleIntegrationTest', Test).get() assert readinessTask.allJvmArgs.contains('-Duser.timezone=UTC') assert readinessTask.allJvmArgs.contains('-Djpa.evidence.postgresql.image=postgres:17-alpine') diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/config/ConfigContractPlugin.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/config/ConfigContractPlugin.java index d06f0d50..af3cc1fd 100644 --- a/src/build-tools/src/main/java/dev/caskeleton/buildtools/config/ConfigContractPlugin.java +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/config/ConfigContractPlugin.java @@ -8,6 +8,22 @@ public final class ConfigContractPlugin implements Plugin { @Override public void apply(Project project) { Project root = project.getRootProject(); + project + .getTasks() + .register( + "verifyOperationalErrorRegistry", + VerifyOperationalErrorRegistryTask.class, + task -> { + task.setGroup("verification"); + task.setDescription( + "Verifies OperationalError and docs/registries/error-codes.yaml stay exactly aligned."); + task.getRegistryFile() + .fileValue(root.file("../docs/registries/error-codes.yaml")); + task.getOperationalErrorSource() + .fileValue( + root.file( + "shared-contract/src/main/java/dev/caskeleton/shared/error/OperationalError.java")); + }); project .getTasks() .register( @@ -16,16 +32,22 @@ public final class ConfigContractPlugin implements Plugin { task -> { task.setGroup("verification"); task.setDescription( - "Verifies application.yml APP_ references, src/.env.example, and env-keys.yaml stay registered."); - task.dependsOn(":adapter:outbound:cache-redis:compileJava"); + "Verifies shipped configuration APP_ references, src/.env.example, and env-keys.yaml stay registered."); + task.dependsOn(":adapter:outbound:redis-runtime:compileJava"); task.getEnvFile().fileValue(root.file(".env.example")); - task.getApplicationYaml() - .fileValue(root.file("app-bootstrap/src/main/resources/application.yml")); + task.getConfigurationFiles() + .from( + root.fileTree( + root.file("app-bootstrap/src/main/resources"), + tree -> { + tree.include("application*.yml"); + tree.include("config/*.yml"); + })); task.getRegistryFile().fileValue(root.file("../docs/registries/env-keys.yaml")); task.getRedisSdkMetadata() .fileValue( root.file( - "adapter/outbound/cache-redis/build/classes/java/main/" + "adapter/outbound/redis-runtime/build/classes/java/main/" + "META-INF/spring-configuration-metadata.json")); task.getProductionSources() .from( @@ -33,8 +55,8 @@ public final class ConfigContractPlugin implements Plugin { root.getProjectDir(), tree -> { tree.include("**/src/main/**/*.java"); - tree.include("**/src/main/**/application.yml"); - tree.exclude("sample-portfolio/**"); + tree.include("**/src/main/**/*.yml"); + tree.include("**/src/main/**/*.yaml"); tree.exclude("**/build/**"); })); }); diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/config/EnvContractVerifier.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/config/EnvContractVerifier.java index a3a50602..eb258573 100644 --- a/src/build-tools/src/main/java/dev/caskeleton/buildtools/config/EnvContractVerifier.java +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/config/EnvContractVerifier.java @@ -37,7 +37,7 @@ public final class EnvContractVerifier { public static EnvContractResult verify( File envFile, - File applicationYaml, + Collection configurationFiles, File registryFile, Collection productionSources, Collection metadataScopes, @@ -48,7 +48,13 @@ public final class EnvContractVerifier { + envFile + ". The tracked example is the contract an adopter copies; a real .env is operator " + "input and is never read here."); - requireFile(applicationYaml, "missing " + applicationYaml); + if (configurationFiles.isEmpty()) { + throw new IllegalStateException( + "verifyEnvKeys: no shipped configuration files were supplied for verification"); + } + for (File configurationFile : configurationFiles) { + requireFile(configurationFile, "missing shipped configuration " + configurationFile); + } requireFile(registryFile, "missing " + registryFile); Set envKeys = new TreeSet<>(); @@ -61,18 +67,20 @@ public final class EnvContractVerifier { Set requiredPlaceholders = new TreeSet<>(); Set allPlaceholders = new TreeSet<>(); - Matcher placeholderMatcher = PLACEHOLDER.matcher(read(applicationYaml)); - while (placeholderMatcher.find()) { - allPlaceholders.add(placeholderMatcher.group(1)); - if (placeholderMatcher.group(2) == null) { - requiredPlaceholders.add(placeholderMatcher.group(1)); - } - } - Set environmentSecretReferences = new TreeSet<>(); - Matcher secretMatcher = SECRET_REFERENCE.matcher(read(applicationYaml)); - while (secretMatcher.find()) { - environmentSecretReferences.add(secretMatcher.group(1)); + for (File configurationFile : configurationFiles) { + String configuration = read(configurationFile); + Matcher placeholderMatcher = PLACEHOLDER.matcher(configuration); + while (placeholderMatcher.find()) { + allPlaceholders.add(placeholderMatcher.group(1)); + if (placeholderMatcher.group(2) == null) { + requiredPlaceholders.add(placeholderMatcher.group(1)); + } + } + Matcher secretMatcher = SECRET_REFERENCE.matcher(configuration); + while (secretMatcher.find()) { + environmentSecretReferences.add(secretMatcher.group(1)); + } } Set applicationAppReferences = new TreeSet<>(); @@ -83,7 +91,7 @@ public final class EnvContractVerifier { failUnlessEmpty( difference(requiredPlaceholders, envKeys), - "application.yml references required env absent from src/.env.example: "); + "shipped configuration references required env absent from src/.env.example: "); List registryRows = parseRegistryRows(registryFile); Set registryAppKeys = new TreeSet<>(); @@ -106,7 +114,7 @@ public final class EnvContractVerifier { + "(registry is the SSOT for APP_ keys): "); failUnlessEmpty( difference(applicationAppReferences, registryAppKeys), - "application.yml references APP_ keys absent from docs/registries/env-keys.yaml " + "shipped configuration references APP_ keys absent from docs/registries/env-keys.yaml " + "(optional defaults and environment secret references are included): "); Set typedProperties = new TreeSet<>(); @@ -148,7 +156,6 @@ public final class EnvContractVerifier { " — remove the row or restore the property."); Set consumed = new TreeSet<>(applicationAppReferences); - consumed.addAll(envAppKeys); consumed.addAll(scanProductionSourceConsumers(productionSources)); Set unconsumed = new TreeSet<>(); @@ -166,7 +173,7 @@ public final class EnvContractVerifier { if (!unconsumedOwned.isEmpty()) { throw new IllegalStateException( "verifyEnvKeys: registered Redis keys that nothing reads — no typed property, no " - + "application.yml reference, no src/.env entry, no Java consumer, and not marked " + + "shipped-configuration reference, no production consumer, and not marked " + "deprecated_orphaned: " + unconsumedOwned + ". Wire the key to a consumer, or mark the row deprecated_orphaned with a " diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/config/VerifyEnvKeysTask.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/config/VerifyEnvKeysTask.java index ec72a7df..ca027522 100644 --- a/src/build-tools/src/main/java/dev/caskeleton/buildtools/config/VerifyEnvKeysTask.java +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/config/VerifyEnvKeysTask.java @@ -27,8 +27,9 @@ public abstract class VerifyEnvKeysTask extends DefaultTask { @InputFile public abstract RegularFileProperty getEnvFile(); - @InputFile - public abstract RegularFileProperty getApplicationYaml(); + @InputFiles + @PathSensitive(PathSensitivity.RELATIVE) + public abstract ConfigurableFileCollection getConfigurationFiles(); @InputFile public abstract RegularFileProperty getRegistryFile(); @@ -48,7 +49,7 @@ public abstract class VerifyEnvKeysTask extends DefaultTask { result = EnvContractVerifier.verify( getEnvFile().get().getAsFile(), - getApplicationYaml().get().getAsFile(), + getConfigurationFiles().getFiles(), getRegistryFile().get().getAsFile(), getProductionSources().getFiles(), List.of( diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/config/VerifyOperationalErrorRegistryTask.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/config/VerifyOperationalErrorRegistryTask.java new file mode 100644 index 00000000..2f409a58 --- /dev/null +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/config/VerifyOperationalErrorRegistryTask.java @@ -0,0 +1,156 @@ +package dev.caskeleton.buildtools.config; + +import java.io.IOException; +import java.io.UncheckedIOException; +import java.nio.charset.StandardCharsets; +import java.nio.file.Files; +import java.util.LinkedHashMap; +import java.util.Map; +import java.util.Set; +import java.util.TreeSet; +import java.util.regex.Matcher; +import java.util.regex.Pattern; +import org.gradle.api.DefaultTask; +import org.gradle.api.GradleException; +import org.gradle.api.file.RegularFileProperty; +import org.gradle.api.tasks.InputFile; +import org.gradle.api.tasks.TaskAction; +import org.gradle.work.DisableCachingByDefault; + +/** Keeps the skeleton-wide OperationalError enum and error-codes registry exactly aligned. */ +@DisableCachingByDefault(because = "Verification reads two small live repository contracts") +public abstract class VerifyOperationalErrorRegistryTask extends DefaultTask { + + private static final Pattern ENUM_ENTRY = + Pattern.compile( + "(?m)^\\s*([A-Z][A-Z0-9_]+)\\s*\\(Category\\.([A-Z_]+),\\s*(\\d+),\\s*(true|false)\\)"); + + @InputFile + public abstract RegularFileProperty getRegistryFile(); + + @InputFile + public abstract RegularFileProperty getOperationalErrorSource(); + + @TaskAction + public void verify() { + String registry = read(getRegistryFile().get().getAsFile().toPath()); + String source = read(getOperationalErrorSource().get().getAsFile().toPath()); + + Map code = parseEnum(source); + Map registered = parseRegistry(registry); + + TreeSet violations = new TreeSet<>(); + Set codeOnly = new TreeSet<>(code.keySet()); + codeOnly.removeAll(registered.keySet()); + if (!codeOnly.isEmpty()) { + violations.add("code-only OperationalError entries: " + codeOnly); + } + + Set registryOnly = new TreeSet<>(registered.keySet()); + registryOnly.removeAll(code.keySet()); + if (!registryOnly.isEmpty()) { + violations.add("registry-only operational entries: " + registryOnly); + } + + code.forEach( + (name, expected) -> { + Contract actual = registered.get(name); + if (actual != null && !actual.equals(expected)) { + violations.add( + name + + " metadata differs: code=" + + expected + + ", registry=" + + actual); + } + }); + + if (!violations.isEmpty()) { + throw new GradleException( + "verifyOperationalErrorRegistry: " + + violations.size() + + " violation(s):\n " + + String.join("\n ", violations)); + } + + getLogger() + .lifecycle( + "verifyOperationalErrorRegistry: OK — {} OperationalError entries match error-codes.yaml.", + code.size()); + } + + private static Map parseEnum(String source) { + Map result = new LinkedHashMap<>(); + Matcher matcher = ENUM_ENTRY.matcher(source); + while (matcher.find()) { + result.put( + matcher.group(1), + new Contract( + matcher.group(2), + Integer.parseInt(matcher.group(3)), + Boolean.parseBoolean(matcher.group(4)))); + } + if (result.isEmpty()) { + throw new GradleException("verifyOperationalErrorRegistry: no OperationalError constants found"); + } + return result; + } + + private static Map parseRegistry(String yaml) { + Map result = new LinkedHashMap<>(); + String current = null; + String category = null; + Integer status = null; + Boolean retryable = null; + + for (String raw : yaml.split("\\R")) { + String line = raw.trim(); + if (line.startsWith("- code:")) { + if (current != null) { + putRegistryRow(result, current, category, status, retryable); + } + current = line.substring("- code:".length()).trim(); + category = null; + status = null; + retryable = null; + } else if (current != null && line.startsWith("category:")) { + category = line.substring("category:".length()).trim(); + } else if (current != null && line.startsWith("http_status:")) { + status = Integer.valueOf(line.substring("http_status:".length()).trim()); + } else if (current != null && line.startsWith("retryable:")) { + retryable = Boolean.valueOf(line.substring("retryable:".length()).trim()); + } + } + if (current != null) { + putRegistryRow(result, current, category, status, retryable); + } + return result; + } + + private static void putRegistryRow( + Map result, + String code, + String category, + Integer status, + Boolean retryable) { + if (category == null || status == null || retryable == null) { + throw new GradleException( + "verifyOperationalErrorRegistry: incomplete registry row for " + code); + } + Contract previous = result.put(code, new Contract(category, status, retryable)); + if (previous != null) { + throw new GradleException( + "verifyOperationalErrorRegistry: duplicate registry code " + code); + } + } + + private static String read(java.nio.file.Path path) { + try { + return Files.readString(path, StandardCharsets.UTF_8); + } catch (IOException exception) { + throw new UncheckedIOException("failed to read " + path, exception); + } + } + + private record Contract(String category, int httpStatus, boolean retryable) {} +} diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/JpaAdopterApiSurfaceVerifier.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/JpaAdopterApiSurfaceVerifier.java new file mode 100644 index 00000000..eab32ea9 --- /dev/null +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/JpaAdopterApiSurfaceVerifier.java @@ -0,0 +1,57 @@ +package dev.caskeleton.buildtools.jpa; + +import java.io.IOException; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.Collection; +import java.util.Set; +import java.util.TreeSet; +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +final class JpaAdopterApiSurfaceVerifier { + + private static final String PREFIX = "dev.caskeleton.adapter.outbound.persistence."; + private static final Pattern IMPORT = + Pattern.compile("^\\s*import\\s+(" + Pattern.quote(PREFIX) + "[A-Za-z0-9_$.]+)\\s*;\\s*$"); + + private JpaAdopterApiSurfaceVerifier() {} + + static Set importedTypes(Collection sources) throws IOException { + Set imports = new TreeSet<>(); + for (Path source : sources) { + for (String line : Files.readAllLines(source)) { + Matcher matcher = IMPORT.matcher(line); + if (matcher.matches()) { + imports.add(matcher.group(1)); + } + } + } + return imports; + } + + static Set baselineTypes(Path baseline) throws IOException { + Set allowed = new TreeSet<>(); + for (String line : Files.readAllLines(baseline)) { + String value = line.trim(); + if (!value.isEmpty() && !value.startsWith("#")) { + allowed.add(value); + } + } + return allowed; + } + + static void verify(Collection sources, Path baseline) throws IOException { + Set imported = importedTypes(sources); + Set allowed = baselineTypes(baseline); + Set unexpected = new TreeSet<>(imported); + unexpected.removeAll(allowed); + if (!unexpected.isEmpty()) { + throw new IllegalStateException( + "JPA adopter API surface grew without review: " + + unexpected + + ". Add only intentionally supported adopter types to " + + baseline); + } + } +} diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/JpaEvidencePlugin.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/JpaEvidencePlugin.java index 8fa78cd3..dec2ed16 100644 --- a/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/JpaEvidencePlugin.java +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/JpaEvidencePlugin.java @@ -35,18 +35,24 @@ public final class JpaEvidencePlugin implements Plugin { "jpaEvidenceExecution", JpaEvidenceExecutionService.class, ignored -> {}); buildEventsListenerRegistry.onTaskCompletion(executionService); + TaskProvider verifySetConfigParameterBinding = + project + .getTasks() + .register( + "verifySetConfigParameterBinding", + VerifySetConfigParameterBindingTask.class, + task -> { + task.setGroup("verification"); + task.setDescription( + "Rejects non-parameterized PostgreSQL set_config values anywhere in this leaf."); + task.getMainSource() + .set(project.getLayout().getProjectDirectory().dir("src/main/java")); + }); + project .getTasks() - .register( - "verifyJpaSqlConstructionSafety", - VerifyJpaSqlConstructionSafetyTask.class, - task -> { - task.setGroup("verification"); - task.setDescription( - "Rejects non-parameterized PostgreSQL set_config values anywhere in this leaf."); - task.getMainSource() - .set(project.getLayout().getProjectDirectory().dir("src/main/java")); - }); + .matching(task -> task.getName().equals("check")) + .configureEach(task -> task.dependsOn(verifySetConfigParameterBinding)); TaskProvider generate = project diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/JpaQualificationPlugin.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/JpaQualificationPlugin.java index dcf43b4a..568b3e0f 100644 --- a/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/JpaQualificationPlugin.java +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/JpaQualificationPlugin.java @@ -14,55 +14,97 @@ public final class JpaQualificationPlugin implements Plugin { public void apply(Project project) { Project root = project.getRootProject(); TaskProvider releaseGateTasks = - project.getTasks().register( - "verifyJpaReleaseGateTasks", - VerifyJpaReleaseGateTasksTask.class, - task -> { - task.setGroup("verification"); - task.setDescription("Resolves every release-registry gate task against the real Gradle task graph."); - task.getRegistryFile().fileValue(root.file("config/jpa/release-registry.json")); - }); + project + .getTasks() + .register( + "verifyJpaReleaseGateTasks", + VerifyJpaReleaseGateTasksTask.class, + task -> { + task.setGroup("verification"); + task.setDescription( + "Resolves every release-registry gate task against the real Gradle task" + + " graph."); + task.getRegistryFile().fileValue(root.file("config/jpa/release-registry.json")); + }); TaskProvider releaseQualification = - project.getTasks().register( - "jpaReleaseQualification", - task -> { - task.setGroup("verification"); - task.setDescription( - "Runs exactly the blocking JPA release gates declared by config/jpa/release-registry.json."); - task.dependsOn(releaseGateTasks); - }); + project + .getTasks() + .register( + "jpaReleaseQualification", + task -> { + task.setGroup("verification"); + task.setDescription( + "Runs exactly the blocking JPA release gates declared by" + + " config/jpa/release-registry.json."); + task.dependsOn(releaseGateTasks); + }); TaskProvider readinessRegistry = - project.getTasks().register( - "verifyJpaReadinessRegistry", - VerifyJpaReadinessRegistryTask.class, - task -> { - task.setGroup("verification"); - task.setDescription("Validates the JPA readiness card, prerequisite, task, and migration registry."); - task.getRegistryFile().fileValue(root.file("config/jpa/readiness-cards.yaml")); + project + .getTasks() + .register( + "verifyJpaReadinessRegistry", + VerifyJpaReadinessRegistryTask.class, + task -> { + task.setGroup("verification"); + task.setDescription( + "Validates the JPA readiness card, prerequisite, task, and migration" + + " registry."); + task.getRegistryFile().fileValue(root.file("config/jpa/readiness-cards.yaml")); + }); + + TaskProvider adopterApiSurface = + project + .getTasks() + .register( + "verifyJpaAdopterApiSurface", + VerifyJpaAdopterApiSurfaceTask.class, + task -> { + task.setGroup("verification"); + task.setDescription( + "Rejects production imports of unsupported JPA persistence implementation" + + " types."); + task.getProductionSources() + .from( + root.fileTree( + ".", + tree -> { + tree.include("**/src/main/java/**/*.java"); + tree.exclude("**/build/**"); + tree.exclude("adapter/outbound/persistence-jpa/**"); + })); + task.getBaseline() + .fileValue(root.file("../docs/architecture/jpa-adopter-api-surface.txt")); + }); + + project + .getGradle() + .projectsEvaluated( + ignored -> { + JpaGradleTaskSnapshot snapshot = JpaGradleTaskSnapshot.capture(root); + releaseGateTasks.configure( + task -> { + task.getAvailableProjectPaths().set(snapshot.projectPaths()); + task.getAvailableTaskPaths().set(snapshot.taskPaths()); + task.getTestTaskPaths().set(snapshot.testTaskPaths()); + }); + readinessRegistry.configure( + task -> task.getAvailableTaskPaths().set(snapshot.taskPaths())); + root.project(":adapter:outbound:persistence-jpa") + .getTasks() + .named("check") + .configure(task -> task.dependsOn(adopterApiSurface)); + + JpaReleaseRegistry registry = readReleaseRegistry(root); + releaseQualification.configure( + task -> + task.dependsOn( + registry.gates().stream() + .filter(JpaReleaseGate::blocking) + .map(JpaReleaseGate::task) + .toList())); }); - - project.getGradle().projectsEvaluated( - ignored -> { - JpaGradleTaskSnapshot snapshot = JpaGradleTaskSnapshot.capture(root); - releaseGateTasks.configure(task -> { - task.getAvailableProjectPaths().set(snapshot.projectPaths()); - task.getAvailableTaskPaths().set(snapshot.taskPaths()); - task.getTestTaskPaths().set(snapshot.testTaskPaths()); - }); - readinessRegistry.configure( - task -> task.getAvailableTaskPaths().set(snapshot.taskPaths())); - - JpaReleaseRegistry registry = readReleaseRegistry(root); - releaseQualification.configure( - task -> - task.dependsOn( - registry.gates().stream() - .filter(JpaReleaseGate::blocking) - .map(JpaReleaseGate::task) - .toList())); - }); } private static JpaReleaseRegistry readReleaseRegistry(Project root) { diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/JpaSqlConstructionSafetyResult.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/JpaSqlConstructionSafetyResult.java deleted file mode 100644 index 279b6b4b..00000000 --- a/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/JpaSqlConstructionSafetyResult.java +++ /dev/null @@ -1,9 +0,0 @@ -package dev.caskeleton.buildtools.jpa; - -import java.util.List; - -public record JpaSqlConstructionSafetyResult(List violations) { - public JpaSqlConstructionSafetyResult { - violations = List.copyOf(violations); - } -} diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/SetConfigParameterBindingResult.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/SetConfigParameterBindingResult.java new file mode 100644 index 00000000..1ec718e9 --- /dev/null +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/SetConfigParameterBindingResult.java @@ -0,0 +1,9 @@ +package dev.caskeleton.buildtools.jpa; + +import java.util.List; + +public record SetConfigParameterBindingResult(List violations) { + public SetConfigParameterBindingResult { + violations = List.copyOf(violations); + } +} diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/JpaSqlConstructionSafetyVerifier.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/SetConfigParameterBindingVerifier.java similarity index 81% rename from src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/JpaSqlConstructionSafetyVerifier.java rename to src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/SetConfigParameterBindingVerifier.java index 075e38c0..e2f4110b 100644 --- a/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/JpaSqlConstructionSafetyVerifier.java +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/SetConfigParameterBindingVerifier.java @@ -8,13 +8,13 @@ import java.util.ArrayList; import java.util.Comparator; import java.util.List; -public final class JpaSqlConstructionSafetyVerifier { - private JpaSqlConstructionSafetyVerifier() {} +public final class SetConfigParameterBindingVerifier { + private SetConfigParameterBindingVerifier() {} - public static JpaSqlConstructionSafetyResult verify(File mainSource) { + public static SetConfigParameterBindingResult verify(File mainSource) { List violations = new ArrayList<>(); if (!mainSource.isDirectory()) { - return new JpaSqlConstructionSafetyResult(violations); + return new SetConfigParameterBindingResult(violations); } try (var paths = Files.walk(mainSource.toPath())) { for (var source : @@ -40,6 +40,6 @@ public final class JpaSqlConstructionSafetyVerifier { } catch (IOException exception) { throw new UncheckedIOException("cannot scan JPA source tree " + mainSource, exception); } - return new JpaSqlConstructionSafetyResult(violations); + return new SetConfigParameterBindingResult(violations); } } diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/VerifyJpaAdopterApiSurfaceTask.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/VerifyJpaAdopterApiSurfaceTask.java new file mode 100644 index 00000000..8e995475 --- /dev/null +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/VerifyJpaAdopterApiSurfaceTask.java @@ -0,0 +1,36 @@ +package dev.caskeleton.buildtools.jpa; + +import java.io.IOException; +import java.io.UncheckedIOException; +import java.nio.file.Path; +import java.util.List; +import org.gradle.api.DefaultTask; +import org.gradle.api.file.ConfigurableFileCollection; +import org.gradle.api.file.RegularFileProperty; +import org.gradle.api.tasks.InputFile; +import org.gradle.api.tasks.InputFiles; +import org.gradle.api.tasks.PathSensitive; +import org.gradle.api.tasks.PathSensitivity; +import org.gradle.api.tasks.TaskAction; + +public abstract class VerifyJpaAdopterApiSurfaceTask extends DefaultTask { + + @InputFiles + @PathSensitive(PathSensitivity.RELATIVE) + public abstract ConfigurableFileCollection getProductionSources(); + + @InputFile + @PathSensitive(PathSensitivity.RELATIVE) + public abstract RegularFileProperty getBaseline(); + + @TaskAction + void verify() { + List sources = + getProductionSources().getFiles().stream().map(file -> file.toPath()).sorted().toList(); + try { + JpaAdopterApiSurfaceVerifier.verify(sources, getBaseline().get().getAsFile().toPath()); + } catch (IOException exception) { + throw new UncheckedIOException("failed to verify JPA adopter API surface", exception); + } + } +} diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/VerifyJpaSqlConstructionSafetyTask.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/VerifySetConfigParameterBindingTask.java similarity index 65% rename from src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/VerifyJpaSqlConstructionSafetyTask.java rename to src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/VerifySetConfigParameterBindingTask.java index 2ff44af5..ac6e7178 100644 --- a/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/VerifyJpaSqlConstructionSafetyTask.java +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/jpa/VerifySetConfigParameterBindingTask.java @@ -8,24 +8,24 @@ import org.gradle.api.tasks.TaskAction; import org.gradle.work.DisableCachingByDefault; @DisableCachingByDefault(because = "Repository source verification emits no reusable output") -public abstract class VerifyJpaSqlConstructionSafetyTask extends DefaultTask { +public abstract class VerifySetConfigParameterBindingTask extends DefaultTask { @InputDirectory public abstract DirectoryProperty getMainSource(); @TaskAction - public void verifySqlConstruction() { - JpaSqlConstructionSafetyResult result = - JpaSqlConstructionSafetyVerifier.verify(getMainSource().get().getAsFile()); + public void verifySetConfigParameterBinding() { + SetConfigParameterBindingResult result = + SetConfigParameterBindingVerifier.verify(getMainSource().get().getAsFile()); if (!result.violations().isEmpty()) { throw new GradleException( - "verifyJpaSqlConstructionSafety: " + "verifySetConfigParameterBinding: " + result.violations().size() + " violation(s):\n " + String.join("\n ", result.violations())); } getLogger() .lifecycle( - "verifyJpaSqlConstructionSafety: OK — every set_config value in {} binds a parameter.", + "verifySetConfigParameterBinding: OK — every set_config value in {} binds a parameter.", getMainSource().get().getAsFile()); } } diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/messaging/VerifyMessagingCertificationEvidenceTask.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/messaging/VerifyMessagingCertificationEvidenceTask.java index 4c2897fb..fdaf352c 100644 --- a/src/build-tools/src/main/java/dev/caskeleton/buildtools/messaging/VerifyMessagingCertificationEvidenceTask.java +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/messaging/VerifyMessagingCertificationEvidenceTask.java @@ -34,9 +34,15 @@ public abstract class VerifyMessagingCertificationEvidenceTask extends DefaultTa unrecorded.removeAll(shipped); throw new GradleException( "the committed certification manifest does not match this run.\n" - + " claimed but not produced: " + display(unproven) + "\n" - + " produced but not claimed: " + display(unrecorded) + "\n" - + "Copy " + getProducedManifest().get().getAsFile() + " over " + + " claimed but not produced: " + + display(unproven) + + "\n" + + " produced but not claimed: " + + display(unrecorded) + + "\n" + + "Copy " + + getProducedManifest().get().getAsFile() + + " over " + getCommittedManifest().get().getAsFile() + " — the manifest is a record of a run, not a statement about one."); } @@ -44,13 +50,25 @@ public abstract class VerifyMessagingCertificationEvidenceTask extends DefaultTa Files.createDirectories(report.getParent()); Files.writeString( report, - "scenarios=" + ran.size() + " manifest=" + getCommittedManifest().get().getAsFile() + "\n", + "scenarios=" + + ran.size() + + " manifest=" + + getCommittedManifest().get().getAsFile() + + "\n", StandardCharsets.UTF_8); } catch (IOException failure) { throw new GradleException("failed to verify messaging certification evidence", failure); } } + /** + * Returns the behavioral claim identity used by the equality gate. + * + *

      {@code gitCommit} and {@code observedAt} remain in the evidence as provenance for audit and + * replay, but they are deliberately not equality keys: rerunning the same certified scenario on a + * later source revision/time should prove the same behavioral claim rather than manufacture a + * second scenario. Release provenance is recorded, not used as a freshness assertion. + */ private static Set normalizedClaims(java.nio.file.Path file) throws IOException { Set result = new LinkedHashSet<>(); for (String line : Files.readAllLines(file, StandardCharsets.UTF_8)) { diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/MongoIntegrationLaneTagVerifier.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/MongoIntegrationLaneTagVerifier.java new file mode 100644 index 00000000..f5e56559 --- /dev/null +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/MongoIntegrationLaneTagVerifier.java @@ -0,0 +1,43 @@ +package dev.caskeleton.buildtools.mongo; + +import java.io.IOException; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.Collection; +import java.util.LinkedHashSet; +import java.util.Set; +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +final class MongoIntegrationLaneTagVerifier { + + private static final Set LANE_TAGS = + Set.of( + "mongodb-replicaset", + "mongodb-failover", + "mongodb-migration", + "mongodb-compatibility", + "mongodb-security-integration"); + + private static final Pattern TAG = Pattern.compile("@Tag\\(\\s*\\\"([^\\\"]+)\\\"\\s*\\)"); + + private MongoIntegrationLaneTagVerifier() {} + + static void verify(Collection sources) throws IOException { + for (Path source : sources) { + String content = Files.readString(source); + Set laneTags = new LinkedHashSet<>(); + Matcher matcher = TAG.matcher(content); + while (matcher.find()) { + String tag = matcher.group(1); + if (LANE_TAGS.contains(tag)) { + laneTags.add(tag); + } + } + if (laneTags.size() > 1) { + throw new IllegalStateException( + source + " belongs to multiple Mongo integration lanes: " + laneTags); + } + } + } +} diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/MongoJUnitXml.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/MongoJUnitXml.java index abf187f0..0bb438cb 100644 --- a/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/MongoJUnitXml.java +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/MongoJUnitXml.java @@ -31,7 +31,12 @@ final class MongoJUnitXml { static SuiteCounts counts(File file) { Element suite = parse(file); - return new SuiteCounts(attribute(suite, "tests", file), attribute(suite, "skipped", file)); + return new SuiteCounts( + suite.getAttribute("name"), + attribute(suite, "tests", file), + attribute(suite, "skipped", file), + attribute(suite, "failures", file), + attribute(suite, "errors", file)); } private static Element parse(File file) { @@ -66,7 +71,7 @@ final class MongoJUnitXml { return Integer.parseInt(value); } - record SuiteCounts(int tests, int skipped) { + record SuiteCounts(String suiteName, int tests, int skipped, int failures, int errors) { int executed() { return tests - skipped; } diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/MongoReleaseContractLaneResult.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/MongoReleaseContractLaneResult.java index 9eb5ed5a..a21e8518 100644 --- a/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/MongoReleaseContractLaneResult.java +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/MongoReleaseContractLaneResult.java @@ -2,8 +2,11 @@ package dev.caskeleton.buildtools.mongo; import java.util.List; -public record MongoReleaseContractLaneResult(List checkedContractIds) { +public record MongoReleaseContractLaneResult( + List checkedContractIds, List externallyVerifiedContractIds) { + public MongoReleaseContractLaneResult { checkedContractIds = List.copyOf(checkedContractIds); + externallyVerifiedContractIds = List.copyOf(externallyVerifiedContractIds); } } diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/MongoReleaseContractLaneVerifier.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/MongoReleaseContractLaneVerifier.java index ce77555a..397ba71e 100644 --- a/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/MongoReleaseContractLaneVerifier.java +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/MongoReleaseContractLaneVerifier.java @@ -11,16 +11,19 @@ public final class MongoReleaseContractLaneVerifier { public static MongoReleaseContractLaneResult verify( File manifest, Set hermeticLanes, File resultsRoot) { List checked = new ArrayList<>(); - List wrongLane = new ArrayList<>(); + List externallyVerified = new ArrayList<>(); + List invalid = new ArrayList<>(); + for (MongoReleaseContract contract : MongoReleaseContractManifestParser.parse(manifest)) { if (!hermeticLanes.contains(contract.task())) { + externallyVerified.add(contract.id()); continue; } + File resultFile = - new File( - new File(resultsRoot, contract.task()), "TEST-" + contract.className() + ".xml"); + new File(new File(resultsRoot, contract.task()), "TEST-" + contract.className() + ".xml"); if (!resultFile.isFile()) { - wrongLane.add( + invalid.add( contract.id() + " names lane '" + contract.task() @@ -28,24 +31,44 @@ public final class MongoReleaseContractLaneVerifier { + contract.className()); continue; } - int executed = MongoJUnitXml.counts(resultFile).executed(); - if (executed < contract.minimumExecuted()) { - wrongLane.add( + + MongoJUnitXml.SuiteCounts counts = MongoJUnitXml.counts(resultFile); + if (!contract.className().equals(counts.suiteName())) { + invalid.add( + contract.id() + + " expected suite '" + + contract.className() + + "' but evidence names '" + + counts.suiteName() + + "'"); + } + if (counts.failures() != 0 || counts.errors() != 0) { + invalid.add( + contract.id() + + " evidence contains " + + counts.failures() + + " failure(s) and " + + counts.errors() + + " error(s)"); + } + if (counts.executed() < contract.minimumExecuted()) { + invalid.add( contract.id() + " requires " + contract.minimumExecuted() + " executed test(s) in '" + contract.task() + "' and the lane ran " - + executed); + + counts.executed()); } checked.add(contract.id()); } - if (!wrongLane.isEmpty()) { + + if (!invalid.isEmpty()) { throw new IllegalStateException( - "the Mongo release manifest points at lanes that cannot produce its evidence: " - + String.join("; ", wrongLane)); + "the Mongo release manifest points at invalid lane evidence: " + + String.join("; ", invalid)); } - return new MongoReleaseContractLaneResult(checked); + return new MongoReleaseContractLaneResult(checked, externallyVerified); } } diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/MongoVerificationPlugin.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/MongoVerificationPlugin.java index 6cdceb6a..a0ad0281 100644 --- a/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/MongoVerificationPlugin.java +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/MongoVerificationPlugin.java @@ -7,6 +7,31 @@ import org.gradle.api.Project; public final class MongoVerificationPlugin implements Plugin { @Override public void apply(Project project) { + var integrationLaneTags = + project + .getTasks() + .register( + "verifyMongoIntegrationLaneTags", + VerifyMongoIntegrationLaneTagsTask.class, + task -> { + task.setGroup("verification"); + task.setDescription( + "Fails when one Mongo integration test belongs to multiple Docker lanes."); + task.getSources() + .from( + project.fileTree( + "src/mongoIntegrationTest/java", tree -> tree.include("**/*.java"))); + }); + project + .getPluginManager() + .withPlugin( + "java", + ignored -> + project + .getTasks() + .named("check") + .configure(task -> task.dependsOn(integrationLaneTags))); + project .getTasks() .register( @@ -41,10 +66,12 @@ public final class MongoVerificationPlugin implements Plugin { task -> { task.setGroup("verification"); task.setDescription( - "Fails when a blocking release contract names a lane that did not run its class."); + "Fails when a blocking release contract names a lane that did not run its" + + " class."); task.dependsOn("test", "mongoStableContractTest"); task.getManifestFile() - .fileValue(project.getRootProject().file("config/mongodb/release-contracts.json")); + .fileValue( + project.getRootProject().file("config/mongodb/release-contracts.json")); task.getResultsRoot() .set(project.getLayout().getBuildDirectory().dir("test-results")); task.getHermeticLanes().convention(List.of("test", "mongoStableContractTest")); diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/VerifyMongoIntegrationLaneTagsTask.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/VerifyMongoIntegrationLaneTagsTask.java new file mode 100644 index 00000000..9d7ef3c2 --- /dev/null +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/VerifyMongoIntegrationLaneTagsTask.java @@ -0,0 +1,30 @@ +package dev.caskeleton.buildtools.mongo; + +import java.io.IOException; +import java.io.UncheckedIOException; +import java.nio.file.Path; +import java.util.List; +import org.gradle.api.DefaultTask; +import org.gradle.api.file.ConfigurableFileCollection; +import org.gradle.api.tasks.InputFiles; +import org.gradle.api.tasks.PathSensitive; +import org.gradle.api.tasks.PathSensitivity; +import org.gradle.api.tasks.TaskAction; + +public abstract class VerifyMongoIntegrationLaneTagsTask extends DefaultTask { + + @InputFiles + @PathSensitive(PathSensitivity.RELATIVE) + public abstract ConfigurableFileCollection getSources(); + + @TaskAction + void verify() { + List sources = + getSources().getFiles().stream().map(file -> file.toPath()).sorted().toList(); + try { + MongoIntegrationLaneTagVerifier.verify(sources); + } catch (IOException exception) { + throw new UncheckedIOException("failed to verify Mongo integration lane tags", exception); + } + } +} diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/VerifyMongoReleaseContractLanesTask.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/VerifyMongoReleaseContractLanesTask.java index d190a628..79468964 100644 --- a/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/VerifyMongoReleaseContractLanesTask.java +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/VerifyMongoReleaseContractLanesTask.java @@ -45,6 +45,8 @@ public abstract class VerifyMongoReleaseContractLanesTask extends DefaultTask { writeReport( "hermetic release contracts verified: " + String.join(", ", result.checkedContractIds()) + + "\nexternally verified release contracts: " + + String.join(", ", result.externallyVerifiedContractIds()) + "\n"); } diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/VerifyMongoTestLaneDisjointnessTask.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/VerifyMongoTestLaneDisjointnessTask.java index 36a8178c..f91c6ae3 100644 --- a/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/VerifyMongoTestLaneDisjointnessTask.java +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/mongo/VerifyMongoTestLaneDisjointnessTask.java @@ -8,6 +8,7 @@ import org.gradle.api.GradleException; import org.gradle.api.file.DirectoryProperty; import org.gradle.api.file.RegularFileProperty; import org.gradle.api.tasks.InputDirectory; +import org.gradle.api.tasks.Internal; import org.gradle.api.tasks.OutputFile; import org.gradle.api.tasks.TaskAction; import org.gradle.work.DisableCachingByDefault; @@ -17,7 +18,7 @@ public abstract class VerifyMongoTestLaneDisjointnessTask extends DefaultTask { @InputDirectory public abstract DirectoryProperty getUnitResults(); - @InputDirectory + @Internal public abstract DirectoryProperty getContractResults(); @OutputFile @@ -34,11 +35,7 @@ public abstract class VerifyMongoTestLaneDisjointnessTask extends DefaultTask { throw new GradleException(invalidEvidence.getMessage(), invalidEvidence); } writeReport( - "unit=" - + result.unitCount() - + " contract=" - + result.contractCount() - + " overlap=0\n"); + "unit=" + result.unitCount() + " contract=" + result.contractCount() + " overlap=0\n"); } private void writeReport(String report) { diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/notification/NotificationApiSurfacePlugin.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/notification/NotificationApiSurfacePlugin.java index c90f9eab..3555bb9d 100644 --- a/src/build-tools/src/main/java/dev/caskeleton/buildtools/notification/NotificationApiSurfacePlugin.java +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/notification/NotificationApiSurfacePlugin.java @@ -12,7 +12,7 @@ public final class NotificationApiSurfacePlugin implements Plugin { List sourceRoots = List.of( root.file( - "application-core/src/main/java/dev/caskeleton/application/notification"), + "application-notification/src/main/java/dev/caskeleton/application/notification"), root.file( "adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification")); File snapshot = root.file("../docs/notification/api-surface-snapshot.txt"); diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/notification/NotificationClaim.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/notification/NotificationClaim.java index e80202e0..664fe9d6 100644 --- a/src/build-tools/src/main/java/dev/caskeleton/buildtools/notification/NotificationClaim.java +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/notification/NotificationClaim.java @@ -4,10 +4,15 @@ import java.util.List; import java.util.Objects; public record NotificationClaim( - String name, NotificationClaimStatus status, List evidence) { + String name, NotificationClaimStatus status, List lanes, List evidence) { public NotificationClaim { Objects.requireNonNull(name, "name"); Objects.requireNonNull(status, "status"); - evidence = List.copyOf(evidence); + lanes = List.copyOf(Objects.requireNonNull(lanes, "lanes")); + evidence = List.copyOf(Objects.requireNonNull(evidence, "evidence")); + } + + public NotificationClaim(String name, NotificationClaimStatus status, List evidence) { + this(name, status, List.of(), evidence); } } diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/notification/NotificationEvidenceVerifier.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/notification/NotificationEvidenceVerifier.java index d9cec9d1..652993f5 100644 --- a/src/build-tools/src/main/java/dev/caskeleton/buildtools/notification/NotificationEvidenceVerifier.java +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/notification/NotificationEvidenceVerifier.java @@ -8,6 +8,7 @@ import java.nio.file.Files; import java.util.ArrayList; import java.util.HashSet; import java.util.List; +import java.util.Map; import java.util.Set; import tools.jackson.databind.JsonNode; import tools.jackson.databind.ObjectMapper; @@ -17,6 +18,20 @@ import tools.jackson.databind.json.JsonMapper; public final class NotificationEvidenceVerifier { private static final ObjectMapper JSON = JsonMapper.builder().build(); + private static final Map EVIDENCE_LANES = + Map.of( + ":adapter:outbound:persistence-jpa:jpaPlatformContractTest", + new EvidenceLane( + "adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/", + "@Tag(\"jpa-contract\")", + "build-logic/src/main/java/dev/caskeleton/buildlogic/jpa/JpaTestLanesPlugin.java", + List.of("jpaPlatformContractTest", "jpa-contract")), + ":adapter:outbound:notification:test", + new EvidenceLane( + "adapter/outbound/notification/src/test/java/", null, null, List.of()), + ":application-notification:test", + new EvidenceLane("application-notification/src/test/java/", null, null, List.of())); + private NotificationEvidenceVerifier() {} public static NotificationEvidenceResult verify( @@ -33,33 +48,32 @@ public final class NotificationEvidenceVerifier { for (NotificationClaim claim : manifest.claims()) { if (claim.status() == NotificationClaimStatus.SATISFIED) { if (claim.evidence().isEmpty()) { - problems.add( - "claim '" + claim.name() + "' is marked satisfied with no evidence at all"); + problems.add("claim '" + claim.name() + "' is marked satisfied with no evidence at all"); continue; } - List missing = - claim.evidence().stream() - .filter(path -> !new File(projectDirectory, path).isFile()) - .toList(); - if (missing.isEmpty()) { + if (claim.lanes().isEmpty()) { + problems.add("claim '" + claim.name() + "' is satisfied but declares no execution lane"); + continue; + } + List laneProblems = validateEvidenceLanes(claim, projectDirectory); + if (laneProblems.isEmpty()) { satisfied.add(claim.name()); } else { - problems.add( - "claim '" - + claim.name() - + "' names evidence that does not exist: " - + String.join(", ", missing)); + problems.addAll(laneProblems); } } else if (!claim.evidence().isEmpty()) { problems.add( "claim '" + claim.name() - + "' is not satisfied but names evidence; either the status or the evidence list is wrong"); + + "' is not satisfied but names evidence; either the status or the evidence list is" + + " wrong"); } } Set knownGrades = - manifest.grades().stream().map(NotificationGrade::name).collect(java.util.stream.Collectors.toSet()); + manifest.grades().stream() + .map(NotificationGrade::name) + .collect(java.util.stream.Collectors.toSet()); boolean insideTable = false; int gradeColumn = -1; int gradeAssigningTables = 0; @@ -134,19 +148,23 @@ public final class NotificationEvidenceVerifier { if (knownGrades.isEmpty()) { throw new IllegalStateException( - "verifyNotificationEvidence: the manifest defines no grades, so the check would pass whatever the support matrix claims."); + "verifyNotificationEvidence: the manifest defines no grades, so the check would pass" + + " whatever the support matrix claims."); } if (gradeAssigningTables == 0) { throw new IllegalStateException( "verifyNotificationEvidence: " + matrixFile.getName() - + " has no table that assigns a grade (a 'Grade' column that is not the first column), so no claim in it was checked."); + + " has no table that assigns a grade (a 'Grade' column that is not the first" + + " column), so no claim in it was checked."); } if (!problems.isEmpty()) { throw new IllegalStateException( "verifyNotificationEvidence: the support matrix claims more than the evidence proves.\n " + String.join("\n ", problems) - + "\nEither add the artifact and mark the claim satisfied, or lower the grade. A grade is a promise about production behaviour; the manifest is where it is kept."); + + "\n" + + "Either add the artifact and mark the claim satisfied, or lower the grade. A grade" + + " is a promise about production behaviour; the manifest is where it is kept."); } return new NotificationEvidenceResult(satisfied.size(), matrixFile.getName()); @@ -171,10 +189,16 @@ public final class NotificationEvidenceVerifier { entry -> { JsonNode value = entry.getValue(); String status = requiredText(value, "status"); + List lanes = stringArray(value.get("lanes")); + if (lanes.isEmpty()) { + String lane = optionalText(value, "lane"); + lanes = lane == null ? List.of() : List.of(lane); + } claims.add( new NotificationClaim( entry.getKey(), NotificationClaimStatus.parse(status), + lanes, stringArray(value.get("evidence")))); }); @@ -186,11 +210,104 @@ public final class NotificationEvidenceVerifier { gradesNode .properties() .forEach( - entry -> grades.add(new NotificationGrade(entry.getKey(), stringArray(entry.getValue())))); + entry -> + grades.add(new NotificationGrade(entry.getKey(), stringArray(entry.getValue())))); return new NotificationEvidenceManifest(matrixDocument, claims, grades); } + private static List validateEvidenceLanes( + NotificationClaim claim, File projectDirectory) { + List problems = new ArrayList<>(); + List lanes = new ArrayList<>(); + for (String laneName : claim.lanes()) { + EvidenceLane lane = EVIDENCE_LANES.get(laneName); + if (lane == null) { + problems.add("claim '" + claim.name() + "' names an unknown evidence lane: " + laneName); + continue; + } + if (lane.declarationPath() != null) { + File declaration = new File(projectDirectory, lane.declarationPath()); + if (!declaration.isFile()) { + problems.add( + "claim '" + + claim.name() + + "' names lane " + + laneName + + " but its declaration is missing: " + + lane.declarationPath()); + continue; + } + String declarationText = read(declaration); + List missingMarkers = + lane.declarationMarkers().stream() + .filter(marker -> !declarationText.contains(marker)) + .toList(); + if (!missingMarkers.isEmpty()) { + problems.add( + "claim '" + + claim.name() + + "' names lane " + + laneName + + " but its declaration no longer contains " + + String.join(", ", missingMarkers)); + continue; + } + } + lanes.add(lane); + } + + for (String path : claim.evidence()) { + File evidenceFile = new File(projectDirectory, path); + if (!evidenceFile.isFile()) { + problems.add("claim '" + claim.name() + "' names evidence that does not exist: " + path); + continue; + } + String source = read(evidenceFile); + if (source.isBlank()) { + problems.add("claim '" + claim.name() + "' names empty evidence: " + path); + continue; + } + boolean looksExecutable = + source.contains("@Test") + || source.contains("@ParameterizedTest") + || source.contains("@RepeatedTest") + || source.contains("@TestFactory"); + if (!looksExecutable) { + problems.add( + "claim '" + claim.name() + "' names evidence with no executable test: " + path); + continue; + } + boolean covered = + lanes.stream() + .anyMatch( + lane -> + path.startsWith(lane.sourcePrefix()) + && (lane.requiredSourceMarker() == null + || source.contains(lane.requiredSourceMarker()))); + if (!covered) { + problems.add( + "claim '" + + claim.name() + + "' names evidence not executed by any declared lane: " + + path); + } + } + return problems; + } + + private static String optionalText(JsonNode node, String field) { + JsonNode value = node == null ? null : node.get(field); + if (value == null || value.isNull()) { + return null; + } + if (!value.isString() || value.asText().isBlank()) { + throw new IllegalStateException( + "verifyNotificationEvidence: optional text field '" + field + "' is invalid"); + } + return value.asText(); + } + private static String requiredText(JsonNode node, String field) { JsonNode value = node == null ? null : node.get(field); if (value == null || !value.isString() || value.asText().isBlank()) { @@ -242,4 +359,14 @@ public final class NotificationEvidenceVerifier { throw new UncheckedIOException("failed to read " + file, exception); } } + + private record EvidenceLane( + String sourcePrefix, + String requiredSourceMarker, + String declarationPath, + List declarationMarkers) { + private EvidenceLane { + declarationMarkers = List.copyOf(declarationMarkers); + } + } } diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/notification/VerifyNotificationEvidenceTask.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/notification/VerifyNotificationEvidenceTask.java index 3fe79cf0..f3a5229b 100644 --- a/src/build-tools/src/main/java/dev/caskeleton/buildtools/notification/VerifyNotificationEvidenceTask.java +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/notification/VerifyNotificationEvidenceTask.java @@ -4,8 +4,8 @@ import org.gradle.api.DefaultTask; import org.gradle.api.GradleException; import org.gradle.api.file.DirectoryProperty; import org.gradle.api.file.RegularFileProperty; -import org.gradle.api.tasks.InputDirectory; import org.gradle.api.tasks.InputFile; +import org.gradle.api.tasks.Internal; import org.gradle.api.tasks.TaskAction; import org.gradle.work.DisableCachingByDefault; @@ -14,10 +14,10 @@ public abstract class VerifyNotificationEvidenceTask extends DefaultTask { @InputFile public abstract RegularFileProperty getManifestFile(); - @InputDirectory + @Internal public abstract DirectoryProperty getRepositoryDirectory(); - @InputDirectory + @Internal public abstract DirectoryProperty getProjectDirectory(); @TaskAction diff --git a/src/build-tools/src/main/java/dev/caskeleton/buildtools/notificationconfig/NotificationConfigurationVerifier.java b/src/build-tools/src/main/java/dev/caskeleton/buildtools/notificationconfig/NotificationConfigurationVerifier.java index c2884ec2..8f14e3c5 100644 --- a/src/build-tools/src/main/java/dev/caskeleton/buildtools/notificationconfig/NotificationConfigurationVerifier.java +++ b/src/build-tools/src/main/java/dev/caskeleton/buildtools/notificationconfig/NotificationConfigurationVerifier.java @@ -15,9 +15,21 @@ import java.util.regex.Pattern; public final class NotificationConfigurationVerifier { private static final Pattern PLACEHOLDER = - Pattern.compile("\\$\\{(APP_NOTIFICATION_PLATFORM_[A-Z0-9_]*)(:[^}]*)?}"); + Pattern.compile("\\$\\{(APP_NOTIFICATION_[A-Z0-9_]+)(:[^}]*)?}"); private static final Pattern REGISTERED = - Pattern.compile("^\\s*- name:\\s*(APP_NOTIFICATION_PLATFORM_[A-Z0-9_]+)\\s*$"); + Pattern.compile("^\\s*- name:\\s*((?:APP_NOTIFICATION|SPRING_MAIL)_[A-Z0-9_]+)\\s*$"); + + private static final Set SMTP_EXTERNAL_VARIABLES = + Set.of( + "SPRING_MAIL_HOST", + "SPRING_MAIL_PORT", + "SPRING_MAIL_USERNAME", + "SPRING_MAIL_PASSWORD", + "SPRING_MAIL_PROPERTIES_MAIL_SMTP_STARTTLS_ENABLE", + "SPRING_MAIL_PROPERTIES_MAIL_SMTP_STARTTLS_REQUIRED", + "SPRING_MAIL_PROPERTIES_MAIL_SMTP_CONNECTIONTIMEOUT", + "SPRING_MAIL_PROPERTIES_MAIL_SMTP_TIMEOUT", + "SPRING_MAIL_PROPERTIES_MAIL_SMTP_WRITETIMEOUT"); private NotificationConfigurationVerifier() {} @@ -64,21 +76,30 @@ public final class NotificationConfigurationVerifier { } } - List problems = - registeredVariables.stream() - .filter(variable -> !boundVariables.contains(variable)) - .map(variable -> variable + " is registered in env-keys.yaml and bound by nothing") - .toList(); + Set effectiveVariables = new TreeSet<>(boundVariables); + if (boundVariables.contains("APP_NOTIFICATION_PLATFORM_SMTP_ENABLED") + || registeredVariables.contains("APP_NOTIFICATION_PLATFORM_SMTP_ENABLED")) { + effectiveVariables.addAll(SMTP_EXTERNAL_VARIABLES); + } + + List problems = new ArrayList<>(); + registeredVariables.stream() + .filter(variable -> !effectiveVariables.contains(variable)) + .map(variable -> variable + " is registered in env-keys.yaml and bound/required by nothing") + .forEach(problems::add); + effectiveVariables.stream() + .filter(variable -> !registeredVariables.contains(variable)) + .map(variable -> variable + " is bound/required but missing from env-keys.yaml") + .forEach(problems::add); if (!problems.isEmpty()) { throw new IllegalStateException( - "verifyNotificationConfiguration: the env-key registry promises settings the binding " - + "does not have.\n " + "verifyNotificationConfiguration: notification environment ownership drifted.\n " + String.join("\n ", problems) - + "\nThe binding is the fact; the registry describes it."); + + "\nThe binding/runtime dependency is the fact; the registry describes it."); } return new NotificationConfiguration( - new ArrayList<>(registeredVariables), new ArrayList<>(boundVariables)); + new ArrayList<>(registeredVariables), new ArrayList<>(effectiveVariables)); } private static void requireFile(File file) { diff --git a/src/build-tools/src/test/java/dev/caskeleton/buildtools/config/EnvContractVerifierTest.java b/src/build-tools/src/test/java/dev/caskeleton/buildtools/config/EnvContractVerifierTest.java index e0f8d355..54765aed 100644 --- a/src/build-tools/src/test/java/dev/caskeleton/buildtools/config/EnvContractVerifierTest.java +++ b/src/build-tools/src/test/java/dev/caskeleton/buildtools/config/EnvContractVerifierTest.java @@ -19,7 +19,7 @@ class EnvContractVerifierTest { EnvContractResult result = EnvContractVerifier.verify( fixture.envFile().toFile(), - fixture.applicationYaml().toFile(), + List.of(fixture.applicationYaml().toFile()), fixture.registry().toFile(), List.of(), List.of(new MetadataScope("app.redis.", fixture.redisMetadata().toFile())), @@ -46,7 +46,7 @@ class EnvContractVerifierTest { () -> EnvContractVerifier.verify( fixture.envFile().toFile(), - fixture.applicationYaml().toFile(), + List.of(fixture.applicationYaml().toFile()), fixture.registry().toFile(), List.of(), List.of(new MetadataScope("app.redis.", fixture.redisMetadata().toFile())), @@ -56,6 +56,80 @@ class EnvContractVerifierTest { assertTrue(failure.getMessage().contains("app.redis.port")); } + @Test + void envExamplePresenceDoesNotCountAsRuntimeConsumption(@TempDir Path temp) throws Exception { + Fixture fixture = fixture(temp); + Files.writeString( + fixture.envFile(), + Files.readString(fixture.envFile()) + "APP_REDIS_UNUSED=present-but-unread\n"); + Files.writeString( + fixture.registry(), + Files.readString(fixture.registry()) + + "- name: APP_REDIS_UNUSED\n" + + " type: string\n" + + " default: null\n"); + + IllegalStateException failure = + assertThrows( + IllegalStateException.class, + () -> + EnvContractVerifier.verify( + fixture.envFile().toFile(), + List.of(fixture.applicationYaml().toFile()), + fixture.registry().toFile(), + List.of(), + List.of(new MetadataScope("app.redis.", fixture.redisMetadata().toFile())), + List.of("APP_REDIS_"))); + + assertTrue(failure.getMessage().contains("registered Redis keys that nothing reads")); + assertTrue(failure.getMessage().contains("APP_REDIS_UNUSED")); + } + + @Test + void secondaryConfigurationReferenceMustBeRegistered(@TempDir Path temp) throws Exception { + Fixture fixture = fixture(temp); + Path secondary = fixture.repositoryRoot().resolve("app-bootstrap/src/main/resources/config/runtime.yml"); + Files.createDirectories(secondary.getParent()); + Files.writeString(secondary, "runtime: ${APP_SECONDARY_ONLY:false}\n"); + IllegalStateException failure = + assertThrows( + IllegalStateException.class, + () -> + EnvContractVerifier.verify( + fixture.envFile().toFile(), + List.of(fixture.applicationYaml().toFile(), secondary.toFile()), + fixture.registry().toFile(), + List.of(), + List.of(new MetadataScope("app.redis.", fixture.redisMetadata().toFile())), + List.of("APP_REDIS_"))); + + assertTrue(failure.getMessage().contains("shipped configuration references APP_ keys")); + assertTrue(failure.getMessage().contains("APP_SECONDARY_ONLY")); + } + + @Test + void secondaryRequiredPlaceholderMustAppearInExample(@TempDir Path temp) throws Exception { + Fixture fixture = fixture(temp); + Path secondary = fixture.repositoryRoot().resolve("app-bootstrap/src/main/resources/config/security.yml"); + Files.createDirectories(secondary.getParent()); + Files.writeString(secondary, "secret: ${APP_REQUIRED_SECONDARY}\n"); + + IllegalStateException failure = + assertThrows( + IllegalStateException.class, + () -> + EnvContractVerifier.verify( + fixture.envFile().toFile(), + List.of(fixture.applicationYaml().toFile(), secondary.toFile()), + fixture.registry().toFile(), + List.of(), + List.of(new MetadataScope("app.redis.", fixture.redisMetadata().toFile())), + List.of("APP_REDIS_"))); + + assertTrue(failure.getMessage().contains("required env absent from src/.env.example")); + assertTrue(failure.getMessage().contains("APP_REQUIRED_SECONDARY")); + } + @Test void requiredPlaceholderMissingFromExampleFails(@TempDir Path temp) throws Exception { Fixture fixture = fixture(temp); @@ -67,7 +141,7 @@ class EnvContractVerifierTest { () -> EnvContractVerifier.verify( fixture.envFile().toFile(), - fixture.applicationYaml().toFile(), + List.of(fixture.applicationYaml().toFile()), fixture.registry().toFile(), List.of(), List.of(new MetadataScope("app.redis.", fixture.redisMetadata().toFile())), @@ -82,7 +156,7 @@ class EnvContractVerifierTest { Path docsRoot = temp.resolve("repository/docs/registries"); Files.createDirectories(repositoryRoot.resolve("app-bootstrap/src/main/resources")); Files.createDirectories( - repositoryRoot.resolve("adapter/outbound/cache-redis/build/classes/java/main/META-INF")); + repositoryRoot.resolve("adapter/outbound/redis-runtime/build/classes/java/main/META-INF")); Files.createDirectories(docsRoot); Path envFile = repositoryRoot.resolve(".env.example"); @@ -90,7 +164,7 @@ class EnvContractVerifierTest { Path registry = docsRoot.resolve("env-keys.yaml"); Path metadata = repositoryRoot.resolve( - "adapter/outbound/cache-redis/build/classes/java/main/META-INF/spring-configuration-metadata.json"); + "adapter/outbound/redis-runtime/build/classes/java/main/META-INF/spring-configuration-metadata.json"); Files.writeString(envFile, "APP_REQUIRED=required\nAPP_REDIS_HOST=localhost\n"); Files.writeString( diff --git a/src/build-tools/src/test/java/dev/caskeleton/buildtools/config/VerifyEnvKeysTaskTypeTest.java b/src/build-tools/src/test/java/dev/caskeleton/buildtools/config/VerifyEnvKeysTaskTypeTest.java index b2891801..f6a786c3 100644 --- a/src/build-tools/src/test/java/dev/caskeleton/buildtools/config/VerifyEnvKeysTaskTypeTest.java +++ b/src/build-tools/src/test/java/dev/caskeleton/buildtools/config/VerifyEnvKeysTaskTypeTest.java @@ -12,6 +12,12 @@ class VerifyEnvKeysTaskTypeTest { assertEquals( ConfigurableFileCollection.class, VerifyEnvKeysTask.class.getMethod("getProductionSources").getReturnType()); + assertEquals( + ConfigurableFileCollection.class, + VerifyEnvKeysTask.class.getMethod("getConfigurationFiles").getReturnType()); + assertThrows( + NoSuchMethodException.class, + () -> VerifyEnvKeysTask.class.getMethod("getApplicationYaml")); assertThrows( NoSuchMethodException.class, () -> VerifyEnvKeysTask.class.getMethod("getRepositoryRoot")); diff --git a/src/build-tools/src/test/java/dev/caskeleton/buildtools/jpa/JpaAdopterApiSurfaceVerifierTest.java b/src/build-tools/src/test/java/dev/caskeleton/buildtools/jpa/JpaAdopterApiSurfaceVerifierTest.java new file mode 100644 index 00000000..7418a16e --- /dev/null +++ b/src/build-tools/src/test/java/dev/caskeleton/buildtools/jpa/JpaAdopterApiSurfaceVerifierTest.java @@ -0,0 +1,38 @@ +package dev.caskeleton.buildtools.jpa; + +import static org.junit.jupiter.api.Assertions.assertDoesNotThrow; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.List; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.io.TempDir; + +class JpaAdopterApiSurfaceVerifierTest { + + @Test + void allowsOnlyReviewedPersistenceImports(@TempDir Path temp) throws Exception { + Path source = temp.resolve("Consumer.java"); + Files.writeString( + source, + "import dev.caskeleton.adapter.outbound.persistence.api.capability.JpaCapability;\n"); + Path baseline = temp.resolve("surface.txt"); + Files.writeString( + baseline, "dev.caskeleton.adapter.outbound.persistence.api.capability.JpaCapability\n"); + + assertDoesNotThrow(() -> JpaAdopterApiSurfaceVerifier.verify(List.of(source), baseline)); + + Files.writeString( + source, + "import dev.caskeleton.adapter.outbound.persistence.api.capability.JpaCapability;\n" + + "import dev.caskeleton.adapter.outbound.persistence.internal.HiddenType;\n"); + + IllegalStateException failure = + assertThrows( + IllegalStateException.class, + () -> JpaAdopterApiSurfaceVerifier.verify(List.of(source), baseline)); + assertTrue(failure.getMessage().contains("internal.HiddenType")); + } +} diff --git a/src/build-tools/src/test/java/dev/caskeleton/buildtools/jpa/JpaSqlConstructionSafetyVerifierTest.java b/src/build-tools/src/test/java/dev/caskeleton/buildtools/jpa/SetConfigParameterBindingVerifierTest.java similarity index 81% rename from src/build-tools/src/test/java/dev/caskeleton/buildtools/jpa/JpaSqlConstructionSafetyVerifierTest.java rename to src/build-tools/src/test/java/dev/caskeleton/buildtools/jpa/SetConfigParameterBindingVerifierTest.java index 0b4188e6..d6c79cc4 100644 --- a/src/build-tools/src/test/java/dev/caskeleton/buildtools/jpa/JpaSqlConstructionSafetyVerifierTest.java +++ b/src/build-tools/src/test/java/dev/caskeleton/buildtools/jpa/SetConfigParameterBindingVerifierTest.java @@ -8,12 +8,12 @@ import java.nio.file.Path; import org.junit.jupiter.api.Test; import org.junit.jupiter.api.io.TempDir; -class JpaSqlConstructionSafetyVerifierTest { +class SetConfigParameterBindingVerifierTest { @Test void parameterizedSetConfigIsAccepted(@TempDir Path temp) throws Exception { write(temp.resolve("Safe.java"), "jdbc.query(\"select set_config('app.tenant_id', ?, true)\");\n"); - JpaSqlConstructionSafetyResult result = JpaSqlConstructionSafetyVerifier.verify(temp.toFile()); + SetConfigParameterBindingResult result = SetConfigParameterBindingVerifier.verify(temp.toFile()); assertTrue(result.violations().isEmpty()); } @@ -28,7 +28,7 @@ class JpaSqlConstructionSafetyVerifierTest { + " String sql = \"select set_config('app.tenant_id', 'literal', true)\";\n" + "}\n"); - JpaSqlConstructionSafetyResult result = JpaSqlConstructionSafetyVerifier.verify(temp.toFile()); + SetConfigParameterBindingResult result = SetConfigParameterBindingVerifier.verify(temp.toFile()); assertEquals(1, result.violations().size()); assertTrue(result.violations().getFirst().contains("Unsafe.java:3: set_config value is not parameterized")); @@ -42,7 +42,7 @@ class JpaSqlConstructionSafetyVerifierTest { + "/* set_config('tenant', 'literal', true) */\n" + " * set_config('tenant', 'literal', true)\n"); - JpaSqlConstructionSafetyResult result = JpaSqlConstructionSafetyVerifier.verify(temp.toFile()); + SetConfigParameterBindingResult result = SetConfigParameterBindingVerifier.verify(temp.toFile()); assertTrue(result.violations().isEmpty()); } diff --git a/src/build-tools/src/test/java/dev/caskeleton/buildtools/mongo/MongoIntegrationLaneTagVerifierTest.java b/src/build-tools/src/test/java/dev/caskeleton/buildtools/mongo/MongoIntegrationLaneTagVerifierTest.java new file mode 100644 index 00000000..0820317e --- /dev/null +++ b/src/build-tools/src/test/java/dev/caskeleton/buildtools/mongo/MongoIntegrationLaneTagVerifierTest.java @@ -0,0 +1,46 @@ +package dev.caskeleton.buildtools.mongo; + +import static org.junit.jupiter.api.Assertions.assertDoesNotThrow; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.List; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.io.TempDir; + +class MongoIntegrationLaneTagVerifierTest { + + @Test + void rejectsOneTestClassAssignedToTwoDockerLanes(@TempDir Path temp) throws Exception { + Path source = temp.resolve("DuplicateLaneTest.java"); + Files.writeString( + source, + """ + import org.junit.jupiter.api.Tag; + @Tag("mongodb-failover") + @Tag("mongodb-replicaset") + class DuplicateLaneTest {} + """); + + IllegalStateException failure = + assertThrows( + IllegalStateException.class, + () -> MongoIntegrationLaneTagVerifier.verify(List.of(source))); + + assertTrue(failure.getMessage().contains("multiple Mongo integration lanes")); + } + + @Test + void acceptsOneIntegrationLanePerSource(@TempDir Path temp) throws Exception { + Path first = temp.resolve("FailoverTest.java"); + Path second = temp.resolve("MigrationTest.java"); + Files.writeString( + first, "@org.junit.jupiter.api.Tag(\"mongodb-failover\") class FailoverTest {}"); + Files.writeString( + second, "@org.junit.jupiter.api.Tag(\"mongodb-migration\") class MigrationTest {}"); + + assertDoesNotThrow(() -> MongoIntegrationLaneTagVerifier.verify(List.of(first, second))); + } +} diff --git a/src/build-tools/src/test/java/dev/caskeleton/buildtools/mongo/MongoReleaseContractLaneVerifierTest.java b/src/build-tools/src/test/java/dev/caskeleton/buildtools/mongo/MongoReleaseContractLaneVerifierTest.java index d463d4cc..b1701cdf 100644 --- a/src/build-tools/src/test/java/dev/caskeleton/buildtools/mongo/MongoReleaseContractLaneVerifierTest.java +++ b/src/build-tools/src/test/java/dev/caskeleton/buildtools/mongo/MongoReleaseContractLaneVerifierTest.java @@ -12,7 +12,8 @@ import org.junit.jupiter.api.io.TempDir; class MongoReleaseContractLaneVerifierTest { @Test - void verifiesOnlyContractsOwnedByHermeticLanes(@TempDir Path temp) throws Exception { + void reportsHermeticAndExternallyVerifiedContractsSeparately(@TempDir Path temp) + throws Exception { Path manifest = temp.resolve("release-contracts.json"); Files.writeString( manifest, @@ -24,14 +25,15 @@ class MongoReleaseContractLaneVerifierTest { ]} """); Path results = Files.createDirectories(temp.resolve("results")); - writeSuite(results, "test", "a.Unit", 1, 0); - writeSuite(results, "mongoStableContractTest", "a.Contract", 3, 1); + writeSuite(results, "test", "a.Unit", "a.Unit", 1, 0, 0, 0); + writeSuite(results, "mongoStableContractTest", "a.Contract", "a.Contract", 3, 1, 0, 0); MongoReleaseContractLaneResult result = MongoReleaseContractLaneVerifier.verify( manifest.toFile(), Set.of("test", "mongoStableContractTest"), results.toFile()); assertEquals(java.util.List.of("C-1", "C-2"), result.checkedContractIds()); + assertEquals(java.util.List.of("C-3"), result.externallyVerifiedContractIds()); } @Test @@ -46,15 +48,32 @@ class MongoReleaseContractLaneVerifierTest { MongoReleaseContractLaneVerifier.verify( manifest.toFile(), Set.of("mongoStableContractTest"), results.toFile())); - assertTrue(failure.getMessage().contains("C-MISSING names lane 'mongoStableContractTest'")); + assertTrue(failure.getMessage().contains("C-MISSING")); assertTrue(failure.getMessage().contains("a.Missing")); } + @Test + void failedOrMisnamedSuiteIsRejected(@TempDir Path temp) throws Exception { + Path manifest = manifest(temp, "C-FAIL", "mongoStableContractTest", "a.Contract", 1); + Path results = Files.createDirectories(temp.resolve("results")); + writeSuite(results, "mongoStableContractTest", "a.Contract", "a.Other", 2, 0, 1, 0); + + IllegalStateException failure = + assertThrows( + IllegalStateException.class, + () -> + MongoReleaseContractLaneVerifier.verify( + manifest.toFile(), Set.of("mongoStableContractTest"), results.toFile())); + + assertTrue(failure.getMessage().contains("expected suite 'a.Contract'")); + assertTrue(failure.getMessage().contains("1 failure(s)")); + } + @Test void insufficientExecutedCountFails(@TempDir Path temp) throws Exception { Path manifest = manifest(temp, "C-MIN", "mongoStableContractTest", "a.Contract", 3); Path results = Files.createDirectories(temp.resolve("results")); - writeSuite(results, "mongoStableContractTest", "a.Contract", 4, 2); + writeSuite(results, "mongoStableContractTest", "a.Contract", "a.Contract", 4, 2, 0, 0); IllegalStateException failure = assertThrows( @@ -85,14 +104,28 @@ class MongoReleaseContractLaneVerifierTest { } private static void writeSuite( - Path resultsRoot, String task, String className, int tests, int skipped) throws Exception { + Path resultsRoot, + String task, + String fileClassName, + String suiteName, + int tests, + int skipped, + int failures, + int errors) + throws Exception { Path lane = Files.createDirectories(resultsRoot.resolve(task)); Files.writeString( - lane.resolve("TEST-" + className + ".xml"), - "\n"); + + "\" failures=\"" + + failures + + "\" errors=\"" + + errors + + "\"/>\n"); } } diff --git a/src/build-tools/src/test/java/dev/caskeleton/buildtools/notification/NotificationEvidenceVerifierTest.java b/src/build-tools/src/test/java/dev/caskeleton/buildtools/notification/NotificationEvidenceVerifierTest.java index f4a2f711..4e6a4e16 100644 --- a/src/build-tools/src/test/java/dev/caskeleton/buildtools/notification/NotificationEvidenceVerifierTest.java +++ b/src/build-tools/src/test/java/dev/caskeleton/buildtools/notification/NotificationEvidenceVerifierTest.java @@ -47,7 +47,8 @@ class NotificationEvidenceVerifierTest { fixture.repositoryRoot().toFile(), fixture.projectRoot().toFile())); - assertTrue(failure.getMessage().contains("claim 'delivery' is marked satisfied with no evidence")); + assertTrue( + failure.getMessage().contains("claim 'delivery' is marked satisfied with no evidence")); } @Test @@ -128,12 +129,16 @@ class NotificationEvidenceVerifierTest { Path docs = repositoryRoot.resolve("docs/notification"); Files.createDirectories(docs); Path evidence = - projectRoot.resolve("adapter/outbound/notification/src/test/java/DeliveryContractTest.java"); + projectRoot.resolve( + "adapter/outbound/notification/src/test/java/DeliveryContractTest.java"); Files.createDirectories(evidence.getParent()); Path manifest = docs.resolve("evidence-manifest.json"); Path matrix = docs.resolve("support-matrix.md"); - Files.writeString(evidence, "final class DeliveryContractTest {}\n"); + Files.writeString( + evidence, + "final class DeliveryContractTest { @Test void provesDelivery() {}" + + " }\n"); Files.writeString( manifest, """ @@ -142,6 +147,7 @@ class NotificationEvidenceVerifierTest { "claims": { "delivery": { "status": "satisfied", + "lane": ":adapter:outbound:notification:test", "evidence": ["adapter/outbound/notification/src/test/java/DeliveryContractTest.java"] } }, @@ -158,6 +164,5 @@ class NotificationEvidenceVerifierTest { return new Fixture(repositoryRoot, projectRoot, manifest, matrix); } - private record Fixture( - Path repositoryRoot, Path projectRoot, Path manifest, Path matrix) {} + private record Fixture(Path repositoryRoot, Path projectRoot, Path manifest, Path matrix) {} } diff --git a/src/build-tools/src/test/java/dev/caskeleton/buildtools/notificationconfig/NotificationConfigurationVerifierTest.java b/src/build-tools/src/test/java/dev/caskeleton/buildtools/notificationconfig/NotificationConfigurationVerifierTest.java index 0c2c2762..214c2c9d 100644 --- a/src/build-tools/src/test/java/dev/caskeleton/buildtools/notificationconfig/NotificationConfigurationVerifierTest.java +++ b/src/build-tools/src/test/java/dev/caskeleton/buildtools/notificationconfig/NotificationConfigurationVerifierTest.java @@ -31,11 +31,13 @@ class NotificationConfigurationVerifierTest { NotificationConfiguration result = NotificationConfigurationVerifier.verify( - application.toFile(), config.toFile(), registry.toFile(), "app-bootstrap/src/main/resources"); + application.toFile(), + config.toFile(), + registry.toFile(), + "app-bootstrap/src/main/resources"); assertEquals( - java.util.List.of( - "APP_NOTIFICATION_PLATFORM_ENABLED", "APP_NOTIFICATION_PLATFORM_SENDER"), + java.util.List.of("APP_NOTIFICATION_PLATFORM_ENABLED", "APP_NOTIFICATION_PLATFORM_SENDER"), result.registeredVariables()); } @@ -62,7 +64,56 @@ class NotificationConfigurationVerifierTest { registry.toFile(), "app-bootstrap/src/main/resources")); assertTrue(failure.getMessage().contains("APP_NOTIFICATION_PLATFORM_UNUSED is registered")); - assertTrue(failure.getMessage().contains("bound by nothing")); + assertTrue(failure.getMessage().contains("bound/required by nothing")); + } + + @Test + void boundButUnregisteredKeyFails(@TempDir Path temp) throws Exception { + Path resources = temp.resolve("resources"); + Files.createDirectories(resources.resolve("config")); + Path application = resources.resolve("application.yml"); + Path registry = temp.resolve("env-keys.yaml"); + + Files.writeString( + application, + "enabled: ${APP_NOTIFICATION_PLATFORM_ENABLED:false}\n" + + "sender: ${APP_NOTIFICATION_PLATFORM_SENDER:no-reply}\n"); + Files.writeString(registry, "- name: APP_NOTIFICATION_PLATFORM_ENABLED\n"); + + IllegalStateException failure = + assertThrows( + IllegalStateException.class, + () -> + NotificationConfigurationVerifier.verify( + application.toFile(), + resources.resolve("config").toFile(), + registry.toFile(), + "app-bootstrap/src/main/resources")); + assertTrue(failure.getMessage().contains("APP_NOTIFICATION_PLATFORM_SENDER")); + assertTrue(failure.getMessage().contains("missing from env-keys.yaml")); + } + + @Test + void smtpTransportDependenciesMustBeRegistered(@TempDir Path temp) throws Exception { + Path resources = temp.resolve("resources"); + Files.createDirectories(resources.resolve("config")); + Path application = resources.resolve("application.yml"); + Path registry = temp.resolve("env-keys.yaml"); + + Files.writeString(application, "enabled: ${APP_NOTIFICATION_PLATFORM_SMTP_ENABLED:false}\n"); + Files.writeString(registry, "- name: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED\n"); + + IllegalStateException failure = + assertThrows( + IllegalStateException.class, + () -> + NotificationConfigurationVerifier.verify( + application.toFile(), + resources.resolve("config").toFile(), + registry.toFile(), + "app-bootstrap/src/main/resources")); + assertTrue(failure.getMessage().contains("SPRING_MAIL_HOST")); + assertTrue(failure.getMessage().contains("missing from env-keys.yaml")); } @Test diff --git a/src/build.gradle b/src/build.gradle index 6a46d370..2d907c11 100644 --- a/src/build.gradle +++ b/src/build.gradle @@ -99,8 +99,9 @@ tasks.register('qualityCheck') { tasks.register('configContractCheck') { group = 'verification' - description = 'Runs the environment configuration contract owned by the composition root.' + description = 'Runs environment and operational error registry contracts owned by the composition root.' dependsOn ':app-bootstrap:verifyEnvKeys' + dependsOn ':app-bootstrap:verifyOperationalErrorRegistry' } tasks.register('integrationCheck') { @@ -126,6 +127,12 @@ tasks.register('qualificationCheck') { dependsOn leafPaths.collect { "${it}:auxiliaryStyleCheck" } } +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' +} + tasks.register('ci') { group = 'verification' description = 'The pull-request gate: every production CI leaf check plus the repository-wide gates.' @@ -134,6 +141,7 @@ tasks.register('ci') { dependsOn tasks.named('qualityCheck') dependsOn tasks.named('configContractCheck') dependsOn tasks.named('qualificationCheck') + dependsOn tasks.named('sampleWebContractCheck') } tasks.register('releaseCheck') { diff --git a/src/config/architecture/README.md b/src/config/architecture/README.md new file mode 100644 index 00000000..07a8d32b --- /dev/null +++ b/src/config/architecture/README.md @@ -0,0 +1,13 @@ +# Architecture module registry + +`modules.json` records Gradle project identity and the exact production project edges each leaf may +see. An empty `allowed_dependencies` list is meaningful: it means the leaf is intentionally +project-standalone, not that the registry entry is unfinished. + +`adapter-outbound-persistence-mongo` is the important example. That leaf owns the Mongo provider +implementation without importing application/domain project types; composition into application +ports is owned by the bootstrap/autoconfiguration side. Its empty dependency list is therefore an +explicit boundary and must remain empty until a real project edge is introduced and reviewed. + +Runtime composition membership is derived from resolved runtime classpaths by the build logic; it is +not duplicated as a per-module field in this registry. diff --git a/src/config/architecture/modules.json b/src/config/architecture/modules.json index 2231c1da..01c5e293 100644 --- a/src/config/architecture/modules.json +++ b/src/config/architecture/modules.json @@ -21,6 +21,31 @@ "shared-contract" ] }, + { + "id": "application-notification", + "gradle_path": ":application-notification", + "source_path": "src/application-notification", + "allowed_dependencies": [ + "application-core" + ] + }, + { + "id": "application-fileserver", + "gradle_path": ":application-fileserver", + "source_path": "src/application-fileserver", + "allowed_dependencies": [ + "application-core", + "shared-contract" + ] + }, + { + "id": "application-objectstorage", + "gradle_path": ":application-objectstorage", + "source_path": "src/application-objectstorage", + "allowed_dependencies": [ + "application-core" + ] + }, { "id": "adapter-outbound-support", "gradle_path": ":adapter:outbound:support", @@ -38,7 +63,9 @@ "allowed_dependencies": [ "domain-core", "application-core", - "shared-contract" + "shared-contract", + "application-notification", + "application-fileserver" ] }, { @@ -53,7 +80,8 @@ "source_path": "src/adapter/outbound/identifier", "allowed_dependencies": [ "domain-core", - "application-core" + "application-core", + "application-fileserver" ] }, { @@ -62,7 +90,8 @@ "source_path": "src/adapter/outbound/fileserver", "allowed_dependencies": [ "application-core", - "shared-contract" + "shared-contract", + "application-fileserver" ] }, { @@ -71,7 +100,22 @@ "source_path": "src/adapter/outbound/objectstorage", "allowed_dependencies": [ "application-core", - "shared-contract" + "shared-contract", + "application-objectstorage" + ] + }, + { + "id": "adapter-outbound-redis-runtime", + "gradle_path": ":adapter:outbound:redis-runtime", + "source_path": "src/adapter/outbound/redis-runtime", + "allowed_dependencies": [] + }, + { + "id": "adapter-outbound-redis-sdk", + "gradle_path": ":adapter:outbound:redis-sdk", + "source_path": "src/adapter/outbound/redis-sdk", + "allowed_dependencies": [ + "adapter-outbound-redis-runtime" ] }, { @@ -82,7 +126,8 @@ "domain-core", "application-core", "shared-contract", - "adapter-outbound-support" + "adapter-outbound-support", + "adapter-outbound-redis-runtime" ] }, { @@ -109,15 +154,23 @@ "messaging-schema-api" ] }, + { + "id": "adapter-outbound-messaging-kafka", + "gradle_path": ":adapter:outbound:messaging-kafka", + "source_path": "src/adapter/outbound/messaging-kafka", + "allowed_dependencies": [ + "adapter-outbound-messaging" + ] + }, { "id": "adapter-outbound-notification", "gradle_path": ":adapter:outbound:notification", "source_path": "src/adapter/outbound/notification", "allowed_dependencies": [ - "domain-core", "application-core", "shared-contract", - "adapter-outbound-support" + "adapter-outbound-support", + "application-notification" ] }, { @@ -127,7 +180,9 @@ "allowed_dependencies": [ "domain-core", "application-core", - "shared-contract" + "shared-contract", + "application-notification", + "application-fileserver" ] }, { @@ -171,6 +226,7 @@ "adapter-outbound-support", "adapter-outbound-messaging", "adapter-outbound-cache-redis", + "adapter-outbound-redis-runtime", "adapter-outbound-notification", "adapter-outbound-fileserver", "adapter-outbound-httpclient", @@ -179,7 +235,16 @@ "shared-contract", "adapter-outbound-persistence-mongo", "adapter-inbound-graphql", - "messaging-spring-boot-starter" + "messaging-spring-boot-starter", + "application-notification", + "application-fileserver", + "messaging-core-api", + "messaging-observability", + "messaging-policy", + "messaging-reliability-api", + "messaging-schema-api", + "messaging-security", + "messaging-transport-spi" ] }, { @@ -193,7 +258,8 @@ "adapter-outbound-identifier", "adapter-outbound-objectstorage", "adapter-inbound-web", - "shared-contract" + "shared-contract", + "application-objectstorage" ] }, { @@ -316,7 +382,11 @@ "messaging-core-api", "messaging-policy", "messaging-transport-spi", - "messaging-kafka" + "messaging-kafka", + "messaging-admin-api", + "messaging-observability", + "messaging-schema-api", + "messaging-security" ] }, { @@ -350,7 +420,8 @@ "messaging-reliability-api", "messaging-policy", "messaging-observability", - "messaging-admin-api" + "messaging-admin-api", + "messaging-schema-api" ] }, { @@ -377,7 +448,8 @@ "source_path": "src/messaging/messaging-admin-api", "allowed_dependencies": [ "messaging-core-api", - "messaging-policy" + "messaging-policy", + "messaging-schema-api" ] }, { @@ -390,7 +462,8 @@ "messaging-admin-api", "messaging-transport-spi", "messaging-security", - "messaging-observability" + "messaging-observability", + "messaging-schema-api" ] }, { @@ -428,7 +501,8 @@ "allowed_dependencies": [ "messaging-core-api", "messaging-policy", - "messaging-transport-spi" + "messaging-transport-spi", + "messaging-schema-api" ] }, { @@ -442,11 +516,9 @@ "messaging-cloudevents", "messaging-core-api", "messaging-inbox-jdbc-postgresql", - "messaging-kafka", "messaging-observability", "messaging-outbox-jdbc-postgresql", "messaging-policy", - "messaging-rabbit", "messaging-reliability-api", "messaging-runtime-core", "messaging-schema-api", @@ -455,6 +527,40 @@ "messaging-transport-spi" ] }, + { + "id": "messaging-spring-boot-starter-kafka", + "gradle_path": ":messaging:messaging-spring-boot-starter-kafka", + "source_path": "src/messaging/messaging-spring-boot-starter-kafka", + "allowed_dependencies": [ + "messaging-spring-boot-starter", + "messaging-kafka", + "messaging-admin-api", + "messaging-core-api", + "messaging-observability", + "messaging-policy", + "messaging-reliability-api", + "messaging-schema-api", + "messaging-security", + "messaging-transport-spi" + ] + }, + { + "id": "messaging-spring-boot-starter-rabbit", + "gradle_path": ":messaging:messaging-spring-boot-starter-rabbit", + "source_path": "src/messaging/messaging-spring-boot-starter-rabbit", + "allowed_dependencies": [ + "messaging-spring-boot-starter", + "messaging-rabbit", + "messaging-admin-api", + "messaging-core-api", + "messaging-observability", + "messaging-policy", + "messaging-reliability-api", + "messaging-schema-api", + "messaging-security", + "messaging-transport-spi" + ] + }, { "id": "messaging-testkit", "gradle_path": ":messaging:messaging-testkit", @@ -472,7 +578,8 @@ "source_path": "src/grpc/grpc-admin", "allowed_dependencies": [ "grpc-core-api", - "grpc-server" + "grpc-server", + "grpc-policy" ], "build": "optional-grpc" }, @@ -509,7 +616,8 @@ "source_path": "src/grpc/grpc-discovery", "allowed_dependencies": [ "grpc-core-api", - "grpc-client" + "grpc-client", + "grpc-policy" ], "build": "optional-grpc" }, @@ -572,8 +680,7 @@ "grpc-admin", "grpc-observability", "grpc-proto-contract", - "grpc-codegen", - "grpc-operation-ledger-jpa" + "grpc-codegen" ], "build": "optional-grpc" }, @@ -624,7 +731,8 @@ "allowed_dependencies": [ "grpc-core-api", "grpc-client", - "grpc-advanced-bootstrap" + "grpc-advanced-bootstrap", + "grpc-policy" ], "build": "optional-grpc" }, diff --git a/src/config/checkstyle/checkstyle.xml b/src/config/checkstyle/checkstyle.xml index 74d55098..0d11fed4 100644 --- a/src/config/checkstyle/checkstyle.xml +++ b/src/config/checkstyle/checkstyle.xml @@ -12,7 +12,6 @@ CustomImportOrder here would fight the formatter (checkstyle #6527) and trap CI in an infinite reformat loop. - SSOT: LLM Wiki raw/branch-notes/feature-static-analysis-quality-contract.md §3 catalog. Test-source relaxations live in checkstyle-suppressions.xml (resolved via ${config_loc}). --> diff --git a/src/config/jpa/readiness-cards.yaml b/src/config/jpa/readiness-cards.yaml index 3b971a5c..8bb6e489 100644 --- a/src/config/jpa/readiness-cards.yaml +++ b/src/config/jpa/readiness-cards.yaml @@ -34,7 +34,7 @@ "prerequisites": ["jpa-observability-lifecycle"], "readiness-task": ":adapter:outbound:persistence-jpa:postgresqlSecurityBaselineIntegrationTest", "support-tasks": [ - ":adapter:outbound:persistence-jpa:verifyJpaSqlConstructionSafety", + ":adapter:outbound:persistence-jpa:verifySetConfigParameterBinding", ":adapter:inbound:web:jpaPersistenceRedactionContractTest" ], "required-evidence": [ diff --git a/src/config/messaging/release-profile-assertions.yaml b/src/config/messaging/release-profile-assertions.yaml index 830f6182..eee7d2a1 100644 --- a/src/config/messaging/release-profile-assertions.yaml +++ b/src/config/messaging/release-profile-assertions.yaml @@ -1,3 +1,8 @@ +# PLANNED R2 CONTRACT ONLY. No current Gradle task reads this file as release evidence. +# `MessagingQualificationPluginTest` requires verifyMessagingReleaseProfile and the remaining R2 +# producers to stay unregistered until they are implemented. Empty expected hashes are therefore +# placeholders, not accepted baselines; promoting this profile requires registering a fail-closed +# verifier and replacing every empty hash with certified evidence. schemaVersion: 1 releaseProfiles: - releaseProfileId: messaging-first-r2-polling-producer-release.v1 diff --git a/src/config/runtime/compose-profile-contracts.json b/src/config/runtime/compose-profile-contracts.json index 84ebec10..6e1c532e 100644 --- a/src/config/runtime/compose-profile-contracts.json +++ b/src/config/runtime/compose-profile-contracts.json @@ -423,6 +423,93 @@ ], "expectedPersistenceVendor": "none" }, + { + "id": "local-redis", + "composeProfile": "local-redis", + "files": [ + "base", + "infra", + "local" + ], + "springRuntime": "local", + "services": [ + "app", + "redis" + ], + "longRunningServices": [ + "app", + "redis" + ], + "oneShotServices": [], + "blocking": true, + "activationEnv": { + "APP_REDIS_ENABLED": "true", + "APP_REDIS_NODES": "redis:6379", + "APP_REDIS_AUTHENTICATION_ANONYMOUS_ACCESS_ACCEPTED": "true" + }, + "expectedSwitchesOn": [ + "app.redis.enabled" + ], + "expectedPersistenceVendor": "none" + }, + { + "id": "local-fileserver", + "composeProfile": "local-fileserver", + "files": [ + "base", + "local" + ], + "springRuntime": "local", + "services": [ + "app" + ], + "longRunningServices": [ + "app" + ], + "oneShotServices": [], + "blocking": true, + "activationEnv": { + "APP_FILESERVER_PLATFORM_ENABLED": "true", + "APP_FILESERVER_PLATFORM_STORAGE_ROOT": "/var/lib/backend/files", + "APP_FILESERVER_PLATFORM_SECURITY_ACCESS_POLICY": "role-based", + "APP_FILESERVER_PLATFORM_OBSERVABILITY_FINGERPRINT_KEY": "compose-contract-fileserver-key-32" + }, + "expectedSwitchesOn": [ + "app.fileserver-platform.enabled" + ], + "expectedPersistenceVendor": "none" + }, + { + "id": "local-httpclient", + "composeProfile": "local-httpclient", + "files": [ + "base", + "local" + ], + "springRuntime": "local", + "services": [ + "app" + ], + "longRunningServices": [ + "app" + ], + "oneShotServices": [], + "blocking": true, + "activationEnv": { + "APP_HTTPCLIENT_ENABLED": "true", + "APP_HTTPCLIENT_CLIENTS_0_NAME": "local-app", + "APP_HTTPCLIENT_CLIENTS_0_BASE_URL": "http://app:8080", + "APP_HTTPCLIENT_CLIENTS_0_ALLOWED_HOSTS_0": "app", + "APP_HTTPCLIENT_CLIENTS_0_ALLOWED_PORTS_0": "8080", + "APP_HTTPCLIENT_CLIENTS_0_REQUEST_MAX_BODY_BYTES": "1048576", + "APP_HTTPCLIENT_CLIENTS_0_TLS_PROFILE_ID": "local-app", + "APP_HTTPCLIENT_CLIENTS_0_TLS_ALLOW_PLAIN_HTTP": "true" + }, + "expectedSwitchesOn": [ + "app.httpclient.enabled" + ], + "expectedPersistenceVendor": "none" + }, { "id": "shared-infra-local", "composeProfile": "shared-infra", @@ -571,7 +658,8 @@ "mailpit", "mongo", "mongo-rs-init", - "notification-smoke" + "notification-smoke", + "redis" ], "longRunningServices": [ "app", @@ -579,7 +667,8 @@ "kafka", "keycloak", "mailpit", - "mongo" + "mongo", + "redis" ], "preStartServices": [ "mongo-rs-init", @@ -619,10 +708,28 @@ "SPRING_MAIL_PROPERTIES_MAIL_SMTP_SSL_TRUST": "mailpit", "APP_NOTIFICATION_PLATFORM_SMTP_ENABLED": "true", "APP_NOTIFICATION_PLATFORM_SMTP_SENDER_IDENTITY": "no-reply@lane.test", - "APP_MESSAGING_KAFKA_BROKERS": "kafka:9092" + "APP_MESSAGING_KAFKA_BROKERS": "kafka:9092", + "APP_REDIS_ENABLED": "true", + "APP_REDIS_NODES": "redis:6379", + "APP_REDIS_AUTHENTICATION_ANONYMOUS_ACCESS_ACCEPTED": "true", + "APP_FILESERVER_PLATFORM_ENABLED": "true", + "APP_FILESERVER_PLATFORM_STORAGE_ROOT": "/var/lib/backend/files", + "APP_FILESERVER_PLATFORM_SECURITY_ACCESS_POLICY": "role-based", + "APP_FILESERVER_PLATFORM_OBSERVABILITY_FINGERPRINT_KEY": "compose-contract-fileserver-key-32", + "APP_HTTPCLIENT_ENABLED": "true", + "APP_HTTPCLIENT_CLIENTS_0_NAME": "local-app", + "APP_HTTPCLIENT_CLIENTS_0_BASE_URL": "http://app:8080", + "APP_HTTPCLIENT_CLIENTS_0_ALLOWED_HOSTS_0": "app", + "APP_HTTPCLIENT_CLIENTS_0_ALLOWED_PORTS_0": "8080", + "APP_HTTPCLIENT_CLIENTS_0_REQUEST_MAX_BODY_BYTES": "1048576", + "APP_HTTPCLIENT_CLIENTS_0_TLS_PROFILE_ID": "local-app", + "APP_HTTPCLIENT_CLIENTS_0_TLS_ALLOW_PLAIN_HTTP": "true" }, "expectedSwitchesOn": [ + "app.fileserver-platform.enabled", + "app.httpclient.enabled", "app.messaging.enabled", + "app.redis.enabled", "backend.graphql.enabled", "ca-skeleton.notification.platform.enabled", "ca-skeleton.persistence-jpa.enabled", @@ -631,7 +738,7 @@ "expectedPersistenceVendor": "postgresql" } ], - "$activationComment": "activationEnv is what the lane injects; expectedSwitchesOn is what the application must then report. Both are needed: a lane named local-jpa that ran with JPA off would render the right services, start cleanly, and prove nothing at all.", + "$activationComment": "activationEnv is what the lane injects; expectedSwitchesOn is what the application must then report. Both are needed: a lane named local-jpa that ran with JPA off would render the right services, start cleanly, and prove nothing at all. Redis, the HTTP Fileserver platform and the HTTP client platform are shipped in app-bootstrap and therefore have dedicated blocking lanes. Object storage, WebSocket and gRPC are build-time optional and are qualified by their dedicated workflows instead of being falsely reported as members of this bootJar.", "$vendorComment": "expectedPersistenceVendor is the vendor the application must report, not the one the lane started. 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.", "$flywayComment": "SPRING_FLYWAY_LOCATIONS is deliberately absent. Seven lanes listed every capability stream there, and it could never have worked: db/migration/jpa/{core,fileserver,idempotency,inbox,notification-platform,outbox-polling,outbox-storage} 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/src/domain-core/README.md b/src/domain-core/README.md index 497eb418..a620b1ff 100644 --- a/src/domain-core/README.md +++ b/src/domain-core/README.md @@ -29,10 +29,14 @@ - **그럼 "닫힌 집합" 보장은 어디서 하나.** `sealed`이 줬을 보장(아무 타입이나 식별자로 쓰지 못하게 하는 것)은 대신 빌드 타임의 `no_long_id_pk` ArchUnit 규칙(D17)이 강제한다 — 도메인의 모든 `id` 필드는 반드시 `ResourceId` 구현이어야 하고, 날것의 `Long` PK 는 금지된다. + 이 규칙은 **식별자 필드의 타입**을 강제하는 규칙이지 문자열 포맷 검증기가 아니다. - **`` 타입 파라미터(F-bounded generic).** 제네릭이 자기 자신을 다시 가리키는 재귀 구조다. 구현 타입이 "나는 나 자신 타입의 `ResourceId`다"라고 선언하게 해서, 자기 타입을 그대로 돌려주는 self-typed API 를 타입 안전하게 만들 수 있다. -- **`value()` 계약.** 36자 canonical UUID(RFC 9562 UUIDv7) 문자열을 반환한다(D2/D3). +- **`value()` 계약.** `ResourceId` 자체가 보장하는 것은 안정적인 `String` 값을 노출한다는 + 모양뿐이다. 이 레퍼런스의 UUID 기반 구현은 36자 canonical RFC 9562 UUID 문자열을 생성자에서 + 검증해야 하며, 그 포맷 불변식은 실제 구현 모듈의 테스트 책임이다. 마커 인터페이스 테스트가 + 가짜 구현을 만들어 36자를 돌려주는 방식으로는 아무것도 증명하지 못한다. ### `IdFactory` — 식별자 생성 포트 diff --git a/src/domain-core/src/main/java/dev/caskeleton/domain/identifier/ResourceId.java b/src/domain-core/src/main/java/dev/caskeleton/domain/identifier/ResourceId.java index 12eab331..aa9cbc4c 100644 --- a/src/domain-core/src/main/java/dev/caskeleton/domain/identifier/ResourceId.java +++ b/src/domain-core/src/main/java/dev/caskeleton/domain/identifier/ResourceId.java @@ -10,6 +10,12 @@ package dev.caskeleton.domain.identifier; */ public interface ResourceId> { - /** The canonical 36-character UUID string (RFC 9562 UUIDv7). */ + /** + * Returns the externally stable identifier text. + * + *

      The marker interface cannot enforce a concrete encoding. This repository's UUID-backed + * implementations use canonical 36-character RFC 9562 UUID text; an implementation owns and tests + * that invariant at its own construction boundary. + */ String value(); } diff --git a/src/domain-core/src/test/java/dev/caskeleton/domain/DomainCoreContractTest.java b/src/domain-core/src/test/java/dev/caskeleton/domain/DomainCoreContractTest.java new file mode 100644 index 00000000..069fc065 --- /dev/null +++ b/src/domain-core/src/test/java/dev/caskeleton/domain/DomainCoreContractTest.java @@ -0,0 +1,47 @@ +package dev.caskeleton.domain; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.domain.identifier.ResourceId; +import dev.caskeleton.domain.stereotype.AggregateRoot; +import dev.caskeleton.domain.stereotype.DomainEvent; +import dev.caskeleton.domain.stereotype.ValueObject; +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; +import java.lang.reflect.Method; +import java.util.Set; +import org.junit.jupiter.api.Test; + +class DomainCoreContractTest { + + @Test + void resourceIdOwnsOnlyTheIdentifierShapeNotAConcreteUuidImplementation() throws Exception { + assertThat(ResourceId.class.isInterface()).isTrue(); + + Method value = ResourceId.class.getMethod("value"); + + assertThat(value.getReturnType()).isEqualTo(String.class); + assertThat(ResourceId.class.getDeclaredMethods()) + .extracting(Method::getName) + .containsExactly("value"); + } + + @Test + void domainStereotypesRemainRuntimeVisibleTypeMarkers() { + assertRuntimeTypeMarker(ValueObject.class); + assertRuntimeTypeMarker(AggregateRoot.class); + assertRuntimeTypeMarker(DomainEvent.class); + } + + private static void assertRuntimeTypeMarker(Class annotationType) { + Retention retention = annotationType.getAnnotation(Retention.class); + Target target = annotationType.getAnnotation(Target.class); + + assertThat(retention).isNotNull(); + assertThat(retention.value()).isEqualTo(RetentionPolicy.RUNTIME); + assertThat(target).isNotNull(); + assertThat(Set.of(target.value())).containsExactly(ElementType.TYPE); + } +} diff --git a/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationBridgePolicy.java b/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationBridgePolicy.java index c13e0337..0ae324aa 100644 --- a/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationBridgePolicy.java +++ b/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationBridgePolicy.java @@ -1,6 +1,6 @@ package dev.caskeleton.grpc.advanced.integration; -import dev.caskeleton.grpc.context.GrpcMetadataKey; +import dev.caskeleton.grpc.api.context.GrpcMetadataKey; import java.util.LinkedHashMap; import java.util.Map; import java.util.Set; diff --git a/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationInboundGateway.java b/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationInboundGateway.java index 0f3053c6..92dfb5a3 100644 --- a/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationInboundGateway.java +++ b/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationInboundGateway.java @@ -1,6 +1,6 @@ package dev.caskeleton.grpc.advanced.integration; -import dev.caskeleton.grpc.context.GrpcRequestContext; +import dev.caskeleton.grpc.api.context.GrpcRequestContext; import java.util.Map; import org.springframework.messaging.Message; import org.springframework.messaging.support.MessageBuilder; diff --git a/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationOutboundGateway.java b/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationOutboundGateway.java index 82731ad0..08163fd0 100644 --- a/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationOutboundGateway.java +++ b/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/integration/GrpcIntegrationOutboundGateway.java @@ -1,6 +1,6 @@ package dev.caskeleton.grpc.advanced.integration; -import dev.caskeleton.grpc.context.GrpcMetadataKey; +import dev.caskeleton.grpc.api.context.GrpcMetadataKey; import java.util.Map; import org.springframework.messaging.Message; diff --git a/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/ReactiveGrpcServerAdapter.java b/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/ReactiveGrpcServerAdapter.java index ca54efe2..189832bf 100644 --- a/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/ReactiveGrpcServerAdapter.java +++ b/src/grpc-advanced/grpc-advanced-compat/src/main/java/dev/caskeleton/grpc/advanced/reactor/ReactiveGrpcServerAdapter.java @@ -1,7 +1,7 @@ package dev.caskeleton.grpc.advanced.reactor; import dev.caskeleton.grpc.context.GrpcContextSnapshot; -import dev.caskeleton.grpc.context.GrpcRequestContext; +import dev.caskeleton.grpc.api.context.GrpcRequestContext; import java.util.function.BiFunction; import reactor.core.publisher.Mono; import reactor.core.scheduler.Scheduler; diff --git a/src/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcIntegrationBridgePolicyTest.java b/src/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcIntegrationBridgePolicyTest.java index 768c37bb..2e1041c3 100644 --- a/src/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcIntegrationBridgePolicyTest.java +++ b/src/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcIntegrationBridgePolicyTest.java @@ -6,15 +6,15 @@ import static org.assertj.core.api.Assertions.assertThatThrownBy; import dev.caskeleton.grpc.advanced.integration.GrpcIntegrationBridgePolicy; import dev.caskeleton.grpc.advanced.integration.GrpcIntegrationInboundGateway; import dev.caskeleton.grpc.advanced.integration.GrpcIntegrationOutboundGateway; -import dev.caskeleton.grpc.context.GrpcClientIdentity; -import dev.caskeleton.grpc.context.GrpcMetadataBudget; -import dev.caskeleton.grpc.context.GrpcMetadataKey; -import dev.caskeleton.grpc.context.GrpcRequestContext; +import dev.caskeleton.grpc.api.context.GrpcClientIdentity; +import dev.caskeleton.grpc.api.context.GrpcMetadataBudget; +import dev.caskeleton.grpc.api.context.GrpcMetadataKey; +import dev.caskeleton.grpc.api.context.GrpcRequestContext; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.RpcType; -import dev.caskeleton.grpc.deadline.GrpcCancellationToken; -import dev.caskeleton.grpc.deadline.GrpcDeadlineBudget; -import dev.caskeleton.grpc.deadline.GrpcDeadlineProfile; +import dev.caskeleton.grpc.api.deadline.GrpcCancellationToken; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineBudget; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineProfile; import java.time.Duration; import java.util.Map; import java.util.Set; diff --git a/src/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcKotlinCompatibilityGateTest.java b/src/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcKotlinCompatibilityGateTest.java index c70f5b42..47a5dfec 100644 --- a/src/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcKotlinCompatibilityGateTest.java +++ b/src/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcKotlinCompatibilityGateTest.java @@ -8,7 +8,7 @@ import dev.caskeleton.grpc.advanced.kotlin.GrpcKotlinCompatibilityGate; import dev.caskeleton.grpc.advanced.kotlin.GrpcKotlinProfile; import dev.caskeleton.grpc.deadline.GrpcCancellationCoordinator; import dev.caskeleton.grpc.deadline.GrpcCancellationReason; -import dev.caskeleton.grpc.deadline.GrpcCancellationToken; +import dev.caskeleton.grpc.api.deadline.GrpcCancellationToken; import java.time.Instant; import java.util.concurrent.atomic.AtomicBoolean; import org.junit.jupiter.api.DisplayName; diff --git a/src/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcReactorContextBridgeTest.java b/src/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcReactorContextBridgeTest.java index de58a760..835811e7 100644 --- a/src/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcReactorContextBridgeTest.java +++ b/src/grpc-advanced/grpc-advanced-compat/src/test/java/dev/caskeleton/grpc/advanced/compat/GrpcReactorContextBridgeTest.java @@ -5,17 +5,17 @@ import static org.assertj.core.api.Assertions.assertThatThrownBy; import dev.caskeleton.grpc.advanced.reactor.GrpcReactorCancellationBridge; import dev.caskeleton.grpc.advanced.reactor.GrpcReactorContextBridge; -import dev.caskeleton.grpc.context.GrpcClientIdentity; +import dev.caskeleton.grpc.api.context.GrpcClientIdentity; import dev.caskeleton.grpc.context.GrpcContextSnapshot; -import dev.caskeleton.grpc.context.GrpcMetadataBudget; -import dev.caskeleton.grpc.context.GrpcRequestContext; +import dev.caskeleton.grpc.api.context.GrpcMetadataBudget; +import dev.caskeleton.grpc.api.context.GrpcRequestContext; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.RpcType; import dev.caskeleton.grpc.deadline.GrpcCancellationCoordinator; import dev.caskeleton.grpc.deadline.GrpcCancellationReason; -import dev.caskeleton.grpc.deadline.GrpcCancellationToken; -import dev.caskeleton.grpc.deadline.GrpcDeadlineBudget; -import dev.caskeleton.grpc.deadline.GrpcDeadlineProfile; +import dev.caskeleton.grpc.api.deadline.GrpcCancellationToken; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineBudget; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineProfile; import java.time.Duration; import java.time.Instant; import java.util.Map; diff --git a/src/grpc-advanced/grpc-advanced-diagnostics/src/main/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcDiagnosticsRedactor.java b/src/grpc-advanced/grpc-advanced-diagnostics/src/main/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcDiagnosticsRedactor.java index b91a7db2..74935763 100644 --- a/src/grpc-advanced/grpc-advanced-diagnostics/src/main/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcDiagnosticsRedactor.java +++ b/src/grpc-advanced/grpc-advanced-diagnostics/src/main/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcDiagnosticsRedactor.java @@ -1,5 +1,9 @@ package dev.caskeleton.grpc.advanced.diagnostics; +import java.nio.charset.StandardCharsets; +import java.security.MessageDigest; +import java.security.NoSuchAlgorithmException; +import java.util.HexFormat; import java.util.LinkedHashMap; import java.util.Map; import java.util.regex.Pattern; @@ -43,9 +47,22 @@ public final class GrpcDiagnosticsRedactor { if (address == null || address.isBlank()) { return "unknown"; } - return IPV4_WITH_PORT - .matcher(address) - .replaceAll(matchResult -> matchResult.group(1) + "." + matchResult.group(2) + ".x.x"); + var matcher = IPV4_WITH_PORT.matcher(address); + if (matcher.find()) { + return matcher.replaceAll( + matchResult -> matchResult.group(1) + "." + matchResult.group(2) + ".x.x"); + } + return "masked:" + stableAddressToken(address); + } + + private static String stableAddressToken(String address) { + try { + byte[] digest = + MessageDigest.getInstance("SHA-256").digest(address.getBytes(StandardCharsets.UTF_8)); + return HexFormat.of().formatHex(digest, 0, 8); + } catch (NoSuchAlgorithmException impossible) { + throw new IllegalStateException("SHA-256 is required by the Java runtime", impossible); + } } /** diff --git a/src/grpc-advanced/grpc-advanced-diagnostics/src/test/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcChannelDiagnosticsPolicyTest.java b/src/grpc-advanced/grpc-advanced-diagnostics/src/test/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcChannelDiagnosticsPolicyTest.java index 8f2da8c9..c537ba7f 100644 --- a/src/grpc-advanced/grpc-advanced-diagnostics/src/test/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcChannelDiagnosticsPolicyTest.java +++ b/src/grpc-advanced/grpc-advanced-diagnostics/src/test/java/dev/caskeleton/grpc/advanced/diagnostics/GrpcChannelDiagnosticsPolicyTest.java @@ -72,6 +72,12 @@ class GrpcChannelDiagnosticsPolicyTest { void addressesAreMaskedRatherThanDropped() { assertThat(GrpcDiagnosticsRedactor.maskAddress("10.4.13.201:9090")).isEqualTo("10.4.x.x"); assertThat(GrpcDiagnosticsRedactor.maskAddress("10.9.13.201")).isEqualTo("10.9.x.x"); + + String ipv6 = GrpcDiagnosticsRedactor.maskAddress("[2001:db8::10]:9090"); + String hostname = GrpcDiagnosticsRedactor.maskAddress("payments.internal.example:443"); + assertThat(ipv6).startsWith("masked:").doesNotContain("2001", "db8"); + assertThat(hostname).startsWith("masked:").doesNotContain("payments", "internal.example"); + assertThat(ipv6).isNotEqualTo(hostname); assertThat(GrpcDiagnosticsRedactor.maskAddress(null)).isEqualTo("unknown"); Map redacted = diff --git a/src/grpc-advanced/grpc-advanced-resilience/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingEligibility.java b/src/grpc-advanced/grpc-advanced-resilience/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingEligibility.java index 2e62c3ae..9131adc8 100644 --- a/src/grpc-advanced/grpc-advanced-resilience/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingEligibility.java +++ b/src/grpc-advanced/grpc-advanced-resilience/src/main/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingEligibility.java @@ -1,8 +1,8 @@ package dev.caskeleton.grpc.advanced.resilience; import dev.caskeleton.grpc.core.RpcType; -import dev.caskeleton.grpc.policy.GrpcMethodPolicy; -import dev.caskeleton.grpc.policy.RpcIdempotencyProfile; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicy; +import dev.caskeleton.grpc.api.policy.RpcIdempotencyProfile; import dev.caskeleton.grpc.resilience.GrpcRetryOwner; import java.util.Optional; @@ -45,7 +45,7 @@ public final class GrpcHedgingEligibility { + "because the second attempt duplicates a success in progress rather than retrying a " + "failure"); } - if (!retryOwner.hedgingAllowed()) { + if (!retryOwner.permitsHedging()) { return Optional.of( "retry owner is " + retryOwner + ", which does not permit in-process hedging"); } diff --git a/src/grpc-advanced/grpc-advanced-resilience/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingEligibilityTest.java b/src/grpc-advanced/grpc-advanced-resilience/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingEligibilityTest.java index fe5713a5..f26115bb 100644 --- a/src/grpc-advanced/grpc-advanced-resilience/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingEligibilityTest.java +++ b/src/grpc-advanced/grpc-advanced-resilience/src/test/java/dev/caskeleton/grpc/advanced/resilience/GrpcHedgingEligibilityTest.java @@ -5,10 +5,10 @@ import static org.assertj.core.api.Assertions.assertThatThrownBy; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.RpcType; -import dev.caskeleton.grpc.deadline.GrpcDeadlineProfile; -import dev.caskeleton.grpc.policy.GrpcMethodPolicy; -import dev.caskeleton.grpc.policy.RpcIdempotencyProfile; -import dev.caskeleton.grpc.policy.WaitForReadyPolicy; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineProfile; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicy; +import dev.caskeleton.grpc.api.policy.RpcIdempotencyProfile; +import dev.caskeleton.grpc.api.policy.WaitForReadyPolicy; import dev.caskeleton.grpc.resilience.GrpcRetryOwner; import java.time.Duration; import org.junit.jupiter.api.DisplayName; diff --git a/src/grpc/CLAUDE.md b/src/grpc/CLAUDE.md index 4d0fcb8a..766fb788 100644 --- a/src/grpc/CLAUDE.md +++ b/src/grpc/CLAUDE.md @@ -98,11 +98,11 @@ focused test는 registry의 `gradle_path`에서 파생한다. ```bash cd src -./gradlew :grpc::test --console=plain -./gradlew :grpc:grpc-testkit:grpcInProcessContractTest --console=plain -./gradlew :grpc:grpc-testkit:grpcNettyContractTest --console=plain -./gradlew :grpc:grpc-testkit:grpcFaultTest --console=plain -./gradlew :grpc:grpc-testkit:grpcPerformanceTest --console=plain +./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 ``` ## 금지 @@ -113,3 +113,19 @@ cd src - in-process 결과로 transport capability를 주장하는 것 (`GrpcEvidenceGrade`가 거부한다). - metric tag에 raw metadata·payload·actor/tenant/object/stream/idempotency 식별자를 넣는 것 (`GrpcMetricCardinalityPolicy`가 거부한다). + + +### Adoption-time observability gate + +The metric names implemented by `grpc-observability` are **not registered in +`docs/registries/metrics.yaml` yet** because this optional family is not a shipped runtime capability. +Do not present those names as repository-certified metrics until adoption adds registry entries with +the repository's `.seconds` / `.total` unit naming and the corresponding validation gate. + + +### Durable operation ledger adoption + +`grpc-spring-boot-starter` does not pull the JPA ledger adapter transitively. A deployment that needs +durable operation idempotency adds `:grpc:grpc-operation-ledger-jpa` explicitly, enables the ledger +configuration, and includes that adapter's Flyway location `db/migration/grpc`. A deployment that +does not adopt the ledger therefore pays no Spring Data JPA classpath cost. diff --git a/src/grpc/grpc-client/src/main/java/dev/caskeleton/grpc/client/GrpcClientCallContext.java b/src/grpc/grpc-client/src/main/java/dev/caskeleton/grpc/client/GrpcClientCallContext.java index 49e8b009..0c21026f 100644 --- a/src/grpc/grpc-client/src/main/java/dev/caskeleton/grpc/client/GrpcClientCallContext.java +++ b/src/grpc/grpc-client/src/main/java/dev/caskeleton/grpc/client/GrpcClientCallContext.java @@ -1,8 +1,8 @@ package dev.caskeleton.grpc.client; -import dev.caskeleton.grpc.context.GrpcMetadataKey; +import dev.caskeleton.grpc.api.context.GrpcMetadataKey; import dev.caskeleton.grpc.core.GrpcMethodName; -import dev.caskeleton.grpc.deadline.GrpcDeadlineBudget; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineBudget; import java.time.Instant; import java.util.Map; import java.util.Optional; diff --git a/src/grpc/grpc-client/src/main/java/dev/caskeleton/grpc/client/GrpcClientMetadataPolicy.java b/src/grpc/grpc-client/src/main/java/dev/caskeleton/grpc/client/GrpcClientMetadataPolicy.java index e97561ae..89ff4116 100644 --- a/src/grpc/grpc-client/src/main/java/dev/caskeleton/grpc/client/GrpcClientMetadataPolicy.java +++ b/src/grpc/grpc-client/src/main/java/dev/caskeleton/grpc/client/GrpcClientMetadataPolicy.java @@ -1,7 +1,7 @@ package dev.caskeleton.grpc.client; -import dev.caskeleton.grpc.context.GrpcMetadataBudget; -import dev.caskeleton.grpc.context.GrpcMetadataKey; +import dev.caskeleton.grpc.api.context.GrpcMetadataBudget; +import dev.caskeleton.grpc.api.context.GrpcMetadataKey; import java.util.LinkedHashMap; import java.util.Map; import java.util.Set; diff --git a/src/grpc/grpc-client/src/main/java/dev/caskeleton/grpc/client/GrpcStubPolicyApplier.java b/src/grpc/grpc-client/src/main/java/dev/caskeleton/grpc/client/GrpcStubPolicyApplier.java index 8ca51fa2..4625d3dd 100644 --- a/src/grpc/grpc-client/src/main/java/dev/caskeleton/grpc/client/GrpcStubPolicyApplier.java +++ b/src/grpc/grpc-client/src/main/java/dev/caskeleton/grpc/client/GrpcStubPolicyApplier.java @@ -1,10 +1,10 @@ package dev.caskeleton.grpc.client; import dev.caskeleton.grpc.core.GrpcMethodName; -import dev.caskeleton.grpc.deadline.GrpcDeadlineBudget; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineBudget; import dev.caskeleton.grpc.deadline.GrpcDeadlineCalculator; -import dev.caskeleton.grpc.policy.GrpcMethodPolicy; -import dev.caskeleton.grpc.policy.GrpcMethodPolicyCatalog; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicy; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicyCatalog; import dev.caskeleton.grpc.resilience.GrpcWaitForReadyDecision; import dev.caskeleton.grpc.resilience.GrpcWaitForReadyProfile; import dev.caskeleton.grpc.resilience.GrpcWaitForReadyValidator; diff --git a/src/grpc/grpc-client/src/test/java/dev/caskeleton/grpc/client/GrpcClientMetadataPolicyTest.java b/src/grpc/grpc-client/src/test/java/dev/caskeleton/grpc/client/GrpcClientMetadataPolicyTest.java index 05bff8b0..1cb2cf12 100644 --- a/src/grpc/grpc-client/src/test/java/dev/caskeleton/grpc/client/GrpcClientMetadataPolicyTest.java +++ b/src/grpc/grpc-client/src/test/java/dev/caskeleton/grpc/client/GrpcClientMetadataPolicyTest.java @@ -3,12 +3,12 @@ package dev.caskeleton.grpc.client; import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.assertThatThrownBy; -import dev.caskeleton.grpc.context.GrpcMetadataBudget; -import dev.caskeleton.grpc.context.GrpcMetadataKey; +import dev.caskeleton.grpc.api.context.GrpcMetadataBudget; +import dev.caskeleton.grpc.api.context.GrpcMetadataKey; import dev.caskeleton.grpc.core.GrpcChannelProfileName; import dev.caskeleton.grpc.core.GrpcMethodName; -import dev.caskeleton.grpc.deadline.GrpcDeadlineBudget; -import dev.caskeleton.grpc.deadline.GrpcDeadlineProfile; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineBudget; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineProfile; import java.time.Duration; import java.time.Instant; import java.util.LinkedHashMap; diff --git a/src/grpc/grpc-client/src/test/java/dev/caskeleton/grpc/client/GrpcTypedStubFactoryTest.java b/src/grpc/grpc-client/src/test/java/dev/caskeleton/grpc/client/GrpcTypedStubFactoryTest.java index c5eb51a0..1ab4a99c 100644 --- a/src/grpc/grpc-client/src/test/java/dev/caskeleton/grpc/client/GrpcTypedStubFactoryTest.java +++ b/src/grpc/grpc-client/src/test/java/dev/caskeleton/grpc/client/GrpcTypedStubFactoryTest.java @@ -5,9 +5,9 @@ import static org.assertj.core.api.Assertions.assertThatThrownBy; import dev.caskeleton.grpc.core.GrpcChannelProfileName; import dev.caskeleton.grpc.core.GrpcMethodName; -import dev.caskeleton.grpc.deadline.GrpcDeadlineProfile; -import dev.caskeleton.grpc.policy.GrpcMethodPolicy; -import dev.caskeleton.grpc.policy.GrpcMethodPolicyCatalog; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineProfile; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicy; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicyCatalog; import dev.caskeleton.grpc.resilience.GrpcWaitForReadyProfile; import java.time.Duration; import java.time.Instant; diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/context/GrpcClientIdentity.java b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcClientIdentity.java similarity index 98% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/context/GrpcClientIdentity.java rename to src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcClientIdentity.java index 873f6005..4a1ba9df 100644 --- a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/context/GrpcClientIdentity.java +++ b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcClientIdentity.java @@ -1,4 +1,4 @@ -package dev.caskeleton.grpc.context; +package dev.caskeleton.grpc.api.context; /** * Who is calling, as established by authentication — never as claimed by a header. diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/context/GrpcMetadataBudget.java b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcMetadataBudget.java similarity index 98% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/context/GrpcMetadataBudget.java rename to src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcMetadataBudget.java index 1ddc6394..99befcd2 100644 --- a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/context/GrpcMetadataBudget.java +++ b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcMetadataBudget.java @@ -1,4 +1,4 @@ -package dev.caskeleton.grpc.context; +package dev.caskeleton.grpc.api.context; import java.util.Map; diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/context/GrpcMetadataKey.java b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcMetadataKey.java similarity index 98% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/context/GrpcMetadataKey.java rename to src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcMetadataKey.java index a09143a7..be7fe5de 100644 --- a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/context/GrpcMetadataKey.java +++ b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcMetadataKey.java @@ -1,4 +1,4 @@ -package dev.caskeleton.grpc.context; +package dev.caskeleton.grpc.api.context; import java.util.regex.Pattern; diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/context/GrpcRequestContext.java b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcRequestContext.java similarity index 95% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/context/GrpcRequestContext.java rename to src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcRequestContext.java index a0c75d22..d42a3a5f 100644 --- a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/context/GrpcRequestContext.java +++ b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/context/GrpcRequestContext.java @@ -1,9 +1,9 @@ -package dev.caskeleton.grpc.context; +package dev.caskeleton.grpc.api.context; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.RpcType; -import dev.caskeleton.grpc.deadline.GrpcCancellationToken; -import dev.caskeleton.grpc.deadline.GrpcDeadlineBudget; +import dev.caskeleton.grpc.api.deadline.GrpcCancellationToken; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineBudget; import java.util.LinkedHashMap; import java.util.Map; import java.util.Optional; diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellationToken.java b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcCancellationToken.java similarity index 98% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellationToken.java rename to src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcCancellationToken.java index 534f3400..ba422438 100644 --- a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellationToken.java +++ b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcCancellationToken.java @@ -1,4 +1,4 @@ -package dev.caskeleton.grpc.deadline; +package dev.caskeleton.grpc.api.deadline; import java.time.Instant; import java.util.Optional; diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlineBudget.java b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineBudget.java similarity index 98% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlineBudget.java rename to src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineBudget.java index f883ab46..b41258a6 100644 --- a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlineBudget.java +++ b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineBudget.java @@ -1,4 +1,4 @@ -package dev.caskeleton.grpc.deadline; +package dev.caskeleton.grpc.api.deadline; import java.time.Duration; diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlineExceededException.java b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineExceededException.java similarity index 83% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlineExceededException.java rename to src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineExceededException.java index e65e5a0e..c5d49af6 100644 --- a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlineExceededException.java +++ b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineExceededException.java @@ -1,7 +1,7 @@ -package dev.caskeleton.grpc.deadline; +package dev.caskeleton.grpc.api.deadline; -import dev.caskeleton.grpc.error.GrpcFailureContext; -import dev.caskeleton.grpc.error.GrpcPlatformException; +import dev.caskeleton.grpc.api.error.GrpcFailureContext; +import dev.caskeleton.grpc.api.error.GrpcPlatformException; /** * A deadline elapsed. diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlineProfile.java b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineProfile.java similarity index 98% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlineProfile.java rename to src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineProfile.java index 4c6308d8..2df50792 100644 --- a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlineProfile.java +++ b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineProfile.java @@ -1,4 +1,4 @@ -package dev.caskeleton.grpc.deadline; +package dev.caskeleton.grpc.api.deadline; import java.time.Duration; diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/error/GrpcCompletionOutcome.java b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcCompletionOutcome.java similarity index 98% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/error/GrpcCompletionOutcome.java rename to src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcCompletionOutcome.java index c5e0b35f..41b1029d 100644 --- a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/error/GrpcCompletionOutcome.java +++ b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcCompletionOutcome.java @@ -1,4 +1,4 @@ -package dev.caskeleton.grpc.error; +package dev.caskeleton.grpc.api.error; import dev.caskeleton.grpc.core.GrpcStatusCode; import dev.caskeleton.grpc.evidence.GrpcBusinessEvidence; diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/error/GrpcFailureCategory.java b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcFailureCategory.java similarity index 98% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/error/GrpcFailureCategory.java rename to src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcFailureCategory.java index a3690c1c..f6ada7a3 100644 --- a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/error/GrpcFailureCategory.java +++ b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcFailureCategory.java @@ -1,4 +1,4 @@ -package dev.caskeleton.grpc.error; +package dev.caskeleton.grpc.api.error; import dev.caskeleton.grpc.core.GrpcStatusCode; diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/error/GrpcFailureContext.java b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcFailureContext.java similarity index 98% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/error/GrpcFailureContext.java rename to src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcFailureContext.java index 110f9bba..91a30ba8 100644 --- a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/error/GrpcFailureContext.java +++ b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcFailureContext.java @@ -1,4 +1,4 @@ -package dev.caskeleton.grpc.error; +package dev.caskeleton.grpc.api.error; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.GrpcStatusCode; diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/error/GrpcPlatformException.java b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcPlatformException.java similarity index 97% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/error/GrpcPlatformException.java rename to src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcPlatformException.java index cae93dcf..22834504 100644 --- a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/error/GrpcPlatformException.java +++ b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/error/GrpcPlatformException.java @@ -1,4 +1,4 @@ -package dev.caskeleton.grpc.error; +package dev.caskeleton.grpc.api.error; /** * The platform's failure carrier. diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationIdentity.java b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationIdentity.java similarity index 97% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationIdentity.java rename to src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationIdentity.java index 5239c717..b4dab916 100644 --- a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationIdentity.java +++ b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationIdentity.java @@ -1,4 +1,4 @@ -package dev.caskeleton.grpc.ledger; +package dev.caskeleton.grpc.api.ledger; import dev.caskeleton.grpc.core.GrpcMethodName; diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedger.java b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedger.java similarity index 98% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedger.java rename to src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedger.java index fb2a3157..9ab94f6c 100644 --- a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedger.java +++ b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedger.java @@ -1,4 +1,4 @@ -package dev.caskeleton.grpc.ledger; +package dev.caskeleton.grpc.api.ledger; import java.time.Instant; import java.util.Optional; diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerRecord.java b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerRecord.java similarity index 98% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerRecord.java rename to src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerRecord.java index 83606a27..2bc0942a 100644 --- a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerRecord.java +++ b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerRecord.java @@ -1,4 +1,4 @@ -package dev.caskeleton.grpc.ledger; +package dev.caskeleton.grpc.api.ledger; import java.time.Instant; import java.util.Optional; diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerState.java b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerState.java similarity index 95% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerState.java rename to src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerState.java index f584aeb1..2908b579 100644 --- a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerState.java +++ b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/ledger/GrpcOperationLedgerState.java @@ -1,4 +1,4 @@ -package dev.caskeleton.grpc.ledger; +package dev.caskeleton.grpc.api.ledger; /** * Where a durable operation claim is in its life. diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/policy/GrpcMethodPolicy.java b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicy.java similarity index 97% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/policy/GrpcMethodPolicy.java rename to src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicy.java index 8e137f6c..3002e059 100644 --- a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/policy/GrpcMethodPolicy.java +++ b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicy.java @@ -1,8 +1,8 @@ -package dev.caskeleton.grpc.policy; +package dev.caskeleton.grpc.api.policy; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.RpcType; -import dev.caskeleton.grpc.deadline.GrpcDeadlineProfile; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineProfile; /** * Everything the platform decides per method, in one immutable value. diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/policy/GrpcMethodPolicyCatalog.java b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicyCatalog.java similarity index 99% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/policy/GrpcMethodPolicyCatalog.java rename to src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicyCatalog.java index f6e694ae..d5e29ec3 100644 --- a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/policy/GrpcMethodPolicyCatalog.java +++ b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicyCatalog.java @@ -1,4 +1,4 @@ -package dev.caskeleton.grpc.policy; +package dev.caskeleton.grpc.api.policy; import dev.caskeleton.grpc.core.GrpcMethodName; import java.util.LinkedHashMap; diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/policy/RpcIdempotencyProfile.java b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/RpcIdempotencyProfile.java similarity index 98% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/policy/RpcIdempotencyProfile.java rename to src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/RpcIdempotencyProfile.java index 362e2b30..814c49a8 100644 --- a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/policy/RpcIdempotencyProfile.java +++ b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/RpcIdempotencyProfile.java @@ -1,4 +1,4 @@ -package dev.caskeleton.grpc.policy; +package dev.caskeleton.grpc.api.policy; /** * How safe a method is to run more than once — the property every retry decision starts from. diff --git a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/policy/WaitForReadyPolicy.java b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/WaitForReadyPolicy.java similarity index 95% rename from src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/policy/WaitForReadyPolicy.java rename to src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/WaitForReadyPolicy.java index 2eb390c1..65f31915 100644 --- a/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/policy/WaitForReadyPolicy.java +++ b/src/grpc/grpc-core-api/src/main/java/dev/caskeleton/grpc/api/policy/WaitForReadyPolicy.java @@ -1,4 +1,4 @@ -package dev.caskeleton.grpc.policy; +package dev.caskeleton.grpc.api.policy; /** * Whether a call queues while the channel is disconnected, instead of failing fast. diff --git a/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/context/GrpcMetadataBudgetTest.java b/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/context/GrpcMetadataBudgetTest.java similarity index 96% rename from src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/context/GrpcMetadataBudgetTest.java rename to src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/context/GrpcMetadataBudgetTest.java index 8164f2d2..dba71e3f 100644 --- a/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/context/GrpcMetadataBudgetTest.java +++ b/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/context/GrpcMetadataBudgetTest.java @@ -1,13 +1,13 @@ -package dev.caskeleton.grpc.context; +package dev.caskeleton.grpc.api.context; import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.assertThatThrownBy; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.RpcType; -import dev.caskeleton.grpc.deadline.GrpcCancellationToken; -import dev.caskeleton.grpc.deadline.GrpcDeadlineBudget; -import dev.caskeleton.grpc.deadline.GrpcDeadlineProfile; +import dev.caskeleton.grpc.api.deadline.GrpcCancellationToken; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineBudget; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineProfile; import java.time.Duration; import java.util.LinkedHashMap; import java.util.Map; diff --git a/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/deadline/GrpcDeadlineBudgetTest.java b/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineBudgetTest.java similarity index 99% rename from src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/deadline/GrpcDeadlineBudgetTest.java rename to src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineBudgetTest.java index ee87c13b..58fd57a9 100644 --- a/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/deadline/GrpcDeadlineBudgetTest.java +++ b/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/deadline/GrpcDeadlineBudgetTest.java @@ -1,4 +1,4 @@ -package dev.caskeleton.grpc.deadline; +package dev.caskeleton.grpc.api.deadline; import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.assertThatThrownBy; diff --git a/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/error/GrpcFailureContextTest.java b/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/error/GrpcFailureContextTest.java similarity index 99% rename from src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/error/GrpcFailureContextTest.java rename to src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/error/GrpcFailureContextTest.java index 2cdbd5c1..930a7431 100644 --- a/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/error/GrpcFailureContextTest.java +++ b/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/error/GrpcFailureContextTest.java @@ -1,4 +1,4 @@ -package dev.caskeleton.grpc.error; +package dev.caskeleton.grpc.api.error; import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.assertThatThrownBy; diff --git a/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/policy/GrpcMethodPolicyCatalogTest.java b/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicyCatalogTest.java similarity index 98% rename from src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/policy/GrpcMethodPolicyCatalogTest.java rename to src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicyCatalogTest.java index 0a253932..213048f1 100644 --- a/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/policy/GrpcMethodPolicyCatalogTest.java +++ b/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/api/policy/GrpcMethodPolicyCatalogTest.java @@ -1,11 +1,11 @@ -package dev.caskeleton.grpc.policy; +package dev.caskeleton.grpc.api.policy; import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.assertThatThrownBy; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.RpcType; -import dev.caskeleton.grpc.deadline.GrpcDeadlineProfile; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineProfile; import java.time.Duration; import java.util.Set; import org.junit.jupiter.api.DisplayName; diff --git a/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/core/GrpcStableModuleCatalogTest.java b/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/core/GrpcStableModuleCatalogTest.java index 4135d34e..ff156776 100644 --- a/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/core/GrpcStableModuleCatalogTest.java +++ b/src/grpc/grpc-core-api/src/test/java/dev/caskeleton/grpc/core/GrpcStableModuleCatalogTest.java @@ -3,7 +3,10 @@ package dev.caskeleton.grpc.core; import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.assertThatThrownBy; +import java.nio.file.Files; +import java.nio.file.Path; import java.util.Set; +import java.util.regex.Pattern; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; @@ -20,6 +23,33 @@ class GrpcStableModuleCatalogTest { assertThat(GrpcStableBuildInvariant.advancedDependencyAllowed()).isFalse(); } + @Test + @DisplayName("the optional gRPC registry is exactly classified as Stable or Advanced") + void registryAndCatalogStayTogether() throws Exception { + Path candidate = Path.of("").toAbsolutePath(); + while (candidate != null + && !Files.isRegularFile(candidate.resolve("src/config/architecture/modules.json"))) { + candidate = candidate.getParent(); + } + assertThat(candidate).as("repository root").isNotNull(); + String registry = Files.readString(candidate.resolve("src/config/architecture/modules.json")); + Pattern entry = + Pattern.compile( + "\\{[^{}]*\"id\"\\s*:\\s*\"(grpc-[^\"]+)\"[^{}]*" + + "\"build\"\\s*:\\s*\"optional-grpc\"[^{}]*\\}", + Pattern.DOTALL); + Set registered = + entry + .matcher(registry) + .results() + .map(result -> result.group(1)) + .collect(java.util.stream.Collectors.toUnmodifiableSet()); + Set classified = new java.util.HashSet<>(GrpcStableModuleCatalog.standard().modules()); + classified.addAll(GrpcStableModuleCatalog.advancedModules()); + + assertThat(registered).isNotEmpty().containsExactlyInAnyOrderElementsOf(classified); + } + @Test @DisplayName("the Stable and Advanced sets are disjoint") void stableAndAdvancedAreDisjoint() { diff --git a/src/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcRpcObservation.java b/src/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcRpcObservation.java index 470142e6..0aad8330 100644 --- a/src/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcRpcObservation.java +++ b/src/grpc/grpc-observability/src/main/java/dev/caskeleton/grpc/observability/GrpcRpcObservation.java @@ -3,7 +3,7 @@ package dev.caskeleton.grpc.observability; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.GrpcStatusCode; import dev.caskeleton.grpc.core.RpcType; -import dev.caskeleton.grpc.error.GrpcCompletionOutcome; +import dev.caskeleton.grpc.api.error.GrpcCompletionOutcome; import java.time.Duration; import java.util.LinkedHashMap; import java.util.Map; diff --git a/src/grpc/grpc-observability/src/test/java/dev/caskeleton/grpc/observability/GrpcMetricCardinalityPolicyTest.java b/src/grpc/grpc-observability/src/test/java/dev/caskeleton/grpc/observability/GrpcMetricCardinalityPolicyTest.java index 5dcf37d6..9b58357f 100644 --- a/src/grpc/grpc-observability/src/test/java/dev/caskeleton/grpc/observability/GrpcMetricCardinalityPolicyTest.java +++ b/src/grpc/grpc-observability/src/test/java/dev/caskeleton/grpc/observability/GrpcMetricCardinalityPolicyTest.java @@ -6,7 +6,7 @@ import static org.assertj.core.api.Assertions.assertThatThrownBy; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.GrpcStatusCode; import dev.caskeleton.grpc.core.RpcType; -import dev.caskeleton.grpc.error.GrpcCompletionOutcome; +import dev.caskeleton.grpc.api.error.GrpcCompletionOutcome; import io.micrometer.core.instrument.simple.SimpleMeterRegistry; import java.time.Duration; import java.util.LinkedHashMap; diff --git a/src/grpc/grpc-operation-ledger-jpa/build.gradle b/src/grpc/grpc-operation-ledger-jpa/build.gradle index abd71d2a..a4f97083 100644 --- a/src/grpc/grpc-operation-ledger-jpa/build.gradle +++ b/src/grpc/grpc-operation-ledger-jpa/build.gradle @@ -1,14 +1,20 @@ plugins { + id 'ca.auxiliary-source-set' id 'ca.platform-module' } +auxiliarySourceSets { + sourceSet('integrationTest') { + compilesAgainst 'main' + } +} + // Durable mutation idempotency: the operation ledger entity, its state machine, the vendor-neutral // repository port and the Spring Data JPA binding, plus the migration that owns the unique // constraint the whole contract rests on. // -// The port is what the policy layer consumes; the Spring Data interface is the adapter. Tests here -// run against a hand-rolled in-memory port implementation — a real datastore is only justified when -// vendor semantics are the thing under test, and the constraint is asserted by the migration. +// The claim algorithm is PostgreSQL-specific by design (INSERT ... ON CONFLICT DO NOTHING), so its +// atomicity is certified against a real PostgreSQL instead of a hand-written repository fake. dependencies { api project(':grpc:grpc-core-api') @@ -16,4 +22,16 @@ dependencies { // Data type, so both vendor APIs appear in this module's public signatures. api 'jakarta.persistence:jakarta.persistence-api' api 'org.springframework.data:spring-data-jpa' + + integrationTestImplementation 'org.testcontainers:testcontainers-postgresql' + integrationTestImplementation 'org.testcontainers:testcontainers-junit-jupiter' + integrationTestImplementation 'org.postgresql:postgresql' +} + +strictTestLanes { + lane('integrationTest') { + integration() + sourceSet = 'integrationTest' + description = 'Certifies atomic gRPC idempotency claims against real PostgreSQL.' + } } diff --git a/src/grpc/grpc-operation-ledger-jpa/gradle.lockfile b/src/grpc/grpc-operation-ledger-jpa/gradle.lockfile index 2c386903..36472586 100644 --- a/src/grpc/grpc-operation-ledger-jpa/gradle.lockfile +++ b/src/grpc/grpc-operation-ledger-jpa/gradle.lockfile @@ -1,49 +1,57 @@ # This is a Gradle generated file for dependency locking. # Manual edits can break the build and are not advised. # This file is expected to be part of source control. -com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,testAnnotationProcessor -com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,testAnnotationProcessor +com.fasterxml.jackson.core:jackson-annotations:2.21=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.github.docker-java:docker-java-api:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.docker-java:docker-java-transport-zerodep:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.docker-java:docker-java-transport:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor com.github.spotbugs:spotbugs-annotations:4.10.2=spotbugs com.github.spotbugs:spotbugs:4.10.2=spotbugs com.github.stephenc.jcip:jcip-annotations:1.0-1=spotbugs -com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,testAnnotationProcessor -com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,testAnnotationProcessor -com.google.auto:auto-common:1.2.2=annotationProcessor,testAnnotationProcessor +com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.auto:auto-common:1.2.2=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor com.google.code.findbugs:jsr305:3.0.2=checkstyle,spotbugs com.google.code.gson:gson:2.13.2=spotbugs -com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor com.google.errorprone:error_prone_annotations:2.41.0=spotbugs com.google.errorprone:error_prone_annotations:2.47.0=checkstyle -com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,testAnnotationProcessor -com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,testAnnotationProcessor -com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,testAnnotationProcessor -com.google.guava:guava:33.5.0-jre=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.guava:guava:33.5.0-jre=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor com.google.guava:guava:33.6.0-jre=checkstyle -com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,testAnnotationProcessor -com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,testAnnotationProcessor -com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,testAnnotationProcessor +com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins com.puppycrawl.tools:checkstyle:13.5.0=checkstyle commons-beanutils:commons-beanutils:1.11.0=checkstyle +commons-codec:commons-codec:1.19.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath commons-collections:commons-collections:3.2.2=checkstyle +commons-io:commons-io:2.20.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath commons-io:commons-io:2.21.0=spotbugs -commons-logging:commons-logging:1.3.6=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +commons-logging:commons-logging:1.3.6=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath info.picocli:picocli:4.7.7=checkstyle -io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,testAnnotationProcessor -io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,testAnnotationProcessor -io.micrometer:micrometer-commons:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.micrometer:micrometer-observation:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -jakarta.annotation:jakarta.annotation-api:3.0.0=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -jakarta.persistence:jakarta.persistence-api:3.2.0=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -javax.inject:javax.inject:1=annotationProcessor,testAnnotationProcessor +io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +io.micrometer:micrometer-commons:1.16.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.micrometer:micrometer-observation:1.16.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +jakarta.annotation:jakarta.annotation-api:3.0.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +jakarta.persistence:jakarta.persistence-api:3.2.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +javax.inject:javax.inject:1=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor jaxen:jaxen:2.0.6=spotbugs -net.bytebuddy:byte-buddy:1.17.8=testCompileClasspath,testRuntimeClasspath +net.bytebuddy:byte-buddy:1.17.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +net.java.dev.jna:jna:5.18.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs -org.antlr:antlr4-runtime:4.13.2=checkstyle,compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.antlr:antlr4-runtime:4.13.2=checkstyle,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.apache.bcel:bcel:6.12.0=spotbugs -org.apache.commons:commons-lang3:3.20.0=checkstyle,spotbugs +org.apache.commons:commons-compress:1.28.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.apache.commons:commons-lang3:3.20.0=checkstyle,integrationTestCompileClasspath,integrationTestRuntimeClasspath,spotbugs org.apache.commons:commons-text:1.15.0=spotbugs org.apache.commons:commons-text:1.3=checkstyle org.apache.httpcomponents:httpclient:4.5.13=checkstyle @@ -55,45 +63,54 @@ org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle org.apache.xbean:xbean-reflect:3.7=checkstyle -org.apiguardian:apiguardian-api:1.1.2=testCompileClasspath -org.assertj:assertj-core:3.27.7=testCompileClasspath,testRuntimeClasspath +org.apiguardian:apiguardian-api:1.1.2=integrationTestCompileClasspath,testCompileClasspath +org.assertj:assertj-core:3.27.7=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.checkerframework:checker-qual:3.55.1=integrationTestRuntimeClasspath org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle org.codehaus.plexus:plexus-component-annotations:2.1.0=checkstyle org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle org.codehaus.plexus:plexus-utils:3.3.0=checkstyle org.dom4j:dom4j:2.2.0=spotbugs org.javassist:javassist:3.28.0-GA=checkstyle -org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-api:6.0.3=testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-engine:6.0.3=testRuntimeClasspath -org.junit.jupiter:junit-jupiter-params:6.0.3=testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter:6.0.3=testCompileClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-commons:6.0.3=testCompileClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-engine:6.0.3=testRuntimeClasspath -org.junit.platform:junit-platform-launcher:6.0.3=testRuntimeClasspath -org.junit:junit-bom:6.0.3=testCompileClasspath,testRuntimeClasspath +org.jetbrains:annotations:17.0.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,integrationTestAnnotationProcessor,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-api:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-engine:6.0.3=integrationTestRuntimeClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-params:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-commons:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-engine:6.0.3=integrationTestRuntimeClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-launcher:6.0.3=integrationTestRuntimeClasspath,testRuntimeClasspath +org.junit:junit-bom:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.junit:junit-bom:6.1.0=spotbugs org.mockito:mockito-core:5.20.0=mockitoAgent -org.opentest4j:opentest4j:1.3.0=testCompileClasspath,testRuntimeClasspath +org.opentest4j:opentest4j:1.3.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.ow2.asm:asm-analysis:9.10.1=spotbugs org.ow2.asm:asm-commons:9.10.1=spotbugs org.ow2.asm:asm-tree:9.10.1=spotbugs org.ow2.asm:asm-util:9.10.1=spotbugs org.ow2.asm:asm:9.10.1=spotbugs -org.pcollections:pcollections:4.0.1=annotationProcessor,testAnnotationProcessor +org.pcollections:pcollections:4.0.1=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +org.postgresql:postgresql:42.7.13=integrationTestCompileClasspath,integrationTestRuntimeClasspath org.reflections:reflections:0.10.2=checkstyle -org.slf4j:slf4j-api:2.0.18=compileClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testRuntimeClasspath +org.rnorth.duct-tape:duct-tape:1.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.slf4j:slf4j-api:2.0.18=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testRuntimeClasspath org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j org.slf4j:slf4j-simple:2.0.18=checkstyle -org.springframework.data:spring-data-commons:4.0.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.data:spring-data-jpa:4.0.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-aop:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-beans:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-context:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-core:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-expression:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-jdbc:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-orm:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-tx:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.data:spring-data-commons:4.0.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.data:spring-data-jpa:4.0.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-aop:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-beans:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-context:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-core:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-expression:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-jdbc:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-orm:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-tx:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.testcontainers:testcontainers-database-commons:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.testcontainers:testcontainers-jdbc:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.testcontainers:testcontainers-junit-jupiter:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.testcontainers:testcontainers-postgresql:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.testcontainers:testcontainers:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs empty= diff --git a/src/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerPostgresIT.java b/src/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerPostgresIT.java new file mode 100644 index 00000000..98fd2f27 --- /dev/null +++ b/src/grpc/grpc-operation-ledger-jpa/src/integrationTest/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerPostgresIT.java @@ -0,0 +1,159 @@ +package dev.caskeleton.grpc.ledger; + +import static org.assertj.core.api.Assertions.assertThat; + +import java.io.IOException; +import java.io.InputStream; +import java.nio.charset.StandardCharsets; +import java.sql.Connection; +import java.sql.PreparedStatement; +import java.sql.ResultSet; +import java.sql.SQLException; +import java.sql.Statement; +import java.time.Instant; +import java.time.ZoneOffset; +import java.util.List; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.Executors; +import java.util.concurrent.Future; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.postgresql.ds.PGSimpleDataSource; +import org.testcontainers.junit.jupiter.Container; +import org.testcontainers.junit.jupiter.Testcontainers; +import org.testcontainers.postgresql.PostgreSQLContainer; + +/** Certifies the native idempotency claim against the PostgreSQL semantics it depends on. */ +@Testcontainers(disabledWithoutDocker = true) +class GrpcOperationLedgerPostgresIT { + + private static final String STORAGE_KEY = "caller|svc/Create|sha256:key"; + private static final String CALLER = "tenant-1.actor-1"; + private static final String METHOD = "svc/Create"; + private static final String KEY_HASH = + "sha256:aabbccddeeff00112233445566778899aabbccddeeff00112233445566778899"; + private static final String FINGERPRINT = + "sha256:0f1e2d3c4b5a69788796a5b4c3d2e1f00f1e2d3c4b5a69788796a5b4c3d2e1f0"; + private static final String OTHER_FINGERPRINT = + "sha256:1122334455667788990011223344556677889900112233445566778899001122"; + private static final Instant NOW = Instant.parse("2026-09-19T00:00:00Z"); + + @SuppressWarnings("resource") + @Container + private static final PostgreSQLContainer POSTGRES = + new PostgreSQLContainer("postgres:16-alpine") + .withDatabaseName("grpc") + .withUsername("grpc") + .withPassword("grpc"); + + private PGSimpleDataSource dataSource; + + @BeforeEach + void migrate() throws SQLException, IOException { + dataSource = new PGSimpleDataSource(); + dataSource.setUrl(POSTGRES.getJdbcUrl()); + dataSource.setUser(POSTGRES.getUsername()); + dataSource.setPassword(POSTGRES.getPassword()); + + try (Connection connection = dataSource.getConnection(); + Statement statement = connection.createStatement()) { + statement.execute("DROP TABLE IF EXISTS grpc_operation_ledger"); + statement.execute(migration()); + } + } + + @Test + void concurrentClaimsHaveExactlyOneWinner() throws Exception { + CountDownLatch start = new CountDownLatch(1); + try (var executor = Executors.newFixedThreadPool(2)) { + Future first = + executor.submit( + () -> { + start.await(); + return claim(FINGERPRINT); + }); + Future second = + executor.submit( + () -> { + start.await(); + return claim(FINGERPRINT); + }); + + start.countDown(); + + assertThat(List.of(first.get(), second.get())).containsExactlyInAnyOrder(1, 0); + } + } + + @Test + void retryingACommittedClaimDoesNotOverwriteItsOutcome() throws SQLException { + assertThat(claim(FINGERPRINT)).isEqualTo(1); + try (Connection connection = dataSource.getConnection(); + PreparedStatement update = + connection.prepareStatement( + """ + UPDATE grpc_operation_ledger + SET state = 'COMMITTED', outcome_reference = ?, completed_at = ? + WHERE storage_key = ? + """)) { + update.setString(1, "outcome://document/42"); + update.setObject(2, NOW.plusSeconds(1).atOffset(ZoneOffset.UTC)); + update.setString(3, STORAGE_KEY); + assertThat(update.executeUpdate()).isEqualTo(1); + } + + assertThat(claim(OTHER_FINGERPRINT)).isZero(); + + try (Connection connection = dataSource.getConnection(); + PreparedStatement select = + connection.prepareStatement( + """ + SELECT state, outcome_reference, request_fingerprint + FROM grpc_operation_ledger + WHERE storage_key = ? + """)) { + select.setString(1, STORAGE_KEY); + try (ResultSet row = select.executeQuery()) { + assertThat(row.next()).isTrue(); + assertThat(row.getString("state")).isEqualTo("COMMITTED"); + assertThat(row.getString("outcome_reference")).isEqualTo("outcome://document/42"); + assertThat(row.getString("request_fingerprint")).isEqualTo(FINGERPRINT); + } + } + } + + private int claim(String requestFingerprint) throws SQLException { + try (Connection connection = dataSource.getConnection(); + PreparedStatement insert = connection.prepareStatement(jdbcClaimSql())) { + insert.setString(1, STORAGE_KEY); + insert.setString(2, CALLER); + insert.setString(3, METHOD); + insert.setString(4, KEY_HASH); + insert.setString(5, requestFingerprint); + insert.setObject(6, NOW.atOffset(ZoneOffset.UTC)); + return insert.executeUpdate(); + } + } + + private static String jdbcClaimSql() { + return GrpcOperationLedgerRepository.ATOMIC_CLAIM_SQL + .replace(":storageKey", "?") + .replace(":callerFingerprint", "?") + .replace(":fullMethodName", "?") + .replace(":idempotencyKeyHash", "?") + .replace(":requestFingerprint", "?") + .replace(":claimedAt", "?"); + } + + private static String migration() throws IOException { + try (InputStream stream = + GrpcOperationLedgerPostgresIT.class + .getClassLoader() + .getResourceAsStream("db/migration/grpc/V001__create_grpc_operation_ledger.sql")) { + if (stream == null) { + throw new IOException("gRPC operation-ledger migration is missing"); + } + return new String(stream.readAllBytes(), StandardCharsets.UTF_8); + } + } +} diff --git a/src/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerEntity.java b/src/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerEntity.java index fe732dce..0b50ca56 100644 --- a/src/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerEntity.java +++ b/src/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerEntity.java @@ -1,5 +1,9 @@ package dev.caskeleton.grpc.ledger; +import dev.caskeleton.grpc.api.ledger.GrpcOperationIdentity; +import dev.caskeleton.grpc.api.ledger.GrpcOperationLedgerRecord; +import dev.caskeleton.grpc.api.ledger.GrpcOperationLedgerState; + import jakarta.persistence.Column; import jakarta.persistence.Entity; import jakarta.persistence.EnumType; diff --git a/src/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerRepository.java b/src/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerRepository.java index 81aa5aec..5f72d6dc 100644 --- a/src/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerRepository.java +++ b/src/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerRepository.java @@ -1,20 +1,68 @@ package dev.caskeleton.grpc.ledger; +import java.time.Instant; import java.util.Optional; +import org.springframework.data.jpa.repository.Modifying; +import org.springframework.data.jpa.repository.Query; import org.springframework.data.repository.Repository; +import org.springframework.data.repository.query.Param; +import org.springframework.transaction.annotation.Transactional; /** * The narrow persistence interface the ledger adapter needs. * - *

      Extends {@code Repository} rather than {@code JpaRepository}, and the difference is the point: - * {@code JpaRepository} publishes {@code deleteAll}, {@code findAll} and {@code saveAll} on the - * table that decides whether a payment runs twice. Naming the four methods that are actually used - * also makes a hand-rolled test double a few lines rather than thirty stubs. + *

      The claim path is deliberately not {@code save}. A claim entity already has a non-null string + * id, so Spring Data JPA treats it as detached and routes {@code save} through {@code merge}; merge + * can overwrite a committed row back to {@code IN_PROGRESS}. Claiming therefore uses one native + * insert with PostgreSQL conflict handling and decides ownership from the affected-row count. */ public interface GrpcOperationLedgerRepository extends Repository { - /** Inserts or updates a claim. */ + /** Atomic PostgreSQL claim statement, also executed by the real-database certification test. */ + String ATOMIC_CLAIM_SQL = + """ + INSERT INTO grpc_operation_ledger ( + storage_key, + caller_fingerprint, + full_method_name, + idempotency_key_hash, + request_fingerprint, + state, + outcome_reference, + claimed_at, + completed_at + ) VALUES ( + :storageKey, + :callerFingerprint, + :fullMethodName, + :idempotencyKeyHash, + :requestFingerprint, + 'IN_PROGRESS', + NULL, + :claimedAt, + NULL + ) + ON CONFLICT DO NOTHING + """; + + /** + * Attempts to create the claim atomically. + * + * @return one when this caller inserted the claim, zero when another claim already exists + */ + @Modifying + @Transactional + @Query(value = ATOMIC_CLAIM_SQL, nativeQuery = true) + int tryInsertClaim( + @Param("storageKey") String storageKey, + @Param("callerFingerprint") String callerFingerprint, + @Param("fullMethodName") String fullMethodName, + @Param("idempotencyKeyHash") String idempotencyKeyHash, + @Param("requestFingerprint") String requestFingerprint, + @Param("claimedAt") Instant claimedAt); + + /** Updates an existing claim after it has been loaded. */ GrpcOperationLedgerEntity save(GrpcOperationLedgerEntity entity); /** Reads a claim by its derived storage key. */ diff --git a/src/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/JpaGrpcOperationLedger.java b/src/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/JpaGrpcOperationLedger.java index 3c374528..aada9538 100644 --- a/src/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/JpaGrpcOperationLedger.java +++ b/src/grpc/grpc-operation-ledger-jpa/src/main/java/dev/caskeleton/grpc/ledger/JpaGrpcOperationLedger.java @@ -1,18 +1,21 @@ package dev.caskeleton.grpc.ledger; +import dev.caskeleton.grpc.api.ledger.GrpcOperationIdentity; +import dev.caskeleton.grpc.api.ledger.GrpcOperationLedger; +import dev.caskeleton.grpc.api.ledger.GrpcOperationLedgerRecord; + import java.time.Instant; import java.util.Optional; -import org.springframework.dao.DataIntegrityViolationException; /** * The JPA-backed operation ledger. * *

      {@link #claim} is insert-first, read-on-conflict — not read-then-insert. That ordering is the - * whole adapter. Two concurrent attempts with the same idempotency key both try to insert; the - * database's unique constraint lets exactly one through and the other catches the violation and - * reads the winner's row. A read-first implementation has a window between the read and the insert - * that is exactly as wide as the race it is supposed to close, and it passes every test that does - * not run the two attempts concurrently. + * whole adapter. Two concurrent attempts with the same idempotency key both execute one PostgreSQL + * {@code INSERT ... ON CONFLICT DO NOTHING}; the affected-row count identifies the single winner + * and every loser reads the winner's row. The claim path deliberately does not use Spring Data + * {@code save}: this entity has a non-null application-assigned id, so save routes through merge + * and can overwrite an existing terminal row. * *

      No transaction annotations here. The commit is meant to happen inside the caller's business * transaction, and a {@code REQUIRES_NEW} on this adapter would put the ledger in its own @@ -34,14 +37,21 @@ public final class JpaGrpcOperationLedger implements GrpcOperationLedger { public Optional claim( GrpcOperationIdentity identity, String requestFingerprint, Instant now) { requireIdentity(identity); - try { - repository.save(GrpcOperationLedgerEntity.claim(identity, requestFingerprint, now)); + int inserted = + repository.tryInsertClaim( + identity.storageKey(), + identity.callerFingerprint(), + identity.method().canonical(), + identity.idempotencyKeyHash(), + requestFingerprint, + now); + if (inserted == 1) { return Optional.empty(); - } catch (DataIntegrityViolationException alreadyClaimed) { - // The unique constraint fired, which means somebody else won the race. Their row is the - // answer; the exception is how we find out, not a failure. - return repository.findById(identity.storageKey()).map(entity -> entity.toRecord(identity)); } + if (inserted != 0) { + throw new IllegalStateException("claim insert affected an unexpected row count: " + inserted); + } + return repository.findById(identity.storageKey()).map(entity -> entity.toRecord(identity)); } @Override diff --git a/src/grpc/grpc-operation-ledger-jpa/src/test/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerRepositoryTest.java b/src/grpc/grpc-operation-ledger-jpa/src/test/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerRepositoryTest.java index 6ef6ea3a..ae22807c 100644 --- a/src/grpc/grpc-operation-ledger-jpa/src/test/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerRepositoryTest.java +++ b/src/grpc/grpc-operation-ledger-jpa/src/test/java/dev/caskeleton/grpc/ledger/GrpcOperationLedgerRepositoryTest.java @@ -1,5 +1,10 @@ package dev.caskeleton.grpc.ledger; +import dev.caskeleton.grpc.api.ledger.GrpcOperationIdentity; +import dev.caskeleton.grpc.api.ledger.GrpcOperationLedger; +import dev.caskeleton.grpc.api.ledger.GrpcOperationLedgerRecord; +import dev.caskeleton.grpc.api.ledger.GrpcOperationLedgerState; + import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.assertThatThrownBy; @@ -15,7 +20,6 @@ import java.util.concurrent.ConcurrentHashMap; import java.util.concurrent.ConcurrentMap; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; -import org.springframework.dao.DataIntegrityViolationException; class GrpcOperationLedgerRepositoryTest { @@ -30,21 +34,34 @@ class GrpcOperationLedgerRepositoryTest { "sha256:aabbccddeeff00112233445566778899aabbccddeeff00112233445566778899"; /** - * An in-memory stand-in for the Spring Data repository, with the unique constraint the real table - * carries. {@code putIfAbsent} is what makes the claim atomic here for the same reason the - * constraint does there; a fake without it would let the adapter's insert-first ordering pass - * while the property it protects does not hold. + * An in-memory stand-in for Spring Data's non-null-id save semantics. + * + *

      A newly constructed ledger entity already has its string id, so a real {@code + * SimpleJpaRepository.save} treats it as detached and merges it. The old fake used {@code + * putIfAbsent} and therefore tested the database constraint we wished save() would hit rather + * than the merge behavior it actually uses. */ private static final class InMemoryRepository implements GrpcOperationLedgerRepository { private final ConcurrentMap rows = new ConcurrentHashMap<>(); + @Override + public int tryInsertClaim( + String storageKey, + String callerFingerprint, + String fullMethodName, + String idempotencyKeyHash, + String requestFingerprint, + Instant claimedAt) { + GrpcOperationIdentity identity = + new GrpcOperationIdentity( + callerFingerprint, GrpcMethodName.parse(fullMethodName), idempotencyKeyHash); + GrpcOperationLedgerEntity claim = + GrpcOperationLedgerEntity.claim(identity, requestFingerprint, claimedAt); + return rows.putIfAbsent(storageKey, claim) == null ? 1 : 0; + } + @Override public GrpcOperationLedgerEntity save(GrpcOperationLedgerEntity entity) { - GrpcOperationLedgerEntity existing = rows.putIfAbsent(entity.getStorageKey(), entity); - if (existing != null && existing != entity) { - throw new DataIntegrityViolationException( - "uq_grpc_operation_ledger_identity violated for " + entity.getStorageKey()); - } rows.put(entity.getStorageKey(), entity); return entity; } @@ -123,6 +140,21 @@ class GrpcOperationLedgerRepositoryTest { assertThat(record.completedAt()).contains(NOW.plusSeconds(1)); } + @Test + @DisplayName("claiming a committed operation returns the stored outcome without rewriting it") + void retryingACommittedClaimPreservesTheWinner() { + GrpcOperationIdentity id = identity("tenant-1.actor-1"); + assertThat(ledger.claim(id, FINGERPRINT, NOW)).isEmpty(); + ledger.markCommitted(id, "outcome://document/42", NOW.plusSeconds(1)); + + GrpcOperationLedgerRecord retry = + ledger.claim(id, OTHER_FINGERPRINT, NOW.plusSeconds(2)).orElseThrow(); + + assertThat(retry.state()).isEqualTo(GrpcOperationLedgerState.COMMITTED); + assertThat(retry.outcomeReference()).contains("outcome://document/42"); + assertThat(retry.requestFingerprint()).isEqualTo(FINGERPRINT); + } + @Test @DisplayName("a commit without a claim is refused rather than silently inserted") void committingWithoutAClaimIsRefused() { diff --git a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/context/GrpcContextSnapshot.java b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/context/GrpcContextSnapshot.java index e9e35b6a..3aa01328 100644 --- a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/context/GrpcContextSnapshot.java +++ b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/context/GrpcContextSnapshot.java @@ -1,8 +1,11 @@ package dev.caskeleton.grpc.context; +import dev.caskeleton.grpc.api.context.GrpcClientIdentity; +import dev.caskeleton.grpc.api.context.GrpcRequestContext; + import dev.caskeleton.grpc.core.GrpcMethodName; -import dev.caskeleton.grpc.deadline.GrpcCancellationToken; -import dev.caskeleton.grpc.deadline.GrpcDeadlineBudget; +import dev.caskeleton.grpc.api.deadline.GrpcCancellationToken; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineBudget; import java.time.Instant; import java.util.Optional; diff --git a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellationCoordinator.java b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellationCoordinator.java index c2cf6cc4..26fe0415 100644 --- a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellationCoordinator.java +++ b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/deadline/GrpcCancellationCoordinator.java @@ -1,5 +1,7 @@ package dev.caskeleton.grpc.deadline; +import dev.caskeleton.grpc.api.deadline.GrpcCancellationToken; + import java.time.Instant; import java.util.ArrayList; import java.util.LinkedHashMap; diff --git a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlineCalculator.java b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlineCalculator.java index a9ddfdd4..6790c710 100644 --- a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlineCalculator.java +++ b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlineCalculator.java @@ -1,7 +1,10 @@ package dev.caskeleton.grpc.deadline; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineBudget; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineProfile; + import dev.caskeleton.grpc.core.RpcType; -import dev.caskeleton.grpc.policy.GrpcMethodPolicy; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicy; import java.time.Duration; /** diff --git a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlinePolicyValidator.java b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlinePolicyValidator.java index 41788929..46ef8ef4 100644 --- a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlinePolicyValidator.java +++ b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/deadline/GrpcDeadlinePolicyValidator.java @@ -2,8 +2,8 @@ package dev.caskeleton.grpc.deadline; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.RpcType; -import dev.caskeleton.grpc.policy.GrpcMethodPolicy; -import dev.caskeleton.grpc.policy.GrpcMethodPolicyCatalog; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicy; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicyCatalog; import java.util.ArrayList; import java.util.List; import java.util.Map; diff --git a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/error/GrpcErrorMapper.java b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/error/GrpcErrorMapper.java index aaf8567c..cad91263 100644 --- a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/error/GrpcErrorMapper.java +++ b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/error/GrpcErrorMapper.java @@ -1,5 +1,9 @@ package dev.caskeleton.grpc.error; +import dev.caskeleton.grpc.api.error.GrpcFailureCategory; +import dev.caskeleton.grpc.api.error.GrpcFailureContext; +import dev.caskeleton.grpc.api.error.GrpcPlatformException; + import dev.caskeleton.grpc.core.GrpcStatusCode; import dev.caskeleton.grpc.validation.GrpcValidationViolation; import io.grpc.Metadata; diff --git a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/error/GrpcStatusMapping.java b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/error/GrpcStatusMapping.java index ba20db95..afa001e5 100644 --- a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/error/GrpcStatusMapping.java +++ b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/error/GrpcStatusMapping.java @@ -1,5 +1,7 @@ package dev.caskeleton.grpc.error; +import dev.caskeleton.grpc.api.error.GrpcFailureCategory; + import dev.caskeleton.grpc.core.GrpcStatusCode; import io.grpc.Status; diff --git a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyInterceptor.java b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyInterceptor.java index 10ba5bc8..8f1fd519 100644 --- a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyInterceptor.java +++ b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyInterceptor.java @@ -1,12 +1,12 @@ package dev.caskeleton.grpc.idempotency; import dev.caskeleton.grpc.core.GrpcMethodName; -import dev.caskeleton.grpc.ledger.GrpcOperationIdentity; -import dev.caskeleton.grpc.ledger.GrpcOperationLedger; -import dev.caskeleton.grpc.ledger.GrpcOperationLedgerRecord; -import dev.caskeleton.grpc.ledger.GrpcOperationLedgerState; -import dev.caskeleton.grpc.policy.GrpcMethodPolicy; -import dev.caskeleton.grpc.policy.GrpcMethodPolicyCatalog; +import dev.caskeleton.grpc.api.ledger.GrpcOperationIdentity; +import dev.caskeleton.grpc.api.ledger.GrpcOperationLedger; +import dev.caskeleton.grpc.api.ledger.GrpcOperationLedgerRecord; +import dev.caskeleton.grpc.api.ledger.GrpcOperationLedgerState; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicy; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicyCatalog; import java.time.Duration; import java.time.Instant; import java.util.Optional; diff --git a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOperationStatusQuery.java b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOperationStatusQuery.java index 678d54ab..290c14f9 100644 --- a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOperationStatusQuery.java +++ b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOperationStatusQuery.java @@ -1,10 +1,10 @@ package dev.caskeleton.grpc.idempotency; import dev.caskeleton.grpc.core.GrpcMethodName; -import dev.caskeleton.grpc.deadline.GrpcDeadlineProfile; -import dev.caskeleton.grpc.ledger.GrpcOperationIdentity; -import dev.caskeleton.grpc.ledger.GrpcOperationLedger; -import dev.caskeleton.grpc.ledger.GrpcOperationLedgerRecord; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineProfile; +import dev.caskeleton.grpc.api.ledger.GrpcOperationIdentity; +import dev.caskeleton.grpc.api.ledger.GrpcOperationLedger; +import dev.caskeleton.grpc.api.ledger.GrpcOperationLedgerRecord; import java.time.Duration; import java.util.Optional; diff --git a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOutcomeReplay.java b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOutcomeReplay.java index 6d60c35f..c856d084 100644 --- a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOutcomeReplay.java +++ b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/idempotency/GrpcOutcomeReplay.java @@ -1,37 +1,54 @@ package dev.caskeleton.grpc.idempotency; +import java.util.Iterator; +import java.util.LinkedHashMap; +import java.util.Map; import java.util.Optional; -import java.util.concurrent.ConcurrentHashMap; -import java.util.concurrent.ConcurrentMap; /** * Returns the stored answer for an operation that already committed. * *

      Separated from the ledger because the two have different size problems. The ledger row must * stay small and is written inside the business transaction; a response may be large and is only - * needed if somebody actually retries. So the ledger stores a reference and this resolves it, - * against whatever the deployment chose — a small inline store, an object store, or a re-read of - * the committed resource. + * needed if somebody actually retries. This in-memory implementation is deliberately bounded; a + * deployment that needs durable or larger replay should keep the response behind an object + * reference instead. */ public final class GrpcOutcomeReplay { - private final ConcurrentMap storedOutcomes = new ConcurrentHashMap<>(); + private static final int DEFAULT_MAX_ENTRIES = 1024; + + private final Map storedOutcomes = new LinkedHashMap<>(16, 0.75f, true); private final int maxInlineBytes; + private final int maxEntries; + + /** + * Creates a bounded in-memory replay store with the default entry ceiling. + * + * @param maxInlineBytes the largest response stored inline + */ + public GrpcOutcomeReplay(int maxInlineBytes) { + this(maxInlineBytes, DEFAULT_MAX_ENTRIES); + } /** * @param maxInlineBytes the largest response stored inline; anything larger must be kept behind a - * reference in an object store instead, which is why {@link #store} refuses it rather than - * silently truncating + * reference in an object store instead + * @param maxEntries the maximum number of inline outcomes retained in-process */ - public GrpcOutcomeReplay(int maxInlineBytes) { + public GrpcOutcomeReplay(int maxInlineBytes, int maxEntries) { if (maxInlineBytes < 1) { throw new IllegalArgumentException("an inline outcome store needs a positive size limit"); } + if (maxEntries < 1) { + throw new IllegalArgumentException("an inline outcome store needs a positive entry limit"); + } this.maxInlineBytes = maxInlineBytes; + this.maxEntries = maxEntries; } /** Stores a response under {@code outcomeReference}. */ - public void store(String outcomeReference, byte[] serializedResponse) { + public synchronized void store(String outcomeReference, byte[] serializedResponse) { if (outcomeReference == null || outcomeReference.isBlank()) { throw new IllegalArgumentException("an outcome needs a reference to be stored under"); } @@ -47,16 +64,21 @@ public final class GrpcOutcomeReplay { + "; store it behind an object reference instead"); } storedOutcomes.put(outcomeReference, serializedResponse.clone()); + while (storedOutcomes.size() > maxEntries) { + Iterator> iterator = storedOutcomes.entrySet().iterator(); + iterator.next(); + iterator.remove(); + } } /** The stored response, if there is one. */ - public Optional replay(String outcomeReference) { + public synchronized Optional replay(String outcomeReference) { byte[] stored = storedOutcomes.get(outcomeReference); return Optional.ofNullable(stored).map(byte[]::clone); } /** How many outcomes are held. */ - public int size() { + public synchronized int size() { return storedOutcomes.size(); } } diff --git a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryCoordinator.java b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryCoordinator.java index c96684c3..43578a95 100644 --- a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryCoordinator.java +++ b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryCoordinator.java @@ -1,9 +1,9 @@ package dev.caskeleton.grpc.resilience; import dev.caskeleton.grpc.core.GrpcStatusCode; -import dev.caskeleton.grpc.deadline.GrpcDeadlineBudget; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineBudget; import dev.caskeleton.grpc.evidence.GrpcExecutionEvidence; -import dev.caskeleton.grpc.policy.GrpcMethodPolicy; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicy; import java.time.Duration; import java.util.random.RandomGenerator; diff --git a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryEligibility.java b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryEligibility.java index e0571ff1..2f9a0c06 100644 --- a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryEligibility.java +++ b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryEligibility.java @@ -2,8 +2,8 @@ package dev.caskeleton.grpc.resilience; import dev.caskeleton.grpc.core.GrpcStatusCode; import dev.caskeleton.grpc.evidence.GrpcExecutionEvidence; -import dev.caskeleton.grpc.policy.GrpcMethodPolicy; -import dev.caskeleton.grpc.policy.RpcIdempotencyProfile; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicy; +import dev.caskeleton.grpc.api.policy.RpcIdempotencyProfile; /** * Whether an attempt may be repeated at all, judged from the method, the evidence and the status diff --git a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryOwner.java b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryOwner.java index 49a494de..c4b443a0 100644 --- a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryOwner.java +++ b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryOwner.java @@ -33,7 +33,7 @@ public enum GrpcRetryOwner { } /** Whether hedging may be configured under this owner. */ - public boolean hedgingAllowed() { + public boolean permitsHedging() { return this == GRPC_PLATFORM; } } diff --git a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryOwnershipValidator.java b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryOwnershipValidator.java index aac2dccf..b19faea0 100644 --- a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryOwnershipValidator.java +++ b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcRetryOwnershipValidator.java @@ -1,8 +1,8 @@ package dev.caskeleton.grpc.resilience; import dev.caskeleton.grpc.core.GrpcMethodName; -import dev.caskeleton.grpc.policy.GrpcMethodPolicy; -import dev.caskeleton.grpc.policy.GrpcMethodPolicyCatalog; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicy; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicyCatalog; import java.util.ArrayList; import java.util.LinkedHashSet; import java.util.List; @@ -71,7 +71,7 @@ public final class GrpcRetryOwnershipValidator { }); if (serviceConfig.retryOwner() == GrpcRetryOwner.SERVICE_MESH - && serviceConfig.hedgingAllowed()) { + && serviceConfig.retryOwnerPermitsHedging()) { violations.add("a mesh-owned channel may not also configure hedging in-process"); } return List.copyOf(violations); diff --git a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcServiceConfigPolicy.java b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcServiceConfigPolicy.java index 3abcd702..11b71b6c 100644 --- a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcServiceConfigPolicy.java +++ b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcServiceConfigPolicy.java @@ -67,7 +67,7 @@ public record GrpcServiceConfigPolicy( } /** Whether hedging may be configured on this channel. */ - public boolean hedgingAllowed() { - return retryOwner.hedgingAllowed(); + public boolean retryOwnerPermitsHedging() { + return retryOwner.permitsHedging(); } } diff --git a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyProfile.java b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyProfile.java index c9a07d74..8123e6d5 100644 --- a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyProfile.java +++ b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyProfile.java @@ -1,6 +1,6 @@ package dev.caskeleton.grpc.resilience; -import dev.caskeleton.grpc.policy.WaitForReadyPolicy; +import dev.caskeleton.grpc.api.policy.WaitForReadyPolicy; import java.time.Duration; /** diff --git a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyValidator.java b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyValidator.java index e1167cfc..f41151da 100644 --- a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyValidator.java +++ b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyValidator.java @@ -1,7 +1,7 @@ package dev.caskeleton.grpc.resilience; -import dev.caskeleton.grpc.deadline.GrpcDeadlineBudget; -import dev.caskeleton.grpc.policy.GrpcMethodPolicy; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineBudget; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicy; import java.time.Duration; /** diff --git a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/streaming/GrpcSerializedStreamWriter.java b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/streaming/GrpcSerializedStreamWriter.java index d46cc22f..166638a3 100644 --- a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/streaming/GrpcSerializedStreamWriter.java +++ b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/streaming/GrpcSerializedStreamWriter.java @@ -28,7 +28,7 @@ public final class GrpcSerializedStreamWriter { private final GrpcFlowControlPolicy flowControl; private final Consumer> transport; private final LongSupplier payloadSizer; - private final Deque> queue = new ArrayDeque<>(); + private final Deque> queue = new ArrayDeque<>(); private GrpcStreamWriterState state = GrpcStreamWriterState.OPEN; private long queuedBytes; @@ -79,13 +79,23 @@ public final class GrpcSerializedStreamWriter { yield GrpcStreamWriteResult.OVERFLOW_TERMINATING; } case DROP_OLDEST -> { - GrpcStreamEnvelope dropped = queue.pollFirst(); - if (dropped != null) { - queuedBytes = Math.max(0L, queuedBytes - nextBytes); + while (true) { + QueuedEnvelope dropped = queue.pollFirst(); + if (dropped == null) { + // The incoming message cannot fit even into an empty bounded queue. A lossy profile + // drops that message rather than violating the byte bound it exists to enforce. + droppedMessages++; + yield GrpcStreamWriteResult.DROPPED; + } + queuedBytes = Math.max(0L, queuedBytes - dropped.serializedBytes()); droppedMessages++; + GrpcFlowControlDecision afterDrop = + flowControl.decide(queue.size(), queuedBytes, nextBytes, transportReady); + if (afterDrop.action() != GrpcFlowControlDecision.Action.DROP_OLDEST) { + enqueue(kind, payload, snapshotVersion, resumeToken, nextBytes); + yield GrpcStreamWriteResult.DROPPED; + } } - enqueue(kind, payload, snapshotVersion, resumeToken, nextBytes); - yield GrpcStreamWriteResult.DROPPED; } case PAUSE, PROCEED -> { enqueue(kind, payload, snapshotVersion, resumeToken, nextBytes); @@ -101,8 +111,10 @@ public final class GrpcSerializedStreamWriter { String resumeToken, long bytes) { queue.addLast( - GrpcStreamEnvelope.message( - streamId, sequence.next(), kind, payload, snapshotVersion, resumeToken)); + new QueuedEnvelope<>( + GrpcStreamEnvelope.message( + streamId, sequence.next(), kind, payload, snapshotVersion, resumeToken), + bytes)); queuedBytes += bytes; } @@ -114,7 +126,7 @@ public final class GrpcSerializedStreamWriter { public synchronized List flush() { java.util.List flushed = new java.util.ArrayList<>(); while (!queue.isEmpty()) { - GrpcStreamEnvelope envelope = queue.pollFirst(); + GrpcStreamEnvelope envelope = queue.pollFirst().envelope(); transport.accept(envelope); lastFlushedSequence = envelope.sequence(); flushed.add(envelope.sequence()); @@ -173,4 +185,12 @@ public final class GrpcSerializedStreamWriter { public synchronized Optional lastFlushedSequence() { return lastFlushedSequence == 0L ? Optional.empty() : Optional.of(lastFlushedSequence); } + + private record QueuedEnvelope(GrpcStreamEnvelope envelope, long serializedBytes) { + private QueuedEnvelope { + if (envelope == null || serializedBytes < 0L) { + throw new IllegalArgumentException("a queued envelope needs a message and byte size"); + } + } + } } diff --git a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamAdmission.java b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamAdmission.java index 5b6c02fb..2c58baf0 100644 --- a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamAdmission.java +++ b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/streaming/GrpcStreamAdmission.java @@ -35,7 +35,7 @@ public final class GrpcStreamAdmission { * * @return false when either bound is reached; the caller answers RESOURCE_EXHAUSTED */ - public boolean tryAdmit(String callerFingerprint) { + public synchronized boolean tryAdmit(String callerFingerprint) { if (callerFingerprint == null || callerFingerprint.isBlank()) { throw new IllegalArgumentException("stream admission needs a caller fingerprint"); } @@ -53,14 +53,16 @@ public final class GrpcStreamAdmission { } /** Releases a stream's slot. */ - public void release(String callerFingerprint) { + public synchronized void release(String callerFingerprint) { AtomicInteger callerCount = perCaller.get(callerFingerprint); - if (callerCount != null && callerCount.get() > 0) { - callerCount.decrementAndGet(); + if (callerCount == null || callerCount.get() <= 0) { + return; } - if (openStreams.get() > 0) { - openStreams.decrementAndGet(); + int remaining = callerCount.decrementAndGet(); + if (remaining == 0) { + perCaller.remove(callerFingerprint, callerCount); } + openStreams.decrementAndGet(); } /** How many streams are open. */ @@ -73,4 +75,8 @@ public final class GrpcStreamAdmission { AtomicInteger callerCount = perCaller.get(callerFingerprint); return callerCount == null ? 0 : callerCount.get(); } + + int trackedCallers() { + return perCaller.size(); + } } diff --git a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/validation/ProtovalidateGrpcInterceptor.java b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/validation/GrpcValidationInterceptor.java similarity index 97% rename from src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/validation/ProtovalidateGrpcInterceptor.java rename to src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/validation/GrpcValidationInterceptor.java index 88d7e307..027ff6f9 100644 --- a/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/validation/ProtovalidateGrpcInterceptor.java +++ b/src/grpc/grpc-policy/src/main/java/dev/caskeleton/grpc/validation/GrpcValidationInterceptor.java @@ -20,7 +20,7 @@ import java.util.Map; * carries only field paths and reason constants. The rejected values never leave the process — * which is the reason {@link GrpcValidationViolation} has nowhere to put them. */ -public final class ProtovalidateGrpcInterceptor implements ServerInterceptor { +public final class GrpcValidationInterceptor implements ServerInterceptor { /** Trailer carrying the violated field paths and reasons, comma-separated. */ public static final Metadata.Key VIOLATIONS_KEY = @@ -35,7 +35,7 @@ public final class ProtovalidateGrpcInterceptor implements ServerInterceptor { * entry is passed through untouched rather than rejected, because "this method has no * transport constraints" is a legitimate state */ - public ProtovalidateGrpcInterceptor( + public GrpcValidationInterceptor( Map> validatorsByFullMethodName) { if (validatorsByFullMethodName == null) { throw new IllegalArgumentException("the validator map must not be null"); diff --git a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/context/GrpcContextBinderTest.java b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/context/GrpcContextBinderTest.java index 27c150bb..2a6db44f 100644 --- a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/context/GrpcContextBinderTest.java +++ b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/context/GrpcContextBinderTest.java @@ -1,13 +1,17 @@ package dev.caskeleton.grpc.context; +import dev.caskeleton.grpc.api.context.GrpcClientIdentity; +import dev.caskeleton.grpc.api.context.GrpcMetadataBudget; +import dev.caskeleton.grpc.api.context.GrpcRequestContext; + import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.assertThatThrownBy; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.RpcType; -import dev.caskeleton.grpc.deadline.GrpcCancellationToken; -import dev.caskeleton.grpc.deadline.GrpcDeadlineBudget; -import dev.caskeleton.grpc.deadline.GrpcDeadlineProfile; +import dev.caskeleton.grpc.api.deadline.GrpcCancellationToken; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineBudget; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineProfile; import java.time.Duration; import java.time.Instant; import java.util.Map; diff --git a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/deadline/GrpcCancellationCoordinatorTest.java b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/deadline/GrpcCancellationCoordinatorTest.java index d8a98858..602e8485 100644 --- a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/deadline/GrpcCancellationCoordinatorTest.java +++ b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/deadline/GrpcCancellationCoordinatorTest.java @@ -1,5 +1,7 @@ package dev.caskeleton.grpc.deadline; +import dev.caskeleton.grpc.api.deadline.GrpcCancellationToken; + import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.assertThatThrownBy; diff --git a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/deadline/GrpcDeadlineCalculatorTest.java b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/deadline/GrpcDeadlineCalculatorTest.java index 2c176145..5260666b 100644 --- a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/deadline/GrpcDeadlineCalculatorTest.java +++ b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/deadline/GrpcDeadlineCalculatorTest.java @@ -1,11 +1,14 @@ package dev.caskeleton.grpc.deadline; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineBudget; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineProfile; + import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.assertThatThrownBy; import dev.caskeleton.grpc.core.GrpcMethodName; -import dev.caskeleton.grpc.policy.GrpcMethodPolicy; -import dev.caskeleton.grpc.policy.GrpcMethodPolicyCatalog; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicy; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicyCatalog; import java.time.Duration; import java.util.Map; import java.util.Set; diff --git a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/error/GrpcErrorMapperTest.java b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/error/GrpcErrorMapperTest.java index 87d78ad7..134032d2 100644 --- a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/error/GrpcErrorMapperTest.java +++ b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/error/GrpcErrorMapperTest.java @@ -1,5 +1,10 @@ package dev.caskeleton.grpc.error; +import dev.caskeleton.grpc.api.error.GrpcCompletionOutcome; +import dev.caskeleton.grpc.api.error.GrpcFailureCategory; +import dev.caskeleton.grpc.api.error.GrpcFailureContext; +import dev.caskeleton.grpc.api.error.GrpcPlatformException; + import static org.assertj.core.api.Assertions.assertThat; import dev.caskeleton.grpc.core.GrpcMethodName; diff --git a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/idempotency/GrpcCompletionReconcilerTest.java b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/idempotency/GrpcCompletionReconcilerTest.java index e074d50e..afb8e98f 100644 --- a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/idempotency/GrpcCompletionReconcilerTest.java +++ b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/idempotency/GrpcCompletionReconcilerTest.java @@ -22,7 +22,7 @@ class GrpcCompletionReconcilerTest { private void claim() { ledger.claim( - new dev.caskeleton.grpc.ledger.GrpcOperationIdentity( + new dev.caskeleton.grpc.api.ledger.GrpcOperationIdentity( CALLER, CREATE, GrpcRequestFingerprint.hashIdempotencyKey(KEY)), GrpcRequestFingerprint.of("body"), NOW); @@ -66,7 +66,7 @@ class GrpcCompletionReconcilerTest { void aCommittedOperationReturnsItsStoredOutcome() { claim(); ledger.markCommitted( - new dev.caskeleton.grpc.ledger.GrpcOperationIdentity( + new dev.caskeleton.grpc.api.ledger.GrpcOperationIdentity( CALLER, CREATE, GrpcRequestFingerprint.hashIdempotencyKey(KEY)), "outcome://document/42", NOW.plusSeconds(1)); @@ -89,7 +89,7 @@ class GrpcCompletionReconcilerTest { void theLedgerIsConsultedFirst() { claim(); ledger.markCommitted( - new dev.caskeleton.grpc.ledger.GrpcOperationIdentity( + new dev.caskeleton.grpc.api.ledger.GrpcOperationIdentity( CALLER, CREATE, GrpcRequestFingerprint.hashIdempotencyKey(KEY)), "outcome://from-ledger", NOW.plusSeconds(1)); diff --git a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyInterceptorTest.java b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyInterceptorTest.java index 38b2dcfc..6bc95db4 100644 --- a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyInterceptorTest.java +++ b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/idempotency/GrpcIdempotencyInterceptorTest.java @@ -5,11 +5,11 @@ import static org.assertj.core.api.Assertions.assertThatThrownBy; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.RpcType; -import dev.caskeleton.grpc.deadline.GrpcDeadlineProfile; -import dev.caskeleton.grpc.policy.GrpcMethodPolicy; -import dev.caskeleton.grpc.policy.GrpcMethodPolicyCatalog; -import dev.caskeleton.grpc.policy.RpcIdempotencyProfile; -import dev.caskeleton.grpc.policy.WaitForReadyPolicy; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineProfile; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicy; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicyCatalog; +import dev.caskeleton.grpc.api.policy.RpcIdempotencyProfile; +import dev.caskeleton.grpc.api.policy.WaitForReadyPolicy; import java.time.Duration; import java.time.Instant; import org.junit.jupiter.api.DisplayName; @@ -151,7 +151,7 @@ class GrpcIdempotencyInterceptorTest { assertThat(hashed).startsWith("sha256:").doesNotContain(KEY); assertThat( - new dev.caskeleton.grpc.ledger.GrpcOperationIdentity(CALLER, CREATE, hashed) + new dev.caskeleton.grpc.api.ledger.GrpcOperationIdentity(CALLER, CREATE, hashed) .storageKey()) .doesNotContain(KEY); } diff --git a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/idempotency/GrpcOutcomeReplayBoundTest.java b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/idempotency/GrpcOutcomeReplayBoundTest.java new file mode 100644 index 00000000..db270606 --- /dev/null +++ b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/idempotency/GrpcOutcomeReplayBoundTest.java @@ -0,0 +1,24 @@ +package dev.caskeleton.grpc.idempotency; + +import static org.assertj.core.api.Assertions.assertThat; + +import org.junit.jupiter.api.Test; + +class GrpcOutcomeReplayBoundTest { + + @Test + void boundedReplayEvictsTheLeastRecentlyUsedOutcome() { + GrpcOutcomeReplay replay = new GrpcOutcomeReplay(16, 2); + + replay.store("one", new byte[] {1}); + replay.store("two", new byte[] {2}); + assertThat(replay.replay("one")).isPresent(); + + replay.store("three", new byte[] {3}); + + assertThat(replay.replay("one")).isPresent(); + assertThat(replay.replay("two")).isEmpty(); + assertThat(replay.replay("three")).isPresent(); + assertThat(replay.size()).isEqualTo(2); + } +} diff --git a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/idempotency/InMemoryOperationLedger.java b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/idempotency/InMemoryOperationLedger.java index 25f33ac3..8d79058e 100644 --- a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/idempotency/InMemoryOperationLedger.java +++ b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/idempotency/InMemoryOperationLedger.java @@ -1,9 +1,9 @@ package dev.caskeleton.grpc.idempotency; -import dev.caskeleton.grpc.ledger.GrpcOperationIdentity; -import dev.caskeleton.grpc.ledger.GrpcOperationLedger; -import dev.caskeleton.grpc.ledger.GrpcOperationLedgerRecord; -import dev.caskeleton.grpc.ledger.GrpcOperationLedgerState; +import dev.caskeleton.grpc.api.ledger.GrpcOperationIdentity; +import dev.caskeleton.grpc.api.ledger.GrpcOperationLedger; +import dev.caskeleton.grpc.api.ledger.GrpcOperationLedgerRecord; +import dev.caskeleton.grpc.api.ledger.GrpcOperationLedgerState; import java.time.Instant; import java.util.Optional; import java.util.concurrent.ConcurrentHashMap; diff --git a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/resilience/GrpcRetryEligibilityTest.java b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/resilience/GrpcRetryEligibilityTest.java index 2d189033..419f7347 100644 --- a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/resilience/GrpcRetryEligibilityTest.java +++ b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/resilience/GrpcRetryEligibilityTest.java @@ -5,15 +5,15 @@ import static org.assertj.core.api.Assertions.assertThat; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.GrpcStatusCode; import dev.caskeleton.grpc.core.RpcType; -import dev.caskeleton.grpc.deadline.GrpcDeadlineBudget; -import dev.caskeleton.grpc.deadline.GrpcDeadlineProfile; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineBudget; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineProfile; import dev.caskeleton.grpc.evidence.GrpcBusinessEvidence; import dev.caskeleton.grpc.evidence.GrpcExecutionEvidence; import dev.caskeleton.grpc.evidence.GrpcStreamEvidence; import dev.caskeleton.grpc.evidence.GrpcTransportEvidence; -import dev.caskeleton.grpc.policy.GrpcMethodPolicy; -import dev.caskeleton.grpc.policy.RpcIdempotencyProfile; -import dev.caskeleton.grpc.policy.WaitForReadyPolicy; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicy; +import dev.caskeleton.grpc.api.policy.RpcIdempotencyProfile; +import dev.caskeleton.grpc.api.policy.WaitForReadyPolicy; import java.time.Duration; import java.util.random.RandomGenerator; import org.junit.jupiter.api.DisplayName; diff --git a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/resilience/GrpcRetryOwnershipValidatorTest.java b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/resilience/GrpcRetryOwnershipValidatorTest.java index 9127f91c..9c05de4c 100644 --- a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/resilience/GrpcRetryOwnershipValidatorTest.java +++ b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/resilience/GrpcRetryOwnershipValidatorTest.java @@ -6,11 +6,11 @@ import static org.assertj.core.api.Assertions.assertThatThrownBy; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.GrpcStatusCode; import dev.caskeleton.grpc.core.RpcType; -import dev.caskeleton.grpc.deadline.GrpcDeadlineProfile; -import dev.caskeleton.grpc.policy.GrpcMethodPolicy; -import dev.caskeleton.grpc.policy.GrpcMethodPolicyCatalog; -import dev.caskeleton.grpc.policy.RpcIdempotencyProfile; -import dev.caskeleton.grpc.policy.WaitForReadyPolicy; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineProfile; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicy; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicyCatalog; +import dev.caskeleton.grpc.api.policy.RpcIdempotencyProfile; +import dev.caskeleton.grpc.api.policy.WaitForReadyPolicy; import java.time.Duration; import java.util.Map; import java.util.Set; @@ -52,8 +52,8 @@ class GrpcRetryOwnershipValidatorTest { assertThat(GrpcRetryOwner.GRPC_PLATFORM.explicitRetryInProcess()).isTrue(); assertThat(GrpcRetryOwner.SERVICE_MESH.explicitRetryInProcess()).isFalse(); assertThat(GrpcRetryOwner.NONE.explicitRetryInProcess()).isFalse(); - assertThat(GrpcRetryOwner.GRPC_PLATFORM.hedgingAllowed()).isTrue(); - assertThat(GrpcRetryOwner.SERVICE_MESH.hedgingAllowed()).isFalse(); + assertThat(GrpcRetryOwner.GRPC_PLATFORM.permitsHedging()).isTrue(); + assertThat(GrpcRetryOwner.SERVICE_MESH.permitsHedging()).isFalse(); } @Test @@ -75,7 +75,7 @@ class GrpcRetryOwnershipValidatorTest { GrpcServiceConfigPolicy mesh = GrpcServiceConfigPolicy.meshOwned(Map.of(GET, GrpcMethodRetryConfig.disabled(GET))); - assertThat(mesh.hedgingAllowed()).isFalse(); + assertThat(mesh.retryOwnerPermitsHedging()).isFalse(); assertThat(GrpcRetryOwnershipValidator.validate(mesh, catalog())).isEmpty(); } diff --git a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyValidatorTest.java b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyValidatorTest.java index fcb783c7..e76baf57 100644 --- a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyValidatorTest.java +++ b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/resilience/GrpcWaitForReadyValidatorTest.java @@ -5,11 +5,11 @@ import static org.assertj.core.api.Assertions.assertThatThrownBy; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.RpcType; -import dev.caskeleton.grpc.deadline.GrpcDeadlineBudget; -import dev.caskeleton.grpc.deadline.GrpcDeadlineProfile; -import dev.caskeleton.grpc.policy.GrpcMethodPolicy; -import dev.caskeleton.grpc.policy.RpcIdempotencyProfile; -import dev.caskeleton.grpc.policy.WaitForReadyPolicy; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineBudget; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineProfile; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicy; +import dev.caskeleton.grpc.api.policy.RpcIdempotencyProfile; +import dev.caskeleton.grpc.api.policy.WaitForReadyPolicy; import java.time.Duration; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; diff --git a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/streaming/GrpcSerializedStreamWriterTest.java b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/streaming/GrpcSerializedStreamWriterTest.java index a897c56e..7976eea2 100644 --- a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/streaming/GrpcSerializedStreamWriterTest.java +++ b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/streaming/GrpcSerializedStreamWriterTest.java @@ -9,6 +9,7 @@ import java.util.concurrent.CountDownLatch; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicLong; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; @@ -110,6 +111,56 @@ class GrpcSerializedStreamWriterTest { assertThat(writer.queuedMessages()).isEqualTo(1); } + @Test + @DisplayName("DROP_OLDEST subtracts the dropped message bytes, not the next message bytes") + void dropOldestKeepsByteAccountingExactForVariableSizedMessages() { + AtomicLong nextSize = new AtomicLong(); + GrpcSerializedStreamWriter writer = + new GrpcSerializedStreamWriter<>( + STREAM, + GrpcStreamSequence.forNewStream(STREAM), + new GrpcFlowControlPolicy(10, 1000L, 9, GrpcSlowConsumerPolicy.DROP_OLDEST), + sent::add, + nextSize::get); + + nextSize.set(900L); + assertThat(writer.write(GrpcStreamEnvelope.Kind.LIVE, "large", null, null, true)) + .isEqualTo(GrpcStreamWriteResult.ACCEPTED); + + nextSize.set(200L); + assertThat(writer.write(GrpcStreamEnvelope.Kind.LIVE, "small", null, null, true)) + .isEqualTo(GrpcStreamWriteResult.DROPPED); + + // Correct accounting is now 200 bytes. The old bug subtracted 200 rather than the dropped + // 900-byte message, leaving a phantom 900 bytes and causing this write to drop again. + nextSize.set(300L); + assertThat(writer.write(GrpcStreamEnvelope.Kind.LIVE, "medium", null, null, true)) + .isEqualTo(GrpcStreamWriteResult.ACCEPTED); + assertThat(writer.droppedMessages()).isEqualTo(1); + } + + @Test + @DisplayName("DROP_OLDEST removes as many queued messages as the byte bound requires") + void dropOldestRepeatsUntilTheIncomingMessageFits() { + AtomicLong nextSize = new AtomicLong(300L); + GrpcSerializedStreamWriter writer = + new GrpcSerializedStreamWriter<>( + STREAM, + GrpcStreamSequence.forNewStream(STREAM), + new GrpcFlowControlPolicy(10, 700L, 9, GrpcSlowConsumerPolicy.DROP_OLDEST), + sent::add, + nextSize::get); + writer.write(GrpcStreamEnvelope.Kind.LIVE, "first", null, null, true); + writer.write(GrpcStreamEnvelope.Kind.LIVE, "second", null, null, true); + + nextSize.set(600L); + assertThat(writer.write(GrpcStreamEnvelope.Kind.LIVE, "large", null, null, true)) + .isEqualTo(GrpcStreamWriteResult.DROPPED); + + assertThat(writer.droppedMessages()).isEqualTo(2); + assertThat(writer.queuedMessages()).isEqualTo(1); + } + @Test @DisplayName("the terminal signal is sent exactly once") void theTerminalSignalIsSentOnce() { diff --git a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/streaming/GrpcStreamAdmissionConcurrencyTest.java b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/streaming/GrpcStreamAdmissionConcurrencyTest.java new file mode 100644 index 00000000..8849c52e --- /dev/null +++ b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/streaming/GrpcStreamAdmissionConcurrencyTest.java @@ -0,0 +1,48 @@ +package dev.caskeleton.grpc.streaming; + +import static org.assertj.core.api.Assertions.assertThat; + +import java.util.ArrayList; +import java.util.List; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.Executors; +import java.util.concurrent.Future; +import org.junit.jupiter.api.Test; + +class GrpcStreamAdmissionConcurrencyTest { + + @Test + void concurrentAdmissionsNeverExceedThePerCallerBoundAndReleaseRemovesCallerState() + throws Exception { + GrpcStreamAdmission admission = new GrpcStreamAdmission(4, 1); + CountDownLatch start = new CountDownLatch(1); + + try (var executor = Executors.newFixedThreadPool(16)) { + List> attempts = new ArrayList<>(); + for (int index = 0; index < 16; index++) { + attempts.add( + executor.submit( + () -> { + start.await(); + return admission.tryAdmit("caller"); + })); + } + start.countDown(); + + int admitted = 0; + for (Future attempt : attempts) { + if (attempt.get()) { + admitted++; + } + } + + assertThat(admitted).isOne(); + assertThat(admission.openStreamsFor("caller")).isOne(); + + admission.release("caller"); + + assertThat(admission.openStreams()).isZero(); + assertThat(admission.trackedCallers()).isZero(); + } + } +} diff --git a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/validation/ProtovalidateGrpcInterceptorTest.java b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/validation/GrpcValidationInterceptorTest.java similarity index 92% rename from src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/validation/ProtovalidateGrpcInterceptorTest.java rename to src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/validation/GrpcValidationInterceptorTest.java index ad306913..73468e88 100644 --- a/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/validation/ProtovalidateGrpcInterceptorTest.java +++ b/src/grpc/grpc-policy/src/test/java/dev/caskeleton/grpc/validation/GrpcValidationInterceptorTest.java @@ -20,7 +20,7 @@ import java.util.concurrent.atomic.AtomicInteger; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Test; -class ProtovalidateGrpcInterceptorTest { +class GrpcValidationInterceptorTest { private static final String FULL_METHOD = "hyeonworks.document.v1.DocumentService/CreateDocument"; @@ -165,8 +165,8 @@ class ProtovalidateGrpcInterceptorTest { @Test @DisplayName("a valid message reaches the handler untouched") void validMessagesReachTheHandler() { - ProtovalidateGrpcInterceptor interceptor = - new ProtovalidateGrpcInterceptor(Map.of(FULL_METHOD, titleValidator())); + GrpcValidationInterceptor interceptor = + new GrpcValidationInterceptor(Map.of(FULL_METHOD, titleValidator())); RecordingServerCall call = new RecordingServerCall(); RecordingHandler handler = new RecordingHandler(); @@ -182,8 +182,8 @@ class ProtovalidateGrpcInterceptorTest { @Test @DisplayName("an invalid message is closed as INVALID_ARGUMENT and never reaches the handler") void invalidMessagesAreRefusedBeforeTheUseCase() { - ProtovalidateGrpcInterceptor interceptor = - new ProtovalidateGrpcInterceptor(Map.of(FULL_METHOD, titleValidator())); + GrpcValidationInterceptor interceptor = + new GrpcValidationInterceptor(Map.of(FULL_METHOD, titleValidator())); RecordingServerCall call = new RecordingServerCall(); RecordingHandler handler = new RecordingHandler(); @@ -194,15 +194,15 @@ class ProtovalidateGrpcInterceptorTest { assertThat(handler.delivered).isEmpty(); assertThat(handler.halfCloses).hasValue(0); assertThat(call.closedStatus.getCode()).isEqualTo(Status.Code.INVALID_ARGUMENT); - assertThat(call.closedTrailers.get(ProtovalidateGrpcInterceptor.VIOLATIONS_KEY)) + assertThat(call.closedTrailers.get(GrpcValidationInterceptor.VIOLATIONS_KEY)) .isEqualTo("document.title: LENGTH_EXCEEDED"); } @Test @DisplayName("the rejected value never appears in the status or the trailers") void theRejectedValueIsNeverEchoed() { - ProtovalidateGrpcInterceptor interceptor = - new ProtovalidateGrpcInterceptor(Map.of(FULL_METHOD, titleValidator())); + GrpcValidationInterceptor interceptor = + new GrpcValidationInterceptor(Map.of(FULL_METHOD, titleValidator())); RecordingServerCall call = new RecordingServerCall(); String secret = "national-id-900101-1234567"; @@ -211,14 +211,14 @@ class ProtovalidateGrpcInterceptorTest { listener.onMessage(secret); assertThat(call.closedStatus.getDescription()).doesNotContain(secret); - assertThat(call.closedTrailers.get(ProtovalidateGrpcInterceptor.VIOLATIONS_KEY)) + assertThat(call.closedTrailers.get(GrpcValidationInterceptor.VIOLATIONS_KEY)) .doesNotContain(secret); } @Test @DisplayName("a method with no registered validator is passed through rather than refused") void unregisteredMethodsPassThrough() { - ProtovalidateGrpcInterceptor interceptor = new ProtovalidateGrpcInterceptor(Map.of()); + GrpcValidationInterceptor interceptor = new GrpcValidationInterceptor(Map.of()); RecordingHandler handler = new RecordingHandler(); ServerCall.Listener listener = diff --git a/src/grpc/grpc-proto-contract/src/main/resources/proto/hyeonworks/grpc/common/v1/error.proto b/src/grpc/grpc-proto-contract/src/main/resources/proto/hyeonworks/grpc/common/v1/error.proto index af32d4d9..e28a0289 100644 --- a/src/grpc/grpc-proto-contract/src/main/resources/proto/hyeonworks/grpc/common/v1/error.proto +++ b/src/grpc/grpc-proto-contract/src/main/resources/proto/hyeonworks/grpc/common/v1/error.proto @@ -6,6 +6,8 @@ option java_multiple_files = true; option java_package = "hyeonworks.grpc.common.v1.generated"; option java_outer_classname = "ErrorProto"; +import "google/protobuf/duration.proto"; + // The platform's allowlisted rich error details. // // Deliberately this repository's own messages rather than google.rpc.*: the Stable contract is that @@ -30,8 +32,8 @@ message BadRequest { // Whether and when the caller may try again. The only channel for a retry hint. message RetryInfo { - // Seconds to wait before the next attempt. Zero means "do not retry". - int64 retry_delay_seconds = 1; + // Delay before the next attempt. Zero duration means "do not retry". + google.protobuf.Duration retry_delay = 1; // Attempts already made, 1-based. int32 attempt = 2; } @@ -51,7 +53,6 @@ message PreconditionFailure { message Violation { string type = 1; string subject = 2; - optional string description = 3; } repeated Violation violations = 1; } diff --git a/src/grpc/grpc-server/src/main/java/dev/caskeleton/grpc/server/GrpcApplicationInvocation.java b/src/grpc/grpc-server/src/main/java/dev/caskeleton/grpc/server/GrpcApplicationInvocation.java index 68e78b5e..10687049 100644 --- a/src/grpc/grpc-server/src/main/java/dev/caskeleton/grpc/server/GrpcApplicationInvocation.java +++ b/src/grpc/grpc-server/src/main/java/dev/caskeleton/grpc/server/GrpcApplicationInvocation.java @@ -1,6 +1,6 @@ package dev.caskeleton.grpc.server; -import dev.caskeleton.grpc.context.GrpcRequestContext; +import dev.caskeleton.grpc.api.context.GrpcRequestContext; /** * The single call an adapter makes into the application. diff --git a/src/grpc/grpc-server/src/main/java/dev/caskeleton/grpc/server/GrpcServiceAdapter.java b/src/grpc/grpc-server/src/main/java/dev/caskeleton/grpc/server/GrpcServiceAdapter.java index 749d2be4..a851af33 100644 --- a/src/grpc/grpc-server/src/main/java/dev/caskeleton/grpc/server/GrpcServiceAdapter.java +++ b/src/grpc/grpc-server/src/main/java/dev/caskeleton/grpc/server/GrpcServiceAdapter.java @@ -1,8 +1,8 @@ package dev.caskeleton.grpc.server; -import dev.caskeleton.grpc.context.GrpcRequestContext; +import dev.caskeleton.grpc.api.context.GrpcRequestContext; import dev.caskeleton.grpc.error.GrpcErrorMapper; -import dev.caskeleton.grpc.error.GrpcPlatformException; +import dev.caskeleton.grpc.api.error.GrpcPlatformException; import java.util.function.Function; /** diff --git a/src/grpc/grpc-server/src/test/java/dev/caskeleton/grpc/architecture/GrpcApplicationBoundaryRulesTest.java b/src/grpc/grpc-server/src/test/java/dev/caskeleton/grpc/architecture/GrpcApplicationBoundaryRulesTest.java index 256d312a..b3dcf099 100644 --- a/src/grpc/grpc-server/src/test/java/dev/caskeleton/grpc/architecture/GrpcApplicationBoundaryRulesTest.java +++ b/src/grpc/grpc-server/src/test/java/dev/caskeleton/grpc/architecture/GrpcApplicationBoundaryRulesTest.java @@ -33,7 +33,7 @@ class GrpcApplicationBoundaryRulesTest { "DocumentServiceAdapter", Set.of( "dev.caskeleton.application.document.CreateDocumentUseCase", - "dev.caskeleton.grpc.context.GrpcRequestContext"))) + "dev.caskeleton.grpc.api.context.GrpcRequestContext"))) .isEmpty(); } diff --git a/src/grpc/grpc-server/src/test/java/dev/caskeleton/grpc/server/GrpcServiceAdapterTest.java b/src/grpc/grpc-server/src/test/java/dev/caskeleton/grpc/server/GrpcServiceAdapterTest.java index 015e10be..c162d6ff 100644 --- a/src/grpc/grpc-server/src/test/java/dev/caskeleton/grpc/server/GrpcServiceAdapterTest.java +++ b/src/grpc/grpc-server/src/test/java/dev/caskeleton/grpc/server/GrpcServiceAdapterTest.java @@ -3,20 +3,20 @@ package dev.caskeleton.grpc.server; import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.assertThatThrownBy; -import dev.caskeleton.grpc.context.GrpcClientIdentity; -import dev.caskeleton.grpc.context.GrpcMetadataBudget; -import dev.caskeleton.grpc.context.GrpcRequestContext; +import dev.caskeleton.grpc.api.context.GrpcClientIdentity; +import dev.caskeleton.grpc.api.context.GrpcMetadataBudget; +import dev.caskeleton.grpc.api.context.GrpcRequestContext; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.GrpcStatusCode; import dev.caskeleton.grpc.core.RpcType; -import dev.caskeleton.grpc.deadline.GrpcCancellationToken; -import dev.caskeleton.grpc.deadline.GrpcDeadlineBudget; -import dev.caskeleton.grpc.deadline.GrpcDeadlineProfile; -import dev.caskeleton.grpc.error.GrpcCompletionOutcome; +import dev.caskeleton.grpc.api.deadline.GrpcCancellationToken; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineBudget; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineProfile; +import dev.caskeleton.grpc.api.error.GrpcCompletionOutcome; import dev.caskeleton.grpc.error.GrpcErrorMapper; -import dev.caskeleton.grpc.error.GrpcFailureCategory; -import dev.caskeleton.grpc.error.GrpcFailureContext; -import dev.caskeleton.grpc.error.GrpcPlatformException; +import dev.caskeleton.grpc.api.error.GrpcFailureCategory; +import dev.caskeleton.grpc.api.error.GrpcFailureContext; +import dev.caskeleton.grpc.api.error.GrpcPlatformException; import dev.caskeleton.grpc.evidence.GrpcExecutionEvidence; import io.grpc.Status; import java.time.Duration; diff --git a/src/grpc/grpc-spring-boot-starter/build.gradle b/src/grpc/grpc-spring-boot-starter/build.gradle index ca555563..b85f08b9 100644 --- a/src/grpc/grpc-spring-boot-starter/build.gradle +++ b/src/grpc/grpc-spring-boot-starter/build.gradle @@ -20,7 +20,7 @@ dependencies { implementation project(':grpc:grpc-proto-contract') implementation project(':grpc:grpc-codegen') - implementation project(':grpc:grpc-operation-ledger-jpa') implementation 'org.springframework.boot:spring-boot-autoconfigure' + } diff --git a/src/grpc/grpc-spring-boot-starter/gradle.lockfile b/src/grpc/grpc-spring-boot-starter/gradle.lockfile index ee0cc9a4..0716db13 100644 --- a/src/grpc/grpc-spring-boot-starter/gradle.lockfile +++ b/src/grpc/grpc-spring-boot-starter/gradle.lockfile @@ -42,13 +42,11 @@ io.grpc:grpc-stub:1.68.1=compileClasspath,runtimeClasspath,testCompileClasspath, io.micrometer:micrometer-commons:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath io.micrometer:micrometer-core:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath io.micrometer:micrometer-observation:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -jakarta.annotation:jakarta.annotation-api:3.0.0=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -jakarta.persistence:jakarta.persistence-api:3.2.0=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath javax.inject:javax.inject:1=annotationProcessor,testAnnotationProcessor jaxen:jaxen:2.0.6=spotbugs net.bytebuddy:byte-buddy:1.17.8=testCompileClasspath,testRuntimeClasspath net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs -org.antlr:antlr4-runtime:4.13.2=checkstyle,compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.antlr:antlr4-runtime:4.13.2=checkstyle org.apache.bcel:bcel:6.12.0=spotbugs org.apache.commons:commons-lang3:3.20.0=checkstyle,spotbugs org.apache.commons:commons-text:1.15.0=spotbugs @@ -92,21 +90,16 @@ org.ow2.asm:asm-util:9.10.1=spotbugs org.ow2.asm:asm:9.10.1=spotbugs org.pcollections:pcollections:4.0.1=annotationProcessor,testAnnotationProcessor org.reflections:reflections:0.10.2=checkstyle -org.slf4j:slf4j-api:2.0.18=compileClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testRuntimeClasspath +org.slf4j:slf4j-api:2.0.18=spotbugs,spotbugsSlf4j org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j org.slf4j:slf4j-simple:2.0.18=checkstyle org.springframework.boot:spring-boot-autoconfigure:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-configuration-processor:4.0.8=annotationProcessor org.springframework.boot:spring-boot:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.data:spring-data-commons:4.0.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.data:spring-data-jpa:4.0.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework:spring-aop:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework:spring-beans:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework:spring-context:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework:spring-core:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework:spring-expression:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-jdbc:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-orm:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-tx:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs empty= diff --git a/src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfiguration.java b/src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfiguration.java index d04d0aed..f550d4cf 100644 --- a/src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfiguration.java +++ b/src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfiguration.java @@ -5,18 +5,24 @@ import dev.caskeleton.grpc.admin.GrpcDrainPolicy; import dev.caskeleton.grpc.admin.GrpcHealthPolicy; import dev.caskeleton.grpc.admin.GrpcReflectionPolicy; import dev.caskeleton.grpc.admin.GrpcServiceHealthRegistry; +import dev.caskeleton.grpc.client.GrpcNamedChannelProfile; import dev.caskeleton.grpc.context.GrpcContextBinder; import dev.caskeleton.grpc.context.GrpcContextPropagationPolicy; import dev.caskeleton.grpc.error.GrpcErrorMapper; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicyCatalog; import dev.caskeleton.grpc.server.GrpcAdmissionController; import dev.caskeleton.grpc.server.GrpcExecutorProfile; import dev.caskeleton.grpc.server.GrpcServerProfile; +import java.time.Duration; +import java.util.Set; import java.util.UUID; +import org.springframework.beans.factory.ObjectProvider; +import org.springframework.beans.factory.SmartInitializingSingleton; +import org.springframework.boot.autoconfigure.AutoConfiguration; import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty; import org.springframework.boot.context.properties.EnableConfigurationProperties; import org.springframework.context.annotation.Bean; -import org.springframework.context.annotation.Configuration; /** * Assembles the Stable platform when, and only when, a deployment asks for it. @@ -26,7 +32,7 @@ import org.springframework.context.annotation.Configuration; * and nothing can: the registry does not permit the edge, so an import here would fail the build * rather than this comment. */ -@Configuration(proxyBeanMethods = false) +@AutoConfiguration @ConditionalOnProperty( prefix = "ca-skeleton.grpc.platform", name = "enabled", @@ -46,8 +52,18 @@ public class GrpcPlatformAutoConfiguration { /** The server transport profile. */ @Bean @ConditionalOnMissingBean - public GrpcServerProfile grpcServerProfile(GrpcExecutorProfile executorProfile) { - return GrpcServerProfile.stableNetty(executorProfile); + public GrpcServerProfile grpcServerProfile( + GrpcPlatformProperties properties, GrpcExecutorProfile executorProfile) { + return new GrpcServerProfile( + properties.getTransport(), + 1024L * 1024L, + 8192, + Duration.ofSeconds(30), + Duration.ofSeconds(10), + Duration.ofSeconds(30), + Duration.ofMinutes(30), + Duration.ofSeconds(30), + executorProfile); } /** Admission control, sized from the executor. */ @@ -97,6 +113,26 @@ public class GrpcPlatformAutoConfiguration { return new GrpcContextBinder(GrpcContextPropagationPolicy.stable()); } + /** + * Runs the Stable startup validator against the bean graph after singleton assembly. + * + *

      The Gradle architecture gate owns dependency-graph isolation. Runtime validation therefore + * passes no synthetic dependency list; it validates only inputs a running process can actually + * observe: typed properties, the method-policy catalog and named client channels. + */ + @Bean + public SmartInitializingSingleton grpcPlatformStartupCheck( + GrpcPlatformProperties properties, + ObjectProvider catalogs, + ObjectProvider channelProfiles) { + return () -> + GrpcPlatformStartupValidator.requireValid( + properties, + catalogs.getIfAvailable(() -> GrpcMethodPolicyCatalog.builder().build()), + channelProfiles.orderedStream().toList(), + Set.of()); + } + /** The shared error mapper. Its execution ids are random and carry no derived content. */ @Bean @ConditionalOnMissingBean diff --git a/src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformProperties.java b/src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformProperties.java index c16f5bee..8f1e2dd4 100644 --- a/src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformProperties.java +++ b/src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformProperties.java @@ -3,7 +3,6 @@ package dev.caskeleton.grpc.boot; import dev.caskeleton.grpc.admin.GrpcReflectionMode; import dev.caskeleton.grpc.security.GrpcTlsProfile; import dev.caskeleton.grpc.server.GrpcServerTransport; -import java.time.Duration; import org.springframework.boot.context.properties.ConfigurationProperties; /** @@ -46,9 +45,6 @@ public class GrpcPlatformProperties { /** The bounded executor's maximum size. */ private int executorMaxPoolSize = 32; - /** The default deadline applied to a Stable unary method that declares none. */ - private Duration defaultUnaryDeadline = Duration.ofSeconds(2); - /** Whether the operation ledger is available, which gates keyed idempotency. */ private boolean operationLedgerEnabled; @@ -116,14 +112,6 @@ public class GrpcPlatformProperties { this.executorMaxPoolSize = executorMaxPoolSize; } - public Duration getDefaultUnaryDeadline() { - return defaultUnaryDeadline; - } - - public void setDefaultUnaryDeadline(Duration defaultUnaryDeadline) { - this.defaultUnaryDeadline = defaultUnaryDeadline; - } - public boolean isOperationLedgerEnabled() { return operationLedgerEnabled; } diff --git a/src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidator.java b/src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidator.java index 51de8d00..fd3a62ec 100644 --- a/src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidator.java +++ b/src/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidator.java @@ -6,9 +6,9 @@ import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.GrpcStableBuildInvariant; import dev.caskeleton.grpc.core.RpcType; import dev.caskeleton.grpc.discovery.GrpcDiscoveryPolicyValidator; -import dev.caskeleton.grpc.policy.GrpcMethodPolicy; -import dev.caskeleton.grpc.policy.GrpcMethodPolicyCatalog; -import dev.caskeleton.grpc.policy.RpcIdempotencyProfile; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicy; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicyCatalog; +import dev.caskeleton.grpc.api.policy.RpcIdempotencyProfile; import dev.caskeleton.grpc.resilience.GrpcRetryOwner; import java.util.ArrayList; import java.util.LinkedHashSet; @@ -33,8 +33,9 @@ public final class GrpcPlatformStartupValidator { /** * Every reason this configuration is refused. * - * @param stableModuleDependencies the module ids the Stable starter resolves, so an Advanced leak - * is caught at startup as well as by the registry gate at build time + * @param stableModuleDependencies dependency ids supplied by a caller that can observe a runtime + * dependency set; the Spring auto-configuration passes an empty set because the Gradle + * registry gate is authoritative for the compiled graph * @return an empty list when the configuration is safe to start */ public static List violations( @@ -104,8 +105,8 @@ public final class GrpcPlatformStartupValidator { private static void validateExecutor(GrpcPlatformProperties properties, List violations) { if (properties.getExecutorQueueCapacity() < 1) { violations.add( - "the server executor queue is unbounded; overload becomes unbounded latency, and the work " - + "that eventually runs is work nobody is waiting for"); + "the server executor queue is unbounded; overload becomes unbounded latency, and the work" + + " that eventually runs is work nobody is waiting for"); } if (properties.getExecutorMaxPoolSize() < 1) { violations.add("the server executor pool size must be positive"); @@ -166,7 +167,8 @@ public final class GrpcPlatformStartupValidator { violations.add( "two retry owners retry in-process across the configured channels " + ownersRetryingInProcess - + "; retries at two layers multiply the load on a dependency that is already failing"); + + "; retries at two layers multiply the load on a dependency that is already" + + " failing"); } } diff --git a/src/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfigurationContextTest.java b/src/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfigurationContextTest.java new file mode 100644 index 00000000..714cebb2 --- /dev/null +++ b/src/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfigurationContextTest.java @@ -0,0 +1,75 @@ +package dev.caskeleton.grpc.boot; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +import java.util.Map; +import org.junit.jupiter.api.Test; +import org.springframework.context.annotation.AnnotationConfigApplicationContext; +import org.springframework.core.env.MapPropertySource; + +class GrpcPlatformAutoConfigurationContextTest { + + @Test + void invalidProductionSecurityFailsDuringActualAutoConfigurationStartup() { + assertThatThrownBy( + () -> + start( + Map.of( + "ca-skeleton.grpc.platform.enabled", "true", + "ca-skeleton.grpc.platform.environment", "PROD", + "ca-skeleton.grpc.platform.transport", "NETTY_SHADED", + "ca-skeleton.grpc.platform.tls-enabled", "true", + "ca-skeleton.grpc.platform.trust-all-certificates", "true"))) + .isInstanceOf(GrpcPlatformConfigurationException.class) + .hasMessageContaining("trust-all is enabled in PROD") + .hasMessageContaining("providing none"); + } + + @Test + void coherentLocalConfigurationRunsTheStartupValidatorAndStarts() { + try (AnnotationConfigApplicationContext context = + start( + Map.of( + "ca-skeleton.grpc.platform.enabled", "true", + "ca-skeleton.grpc.platform.environment", "LOCAL", + "ca-skeleton.grpc.platform.transport", "NETTY_SHADED", + "ca-skeleton.grpc.platform.executor-queue-capacity", "32", + "ca-skeleton.grpc.platform.executor-max-pool-size", "4"))) { + assertThat(context.getBean(GrpcPlatformProperties.class).isEnabled()).isTrue(); + assertThat( + context.getBeansOfType( + org.springframework.beans.factory.SmartInitializingSingleton.class)) + .isNotEmpty(); + } + } + + @Test + void configuredTransportIsUsedByTheServerProfile() { + try (AnnotationConfigApplicationContext context = + start( + Map.of( + "ca-skeleton.grpc.platform.enabled", "true", + "ca-skeleton.grpc.platform.environment", "LOCAL", + "ca-skeleton.grpc.platform.transport", "NETTY"))) { + assertThat(context.getBean(dev.caskeleton.grpc.server.GrpcServerProfile.class).transport()) + .isEqualTo(dev.caskeleton.grpc.server.GrpcServerTransport.NETTY); + } + } + + private static AnnotationConfigApplicationContext start(Map properties) { + AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(); + context + .getEnvironment() + .getPropertySources() + .addFirst(new MapPropertySource("grpc-platform-test", properties)); + context.register(GrpcPlatformAutoConfiguration.class); + try { + context.refresh(); + return context; + } catch (RuntimeException failure) { + context.close(); + throw failure; + } + } +} diff --git a/src/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidatorTest.java b/src/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidatorTest.java index 25911e09..5d9ea89c 100644 --- a/src/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidatorTest.java +++ b/src/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidatorTest.java @@ -7,11 +7,11 @@ import dev.caskeleton.grpc.admin.GrpcReflectionMode; import dev.caskeleton.grpc.client.GrpcNamedChannelProfile; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.RpcType; -import dev.caskeleton.grpc.deadline.GrpcDeadlineProfile; -import dev.caskeleton.grpc.policy.GrpcMethodPolicy; -import dev.caskeleton.grpc.policy.GrpcMethodPolicyCatalog; -import dev.caskeleton.grpc.policy.RpcIdempotencyProfile; -import dev.caskeleton.grpc.policy.WaitForReadyPolicy; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineProfile; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicy; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicyCatalog; +import dev.caskeleton.grpc.api.policy.RpcIdempotencyProfile; +import dev.caskeleton.grpc.api.policy.WaitForReadyPolicy; import dev.caskeleton.grpc.resilience.GrpcRetryOwner; import dev.caskeleton.grpc.security.GrpcTlsProfile; import dev.caskeleton.grpc.server.GrpcServerTransport; diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryContractResult.java b/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryContractResult.java index 8a9b3450..133c4dde 100644 --- a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryContractResult.java +++ b/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryContractResult.java @@ -16,7 +16,7 @@ public record GrpcUnaryContractResult( GrpcEvidenceGrade grade, int attempts, int businessInvocations, - dev.caskeleton.grpc.error.GrpcCompletionOutcome observedOutcome) { + dev.caskeleton.grpc.api.error.GrpcCompletionOutcome observedOutcome) { /** Requires the scenario, the grade and non-negative counts. */ public GrpcUnaryContractResult { diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryReliabilityContract.java b/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryReliabilityContract.java index ac071f8e..e039a2be 100644 --- a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryReliabilityContract.java +++ b/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryReliabilityContract.java @@ -3,7 +3,7 @@ package dev.caskeleton.grpc.testkit; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.deadline.GrpcDeadlinePolicyValidator; import dev.caskeleton.grpc.deadline.GrpcDependencyBudget; -import dev.caskeleton.grpc.policy.GrpcMethodPolicyCatalog; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicyCatalog; import java.util.ArrayList; import java.util.List; import java.util.Map; diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryScenario.java b/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryScenario.java index 178ea21c..ecb95f05 100644 --- a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryScenario.java +++ b/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/GrpcUnaryScenario.java @@ -2,8 +2,8 @@ package dev.caskeleton.grpc.testkit; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.GrpcStatusCode; -import dev.caskeleton.grpc.error.GrpcCompletionOutcome; -import dev.caskeleton.grpc.policy.RpcIdempotencyProfile; +import dev.caskeleton.grpc.api.error.GrpcCompletionOutcome; +import dev.caskeleton.grpc.api.policy.RpcIdempotencyProfile; /** * One unary reliability case: a method shape, a failure, and what must happen next. diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultResult.java b/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultResult.java index d3078ce0..de38520d 100644 --- a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultResult.java +++ b/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultResult.java @@ -1,6 +1,6 @@ package dev.caskeleton.grpc.testkit.fault; -import dev.caskeleton.grpc.error.GrpcCompletionOutcome; +import dev.caskeleton.grpc.api.error.GrpcCompletionOutcome; import dev.caskeleton.grpc.evidence.GrpcExecutionEvidence; import dev.caskeleton.grpc.testkit.GrpcEvidenceGrade; import java.util.Optional; diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultScenario.java b/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultScenario.java index 1caa8cf8..42c2138d 100644 --- a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultScenario.java +++ b/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcFaultScenario.java @@ -1,8 +1,8 @@ package dev.caskeleton.grpc.testkit.fault; import dev.caskeleton.grpc.core.GrpcMethodName; -import dev.caskeleton.grpc.error.GrpcCompletionOutcome; -import dev.caskeleton.grpc.policy.RpcIdempotencyProfile; +import dev.caskeleton.grpc.api.error.GrpcCompletionOutcome; +import dev.caskeleton.grpc.api.policy.RpcIdempotencyProfile; /** * One fault to inject, and what the client is expected to conclude from it. diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcTransportEvidenceClassifier.java b/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcTransportEvidenceClassifier.java index 3d77970c..98868980 100644 --- a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcTransportEvidenceClassifier.java +++ b/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/fault/GrpcTransportEvidenceClassifier.java @@ -3,7 +3,7 @@ package dev.caskeleton.grpc.testkit.fault; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.GrpcStatusCode; import dev.caskeleton.grpc.core.RpcType; -import dev.caskeleton.grpc.error.GrpcCompletionOutcome; +import dev.caskeleton.grpc.api.error.GrpcCompletionOutcome; import dev.caskeleton.grpc.evidence.GrpcBusinessEvidence; import dev.caskeleton.grpc.evidence.GrpcExecutionEvidence; import dev.caskeleton.grpc.evidence.GrpcStreamEvidence; diff --git a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcTlsTestMaterial.java b/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcTlsTestMaterial.java index 55ca74a0..355b6682 100644 --- a/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcTlsTestMaterial.java +++ b/src/grpc/grpc-testkit/src/main/java/dev/caskeleton/grpc/testkit/netty/GrpcTlsTestMaterial.java @@ -83,6 +83,17 @@ public final class GrpcTlsTestMaterial implements AutoCloseable { Path directory = Files.createTempDirectory("grpc-testkit-tls"); Path keyStorePath = directory.resolve("server.p12"); Path certificatePath = directory.resolve("server.crt"); + Path passwordPath = directory.resolve("keytool.pass"); + try (var writer = Files.newBufferedWriter(passwordPath)) { + writer.write(password); + } + try { + Files.setPosixFilePermissions( + passwordPath, + java.nio.file.attribute.PosixFilePermissions.fromString("rw-------")); + } catch (UnsupportedOperationException ignored) { + // Non-POSIX test hosts still avoid argv disclosure; the whole temp directory is private. + } runKeytool( List.of( @@ -103,10 +114,10 @@ public final class GrpcTlsTestMaterial implements AutoCloseable { "PKCS12", "-keystore", keyStorePath.toString(), - "-storepass", - new String(password), - "-keypass", - new String(password))); + "-storepass:file", + passwordPath.toString(), + "-keypass:file", + passwordPath.toString())); runKeytool( List.of( "-exportcert", @@ -115,8 +126,8 @@ public final class GrpcTlsTestMaterial implements AutoCloseable { ALIAS, "-keystore", keyStorePath.toString(), - "-storepass", - new String(password), + "-storepass:file", + passwordPath.toString(), "-file", certificatePath.toString())); diff --git a/src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcPackageOwnershipTest.java b/src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcPackageOwnershipTest.java new file mode 100644 index 00000000..4347d1d8 --- /dev/null +++ b/src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcPackageOwnershipTest.java @@ -0,0 +1,56 @@ +package dev.caskeleton.grpc.testkit; + +import static org.assertj.core.api.Assertions.assertThat; + +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.ArrayList; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.regex.Pattern; +import org.junit.jupiter.api.Test; + +class GrpcPackageOwnershipTest { + private static final Pattern PACKAGE = Pattern.compile("(?m)^package\\s+([^;]+);"); + + @Test + void corePolicyAndLedgerJpaDoNotSplitAJavaPackageAcrossLeaves() throws Exception { + Path repo = repositoryRoot(); + List leaves = + List.of("grpc-core-api", "grpc-policy", "grpc-operation-ledger-jpa"); + Map> owners = new LinkedHashMap<>(); + for (String leaf : leaves) { + Path source = repo.resolve("src/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)); + if (matcher.find()) { + owners.computeIfAbsent(matcher.group(1), ignored -> new ArrayList<>()).add(leaf); + } + } + } + } + Map> split = new LinkedHashMap<>(); + owners.forEach( + (pkg, leafOwners) -> { + if (leafOwners.stream().distinct().count() > 1) { + split.put(pkg, leafOwners.stream().distinct().toList()); + } + }); + + assertThat(split).as("Java packages must have exactly one owning leaf").isEmpty(); + } + + private static Path repositoryRoot() { + Path candidate = Path.of("").toAbsolutePath(); + while (candidate != null + && !Files.isRegularFile(candidate.resolve("src/config/architecture/modules.json"))) { + candidate = candidate.getParent(); + } + if (candidate == null) { + throw new IllegalStateException("could not locate repository root"); + } + return candidate; + } +} diff --git a/src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcTransportEvidenceClassifierTest.java b/src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcTransportEvidenceClassifierTest.java index ff53c299..921bb2a1 100644 --- a/src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcTransportEvidenceClassifierTest.java +++ b/src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcTransportEvidenceClassifierTest.java @@ -6,12 +6,13 @@ import static org.assertj.core.api.Assertions.assertThatThrownBy; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.GrpcStatusCode; import dev.caskeleton.grpc.core.RpcType; -import dev.caskeleton.grpc.error.GrpcCompletionOutcome; +import dev.caskeleton.grpc.api.error.GrpcCompletionOutcome; +import dev.caskeleton.grpc.error.GrpcStatusMapping; import dev.caskeleton.grpc.evidence.GrpcBusinessEvidence; import dev.caskeleton.grpc.evidence.GrpcExecutionEvidence; import dev.caskeleton.grpc.evidence.GrpcStreamEvidence; import dev.caskeleton.grpc.evidence.GrpcTransportEvidence; -import dev.caskeleton.grpc.policy.RpcIdempotencyProfile; +import dev.caskeleton.grpc.api.policy.RpcIdempotencyProfile; import dev.caskeleton.grpc.testkit.fault.GrpcFaultPoint; import dev.caskeleton.grpc.testkit.fault.GrpcFaultResult; import dev.caskeleton.grpc.testkit.fault.GrpcFaultScenario; @@ -30,6 +31,7 @@ import java.util.Optional; import java.util.concurrent.CountDownLatch; import java.util.concurrent.TimeUnit; import java.util.concurrent.atomic.AtomicBoolean; +import java.util.concurrent.atomic.AtomicReference; import org.junit.jupiter.api.DisplayName; import org.junit.jupiter.api.Tag; import org.junit.jupiter.api.Test; @@ -43,6 +45,8 @@ class GrpcTransportEvidenceClassifierTest { GrpcMethodName.parse("hyeonworks.document.v1.DocumentService/GetDocument"); private static final MethodDescriptor CREATE_DESCRIPTOR = GrpcTextCodec.unary(CREATE.canonical()); + private static final MethodDescriptor GET_DESCRIPTOR = + GrpcTextCodec.unary(GET.canonical()); @Test @DisplayName("an unobserved send is UNOBSERVED, never NOT_SENT") @@ -185,18 +189,124 @@ class GrpcTransportEvidenceClassifierTest { .hasMessageContaining("did not inject a real network fault"); } + @Test + @DisplayName("a real transport shutdown before send is observed as REJECTED") + void aRealTransportShutdownBeforeSendIsRejected() { + AtomicBoolean applicationStarted = new AtomicBoolean(); + ServerCallHandler handler = + ServerCalls.asyncUnaryCall( + (String request, StreamObserver observer) -> { + applicationStarted.set(true); + observer.onNext("unexpected"); + observer.onCompleted(); + }); + + try (GrpcNettyTestServer server = server(GET_DESCRIPTOR, handler)) { + GrpcNettyTestClient client = + GrpcNettyTestClient.connect(server, Optional.empty(), Optional.empty()); + client.close(); + + StatusRuntimeException failure = + captureFailure(() -> client.callUnary(GET_DESCRIPTOR, "read")); + assertThat(failure).isNotNull(); + assertThat(applicationStarted).isFalse(); + + GrpcTransportEvidenceClassifier.ClientObservation observation = + new GrpcTransportEvidenceClassifier.ClientObservation( + false, false, false, false, Optional.empty()); + GrpcExecutionEvidence evidence = + GrpcTransportEvidenceClassifier.classify( + GET, RpcType.UNARY, observation, true, GrpcBusinessEvidence.NONE); + GrpcFaultResult result = + faultResult(GrpcFaultScenario.readNeverSent(GET), evidence, failure, Optional.empty()); + + assertThat(evidence.transport()).isEqualTo(GrpcTransportEvidence.NOT_SENT); + assertThat(result.observedOutcome()).isEqualTo(GrpcCompletionOutcome.REJECTED); + assertThat(result.matchedExpectation()).isTrue(); + } + } + @Test @DisplayName("a real connection loss after the server started work is COMPLETION_UNKNOWN") void aRealConnectionLossAfterAppStartIsCompletionUnknown() throws Exception { - CountDownLatch serverEntered = new CountDownLatch(1); + ObservedServerFault observed = observeServerSideCut(false); + + assertThat(observed.failure()).isNotNull(); + assertThat(observed.applicationStarted()).isTrue(); + assertThat(observed.commitConfirmed()).isFalse(); + + GrpcExecutionEvidence evidence = + GrpcTransportEvidenceClassifier.classify( + CREATE, + RpcType.UNARY, + new GrpcTransportEvidenceClassifier.ClientObservation( + observed.applicationStarted(), false, false, false, Optional.empty()), + false, + GrpcBusinessEvidence.ATTEMPTED); + GrpcFaultScenario scenario = + new GrpcFaultScenario( + "connection-lost-after-app-start", + CREATE, + RpcIdempotencyProfile.IDEMPOTENCY_KEY_REQUIRED, + GrpcFaultPoint.APP_STARTED, + GrpcCompletionOutcome.COMPLETION_UNKNOWN, + false); + GrpcFaultResult result = faultResult(scenario, evidence, observed.failure(), Optional.empty()); + + assertThat(evidence.transport()).isEqualTo(GrpcTransportEvidence.SENT_UNCONFIRMED); + assertThat(result.observedOutcome()).isEqualTo(GrpcCompletionOutcome.COMPLETION_UNKNOWN); + assertThat(result.matchedExpectation()).isTrue(); + assertThat(result.describe()).contains("APP_STARTED").contains("(match)"); + } + + @Test + @DisplayName("a real connection loss after commit leaves the client completion UNKNOWN") + void aRealConnectionLossAfterCommitIsCompletionUnknown() throws Exception { + ObservedServerFault observed = observeServerSideCut(true); + + assertThat(observed.failure()).isNotNull(); + assertThat(observed.applicationStarted()).isTrue(); + assertThat(observed.commitConfirmed()).isTrue(); + + // The server-side fixture knows commit completed, but the client did not observe that fact. + // The evidence passed to the client classifier is therefore ATTEMPTED, not COMMIT_CONFIRMED. + GrpcExecutionEvidence evidence = + GrpcTransportEvidenceClassifier.classify( + CREATE, + RpcType.UNARY, + new GrpcTransportEvidenceClassifier.ClientObservation( + observed.applicationStarted(), false, false, false, Optional.empty()), + false, + GrpcBusinessEvidence.ATTEMPTED); + GrpcFaultResult result = + faultResult( + GrpcFaultScenario.commitResponseLost(CREATE), + evidence, + observed.failure(), + Optional.empty()); + + assertThat(evidence.transport()).isEqualTo(GrpcTransportEvidence.SENT_UNCONFIRMED); + assertThat(result.observedOutcome()).isEqualTo(GrpcCompletionOutcome.COMPLETION_UNKNOWN); + assertThat(result.matchedExpectation()).isTrue(); + assertThat(result.describe()).contains("AFTER_COMMIT").contains("(match)"); + } + + private static ObservedServerFault observeServerSideCut(boolean commitBeforeCut) + throws Exception { + CountDownLatch faultReady = new CountDownLatch(1); CountDownLatch releaseServer = new CountDownLatch(1); AtomicBoolean applicationStarted = new AtomicBoolean(); + AtomicBoolean commitConfirmed = new AtomicBoolean(); + AtomicReference observedFailure = new AtomicReference<>(); ServerCallHandler blockingHandler = ServerCalls.asyncUnaryCall( (String request, StreamObserver observer) -> { applicationStarted.set(true); - serverEntered.countDown(); + if (commitBeforeCut) { + commitConfirmed.set(true); + } + faultReady.countDown(); try { releaseServer.await(10, TimeUnit.SECONDS); } catch (InterruptedException interrupted) { @@ -205,17 +315,8 @@ class GrpcTransportEvidenceClassifierTest { observer.onNext("never-delivered"); observer.onCompleted(); }); - GrpcNettyTestServer server = - GrpcNettyTestServer.start( - GrpcNettyContractProfile.plaintext(), - List.of( - ServerServiceDefinition.builder("hyeonworks.document.v1.DocumentService") - .addMethod(CREATE_DESCRIPTOR, blockingHandler) - .build()), - List.of(), - Optional.empty()); - StatusRuntimeException observedFailure; + GrpcNettyTestServer server = server(CREATE_DESCRIPTOR, blockingHandler); try (GrpcNettyTestClient client = GrpcNettyTestClient.connect(server, Optional.empty(), Optional.empty())) { Thread caller = @@ -223,50 +324,61 @@ class GrpcTransportEvidenceClassifierTest { () -> { try { client.callUnary(CREATE_DESCRIPTOR, "create"); - } catch (StatusRuntimeException expected) { - // The connection dies underneath this call; the exception is the observation. + } catch (StatusRuntimeException failure) { + observedFailure.set(failure); } }); caller.start(); - assertThat(serverEntered.await(10, TimeUnit.SECONDS)).isTrue(); - // A real fault: the socket goes away while the server is mid-application-work. + assertThat(faultReady.await(10, TimeUnit.SECONDS)).isTrue(); server.close(); releaseServer.countDown(); caller.join(TimeUnit.SECONDS.toMillis(10)); - observedFailure = null; + + assertThat(caller.isAlive()).isFalse(); + return new ObservedServerFault( + observedFailure.get(), applicationStarted.get(), commitConfirmed.get()); } finally { releaseServer.countDown(); server.close(); } - - // The client saw its request go out and nothing come back. It did not observe the send failing, - // so the transport axis is SENT_UNCONFIRMED, and the server did start work. - GrpcExecutionEvidence evidence = - GrpcTransportEvidenceClassifier.classify( - CREATE, - RpcType.UNARY, - GrpcTransportEvidenceClassifier.ClientObservation.sentAndSilent(), - false, - GrpcBusinessEvidence.ATTEMPTED); - GrpcFaultResult result = - new GrpcFaultResult( - new GrpcFaultScenario( - "connection-lost-after-app-start", - CREATE, - RpcIdempotencyProfile.IDEMPOTENCY_KEY_REQUIRED, - GrpcFaultPoint.APP_STARTED, - GrpcCompletionOutcome.COMPLETION_UNKNOWN, - false), - GrpcEvidenceGrade.FAULT, - evidence, - GrpcTransportEvidenceClassifier.outcomeFor(GrpcStatusCode.UNAVAILABLE, evidence), - Optional.empty()); - - assertThat(observedFailure).isNull(); - assertThat(applicationStarted).isTrue(); - assertThat(result.observedOutcome()).isEqualTo(GrpcCompletionOutcome.COMPLETION_UNKNOWN); - assertThat(result.matchedExpectation()).isTrue(); - assertThat(result.describe()).contains("APP_STARTED").contains("(match)"); } + + private static GrpcNettyTestServer server( + MethodDescriptor descriptor, ServerCallHandler handler) { + return GrpcNettyTestServer.start( + GrpcNettyContractProfile.plaintext(), + List.of( + ServerServiceDefinition.builder("hyeonworks.document.v1.DocumentService") + .addMethod(descriptor, handler) + .build()), + List.of(), + Optional.empty()); + } + + private static StatusRuntimeException captureFailure(Runnable call) { + try { + call.run(); + return null; + } catch (StatusRuntimeException failure) { + return failure; + } + } + + private static GrpcFaultResult faultResult( + GrpcFaultScenario scenario, + GrpcExecutionEvidence evidence, + StatusRuntimeException failure, + Optional lastSequence) { + GrpcStatusCode status = GrpcStatusMapping.fromTransport(failure.getStatus()); + return new GrpcFaultResult( + scenario, + GrpcEvidenceGrade.FAULT, + evidence, + GrpcTransportEvidenceClassifier.outcomeFor(status, evidence), + lastSequence); + } + + private record ObservedServerFault( + StatusRuntimeException failure, boolean applicationStarted, boolean commitConfirmed) {} } diff --git a/src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcUnaryReliabilityContractTest.java b/src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcUnaryReliabilityContractTest.java index 0e68163e..3312f987 100644 --- a/src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcUnaryReliabilityContractTest.java +++ b/src/grpc/grpc-testkit/src/test/java/dev/caskeleton/grpc/testkit/GrpcUnaryReliabilityContractTest.java @@ -5,12 +5,12 @@ import static org.assertj.core.api.Assertions.assertThatThrownBy; import dev.caskeleton.grpc.core.GrpcMethodName; import dev.caskeleton.grpc.core.GrpcStatusCode; -import dev.caskeleton.grpc.deadline.GrpcDeadlineProfile; +import dev.caskeleton.grpc.api.deadline.GrpcDeadlineProfile; import dev.caskeleton.grpc.deadline.GrpcDependencyBudget; -import dev.caskeleton.grpc.error.GrpcCompletionOutcome; -import dev.caskeleton.grpc.policy.GrpcMethodPolicy; -import dev.caskeleton.grpc.policy.GrpcMethodPolicyCatalog; -import dev.caskeleton.grpc.policy.RpcIdempotencyProfile; +import dev.caskeleton.grpc.api.error.GrpcCompletionOutcome; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicy; +import dev.caskeleton.grpc.api.policy.GrpcMethodPolicyCatalog; +import dev.caskeleton.grpc.api.policy.RpcIdempotencyProfile; import java.time.Duration; import java.util.List; import java.util.Map; diff --git a/src/messaging/CLAUDE.md b/src/messaging/CLAUDE.md index dacd813e..d051e292 100644 --- a/src/messaging/CLAUDE.md +++ b/src/messaging/CLAUDE.md @@ -77,6 +77,15 @@ storage/relay migration을 별도 change set으로 완료한 뒤에만 R0 seam canonical bridge의 producer identity는 `app.messaging.producer-id`로 명시한다. 값이 없으면 bridge bean을 만들지 않으며 `spring.application.name`/host/pod 이름에서 identity를 발명하지 않는다. +`ca-skeleton.outbox.canonical-transport-enabled=true`는 bridge 존재만으로 충분하지 않다. Stable +composition은 애플리케이션 계약 catalog/schema source를 임의로 만들지 않으므로 adopter가 +`IntegrationEventEncoderPort`를 명시적으로 제공해야 한다. 저장소의 후보 구현은 +`JsonSchemaIntegrationEventEncoder`이지만 이를 사용하려면 compiled contract descriptor, +`LocalJsonSchemaRegistry`, payload/envelope limits와 key material에 해당하는 application-owned 입력을 +같이 조립해야 한다. `OutboxCanonicalTransportRequirementValidator`는 publisher 또는 encoder 중 하나라도 +없으면 startup을 거부한다. 즉 canonical flag가 켜졌는데 정본 encoder가 없는 상태로 성공 기동하는 +경로는 없다. + ## Stable 승격에 필요한 증거 adapter를 Experimental → Stable로 올릴 때 필요한 것 (`docs/messaging/support-matrix.md`가 현재 diff --git a/src/messaging/messaging-admin-runtime/src/main/java/dev/caskeleton/messaging/admin/runtime/DestructiveMessagingAdmin.java b/src/messaging/messaging-admin-runtime/src/main/java/dev/caskeleton/messaging/admin/runtime/DestructiveMessagingAdmin.java index 7e6cec8a..8bd50dc2 100644 --- a/src/messaging/messaging-admin-runtime/src/main/java/dev/caskeleton/messaging/admin/runtime/DestructiveMessagingAdmin.java +++ b/src/messaging/messaging-admin-runtime/src/main/java/dev/caskeleton/messaging/admin/runtime/DestructiveMessagingAdmin.java @@ -1,6 +1,6 @@ package dev.caskeleton.messaging.admin.runtime; -import dev.caskeleton.messaging.admin.AdminApproval; +import dev.caskeleton.messaging.admin.VerifiedApproval; import dev.caskeleton.messaging.admin.DestructiveOperation; import dev.caskeleton.messaging.api.destination.DestinationName; import java.time.Duration; @@ -24,7 +24,7 @@ public interface DestructiveMessagingAdmin { record Approved( DestructiveOperation operation, DestinationName destination, - AdminApproval approval, + VerifiedApproval approval, long estimatedMessagesAffected) { public Approved { diff --git a/src/messaging/messaging-admin-runtime/src/main/java/dev/caskeleton/messaging/admin/runtime/ReplayService.java b/src/messaging/messaging-admin-runtime/src/main/java/dev/caskeleton/messaging/admin/runtime/ReplayService.java index 8aa316da..723e1ed8 100644 --- a/src/messaging/messaging-admin-runtime/src/main/java/dev/caskeleton/messaging/admin/runtime/ReplayService.java +++ b/src/messaging/messaging-admin-runtime/src/main/java/dev/caskeleton/messaging/admin/runtime/ReplayService.java @@ -13,13 +13,10 @@ import java.util.Optional; /** * Re-reads a destination from an earlier position. * - *

      An isolated replay reads alongside the live consumer and needs no approval, because it changes - * nothing: a throwaway group has its own offsets. Replaying into an existing production group is a - * different operation entirely — it rewinds a live consumer and reprocesses everything since — so - * it goes through the destructive guard. - * - *

      Making the safe form free and the destructive form approved is what keeps operators from - * reaching for the destructive one out of convenience. + *

      The request carries an {@code isolatedConsumerGroup} intent flag, but a caller-supplied + * boolean is not proof that the executor actually created or used an isolated broker group. + * Therefore every non-dry-run replay goes through the destructive guard until the runtime can + * attest isolation itself. Dry-run remains approval-free because it changes no broker state. */ public final class ReplayService { @@ -55,13 +52,8 @@ public final class ReplayService { Objects.requireNonNull(request, "request must not be null"); Objects.requireNonNull(approval, "approval must not be null"); - boolean needsApproval = !request.isolatedConsumerGroup(); guard.authorize( - DestructiveOperation.REPLAY, - request.destination(), - approval, - request.dryRun() || !needsApproval, - now); + DestructiveOperation.REPLAY, request.destination(), approval, request.dryRun(), now); if (request.dryRun()) { return new ReplayReport(request.replayId(), 0, true); @@ -74,7 +66,7 @@ public final class ReplayService { "REPLAY", subject, request.destination().value(), - approval.map(VerifiedApproval::ticket).orElse("isolated"), + approval.map(VerifiedApproval::ticket).orElse("dry-run"), now, Map.of( "replayId", request.replayId().toString(), diff --git a/src/messaging/messaging-admin-runtime/src/test/java/dev/caskeleton/messaging/admin/runtime/ApprovalForgeryTest.java b/src/messaging/messaging-admin-runtime/src/test/java/dev/caskeleton/messaging/admin/runtime/ApprovalForgeryTest.java index 38c8912b..abc54be1 100644 --- a/src/messaging/messaging-admin-runtime/src/test/java/dev/caskeleton/messaging/admin/runtime/ApprovalForgeryTest.java +++ b/src/messaging/messaging-admin-runtime/src/test/java/dev/caskeleton/messaging/admin/runtime/ApprovalForgeryTest.java @@ -187,6 +187,18 @@ class ApprovalForgeryTest { .isInstanceOf(IllegalArgumentException.class); } + @Test + @DisplayName("destructive admin plans can only carry a verified approval") + void destructiveAdminUsesTheUnforgeableApprovalType() { + assertThat( + java.util.Arrays.stream(DestructiveMessagingAdmin.Approved.class.getRecordComponents()) + .filter(component -> component.getName().equals("approval")) + .findFirst() + .orElseThrow() + .getType()) + .isEqualTo(VerifiedApproval.class); + } + @Test @DisplayName("a correctly issued approval executes") void aCorrectlyIssuedApprovalExecutes() { diff --git a/src/messaging/messaging-admin-runtime/src/test/java/dev/caskeleton/messaging/admin/runtime/ReplayServiceTest.java b/src/messaging/messaging-admin-runtime/src/test/java/dev/caskeleton/messaging/admin/runtime/ReplayServiceTest.java new file mode 100644 index 00000000..395ec201 --- /dev/null +++ b/src/messaging/messaging-admin-runtime/src/test/java/dev/caskeleton/messaging/admin/runtime/ReplayServiceTest.java @@ -0,0 +1,77 @@ +package dev.caskeleton.messaging.admin.runtime; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatThrownBy; + +import dev.caskeleton.messaging.admin.DestructiveOperationGuard; +import dev.caskeleton.messaging.admin.ReplayRequest; +import dev.caskeleton.messaging.api.destination.DestinationName; +import dev.caskeleton.messaging.api.error.MessageAuthorizationException; +import java.time.Duration; +import java.time.Instant; +import java.util.Optional; +import java.util.UUID; +import java.util.concurrent.atomic.AtomicInteger; +import org.junit.jupiter.api.Test; + +class ReplayServiceTest { + + private static final Instant NOW = Instant.parse("2026-09-21T00:00:00Z"); + private static final DestinationName DESTINATION = new DestinationName("orders.v1"); + + @Test + void callerClaimedIsolationDoesNotBypassApprovalForARealReplay() { + AtomicInteger executions = new AtomicInteger(); + ReplayService service = + new ReplayService( + new DestructiveOperationGuard(true), + request -> { + executions.incrementAndGet(); + return 1; + }, + event -> {}); + + ReplayRequest request = + new ReplayRequest( + UUID.fromString("0199aaaa-bbbb-7ccc-8ddd-eeeeffff1000"), + DESTINATION, + NOW.minus(Duration.ofHours(1)), + Optional.empty(), + true, + false); + + assertThatThrownBy(() -> service.replay(request, Optional.empty(), "operator", NOW)) + .isInstanceOfSatisfying( + MessageAuthorizationException.class, + failure -> assertThat(failure.failure().code()).isEqualTo("APPROVAL_REQUIRED")); + assertThat(executions).hasValue(0); + } + + @Test + void dryRunRemainsApprovalFreeEvenWhenIsolationIsOnlyAnIntentFlag() { + AtomicInteger executions = new AtomicInteger(); + ReplayService service = + new ReplayService( + new DestructiveOperationGuard(true), + request -> { + executions.incrementAndGet(); + return 1; + }, + event -> {}); + + ReplayRequest request = + new ReplayRequest( + UUID.fromString("0199aaaa-bbbb-7ccc-8ddd-eeeeffff1001"), + DESTINATION, + NOW.minus(Duration.ofHours(1)), + Optional.empty(), + true, + true); + + ReplayReport report = service.replay(request, Optional.empty(), "operator", NOW); + + assertThat(report.dryRun()).isTrue(); + assertThat(report.replayed()).isZero(); + assertThat(executions).hasValue(0); + } +} diff --git a/src/messaging/messaging-inbox-jdbc-postgresql/build.gradle b/src/messaging/messaging-inbox-jdbc-postgresql/build.gradle index 1cd44c7c..bf339f0d 100644 --- a/src/messaging/messaging-inbox-jdbc-postgresql/build.gradle +++ b/src/messaging/messaging-inbox-jdbc-postgresql/build.gradle @@ -1,7 +1,14 @@ plugins { + id 'ca.auxiliary-source-set' id 'ca.platform-module' } +auxiliarySourceSets { + sourceSet('integrationTest') { + compilesAgainst 'main' + } +} + dependencies { api project(':messaging:messaging-core-api') api project(':messaging:messaging-reliability-api') @@ -12,7 +19,15 @@ dependencies { // Live-database certification. The reliability patterns are claims about transaction // boundaries and uniqueness constraints, and only a real database can settle them. testImplementation project(':messaging:messaging-testkit') - testImplementation 'org.testcontainers:testcontainers-postgresql' - testImplementation 'org.testcontainers:testcontainers-junit-jupiter' - testImplementation 'org.postgresql:postgresql' + integrationTestImplementation 'org.testcontainers:testcontainers-postgresql' + integrationTestImplementation 'org.testcontainers:testcontainers-junit-jupiter' + integrationTestImplementation 'org.postgresql:postgresql' +} + +strictTestLanes { + lane('integrationTest') { + integration() + sourceSet = 'integrationTest' + description = 'Runs inbox transaction and uniqueness contracts against real PostgreSQL.' + } } diff --git a/src/messaging/messaging-inbox-jdbc-postgresql/gradle.lockfile b/src/messaging/messaging-inbox-jdbc-postgresql/gradle.lockfile index badf14ea..865fc312 100644 --- a/src/messaging/messaging-inbox-jdbc-postgresql/gradle.lockfile +++ b/src/messaging/messaging-inbox-jdbc-postgresql/gradle.lockfile @@ -1,53 +1,53 @@ # This is a Gradle generated file for dependency locking. # Manual edits can break the build and are not advised. # This file is expected to be part of source control. -com.fasterxml.jackson.core:jackson-annotations:2.21=testCompileClasspath,testRuntimeClasspath -com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,testAnnotationProcessor -com.github.docker-java:docker-java-api:3.7.1=testCompileClasspath,testRuntimeClasspath -com.github.docker-java:docker-java-transport-zerodep:3.7.1=testCompileClasspath,testRuntimeClasspath -com.github.docker-java:docker-java-transport:3.7.1=testCompileClasspath,testRuntimeClasspath -com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,testAnnotationProcessor +com.fasterxml.jackson.core:jackson-annotations:2.21=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.github.docker-java:docker-java-api:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.docker-java:docker-java-transport-zerodep:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.docker-java:docker-java-transport:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor com.github.spotbugs:spotbugs-annotations:4.10.2=spotbugs com.github.spotbugs:spotbugs:4.10.2=spotbugs com.github.stephenc.jcip:jcip-annotations:1.0-1=spotbugs -com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,testAnnotationProcessor -com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,testAnnotationProcessor -com.google.auto:auto-common:1.2.2=annotationProcessor,testAnnotationProcessor +com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.auto:auto-common:1.2.2=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor com.google.code.findbugs:jsr305:3.0.2=checkstyle,spotbugs com.google.code.gson:gson:2.13.2=spotbugs -com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor com.google.errorprone:error_prone_annotations:2.41.0=spotbugs com.google.errorprone:error_prone_annotations:2.47.0=checkstyle -com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,testAnnotationProcessor -com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,testAnnotationProcessor -com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,testAnnotationProcessor -com.google.guava:guava:33.5.0-jre=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.guava:guava:33.5.0-jre=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor com.google.guava:guava:33.6.0-jre=checkstyle -com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,testAnnotationProcessor -com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,testAnnotationProcessor -com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,testAnnotationProcessor +com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins com.puppycrawl.tools:checkstyle:13.5.0=checkstyle commons-beanutils:commons-beanutils:1.11.0=checkstyle -commons-codec:commons-codec:1.19.0=testCompileClasspath,testRuntimeClasspath +commons-codec:commons-codec:1.19.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath commons-collections:commons-collections:3.2.2=checkstyle -commons-io:commons-io:2.20.0=testCompileClasspath,testRuntimeClasspath +commons-io:commons-io:2.20.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath commons-io:commons-io:2.21.0=spotbugs -commons-logging:commons-logging:1.3.6=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +commons-logging:commons-logging:1.3.6=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath info.picocli:picocli:4.7.7=checkstyle -io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,testAnnotationProcessor -io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,testAnnotationProcessor -javax.inject:javax.inject:1=annotationProcessor,testAnnotationProcessor +io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +javax.inject:javax.inject:1=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor jaxen:jaxen:2.0.6=spotbugs -net.bytebuddy:byte-buddy:1.17.8=testCompileClasspath,testRuntimeClasspath -net.java.dev.jna:jna:5.18.1=testCompileClasspath,testRuntimeClasspath +net.bytebuddy:byte-buddy:1.17.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +net.java.dev.jna:jna:5.18.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs org.antlr:antlr4-runtime:4.13.2=checkstyle org.apache.bcel:bcel:6.12.0=spotbugs -org.apache.commons:commons-compress:1.28.0=testCompileClasspath,testRuntimeClasspath -org.apache.commons:commons-lang3:3.20.0=checkstyle,spotbugs,testCompileClasspath,testRuntimeClasspath +org.apache.commons:commons-compress:1.28.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.apache.commons:commons-lang3:3.20.0=checkstyle,integrationTestCompileClasspath,integrationTestRuntimeClasspath,spotbugs org.apache.commons:commons-text:1.15.0=spotbugs org.apache.commons:commons-text:1.3=checkstyle org.apache.httpcomponents:httpclient:4.5.13=checkstyle @@ -59,48 +59,48 @@ org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle org.apache.xbean:xbean-reflect:3.7=checkstyle -org.apiguardian:apiguardian-api:1.1.2=testCompileClasspath -org.assertj:assertj-core:3.27.7=testCompileClasspath,testRuntimeClasspath -org.checkerframework:checker-qual:3.55.1=testRuntimeClasspath +org.apiguardian:apiguardian-api:1.1.2=integrationTestCompileClasspath,testCompileClasspath +org.assertj:assertj-core:3.27.7=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.checkerframework:checker-qual:3.55.1=integrationTestRuntimeClasspath org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle org.codehaus.plexus:plexus-component-annotations:2.1.0=checkstyle org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle org.codehaus.plexus:plexus-utils:3.3.0=checkstyle org.dom4j:dom4j:2.2.0=spotbugs org.javassist:javassist:3.28.0-GA=checkstyle -org.jetbrains:annotations:17.0.0=testCompileClasspath,testRuntimeClasspath -org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-api:6.0.3=testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-engine:6.0.3=testRuntimeClasspath -org.junit.jupiter:junit-jupiter-params:6.0.3=testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter:6.0.3=testCompileClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-commons:6.0.3=testCompileClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-engine:6.0.3=testRuntimeClasspath -org.junit.platform:junit-platform-launcher:6.0.3=testRuntimeClasspath -org.junit:junit-bom:6.0.3=testCompileClasspath,testRuntimeClasspath +org.jetbrains:annotations:17.0.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,integrationTestAnnotationProcessor,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-api:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-engine:6.0.3=integrationTestRuntimeClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-params:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-commons:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-engine:6.0.3=integrationTestRuntimeClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-launcher:6.0.3=integrationTestRuntimeClasspath,testRuntimeClasspath +org.junit:junit-bom:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.junit:junit-bom:6.1.0=spotbugs org.mockito:mockito-core:5.20.0=mockitoAgent -org.opentest4j:opentest4j:1.3.0=testCompileClasspath,testRuntimeClasspath +org.opentest4j:opentest4j:1.3.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.ow2.asm:asm-analysis:9.10.1=spotbugs org.ow2.asm:asm-commons:9.10.1=spotbugs org.ow2.asm:asm-tree:9.10.1=spotbugs org.ow2.asm:asm-util:9.10.1=spotbugs org.ow2.asm:asm:9.10.1=spotbugs -org.pcollections:pcollections:4.0.1=annotationProcessor,testAnnotationProcessor -org.postgresql:postgresql:42.7.13=testCompileClasspath,testRuntimeClasspath +org.pcollections:pcollections:4.0.1=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +org.postgresql:postgresql:42.7.13=integrationTestCompileClasspath,integrationTestRuntimeClasspath org.reflections:reflections:0.10.2=checkstyle -org.rnorth.duct-tape:duct-tape:1.0.8=testCompileClasspath,testRuntimeClasspath -org.slf4j:slf4j-api:2.0.18=spotbugs,spotbugsSlf4j,testCompileClasspath,testRuntimeClasspath +org.rnorth.duct-tape:duct-tape:1.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.slf4j:slf4j-api:2.0.18=integrationTestCompileClasspath,integrationTestRuntimeClasspath,spotbugs,spotbugsSlf4j org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j org.slf4j:slf4j-simple:2.0.18=checkstyle -org.springframework:spring-beans:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-core:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-jdbc:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-tx:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers-database-commons:2.0.5=testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers-jdbc:2.0.5=testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers-junit-jupiter:2.0.5=testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers-postgresql:2.0.5=testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers:2.0.5=testCompileClasspath,testRuntimeClasspath +org.springframework:spring-beans:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-core:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-jdbc:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-tx:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.testcontainers:testcontainers-database-commons:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.testcontainers:testcontainers-jdbc:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.testcontainers:testcontainers-junit-jupiter:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.testcontainers:testcontainers-postgresql:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.testcontainers:testcontainers:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs empty= diff --git a/src/messaging/messaging-inbox-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/inbox/InboxPostgresIT.java b/src/messaging/messaging-inbox-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/inbox/InboxPostgresIT.java similarity index 98% rename from src/messaging/messaging-inbox-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/inbox/InboxPostgresIT.java rename to src/messaging/messaging-inbox-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/inbox/InboxPostgresIT.java index a3814181..367a6f5b 100644 --- a/src/messaging/messaging-inbox-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/inbox/InboxPostgresIT.java +++ b/src/messaging/messaging-inbox-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/inbox/InboxPostgresIT.java @@ -196,7 +196,7 @@ class InboxPostgresIT { try (InputStream stream = InboxPostgresIT.class .getClassLoader() - .getResourceAsStream("db/migration/messaging/V2__messaging_inbox.sql")) { + .getResourceAsStream("db/migration/messaging/V1101__messaging_inbox.sql")) { if (stream == null) { throw new IOException("the inbox migration is missing from the classpath"); } diff --git a/src/messaging/messaging-inbox-jdbc-postgresql/src/main/resources/db/migration/messaging/V2__messaging_inbox.sql b/src/messaging/messaging-inbox-jdbc-postgresql/src/main/resources/db/migration/messaging/V1101__messaging_inbox.sql similarity index 100% rename from src/messaging/messaging-inbox-jdbc-postgresql/src/main/resources/db/migration/messaging/V2__messaging_inbox.sql rename to src/messaging/messaging-inbox-jdbc-postgresql/src/main/resources/db/migration/messaging/V1101__messaging_inbox.sql diff --git a/src/messaging/messaging-kafka-share-experimental/build.gradle b/src/messaging/messaging-kafka-share-experimental/build.gradle index fd42b56b..33edc258 100644 --- a/src/messaging/messaging-kafka-share-experimental/build.gradle +++ b/src/messaging/messaging-kafka-share-experimental/build.gradle @@ -8,5 +8,4 @@ dependencies { api project(':messaging:messaging-transport-spi') api project(':messaging:messaging-kafka') - implementation 'org.apache.kafka:kafka-clients' } diff --git a/src/messaging/messaging-kafka-share-experimental/src/main/java/dev/caskeleton/messaging/kafka/share/KafkaShareGroupRegistrar.java b/src/messaging/messaging-kafka-share-experimental/src/main/java/dev/caskeleton/messaging/kafka/share/KafkaShareGroupRegistrar.java index 14424153..07c9ec1f 100644 --- a/src/messaging/messaging-kafka-share-experimental/src/main/java/dev/caskeleton/messaging/kafka/share/KafkaShareGroupRegistrar.java +++ b/src/messaging/messaging-kafka-share-experimental/src/main/java/dev/caskeleton/messaging/kafka/share/KafkaShareGroupRegistrar.java @@ -4,9 +4,6 @@ import dev.caskeleton.messaging.api.error.MessagingCapabilityUnavailableExceptio import dev.caskeleton.messaging.transport.TransportConsumerRegistration; import dev.caskeleton.messaging.transport.TransportConsumerSpec; import java.util.Objects; -import java.util.concurrent.CompletableFuture; -import java.util.concurrent.CompletionStage; -import java.util.concurrent.atomic.AtomicBoolean; /** * Registers a share group consumer, once the experimental guard has passed. @@ -44,45 +41,8 @@ public final class KafkaShareGroupRegistrar { KafkaShareProfile profile, TransportConsumerSpec spec) { Objects.requireNonNull(spec, "spec must not be null"); validator.validate(profile); - return new ShareRegistration(profile); - } - - /** A live share group subscription. */ - private static final class ShareRegistration implements TransportConsumerRegistration { - - private final KafkaShareProfile profile; - private final AtomicBoolean active = new AtomicBoolean(true); - - private ShareRegistration(KafkaShareProfile profile) { - this.profile = profile; - } - - @Override - public CompletionStage pause(String scope) { - return CompletableFuture.failedFuture( - new MessagingCapabilityUnavailableException( - "KAFKA_SHARE_NO_PAUSE", - "a Kafka share group has no partition assignment to pause: " - + profile.destination().value())); - } - - @Override - public CompletionStage resume(String scope) { - return CompletableFuture.failedFuture( - new MessagingCapabilityUnavailableException( - "KAFKA_SHARE_NO_RESUME", - "a Kafka share group has no partition assignment to resume: " - + profile.destination().value())); - } - - @Override - public boolean isActive() { - return active.get(); - } - - @Override - public void close() { - active.set(false); - } + throw new MessagingCapabilityUnavailableException( + "KAFKA_SHARE_CONSUMER_NOT_IMPLEMENTED", + "Kafka Share registration is not implemented; refusing to advertise an active consumer"); } } diff --git a/src/messaging/messaging-kafka-share-experimental/src/test/java/dev/caskeleton/messaging/kafka/share/KafkaShareProfileValidatorTest.java b/src/messaging/messaging-kafka-share-experimental/src/test/java/dev/caskeleton/messaging/kafka/share/KafkaShareProfileValidatorTest.java index 2772f825..e2ecf9ab 100644 --- a/src/messaging/messaging-kafka-share-experimental/src/test/java/dev/caskeleton/messaging/kafka/share/KafkaShareProfileValidatorTest.java +++ b/src/messaging/messaging-kafka-share-experimental/src/test/java/dev/caskeleton/messaging/kafka/share/KafkaShareProfileValidatorTest.java @@ -57,17 +57,18 @@ class KafkaShareProfileValidatorTest { } @Test - void pauseIsRefusedRatherThanSilentlyIgnored() { - var registration = - new KafkaShareGroupRegistrar() - .register( - KafkaShareProfileFixtures.profile(OrderingScope.NONE), - new dev.caskeleton.messaging.transport.TransportConsumerSpec( - KafkaShareProfileFixtures.destinationProfile(), - delivery -> java.util.concurrent.CompletableFuture.completedFuture(null))); - - assertThat(registration.pause("any").toCompletableFuture()).isCompletedExceptionally(); - assertThat(registration.isActive()).isTrue(); + void registerFailsClosedUntilAShareConsumerActuallyExists() { + assertThatThrownBy( + () -> + new KafkaShareGroupRegistrar() + .register( + KafkaShareProfileFixtures.profile(OrderingScope.NONE), + new dev.caskeleton.messaging.transport.TransportConsumerSpec( + KafkaShareProfileFixtures.destinationProfile(), + delivery -> + java.util.concurrent.CompletableFuture.completedFuture(null)))) + .isInstanceOf(MessagingCapabilityUnavailableException.class) + .hasMessageContaining("not implemented"); } } diff --git a/src/messaging/messaging-kafka/build.gradle b/src/messaging/messaging-kafka/build.gradle index a14c287a..dfd05337 100644 --- a/src/messaging/messaging-kafka/build.gradle +++ b/src/messaging/messaging-kafka/build.gradle @@ -1,9 +1,18 @@ plugins { + id 'java-test-fixtures' + id 'ca.auxiliary-source-set' id 'ca.jmh-benchmarks' id 'ca.messaging-certification' } +auxiliarySourceSets { + sourceSet('integrationTest') { + compilesAgainst 'main', 'testFixtures' + } +} + dependencies { + implementation 'org.springframework.kafka:spring-kafka' api project(':messaging:messaging-core-api') api project(':messaging:messaging-schema-api') api project(':messaging:messaging-policy') @@ -12,7 +21,6 @@ dependencies { api project(':messaging:messaging-security') api project(':messaging:messaging-admin-api') - implementation 'org.springframework.kafka:spring-kafka' // api: the public constructors and mappers take and return Producer, ProducerRecord and // RecordMetadata. Hiding the dependency does not hide the types — it only stops a consumer // from compiling against the API this module documents. @@ -21,6 +29,7 @@ dependencies { // Test-only. The shared adapter contract is what makes "Stable" mean something, so the Kafka // adapter runs it rather than asserting its own behaviour in its own terms. testImplementation project(':messaging:messaging-testkit') + testFixturesImplementation project(':messaging:messaging-testkit') // Test-only. The topology validator is broker-neutral, so it lives in the admin runtime; the // live-broker suite is here because only this module has a Kafka container to describe. @@ -28,10 +37,10 @@ dependencies { // Live-broker certification. The deterministic suite proves the platform's semantics; these // prove the client actually behaves that way against the version the matrix claims. - testImplementation 'org.testcontainers:testcontainers-junit-jupiter' - testImplementation 'org.testcontainers:testcontainers-kafka' - testImplementation 'org.testcontainers:testcontainers-toxiproxy' - testImplementation libs.toxiproxy.java + integrationTestImplementation 'org.testcontainers:testcontainers-junit-jupiter' + integrationTestImplementation 'org.testcontainers:testcontainers-kafka' + integrationTestImplementation 'org.testcontainers:testcontainers-toxiproxy' + integrationTestImplementation libs.toxiproxy.java } // The certification lane, and the gate that makes its output the only source of a Stable claim. @@ -45,7 +54,7 @@ dependencies { strictTestLanes { lane('messagingCertificationTest') { integration() - tag = 'messaging-certification' + sourceSet = 'integrationTest' description = 'Runs the broker fault scenarios against a real Kafka and writes the ' + 'certification evidence the compatibility matrix reads.' // Pinned images. A certification claim names the build it was made against, so a @@ -60,7 +69,9 @@ strictTestLanes { project.layout.buildDirectory .file('messaging-certification/broker-certification-evidence.jsonl') .get().asFile.absolutePath - // The commit is part of the evidence: "certified" is a claim about one source tree. + // The commit is provenance recorded in the evidence, not an equality key for the + // behavioral claim gate. Re-running the same scenario on a later commit refreshes + // provenance without creating a different scenario identity. // Read from the environment rather than a `-P` flag so the CI job's command line stays // the literal grammar the gate matrix lint accepts. systemProperty 'messaging.certification.commit', @@ -69,14 +80,3 @@ strictTestLanes { .toString() } } - -// The certification tag is excluded from `test` because the lane deliberately carries no Docker -// guard. Every other container suite here skips with a stated reason when Docker is absent; a lane -// that skipped would report success for a broker nobody started, which is the whole failure the -// evidence exists to rule out. Keeping it out of `test` is what lets it fail closed without -// breaking a laptop build. -tasks.named('test', Test) { - useJUnitPlatform { - excludeTags 'messaging-certification' - } -} diff --git a/src/messaging/messaging-kafka/gradle.lockfile b/src/messaging/messaging-kafka/gradle.lockfile index 3bbaee75..b38d8676 100644 --- a/src/messaging/messaging-kafka/gradle.lockfile +++ b/src/messaging/messaging-kafka/gradle.lockfile @@ -1,66 +1,66 @@ # This is a Gradle generated file for dependency locking. # Manual edits can break the build and are not advised. # This file is expected to be part of source control. -at.yawk.lz4:lz4-java:1.10.1=jmhRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -com.fasterxml.jackson.core:jackson-annotations:2.21=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor -com.github.docker-java:docker-java-api:3.7.1=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.github.docker-java:docker-java-transport-zerodep:3.7.1=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.github.docker-java:docker-java-transport:3.7.1=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor -com.github.luben:zstd-jni:1.5.6-10=jmhRuntimeClasspath,runtimeClasspath,testRuntimeClasspath +at.yawk.lz4:lz4-java:1.10.1=integrationTestRuntimeClasspath,jmhRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +com.fasterxml.jackson.core:jackson-annotations:2.21=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.github.docker-java:docker-java-api:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.docker-java:docker-java-transport-zerodep:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.docker-java:docker-java-transport:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.github.luben:zstd-jni:1.5.6-10=integrationTestRuntimeClasspath,jmhRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath com.github.spotbugs:spotbugs-annotations:4.10.2=spotbugs com.github.spotbugs:spotbugs:4.10.2=spotbugs com.github.stephenc.jcip:jcip-annotations:1.0-1=spotbugs -com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor -com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor -com.google.auto:auto-common:1.2.2=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor +com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.auto:auto-common:1.2.2=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor com.google.code.findbugs:jsr305:3.0.2=checkstyle,spotbugs -com.google.code.gson:gson:2.13.2=jmhCompileClasspath,jmhRuntimeClasspath,spotbugs,testCompileClasspath,testRuntimeClasspath -com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_annotations:2.41.0=jmhCompileClasspath,jmhRuntimeClasspath,spotbugs,testCompileClasspath,testRuntimeClasspath +com.google.code.gson:gson:2.13.2=integrationTestCompileClasspath,integrationTestRuntimeClasspath,spotbugs +com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.41.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,spotbugs com.google.errorprone:error_prone_annotations:2.47.0=checkstyle -com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor -com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor -com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,jmhAnnotationProcessor,testAnnotationProcessor -com.google.guava:guava:33.5.0-jre=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.guava:guava:33.5.0-jre=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor com.google.guava:guava:33.6.0-jre=checkstyle -com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,jmhAnnotationProcessor,testAnnotationProcessor -com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,jmhAnnotationProcessor,testAnnotationProcessor -com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor +com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins com.puppycrawl.tools:checkstyle:13.5.0=checkstyle commons-beanutils:commons-beanutils:1.11.0=checkstyle -commons-codec:commons-codec:1.19.0=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +commons-codec:commons-codec:1.19.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath commons-collections:commons-collections:3.2.2=checkstyle -commons-io:commons-io:2.20.0=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +commons-io:commons-io:2.20.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath commons-io:commons-io:2.21.0=spotbugs -commons-logging:commons-logging:1.3.6=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -eu.rekawek.toxiproxy:toxiproxy-java:2.1.7=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +commons-logging:commons-logging:1.3.6=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +eu.rekawek.toxiproxy:toxiproxy-java:2.1.7=integrationTestCompileClasspath,integrationTestRuntimeClasspath info.picocli:picocli:4.7.7=checkstyle -io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor -io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor -io.micrometer:micrometer-commons:1.16.7=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.micrometer:micrometer-core:1.16.7=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.micrometer:micrometer-observation:1.16.7=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -javax.inject:javax.inject:1=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor +io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +io.micrometer:micrometer-commons:1.16.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +io.micrometer:micrometer-core:1.16.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +io.micrometer:micrometer-observation:1.16.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +javax.inject:javax.inject:1=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor jaxen:jaxen:2.0.6=spotbugs -net.bytebuddy:byte-buddy:1.17.8=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.java.dev.jna:jna:5.18.1=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +net.bytebuddy:byte-buddy:1.17.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +net.java.dev.jna:jna:5.18.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath net.sf.jopt-simple:jopt-simple:5.0.4=jmhAnnotationProcessor,jmhCompileClasspath,jmhRuntimeClasspath net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs org.antlr:antlr4-runtime:4.13.2=checkstyle org.apache.bcel:bcel:6.12.0=spotbugs -org.apache.commons:commons-compress:1.28.0=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.apache.commons:commons-lang3:3.20.0=checkstyle,jmhCompileClasspath,jmhRuntimeClasspath,spotbugs,testCompileClasspath,testRuntimeClasspath +org.apache.commons:commons-compress:1.28.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.apache.commons:commons-lang3:3.20.0=checkstyle,integrationTestCompileClasspath,integrationTestRuntimeClasspath,spotbugs org.apache.commons:commons-math3:3.6.1=jmhAnnotationProcessor,jmhCompileClasspath,jmhRuntimeClasspath org.apache.commons:commons-text:1.15.0=spotbugs org.apache.commons:commons-text:1.3=checkstyle org.apache.httpcomponents:httpclient:4.5.13=checkstyle org.apache.httpcomponents:httpcore:4.4.16=checkstyle -org.apache.kafka:kafka-clients:4.1.2=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.apache.kafka:kafka-clients:4.1.2=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath org.apache.logging.log4j:log4j-api:2.25.5=spotbugs org.apache.logging.log4j:log4j-core:2.25.5=spotbugs org.apache.maven.doxia:doxia-core:1.12.0=checkstyle @@ -68,54 +68,54 @@ org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle org.apache.xbean:xbean-reflect:3.7=checkstyle -org.apiguardian:apiguardian-api:1.1.2=jmhCompileClasspath,testCompileClasspath -org.assertj:assertj-core:3.27.7=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.apiguardian:apiguardian-api:1.1.2=integrationTestCompileClasspath,jmhCompileClasspath,testCompileClasspath,testFixturesCompileClasspath +org.assertj:assertj-core:3.27.7=integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle org.codehaus.plexus:plexus-component-annotations:2.1.0=checkstyle org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle org.codehaus.plexus:plexus-utils:3.3.0=checkstyle org.dom4j:dom4j:2.2.0=spotbugs -org.hdrhistogram:HdrHistogram:2.2.2=jmhRuntimeClasspath,runtimeClasspath,testRuntimeClasspath +org.hdrhistogram:HdrHistogram:2.2.2=integrationTestRuntimeClasspath,jmhRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath org.javassist:javassist:3.28.0-GA=checkstyle -org.jetbrains:annotations:17.0.0=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,jmhAnnotationProcessor,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-api:6.0.3=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-engine:6.0.3=jmhRuntimeClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-params:6.0.3=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter:6.0.3=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-commons:6.0.3=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-engine:6.0.3=jmhRuntimeClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-launcher:6.0.3=jmhRuntimeClasspath,testRuntimeClasspath -org.junit:junit-bom:6.0.3=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.jetbrains:annotations:17.0.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,integrationTestAnnotationProcessor,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhAnnotationProcessor,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testFixturesAnnotationProcessor,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-api:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-engine:6.0.3=integrationTestRuntimeClasspath,jmhRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-params:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-commons:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-engine:6.0.3=integrationTestRuntimeClasspath,jmhRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-launcher:6.0.3=integrationTestRuntimeClasspath,jmhRuntimeClasspath,testRuntimeClasspath +org.junit:junit-bom:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath org.junit:junit-bom:6.1.0=spotbugs -org.latencyutils:LatencyUtils:2.0.3=jmhRuntimeClasspath,runtimeClasspath,testRuntimeClasspath +org.latencyutils:LatencyUtils:2.0.3=integrationTestRuntimeClasspath,jmhRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath org.mockito:mockito-core:5.20.0=mockitoAgent org.openjdk.jmh:jmh-core:1.37=jmhAnnotationProcessor,jmhCompileClasspath,jmhRuntimeClasspath org.openjdk.jmh:jmh-generator-annprocess:1.37=jmhAnnotationProcessor -org.opentest4j:opentest4j:1.3.0=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.opentest4j:opentest4j:1.3.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath org.ow2.asm:asm-analysis:9.10.1=spotbugs org.ow2.asm:asm-commons:9.10.1=spotbugs org.ow2.asm:asm-tree:9.10.1=spotbugs org.ow2.asm:asm-util:9.10.1=spotbugs org.ow2.asm:asm:9.10.1=spotbugs -org.pcollections:pcollections:4.0.1=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor +org.pcollections:pcollections:4.0.1=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor org.reflections:reflections:0.10.2=checkstyle -org.rnorth.duct-tape:duct-tape:1.0.8=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.slf4j:slf4j-api:2.0.18=jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testRuntimeClasspath +org.rnorth.duct-tape:duct-tape:1.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.slf4j:slf4j-api:2.0.18=integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhRuntimeClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testFixturesRuntimeClasspath,testRuntimeClasspath org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j org.slf4j:slf4j-simple:2.0.18=checkstyle -org.springframework.kafka:spring-kafka:4.0.7=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-aop:7.0.9=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-beans:7.0.9=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-context:7.0.9=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-core:7.0.9=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-expression:7.0.9=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-messaging:7.0.9=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-tx:7.0.9=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers-junit-jupiter:2.0.5=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers-kafka:2.0.5=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers-toxiproxy:2.0.5=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers:2.0.5=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.xerial.snappy:snappy-java:1.1.10.7=jmhRuntimeClasspath,runtimeClasspath,testRuntimeClasspath +org.springframework.kafka:spring-kafka:4.0.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.springframework:spring-aop:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.springframework:spring-beans:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.springframework:spring-context:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.springframework:spring-core:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.springframework:spring-expression:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.springframework:spring-messaging:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.springframework:spring-tx:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.testcontainers:testcontainers-junit-jupiter:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.testcontainers:testcontainers-kafka:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.testcontainers:testcontainers-toxiproxy:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.testcontainers:testcontainers:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.xerial.snappy:snappy-java:1.1.10.7=integrationTestRuntimeClasspath,jmhRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs empty= diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaAmbiguityChaosIT.java b/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaAmbiguityChaosIT.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaAmbiguityChaosIT.java rename to src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaAmbiguityChaosIT.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaBrokerCertificationIT.java b/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaBrokerCertificationIT.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaBrokerCertificationIT.java rename to src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaBrokerCertificationIT.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaBrokerIT.java b/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaBrokerIT.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaBrokerIT.java rename to src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaBrokerIT.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaConsumerSettlementIT.java b/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaConsumerSettlementIT.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaConsumerSettlementIT.java rename to src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaConsumerSettlementIT.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaContainerFixture.java b/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaContainerFixture.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaContainerFixture.java rename to src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaContainerFixture.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaContainerSmokeTest.java b/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaContainerSmokeTest.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaContainerSmokeTest.java rename to src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaContainerSmokeTest.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaReadCommittedIT.java b/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaReadCommittedIT.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaReadCommittedIT.java rename to src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaReadCommittedIT.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaTopologyValidationIT.java b/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTopologyValidationIT.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaTopologyValidationIT.java rename to src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTopologyValidationIT.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaTransactionFencingIT.java b/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTransactionFencingIT.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaTransactionFencingIT.java rename to src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTransactionFencingIT.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaTransactionFixtures.java b/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTransactionFixtures.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaTransactionFixtures.java rename to src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTransactionFixtures.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaTransactionIT.java b/src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTransactionIT.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaTransactionIT.java rename to src/messaging/messaging-kafka/src/integrationTest/java/dev/caskeleton/messaging/kafka/KafkaTransactionIT.java diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaConsumerRegistrar.java b/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaConsumerRegistrar.java index 241f0473..c285b5c4 100644 --- a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaConsumerRegistrar.java +++ b/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaConsumerRegistrar.java @@ -289,6 +289,8 @@ public final class KafkaConsumerRegistrar implements TransportConsumerRegistrati shutdown.endWork(); return; } + java.util.concurrent.CompletableFuture handler = null; + boolean releaseImmediately = true; try { int attempt = retryMetadataMapper.attemptOf(envelope); TransportDelivery delivery = @@ -301,19 +303,36 @@ public final class KafkaConsumerRegistrar implements TransportConsumerRegistrati profile.consumer().group().orElse(null), now), settlement); - // The declared handler timeout is applied. It existed as a policy field and the - // worker blocked on an unbounded join, so a handler that never returned held its - // partition's permit and its offset forever — the partition simply stopped. - spec.sink() - .apply(delivery) - .toCompletableFuture() - .get(handlerTimeout.toMillis(), java.util.concurrent.TimeUnit.MILLISECONDS); + // The declared handler timeout is applied. The outstanding stage is kept so timeout + // handling can cancel it before this partition becomes eligible for redelivery. + handler = spec.sink().apply(delivery).toCompletableFuture(); + handler.get(handlerTimeout.toMillis(), java.util.concurrent.TimeUnit.MILLISECONDS); } catch (java.util.concurrent.TimeoutException timedOut) { - // Unsettled work, not a completion: pause and re-read rather than advancing past a - // message whose handler may still be running. + // A timed-out handler may still be applying side effects. Cancel it before releasing + // the partition permit; otherwise the same offset can be dispatched again while the + // first handler is still running. + java.util.concurrent.CompletableFuture timedOutHandler = handler; settlement.requeueAfterFailure(); + if (timedOutHandler != null + && !timedOutHandler.cancel(true) + && !timedOutHandler.isDone()) { + releaseImmediately = false; + java.util.concurrent.CompletableFuture releaseAfterCompletion = + timedOutHandler.whenComplete( + (ignored, failure) -> { + coordinator.release(partition); + shutdown.endWork(); + }); + // Keep the continuation strongly referenced through this worker frame. The + // completion action owns the delayed permit/work-count release; its own result is + // intentionally not joined here. + Objects.requireNonNull(releaseAfterCompletion); + } } catch (InterruptedException interrupted) { Thread.currentThread().interrupt(); + if (handler != null) { + handler.cancel(true); + } settlement.requeueAfterFailure(); } catch (java.util.concurrent.ExecutionException | RuntimeException failure) { // A handler failure is retried, not parked. PARKED completed the offset without any @@ -321,8 +340,10 @@ public final class KafkaConsumerRegistrar implements TransportConsumerRegistrati // every message it touched. settlement.requeueAfterFailure(); } finally { - coordinator.release(partition); - shutdown.endWork(); + if (releaseImmediately) { + coordinator.release(partition); + shutdown.endWork(); + } } }); return true; @@ -509,10 +530,13 @@ public final class KafkaConsumerRegistrar implements TransportConsumerRegistrati // Close still runs here rather than through the queue: after this the poll loop stops, so // queued work would never drain. What it does not do is race an in-progress poll — callers // stop the loop first, and `active` makes a second close a no-op. - drainControl(); - applySettlements(); - commitContiguous(); - consumer.close(); + try { + drainControl(); + applySettlements(); + commitContiguous(); + } finally { + consumer.close(); + } } } diff --git a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSecurityConfigurer.java b/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSecurityConfigurer.java index 2e1d6720..e9ca621d 100644 --- a/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSecurityConfigurer.java +++ b/src/messaging/messaging-kafka/src/main/java/dev/caskeleton/messaging/kafka/KafkaSecurityConfigurer.java @@ -19,9 +19,12 @@ import java.util.Objects; * configured from a value read once at startup holds that value until the process restarts, so the * rotation the credential store performs never reaches the broker connection. * - *

      The JAAS config is assembled into a {@code String} because that is the only shape Kafka's - * client accepts, and it is deliberately never retained — the method returns the map and keeps no - * reference, so the secret's lifetime is the caller's. + *

      The JAAS config is assembled into a {@code String} because that is the shape Kafka's client + * configuration accepts. The configurer keeps no field reference after returning the map, but the + * returned immutable String contains the credential and cannot be zeroized; its lifetime is the + * Kafka/client configuration lifetime. The source {@link CredentialRuntime} material is still + * zeroizable, but converting it to JAAS necessarily weakens that property and must not be described + * as if the String never existed. */ public final class KafkaSecurityConfigurer { diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaConsumerRegistrarTest.java b/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaConsumerRegistrarTest.java index 981b9417..8270f050 100644 --- a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaConsumerRegistrarTest.java +++ b/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaConsumerRegistrarTest.java @@ -153,6 +153,93 @@ class KafkaConsumerRegistrarTest { assertThat(registrar.isActive()).isFalse(); } + @Test + void handlerTimeoutCancelsTheOutstandingHandlerBeforeThePartitionPermitIsReleased() { + CompletableFuture handler = new CompletableFuture<>(); + dev.caskeleton.messaging.policy.DestinationProfile base = KafkaContractHarness.profile(); + dev.caskeleton.messaging.policy.DestinationProfile fastTimeout = + new dev.caskeleton.messaging.policy.DestinationProfile( + base.name(), + base.broker(), + base.kind(), + base.physical(), + base.schema(), + base.deliveryGuarantee(), + base.orderingScope(), + base.externalSideEffectGuarantee(), + base.producer(), + new dev.caskeleton.messaging.policy.ConsumerPolicy( + base.consumer().group(), + base.consumer().concurrency(), + base.consumer().maxInFlightPerOrderingUnit(), + base.consumer().prefetch(), + Duration.ofMillis(5), + base.consumer().manualSettlement()), + base.retry(), + base.deadLetter(), + base.payload(), + base.tier(), + base.production(), + base.keyResolverConfigured(), + base.topologyAutoCreate()); + + KafkaConsumerRegistrar registrar = + new KafkaConsumerRegistrar( + new TransportConsumerSpec(fastTimeout, delivery -> handler), + consumer, + handlers, + new GracefulShutdownCoordinator(Duration.ofSeconds(30)), + Duration.ofMillis(1)); + + assign(); + addRecord(10); + registrar.pollOnce(NOW); + handlers.runAll(); + + assertThat(handler) + .as("a timed-out handler must be cancelled before the same partition can be redelivered") + .isCancelled(); + } + + @Test + void closeStillClosesTheConsumerWhenTheFinalCommitFails() { + CommitFailingConsumer failing = new CommitFailingConsumer(); + failing.assign(List.of(PARTITION)); + failing.updateBeginningOffsets(Map.of(PARTITION, 10L)); + failing.seek(PARTITION, 10L); + + RecordHeaders headers = new RecordHeaders(); + headers.add( + ReservedHeaders.MESSAGE_ID, + MessageId.newId().value().toString().getBytes(StandardCharsets.UTF_8)); + headers.add(ReservedHeaders.MESSAGE_TYPE, "order.created".getBytes(StandardCharsets.UTF_8)); + headers.add(ReservedHeaders.SCHEMA_VERSION, "1".getBytes(StandardCharsets.UTF_8)); + headers.add(ReservedHeaders.CONTENT_TYPE, "application/json".getBytes(StandardCharsets.UTF_8)); + failing.addRecord(record(10, headers)); + + KafkaConsumerRegistrar registrar = + new KafkaConsumerRegistrar( + new TransportConsumerSpec( + KafkaContractHarness.profile(), + delivery -> { + delivery.settlement().acknowledge().toCompletableFuture().join(); + return CompletableFuture.completedFuture(null); + }), + failing, + Runnable::run, + new GracefulShutdownCoordinator(Duration.ofSeconds(30)), + Duration.ofMillis(1)); + + registrar.pollOnce(NOW); + failing.failCommits = true; + + org.assertj.core.api.Assertions.assertThatThrownBy(registrar::close) + .isInstanceOf(org.apache.kafka.clients.consumer.CommitFailedException.class); + assertThat(failing.closed()) + .as("a failed final commit must not leak the consumer/group membership") + .isTrue(); + } + @Test void pauseAndResumeOperateOnTheAssignedPartitions() { KafkaConsumerRegistrar registrar = registrar(this::settleImmediately); @@ -377,7 +464,7 @@ class KafkaConsumerRegistrarTest { consumer.addRecord(record(offset, new RecordHeaders())); } - private ConsumerRecord record(long offset, RecordHeaders headers) { + private static ConsumerRecord record(long offset, RecordHeaders headers) { return new ConsumerRecord<>( TOPIC, 0, @@ -420,6 +507,24 @@ class KafkaConsumerRegistrarTest { handled.add(delivery); return CompletableFuture.completedFuture(null); } + + private static final class CommitFailingConsumer extends MockConsumer { + private boolean failCommits; + + CommitFailingConsumer() { + super("earliest"); + } + + @Override + public synchronized void commitSync( + Map offsets) { + if (failCommits) { + throw new org.apache.kafka.clients.consumer.CommitFailedException("forced final commit"); + } + super.commitSync(offsets); + } + } + } /** Queues handler work so the in-flight ceiling is observable. */ diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaContractHarness.java b/src/messaging/messaging-kafka/src/testFixtures/java/dev/caskeleton/messaging/kafka/KafkaContractHarness.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaContractHarness.java rename to src/messaging/messaging-kafka/src/testFixtures/java/dev/caskeleton/messaging/kafka/KafkaContractHarness.java diff --git a/src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaFixtureProfiles.java b/src/messaging/messaging-kafka/src/testFixtures/java/dev/caskeleton/messaging/kafka/KafkaFixtureProfiles.java similarity index 100% rename from src/messaging/messaging-kafka/src/test/java/dev/caskeleton/messaging/kafka/KafkaFixtureProfiles.java rename to src/messaging/messaging-kafka/src/testFixtures/java/dev/caskeleton/messaging/kafka/KafkaFixtureProfiles.java diff --git a/src/messaging/messaging-nats-experimental/build.gradle b/src/messaging/messaging-nats-experimental/build.gradle index d635cefa..929bf94c 100644 --- a/src/messaging/messaging-nats-experimental/build.gradle +++ b/src/messaging/messaging-nats-experimental/build.gradle @@ -11,5 +11,4 @@ dependencies { api project(':messaging:messaging-security') api project(':messaging:messaging-admin-api') - implementation libs.jnats } diff --git a/src/messaging/messaging-nats-experimental/gradle.lockfile b/src/messaging/messaging-nats-experimental/gradle.lockfile index 03040a9c..f5ad1bb5 100644 --- a/src/messaging/messaging-nats-experimental/gradle.lockfile +++ b/src/messaging/messaging-nats-experimental/gradle.lockfile @@ -35,7 +35,6 @@ io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,testAnnotatio io.micrometer:micrometer-commons:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath io.micrometer:micrometer-core:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath io.micrometer:micrometer-observation:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.nats:jnats:2.26.2=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath javax.inject:javax.inject:1=annotationProcessor,testAnnotationProcessor jaxen:jaxen:2.0.6=spotbugs net.bytebuddy:byte-buddy:1.17.8=testCompileClasspath,testRuntimeClasspath @@ -56,7 +55,6 @@ org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle org.apache.xbean:xbean-reflect:3.7=checkstyle org.apiguardian:apiguardian-api:1.1.2=testCompileClasspath org.assertj:assertj-core:3.27.7=testCompileClasspath,testRuntimeClasspath -org.bouncycastle:bcprov-lts8on:2.73.10=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle org.codehaus.plexus:plexus-component-annotations:2.1.0=checkstyle org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle diff --git a/src/messaging/messaging-outbox-jdbc-postgresql/build.gradle b/src/messaging/messaging-outbox-jdbc-postgresql/build.gradle index 8aabecdb..36beb142 100644 --- a/src/messaging/messaging-outbox-jdbc-postgresql/build.gradle +++ b/src/messaging/messaging-outbox-jdbc-postgresql/build.gradle @@ -1,7 +1,14 @@ plugins { + id 'ca.auxiliary-source-set' id 'ca.platform-module' } +auxiliarySourceSets { + sourceSet('integrationTest') { + compilesAgainst 'main' + } +} + dependencies { api project(':messaging:messaging-core-api') api project(':messaging:messaging-reliability-api') @@ -19,7 +26,15 @@ dependencies { // Live-database certification. The reliability patterns are claims about transaction // boundaries and uniqueness constraints, and only a real database can settle them. testImplementation project(':messaging:messaging-testkit') - testImplementation 'org.testcontainers:testcontainers-postgresql' - testImplementation 'org.testcontainers:testcontainers-junit-jupiter' - testImplementation 'org.postgresql:postgresql' + integrationTestImplementation 'org.testcontainers:testcontainers-postgresql' + integrationTestImplementation 'org.testcontainers:testcontainers-junit-jupiter' + integrationTestImplementation 'org.postgresql:postgresql' +} + +strictTestLanes { + lane('integrationTest') { + integration() + sourceSet = 'integrationTest' + description = 'Runs outbox and admin-journal contracts against real PostgreSQL.' + } } diff --git a/src/messaging/messaging-outbox-jdbc-postgresql/gradle.lockfile b/src/messaging/messaging-outbox-jdbc-postgresql/gradle.lockfile index 93005bc0..608e6f7b 100644 --- a/src/messaging/messaging-outbox-jdbc-postgresql/gradle.lockfile +++ b/src/messaging/messaging-outbox-jdbc-postgresql/gradle.lockfile @@ -1,56 +1,56 @@ # This is a Gradle generated file for dependency locking. # Manual edits can break the build and are not advised. # This file is expected to be part of source control. -com.fasterxml.jackson.core:jackson-annotations:2.21=testCompileClasspath,testRuntimeClasspath -com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,testAnnotationProcessor -com.github.docker-java:docker-java-api:3.7.1=testCompileClasspath,testRuntimeClasspath -com.github.docker-java:docker-java-transport-zerodep:3.7.1=testCompileClasspath,testRuntimeClasspath -com.github.docker-java:docker-java-transport:3.7.1=testCompileClasspath,testRuntimeClasspath -com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,testAnnotationProcessor +com.fasterxml.jackson.core:jackson-annotations:2.21=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.github.docker-java:docker-java-api:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.docker-java:docker-java-transport-zerodep:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.docker-java:docker-java-transport:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor com.github.spotbugs:spotbugs-annotations:4.10.2=spotbugs com.github.spotbugs:spotbugs:4.10.2=spotbugs com.github.stephenc.jcip:jcip-annotations:1.0-1=spotbugs -com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,testAnnotationProcessor -com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,testAnnotationProcessor -com.google.auto:auto-common:1.2.2=annotationProcessor,testAnnotationProcessor +com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.auto:auto-common:1.2.2=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor com.google.code.findbugs:jsr305:3.0.2=checkstyle,spotbugs com.google.code.gson:gson:2.13.2=spotbugs -com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor com.google.errorprone:error_prone_annotations:2.41.0=spotbugs com.google.errorprone:error_prone_annotations:2.47.0=checkstyle -com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,testAnnotationProcessor -com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,testAnnotationProcessor -com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,testAnnotationProcessor -com.google.guava:guava:33.5.0-jre=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.guava:guava:33.5.0-jre=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor com.google.guava:guava:33.6.0-jre=checkstyle -com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,testAnnotationProcessor -com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,testAnnotationProcessor -com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,testAnnotationProcessor +com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins com.puppycrawl.tools:checkstyle:13.5.0=checkstyle commons-beanutils:commons-beanutils:1.11.0=checkstyle -commons-codec:commons-codec:1.19.0=testCompileClasspath,testRuntimeClasspath +commons-codec:commons-codec:1.19.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath commons-collections:commons-collections:3.2.2=checkstyle -commons-io:commons-io:2.20.0=testCompileClasspath,testRuntimeClasspath +commons-io:commons-io:2.20.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath commons-io:commons-io:2.21.0=spotbugs -commons-logging:commons-logging:1.3.6=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +commons-logging:commons-logging:1.3.6=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath info.picocli:picocli:4.7.7=checkstyle -io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,testAnnotationProcessor -io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,testAnnotationProcessor -io.micrometer:micrometer-commons:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.micrometer:micrometer-core:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.micrometer:micrometer-observation:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -javax.inject:javax.inject:1=annotationProcessor,testAnnotationProcessor +io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +io.micrometer:micrometer-commons:1.16.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.micrometer:micrometer-core:1.16.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.micrometer:micrometer-observation:1.16.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +javax.inject:javax.inject:1=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor jaxen:jaxen:2.0.6=spotbugs -net.bytebuddy:byte-buddy:1.17.8=testCompileClasspath,testRuntimeClasspath -net.java.dev.jna:jna:5.18.1=testCompileClasspath,testRuntimeClasspath +net.bytebuddy:byte-buddy:1.17.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +net.java.dev.jna:jna:5.18.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs org.antlr:antlr4-runtime:4.13.2=checkstyle org.apache.bcel:bcel:6.12.0=spotbugs -org.apache.commons:commons-compress:1.28.0=testCompileClasspath,testRuntimeClasspath -org.apache.commons:commons-lang3:3.20.0=checkstyle,spotbugs,testCompileClasspath,testRuntimeClasspath +org.apache.commons:commons-compress:1.28.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.apache.commons:commons-lang3:3.20.0=checkstyle,integrationTestCompileClasspath,integrationTestRuntimeClasspath,spotbugs org.apache.commons:commons-text:1.15.0=spotbugs org.apache.commons:commons-text:1.3=checkstyle org.apache.httpcomponents:httpclient:4.5.13=checkstyle @@ -62,50 +62,50 @@ org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle org.apache.xbean:xbean-reflect:3.7=checkstyle -org.apiguardian:apiguardian-api:1.1.2=testCompileClasspath -org.assertj:assertj-core:3.27.7=testCompileClasspath,testRuntimeClasspath -org.checkerframework:checker-qual:3.55.1=testRuntimeClasspath +org.apiguardian:apiguardian-api:1.1.2=integrationTestCompileClasspath,testCompileClasspath +org.assertj:assertj-core:3.27.7=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.checkerframework:checker-qual:3.55.1=integrationTestRuntimeClasspath org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle org.codehaus.plexus:plexus-component-annotations:2.1.0=checkstyle org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle org.codehaus.plexus:plexus-utils:3.3.0=checkstyle org.dom4j:dom4j:2.2.0=spotbugs -org.hdrhistogram:HdrHistogram:2.2.2=runtimeClasspath,testRuntimeClasspath +org.hdrhistogram:HdrHistogram:2.2.2=integrationTestRuntimeClasspath,runtimeClasspath,testRuntimeClasspath org.javassist:javassist:3.28.0-GA=checkstyle -org.jetbrains:annotations:17.0.0=testCompileClasspath,testRuntimeClasspath -org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-api:6.0.3=testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-engine:6.0.3=testRuntimeClasspath -org.junit.jupiter:junit-jupiter-params:6.0.3=testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter:6.0.3=testCompileClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-commons:6.0.3=testCompileClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-engine:6.0.3=testRuntimeClasspath -org.junit.platform:junit-platform-launcher:6.0.3=testRuntimeClasspath -org.junit:junit-bom:6.0.3=testCompileClasspath,testRuntimeClasspath +org.jetbrains:annotations:17.0.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,integrationTestAnnotationProcessor,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-api:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-engine:6.0.3=integrationTestRuntimeClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-params:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-commons:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-engine:6.0.3=integrationTestRuntimeClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-launcher:6.0.3=integrationTestRuntimeClasspath,testRuntimeClasspath +org.junit:junit-bom:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.junit:junit-bom:6.1.0=spotbugs -org.latencyutils:LatencyUtils:2.0.3=runtimeClasspath,testRuntimeClasspath +org.latencyutils:LatencyUtils:2.0.3=integrationTestRuntimeClasspath,runtimeClasspath,testRuntimeClasspath org.mockito:mockito-core:5.20.0=mockitoAgent -org.opentest4j:opentest4j:1.3.0=testCompileClasspath,testRuntimeClasspath +org.opentest4j:opentest4j:1.3.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.ow2.asm:asm-analysis:9.10.1=spotbugs org.ow2.asm:asm-commons:9.10.1=spotbugs org.ow2.asm:asm-tree:9.10.1=spotbugs org.ow2.asm:asm-util:9.10.1=spotbugs org.ow2.asm:asm:9.10.1=spotbugs -org.pcollections:pcollections:4.0.1=annotationProcessor,testAnnotationProcessor -org.postgresql:postgresql:42.7.13=testCompileClasspath,testRuntimeClasspath +org.pcollections:pcollections:4.0.1=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +org.postgresql:postgresql:42.7.13=integrationTestCompileClasspath,integrationTestRuntimeClasspath org.reflections:reflections:0.10.2=checkstyle -org.rnorth.duct-tape:duct-tape:1.0.8=testCompileClasspath,testRuntimeClasspath -org.slf4j:slf4j-api:2.0.18=spotbugs,spotbugsSlf4j,testCompileClasspath,testRuntimeClasspath +org.rnorth.duct-tape:duct-tape:1.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.slf4j:slf4j-api:2.0.18=integrationTestCompileClasspath,integrationTestRuntimeClasspath,spotbugs,spotbugsSlf4j org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j org.slf4j:slf4j-simple:2.0.18=checkstyle -org.springframework:spring-beans:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-core:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-jdbc:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-tx:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers-database-commons:2.0.5=testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers-jdbc:2.0.5=testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers-junit-jupiter:2.0.5=testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers-postgresql:2.0.5=testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers:2.0.5=testCompileClasspath,testRuntimeClasspath +org.springframework:spring-beans:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-core:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-jdbc:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-tx:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.testcontainers:testcontainers-database-commons:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.testcontainers:testcontainers-jdbc:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.testcontainers:testcontainers-junit-jupiter:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.testcontainers:testcontainers-postgresql:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.testcontainers:testcontainers:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs empty= diff --git a/src/messaging/messaging-outbox-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/outbox/AdminOperationJournalPostgresIT.java b/src/messaging/messaging-outbox-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/outbox/AdminOperationJournalPostgresIT.java similarity index 99% rename from src/messaging/messaging-outbox-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/outbox/AdminOperationJournalPostgresIT.java rename to src/messaging/messaging-outbox-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/outbox/AdminOperationJournalPostgresIT.java index 5d435b52..7752598e 100644 --- a/src/messaging/messaging-outbox-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/outbox/AdminOperationJournalPostgresIT.java +++ b/src/messaging/messaging-outbox-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/outbox/AdminOperationJournalPostgresIT.java @@ -67,7 +67,7 @@ class AdminOperationJournalPostgresIT { try (Connection connection = dataSource.getConnection(); Statement statement = connection.createStatement()) { statement.execute("DROP TABLE IF EXISTS messaging_admin_operation"); - statement.execute(migration("V3__messaging_admin_operation_journal.sql")); + statement.execute(migration("V1003__messaging_admin_operation_journal.sql")); } journal = new JdbcAdminOperationJournal(dataSource); } diff --git a/src/messaging/messaging-outbox-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/outbox/OutboxPostgresIT.java b/src/messaging/messaging-outbox-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/outbox/OutboxPostgresIT.java similarity index 99% rename from src/messaging/messaging-outbox-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/outbox/OutboxPostgresIT.java rename to src/messaging/messaging-outbox-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/outbox/OutboxPostgresIT.java index eeb58841..cb2d95d9 100644 --- a/src/messaging/messaging-outbox-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/outbox/OutboxPostgresIT.java +++ b/src/messaging/messaging-outbox-jdbc-postgresql/src/integrationTest/java/dev/caskeleton/messaging/outbox/OutboxPostgresIT.java @@ -147,7 +147,7 @@ class OutboxPostgresIT { appendInTransaction(record); repository.leaseBatch(10, Duration.ofSeconds(30), NOW); - repository.markPublished(record.messageId(), NOW); + repository.markPublishedUnfenced(record.messageId(), NOW); assertThat(repository.find(record.messageId()).orElseThrow().status()) .isEqualTo(OutboxStatus.PUBLISHED); @@ -160,7 +160,7 @@ class OutboxPostgresIT { appendInTransaction(record); repository.leaseBatch(10, Duration.ofSeconds(30), NOW); - repository.markFailed(record.messageId(), "INVALID_TOPIC", NOW); + repository.markFailedUnfenced(record.messageId(), "INVALID_TOPIC", NOW); assertThat(repository.leaseBatch(10, Duration.ofSeconds(30), NOW.plusSeconds(60))).isEmpty(); } @@ -197,7 +197,7 @@ class OutboxPostgresIT { OutboxRecord pending = record(); appendInTransaction(published); appendInTransaction(pending); - repository.markPublished(published.messageId(), NOW); + repository.markPublishedUnfenced(published.messageId(), NOW); int removed = repository.purgePublishedBefore(NOW.plusSeconds(1)); diff --git a/src/messaging/messaging-outbox-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/outbox/JdbcOutboxRepository.java b/src/messaging/messaging-outbox-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/outbox/JdbcOutboxRepository.java index ec88cbae..44a986ad 100644 --- a/src/messaging/messaging-outbox-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/outbox/JdbcOutboxRepository.java +++ b/src/messaging/messaging-outbox-jdbc-postgresql/src/main/java/dev/caskeleton/messaging/outbox/JdbcOutboxRepository.java @@ -75,7 +75,8 @@ public final class JdbcOutboxRepository implements OutboxRepository { payload, headers, created_at, status, attempts, lease_expires_at, last_failure_code, producer, occurred_at, correlation_id, causation_id, tenant, partition_key, ordering_key, schema_subject, schema_uri, - traceparent, tracestate, baggage"""; + traceparent, tracestate, baggage\ + """; private static final String LEASE = """ @@ -351,7 +352,8 @@ public final class JdbcOutboxRepository implements OutboxRepository { Objects.requireNonNull(lease, "lease must not be null"); String sql = setClause - + "WHERE message_id = ? AND status = 'IN_FLIGHT' AND lease_owner = ? AND lease_token = ?"; + + "WHERE message_id = ? AND status = 'IN_FLIGHT' AND lease_owner = ? AND lease_token =" + + " ?"; return withConnection( connection -> { try (PreparedStatement statement = connection.prepareStatement(sql)) { @@ -400,7 +402,8 @@ public final class JdbcOutboxRepository implements OutboxRepository { Objects.requireNonNull(lease, "lease must not be null"); String sql = setClause - + "WHERE message_id = ? AND status = 'IN_FLIGHT' AND lease_owner = ? AND lease_token = ?"; + + "WHERE message_id = ? AND status = 'IN_FLIGHT' AND lease_owner = ? AND lease_token =" + + " ?"; return withConnection( connection -> { try (PreparedStatement statement = connection.prepareStatement(sql)) { @@ -420,8 +423,7 @@ public final class JdbcOutboxRepository implements OutboxRepository { }); } - @Override - public void markPublished(MessageId messageId, Instant now) { + public void markPublishedUnfenced(MessageId messageId, Instant now) { update( "UPDATE messaging_outbox SET status = 'PUBLISHED', published_at = ?, " + "lease_expires_at = NULL, attempts = attempts + 1 WHERE message_id = ?", @@ -430,8 +432,7 @@ public final class JdbcOutboxRepository implements OutboxRepository { null); } - @Override - public void markAmbiguous(MessageId messageId, String failureCode, Instant now) { + public void markAmbiguousUnfenced(MessageId messageId, String failureCode, Instant now) { // The lease is released rather than held: an ambiguous row must become claimable again so the // relay retries it under the same message id. update( @@ -442,8 +443,7 @@ public final class JdbcOutboxRepository implements OutboxRepository { failureCode); } - @Override - public void markFailed(MessageId messageId, String failureCode, Instant now) { + public void markFailedUnfenced(MessageId messageId, String failureCode, Instant now) { update( "UPDATE messaging_outbox SET status = 'FAILED', lease_expires_at = NULL, " + "last_failure_code = ?, attempts = attempts + 1 WHERE message_id = ?", @@ -452,8 +452,7 @@ public final class JdbcOutboxRepository implements OutboxRepository { failureCode); } - @Override - public void releaseLease(MessageId messageId) { + public void releaseLeaseUnfenced(MessageId messageId) { withConnection( connection -> { try (PreparedStatement statement = diff --git a/src/messaging/messaging-outbox-jdbc-postgresql/src/main/resources/db/migration/messaging/V1__messaging_outbox.sql b/src/messaging/messaging-outbox-jdbc-postgresql/src/main/resources/db/migration/messaging/V1001__messaging_outbox.sql similarity index 100% rename from src/messaging/messaging-outbox-jdbc-postgresql/src/main/resources/db/migration/messaging/V1__messaging_outbox.sql rename to src/messaging/messaging-outbox-jdbc-postgresql/src/main/resources/db/migration/messaging/V1001__messaging_outbox.sql diff --git a/src/messaging/messaging-outbox-jdbc-postgresql/src/main/resources/db/migration/messaging/V2__messaging_outbox_lease_fencing.sql b/src/messaging/messaging-outbox-jdbc-postgresql/src/main/resources/db/migration/messaging/V1002__messaging_outbox_lease_fencing.sql similarity index 100% rename from src/messaging/messaging-outbox-jdbc-postgresql/src/main/resources/db/migration/messaging/V2__messaging_outbox_lease_fencing.sql rename to src/messaging/messaging-outbox-jdbc-postgresql/src/main/resources/db/migration/messaging/V1002__messaging_outbox_lease_fencing.sql diff --git a/src/messaging/messaging-outbox-jdbc-postgresql/src/main/resources/db/migration/messaging/V3__messaging_admin_operation_journal.sql b/src/messaging/messaging-outbox-jdbc-postgresql/src/main/resources/db/migration/messaging/V1003__messaging_admin_operation_journal.sql similarity index 100% rename from src/messaging/messaging-outbox-jdbc-postgresql/src/main/resources/db/migration/messaging/V3__messaging_admin_operation_journal.sql rename to src/messaging/messaging-outbox-jdbc-postgresql/src/main/resources/db/migration/messaging/V1003__messaging_admin_operation_journal.sql diff --git a/src/messaging/messaging-outbox-jdbc-postgresql/src/main/resources/db/migration/messaging/V4__messaging_outbox_canonical_metadata.sql b/src/messaging/messaging-outbox-jdbc-postgresql/src/main/resources/db/migration/messaging/V1004__messaging_outbox_canonical_metadata.sql similarity index 100% rename from src/messaging/messaging-outbox-jdbc-postgresql/src/main/resources/db/migration/messaging/V4__messaging_outbox_canonical_metadata.sql rename to src/messaging/messaging-outbox-jdbc-postgresql/src/main/resources/db/migration/messaging/V1004__messaging_outbox_canonical_metadata.sql diff --git a/src/messaging/messaging-outbox-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/outbox/OutboxOperationsTest.java b/src/messaging/messaging-outbox-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/outbox/OutboxOperationsTest.java index 54250415..f7df5cbf 100644 --- a/src/messaging/messaging-outbox-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/outbox/OutboxOperationsTest.java +++ b/src/messaging/messaging-outbox-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/outbox/OutboxOperationsTest.java @@ -64,55 +64,30 @@ class OutboxOperationsTest { @Override public dev.caskeleton.messaging.reliability.OutboxTransitionResult markExhausted( dev.caskeleton.messaging.reliability.OutboxLease lease, String reason, Instant now) { - markFailed(lease.messageId(), reason, now); - return dev.caskeleton.messaging.reliability.OutboxTransitionResult.APPLIED; + throw new UnsupportedOperationException(); } @Override public dev.caskeleton.messaging.reliability.OutboxTransitionResult markPublished( dev.caskeleton.messaging.reliability.OutboxLease lease, Instant now) { - markPublished(lease.messageId(), now); - return dev.caskeleton.messaging.reliability.OutboxTransitionResult.APPLIED; + throw new UnsupportedOperationException(); } @Override public dev.caskeleton.messaging.reliability.OutboxTransitionResult markAmbiguous( dev.caskeleton.messaging.reliability.OutboxLease lease, String failureCode, Instant now) { - markAmbiguous(lease.messageId(), failureCode, now); - return dev.caskeleton.messaging.reliability.OutboxTransitionResult.APPLIED; + throw new UnsupportedOperationException(); } @Override public dev.caskeleton.messaging.reliability.OutboxTransitionResult markFailed( dev.caskeleton.messaging.reliability.OutboxLease lease, String failureCode, Instant now) { - markFailed(lease.messageId(), failureCode, now); - return dev.caskeleton.messaging.reliability.OutboxTransitionResult.APPLIED; + throw new UnsupportedOperationException(); } @Override public dev.caskeleton.messaging.reliability.OutboxTransitionResult releaseLease( dev.caskeleton.messaging.reliability.OutboxLease lease) { - releaseLease(lease.messageId()); - return dev.caskeleton.messaging.reliability.OutboxTransitionResult.APPLIED; - } - - @Override - public void markPublished(MessageId messageId, Instant now) { - throw new UnsupportedOperationException(); - } - - @Override - public void markAmbiguous(MessageId messageId, String failureCode, Instant now) { - throw new UnsupportedOperationException(); - } - - @Override - public void markFailed(MessageId messageId, String failureCode, Instant now) { - throw new UnsupportedOperationException(); - } - - @Override - public void releaseLease(MessageId messageId) { throw new UnsupportedOperationException(); } diff --git a/src/messaging/messaging-outbox-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/outbox/OutboxRelayTest.java b/src/messaging/messaging-outbox-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/outbox/OutboxRelayTest.java index 62bc74f5..471ba56f 100644 --- a/src/messaging/messaging-outbox-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/outbox/OutboxRelayTest.java +++ b/src/messaging/messaging-outbox-jdbc-postgresql/src/test/java/dev/caskeleton/messaging/outbox/OutboxRelayTest.java @@ -305,7 +305,7 @@ final class InMemoryOutboxRepository implements OutboxRepository { boolean waiting = nextAttempt != null && now.isBefore(nextAttempt); if (waiting || lease.record().attempts() >= maxAttempts) { // Put it back exactly as the SQL predicate would have left it: unclaimed. - releaseLease(lease.messageId()); + releaseLeaseUnfenced(lease.messageId()); continue; } claimed.add(lease); @@ -349,7 +349,7 @@ final class InMemoryOutboxRepository implements OutboxRepository { if (!owns(lease)) { return OutboxTransitionResult.STALE_LEASE; } - markAmbiguous(lease.messageId(), failureCode, now); + markAmbiguousUnfenced(lease.messageId(), failureCode); owners.remove(lease.messageId()); return OutboxTransitionResult.APPLIED; } @@ -359,7 +359,7 @@ final class InMemoryOutboxRepository implements OutboxRepository { if (!owns(lease)) { return OutboxTransitionResult.STALE_LEASE; } - markFailed(lease.messageId(), failureCode, now); + markFailedUnfenced(lease.messageId(), failureCode); owners.remove(lease.messageId()); return OutboxTransitionResult.APPLIED; } @@ -369,29 +369,21 @@ final class InMemoryOutboxRepository implements OutboxRepository { if (!owns(lease)) { return OutboxTransitionResult.STALE_LEASE; } - releaseLease(lease.messageId()); + releaseLeaseUnfenced(lease.messageId()); owners.remove(lease.messageId()); return OutboxTransitionResult.APPLIED; } - @Override - public void markPublished(MessageId messageId, Instant now) { - transition(messageId, OutboxStatus.PUBLISHED, Optional.empty()); - } - - @Override - public void markAmbiguous(MessageId messageId, String failureCode, Instant now) { + private void markAmbiguousUnfenced(MessageId messageId, String failureCode) { transition(messageId, OutboxStatus.AMBIGUOUS, Optional.of(failureCode)); leases.remove(messageId); } - @Override - public void markFailed(MessageId messageId, String failureCode, Instant now) { + private void markFailedUnfenced(MessageId messageId, String failureCode) { transition(messageId, OutboxStatus.FAILED, Optional.of(failureCode)); } - @Override - public void releaseLease(MessageId messageId) { + private void releaseLeaseUnfenced(MessageId messageId) { leases.remove(messageId); } diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DestinationProfileValidator.java b/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DestinationProfileValidator.java index bcd47281..4757611c 100644 --- a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DestinationProfileValidator.java +++ b/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/DestinationProfileValidator.java @@ -71,6 +71,13 @@ public final class DestinationProfileValidator { throw new IllegalArgumentException( "at-least-once delivery requires a publish confirmation for " + profile.name().value()); } + if (profile.deliveryGuarantee() == DeliveryGuarantee.AT_LEAST_ONCE + && !profile.deadLetter().enabled()) { + throw new IllegalArgumentException( + "at-least-once delivery requires a dead letter destination so a failed delivery has " + + "an executable terminal path: " + + profile.name().value()); + } if (profile.production() && profile.topologyAutoCreate()) { throw new IllegalArgumentException( "a production profile must not auto-create topology: " + profile.name().value()); diff --git a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/MessagingAdmissionController.java b/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/MessagingAdmissionController.java index 108e743c..4b2cc984 100644 --- a/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/MessagingAdmissionController.java +++ b/src/messaging/messaging-policy/src/main/java/dev/caskeleton/messaging/policy/MessagingAdmissionController.java @@ -169,16 +169,20 @@ public final class MessagingAdmissionController { } private boolean reserve(String destination) { - AtomicInteger counter = perDestination.computeIfAbsent(destination, key -> new AtomicInteger()); - while (true) { - int current = counter.get(); - if (current >= perDestinationLimit) { - return false; - } - if (counter.compareAndSet(current, current + 1)) { - return true; - } - } + java.util.concurrent.atomic.AtomicBoolean reserved = + new java.util.concurrent.atomic.AtomicBoolean(); + perDestination.compute( + destination, + (key, existing) -> { + AtomicInteger counter = existing == null ? new AtomicInteger() : existing; + if (counter.get() >= perDestinationLimit) { + return counter; + } + counter.incrementAndGet(); + reserved.set(true); + return counter; + }); + return reserved.get(); } /** @@ -187,14 +191,18 @@ public final class MessagingAdmissionController { * @return true when this call actually released a slot the destination was holding */ private boolean release(String destination) { - AtomicInteger counter = perDestination.get(destination); - if (counter == null) { - return false; - } - int before = counter.getAndUpdate(current -> current > 0 ? current - 1 : current); - // Drop the entry at zero, atomically, so the map does not accumulate one counter per - // destination ever published to for the life of the process. - perDestination.computeIfPresent(destination, (key, value) -> value.get() == 0 ? null : value); - return before > 0; + java.util.concurrent.atomic.AtomicBoolean released = + new java.util.concurrent.atomic.AtomicBoolean(); + perDestination.computeIfPresent( + destination, + (key, counter) -> { + if (counter.get() <= 0) { + return null; + } + int remaining = counter.decrementAndGet(); + released.set(true); + return remaining == 0 ? null : counter; + }); + return released.get(); } } diff --git a/src/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/DestinationProfileValidatorTest.java b/src/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/DestinationProfileValidatorTest.java index 5bc613bd..f2c16a98 100644 --- a/src/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/DestinationProfileValidatorTest.java +++ b/src/messaging/messaging-policy/src/test/java/dev/caskeleton/messaging/policy/DestinationProfileValidatorTest.java @@ -88,6 +88,15 @@ class DestinationProfileValidatorTest { .hasMessageContaining("confirmation"); } + @Test + void atLeastOnceRequiresADeadLetterDestinationEvenWhenRetriesAreDisabled() { + DestinationProfile profile = DestinationProfileFixtures.atLeastOnceWithoutDeadLetter(); + + assertThatThrownBy(() -> validator.validate(profile)) + .isInstanceOf(IllegalArgumentException.class) + .hasMessageContaining("dead letter destination"); + } + @Test void aProductionProfileCannotAutoCreateTopology() { DestinationProfile profile = DestinationProfileFixtures.productionWithAutoCreate(); @@ -103,7 +112,7 @@ class DestinationProfileValidatorTest { assertThatThrownBy(() -> validator.validate(profile)) .isInstanceOf(IllegalArgumentException.class) - .hasMessageContaining("park"); + .hasMessageContaining("dead letter destination"); } @Test @@ -177,7 +186,7 @@ final class DestinationProfileFixtures { ProducerPolicy.defaults(), ConsumerPolicy.defaults("order-projection"), RetryPolicy.none(), - DeadLetterPolicy.disabled(), + DeadLetterPolicy.to(new DestinationName("order-events-dlq")), PayloadPolicy.defaults(), CapabilityTier.M1, false, @@ -392,6 +401,28 @@ final class DestinationProfileFixtures { base.topologyAutoCreate()); } + static DestinationProfile atLeastOnceWithoutDeadLetter() { + DestinationProfile base = base(); + return new DestinationProfile( + base.name(), + base.broker(), + base.kind(), + base.physical(), + base.schema(), + DeliveryGuarantee.AT_LEAST_ONCE, + base.orderingScope(), + base.externalSideEffectGuarantee(), + base.producer(), + base.consumer(), + RetryPolicy.none(), + DeadLetterPolicy.disabled(), + base.payload(), + base.tier(), + base.production(), + base.keyResolverConfigured(), + base.topologyAutoCreate()); + } + static DestinationProfile atMostOnceWithoutDeadLetter() { DestinationProfile base = base(); return new DestinationProfile( @@ -414,6 +445,28 @@ final class DestinationProfileFixtures { base.topologyAutoCreate()); } + static DestinationProfile parking(String name) { + DestinationProfile base = atMostOnceWithoutDeadLetter(); + return new DestinationProfile( + new DestinationName(name), + base.broker(), + base.kind(), + base.physical(), + base.schema(), + base.deliveryGuarantee(), + base.orderingScope(), + base.externalSideEffectGuarantee(), + base.producer(), + base.consumer(), + base.retry(), + base.deadLetter(), + base.payload(), + base.tier(), + base.production(), + base.keyResolverConfigured(), + base.topologyAutoCreate()); + } + static RetryPolicy retryTo(String destination) { return new RetryPolicy( RetryMode.RETRY_DESTINATION, @@ -432,8 +485,8 @@ final class DestinationProfileFixtures { return List.of( named("alpha", retryTo("beta"), DeadLetterPolicy.to(new DestinationName("alpha-dlq"))), named("beta", retryTo("alpha"), DeadLetterPolicy.to(new DestinationName("beta-dlq"))), - named("alpha-dlq", RetryPolicy.none(), DeadLetterPolicy.disabled()), - named("beta-dlq", RetryPolicy.none(), DeadLetterPolicy.disabled())); + parking("alpha-dlq"), + parking("beta-dlq")); } /** @@ -449,7 +502,7 @@ final class DestinationProfileFixtures { return List.of( named("alpha", retryTo("beta"), DeadLetterPolicy.to(new DestinationName("alpha-dlq"))), named("beta", RetryPolicy.none(), DeadLetterPolicy.to(new DestinationName("alpha"))), - named("alpha-dlq", RetryPolicy.none(), DeadLetterPolicy.disabled())); + parking("alpha-dlq")); } /** Two destinations dead-lettering into the same place: a diamond, not a cycle. */ @@ -457,12 +510,12 @@ final class DestinationProfileFixtures { return List.of( named("alpha", RetryPolicy.none(), DeadLetterPolicy.to(new DestinationName("shared-dlq"))), named("beta", RetryPolicy.none(), DeadLetterPolicy.to(new DestinationName("shared-dlq"))), - named("shared-dlq", RetryPolicy.none(), DeadLetterPolicy.disabled())); + parking("shared-dlq")); } static List danglingRetryDestination() { return List.of( named("alpha", retryTo("missing"), DeadLetterPolicy.to(new DestinationName("alpha-dlq"))), - named("alpha-dlq", RetryPolicy.none(), DeadLetterPolicy.disabled())); + parking("alpha-dlq")); } } diff --git a/src/messaging/messaging-pulsar-experimental/build.gradle b/src/messaging/messaging-pulsar-experimental/build.gradle index c98d34a5..929bf94c 100644 --- a/src/messaging/messaging-pulsar-experimental/build.gradle +++ b/src/messaging/messaging-pulsar-experimental/build.gradle @@ -11,5 +11,4 @@ dependencies { api project(':messaging:messaging-security') api project(':messaging:messaging-admin-api') - implementation libs.pulsar.client } diff --git a/src/messaging/messaging-pulsar-experimental/gradle.lockfile b/src/messaging/messaging-pulsar-experimental/gradle.lockfile index 86f863d6..f5ad1bb5 100644 --- a/src/messaging/messaging-pulsar-experimental/gradle.lockfile +++ b/src/messaging/messaging-pulsar-experimental/gradle.lockfile @@ -1,7 +1,6 @@ # This is a Gradle generated file for dependency locking. # Manual edits can break the build and are not advised. # This file is expected to be part of source control. -com.fasterxml.jackson.core:jackson-annotations:2.21=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,testAnnotationProcessor com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,testAnnotationProcessor com.github.spotbugs:spotbugs-annotations:4.10.2=spotbugs @@ -36,12 +35,7 @@ io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,testAnnotatio io.micrometer:micrometer-commons:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath io.micrometer:micrometer-core:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath io.micrometer:micrometer-observation:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.opentelemetry:opentelemetry-api-incubator:1.45.0-alpha=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.opentelemetry:opentelemetry-api:1.55.0=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.opentelemetry:opentelemetry-common:1.55.0=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.opentelemetry:opentelemetry-context:1.55.0=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath javax.inject:javax.inject:1=annotationProcessor,testAnnotationProcessor -javax.validation:validation-api:1.1.0.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath jaxen:jaxen:2.0.6=spotbugs net.bytebuddy:byte-buddy:1.17.8=testCompileClasspath,testRuntimeClasspath net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs @@ -58,17 +52,9 @@ org.apache.maven.doxia:doxia-core:1.12.0=checkstyle org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle -org.apache.pulsar:bouncy-castle-bc:4.1.3=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.apache.pulsar:pulsar-client-admin-api:4.1.3=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.apache.pulsar:pulsar-client-api:4.1.3=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.apache.pulsar:pulsar-client:4.0.3=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.apache.xbean:xbean-reflect:3.7=checkstyle org.apiguardian:apiguardian-api:1.1.2=testCompileClasspath org.assertj:assertj-core:3.27.7=testCompileClasspath,testRuntimeClasspath -org.bouncycastle:bcpkix-jdk18on:1.81=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.bouncycastle:bcprov-ext-jdk18on:1.78.1=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.bouncycastle:bcprov-jdk18on:1.81.1=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.bouncycastle:bcutil-jdk18on:1.81.1=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle org.codehaus.plexus:plexus-component-annotations:2.1.0=checkstyle org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle @@ -96,7 +82,7 @@ org.ow2.asm:asm-util:9.10.1=spotbugs org.ow2.asm:asm:9.10.1=spotbugs org.pcollections:pcollections:4.0.1=annotationProcessor,testAnnotationProcessor org.reflections:reflections:0.10.2=checkstyle -org.slf4j:slf4j-api:2.0.18=compileClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testRuntimeClasspath +org.slf4j:slf4j-api:2.0.18=spotbugs,spotbugsSlf4j org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j org.slf4j:slf4j-simple:2.0.18=checkstyle org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs diff --git a/src/messaging/messaging-rabbit/build.gradle b/src/messaging/messaging-rabbit/build.gradle index b45f5fbd..f3469968 100644 --- a/src/messaging/messaging-rabbit/build.gradle +++ b/src/messaging/messaging-rabbit/build.gradle @@ -1,7 +1,15 @@ plugins { + id 'java-test-fixtures' + id 'ca.auxiliary-source-set' id 'ca.jmh-benchmarks' } +auxiliarySourceSets { + sourceSet('integrationTest') { + compilesAgainst 'main', 'testFixtures' + } +} + dependencies { api project(':messaging:messaging-core-api') api project(':messaging:messaging-schema-api') @@ -22,6 +30,14 @@ dependencies { // Live-broker certification. The confirm-and-return ordering the adapter depends on is a // property of AMQP, and only a real broker exhibits it. - testImplementation 'org.testcontainers:testcontainers-rabbitmq' - testImplementation 'org.testcontainers:testcontainers-junit-jupiter' + integrationTestImplementation 'org.testcontainers:testcontainers-rabbitmq' + integrationTestImplementation 'org.testcontainers:testcontainers-junit-jupiter' +} + +strictTestLanes { + lane('integrationTest') { + integration() + sourceSet = 'integrationTest' + description = 'Runs RabbitMQ broker integration contracts against a real container.' + } } diff --git a/src/messaging/messaging-rabbit/gradle.lockfile b/src/messaging/messaging-rabbit/gradle.lockfile index 703374a1..e5000c29 100644 --- a/src/messaging/messaging-rabbit/gradle.lockfile +++ b/src/messaging/messaging-rabbit/gradle.lockfile @@ -1,69 +1,69 @@ # This is a Gradle generated file for dependency locking. # Manual edits can break the build and are not advised. # This file is expected to be part of source control. -com.fasterxml.jackson.core:jackson-annotations:2.21=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor -com.github.docker-java:docker-java-api:3.7.1=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.github.docker-java:docker-java-transport-zerodep:3.7.1=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.github.docker-java:docker-java-transport:3.7.1=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor +com.fasterxml.jackson.core:jackson-annotations:2.21=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.github.docker-java:docker-java-api:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.docker-java:docker-java-transport-zerodep:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.docker-java:docker-java-transport:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor com.github.spotbugs:spotbugs-annotations:4.10.2=spotbugs com.github.spotbugs:spotbugs:4.10.2=spotbugs com.github.stephenc.jcip:jcip-annotations:1.0-1=spotbugs -com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor -com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor -com.google.auto:auto-common:1.2.2=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor +com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.auto:auto-common:1.2.2=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor com.google.code.findbugs:jsr305:3.0.2=checkstyle,spotbugs com.google.code.gson:gson:2.13.2=spotbugs -com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor com.google.errorprone:error_prone_annotations:2.41.0=spotbugs com.google.errorprone:error_prone_annotations:2.47.0=checkstyle -com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor -com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor -com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,jmhAnnotationProcessor,testAnnotationProcessor -com.google.guava:guava:33.5.0-jre=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.guava:guava:33.5.0-jre=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor com.google.guava:guava:33.6.0-jre=checkstyle -com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,jmhAnnotationProcessor,testAnnotationProcessor -com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,jmhAnnotationProcessor,testAnnotationProcessor -com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor +com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins com.puppycrawl.tools:checkstyle:13.5.0=checkstyle -com.rabbitmq:amqp-client:5.27.1=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +com.rabbitmq:amqp-client:5.27.1=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath commons-beanutils:commons-beanutils:1.11.0=checkstyle -commons-codec:commons-codec:1.19.0=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +commons-codec:commons-codec:1.19.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath commons-collections:commons-collections:3.2.2=checkstyle -commons-io:commons-io:2.20.0=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +commons-io:commons-io:2.20.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath commons-io:commons-io:2.21.0=spotbugs -commons-logging:commons-logging:1.3.6=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +commons-logging:commons-logging:1.3.6=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath info.picocli:picocli:4.7.7=checkstyle -io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor -io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor -io.micrometer:micrometer-commons:1.16.7=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.micrometer:micrometer-core:1.16.7=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.micrometer:micrometer-observation:1.16.7=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-buffer:4.2.17.Final=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-codec-base:4.2.17.Final=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-codec-compression:4.2.17.Final=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-codec-marshalling:4.2.17.Final=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-codec-protobuf:4.2.17.Final=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-codec:4.2.17.Final=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-common:4.2.17.Final=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-handler:4.2.17.Final=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-resolver:4.2.17.Final=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-transport-native-unix-common:4.2.17.Final=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-transport:4.2.17.Final=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -javax.inject:javax.inject:1=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor +io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor +io.micrometer:micrometer-commons:1.16.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +io.micrometer:micrometer-core:1.16.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +io.micrometer:micrometer-observation:1.16.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +io.netty:netty-buffer:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +io.netty:netty-codec-base:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +io.netty:netty-codec-compression:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +io.netty:netty-codec-marshalling:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +io.netty:netty-codec-protobuf:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +io.netty:netty-codec:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +io.netty:netty-common:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +io.netty:netty-handler:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +io.netty:netty-resolver:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +io.netty:netty-transport-native-unix-common:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +io.netty:netty-transport:4.2.17.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +javax.inject:javax.inject:1=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor jaxen:jaxen:2.0.6=spotbugs -net.bytebuddy:byte-buddy:1.17.8=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.java.dev.jna:jna:5.18.1=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +net.bytebuddy:byte-buddy:1.17.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +net.java.dev.jna:jna:5.18.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath net.sf.jopt-simple:jopt-simple:5.0.4=jmhAnnotationProcessor,jmhCompileClasspath,jmhRuntimeClasspath net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs org.antlr:antlr4-runtime:4.13.2=checkstyle org.apache.bcel:bcel:6.12.0=spotbugs -org.apache.commons:commons-compress:1.28.0=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.apache.commons:commons-lang3:3.20.0=checkstyle,jmhCompileClasspath,jmhRuntimeClasspath,spotbugs,testCompileClasspath,testRuntimeClasspath +org.apache.commons:commons-compress:1.28.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.apache.commons:commons-lang3:3.20.0=checkstyle,integrationTestCompileClasspath,integrationTestRuntimeClasspath,spotbugs org.apache.commons:commons-math3:3.6.1=jmhAnnotationProcessor,jmhCompileClasspath,jmhRuntimeClasspath org.apache.commons:commons-text:1.15.0=spotbugs org.apache.commons:commons-text:1.3=checkstyle @@ -76,53 +76,53 @@ org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle org.apache.xbean:xbean-reflect:3.7=checkstyle -org.apiguardian:apiguardian-api:1.1.2=jmhCompileClasspath,testCompileClasspath -org.assertj:assertj-core:3.27.7=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.apiguardian:apiguardian-api:1.1.2=integrationTestCompileClasspath,jmhCompileClasspath,testCompileClasspath +org.assertj:assertj-core:3.27.7=integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle org.codehaus.plexus:plexus-component-annotations:2.1.0=checkstyle org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle org.codehaus.plexus:plexus-utils:3.3.0=checkstyle org.dom4j:dom4j:2.2.0=spotbugs -org.hdrhistogram:HdrHistogram:2.2.2=jmhRuntimeClasspath,runtimeClasspath,testRuntimeClasspath +org.hdrhistogram:HdrHistogram:2.2.2=integrationTestRuntimeClasspath,jmhRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath org.javassist:javassist:3.28.0-GA=checkstyle -org.jetbrains:annotations:17.0.0=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,jmhAnnotationProcessor,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-api:6.0.3=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-engine:6.0.3=jmhRuntimeClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-params:6.0.3=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter:6.0.3=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-commons:6.0.3=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-engine:6.0.3=jmhRuntimeClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-launcher:6.0.3=jmhRuntimeClasspath,testRuntimeClasspath -org.junit:junit-bom:6.0.3=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.jetbrains:annotations:17.0.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,integrationTestAnnotationProcessor,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhAnnotationProcessor,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testFixturesAnnotationProcessor,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-api:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-engine:6.0.3=integrationTestRuntimeClasspath,jmhRuntimeClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-params:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-commons:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-engine:6.0.3=integrationTestRuntimeClasspath,jmhRuntimeClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-launcher:6.0.3=integrationTestRuntimeClasspath,jmhRuntimeClasspath,testRuntimeClasspath +org.junit:junit-bom:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.junit:junit-bom:6.1.0=spotbugs -org.latencyutils:LatencyUtils:2.0.3=jmhRuntimeClasspath,runtimeClasspath,testRuntimeClasspath +org.latencyutils:LatencyUtils:2.0.3=integrationTestRuntimeClasspath,jmhRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath org.mockito:mockito-core:5.20.0=mockitoAgent org.openjdk.jmh:jmh-core:1.37=jmhAnnotationProcessor,jmhCompileClasspath,jmhRuntimeClasspath org.openjdk.jmh:jmh-generator-annprocess:1.37=jmhAnnotationProcessor -org.opentest4j:opentest4j:1.3.0=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.opentest4j:opentest4j:1.3.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.ow2.asm:asm-analysis:9.10.1=spotbugs org.ow2.asm:asm-commons:9.10.1=spotbugs org.ow2.asm:asm-tree:9.10.1=spotbugs org.ow2.asm:asm-util:9.10.1=spotbugs org.ow2.asm:asm:9.10.1=spotbugs -org.pcollections:pcollections:4.0.1=annotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor +org.pcollections:pcollections:4.0.1=annotationProcessor,integrationTestAnnotationProcessor,jmhAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor org.reflections:reflections:0.10.2=checkstyle -org.rnorth.duct-tape:duct-tape:1.0.8=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.slf4j:slf4j-api:2.0.18=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testRuntimeClasspath +org.rnorth.duct-tape:duct-tape:1.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.slf4j:slf4j-api:2.0.18=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j org.slf4j:slf4j-simple:2.0.18=checkstyle -org.springframework.amqp:spring-amqp:4.0.5=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.amqp:spring-rabbit:4.0.5=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-aop:7.0.9=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-beans:7.0.9=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-context:7.0.9=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-core:7.0.9=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-expression:7.0.9=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-messaging:7.0.9=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-tx:7.0.9=compileClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers-junit-jupiter:2.0.5=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers-rabbitmq:2.0.5=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers:2.0.5=jmhCompileClasspath,jmhRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.amqp:spring-amqp:4.0.5=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.springframework.amqp:spring-rabbit:4.0.5=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.springframework:spring-aop:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.springframework:spring-beans:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.springframework:spring-context:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.springframework:spring-core:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.springframework:spring-expression:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.springframework:spring-messaging:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.springframework:spring-tx:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,jmhCompileClasspath,jmhRuntimeClasspath,runtimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath +org.testcontainers:testcontainers-junit-jupiter:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.testcontainers:testcontainers-rabbitmq:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.testcontainers:testcontainers:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs empty= diff --git a/src/messaging/messaging-rabbit/src/test/java/dev/caskeleton/messaging/rabbit/RabbitBrokerIT.java b/src/messaging/messaging-rabbit/src/integrationTest/java/dev/caskeleton/messaging/rabbit/RabbitBrokerIT.java similarity index 100% rename from src/messaging/messaging-rabbit/src/test/java/dev/caskeleton/messaging/rabbit/RabbitBrokerIT.java rename to src/messaging/messaging-rabbit/src/integrationTest/java/dev/caskeleton/messaging/rabbit/RabbitBrokerIT.java diff --git a/src/messaging/messaging-rabbit/src/test/java/dev/caskeleton/messaging/rabbit/RabbitFixtureProfiles.java b/src/messaging/messaging-rabbit/src/integrationTest/java/dev/caskeleton/messaging/rabbit/RabbitFixtureProfiles.java similarity index 100% rename from src/messaging/messaging-rabbit/src/test/java/dev/caskeleton/messaging/rabbit/RabbitFixtureProfiles.java rename to src/messaging/messaging-rabbit/src/integrationTest/java/dev/caskeleton/messaging/rabbit/RabbitFixtureProfiles.java diff --git a/src/messaging/messaging-rabbit/src/main/java/dev/caskeleton/messaging/rabbit/RabbitMessagingTransport.java b/src/messaging/messaging-rabbit/src/main/java/dev/caskeleton/messaging/rabbit/RabbitMessagingTransport.java index 89fe4889..b6d58627 100644 --- a/src/messaging/messaging-rabbit/src/main/java/dev/caskeleton/messaging/rabbit/RabbitMessagingTransport.java +++ b/src/messaging/messaging-rabbit/src/main/java/dev/caskeleton/messaging/rabbit/RabbitMessagingTransport.java @@ -20,6 +20,9 @@ import java.util.Objects; import java.util.Optional; import java.util.concurrent.CompletableFuture; import java.util.concurrent.CompletionStage; +import java.util.concurrent.Executors; +import java.util.concurrent.ScheduledExecutorService; +import java.util.concurrent.TimeUnit; import java.util.concurrent.atomic.AtomicBoolean; import java.util.function.Function; @@ -48,6 +51,8 @@ public final class RabbitMessagingTransport implements MessagingTransport { private final RabbitPublishMapper mapper; private final RabbitConfirmCoordinator coordinator; private final Function consumerFactory; + private final Duration confirmTimeout; + private final ScheduledExecutorService confirmTimeouts; private final AtomicBoolean closed = new AtomicBoolean(); /** @@ -59,6 +64,12 @@ public final class RabbitMessagingTransport implements MessagingTransport { */ public RabbitMessagingTransport( String brokerName, long generation, RabbitChannelPublisher channel) { + this(brokerName, generation, channel, Duration.ofSeconds(5)); + } + + /** Creates a publish-only transport with an explicit confirm timeout. */ + public RabbitMessagingTransport( + String brokerName, long generation, RabbitChannelPublisher channel, Duration confirmTimeout) { this( brokerName, generation, @@ -67,7 +78,8 @@ public final class RabbitMessagingTransport implements MessagingTransport { throw new MessagingCapabilityUnavailableException( "RABBIT_CONSUMER_NOT_CONFIGURED", "this Rabbit transport was created without a consumer factory"); - }); + }, + confirmTimeout); } /** @@ -83,12 +95,33 @@ public final class RabbitMessagingTransport implements MessagingTransport { long generation, RabbitChannelPublisher channel, Function consumerFactory) { + this(brokerName, generation, channel, consumerFactory, Duration.ofSeconds(5)); + } + + /** Creates a transport with explicit consumer factory and confirm deadline. */ + public RabbitMessagingTransport( + String brokerName, + long generation, + RabbitChannelPublisher channel, + Function consumerFactory, + Duration confirmTimeout) { this.brokerName = Objects.requireNonNull(brokerName, "brokerName must not be null"); this.generation = generation; this.channel = Objects.requireNonNull(channel, "channel must not be null"); this.consumerFactory = Objects.requireNonNull(consumerFactory, "consumerFactory is required"); + this.confirmTimeout = Objects.requireNonNull(confirmTimeout, "confirmTimeout must not be null"); + if (confirmTimeout.isNegative() || confirmTimeout.isZero()) { + throw new IllegalArgumentException("confirmTimeout must be positive"); + } this.mapper = new RabbitPublishMapper(); this.coordinator = new RabbitConfirmCoordinator(); + this.confirmTimeouts = + Executors.newSingleThreadScheduledExecutor( + runnable -> { + Thread thread = new Thread(runnable, "messaging-rabbit-confirm-timeouts"); + thread.setDaemon(true); + return thread; + }); } @Override @@ -117,6 +150,12 @@ public final class RabbitMessagingTransport implements MessagingTransport { coordinator .awaiting(sequence, exchange, routingKey, request.profile().producer().confirmation()) .thenApply(TransportPublishResult::new); + var timeout = + confirmTimeouts.schedule( + () -> coordinator.timedOut(sequence, confirmTimeout), + confirmTimeout.toNanos(), + TimeUnit.NANOSECONDS); + pending.whenComplete((result, failure) -> timeout.cancel(false)); try { channel.publish(sequence, exchange, routingKey, mapper.toMessage(request), true); @@ -216,6 +255,7 @@ public final class RabbitMessagingTransport implements MessagingTransport { // Drain what is still waiting. Leaving the stages pending hangs every caller holding one, and // a closed channel will never deliver their confirms. coordinator.channelClosed(Duration.ZERO); + confirmTimeouts.shutdownNow(); channel.close(); } diff --git a/src/messaging/messaging-rabbit/src/main/java/dev/caskeleton/messaging/rabbit/RabbitPublishFailureClassifier.java b/src/messaging/messaging-rabbit/src/main/java/dev/caskeleton/messaging/rabbit/RabbitPublishFailureClassifier.java index 4fb3cea6..c9408b98 100644 --- a/src/messaging/messaging-rabbit/src/main/java/dev/caskeleton/messaging/rabbit/RabbitPublishFailureClassifier.java +++ b/src/messaging/messaging-rabbit/src/main/java/dev/caskeleton/messaging/rabbit/RabbitPublishFailureClassifier.java @@ -91,19 +91,35 @@ public final class RabbitPublishFailureClassifier { } private static FailureCategory categoryOf(Throwable cause) { + if (cause instanceof com.rabbitmq.client.PossibleAuthenticationFailureException) { + return FailureCategory.AUTHENTICATION; + } + if (cause instanceof com.rabbitmq.client.ShutdownSignalException shutdown) { + int replyCode = replyCode(shutdown.getReason()); + if (replyCode == 403) { + return FailureCategory.AUTHORIZATION; + } + if (replyCode >= 500) { + return FailureCategory.TRANSIENT_INFRASTRUCTURE; + } + return FailureCategory.PERMANENT_BUSINESS; + } if (cause instanceof IOException) { return FailureCategory.TRANSIENT_INFRASTRUCTURE; } - String name = name(cause); - if (name.contains("Authentication")) { - return FailureCategory.AUTHENTICATION; - } - if (name.contains("Authorization") || name.contains("AccessRefused")) { - return FailureCategory.AUTHORIZATION; - } return FailureCategory.PERMANENT_BUSINESS; } + private static int replyCode(com.rabbitmq.client.Method reason) { + if (reason instanceof com.rabbitmq.client.AMQP.Channel.Close close) { + return close.getReplyCode(); + } + if (reason instanceof com.rabbitmq.client.AMQP.Connection.Close close) { + return close.getReplyCode(); + } + return -1; + } + private static Throwable unwrap(Throwable error) { if (error instanceof java.util.concurrent.CompletionException && error.getCause() != null) { return error.getCause(); diff --git a/src/messaging/messaging-rabbit/src/test/java/dev/caskeleton/messaging/rabbit/RabbitProfileValidatorTest.java b/src/messaging/messaging-rabbit/src/test/java/dev/caskeleton/messaging/rabbit/RabbitProfileValidatorTest.java index 54193982..ba0f14f5 100644 --- a/src/messaging/messaging-rabbit/src/test/java/dev/caskeleton/messaging/rabbit/RabbitProfileValidatorTest.java +++ b/src/messaging/messaging-rabbit/src/test/java/dev/caskeleton/messaging/rabbit/RabbitProfileValidatorTest.java @@ -3,26 +3,6 @@ package dev.caskeleton.messaging.rabbit; import static org.assertj.core.api.Assertions.assertThatCode; import static org.assertj.core.api.Assertions.assertThatThrownBy; -import dev.caskeleton.messaging.api.ContentType; -import dev.caskeleton.messaging.api.MessageType; -import dev.caskeleton.messaging.api.delivery.DeliveryGuarantee; -import dev.caskeleton.messaging.api.delivery.ExternalSideEffectGuarantee; -import dev.caskeleton.messaging.api.delivery.OrderingScope; -import dev.caskeleton.messaging.api.destination.DestinationKind; -import dev.caskeleton.messaging.api.destination.DestinationName; -import dev.caskeleton.messaging.policy.CapabilityTier; -import dev.caskeleton.messaging.policy.ConsumerPolicy; -import dev.caskeleton.messaging.policy.DeadLetterPolicy; -import dev.caskeleton.messaging.policy.DestinationProfile; -import dev.caskeleton.messaging.policy.PayloadPolicy; -import dev.caskeleton.messaging.policy.PhysicalDestination; -import dev.caskeleton.messaging.policy.ProducerPolicy; -import dev.caskeleton.messaging.policy.RetryPolicy; -import dev.caskeleton.messaging.policy.SchemaPolicy; -import dev.caskeleton.messaging.schema.SchemaCompatibility; -import java.time.Duration; -import java.util.List; -import java.util.Set; import org.junit.jupiter.api.Test; class RabbitProfileValidatorTest { @@ -86,99 +66,3 @@ class RabbitProfileValidatorTest { .doesNotThrowAnyException(); } } - -/** Builds RabbitMQ profiles for validator tests. */ -final class RabbitProfileFixtures { - - private RabbitProfileFixtures() {} - - static RabbitBrokerProfile stable() { - return new RabbitBrokerProfile( - "rabbit-primary", - true, - false, - List.of("localhost:5672"), - true, - true, - true, - Duration.ofSeconds(5), - false, - 16, - true, - true, - true); - } - - static RabbitBrokerProfile withoutConfirms() { - return copy(stable(), false, true, true, false, true, false, true); - } - - static RabbitBrokerProfile withoutReturns() { - return copy(stable(), true, false, true, false, true, false, true); - } - - static RabbitBrokerProfile withoutMandatory() { - return copy(stable(), true, true, false, false, true, false, true); - } - - static RabbitBrokerProfile withAutoAck() { - return copy(stable(), true, true, true, true, true, false, true); - } - - static RabbitBrokerProfile withoutQuorumQueues() { - return copy(stable(), true, true, true, false, false, false, true); - } - - static RabbitBrokerProfile productionWithoutTls() { - return copy(stable(), true, true, true, false, true, true, false); - } - - private static RabbitBrokerProfile copy( - RabbitBrokerProfile base, - boolean confirms, - boolean returns, - boolean mandatory, - boolean autoAck, - boolean quorumQueues, - boolean production, - boolean tlsEnabled) { - return new RabbitBrokerProfile( - base.broker(), - base.stable(), - production, - base.addresses(), - confirms, - returns, - mandatory, - base.confirmTimeout(), - autoAck, - base.prefetch(), - quorumQueues, - tlsEnabled, - base.authenticationEnabled()); - } - - static DestinationProfile workQueueDestination() { - return new DestinationProfile( - new DestinationName("email-work"), - "rabbit-primary", - DestinationKind.WORK_QUEUE, - PhysicalDestination.rabbitQueue("notification.work", "email", "notification.email.q"), - new SchemaPolicy( - ContentType.JSON, - SchemaCompatibility.BACKWARD, - Set.of(new MessageType("email.requested"))), - DeliveryGuarantee.AT_LEAST_ONCE, - OrderingScope.NONE, - ExternalSideEffectGuarantee.IDEMPOTENCY_REQUIRED, - ProducerPolicy.defaults(), - ConsumerPolicy.defaults("notification"), - RetryPolicy.none(), - DeadLetterPolicy.to(new DestinationName("email-work-dlq")), - PayloadPolicy.defaults(), - CapabilityTier.M1, - false, - false, - false); - } -} diff --git a/src/messaging/messaging-rabbit/src/test/java/dev/caskeleton/messaging/rabbit/RabbitRuntimeTest.java b/src/messaging/messaging-rabbit/src/test/java/dev/caskeleton/messaging/rabbit/RabbitRuntimeTest.java index b45e35e6..903beaec 100644 --- a/src/messaging/messaging-rabbit/src/test/java/dev/caskeleton/messaging/rabbit/RabbitRuntimeTest.java +++ b/src/messaging/messaging-rabbit/src/test/java/dev/caskeleton/messaging/rabbit/RabbitRuntimeTest.java @@ -88,6 +88,38 @@ class RabbitRuntimeTest { assertThat(result.routingOutcome()).isEqualTo(RoutingOutcome.UNROUTABLE); } + @Test + void aMissingConfirmExpiresWithoutAnExternalTimeoutCallback() throws Exception { + try (RabbitMessagingTransport timed = + new RabbitMessagingTransport( + "rabbit-primary", + 1, + new RabbitChannelPublisher() { + @Override + public long nextPublishSequence() { + return sequence.incrementAndGet(); + } + + @Override + public void publish( + long sequenceNumber, + String exchange, + String routingKey, + Message message, + boolean mandatory) { + published.add(message); + } + }, + Duration.ofMillis(20))) { + CompletionStage stage = timed.publish(request()); + + var result = + stage.toCompletableFuture().get(1, java.util.concurrent.TimeUnit.SECONDS).result(); + assertThat(result.completion()).isEqualTo(PublishCompletion.AMBIGUOUS); + assertThat(timed.pendingConfirms()).isZero(); + } + } + @Test void aMissingConfirmIsAmbiguous() { RabbitMessagingTransport transport = transport(); diff --git a/src/messaging/messaging-rabbit/src/test/java/dev/caskeleton/messaging/rabbit/RabbitTopologyAndBatchTest.java b/src/messaging/messaging-rabbit/src/test/java/dev/caskeleton/messaging/rabbit/RabbitTopologyAndBatchTest.java index 040a8df3..678615cd 100644 --- a/src/messaging/messaging-rabbit/src/test/java/dev/caskeleton/messaging/rabbit/RabbitTopologyAndBatchTest.java +++ b/src/messaging/messaging-rabbit/src/test/java/dev/caskeleton/messaging/rabbit/RabbitTopologyAndBatchTest.java @@ -122,6 +122,39 @@ class RabbitTopologyAndBatchTest { .isEqualTo(TransmissionEvidence.MAY_HAVE_BEEN_TRANSMITTED); } + @Test + void authenticationFailureUsesTheTypedRabbitSignal() { + PublishResult result = + new RabbitPublishFailureClassifier() + .classify( + new com.rabbitmq.client.AuthenticationFailureException("bad credentials"), + false, + Duration.ofMillis(3)); + + assertThat(result.failure()).hasValueSatisfying( + failure -> assertThat(failure.category()).isEqualTo( + dev.caskeleton.messaging.api.error.FailureCategory.AUTHENTICATION)); + } + + @Test + void accessRefusedReplyCodeIsAuthorizationRatherThanBusinessRejection() { + com.rabbitmq.client.ShutdownSignalException accessRefused = + new com.rabbitmq.client.ShutdownSignalException( + false, + false, + new com.rabbitmq.client.impl.AMQImpl.Channel.Close( + 403, "ACCESS_REFUSED", 60, 40), + null); + + PublishResult result = + new RabbitPublishFailureClassifier() + .classify(accessRefused, false, Duration.ofMillis(3)); + + assertThat(result.failure()).hasValueSatisfying( + failure -> assertThat(failure.category()).isEqualTo( + dev.caskeleton.messaging.api.error.FailureCategory.AUTHORIZATION)); + } + @Test void aNackIsRejectedButStillCountsAsTransmitted() { PublishResult result = new RabbitPublishFailureClassifier().nacked(Duration.ofMillis(3)); diff --git a/src/messaging/messaging-rabbit/src/testFixtures/java/dev/caskeleton/messaging/rabbit/RabbitProfileFixtures.java b/src/messaging/messaging-rabbit/src/testFixtures/java/dev/caskeleton/messaging/rabbit/RabbitProfileFixtures.java new file mode 100644 index 00000000..e505cd24 --- /dev/null +++ b/src/messaging/messaging-rabbit/src/testFixtures/java/dev/caskeleton/messaging/rabbit/RabbitProfileFixtures.java @@ -0,0 +1,118 @@ +package dev.caskeleton.messaging.rabbit; + +import dev.caskeleton.messaging.api.ContentType; +import dev.caskeleton.messaging.api.MessageType; +import dev.caskeleton.messaging.api.delivery.DeliveryGuarantee; +import dev.caskeleton.messaging.api.delivery.ExternalSideEffectGuarantee; +import dev.caskeleton.messaging.api.delivery.OrderingScope; +import dev.caskeleton.messaging.api.destination.DestinationKind; +import dev.caskeleton.messaging.api.destination.DestinationName; +import dev.caskeleton.messaging.policy.CapabilityTier; +import dev.caskeleton.messaging.policy.ConsumerPolicy; +import dev.caskeleton.messaging.policy.DeadLetterPolicy; +import dev.caskeleton.messaging.policy.DestinationProfile; +import dev.caskeleton.messaging.policy.PayloadPolicy; +import dev.caskeleton.messaging.policy.PhysicalDestination; +import dev.caskeleton.messaging.policy.ProducerPolicy; +import dev.caskeleton.messaging.policy.RetryPolicy; +import dev.caskeleton.messaging.policy.SchemaPolicy; +import dev.caskeleton.messaging.schema.SchemaCompatibility; +import java.time.Duration; +import java.util.List; +import java.util.Set; + +/** Builds RabbitMQ profiles for validator tests. */ +final class RabbitProfileFixtures { + + private RabbitProfileFixtures() {} + + static RabbitBrokerProfile stable() { + return new RabbitBrokerProfile( + "rabbit-primary", + true, + false, + List.of("localhost:5672"), + true, + true, + true, + Duration.ofSeconds(5), + false, + 16, + true, + true, + true); + } + + static RabbitBrokerProfile withoutConfirms() { + return copy(stable(), false, true, true, false, true, false, true); + } + + static RabbitBrokerProfile withoutReturns() { + return copy(stable(), true, false, true, false, true, false, true); + } + + static RabbitBrokerProfile withoutMandatory() { + return copy(stable(), true, true, false, false, true, false, true); + } + + static RabbitBrokerProfile withAutoAck() { + return copy(stable(), true, true, true, true, true, false, true); + } + + static RabbitBrokerProfile withoutQuorumQueues() { + return copy(stable(), true, true, true, false, false, false, true); + } + + static RabbitBrokerProfile productionWithoutTls() { + return copy(stable(), true, true, true, false, true, true, false); + } + + private static RabbitBrokerProfile copy( + RabbitBrokerProfile base, + boolean confirms, + boolean returns, + boolean mandatory, + boolean autoAck, + boolean quorumQueues, + boolean production, + boolean tlsEnabled) { + return new RabbitBrokerProfile( + base.broker(), + base.stable(), + production, + base.addresses(), + confirms, + returns, + mandatory, + base.confirmTimeout(), + autoAck, + base.prefetch(), + quorumQueues, + tlsEnabled, + base.authenticationEnabled()); + } + + static DestinationProfile workQueueDestination() { + return new DestinationProfile( + new DestinationName("email-work"), + "rabbit-primary", + DestinationKind.WORK_QUEUE, + PhysicalDestination.rabbitQueue("notification.work", "email", "notification.email.q"), + new SchemaPolicy( + ContentType.JSON, + SchemaCompatibility.BACKWARD, + Set.of(new MessageType("email.requested"))), + DeliveryGuarantee.AT_LEAST_ONCE, + OrderingScope.NONE, + ExternalSideEffectGuarantee.IDEMPOTENCY_REQUIRED, + ProducerPolicy.defaults(), + ConsumerPolicy.defaults("notification"), + RetryPolicy.none(), + DeadLetterPolicy.to(new DestinationName("email-work-dlq")), + PayloadPolicy.defaults(), + CapabilityTier.M1, + false, + false, + false); + } +} diff --git a/src/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxRepository.java b/src/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxRepository.java index 39f00a7a..6552a3b1 100644 --- a/src/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxRepository.java +++ b/src/messaging/messaging-reliability-api/src/main/java/dev/caskeleton/messaging/reliability/OutboxRepository.java @@ -58,14 +58,6 @@ public interface OutboxRepository { List claimBatch( String owner, int batchSize, Duration leaseDuration, Instant now, int maxAttempts); - /** - * Marks a record as confirmed by the broker. - * - * @param messageId the record identity - * @param now the current instant - */ - void markPublished(MessageId messageId, Instant now); - /** * Records a confirmed publication, only if this lease still owns the row. * @@ -73,17 +65,6 @@ public interface OutboxRepository { */ OutboxTransitionResult markPublished(OutboxLease lease, Instant now); - /** - * Marks a record whose publish outcome is unknown. - * - *

      The record stays eligible for retry under the same identity. - * - * @param messageId the record identity - * @param failureCode the sanitized failure code - * @param now the current instant - */ - void markAmbiguous(MessageId messageId, String failureCode, Instant now); - /** Records an ambiguous outcome, only if this lease still owns the row. */ OutboxTransitionResult markAmbiguous(OutboxLease lease, String failureCode, Instant now); @@ -99,25 +80,9 @@ public interface OutboxRepository { */ OutboxTransitionResult markExhausted(OutboxLease lease, String reason, Instant now); - /** - * Marks a record the broker definitively rejected. - * - * @param messageId the record identity - * @param failureCode the sanitized failure code - * @param now the current instant - */ - void markFailed(MessageId messageId, String failureCode, Instant now); - /** Records a terminal failure, only if this lease still owns the row. */ OutboxTransitionResult markFailed(OutboxLease lease, String failureCode, Instant now); - /** - * Releases a lease without changing the record's outcome. - * - * @param messageId the record identity - */ - void releaseLease(MessageId messageId); - /** Gives a claim back, only if this lease still owns the row. */ OutboxTransitionResult releaseLease(OutboxLease lease); diff --git a/src/messaging/messaging-reliability-api/src/test/java/dev/caskeleton/messaging/reliability/OutboxRepositoryApiSafetyTest.java b/src/messaging/messaging-reliability-api/src/test/java/dev/caskeleton/messaging/reliability/OutboxRepositoryApiSafetyTest.java new file mode 100644 index 00000000..72c780e1 --- /dev/null +++ b/src/messaging/messaging-reliability-api/src/test/java/dev/caskeleton/messaging/reliability/OutboxRepositoryApiSafetyTest.java @@ -0,0 +1,24 @@ +package dev.caskeleton.messaging.reliability; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.messaging.api.MessageId; +import java.lang.reflect.Method; +import java.util.Set; +import org.junit.jupiter.api.Test; + +class OutboxRepositoryApiSafetyTest { + @Test + void outcomeTransitionsDoNotExposeUnfencedMessageIdOverloadsUnderTheSafeNames() { + Set fencedNames = + Set.of("markPublished", "markAmbiguous", "markFailed", "releaseLease"); + + assertThat(OutboxRepository.class.getMethods()) + .filteredOn(method -> fencedNames.contains(method.getName())) + .noneMatch(OutboxRepositoryApiSafetyTest::startsWithMessageId); + } + + private static boolean startsWithMessageId(Method method) { + return method.getParameterCount() > 0 && method.getParameterTypes()[0] == MessageId.class; + } +} diff --git a/src/messaging/messaging-schema-protobuf/build.gradle b/src/messaging/messaging-schema-protobuf/build.gradle index 054e0943..3c431b43 100644 --- a/src/messaging/messaging-schema-protobuf/build.gradle +++ b/src/messaging/messaging-schema-protobuf/build.gradle @@ -8,5 +8,5 @@ dependencies { // api: ProtobufMessageContract is a public record over com.google.protobuf.Message and // Parser, and registering a contract is the first thing a consumer of this codec does. - api libs.protobuf.java.legacy + api libs.protobuf.java } diff --git a/src/messaging/messaging-schema-protobuf/gradle.lockfile b/src/messaging/messaging-schema-protobuf/gradle.lockfile index 15b6267e..85388e06 100644 --- a/src/messaging/messaging-schema-protobuf/gradle.lockfile +++ b/src/messaging/messaging-schema-protobuf/gradle.lockfile @@ -23,8 +23,7 @@ com.google.guava:guava:33.5.0-jre=annotationProcessor,testAnnotationProcessor com.google.guava:guava:33.6.0-jre=checkstyle com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,testAnnotationProcessor com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,testAnnotationProcessor -com.google.protobuf:protobuf-java:4.29.3=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,testAnnotationProcessor +com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,compileClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins com.puppycrawl.tools:checkstyle:13.5.0=checkstyle commons-beanutils:commons-beanutils:1.11.0=checkstyle diff --git a/src/messaging/messaging-spring-boot-starter-kafka/build.gradle b/src/messaging/messaging-spring-boot-starter-kafka/build.gradle new file mode 100644 index 00000000..9333a84b --- /dev/null +++ b/src/messaging/messaging-spring-boot-starter-kafka/build.gradle @@ -0,0 +1,13 @@ +plugins { + id 'ca.platform-module' + id 'ca.spring-config' +} + +dependencies { + // Capability artifact: selecting Kafka is a build-time decision. The core starter contains no + // Kafka client classes. + api project(':messaging:messaging-spring-boot-starter') + api project(':messaging:messaging-kafka') + + implementation 'org.springframework.boot:spring-boot-autoconfigure' +} diff --git a/src/messaging/messaging-spring-boot-starter-kafka/gradle.lockfile b/src/messaging/messaging-spring-boot-starter-kafka/gradle.lockfile new file mode 100644 index 00000000..6e4716fe --- /dev/null +++ b/src/messaging/messaging-spring-boot-starter-kafka/gradle.lockfile @@ -0,0 +1,115 @@ +# This is a Gradle generated file for dependency locking. +# Manual edits can break the build and are not advised. +# This file is expected to be part of source control. +at.yawk.lz4:lz4-java:1.10.1=runtimeClasspath,testRuntimeClasspath +com.fasterxml.jackson.core:jackson-annotations:2.21=runtimeClasspath,testRuntimeClasspath +com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,testAnnotationProcessor +com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,testAnnotationProcessor +com.github.luben:zstd-jni:1.5.6-10=runtimeClasspath,testRuntimeClasspath +com.github.spotbugs:spotbugs-annotations:4.10.2=spotbugs +com.github.spotbugs:spotbugs:4.10.2=spotbugs +com.github.stephenc.jcip:jcip-annotations:1.0-1=spotbugs +com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,testAnnotationProcessor +com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,testAnnotationProcessor +com.google.auto:auto-common:1.2.2=annotationProcessor,testAnnotationProcessor +com.google.code.findbugs:jsr305:3.0.2=checkstyle,spotbugs +com.google.code.gson:gson:2.13.2=spotbugs +com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.41.0=spotbugs +com.google.errorprone:error_prone_annotations:2.47.0=checkstyle +com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,testAnnotationProcessor +com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.guava:guava:33.5.0-jre=annotationProcessor,testAnnotationProcessor +com.google.guava:guava:33.6.0-jre=checkstyle +com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,testAnnotationProcessor +com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins +com.puppycrawl.tools:checkstyle:13.5.0=checkstyle +commons-beanutils:commons-beanutils:1.11.0=checkstyle +commons-collections:commons-collections:3.2.2=checkstyle +commons-io:commons-io:2.21.0=spotbugs +commons-logging:commons-logging:1.3.6=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +info.picocli:picocli:4.7.7=checkstyle +io.cloudevents:cloudevents-api:4.0.1=runtimeClasspath,testRuntimeClasspath +io.cloudevents:cloudevents-core:4.0.1=runtimeClasspath,testRuntimeClasspath +io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,testAnnotationProcessor +io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,testAnnotationProcessor +io.micrometer:micrometer-commons:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.micrometer:micrometer-core:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.micrometer:micrometer-observation:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.projectreactor:reactor-core:3.8.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +javax.inject:javax.inject:1=annotationProcessor,testAnnotationProcessor +jaxen:jaxen:2.0.6=spotbugs +net.bytebuddy:byte-buddy:1.17.8=testCompileClasspath,testRuntimeClasspath +net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs +org.antlr:antlr4-runtime:4.13.2=checkstyle +org.apache.bcel:bcel:6.12.0=spotbugs +org.apache.commons:commons-lang3:3.20.0=checkstyle,spotbugs +org.apache.commons:commons-text:1.15.0=spotbugs +org.apache.commons:commons-text:1.3=checkstyle +org.apache.httpcomponents:httpclient:4.5.13=checkstyle +org.apache.httpcomponents:httpcore:4.4.16=checkstyle +org.apache.kafka:kafka-clients:4.1.2=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.apache.logging.log4j:log4j-api:2.25.5=spotbugs +org.apache.logging.log4j:log4j-core:2.25.5=spotbugs +org.apache.maven.doxia:doxia-core:1.12.0=checkstyle +org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle +org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle +org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle +org.apache.xbean:xbean-reflect:3.7=checkstyle +org.apiguardian:apiguardian-api:1.1.2=testCompileClasspath +org.assertj:assertj-core:3.27.7=testCompileClasspath,testRuntimeClasspath +org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle +org.codehaus.plexus:plexus-component-annotations:2.1.0=checkstyle +org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle +org.codehaus.plexus:plexus-utils:3.3.0=checkstyle +org.dom4j:dom4j:2.2.0=spotbugs +org.hdrhistogram:HdrHistogram:2.2.2=runtimeClasspath,testRuntimeClasspath +org.javassist:javassist:3.28.0-GA=checkstyle +org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-api:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-engine:6.0.3=testRuntimeClasspath +org.junit.jupiter:junit-jupiter-params:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-commons:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-engine:6.0.3=testRuntimeClasspath +org.junit.platform:junit-platform-launcher:6.0.3=testRuntimeClasspath +org.junit:junit-bom:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit:junit-bom:6.1.0=spotbugs +org.latencyutils:LatencyUtils:2.0.3=runtimeClasspath,testRuntimeClasspath +org.mockito:mockito-core:5.20.0=mockitoAgent +org.opentest4j:opentest4j:1.3.0=testCompileClasspath,testRuntimeClasspath +org.ow2.asm:asm-analysis:9.10.1=spotbugs +org.ow2.asm:asm-commons:9.10.1=spotbugs +org.ow2.asm:asm-tree:9.10.1=spotbugs +org.ow2.asm:asm-util:9.10.1=spotbugs +org.ow2.asm:asm:9.10.1=spotbugs +org.pcollections:pcollections:4.0.1=annotationProcessor,testAnnotationProcessor +org.reactivestreams:reactive-streams:1.0.4=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.reflections:reflections:0.10.2=checkstyle +org.slf4j:slf4j-api:2.0.18=runtimeClasspath,spotbugs,spotbugsSlf4j,testRuntimeClasspath +org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j +org.slf4j:slf4j-simple:2.0.18=checkstyle +org.springframework.boot:spring-boot-actuator:4.0.8=runtimeClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-autoconfigure:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-configuration-processor:4.0.8=annotationProcessor +org.springframework.boot:spring-boot:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.kafka:spring-kafka:4.0.7=runtimeClasspath,testRuntimeClasspath +org.springframework:spring-aop:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-beans:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-context:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-core:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-expression:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-jdbc:7.0.9=runtimeClasspath,testRuntimeClasspath +org.springframework:spring-messaging:7.0.9=runtimeClasspath,testRuntimeClasspath +org.springframework:spring-tx:7.0.9=runtimeClasspath,testRuntimeClasspath +org.xerial.snappy:snappy-java:1.1.10.7=runtimeClasspath,testRuntimeClasspath +org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs +tools.jackson.core:jackson-core:3.1.5=runtimeClasspath,testRuntimeClasspath +tools.jackson.core:jackson-databind:3.1.5=runtimeClasspath,testRuntimeClasspath +tools.jackson:jackson-bom:3.1.5=runtimeClasspath,testRuntimeClasspath +empty= diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaMessagingAutoConfiguration.java b/src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaMessagingAutoConfiguration.java similarity index 86% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaMessagingAutoConfiguration.java rename to src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaMessagingAutoConfiguration.java index 5525380e..cc2b247e 100644 --- a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaMessagingAutoConfiguration.java +++ b/src/messaging/messaging-spring-boot-starter-kafka/src/main/java/dev/caskeleton/messaging/autoconfigure/KafkaMessagingAutoConfiguration.java @@ -59,7 +59,7 @@ public class KafkaMessagingAutoConfiguration { return new StartupProfileValidation<>( () -> java.util.stream.Stream.concat( - compiled.kafkaBrokers().stream(), profiles.orderedStream()) + configuredKafkaProfiles(compiled).stream(), profiles.orderedStream()) .toList(), validator::validate); } @@ -167,4 +167,31 @@ public class KafkaMessagingAutoConfiguration { // the first rotation look like it had already happened. return new dev.caskeleton.messaging.kafka.KafkaMessagingTransport("kafka", 1L, producer); } + + private static java.util.List + configuredKafkaProfiles(CompiledMessagingConfiguration compiled) { + return compiled.brokers().entrySet().stream() + .filter( + entry -> + entry.getValue().type() != null + && entry.getValue().type().equalsIgnoreCase(BrokerSettings.KAFKA)) + .map( + entry -> { + BrokerSettings broker = entry.getValue(); + return new dev.caskeleton.messaging.kafka.KafkaBrokerProfile( + entry.getKey(), + broker.stable(), + broker.production(), + broker.bootstrapServers(), + broker.enableIdempotence(), + broker.acks(), + broker.maxInFlightRequestsPerConnection(), + broker.deliveryTimeout(), + broker.enableAutoCommit(), + broker.consumerGroup(), + broker.tlsEnabled(), + broker.authenticationEnabled()); + }) + .toList(); + } } diff --git a/src/messaging/messaging-spring-boot-starter-rabbit/build.gradle b/src/messaging/messaging-spring-boot-starter-rabbit/build.gradle new file mode 100644 index 00000000..3635e1c8 --- /dev/null +++ b/src/messaging/messaging-spring-boot-starter-rabbit/build.gradle @@ -0,0 +1,12 @@ +plugins { + id 'ca.platform-module' + id 'ca.spring-config' +} + +dependencies { + // Capability artifact: Rabbit types/client exist only when this artifact is deliberately added. + api project(':messaging:messaging-spring-boot-starter') + api project(':messaging:messaging-rabbit') + + implementation 'org.springframework.boot:spring-boot-autoconfigure' +} diff --git a/src/messaging/messaging-spring-boot-starter-rabbit/gradle.lockfile b/src/messaging/messaging-spring-boot-starter-rabbit/gradle.lockfile new file mode 100644 index 00000000..1d3075d1 --- /dev/null +++ b/src/messaging/messaging-spring-boot-starter-rabbit/gradle.lockfile @@ -0,0 +1,124 @@ +# This is a Gradle generated file for dependency locking. +# Manual edits can break the build and are not advised. +# This file is expected to be part of source control. +com.fasterxml.jackson.core:jackson-annotations:2.21=runtimeClasspath,testRuntimeClasspath +com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,testAnnotationProcessor +com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,testAnnotationProcessor +com.github.spotbugs:spotbugs-annotations:4.10.2=spotbugs +com.github.spotbugs:spotbugs:4.10.2=spotbugs +com.github.stephenc.jcip:jcip-annotations:1.0-1=spotbugs +com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,testAnnotationProcessor +com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,testAnnotationProcessor +com.google.auto:auto-common:1.2.2=annotationProcessor,testAnnotationProcessor +com.google.code.findbugs:jsr305:3.0.2=checkstyle,spotbugs +com.google.code.gson:gson:2.13.2=spotbugs +com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.41.0=spotbugs +com.google.errorprone:error_prone_annotations:2.47.0=checkstyle +com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,testAnnotationProcessor +com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.guava:guava:33.5.0-jre=annotationProcessor,testAnnotationProcessor +com.google.guava:guava:33.6.0-jre=checkstyle +com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,testAnnotationProcessor +com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,testAnnotationProcessor +com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins +com.puppycrawl.tools:checkstyle:13.5.0=checkstyle +com.rabbitmq:amqp-client:5.27.1=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +commons-beanutils:commons-beanutils:1.11.0=checkstyle +commons-collections:commons-collections:3.2.2=checkstyle +commons-io:commons-io:2.21.0=spotbugs +commons-logging:commons-logging:1.3.6=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +info.picocli:picocli:4.7.7=checkstyle +io.cloudevents:cloudevents-api:4.0.1=runtimeClasspath,testRuntimeClasspath +io.cloudevents:cloudevents-core:4.0.1=runtimeClasspath,testRuntimeClasspath +io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,testAnnotationProcessor +io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,testAnnotationProcessor +io.micrometer:micrometer-commons:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.micrometer:micrometer-core:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.micrometer:micrometer-observation:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-buffer:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-base:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-compression:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-marshalling:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-protobuf:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-common:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-handler:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-resolver:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-transport-native-unix-common:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-transport:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.projectreactor:reactor-core:3.8.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +javax.inject:javax.inject:1=annotationProcessor,testAnnotationProcessor +jaxen:jaxen:2.0.6=spotbugs +net.bytebuddy:byte-buddy:1.17.8=testCompileClasspath,testRuntimeClasspath +net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs +org.antlr:antlr4-runtime:4.13.2=checkstyle +org.apache.bcel:bcel:6.12.0=spotbugs +org.apache.commons:commons-lang3:3.20.0=checkstyle,spotbugs +org.apache.commons:commons-text:1.15.0=spotbugs +org.apache.commons:commons-text:1.3=checkstyle +org.apache.httpcomponents:httpclient:4.5.13=checkstyle +org.apache.httpcomponents:httpcore:4.4.16=checkstyle +org.apache.logging.log4j:log4j-api:2.25.5=spotbugs +org.apache.logging.log4j:log4j-core:2.25.5=spotbugs +org.apache.maven.doxia:doxia-core:1.12.0=checkstyle +org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle +org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle +org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle +org.apache.xbean:xbean-reflect:3.7=checkstyle +org.apiguardian:apiguardian-api:1.1.2=testCompileClasspath +org.assertj:assertj-core:3.27.7=testCompileClasspath,testRuntimeClasspath +org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle +org.codehaus.plexus:plexus-component-annotations:2.1.0=checkstyle +org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle +org.codehaus.plexus:plexus-utils:3.3.0=checkstyle +org.dom4j:dom4j:2.2.0=spotbugs +org.hdrhistogram:HdrHistogram:2.2.2=runtimeClasspath,testRuntimeClasspath +org.javassist:javassist:3.28.0-GA=checkstyle +org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-api:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-engine:6.0.3=testRuntimeClasspath +org.junit.jupiter:junit-jupiter-params:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-commons:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-engine:6.0.3=testRuntimeClasspath +org.junit.platform:junit-platform-launcher:6.0.3=testRuntimeClasspath +org.junit:junit-bom:6.0.3=testCompileClasspath,testRuntimeClasspath +org.junit:junit-bom:6.1.0=spotbugs +org.latencyutils:LatencyUtils:2.0.3=runtimeClasspath,testRuntimeClasspath +org.mockito:mockito-core:5.20.0=mockitoAgent +org.opentest4j:opentest4j:1.3.0=testCompileClasspath,testRuntimeClasspath +org.ow2.asm:asm-analysis:9.10.1=spotbugs +org.ow2.asm:asm-commons:9.10.1=spotbugs +org.ow2.asm:asm-tree:9.10.1=spotbugs +org.ow2.asm:asm-util:9.10.1=spotbugs +org.ow2.asm:asm:9.10.1=spotbugs +org.pcollections:pcollections:4.0.1=annotationProcessor,testAnnotationProcessor +org.reactivestreams:reactive-streams:1.0.4=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.reflections:reflections:0.10.2=checkstyle +org.slf4j:slf4j-api:2.0.18=compileClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testRuntimeClasspath +org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j +org.slf4j:slf4j-simple:2.0.18=checkstyle +org.springframework.amqp:spring-amqp:4.0.5=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.amqp:spring-rabbit:4.0.5=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-actuator:4.0.8=runtimeClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-autoconfigure:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-configuration-processor:4.0.8=annotationProcessor +org.springframework.boot:spring-boot:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-aop:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-beans:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-context:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-core:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-expression:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-jdbc:7.0.9=runtimeClasspath,testRuntimeClasspath +org.springframework:spring-messaging:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-tx:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs +tools.jackson.core:jackson-core:3.1.5=runtimeClasspath,testRuntimeClasspath +tools.jackson.core:jackson-databind:3.1.5=runtimeClasspath,testRuntimeClasspath +tools.jackson:jackson-bom:3.1.5=runtimeClasspath,testRuntimeClasspath +empty= diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/RabbitMessagingAutoConfiguration.java b/src/messaging/messaging-spring-boot-starter-rabbit/src/main/java/dev/caskeleton/messaging/autoconfigure/RabbitMessagingAutoConfiguration.java similarity index 75% rename from src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/RabbitMessagingAutoConfiguration.java rename to src/messaging/messaging-spring-boot-starter-rabbit/src/main/java/dev/caskeleton/messaging/autoconfigure/RabbitMessagingAutoConfiguration.java index 66b14ddf..f64cd424 100644 --- a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/RabbitMessagingAutoConfiguration.java +++ b/src/messaging/messaging-spring-boot-starter-rabbit/src/main/java/dev/caskeleton/messaging/autoconfigure/RabbitMessagingAutoConfiguration.java @@ -55,7 +55,7 @@ public class RabbitMessagingAutoConfiguration { return new StartupProfileValidation<>( () -> java.util.stream.Stream.concat( - compiled.rabbitBrokers().stream(), profiles.orderedStream()) + configuredRabbitProfiles(compiled).stream(), profiles.orderedStream()) .toList(), validator::validate); } @@ -95,4 +95,32 @@ public class RabbitMessagingAutoConfiguration { CredentialRuntimeRegistry credentials, BrokerTlsPolicy tlsPolicy) { return new RabbitSecurityConfigurer(credentials, tlsPolicy); } + + private static java.util.List + configuredRabbitProfiles(CompiledMessagingConfiguration compiled) { + return compiled.brokers().entrySet().stream() + .filter( + entry -> + entry.getValue().type() != null + && entry.getValue().type().equalsIgnoreCase(BrokerSettings.RABBITMQ)) + .map( + entry -> { + BrokerSettings broker = entry.getValue(); + return new dev.caskeleton.messaging.rabbit.RabbitBrokerProfile( + entry.getKey(), + broker.stable(), + broker.production(), + broker.addresses(), + broker.publisherConfirms(), + broker.publisherReturns(), + broker.mandatory(), + broker.confirmTimeout(), + broker.autoAck(), + broker.prefetch(), + broker.quorumQueues(), + broker.tlsEnabled(), + broker.authenticationEnabled()); + }) + .toList(); + } } diff --git a/src/messaging/messaging-spring-boot-starter/README.md b/src/messaging/messaging-spring-boot-starter/README.md index c99440e2..9580cea2 100644 --- a/src/messaging/messaging-spring-boot-starter/README.md +++ b/src/messaging/messaging-spring-boot-starter/README.md @@ -1,26 +1,47 @@ # messaging-spring-boot-starter -## 아티팩트 분리 (예정) +## 아티팩트 분리 -이 starter는 현재 하나의 아티팩트로 Kafka·Rabbit·JDBC reliability·admin 자동설정을 모두 등록한다. -MSG-007이 요구하는 최종 형태는 capability별 분리다: +기본 `messaging-spring-boot-starter`는 이제 **broker-neutral core**다. Kafka/Rabbit client를 +production runtime에 직접 넣지 않으며, 브로커 채택은 capability artifact를 composition에 추가하는 +build-time 결정이다. ```text -messaging-spring-boot-autoconfigure-core -messaging-spring-boot-starter-core -messaging-spring-boot-starter-kafka -messaging-spring-boot-starter-rabbit -messaging-spring-boot-starter-reliability-jdbc-postgresql -messaging-spring-boot-starter-admin +messaging-spring-boot-starter +├─ messaging-spring-boot-starter-kafka # Kafka client/transport capability +└─ messaging-spring-boot-starter-rabbit # Rabbit profile/validator capability ``` -지금 반영된 것과 남은 것을 분명히 적는다. +- 기본 app-bootstrap은 core starter만 가진다. 따라서 messaging off/default runtime에는 + `kafka-clients`, `spring-kafka`, `spring-rabbit`, `amqp-client`가 없다. +- Kafka를 채택하는 composition은 `:messaging:messaging-spring-boot-starter-kafka`를 추가한다. +- Rabbit capability도 별도 artifact지만, 아래 설명처럼 아직 production transport가 없어 + `app.messaging.broker=rabbit` 선택은 startup에서 거부된다. +- reliability/admin의 추가 artifact 분리는 별도 구조 개선 여지로 남지만, broker SDK 동시 탑재 문제와 + transport 선택 문제는 core/broker capability 분리로 해소했다. +- legacy R0 outbound bridge도 같은 원칙을 따른다. broker-neutral + `:adapter:outbound:messaging`과 Kafka 전용 `:adapter:outbound:messaging-kafka`가 분리돼 있다. -- **반영**: 내부 leaf 9개를 `api` → `implementation`으로 낮췄다. 어댑터를 쓰지 않는 소비자의 컴파일 - classpath에 두 브로커 SDK가 더 이상 올라가지 않는다. -- **반영**: 브로커 security configurer는 `CredentialRuntimeRegistry` 빈이 있을 때만 만들어지고, - production 프로파일에 credential 소스가 없으면 `MessagingCredentialRequirementValidator`가 - 내부 타입 이름이 아니라 조치 가능한 한 개의 오류로 실패시킨다. -- **남음**: 아티팩트 자체의 분리. 레지스트리(43→44에서 다시 49)와 `AutoConfiguration.imports` 분할을 - 함께 바꾸는 변경이라 별도 커밋으로 다룬다. 그 전까지 런타임 의존성(`runtimeClasspath`)에는 여전히 - 두 브로커가 함께 들어온다. +## 현재 broker/runtime 지원 범위 + +### Kafka + +Kafka publish runtime은 **Kafka capability artifact를 추가한 composition에서만** 조립된다. +`KafkaMessagingTransport`는 publish runtime으로 설치되지만, `KafkaConsumerRegistrar`는 capability +starter나 app-bootstrap에서 자동 생성하지 않는다. 따라서 현재 자동조립된 transport에 consume +registration을 요청하면 `KAFKA_CONSUMER_NOT_CONFIGURED`로 실패한다. + +consume을 채택하려면 애플리케이션 composition이 별도로 `KafkaConsumerRegistrar`와 handler sink를 +조립해야 한다. leaf 안의 consumer/rebalance/settlement 테스트가 초록이라는 사실은 capability +starter가 consumer runtime까지 자동 제공한다는 뜻이 아니다. + +### RabbitMQ + +RabbitMQ는 별도 capability artifact에 격리되어 있지만 **아직 선택할 수 없는 transport**다. +`app.messaging.broker=rabbit`을 설정하면 `MessagingProviderSelection`이 startup에서 거부한다. +이 leaf에는 validator, failure classifier, topology/security 부품과 테스트는 있지만 production +`RabbitChannelPublisher` 구현이 없어 `MessagingTransport`를 완성할 수 없다. + +현재 selectable broker는 Kafka뿐이다. Rabbit이 selectable로 승격되는 조건은 production +channel publisher/settlement bridge를 구현하고 starter composition 및 broker integration 증거를 +함께 추가하는 것이다. diff --git a/src/messaging/messaging-spring-boot-starter/build.gradle b/src/messaging/messaging-spring-boot-starter/build.gradle index 448d06a4..14167faa 100644 --- a/src/messaging/messaging-spring-boot-starter/build.gradle +++ b/src/messaging/messaging-spring-boot-starter/build.gradle @@ -1,4 +1,5 @@ plugins { + id 'ca.auxiliary-source-set' id 'ca.platform-module' id 'ca.spring-config' } @@ -14,6 +15,12 @@ plugins { // is `implementation`. Splitting the starter into per-capability artifacts (core / kafka / rabbit / // reliability / admin) is the structural fix the review asks for and is a registry change of its // own; this is the part that stops an adopter's compile classpath from containing two broker SDKs. +auxiliarySourceSets { + sourceSet('integrationTest') { + compilesAgainst 'main' + } +} + dependencies { // Types an adopter writes against: envelopes, destinations, publish results, profiles, ports. api project(':messaging:messaging-core-api') @@ -31,8 +38,6 @@ dependencies { // which is why MessagingCoreAutoConfiguration consumed a MessagePublisher that nothing in // reach could produce (MSG-INT-003). implementation project(':messaging:messaging-runtime-core') - implementation project(':messaging:messaging-kafka') - implementation project(':messaging:messaging-rabbit') implementation project(':messaging:messaging-outbox-jdbc-postgresql') implementation project(':messaging:messaging-inbox-jdbc-postgresql') implementation project(':messaging:messaging-claim-check') @@ -50,6 +55,10 @@ dependencies { testImplementation 'io.projectreactor:reactor-test' testImplementation 'org.springframework.boot:spring-boot-test' testImplementation 'org.springframework:spring-test' + // Provider auto-configurations live in capability artifacts. Tests that exercise provider + // selection add them only to the test graph; the production starter remains broker-neutral. + testImplementation project(':messaging:messaging-spring-boot-starter-kafka') + testImplementation project(':messaging:messaging-spring-boot-starter-rabbit') // Test-only, and specifically so the configuration reference can be executed rather than read: // MessagingConfigurationBindingTest loads the YAML blocks out of the shipped document and boots // a context on them. Spring Boot 4 treats snakeyaml as optional, so a document-driven test has @@ -59,6 +68,15 @@ dependencies { // app-bootstrap membership in the same change that proves a real broker round trip, // so the proof has to run somewhere — and the starter is where the whole platform // assembles. - testImplementation 'org.testcontainers:testcontainers-junit-jupiter' - testImplementation 'org.testcontainers:testcontainers-kafka' + integrationTestImplementation project(':messaging:messaging-spring-boot-starter-kafka') + integrationTestImplementation 'org.testcontainers:testcontainers-junit-jupiter' + integrationTestImplementation 'org.testcontainers:testcontainers-kafka' +} + +strictTestLanes { + lane('integrationTest') { + integration() + sourceSet = 'integrationTest' + description = 'Runs the assembled messaging starter round trip against real Kafka.' + } } diff --git a/src/messaging/messaging-spring-boot-starter/gradle.lockfile b/src/messaging/messaging-spring-boot-starter/gradle.lockfile index c873ea46..af7c26ed 100644 --- a/src/messaging/messaging-spring-boot-starter/gradle.lockfile +++ b/src/messaging/messaging-spring-boot-starter/gradle.lockfile @@ -1,79 +1,79 @@ # This is a Gradle generated file for dependency locking. # Manual edits can break the build and are not advised. # This file is expected to be part of source control. -at.yawk.lz4:lz4-java:1.10.1=runtimeClasspath,testRuntimeClasspath -com.fasterxml.jackson.core:jackson-annotations:2.21=runtimeClasspath,testCompileClasspath,testRuntimeClasspath -com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,testAnnotationProcessor -com.github.docker-java:docker-java-api:3.7.1=testCompileClasspath,testRuntimeClasspath -com.github.docker-java:docker-java-transport-zerodep:3.7.1=testCompileClasspath,testRuntimeClasspath -com.github.docker-java:docker-java-transport:3.7.1=testCompileClasspath,testRuntimeClasspath -com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,testAnnotationProcessor -com.github.luben:zstd-jni:1.5.6-10=runtimeClasspath,testRuntimeClasspath +at.yawk.lz4:lz4-java:1.10.1=integrationTestRuntimeClasspath,testRuntimeClasspath +com.fasterxml.jackson.core:jackson-annotations:2.21=integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testRuntimeClasspath +com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.github.docker-java:docker-java-api:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.docker-java:docker-java-transport-zerodep:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.docker-java:docker-java-transport:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath +com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.github.luben:zstd-jni:1.5.6-10=integrationTestRuntimeClasspath,testRuntimeClasspath com.github.spotbugs:spotbugs-annotations:4.10.2=spotbugs com.github.spotbugs:spotbugs:4.10.2=spotbugs com.github.stephenc.jcip:jcip-annotations:1.0-1=spotbugs -com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,testAnnotationProcessor -com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,testAnnotationProcessor -com.google.auto:auto-common:1.2.2=annotationProcessor,testAnnotationProcessor +com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.auto:auto-common:1.2.2=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor com.google.code.findbugs:jsr305:3.0.2=checkstyle,spotbugs com.google.code.gson:gson:2.13.2=spotbugs -com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor com.google.errorprone:error_prone_annotations:2.41.0=spotbugs com.google.errorprone:error_prone_annotations:2.47.0=checkstyle -com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,testAnnotationProcessor -com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,testAnnotationProcessor -com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,testAnnotationProcessor -com.google.guava:guava:33.5.0-jre=annotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.guava:guava:33.5.0-jre=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor com.google.guava:guava:33.6.0-jre=checkstyle -com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,testAnnotationProcessor -com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,testAnnotationProcessor -com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,testAnnotationProcessor +com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,testAnnotationProcessor +com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins com.puppycrawl.tools:checkstyle:13.5.0=checkstyle -com.rabbitmq:amqp-client:5.27.1=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +com.rabbitmq:amqp-client:5.27.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath commons-beanutils:commons-beanutils:1.11.0=checkstyle -commons-codec:commons-codec:1.19.0=testCompileClasspath,testRuntimeClasspath +commons-codec:commons-codec:1.19.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath commons-collections:commons-collections:3.2.2=checkstyle -commons-io:commons-io:2.20.0=testCompileClasspath,testRuntimeClasspath +commons-io:commons-io:2.20.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath commons-io:commons-io:2.21.0=spotbugs -commons-logging:commons-logging:1.3.6=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +commons-logging:commons-logging:1.3.6=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath info.picocli:picocli:4.7.7=checkstyle -io.cloudevents:cloudevents-api:4.0.1=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.cloudevents:cloudevents-core:4.0.1=runtimeClasspath,testRuntimeClasspath -io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,testAnnotationProcessor -io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,testAnnotationProcessor -io.micrometer:micrometer-commons:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.micrometer:micrometer-core:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.micrometer:micrometer-observation:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-buffer:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-codec-base:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-codec-compression:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-codec-marshalling:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-codec-protobuf:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-codec:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-common:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-handler:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-resolver:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-transport-native-unix-common:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-transport:4.2.17.Final=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.projectreactor:reactor-core:3.8.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.projectreactor:reactor-test:3.8.7=testCompileClasspath,testRuntimeClasspath -javax.inject:javax.inject:1=annotationProcessor,testAnnotationProcessor +io.cloudevents:cloudevents-api:4.0.1=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.cloudevents:cloudevents-core:4.0.1=integrationTestRuntimeClasspath,runtimeClasspath,testRuntimeClasspath +io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +io.micrometer:micrometer-commons:1.16.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.micrometer:micrometer-core:1.16.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.micrometer:micrometer-observation:1.16.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-buffer:4.2.17.Final=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-base:4.2.17.Final=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-compression:4.2.17.Final=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-marshalling:4.2.17.Final=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec-protobuf:4.2.17.Final=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-codec:4.2.17.Final=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-common:4.2.17.Final=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-handler:4.2.17.Final=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-resolver:4.2.17.Final=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-transport-native-unix-common:4.2.17.Final=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +io.netty:netty-transport:4.2.17.Final=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +io.projectreactor:reactor-core:3.8.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +io.projectreactor:reactor-test:3.8.7=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +javax.inject:javax.inject:1=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor jaxen:jaxen:2.0.6=spotbugs -net.bytebuddy:byte-buddy:1.17.8=testCompileClasspath,testRuntimeClasspath -net.java.dev.jna:jna:5.18.1=testCompileClasspath,testRuntimeClasspath +net.bytebuddy:byte-buddy:1.17.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +net.java.dev.jna:jna:5.18.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs org.antlr:antlr4-runtime:4.13.2=checkstyle org.apache.bcel:bcel:6.12.0=spotbugs -org.apache.commons:commons-compress:1.28.0=testCompileClasspath,testRuntimeClasspath -org.apache.commons:commons-lang3:3.20.0=checkstyle,spotbugs,testCompileClasspath,testRuntimeClasspath +org.apache.commons:commons-compress:1.28.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.apache.commons:commons-lang3:3.20.0=checkstyle,integrationTestCompileClasspath,integrationTestRuntimeClasspath,spotbugs org.apache.commons:commons-text:1.15.0=spotbugs org.apache.commons:commons-text:1.3=checkstyle org.apache.httpcomponents:httpclient:4.5.13=checkstyle org.apache.httpcomponents:httpcore:4.4.16=checkstyle -org.apache.kafka:kafka-clients:4.1.2=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.apache.kafka:kafka-clients:4.1.2=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.apache.logging.log4j:log4j-api:2.25.5=spotbugs org.apache.logging.log4j:log4j-core:2.25.5=spotbugs org.apache.maven.doxia:doxia-core:1.12.0=checkstyle @@ -81,65 +81,65 @@ org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle org.apache.xbean:xbean-reflect:3.7=checkstyle -org.apiguardian:apiguardian-api:1.1.2=testCompileClasspath -org.assertj:assertj-core:3.27.7=testCompileClasspath,testRuntimeClasspath +org.apiguardian:apiguardian-api:1.1.2=integrationTestCompileClasspath,testCompileClasspath +org.assertj:assertj-core:3.27.7=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle org.codehaus.plexus:plexus-component-annotations:2.1.0=checkstyle org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle org.codehaus.plexus:plexus-utils:3.3.0=checkstyle org.dom4j:dom4j:2.2.0=spotbugs -org.hdrhistogram:HdrHistogram:2.2.2=runtimeClasspath,testRuntimeClasspath +org.hdrhistogram:HdrHistogram:2.2.2=integrationTestRuntimeClasspath,runtimeClasspath,testRuntimeClasspath org.javassist:javassist:3.28.0-GA=checkstyle -org.jetbrains:annotations:17.0.0=testCompileClasspath,testRuntimeClasspath -org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-api:6.0.3=testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-engine:6.0.3=testRuntimeClasspath -org.junit.jupiter:junit-jupiter-params:6.0.3=testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter:6.0.3=testCompileClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-commons:6.0.3=testCompileClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-engine:6.0.3=testRuntimeClasspath -org.junit.platform:junit-platform-launcher:6.0.3=testRuntimeClasspath -org.junit:junit-bom:6.0.3=testCompileClasspath,testRuntimeClasspath +org.jetbrains:annotations:17.0.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,integrationTestAnnotationProcessor,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-api:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-engine:6.0.3=integrationTestRuntimeClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter-params:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.jupiter:junit-jupiter:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-commons:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-engine:6.0.3=integrationTestRuntimeClasspath,testRuntimeClasspath +org.junit.platform:junit-platform-launcher:6.0.3=integrationTestRuntimeClasspath,testRuntimeClasspath +org.junit:junit-bom:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.junit:junit-bom:6.1.0=spotbugs -org.latencyutils:LatencyUtils:2.0.3=runtimeClasspath,testRuntimeClasspath +org.latencyutils:LatencyUtils:2.0.3=integrationTestRuntimeClasspath,runtimeClasspath,testRuntimeClasspath org.mockito:mockito-core:5.20.0=mockitoAgent -org.opentest4j:opentest4j:1.3.0=testCompileClasspath,testRuntimeClasspath +org.opentest4j:opentest4j:1.3.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath org.ow2.asm:asm-analysis:9.10.1=spotbugs org.ow2.asm:asm-commons:9.10.1=spotbugs org.ow2.asm:asm-tree:9.10.1=spotbugs org.ow2.asm:asm-util:9.10.1=spotbugs org.ow2.asm:asm:9.10.1=spotbugs -org.pcollections:pcollections:4.0.1=annotationProcessor,testAnnotationProcessor -org.reactivestreams:reactive-streams:1.0.4=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.pcollections:pcollections:4.0.1=annotationProcessor,integrationTestAnnotationProcessor,testAnnotationProcessor +org.reactivestreams:reactive-streams:1.0.4=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.reflections:reflections:0.10.2=checkstyle -org.rnorth.duct-tape:duct-tape:1.0.8=testCompileClasspath,testRuntimeClasspath -org.slf4j:slf4j-api:2.0.18=compileClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testRuntimeClasspath +org.rnorth.duct-tape:duct-tape:1.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.slf4j:slf4j-api:2.0.18=integrationTestCompileClasspath,integrationTestRuntimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testRuntimeClasspath org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j org.slf4j:slf4j-simple:2.0.18=checkstyle -org.springframework.amqp:spring-amqp:4.0.5=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.amqp:spring-rabbit:4.0.5=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-actuator:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-autoconfigure:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.amqp:spring-amqp:4.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.amqp:spring-rabbit:4.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-actuator:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-autoconfigure:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.springframework.boot:spring-boot-configuration-processor:4.0.8=annotationProcessor -org.springframework.boot:spring-boot-test:4.0.8=testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot:4.0.8=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.kafka:spring-kafka:4.0.7=runtimeClasspath,testRuntimeClasspath -org.springframework:spring-aop:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-beans:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-context:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-core:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-expression:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-jdbc:7.0.9=runtimeClasspath,testRuntimeClasspath -org.springframework:spring-messaging:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-test:7.0.9=testCompileClasspath,testRuntimeClasspath -org.springframework:spring-tx:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers-junit-jupiter:2.0.5=testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers-kafka:2.0.5=testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers:2.0.5=testCompileClasspath,testRuntimeClasspath -org.xerial.snappy:snappy-java:1.1.10.7=runtimeClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-test:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.kafka:spring-kafka:4.0.7=integrationTestRuntimeClasspath,testRuntimeClasspath +org.springframework:spring-aop:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-beans:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-context:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-core:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-expression:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-jdbc:7.0.9=integrationTestRuntimeClasspath,runtimeClasspath,testRuntimeClasspath +org.springframework:spring-messaging:7.0.9=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-test:7.0.9=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework:spring-tx:7.0.9=integrationTestCompileClasspath,integrationTestRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.testcontainers:testcontainers-junit-jupiter:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.testcontainers:testcontainers-kafka:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.testcontainers:testcontainers:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath +org.xerial.snappy:snappy-java:1.1.10.7=integrationTestRuntimeClasspath,testRuntimeClasspath org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs -org.yaml:snakeyaml:2.5=testCompileClasspath,testRuntimeClasspath -tools.jackson.core:jackson-core:3.1.5=runtimeClasspath,testRuntimeClasspath -tools.jackson.core:jackson-databind:3.1.5=runtimeClasspath,testRuntimeClasspath -tools.jackson:jackson-bom:3.1.5=runtimeClasspath,testRuntimeClasspath +org.yaml:snakeyaml:2.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +tools.jackson.core:jackson-core:3.1.5=integrationTestRuntimeClasspath,runtimeClasspath,testRuntimeClasspath +tools.jackson.core:jackson-databind:3.1.5=integrationTestRuntimeClasspath,runtimeClasspath,testRuntimeClasspath +tools.jackson:jackson-bom:3.1.5=integrationTestRuntimeClasspath,runtimeClasspath,testRuntimeClasspath empty= diff --git a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingLiveRoundTripQualificationTest.java b/src/messaging/messaging-spring-boot-starter/src/integrationTest/java/dev/caskeleton/messaging/autoconfigure/MessagingLiveRoundTripQualificationTest.java similarity index 98% rename from src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingLiveRoundTripQualificationTest.java rename to src/messaging/messaging-spring-boot-starter/src/integrationTest/java/dev/caskeleton/messaging/autoconfigure/MessagingLiveRoundTripQualificationTest.java index ceaa89c5..8fdc0a24 100644 --- a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingLiveRoundTripQualificationTest.java +++ b/src/messaging/messaging-spring-boot-starter/src/integrationTest/java/dev/caskeleton/messaging/autoconfigure/MessagingLiveRoundTripQualificationTest.java @@ -180,7 +180,9 @@ class MessagingLiveRoundTripQualificationTest { ContentType.JSON, dev.caskeleton.messaging.schema.SchemaCompatibility.BACKWARD_TRANSITIVE, java.util.Set.of(new MessageType("order.created"))), - dev.caskeleton.messaging.api.delivery.DeliveryGuarantee.AT_LEAST_ONCE, + deadLetter == null + ? dev.caskeleton.messaging.api.delivery.DeliveryGuarantee.AT_MOST_ONCE + : dev.caskeleton.messaging.api.delivery.DeliveryGuarantee.AT_LEAST_ONCE, dev.caskeleton.messaging.api.delivery.OrderingScope.NONE, dev.caskeleton.messaging.api.delivery.ExternalSideEffectGuarantee.IDEMPOTENCY_REQUIRED, dev.caskeleton.messaging.policy.ProducerPolicy.defaults(), diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/CompiledMessagingConfiguration.java b/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/CompiledMessagingConfiguration.java index 661fcd68..7b65e6a6 100644 --- a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/CompiledMessagingConfiguration.java +++ b/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/CompiledMessagingConfiguration.java @@ -1,53 +1,43 @@ package dev.caskeleton.messaging.autoconfigure; -import dev.caskeleton.messaging.kafka.KafkaBrokerProfile; import dev.caskeleton.messaging.policy.DestinationProfile; -import dev.caskeleton.messaging.rabbit.RabbitBrokerProfile; import dev.caskeleton.messaging.security.BrokerSecurityProfile; import java.util.List; +import java.util.Map; import java.util.Objects; /** - * What the documented configuration compiles to. + * What the documented broker-neutral configuration compiles to. * - *

      One object rather than four beans, because the four are only meaningful together: a - * destination names a broker, a security entry secures one, and a compile that produced three of - * the four would leave the fourth silently empty. Holding them as one result means the startup - * validations either all see this deployment's configuration or the compile failed. + *

      The core starter owns destination/security policy and the raw broker settings an adopter + * wrote. It deliberately does not construct Kafka or Rabbit profile types: doing that here would + * make the supposedly core artifact depend on both broker adapters. A broker capability compiles + * its own profile from {@link #brokers()} only when that capability artifact is present. * * @param destinations the destination profiles built from {@code app.messaging.destinations} - * @param kafkaBrokers the Kafka profiles built from {@code app.messaging.brokers} - * @param rabbitBrokers the RabbitMQ profiles built from {@code app.messaging.brokers} + * @param brokers the validated broker settings keyed by logical broker name * @param security the broker security profiles built from {@code app.messaging.security} */ public record CompiledMessagingConfiguration( List destinations, - List kafkaBrokers, - List rabbitBrokers, + Map brokers, List security) { public CompiledMessagingConfiguration { Objects.requireNonNull(destinations, "destinations must not be null"); - Objects.requireNonNull(kafkaBrokers, "kafkaBrokers must not be null"); - Objects.requireNonNull(rabbitBrokers, "rabbitBrokers must not be null"); + Objects.requireNonNull(brokers, "brokers must not be null"); Objects.requireNonNull(security, "security must not be null"); destinations = List.copyOf(destinations); - kafkaBrokers = List.copyOf(kafkaBrokers); - rabbitBrokers = List.copyOf(rabbitBrokers); + brokers = Map.copyOf(brokers); security = List.copyOf(security); } /** * Returns the result of compiling a deployment that configured nothing. * - *

      Empty is a legitimate state, not a failure: an application may still register its profiles - * as beans, which is how this platform worked before anything bound. What is not legitimate is a - * deployment that configured destinations and got this — which is why the compiler builds it only - * when the sections really are absent. - * * @return the empty compilation */ public static CompiledMessagingConfiguration empty() { - return new CompiledMessagingConfiguration(List.of(), List.of(), List.of(), List.of()); + return new CompiledMessagingConfiguration(List.of(), Map.of(), List.of()); } } diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/DefaultBatchMessagePublisher.java b/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/DefaultBatchMessagePublisher.java index f6f65481..c45124d2 100644 --- a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/DefaultBatchMessagePublisher.java +++ b/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/DefaultBatchMessagePublisher.java @@ -34,10 +34,11 @@ import java.util.function.Supplier; * already in flight when the first rejection arrives cannot be recalled, so they are still awaited * and reported; pretending otherwise would leave the caller unsure whether they landed. */ -public final class DefaultBatchMessagePublisher implements BatchMessagePublisher { +public final class DefaultBatchMessagePublisher implements BatchMessagePublisher, AutoCloseable { private final MessagePublisher publisher; private final Supplier clock; + private final java.util.concurrent.ScheduledExecutorService deadlines; /** * Creates a batch publisher over the single-message publisher. @@ -46,8 +47,24 @@ public final class DefaultBatchMessagePublisher implements BatchMessagePublisher * @param clock supplies the current instant */ public DefaultBatchMessagePublisher(MessagePublisher publisher, Supplier clock) { + this( + publisher, + clock, + java.util.concurrent.Executors.newSingleThreadScheduledExecutor( + runnable -> { + Thread thread = new Thread(runnable, "messaging-batch-deadline"); + thread.setDaemon(true); + return thread; + })); + } + + DefaultBatchMessagePublisher( + MessagePublisher publisher, + Supplier clock, + java.util.concurrent.ScheduledExecutorService deadlines) { this.publisher = Objects.requireNonNull(publisher, "publisher must not be null"); this.clock = Objects.requireNonNull(clock, "clock must not be null"); + this.deadlines = Objects.requireNonNull(deadlines, "deadlines must not be null"); } @Override @@ -111,7 +128,7 @@ public final class DefaultBatchMessagePublisher implements BatchMessagePublisher // Same for the scheduled future: cancelling it early would only save a no-op, and the task // checks `isDone` before completing anything. java.util.concurrent.ScheduledFuture ignoredDeadline = - DEADLINES.schedule( + deadlines.schedule( () -> { if (!completed.isDone()) { completed.complete( @@ -126,19 +143,10 @@ public final class DefaultBatchMessagePublisher implements BatchMessagePublisher return completed; } - /** - * One scheduler for batch deadlines. - * - *

      A daemon thread so a pending deadline never keeps the JVM alive, and one shared instance - * because a scheduler per batch is a thread per batch. - */ - private static final java.util.concurrent.ScheduledExecutorService DEADLINES = - java.util.concurrent.Executors.newSingleThreadScheduledExecutor( - runnable -> { - Thread thread = new Thread(runnable, "messaging-batch-deadline"); - thread.setDaemon(true); - return thread; - }); + @Override + public void close() { + deadlines.shutdownNow(); + } private boolean anyRejected(List> pending) { return pending.stream() diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingAdminAutoConfiguration.java b/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingAdminAutoConfiguration.java index 14bf022f..5238ba6a 100644 --- a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingAdminAutoConfiguration.java +++ b/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingAdminAutoConfiguration.java @@ -24,7 +24,10 @@ import org.springframework.context.annotation.Configuration; * or delete registers one itself, with an admin credential this runtime does not hold. */ @Configuration(proxyBeanMethods = false) -@ConditionalOnProperty(prefix = "app.messaging.admin", name = "enabled", havingValue = "true") +@ConditionalOnProperty( + prefix = MessagingSettings.PREFIX + ".admin", + name = "enabled", + havingValue = "true") public class MessagingAdminAutoConfiguration { /** diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationCompiler.java b/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationCompiler.java index ca76445a..dca2d398 100644 --- a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationCompiler.java +++ b/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationCompiler.java @@ -4,7 +4,6 @@ import dev.caskeleton.messaging.api.ContentType; import dev.caskeleton.messaging.api.MessageType; import dev.caskeleton.messaging.api.destination.DestinationName; import dev.caskeleton.messaging.api.error.MessagingConfigurationException; -import dev.caskeleton.messaging.kafka.KafkaBrokerProfile; import dev.caskeleton.messaging.policy.ConsumerPolicy; import dev.caskeleton.messaging.policy.DeadLetterPolicy; import dev.caskeleton.messaging.policy.DestinationProfile; @@ -13,7 +12,6 @@ import dev.caskeleton.messaging.policy.PhysicalDestination; import dev.caskeleton.messaging.policy.ProducerPolicy; import dev.caskeleton.messaging.policy.RetryPolicy; import dev.caskeleton.messaging.policy.SchemaPolicy; -import dev.caskeleton.messaging.rabbit.RabbitBrokerProfile; import dev.caskeleton.messaging.security.BrokerCredentialProfile; import dev.caskeleton.messaging.security.BrokerSecurityProfile; import dev.caskeleton.messaging.security.DestinationAccessPolicy; @@ -68,20 +66,7 @@ public final class MessagingConfigurationCompiler { */ public CompiledMessagingConfiguration compile() { Map brokers = settings.getBrokers(); - List kafka = new ArrayList<>(); - List rabbit = new ArrayList<>(); - brokers.forEach( - (name, broker) -> { - switch (familyOf(name, broker)) { - case BrokerSettings.KAFKA -> kafka.add(toKafkaProfile(name, broker)); - case BrokerSettings.RABBITMQ -> rabbit.add(toRabbitProfile(name, broker)); - default -> - throw configurationError( - key("brokers", name, "type"), - "'%s' is not a broker family this platform binds; use '%s' or '%s'" - .formatted(broker.type(), BrokerSettings.KAFKA, BrokerSettings.RABBITMQ)); - } - }); + brokers.forEach(MessagingConfigurationCompiler::validateBrokerSettings); List destinations = new ArrayList<>(); settings @@ -93,7 +78,7 @@ public final class MessagingConfigurationCompiler { .getSecurity() .forEach((name, entry) -> security.add(toSecurityProfile(name, entry, brokers))); - return new CompiledMessagingConfiguration(destinations, kafka, rabbit, security); + return new CompiledMessagingConfiguration(destinations, brokers, security); } private static String familyOf(String name, BrokerSettings broker) { @@ -106,49 +91,30 @@ public final class MessagingConfigurationCompiler { return broker.type().toLowerCase(Locale.ROOT); } - private static KafkaBrokerProfile toKafkaProfile(String name, BrokerSettings broker) { - if (broker.bootstrapServers().isEmpty()) { - throw configurationError( - key("brokers", name, "bootstrap-servers"), - "a Kafka broker needs at least one address; a client with none defaults to " - + "localhost:9092 and fails at the first publish rather than at startup"); + private static void validateBrokerSettings(String name, BrokerSettings broker) { + switch (familyOf(name, broker)) { + case BrokerSettings.KAFKA -> { + if (broker.bootstrapServers().isEmpty()) { + throw configurationError( + key("brokers", name, "bootstrap-servers"), + "a Kafka broker needs at least one address; a client with none defaults to " + + "localhost:9092 and fails at the first publish rather than at startup"); + } + } + case BrokerSettings.RABBITMQ -> { + if (broker.addresses().isEmpty()) { + throw configurationError( + key("brokers", name, "addresses"), + "a RabbitMQ broker needs at least one address; a client with none defaults to " + + "localhost and connects as guest"); + } + } + default -> + throw configurationError( + key("brokers", name, "type"), + "'%s' is not a broker family this platform binds; use '%s' or '%s'" + .formatted(broker.type(), BrokerSettings.KAFKA, BrokerSettings.RABBITMQ)); } - return new KafkaBrokerProfile( - name, - broker.stable(), - broker.production(), - broker.bootstrapServers(), - broker.enableIdempotence(), - broker.acks(), - broker.maxInFlightRequestsPerConnection(), - broker.deliveryTimeout(), - broker.enableAutoCommit(), - broker.consumerGroup(), - broker.tlsEnabled(), - broker.authenticationEnabled()); - } - - private static RabbitBrokerProfile toRabbitProfile(String name, BrokerSettings broker) { - if (broker.addresses().isEmpty()) { - throw configurationError( - key("brokers", name, "addresses"), - "a RabbitMQ broker needs at least one address; a client with none defaults to " - + "localhost and connects as guest"); - } - return new RabbitBrokerProfile( - name, - broker.stable(), - broker.production(), - broker.addresses(), - broker.publisherConfirms(), - broker.publisherReturns(), - broker.mandatory(), - broker.confirmTimeout(), - broker.autoAck(), - broker.prefetch(), - broker.quorumQueues(), - broker.tlsEnabled(), - broker.authenticationEnabled()); } private DestinationProfile toProfile( diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationKeyValidator.java b/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationKeyValidator.java index fdc27795..84e9baa7 100644 --- a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationKeyValidator.java +++ b/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationKeyValidator.java @@ -108,6 +108,13 @@ public final class MessagingConfigurationKeyValidator implements InitializingBea } }); + for (String key : keysUnder(MessagingSettings.PREFIX + ".admin.")) { + String leaf = key.substring((MessagingSettings.PREFIX + ".admin.").length()); + if (!"enabled".equals(leaf)) { + rejected.add("%s binds nothing; admin entries accept [enabled]".formatted(key)); + } + } + if (rejected.isEmpty()) { return; } diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingCoreAutoConfiguration.java b/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingCoreAutoConfiguration.java index 89c155bd..81b0602a 100644 --- a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingCoreAutoConfiguration.java +++ b/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingCoreAutoConfiguration.java @@ -265,6 +265,28 @@ public class MessagingCoreAutoConfiguration { return new CardinalityGuard(); } + /** + * Binds the platform observation seam to Micrometer when a registry is available. + * + *

      Narrow tests and non-observed adopters may omit Micrometer entirely. A normal Boot runtime + * with Actuator contributes a registry, in which case publish outcomes must not fall back to the + * no-op observation constructor. + * + * @param registry the Micrometer registry + * @param guard the bounded-cardinality guard + * @param redactor the diagnostics redactor + * @return the messaging metrics binding + */ + @Bean + @ConditionalOnBean(io.micrometer.core.instrument.MeterRegistry.class) + @ConditionalOnMissingBean(dev.caskeleton.messaging.observation.MessagingObservation.class) + public dev.caskeleton.messaging.observation.MessagingObservation messagingObservation( + io.micrometer.core.instrument.MeterRegistry registry, + CardinalityGuard guard, + MessagingRedactor redactor) { + return new dev.caskeleton.messaging.observation.MessagingMetrics(registry, guard, redactor); + } + /** * Returns the blocking publish facade. * @@ -442,9 +464,16 @@ public class MessagingCoreAutoConfiguration { dev.caskeleton.messaging.schema.MessageCodecRegistry codecs, dev.caskeleton.messaging.policy.MessagingAdmissionController admission, MessagingRuntimeRegistry runtimes, - dev.caskeleton.messaging.transport.MessagingTransport transport) { + dev.caskeleton.messaging.transport.MessagingTransport transport, + ObjectProvider observation) { + dev.caskeleton.messaging.observation.MessagingObservation configured = + observation.getIfAvailable(); + if (configured == null) { + return new dev.caskeleton.messaging.runtime.DefaultMessagePublisher( + destinations, access, codecs, admission, runtimes, transport); + } return new dev.caskeleton.messaging.runtime.DefaultMessagePublisher( - destinations, access, codecs, admission, runtimes, transport); + destinations, access, codecs, admission, runtimes, transport, System::nanoTime, configured); } /** @@ -462,7 +491,8 @@ public class MessagingCoreAutoConfiguration { @Bean public org.springframework.beans.factory.InitializingBean messagingRuntimeInstallation( MessagingRuntimeRegistry runtimes, - ObjectProvider transport) { + ObjectProvider transport, + CompiledMessagingConfiguration compiled) { return () -> { dev.caskeleton.messaging.transport.MessagingTransport selected = transport.getIfAvailable(); if (selected == null) { @@ -472,9 +502,49 @@ public class MessagingCoreAutoConfiguration { // without a transport — and demanding one here would refuse that. return; } + + String runtimeName = logicalRuntimeName(selected, compiled); runtimes.install( new dev.caskeleton.messaging.runtime.TransportMessagingRuntime( - selected.brokerName(), 1L, selected)); + runtimeName, selected.generation(), selected)); }; } + + private static String logicalRuntimeName( + dev.caskeleton.messaging.transport.MessagingTransport selected, + CompiledMessagingConfiguration compiled) { + String configuredFamily = + switch (selected.brokerName()) { + case "kafka" -> BrokerSettings.KAFKA; + case "rabbit" -> BrokerSettings.RABBITMQ; + default -> selected.brokerName(); + }; + java.util.List configuredNames = + compiled.brokers().entrySet().stream() + .filter( + entry -> + entry.getValue().type() != null + && entry.getValue().type().equalsIgnoreCase(configuredFamily)) + .map(java.util.Map.Entry::getKey) + .sorted() + .toList(); + + if (configuredNames.isEmpty()) { + // Backward compatibility for applications that declare all profiles as beans and therefore + // have no app.messaging.brokers entries. Their destination profiles historically named the + // transport family directly. + return selected.brokerName(); + } + if (configuredNames.size() != 1) { + throw new IllegalStateException( + "the selected " + + selected.brokerName() + + " transport has one client/runtime but app.messaging.brokers declares " + + configuredNames.size() + + " logical brokers " + + configuredNames + + "; configure exactly one logical broker for the selected transport"); + } + return configuredNames.getFirst(); + } } diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingPlatformRootAutoConfiguration.java b/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingPlatformRootAutoConfiguration.java index a5880351..8e3b8163 100644 --- a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingPlatformRootAutoConfiguration.java +++ b/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingPlatformRootAutoConfiguration.java @@ -22,7 +22,8 @@ import org.springframework.context.annotation.Import; * *

      {@code app.messaging.enabled=false} means no beans, no clients, no threads, and no bound * detail namespace. {@code MessagingStarterOffContractTest} holds that against a full context - * including this starter's imports and the vendor auto-configurations Spring Boot would contribute. + * including this starter's owned imports. Vendor auto-configuration is verified in its own runtime + * lanes. */ @AutoConfiguration @ConditionalOnProperty(prefix = MessagingSettings.PREFIX, name = "enabled", havingValue = "true") diff --git a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingProviderSelection.java b/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingProviderSelection.java index c93129dc..789e1a5e 100644 --- a/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingProviderSelection.java +++ b/src/messaging/messaging-spring-boot-starter/src/main/java/dev/caskeleton/messaging/autoconfigure/MessagingProviderSelection.java @@ -43,10 +43,10 @@ public class MessagingProviderSelection { "rabbit", "com.rabbitmq.client.Channel"); /** Broker id to the configuration that assembles it. */ - static final Map> PROVIDER_CONFIGURATIONS = + static final Map PROVIDER_CONFIGURATIONS = Map.of( - "kafka", KafkaMessagingAutoConfiguration.class, - "rabbit", RabbitMessagingAutoConfiguration.class); + "kafka", "dev.caskeleton.messaging.autoconfigure.KafkaMessagingAutoConfiguration", + "rabbit", "dev.caskeleton.messaging.autoconfigure.RabbitMessagingAutoConfiguration"); /** * Broker ids that ship without a {@code MessagingTransport}, and why. @@ -144,7 +144,7 @@ public class MessagingProviderSelection { @Override public String[] selectImports(AnnotationMetadata importingClassMetadata) { - return new String[] {PROVIDER_CONFIGURATIONS.get(selectedBroker(environment)).getName()}; + return new String[] {PROVIDER_CONFIGURATIONS.get(selectedBroker(environment))}; } } } diff --git a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/BatchPublisherTest.java b/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/BatchPublisherTest.java index 625e9045..ee8855af 100644 --- a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/BatchPublisherTest.java +++ b/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/BatchPublisherTest.java @@ -136,6 +136,18 @@ class BatchPublisherTest { .join(); } + @Test + void closingTheBatchPublisherStopsItsDeadlineScheduler() { + var deadlines = new java.util.concurrent.ScheduledThreadPoolExecutor(1); + var publisher = + new DefaultBatchMessagePublisher( + scripted(List.of(Outcome.CONFIRM), new ArrayList<>()), () -> NOW, deadlines); + + publisher.close(); + + assertThat(deadlines.isShutdown()).isTrue(); + } + @Test void everyEntryGetsItsOwnResultKeyedByIndex() { BatchPublishResult result = diff --git a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingAutoConfigurationTest.java b/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingAutoConfigurationTest.java index dcb22b1b..ba6b2c71 100644 --- a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingAutoConfigurationTest.java +++ b/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingAutoConfigurationTest.java @@ -55,6 +55,49 @@ class MessagingAutoConfigurationTest { .hasSingleBean(GracefulShutdownCoordinator.class)); } + @Test + void installsSelectedTransportUnderConfiguredLogicalBrokerName() { + new ApplicationContextRunner() + .withConfiguration(AutoConfigurations.of(MessagingCoreAutoConfiguration.class)) + .withUserConfiguration( + PublisherConfiguration.class, LogicalBrokerRuntimeConfiguration.class) + .withPropertyValues( + "app.messaging.brokers.kafka-primary.type=kafka", + "app.messaging.brokers.kafka-primary.bootstrap-servers[0]=broker-1:9092") + .run( + context -> { + assertThat(context).hasNotFailed(); + dev.caskeleton.messaging.transport.MessagingRuntimeRegistry runtimes = + context.getBean( + dev.caskeleton.messaging.transport.MessagingRuntimeRegistry.class); + + try (dev.caskeleton.messaging.transport.MessagingRuntimeLease lease = + runtimes.acquire("kafka-primary")) { + assertThat(lease.runtime().brokerName()).isEqualTo("kafka-primary"); + assertThat(lease.runtime().transport().brokerName()).isEqualTo("kafka"); + } + }); + } + + @Test + void multipleLogicalBrokersFailInsteadOfSharingOnePhysicalTransport() { + new ApplicationContextRunner() + .withConfiguration(AutoConfigurations.of(MessagingCoreAutoConfiguration.class)) + .withUserConfiguration( + PublisherConfiguration.class, LogicalBrokerRuntimeConfiguration.class) + .withPropertyValues( + "app.messaging.brokers.kafka-primary.type=kafka", + "app.messaging.brokers.kafka-primary.bootstrap-servers[0]=broker-1:9092", + "app.messaging.brokers.kafka-secondary.type=kafka", + "app.messaging.brokers.kafka-secondary.bootstrap-servers[0]=broker-2:9092") + .run( + context -> + assertThat(context) + .hasFailed() + .getFailure() + .hasMessageContaining("exactly one logical broker")); + } + @Test void experimentalAdaptersAndTheBridgeAreOffByDefault() { runner.run( @@ -116,6 +159,47 @@ class MessagingAutoConfigurationTest { .run(context -> assertThat(context).hasFailed()); } + @Configuration(proxyBeanMethods = false) + static class LogicalBrokerRuntimeConfiguration { + + @Bean + dev.caskeleton.messaging.transport.MessagingTransport messagingTransport() { + return new dev.caskeleton.messaging.transport.MessagingTransport() { + @Override + public java.util.concurrent.CompletionStage< + dev.caskeleton.messaging.transport.TransportPublishResult> + publish(dev.caskeleton.messaging.transport.TransportPublishRequest request) { + throw new UnsupportedOperationException("not used"); + } + + @Override + public dev.caskeleton.messaging.transport.TransportConsumerRegistration register( + dev.caskeleton.messaging.transport.TransportConsumerSpec spec) { + throw new UnsupportedOperationException("not used"); + } + + @Override + public dev.caskeleton.messaging.api.destination.DestinationCapabilities capabilities( + DestinationName destination) { + throw new UnsupportedOperationException("not used"); + } + + @Override + public String brokerName() { + return "kafka"; + } + + @Override + public long generation() { + return 1L; + } + + @Override + public void close() {} + }; + } + } + /** Supplies the publisher the facades and orchestrator depend on. */ @Configuration(proxyBeanMethods = false) static class PublisherConfiguration { @@ -177,7 +261,7 @@ class MessagingAutoConfigurationTest { base.kind(), base.physical(), base.schema(), - base.deliveryGuarantee(), + DeliveryGuarantee.AT_MOST_ONCE, base.orderingScope(), base.externalSideEffectGuarantee(), base.producer(), diff --git a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationBindingTest.java b/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationBindingTest.java index bea9b563..437ca3f8 100644 --- a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationBindingTest.java +++ b/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingConfigurationBindingTest.java @@ -67,18 +67,15 @@ class MessagingConfigurationBindingTest { CompiledMessagingConfiguration compiled = context.getBean(CompiledMessagingConfiguration.class); - assertThat(compiled.kafkaBrokers()) - .singleElement() - .satisfies( - broker -> { - assertThat(broker.broker()).isEqualTo("kafka-primary"); - assertThat(broker.bootstrapServers()) - .containsExactly("broker-1:9093", "broker-2:9093"); - assertThat(broker.enableAutoCommit()).isFalse(); - }); - assertThat(compiled.rabbitBrokers()) - .singleElement() - .satisfies(broker -> assertThat(broker.quorumQueues()).isTrue()); + assertThat(compiled.brokers()).containsKeys("kafka-primary", "rabbit-primary"); + BrokerSettings kafka = compiled.brokers().get("kafka-primary"); + assertThat(kafka.type()).isEqualTo(BrokerSettings.KAFKA); + assertThat(kafka.bootstrapServers()) + .containsExactly("broker-1:9093", "broker-2:9093"); + assertThat(kafka.enableAutoCommit()).isFalse(); + BrokerSettings rabbit = compiled.brokers().get("rabbit-primary"); + assertThat(rabbit.type()).isEqualTo(BrokerSettings.RABBITMQ); + assertThat(rabbit.quorumQueues()).isTrue(); assertThat(compiled.security()) .singleElement() .satisfies( @@ -95,6 +92,20 @@ class MessagingConfigurationBindingTest { }); } + @Test + void aTypoInsideTheAdminSectionFailsStartupNamingTheKey() { + runner + .withPropertyValues(minimal()) + .withPropertyValues("app.messaging.admin.enable=true") + .run( + context -> + assertThat(context) + .hasFailed() + .getFailure() + .hasMessageContaining("app.messaging.admin.enable") + .hasMessageContaining("enabled")); + } + @Test void aTypoInsideABoundSectionFailsStartupNamingTheKey() { runner @@ -263,6 +274,7 @@ class MessagingConfigurationBindingTest { "app.messaging.destinations.order-events.kind=EVENT_STREAM", "app.messaging.destinations.order-events.physical.topic=order.events.v1", "app.messaging.destinations.order-events.schema.message-types[0]=order.created", + "app.messaging.destinations.order-events.guarantees.delivery=AT_MOST_ONCE", }; } diff --git a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingMigrationNamespaceTest.java b/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingMigrationNamespaceTest.java new file mode 100644 index 00000000..6cd3e521 --- /dev/null +++ b/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingMigrationNamespaceTest.java @@ -0,0 +1,79 @@ +package dev.caskeleton.messaging.autoconfigure; + +import static org.assertj.core.api.Assertions.assertThat; + +import java.io.IOException; +import java.net.JarURLConnection; +import java.net.URL; +import java.util.ArrayList; +import java.util.Enumeration; +import java.util.HashSet; +import java.util.List; +import java.util.Set; +import java.util.regex.Matcher; +import java.util.regex.Pattern; +import org.junit.jupiter.api.Test; + +/** + * Keeps every messaging reliability migration in one collision-free Flyway version namespace. + * + *

      The starter ships both JDBC reliability modules, so this test inspects the same combined + * runtime classpath an adopter receives rather than certifying each module in isolation. + */ +class MessagingMigrationNamespaceTest { + + private static final String LOCATION = "db/migration/messaging"; + private static final Pattern VERSIONED = Pattern.compile("V(\\d+)__.+\\.sql"); + + @Test + void combinedMessagingClasspathHasUniqueReservedFlywayVersions() throws Exception { + List migrations = migrationsOnCombinedClasspath(); + + assertThat(migrations) + .as("both messaging JDBC modules must contribute migrations to the assembled starter") + .hasSizeGreaterThanOrEqualTo(5); + + Set versions = new HashSet<>(); + for (String migration : migrations) { + Matcher match = VERSIONED.matcher(migration); + assertThat(match.matches()).as("%s must be a versioned Flyway migration", migration).isTrue(); + long version = Long.parseLong(match.group(1)); + assertThat(version) + .as("%s must stay in the messaging-reserved version range", migration) + .isBetween(1000L, 1999L); + assertThat(versions.add(version)) + .as("Flyway version %s is duplicated across the assembled messaging modules", version) + .isTrue(); + } + } + + private static List migrationsOnCombinedClasspath() throws IOException { + List names = new ArrayList<>(); + Enumeration roots = + MessagingMigrationNamespaceTest.class.getClassLoader().getResources(LOCATION); + while (roots.hasMoreElements()) { + URL root = roots.nextElement(); + if ("file".equals(root.getProtocol())) { + java.io.File[] files = + new java.io.File(java.net.URI.create(root.toString())) + .listFiles((dir, name) -> name.endsWith(".sql")); + if (files != null) { + for (java.io.File file : files) { + names.add(file.getName()); + } + } + } else if ("jar".equals(root.getProtocol())) { + JarURLConnection connection = (JarURLConnection) root.openConnection(); + try (java.util.jar.JarFile jar = connection.getJarFile()) { + jar.stream() + .map(java.util.jar.JarEntry::getName) + .filter(name -> name.startsWith(LOCATION + "/")) + .filter(name -> name.endsWith(".sql")) + .map(name -> name.substring(name.lastIndexOf('/') + 1)) + .forEach(names::add); + } + } + } + return names.stream().sorted().toList(); + } +} diff --git a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingOutboxRelayLifecycleTest.java b/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingOutboxRelayLifecycleTest.java index 4f283df8..6527539b 100644 --- a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingOutboxRelayLifecycleTest.java +++ b/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingOutboxRelayLifecycleTest.java @@ -133,21 +133,11 @@ class MessagingOutboxRelayLifecycleTest { throw new UnsupportedOperationException("not used by this test"); } - @Override - public void markPublished(MessageId messageId, Instant now) { - throw new UnsupportedOperationException("not used by this test"); - } - @Override public OutboxTransitionResult markPublished(OutboxLease lease, Instant now) { throw new UnsupportedOperationException("not used by this test"); } - @Override - public void markAmbiguous(MessageId messageId, String failureCode, Instant now) { - throw new UnsupportedOperationException("not used by this test"); - } - @Override public OutboxTransitionResult markAmbiguous( OutboxLease lease, String failureCode, Instant now) { @@ -165,21 +155,11 @@ class MessagingOutboxRelayLifecycleTest { throw new UnsupportedOperationException("not used by this test"); } - @Override - public void markFailed(MessageId messageId, String failureCode, Instant now) { - throw new UnsupportedOperationException("not used by this test"); - } - @Override public OutboxTransitionResult markFailed(OutboxLease lease, String failureCode, Instant now) { throw new UnsupportedOperationException("not used by this test"); } - @Override - public void releaseLease(MessageId messageId) { - throw new UnsupportedOperationException("not used by this test"); - } - @Override public OutboxTransitionResult releaseLease(OutboxLease lease) { throw new UnsupportedOperationException("not used by this test"); diff --git a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingStarterOffContractTest.java b/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingStarterOffContractTest.java index 2d4f7c4f..033fb0dd 100644 --- a/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingStarterOffContractTest.java +++ b/src/messaging/messaging-spring-boot-starter/src/test/java/dev/caskeleton/messaging/autoconfigure/MessagingStarterOffContractTest.java @@ -5,9 +5,9 @@ import static org.assertj.core.api.Assertions.assertThat; import dev.caskeleton.messaging.api.MessageEnvelope; import dev.caskeleton.messaging.api.destination.MessageDestination; import dev.caskeleton.messaging.api.publish.MessagePublisher; -import dev.caskeleton.messaging.schema.EncodedMessagePublisher; import dev.caskeleton.messaging.api.publish.PublishOptions; import dev.caskeleton.messaging.api.publish.PublishResult; +import dev.caskeleton.messaging.schema.EncodedMessagePublisher; import java.util.Set; import java.util.concurrent.CompletionStage; import java.util.stream.Collectors; @@ -180,18 +180,51 @@ class MessagingStarterOffContractTest { context -> { assertThat(context) .as( - "this asserted the opposite, with the note that C3 would invert it rather than " - + "delete it. Every policy bean was in place and the platform still could " - + "not publish: no configuration produced a MessagePublisher, so " - + "DeadLetterOrchestrator had nothing to depend on. DefaultMessagePublisher " - + "existed in messaging-runtime-core the whole time — the starter did not " - + "depend on that leaf.") + "this asserted the opposite, with the note that C3 would invert it rather" + + " than delete it. Every policy bean was in place and the platform still" + + " could not publish: no configuration produced a MessagePublisher, so" + + " DeadLetterOrchestrator had nothing to depend on." + + " DefaultMessagePublisher existed in messaging-runtime-core the whole" + + " time — the starter did not depend on that leaf.") .hasNotFailed(); assertThat(context).hasSingleBean(MessagePublisher.class); assertThat(context).hasSingleBean(EncodedMessagePublisher.class); }); } + @Test + @DisplayName("a selected publisher uses the Micrometer observation bean when a registry exists") + void selectedPublisherIsObserved() { + runner + .withBean( + io.micrometer.core.instrument.MeterRegistry.class, + io.micrometer.core.instrument.simple.SimpleMeterRegistry::new) + .withPropertyValues( + "app.messaging.enabled=true", + "app.messaging.broker=kafka", + "spring.kafka.bootstrap-servers=localhost:9092") + .run( + context -> { + assertThat(context) + .hasSingleBean(dev.caskeleton.messaging.observation.MessagingObservation.class); + Object publisher = context.getBean(MessagePublisher.class); + assertThat(publisher) + .isInstanceOf(dev.caskeleton.messaging.runtime.DefaultMessagePublisher.class); + + try { + java.lang.reflect.Field observation = + publisher.getClass().getDeclaredField("observation"); + observation.setAccessible(true); + assertThat(observation.get(publisher)) + .isSameAs( + context.getBean( + dev.caskeleton.messaging.observation.MessagingObservation.class)); + } catch (ReflectiveOperationException failure) { + throw new LinkageError(failure.getMessage(), failure); + } + }); + } + @Test @DisplayName("a selected broker with no address fails at startup, not at the first publish") void aSelectedBrokerWithNoAddressFailsAtStartup() { diff --git a/src/messaging/messaging-spring-cloud-stream-bridge/build.gradle b/src/messaging/messaging-spring-cloud-stream-bridge/build.gradle index e9bd8ef0..d1045677 100644 --- a/src/messaging/messaging-spring-cloud-stream-bridge/build.gradle +++ b/src/messaging/messaging-spring-cloud-stream-bridge/build.gradle @@ -7,5 +7,4 @@ dependencies { api project(':messaging:messaging-policy') api project(':messaging:messaging-transport-spi') - implementation 'org.springframework:spring-context' } diff --git a/src/messaging/messaging-spring-cloud-stream-bridge/gradle.lockfile b/src/messaging/messaging-spring-cloud-stream-bridge/gradle.lockfile index 4c95da8a..e2c95854 100644 --- a/src/messaging/messaging-spring-cloud-stream-bridge/gradle.lockfile +++ b/src/messaging/messaging-spring-cloud-stream-bridge/gradle.lockfile @@ -29,12 +29,9 @@ com.puppycrawl.tools:checkstyle:13.5.0=checkstyle commons-beanutils:commons-beanutils:1.11.0=checkstyle commons-collections:commons-collections:3.2.2=checkstyle commons-io:commons-io:2.21.0=spotbugs -commons-logging:commons-logging:1.3.6=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath info.picocli:picocli:4.7.7=checkstyle io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,testAnnotationProcessor io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,testAnnotationProcessor -io.micrometer:micrometer-commons:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.micrometer:micrometer-observation:1.16.7=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath javax.inject:javax.inject:1=annotationProcessor,testAnnotationProcessor jaxen:jaxen:2.0.6=spotbugs net.bytebuddy:byte-buddy:1.17.8=testCompileClasspath,testRuntimeClasspath @@ -61,7 +58,7 @@ org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle org.codehaus.plexus:plexus-utils:3.3.0=checkstyle org.dom4j:dom4j:2.2.0=spotbugs org.javassist:javassist:3.28.0-GA=checkstyle -org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath +org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,testAnnotationProcessor,testCompileClasspath org.junit.jupiter:junit-jupiter-api:6.0.3=testCompileClasspath,testRuntimeClasspath org.junit.jupiter:junit-jupiter-engine:6.0.3=testRuntimeClasspath org.junit.jupiter:junit-jupiter-params:6.0.3=testCompileClasspath,testRuntimeClasspath @@ -83,10 +80,5 @@ org.reflections:reflections:0.10.2=checkstyle org.slf4j:slf4j-api:2.0.18=spotbugs,spotbugsSlf4j org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j org.slf4j:slf4j-simple:2.0.18=checkstyle -org.springframework:spring-aop:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-beans:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-context:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-core:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-expression:7.0.9=compileClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs -empty= +empty=compileClasspath,runtimeClasspath diff --git a/src/messaging/messaging-spring-cloud-stream-bridge/src/main/java/dev/caskeleton/messaging/streambridge/SpringCloudStreamPublisherBridge.java b/src/messaging/messaging-spring-cloud-stream-bridge/src/main/java/dev/caskeleton/messaging/streambridge/SpringCloudStreamPublisherBridge.java index 7e2b68d4..059144fe 100644 --- a/src/messaging/messaging-spring-cloud-stream-bridge/src/main/java/dev/caskeleton/messaging/streambridge/SpringCloudStreamPublisherBridge.java +++ b/src/messaging/messaging-spring-cloud-stream-bridge/src/main/java/dev/caskeleton/messaging/streambridge/SpringCloudStreamPublisherBridge.java @@ -15,7 +15,14 @@ import java.util.Optional; import java.util.concurrent.ConcurrentHashMap; /** - * Sends through a Spring Cloud Stream output binding and reports what that actually proves. + * Framework-neutral publish evidence bridge for a future Spring Cloud Stream adapter. + * + *

      Despite the historical module/class name, this type does not itself depend on Spring Cloud + * Stream and does not auto-configure {@code StreamBridge}. A product integrating Spring Cloud + * Stream supplies the {@link ChannelSend} seam explicitly. Keeping that limitation in the type + * contract prevents this module from being mistaken for a shipped Spring Cloud Stream integration. + * + *

      Sends through a Spring Cloud Stream output binding and reports what that actually proves. * *

      The result is deliberately {@code AMBIGUOUS} rather than {@code CONFIRMED}. A Stream {@code * send} returns a boolean from the message channel — it says the binder accepted the message, not diff --git a/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/BrokerCertificationEvidence.java b/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/BrokerCertificationEvidence.java index ce026067..360e69c1 100644 --- a/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/BrokerCertificationEvidence.java +++ b/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/BrokerCertificationEvidence.java @@ -14,9 +14,9 @@ import java.util.Objects; * then tells an adopter that connection-cut and confirm-timeout are certified when neither has ever * run. * - *

      This record is what a lane emits after running. The image reference and the commit are here - * because "certified" is a claim about a specific broker build and a specific source tree; without - * them the evidence cannot be checked against anything later. + *

      This record is what a lane emits after running. The image reference, commit and observation + * time are provenance: they identify the run for audit/replay. The certification equality gate + * compares the behavioral claim fields and deliberately does not use commit/time as freshness keys. * *

      {@link #toJson()} and {@link #fromJson(String)} are the same statement in both directions: the * certification lane writes a line per scenario it proved and the compatibility matrix reads those diff --git a/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/BrokerFailureMatrix.java b/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/BrokerFailureMatrix.java index acb7d50a..5f27cdc1 100644 --- a/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/BrokerFailureMatrix.java +++ b/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/BrokerFailureMatrix.java @@ -86,6 +86,26 @@ public final class BrokerFailureMatrix { .anyMatch(scenario -> coverageOf(adapter, scenario) == Coverage.LIVE_BROKER); } + /** + * Reports whether every scenario is backed by live-broker evidence or an explicitly approved gap. + * + *

      This is the Stable certification predicate. A single live scenario is not certification, and + * an absent scenario is not silently converted into an approved exception. + * + * @param adapter the adapter module name + * @param approvedGaps gaps reviewed and accepted independently of this matrix + * @return true when every scenario is explained by evidence or an approved gap + */ + public boolean hasCertificationCoverage( + String adapter, java.util.Set approvedGaps) { + Objects.requireNonNull(approvedGaps, "approvedGaps must not be null"); + return NetworkFaultScenario.all().stream() + .allMatch( + scenario -> + coverageOf(adapter, scenario) == Coverage.LIVE_BROKER + || approvedGaps.contains(scenario)); + } + /** * Reports whether an adapter covers every scenario. * diff --git a/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/CertifiedEvidence.java b/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/CertifiedEvidence.java index 6d7f614f..423bd4be 100644 --- a/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/CertifiedEvidence.java +++ b/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/CertifiedEvidence.java @@ -4,6 +4,7 @@ import java.io.IOException; import java.io.InputStream; import java.nio.charset.StandardCharsets; import java.util.List; +import java.util.Map; import java.util.Set; /** @@ -33,6 +34,9 @@ public final class CertifiedEvidence { private static final List RECORDED = load(); + private static final Map> APPROVED_GAPS = + Map.of("messaging-kafka", Set.of(NetworkFaultScenario.CONNECTION_REFUSED)); + private CertifiedEvidence() {} /** @@ -44,6 +48,17 @@ public final class CertifiedEvidence { return RECORDED; } + /** + * Returns gaps that were deliberately accepted after review rather than inferred from missing + * evidence. + * + * @param adapter the adapter module name + * @return the explicit approved gaps for that adapter + */ + public static Set approvedGaps(String adapter) { + return APPROVED_GAPS.getOrDefault(adapter, Set.of()); + } + /** * Returns the scenarios an adapter has no evidence for. * diff --git a/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/CompatibilityMatrix.java b/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/CompatibilityMatrix.java index 0eb721b9..13d74864 100644 --- a/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/CompatibilityMatrix.java +++ b/src/messaging/messaging-testkit/src/main/java/dev/caskeleton/messaging/testkit/CompatibilityMatrix.java @@ -58,7 +58,8 @@ public final class CompatibilityMatrix { * @return true when {@link CertifiedEvidence} has live-broker evidence for this adapter */ public boolean hasLiveBrokerCertification() { - return BrokerFailureMatrix.from(CertifiedEvidence.recorded()).hasLiveBrokerCoverage(adapter); + return BrokerFailureMatrix.from(CertifiedEvidence.recorded()) + .hasCertificationCoverage(adapter, CertifiedEvidence.approvedGaps(adapter)); } public Entry { diff --git a/src/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/CompatibilityMatrixTest.java b/src/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/CompatibilityMatrixTest.java index c2bd66db..f126796a 100644 --- a/src/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/CompatibilityMatrixTest.java +++ b/src/messaging/messaging-testkit/src/test/java/dev/caskeleton/messaging/testkit/CompatibilityMatrixTest.java @@ -46,17 +46,27 @@ class CompatibilityMatrixTest { } @Test - void aCertificationClaimCannotBeMadeWithoutEvidence() { + void oneLiveScenarioCannotSatisfyAStableCertification() { + String adapter = "messaging-partial"; + BrokerFailureMatrix partial = + new BrokerFailureMatrix() + .record( + adapter, + NetworkFaultScenario.all().get(0), + BrokerFailureMatrix.Coverage.LIVE_BROKER); + + assertThat(partial.hasCertificationCoverage(adapter, java.util.Set.of())).isFalse(); + } + + @Test + void everyStableAdapterHasOnlyExplicitlyApprovedEvidenceGaps() { assertThat(CompatibilityMatrix.entries().values()) + .filteredOn(entry -> entry.tier() == CompatibilityMatrix.Tier.STABLE) .allSatisfy( entry -> - assertThat(entry.hasLiveBrokerCertification()) - .as( - "%s claims certification, so a lane must have produced evidence", - entry.adapter()) - .isEqualTo( - BrokerFailureMatrix.from(CertifiedEvidence.recorded()) - .hasLiveBrokerCoverage(entry.adapter()))); + assertThat(CertifiedEvidence.approvedGaps(entry.adapter())) + .containsExactlyInAnyOrderElementsOf( + CertifiedEvidence.knownGaps(entry.adapter()))); } @Test diff --git a/src/optional-platforms/build.gradle b/src/optional-platforms/build.gradle index 4604ffbc..7b10c142 100644 --- a/src/optional-platforms/build.gradle +++ b/src/optional-platforms/build.gradle @@ -1,8 +1,18 @@ +plugins { + id 'ca.architecture' +} + ext.sourceRevision = providers.gradleProperty('gitRevision') .orElse(providers.environmentVariable('GIT_SHA')) .orElse(providers.environmentVariable('GITHUB_SHA')) .getOrElse('unknown') +tasks.register('resolveAndLockAll') { + group = 'build setup' + description = 'Regenerates dependency locks for every optional gRPC leaf (requires --write-locks).' + dependsOn subprojects.findAll { it.childProjects.isEmpty() }.collect { "${it.path}:resolveAndLockAll" } +} + tasks.register('checkAll') { group = 'verification' description = 'Runs every gRPC optional-platform leaf check.' @@ -20,4 +30,5 @@ tasks.register('ci') { description = 'Runs the optional gRPC platform verification surface.' dependsOn tasks.named('checkAll') dependsOn tasks.named('qualityCheck') + dependsOn tasks.named('verifyCleanArchitectureDependencies') } diff --git a/src/optional-platforms/settings-gradle.lockfile b/src/optional-platforms/settings-gradle.lockfile new file mode 100644 index 00000000..709a43f7 --- /dev/null +++ b/src/optional-platforms/settings-gradle.lockfile @@ -0,0 +1,4 @@ +# This is a Gradle generated file for dependency locking. +# Manual edits can break the build and are not advised. +# This file is expected to be part of source control. +empty=incomingCatalogForLibs0 diff --git a/src/sample-portfolio/README.md b/src/sample-portfolio/README.md index 1b8a328f..9d3fda48 100644 --- a/src/sample-portfolio/README.md +++ b/src/sample-portfolio/README.md @@ -257,9 +257,9 @@ curl -X POST localhost:8080/work-logs -H 'Content-Type: application/json' -d '{ `If-Match` 가 없으면 검사를 건너뜁니다 — 스켈레톤은 권장 패턴을 보여주되 강제하지는 않습니다. `ETag`/`If-Match` 는 HTTP 전송 관심사(RFC 7232)라, 읽고-비교하는 로직을 일부러 웹 어댑터에만 두고 application/domain 은 ETag 를 전혀 보지 않게 합니다. -- **POST /worklogs**: `Idempotency-Key` 헤더는 POST 요청 표면의 일부로 받아만 둡니다. 키의 - 모양·범위·재생(replay) 의미는 별도 계약(rate-limit-idempotency)의 몫이라, 그 브랜치가 replay 를 - 배선하기 전까지는 서버가 헤더를 그냥 허용(무시)합니다. +- **POST /worklogs**: 이 예제는 멱등성을 약속하지 않습니다. 지원하지 않는 `Idempotency-Key`를 + 시그니처에 받아 놓고 무시하지 않으며, 멱등성 예시는 poster image publication 유스케이스에서 + application `IdempotencyExecutor`로 제공합니다. - **POST /worklogs:batchCreate**: AIP-136 콜론-동사 일괄 생성. **동기 = 원자적**이라 한 항목이라도 실패하면 배치 전체가 롤백되고 단일 4xx 가 납니다. 한 번에 보낼 수 있는 항목 수는 `MAX_BATCH_SIZE`(1000)로 제한하고, 넘으면 400 입니다. 요청 봉투는 `{ "requests": [ ... ] }` 형태입니다. @@ -436,16 +436,6 @@ curl -X POST localhost:8080/work-logs -H 'Content-Type: application/json' -d '{ (append 아님), `application.yml` 의 `spring.flyway.locations` 는 런타임 효과 없는 문서용일 뿐이고 실제 기준은 이 customizer 입니다. -### TestEnclosedConfigurationFilter — 테스트 중첩 @Configuration 제외 -- 테스트 클래스 안에 중첩된 `@Configuration` 을 컴포넌트 스캔에서 빼는 필터입니다. -- **문제**: `:sample-portfolio:test` 를 돌리면 테스트 클래스가 classpath 에 올라옵니다. 테스트 안 - static 중첩 `@Configuration`(예: `WorkLogAuthorizationContractTest$AuthzTestConfig`)이 평범한 - `@Configuration` 이라, 전체 컨텍스트로 부팅할 때 스캔에 발견·등록됩니다. 두 테스트 설정이 같은 이름의 - 빈(예: `clock`)을 정의하면 `BeanDefinitionOverrideException` 이 납니다(override 기본 false). -- **휴리스틱**: 바이너리 이름에 `$` 가 있고 그 바깥(enclosing) 클래스 이름이 `Test` 로 끝나면(자바 - 테스트 클래스 관례) 제외합니다. 테스트 프레임워크 의존성을 프로덕션 소스에 들이지 않고도 중첩 - 테스트 픽스처를 전부 거릅니다. - ### 분산 추적 복제본 — SampleTracingConfig / …Settings / …SampleRateResolver / …EnvironmentPostProcessor / SampleMicrometerSpanErrorRecorder - `app-bootstrap` 의 tracing 구성 루트를 샘플 전용으로 옮긴 것들입니다(위 "공통 배경" 참고). tracing 런타임(OTel/Micrometer 브리지)이 샘플 build.gradle 에 켜져 있지만, 그 빈들을 등록하는 조립 코드는 diff --git a/src/sample-portfolio/build.gradle b/src/sample-portfolio/build.gradle index 2a579774..e022752f 100644 --- a/src/sample-portfolio/build.gradle +++ b/src/sample-portfolio/build.gradle @@ -3,6 +3,7 @@ plugins { id 'ca.spring-config' id 'org.springframework.boot' id 'ca.auxiliary-source-set' + id 'java-test-fixtures' } // Fixture/sample module. Production modules must not depend on this module. @@ -22,7 +23,15 @@ tasks.named('test') { } auxiliarySourceSets { - sourceSet('posterImageMigrationTest') { compilesAgainst 'main', 'test' } + sourceSet('integrationTest') { + compilesAgainst 'main', 'testFixtures' + } + sourceSet('systemTest') { + compilesAgainst 'main', 'testFixtures' + } + sourceSet('webSystemTest') { + compilesAgainst 'main', 'testFixtures' + } } // The objectstorage adapter (runtimeOnly) pulls in software.amazon.awssdk:s3, whose version is @@ -38,6 +47,7 @@ dependencyManagement { dependencies { implementation project(':domain-core') implementation project(':application-core') + implementation project(':application-objectstorage') implementation project(':adapter:outbound:persistence-jpa') implementation project(':adapter:outbound:identifier') // Object storage adapter (filesystem default / S3-MinIO opt-in) provides the ObjectStoragePort @@ -71,16 +81,30 @@ dependencies { // (spring-boot-starter-security is already declared above; it also backs ManagementSecurityConfig.) // Property-based testing for @ValueObject invariants (registers its own JUnit Platform engine). testImplementation libs.jqwik + testImplementation libs.archunit.junit5 + + // Shared factory is compiled without leaking Testcontainers onto ordinary unit-test runtime. + testFixturesCompileOnly 'org.testcontainers:testcontainers-postgresql' + testFixturesCompileOnly 'org.springframework.boot:spring-boot' + testFixturesCompileOnly 'org.springframework.boot:spring-boot-autoconfigure' + + // Real PostgreSQL adapter/migration semantics. + integrationTestImplementation 'org.testcontainers:testcontainers-postgresql' + integrationTestImplementation 'org.testcontainers:testcontainers-junit-jupiter' + integrationTestImplementation 'org.springframework.boot:spring-boot-testcontainers' + integrationTestImplementation 'org.springframework.boot:spring-boot-data-jpa-test' + integrationTestImplementation 'org.springframework.boot:spring-boot-jpa-test' + integrationTestImplementation 'org.springframework.boot:spring-boot-jdbc-test' + integrationTestRuntimeOnly 'org.postgresql:postgresql' + + // Whole standalone application composition with a real PostgreSQL instance. + systemTestImplementation 'org.testcontainers:testcontainers-postgresql' + systemTestImplementation 'org.testcontainers:testcontainers-junit-jupiter' + systemTestImplementation 'org.springframework.boot:spring-boot-testcontainers' + systemTestRuntimeOnly 'org.postgresql:postgresql' // Real-DB integration test for the persistence adapter (disposable Postgres, real Flyway + JPA). - testImplementation 'org.testcontainers:testcontainers-postgresql' - testImplementation 'org.testcontainers:testcontainers-junit-jupiter' // @ServiceConnection supplies datasource connection details to Spring context/slice tests. - testImplementation 'org.springframework.boot:spring-boot-testcontainers' // Boot 4 split JPA/JDBC slice annotations and TestEntityManager into dedicated test modules. - testImplementation 'org.springframework.boot:spring-boot-data-jpa-test' - testImplementation 'org.springframework.boot:spring-boot-jpa-test' - testImplementation 'org.springframework.boot:spring-boot-jdbc-test' - testRuntimeOnly 'org.postgresql:postgresql' // Spring Security test support (MockMvc + @WithMockUser) for any slice tests. testImplementation 'org.springframework.security:spring-security-test' // TestRestTemplate needs RestTemplateBuilder, and spring-boot-resttestclient stopped @@ -101,7 +125,28 @@ dependencies { // convention checks after the run, and the convention supplies the fail-closed discovery this task // had no way to opt out of losing. strictTestLanes { + lane('integrationTest') { + integration() + sourceSet = 'integrationTest' + description = 'Runs sample persistence and migration contracts against real PostgreSQL.' + } + lane('systemTest') { + system() + sourceSet = 'systemTest' + description = 'Runs the standalone sample application composition against real PostgreSQL.' + } + lane('webSystemTest') { + system() + sourceSet = 'webSystemTest' + description = 'Runs focused sample HTTP contracts against a real embedded server.' + requires( + 'dev.caskeleton.sample.portfolio.adapter.inbound.web.date.DateHeaderContractTest', + 'dev.caskeleton.sample.portfolio.adapter.inbound.web.filter.VirtualThreadMdcE2ETest', + 'dev.caskeleton.sample.portfolio.adapter.inbound.web.openapi.OpenApiSnapshotTest') + } lane('openapiCheckSnapshot') { + system() + sourceSet = 'webSystemTest' description = 'OpenAPI drift gate: runtime springdoc /v3/api-docs vs the committed snapshot. ' + '-PapproveOpenApiChange regenerates the committed baseline.' requires('dev.caskeleton.sample.portfolio.adapter.inbound.web.contract.OpenApiDriftContractTest') @@ -112,9 +157,13 @@ strictTestLanes { } } +tasks.named('check') { + dependsOn tasks.named('openapiCheckSnapshot') +} + def posterImageMigrationQualification = extensions.getByName('strictQualification').register( 'posterImageMigrationTest', - sourceSets.posterImageMigrationTest, + sourceSets.integrationTest, [ 'dev.caskeleton.sample.portfolio.qualification.PosterImageIdempotencyRotationQualificationTest', 'dev.caskeleton.sample.portfolio.qualification.PosterImageRetirementQualificationTest', diff --git a/src/sample-portfolio/gradle.lockfile b/src/sample-portfolio/gradle.lockfile index a2915693..2442d559 100644 --- a/src/sample-portfolio/gradle.lockfile +++ b/src/sample-portfolio/gradle.lockfile @@ -1,338 +1,343 @@ # This is a Gradle generated file for dependency locking. # Manual edits can break the build and are not advised. # This file is expected to be part of source control. -aopalliance:aopalliance:1.0=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -biz.aQute.bnd:biz.aQute.bnd.annotation:7.1.0=compileClasspath,posterImageMigrationTestCompileClasspath,testCompileClasspath -ch.qos.logback:logback-classic:1.5.38=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -ch.qos.logback:logback-core:1.5.38=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -com.fasterxml.jackson.core:jackson-annotations:2.21=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -com.fasterxml.jackson.core:jackson-core:2.21.5=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -com.fasterxml.jackson.core:jackson-databind:2.21.5=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -com.fasterxml.jackson.dataformat:jackson-dataformat-yaml:2.21.5=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.21.5=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -com.fasterxml.jackson:jackson-bom:2.21.5=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -com.fasterxml:classmate:1.7.3=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,posterImageMigrationTestAnnotationProcessor,testAnnotationProcessor -com.github.docker-java:docker-java-api:3.7.1=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.github.docker-java:docker-java-transport-zerodep:3.7.1=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.github.docker-java:docker-java-transport:3.7.1=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.github.f4b6a3:uuid-creator:6.1.1=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,posterImageMigrationTestAnnotationProcessor,testAnnotationProcessor +aopalliance:aopalliance:1.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +biz.aQute.bnd:biz.aQute.bnd.annotation:7.1.0=compileClasspath,integrationTestCompileClasspath,posterImageMigrationTestCompileClasspath,systemTestCompileClasspath,testCompileClasspath,webSystemTestCompileClasspath +ch.qos.logback:logback-classic:1.5.38=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +ch.qos.logback:logback-core:1.5.38=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +com.fasterxml.jackson.core:jackson-annotations:2.21=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +com.fasterxml.jackson.core:jackson-core:2.21.5=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +com.fasterxml.jackson.core:jackson-databind:2.21.5=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +com.fasterxml.jackson.dataformat:jackson-dataformat-yaml:2.21.5=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.21.5=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +com.fasterxml.jackson:jackson-bom:2.21.5=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +com.fasterxml:classmate:1.7.3=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +com.github.ben-manes.caffeine:caffeine:3.2.4=annotationProcessor,integrationTestAnnotationProcessor,posterImageMigrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,webSystemTestAnnotationProcessor +com.github.docker-java:docker-java-api:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testFixturesCompileClasspath +com.github.docker-java:docker-java-transport-zerodep:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testFixturesCompileClasspath +com.github.docker-java:docker-java-transport:3.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testFixturesCompileClasspath +com.github.f4b6a3:uuid-creator:6.1.1=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +com.github.kevinstern:software-and-algorithms:1.0=annotationProcessor,integrationTestAnnotationProcessor,posterImageMigrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,webSystemTestAnnotationProcessor com.github.spotbugs:spotbugs-annotations:4.10.2=spotbugs com.github.spotbugs:spotbugs:4.10.2=spotbugs com.github.stephenc.jcip:jcip-annotations:1.0-1=spotbugs -com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,posterImageMigrationTestAnnotationProcessor,testAnnotationProcessor -com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,posterImageMigrationTestAnnotationProcessor,testAnnotationProcessor -com.google.auto:auto-common:1.2.2=annotationProcessor,posterImageMigrationTestAnnotationProcessor,testAnnotationProcessor +com.google.auto.service:auto-service-annotations:1.0.1=annotationProcessor,integrationTestAnnotationProcessor,posterImageMigrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,webSystemTestAnnotationProcessor +com.google.auto.value:auto-value-annotations:1.9=annotationProcessor,integrationTestAnnotationProcessor,posterImageMigrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,webSystemTestAnnotationProcessor +com.google.auto:auto-common:1.2.2=annotationProcessor,integrationTestAnnotationProcessor,posterImageMigrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,webSystemTestAnnotationProcessor com.google.code.findbugs:jsr305:3.0.2=checkstyle,spotbugs com.google.code.gson:gson:2.13.2=spotbugs -com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,posterImageMigrationTestAnnotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_annotations:2.38.0=compileClasspath,posterImageMigrationTestCompileClasspath,testCompileClasspath +com.google.errorprone:error_prone_annotation:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,posterImageMigrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,webSystemTestAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.38.0=compileClasspath,integrationTestCompileClasspath,posterImageMigrationTestCompileClasspath,systemTestCompileClasspath,testCompileClasspath,webSystemTestCompileClasspath com.google.errorprone:error_prone_annotations:2.41.0=spotbugs com.google.errorprone:error_prone_annotations:2.47.0=checkstyle -com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,posterImageMigrationTestAnnotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,posterImageMigrationTestAnnotationProcessor,testAnnotationProcessor -com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,posterImageMigrationTestAnnotationProcessor,testAnnotationProcessor -com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,posterImageMigrationTestAnnotationProcessor,testAnnotationProcessor -com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,posterImageMigrationTestAnnotationProcessor,testAnnotationProcessor -com.google.guava:guava:33.5.0-jre=annotationProcessor,posterImageMigrationTestAnnotationProcessor,testAnnotationProcessor +com.google.errorprone:error_prone_annotations:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,posterImageMigrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,webSystemTestAnnotationProcessor +com.google.errorprone:error_prone_check_api:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,posterImageMigrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,webSystemTestAnnotationProcessor +com.google.errorprone:error_prone_core:2.49.0=annotationProcessor,integrationTestAnnotationProcessor,posterImageMigrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,webSystemTestAnnotationProcessor +com.google.googlejavaformat:google-java-format:1.35.0=annotationProcessor,integrationTestAnnotationProcessor,posterImageMigrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,webSystemTestAnnotationProcessor +com.google.guava:failureaccess:1.0.3=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,posterImageMigrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,webSystemTestAnnotationProcessor +com.google.guava:guava:33.5.0-jre=annotationProcessor,integrationTestAnnotationProcessor,posterImageMigrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,webSystemTestAnnotationProcessor com.google.guava:guava:33.6.0-jre=checkstyle -com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,posterImageMigrationTestAnnotationProcessor,testAnnotationProcessor -com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,posterImageMigrationTestAnnotationProcessor,testAnnotationProcessor -com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,posterImageMigrationTestAnnotationProcessor,testAnnotationProcessor -com.h2database:h2:2.4.240=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath +com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,posterImageMigrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,webSystemTestAnnotationProcessor +com.google.j2objc:j2objc-annotations:3.1=annotationProcessor,checkstyle,integrationTestAnnotationProcessor,posterImageMigrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,webSystemTestAnnotationProcessor +com.google.protobuf:protobuf-java:4.33.2=annotationProcessor,integrationTestAnnotationProcessor,posterImageMigrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,webSystemTestAnnotationProcessor +com.h2database:h2:2.4.240=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath com.h3xstream.findsecbugs:findsecbugs-plugin:1.14.0=spotbugsPlugins -com.jayway.jsonpath:json-path:2.10.0=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.nimbusds:nimbus-jose-jwt:10.4=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +com.jayway.jsonpath:json-path:2.10.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +com.nimbusds:nimbus-jose-jwt:10.4=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath com.puppycrawl.tools:checkstyle:13.5.0=checkstyle -com.squareup.okhttp3:okhttp-jvm:5.2.1=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -com.squareup.okhttp3:okhttp:5.2.1=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -com.squareup.okio:okio-jvm:3.16.1=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -com.squareup.okio:okio:3.16.1=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -com.sun.istack:istack-commons-runtime:4.1.2=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -com.vaadin.external.google:android-json:0.0.20131108.vaadin1=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -com.zaxxer:HikariCP:7.0.2=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +com.squareup.okhttp3:okhttp-jvm:5.2.1=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +com.squareup.okhttp3:okhttp:5.2.1=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +com.squareup.okio:okio-jvm:3.16.1=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +com.squareup.okio:okio:3.16.1=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +com.sun.istack:istack-commons-runtime:4.1.2=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +com.tngtech.archunit:archunit-junit5-api:1.3.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +com.tngtech.archunit:archunit-junit5-engine-api:1.3.0=integrationTestRuntimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +com.tngtech.archunit:archunit-junit5-engine:1.3.0=integrationTestRuntimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +com.tngtech.archunit:archunit-junit5:1.3.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +com.tngtech.archunit:archunit:1.3.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +com.vaadin.external.google:android-json:0.0.20131108.vaadin1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +com.zaxxer:HikariCP:7.0.2=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath commons-beanutils:commons-beanutils:1.11.0=checkstyle -commons-codec:commons-codec:1.19.0=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +commons-codec:commons-codec:1.19.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath commons-collections:commons-collections:3.2.2=checkstyle -commons-io:commons-io:2.20.0=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +commons-io:commons-io:2.20.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testFixturesCompileClasspath commons-io:commons-io:2.21.0=spotbugs -commons-logging:commons-logging:1.3.6=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +commons-logging:commons-logging:1.3.6=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath info.picocli:picocli:4.7.7=checkstyle -io.github.cdimascio:dotenv-java:3.0.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,posterImageMigrationTestAnnotationProcessor,testAnnotationProcessor -io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,posterImageMigrationTestAnnotationProcessor,testAnnotationProcessor -io.micrometer:context-propagation:1.2.1=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.micrometer:micrometer-commons:1.16.7=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.micrometer:micrometer-core:1.16.7=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.micrometer:micrometer-jakarta9:1.16.7=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.micrometer:micrometer-observation:1.16.7=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.micrometer:micrometer-registry-prometheus:1.16.7=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.micrometer:micrometer-tracing-bridge-otel:1.6.7=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.micrometer:micrometer-tracing:1.6.7=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.netty:netty-buffer:4.2.17.Final=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.netty:netty-codec-base:4.2.17.Final=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.netty:netty-codec-compression:4.2.17.Final=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.netty:netty-codec-http2:4.2.17.Final=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.netty:netty-codec-http:4.2.17.Final=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.netty:netty-codec-marshalling:4.2.17.Final=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.netty:netty-codec-protobuf:4.2.17.Final=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.netty:netty-codec:4.2.17.Final=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.netty:netty-common:4.2.17.Final=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.netty:netty-handler:4.2.17.Final=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.netty:netty-resolver:4.2.17.Final=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.netty:netty-transport-classes-epoll:4.2.17.Final=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.netty:netty-transport-native-unix-common:4.2.17.Final=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.netty:netty-transport:4.2.17.Final=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.opentelemetry.semconv:opentelemetry-semconv:1.37.0=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.opentelemetry:opentelemetry-api:1.55.0=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.opentelemetry:opentelemetry-common:1.55.0=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.opentelemetry:opentelemetry-context:1.55.0=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.opentelemetry:opentelemetry-exporter-common:1.55.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.opentelemetry:opentelemetry-exporter-otlp-common:1.55.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.opentelemetry:opentelemetry-exporter-otlp:1.55.0=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.opentelemetry:opentelemetry-exporter-sender-okhttp:1.55.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.opentelemetry:opentelemetry-extension-trace-propagators:1.55.0=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.opentelemetry:opentelemetry-sdk-common:1.55.0=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.opentelemetry:opentelemetry-sdk-extension-autoconfigure-spi:1.55.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.opentelemetry:opentelemetry-sdk-logs:1.55.0=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.opentelemetry:opentelemetry-sdk-metrics:1.55.0=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.opentelemetry:opentelemetry-sdk-trace:1.55.0=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.opentelemetry:opentelemetry-sdk:1.55.0=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.projectreactor:reactor-core:3.8.7=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.prometheus:prometheus-metrics-config:1.4.3=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.prometheus:prometheus-metrics-core:1.4.3=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.prometheus:prometheus-metrics-exposition-formats:1.4.3=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.prometheus:prometheus-metrics-exposition-textformats:1.4.3=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.prometheus:prometheus-metrics-model:1.4.3=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.prometheus:prometheus-metrics-tracer-common:1.4.3=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -io.swagger.core.v3:swagger-annotations-jakarta:2.2.38=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.swagger.core.v3:swagger-core-jakarta:2.2.38=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -io.swagger.core.v3:swagger-models-jakarta:2.2.38=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -jakarta.activation:jakarta.activation-api:2.1.4=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -jakarta.annotation:jakarta.annotation-api:3.0.0=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -jakarta.inject:jakarta.inject-api:2.0.1=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -jakarta.persistence:jakarta.persistence-api:3.2.0=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -jakarta.transaction:jakarta.transaction-api:2.0.1=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -jakarta.validation:jakarta.validation-api:3.1.1=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -jakarta.xml.bind:jakarta.xml.bind-api:4.0.5=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -javax.inject:javax.inject:1=annotationProcessor,posterImageMigrationTestAnnotationProcessor,testAnnotationProcessor +io.github.cdimascio:dotenv-java:3.0.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.github.eisop:dataflow-errorprone:3.41.0-eisop1=annotationProcessor,integrationTestAnnotationProcessor,posterImageMigrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,webSystemTestAnnotationProcessor +io.github.java-diff-utils:java-diff-utils:4.12=annotationProcessor,integrationTestAnnotationProcessor,posterImageMigrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,webSystemTestAnnotationProcessor +io.micrometer:context-propagation:1.2.1=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.micrometer:micrometer-commons:1.16.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.micrometer:micrometer-core:1.16.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.micrometer:micrometer-jakarta9:1.16.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.micrometer:micrometer-observation:1.16.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.micrometer:micrometer-registry-prometheus:1.16.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.micrometer:micrometer-tracing-bridge-otel:1.6.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.micrometer:micrometer-tracing:1.6.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.netty:netty-buffer:4.2.17.Final=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.netty:netty-codec-base:4.2.17.Final=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.netty:netty-codec-compression:4.2.17.Final=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.netty:netty-codec-http2:4.2.17.Final=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.netty:netty-codec-http:4.2.17.Final=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.netty:netty-codec-marshalling:4.2.17.Final=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.netty:netty-codec-protobuf:4.2.17.Final=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.netty:netty-codec:4.2.17.Final=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.netty:netty-common:4.2.17.Final=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.netty:netty-handler:4.2.17.Final=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.netty:netty-resolver:4.2.17.Final=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.netty:netty-transport-classes-epoll:4.2.17.Final=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.netty:netty-transport-native-unix-common:4.2.17.Final=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.netty:netty-transport:4.2.17.Final=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.opentelemetry.semconv:opentelemetry-semconv:1.37.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.opentelemetry:opentelemetry-api:1.55.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.opentelemetry:opentelemetry-common:1.55.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.opentelemetry:opentelemetry-context:1.55.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.opentelemetry:opentelemetry-exporter-common:1.55.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.opentelemetry:opentelemetry-exporter-otlp-common:1.55.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.opentelemetry:opentelemetry-exporter-otlp:1.55.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.opentelemetry:opentelemetry-exporter-sender-okhttp:1.55.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.opentelemetry:opentelemetry-extension-trace-propagators:1.55.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.opentelemetry:opentelemetry-sdk-common:1.55.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.opentelemetry:opentelemetry-sdk-extension-autoconfigure-spi:1.55.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.opentelemetry:opentelemetry-sdk-logs:1.55.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.opentelemetry:opentelemetry-sdk-metrics:1.55.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.opentelemetry:opentelemetry-sdk-trace:1.55.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.opentelemetry:opentelemetry-sdk:1.55.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.projectreactor:reactor-core:3.8.7=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.prometheus:prometheus-metrics-config:1.4.3=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.prometheus:prometheus-metrics-core:1.4.3=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.prometheus:prometheus-metrics-exposition-formats:1.4.3=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.prometheus:prometheus-metrics-exposition-textformats:1.4.3=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.prometheus:prometheus-metrics-model:1.4.3=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.prometheus:prometheus-metrics-tracer-common:1.4.3=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +io.swagger.core.v3:swagger-annotations-jakarta:2.2.38=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.swagger.core.v3:swagger-core-jakarta:2.2.38=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +io.swagger.core.v3:swagger-models-jakarta:2.2.38=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +jakarta.activation:jakarta.activation-api:2.1.4=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +jakarta.annotation:jakarta.annotation-api:3.0.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +jakarta.inject:jakarta.inject-api:2.0.1=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +jakarta.persistence:jakarta.persistence-api:3.2.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +jakarta.transaction:jakarta.transaction-api:2.0.1=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +jakarta.validation:jakarta.validation-api:3.1.1=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +jakarta.xml.bind:jakarta.xml.bind-api:4.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +javax.inject:javax.inject:1=annotationProcessor,integrationTestAnnotationProcessor,posterImageMigrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,webSystemTestAnnotationProcessor jaxen:jaxen:2.0.6=spotbugs -me.paulschwarz:spring-dotenv:4.0.0=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -net.bytebuddy:byte-buddy-agent:1.17.8=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.bytebuddy:byte-buddy:1.17.8=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -net.java.dev.jna:jna:5.18.1=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.jqwik:jqwik-api:1.9.1=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.jqwik:jqwik-engine:1.9.1=posterImageMigrationTestRuntimeClasspath,testRuntimeClasspath -net.jqwik:jqwik-time:1.9.1=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.jqwik:jqwik-web:1.9.1=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.jqwik:jqwik:1.9.1=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.minidev:accessors-smart:2.6.0=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -net.minidev:json-smart:2.6.0=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +me.paulschwarz:spring-dotenv:4.0.0=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +net.bytebuddy:byte-buddy-agent:1.17.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +net.bytebuddy:byte-buddy:1.17.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +net.java.dev.jna:jna:5.18.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testFixturesCompileClasspath +net.jqwik:jqwik-api:1.9.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +net.jqwik:jqwik-engine:1.9.1=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +net.jqwik:jqwik-time:1.9.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +net.jqwik:jqwik-web:1.9.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +net.jqwik:jqwik:1.9.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +net.minidev:accessors-smart:2.6.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +net.minidev:json-smart:2.6.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath net.sf.saxon:Saxon-HE:12.9=checkstyle,spotbugs -org.antlr:antlr4-runtime:4.13.2=checkstyle,compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.antlr:antlr4-runtime:4.13.2=checkstyle,compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath org.apache.bcel:bcel:6.12.0=spotbugs -org.apache.commons:commons-compress:1.28.0=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.apache.commons:commons-lang3:3.20.0=checkstyle,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,spotbugs,testCompileClasspath,testRuntimeClasspath +org.apache.commons:commons-compress:1.28.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testFixturesCompileClasspath +org.apache.commons:commons-lang3:3.20.0=checkstyle,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,spotbugs,systemTestCompileClasspath,systemTestRuntimeClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath org.apache.commons:commons-text:1.15.0=spotbugs org.apache.commons:commons-text:1.3=checkstyle -org.apache.httpcomponents:httpclient:4.5.13=checkstyle,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.apache.httpcomponents:httpcore:4.4.16=checkstyle,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.apache.logging.log4j:log4j-api:2.25.5=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,spotbugs,testCompileClasspath,testRuntimeClasspath +org.apache.httpcomponents:httpclient:4.5.13=checkstyle,integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.apache.httpcomponents:httpcore:4.4.16=checkstyle,integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.apache.logging.log4j:log4j-api:2.25.5=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,spotbugs,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath org.apache.logging.log4j:log4j-core:2.25.5=spotbugs -org.apache.logging.log4j:log4j-to-slf4j:2.25.5=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.apache.logging.log4j:log4j-to-slf4j:2.25.5=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath org.apache.maven.doxia:doxia-core:1.12.0=checkstyle org.apache.maven.doxia:doxia-logging-api:1.12.0=checkstyle org.apache.maven.doxia:doxia-module-xdoc:1.12.0=checkstyle org.apache.maven.doxia:doxia-sink-api:1.12.0=checkstyle -org.apache.tomcat.embed:tomcat-embed-core:11.0.24=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.apache.tomcat.embed:tomcat-embed-el:11.0.24=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.apache.tomcat.embed:tomcat-embed-websocket:11.0.24=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.apache.tomcat.embed:tomcat-embed-core:11.0.24=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.apache.tomcat.embed:tomcat-embed-el:11.0.24=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.apache.tomcat.embed:tomcat-embed-websocket:11.0.24=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath org.apache.xbean:xbean-reflect:3.7=checkstyle -org.apiguardian:apiguardian-api:1.1.2=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.aspectj:aspectjweaver:1.9.25.1=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.assertj:assertj-core:3.27.7=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.awaitility:awaitility:4.3.0=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.checkerframework:checker-qual:3.55.1=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath +org.apiguardian:apiguardian-api:1.1.2=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.aspectj:aspectjweaver:1.9.25.1=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.assertj:assertj-core:3.27.7=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.awaitility:awaitility:4.3.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.checkerframework:checker-qual:3.55.1=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath org.codehaus.plexus:plexus-classworlds:2.6.0=checkstyle org.codehaus.plexus:plexus-component-annotations:2.1.0=checkstyle org.codehaus.plexus:plexus-container-default:2.1.0=checkstyle org.codehaus.plexus:plexus-utils:3.3.0=checkstyle org.dom4j:dom4j:2.2.0=spotbugs -org.eclipse.angus:angus-activation:2.0.3=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.flywaydb:flyway-core:11.14.1=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.flywaydb:flyway-database-postgresql:11.14.1=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.glassfish.jaxb:jaxb-core:4.0.9=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.glassfish.jaxb:jaxb-runtime:4.0.9=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.glassfish.jaxb:txw2:4.0.9=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.hamcrest:hamcrest:3.0=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.hdrhistogram:HdrHistogram:2.2.2=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.hibernate.models:hibernate-models:1.0.1=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.hibernate.orm:hibernate-core:7.2.24.Final=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.hibernate.validator:hibernate-validator:9.0.1.Final=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.eclipse.angus:angus-activation:2.0.3=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.flywaydb:flyway-core:11.14.1=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.flywaydb:flyway-database-postgresql:11.14.1=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.glassfish.jaxb:jaxb-core:4.0.9=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.glassfish.jaxb:jaxb-runtime:4.0.9=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.glassfish.jaxb:txw2:4.0.9=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.hamcrest:hamcrest:3.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.hdrhistogram:HdrHistogram:2.2.2=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.hibernate.models:hibernate-models:1.0.1=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.hibernate.orm:hibernate-core:7.2.24.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.hibernate.validator:hibernate-validator:9.0.1.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath org.javassist:javassist:3.28.0-GA=checkstyle -org.jboss.logging:jboss-logging:3.6.3.Final=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.jetbrains.kotlin:kotlin-stdlib:2.2.21=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.jetbrains:annotations:13.0=productionRuntimeClasspath,runtimeClasspath -org.jetbrains:annotations:17.0.0=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,posterImageMigrationTestAnnotationProcessor,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testAnnotationProcessor,testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-api:6.0.3=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-engine:6.0.3=posterImageMigrationTestRuntimeClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter-params:6.0.3=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit.jupiter:junit-jupiter:6.0.3=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-commons:6.0.3=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-engine:6.0.3=posterImageMigrationTestRuntimeClasspath,testRuntimeClasspath -org.junit.platform:junit-platform-launcher:6.0.3=posterImageMigrationTestRuntimeClasspath,testRuntimeClasspath -org.junit:junit-bom:6.0.3=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.jboss.logging:jboss-logging:3.6.3.Final=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.jetbrains.kotlin:kotlin-stdlib:2.2.21=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.jetbrains:annotations:13.0=productionRuntimeClasspath,runtimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.jetbrains:annotations:17.0.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testFixturesCompileClasspath +org.jspecify:jspecify:1.0.1=annotationProcessor,checkstyle,compileClasspath,integrationTestAnnotationProcessor,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestAnnotationProcessor,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestAnnotationProcessor,systemTestCompileClasspath,systemTestRuntimeClasspath,testAnnotationProcessor,testCompileClasspath,testFixturesAnnotationProcessor,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestAnnotationProcessor,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.junit.jupiter:junit-jupiter-api:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.junit.jupiter:junit-jupiter-engine:6.0.3=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.junit.jupiter:junit-jupiter-params:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.junit.jupiter:junit-jupiter:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.junit.platform:junit-platform-commons:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.junit.platform:junit-platform-engine:6.0.3=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.junit.platform:junit-platform-launcher:6.0.3=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.junit:junit-bom:6.0.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath org.junit:junit-bom:6.1.0=spotbugs -org.latencyutils:LatencyUtils:2.0.3=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.mockito:mockito-core:5.20.0=mockitoAgent,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.mockito:mockito-junit-jupiter:5.20.0=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.objenesis:objenesis:3.3=posterImageMigrationTestRuntimeClasspath,testRuntimeClasspath -org.openapitools:jackson-databind-nullable:0.2.6=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.opentest4j:opentest4j:1.3.0=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.osgi:org.osgi.annotation.bundle:2.0.0=compileClasspath,posterImageMigrationTestCompileClasspath,testCompileClasspath -org.osgi:org.osgi.annotation.versioning:1.1.2=compileClasspath,posterImageMigrationTestCompileClasspath,testCompileClasspath -org.osgi:org.osgi.resource:1.0.0=compileClasspath,posterImageMigrationTestCompileClasspath,testCompileClasspath -org.osgi:org.osgi.service.serviceloader:1.0.0=compileClasspath,posterImageMigrationTestCompileClasspath,testCompileClasspath +org.latencyutils:LatencyUtils:2.0.3=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.mockito:mockito-core:5.20.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,mockitoAgent,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.mockito:mockito-junit-jupiter:5.20.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.objenesis:objenesis:3.3=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,systemTestRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.openapitools:jackson-databind-nullable:0.2.6=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.opentest4j:opentest4j:1.3.0=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.osgi:org.osgi.annotation.bundle:2.0.0=compileClasspath,integrationTestCompileClasspath,posterImageMigrationTestCompileClasspath,systemTestCompileClasspath,testCompileClasspath,webSystemTestCompileClasspath +org.osgi:org.osgi.annotation.versioning:1.1.2=compileClasspath,integrationTestCompileClasspath,posterImageMigrationTestCompileClasspath,systemTestCompileClasspath,testCompileClasspath,webSystemTestCompileClasspath +org.osgi:org.osgi.resource:1.0.0=compileClasspath,integrationTestCompileClasspath,posterImageMigrationTestCompileClasspath,systemTestCompileClasspath,testCompileClasspath,webSystemTestCompileClasspath +org.osgi:org.osgi.service.serviceloader:1.0.0=compileClasspath,integrationTestCompileClasspath,posterImageMigrationTestCompileClasspath,systemTestCompileClasspath,testCompileClasspath,webSystemTestCompileClasspath org.ow2.asm:asm-analysis:9.10.1=spotbugs org.ow2.asm:asm-commons:9.10.1=spotbugs org.ow2.asm:asm-tree:9.10.1=spotbugs org.ow2.asm:asm-util:9.10.1=spotbugs org.ow2.asm:asm:9.10.1=spotbugs -org.ow2.asm:asm:9.7.1=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.pcollections:pcollections:4.0.1=annotationProcessor,posterImageMigrationTestAnnotationProcessor,testAnnotationProcessor -org.postgresql:postgresql:42.7.13=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.reactivestreams:reactive-streams:1.0.4=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath +org.ow2.asm:asm:9.7.1=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.pcollections:pcollections:4.0.1=annotationProcessor,integrationTestAnnotationProcessor,posterImageMigrationTestAnnotationProcessor,systemTestAnnotationProcessor,testAnnotationProcessor,testFixturesAnnotationProcessor,webSystemTestAnnotationProcessor +org.postgresql:postgresql:42.7.13=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.reactivestreams:reactive-streams:1.0.4=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath org.reflections:reflections:0.10.2=checkstyle -org.rnorth.duct-tape:duct-tape:1.0.8=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.skyscreamer:jsonassert:1.5.3=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.slf4j:jul-to-slf4j:2.0.18=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.slf4j:slf4j-api:2.0.18=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,testCompileClasspath,testRuntimeClasspath +org.rnorth.duct-tape:duct-tape:1.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testFixturesCompileClasspath +org.skyscreamer:jsonassert:1.5.3=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.slf4j:jul-to-slf4j:2.0.18=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.slf4j:slf4j-api:2.0.18=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,spotbugs,spotbugsSlf4j,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath org.slf4j:slf4j-simple:2.0.17=spotbugsSlf4j org.slf4j:slf4j-simple:2.0.18=checkstyle -org.springdoc:springdoc-openapi-starter-common:3.0.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.springdoc:springdoc-openapi-starter-webmvc-api:3.0.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-actuator-autoconfigure:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-actuator:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-autoconfigure:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springdoc:springdoc-openapi-starter-common:3.0.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.springdoc:springdoc-openapi-starter-webmvc-api:3.0.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-actuator-autoconfigure:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-actuator:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-autoconfigure:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath org.springframework.boot:spring-boot-configuration-processor:4.0.8=annotationProcessor -org.springframework.boot:spring-boot-data-commons:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-data-jpa-test:4.0.8=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-data-jpa:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-flyway:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-health:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-hibernate:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-http-client:4.0.8=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-http-converter:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-jackson:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-jdbc-test:4.0.8=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-jdbc:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-jpa-test:4.0.8=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-jpa:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-micrometer-metrics:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-micrometer-observation:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-persistence:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-restclient:4.0.8=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-resttestclient:4.0.8=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-security-oauth2-resource-server:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-security:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-servlet:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-sql:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-actuator:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-data-jpa:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-flyway:4.0.8=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-jackson-test:4.0.8=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-jackson:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-jdbc:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-logging:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-micrometer-metrics:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-oauth2-resource-server:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-security:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-test:4.0.8=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-tomcat-runtime:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-tomcat:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-validation:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-web:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-webmvc-test:4.0.8=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter-webmvc:4.0.8=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-starter:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-test-autoconfigure:4.0.8=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-test:4.0.8=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-testcontainers:4.0.8=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-tomcat:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-transaction:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-validation:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-web-server:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-webmvc-test:4.0.8=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot-webmvc:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.boot:spring-boot:4.0.8=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.data:spring-data-commons:4.0.7=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.data:spring-data-jpa:4.0.7=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.integration:spring-integration-core:7.0.6=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.springframework.integration:spring-integration-jdbc:7.0.6=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.springframework.security:spring-security-config:7.0.7=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.security:spring-security-core:7.0.7=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.security:spring-security-crypto:7.0.7=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.security:spring-security-oauth2-core:7.0.7=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.security:spring-security-oauth2-jose:7.0.7=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.security:spring-security-oauth2-resource-server:7.0.7=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.security:spring-security-test:7.0.7=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.security:spring-security-web:7.0.7=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework.session:spring-session-core:4.0.5=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.springframework:spring-aop:7.0.9=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-aspects:7.0.9=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-beans:7.0.9=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-context:7.0.9=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-core:7.0.9=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-expression:7.0.9=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-jdbc:7.0.9=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-messaging:7.0.9=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.springframework:spring-orm:7.0.9=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-test:7.0.9=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-tx:7.0.9=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-web:7.0.9=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.springframework:spring-webflux:7.0.9=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -org.springframework:spring-webmvc:7.0.9=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers-database-commons:2.0.5=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers-jdbc:2.0.5=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers-junit-jupiter:2.0.5=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers-postgresql:2.0.5=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.testcontainers:testcontainers:2.0.5=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath +org.springframework.boot:spring-boot-data-commons:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-data-jpa-test:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath +org.springframework.boot:spring-boot-data-jpa:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-flyway:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-health:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-hibernate:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-http-client:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-http-converter:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-jackson:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-jdbc-test:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath +org.springframework.boot:spring-boot-jdbc:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-jpa-test:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath +org.springframework.boot:spring-boot-jpa:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-micrometer-metrics:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-micrometer-observation:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-persistence:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-restclient:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-resttestclient:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-security-oauth2-resource-server:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-security:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-servlet:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-sql:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-starter-actuator:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-starter-data-jpa:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-starter-flyway:4.0.8=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-starter-jackson-test:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-starter-jackson:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-starter-jdbc:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-starter-logging:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-starter-micrometer-metrics:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-starter-oauth2-resource-server:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-starter-security:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-starter-test:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-starter-tomcat-runtime:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-starter-tomcat:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-starter-validation:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-starter-web:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-starter-webmvc-test:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-starter-webmvc:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-starter:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-test-autoconfigure:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-test:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-testcontainers:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath +org.springframework.boot:spring-boot-tomcat:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-transaction:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-validation:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-web-server:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-webmvc-test:4.0.8=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot-webmvc:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.boot:spring-boot:4.0.8=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.data:spring-data-commons:4.0.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.data:spring-data-jpa:4.0.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.integration:spring-integration-core:7.0.6=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.springframework.integration:spring-integration-jdbc:7.0.6=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.springframework.security:spring-security-config:7.0.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.security:spring-security-core:7.0.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.security:spring-security-crypto:7.0.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.security:spring-security-oauth2-core:7.0.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.security:spring-security-oauth2-jose:7.0.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.security:spring-security-oauth2-resource-server:7.0.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.security:spring-security-test:7.0.7=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.security:spring-security-web:7.0.7=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework.session:spring-session-core:4.0.5=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.springframework:spring-aop:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework:spring-aspects:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework:spring-beans:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework:spring-context:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework:spring-core:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework:spring-expression:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework:spring-jdbc:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework:spring-messaging:7.0.9=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.springframework:spring-orm:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework:spring-test:7.0.9=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework:spring-tx:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework:spring-web:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.springframework:spring-webflux:7.0.9=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +org.springframework:spring-webmvc:7.0.9=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.testcontainers:testcontainers-database-commons:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testFixturesCompileClasspath +org.testcontainers:testcontainers-jdbc:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testFixturesCompileClasspath +org.testcontainers:testcontainers-junit-jupiter:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath +org.testcontainers:testcontainers-postgresql:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testFixturesCompileClasspath +org.testcontainers:testcontainers:2.0.5=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testFixturesCompileClasspath org.xmlresolver:xmlresolver:5.3.3=checkstyle,spotbugs -org.xmlunit:xmlunit-core:2.10.4=posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath -org.yaml:snakeyaml:2.5=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -software.amazon.awssdk:annotations:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:apache-client:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:arns:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:auth:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:aws-core:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:aws-query-protocol:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:aws-xml-protocol:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:checksums-spi:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:checksums:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:crt-core:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:endpoints-spi:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:http-auth-aws-eventstream:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:http-auth-aws:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:http-auth-spi:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:http-auth:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:http-client-spi:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:identity-spi:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:json-utils:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:metrics-spi:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:netty-nio-client:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:profiles:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:protocol-core:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:regions:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:retries-spi:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:retries:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:s3:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:sdk-core:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:third-party-jackson-core:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.awssdk:utils:2.30.0=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -software.amazon.eventstream:eventstream:1.0.1=posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testRuntimeClasspath -tools.jackson.core:jackson-core:3.1.5=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -tools.jackson.core:jackson-databind:3.1.5=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath -tools.jackson:jackson-bom:3.1.5=compileClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,testCompileClasspath,testRuntimeClasspath +org.xmlunit:xmlunit-core:2.10.4=integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +org.yaml:snakeyaml:2.5=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:annotations:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:apache-client:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:arns:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:auth:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:aws-core:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:aws-query-protocol:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:aws-xml-protocol:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:checksums-spi:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:checksums:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:crt-core:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:endpoints-spi:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:http-auth-aws-eventstream:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:http-auth-aws:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:http-auth-spi:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:http-auth:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:http-client-spi:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:identity-spi:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:json-utils:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:metrics-spi:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:netty-nio-client:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:profiles:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:protocol-core:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:regions:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:retries-spi:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:retries:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:s3:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:sdk-core:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:third-party-jackson-core:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.awssdk:utils:2.30.0=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +software.amazon.eventstream:eventstream:1.0.1=integrationTestRuntimeClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestRuntimeClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestRuntimeClasspath +tools.jackson.core:jackson-core:3.1.5=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +tools.jackson.core:jackson-databind:3.1.5=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath +tools.jackson:jackson-bom:3.1.5=compileClasspath,integrationTestCompileClasspath,integrationTestRuntimeClasspath,posterImageMigrationTestCompileClasspath,posterImageMigrationTestRuntimeClasspath,productionRuntimeClasspath,runtimeClasspath,systemTestCompileClasspath,systemTestRuntimeClasspath,testCompileClasspath,testFixturesRuntimeClasspath,testRuntimeClasspath,webSystemTestCompileClasspath,webSystemTestRuntimeClasspath empty=developmentOnly,testAndDevelopmentOnly diff --git a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterImageUploadIntentRepositoryIntegrationTest.java b/src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterImageUploadIntentRepositoryIntegrationTest.java similarity index 100% rename from src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterImageUploadIntentRepositoryIntegrationTest.java rename to src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterImageUploadIntentRepositoryIntegrationTest.java diff --git a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterRepositoryAdapterIntegrationTest.java b/src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterRepositoryAdapterIntegrationTest.java similarity index 100% rename from src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterRepositoryAdapterIntegrationTest.java rename to src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/PosterRepositoryAdapterIntegrationTest.java diff --git a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogRepositoryAdapterIntegrationTest.java b/src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogRepositoryAdapterIntegrationTest.java similarity index 100% rename from src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogRepositoryAdapterIntegrationTest.java rename to src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/adapter/outbound/persistence/repository/WorkLogRepositoryAdapterIntegrationTest.java diff --git a/src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SampleMigrationStreamIsolationTest.java b/src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SampleMigrationStreamIsolationTest.java new file mode 100644 index 00000000..76df92ec --- /dev/null +++ b/src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SampleMigrationStreamIsolationTest.java @@ -0,0 +1,81 @@ +package dev.caskeleton.sample.portfolio.bootstrap.persistence; + +import static org.assertj.core.api.Assertions.assertThat; + +import dev.caskeleton.sample.portfolio.testinfra.PostgreSqlTestContainer; +import java.sql.Connection; +import java.sql.DriverManager; +import java.sql.PreparedStatement; +import java.sql.ResultSet; +import org.flywaydb.core.Flyway; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.testcontainers.junit.jupiter.Container; +import org.testcontainers.junit.jupiter.Testcontainers; +import org.testcontainers.postgresql.PostgreSQLContainer; + +/** Proves that disposable sample migrations do not occupy the production Flyway version space. */ +@Testcontainers +class SampleMigrationStreamIsolationTest { + + @Container static final PostgreSQLContainer POSTGRES = PostgreSqlTestContainer.create(); + + private Flyway productionFlyway; + + @BeforeEach + void cleanDatabase() { + productionFlyway = + Flyway.configure() + .dataSource(POSTGRES.getJdbcUrl(), POSTGRES.getUsername(), POSTGRES.getPassword()) + .locations("classpath:db/migration/postgresql") + .cleanDisabled(false) + .load(); + productionFlyway.clean(); + } + + @Test + void productionAndSampleUseIndependentHistoryTables() throws Exception { + SamplePostgreSqlPersistenceConfig.sampleMigrationStrategy().migrate(productionFlyway); + + try (Connection connection = + DriverManager.getConnection( + POSTGRES.getJdbcUrl(), POSTGRES.getUsername(), POSTGRES.getPassword())) { + assertThat(successfulVersions(connection, "flyway_schema_history")) + .contains("1", "3", "13") + .doesNotContain("2", "7", "8"); + assertThat(successfulVersions(connection, "flyway_sample_schema_history")) + .contains("2", "7", "8"); + assertThat(tableExists(connection, "work_log")).isTrue(); + assertThat(tableExists(connection, "poster")).isTrue(); + } + } + + private static java.util.List successfulVersions(Connection connection, String history) + throws Exception { + try (PreparedStatement statement = + connection.prepareStatement( + "select version from " + + history + + " where success = true order by installed_rank"); + ResultSet result = statement.executeQuery()) { + java.util.ArrayList versions = new java.util.ArrayList<>(); + while (result.next()) { + versions.add(result.getString(1)); + } + return java.util.List.copyOf(versions); + } + } + + private static boolean tableExists(Connection connection, String table) throws Exception { + try (PreparedStatement statement = + connection.prepareStatement( + "select count(*) from information_schema.tables " + + "where table_schema = 'public' and table_name = ?")) { + statement.setString(1, table); + try (ResultSet result = statement.executeQuery()) { + assertThat(result.next()).isTrue(); + return result.getInt(1) == 1; + } + } + } +} diff --git a/src/sample-portfolio/src/posterImageMigrationTest/java/dev/caskeleton/sample/portfolio/qualification/PosterImageIdempotencyRotationQualificationTest.java b/src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/qualification/PosterImageIdempotencyRotationQualificationTest.java similarity index 100% rename from src/sample-portfolio/src/posterImageMigrationTest/java/dev/caskeleton/sample/portfolio/qualification/PosterImageIdempotencyRotationQualificationTest.java rename to src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/qualification/PosterImageIdempotencyRotationQualificationTest.java diff --git a/src/sample-portfolio/src/posterImageMigrationTest/java/dev/caskeleton/sample/portfolio/qualification/PosterImageRetirementQualificationTest.java b/src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/qualification/PosterImageRetirementQualificationTest.java similarity index 100% rename from src/sample-portfolio/src/posterImageMigrationTest/java/dev/caskeleton/sample/portfolio/qualification/PosterImageRetirementQualificationTest.java rename to src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/qualification/PosterImageRetirementQualificationTest.java diff --git a/src/sample-portfolio/src/posterImageMigrationTest/java/dev/caskeleton/sample/portfolio/qualification/PosterImageV8MigrationQualificationTest.java b/src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/qualification/PosterImageV8MigrationQualificationTest.java similarity index 100% rename from src/sample-portfolio/src/posterImageMigrationTest/java/dev/caskeleton/sample/portfolio/qualification/PosterImageV8MigrationQualificationTest.java rename to src/sample-portfolio/src/integrationTest/java/dev/caskeleton/sample/portfolio/qualification/PosterImageV8MigrationQualificationTest.java diff --git a/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/SamplePortfolioApplication.java b/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/SamplePortfolioApplication.java index c0430211..d18bb5a0 100644 --- a/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/SamplePortfolioApplication.java +++ b/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/SamplePortfolioApplication.java @@ -3,7 +3,6 @@ package dev.caskeleton.sample.portfolio; import dev.caskeleton.adapter.inbound.web.auth.SecurityConfig; import dev.caskeleton.adapter.inbound.web.authz.MethodSecurityConfig; import dev.caskeleton.adapter.outbound.persistence.postgresql.PostgreSqlPersistenceConfig; -import dev.caskeleton.sample.portfolio.bootstrap.scan.TestEnclosedConfigurationFilter; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.EnableAutoConfiguration; import org.springframework.boot.context.properties.ConfigurationPropertiesScan; @@ -37,11 +36,7 @@ import org.springframework.context.annotation.FilterType; // configured IdP or method-security principal. Production modules keep these guards. SecurityConfig.class, MethodSecurityConfig.class - }), - // Excludes @Configuration nested in test classes (see README). - @ComponentScan.Filter( - type = FilterType.CUSTOM, - classes = TestEnclosedConfigurationFilter.class) + }) }) @ConfigurationPropertiesScan(basePackages = "dev.caskeleton") public class SamplePortfolioApplication { diff --git a/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/WorkLogController.java b/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/WorkLogController.java index 7bad8fee..34c079d0 100644 --- a/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/WorkLogController.java +++ b/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/WorkLogController.java @@ -122,11 +122,7 @@ public class WorkLogController { PageMeta pageMeta = pageParams.toPageMeta(result.total(), appliedSort); ResponseMeta meta = ResponseMetaFactory.fromMdc().withPage(pageMeta); - ResponseEntity.BodyBuilder builder = ResponseEntity.ok(); - if (pageParams.isDeepOffset()) { // deep offset → recommend cursor - builder.header(ApiHeaders.DEPRECATION, "deep-offset-pagination"); - } - return builder.body(Envelope.ok(body, meta)); + return ResponseEntity.ok(Envelope.ok(body, meta)); } @GetMapping("/worklogs/repoStats") @@ -147,14 +143,8 @@ public class WorkLogController { return ResponseEntity.ok().eTag(etag).body(WorkLogWebMapper.toResponse(workLog)); } - /** - * {@code Idempotency-Key} is accepted on the POST surface but only tolerated (ignored) until the - * rate-limit/idempotency contract wires replay. See README. - */ @PostMapping("/worklogs") - public ResponseEntity create( - @Valid @RequestBody CreateWorkLogRequest body, - @RequestHeader(value = ApiHeaders.IDEMPOTENCY_KEY, required = false) String idempotencyKey) { + public ResponseEntity create(@Valid @RequestBody CreateWorkLogRequest body) { WorkLog created = create.handle(WorkLogWebMapper.toCommand(body, currentOwnerSubject())); return ResponseEntity.ok().eTag(etagOf(created)).body(WorkLogWebMapper.toResponse(created)); } @@ -186,9 +176,7 @@ public class WorkLogController { * success). See README. */ @PostMapping("/worklogs:batchCreate") - public List batchCreate( - @Valid @RequestBody BatchCreateRequest request, - @RequestHeader(value = ApiHeaders.IDEMPOTENCY_KEY, required = false) String idempotencyKey) { + public List batchCreate(@Valid @RequestBody BatchCreateRequest request) { String owner = currentOwnerSubject(); List created = batchCreate.handle( diff --git a/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/event/PosterEventPublisher.java b/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/event/PosterEventPublisher.java index 6a875638..0818ff4c 100644 --- a/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/event/PosterEventPublisher.java +++ b/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/event/PosterEventPublisher.java @@ -11,7 +11,6 @@ import dev.caskeleton.sample.portfolio.domain.poster.PosterPublished; import dev.caskeleton.sample.portfolio.domain.worklog.OutboxEventIdFactory; import java.time.Clock; import java.time.Instant; -import org.springframework.stereotype.Component; /** * Publishes Poster lifecycle domain events to the transactional outbox. MUST be invoked from within @@ -21,7 +20,6 @@ import org.springframework.stereotype.Component; * {@link OutboxEventIdFactory}) doubles as the idempotency key; {@code correlationId} comes through * {@link CorrelationIdPort}, falling back to {@code eventId} off-HTTP. */ -@Component public class PosterEventPublisher { private final LegacyOutboxAppendPort outbox; diff --git a/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/event/PosterImagePublicationEventPublisher.java b/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/event/PosterImagePublicationEventPublisher.java index 5425d21b..f1d3aa81 100644 --- a/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/event/PosterImagePublicationEventPublisher.java +++ b/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/event/PosterImagePublicationEventPublisher.java @@ -5,10 +5,8 @@ import dev.caskeleton.application.outbox.LegacyOutboxAppendPort; import dev.caskeleton.application.outbox.NewOutboxEvent; import dev.caskeleton.sample.portfolio.domain.worklog.OutboxEventIdFactory; import java.time.Clock; -import org.springframework.stereotype.Component; /** Transactional locator-free publication integration notifications. */ -@Component public final class PosterImagePublicationEventPublisher { private final LegacyOutboxAppendPort outbox; diff --git a/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/ArchivePosterUseCase.java b/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/ArchivePosterUseCase.java index 5382cde2..531eff8c 100644 --- a/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/ArchivePosterUseCase.java +++ b/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/ArchivePosterUseCase.java @@ -13,12 +13,10 @@ import dev.caskeleton.sample.portfolio.application.exception.PosterNotFoundExcep import dev.caskeleton.sample.portfolio.domain.poster.Poster; import dev.caskeleton.sample.portfolio.domain.poster.PosterArchived; import dev.caskeleton.sample.portfolio.domain.poster.PosterRepository; -import org.springframework.stereotype.Service; /** * Archives a poster (→ {@code ARCHIVED}, terminal). Emits a {@code poster.archived} outbox event. */ -@Service @RequiresPermission("poster:write") @UseCaseCapability( transactionMode = TransactionMode.WRITE, diff --git a/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/CreatePosterUseCase.java b/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/CreatePosterUseCase.java index 5ed0390c..750328e3 100644 --- a/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/CreatePosterUseCase.java +++ b/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/CreatePosterUseCase.java @@ -14,14 +14,12 @@ import dev.caskeleton.sample.portfolio.domain.poster.Poster; import dev.caskeleton.sample.portfolio.domain.poster.PosterCreated; import dev.caskeleton.sample.portfolio.domain.poster.PosterIdFactory; import dev.caskeleton.sample.portfolio.domain.poster.PosterRepository; -import org.springframework.stereotype.Service; /** * Creates a new {@link Poster} (server-assigned id via {@link PosterIdFactory}) and appends a * {@code poster.created} outbox event in the same write transaction. Rejects a duplicate title. * Mirrors {@code CreateWorkLogUseCase}. */ -@Service @RequiresPermission("poster:write") @UseCaseCapability( transactionMode = TransactionMode.WRITE, diff --git a/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/DeletePosterUseCase.java b/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/DeletePosterUseCase.java index ee60d111..c23543c8 100644 --- a/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/DeletePosterUseCase.java +++ b/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/application/poster/DeletePosterUseCase.java @@ -15,15 +15,12 @@ import dev.caskeleton.sample.portfolio.domain.poster.PosterDeleted; import dev.caskeleton.sample.portfolio.domain.poster.PosterRepository; import java.time.Duration; import java.util.Optional; -import org.springframework.beans.factory.annotation.Autowired; -import org.springframework.stereotype.Service; /** * Deletes a poster — the destructive, admin-tier operation, gated by {@code poster:close} (granted * only to {@code admin}). Emits a {@code poster.deleted} outbox event. Mirrors {@code * DeleteWorkLogUseCase}. */ -@Service @RequiresPermission("poster:close") @UseCaseCapability( transactionMode = TransactionMode.WRITE, @@ -42,7 +39,6 @@ public class DeletePosterUseCase implements CommandUseCaseThe sample intentionally mirrors the production template: application classes are plain Java + * and Spring owns their lifecycle only here, at the composition boundary. This keeps the reference + * application from teaching adopters to put framework stereotypes on use cases. + */ +@Configuration(proxyBeanMethods = false) +public class SampleApplicationUseCaseConfig { + + @Bean + PosterEventPublisher posterEventPublisher( + LegacyOutboxAppendPort outbox, + OutboxEventIdFactory eventIds, + CorrelationIdPort correlations, + Clock clock) { + return new PosterEventPublisher(outbox, eventIds, correlations, clock); + } + + @Bean + PosterImagePublicationEventPublisher posterImagePublicationEventPublisher( + LegacyOutboxAppendPort outbox, + OutboxEventIdFactory eventIds, + CorrelationIdPort correlations, + Clock clock) { + return new PosterImagePublicationEventPublisher(outbox, eventIds, correlations, clock); + } + + @Bean + ArchivePosterUseCase archivePosterUseCase( + PosterRepository repository, PosterEventPublisher events, TransactionPort transactions) { + return new ArchivePosterUseCase(repository, events, transactions); + } + + @Bean + CreatePosterUseCase createPosterUseCase( + PosterRepository repository, + PosterIdFactory ids, + PosterEventPublisher events, + TransactionPort transactions) { + return new CreatePosterUseCase(repository, ids, events, transactions); + } + + @Bean + DeletePosterUseCase deletePosterUseCase( + PosterRepository repository, + PosterEventPublisher events, + TransactionPort transactions, + Optional retireImages) { + return new DeletePosterUseCase(repository, events, transactions, retireImages); + } + + @Bean + GetPosterUseCase getPosterUseCase(PosterRepository repository, TransactionPort transactions) { + return new GetPosterUseCase(repository, transactions); + } + + @Bean + ListPostersUseCase listPostersUseCase(PosterRepository repository, TransactionPort transactions) { + return new ListPostersUseCase(repository, transactions); + } + + @Bean + PublishPosterUseCase publishPosterUseCase( + PosterRepository repository, PosterEventPublisher events, TransactionPort transactions) { + return new PublishPosterUseCase(repository, events, transactions); + } + + @Bean + UpdatePosterUseCase updatePosterUseCase( + PosterRepository repository, TransactionPort transactions) { + return new UpdatePosterUseCase(repository, transactions); + } + + @Bean + BatchCreateWorkLogsUseCase batchCreateWorkLogsUseCase( + WorkLogRepository repository, WorkLogIdFactory ids, TransactionPort transactions) { + return new BatchCreateWorkLogsUseCase(repository, ids, transactions); + } + + @Bean + CreateWorkLogUseCase createWorkLogUseCase( + WorkLogRepository repository, + WorkLogIdFactory workLogIds, + OutboxEventIdFactory eventIds, + LegacyOutboxAppendPort outbox, + CorrelationIdPort correlations, + Clock clock, + TransactionPort transactions) { + return new CreateWorkLogUseCase( + repository, workLogIds, eventIds, outbox, correlations, clock, transactions); + } + + @Bean + DeleteWorkLogUseCase deleteWorkLogUseCase( + WorkLogRepository repository, TransactionPort transactions) { + return new DeleteWorkLogUseCase(repository, transactions); + } + + @Bean + GetRepoStatsUseCase getRepoStatsUseCase(RepoStatsPort repoStats) { + return new GetRepoStatsUseCase(repoStats); + } + + @Bean + GetWorkLogUseCase getWorkLogUseCase(WorkLogRepository repository, TransactionPort transactions) { + return new GetWorkLogUseCase(repository, transactions); + } + + @Bean + ListRecentWorkLogSummariesUseCase listRecentWorkLogSummariesUseCase( + WorkLogSummaryQueryPort queries, TransactionPort transactions) { + return new ListRecentWorkLogSummariesUseCase(queries, transactions); + } + + @Bean + ListWorkLogsUseCase listWorkLogsUseCase( + WorkLogRepository repository, TransactionPort transactions) { + return new ListWorkLogsUseCase(repository, transactions); + } + + @Bean + UpdateWorkLogUseCase updateWorkLogUseCase( + WorkLogRepository repository, TransactionPort transactions) { + return new UpdateWorkLogUseCase(repository, transactions); + } +} diff --git a/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SamplePostgreSqlPersistenceConfig.java b/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SamplePostgreSqlPersistenceConfig.java index dac991c3..88323d96 100644 --- a/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SamplePostgreSqlPersistenceConfig.java +++ b/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SamplePostgreSqlPersistenceConfig.java @@ -10,7 +10,10 @@ import dev.caskeleton.adapter.outbound.persistence.postgresql.PostgreSqlOutboxCl import dev.caskeleton.adapter.outbound.persistence.postgresql.PostgreSqlSqlStateErrorMapping; import dev.caskeleton.adapter.outbound.persistence.transaction.TransactionLocalTimeoutConfigurer; import jakarta.persistence.EntityManager; +import org.flywaydb.core.Flyway; +import org.flywaydb.core.api.MigrationVersion; import org.springframework.boot.flyway.autoconfigure.FlywayConfigurationCustomizer; +import org.springframework.boot.flyway.autoconfigure.FlywayMigrationStrategy; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.Import; @@ -18,25 +21,51 @@ import org.springframework.jdbc.core.JdbcOperations; /** * Sample-local replacement for {@code PostgreSqlPersistenceConfig}. Exists to break a - * Flyway/EntityManager initialization cycle by registering the {@code - * FlywayConfigurationCustomizer} as a {@code static @Bean}. Disposable. See README. + * Flyway/EntityManager initialization cycle and to keep sample schema migrations in a separate + * Flyway history from the production persistence timeline. Disposable. See README. */ @Configuration(proxyBeanMethods = false) @Import(PersistenceJpaConfig.class) public class SamplePostgreSqlPersistenceConfig { /** - * {@code static @Bean} (called without instantiating the owning class, so no - * {@code @PersistenceContext} injection during Flyway init). Sets both migration locations: - * production {@code db/migration/postgresql} + sample {@code db/sample-migration}. {@code - * locations(...)} replaces rather than appends, so this — not {@code spring.flyway.locations} in - * application.yml — is the effective source of truth. See README. + * Keeps Boot's primary Flyway on the production persistence timeline only. + * + *

      The sample migrations run through {@link #sampleMigrationStrategy()} with their own schema + * history table, so a sample V2/V7/V8 no longer reserves those versions for production. */ @Bean public static FlywayConfigurationCustomizer postgreSqlFlywayLocationCustomizer() { - return configuration -> - configuration.locations( - "classpath:db/migration/postgresql", "classpath:db/sample-migration"); + return configuration -> configuration.locations("classpath:db/migration/postgresql"); + } + + /** + * Applies the disposable sample schema as a second Flyway stream after production migrations. + * + *

      The schema is already non-empty after the production stream, so the sample stream baselines + * itself at version 0 before applying its own V2/V7/V8 history. Its history table is deliberately + * distinct: version identity is scoped to a stream, not to the whole database. + */ + @Bean + public static FlywayMigrationStrategy sampleMigrationStrategy() { + return productionFlyway -> { + productionFlyway.migrate(); + + Flyway sampleFlyway = + sampleFlywayConfiguration(productionFlyway.getConfiguration().getDataSource()).load(); + sampleFlyway.migrate(); + }; + } + + static org.flywaydb.core.api.configuration.FluentConfiguration sampleFlywayConfiguration( + javax.sql.DataSource dataSource) { + return Flyway.configure(SamplePostgreSqlPersistenceConfig.class.getClassLoader()) + .dataSource(dataSource) + .locations("classpath:db/sample-migration") + .table("flyway_sample_schema_history") + .baselineOnMigrate(true) + .baselineVersion(MigrationVersion.fromVersion("0")) + .cleanDisabled(true); } @Bean diff --git a/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/scan/TestEnclosedConfigurationFilter.java b/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/scan/TestEnclosedConfigurationFilter.java deleted file mode 100644 index 60608714..00000000 --- a/src/sample-portfolio/src/main/java/dev/caskeleton/sample/portfolio/bootstrap/scan/TestEnclosedConfigurationFilter.java +++ /dev/null @@ -1,29 +0,0 @@ -package dev.caskeleton.sample.portfolio.bootstrap.scan; - -import org.springframework.core.type.classreading.MetadataReader; -import org.springframework.core.type.classreading.MetadataReaderFactory; -import org.springframework.core.type.filter.TypeFilter; - -/** - * Component-scan exclusion filter that rejects {@code @Configuration} classes nested inside test - * classes (binary name contains {@code $} and the enclosing class name ends with {@code Test}), - * preventing {@code BeanDefinitionOverrideException} during the full-context boot. Disposable. See - * README. - */ -public class TestEnclosedConfigurationFilter implements TypeFilter { - - @Override - public boolean match(MetadataReader metadataReader, MetadataReaderFactory metadataReaderFactory) { - String className = metadataReader.getClassMetadata().getClassName(); - int dollarIndex = className.lastIndexOf('$'); - if (dollarIndex < 0) { - return false; // top-level class — not a nested class - } - String enclosingName = className.substring(0, dollarIndex); - // Strip any further nesting to reach the top-level class name segment. - int lastDot = enclosingName.lastIndexOf('.'); - String simpleEnclosingName = - (lastDot >= 0) ? enclosingName.substring(lastDot + 1) : enclosingName; - return simpleEnclosingName.endsWith("Test"); - } -} diff --git a/src/sample-portfolio/src/main/resources/application.yml b/src/sample-portfolio/src/main/resources/application.yml index 06f582be..51b50852 100644 --- a/src/sample-portfolio/src/main/resources/application.yml +++ b/src/sample-portfolio/src/main/resources/application.yml @@ -44,12 +44,10 @@ spring: baseline-on-migrate: false out-of-order: true clean-disabled: true - # NOTE: this property is overridden at runtime by the static - # SamplePostgreSqlPersistenceConfig.postgreSqlFlywayLocationCustomizer @Bean, which - # sets both "classpath:db/migration/postgresql" (the legacy production timeline) and - # "classpath:db/sample-migration" (V2 work_log, V7 poster). The FlywayConfigurationCustomizer - # replaces whatever is declared here, so this entry is documentation-only. - locations: classpath:db/migration/postgresql,classpath:db/sample-migration + # The primary Flyway owns the production persistence timeline only. The sample schema + # is migrated separately by SamplePostgreSqlPersistenceConfig.sampleMigrationStrategy using + # flyway_sample_schema_history, so sample version numbers never reserve production versions. + locations: classpath:db/migration/postgresql jpa: hibernate: ddl-auto: ${APP_DATASOURCE_DDL_AUTO:update} @@ -120,7 +118,7 @@ management: server: port: ${APP_SERVER_PORT:8080} shutdown: ${APP_SERVER_SHUTDOWN:graceful} - forward-headers-strategy: ${APP_SERVER_FORWARD_HEADERS_STRATEGY:framework} + forward-headers-strategy: ${APP_SERVER_FORWARD_HEADERS_STRATEGY:none} tomcat: threads: max: ${APP_SERVER_TOMCAT_MAX_THREADS:200} @@ -173,8 +171,6 @@ ca-skeleton: bootstrap: app-name: ${APP_NAME:sample-portfolio} runtime: - error-detail-exposure-enabled: ${APP_ERROR_DETAIL_EXPOSURE_ENABLED:false} - log-body-capture-enabled: ${APP_LOG_BODY_CAPTURE_ENABLED:false} multi-instance-enabled: ${APP_MULTI_INSTANCE_ENABLED:false} lock: wait-time: 3s @@ -231,6 +227,7 @@ ca-skeleton: otlp-endpoint: ${OTEL_EXPORTER_OTLP_ENDPOINT:} # Outbox relay disabled for lean demo (WorkLog demo does not need active relay). outbox: + enabled: true relay-enabled: false poll-interval: PT5S batch-size: 20 @@ -279,10 +276,10 @@ app: kafka: brokers: ${APP_MESSAGING_KAFKA_BROKERS:} notification: - slack: - provider: ${APP_NOTIFICATION_SLACK_PROVIDER:} - email: - provider: ${APP_NOTIFICATION_EMAIL_PROVIDER:} + slack-webhook: + enabled: ${APP_NOTIFICATION_SLACK_WEBHOOK_ENABLED:false} + google-email: + enabled: ${APP_NOTIFICATION_GOOGLE_EMAIL_ENABLED:false} outbound: http: connect-timeout: ${APP_OUTBOUND_HTTP_CONNECT_TIMEOUT:2s} diff --git a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/SampleApplicationContextTest.java b/src/sample-portfolio/src/systemTest/java/dev/caskeleton/sample/portfolio/SampleApplicationContextTest.java similarity index 72% rename from src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/SampleApplicationContextTest.java rename to src/sample-portfolio/src/systemTest/java/dev/caskeleton/sample/portfolio/SampleApplicationContextTest.java index ae33a299..9c9e5d11 100644 --- a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/SampleApplicationContextTest.java +++ b/src/sample-portfolio/src/systemTest/java/dev/caskeleton/sample/portfolio/SampleApplicationContextTest.java @@ -18,11 +18,10 @@ import org.testcontainers.postgresql.PostgreSQLContainer; * Boot-loop driver for the LEAN sample-portfolio standalone startup. * *

      Boots a full {@link SamplePortfolioApplication} context using the {@code test} Spring profile - * and a real Testcontainers Postgres. Asserts that the full migration set — including the sample's - * work_log table (V2 from {@code db/sample-migration}) — is applied on standalone boot. This guards - * against {@link - * dev.caskeleton.sample.portfolio.bootstrap.persistence.SamplePostgreSqlPersistenceConfig} - * accidentally dropping sample migrations when it configures Flyway locations. + * and a real Testcontainers Postgres. Asserts that both migration streams are applied: the + * production persistence timeline in {@code flyway_schema_history} and the sample timeline in + * {@code flyway_sample_schema_history}. This prevents the disposable sample from reserving version + * numbers in the production stream. * *

      Testcontainers is enabled via {@code @ActiveProfiles("test")} combined with a disposable * Postgres container whose connection details override the placeholder datasource URL defined in @@ -66,19 +65,24 @@ class SampleApplicationContextTest { .isEqualTo(1); } - /** - * Asserts that {@code flyway_schema_history} records V2 as a successfully applied migration - * script (description contains "work_log" case-insensitively). - */ + /** The sample V2 belongs only to the sample schema-history stream. */ @Test - void flywaySchemaHistoryContainsV2WorkLogMigration() { - Integer applied = + void sampleMigrationHistoryOwnsV2WithoutReservingProductionV2() { + Integer sampleApplied = jdbcTemplate.queryForObject( - "SELECT count(*) FROM flyway_schema_history " + "SELECT count(*) FROM flyway_sample_schema_history " + "WHERE version = '2' AND success = true", Integer.class); - assertThat(applied) - .as("flyway_schema_history must contain a successful V2 migration") + Integer productionV2 = + jdbcTemplate.queryForObject( + "SELECT count(*) FROM flyway_schema_history WHERE version = '2' AND success = true", + Integer.class); + + assertThat(sampleApplied) + .as("sample history must record its own V2 work_log migration") .isEqualTo(1); + assertThat(productionV2) + .as("sample V2 must not reserve V2 in the production migration timeline") + .isZero(); } } diff --git a/src/sample-portfolio/src/test/resources/application-test.yml b/src/sample-portfolio/src/systemTest/resources/application-test.yml similarity index 98% rename from src/sample-portfolio/src/test/resources/application-test.yml rename to src/sample-portfolio/src/systemTest/resources/application-test.yml index f9f38b37..9efae481 100644 --- a/src/sample-portfolio/src/test/resources/application-test.yml +++ b/src/sample-portfolio/src/systemTest/resources/application-test.yml @@ -104,8 +104,6 @@ ca-skeleton: bootstrap: app-name: sample-portfolio-test runtime: - error-detail-exposure-enabled: false - log-body-capture-enabled: false multi-instance-enabled: false lock: wait-time: 3s @@ -160,6 +158,7 @@ ca-skeleton: exporter: otlp-endpoint: "" outbox: + enabled: true relay-enabled: false poll-interval: PT5S batch-size: 20 diff --git a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/WorkLogControllerWireTest.java b/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/WorkLogControllerWireTest.java index 43f6b912..2c8d8d10 100644 --- a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/WorkLogControllerWireTest.java +++ b/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/controller/WorkLogControllerWireTest.java @@ -222,21 +222,6 @@ class WorkLogControllerWireTest { .andExpect(jsonPath("$.data.length()").value(1)); } - // ---- D3 Idempotency-Key accepted (server-tolerant) on POST ---- - - @Test - void postAcceptsIdempotencyKeyHeader() throws Exception { - when(createUseCase.handle(any())).thenReturn(sample("a")); - mvc.perform( - post("/worklogs") - .header("Idempotency-Key", "key-abc") - .contentType(MediaType.APPLICATION_JSON) - .content( - "{\"title\":\"a\",\"category\":\"DATABASE\",\"periodStart\":\"2025-01-01\"}")) - .andExpect(status().isOk()) - .andExpect(jsonPath("$.success").value(true)); - } - // ---- existing id / validation / mapping behaviours (paths renamed to /worklogs) ---- @Test diff --git a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/request/BasicPolymorphicTypeValidatorAllowlistTest.java b/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/request/BasicPolymorphicTypeValidatorAllowlistTest.java index a8c24228..1385043d 100644 --- a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/request/BasicPolymorphicTypeValidatorAllowlistTest.java +++ b/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/request/BasicPolymorphicTypeValidatorAllowlistTest.java @@ -13,7 +13,7 @@ import org.junit.jupiter.api.Test; /** * B5 alternative pattern: {@link BasicPolymorphicTypeValidator} allowlist. * - *

      The branch note records two acceptable polymorphic-deserialization shapes: + *

      The design record records two acceptable polymorphic-deserialization shapes: * *

        *
      1. {@code @JsonTypeInfo(use = NAME)} + {@code @JsonSubTypes} on a sealed interface — see diff --git a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/response/BulkEnvelopeTest.java b/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/response/BulkEnvelopeTest.java index 0bad86f4..7dff1b7a 100644 --- a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/response/BulkEnvelopeTest.java +++ b/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/dto/response/BulkEnvelopeTest.java @@ -13,7 +13,7 @@ import org.junit.jupiter.api.Test; /** * B8: pin the three bulk-endpoint envelope shapes. * - *

        The branch note's failure condition explicitly forbids {@code success: true} on any + *

        The design record's failure condition explicitly forbids {@code success: true} on any * partial-failure response. The "all failed" case and the "partial" case must take the same * envelope branch ({@code BATCH_PARTIAL_FAILURE}) so callers always inspect {@code details[]} when * {@code success == false}. diff --git a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/filter/VirtualThreadMdcPropagationTest.java b/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/filter/VirtualThreadMdcPropagationTest.java index 7b3ee444..4909a489 100644 --- a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/filter/VirtualThreadMdcPropagationTest.java +++ b/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/filter/VirtualThreadMdcPropagationTest.java @@ -11,7 +11,7 @@ import org.slf4j.MDC; /** * B6 contract pin for virtual-thread context propagation. * - *

        The branch note rejects {@link InheritableThreadLocal} and requires SLF4J 2.0+ MDC + {@code + *

        The design record rejects {@link InheritableThreadLocal} and requires SLF4J 2.0+ MDC + {@code * RequestContextHolder} for {@code requestId} / {@code traceId} propagation. SLF4J 2.0's {@code * MDCAdapter} is virtual-thread aware (the value lives on each virtual thread's own {@code * ThreadLocal}, not on the carrier), which gives the two guarantees this test pins: diff --git a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/architecture/SampleArchitectureTest.java b/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/architecture/SampleArchitectureTest.java new file mode 100644 index 00000000..f7fb40bb --- /dev/null +++ b/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/architecture/SampleArchitectureTest.java @@ -0,0 +1,70 @@ +package dev.caskeleton.sample.portfolio.architecture; + +import static com.tngtech.archunit.lang.syntax.ArchRuleDefinition.noClasses; +import static org.assertj.core.api.Assertions.assertThat; + +import com.tngtech.archunit.core.domain.JavaClasses; +import com.tngtech.archunit.core.importer.ClassFileImporter; +import com.tngtech.archunit.core.importer.ImportOption; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; + +class SampleArchitectureTest { + + private static JavaClasses sample; + + @BeforeAll + static void importSampleProductionCode() { + sample = + new ClassFileImporter() + .withImportOption(ImportOption.Predefined.DO_NOT_INCLUDE_TESTS) + .importPackages("dev.caskeleton.sample.portfolio"); + assertThat(sample).isNotEmpty(); + } + + @Test + void applicationLayerIsFrameworkFree() { + noClasses() + .that() + .resideInAPackage("..sample.portfolio.application..") + .should() + .dependOnClassesThat() + .resideInAnyPackage( + "org.springframework..", + "jakarta.persistence..", + "jakarta.servlet..", + "org.hibernate..") + .because("application use cases are plain Java and are assembled only by bootstrap") + .check(sample); + } + + @Test + void domainLayerIsFrameworkFree() { + noClasses() + .that() + .resideInAPackage("..sample.portfolio.domain..") + .should() + .dependOnClassesThat() + .resideInAnyPackage( + "org.springframework..", + "jakarta.persistence..", + "jakarta.servlet..", + "org.hibernate..", + "tools.jackson..", + "com.fasterxml.jackson..") + .because("the sample domain is the reference model adopters are expected to copy") + .check(sample); + } + + @Test + void inboundWebDoesNotDependOnPersistenceImplementation() { + noClasses() + .that() + .resideInAPackage("..sample.portfolio.adapter.inbound.web..") + .should() + .dependOnClassesThat() + .resideInAPackage("..sample.portfolio.adapter.outbound.persistence..") + .because("controllers depend on application/domain contracts, not persistence adapters") + .check(sample); + } +} diff --git a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SamplePostgreSqlPersistenceConfigTest.java b/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SamplePostgreSqlPersistenceConfigTest.java new file mode 100644 index 00000000..8fcc501f --- /dev/null +++ b/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/persistence/SamplePostgreSqlPersistenceConfigTest.java @@ -0,0 +1,24 @@ +package dev.caskeleton.sample.portfolio.bootstrap.persistence; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.mockito.Mockito.mock; + +import javax.sql.DataSource; +import org.junit.jupiter.api.Test; + +class SamplePostgreSqlPersistenceConfigTest { + + @Test + void sampleMigrationsUseTheirOwnLocationAndHistoryTimeline() { + var configuration = + SamplePostgreSqlPersistenceConfig.sampleFlywayConfiguration(mock(DataSource.class)); + + assertThat(configuration.getTable()).isEqualTo("flyway_sample_schema_history"); + assertThat(configuration.getBaselineVersion().getVersion()).isEqualTo("0"); + assertThat(configuration.isBaselineOnMigrate()).isTrue(); + assertThat(configuration.isCleanDisabled()).isTrue(); + assertThat(configuration.getLocations()) + .extracting(Object::toString) + .containsExactly("classpath:db/sample-migration"); + } +} diff --git a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/security/SamplePublicAccessSecurityConfigTest.java b/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/security/SamplePublicAccessSecurityConfigTest.java index ed124115..cbd4d449 100644 --- a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/security/SamplePublicAccessSecurityConfigTest.java +++ b/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/bootstrap/security/SamplePublicAccessSecurityConfigTest.java @@ -68,7 +68,8 @@ class SamplePublicAccessSecurityConfigTest { post("/worklogs") .contentType(MediaType.APPLICATION_JSON) .content( - "{\"title\":\"public demo\",\"category\":\"DATABASE\",\"periodStart\":\"2025-01-01\"}")) + "{\"title\":\"public" + + " demo\",\"category\":\"DATABASE\",\"periodStart\":\"2025-01-01\"}")) .andExpect(status().isOk()); } @@ -83,6 +84,18 @@ class SamplePublicAccessSecurityConfigTest { .contains(SecurityConfig.class, MethodSecurityConfig.class); } + @Test + void productionCompositionRootDoesNotReferenceTestOnlyScanFilters() { + ComponentScan componentScan = + AnnotationUtils.findAnnotation(SamplePortfolioApplication.class, ComponentScan.class); + + assertThat(componentScan).isNotNull(); + assertThat(componentScan.excludeFilters()) + .flatExtracting(filter -> List.of(filter.classes())) + .extracting(Class::getSimpleName) + .doesNotContain("TestEnclosedConfigurationFilter"); + } + private static WorkLog sample(String title) { return WorkLog.rehydrate( WorkLogId.of(ID), diff --git a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/worklog/PeriodTest.java b/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/worklog/PeriodTest.java index 8a35fc72..2b3ecbc0 100644 --- a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/worklog/PeriodTest.java +++ b/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/domain/worklog/PeriodTest.java @@ -31,7 +31,7 @@ class PeriodTest { // canonical constructor. Period is an immutable record, so the compact canonical // constructor is the SOLE construction path and there is no setter to bypass it — // no application-service or persistence path can hand out an invariant-violating - // Period. This is the "intentional bypass test" the branch note's 테스트 계약 requires. + // Period. This is the "intentional bypass test" the design record's 테스트 계약 requires. @Test void invariantIsEnforcedOnTheSoleConstructionPathAndCannotBeBypassed() { assertThatThrownBy(() -> new Period(LocalDate.of(2030, 12, 31), LocalDate.of(2030, 1, 1))) diff --git a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/SamplePortfolioTestApplication.java b/src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/SamplePortfolioTestApplication.java similarity index 100% rename from src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/SamplePortfolioTestApplication.java rename to src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/SamplePortfolioTestApplication.java diff --git a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/testinfra/PostgreSqlTestContainer.java b/src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/testinfra/PostgreSqlTestContainer.java similarity index 100% rename from src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/testinfra/PostgreSqlTestContainer.java rename to src/sample-portfolio/src/testFixtures/java/dev/caskeleton/sample/portfolio/testinfra/PostgreSqlTestContainer.java diff --git a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/contract/OpenApiDriftContractTest.java b/src/sample-portfolio/src/webSystemTest/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/contract/OpenApiDriftContractTest.java similarity index 99% rename from src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/contract/OpenApiDriftContractTest.java rename to src/sample-portfolio/src/webSystemTest/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/contract/OpenApiDriftContractTest.java index 62d9b0bb..49c5f22f 100644 --- a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/contract/OpenApiDriftContractTest.java +++ b/src/sample-portfolio/src/webSystemTest/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/contract/OpenApiDriftContractTest.java @@ -65,7 +65,7 @@ class OpenApiDriftContractTest { private static final String SNAPSHOT_RESOURCE = "/openapi/worklogs-openapi-snapshot.json"; private static final String SNAPSHOT_SOURCE_PATH = - "src/test/resources/openapi/worklogs-openapi-snapshot.json"; + "src/webSystemTest/resources/openapi/worklogs-openapi-snapshot.json"; private static final String WRITE_FLAG = "openapi.snapshot.write"; /** Sorts map keys so the snapshot is stable regardless of springdoc emission order. */ diff --git a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/date/DateHeaderContractTest.java b/src/sample-portfolio/src/webSystemTest/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/date/DateHeaderContractTest.java similarity index 100% rename from src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/date/DateHeaderContractTest.java rename to src/sample-portfolio/src/webSystemTest/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/date/DateHeaderContractTest.java diff --git a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/filter/VirtualThreadMdcE2ETest.java b/src/sample-portfolio/src/webSystemTest/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/filter/VirtualThreadMdcE2ETest.java similarity index 93% rename from src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/filter/VirtualThreadMdcE2ETest.java rename to src/sample-portfolio/src/webSystemTest/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/filter/VirtualThreadMdcE2ETest.java index 9f4581af..963cefe6 100644 --- a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/filter/VirtualThreadMdcE2ETest.java +++ b/src/sample-portfolio/src/webSystemTest/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/filter/VirtualThreadMdcE2ETest.java @@ -47,8 +47,8 @@ import org.springframework.web.bind.annotation.RestController; *

      2. the {@code requestId} the inbound filter set on MDC is visible to the controller (i.e., the * filter ran on the same virtual thread and the MDC value propagated through the filter chain * into the handler); - *
      3. when the client supplies {@code X-Request-Id}, the filter honours it and the controller - * sees the same value. + *
      4. when the client supplies {@code X-Request-Id}, the default trust policy replaces it with a + * server-assigned id and the controller/response header see that same assigned value. *
    * *

    Auto-configuration is narrowed to skip security so the demo endpoint is reachable without a @@ -106,7 +106,7 @@ class VirtualThreadMdcE2ETest { } @Test - void filterHonoursClientSuppliedRequestIdUnderVirtualThreads() { + void filterRejectsClientSuppliedRequestIdUnderVirtualThreads() { HttpHeaders headers = new HttpHeaders(); headers.set("X-Request-Id", "client-supplied-abc"); ResponseEntity> response = @@ -120,7 +120,9 @@ class VirtualThreadMdcE2ETest { assertThat(response.getStatusCode().is2xxSuccessful()).isTrue(); @SuppressWarnings("unchecked") Map body = (Map) response.getBody().get("data"); - assertThat(body.get("requestId")).isEqualTo("client-supplied-abc"); + String assigned = String.valueOf(body.get("requestId")); + assertThat(assigned).isNotBlank().isNotEqualTo("client-supplied-abc"); + assertThat(response.getHeaders().getFirst("X-Request-Id")).isEqualTo(assigned); } @SpringBootConfiguration diff --git a/src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/openapi/OpenApiSnapshotTest.java b/src/sample-portfolio/src/webSystemTest/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/openapi/OpenApiSnapshotTest.java similarity index 100% rename from src/sample-portfolio/src/test/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/openapi/OpenApiSnapshotTest.java rename to src/sample-portfolio/src/webSystemTest/java/dev/caskeleton/sample/portfolio/adapter/inbound/web/openapi/OpenApiSnapshotTest.java diff --git a/src/sample-portfolio/src/test/resources/openapi/worklogs-openapi-snapshot.json b/src/sample-portfolio/src/webSystemTest/resources/openapi/worklogs-openapi-snapshot.json similarity index 96% rename from src/sample-portfolio/src/test/resources/openapi/worklogs-openapi-snapshot.json rename to src/sample-portfolio/src/webSystemTest/resources/openapi/worklogs-openapi-snapshot.json index 8ea1e665..d58c22a7 100644 --- a/src/sample-portfolio/src/test/resources/openapi/worklogs-openapi-snapshot.json +++ b/src/sample-portfolio/src/webSystemTest/resources/openapi/worklogs-openapi-snapshot.json @@ -330,14 +330,6 @@ }, "post" : { "operationId" : "create", - "parameters" : [ { - "in" : "header", - "name" : "Idempotency-Key", - "required" : false, - "schema" : { - "type" : "string" - } - } ], "requestBody" : { "content" : { "application/json" : { @@ -483,14 +475,6 @@ "/worklogs:batchCreate" : { "post" : { "operationId" : "batchCreate", - "parameters" : [ { - "in" : "header", - "name" : "Idempotency-Key", - "required" : false, - "schema" : { - "type" : "string" - } - } ], "requestBody" : { "content" : { "application/json" : { diff --git a/src/shared-contract/build.gradle b/src/shared-contract/build.gradle index 0384cc17..2a32ddab 100644 --- a/src/shared-contract/build.gradle +++ b/src/shared-contract/build.gradle @@ -1,6 +1,5 @@ plugins { id 'ca.java-library' - id 'ca.auxiliary-source-set' } // Skeleton-wide operational contracts only. No business/domain concepts. @@ -8,23 +7,6 @@ plugins { dependencies { } -auxiliarySourceSets { - sourceSet('edgeRateLimitContractTest') { - compilesAgainst 'main' - inherits 'implementation', 'compileOnly', 'runtimeOnly' - } -} - -strictTestLanes { - lane('edgeRateLimitContractTest') { - // Its own source set is the selection; nothing else in this leaf can join the lane. - sourceSet = 'edgeRateLimitContractTest' - description = 'Runs the provider-neutral edge rate-limit shared contract.' - group = 'redis verification' - jvmArgs '-Duser.timezone=UTC' - } -} - def messagingSharedSchemaQualification = extensions.getByName('strictQualification').register( 'messagingSharedSchemaQualificationTest', sourceSets.test, diff --git a/src/shared-contract/src/main/java/dev/caskeleton/shared/activation/MasterSwitch.java b/src/shared-contract/src/main/java/dev/caskeleton/shared/activation/MasterSwitch.java index 24f9bc6d..72e973a7 100644 --- a/src/shared-contract/src/main/java/dev/caskeleton/shared/activation/MasterSwitch.java +++ b/src/shared-contract/src/main/java/dev/caskeleton/shared/activation/MasterSwitch.java @@ -5,7 +5,8 @@ import java.util.List; import java.util.Map; /** - * The five adapters this skeleton ships behind an explicit switch, and the names that address them. + * The runtime capabilities this skeleton ships behind an explicit switch, and the names that + * address them. * *

    One place knows the names. Spread across conditions as string literals, a rename becomes a * silent activation change: the condition stops matching, the adapter stops assembling, and nothing @@ -27,7 +28,15 @@ public enum MasterSwitch { NOTIFICATION_PLATFORM( "ca-skeleton.notification.platform.enabled", "APP_NOTIFICATION_PLATFORM_ENABLED"), /** The GraphQL transport boundary. */ - GRAPHQL("backend.graphql.enabled", "APP_GRAPHQL_ENABLED"); + GRAPHQL("backend.graphql.enabled", "APP_GRAPHQL_ENABLED"), + /** The shared Redis runtime substrate. */ + REDIS("app.redis.enabled", "APP_REDIS_ENABLED"), + /** The explicit Fileserver R2 publication capability. */ + FILESERVER("app.fileserver.enabled", "APP_FILESERVER_ENABLED"), + /** The HTTP upload/download Fileserver platform. */ + FILESERVER_PLATFORM("app.fileserver-platform.enabled", "APP_FILESERVER_PLATFORM_ENABLED"), + /** The outbound HTTP client platform. */ + HTTPCLIENT("app.httpclient.enabled", "APP_HTTPCLIENT_ENABLED"); private static final Map> SUPERSEDED = supersededProperties(); @@ -57,6 +66,10 @@ public enum MasterSwitch { // backend.graphql.deployment-mode. superseded.put(NOTIFICATION_PLATFORM, List.of()); superseded.put(GRAPHQL, List.of()); + superseded.put(REDIS, List.of()); + superseded.put(FILESERVER, List.of()); + superseded.put(FILESERVER_PLATFORM, List.of()); + superseded.put(HTTPCLIENT, List.of()); return Map.copyOf(superseded); } diff --git a/src/shared-contract/src/main/java/dev/caskeleton/shared/error/OperationalError.java b/src/shared-contract/src/main/java/dev/caskeleton/shared/error/OperationalError.java index 363aa56b..ed12d16a 100644 --- a/src/shared-contract/src/main/java/dev/caskeleton/shared/error/OperationalError.java +++ b/src/shared-contract/src/main/java/dev/caskeleton/shared/error/OperationalError.java @@ -52,6 +52,7 @@ public enum OperationalError implements ApiErrorCode { DB_UNAVAILABLE(Category.TRANSIENT_DEPENDENCY, 503, true), // 08* DB_SERIALIZATION_FAILURE(Category.CONFLICT, 409, true), // 40001 DB_DEADLOCK(Category.CONFLICT, 409, true), // 40P01 + DB_LOCK_TIMEOUT(Category.CONFLICT, 409, false), // 55P03 DB_NULL_VIOLATION(Category.DATA_INTEGRITY, 409, false), // 23502 DB_FK_VIOLATION(Category.DATA_INTEGRITY, 409, false), // 23503 DB_UNIQUE_VIOLATION(Category.CONFLICT, 409, false), // 23505 diff --git a/src/shared-contract/src/main/java/dev/caskeleton/shared/ratelimit/RateLimitDecision.java b/src/shared-contract/src/main/java/dev/caskeleton/shared/ratelimit/RateLimitDecision.java index 7b657a2e..fa59dcdc 100644 --- a/src/shared-contract/src/main/java/dev/caskeleton/shared/ratelimit/RateLimitDecision.java +++ b/src/shared-contract/src/main/java/dev/caskeleton/shared/ratelimit/RateLimitDecision.java @@ -49,7 +49,7 @@ public record RateLimitDecision( } public enum DecisionSource { - GLOBAL_REDIS + GLOBAL_SHARED_STORE } public enum DecisionCertainty { diff --git a/src/shared-contract/src/main/java/dev/caskeleton/shared/runtime/RuntimeEnvironment.java b/src/shared-contract/src/main/java/dev/caskeleton/shared/runtime/RuntimeEnvironment.java index 74532849..cd3bcd08 100644 --- a/src/shared-contract/src/main/java/dev/caskeleton/shared/runtime/RuntimeEnvironment.java +++ b/src/shared-contract/src/main/java/dev/caskeleton/shared/runtime/RuntimeEnvironment.java @@ -29,9 +29,11 @@ import java.util.Optional; *

    Three module families ask this question — the composition root, the Fileserver and HTTP client * platform configurations, and the object-storage adapter. {@code shared-contract} is the one leaf * all of them may depend on. It is also Java-stdlib-only, so this type cannot accept Spring's - * {@code Environment}; callers pass {@code List.of(environment.getActiveProfiles())} instead. That - * is not a workaround: it keeps the vocabulary testable without a container and usable from the - * {@code EnvironmentPostProcessor} phase, where no application context exists yet. + * {@code Environment}. Spring-aware composition code captures active profiles through + * app-bootstrap's {@code RuntimeProfileSnapshot} bridge and passes the resulting plain collection + * here. That keeps the vocabulary testable without a container and usable from the {@code + * EnvironmentPostProcessor} phase, where no application context exists yet, while preventing ad-hoc + * profile reads from reappearing throughout bootstrap code. * *

    The vendored {@code messaging:*} platform deliberately does not use this type. It depends on * no {@code shared-contract} type by design, and its own profile vocabulary is its own contract. diff --git a/src/shared-contract/src/test/java/dev/caskeleton/shared/activation/MasterSwitchParserTest.java b/src/shared-contract/src/test/java/dev/caskeleton/shared/activation/MasterSwitchParserTest.java index 1be11f0a..2d5e0672 100644 --- a/src/shared-contract/src/test/java/dev/caskeleton/shared/activation/MasterSwitchParserTest.java +++ b/src/shared-contract/src/test/java/dev/caskeleton/shared/activation/MasterSwitchParserTest.java @@ -67,15 +67,20 @@ class MasterSwitchParserTest { } @Test - @DisplayName("each switch carries its canonical env name") + @DisplayName("every switch has one unique operator-facing APP_* environment name") void environmentNamesAreCanonical() { - assertThat(MasterSwitch.PERSISTENCE_JPA.environmentVariable()) - .isEqualTo("APP_PERSISTENCE_JPA_ENABLED"); - assertThat(MasterSwitch.PERSISTENCE_MONGO.environmentVariable()) - .isEqualTo("APP_PERSISTENCE_MONGO_ENABLED"); - assertThat(MasterSwitch.MESSAGING.environmentVariable()).isEqualTo("APP_MESSAGING_ENABLED"); - assertThat(MasterSwitch.NOTIFICATION_PLATFORM.environmentVariable()) - .isEqualTo("APP_NOTIFICATION_PLATFORM_ENABLED"); + var names = + java.util.Arrays.stream(MasterSwitch.values()) + .map(MasterSwitch::environmentVariable) + .toList(); + + assertThat(names) + .allSatisfy( + name -> { + assertThat(name).startsWith("APP_").endsWith("_ENABLED"); + assertThat(name).doesNotContain("."); + }) + .doesNotHaveDuplicates(); assertThat(MasterSwitch.GRAPHQL.environmentVariable()).isEqualTo("APP_GRAPHQL_ENABLED"); } } diff --git a/src/shared-contract/src/edgeRateLimitContractTest/java/dev/caskeleton/shared/ratelimit/EdgeRateLimitProviderNeutralContractTest.java b/src/shared-contract/src/test/java/dev/caskeleton/shared/ratelimit/EdgeRateLimitProviderNeutralContractTest.java similarity index 100% rename from src/shared-contract/src/edgeRateLimitContractTest/java/dev/caskeleton/shared/ratelimit/EdgeRateLimitProviderNeutralContractTest.java rename to src/shared-contract/src/test/java/dev/caskeleton/shared/ratelimit/EdgeRateLimitProviderNeutralContractTest.java diff --git a/src/shared-contract/src/test/java/dev/caskeleton/shared/ratelimit/RateLimitContractTest.java b/src/shared-contract/src/test/java/dev/caskeleton/shared/ratelimit/RateLimitContractTest.java index ede64f17..61fb61c2 100644 --- a/src/shared-contract/src/test/java/dev/caskeleton/shared/ratelimit/RateLimitContractTest.java +++ b/src/shared-contract/src/test/java/dev/caskeleton/shared/ratelimit/RateLimitContractTest.java @@ -124,7 +124,7 @@ class RateLimitContractTest { resetAt, "login", "v3", - RateLimitDecision.DecisionSource.GLOBAL_REDIS, + RateLimitDecision.DecisionSource.GLOBAL_SHARED_STORE, RateLimitDecision.DecisionCertainty.CERTAIN); assertThat(new RateLimitOutcome.Evaluated(decision).decision()).isEqualTo(decision); @@ -154,7 +154,7 @@ class RateLimitContractTest { resetAt, "login", "v3", - RateLimitDecision.DecisionSource.GLOBAL_REDIS, + RateLimitDecision.DecisionSource.GLOBAL_SHARED_STORE, RateLimitDecision.DecisionCertainty.CERTAIN)) .isInstanceOf(IllegalArgumentException.class) .hasMessageContaining("remaining"); @@ -168,7 +168,7 @@ class RateLimitContractTest { resetAt, "login", "v3", - RateLimitDecision.DecisionSource.GLOBAL_REDIS, + RateLimitDecision.DecisionSource.GLOBAL_SHARED_STORE, RateLimitDecision.DecisionCertainty.CERTAIN)) .isInstanceOf(IllegalArgumentException.class) .hasMessageContaining("retryAfter");