DongHyeonkaandClaude Opus 5
ef947e5bb0
외부 리뷰("현재 상태를 유지하기 위한 검증이 너무 많고, 그 검증 자체를
다시 검증하는 구조까지 생겼다")를 설계 문서로 정리하고 코드로 반영한다.
설계·판단 근거는 docs/superpowers/specs/2026-09-16-verification-surface-reduction-design.md.
삭제
- .github/ci-gate-matrix.yml(1,025줄) + verify-gate-matrix.sh(568줄):
Gradle task graph와 workflow graph에 이미 있는 정보의 3중 복제
- verify-gradle-wrapper.sh(799줄): workflow 바이트 해시 잠금.
wrapper 검증은 gradle/actions/wrapper-validation(full SHA 핀)에 위임
- DeveloperExperienceContractTest 등의 CI YAML mutation 테스트:
애플리케이션 test suite가 GitHub Actions YAML 파서를 검증하던 계층 역전
- 문서 drift 파서: verifyReadmeCommands, verifyRunbookReferences,
verifyDocumentedLeafCount, verifyTestSourceSetRegistry
- 빈 레지스트리를 지키던 커스텀 YAML 파서: verifyTrivyignore,
verifyQuarantineSunset, flaky-quarantine.yaml
- verifyConfigurationPropertiesProcessor, verifyOneTypePerFile:
각각 ca.spring-config convention과 Checkstyle OneTopLevelClass가 대체
- 정상 입력으로도 성공할 수 없던 messaging always-fail task
- ModuleRegistry의 JSON 필드 집합 정확 일치, sample-portfolio negative guard
이동
- java/quality/spring 공통 설정을 configure(subprojects) 블록에서
ca.java-conventions / ca.quality-conventions / ca.java-library /
ca.spring-library convention plugin으로
- 아키텍처 검증을 ca.architecture로, JPA·messaging qualification을
gradle/qualification/ 아래로, verifyEnvKeys를 :app-bootstrap 소유로
완화
- Git revision은 releaseCheck·아카이브 생성에서만 요구. 일반 빌드는 SNAPSHOT
- SpotBugs/FindSecBugs는 로컬 check에서 빼고 qualityCheck 레인으로
task 계층
- leaf check는 그 leaf만. architectureCheck / qualityCheck /
configContractCheck / integrationCheck / ci / releaseCheck로 이름 분리
CI
- _reusable-gradle.yml 신규. checkout + wrapper validation + JDK/캐시 공통화
- fileserver-release.yml -> fileserver-certification.yml (CD가 아니라 certification)
- GitHub Actions = CI + artifact, Argo CD = CD 경계를 docs/ci-cd/boundary.md로 고정
순증감 +3,274 / -7,483.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
52 lines
2.3 KiB
YAML
52 lines
2.3 KiB
YAML
# The messaging platform's broker certification lane.
|
|
#
|
|
# Separate from ci-quality-gates.yml because it needs a container runtime and several minutes of it.
|
|
# The lane deliberately carries no Docker guard: every other container suite in the messaging tree
|
|
# skips with a stated reason when Docker is absent, and a certification lane that skipped would
|
|
# report success for a broker nobody started — which is the exact claim the evidence exists to rule
|
|
# out.
|
|
#
|
|
# The job runs the evidence gate rather than the lane, and the gate depends on the lane. What it
|
|
# proves is not only that the scenarios pass but that the committed manifest
|
|
# (messaging-testkit/src/main/resources/messaging/broker-certification-evidence.jsonl) is what this
|
|
# run produced, so "certified against a live broker" cannot be restored by editing a file.
|
|
name: messaging-certification
|
|
|
|
on:
|
|
pull_request:
|
|
paths:
|
|
- "src/messaging/**"
|
|
- ".github/workflows/messaging-certification.yml"
|
|
# Every Gradle job here installs its toolchain through this composite action, so a change to
|
|
# it changes what this gate runs.
|
|
- ".github/actions/setup-gradle-java/action.yml"
|
|
schedule:
|
|
- cron: "41 4 * * 3"
|
|
workflow_dispatch:
|
|
|
|
permissions:
|
|
contents: read
|
|
|
|
env:
|
|
# Reuse would hand one scenario the broker another scenario had already faulted.
|
|
TESTCONTAINERS_REUSE_ENABLE: "false"
|
|
|
|
jobs:
|
|
broker-certification:
|
|
runs-on: ubuntu-latest
|
|
steps:
|
|
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # actions/checkout@v4.2.2
|
|
- uses: ./.github/actions/setup-gradle-java
|
|
- name: Certify the Kafka adapter against a real broker
|
|
working-directory: src
|
|
# GITHUB_SHA is read by the lane and written into every evidence line, because "certified"
|
|
# is a claim about one source tree.
|
|
run: ./gradlew :messaging:messaging-kafka:verifyMessagingCertificationEvidence --no-daemon --stacktrace
|
|
- name: Publish the certification evidence
|
|
if: always()
|
|
uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # actions/upload-artifact@v4.6.2
|
|
with:
|
|
name: messaging-broker-certification-evidence
|
|
path: src/messaging/messaging-kafka/build/messaging-certification/
|
|
if-no-files-found: warn
|