Add package info and unstable annotations

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;

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;

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;

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;

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.
+ * <p>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;

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.
+ * <p>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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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.
+ * <p>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;

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;

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)
 }

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;

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;

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;

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;

cli/src/main/java/software/amazon/smithy/java/cli/package-info.java

@@ -1,3 +1,7 @@
+/**
+ * CLI utilities for invoking Smithy services.
+ * <p>This package is under development and is not intended for use in production.
+ */
 @SmithyUnstableApi
 package software.amazon.smithy.java.cli;
 

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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;

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() {}
 

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() {}

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";

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<T extends Trait> extends BiConsumer<JavaWriter, T> {
     Class<T> traitClass();
 }

codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/TypeCodegenSettings.java

@@ -14,7 +14,9 @@
 import software.amazon.smithy.model.node.ObjectNode;
 import software.amazon.smithy.model.selector.Selector;
 import software.amazon.smithy.model.shapes.ShapeId;
+import software.amazon.smithy.utils.SmithyInternalApi;
 
+@SmithyInternalApi
 public final class TypeCodegenSettings {
     private static final String SHAPES = "shapes";
     private static final String SELECTOR = "selector";

codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/generators/package-info.java

@@ -0,0 +1,4 @@
+/**
+ * Shape and type code generators.
+ */
+package software.amazon.smithy.java.codegen.generators;

codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/integrations/core/package-info.java

@@ -0,0 +1,4 @@
+/**
+ * Core codegen integrations and trait initializers.
+ */
+package software.amazon.smithy.java.codegen.integrations.core;

codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/integrations/javadoc/package-info.java

@@ -0,0 +1,4 @@
+/**
+ * Javadoc generation integrations for codegen.
+ */
+package software.amazon.smithy.java.codegen.integrations.javadoc;

codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/package-info.java

@@ -0,0 +1,4 @@
+/**
+ * Core code generation framework for Smithy Java.
+ */
+package software.amazon.smithy.java.codegen;

codegen/codegen-core/src/main/java/software/amazon/smithy/java/codegen/sections/package-info.java

@@ -0,0 +1,4 @@
+/**
+ * Codegen section types for interceptor-based customization.
+ */
+package software.amazon.smithy.java.codegen.sections;