# Experimental 정책 ## Stable과 Experimental의 차이 **Stable**은 공통 Contract Suite(`MessagingAdapterContract`)를 변경 없이 통과한 어댑터다. 컴파일되는 어댑터가 아니라, 아래 7가지를 실제로 증명한 어댑터다. ```text publishesAndConfirms returnsAmbiguousWhenConfirmIsLost redeliversWhenSettlementIsLost preservesMessageIdAcrossRetryAndDlq keepsSourceUnsettledWhenDlqPublishFails rejectsOversizedPayloadBeforeTransport stopsAcceptingNewWorkDuringShutdown ``` **Experimental**은 아직 그 증명이 끝나지 않은 어댑터다. 현재 Experimental 어댑터는 없다. Kafka Share Group·Pulsar·NATS JetStream(Experimental), RabbitMQ, Spring Cloud Stream bridge(Optional)는 SDK 없는 seam이거나 선택할 수 없는 상태여서 2026-09-25에 삭제했다(`docs/capability-status.md` 제거 표). 이 문서는 새 어댑터를 들일 때 지킬 규칙이다. ## 규칙 ### 1. 기본 비활성 새 Experimental 어댑터는 자기 활성화 플래그를 가지고 기본값은 `false`다. 활성화하지 않으면 validator가 `MessagingCapabilityUnavailableException`을 던진다. Contract Suite가 아직 증명 중인 어댑터가 누군가의 기본 설정 때문에 load-bearing이 되어서는 안 된다. ### 2. Stable 모듈이 Experimental 모듈에 의존하지 않는다 Gradle 의존 그래프로 강제된다. Experimental leaf는 `messaging-spring-boot-starter`의 `allowed_dependencies`에 넣지 않는다. `verifyCleanArchitectureDependencies`가 위반을 빌드 실패로 만든다. ### 3. Core 계약을 바꾸지 않는다 Experimental 어댑터는 브로커의 차이를 `MessagingCapabilities`로 표현할 뿐, `messaging-core-api`의 타입을 바꾸지 않는다. ### 4. 없는 기능을 광고하지 않는다 Contract Suite로 증명하지 않은 capability는 `MessagingCapabilities`에서 `false`로 둔다. `false`인 capability를 요구하는 profile은 startup에서 실패한다. 조용히 약화되지 않는다. ## 승격 조건 Experimental → Stable로 올리려면 전부 필요하다. 1. `MessagingAdapterContract` 7개 테스트를 변경 없이 통과 2. 장애 주입(연결 끊김, confirm 유실, settlement 유실) 하에서 통과 3. 지원 브로커 버전 범위 명시 및 CI 검증 4. `support-matrix.md`의 capability 표 갱신 5. ADR 작성 6. 기본 활성화 여부에 대한 별도 결정