설계: 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>
126 lines
5.0 KiB
YAML
126 lines
5.0 KiB
YAML
name: jpa-release
|
|
|
|
# The release registry is the gate-task source: jpaReleaseQualification reads its blocking gates,
|
|
# while JpaReleaseRenderingTest holds this file's matrix and promotion lists to the registry's Stable
|
|
# majors and verifyJpaReleaseGateTasks resolves each declared task against the real Gradle graph.
|
|
# CI therefore owns release scheduling, not a second JPA gate-task inventory.
|
|
#
|
|
# The matrix below is therefore not free to drift: editing it without editing the registry fails the
|
|
# unit lane.
|
|
|
|
on:
|
|
workflow_dispatch:
|
|
push:
|
|
tags:
|
|
- 'v*'
|
|
|
|
permissions:
|
|
contents: read
|
|
|
|
concurrency:
|
|
group: ${{ github.workflow }}-${{ github.ref }}
|
|
cancel-in-progress: false
|
|
|
|
jobs:
|
|
# One job per PostgreSQL major, because one job for three majors was one job for one major.
|
|
#
|
|
# `-Pjpa.matrix.versions=16,17,18` reached JpaPlatformContractSupport.start(), which started
|
|
# selectedVersions().get(0) — so twenty-eight integration classes ran against PG16 and nothing
|
|
# ran against 17 or 18, while docs/jpa/support-matrix.md recorded all three as "full contract
|
|
# suite, release lane". A JSONB mapping, a Hibernate dialect difference or a Flyway upgrade that
|
|
# only breaks on 18 shipped with a green release.
|
|
#
|
|
# start() now fails closed on a multi-version selection, so the fan-out is not optional: the
|
|
# matrix is the only way the three majors get covered, and removing a major from it removes the
|
|
# evidence rather than quietly reusing another major's.
|
|
jpa-release-gate:
|
|
runs-on: ubuntu-latest
|
|
timeout-minutes: 90
|
|
strategy:
|
|
fail-fast: false
|
|
matrix:
|
|
postgresql: ["16", "17", "18"]
|
|
steps:
|
|
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # actions/checkout@v4.2.2
|
|
- uses: ./.github/actions/setup-gradle-java
|
|
- name: Run the JPA database qualification set on PostgreSQL ${{ matrix.postgresql }}
|
|
working-directory: src
|
|
run: >-
|
|
./gradlew
|
|
jpaReleaseQualification
|
|
-Pjpa.matrix.versions=${{ matrix.postgresql }}
|
|
--stacktrace
|
|
- name: Record which major this evidence covers
|
|
if: always()
|
|
working-directory: src
|
|
run: |
|
|
mkdir -p build/jpa-release-evidence
|
|
{
|
|
echo "sha=${{ github.sha }}"
|
|
echo "ref=${{ github.ref }}"
|
|
echo "postgresql-major=${{ matrix.postgresql }}"
|
|
echo "task-set=jpa-database-qualification"
|
|
} > "build/jpa-release-evidence/manifest-${{ matrix.postgresql }}.properties"
|
|
- name: Upload the release evidence
|
|
if: always()
|
|
uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # actions/upload-artifact@v4.6.2
|
|
with:
|
|
name: jpa-release-evidence-pg${{ matrix.postgresql }}
|
|
path: |
|
|
src/build/jpa-release-evidence/manifest-${{ matrix.postgresql }}.properties
|
|
src/adapter/outbound/persistence-jpa/build/test-results/**/*.xml
|
|
retention-days: 30
|
|
if-no-files-found: error
|
|
|
|
# The promotion decision. Three majors' evidence, and all three must come from this SHA — an
|
|
# aggregate that accepted a re-run artifact from another commit would promote a release on
|
|
# evidence produced by different code.
|
|
jpa-release-promotion:
|
|
runs-on: ubuntu-latest
|
|
timeout-minutes: 15
|
|
needs: jpa-release-gate
|
|
steps:
|
|
- name: Download every major's evidence
|
|
uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # actions/download-artifact@v4.3.0
|
|
with:
|
|
pattern: jpa-release-evidence-pg*
|
|
path: evidence
|
|
- name: Require all three majors, all from this SHA
|
|
run: |
|
|
set -euo pipefail
|
|
missing=0
|
|
for major in 16 17 18; do
|
|
manifest=$(find evidence -name "manifest-${major}.properties" -print -quit)
|
|
if [ -z "${manifest}" ]; then
|
|
echo "::error::no release evidence for PostgreSQL ${major}"
|
|
missing=1
|
|
continue
|
|
fi
|
|
sha=$(sed -n 's/^sha=//p' "${manifest}")
|
|
if [ "${sha}" != "${{ github.sha }}" ]; then
|
|
echo "::error::PostgreSQL ${major} evidence is from ${sha}, not ${{ github.sha }}"
|
|
missing=1
|
|
fi
|
|
done
|
|
if [ "${missing}" -ne 0 ]; then
|
|
echo "::error::the release gate covers three PostgreSQL majors; promotion needs all three"
|
|
exit 1
|
|
fi
|
|
echo "PostgreSQL 16, 17 and 18 evidence all present and all from ${{ github.sha }}."
|
|
|
|
jpa-architecture-and-docs:
|
|
runs-on: ubuntu-latest
|
|
timeout-minutes: 30
|
|
steps:
|
|
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # actions/checkout@v4.2.2
|
|
- uses: ./.github/actions/setup-gradle-java
|
|
- name: Verify the release registry and the support matrix
|
|
working-directory: src
|
|
run: >-
|
|
./gradlew
|
|
:verifyJpaReleaseGateTasks
|
|
:verifyJpaReadinessRegistry
|
|
:adapter:outbound:persistence-jpa:test --tests '*JpaReleaseManifestTest'
|
|
|
|
--stacktrace
|