From b16957a482cc68bdcc9507253da1004ecc5161dd Mon Sep 17 00:00:00 2001
From: Christopher Dilks <c-dilks@users.noreply.github.com>
Date: Mon, 12 Oct 2026 15:39:15 -0400
Subject: [PATCH 1/2] build: consume `ccdbrcdb` from `code.jlab.org`

---
 pom.xml | 38 ++++++++++++++++++++++----------------
 1 file changed, 22 insertions(+), 16 deletions(-)

diff --git a/pom.xml b/pom.xml
index 277553f7fb..d8a5674a74 100644
--- a/pom.xml
+++ b/pom.xml
@@ -19,31 +19,31 @@
   </modules>
 
   <repositories>
-    <!-- code.jlab.org package registries -->
+    <!-- jnp-hipo4 ::: https://code.jlab.org/hallb/clas12/hipo-java -->
     <repository>
-      <!-- git repo:  https://code.jlab.org/hallb/clas12/hipo-java -->
-      <!-- artifacts: jnp-hipo4 -->
       <id>code.jlab.org-hipo-java</id>
       <url>https://code.jlab.org/api/v4/projects/919/packages/maven</url>
     </repository>
+    <!-- xmsg ::: https://code.jlab.org/hallb/clas12/coatjava/xmsg-java -->
     <repository>
-      <!-- git repo:  https://code.jlab.org/hallb/clas12/coatjava/xmsg-java -->
-      <!-- artifacts: xmsg -->
       <id>code.jlab.org-xmsg-java</id>
       <url>https://code.jlab.org/api/v4/projects/959/packages/maven</url>
     </repository>
+    <!-- jclara ::: https://code.jlab.org/hallb/clas12/coatjava/clara-java -->
     <repository>
-      <!-- git repo:  https://code.jlab.org/hallb/clas12/coatjava/clara-java -->
-      <!-- artifacts: jclara -->
       <id>code.jlab.org-clara-java</id>
       <url>https://code.jlab.org/api/v4/projects/243/packages/maven</url>
     </repository>
+    <!-- freehep-jminuit ::: https://code.jlab.org/hallb/clas12/jminuit-maven-mirror -->
     <repository>
-      <!-- git repo:  https://code.jlab.org/hallb/clas12/jminuit-maven-mirror -->
-      <!-- artifacts: freehep-jminuit -->
       <id>code.jlab.org-freehep-jminuit</id>
       <url>https://code.jlab.org/api/v4/projects/1079/packages/maven</url>
     </repository>
+    <!-- ccdbrcdb ::: https://code.jlab.org/hallb/clas12/coatjava/ccdbrcdb-java -->
+    <repository>
+      <id>code.jlab.org-ccdbrcdb-java</id>
+      <url>https://code.jlab.org/api/v4/projects/245/packages/maven</url>
+    </repository>
     <!-- clasweb repositories -->
     <repository>
       <id>clasweb-clas12maven</id>
@@ -216,7 +216,18 @@
       <dependency>
         <groupId>org.jlab.ccdbrcdb</groupId>
         <artifactId>ccdbrcdb</artifactId>
-        <version>2.0</version>
+        <version>2.1</version>
+        <exclusions>
+          <exclusion>
+            <!--
+              protobuf is transitive via `mysql-connector-j` and is only needed for
+              the X DevAPI (MySQL X Protocol); it also conflicts with the version
+              used by `xmsg`, so we exclude it here
+            -->
+            <groupId>com.google.protobuf</groupId>
+            <artifactId>protobuf-java</artifactId>
+          </exclusion>
+        </exclusions>
       </dependency>
 
       <dependency>
@@ -425,12 +436,7 @@
             </goals>
             <configuration>
               <rules>
-                <dependencyConvergence>
-                  <excludes>
-                    <!-- excluding conflicts that may be tricky to resolve -->
-                    <exclude>com.google.protobuf:protobuf-java</exclude> <!-- `org.jlab.ccdbrcdb:ccdbrcdb` use v3, but `org.jlab.coda.xmsg` uses v2 -->
-                  </excludes>
-                </dependencyConvergence>
+                <dependencyConvergence/>
               </rules>
             </configuration>
           </execution>

From 0bda44f2ff1f62b7778aad700f4eb0a78dad6735 Mon Sep 17 00:00:00 2001
From: Christopher Dilks <c-dilks@users.noreply.github.com>
Date: Mon, 12 Oct 2026 15:42:03 -0400
Subject: [PATCH 2/2] doc: clarify

---
 pom.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pom.xml b/pom.xml
index d8a5674a74..9609367f92 100644
--- a/pom.xml
+++ b/pom.xml
@@ -221,8 +221,8 @@
           <exclusion>
             <!--
               protobuf is transitive via `mysql-connector-j` and is only needed for
-              the X DevAPI (MySQL X Protocol); it also conflicts with the version
-              used by `xmsg`, so we exclude it here
+              the X DevAPI (MySQL X Protocol), unused here; it also conflicts with
+              the version used by `xmsg`, so we exclude it here
             -->
             <groupId>com.google.protobuf</groupId>
             <artifactId>protobuf-java</artifactId>