diff --git a/auth-api/src/main/java/software/amazon/smithy/java/auth/api/identity/package-info.java b/auth-api/src/main/java/software/amazon/smithy/java/auth/api/identity/package-info.java new file mode 100644 index 000000000..93c97d66d --- /dev/null +++ b/auth-api/src/main/java/software/amazon/smithy/java/auth/api/identity/package-info.java @@ -0,0 +1,4 @@ +/** + * Identity types and resolvers for authentication. + */ +package software.amazon.smithy.java.auth.api.identity; diff --git a/auth-api/src/main/java/software/amazon/smithy/java/auth/api/package-info.java b/auth-api/src/main/java/software/amazon/smithy/java/auth/api/package-info.java new file mode 100644 index 000000000..b57c32029 --- /dev/null +++ b/auth-api/src/main/java/software/amazon/smithy/java/auth/api/package-info.java @@ -0,0 +1,4 @@ +/** + * Shared authentication and signing API for clients and servers. + */ +package software.amazon.smithy.java.auth.api; diff --git a/aws/aws-auth-api/src/main/java/software/amazon/smithy/java/aws/auth/api/identity/package-info.java b/aws/aws-auth-api/src/main/java/software/amazon/smithy/java/aws/auth/api/identity/package-info.java new file mode 100644 index 000000000..fced512d7 --- /dev/null +++ b/aws/aws-auth-api/src/main/java/software/amazon/smithy/java/aws/auth/api/identity/package-info.java @@ -0,0 +1,4 @@ +/** + * AWS-specific credential identity types and resolvers. + */ +package software.amazon.smithy.java.aws.auth.api.identity; diff --git a/aws/aws-event-streams/src/main/java/software/amazon/smithy/java/aws/events/package-info.java b/aws/aws-event-streams/src/main/java/software/amazon/smithy/java/aws/events/package-info.java new file mode 100644 index 000000000..579d37f52 --- /dev/null +++ b/aws/aws-event-streams/src/main/java/software/amazon/smithy/java/aws/events/package-info.java @@ -0,0 +1,4 @@ +/** + * AWS event stream encoding and decoding. + */ +package software.amazon.smithy.java.aws.events; diff --git a/aws/aws-service-bundle/src/main/java/software/amazon/smithy/java/aws/servicebundle/provider/package-info.java b/aws/aws-service-bundle/src/main/java/software/amazon/smithy/java/aws/servicebundle/provider/package-info.java new file mode 100644 index 000000000..21e8243c5 --- /dev/null +++ b/aws/aws-service-bundle/src/main/java/software/amazon/smithy/java/aws/servicebundle/provider/package-info.java @@ -0,0 +1,8 @@ +/** + * AWS service bundle plugin provider. + *
This package is under development and is not intended for use in production. + */ +@SmithyUnstableApi +package software.amazon.smithy.java.aws.servicebundle.provider; + +import software.amazon.smithy.utils.SmithyUnstableApi; diff --git a/aws/aws-service-bundler/src/main/java/software/amazon/smithy/java/aws/servicebundle/bundler/package-info.java b/aws/aws-service-bundler/src/main/java/software/amazon/smithy/java/aws/servicebundle/bundler/package-info.java new file mode 100644 index 000000000..740d004c8 --- /dev/null +++ b/aws/aws-service-bundler/src/main/java/software/amazon/smithy/java/aws/servicebundle/bundler/package-info.java @@ -0,0 +1,8 @@ +/** + * AWS service model bundler. + *
This package is under development and is not intended for use in production. + */ +@SmithyUnstableApi +package software.amazon.smithy.java.aws.servicebundle.bundler; + +import software.amazon.smithy.utils.SmithyUnstableApi; diff --git a/aws/aws-sigv4/src/main/java/software/amazon/smithy/java/aws/client/auth/scheme/sigv4/package-info.java b/aws/aws-sigv4/src/main/java/software/amazon/smithy/java/aws/client/auth/scheme/sigv4/package-info.java new file mode 100644 index 000000000..759d58e93 --- /dev/null +++ b/aws/aws-sigv4/src/main/java/software/amazon/smithy/java/aws/client/auth/scheme/sigv4/package-info.java @@ -0,0 +1,4 @@ +/** + * AWS SigV4 authentication scheme for clients. + */ +package software.amazon.smithy.java.aws.client.auth.scheme.sigv4; diff --git a/aws/client/aws-client-awsjson/src/main/java/software/amazon/smithy/java/aws/client/awsjson/package-info.java b/aws/client/aws-client-awsjson/src/main/java/software/amazon/smithy/java/aws/client/awsjson/package-info.java new file mode 100644 index 000000000..c990c48ef --- /dev/null +++ b/aws/client/aws-client-awsjson/src/main/java/software/amazon/smithy/java/aws/client/awsjson/package-info.java @@ -0,0 +1,4 @@ +/** + * AWS JSON 1.0 and 1.1 client protocol implementations. + */ +package software.amazon.smithy.java.aws.client.awsjson; diff --git a/aws/client/aws-client-awsquery/src/main/java/software/amazon/smithy/java/aws/client/awsquery/package-info.java b/aws/client/aws-client-awsquery/src/main/java/software/amazon/smithy/java/aws/client/awsquery/package-info.java new file mode 100644 index 000000000..be76c42ff --- /dev/null +++ b/aws/client/aws-client-awsquery/src/main/java/software/amazon/smithy/java/aws/client/awsquery/package-info.java @@ -0,0 +1,4 @@ +/** + * AWS Query client protocol implementation. + */ +package software.amazon.smithy.java.aws.client.awsquery; diff --git a/aws/client/aws-client-core/src/main/java/software/amazon/smithy/java/aws/client/core/identity/package-info.java b/aws/client/aws-client-core/src/main/java/software/amazon/smithy/java/aws/client/core/identity/package-info.java new file mode 100644 index 000000000..da7a16bee --- /dev/null +++ b/aws/client/aws-client-core/src/main/java/software/amazon/smithy/java/aws/client/core/identity/package-info.java @@ -0,0 +1,4 @@ +/** + * AWS client identity resolvers. + */ +package software.amazon.smithy.java.aws.client.core.identity; diff --git a/aws/client/aws-client-core/src/main/java/software/amazon/smithy/java/aws/client/core/settings/package-info.java b/aws/client/aws-client-core/src/main/java/software/amazon/smithy/java/aws/client/core/settings/package-info.java new file mode 100644 index 000000000..8df2ccfa4 --- /dev/null +++ b/aws/client/aws-client-core/src/main/java/software/amazon/smithy/java/aws/client/core/settings/package-info.java @@ -0,0 +1,4 @@ +/** + * AWS client configuration settings. + */ +package software.amazon.smithy.java.aws.client.core.settings; diff --git a/aws/client/aws-client-http/src/main/java/software/amazon/smithy/java/aws/client/http/package-info.java b/aws/client/aws-client-http/src/main/java/software/amazon/smithy/java/aws/client/http/package-info.java new file mode 100644 index 000000000..3f1f8a423 --- /dev/null +++ b/aws/client/aws-client-http/src/main/java/software/amazon/smithy/java/aws/client/http/package-info.java @@ -0,0 +1,4 @@ +/** + * AWS-specific HTTP client plugins. + */ +package software.amazon.smithy.java.aws.client.http; diff --git a/aws/client/aws-client-restjson/src/main/java/software/amazon/smithy/java/aws/client/restjson/package-info.java b/aws/client/aws-client-restjson/src/main/java/software/amazon/smithy/java/aws/client/restjson/package-info.java new file mode 100644 index 000000000..43af23867 --- /dev/null +++ b/aws/client/aws-client-restjson/src/main/java/software/amazon/smithy/java/aws/client/restjson/package-info.java @@ -0,0 +1,4 @@ +/** + * AWS restJson1 client protocol implementation. + */ +package software.amazon.smithy.java.aws.client.restjson; diff --git a/aws/client/aws-client-restxml/src/main/java/software/amazon/smithy/java/aws/client/restxml/package-info.java b/aws/client/aws-client-restxml/src/main/java/software/amazon/smithy/java/aws/client/restxml/package-info.java new file mode 100644 index 000000000..1dffff791 --- /dev/null +++ b/aws/client/aws-client-restxml/src/main/java/software/amazon/smithy/java/aws/client/restxml/package-info.java @@ -0,0 +1,4 @@ +/** + * AWS restXml client protocol implementation. + */ +package software.amazon.smithy.java.aws.client.restxml; diff --git a/aws/client/aws-client-rulesengine/src/main/java/software/amazon/smithy/java/aws/client/rulesengine/package-info.java b/aws/client/aws-client-rulesengine/src/main/java/software/amazon/smithy/java/aws/client/rulesengine/package-info.java new file mode 100644 index 000000000..655b099e0 --- /dev/null +++ b/aws/client/aws-client-rulesengine/src/main/java/software/amazon/smithy/java/aws/client/rulesengine/package-info.java @@ -0,0 +1,4 @@ +/** + * AWS rules engine extensions for endpoint resolution. + */ +package software.amazon.smithy.java.aws.client.rulesengine; diff --git a/aws/integrations/aws-lambda-endpoint/src/main/java/software/amazon/smithy/java/aws/integrations/lambda/package-info.java b/aws/integrations/aws-lambda-endpoint/src/main/java/software/amazon/smithy/java/aws/integrations/lambda/package-info.java new file mode 100644 index 000000000..a36e98462 --- /dev/null +++ b/aws/integrations/aws-lambda-endpoint/src/main/java/software/amazon/smithy/java/aws/integrations/lambda/package-info.java @@ -0,0 +1,8 @@ +/** + * AWS Lambda endpoint integration. + *
This package is under development and is not intended for use in production. + */ +@SmithyUnstableApi +package software.amazon.smithy.java.aws.integrations.lambda; + +import software.amazon.smithy.utils.SmithyUnstableApi; diff --git a/aws/sdkv2/aws-sdkv2-auth/src/main/java/software/amazon/smithy/java/aws/sdkv2/auth/package-info.java b/aws/sdkv2/aws-sdkv2-auth/src/main/java/software/amazon/smithy/java/aws/sdkv2/auth/package-info.java new file mode 100644 index 000000000..20f67c648 --- /dev/null +++ b/aws/sdkv2/aws-sdkv2-auth/src/main/java/software/amazon/smithy/java/aws/sdkv2/auth/package-info.java @@ -0,0 +1,4 @@ +/** + * Bridge between Smithy Java auth and AWS SDK v2 credentials. + */ +package software.amazon.smithy.java.aws.sdkv2.auth; diff --git a/aws/sdkv2/aws-sdkv2-retries/build.gradle.kts b/aws/sdkv2/aws-sdkv2-retries/build.gradle.kts index 9f1221252..3ab40b46a 100644 --- a/aws/sdkv2/aws-sdkv2-retries/build.gradle.kts +++ b/aws/sdkv2/aws-sdkv2-retries/build.gradle.kts @@ -10,6 +10,5 @@ extra["moduleName"] = "software.amazon.smithy.java.aws.sdkv2.retries" dependencies { api(project(":retries-api")) implementation(libs.aws.sdk.retries.spi) - testImplementation(libs.aws.sdk.retries) } diff --git a/aws/sdkv2/aws-sdkv2-retries/src/main/java/software/amazon/smithy/java/aws/sdkv2/retries/package-info.java b/aws/sdkv2/aws-sdkv2-retries/src/main/java/software/amazon/smithy/java/aws/sdkv2/retries/package-info.java new file mode 100644 index 000000000..9114803e5 --- /dev/null +++ b/aws/sdkv2/aws-sdkv2-retries/src/main/java/software/amazon/smithy/java/aws/sdkv2/retries/package-info.java @@ -0,0 +1,4 @@ +/** + * Bridge between Smithy Java retries and AWS SDK v2 retry strategies. + */ +package software.amazon.smithy.java.aws.sdkv2.retries; diff --git a/aws/sdkv2/aws-sdkv2-shapes/src/main/java/software/amazon/smithy/java/aws/sdkv2/shapes/package-info.java b/aws/sdkv2/aws-sdkv2-shapes/src/main/java/software/amazon/smithy/java/aws/sdkv2/shapes/package-info.java new file mode 100644 index 000000000..e829df8f6 --- /dev/null +++ b/aws/sdkv2/aws-sdkv2-shapes/src/main/java/software/amazon/smithy/java/aws/sdkv2/shapes/package-info.java @@ -0,0 +1,4 @@ +/** + * Bridge between Smithy Java shapes and AWS SDK v2 types. + */ +package software.amazon.smithy.java.aws.sdkv2.shapes; diff --git a/aws/server/aws-server-restjson/src/main/java/software/amazon/smithy/java/aws/server/restjson/package-info.java b/aws/server/aws-server-restjson/src/main/java/software/amazon/smithy/java/aws/server/restjson/package-info.java new file mode 100644 index 000000000..8d8ec4bea --- /dev/null +++ b/aws/server/aws-server-restjson/src/main/java/software/amazon/smithy/java/aws/server/restjson/package-info.java @@ -0,0 +1,4 @@ +/** + * AWS restJson1 server protocol implementation. + */ +package software.amazon.smithy.java.aws.server.restjson; diff --git a/aws/server/aws-server-restjson/src/main/java/software/amazon/smithy/java/aws/server/restjson/router/package-info.java b/aws/server/aws-server-restjson/src/main/java/software/amazon/smithy/java/aws/server/restjson/router/package-info.java new file mode 100644 index 000000000..bbb5edb20 --- /dev/null +++ b/aws/server/aws-server-restjson/src/main/java/software/amazon/smithy/java/aws/server/restjson/router/package-info.java @@ -0,0 +1,4 @@ +/** + * URI routing for the AWS restJson1 server protocol. + */ +package software.amazon.smithy.java.aws.server.restjson.router; diff --git a/cli/src/main/java/software/amazon/smithy/java/cli/package-info.java b/cli/src/main/java/software/amazon/smithy/java/cli/package-info.java index 98d164c2e..a022b1275 100644 --- a/cli/src/main/java/software/amazon/smithy/java/cli/package-info.java +++ b/cli/src/main/java/software/amazon/smithy/java/cli/package-info.java @@ -1,3 +1,7 @@ +/** + * CLI utilities for invoking Smithy services. + *
This package is under development and is not intended for use in production.
+ */
@SmithyUnstableApi
package software.amazon.smithy.java.cli;
diff --git a/client/client-auth-api/src/main/java/software/amazon/smithy/java/client/core/auth/scheme/package-info.java b/client/client-auth-api/src/main/java/software/amazon/smithy/java/client/core/auth/scheme/package-info.java
new file mode 100644
index 000000000..2c48aadee
--- /dev/null
+++ b/client/client-auth-api/src/main/java/software/amazon/smithy/java/client/core/auth/scheme/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Client authentication scheme API.
+ */
+package software.amazon.smithy.java.client.core.auth.scheme;
diff --git a/client/client-core/src/main/java/software/amazon/smithy/java/client/core/endpoint/package-info.java b/client/client-core/src/main/java/software/amazon/smithy/java/client/core/endpoint/package-info.java
new file mode 100644
index 000000000..010f8a533
--- /dev/null
+++ b/client/client-core/src/main/java/software/amazon/smithy/java/client/core/endpoint/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Client endpoint resolution API.
+ */
+package software.amazon.smithy.java.client.core.endpoint;
diff --git a/client/client-core/src/main/java/software/amazon/smithy/java/client/core/error/package-info.java b/client/client-core/src/main/java/software/amazon/smithy/java/client/core/error/package-info.java
new file mode 100644
index 000000000..bf014cf2f
--- /dev/null
+++ b/client/client-core/src/main/java/software/amazon/smithy/java/client/core/error/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Client transport error types.
+ */
+package software.amazon.smithy.java.client.core.error;
diff --git a/client/client-core/src/main/java/software/amazon/smithy/java/client/core/interceptors/package-info.java b/client/client-core/src/main/java/software/amazon/smithy/java/client/core/interceptors/package-info.java
new file mode 100644
index 000000000..a8620ab91
--- /dev/null
+++ b/client/client-core/src/main/java/software/amazon/smithy/java/client/core/interceptors/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Client interceptor API for request and response hooks.
+ */
+package software.amazon.smithy.java.client.core.interceptors;
diff --git a/client/client-core/src/main/java/software/amazon/smithy/java/client/core/package-info.java b/client/client-core/src/main/java/software/amazon/smithy/java/client/core/package-info.java
index 8f0baacc2..1759c5f7b 100644
--- a/client/client-core/src/main/java/software/amazon/smithy/java/client/core/package-info.java
+++ b/client/client-core/src/main/java/software/amazon/smithy/java/client/core/package-info.java
@@ -1,4 +1,4 @@
-@SmithyUnstableApi
+/**
+ * Protocol and transport agnostic client core.
+ */
package software.amazon.smithy.java.client.core;
-
-import software.amazon.smithy.utils.SmithyUnstableApi;
diff --git a/client/client-core/src/main/java/software/amazon/smithy/java/client/core/pagination/package-info.java b/client/client-core/src/main/java/software/amazon/smithy/java/client/core/pagination/package-info.java
new file mode 100644
index 000000000..0f1f63ac1
--- /dev/null
+++ b/client/client-core/src/main/java/software/amazon/smithy/java/client/core/pagination/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Client pagination support.
+ */
+package software.amazon.smithy.java.client.core.pagination;
diff --git a/client/client-core/src/main/java/software/amazon/smithy/java/client/core/plugins/package-info.java b/client/client-core/src/main/java/software/amazon/smithy/java/client/core/plugins/package-info.java
new file mode 100644
index 000000000..fd8b24a43
--- /dev/null
+++ b/client/client-core/src/main/java/software/amazon/smithy/java/client/core/plugins/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Built-in client plugins.
+ */
+package software.amazon.smithy.java.client.core.plugins;
diff --git a/client/client-core/src/main/java/software/amazon/smithy/java/client/core/settings/package-info.java b/client/client-core/src/main/java/software/amazon/smithy/java/client/core/settings/package-info.java
new file mode 100644
index 000000000..6338a2dcc
--- /dev/null
+++ b/client/client-core/src/main/java/software/amazon/smithy/java/client/core/settings/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Client configuration settings.
+ */
+package software.amazon.smithy.java.client.core.settings;
diff --git a/client/client-http-binding/src/main/java/software/amazon/smithy/java/client/http/binding/package-info.java b/client/client-http-binding/src/main/java/software/amazon/smithy/java/client/http/binding/package-info.java
index 2f50aaacb..37548ece9 100644
--- a/client/client-http-binding/src/main/java/software/amazon/smithy/java/client/http/binding/package-info.java
+++ b/client/client-http-binding/src/main/java/software/amazon/smithy/java/client/http/binding/package-info.java
@@ -1,4 +1,4 @@
-@SmithyUnstableApi
+/**
+ * Client-side HTTP binding protocol support.
+ */
package software.amazon.smithy.java.client.http.binding;
-
-import software.amazon.smithy.utils.SmithyUnstableApi;
diff --git a/client/client-http/src/main/java/software/amazon/smithy/java/client/http/auth/package-info.java b/client/client-http/src/main/java/software/amazon/smithy/java/client/http/auth/package-info.java
new file mode 100644
index 000000000..007e6dde4
--- /dev/null
+++ b/client/client-http/src/main/java/software/amazon/smithy/java/client/http/auth/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * HTTP authentication scheme implementations for clients.
+ */
+package software.amazon.smithy.java.client.http.auth;
diff --git a/client/client-http/src/main/java/software/amazon/smithy/java/client/http/compression/package-info.java b/client/client-http/src/main/java/software/amazon/smithy/java/client/http/compression/package-info.java
new file mode 100644
index 000000000..1d03136c1
--- /dev/null
+++ b/client/client-http/src/main/java/software/amazon/smithy/java/client/http/compression/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * HTTP request compression support.
+ */
+package software.amazon.smithy.java.client.http.compression;
diff --git a/client/client-http/src/main/java/software/amazon/smithy/java/client/http/package-info.java b/client/client-http/src/main/java/software/amazon/smithy/java/client/http/package-info.java
index 2deb1b7c6..cc05da8a4 100644
--- a/client/client-http/src/main/java/software/amazon/smithy/java/client/http/package-info.java
+++ b/client/client-http/src/main/java/software/amazon/smithy/java/client/http/package-info.java
@@ -1,4 +1,4 @@
-@SmithyUnstableApi
+/**
+ * HTTP transport implementation for clients.
+ */
package software.amazon.smithy.java.client.http;
-
-import software.amazon.smithy.utils.SmithyUnstableApi;
diff --git a/client/client-http/src/main/java/software/amazon/smithy/java/client/http/plugins/package-info.java b/client/client-http/src/main/java/software/amazon/smithy/java/client/http/plugins/package-info.java
new file mode 100644
index 000000000..4775fed55
--- /dev/null
+++ b/client/client-http/src/main/java/software/amazon/smithy/java/client/http/plugins/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * HTTP-specific client plugins.
+ */
+package software.amazon.smithy.java.client.http.plugins;
diff --git a/client/client-metrics-otel/src/main/java/software/amazon/smithy/java/client/metrics/otel/package-info.java b/client/client-metrics-otel/src/main/java/software/amazon/smithy/java/client/metrics/otel/package-info.java
new file mode 100644
index 000000000..2ffc5ee7e
--- /dev/null
+++ b/client/client-metrics-otel/src/main/java/software/amazon/smithy/java/client/metrics/otel/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * OpenTelemetry metrics for Smithy clients.
+ */
+package software.amazon.smithy.java.client.metrics.otel;
diff --git a/client/client-mock-plugin/src/main/java/software/amazon/smithy/java/client/http/mock/package-info.java b/client/client-mock-plugin/src/main/java/software/amazon/smithy/java/client/http/mock/package-info.java
new file mode 100644
index 000000000..6ed9bfa79
--- /dev/null
+++ b/client/client-mock-plugin/src/main/java/software/amazon/smithy/java/client/http/mock/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Mock transport plugin for testing clients.
+ */
+package software.amazon.smithy.java.client.http.mock;
diff --git a/client/client-rpcv2-cbor/src/main/java/software/amazon/smithy/java/client/rpcv2/package-info.java b/client/client-rpcv2-cbor/src/main/java/software/amazon/smithy/java/client/rpcv2/package-info.java
new file mode 100644
index 000000000..1e0136d04
--- /dev/null
+++ b/client/client-rpcv2-cbor/src/main/java/software/amazon/smithy/java/client/rpcv2/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Client-side rpcv2-cbor protocol implementation.
+ */
+package software.amazon.smithy.java.client.rpcv2;
diff --git a/client/client-rulesengine/src/main/java/software/amazon/smithy/java/client/rulesengine/package-info.java b/client/client-rulesengine/src/main/java/software/amazon/smithy/java/client/rulesengine/package-info.java
new file mode 100644
index 000000000..15311349e
--- /dev/null
+++ b/client/client-rulesengine/src/main/java/software/amazon/smithy/java/client/rulesengine/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Client endpoint rules engine.
+ */
+package software.amazon.smithy.java.client.rulesengine;
diff --git a/client/client-waiters/src/main/java/software/amazon/smithy/java/client/waiters/backoff/package-info.java b/client/client-waiters/src/main/java/software/amazon/smithy/java/client/waiters/backoff/package-info.java
new file mode 100644
index 000000000..d5681c95d
--- /dev/null
+++ b/client/client-waiters/src/main/java/software/amazon/smithy/java/client/waiters/backoff/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Backoff strategies for client waiters.
+ */
+package software.amazon.smithy.java.client.waiters.backoff;
diff --git a/client/client-waiters/src/main/java/software/amazon/smithy/java/client/waiters/jmespath/package-info.java b/client/client-waiters/src/main/java/software/amazon/smithy/java/client/waiters/jmespath/package-info.java
new file mode 100644
index 000000000..497857baf
--- /dev/null
+++ b/client/client-waiters/src/main/java/software/amazon/smithy/java/client/waiters/jmespath/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * JMESPath utilities for waiter matchers.
+ */
+package software.amazon.smithy.java.client.waiters.jmespath;
diff --git a/client/client-waiters/src/main/java/software/amazon/smithy/java/client/waiters/matching/package-info.java b/client/client-waiters/src/main/java/software/amazon/smithy/java/client/waiters/matching/package-info.java
new file mode 100644
index 000000000..7a4a204c3
--- /dev/null
+++ b/client/client-waiters/src/main/java/software/amazon/smithy/java/client/waiters/matching/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Waiter acceptor matchers.
+ */
+package software.amazon.smithy.java.client.waiters.matching;
diff --git a/client/client-waiters/src/main/java/software/amazon/smithy/java/client/waiters/package-info.java b/client/client-waiters/src/main/java/software/amazon/smithy/java/client/waiters/package-info.java
new file mode 100644
index 000000000..1278d2ffd
--- /dev/null
+++ b/client/client-waiters/src/main/java/software/amazon/smithy/java/client/waiters/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Client waiter support for polling operations.
+ */
+package software.amazon.smithy.java.client.waiters;
diff --git a/client/dynamic-client/src/main/java/software/amazon/smithy/java/dynamicclient/package-info.java b/client/dynamic-client/src/main/java/software/amazon/smithy/java/dynamicclient/package-info.java
index 5da5348d6..05c4d953b 100644
--- a/client/dynamic-client/src/main/java/software/amazon/smithy/java/dynamicclient/package-info.java
+++ b/client/dynamic-client/src/main/java/software/amazon/smithy/java/dynamicclient/package-info.java
@@ -1,4 +1,4 @@
-@SmithyUnstableApi
+/**
+ * Dynamic Smithy client that does not require codegen.
+ */
package software.amazon.smithy.java.dynamicclient;
-
-import software.amazon.smithy.utils.SmithyUnstableApi;
diff --git a/client/dynamic-client/src/main/java/software/amazon/smithy/java/dynamicclient/plugins/package-info.java b/client/dynamic-client/src/main/java/software/amazon/smithy/java/dynamicclient/plugins/package-info.java
new file mode 100644
index 000000000..6745c0f7f
--- /dev/null
+++ b/client/dynamic-client/src/main/java/software/amazon/smithy/java/dynamicclient/plugins/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Plugins for the dynamic client.
+ */
+package software.amazon.smithy.java.dynamicclient.plugins;
diff --git a/client/dynamic-client/src/main/java/software/amazon/smithy/java/dynamicclient/settings/package-info.java b/client/dynamic-client/src/main/java/software/amazon/smithy/java/dynamicclient/settings/package-info.java
new file mode 100644
index 000000000..9e82a876e
--- /dev/null
+++ b/client/dynamic-client/src/main/java/software/amazon/smithy/java/dynamicclient/settings/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Settings for the dynamic client.
+ */
+package software.amazon.smithy.java.dynamicclient.settings;
diff --git a/codecs/cbor-codec/src/main/java/software/amazon/smithy/java/cbor/package-info.java b/codecs/cbor-codec/src/main/java/software/amazon/smithy/java/cbor/package-info.java
new file mode 100644
index 000000000..c1cf5186f
--- /dev/null
+++ b/codecs/cbor-codec/src/main/java/software/amazon/smithy/java/cbor/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * CBOR codec for binary serialization and deserialization.
+ */
+package software.amazon.smithy.java.cbor;
diff --git a/codecs/json-codec/src/main/java/software/amazon/smithy/java/json/jackson/package-info.java b/codecs/json-codec/src/main/java/software/amazon/smithy/java/json/jackson/package-info.java
new file mode 100644
index 000000000..c0c10b0fc
--- /dev/null
+++ b/codecs/json-codec/src/main/java/software/amazon/smithy/java/json/jackson/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Jackson-based JSON serialization and deserialization.
+ */
+package software.amazon.smithy.java.json.jackson;
diff --git a/codecs/json-codec/src/main/java/software/amazon/smithy/java/json/package-info.java b/codecs/json-codec/src/main/java/software/amazon/smithy/java/json/package-info.java
index cac79daf0..c1dd901dd 100644
--- a/codecs/json-codec/src/main/java/software/amazon/smithy/java/json/package-info.java
+++ b/codecs/json-codec/src/main/java/software/amazon/smithy/java/json/package-info.java
@@ -1,4 +1,4 @@
-@SmithyUnstableApi
+/**
+ * JSON codec for serialization and deserialization.
+ */
package software.amazon.smithy.java.json;
-
-import software.amazon.smithy.utils.SmithyUnstableApi;
diff --git a/codecs/xml-codec/src/main/java/software/amazon/smithy/java/xml/package-info.java b/codecs/xml-codec/src/main/java/software/amazon/smithy/java/xml/package-info.java
new file mode 100644
index 000000000..765a73dfd
--- /dev/null
+++ b/codecs/xml-codec/src/main/java/software/amazon/smithy/java/xml/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * XML codec for serialization and deserialization.
+ */
+package software.amazon.smithy.java.xml;
diff --git a/codegen/codegen-core/src/main/java/software/amazon/smithy/framework/knowledge/package-info.java b/codegen/codegen-core/src/main/java/software/amazon/smithy/framework/knowledge/package-info.java
new file mode 100644
index 000000000..d483c8a2b
--- /dev/null
+++ b/codegen/codegen-core/src/main/java/software/amazon/smithy/framework/knowledge/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Knowledge index types for framework error handling.
+ */
+package software.amazon.smithy.framework.knowledge;
diff --git a/codegen/codegen-core/src/main/java/software/amazon/smithy/framework/traits/package-info.java b/codegen/codegen-core/src/main/java/software/amazon/smithy/framework/traits/package-info.java
new file mode 100644
index 000000000..85056f2e3
--- /dev/null
+++ b/codegen/codegen-core/src/main/java/software/amazon/smithy/framework/traits/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Trait definitions for framework errors.
+ */
+package software.amazon.smithy.framework.traits;
diff --git a/codegen/codegen-core/src/main/java/software/amazon/smithy/framework/transform/package-info.java b/codegen/codegen-core/src/main/java/software/amazon/smithy/framework/transform/package-info.java
new file mode 100644
index 000000000..75bf0ba8c
--- /dev/null
+++ b/codegen/codegen-core/src/main/java/software/amazon/smithy/framework/transform/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Model transforms for framework error handling.
+ */
+package software.amazon.smithy.framework.transform;
diff --git a/codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/ExternalSymbols.java b/codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/ExternalSymbols.java
index 58f80a7e3..85db5ca97 100644
--- a/codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/ExternalSymbols.java
+++ b/codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/ExternalSymbols.java
@@ -6,11 +6,13 @@
package software.amazon.smithy.java.codegen;
import software.amazon.smithy.codegen.core.Symbol;
+import software.amazon.smithy.utils.SmithyInternalApi;
/**
* Pre-built Symbol objects for types from modules that are NOT on the compile classpath
* of codegen-plugin (e.g., framework-errors generated types).
*/
+@SmithyInternalApi
public final class ExternalSymbols {
private ExternalSymbols() {}
diff --git a/codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/ServerSymbolProperties.java b/codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/ServerSymbolProperties.java
index 47979994d..a86a18d5a 100644
--- a/codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/ServerSymbolProperties.java
+++ b/codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/ServerSymbolProperties.java
@@ -7,12 +7,14 @@
import software.amazon.smithy.codegen.core.Property;
import software.amazon.smithy.codegen.core.Symbol;
+import software.amazon.smithy.utils.SmithyUnstableApi;
/**
* Contains server-specific properties that may be added to symbols by smithy-java.
*
* @see software.amazon.smithy.java.codegen.SymbolProperties for other properties that may be added to symbols.
*/
+@SmithyUnstableApi
public final class ServerSymbolProperties {
private ServerSymbolProperties() {}
diff --git a/codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/SyntheticServiceTransform.java b/codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/SyntheticServiceTransform.java
index 0aca09faf..3a2f0e9f7 100644
--- a/codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/SyntheticServiceTransform.java
+++ b/codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/SyntheticServiceTransform.java
@@ -21,6 +21,7 @@
import software.amazon.smithy.model.traits.ErrorTrait;
import software.amazon.smithy.model.traits.PrivateTrait;
import software.amazon.smithy.model.transform.ModelTransformer;
+import software.amazon.smithy.utils.SmithyInternalApi;
/**
* Generates a synthetic service for a set of shapes.
@@ -33,6 +34,7 @@
* provides renames for a set of shapes as well as the list of protocols the shapes should support. This
* transform creates a synthetic service that Directed codegen can use to generate the provided set of shapes.
*/
+@SmithyInternalApi
public final class SyntheticServiceTransform {
private static final InternalLogger LOGGER = InternalLogger.getLogger(SyntheticServiceTransform.class);
public static final String SYNTHETIC_NAMESPACE = "smithy.synthetic";
diff --git a/codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/TraitInitializer.java b/codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/TraitInitializer.java
index 09917b441..d2ad6f4d7 100644
--- a/codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/TraitInitializer.java
+++ b/codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/TraitInitializer.java
@@ -9,6 +9,7 @@
import software.amazon.smithy.java.codegen.writer.JavaWriter;
import software.amazon.smithy.java.core.schema.Schema;
import software.amazon.smithy.model.traits.Trait;
+import software.amazon.smithy.utils.SmithyInternalApi;
/**
* Writes an initializer for a trait when adding that trait to a {@link Schema}.
@@ -27,6 +28,7 @@
* {@code TraitService} service provider interface to identify the correct trait provider class for a given trait ID.
* The trait is then initialized using the trait provider and a {@code Node}.
*/
+@SmithyInternalApi
public interface TraitInitializer This package is under development and is not intended for use in production.
+ */
+@SmithyUnstableApi
+package software.amazon.smithy.java.codegen.test;
+
+import software.amazon.smithy.utils.SmithyUnstableApi;
diff --git a/context/src/main/java/software/amazon/smithy/java/context/package-info.java b/context/src/main/java/software/amazon/smithy/java/context/package-info.java
new file mode 100644
index 000000000..b0b04899c
--- /dev/null
+++ b/context/src/main/java/software/amazon/smithy/java/context/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Context propagation utilities.
+ */
+package software.amazon.smithy.java.context;
diff --git a/core/src/main/java/software/amazon/smithy/java/core/error/package-info.java b/core/src/main/java/software/amazon/smithy/java/core/error/package-info.java
new file mode 100644
index 000000000..7dfa2bbb7
--- /dev/null
+++ b/core/src/main/java/software/amazon/smithy/java/core/error/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Core error types for modeled exceptions.
+ */
+package software.amazon.smithy.java.core.error;
diff --git a/core/src/main/java/software/amazon/smithy/java/core/package-info.java b/core/src/main/java/software/amazon/smithy/java/core/package-info.java
new file mode 100644
index 000000000..682d95548
--- /dev/null
+++ b/core/src/main/java/software/amazon/smithy/java/core/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Core runtime types for Smithy Java.
+ */
+package software.amazon.smithy.java.core;
diff --git a/core/src/main/java/software/amazon/smithy/java/core/schema/package-info.java b/core/src/main/java/software/amazon/smithy/java/core/schema/package-info.java
new file mode 100644
index 000000000..9af7b01e2
--- /dev/null
+++ b/core/src/main/java/software/amazon/smithy/java/core/schema/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Schema definitions and shape builders for the Smithy data model.
+ */
+package software.amazon.smithy.java.core.schema;
diff --git a/core/src/main/java/software/amazon/smithy/java/core/serde/document/package-info.java b/core/src/main/java/software/amazon/smithy/java/core/serde/document/package-info.java
new file mode 100644
index 000000000..730f6aac2
--- /dev/null
+++ b/core/src/main/java/software/amazon/smithy/java/core/serde/document/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Document type and document-based serialization.
+ */
+package software.amazon.smithy.java.core.serde.document;
diff --git a/core/src/main/java/software/amazon/smithy/java/core/serde/event/package-info.java b/core/src/main/java/software/amazon/smithy/java/core/serde/event/package-info.java
new file mode 100644
index 000000000..439376e61
--- /dev/null
+++ b/core/src/main/java/software/amazon/smithy/java/core/serde/event/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Event stream serialization and deserialization.
+ */
+package software.amazon.smithy.java.core.serde.event;
diff --git a/core/src/main/java/software/amazon/smithy/java/core/serde/package-info.java b/core/src/main/java/software/amazon/smithy/java/core/serde/package-info.java
new file mode 100644
index 000000000..e32690ea1
--- /dev/null
+++ b/core/src/main/java/software/amazon/smithy/java/core/serde/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Serialization and deserialization framework.
+ */
+package software.amazon.smithy.java.core.serde;
diff --git a/dynamic-schemas/src/main/java/software/amazon/smithy/java/dynamicschemas/package-info.java b/dynamic-schemas/src/main/java/software/amazon/smithy/java/dynamicschemas/package-info.java
index 94435bba9..c435c655f 100644
--- a/dynamic-schemas/src/main/java/software/amazon/smithy/java/dynamicschemas/package-info.java
+++ b/dynamic-schemas/src/main/java/software/amazon/smithy/java/dynamicschemas/package-info.java
@@ -1,4 +1,4 @@
-@SmithyUnstableApi
+/**
+ * Dynamic schema-driven document types.
+ */
package software.amazon.smithy.java.dynamicschemas;
-
-import software.amazon.smithy.utils.SmithyUnstableApi;
diff --git a/framework-errors/src/main/java/software/amazon/smithy/framework/knowledge/package-info.java b/framework-errors/src/main/java/software/amazon/smithy/framework/knowledge/package-info.java
new file mode 100644
index 000000000..d483c8a2b
--- /dev/null
+++ b/framework-errors/src/main/java/software/amazon/smithy/framework/knowledge/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Knowledge index types for framework error handling.
+ */
+package software.amazon.smithy.framework.knowledge;
diff --git a/framework-errors/src/main/java/software/amazon/smithy/framework/traits/package-info.java b/framework-errors/src/main/java/software/amazon/smithy/framework/traits/package-info.java
new file mode 100644
index 000000000..85056f2e3
--- /dev/null
+++ b/framework-errors/src/main/java/software/amazon/smithy/framework/traits/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Trait definitions for framework errors.
+ */
+package software.amazon.smithy.framework.traits;
diff --git a/framework-errors/src/main/java/software/amazon/smithy/framework/transform/package-info.java b/framework-errors/src/main/java/software/amazon/smithy/framework/transform/package-info.java
new file mode 100644
index 000000000..75bf0ba8c
--- /dev/null
+++ b/framework-errors/src/main/java/software/amazon/smithy/framework/transform/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Model transforms for framework error handling.
+ */
+package software.amazon.smithy.framework.transform;
diff --git a/fuzz-test-harness/src/main/java/software/amazon/smithy/java/fuzz/package-info.java b/fuzz-test-harness/src/main/java/software/amazon/smithy/java/fuzz/package-info.java
new file mode 100644
index 000000000..04d382c01
--- /dev/null
+++ b/fuzz-test-harness/src/main/java/software/amazon/smithy/java/fuzz/package-info.java
@@ -0,0 +1,8 @@
+/**
+ * Fuzz testing harness for codecs.
+ * This package is for smithy-java internal use only.
+ */
+@SmithyInternalApi
+package software.amazon.smithy.java.fuzz;
+
+import software.amazon.smithy.utils.SmithyInternalApi;
diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
index 92ed94347..2e1113280 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -1,7 +1,6 @@
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
-distributionSha256Sum=60ea723356d81263e8002fec0fcf9e2b0eee0c0850c7a3d7ab0a63f2ccc601f3
-distributionUrl=https\://services.gradle.org/distributions/gradle-9.4.0-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.1.0-bin.zip
networkTimeout=10000
validateDistributionUrl=true
zipStoreBase=GRADLE_USER_HOME
diff --git a/http/http-api/src/main/java/software/amazon/smithy/java/http/api/package-info.java b/http/http-api/src/main/java/software/amazon/smithy/java/http/api/package-info.java
new file mode 100644
index 000000000..e7c9859dc
--- /dev/null
+++ b/http/http-api/src/main/java/software/amazon/smithy/java/http/api/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * HTTP message API types.
+ */
+package software.amazon.smithy.java.http.api;
diff --git a/http/http-binding/src/main/java/software/amazon/smithy/java/http/binding/package-info.java b/http/http-binding/src/main/java/software/amazon/smithy/java/http/binding/package-info.java
index 085476212..2417ef5d0 100644
--- a/http/http-binding/src/main/java/software/amazon/smithy/java/http/binding/package-info.java
+++ b/http/http-binding/src/main/java/software/amazon/smithy/java/http/binding/package-info.java
@@ -1,4 +1,4 @@
-@SmithyUnstableApi
+/**
+ * HTTP binding serialization and deserialization.
+ */
package software.amazon.smithy.java.http.binding;
-
-import software.amazon.smithy.utils.SmithyUnstableApi;
diff --git a/io/src/main/java/software/amazon/smithy/java/io/datastream/package-info.java b/io/src/main/java/software/amazon/smithy/java/io/datastream/package-info.java
new file mode 100644
index 000000000..d82547d7c
--- /dev/null
+++ b/io/src/main/java/software/amazon/smithy/java/io/datastream/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Data stream types for streaming payloads.
+ */
+package software.amazon.smithy.java.io.datastream;
diff --git a/io/src/main/java/software/amazon/smithy/java/io/package-info.java b/io/src/main/java/software/amazon/smithy/java/io/package-info.java
new file mode 100644
index 000000000..3f87f28fb
--- /dev/null
+++ b/io/src/main/java/software/amazon/smithy/java/io/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Common I/O utilities.
+ */
+package software.amazon.smithy.java.io;
diff --git a/io/src/main/java/software/amazon/smithy/java/io/uri/package-info.java b/io/src/main/java/software/amazon/smithy/java/io/uri/package-info.java
new file mode 100644
index 000000000..abdb3f85b
--- /dev/null
+++ b/io/src/main/java/software/amazon/smithy/java/io/uri/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * URI building and encoding utilities.
+ */
+package software.amazon.smithy.java.io.uri;
diff --git a/jmespath/src/main/java/software/amazon/smithy/java/jmespath/package-info.java b/jmespath/src/main/java/software/amazon/smithy/java/jmespath/package-info.java
index 8f7bfa84f..98e99dc41 100644
--- a/jmespath/src/main/java/software/amazon/smithy/java/jmespath/package-info.java
+++ b/jmespath/src/main/java/software/amazon/smithy/java/jmespath/package-info.java
@@ -1,4 +1,4 @@
-@SmithyUnstableApi
+/**
+ * JMESPath expression evaluation for Documents.
+ */
package software.amazon.smithy.java.jmespath;
-
-import software.amazon.smithy.utils.SmithyUnstableApi;
diff --git a/logging/src/main/java/software/amazon/smithy/java/logging/package-info.java b/logging/src/main/java/software/amazon/smithy/java/logging/package-info.java
new file mode 100644
index 000000000..a4dab57f5
--- /dev/null
+++ b/logging/src/main/java/software/amazon/smithy/java/logging/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Internal logging abstraction.
+ */
+package software.amazon.smithy.java.logging;
diff --git a/mcp/mcp-server/src/main/java/software/amazon/smithy/java/mcp/server/package-info.java b/mcp/mcp-server/src/main/java/software/amazon/smithy/java/mcp/server/package-info.java
new file mode 100644
index 000000000..0221e2c32
--- /dev/null
+++ b/mcp/mcp-server/src/main/java/software/amazon/smithy/java/mcp/server/package-info.java
@@ -0,0 +1,8 @@
+/**
+ * MCP server implementation for exposing Smithy services as tools.
+ * This package is under development and is not intended for use in production.
+ */
+@SmithyUnstableApi
+package software.amazon.smithy.java.mcp.server;
+
+import software.amazon.smithy.utils.SmithyUnstableApi;
diff --git a/model-bundle/model-bundle-api/src/main/java/software/amazon/smithy/modelbundle/api/package-info.java b/model-bundle/model-bundle-api/src/main/java/software/amazon/smithy/modelbundle/api/package-info.java
new file mode 100644
index 000000000..372746b79
--- /dev/null
+++ b/model-bundle/model-bundle-api/src/main/java/software/amazon/smithy/modelbundle/api/package-info.java
@@ -0,0 +1,8 @@
+/**
+ * Model bundling API for packaging service models.
+ * This package is under development and is not intended for use in production.
+ */
+@SmithyUnstableApi
+package software.amazon.smithy.modelbundle.api;
+
+import software.amazon.smithy.utils.SmithyUnstableApi;
diff --git a/protocol-test-harness/src/main/java/software/amazon/smithy/java/protocoltests/generators/package-info.java b/protocol-test-harness/src/main/java/software/amazon/smithy/java/protocoltests/generators/package-info.java
new file mode 100644
index 000000000..e52e674df
--- /dev/null
+++ b/protocol-test-harness/src/main/java/software/amazon/smithy/java/protocoltests/generators/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Protocol test code generators.
+ */
+package software.amazon.smithy.java.protocoltests.generators;
diff --git a/protocol-test-harness/src/main/java/software/amazon/smithy/java/protocoltests/harness/package-info.java b/protocol-test-harness/src/main/java/software/amazon/smithy/java/protocoltests/harness/package-info.java
new file mode 100644
index 000000000..7c93d9e97
--- /dev/null
+++ b/protocol-test-harness/src/main/java/software/amazon/smithy/java/protocoltests/harness/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Protocol test harness for validating protocol implementations.
+ */
+package software.amazon.smithy.java.protocoltests.harness;
diff --git a/retries-api/src/main/java/software/amazon/smithy/java/retries/api/package-info.java b/retries-api/src/main/java/software/amazon/smithy/java/retries/api/package-info.java
new file mode 100644
index 000000000..ff499d4e3
--- /dev/null
+++ b/retries-api/src/main/java/software/amazon/smithy/java/retries/api/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * Retry strategy API.
+ */
+package software.amazon.smithy.java.retries.api;
diff --git a/server/server-api/src/main/java/software/amazon/smithy/java/server/package-info.java b/server/server-api/src/main/java/software/amazon/smithy/java/server/package-info.java
new file mode 100644
index 000000000..b4a65be66
--- /dev/null
+++ b/server/server-api/src/main/java/software/amazon/smithy/java/server/package-info.java
@@ -0,0 +1,8 @@
+/**
+ * Server API types and interfaces.
+ * This package is under development and is not intended for use in production.
+ */
+@SmithyUnstableApi
+package software.amazon.smithy.java.server;
+
+import software.amazon.smithy.utils.SmithyUnstableApi;
diff --git a/server/server-core/src/main/java/software/amazon/smithy/java/server/core/package-info.java b/server/server-core/src/main/java/software/amazon/smithy/java/server/core/package-info.java
new file mode 100644
index 000000000..242214a72
--- /dev/null
+++ b/server/server-core/src/main/java/software/amazon/smithy/java/server/core/package-info.java
@@ -0,0 +1,8 @@
+/**
+ * Core server orchestration and protocol handling.
+ * This package is under development and is not intended for use in production.
+ */
+@SmithyUnstableApi
+package software.amazon.smithy.java.server.core;
+
+import software.amazon.smithy.utils.SmithyUnstableApi;
diff --git a/server/server-core/src/main/java/software/amazon/smithy/java/server/package-info.java b/server/server-core/src/main/java/software/amazon/smithy/java/server/package-info.java
new file mode 100644
index 000000000..b4a65be66
--- /dev/null
+++ b/server/server-core/src/main/java/software/amazon/smithy/java/server/package-info.java
@@ -0,0 +1,8 @@
+/**
+ * Server API types and interfaces.
+ * This package is under development and is not intended for use in production.
+ */
+@SmithyUnstableApi
+package software.amazon.smithy.java.server;
+
+import software.amazon.smithy.utils.SmithyUnstableApi;
diff --git a/server/server-netty/src/main/java/software/amazon/smithy/java/server/netty/package-info.java b/server/server-netty/src/main/java/software/amazon/smithy/java/server/netty/package-info.java
new file mode 100644
index 000000000..0f58274d0
--- /dev/null
+++ b/server/server-netty/src/main/java/software/amazon/smithy/java/server/netty/package-info.java
@@ -0,0 +1,8 @@
+/**
+ * Netty-based HTTP server implementation.
+ * This package is under development and is not intended for use in production.
+ */
+@SmithyUnstableApi
+package software.amazon.smithy.java.server.netty;
+
+import software.amazon.smithy.utils.SmithyUnstableApi;
diff --git a/server/server-proxy/src/main/java/software/amazon/smithy/java/server/package-info.java b/server/server-proxy/src/main/java/software/amazon/smithy/java/server/package-info.java
new file mode 100644
index 000000000..b4a65be66
--- /dev/null
+++ b/server/server-proxy/src/main/java/software/amazon/smithy/java/server/package-info.java
@@ -0,0 +1,8 @@
+/**
+ * Server API types and interfaces.
+ * This package is under development and is not intended for use in production.
+ */
+@SmithyUnstableApi
+package software.amazon.smithy.java.server;
+
+import software.amazon.smithy.utils.SmithyUnstableApi;
diff --git a/server/server-rpcv2-cbor/src/main/java/software/amazon/smithy/java/server/rpcv2/package-info.java b/server/server-rpcv2-cbor/src/main/java/software/amazon/smithy/java/server/rpcv2/package-info.java
index 11f773e6b..dc6b4c734 100644
--- a/server/server-rpcv2-cbor/src/main/java/software/amazon/smithy/java/server/rpcv2/package-info.java
+++ b/server/server-rpcv2-cbor/src/main/java/software/amazon/smithy/java/server/rpcv2/package-info.java
@@ -1,3 +1,7 @@
+/**
+ * Server-side rpcv2-cbor protocol implementation.
+ * This package is under development and is not intended for use in production.
+ */
@SmithyUnstableApi
package software.amazon.smithy.java.server.rpcv2;
diff --git a/smithy-ai-traits/src/main/java/software/amazon/smithy/ai/package-info.java b/smithy-ai-traits/src/main/java/software/amazon/smithy/ai/package-info.java
new file mode 100644
index 000000000..28899c864
--- /dev/null
+++ b/smithy-ai-traits/src/main/java/software/amazon/smithy/ai/package-info.java
@@ -0,0 +1,8 @@
+/**
+ * Smithy AI traits and validators.
+ * This package is under development and is not intended for use in production.
+ */
+@SmithyUnstableApi
+package software.amazon.smithy.ai;
+
+import software.amazon.smithy.utils.SmithyUnstableApi;