From a1ec8a339ae0777585b959955d98f25e5d43064f Mon Sep 17 00:00:00 2001
From: kuntal1461 <kuntal.1461@gmail.com>
Date: Tue, 7 Oct 2025 23:44:02 +0530
Subject: [PATCH 1/3] By Kuntal : feat(bom) add Maven BOM module for
 swagger-core (#4966)

---
 README.md                   | 57 ++++++++++++++++++++++++++++
 modules/swagger-bom/pom.xml | 75 +++++++++++++++++++++++++++++++++++++
 pom.xml                     |  1 +
 3 files changed, 133 insertions(+)
 create mode 100644 modules/swagger-bom/pom.xml

diff --git a/README.md b/README.md
index 931b0363eb..867ed6e3da 100644
--- a/README.md
+++ b/README.md
@@ -156,6 +156,63 @@ Of course if you don't want to build locally you can grab artifacts from maven c
 
 `https://repo1.maven.org/maven2/io/swagger/core/`
 
+### Maven BOM
+
+To manage Swagger dependencies consistently across modules, import the Swagger Core BOM and omit versions on individual Swagger dependencies:
+
+```xml
+<dependencyManagement>
+  <dependencies>
+    <dependency>
+      <groupId>io.swagger.core.v3</groupId>
+      <artifactId>swagger-bom</artifactId>
+      <version>${swagger-openapiv3.version}</version>
+      <type>pom</type>
+      <scope>import</scope>
+    </dependency>
+  </dependencies>
+  
+</dependencyManagement>
+
+<!-- Then declare Swagger dependencies without versions -->
+<dependencies>
+  <dependency>
+    <groupId>io.swagger.core.v3</groupId>
+    <artifactId>swagger-annotations</artifactId>
+  </dependency>
+  <dependency>
+    <groupId>io.swagger.core.v3</groupId>
+    <artifactId>swagger-models</artifactId>
+  </dependency>
+  <dependency>
+    <groupId>io.swagger.core.v3</groupId>
+    <artifactId>swagger-core</artifactId>
+  </dependency>
+  <dependency>
+    <groupId>io.swagger.core.v3</groupId>
+    <artifactId>swagger-integration</artifactId>
+  </dependency>
+  <dependency>
+    <groupId>io.swagger.core.v3</groupId>
+    <artifactId>swagger-jaxrs2</artifactId>
+  </dependency>
+  <!-- Optional servlet initializer helpers -->
+  <dependency>
+    <groupId>io.swagger.core.v3</groupId>
+    <artifactId>swagger-jaxrs2-servlet-initializer</artifactId>
+  </dependency>
+  <dependency>
+    <groupId>io.swagger.core.v3</groupId>
+    <artifactId>swagger-jaxrs2-servlet-initializer-v2</artifactId>
+  </dependency>
+  <!-- Optional support for Java 17 module-path consumers -->
+  <dependency>
+    <groupId>io.swagger.core.v3</groupId>
+    <artifactId>swagger-java17-support</artifactId>
+  </dependency>
+</dependencies>
+```
+
 ## Sample Apps
 The samples have moved to [a new repository](https://github.com/swagger-api/swagger-samples/tree/2.0) and contain various integrations and configurations.
 
diff --git a/modules/swagger-bom/pom.xml b/modules/swagger-bom/pom.xml
new file mode 100644
index 0000000000..7b15d3d99b
--- /dev/null
+++ b/modules/swagger-bom/pom.xml
@@ -0,0 +1,75 @@
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>io.swagger.core.v3</groupId>
+    <artifactId>swagger-bom</artifactId>
+    <version>2.2.38-SNAPSHOT</version>
+    <packaging>pom</packaging>
+
+    <name>swagger-bom</name>
+    <description>Bill of Materials (BOM) for Swagger Core (OpenAPI 3)</description>
+    <url>https://github.com/swagger-api/swagger-core</url>
+
+    <scm>
+        <connection>scm:git:git@github.com:swagger-api/swagger-core.git</connection>
+        <developerConnection>scm:git:git@github.com:swagger-api/swagger-core.git</developerConnection>
+        <url>https://github.com/swagger-api/swagger-core</url>
+    </scm>
+
+    <licenses>
+        <license>
+            <name>Apache License 2.0</name>
+            <url>http://www.apache.org/licenses/LICENSE-2.0.html</url>
+            <distribution>repo</distribution>
+        </license>
+    </licenses>
+
+    <dependencyManagement>
+        <dependencies>
+            <!-- Core Swagger (OpenAPI 3) libraries -->
+            <dependency>
+                <groupId>io.swagger.core.v3</groupId>
+                <artifactId>swagger-annotations</artifactId>
+                <version>${project.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>io.swagger.core.v3</groupId>
+                <artifactId>swagger-models</artifactId>
+                <version>${project.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>io.swagger.core.v3</groupId>
+                <artifactId>swagger-core</artifactId>
+                <version>${project.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>io.swagger.core.v3</groupId>
+                <artifactId>swagger-integration</artifactId>
+                <version>${project.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>io.swagger.core.v3</groupId>
+                <artifactId>swagger-jaxrs2</artifactId>
+                <version>${project.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>io.swagger.core.v3</groupId>
+                <artifactId>swagger-jaxrs2-servlet-initializer</artifactId>
+                <version>${project.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>io.swagger.core.v3</groupId>
+                <artifactId>swagger-jaxrs2-servlet-initializer-v2</artifactId>
+                <version>${project.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>io.swagger.core.v3</groupId>
+                <artifactId>swagger-java17-support</artifactId>
+                <version>${project.version}</version>
+            </dependency>
+        </dependencies>
+    </dependencyManagement>
+
+</project>
+
diff --git a/pom.xml b/pom.xml
index cc2a194647..dff31d7196 100644
--- a/pom.xml
+++ b/pom.xml
@@ -401,6 +401,7 @@
         <module>modules/swagger-jaxrs2</module>
         <module>modules/swagger-jaxrs2-servlet-initializer</module>
         <module>modules/swagger-jaxrs2-servlet-initializer-v2</module>
+        <module>modules/swagger-bom</module>
         <module>modules/swagger-maven-plugin</module>
         <module>modules/swagger-eclipse-transformer-maven-plugin</module>
         <module>modules/swagger-project-jakarta</module>

From cae1222f8a5d15b16303c06585d8613a7d54409f Mon Sep 17 00:00:00 2001
From: Ewa Ostrowska <ewa.ostrowska@smartbear.com>
Date: Wed, 8 Apr 2026 11:29:22 +0200
Subject: [PATCH 2/3] add jakarta artifacts and CI drift-guard

---
 .github/workflows/maven-pulls.yml | 10 +++++
 .github/workflows/maven.yml       | 10 +++++
 CHANGELOG.md                      | 18 ++++++++
 CI/post-release.sh                |  5 +++
 CI/prepare-release.sh             |  5 +++
 README.md                         | 62 ++++++++++++++++++++++++---
 modules/swagger-bom/pom.xml       | 70 ++++++++++++++++++++++++++++++-
 7 files changed, 174 insertions(+), 6 deletions(-)
 create mode 100644 CHANGELOG.md

diff --git a/.github/workflows/maven-pulls.yml b/.github/workflows/maven-pulls.yml
index 17523a0923..44b8d0f4f0 100644
--- a/.github/workflows/maven-pulls.yml
+++ b/.github/workflows/maven-pulls.yml
@@ -29,6 +29,16 @@ jobs:
         key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
         restore-keys: |
           ${{ runner.os }}-maven-
+    - name: Check swagger-bom version matches root version
+      run: |
+        ROOT_VERSION=$(./mvnw -q -Dexec.executable="echo" -Dexec.args='${project.version}' --non-recursive org.codehaus.mojo:exec-maven-plugin:1.3.1:exec)
+        BOM_VERSION=$(./mvnw -q -Dexec.executable="echo" -Dexec.args='${project.version}' --non-recursive org.codehaus.mojo:exec-maven-plugin:1.3.1:exec --file modules/swagger-bom/pom.xml)
+        echo "Root version: ${ROOT_VERSION}"
+        echo "BOM version:  ${BOM_VERSION}"
+        if [ "${ROOT_VERSION}" != "${BOM_VERSION}" ]; then
+          echo "ERROR: swagger-bom version (${BOM_VERSION}) does not match root version (${ROOT_VERSION}). Update modules/swagger-bom/pom.xml."
+          exit 1
+        fi
     - name: Build with Maven and Gradle
       run: |
         ./mvnw --no-transfer-progress -B install --file pom.xml
diff --git a/.github/workflows/maven.yml b/.github/workflows/maven.yml
index 1ac4203cb9..583f1dd29c 100644
--- a/.github/workflows/maven.yml
+++ b/.github/workflows/maven.yml
@@ -29,6 +29,16 @@ jobs:
         key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
         restore-keys: |
           ${{ runner.os }}-maven-
+    - name: Check swagger-bom version matches root version
+      run: |
+        ROOT_VERSION=$(./mvnw -q -Dexec.executable="echo" -Dexec.args='${project.version}' --non-recursive org.codehaus.mojo:exec-maven-plugin:1.3.1:exec)
+        BOM_VERSION=$(./mvnw -q -Dexec.executable="echo" -Dexec.args='${project.version}' --non-recursive org.codehaus.mojo:exec-maven-plugin:1.3.1:exec --file modules/swagger-bom/pom.xml)
+        echo "Root version: ${ROOT_VERSION}"
+        echo "BOM version:  ${BOM_VERSION}"
+        if [ "${ROOT_VERSION}" != "${BOM_VERSION}" ]; then
+          echo "ERROR: swagger-bom version (${BOM_VERSION}) does not match root version (${ROOT_VERSION}). Update modules/swagger-bom/pom.xml."
+          exit 1
+        fi
     - name: Build with Maven and Gradle, Deploy snapshot to maven central
       run: |
         export MY_POM_VERSION=`./mvnw -q -Dexec.executable="echo" -Dexec.args='${projects.version}' --non-recursive org.codehaus.mojo:exec-maven-plugin:1.3.1:exec`
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000000..3d953f0b48
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,18 @@
+# Changelog
+
+## 2.2.47-SNAPSHOT
+
+### New Features
+
+- **`swagger-bom`**: Added Maven Bill of Materials (BOM) module (`io.swagger.core.v3:swagger-bom`).
+  The BOM manages **both** the `javax` artifact family and the Jakarta (`-jakarta` suffix) artifact family
+  in a single import. Consumers can import the BOM once and omit explicit versions on all
+  `io.swagger.core.v3` runtime dependencies.
+  Covered artifacts: `swagger-annotations`, `swagger-models`, `swagger-core`, `swagger-integration`,
+  `swagger-jaxrs2`, `swagger-jaxrs2-servlet-initializer`, `swagger-jaxrs2-servlet-initializer-v2`,
+  `swagger-java17-support`, and their `-jakarta` counterparts.
+  Build plugins are intentionally excluded from the BOM.
+
+---
+
+For earlier releases see the [GitHub Releases page](https://github.com/swagger-api/swagger-core/releases).
diff --git a/CI/post-release.sh b/CI/post-release.sh
index 7e95b3c2b7..fae521299e 100755
--- a/CI/post-release.sh
+++ b/CI/post-release.sh
@@ -23,6 +23,11 @@ python $CUR/CI/publishRelease.py "$SC_RELEASE_TAG"
 ./mvnw versions:set -DnewVersion="${SC_NEXT_VERSION}-SNAPSHOT"
 ./mvnw versions:commit
 
+cd modules/swagger-bom
+../../mvnw versions:set -DnewVersion="${SC_NEXT_VERSION}-SNAPSHOT"
+../../mvnw versions:commit
+cd ../..
+
 cd modules/swagger-project-jakarta
 ../../mvnw versions:set -DnewVersion="${SC_NEXT_VERSION}-SNAPSHOT"
 ../../mvnw versions:commit
diff --git a/CI/prepare-release.sh b/CI/prepare-release.sh
index 771451ccf6..878cf34606 100755
--- a/CI/prepare-release.sh
+++ b/CI/prepare-release.sh
@@ -25,6 +25,11 @@ python $CUR/CI/releaseNotes.py "$SC_LAST_RELEASE" "$SC_RELEASE_TITLE" "$SC_RELEA
 ./mvnw versions:set -DnewVersion=$SC_VERSION
 ./mvnw versions:commit
 
+cd modules/swagger-bom
+../../mvnw versions:set -DnewVersion=$SC_VERSION
+../../mvnw versions:commit
+cd ../..
+
 cd modules/swagger-project-jakarta
 ../../mvnw versions:set -DnewVersion=$SC_VERSION
 ../../mvnw versions:commit
diff --git a/README.md b/README.md
index 867ed6e3da..1400dc77f7 100644
--- a/README.md
+++ b/README.md
@@ -158,7 +158,16 @@ Of course if you don't want to build locally you can grab artifacts from maven c
 
 ### Maven BOM
 
-To manage Swagger dependencies consistently across modules, import the Swagger Core BOM and omit versions on individual Swagger dependencies:
+The `swagger-bom` artifact is a Bill of Materials that manages **both** the `javax` and Jakarta (`-jakarta` suffix) artifact families.
+Import it once and omit versions on all individual Swagger dependencies.
+
+> **Note:** Maven and Gradle build plugins (`swagger-maven-plugin`, `swagger-gradle-plugin`,
+> `swagger-eclipse-transformer-maven-plugin`) are intentionally **excluded** from the BOM.
+> Plugins are applied via `<build><plugins>` or `plugins {}`, not via `<dependencyManagement>`,
+> so including them in the BOM would be misleading and could conflict with the plugin
+> management section of a consumer's build.
+
+#### Maven
 
 ```xml
 <dependencyManagement>
@@ -171,11 +180,11 @@ To manage Swagger dependencies consistently across modules, import the Swagger C
       <scope>import</scope>
     </dependency>
   </dependencies>
-  
 </dependencyManagement>
 
-<!-- Then declare Swagger dependencies without versions -->
+<!-- Then declare Swagger dependencies without explicit versions -->
 <dependencies>
+  <!-- javax artifacts -->
   <dependency>
     <groupId>io.swagger.core.v3</groupId>
     <artifactId>swagger-annotations</artifactId>
@@ -196,7 +205,6 @@ To manage Swagger dependencies consistently across modules, import the Swagger C
     <groupId>io.swagger.core.v3</groupId>
     <artifactId>swagger-jaxrs2</artifactId>
   </dependency>
-  <!-- Optional servlet initializer helpers -->
   <dependency>
     <groupId>io.swagger.core.v3</groupId>
     <artifactId>swagger-jaxrs2-servlet-initializer</artifactId>
@@ -205,14 +213,58 @@ To manage Swagger dependencies consistently across modules, import the Swagger C
     <groupId>io.swagger.core.v3</groupId>
     <artifactId>swagger-jaxrs2-servlet-initializer-v2</artifactId>
   </dependency>
-  <!-- Optional support for Java 17 module-path consumers -->
   <dependency>
     <groupId>io.swagger.core.v3</groupId>
     <artifactId>swagger-java17-support</artifactId>
   </dependency>
+  <!-- Jakarta namespace artifacts (use instead of, or alongside, the javax ones above) -->
+  <dependency>
+    <groupId>io.swagger.core.v3</groupId>
+    <artifactId>swagger-annotations-jakarta</artifactId>
+  </dependency>
+  <dependency>
+    <groupId>io.swagger.core.v3</groupId>
+    <artifactId>swagger-models-jakarta</artifactId>
+  </dependency>
+  <dependency>
+    <groupId>io.swagger.core.v3</groupId>
+    <artifactId>swagger-core-jakarta</artifactId>
+  </dependency>
+  <dependency>
+    <groupId>io.swagger.core.v3</groupId>
+    <artifactId>swagger-integration-jakarta</artifactId>
+  </dependency>
+  <dependency>
+    <groupId>io.swagger.core.v3</groupId>
+    <artifactId>swagger-jaxrs2-jakarta</artifactId>
+  </dependency>
+  <dependency>
+    <groupId>io.swagger.core.v3</groupId>
+    <artifactId>swagger-jaxrs2-servlet-initializer-jakarta</artifactId>
+  </dependency>
+  <dependency>
+    <groupId>io.swagger.core.v3</groupId>
+    <artifactId>swagger-jaxrs2-servlet-initializer-v2-jakarta</artifactId>
+  </dependency>
 </dependencies>
 ```
 
+#### Gradle
+
+```kotlin
+dependencies {
+    implementation(platform("io.swagger.core.v3:swagger-bom:${swaggerOpenapiv3Version}"))
+
+    // javax artifacts — no version needed
+    implementation("io.swagger.core.v3:swagger-annotations")
+    implementation("io.swagger.core.v3:swagger-core")
+
+    // Jakarta namespace artifacts — no version needed
+    implementation("io.swagger.core.v3:swagger-annotations-jakarta")
+    implementation("io.swagger.core.v3:swagger-core-jakarta")
+}
+```
+
 ## Sample Apps
 The samples have moved to [a new repository](https://github.com/swagger-api/swagger-samples/tree/2.0) and contain various integrations and configurations.
 
diff --git a/modules/swagger-bom/pom.xml b/modules/swagger-bom/pom.xml
index 7b15d3d99b..1046fe615a 100644
--- a/modules/swagger-bom/pom.xml
+++ b/modules/swagger-bom/pom.xml
@@ -4,7 +4,7 @@
 
     <groupId>io.swagger.core.v3</groupId>
     <artifactId>swagger-bom</artifactId>
-    <version>2.2.38-SNAPSHOT</version>
+    <version>2.2.47-SNAPSHOT</version>
     <packaging>pom</packaging>
 
     <name>swagger-bom</name>
@@ -25,6 +25,38 @@
         </license>
     </licenses>
 
+    <developers>
+        <developer>
+            <id>daniel-kmiecik</id>
+            <name>Daniel Kmiecik</name>
+        </developer>
+        <developer>
+            <id>djankowsk</id>
+            <name>Damian Jankowski</name>
+        </developer>
+        <developer>
+            <id>ewaostrowska</id>
+            <name>Ewa Ostrowska</name>
+        </developer>
+    </developers>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.sonatype.central</groupId>
+                <artifactId>central-publishing-maven-plugin</artifactId>
+                <version>0.7.0</version>
+                <extensions>true</extensions>
+                <configuration>
+                    <publishingServerId>central</publishingServerId>
+                    <autoPublish>true</autoPublish>
+                    <waitUntil>published</waitUntil>
+                    <waitMaxTime>3600</waitMaxTime>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+
     <dependencyManagement>
         <dependencies>
             <!-- Core Swagger (OpenAPI 3) libraries -->
@@ -68,6 +100,42 @@
                 <artifactId>swagger-java17-support</artifactId>
                 <version>${project.version}</version>
             </dependency>
+            <!-- Jakarta namespace artifacts -->
+            <dependency>
+                <groupId>io.swagger.core.v3</groupId>
+                <artifactId>swagger-annotations-jakarta</artifactId>
+                <version>${project.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>io.swagger.core.v3</groupId>
+                <artifactId>swagger-models-jakarta</artifactId>
+                <version>${project.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>io.swagger.core.v3</groupId>
+                <artifactId>swagger-core-jakarta</artifactId>
+                <version>${project.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>io.swagger.core.v3</groupId>
+                <artifactId>swagger-integration-jakarta</artifactId>
+                <version>${project.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>io.swagger.core.v3</groupId>
+                <artifactId>swagger-jaxrs2-jakarta</artifactId>
+                <version>${project.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>io.swagger.core.v3</groupId>
+                <artifactId>swagger-jaxrs2-servlet-initializer-jakarta</artifactId>
+                <version>${project.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>io.swagger.core.v3</groupId>
+                <artifactId>swagger-jaxrs2-servlet-initializer-v2-jakarta</artifactId>
+                <version>${project.version}</version>
+            </dependency>
         </dependencies>
     </dependencyManagement>
 

From 4c82d4b857d9fb84f42b1421ba2117c749848ff1 Mon Sep 17 00:00:00 2001
From: Ewa Ostrowska <ewa.ostrowska@smartbear.com>
Date: Wed, 8 Apr 2026 12:32:58 +0200
Subject: [PATCH 3/3] add integration test module and enforcer plugin

---
 .github/workflows/prepare-release.yml        |  10 ++
 .github/workflows/release.yml                |  10 ++
 CHANGELOG.md                                 |  18 ---
 README.md                                    |   4 -
 modules/swagger-bom-integration-test/pom.xml | 141 +++++++++++++++++++
 modules/swagger-bom/pom.xml                  |  40 +++++-
 pom.xml                                      |   1 +
 7 files changed, 197 insertions(+), 27 deletions(-)
 delete mode 100644 CHANGELOG.md
 create mode 100644 modules/swagger-bom-integration-test/pom.xml

diff --git a/.github/workflows/prepare-release.yml b/.github/workflows/prepare-release.yml
index 197485c3f3..758de11eee 100644
--- a/.github/workflows/prepare-release.yml
+++ b/.github/workflows/prepare-release.yml
@@ -35,6 +35,16 @@ jobs:
         key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
         restore-keys: |
           ${{ runner.os }}-maven-
+    - name: Check swagger-bom version matches root version
+      run: |
+        ROOT_VERSION=$(./mvnw -q -Dexec.executable="echo" -Dexec.args='${project.version}' --non-recursive org.codehaus.mojo:exec-maven-plugin:1.3.1:exec)
+        BOM_VERSION=$(./mvnw -q -Dexec.executable="echo" -Dexec.args='${project.version}' --non-recursive org.codehaus.mojo:exec-maven-plugin:1.3.1:exec --file modules/swagger-bom/pom.xml)
+        echo "Root version: ${ROOT_VERSION}"
+        echo "BOM version:  ${BOM_VERSION}"
+        if [ "${ROOT_VERSION}" != "${BOM_VERSION}" ]; then
+          echo "ERROR: swagger-bom version (${BOM_VERSION}) does not match root version (${ROOT_VERSION}). Update modules/swagger-bom/pom.xml."
+          exit 1
+        fi
     - name: Run prepare release script
       id: prepare-release
       run: |
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 6599a14554..ad815fd49e 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -40,6 +40,16 @@ jobs:
       run: |
         mkdir -p ~/.gradle
         echo "gradle.publish.key=${GRADLE_PUBLISH_KEY}\ngradle.publish.secret=${GRADLE_PUBLISH_SECRET}" > ~/.gradle/gradle.properties
+    - name: Check swagger-bom version matches root version
+      run: |
+        ROOT_VERSION=$(./mvnw -q -Dexec.executable="echo" -Dexec.args='${project.version}' --non-recursive org.codehaus.mojo:exec-maven-plugin:1.3.1:exec)
+        BOM_VERSION=$(./mvnw -q -Dexec.executable="echo" -Dexec.args='${project.version}' --non-recursive org.codehaus.mojo:exec-maven-plugin:1.3.1:exec --file modules/swagger-bom/pom.xml)
+        echo "Root version: ${ROOT_VERSION}"
+        echo "BOM version:  ${BOM_VERSION}"
+        if [ "${ROOT_VERSION}" != "${BOM_VERSION}" ]; then
+          echo "ERROR: swagger-bom version (${BOM_VERSION}) does not match root version (${ROOT_VERSION}). Update modules/swagger-bom/pom.xml."
+          exit 1
+        fi
     - name: Run pre release script
       id: preRelease
       run: |
diff --git a/CHANGELOG.md b/CHANGELOG.md
deleted file mode 100644
index 3d953f0b48..0000000000
--- a/CHANGELOG.md
+++ /dev/null
@@ -1,18 +0,0 @@
-# Changelog
-
-## 2.2.47-SNAPSHOT
-
-### New Features
-
-- **`swagger-bom`**: Added Maven Bill of Materials (BOM) module (`io.swagger.core.v3:swagger-bom`).
-  The BOM manages **both** the `javax` artifact family and the Jakarta (`-jakarta` suffix) artifact family
-  in a single import. Consumers can import the BOM once and omit explicit versions on all
-  `io.swagger.core.v3` runtime dependencies.
-  Covered artifacts: `swagger-annotations`, `swagger-models`, `swagger-core`, `swagger-integration`,
-  `swagger-jaxrs2`, `swagger-jaxrs2-servlet-initializer`, `swagger-jaxrs2-servlet-initializer-v2`,
-  `swagger-java17-support`, and their `-jakarta` counterparts.
-  Build plugins are intentionally excluded from the BOM.
-
----
-
-For earlier releases see the [GitHub Releases page](https://github.com/swagger-api/swagger-core/releases).
diff --git a/README.md b/README.md
index 1400dc77f7..207164474b 100644
--- a/README.md
+++ b/README.md
@@ -213,10 +213,6 @@ Import it once and omit versions on all individual Swagger dependencies.
     <groupId>io.swagger.core.v3</groupId>
     <artifactId>swagger-jaxrs2-servlet-initializer-v2</artifactId>
   </dependency>
-  <dependency>
-    <groupId>io.swagger.core.v3</groupId>
-    <artifactId>swagger-java17-support</artifactId>
-  </dependency>
   <!-- Jakarta namespace artifacts (use instead of, or alongside, the javax ones above) -->
   <dependency>
     <groupId>io.swagger.core.v3</groupId>
diff --git a/modules/swagger-bom-integration-test/pom.xml b/modules/swagger-bom-integration-test/pom.xml
new file mode 100644
index 0000000000..49730678af
--- /dev/null
+++ b/modules/swagger-bom-integration-test/pom.xml
@@ -0,0 +1,141 @@
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <parent>
+        <groupId>io.swagger.core.v3</groupId>
+        <artifactId>swagger-project</artifactId>
+        <version>2.2.47-SNAPSHOT</version>
+        <relativePath>../..</relativePath>
+    </parent>
+
+    <artifactId>swagger-bom-integration-test</artifactId>
+    <packaging>pom</packaging>
+
+    <name>swagger-bom-integration-test</name>
+    <description>Verifies that swagger-bom manages all expected artifacts at the correct version</description>
+
+    <!-- Not a publishable artifact -->
+    <properties>
+        <maven.deploy.skip>true</maven.deploy.skip>
+        <maven.install.skip>true</maven.install.skip>
+    </properties>
+
+    <dependencyManagement>
+        <dependencies>
+            <dependency>
+                <groupId>io.swagger.core.v3</groupId>
+                <artifactId>swagger-bom</artifactId>
+                <version>${project.version}</version>
+                <type>pom</type>
+                <scope>import</scope>
+            </dependency>
+        </dependencies>
+    </dependencyManagement>
+
+    <!--
+        Declare every artifact the BOM is expected to manage, without explicit versions.
+        Maven will fail if the BOM does not provide a version for any of these entries.
+    -->
+    <dependencies>
+        <!-- javax artifact family -->
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
+            <artifactId>swagger-annotations</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
+            <artifactId>swagger-models</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
+            <artifactId>swagger-core</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
+            <artifactId>swagger-integration</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
+            <artifactId>swagger-jaxrs2</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
+            <artifactId>swagger-jaxrs2-servlet-initializer</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
+            <artifactId>swagger-jaxrs2-servlet-initializer-v2</artifactId>
+        </dependency>
+        <!-- Jakarta namespace artifact family -->
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
+            <artifactId>swagger-annotations-jakarta</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
+            <artifactId>swagger-models-jakarta</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
+            <artifactId>swagger-core-jakarta</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
+            <artifactId>swagger-integration-jakarta</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
+            <artifactId>swagger-jaxrs2-jakarta</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
+            <artifactId>swagger-jaxrs2-servlet-initializer-jakarta</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
+            <artifactId>swagger-jaxrs2-servlet-initializer-v2-jakarta</artifactId>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <!--
+                Explicitly resolve all declared dependencies so that the build fails
+                fast if any managed artifact cannot be downloaded or is missing
+                from the local repository after a full reactor install.
+            -->
+            <!-- Disable the DependencyConvergence rule inherited from the root parent.
+                 Transitive deps of mixed javax/Jakarta artifacts intentionally diverge. -->
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-enforcer-plugin</artifactId>
+                <executions>
+                    <execution>
+                        <id>enforce-versions</id>
+                        <configuration>
+                            <skip>true</skip>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-dependency-plugin</artifactId>
+                <executions>
+                    <execution>
+                        <id>verify-bom-deps-resolve</id>
+                        <phase>validate</phase>
+                        <goals>
+                            <goal>resolve</goal>
+                        </goals>
+                        <configuration>
+                            <includeGroupIds>io.swagger.core.v3</includeGroupIds>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+
+</project>
diff --git a/modules/swagger-bom/pom.xml b/modules/swagger-bom/pom.xml
index 1046fe615a..242473a147 100644
--- a/modules/swagger-bom/pom.xml
+++ b/modules/swagger-bom/pom.xml
@@ -40,6 +40,11 @@
         </developer>
     </developers>
 
+    <issueManagement>
+        <system>github</system>
+        <url>https://github.com/swagger-api/swagger-core/issues</url>
+    </issueManagement>
+
     <build>
         <plugins>
             <plugin>
@@ -57,6 +62,36 @@
         </plugins>
     </build>
 
+    <profiles>
+        <profile>
+            <id>release</id>
+            <build>
+                <plugins>
+                    <plugin>
+                        <groupId>org.apache.maven.plugins</groupId>
+                        <artifactId>maven-gpg-plugin</artifactId>
+                        <version>1.6</version>
+                        <configuration>
+                            <gpgArguments>
+                                <arg>--pinentry-mode</arg>
+                                <arg>loopback</arg>
+                            </gpgArguments>
+                        </configuration>
+                        <executions>
+                            <execution>
+                                <id>sign-artifacts</id>
+                                <phase>verify</phase>
+                                <goals>
+                                    <goal>sign</goal>
+                                </goals>
+                            </execution>
+                        </executions>
+                    </plugin>
+                </plugins>
+            </build>
+        </profile>
+    </profiles>
+
     <dependencyManagement>
         <dependencies>
             <!-- Core Swagger (OpenAPI 3) libraries -->
@@ -95,11 +130,6 @@
                 <artifactId>swagger-jaxrs2-servlet-initializer-v2</artifactId>
                 <version>${project.version}</version>
             </dependency>
-            <dependency>
-                <groupId>io.swagger.core.v3</groupId>
-                <artifactId>swagger-java17-support</artifactId>
-                <version>${project.version}</version>
-            </dependency>
             <!-- Jakarta namespace artifacts -->
             <dependency>
                 <groupId>io.swagger.core.v3</groupId>
diff --git a/pom.xml b/pom.xml
index dff31d7196..df82cd7eef 100644
--- a/pom.xml
+++ b/pom.xml
@@ -405,6 +405,7 @@
         <module>modules/swagger-maven-plugin</module>
         <module>modules/swagger-eclipse-transformer-maven-plugin</module>
         <module>modules/swagger-project-jakarta</module>
+        <module>modules/swagger-bom-integration-test</module>
 
     </modules>
     <reporting>