chore: Fix generation of javadoc comments

.github/workflows/test.yml

@@ -26,3 +26,6 @@ jobs:
 
       - name: Test
         run: mvn -B test
+
+      - name: Javadoc
+        run: mvn -B javadoc:javadoc

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.10.1] - 2026-JUN-23
+
+### Fixed
+
+- **Maven Central publish**: Javadoc generation failed on model comments containing `>`, `>=`, or `->` from OpenAPI descriptions (e.g. margin threshold comparisons, call priority ordering). Disabled doclint HTML checks in `maven-javadoc-plugin` so generated comments stay human-readable while Javadoc still builds for release.
+- **CI**: PR workflow runs `mvn javadoc:javadoc` so Javadoc failures are caught before release.
+
 ## [1.10.0] - 2026-JUN-17
 
 ### Added

pom.xml

@@ -21,7 +21,7 @@
   <description>Sample Java SDK for the Coinbase Prime REST APIs</description>
   <groupId>com.coinbase.prime</groupId>
   <url>https://github.com/coinbase/prime-sdk-java</url>
-  <version>1.10.0</version>
+  <version>1.10.1</version>
   <licenses>
     <license>
       <name>Apache License, Version 2.0</name>
@@ -96,6 +96,9 @@
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-javadoc-plugin</artifactId>
         <version>3.7.0</version>
+        <configuration>
+          <doclint>none</doclint>
+        </configuration>
         <executions>
           <execution>
             <id>attach-javadocs</id>

tools/model-generator/pom.xml

@@ -75,6 +75,13 @@
             <artifactId>slf4j-simple</artifactId>
             <version>2.0.9</version>
         </dependency>
+
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter</artifactId>
+            <version>5.10.0</version>
+            <scope>test</scope>
+        </dependency>
     </dependencies>
 
     <build>
@@ -88,6 +95,11 @@
                     <target>11</target>
                 </configuration>
             </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-surefire-plugin</artifactId>
+                <version>3.0.0-M5</version>
+            </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-shade-plugin</artifactId>

tools/model-generator/src/test/java/com/coinbase/tools/modelgenerator/PostProcessorJavadocTest.java

@@ -0,0 +1,71 @@
+/*
+ * Copyright 2026-present Coinbase Global, Inc.
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+package com.coinbase.tools.modelgenerator;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import org.junit.jupiter.api.Test;
+
+class PostProcessorJavadocTest {
+
+  @Test
+  void decodeHtmlEntities_decodesCommonEntities() {
+    assertEquals(
+        "aged > urgent > standard > debit",
+        PostProcessor.decodeHtmlEntities("aged > urgent > standard > debit"));
+    assertEquals(
+        "EQ / MR >= threshold_value",
+        PostProcessor.decodeHtmlEntities("EQ / MR >= threshold_value"));
+    assertEquals(
+        "(tier_a, tier_b) -> rate",
+        PostProcessor.decodeHtmlEntities("(tier_a, tier_b) -> rate"));
+    assertEquals(
+        "margin excess is > 0",
+        PostProcessor.decodeHtmlEntities("margin excess is > 0"));
+  }
+
+  @Test
+  void decodeHtmlEntities_leavesPlainTextUnchanged() {
+    assertEquals(
+        "aged > urgent > standard > debit",
+        PostProcessor.decodeHtmlEntities("aged > urgent > standard > debit"));
+    assertEquals(
+        "EQ / MR >= threshold_value",
+        PostProcessor.decodeHtmlEntities("EQ / MR >= threshold_value"));
+  }
+
+  @Test
+  void decodeHtmlEntities_decodesAcrossFullFileContent() {
+    String input =
+        "public class Foo {\n"
+            + "  /**\n"
+            + "   * aged > urgent > standard > debit.\n"
+            + "   */\n"
+            + "  private String bar;\n"
+            + "}\n";
+
+    String expected =
+        "public class Foo {\n"
+            + "  /**\n"
+            + "   * aged > urgent > standard > debit.\n"
+            + "   */\n"
+            + "  private String bar;\n"
+            + "}\n";
+
+    assertEquals(expected, PostProcessor.decodeHtmlEntities(input));
+  }
+}