From 2264229055a0f6a3a255ef71e25fc06a38c8ce62 Mon Sep 17 00:00:00 2001
From: Sam Barker <sam@quadrocket.co.uk>
Date: Tue, 1 Sep 2026 13:22:27 +1200
Subject: [PATCH] Failing test for #8731

ChangePackage does not rewrite {@link} type references in Javadoc
attached to a package declaration in package-info.java, even though
the same Javadoc on a class works correctly.

Fixes #8731

Assisted-by: Claude Sonnet 5 <noreply@anthropic.com>
Signed-off-by: Sam Barker <sam@quadrocket.co.uk>
---
 .../openrewrite/java/ChangePackageTest.java   | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/rewrite-java-test/src/test/java/org/openrewrite/java/ChangePackageTest.java b/rewrite-java-test/src/test/java/org/openrewrite/java/ChangePackageTest.java
index 47b5eac94ba..0bab28d74c0 100644
--- a/rewrite-java-test/src/test/java/org/openrewrite/java/ChangePackageTest.java
+++ b/rewrite-java-test/src/test/java/org/openrewrite/java/ChangePackageTest.java
@@ -2256,6 +2256,28 @@ public class Ref {}
         );
     }
 
+    @Issue("https://github.com/openrewrite/rewrite/issues/8731")
+    @Test
+    void javadocLinkOnPackageInfoUpdated() {
+        rewriteRun(
+          spec -> spec.recipe(new ChangePackage("org.openrewrite", "org.openrewrite.test", true)),
+          java(
+            """
+              /**
+               * See {@link org.openrewrite.Existing}
+               */
+              package com.example;
+              """,
+            """
+              /**
+               * See {@link org.openrewrite.test.Existing}
+               */
+              package com.example;
+              """
+          )
+        );
+    }
+
     @Test
     @Issue("https://github.com/openrewrite/rewrite/issues/2482")
     void changePackageInServiceProviderFile() {