refactor(grpc)!: Maven group과 패키지를 dev.cakit.grpc로 바꾼다 #2

Merged
donghyeon.kang merged 3 commits from refactor/cakit-package into main 2026-11-08 05:16:30 +00:00
3 Commits
Author SHA1 Message Date
DongHyeonka eed2d152a5 build: Maven group을 dev.cakit.grpc로 바꾸고 남은 hyeonworks 이름을 지운다
pr / ci (pull_request) Successful in 4m0s
앞 커밋에서 패키지를 dev.cakit.grpc로 바꿨다. 배포 좌표(group)와 문서는
아직 com.hyeonworks.grpc였다.

- gradle.properties libraryGroup = dev.cakit.grpc(모든 모듈과 SBOM
  artifact의 group)
- README 받는 법(exclusiveContent 필터 dev.cakit), AGENTS.md, CHANGELOG
  옮기는 법, problem-statement, release.md, family AGENTS.md 둘
- SpotBugs 제외에서 템플릿 클래스(@RequiresPermission)를 가리키던 줄을
  지웠다. 이 repo에는 그런 bean이 없다

남긴 것: Gitea 주소 git.learn.hyeonworks.com(서버 주소), 기록
ADR-GRPC-002 본문의 「예전에는 hyeonworks」(기록 본문은 고치지 않는다).

검증: git grep -i hyeonworks에서 위 둘만 남는다. 빌드 게이트는 desktop
(이 PR 본문).
2026-11-08 14:08:45 +09:00
DongHyeonka d9d1cfb55a ci(buf): 선언한 깨지는 schema 변경만 bufBreaking을 통과시킨다
bufBreaking은 기준(PR이면 merge base, main이면 직전 커밋)과 schema를
비교해 깨짐이면 무조건 실패했다. 그래서 일부러 깨는 변경(바로 앞 커밋의
proto 패키지 이름 바꾸기 같은 것)은 PR도 병합 뒤 main도 빨갛게 만들고,
통과시킬 길이 기준을 손으로 바꾸는 것뿐이었다.

기준과 HEAD 사이 커밋 하나가 `BREAKING CHANGE:` 꼬리말로 선언하면
통과시킨다. 커밋 규칙이 이미 깨지는 변경에 요구하는 표시이고, 그 표시가
MAJOR 버전의 근거다(docs/work/release.md 2절). 선언 없는 깨짐은 전처럼
실패하고, 고치는 길(되돌리기 또는 선언)을 말한다.

버린 대안: 첫 릴리스 전에는 검사를 끄기(태그 뒤의 첫 깨짐을 놓친다),
마지막 릴리스 태그와 비교(한 번 선언한 깨짐 뒤로 다음 릴리스까지 모든
PR이 빨개진다).

검증(desktop): HEAD c8f8721(BREAKING CHANGE 선언)과 기준 bbe49ac — 깨짐을
알리고 rc=0. 같은 트리에 꼬리말 없는 메시지로 바꾼 버리는 사본 — rc=1과
안내. gates.md 4절에 규칙을 적었다.
2026-11-08 14:08:07 +09:00
DongHyeonka c8f87215a1 refactor(grpc)!: Java·proto 패키지를 dev.cakit.grpc로 바꾼다
41d73a1이 패키지를 com.hyeonworks.grpc로 바꿨다. 소유자(2026-11-08)가
개인 도메인 이름을 공용 라이브러리에 쓰지 않기로 했다. 원래 이름
dev.caskeleton.grpc로 되돌리면 템플릿 재사용 체크리스트(「dev.caskeleton을
자기 패키지로 바꾼다」)가 파생 서비스의 라이브러리 import까지 깨뜨린다
(설계 05 NS1의 단점). 그래서 개인 도메인도 템플릿 자리표시 이름도 아닌
중립 이름 cakit을 쓴다(총괄 결정, 소유자가 맡김).

- Java: com.hyeonworks.grpc → dev.cakit.grpc(폴더도 옮김)
- proto: package hyeonworks.grpc.common.v1 → cakit.grpc.common.v1,
  생성 Java 패키지 → cakit.grpc.common.v1.generated. proto 폴더도 Buf
  PACKAGE_DIRECTORY_MATCH에 맞게 옮겼다
- 시험의 가짜 서비스 이름(hyeonworks.document.v1 등)과 SpotBugs 제외의
  클래스 이름, AutoConfiguration.imports

생성 Java 패키지를 dev.cakit.grpc 아래로 두지 않은 이유: 「생성 코드는
손으로 쓴 루트와 겹치지 않는다」는 규칙을 GrpcContractGeneratedCodeTest가
고정한다. 이름만 바꾸는 이 커밋에서 그 규칙까지 바꾸지 않는다.

만든 법: git mv로 폴더를 옮기고 grpc·grpc-advanced·config/spotbugs의 추적
파일에서 com.hyeonworks → dev.cakit, 그 밖의 hyeonworks → cakit(Gitea 주소
git.learn.hyeonworks.com은 제외)으로 바꾼 뒤 desktop spotlessApply(rc=0)로
import 순서만 맞췄다.

위험: proto 패키지는 wire 이름이다. 아직 배포 전이라 깨질 소비자가 없다.

BREAKING CHANGE: Java 패키지 com.hyeonworks.grpc.* → dev.cakit.grpc.*,
proto 패키지 hyeonworks.grpc.common.v1 → cakit.grpc.common.v1. 배포한 버전이
없어 옮길 소비자는 없다.
Refs: design-docs repo-structure/05-library-repos.md 6.3절(Q3·Q4 정정은 총괄)
2026-11-08 14:06:58 +09:00