설계: 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>
33 lines
1.5 KiB
Markdown
33 lines
1.5 KiB
Markdown
# OpenAPI 3.2: the experimental lane
|
|
|
|
## Why it is a lane rather than an upgrade
|
|
|
|
Generating 3.2 is cheap. Adopting it is not, and the two get conflated because the generated
|
|
document looks fine.
|
|
|
|
The value of an API description is entirely in what consumes it. A document in a version a client
|
|
generator does not fully understand does not fail — it produces a client that compiles and is wrong,
|
|
which is worse than no document at all.
|
|
|
|
So 3.1.2 stays the release artifact and 3.2 is generated beside it.
|
|
|
|
## The invariant
|
|
|
|
**Generating 3.2 must not change the 3.1 snapshot.** Both come from the same model, so a contributor
|
|
that mutates it on the way to 3.2 changes the artifact that is actually shipped — silently, and only
|
|
when 3.2 is generated.
|
|
|
|
Nothing in this repository checks it any more. `OpenApi32CompatibilityReport` and
|
|
`OpenApiToolchainMatrix` — the promotion report that hashed the snapshot and recorded which parser,
|
|
linter, generator and client compile had read the 3.2 output — were removed on 2026-09-25: they
|
|
lived in production code and only their own tests called them. A service that generates 3.2 with
|
|
`WebOpenApi32Generator` (library, `adapter:inbound:web-advanced`) owns that check in its own build.
|
|
|
|
Promotion stays a judgement, recorded in
|
|
`docs/adr/ADR-WEB-ADV-003-openapi-32-remains-experimental.md`.
|
|
|
|
## Running it
|
|
|
|
No workflow in this repository generates 3.2. `OpenApiVersionLane.STABLE_3_1` is the release
|
|
artifact; `WebOpenApi32GeneratorTest` covers the generator.
|