feat: remove XMLBeans dependency from metaschema-testing module

Replace XMLBeans with Metaschema bindings in the metaschema-testing module:

- Create YAML Metaschema module (unit-tests.yaml) to replace XSD schema
- Configure metaschema-maven-plugin for binding class generation
- Update AbstractTestSuite.java to use generated Metaschema bindings
- Remove XMLBeans handler classes and configuration files
- Remove XMLBeans from parent POM (dependencies, plugin, javadoc exclusions)
- Clean up leftover XMLBeans artifacts in databind module
- Update documentation to reflect YAML-first approach

This completes the XMLBeans removal initiative. No XMLBeans references
remain in the codebase.

Author: david-waltermire

CLAUDE.md

@@ -102,11 +102,18 @@ Metapath is an implementation of XPath 3.1. The [XPath 3.1 specification](https:
 ### Generated Code
 
 Code generation occurs during Maven build:
-- **XMLBeans**: Generated from XSD schemas in `core/metaschema/schema/xml`
+- **Metaschema bindings**: Generated from Metaschema modules via metaschema-maven-plugin
 - **ANTLR4**: Metapath parser from `core/src/main/antlr4`
 
 Generated sources are placed in `target/generated-sources/` and excluded from style checks.
 
+### Metaschema Module Authoring
+
+**YAML-first approach**: When creating new Metaschema modules, prefer YAML format over XML.
+- YAML modules use `.yaml` extension and are stored in `src/main/metaschema/`
+- Use the JSON schema at `databind-metaschema/target/generated-resources/schema/json/metaschema-model_schema.json` for IDE validation
+- Reference existing YAML modules (e.g., `databind/src/main/metaschema/metaschema-bindings.yaml`) for structure examples
+
 ### Key Interfaces
 
 - `IModule` - Represents a Metaschema module with definitions
@@ -168,7 +175,7 @@ Checkstyle enforces these rules (configured in [oss-maven checkstyle.xml](https:
 Exceptions (no Javadoc required):
 - `@Override` methods (inherit documentation)
 - `@Test` methods (use descriptive names)
-- Generated code (`*.xmlbeans`, `*.antlr` packages)
+- Generated code (`*.antlr` packages)
 
 ```bash
 # Check Javadoc compliance

PRDs/20251221-xmlbeans-removal/implementation-plan.md

@@ -124,7 +124,7 @@ Use this schema for IDE validation when authoring the YAML Metaschema modules.
 | **Risk Level** | Low |
 | **Dependencies** | PR 1 |
 | **Target Branch** | develop |
-| **Status** | Pending |
+| **Status** | Ready for PR |
 | **Pull Request** | |
 
 #### Files to Create
@@ -177,19 +177,19 @@ Use this schema for IDE validation when authoring the YAML Metaschema modules.
 
 #### Acceptance Criteria
 
-- [ ] Metaschema module created at `metaschema-testing/src/main/metaschema/unit-tests.yaml`
-- [ ] metaschema-maven-plugin configured in testing POM
-- [ ] `AbstractTestSuite.java` uses generated binding classes
-- [ ] No XMLBeans imports in metaschema-testing module
-- [ ] XMLBeans dependency removed from `metaschema-testing/pom.xml`
-- [ ] XMLBeans removed from parent `pom.xml`
-- [ ] XSD file deleted from `core/metaschema/test-suite/`
-- [ ] XMLBeans handler package deleted
-- [ ] Existing test suite files parse correctly
-- [ ] All metaschema-testing tests pass
-- [ ] All dependent module tests pass
-- [ ] Full CI build succeeds: `mvn install -PCI -Prelease`
-- [ ] No XMLBeans references remain in codebase (verify with grep)
+- [x] Metaschema module created at `metaschema-testing/src/main/metaschema/unit-tests.yaml`
+- [x] metaschema-maven-plugin configured in testing POM
+- [x] `AbstractTestSuite.java` uses generated binding classes
+- [x] No XMLBeans imports in metaschema-testing module
+- [x] XMLBeans dependency removed from `metaschema-testing/pom.xml`
+- [x] XMLBeans removed from parent `pom.xml`
+- [x] XSD file deleted from `core/metaschema/test-suite/`
+- [x] XMLBeans handler package deleted
+- [x] Existing test suite files parse correctly
+- [x] All metaschema-testing tests pass
+- [x] All dependent module tests pass
+- [x] Full CI build succeeds: `mvn install -PCI -Prelease`
+- [x] No XMLBeans references remain in codebase (verify with grep)
 
 ---
 

databind/spotbugs-exclude.xml

@@ -5,7 +5,6 @@
 	xsi:schemaLocation="https://github.com/spotbugs/filter/3.0.0 https://raw.githubusercontent.com/spotbugs/spotbugs/3.1.0/spotbugs/etc/findbugsfilter.xsd">
 	<Match>
 		<Or>
-			<Package name="~gov\.nist\.secauto\.metaschema\.databind\.codegen\.xmlbeans\.*" />
 			<Bug pattern="EI_EXPOSE_REP" />
 			<Bug pattern="EI_EXPOSE_REP2" />
 		</Or>

databind/src/main/java/org/apache/xmlbeans/metadata/system/metaschema/codegen/package-info.java

@@ -7,7 +7,7 @@ This guide defines the Javadoc requirements for the metaschema-java project, bas
 The project's `pom.xml` configures `maven-javadoc-plugin` with:
 - `failOnWarnings: false` - Javadoc warnings do not fail the build (currently)
 - `failOnError: false` - Javadoc errors do not fail the build (currently)
-- Excluded packages: `*.xmlbeans`, `*.xmlbeans.*`, `*.antlr` (generated code)
+- Excluded packages: `*.antlr` (generated code)
 
 **Important**: While these settings currently allow builds to pass with Javadoc issues, the goal is to progressively improve documentation coverage until these can be set to `true`.
 
@@ -351,6 +351,6 @@ When working in a file, consider documenting nearby undocumented members, especi
 ### Excluded Code
 
 Do not add Javadoc to:
-- Generated code (`*.xmlbeans`, `*.antlr` packages)
+- Generated code (`*.antlr` packages)
 - `module-info.java` files
 - Test classes and methods (use descriptive method names instead)

docs/javadoc-style-guide.md

@@ -32,10 +32,6 @@
 			<groupId>${project.groupId}</groupId>
 			<artifactId>metaschema-databind</artifactId>
 		</dependency>
-		<dependency>
-			<groupId>org.apache.xmlbeans</groupId>
-			<artifactId>xmlbeans</artifactId>
-		</dependency>
 		<dependency>
 			<groupId>org.apache.logging.log4j</groupId>
 			<artifactId>log4j-core</artifactId>
@@ -53,46 +49,50 @@
 	</dependencies>
 
 	<build>
-		<resources>
-			<resource>
-				<directory>src/main/resources</directory>
-			</resource>
-			<resource>
-				<directory>${project.build.directory}/generated-resources/xmlbeans</directory>
-			</resource>
-		</resources>
 		<pluginManagement>
 			<plugins>
 				<plugin>
 					<groupId>org.apache.maven.plugins</groupId>
 					<artifactId>maven-pmd-plugin</artifactId>
 					<configuration>
 						<excludeRoots>
-							<excludeRoot>target/generated-sources/xmlbeans</excludeRoot>
+							<excludeRoot>target/generated-sources/metaschema</excludeRoot>
 						</excludeRoots>
 					</configuration>
 				</plugin>
+				<plugin>
+					<groupId>org.apache.maven.plugins</groupId>
+					<artifactId>maven-checkstyle-plugin</artifactId>
+					<configuration>
+						<excludes>**/gov/nist/secauto/metaschema/model/testing/binding/**/*</excludes>
+					</configuration>
+				</plugin>
+				<plugin>
+					<groupId>com.github.spotbugs</groupId>
+					<artifactId>spotbugs-maven-plugin</artifactId>
+					<configuration>
+						<excludeFilterFile>spotbugs-exclude.xml</excludeFilterFile>
+					</configuration>
+				</plugin>
 			</plugins>
 		</pluginManagement>
 		<plugins>
 			<plugin>
-				<groupId>org.apache.xmlbeans</groupId>
-				<artifactId>xmlbeans</artifactId>
+				<groupId>${project.groupId}</groupId>
+				<artifactId>metaschema-maven-plugin</artifactId>
+				<version>${project.version}</version>
 				<executions>
 					<execution>
-						<id>metaschema-testing-beans</id>
-						<inherited>false</inherited>
+						<id>generate-test-suite-bindings</id>
 						<phase>generate-sources</phase>
 						<goals>
-							<goal>compile</goal>
+							<goal>generate-sources</goal>
 						</goals>
 						<configuration>
-	                        <xmlConfigs>${project.basedir}/src/schema/xmlconfig.xml</xmlConfigs>
-							<sourceDir>${project.basedir}/../core/metaschema/test-suite</sourceDir>
-							<sourceSchemas>unit-tests.xsd</sourceSchemas>
-							<javaTargetDir>${project.build.directory}/generated-sources/xmlbeans</javaTargetDir>
-							<classTargetDir>${project.basedir}/target/generated-resources/xmlbeans</classTargetDir>
-							<name>metaschema.testing</name>
+							<metaschemaDir>${project.basedir}/src/main/metaschema</metaschemaDir>
+							<includes>
+								<include>unit-tests.yaml</include>
+							</includes>
 						</configuration>
 					</execution>
 				</executions>
@@ -102,14 +102,14 @@
 				<artifactId>build-helper-maven-plugin</artifactId>
 				<executions>
 					<execution>
-						<id>add-xmlbeans-source</id>
+						<id>add-generated-sources</id>
 						<phase>generate-sources</phase>
 						<goals>
 							<goal>add-source</goal>
 						</goals>
 						<configuration>
 							<sources>
-								<source>${project.build.directory}/generated-sources/xmlbeans</source>
+								<source>${project.build.directory}/generated-sources/metaschema</source>
 							</sources>
 						</configuration>
 					</execution>

metaschema-testing/pom.xml

@@ -9,4 +9,8 @@
 			<Bug pattern="EI_EXPOSE_REP2" />
 		</Or>
 	</Match>
+	<!-- Exclude generated binding classes -->
+	<Match>
+		<Package name="~gov\.nist\.secauto\.metaschema\.model\.testing\.binding.*" />
+	</Match>
 </FindBugsFilter>