Fix Javadoc errors and add CI validation

- Fix malformed HTML in GroupCreate.java and GroupRead.java by wrapping
  <resource_key:resource_instance_key> with {@code ...}
- Add javadoc.yaml workflow to validate Javadoc on PRs and master pushes
- Update publish.yaml to verify Javadoc before publishing

Fixes PER-13670

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: zeevmoney

.github/workflows/javadoc.yaml

@@ -0,0 +1,33 @@
+name: Javadoc Verification
+
+on:
+  pull_request:
+    branches: [master]
+  push:
+    branches: [master]
+
+jobs:
+  javadoc:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-java@v3.11.0
+        with:
+          java-version: '8'
+          distribution: 'corretto'
+      - name: Validate Gradle wrapper
+        uses: gradle/wrapper-validation-action@v1
+      - name: Generate Javadoc
+        uses: gradle/gradle-build-action@v2
+        with:
+          arguments: javadoc
+      - name: Check Javadoc generation
+        run: |
+          if [ -d "build/docs/javadoc" ]; then
+            echo "Javadoc generated successfully"
+            echo "Javadoc files:"
+            find build/docs/javadoc -name "*.html" | head -20
+          else
+            echo "ERROR: Javadoc directory not found"
+            exit 1
+          fi

.github/workflows/publish.yaml

@@ -1,15 +1,15 @@
 name: Publish package to GitHub Packages
 on:
   release:
-    types: [created]
+    types: [ created ]
   workflow_dispatch:
-  
+
 jobs:
   publish:
-    runs-on: ubuntu-latest 
-    permissions: 
+    runs-on: ubuntu-latest
+    permissions:
       contents: read
-      packages: write 
+      packages: write
     steps:
       - uses: actions/checkout@v2
       - uses: actions/setup-java@v3.11.0
@@ -18,6 +18,18 @@ jobs:
           distribution: 'corretto'
       - name: Validate Gradle wrapper
         uses: gradle/wrapper-validation-action@v1
+      - name: Verify Javadoc generation
+        uses: gradle/gradle-build-action@v2
+        with:
+          arguments: javadoc
+      - name: Check Javadoc generation
+        run: |
+          if [ -d "build/docs/javadoc" ]; then
+            echo "Javadoc verified successfully"
+          else
+            echo "ERROR: Javadoc directory not found"
+            exit 1
+          fi
       - name: Publish package
         uses: gradle/gradle-build-action@v2
         with:
@@ -29,4 +41,4 @@ jobs:
           GPG_SIGNING_KEY: ${{ secrets.GPG_SIGNING_KEY }}
           GPG_SIGNING_PASSPHRASE: ${{ secrets.GPG_SIGNING_PASSPHRASE }}
           NEXUS_TOKEN_USERNAME: ${{ secrets.NEXUS_TOKEN_USERNAME }}
-          NEXUS_TOKEN_PASSWORD: ${{ secrets.NEXUS_TOKEN_PASSWORD }}
+          NEXUS_TOKEN_PASSWORD: ${{ secrets.NEXUS_TOKEN_PASSWORD }}

src/main/java/io/permit/sdk/openapi/models/GroupCreate.java

@@ -39,7 +39,7 @@ public class GroupCreate {
     /**
      * Group Instance Key
      * <p>
-     * Either the unique id of the resource instance that that the group belongs to, or the URL-friendly key of the <resource_key:resource_instance_key> (i.e: file:my_file)
+     * Either the unique id of the resource instance that that the group belongs to, or the URL-friendly key of the {@code <resource_key:resource_instance_key>} (i.e: file:my_file)
      * (Required)
      *
      */

src/main/java/io/permit/sdk/openapi/models/GroupRead.java

@@ -59,7 +59,7 @@ public class GroupRead {
     /**
      * GroupInstanceKey
      * <p>
-     * Either the unique id of the resource instance that that the group belongs to, or the URL-friendly key of the <resource_key:resource_instance_key> (i.e: file:my_file)
+     * Either the unique id of the resource instance that that the group belongs to, or the URL-friendly key of the {@code <resource_key:resource_instance_key>} (i.e: file:my_file)
      * (Required)
      *
      */