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
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
324 changed files with 937 additions and 933 deletions
+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가 느려도 다른 의존성 해석에는 영향이 없다.
## 지원 표
+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절.
+1 -1
View File
@@ -50,7 +50,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. 올리기 직전까지 미리 돌리기
+1 -1
View File
@@ -1,6 +1,6 @@
# 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
+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.
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.api.ledger;
package dev.cakit.grpc.api.ledger;
/**
* Which attempt holds a claim: the fencing token a commit or a failure record must present.
@@ -1,6 +1,6 @@
package com.hyeonworks.grpc.api.ledger;
package dev.cakit.grpc.api.ledger;
import com.hyeonworks.grpc.core.GrpcMethodName;
import dev.cakit.grpc.core.GrpcMethodName;
/**
* What makes two requests the same operation.
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.api.ledger;
package dev.cakit.grpc.api.ledger;
import java.time.Instant;
import java.util.Optional;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.api.ledger;
package dev.cakit.grpc.api.ledger;
import java.time.Instant;
import java.util.Optional;
@@ -1,4 +1,4 @@
package com.hyeonworks.grpc.api.ledger;
package dev.cakit.grpc.api.ledger;
/**
* Where a durable operation claim is in its life.

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