registry가 라이브러리 edge를 계속 막게 했다: 맨 위 library_groups, 행마다 allowed_libraries(설계 Q11 T2). 분리 전 프로젝트 edge 검사가 지키던 약속(bridge는 core-api만, Kafka capability는 starter-kafka를 runtimeOnly로만, 계층 leaf는 메시징을 모름)이 그대로 검사된다.
경로로 읽던 결합 셋을 풀었다: persistence-jpa migration 시험(라이브러리 jar의 db/migration을 풀어 읽는다), SpotBugs 제외, app.messaging 주인 계약 테스트(repo마다 자기 쪽 하나).
고른 방법과 버린 대안
migration 결합: 소스 폴더를 경로로 읽던 것을, 카탈로그가 고른 버전의 jar를 전용 configuration messagingMigrations(non-transitive)로 받아 Sync로 풀고 system property로 넘긴다. 버린 대안: jar를 testRuntimeOnly로 올려 classpath에서 읽기 — persistence-jpa 시험 컨텍스트의 Flyway가 classpath:db/migration 아래 메시징 migration까지 볼 위험.
registry 칸(T2): 방향 검사가 운영 선언(runtimeOnly 포함)과 compile-visible 소유 group 모듈을 대조한다. --include-build로 끼운 라이브러리 프로젝트는 그 좌표로 본다(같이 고치는 흐름에서도 같은 판정). 버린 대안: ArchUnit 패키지 규칙(T1) — runtimeOnly로 싣는 starter를 못 본다.
계약 테스트 나누기: MessagingPublicSurfaceContractTest는 라이브러리 repo(messaging-testkit의 repositoryContractTest lane)로 이력째 옮겼다. MessagingAuthorityContractTest는 이 repo의 주인 하나만 보고, 라이브러리 쪽 하나는 그 repo의 MessagingSettingsOwnerContractTest가 본다.
기록 문서: 메시징 설계서·계획서·납품 패키지(기록 8개)는 본문을 두고 머리 블록 「현재 정본」만 고쳤다(gRPC 때와 같은 이유: 기록은 그때 템플릿 코드를 두고 쓴 것).
auto-configuration 이름: 순서 제약(afterName/beforeName)이 플랫폼 root를 이름으로 부르므로 그 문자열도 dev.cakit.messaging…으로 바꿨다. 시험 stand-in도 같은 FQCN으로 옮겼다.
위험과 영향
파생 서비스: 메시징 코드를 import하거나 project(':messaging:…')을 쓴 서비스는 빌드가 깨진다(B-57·B-58에 옮기는 법). tech-log-backend는 플랫폼을 받은 적이 없어 해당 없음(설계 12절).
빌드가 Gitea에 기댄다: 캐시가 빈 빌드(새 기계, 이미지 builder의 verifyDependencyLocks)는 git.learn.hyeonworks.com에 닿아야 한다. 공개 owner라 토큰은 필요 없다(익명 200 확인).
동작: 같은 소스의 1.0.0이라 바뀌는 동작은 없다. 설정 키 app.messaging.*, env 키, Flyway 위치·파일, 표 이름은 그대로다.
라이브러리 쪽: 인증 manifest의 gitCommit을 라이브러리 커밋으로 갱신한 PR #1을 총괄이 병합한 뒤 그 커밋(8c6045e)에 v1.0.0을 달았다. 게시한 testkit jar의 증거가 템플릿 SHA를 가리키지 않는다.
검증
desktop(~/x3-template, 합친 트리 = 이 브랜치 head 7dc5725f(게이트) / 96836a64(장부 더함), --no-build-cache), 로그 ~/x3-messaging-library-logs/template/:
단계
게이트
rc
시험(XML)
PR
:ci :verifyDependencyLocks --warning-mode=fail
0
6,724(실패 0, skip 28)
PR
:verifyStrictLaneStages --dry-run, verify-compose-profile-contracts.sh, check-repo-layout.py, 문서 자기 시험·check-docs.py·work-docs·링크·리뷰 색인
첫 실행 2(github.com 504 넷, 기록 문서의 외부 링크), 다시 돌려 0(648 OK)
—
main
:mainCheck --continue --warning-mode=fail
0
417
main
configuration-cache 셋, :integrationCheck(879), :performanceCheck(26), http3(360), notification-platform pr 일곱
모두 0
main
compose smoke(18 lane 통과), 빠른 시작 bootstrap-local.sh(health 200/UP)
0
—
태그
:releaseCheck -PgitRevision=<head>
0
1
캐시: 모든 Gradle 명령에 --no-build-cache. 바깥 빌드 FROM-CACHE 0. mainCheck 로그의 FROM-CACHE 10은 verifyFeatureScaffold의 중첩 빌드 것이다.
숫자 대조: 앞 PR(#6) 대비 ci 시험이 665개, integrationCheck가 79개 줄었다. 라이브러리 repo로 간 메시징 모듈의 단위 시험 665개와 integration lane 79개(인증 37 + 신뢰성·starter 42)와 같다.
실행 위치: desktop 새 worktree ~/x3-gates(head 7dc5725f, 17:12~20:12 KST, 직전 부하는 summary 파일). 그 뒤 커밋 96836a64는 장부 줄 두 개뿐이다(문서 검사만 다시 돌렸다).
이 브랜치에서 RED→GREEN을 본 시험: build-logic functional 시험(runtimeOnly·compile-visible·--include-build), system caller 고정 시험 둘, 순서 시험 둘(제약을 지우면 실패), 편집 훅 N1 시험.
라이브러리: messaging-library runner main run 23·pr run 24·signing-check run 25·release run 28 success, desktop ci --rerun-tasks·mainCheck(인증 lane 37, integration 42)·releaseRehearsal 1.0.0 rc=0.
리뷰어가 볼 곳
src/build-logic/src/main/java/dev/caskeleton/buildlogic/{ModuleRegistry.java,architecture/VerifyModuleDependencyDirectionTask.java,architecture/ArchitecturePlugin.java}와 새 시험(ModuleRegistryTest 4, CleanArchitectureResolvedClasspathFunctionalTest 5).
## 무엇을, 왜
소유자 결정(2026-11-07): 템플릿 안에 프로젝트 계층이 아닌 라이브러리를 두지 않는다. 별도 repo로 관리하고 템플릿은 버전으로 받는다. gRPC는 앞 PR(#6)에서 옮겼고, 이번은 메시징이다.
- 메시징 플랫폼(`src/platforms/messaging`, 19개 모듈)은 이력째 [messaging-library](https://git.learn.hyeonworks.com/donghyeon.kang/messaging-library)로 옮겨 `dev.cakit.messaging` **1.0.0**으로 Gitea Packages에 게시했다(태그 `v1.0.0`, release run 28).
- 템플릿은 그 버전을 받는다: `src/settings.gradle`의 `exclusiveContent` 저장소(group `dev.cakit`와 그 아래만), 카탈로그 `messagingLibrary = "1.0.0"`과 모듈 여섯, 쓰는 leaf의 `project(':messaging:…')`을 좌표로, import `dev.caskeleton.messaging` → `dev.cakit.messaging`.
- 지운 것: `src/platforms/messaging`과 빈 `src/platforms/`, registry 19행, `messaging-certification.yml`, 카탈로그의 메시징 전용 항목(avro, cloudevents, protobuf 4.33.2), SpotBugs 제외의 메시징 줄, `docs/messaging/`, `check-repo-layout.py`의 `platforms`. 지운 경로는 `docs/upgrade/2026-11-maturity-review.md` B-57~B-59.
- registry가 라이브러리 edge를 계속 막게 했다: 맨 위 `library_groups`, 행마다 `allowed_libraries`(설계 Q11 T2). 분리 전 프로젝트 edge 검사가 지키던 약속(bridge는 core-api만, Kafka capability는 starter-kafka를 `runtimeOnly`로만, 계층 leaf는 메시징을 모름)이 그대로 검사된다.
- 경로로 읽던 결합 셋을 풀었다: persistence-jpa migration 시험(라이브러리 jar의 `db/migration`을 풀어 읽는다), SpotBugs 제외, `app.messaging` 주인 계약 테스트(repo마다 자기 쪽 하나).
## 고른 방법과 버린 대안
- **migration 결합**: 소스 폴더를 경로로 읽던 것을, 카탈로그가 고른 버전의 jar를 전용 configuration `messagingMigrations`(non-transitive)로 받아 `Sync`로 풀고 system property로 넘긴다. 버린 대안: jar를 `testRuntimeOnly`로 올려 classpath에서 읽기 — persistence-jpa 시험 컨텍스트의 Flyway가 `classpath:db/migration` 아래 메시징 migration까지 볼 위험.
- **registry 칸(T2)**: 방향 검사가 운영 선언(`runtimeOnly` 포함)과 compile-visible 소유 group 모듈을 대조한다. `--include-build`로 끼운 라이브러리 프로젝트는 그 좌표로 본다(같이 고치는 흐름에서도 같은 판정). 버린 대안: ArchUnit 패키지 규칙(T1) — `runtimeOnly`로 싣는 starter를 못 본다.
- **계약 테스트 나누기**: `MessagingPublicSurfaceContractTest`는 라이브러리 repo(`messaging-testkit`의 `repositoryContractTest` lane)로 이력째 옮겼다. `MessagingAuthorityContractTest`는 이 repo의 주인 하나만 보고, 라이브러리 쪽 하나는 그 repo의 `MessagingSettingsOwnerContractTest`가 본다.
- **기록 문서**: 메시징 설계서·계획서·납품 패키지(기록 8개)는 본문을 두고 머리 블록 「현재 정본」만 고쳤다(gRPC 때와 같은 이유: 기록은 그때 템플릿 코드를 두고 쓴 것).
- **auto-configuration 이름**: 순서 제약(`afterName`/`beforeName`)이 플랫폼 root를 이름으로 부르므로 그 문자열도 `dev.cakit.messaging…`으로 바꿨다. 시험 stand-in도 같은 FQCN으로 옮겼다.
## 위험과 영향
- **파생 서비스**: 메시징 코드를 import하거나 `project(':messaging:…')`을 쓴 서비스는 빌드가 깨진다(B-57·B-58에 옮기는 법). `tech-log-backend`는 플랫폼을 받은 적이 없어 해당 없음(설계 12절).
- **빌드가 Gitea에 기댄다**: 캐시가 빈 빌드(새 기계, 이미지 builder의 `verifyDependencyLocks`)는 `git.learn.hyeonworks.com`에 닿아야 한다. 공개 owner라 토큰은 필요 없다(익명 200 확인).
- **동작**: 같은 소스의 1.0.0이라 바뀌는 동작은 없다. 설정 키 `app.messaging.*`, env 키, Flyway 위치·파일, 표 이름은 그대로다.
- **라이브러리 쪽**: 인증 manifest의 gitCommit을 라이브러리 커밋으로 갱신한 PR #1을 총괄이 병합한 뒤 그 커밋(`8c6045e`)에 `v1.0.0`을 달았다. 게시한 testkit jar의 증거가 템플릿 SHA를 가리키지 않는다.
## 검증
desktop(`~/x3-template`, 합친 트리 = 이 브랜치 head `7dc5725f`(게이트) / `96836a64`(장부 더함), `--no-build-cache`), 로그 `~/x3-messaging-library-logs/template/`:
| 단계 | 게이트 | rc | 시험(XML) |
| --- | --- | --- | --- |
| PR | `:ci :verifyDependencyLocks --warning-mode=fail` | 0 | 6,724(실패 0, skip 28) |
| PR | `:verifyStrictLaneStages --dry-run`, `verify-compose-profile-contracts.sh`, `check-repo-layout.py`, 문서 자기 시험·`check-docs.py`·work-docs·링크·리뷰 색인 | 모두 0 | — |
| PR(경로) | build-logic `test`(183)·`check javadoc`, fileserver 다섯, MinIO(19), jpa pg16(432)·pg18(432)·migration(45) | 모두 0 | |
| PR(도구) | trivy fs HIGH·CRITICAL(메시징 leaf lockfile 포함 0건) | 0 | — |
| PR(도구) | lychee | 첫 실행 2(github.com 504 넷, 기록 문서의 외부 링크), 다시 돌려 0(648 OK) | — |
| main | `:mainCheck --continue --warning-mode=fail` | 0 | 417 |
| main | configuration-cache 셋, `:integrationCheck`(879), `:performanceCheck`(26), http3(360), notification-platform pr 일곱 | 모두 0 | |
| main | compose smoke(18 lane 통과), 빠른 시작 `bootstrap-local.sh`(health 200/UP) | 0 | — |
| 태그 | `:releaseCheck -PgitRevision=<head>` | 0 | 1 |
- 캐시: 모든 Gradle 명령에 `--no-build-cache`. 바깥 빌드 FROM-CACHE 0. `mainCheck` 로그의 FROM-CACHE 10은 `verifyFeatureScaffold`의 중첩 빌드 것이다.
- 숫자 대조: 앞 PR(#6) 대비 `ci` 시험이 665개, `integrationCheck`가 79개 줄었다. 라이브러리 repo로 간 메시징 모듈의 단위 시험 665개와 integration lane 79개(인증 37 + 신뢰성·starter 42)와 같다.
- 실행 위치: desktop 새 worktree `~/x3-gates`(head `7dc5725f`, 17:12~20:12 KST, 직전 부하는 summary 파일). 그 뒤 커밋 `96836a64`는 장부 줄 두 개뿐이다(문서 검사만 다시 돌렸다).
- 이 브랜치에서 RED→GREEN을 본 시험: build-logic functional 시험(runtimeOnly·compile-visible·--include-build), system caller 고정 시험 둘, 순서 시험 둘(제약을 지우면 실패), 편집 훅 N1 시험.
라이브러리: messaging-library runner main run 23·pr run 24·signing-check run 25·release run 28 success, desktop `ci --rerun-tasks`·`mainCheck`(인증 lane 37, integration 42)·`releaseRehearsal 1.0.0` rc=0.
## 리뷰어가 볼 곳
- `src/build-logic/src/main/java/dev/caskeleton/buildlogic/{ModuleRegistry.java,architecture/VerifyModuleDependencyDirectionTask.java,architecture/ArchitecturePlugin.java}`와 새 시험(`ModuleRegistryTest` 4, `CleanArchitectureResolvedClasspathFunctionalTest` 5).
- `src/adapter/outbound/persistence-jpa/build.gradle`(`messagingMigrations`), `MigrationTrees.java`.
- `src/config/architecture/modules.json`의 `allowed_libraries` 세 행.
- 기계적으로 만든 부분: 메시징 폴더 삭제(`git rm -r src/platforms`), import 바꾸기(`dev.caskeleton.messaging` → `dev.cakit.messaging` 문자열 치환 15파일), SpotBugs 줄 정리(메시징 `Class`/`Source`를 가진 Match만 지움), lockfile(`resolveAndLockAll --write-locks`).
## 관련
- design-docs `repo-structure/05-library-repos.md` 4·8·10·13·14절, 15절 결정과 「변경(2026-11-08)」
- messaging-library `CHANGELOG.md` 1.0.0, `docs/work/release.md`
- `docs/work/reference/related-repos.md`(관련 저장소), `docs/upgrade/2026-11-maturity-review.md` 3.9절
방향 검사(verifyModuleDependencyDirection)는 프로젝트 edge만 센다.
라이브러리가 별도 repo로 나가 외부 좌표가 되면, 지금 registry가
지키는 약속(메시징 bridge는 core-api만 본다, Kafka capability는
starter-kafka를 runtimeOnly로만 싣는다, 계층 leaf는 메시징을 모른다)을
아무것도 검사하지 않게 된다.
registry에 칸 둘을 더한다(설계 10.2절 T2, 소유자 승인 Q11).
- 맨 위 선택 칸 library_groups: 다스릴 Maven group 접두사.
- 행마다 선택 칸 allowed_libraries: group:artifact 목록. 꼴이 틀리거나,
library_groups 밖 group이거나, 겹치면 registry를 읽을 때 거절한다.
계층 leaf(domain-core, shared-contract, application-*) 행이 칸을
채우면 registry 위반이다. purity 검사가 비프로젝트 선언을 막는 것과
따로 registry 자체가 막는다.
- 방향 검사는 프로젝트 edge와 같은 방식으로 본다: 운영 선언
(api·implementation·compileOnly·runtimeOnly)의 소유 group 좌표와,
compileClasspath에서 보이는 소유 group 모듈(라이브러리 모듈이 api로
내보낸 것 포함)이 모두 칸에 있어야 한다. --include-build로 끼운
라이브러리 프로젝트는 프로젝트 edge가 아니라 그 좌표로 본다. 그래야
같이 고치는 흐름(composite build)에서도 같은 판정이 나온다. 「자기
빌드」는 ":"로 짐작하지 않고 해석 root의 build path로 읽는다(이 빌드가
다른 빌드에 끼워 돌아도 검사가 꺼지지 않게).
버린 대안: app-bootstrap ArchUnit 패키지 규칙(T1). import만 보고
runtimeOnly로 싣는 starter를 못 본다. 「어떤 모듈을 싣는가」는 빌드
사실이라 빌드 검사가 맞다.
위험: 시험 구성(testImplementation 등)은 프로젝트 edge처럼 보지 않는다.
이 빌드 자체를 다른 빌드에 끼우는 경우는 시험이 없다.
검증: desktop ./gradlew -p build-logic test rc=0. 새 시험: ModuleRegistryTest
4, CleanArchitectureResolvedClasspathFunctionalTest 7. functional 시험은
구현 전 RED였다(runtimeOnly·compile-visible 두 건은 게이트가 통과해
버렸고, --include-build 건은 「forbidden project dependencies
[demo-included]」로 실패).
Refs: design-docs repo-structure/05-library-repos.md 10.2절
템플릿 안에 프로젝트 계층이 아닌 메시징 플랫폼(src/platforms/messaging,
19개 모듈)이 있다. 소유자 결정(2026-11-07)은 라이브러리를 별도 repo에서
관리하고 템플릿은 버전으로 받는 것이다. 라이브러리는 이력째
messaging-library로 옮겨 dev.cakit.messaging 1.0.0으로 Gitea Packages에
게시했다(태그 v1.0.0 = 8c6045e, release run 28).
- 받는 법: src/settings.gradle에 exclusiveContent 저장소(group dev.cakit와
그 아래는 Gitea에서만, 나머지는 Maven Central에서만). 카탈로그
messagingLibrary = "1.0.0"과 쓰는 모듈 여섯.
- 쓰는 leaf: adapter:outbound:messaging, adapter:outbound:messaging-kafka,
adapter:inbound:messaging(admin exclude 좌표를 새 group으로), 시험만
composition:outbox-relay와 app-bootstrap architectureTest. import와
auto-configuration 이름 문자열 dev.caskeleton.messaging →
dev.cakit.messaging, 시험 stand-in도 같은 FQCN으로.
- persistence-jpa migration 시험이 라이브러리 소스 폴더를 경로
(../../../platforms/…)로 읽던 것을, 카탈로그 버전의 jar를 전용 구성
messagingMigrations(non-transitive)로 받아 db/migration을 풀어 읽게
했다. classpath에 올리면 그 leaf 시험의 Flyway가 메시징 migration까지
볼 수 있어 버렸다.
- registry: 메시징 19행을 지우고 library_groups ["dev.cakit"]와 쓰는 세
행의 allowed_libraries. 분리 전 프로젝트 edge 검사가 지키던 약속이
앞 커밋의 라이브러리 edge 검사로 그대로 남는다.
- 계약 테스트: MessagingPublicSurfaceContractTest는 라이브러리로 옮겼고,
MessagingAuthorityContractTest는 이 repo의 app.messaging 주인 하나만
본다(라이브러리 쪽 하나는 그 repo가 본다).
- system caller 규칙(ApplicationBoundaryArchitectureTest)의 「프로젝트
타입」에 dev.cakit.을 더했다. 메시지 handler가 구현하는 MessageHandler가
라이브러리 타입이 되면서, 그대로 두면 manual 09의 handler가
SYSTEM_CALLERS_HAVE_ONLY_PROJECT_SUPERTYPES에 걸리고 MessageHandler로
주입받는 endpoint를 USER_TRANSPORTS_DO_NOT_REACH_SYSTEM_CALLERS가
따라가지 못한다(구조 리뷰가 찾음).
- 순서 시험: 이름 정렬로도 라이브러리 root가 먼저 오게 되어 bridge 시험이
afterName을 지키지 못했다. stand-in을 맨 뒤 순서로 두고, inbox 쪽
beforeName을 지키는 시험을 더했다.
- 지움: src/platforms(와 빈 폴더), messaging-certification.yml, 카탈로그의
avro·cloudevents·protobuf 4.33.2, SpotBugs 제외의 메시징 줄,
check-repo-layout.py의 platforms. 편집 훅이 계층 leaf의 dev.cakit import를
알린다.
- lockfile: 바뀐 줄은 dev.cakit.messaging 좌표 추가 45줄뿐이다(외부
의존성 집합은 그대로, 설계 16절 H6).
버린 대안: 라이브러리 jar를 persistence-jpa testRuntimeOnly로 올려
classpath에서 읽기(위 이유). 템플릿에 docs/messaging 사본을 남기기
(라이브러리 문서와 갈라진다. 다음 커밋이 문서를 그 repo로 가리킨다).
위험: 캐시가 빈 빌드(새 기계, 이미지 builder)는 git.learn.hyeonworks.com에
닿아야 한다. 공개 owner라 토큰은 필요 없다(익명 200 확인). 이 커밋만으로는
살아 있는 문서가 지운 경로를 부른다(check-docs는 다음 커밋에서 통과).
검증: desktop에서 이 트리로 RED·GREEN(system caller 고정 시험 2건, 순서
시험 2건은 수정 전·제약 제거 시 실패, 수정 후 통과). 전체 게이트는
PR 본문.
BREAKING CHANGE: src/platforms/messaging과 project(':messaging:…') 경로가
없어졌다. dev.cakit.messaging:<모듈>:1.0.0 좌표로 받고 import를
dev.caskeleton.messaging → dev.cakit.messaging으로 바꾼다
(docs/upgrade/2026-11-maturity-review.md B-57~B-59).
Refs: design-docs repo-structure/05-library-repos.md 4·8·10·13절
앞 커밋이 메시징 플랫폼을 지웠지만 살아 있는 문서는 아직 src/platforms
경로와 docs/messaging/을 부른다. 기록 8개의 머리 블록 「현재 정본」도
지운 docs/messaging/support-matrix.md를 가리킨다.
- docs/messaging/(10개)을 지운다. 같은 이름의 파일이 이력째
messaging-library에 있다. 이 repo에서 그 내용을 부르던 문서(manual 09,
messaging-kafka README·AGENTS)는 그 repo 파일로 링크한다.
- 기록(설계서 3, 계획서 3, 납품 패키지 2): 본문은 두고 머리 블록만
고쳤다. 플랫폼을 다룬 것은 「없음 — messaging-library로 옮겼다」, 앱
쪽 발행·소비를 다룬 것은 docs/manual/09-outbox-events.md.
- docs/work/reference/related-repos.md: 관련 저장소 표(메시징 줄 채움),
라이브러리를 고치는 법, 템플릿에서 버전 올리는 법, 같이 고칠 때
composite build(Gradle 루트가 src/라 ../../messaging-library), registry
라이브러리 칸. 설계 14절이 근거다.
- src/config/architecture/README.md: library_groups·allowed_libraries 설명.
- docs/upgrade/2026-11-maturity-review.md 3.9절: B-57(지운 것), B-58(받는
법·패키지·auto-config 이름), B-59(registry 칸).
- 진입 문서와 지역 지침(AGENTS.md, README.md, delegate, decisions,
review-criteria, defect-patterns, gates, capability-status, manual 07,
build-logic·persistence-jpa·inbound messaging·shared-contract 지침,
env-keys 주석)에서 「들여온 제품」·src/platforms 문장을 별도 repo
라이브러리 문장으로 바꿨다.
위험: 다른 repo 파일을 가리키는 링크는 lychee가 외부 URL로 본다(공개
repo라 익명으로 읽힌다).
검증: python3 scripts/check-docs.py OK, check-work-docs.py OK(상대 링크
깨짐 0), check-repo-layout.py OK, python3 -m unittest discover -s
scripts/tests OK.
BREAKING CHANGE: docs/messaging/이 없어졌다. 메시징 문서는
messaging-library repo의 docs/messaging/에 있다.
Refs: design-docs repo-structure/05-library-repos.md 4.3·14절
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
소유자 결정(2026-11-07): 템플릿 안에 프로젝트 계층이 아닌 라이브러리를 두지 않는다. 별도 repo로 관리하고 템플릿은 버전으로 받는다. gRPC는 앞 PR(#6)에서 옮겼고, 이번은 메시징이다.
src/platforms/messaging, 19개 모듈)은 이력째 messaging-library로 옮겨dev.cakit.messaging1.0.0으로 Gitea Packages에 게시했다(태그v1.0.0, release run 28).src/settings.gradle의exclusiveContent저장소(groupdev.cakit와 그 아래만), 카탈로그messagingLibrary = "1.0.0"과 모듈 여섯, 쓰는 leaf의project(':messaging:…')을 좌표로, importdev.caskeleton.messaging→dev.cakit.messaging.src/platforms/messaging과 빈src/platforms/, registry 19행,messaging-certification.yml, 카탈로그의 메시징 전용 항목(avro, cloudevents, protobuf 4.33.2), SpotBugs 제외의 메시징 줄,docs/messaging/,check-repo-layout.py의platforms. 지운 경로는docs/upgrade/2026-11-maturity-review.mdB-57~B-59.library_groups, 행마다allowed_libraries(설계 Q11 T2). 분리 전 프로젝트 edge 검사가 지키던 약속(bridge는 core-api만, Kafka capability는 starter-kafka를runtimeOnly로만, 계층 leaf는 메시징을 모름)이 그대로 검사된다.db/migration을 풀어 읽는다), SpotBugs 제외,app.messaging주인 계약 테스트(repo마다 자기 쪽 하나).고른 방법과 버린 대안
messagingMigrations(non-transitive)로 받아Sync로 풀고 system property로 넘긴다. 버린 대안: jar를testRuntimeOnly로 올려 classpath에서 읽기 — persistence-jpa 시험 컨텍스트의 Flyway가classpath:db/migration아래 메시징 migration까지 볼 위험.runtimeOnly포함)과 compile-visible 소유 group 모듈을 대조한다.--include-build로 끼운 라이브러리 프로젝트는 그 좌표로 본다(같이 고치는 흐름에서도 같은 판정). 버린 대안: ArchUnit 패키지 규칙(T1) —runtimeOnly로 싣는 starter를 못 본다.MessagingPublicSurfaceContractTest는 라이브러리 repo(messaging-testkit의repositoryContractTestlane)로 이력째 옮겼다.MessagingAuthorityContractTest는 이 repo의 주인 하나만 보고, 라이브러리 쪽 하나는 그 repo의MessagingSettingsOwnerContractTest가 본다.afterName/beforeName)이 플랫폼 root를 이름으로 부르므로 그 문자열도dev.cakit.messaging…으로 바꿨다. 시험 stand-in도 같은 FQCN으로 옮겼다.위험과 영향
project(':messaging:…')을 쓴 서비스는 빌드가 깨진다(B-57·B-58에 옮기는 법).tech-log-backend는 플랫폼을 받은 적이 없어 해당 없음(설계 12절).verifyDependencyLocks)는git.learn.hyeonworks.com에 닿아야 한다. 공개 owner라 토큰은 필요 없다(익명 200 확인).app.messaging.*, env 키, Flyway 위치·파일, 표 이름은 그대로다.8c6045e)에v1.0.0을 달았다. 게시한 testkit jar의 증거가 템플릿 SHA를 가리키지 않는다.검증
desktop(
~/x3-template, 합친 트리 = 이 브랜치 head7dc5725f(게이트) /96836a64(장부 더함),--no-build-cache), 로그~/x3-messaging-library-logs/template/::ci :verifyDependencyLocks --warning-mode=fail:verifyStrictLaneStages --dry-run,verify-compose-profile-contracts.sh,check-repo-layout.py, 문서 자기 시험·check-docs.py·work-docs·링크·리뷰 색인test(183)·check javadoc, fileserver 다섯, MinIO(19), jpa pg16(432)·pg18(432)·migration(45):mainCheck --continue --warning-mode=fail:integrationCheck(879),:performanceCheck(26), http3(360), notification-platform pr 일곱bootstrap-local.sh(health 200/UP):releaseCheck -PgitRevision=<head>--no-build-cache. 바깥 빌드 FROM-CACHE 0.mainCheck로그의 FROM-CACHE 10은verifyFeatureScaffold의 중첩 빌드 것이다.ci시험이 665개,integrationCheck가 79개 줄었다. 라이브러리 repo로 간 메시징 모듈의 단위 시험 665개와 integration lane 79개(인증 37 + 신뢰성·starter 42)와 같다.~/x3-gates(head7dc5725f, 17:12~20:12 KST, 직전 부하는 summary 파일). 그 뒤 커밋96836a64는 장부 줄 두 개뿐이다(문서 검사만 다시 돌렸다).라이브러리: messaging-library runner main run 23·pr run 24·signing-check run 25·release run 28 success, desktop
ci --rerun-tasks·mainCheck(인증 lane 37, integration 42)·releaseRehearsal 1.0.0rc=0.리뷰어가 볼 곳
src/build-logic/src/main/java/dev/caskeleton/buildlogic/{ModuleRegistry.java,architecture/VerifyModuleDependencyDirectionTask.java,architecture/ArchitecturePlugin.java}와 새 시험(ModuleRegistryTest4,CleanArchitectureResolvedClasspathFunctionalTest5).src/adapter/outbound/persistence-jpa/build.gradle(messagingMigrations),MigrationTrees.java.src/config/architecture/modules.json의allowed_libraries세 행.git rm -r src/platforms), import 바꾸기(dev.caskeleton.messaging→dev.cakit.messaging문자열 치환 15파일), SpotBugs 줄 정리(메시징Class/Source를 가진 Match만 지움), lockfile(resolveAndLockAll --write-locks).관련
repo-structure/05-library-repos.md4·8·10·13·14절, 15절 결정과 「변경(2026-11-08)」CHANGELOG.md1.0.0,docs/work/release.mddocs/work/reference/related-repos.md(관련 저장소),docs/upgrade/2026-11-maturity-review.md3.9절템플릿 안에 프로젝트 계층이 아닌 메시징 플랫폼(src/platforms/messaging, 19개 모듈)이 있다. 소유자 결정(2026-11-07)은 라이브러리를 별도 repo에서 관리하고 템플릿은 버전으로 받는 것이다. 라이브러리는 이력째 messaging-library로 옮겨 dev.cakit.messaging 1.0.0으로 Gitea Packages에 게시했다(태그 v1.0.0 = 8c6045e, release run 28). - 받는 법: src/settings.gradle에 exclusiveContent 저장소(group dev.cakit와 그 아래는 Gitea에서만, 나머지는 Maven Central에서만). 카탈로그 messagingLibrary = "1.0.0"과 쓰는 모듈 여섯. - 쓰는 leaf: adapter:outbound:messaging, adapter:outbound:messaging-kafka, adapter:inbound:messaging(admin exclude 좌표를 새 group으로), 시험만 composition:outbox-relay와 app-bootstrap architectureTest. import와 auto-configuration 이름 문자열 dev.caskeleton.messaging → dev.cakit.messaging, 시험 stand-in도 같은 FQCN으로. - persistence-jpa migration 시험이 라이브러리 소스 폴더를 경로 (../../../platforms/…)로 읽던 것을, 카탈로그 버전의 jar를 전용 구성 messagingMigrations(non-transitive)로 받아 db/migration을 풀어 읽게 했다. classpath에 올리면 그 leaf 시험의 Flyway가 메시징 migration까지 볼 수 있어 버렸다. - registry: 메시징 19행을 지우고 library_groups ["dev.cakit"]와 쓰는 세 행의 allowed_libraries. 분리 전 프로젝트 edge 검사가 지키던 약속이 앞 커밋의 라이브러리 edge 검사로 그대로 남는다. - 계약 테스트: MessagingPublicSurfaceContractTest는 라이브러리로 옮겼고, MessagingAuthorityContractTest는 이 repo의 app.messaging 주인 하나만 본다(라이브러리 쪽 하나는 그 repo가 본다). - system caller 규칙(ApplicationBoundaryArchitectureTest)의 「프로젝트 타입」에 dev.cakit.을 더했다. 메시지 handler가 구현하는 MessageHandler가 라이브러리 타입이 되면서, 그대로 두면 manual 09의 handler가 SYSTEM_CALLERS_HAVE_ONLY_PROJECT_SUPERTYPES에 걸리고 MessageHandler로 주입받는 endpoint를 USER_TRANSPORTS_DO_NOT_REACH_SYSTEM_CALLERS가 따라가지 못한다(구조 리뷰가 찾음). - 순서 시험: 이름 정렬로도 라이브러리 root가 먼저 오게 되어 bridge 시험이 afterName을 지키지 못했다. stand-in을 맨 뒤 순서로 두고, inbox 쪽 beforeName을 지키는 시험을 더했다. - 지움: src/platforms(와 빈 폴더), messaging-certification.yml, 카탈로그의 avro·cloudevents·protobuf 4.33.2, SpotBugs 제외의 메시징 줄, check-repo-layout.py의 platforms. 편집 훅이 계층 leaf의 dev.cakit import를 알린다. - lockfile: 바뀐 줄은 dev.cakit.messaging 좌표 추가 45줄뿐이다(외부 의존성 집합은 그대로, 설계 16절 H6). 버린 대안: 라이브러리 jar를 persistence-jpa testRuntimeOnly로 올려 classpath에서 읽기(위 이유). 템플릿에 docs/messaging 사본을 남기기 (라이브러리 문서와 갈라진다. 다음 커밋이 문서를 그 repo로 가리킨다). 위험: 캐시가 빈 빌드(새 기계, 이미지 builder)는 git.learn.hyeonworks.com에 닿아야 한다. 공개 owner라 토큰은 필요 없다(익명 200 확인). 이 커밋만으로는 살아 있는 문서가 지운 경로를 부른다(check-docs는 다음 커밋에서 통과). 검증: desktop에서 이 트리로 RED·GREEN(system caller 고정 시험 2건, 순서 시험 2건은 수정 전·제약 제거 시 실패, 수정 후 통과). 전체 게이트는 PR 본문. BREAKING CHANGE: src/platforms/messaging과 project(':messaging:…') 경로가 없어졌다. dev.cakit.messaging:<모듈>:1.0.0 좌표로 받고 import를 dev.caskeleton.messaging → dev.cakit.messaging으로 바꾼다 (docs/upgrade/2026-11-maturity-review.md B-57~B-59). Refs: design-docs repo-structure/05-library-repos.md 4·8·10·13절