refactor!: resolve all split packages across Maven modules (#987)

* refactor: resolve all split packages across Maven modules

Rename packages in leaf/dependent modules so no Java package spans
multiple Maven modules. This eliminates duplicate package-info.class
in published jars (which broke Android builds) and enables
javadoc:aggregate.

Package moves:
- org.a2aproject.sdk.util (spec) -> org.a2aproject.sdk.spec.util
- org.a2aproject.sdk.extras.opentelemetry (server) -> org.a2aproject.sdk.extras.opentelemetry.server
- org.a2aproject.sdk.client.http (android) -> org.a2aproject.sdk.client.http.android
- org.a2aproject.sdk.client.http (vertx) -> org.a2aproject.sdk.client.http.vertx
- org.a2aproject.sdk.compat03.conversion (test) -> org.a2aproject.sdk.compat03.conversion.test
- org.a2aproject.sdk.examples.helloworld -> .client / .server sub-packages
- org.a2aproject.sdk.test -> org.a2aproject.sdk.bom.test.{sdk,reference,extras}
- org.a2aproject.sdk.server.events (test) -> org.a2aproject.sdk.extras.queuemanager.replicated.events
- Remove EventQueueTestHelper from org.a2aproject.sdk.server.events in the replicated module (split package with server-common). 
- Consolidate tapQueue() into server-common's test-jar EventQueueUtil and add a test-jar dependency.

This fixes #978

Author: kabir

AGENTS.md

@@ -66,6 +66,7 @@ mvn clean install
 - Use `org.a2aproject.sdk.util.Assert.checkNotNullParam()` in the compact constructor to validate required fields
 - Use `List.copyOf()` and `Map.copyOf()` for defensive copying of collections
 - Apply the Builder pattern for records with many fields (see `AgentCard.java` as reference)
+- Do not split Java packages across Maven modules in production code (each package must belong to exactly one module). Test code may share a package with production code to access package-private members.
 
 ### Code generation
 

boms/extras/src/it/extras-usage-test/pom.xml

@@ -158,7 +158,7 @@
                             <goal>java</goal>
                         </goals>
                         <configuration>
-                            <mainClass>org.a2aproject.sdk.test.ExtrasBomVerifier</mainClass>
+                            <mainClass>org.a2aproject.sdk.bom.test.extras.ExtrasBomVerifier</mainClass>
                         </configuration>
                     </execution>
                 </executions>

…aproject/sdk/test/ExtrasBomVerifier.java …k/bom/test/extras/ExtrasBomVerifier.javaboms/extras/src/it/extras-usage-test/src/main/java/org/a2aproject/sdk/test/ExtrasBomVerifier.java renamed to boms/extras/src/it/extras-usage-test/src/main/java/org/a2aproject/sdk/bom/test/extras/ExtrasBomVerifier.java boms/extras/src/it/extras-usage-test/src/main/java/org/a2aproject/sdk/test/ExtrasBomVerifier.java renamed to boms/extras/src/it/extras-usage-test/src/main/java/org/a2aproject/sdk/bom/test/extras/ExtrasBomVerifier.java

@@ -1,4 +1,4 @@
-package org.a2aproject.sdk.test;
+package org.a2aproject.sdk.bom.test.extras;
 
 import org.a2aproject.sdk.bom.test.DynamicBomVerifier;
 

boms/reference/src/it/reference-usage-test/pom.xml

@@ -155,7 +155,7 @@
                             <goal>java</goal>
                         </goals>
                         <configuration>
-                            <mainClass>org.a2aproject.sdk.test.ReferenceBomVerifier</mainClass>
+                            <mainClass>org.a2aproject.sdk.bom.test.reference.ReferenceBomVerifier</mainClass>
                         </configuration>
                     </execution>
                 </executions>

…oject/sdk/test/ReferenceBomVerifier.java …test/reference/ReferenceBomVerifier.javaboms/reference/src/it/reference-usage-test/src/main/java/org/a2aproject/sdk/test/ReferenceBomVerifier.java renamed to boms/reference/src/it/reference-usage-test/src/main/java/org/a2aproject/sdk/bom/test/reference/ReferenceBomVerifier.java boms/reference/src/it/reference-usage-test/src/main/java/org/a2aproject/sdk/test/ReferenceBomVerifier.java renamed to boms/reference/src/it/reference-usage-test/src/main/java/org/a2aproject/sdk/bom/test/reference/ReferenceBomVerifier.java

@@ -1,4 +1,4 @@
-package org.a2aproject.sdk.test;
+package org.a2aproject.sdk.bom.test.reference;
 
 import org.a2aproject.sdk.bom.test.DynamicBomVerifier;
 

boms/sdk/src/it/sdk-usage-test/pom.xml

@@ -196,7 +196,7 @@
                             <goal>java</goal>
                         </goals>
                         <configuration>
-                            <mainClass>org.a2aproject.sdk.test.SdkBomVerifier</mainClass>
+                            <mainClass>org.a2aproject.sdk.bom.test.sdk.SdkBomVerifier</mainClass>
                         </configuration>
                     </execution>
                 </executions>

…/a2aproject/sdk/test/SdkBomVerifier.java …ect/sdk/bom/test/sdk/SdkBomVerifier.javaboms/sdk/src/it/sdk-usage-test/src/main/java/org/a2aproject/sdk/test/SdkBomVerifier.java renamed to boms/sdk/src/it/sdk-usage-test/src/main/java/org/a2aproject/sdk/bom/test/sdk/SdkBomVerifier.java boms/sdk/src/it/sdk-usage-test/src/main/java/org/a2aproject/sdk/test/SdkBomVerifier.java renamed to boms/sdk/src/it/sdk-usage-test/src/main/java/org/a2aproject/sdk/bom/test/sdk/SdkBomVerifier.java

@@ -1,4 +1,4 @@
-package org.a2aproject.sdk.test;
+package org.a2aproject.sdk.bom.test.sdk;
 
 import org.a2aproject.sdk.bom.test.DynamicBomVerifier;
 

client/base/src/main/java/org/a2aproject/sdk/client/ClientTaskManager.java

@@ -1,6 +1,6 @@
 package org.a2aproject.sdk.client;
 
-import static org.a2aproject.sdk.util.Utils.appendArtifactToTask;
+import static org.a2aproject.sdk.spec.util.Utils.appendArtifactToTask;
 
 import java.util.ArrayList;
 import java.util.HashMap;

client/transport/jsonrpc/src/main/java/org/a2aproject/sdk/client/transport/jsonrpc/JSONRPCTransport.java

@@ -65,7 +65,7 @@
 import org.a2aproject.sdk.spec.TaskIdParams;
 import org.a2aproject.sdk.spec.TaskPushNotificationConfig;
 import org.a2aproject.sdk.spec.TaskQueryParams;
-import org.a2aproject.sdk.util.Utils;
+import org.a2aproject.sdk.spec.util.Utils;
 import org.jspecify.annotations.Nullable;
 
 public class JSONRPCTransport implements ClientTransport {

client/transport/jsonrpc/src/test/java/org/a2aproject/sdk/client/transport/jsonrpc/JSONRPCTransportTest.java

@@ -66,7 +66,7 @@
 import org.a2aproject.sdk.spec.TaskQueryParams;
 import org.a2aproject.sdk.spec.TaskState;
 import org.a2aproject.sdk.spec.TextPart;
-import org.a2aproject.sdk.util.Utils;
+import org.a2aproject.sdk.spec.util.Utils;
 import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;