Author SHA1 Message Date
DongHyeonka ed8baf3a91 fix(release): 비밀번호 칸 검사 실패가 진단 결과에 들어가게 한다
pr / ci (pull_request) Successful in 3m36s
앞 커밋이 더한 「SIGNING_PASSWORD에 키 블록」 검사는 PROBLEM 줄만 내고
스크립트 종료 코드에 들어가지 않았다. 다른 검사가 같이 실패해 지금은 결과가
같지만, 이 검사만 걸리는 경우에는 통과로 보였을 것이다. 그 python 블록이
실패하면 fail=1이 되게 했다.

검증: 키 블록을 비밀번호로 준 경우 rc=1.
2026-11-08 15:30:34 +09:00
DongHyeonka f88f180ab6 fix(release): SIGNING_PASSWORD에 키 블록이 들어간 경우를 이름 댄다
pr / ci (pull_request) Successful in 3m40s
signing-check(run 15)가 남은 실패의 원인을 보였다. SIGNING_PASSWORD는
3,473글자에 줄바꿈 56개였다. 앞 run에서 base64를 푼 armored 키(3,474글자,
58줄)와 같은 모양이다. Gradle 서명기는 「checksum mismatch at in checksum
of 20 bytes」, 곧 틀린 비밀번호로 실패했다. 비밀번호 칸에 키가 들어갔다.

진단이 이 경우를 바로 말한다. 비밀번호에 「-----BEGIN PGP」가 있거나
1,000글자를 넘으면, 그것이 비밀번호가 아니라는 PROBLEM 줄을 낸다(값은
출력하지 않는다). release.md 1절에 SIGNING_PASSWORD는 키를 만들 때 정한
암호 한 줄이라고 적었다.

검증: 로컬 gpg로 armored 키를 비밀번호로 준 경우 PROBLEM 줄과 rc=1(아래
signing-check 실행).
2026-11-08 15:22:32 +09:00
DongHyeonka a892a45073 fix(release): 서명 진단이 비밀번호 모양을 알리고 Gradle 서명기로도 서명해 본다
pr / ci (pull_request) Successful in 3m34s
signing-check(run 13)에서 base64를 푼 키는 맞았다. armor·CRC24·tag 5가
정상이고, 가져온 키 지문이 릴리스 키 92646CEA…F791F8AB였다. 남은 실패는
「SIGNING_PASSWORD로 서명이 안 된다」 하나인데, 비밀번호가 틀렸는지,
붙여 넣을 때 줄바꿈·공백이 섞였는지, gpg 쪽 문제인지 가를 수 없었다.
gpg는 비밀번호의 첫 줄만 읽고 Gradle은 값 전체를 쓰므로, gpg 판정이
Gradle 판정과 다를 수도 있었다.

- check-signing-key.sh: 비밀번호의 모양(글자 수, 줄바꿈·CR 수, 앞뒤 공백,
  비ASCII 수)과 서명 실패 때의 gpg 상태 키워드만 출력한다. 값은 출력하지
  않는다.
- verifySigningKey: 스크립트 뒤에 Gradle의 in-memory 서명기
  (signing.signatory)로 몇 바이트를 서명해 본다. Sign 태스크와 같은 판정이다.
  실패 문구는 BouncyCastle 예외 문장뿐이다. 둘 중 하나라도 실패하면
  태스크가 실패한다.

검증(로컬 gpg, 버리는 키): 맞는 비밀번호 ok, 틀린 비밀번호 「gpg status:
BEGIN_SIGNING FAILURE KEY_CONSIDERED」. 끝에 줄바꿈이 붙은 비밀번호는 gpg로
ok이고 모양 줄이 「line breaks 1」을 알린다(Gradle 판정은 desktop과 runner).
2026-11-08 15:21:16 +09:00
DongHyeonka 97f7381aae fix(release): base64로 감싼 armored 서명 키도 받는다
pr / ci (pull_request) Successful in 3m37s
진단을 다시 돌리자(signing-check run 11) SIGNING_KEY가 바뀌어 있었다.
4,632글자 한 줄, base64로 읽으면 3,474바이트이고 그 첫 바이트가
`-`였다. 곧 armored 키 파일을 base64로 한 줄에 감싼 값이다(CI secret에
여러 줄 값을 넣을 때 흔히 쓰는 방법). Gradle의 useInMemoryPgpKeys는
armored 글만 읽어서 이 값도 「Could not read PGP secret key」로 실패한다.

build-logic SigningKeys.armoured가 값을 받아, armored 블록을 base64로
감싼 것이면 풀어서 돌려준다. 그 밖의 값은 그대로 돌려줘 원래 오류로
실패하게 한다. 모듈 서명(LibraryPublishingPlugin)과 SBOM 서명(루트
build.gradle)이 이것을 거친다. check-signing-key.sh도 같은 규칙으로 풀어
본다. 「form: base64 of an armoured key file」을 알리고 풀린 글로 나머지를
검사한다. 키는 gpg에 환경 변수 대신 임시 폴더(0700, 끝나면 지움)의 파일로
넘긴다.

버린 대안: 소유자에게 여러 줄로 다시 넣게 하기. 지금 값도 키로는 맞을 수
있고, base64 한 줄은 secret 저장소가 여러 줄을 망가뜨릴 때의 표준 우회다.

검증(desktop, 버리는 RSA 4096 키):
- SigningKeysTest: 클래스가 없어 컴파일 실패(RED) → 통과(GREEN)
- check-signing-key.sh: armored·base64 둘 다 rc=0, base64 + 틀린 암호
  rc=1, 지문 rc=1
- base64 키로 서명 리허설: rc=0, 서명된 artifact 10개, gpg --verify Good
  signature
2026-11-08 15:14:28 +09:00
DongHyeonka 732cb26eb5 fix(release): SIGNING_KEY에 지문이 들어간 경우를 이름 대고 넣는 법을 적는다
pr / ci (pull_request) Successful in 3m42s
signing-check(run 10)로 v1.0.0 서명 실패의 원인을 찾았다. SIGNING_KEY
secret은 40글자 한 줄이었고 BEGIN·END 줄이 없었다. base64로 읽으면 30바이트,
첫 패킷 tag 55(0x37)였다. 16진수 40글자 지문 `92…`를 base64로 읽으면
첫 바이트가 0xF7, 곧 tag 0x37이다. 비밀 키 대신 키 지문이 들어갔다.

- check-signing-key.sh: 값이 16진수 8·16·40글자(키 ID·지문)면 그렇다고
  말한다. 릴리스 키 지문과 같으면 그것도 말한다(공개 정보만 비교한다).
- release.md 1절: SIGNING_KEY에 넣을 것(export 파일 전체, 줄바꿈 그대로),
  넣는 곳, signing-check로 확인하는 법. 3절: 비밀 값을 바꾼 뒤 첫 태그 전에
  signing-check. 5절: 서명 실패 행. 아무것도 게시되지 않았으면 태그를 고친
  커밋으로 옮겨 같은 버전을 쓴다는 규칙(총괄 결정과 같게).

검증: 지문 40글자를 넣은 경우 rc=1과 「key ID or fingerprint (the release
key's fingerprint)」. 앞 커밋의 시험 다섯은 그대로 통과한다.
2026-11-08 15:07:06 +09:00
DongHyeonka 5e0c89dab4 ci(release): 서명 비밀 값을 값 없이 진단하는 verifySigningKey를 더한다
v1.0.0 release(run 9)가 :grpc:grpc-contract:signMavenPublication에서
「Could not read PGP secret key」로 멈췄다. 원인 사슬은 BouncyCastle의
「secret key ring doesn't start with secret key tag: tag 0x37」이다.
Gradle은 키 문자열이 망가진 경우와 비밀번호가 틀린 경우를 같은 문장으로
알리고, secret은 로그에서 볼 수 없어 무엇이 틀렸는지 가릴 길이 없었다.

scripts/release/check-signing-key.sh가 값을 출력하지 않고 본다:
- 모양: 글자·줄 수, CR, 「\n」 문자열, 비ASCII, 앞뒤 공백
- armour: 첫 줄 BEGIN, 끝 줄 END, BEGIN 뒤 빈 줄
- base64 본문: 줄 너비, CRC24가 checksum 줄과 맞는지, 첫 패킷이 비밀
  키(tag 5)인지
- gpg가 가져오는지, 가져온 키의 지문(공개 정보)이 릴리스 키인지
- SIGNING_PASSWORD로 서명되는지(성공/실패만)

Gradle 태스크 verifySigningKey가 이 스크립트를 부른다. `release`는 이것에
의존하고(서명 키가 있으면 releaseRehearsal도), 모든 Sign 태스크는 그 뒤에
돈다. release.yml은 그대로 한 줄이다. 태그 없이 돌리는 수동 workflow
signing-check.yml을 더했다. 릴리스 키 지문은 gradle.properties
signingKeyFingerprint다.

검증(desktop, 버리는 RSA 4096 키): 정상 키 rc=0(모든 칸 yes, 서명 ok).
base64 줄 하나 뺀 키·한 줄로 붙인 키·틀린 비밀번호·다른 키는 각각 rc=1과
그 원인 줄. 같은 BouncyCastle 1.81로 망가뜨린 모양별 오류를 재현했다.
줄 누락은 tag 0x1·0xc·0xf처럼 임의의 tag를 낸다. 한 줄로 붙이거나 공백·
「\n」이 섞이면 0xffffffff, 비밀번호가 틀리면 checksum mismatch다.
2026-11-08 15:05:04 +09:00
donghyeon.kang 7757f1e834 Merge pull request 'refactor(grpc)!: Maven group과 패키지를 dev.cakit.grpc로 바꾼다' (#2) from refactor/cakit-package into main
main / main-check (push) Successful in 3m45s
release / release (push) Failing after 1m8s
2026-11-08 05:16:30 +00:00
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
donghyeon.kang bbe49accf8 Merge pull request 'docs: 별도 repo 라이브러리로서의 지침·작업 문서·릴리스 절차를 쓴다' (#1) from docs/library-guides into main
main / main-check (push) Successful in 5m30s
2026-11-08 04:51:00 +00:00
330 changed files with 1295 additions and 939 deletions
+29
View File
@@ -0,0 +1,29 @@
# Checks the release signing secrets without cutting a tag (docs/work/release.md 5절). Manual only:
# run it after the owner puts SIGNING_KEY or SIGNING_PASSWORD in, and before tagging. It prints shapes
# and verdicts, never the secrets (scripts/release/check-signing-key.sh).
name: signing-check
on:
workflow_dispatch:
permissions:
contents: read
jobs:
signing-check:
runs-on: ubuntu-latest
timeout-minutes: 20
steps:
- uses: https://github.com/actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
- uses: https://github.com/actions/setup-java@c5195efecf7bdfc987ee8bae7a71cb8b11521c00 # v4.7.1
with:
distribution: temurin
java-version: "21.0.11+10.0.LTS"
- uses: https://github.com/gradle/actions/setup-gradle@3f131e8634966bd73d06cc69884922b02e6faf92 # v6
with:
build-scan-publish: false
cache-read-only: true
- run: ./gradlew verifySigningKey --stacktrace
env:
SIGNING_KEY: ${{ secrets.SIGNING_KEY }}
SIGNING_PASSWORD: ${{ secrets.SIGNING_PASSWORD }}
+1 -1
View File
@@ -1,6 +1,6 @@
# AGENTS.md — grpc-library의 정본
Spring Boot 앱에 gRPC 서버·클라이언트를 붙이는 플랫폼 라이브러리다(Maven group `com.hyeonworks.grpc`). 백엔드 템플릿에서 2026-11-08에 이력째 옮겨 왔다. 왜 따로 두는지와 받는 법은 `README.md`, 풀 문제는 `docs/problem-statement.md`다.
Spring Boot 앱에 gRPC 서버·클라이언트를 붙이는 플랫폼 라이브러리다(Maven group `dev.cakit.grpc`). 백엔드 템플릿에서 2026-11-08에 이력째 옮겨 왔다. 왜 따로 두는지와 받는 법은 `README.md`, 풀 문제는 `docs/problem-statement.md`다.
## 꼭 지킬 것 — 하나라도 어기면 동작해도 완료가 아니다
+3 -3
View File
@@ -10,7 +10,7 @@
템플릿 안 코드를 직접 썼다면(템플릿 기준 커밋 `22df3525` 이전):
- Java 패키지: `dev.caskeleton.grpc.*` → `com.hyeonworks.grpc.*`. import를 바꾼다.
- proto 패키지: `caskeleton.grpc.common.v1` → `hyeonworks.grpc.common.v1`, 생성 Java 패키지 `caskeleton.grpc.common.v1.generated` → `hyeonworks.grpc.common.v1.generated`. proto는 wire 이름이므로 상대편도 함께 바꾼다.
- Gradle: `project(':grpc:<모듈>')` → `com.hyeonworks.grpc:<모듈>:1.0.0`(저장소 선언은 README 「받는 법」).
- Java 패키지: `dev.caskeleton.grpc.*` → `dev.cakit.grpc.*`. import를 바꾼다. 템플릿 재사용 체크리스트의 `dev.caskeleton` 일괄 바꾸기와 겹치지 않게 다른 이름을 쓴다.
- proto 패키지: `caskeleton.grpc.common.v1` → `cakit.grpc.common.v1`, 생성 Java 패키지 `caskeleton.grpc.common.v1.generated` → `cakit.grpc.common.v1.generated`. proto는 wire 이름이므로 상대편도 함께 바꾼다.
- Gradle: `project(':grpc:<모듈>')` → `dev.cakit.grpc:<모듈>:1.0.0`(저장소 선언은 README 「받는 법」).
- 설정 키 `app.grpc.platform.*`와 Flyway 위치 `db/migration/grpc`는 그대로다.
+4 -4
View File
@@ -12,7 +12,7 @@ Spring Boot 앱에 gRPC 서버·클라이언트를 붙이는 플랫폼 라이브
## 받는 법
Maven group은 `com.hyeonworks.grpc`, artifact는 모듈 이름 그대로다(`grpc-core-api`, `grpc-runtime`, `grpc-spring-boot-starter`, …). 저장소는 소유자 Gitea Packages이고, 공개라 읽을 때 토큰이 필요 없다.
Maven group은 `dev.cakit.grpc`, artifact는 모듈 이름 그대로다(`grpc-core-api`, `grpc-runtime`, `grpc-spring-boot-starter`, …). 저장소는 소유자 Gitea Packages이고, 공개라 읽을 때 토큰이 필요 없다.
```groovy
// settings.gradle
@@ -22,7 +22,7 @@ dependencyResolutionManagement {
forRepository {
maven { url = 'https://git.learn.hyeonworks.com/api/packages/donghyeon.kang/maven' }
}
filter { includeGroupByRegex 'com\\.hyeonworks(\\..*)?' }
filter { includeGroupByRegex 'dev\\.cakit(\\..*)?' }
}
mavenCentral()
}
@@ -32,11 +32,11 @@ dependencyResolutionManagement {
```groovy
// build.gradle
dependencies {
implementation 'com.hyeonworks.grpc:grpc-spring-boot-starter:1.0.0'
implementation 'dev.cakit.grpc:grpc-spring-boot-starter:1.0.0'
}
```
`exclusiveContent`는 `com.hyeonworks` group을 이 저장소에서만, 나머지는 Maven Central에서만 찾게 한다. 같은 이름을 공개 저장소에 올리는 공격이 통하지 않고, Gitea가 느려도 다른 의존성 해석에는 영향이 없다.
`exclusiveContent`는 `dev.cakit` group을 이 저장소에서만, 나머지는 Maven Central에서만 찾게 한다. 같은 이름을 공개 저장소에 올리는 공격이 통하지 않고, Gitea가 느려도 다른 의존성 해석에는 영향이 없다.
## 지원 표
@@ -13,6 +13,7 @@ import org.gradle.api.publish.PublishingExtension;
import org.gradle.api.publish.maven.MavenPublication;
import org.gradle.api.publish.maven.tasks.PublishToMavenRepository;
import org.gradle.authentication.http.HttpHeaderAuthentication;
import org.gradle.plugins.signing.Sign;
import org.gradle.plugins.signing.SigningExtension;
/**
@@ -36,7 +37,8 @@ import org.gradle.plugins.signing.SigningExtension;
* the versions its own resolution chose ({@code versionMapping}), and the plugin's POM
* customization, which would add the BOM imports a consumer never inherits, is off.
*
* <p>Signing: with {@code SIGNING_KEY} (an ASCII-armoured PGP secret key) and {@code
* <p>Signing: with {@code SIGNING_KEY} (an ASCII-armoured PGP secret key, or the base64 of one;
* {@link SigningKeys}) and {@code
* SIGNING_PASSWORD} in the environment, every published file gets an {@code .asc}. Without them
* nothing is signed, and a task that uploads to {@code gitea} fails before it starts: an unsigned
* release is not a release.
@@ -137,7 +139,8 @@ public final class LibraryPublishingPlugin implements Plugin<Project> {
.dir("staging-repository"));
});
String signingKey = project.getProviders().environmentVariable("SIGNING_KEY").getOrElse("");
String signingKey =
SigningKeys.armoured(project.getProviders().environmentVariable("SIGNING_KEY").getOrElse(""));
String signingPassword =
project.getProviders().environmentVariable("SIGNING_PASSWORD").getOrElse("");
boolean signed = !signingKey.isBlank();
@@ -145,6 +148,9 @@ public final class LibraryPublishingPlugin implements Plugin<Project> {
SigningExtension signing = project.getExtensions().getByType(SigningExtension.class);
signing.useInMemoryPgpKeys(signingKey, signingPassword);
signing.sign(publication);
// The root's verifySigningKey says what is wrong with a key before Gradle's signing reports
// it only as "Could not read PGP secret key".
project.getTasks().withType(Sign.class).configureEach(task -> task.mustRunAfter(":verifySigningKey"));
}
// Nothing leaves the machine before the release checks have passed, and nothing reaches Gitea
@@ -0,0 +1,42 @@
package dev.caskeleton.buildlogic.publishing;
import java.nio.charset.StandardCharsets;
import java.util.Base64;
/**
* The ASCII-armoured key Gradle's in-memory signatory reads, from what a CI secret holds.
*
* <p>A secret store keeps a multi-line value badly or not at all, so the common practice is to put
* the armoured key file in base64 on one line ({@code base64 -w0 signing-key.asc}). Gradle's {@code
* useInMemoryPgpKeys} reads only the armoured text and reports the base64 form as "Could not read
* PGP secret key" (v1.0.0 release run 9 and the secret put in after it). Both forms are accepted:
* a value that decodes to an armoured private key block is unwrapped, anything else is passed on
* unchanged, so a wrong value still fails, and {@code verifySigningKey} says why.
*/
public final class SigningKeys {
private static final String BEGIN = "-----BEGIN PGP PRIVATE KEY BLOCK-----";
private SigningKeys() {}
/**
* The armoured key: {@code value} itself, or the armoured block it is the base64 of.
*
* @param value the secret as given (armoured, base64 of the armoured file, or anything else)
* @return the armoured key, or {@code value} unchanged when it is neither form
*/
public static String armoured(String value) {
if (value == null || value.isBlank() || value.contains(BEGIN)) {
return value;
}
String compact = value.replaceAll("\\s", "");
if (!compact.matches("[A-Za-z0-9+/]+={0,2}")) {
return value;
}
try {
String decoded = new String(Base64.getDecoder().decode(compact), StandardCharsets.UTF_8);
return decoded.strip().startsWith(BEGIN) ? decoded : value;
} catch (IllegalArgumentException notBase64) {
return value;
}
}
}
@@ -0,0 +1,41 @@
package dev.caskeleton.buildlogic.publishing;
import static org.assertj.core.api.Assertions.assertThat;
import java.nio.charset.StandardCharsets;
import java.util.Base64;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
class SigningKeysTest {
private static final String ARMOURED =
"-----BEGIN PGP PRIVATE KEY BLOCK-----\n\nlQdGBGrv1SYBEADGgq8C\n=abcd\n"
+ "-----END PGP PRIVATE KEY BLOCK-----\n";
@Test
@DisplayName("armour 그대로인 키는 바꾸지 않는다")
void anArmouredKeyIsUsedAsItIs() {
assertThat(SigningKeys.armoured(ARMOURED)).isEqualTo(ARMOURED);
}
@Test
@DisplayName("armour 파일을 base64로 감싼 값은 풀어서 armour로 쓴다")
void aBase64WrappedArmouredKeyIsUnwrapped() {
String wrapped = Base64.getEncoder().encodeToString(ARMOURED.getBytes(StandardCharsets.UTF_8));
assertThat(SigningKeys.armoured(wrapped)).isEqualTo(ARMOURED);
assertThat(SigningKeys.armoured(wrapped.substring(0, 40) + "\n" + wrapped.substring(40)))
.isEqualTo(ARMOURED);
}
@Test
@DisplayName("지문이나 armour가 아닌 base64는 그대로 두어 서명이 원래 오류로 실패하게 한다")
void anythingElseIsLeftAlone() {
String fingerprint = "92646CEAFE816CF8B9C249F0A1C936D7F791F8AB";
String otherBase64 = Base64.getEncoder().encodeToString("not a key".getBytes(StandardCharsets.UTF_8));
assertThat(SigningKeys.armoured(fingerprint)).isEqualTo(fingerprint);
assertThat(SigningKeys.armoured(otherBase64)).isEqualTo(otherBase64);
assertThat(SigningKeys.armoured("")).isEmpty();
}
}
+46 -1
View File
@@ -1,4 +1,5 @@
import dev.caskeleton.buildlogic.java.JavaConventionsPlugin
import dev.caskeleton.buildlogic.publishing.SigningKeys
plugins {
id 'ca.architecture'
@@ -190,7 +191,47 @@ publishing {
}
}
def signingKey = providers.environmentVariable('SIGNING_KEY').getOrElse('')
// The armoured key, or the base64 of the armoured file (the usual way to keep it in a CI secret).
def signingKey = SigningKeys.armoured(providers.environmentVariable('SIGNING_KEY').getOrElse(''))
// Before anything is signed: the secret's shape, that gpg imports it as the release key and that
// SIGNING_PASSWORD signs with it, printing no part of either. Gradle's signing reports every one of
// these as "Could not read PGP secret key" (v1.0.0 release run 9); this says which. A key other
// than the release key passes with -PsigningKeyFingerprint=<its fingerprint> (a rehearsal key).
// gpg reads only a passphrase's first line and Gradle the whole value, so the task then signs a few
// bytes with Gradle's own signatory: the verdict is the one the Sign tasks would reach.
tasks.register('verifySigningKey', Exec) {
group = 'verification'
description = 'Checks SIGNING_KEY and SIGNING_PASSWORD without printing them (scripts/release/check-signing-key.sh).'
outputs.upToDateWhen { false }
ignoreExitValue = true
commandLine 'bash', file('scripts/release/check-signing-key.sh'),
providers.gradleProperty('signingKeyFingerprint').getOrElse('')
def signed = !signingKey.isBlank()
doLast {
boolean scriptPassed = executionResult.get().exitValue == 0
boolean gradlePassed = !signed
String verdict = 'skipped: no SIGNING_KEY'
if (signed) {
try {
signing.signatory.sign(new ByteArrayInputStream('signing check'.bytes), OutputStream.nullOutputStream())
gradlePassed = true
verdict = 'ok'
} catch (Exception failure) {
// Exception text only: BouncyCastle names what failed (checksum mismatch, a tag), never the key.
def cause = failure.cause ? " (${failure.cause.class.simpleName}: ${failure.cause.message})" : ''
verdict = "failed: ${failure.message}${cause}"
}
}
logger.lifecycle("signing as Gradle's Sign tasks do (in-memory key): ${verdict}")
if (!scriptPassed || !gradlePassed) {
throw new GradleException('verifySigningKey: the signing secrets would not sign; the PROBLEM lines above say why.')
}
}
}
tasks.withType(Sign).configureEach {
mustRunAfter tasks.named('verifySigningKey')
}
if (!signingKey.isBlank()) {
signing {
useInMemoryPgpKeys(signingKey, providers.environmentVariable('SIGNING_PASSWORD').getOrElse(''))
@@ -220,6 +261,9 @@ tasks.register('releaseRehearsal') {
group = 'release'
description = 'releaseCheck, then publishes every module and the SBOM to build/staging-repository and checks the files.'
dependsOn tasks.named('releaseCheck')
if (!signingKey.isBlank()) {
dependsOn tasks.named('verifySigningKey')
}
dependsOn tasks.named('publishAllPublicationsToStagingRepository')
dependsOn leafPaths.collect { "${it}:publishAllPublicationsToStagingRepository" }
def staging = layout.buildDirectory.dir('staging-repository')
@@ -244,6 +288,7 @@ tasks.register('release') {
group = 'release'
description = 'releaseCheck, publish to Gitea Packages, then verify the version is readable anonymously.'
dependsOn tasks.named('releaseCheck')
dependsOn tasks.named('verifySigningKey')
dependsOn tasks.named('publishAllPublicationsToGiteaRepository')
dependsOn leafPaths.collect { "${it}:publishAllPublicationsToGiteaRepository" }
def url = providers.gradleProperty('packagesUrl')
+10 -15
View File
@@ -78,17 +78,12 @@
<!-- CT_CONSTRUCTOR_THROW (finalizer attack: a subclass's finalize() keeps a half-built object).
A final class cannot be attacked this way, and every class that could be made final was.
These three groups must stay subclassable. -->
<!-- CT group 1 — CGLIB proxies. @RequiresPermission is enforced by a method-security advisor,
and Spring Boot proxies with CGLIB, which subclasses the bean
(RequiresPermissionProxyabilityTest fails the build if such a class is final). The
Annotation matcher covers every class annotated at class level, including ones added
later. A class that annotates only some methods is proxied all the same but is not matched
here; name it when one appears. A @Configuration class is CGLIB-subclassed for its @Bean
methods for the same reason. -->
<!-- CT group 1 — CGLIB proxies. A @Configuration class is CGLIB-subclassed for its @Bean
methods, so it must stay subclassable. (The template's copy also names its
@RequiresPermission beans here; this library has none.) -->
<Match>
<Bug pattern="CT_CONSTRUCTOR_THROW" />
<Or>
<Annotation name="com.hyeonworks.application.security.RequiresPermission" />
<Annotation name="org.springframework.context.annotation.Configuration" />
</Or>
</Match>
@@ -100,7 +95,7 @@
<Match>
<Bug pattern="CT_CONSTRUCTOR_THROW" />
<Or>
<Class name="com.hyeonworks.grpc.api.error.GrpcPlatformException" />
<Class name="dev.cakit.grpc.api.error.GrpcPlatformException" />
</Or>
</Match>
<!-- FindSecBugs REDOS, one Match per constructor or static initialiser. Every pattern flagged
@@ -114,11 +109,11 @@
<Bug pattern="REDOS" />
<Or>
<And>
<Class name="com.hyeonworks.grpc.core.GrpcChannelProfileName" />
<Class name="dev.cakit.grpc.core.GrpcChannelProfileName" />
<Method name="&lt;clinit&gt;" />
</And>
<And>
<Class name="com.hyeonworks.grpc.core.GrpcServiceName" />
<Class name="dev.cakit.grpc.core.GrpcServiceName" />
<Method name="&lt;clinit&gt;" />
</And>
</Or>
@@ -134,11 +129,11 @@
<Bug pattern="REDOS" />
<Or>
<And>
<Class name="com.hyeonworks.grpc.api.context.GrpcMetadataKey" />
<Class name="dev.cakit.grpc.api.context.GrpcMetadataKey" />
<Method name="&lt;clinit&gt;" />
</And>
<And>
<Class name="com.hyeonworks.grpc.advanced.discovery.GrpcResolverSafetyPolicy" />
<Class name="dev.cakit.grpc.advanced.discovery.GrpcResolverSafetyPolicy" />
<Method name="&lt;clinit&gt;" />
</And>
</Or>
@@ -157,7 +152,7 @@
<Bug pattern="UNSAFE_HASH_EQUALS" />
<Or>
<And>
<Class name="com.hyeonworks.grpc.admin.GrpcPlatformSnapshotService" />
<Class name="dev.cakit.grpc.admin.GrpcPlatformSnapshotService" />
<Method name="~lambda\$driftAgainstRelease\$\d+" />
</And>
</Or>
@@ -169,7 +164,7 @@
grpc-testkit, which no production leaf depends on. -->
<Match>
<Bug pattern="COMMAND_INJECTION" />
<Class name="com.hyeonworks.grpc.testkit.netty.GrpcTlsTestMaterial" />
<Class name="dev.cakit.grpc.testkit.netty.GrpcTlsTestMaterial" />
<Method name="runKeytool" />
</Match>
</FindBugsFilter>
+1 -1
View File
@@ -39,4 +39,4 @@
## 되돌릴 수 없는 결정
- 배포한 버전은 지우지 않는다(`docs/work/release.md` 2절). 같은 버전은 다시 올릴 수 없다.
- Maven group `com.hyeonworks.grpc`와 proto 패키지 `hyeonworks.grpc.*`. 바꾸면 모든 소비자의 MAJOR다. 근거는 design-docs `repo-structure/05-library-repos.md` 6.3절.
- Maven group `dev.cakit.grpc`와 proto 패키지 `cakit.grpc.*`. 바꾸면 모든 소비자의 MAJOR다. 근거는 design-docs `repo-structure/05-library-repos.md` 6.3절.
+16 -4
View File
@@ -21,12 +21,23 @@ main 병합 ──> 소유자가 태그 vX.Y.Z push ──> .gitea/workflows/rel
| --- | --- | --- |
| `PACKAGE_TOKEN` | Gitea 개인 토큰. 권한은 `package` 읽기·쓰기만(repository·user 권한 없음). Gitea job 토큰(`GITEA_TOKEN`)은 패키지를 올릴 수 없어서 사람 토큰이 필요하다 | Gitea 웹 → 설정 → 애플리케이션에서 새로 만들어 secret을 덮어쓰고 옛 토큰을 지운다 |
| `SIGNING_KEY` | 서명용 PGP 비밀 키(ASCII armor 전체). 두 라이브러리(grpc, messaging)가 같은 키를 쓴다 | 새 키 쌍을 만들고 README 「서명」의 공개 키와 지문을 같은 PR에서 바꾼다. 만료(2028-11-07) 전에 한다 |
| `SIGNING_PASSWORD` | 그 키의 암호 | 키와 함께 |
| `SIGNING_PASSWORD` | 그 키를 만들 때 정한 암호 한 줄. 키 파일이나 그 base64가 아니다 | 키와 함께 |
- 이름: 설계(design-docs `repo-structure/05-library-repos.md` 7절)는 `PACKAGES_TOKEN`이라고 적었지만, 등록된 이름 `PACKAGE_TOKEN`에 workflow와 빌드를 맞췄다. 소유자에게 다시 등록을 부탁하지 않는다.
- 서명 키: RSA 4096, 지문 `92646CEAFE816CF8B9C249F0A1C936D7F791F8AB`, 2028-11-07 만료. 공개 키는 README 「서명」이다.
- 첫 태그는 `v1.0.0`이다(3절).
**`SIGNING_KEY`에 넣는 것**은 키 지문이나 키 ID(16진수 40·16·8글자)가 아니라 비밀 키 파일 전체다. 파일 그대로(여러 줄)나 그 파일을 base64로 한 줄로 만든 값(`base64 -w0 signing-key.asc`) 둘 다 된다. 빌드가 base64를 풀어 쓴다(`SigningKeys`).
```bash
gpg --armor --export-secret-keys 92646CEAFE816CF8B9C249F0A1C936D7F791F8AB > signing-key.asc
```
1. `signing-key.asc`를 열어 첫 줄 `-----BEGIN PGP PRIVATE KEY BLOCK-----`부터 끝 줄 `-----END PGP PRIVATE KEY BLOCK-----`까지 줄바꿈 그대로 복사한다. RSA 4096 키면 100줄 남짓이다.
2. Gitea → 그 repo(grpc-library, messaging-library 둘 다) → 설정 → Actions → Secrets → `SIGNING_KEY`를 고쳐 붙여 넣는다.
3. Actions → `signing-check` → Run workflow(main). 로그에 `PROBLEM` 줄이 없고 `gpg import: ok, secret key fingerprint 92646CEA…F791F8AB`, `signing with SIGNING_PASSWORD: ok`가 나오면 된다. 이 workflow는 값을 출력하지 않는다(`scripts/release/check-signing-key.sh`).
4. `signing-key.asc`를 지운다(`shred -u signing-key.asc`).
## 2. 버전 규칙
- SemVer, repo 하나에 버전 하나. 모든 모듈이 같은 버전으로 나간다. 태그는 `vMAJOR.MINOR.PATCH`이고 접미사(`-rc.1` 등)는 없다. 다른 모양의 태그는 `ca.java-conventions`가 빌드 전에 거부한다.
@@ -39,7 +50,7 @@ main 병합 ──> 소유자가 태그 vX.Y.Z push ──> .gitea/workflows/rel
1. main이 초록인지 본다(main.yml 마지막 실행).
2. `CHANGELOG.md`에 그 버전 절을 쓰고 PR로 병합한다.
3. 올리기 전까지를 desktop에서 미리 돌려 본다(비밀 값 없이, 4절).
3. 올리기 전까지를 desktop에서 미리 돌려 본다(비밀 값 없이, 4절). 비밀 값을 넣거나 바꾼 뒤 첫 태그라면 `signing-check` workflow도 한 번 돌린다(1절).
4. 태그를 단다.
```bash
@@ -50,7 +61,7 @@ main 병합 ──> 소유자가 태그 vX.Y.Z push ──> .gitea/workflows/rel
git push origin v1.0.0
```
5. release.yml 실행이 초록인지 Gitea Actions 화면에서 본다. 마지막 줄들에 모듈마다 `published: com.hyeonworks.grpc:<모듈>:<버전>`이 찍힌다.
5. release.yml 실행이 초록인지 Gitea Actions 화면에서 본다. 마지막 줄들에 모듈마다 `published: dev.cakit.grpc:<모듈>:<버전>`이 찍힌다.
6. 템플릿이 이 라이브러리를 쓰게 되면(지금은 쓰지 않는다) 템플릿 PR로 카탈로그 버전을 올린다. 절차는 템플릿 `docs/work/reference/related-repos.md`다.
## 4. 올리기 직전까지 미리 돌리기
@@ -65,7 +76,8 @@ scripts/verify.sh release --on desktop
| 어디서 | 뜻 | 할 일 |
| --- | --- | --- |
| 1~4단계 | 아무것도 올라가지 않았다 | 고쳐서 main에 병합하고 같은 태그 이름을 새 커밋에 다시 달지 않는다. 다음 PATCH 태그를 쓴다 |
| 1~4단계, 서명 | 아무것도 올라가지 않았다 | 고쳐서 main에 병합한다. 그 버전의 파일이 Packages에 하나도 없으면(`maven-metadata.xml`에 없음) 태그를 지우고 고친 main 커밋에 같은 태그를 다시 단다. 하나라도 올라갔으면 다음 PATCH를 쓴다 |
| 서명 직전 `verifySigningKey`, 또는 `Could not read PGP secret key` | 서명 비밀 값이 키로 읽히지 않는다 | `signing-check` workflow의 `PROBLEM` 줄이 원인이다(지문을 넣음, 줄바꿈 잃음, BEGIN·END 줄 빠짐, base64 손상, 다른 키, 암호 칸에 키를 넣음, 틀린 암호). 1절대로 다시 넣는다 |
| 5단계 중간 | 일부 모듈만 올라갔을 수 있다 | 그 버전은 버린다(지우지 않는다). 원인을 고치고 다음 PATCH를 낸다. `CHANGELOG.md`에 버린 버전을 적는다 |
| 6단계 | 올라갔지만 익명으로 안 읽힌다 | owner 공개 설정을 확인한다. 템플릿 이미지 빌드가 토큰 없이 읽는다는 전제(설계 8.3절 R1)가 깨진 것이다 |
+3 -1
View File
@@ -1,8 +1,10 @@
# The Maven group every module publishes under, and where. ca.java-conventions refuses a build
# without libraryGroup; ca.library-publishing reads the other two.
libraryGroup=com.hyeonworks.grpc
libraryGroup=dev.cakit.grpc
packagesUrl=https://git.learn.hyeonworks.com/api/packages/donghyeon.kang/maven
repositoryUrl=https://git.learn.hyeonworks.com/donghyeon.kang/grpc-library
# The release signing key (public fingerprint). verifySigningKey refuses any other key in SIGNING_KEY.
signingKeyFingerprint=92646CEAFE816CF8B9C249F0A1C936D7F791F8AB
# Build defaults, copied from the backend template's src/gradle.properties.
org.gradle.workers.max=4
+1 -1
View File
@@ -43,7 +43,7 @@ property key는 `app.grpc.advanced.<capability>.enabled`이고 전부 기본 off
## Leaf별 담당 capability
| leaf | 패키지(`com.hyeonworks.grpc.advanced.*`) | capability |
| leaf | 패키지(`dev.cakit.grpc.advanced.*`) | capability |
| --- | --- | --- |
| `grpc-advanced` | `bootstrap` | capability grade, feature flag, module guard, capability별 promotion gate |
| `grpc-advanced` | `edition` | Protobuf Edition 2024 opt-in lane, Edition 2026 watch lane |
@@ -1,6 +1,6 @@
package com.hyeonworks.grpc.advanced.integration;
package dev.cakit.grpc.advanced.integration;
import com.hyeonworks.grpc.api.context.GrpcMetadataKey;
import dev.cakit.grpc.api.context.GrpcMetadataKey;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.Set;
@@ -1,6 +1,6 @@
package com.hyeonworks.grpc.advanced.integration;
package dev.cakit.grpc.advanced.integration;
import com.hyeonworks.grpc.api.context.GrpcRequestContext;
import dev.cakit.grpc.api.context.GrpcRequestContext;
import java.util.Map;
import org.springframework.messaging.Message;
import org.springframework.messaging.support.MessageBuilder;
@@ -1,6 +1,6 @@
package com.hyeonworks.grpc.advanced.integration;
package dev.cakit.grpc.advanced.integration;
import com.hyeonworks.grpc.api.context.GrpcMetadataKey;
import dev.cakit.grpc.api.context.GrpcMetadataKey;
import java.util.Map;
import org.springframework.messaging.Message;
@@ -1,7 +1,7 @@
package com.hyeonworks.grpc.advanced.kotlin;
package dev.cakit.grpc.advanced.kotlin;
import com.hyeonworks.grpc.deadline.GrpcCancellationCoordinator;
import com.hyeonworks.grpc.deadline.GrpcCancellationReason;
import dev.cakit.grpc.deadline.GrpcCancellationCoordinator;
import dev.cakit.grpc.deadline.GrpcCancellationReason;
import java.time.Instant;
import java.util.function.Supplier;
@@ -45,7 +45,7 @@ public final class GrpcCoroutineContextBridge {
throw new IllegalArgumentException("a cancellable operation needs a name");
}
coordinator.register(
new com.hyeonworks.grpc.deadline.GrpcCancellableOperation() {
new dev.cakit.grpc.deadline.GrpcCancellableOperation() {
@Override
public String name() {
return operationName;
@@ -1,7 +1,7 @@
package com.hyeonworks.grpc.advanced.reactor;
package dev.cakit.grpc.advanced.reactor;
import com.hyeonworks.grpc.deadline.GrpcCancellationCoordinator;
import com.hyeonworks.grpc.deadline.GrpcCancellationReason;
import dev.cakit.grpc.deadline.GrpcCancellationCoordinator;
import dev.cakit.grpc.deadline.GrpcCancellationReason;
import java.time.Instant;
import java.util.function.Supplier;
import reactor.core.Disposable;
@@ -46,7 +46,7 @@ public final class GrpcReactorCancellationBridge {
throw new IllegalArgumentException("a cancellable operation needs a name");
}
coordinator.register(
new com.hyeonworks.grpc.deadline.GrpcCancellableOperation() {
new dev.cakit.grpc.deadline.GrpcCancellableOperation() {
@Override
public String name() {
return operationName;
@@ -1,6 +1,6 @@
package com.hyeonworks.grpc.advanced.reactor;
package dev.cakit.grpc.advanced.reactor;
import com.hyeonworks.grpc.context.GrpcContextSnapshot;
import dev.cakit.grpc.context.GrpcContextSnapshot;
import java.util.Optional;
import reactor.util.context.Context;
import reactor.util.context.ContextView;
@@ -16,7 +16,7 @@ import reactor.util.context.ContextView;
*/
public final class GrpcReactorContextBridge {
private static final String CONTEXT_KEY = "com.hyeonworks.grpc.contextSnapshot";
private static final String CONTEXT_KEY = "dev.cakit.grpc.contextSnapshot";
private GrpcReactorContextBridge() {}
@@ -1,6 +1,6 @@
package com.hyeonworks.grpc.advanced.reactor;
package dev.cakit.grpc.advanced.reactor;
import com.hyeonworks.grpc.context.GrpcContextSnapshot;
import dev.cakit.grpc.context.GrpcContextSnapshot;
import java.util.List;
import java.util.function.Supplier;
import reactor.core.publisher.Flux;
@@ -1,7 +1,7 @@
package com.hyeonworks.grpc.advanced.reactor;
package dev.cakit.grpc.advanced.reactor;
import com.hyeonworks.grpc.api.context.GrpcRequestContext;
import com.hyeonworks.grpc.context.GrpcContextSnapshot;
import dev.cakit.grpc.api.context.GrpcRequestContext;
import dev.cakit.grpc.context.GrpcContextSnapshot;
import java.util.function.BiFunction;
import reactor.core.publisher.Mono;
import reactor.core.scheduler.Scheduler;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.web;
package dev.cakit.grpc.advanced.web;
import java.util.Set;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.web;
package dev.cakit.grpc.advanced.web;
import java.util.ArrayList;
import java.util.List;
@@ -1,6 +1,6 @@
package com.hyeonworks.grpc.advanced.web;
package dev.cakit.grpc.advanced.web;
import com.hyeonworks.grpc.core.RpcType;
import dev.cakit.grpc.core.RpcType;
/**
* Which RPC shapes gRPC-Web can actually carry.
@@ -1,12 +1,12 @@
package com.hyeonworks.grpc.advanced.compat;
package dev.cakit.grpc.advanced.compat;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
import com.hyeonworks.grpc.advanced.kotlin.GrpcCoroutineContextBridge;
import com.hyeonworks.grpc.api.deadline.GrpcCancellationToken;
import com.hyeonworks.grpc.deadline.GrpcCancellationCoordinator;
import com.hyeonworks.grpc.deadline.GrpcCancellationReason;
import dev.cakit.grpc.advanced.kotlin.GrpcCoroutineContextBridge;
import dev.cakit.grpc.api.deadline.GrpcCancellationToken;
import dev.cakit.grpc.deadline.GrpcCancellationCoordinator;
import dev.cakit.grpc.deadline.GrpcCancellationReason;
import java.time.Instant;
import java.util.concurrent.atomic.AtomicBoolean;
import org.junit.jupiter.api.DisplayName;
@@ -1,20 +1,20 @@
package com.hyeonworks.grpc.advanced.compat;
package dev.cakit.grpc.advanced.compat;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
import com.hyeonworks.grpc.advanced.integration.GrpcIntegrationBridgePolicy;
import com.hyeonworks.grpc.advanced.integration.GrpcIntegrationInboundGateway;
import com.hyeonworks.grpc.advanced.integration.GrpcIntegrationOutboundGateway;
import com.hyeonworks.grpc.api.context.GrpcClientIdentity;
import com.hyeonworks.grpc.api.context.GrpcMetadataBudget;
import com.hyeonworks.grpc.api.context.GrpcMetadataKey;
import com.hyeonworks.grpc.api.context.GrpcRequestContext;
import com.hyeonworks.grpc.api.deadline.GrpcCancellationToken;
import com.hyeonworks.grpc.api.deadline.GrpcDeadlineBudget;
import com.hyeonworks.grpc.api.deadline.GrpcDeadlineProfile;
import com.hyeonworks.grpc.core.GrpcMethodName;
import com.hyeonworks.grpc.core.RpcType;
import dev.cakit.grpc.advanced.integration.GrpcIntegrationBridgePolicy;
import dev.cakit.grpc.advanced.integration.GrpcIntegrationInboundGateway;
import dev.cakit.grpc.advanced.integration.GrpcIntegrationOutboundGateway;
import dev.cakit.grpc.api.context.GrpcClientIdentity;
import dev.cakit.grpc.api.context.GrpcMetadataBudget;
import dev.cakit.grpc.api.context.GrpcMetadataKey;
import dev.cakit.grpc.api.context.GrpcRequestContext;
import dev.cakit.grpc.api.deadline.GrpcCancellationToken;
import dev.cakit.grpc.api.deadline.GrpcDeadlineBudget;
import dev.cakit.grpc.api.deadline.GrpcDeadlineProfile;
import dev.cakit.grpc.core.GrpcMethodName;
import dev.cakit.grpc.core.RpcType;
import java.time.Duration;
import java.util.Map;
import java.util.Set;
@@ -27,7 +27,7 @@ class GrpcIntegrationBridgePolicyTest {
private static final GrpcMetadataKey CORRELATION = GrpcMetadataKey.ascii("x-correlation-id");
private static final GrpcMethodName GET =
GrpcMethodName.parse("hyeonworks.document.v1.DocumentService/GetDocument");
GrpcMethodName.parse("cakit.document.v1.DocumentService/GetDocument");
private static GrpcRequestContext requestContext() {
return GrpcRequestContext.create(
@@ -1,21 +1,21 @@
package com.hyeonworks.grpc.advanced.compat;
package dev.cakit.grpc.advanced.compat;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
import com.hyeonworks.grpc.advanced.reactor.GrpcReactorCancellationBridge;
import com.hyeonworks.grpc.advanced.reactor.GrpcReactorContextBridge;
import com.hyeonworks.grpc.api.context.GrpcClientIdentity;
import com.hyeonworks.grpc.api.context.GrpcMetadataBudget;
import com.hyeonworks.grpc.api.context.GrpcRequestContext;
import com.hyeonworks.grpc.api.deadline.GrpcCancellationToken;
import com.hyeonworks.grpc.api.deadline.GrpcDeadlineBudget;
import com.hyeonworks.grpc.api.deadline.GrpcDeadlineProfile;
import com.hyeonworks.grpc.context.GrpcContextSnapshot;
import com.hyeonworks.grpc.core.GrpcMethodName;
import com.hyeonworks.grpc.core.RpcType;
import com.hyeonworks.grpc.deadline.GrpcCancellationCoordinator;
import com.hyeonworks.grpc.deadline.GrpcCancellationReason;
import dev.cakit.grpc.advanced.reactor.GrpcReactorCancellationBridge;
import dev.cakit.grpc.advanced.reactor.GrpcReactorContextBridge;
import dev.cakit.grpc.api.context.GrpcClientIdentity;
import dev.cakit.grpc.api.context.GrpcMetadataBudget;
import dev.cakit.grpc.api.context.GrpcRequestContext;
import dev.cakit.grpc.api.deadline.GrpcCancellationToken;
import dev.cakit.grpc.api.deadline.GrpcDeadlineBudget;
import dev.cakit.grpc.api.deadline.GrpcDeadlineProfile;
import dev.cakit.grpc.context.GrpcContextSnapshot;
import dev.cakit.grpc.core.GrpcMethodName;
import dev.cakit.grpc.core.RpcType;
import dev.cakit.grpc.deadline.GrpcCancellationCoordinator;
import dev.cakit.grpc.deadline.GrpcCancellationReason;
import java.time.Duration;
import java.time.Instant;
import java.util.Map;
@@ -28,7 +28,7 @@ import reactor.util.context.Context;
class GrpcReactorContextBridgeTest {
private static final GrpcMethodName GET =
GrpcMethodName.parse("hyeonworks.document.v1.DocumentService/GetDocument");
GrpcMethodName.parse("cakit.document.v1.DocumentService/GetDocument");
private static final Instant NOW = Instant.parse("2026-08-30T10:00:00Z");
private static GrpcContextSnapshot snapshot() {
@@ -1,14 +1,14 @@
package com.hyeonworks.grpc.advanced.compat;
package dev.cakit.grpc.advanced.compat;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
import com.hyeonworks.grpc.advanced.web.GrpcWebProfile;
import com.hyeonworks.grpc.advanced.web.GrpcWebProxyContract;
import com.hyeonworks.grpc.advanced.web.GrpcWebRpcSupport;
import com.hyeonworks.grpc.core.RpcType;
import com.hyeonworks.grpc.error.GrpcErrorMapper;
import com.hyeonworks.grpc.validation.GrpcValidationInterceptor;
import dev.cakit.grpc.advanced.web.GrpcWebProfile;
import dev.cakit.grpc.advanced.web.GrpcWebProxyContract;
import dev.cakit.grpc.advanced.web.GrpcWebRpcSupport;
import dev.cakit.grpc.core.RpcType;
import dev.cakit.grpc.error.GrpcErrorMapper;
import dev.cakit.grpc.validation.GrpcValidationInterceptor;
import java.io.IOException;
import java.io.InputStream;
import java.io.UncheckedIOException;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.bootstrap;
package dev.cakit.grpc.advanced.bootstrap;
/**
* Every capability the Stable platform deliberately excludes, and how ready each one is.
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.bootstrap;
package dev.cakit.grpc.advanced.bootstrap;
/**
* A capability was used without being enabled.
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.bootstrap;
package dev.cakit.grpc.advanced.bootstrap;
import java.util.EnumMap;
import java.util.EnumSet;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.bootstrap;
package dev.cakit.grpc.advanced.bootstrap;
/**
* The single gate every advanced capability passes through.
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.bootstrap;
package dev.cakit.grpc.advanced.bootstrap;
/**
* How much a capability has been established, and what that permits.
@@ -1,8 +1,8 @@
package com.hyeonworks.grpc.advanced.diagnostics;
package dev.cakit.grpc.advanced.diagnostics;
import com.hyeonworks.grpc.advanced.bootstrap.GrpcAdvancedCapability;
import com.hyeonworks.grpc.advanced.bootstrap.GrpcAdvancedFeatureFlags;
import com.hyeonworks.grpc.advanced.bootstrap.GrpcAdvancedModuleGuard;
import dev.cakit.grpc.advanced.bootstrap.GrpcAdvancedCapability;
import dev.cakit.grpc.advanced.bootstrap.GrpcAdvancedFeatureFlags;
import dev.cakit.grpc.advanced.bootstrap.GrpcAdvancedModuleGuard;
import java.util.Set;
/**
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.diagnostics;
package dev.cakit.grpc.advanced.diagnostics;
import java.time.Instant;
import java.util.List;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.diagnostics;
package dev.cakit.grpc.advanced.diagnostics;
import java.nio.charset.StandardCharsets;
import java.security.MessageDigest;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.discovery;
package dev.cakit.grpc.advanced.discovery;
import java.util.List;
import java.util.Optional;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.discovery;
package dev.cakit.grpc.advanced.discovery;
/**
* One endpoint a picker may choose, described only by what routing is allowed to consider.
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.discovery;
package dev.cakit.grpc.advanced.discovery;
import java.util.List;
import java.util.Set;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.discovery;
package dev.cakit.grpc.advanced.discovery;
import java.util.Optional;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.discovery;
package dev.cakit.grpc.advanced.discovery;
import java.util.List;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.discovery;
package dev.cakit.grpc.advanced.discovery;
import java.util.List;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.discovery;
package dev.cakit.grpc.advanced.discovery;
import java.util.ArrayList;
import java.util.List;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.discovery;
package dev.cakit.grpc.advanced.discovery;
import java.util.Collections;
import java.util.LinkedHashMap;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.edition;
package dev.cakit.grpc.advanced.edition;
import java.util.Set;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.edition;
package dev.cakit.grpc.advanced.edition;
/**
* The four independent things that have to be true before an edition is usable, tracked separately.
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.edition;
package dev.cakit.grpc.advanced.edition;
import java.time.Instant;
import java.util.ArrayList;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.edition;
package dev.cakit.grpc.advanced.edition;
import java.util.ArrayList;
import java.util.List;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.resilience;
package dev.cakit.grpc.advanced.resilience;
import java.util.concurrent.atomic.AtomicLong;
@@ -1,9 +1,9 @@
package com.hyeonworks.grpc.advanced.resilience;
package dev.cakit.grpc.advanced.resilience;
import com.hyeonworks.grpc.api.policy.GrpcMethodPolicy;
import com.hyeonworks.grpc.api.policy.RpcIdempotencyProfile;
import com.hyeonworks.grpc.core.RpcType;
import com.hyeonworks.grpc.resilience.GrpcRetryOwner;
import dev.cakit.grpc.api.policy.GrpcMethodPolicy;
import dev.cakit.grpc.api.policy.RpcIdempotencyProfile;
import dev.cakit.grpc.core.RpcType;
import dev.cakit.grpc.resilience.GrpcRetryOwner;
import java.util.Optional;
/**
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.resilience;
package dev.cakit.grpc.advanced.resilience;
import java.time.Duration;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.resilience;
package dev.cakit.grpc.advanced.resilience;
import java.time.Duration;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.streaming;
package dev.cakit.grpc.advanced.streaming;
/**
* One direction of a bidirectional stream, tracked on its own.
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.streaming;
package dev.cakit.grpc.advanced.streaming;
/**
* What a bidirectional resume has to carry: both applied positions, and the generation they belong
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.streaming;
package dev.cakit.grpc.advanced.streaming;
/**
* Two sequences, one per direction, never merged.
@@ -1,6 +1,6 @@
package com.hyeonworks.grpc.advanced.streaming;
package dev.cakit.grpc.advanced.streaming;
import com.hyeonworks.grpc.streaming.GrpcFlowControlPolicy;
import dev.cakit.grpc.streaming.GrpcFlowControlPolicy;
import java.util.Optional;
/**
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.streaming;
package dev.cakit.grpc.advanced.streaming;
import java.time.Instant;
import java.util.Optional;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.streaming;
package dev.cakit.grpc.advanced.streaming;
import java.time.Instant;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.streaming;
package dev.cakit.grpc.advanced.streaming;
/**
* One message a client sends, carrying the session and sequence that make it identifiable.
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.streaming;
package dev.cakit.grpc.advanced.streaming;
import java.time.Duration;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.streaming;
package dev.cakit.grpc.advanced.streaming;
import java.util.Optional;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.streaming;
package dev.cakit.grpc.advanced.streaming;
import java.util.UUID;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.streaming;
package dev.cakit.grpc.advanced.streaming;
/**
* Where a client stream is in its life.
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.streaming;
package dev.cakit.grpc.advanced.streaming;
import java.time.Duration;
import java.time.Instant;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.streaming;
package dev.cakit.grpc.advanced.streaming;
/**
* Whether more inbound messages may be requested, or more outbound produced.
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.streaming;
package dev.cakit.grpc.advanced.streaming;
import java.time.Duration;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.xds;
package dev.cakit.grpc.advanced.xds;
import java.time.Duration;
import java.time.Instant;
@@ -1,6 +1,6 @@
package com.hyeonworks.grpc.advanced.xds;
package dev.cakit.grpc.advanced.xds;
import com.hyeonworks.grpc.resilience.GrpcRetryOwner;
import dev.cakit.grpc.resilience.GrpcRetryOwner;
import java.net.URI;
/**
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.xds;
package dev.cakit.grpc.advanced.xds;
import java.time.Instant;
import java.util.List;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.bootstrap;
package dev.cakit.grpc.advanced.bootstrap;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
@@ -1,10 +1,10 @@
package com.hyeonworks.grpc.advanced.diagnostics;
package dev.cakit.grpc.advanced.diagnostics;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
import com.hyeonworks.grpc.advanced.bootstrap.GrpcAdvancedCapability;
import com.hyeonworks.grpc.advanced.bootstrap.GrpcAdvancedFeatureFlags;
import dev.cakit.grpc.advanced.bootstrap.GrpcAdvancedCapability;
import dev.cakit.grpc.advanced.bootstrap.GrpcAdvancedFeatureFlags;
import java.time.Instant;
import java.util.LinkedHashMap;
import java.util.List;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.diagnostics;
package dev.cakit.grpc.advanced.diagnostics;
import static org.assertj.core.api.Assertions.assertThat;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.edition;
package dev.cakit.grpc.advanced.edition;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
@@ -36,14 +36,14 @@ class GrpcEdition2024PolicyTest {
void publicServicesNeedAPromotion() {
GrpcEdition2024Policy withoutPromotion =
new GrpcEdition2024Policy(
Set.of("grpc-advanced"), Set.of("hyeonworks.document.v1.DocumentService"), false);
Set.of("grpc-advanced"), Set.of("cakit.document.v1.DocumentService"), false);
GrpcEdition2024Policy withPromotion =
new GrpcEdition2024Policy(
Set.of("grpc-advanced"), Set.of("hyeonworks.document.v1.DocumentService"), true);
Set.of("grpc-advanced"), Set.of("cakit.document.v1.DocumentService"), true);
assertThat(withoutPromotion.serviceMayMove("hyeonworks.document.v1.DocumentService")).isFalse();
assertThat(withPromotion.serviceMayMove("hyeonworks.document.v1.DocumentService")).isTrue();
assertThat(withoutPromotion.serviceMayMove("hyeonworks.internal.v1.ScratchService")).isTrue();
assertThat(withoutPromotion.serviceMayMove("cakit.document.v1.DocumentService")).isFalse();
assertThat(withPromotion.serviceMayMove("cakit.document.v1.DocumentService")).isTrue();
assertThat(withoutPromotion.serviceMayMove("cakit.internal.v1.ScratchService")).isTrue();
}
@Test
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.edition;
package dev.cakit.grpc.advanced.edition;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
@@ -1,15 +1,15 @@
package com.hyeonworks.grpc.advanced.resilience;
package dev.cakit.grpc.advanced.resilience;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
import com.hyeonworks.grpc.api.deadline.GrpcDeadlineProfile;
import com.hyeonworks.grpc.api.policy.GrpcMethodPolicy;
import com.hyeonworks.grpc.api.policy.RpcIdempotencyProfile;
import com.hyeonworks.grpc.api.policy.WaitForReadyPolicy;
import com.hyeonworks.grpc.core.GrpcMethodName;
import com.hyeonworks.grpc.core.RpcType;
import com.hyeonworks.grpc.resilience.GrpcRetryOwner;
import dev.cakit.grpc.api.deadline.GrpcDeadlineProfile;
import dev.cakit.grpc.api.policy.GrpcMethodPolicy;
import dev.cakit.grpc.api.policy.RpcIdempotencyProfile;
import dev.cakit.grpc.api.policy.WaitForReadyPolicy;
import dev.cakit.grpc.core.GrpcMethodName;
import dev.cakit.grpc.core.RpcType;
import dev.cakit.grpc.resilience.GrpcRetryOwner;
import java.time.Duration;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
@@ -17,11 +17,11 @@ import org.junit.jupiter.api.Test;
class GrpcHedgingEligibilityTest {
private static final GrpcMethodName GET =
GrpcMethodName.parse("hyeonworks.document.v1.DocumentService/GetDocument");
GrpcMethodName.parse("cakit.document.v1.DocumentService/GetDocument");
private static final GrpcMethodName CREATE =
GrpcMethodName.parse("hyeonworks.document.v1.DocumentService/CreateDocument");
GrpcMethodName.parse("cakit.document.v1.DocumentService/CreateDocument");
private static final GrpcMethodName WATCH =
GrpcMethodName.parse("hyeonworks.document.v1.DocumentService/WatchDocuments");
GrpcMethodName.parse("cakit.document.v1.DocumentService/WatchDocuments");
private static final GrpcDeadlineProfile TWO_SECONDS =
GrpcDeadlineProfile.of(Duration.ofSeconds(2));
@@ -1,12 +1,12 @@
package com.hyeonworks.grpc.advanced.resilience;
package dev.cakit.grpc.advanced.resilience;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
import com.hyeonworks.grpc.advanced.discovery.GrpcEndpointCandidate;
import com.hyeonworks.grpc.advanced.discovery.GrpcLoadBalancerDecision;
import com.hyeonworks.grpc.advanced.discovery.GrpcLoadBalancerPicker;
import com.hyeonworks.grpc.advanced.discovery.GrpcLoadBalancerSafetyPolicy;
import dev.cakit.grpc.advanced.discovery.GrpcEndpointCandidate;
import dev.cakit.grpc.advanced.discovery.GrpcLoadBalancerDecision;
import dev.cakit.grpc.advanced.discovery.GrpcLoadBalancerPicker;
import dev.cakit.grpc.advanced.discovery.GrpcLoadBalancerSafetyPolicy;
import java.util.List;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
@@ -1,13 +1,13 @@
package com.hyeonworks.grpc.advanced.resilience;
package dev.cakit.grpc.advanced.resilience;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
import static org.assertj.core.api.Assertions.catchThrowable;
import com.hyeonworks.grpc.advanced.discovery.GrpcCustomResolver;
import com.hyeonworks.grpc.advanced.discovery.GrpcEndpointSnapshot;
import com.hyeonworks.grpc.advanced.discovery.GrpcResolverSafetyPolicy;
import com.hyeonworks.grpc.advanced.discovery.GrpcResolverUpdate;
import dev.cakit.grpc.advanced.discovery.GrpcCustomResolver;
import dev.cakit.grpc.advanced.discovery.GrpcEndpointSnapshot;
import dev.cakit.grpc.advanced.discovery.GrpcResolverSafetyPolicy;
import dev.cakit.grpc.advanced.discovery.GrpcResolverUpdate;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;
@@ -1,12 +1,12 @@
package com.hyeonworks.grpc.advanced.resilience;
package dev.cakit.grpc.advanced.resilience;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
import com.hyeonworks.grpc.advanced.xds.GrpcXdsFailurePolicy;
import com.hyeonworks.grpc.advanced.xds.GrpcXdsProfile;
import com.hyeonworks.grpc.advanced.xds.GrpcXdsResourceSnapshot;
import com.hyeonworks.grpc.resilience.GrpcRetryOwner;
import dev.cakit.grpc.advanced.xds.GrpcXdsFailurePolicy;
import dev.cakit.grpc.advanced.xds.GrpcXdsProfile;
import dev.cakit.grpc.advanced.xds.GrpcXdsResourceSnapshot;
import dev.cakit.grpc.resilience.GrpcRetryOwner;
import java.net.URI;
import java.time.Instant;
import java.util.List;
@@ -30,7 +30,7 @@ class GrpcXdsProfileTest {
@Test
@DisplayName("an xDS profile requires an xds target, a namespace, mesh retries and mTLS")
void anXdsProfileRequiresItsFourConditions() {
assertThat(profile("hyeonworks/documents").target().getScheme()).isEqualTo("xds");
assertThat(profile("cakit/documents").target().getScheme()).isEqualTo("xds");
assertThatThrownBy(
() ->
new GrpcXdsProfile(
@@ -1,10 +1,10 @@
package com.hyeonworks.grpc.advanced.streaming;
package dev.cakit.grpc.advanced.streaming;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
import com.hyeonworks.grpc.streaming.GrpcFlowControlPolicy;
import com.hyeonworks.grpc.streaming.GrpcSlowConsumerPolicy;
import dev.cakit.grpc.streaming.GrpcFlowControlPolicy;
import dev.cakit.grpc.streaming.GrpcSlowConsumerPolicy;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.streaming;
package dev.cakit.grpc.advanced.streaming;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.streaming;
package dev.cakit.grpc.advanced.streaming;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.advanced.streaming;
package dev.cakit.grpc.advanced.streaming;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
@@ -1,9 +1,9 @@
edition = "2024";
package hyeonworks.grpc.edition.v1;
package cakit.grpc.edition.v1;
option java_multiple_files = true;
option java_package = "hyeonworks.grpc.edition.v1.generated";
option java_package = "cakit.grpc.edition.v1.generated";
// The Edition 2024 comparison fixture.
//
+5 -5
View File
@@ -1,7 +1,7 @@
# grpc — gRPC 플랫폼 family의 지역 정본
이 문서는 `grpc:*` family의 **지역 정본(local authority)**이다. gRPC platform은 이 repo(`grpc-library`)가 소유하고
Maven group `com.hyeonworks.grpc`로 배포한다. 여기서 정하는 것은 family별 framework 규칙, 증거 등급,
Maven group `dev.cakit.grpc`로 배포한다. 여기서 정하는 것은 family별 framework 규칙, 증거 등급,
Stable 범위의 경계와 application에 채택될 때 필요한 계약이다.
루트 `AGENTS.md`와 충돌하면 루트가 이긴다.
@@ -37,9 +37,9 @@ server profile·named channel profile·method size profile·method policy 기본
그 상수를 쓴다. `GrpcPlatformStartupValidator`는 method의 inbound 한도가 server profile 한도보다 크면
기동을 거부한다.
`.proto`의 proto 조직 이름은 `hyeonworks`다(`package hyeonworks.grpc.common.v1`, 생성 Java 패키지
`hyeonworks.grpc.common.v1.generated` — 손으로 쓴 `com.hyeonworks`와 겹치지 않는다). proto 패키지는 wire
이름이라 바꾸면 MAJOR다(`docs/work/release.md` 2절). 2026-11-08 전의 이름은 `caskeleton`이었다.
`.proto`의 proto 조직 이름은 `cakit`이다(`package cakit.grpc.common.v1`, 생성 Java 패키지
`cakit.grpc.common.v1.generated` — 손으로 쓴 `dev.cakit`과 겹치지 않는다). proto 패키지는 wire
이름이라 바꾸면 MAJOR다(`docs/work/release.md` 2절). 2026-11-08 전의 이름은 `caskeleton`이었다(템플릿 자리표시 이름과 겹치지 않게 바꿨다).
### 공용 다이제스트 헬퍼를 복사해 두는 이유
@@ -84,7 +84,7 @@ capability flag 뒤에 있다. `GrpcPlatformStartupValidator`가 Stable catalog
## 라이브러리로 배포된다는 것의 의미
앱은 이 repo를 빌드에 넣지 않고 Gitea Packages에 배포한 버전(`com.hyeonworks.grpc:<모듈>:<버전>`)을 받는다. 플랫폼
앱은 이 repo를 빌드에 넣지 않고 Gitea Packages에 배포한 버전(`dev.cakit.grpc:<모듈>:<버전>`)을 받는다. 플랫폼
자체는 이 repo의 `./gradlew ci`로 검증하고, 앱 runtime에 실제 채택하려면 그 앱의 조립 루트가 명시적으로
dependency를 가져오는 별도 변경이 필요하다. 백엔드 템플릿은 지금 이 라이브러리를 받지 않는다.
+1 -1
View File
@@ -15,7 +15,7 @@ plugins {
// grpc-codegen, which did both with regular expressions (owner decision 18).
//
// Generated code lands under build/, in the package each file's `java_package` names
// (`hyeonworks.*.generated`), which is disjoint from the hand-written `com.hyeonworks` root.
// (`cakit.*.generated`), which is disjoint from the hand-written `dev.cakit` root.
// Messages only: the schema declares no service yet, so there is no grpc-java stub to generate.
dependencies {
// api: every generated message extends com.google.protobuf.GeneratedMessageV3.
@@ -1,9 +1,9 @@
syntax = "proto3";
package hyeonworks.grpc.common.v1;
package cakit.grpc.common.v1;
option java_multiple_files = true;
option java_package = "hyeonworks.grpc.common.v1.generated";
option java_package = "cakit.grpc.common.v1.generated";
option java_outer_classname = "ErrorProto";
import "google/protobuf/duration.proto";
@@ -1,9 +1,9 @@
syntax = "proto3";
package hyeonworks.grpc.common.v1;
package cakit.grpc.common.v1;
option java_multiple_files = true;
option java_package = "hyeonworks.grpc.common.v1.generated";
option java_package = "cakit.grpc.common.v1.generated";
option java_outer_classname = "StreamProto";
// The Stable server-streaming envelope.
@@ -1,10 +1,10 @@
package com.hyeonworks.grpc.contract;
package dev.cakit.grpc.contract;
import static org.assertj.core.api.Assertions.assertThat;
import hyeonworks.grpc.common.v1.generated.StreamEnvelope;
import hyeonworks.grpc.common.v1.generated.StreamMessageKind;
import hyeonworks.grpc.common.v1.generated.StreamTerminationReason;
import cakit.grpc.common.v1.generated.StreamEnvelope;
import cakit.grpc.common.v1.generated.StreamMessageKind;
import cakit.grpc.common.v1.generated.StreamTerminationReason;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
@@ -32,15 +32,15 @@ class GrpcContractGeneratedCodeTest {
}
@Test
@DisplayName("생성 코드의 proto 패키지와 Java 패키지는 조직 이름 hyeonworks 아래에 있고 손으로 쓴 com.hyeonworks과 겹치지 않는다")
void generatedCodeLivesUnderTheHyeonworksProtoPackageAndOutsideTheHandWrittenRoot() {
@DisplayName("생성 코드의 proto 패키지와 Java 패키지는 조직 이름 cakit 아래에 있고 손으로 쓴 dev.cakit과 겹치지 않는다")
void generatedCodeLivesUnderTheCakitProtoPackageAndOutsideTheHandWrittenRoot() {
// when
String protoPackage = StreamEnvelope.getDescriptor().getFile().getPackage();
// then
assertThat(protoPackage).isEqualTo("hyeonworks.grpc.common.v1");
assertThat(protoPackage).isEqualTo("cakit.grpc.common.v1");
assertThat(StreamEnvelope.class.getPackageName())
.isEqualTo("hyeonworks.grpc.common.v1.generated")
.doesNotStartWith("com.hyeonworks");
.isEqualTo("cakit.grpc.common.v1.generated")
.doesNotStartWith("dev.cakit");
}
}
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.api.context;
package dev.cakit.grpc.api.context;
/**
* Who is calling, as established by authentication — never as claimed by a header.
@@ -1,6 +1,6 @@
package com.hyeonworks.grpc.api.context;
package dev.cakit.grpc.api.context;
import com.hyeonworks.grpc.api.policy.GrpcTransportLimits;
import dev.cakit.grpc.api.policy.GrpcTransportLimits;
import java.util.Map;
/**
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.api.context;
package dev.cakit.grpc.api.context;
import java.util.regex.Pattern;
@@ -1,9 +1,9 @@
package com.hyeonworks.grpc.api.context;
package dev.cakit.grpc.api.context;
import com.hyeonworks.grpc.api.deadline.GrpcCancellationToken;
import com.hyeonworks.grpc.api.deadline.GrpcDeadlineBudget;
import com.hyeonworks.grpc.core.GrpcMethodName;
import com.hyeonworks.grpc.core.RpcType;
import dev.cakit.grpc.api.deadline.GrpcCancellationToken;
import dev.cakit.grpc.api.deadline.GrpcDeadlineBudget;
import dev.cakit.grpc.core.GrpcMethodName;
import dev.cakit.grpc.core.RpcType;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.Optional;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.api.deadline;
package dev.cakit.grpc.api.deadline;
import java.time.Instant;
import java.util.Optional;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.api.deadline;
package dev.cakit.grpc.api.deadline;
import java.time.Duration;
import java.util.function.LongSupplier;
@@ -1,7 +1,7 @@
package com.hyeonworks.grpc.api.deadline;
package dev.cakit.grpc.api.deadline;
import com.hyeonworks.grpc.api.error.GrpcFailureContext;
import com.hyeonworks.grpc.api.error.GrpcPlatformException;
import dev.cakit.grpc.api.error.GrpcFailureContext;
import dev.cakit.grpc.api.error.GrpcPlatformException;
/**
* A deadline elapsed.
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.api.deadline;
package dev.cakit.grpc.api.deadline;
import java.time.Duration;
@@ -1,9 +1,9 @@
package com.hyeonworks.grpc.api.error;
package dev.cakit.grpc.api.error;
import com.hyeonworks.grpc.core.GrpcStatusCode;
import com.hyeonworks.grpc.evidence.GrpcBusinessEvidence;
import com.hyeonworks.grpc.evidence.GrpcExecutionEvidence;
import com.hyeonworks.grpc.evidence.GrpcStreamEvidence;
import dev.cakit.grpc.core.GrpcStatusCode;
import dev.cakit.grpc.evidence.GrpcBusinessEvidence;
import dev.cakit.grpc.evidence.GrpcExecutionEvidence;
import dev.cakit.grpc.evidence.GrpcStreamEvidence;
/**
* What the caller may conclude about the business operation.
@@ -1,6 +1,6 @@
package com.hyeonworks.grpc.api.error;
package dev.cakit.grpc.api.error;
import com.hyeonworks.grpc.core.GrpcStatusCode;
import dev.cakit.grpc.core.GrpcStatusCode;
/**
* The platform's stable failure taxonomy, and the canonical status each category maps to.
@@ -1,8 +1,8 @@
package com.hyeonworks.grpc.api.error;
package dev.cakit.grpc.api.error;
import com.hyeonworks.grpc.core.GrpcMethodName;
import com.hyeonworks.grpc.core.GrpcStatusCode;
import com.hyeonworks.grpc.evidence.GrpcExecutionEvidence;
import dev.cakit.grpc.core.GrpcMethodName;
import dev.cakit.grpc.core.GrpcStatusCode;
import dev.cakit.grpc.evidence.GrpcExecutionEvidence;
import java.time.Duration;
import java.util.Optional;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.api.error;
package dev.cakit.grpc.api.error;
/**
* The platform's failure carrier.

Some files were not shown because too many files have changed in this diff Show More