diff --git a/docs/compatibility/grpc-advanced-support-matrix.md b/docs/compatibility/grpc-advanced-support-matrix.md index 7660104..9df35cb 100644 --- a/docs/compatibility/grpc-advanced-support-matrix.md +++ b/docs/compatibility/grpc-advanced-support-matrix.md @@ -4,7 +4,7 @@ Every capability in `:grpc-advanced:*`, its grade, and what it would take to rai `GrpcAdvancedSupportMatrix` is the machine-readable form; `GrpcAdvancedCapability.defaultGrade` carries the same values. -All capabilities are off by default. Flags are `ca-skeleton.grpc.advanced..enabled`. +All capabilities are off by default. Flags are `app.grpc.advanced..enabled`. ## Grades diff --git a/docs/runbooks/grpc-advanced-capabilities.md b/docs/runbooks/grpc-advanced-capabilities.md index a4b0b49..bc3a50d 100644 --- a/docs/runbooks/grpc-advanced-capabilities.md +++ b/docs/runbooks/grpc-advanced-capabilities.md @@ -3,7 +3,7 @@ Scope: the `:grpc-advanced:*` family. Everything here is off by default and stays off until a deployment names it. Nothing in this family ships in a runtime composition today. -Flags are `ca-skeleton.grpc.advanced..enabled`. `GrpcAdvancedCapability` owns the list of +Flags are `app.grpc.advanced..enabled`. `GrpcAdvancedCapability` owns the list of capability names; `GrpcAdvancedSupportMatrix` owns their current grades. --- diff --git a/docs/runbooks/grpc-platform-operations.md b/docs/runbooks/grpc-platform-operations.md index 9ce0587..07d0639 100644 --- a/docs/runbooks/grpc-platform-operations.md +++ b/docs/runbooks/grpc-platform-operations.md @@ -5,8 +5,8 @@ empty — so nothing here fires in production yet. It is written now because the the ones an on-call cannot work out from first principles at three in the morning, and shipping the behaviour before the runbook means the first person to meet one is doing that. -Configuration lives under `ca-skeleton.grpc.platform.*` and is bound by `GrpcPlatformProperties`. -The platform does not start unless `ca-skeleton.grpc.platform.enabled=true`. +Configuration lives under `app.grpc.platform.*` and is bound by `GrpcPlatformProperties`. +The platform does not start unless `app.grpc.platform.enabled=true`. --- @@ -94,7 +94,7 @@ capacity on nothing. means the bottleneck is admission, not the work. 2. Check which saturation counter is moving — executor, channel or flow control. They look identical in a latency graph and have different fixes. -3. Raising `ca-skeleton.grpc.platform.executor-queue-capacity` defers the problem; it does not remove +3. Raising `app.grpc.platform.executor-queue-capacity` defers the problem; it does not remove it. `GrpcExecutorProfile` refuses a queue above ten thousand for that reason. --- @@ -138,5 +138,5 @@ construction rather than redacted. - **Reflection in production.** `GrpcReflectionMode.defaultFor` returns `DISABLED` for `STAGE` and `PROD`. Reflection publishes the whole schema to anyone who can open a connection. - **Every advanced capability.** See `docs/runbooks/grpc-advanced-capabilities.md`. -- **The platform itself.** `ca-skeleton.grpc.platform.enabled` defaults to false, and every `:grpc:*` +- **The platform itself.** `app.grpc.platform.enabled` defaults to false, and every `:grpc:*` leaf is build-only in the registry. diff --git a/grpc-advanced/CLAUDE.md b/grpc-advanced/CLAUDE.md index cf3a6d7..3955a52 100644 --- a/grpc-advanced/CLAUDE.md +++ b/grpc-advanced/CLAUDE.md @@ -31,7 +31,7 @@ capability마다 별도 flag를 갖는다. 하나의 "advanced" 스위치로 묶 | `WATCH` | X (추적만) | — | | `DISABLED` | X | — | -property key는 `ca-skeleton.grpc.advanced..enabled`이고 전부 기본 off다. +property key는 `app.grpc.advanced..enabled`이고 전부 기본 off다. `GrpcAdvancedModuleGuard`가 세 조건(flag 미설정 / grade가 시작 불가 / production 승인 없음)을 구분해서 거부하며, 세 경우의 조치가 다르므로 메시지도 다르다. diff --git a/grpc-advanced/grpc-advanced/build.gradle b/grpc-advanced/grpc-advanced/build.gradle index eaf898d..c4b9a18 100644 --- a/grpc-advanced/grpc-advanced/build.gradle +++ b/grpc-advanced/grpc-advanced/build.gradle @@ -6,7 +6,7 @@ plugins { // The capabilities the Stable platform deliberately excludes, each behind its own capability flag: // -// bootstrap capability grades, the `ca-skeleton.grpc.advanced.*` feature-flag contract, the +// bootstrap capability grades, the `app.grpc.advanced.*` feature-flag contract, the // module guard that refuses an unflagged capability, the per-capability promotion // gate // edition Protobuf Edition 2024 opt-in lane and Edition 2026 watch lane diff --git a/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedCapability.java b/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedCapability.java index b679f14..12e8fb6 100644 --- a/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedCapability.java +++ b/grpc-advanced/grpc-advanced/src/main/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedCapability.java @@ -48,14 +48,14 @@ public enum GrpcAdvancedCapability { this.defaultGrade = defaultGrade; } - /** The property suffix under {@code ca-skeleton.grpc.advanced}. */ + /** The property suffix under {@code app.grpc.advanced}. */ public String flagName() { return flagName; } /** The full property key that enables this capability. */ public String propertyKey() { - return "ca-skeleton.grpc.advanced." + flagName + ".enabled"; + return "app.grpc.advanced." + flagName + ".enabled"; } /** How ready this capability is today. */ diff --git a/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedModuleGuardTest.java b/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedModuleGuardTest.java index dcaae0e..32268e9 100644 --- a/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedModuleGuardTest.java +++ b/grpc-advanced/grpc-advanced/src/test/java/dev/caskeleton/grpc/advanced/bootstrap/GrpcAdvancedModuleGuardTest.java @@ -23,8 +23,7 @@ class GrpcAdvancedModuleGuardTest { @Test @DisplayName("each capability has its own flag, not a shared one") void eachCapabilityHasItsOwnFlag() { - assertThat(GrpcAdvancedCapability.XDS.propertyKey()) - .isEqualTo("ca-skeleton.grpc.advanced.xds.enabled"); + assertThat(GrpcAdvancedCapability.XDS.propertyKey()).isEqualTo("app.grpc.advanced.xds.enabled"); assertThat(GrpcAdvancedCapability.GRPC_WEB.propertyKey()) .isNotEqualTo(GrpcAdvancedCapability.XDS.propertyKey()); @@ -43,7 +42,7 @@ class GrpcAdvancedModuleGuardTest { GrpcAdvancedModuleGuard.require( GrpcAdvancedFeatureFlags.forDevelopment(), GrpcAdvancedCapability.REACTOR)) .isInstanceOf(GrpcAdvancedCapabilityDisabledException.class) - .hasMessageContaining("ca-skeleton.grpc.advanced.reactor.enabled=true"); + .hasMessageContaining("app.grpc.advanced.reactor.enabled=true"); } @Test diff --git a/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfiguration.java b/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfiguration.java index 5e17459..8516939 100644 --- a/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfiguration.java +++ b/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfiguration.java @@ -33,7 +33,7 @@ import org.springframework.context.annotation.Bean; */ @AutoConfiguration @ConditionalOnProperty( - prefix = "ca-skeleton.grpc.platform", + prefix = "app.grpc.platform", name = "enabled", havingValue = "true", matchIfMissing = false) diff --git a/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformProperties.java b/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformProperties.java index 92c5be0..c480573 100644 --- a/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformProperties.java +++ b/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformProperties.java @@ -6,7 +6,7 @@ import dev.caskeleton.grpc.server.GrpcServerTransport; import org.springframework.boot.context.properties.ConfigurationProperties; /** - * The gRPC platform's typed configuration, bound from {@code ca-skeleton.grpc.platform.*}. + * The gRPC platform's typed configuration, bound from {@code app.grpc.platform.*}. * *

Off by default, like every other optional capability in this repository. A platform that * starts because its jar is on the classpath is a platform that opens a port on a deployment nobody @@ -16,7 +16,7 @@ import org.springframework.boot.context.properties.ConfigurationProperties; * leaving a setting at its default — which is how a deployment ends up with production reflection * enabled because somebody wrote {@code reflection-mode} under the wrong prefix. */ -@ConfigurationProperties(prefix = "ca-skeleton.grpc.platform", ignoreUnknownFields = false) +@ConfigurationProperties(prefix = "app.grpc.platform", ignoreUnknownFields = false) public class GrpcPlatformProperties { /** Whether the platform is assembled at all. */ diff --git a/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidator.java b/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidator.java index f4024f9..1f1a4de 100644 --- a/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidator.java +++ b/grpc/grpc-spring-boot-starter/src/main/java/dev/caskeleton/grpc/boot/GrpcPlatformStartupValidator.java @@ -82,7 +82,7 @@ public final class GrpcPlatformStartupValidator { } if (properties.getEnvironment() == null) { violations.add( - "ca-skeleton.grpc.platform.environment is not set; the TLS and reflection floors depend on" + "app.grpc.platform.environment is not set; the TLS and reflection floors depend on" + " it, so it is refused rather than assumed LOCAL"); return; } diff --git a/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfigurationContextTest.java b/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfigurationContextTest.java index e328acd..6957096 100644 --- a/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfigurationContextTest.java +++ b/grpc/grpc-spring-boot-starter/src/test/java/dev/caskeleton/grpc/boot/GrpcPlatformAutoConfigurationContextTest.java @@ -17,11 +17,11 @@ class GrpcPlatformAutoConfigurationContextTest { () -> start( Map.of( - "ca-skeleton.grpc.platform.enabled", "true", - "ca-skeleton.grpc.platform.environment", "PROD", - "ca-skeleton.grpc.platform.transport", "NETTY_SHADED", - "ca-skeleton.grpc.platform.tls-enabled", "true", - "ca-skeleton.grpc.platform.trust-all-certificates", "true"))) + "app.grpc.platform.enabled", "true", + "app.grpc.platform.environment", "PROD", + "app.grpc.platform.transport", "NETTY_SHADED", + "app.grpc.platform.tls-enabled", "true", + "app.grpc.platform.trust-all-certificates", "true"))) .isInstanceOf(GrpcPlatformConfigurationException.class) .hasMessageContaining("trust-all is enabled in PROD") .hasMessageContaining("providing none"); @@ -35,15 +35,15 @@ class GrpcPlatformAutoConfigurationContextTest { () -> start( Map.of( - "ca-skeleton.grpc.platform.enabled", "true", - "ca-skeleton.grpc.platform.transport", "NETTY_SHADED", - "ca-skeleton.grpc.platform.tls-enabled", "false", - "ca-skeleton.grpc.platform.reflection-mode", "ENABLED"))); + "app.grpc.platform.enabled", "true", + "app.grpc.platform.transport", "NETTY_SHADED", + "app.grpc.platform.tls-enabled", "false", + "app.grpc.platform.reflection-mode", "ENABLED"))); // then assertThat(failure) .isInstanceOf(GrpcPlatformConfigurationException.class) - .hasMessageContaining("ca-skeleton.grpc.platform.environment is not set"); + .hasMessageContaining("app.grpc.platform.environment is not set"); } @Test @@ -51,11 +51,11 @@ class GrpcPlatformAutoConfigurationContextTest { try (AnnotationConfigApplicationContext context = start( Map.of( - "ca-skeleton.grpc.platform.enabled", "true", - "ca-skeleton.grpc.platform.environment", "LOCAL", - "ca-skeleton.grpc.platform.transport", "NETTY_SHADED", - "ca-skeleton.grpc.platform.executor-queue-capacity", "32", - "ca-skeleton.grpc.platform.executor-max-pool-size", "4"))) { + "app.grpc.platform.enabled", "true", + "app.grpc.platform.environment", "LOCAL", + "app.grpc.platform.transport", "NETTY_SHADED", + "app.grpc.platform.executor-queue-capacity", "32", + "app.grpc.platform.executor-max-pool-size", "4"))) { assertThat(context.getBean(GrpcPlatformProperties.class).isEnabled()).isTrue(); assertThat( context.getBeansOfType( @@ -69,9 +69,9 @@ class GrpcPlatformAutoConfigurationContextTest { try (AnnotationConfigApplicationContext context = start( Map.of( - "ca-skeleton.grpc.platform.enabled", "true", - "ca-skeleton.grpc.platform.environment", "LOCAL", - "ca-skeleton.grpc.platform.transport", "NETTY"))) { + "app.grpc.platform.enabled", "true", + "app.grpc.platform.environment", "LOCAL", + "app.grpc.platform.transport", "NETTY"))) { assertThat(context.getBean(dev.caskeleton.grpc.server.GrpcServerProfile.class).transport()) .isEqualTo(dev.caskeleton.grpc.server.GrpcServerTransport.NETTY); }