설계: docs/superpowers/specs/2026-09-25-capability-module-packaging-design.md
계획/진행 기록: docs/superpowers/plans/2026-09-25-capability-module-packaging.md
- Wave 0: 규칙 고정(AGENTS.md capability 완료 기준·테스트 규칙) + 차단 결함 7건
(compose overlay 검사, redis-sdk CI job, 적용된 V9/V13 원복 + V16, @EnableScheduling,
messaging bridge 순서, prod 에러 상세 validator, sample loggers read-only)
- Wave 1: 데이터·보안 Critical 10건 (durable operation 25P02, operation 유스케이스 이동,
outbox 재인코딩, Kafka TLS/SASL, 알림 트랜잭션, SNS 서명, tus checksum, GraphQL fragment,
Redis lane, gRPC FAILED_TERMINAL)
- Wave 2: 리팩터링 잔재·실험용 자리 삭제, outbox v1 fencing(V17), 멱등성 V2 정본화
- Wave 3: 라이브러리형 코드 정리(동작하지 않는 설정·인터페이스·gate 제거, web-advanced 분리)
- Wave 4: capability 11개를 "있으면 켜짐" 모듈로 포장, 끄는 장치 제거, 기본 조립 web-only,
qualificationBootJar 분리
- Wave 5: 빌드 로직 축소(17.2k -> 10.8k줄), sample 테스트 컨벤션 적용
삭제한 코드는 docs/capability-status.md "제거된 코드" 표에 복구 커밋(208077fd)과 함께 기록.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2.3 KiB
2.3 KiB
Messaging R2 자격(qualification) — 미구현
추적: MSG-015
상태
구현되지 않았다. R2 자격을 주장할 수 있는 근거가 없다.
- qualification producer 없음
- 대응하는 Test 태스크 없음
- 공통 스키마 validator 없음
따라서 config/messaging/readiness-cards.yaml의 카드는 모두 maturity: not-implemented다.
유일하게 implemented-candidate였던 json-schema-envelope.v1은 그 구현(adapter messaging의
JsonSchemaIntegrationEventEncoder와 verifyMessagingJsonSchemaV1)을 2026-09-25에 삭제하면서
not-implemented로 내렸다. 남은 evidence producer는 verifyMessagingContracts 하나다.
왜 Gradle 태스크를 미리 만들어 두지 않는가
2026-09 이전에는 루트 빌드가 아래 아홉 개 태스크 이름을 미리 등록해 두고, 그 본문이 입력과 무관하게 무조건 예외를 던졌다.
verifyMessagingPollingOutboxR2 verifyMessagingTargetBinding
verifyMessagingKafkaProducerR2 verifyMessagingDeploymentCutover
verifyMessagingSecurityR2 verifyMessagingCleanupTargetBinding
verifyMessagingReleaseProfile verifyMessagingFinalR2Profile
verifyMessagingTargetBindingPreflight
의도는 "fail-closed"였지만 결과는 다음과 같았다.
./gradlew tasks에 게이트처럼 보이는 이름 아홉 개가 나타난다.dependsOn으로 걸 수 있다. 거는 순간 그 레인은 영원히 빨간불이다.- 정상적인 입력으로도 성공할 수 없으므로 "검증"이 아니다.
즉 TODO를 Gradle 태스크 API로 표현한 것이었다. 미구현 사실을 기록하는 자리는 이 문서이고, 태스크는 실제로 통과할 수 있게 된 시점에 그 producer와 함께 추가한다.
구현 시 추가할 것
- 각 시나리오를 실제로 실행하는 Test 태스크.
- 그 실행 결과(JUnit XML)에서 payload-free manifest를 만드는 producer.
config/messaging/evidence/build-evidence-manifest-v1.schema.json으로 그 manifest 바이트를 검증하는 단계(build-toolsVerifyMessagingEvidenceTask가 쓰고 바로 검증한다).- 위 셋이 모두 생긴 다음에
verifyMessaging<Scenario>R2태스크 등록.
build-tools MessagingQualificationPlugin의 verifyMessagingContracts가 그 네 단계를 모두 갖춘
예시다.