diff --git a/.github/workflows/publish-java.yml b/.github/workflows/publish-java.yml
index 7a46aec7..c853abf9 100644
--- a/.github/workflows/publish-java.yml
+++ b/.github/workflows/publish-java.yml
@@ -169,9 +169,15 @@ jobs:
         env:
           GH_TOKEN: ${{ github.token }}
         run: |
-          git tag "java-v${VERSION}"
-          git -c http.https://github.com/.extraheader="AUTHORIZATION: bearer ${GH_TOKEN}" \
-            push origin "java-v${VERSION}"
+          # Idempotent: a re-publish (e.g. after fixing the keyserver) reuses the
+          # same version, so skip if the tag is already on the remote.
+          if git ls-remote --exit-code --tags origin "java-v${VERSION}" >/dev/null 2>&1; then
+            echo "::notice::Tag java-v${VERSION} already exists — skipping"
+          else
+            git tag "java-v${VERSION}"
+            git -c http.https://github.com/.extraheader="AUTHORIZATION: bearer ${GH_TOKEN}" \
+              push origin "java-v${VERSION}"
+          fi
 
       - name: Create GitHub release
         if: ${{ !inputs.dry-run }}
diff --git a/sdks/java/src/main/java/org/byteveda/taskito/model/JobFilter.java b/sdks/java/src/main/java/org/byteveda/taskito/model/JobFilter.java
index 7dcb1827..aadf55de 100644
--- a/sdks/java/src/main/java/org/byteveda/taskito/model/JobFilter.java
+++ b/sdks/java/src/main/java/org/byteveda/taskito/model/JobFilter.java
@@ -3,7 +3,7 @@
 import com.fasterxml.jackson.annotation.JsonInclude;
 import com.fasterxml.jackson.annotation.JsonProperty;
 
-/** Immutable filter for {@link Queue#listJobs(JobFilter)}. Unset fields are ignored. */
+/** Immutable filter for {@link org.byteveda.taskito.Queue#listJobs(JobFilter)}. Unset fields are ignored. */
 @JsonInclude(JsonInclude.Include.NON_NULL)
 public final class JobFilter {
     @JsonProperty("status")
diff --git a/sdks/java/src/main/java/org/byteveda/taskito/worker/Worker.java b/sdks/java/src/main/java/org/byteveda/taskito/worker/Worker.java
index 4dae12ab..821bb55b 100644
--- a/sdks/java/src/main/java/org/byteveda/taskito/worker/Worker.java
+++ b/sdks/java/src/main/java/org/byteveda/taskito/worker/Worker.java
@@ -27,7 +27,7 @@
 import org.byteveda.taskito.workflows.WorkflowTracker;
 
 /**
- * A running worker. Build one with {@link Queue#worker()}, register handlers,
+ * A running worker. Build one with {@link org.byteveda.taskito.Queue#worker()}, register handlers,
  * then {@link Builder#start()}. {@link #close()} stops it and drains in-flight
  * jobs.
  */