Address PR #532 feedback: document supported constraint types

- Add class-level Javadoc to ContextBuilder listing supported constraint
  types (IAllowedValuesConstraint, IMatchesConstraint, IExpectConstraint,
  IIndexHasKeyConstraint) and noting which types will throw
  UnsupportedOperationException
- Add source assertions to test methods and clarify that constraint
  application is tested in ExternalConstraintsModulePostProcessorTest

Author: david-waltermire

core/src/test/java/gov/nist/secauto/metaschema/core/testsupport/builder/ContextBuilder.java

@@ -27,6 +27,18 @@
 
 /**
  * Implementation of {@link IContextBuilder} for creating constraint contexts.
+ * <p>
+ * This builder supports the following constraint types:
+ * <ul>
+ * <li>{@link IAllowedValuesConstraint}</li>
+ * <li>{@link IMatchesConstraint}</li>
+ * <li>{@link IExpectConstraint}</li>
+ * <li>{@link IIndexHasKeyConstraint}</li>
+ * </ul>
+ * Other constraint types (such as {@code ICardinalityConstraint},
+ * {@code IIndexConstraint}, or {@code IUniqueConstraint}) will throw an
+ * {@link UnsupportedOperationException} when added. To support additional
+ * constraint types, extend the {@link #addConstraint} method.
  */
 public class ContextBuilder implements IContextBuilder {
   @NonNull

core/src/test/java/gov/nist/secauto/metaschema/core/testsupport/tests/ConstraintSetBuilderTest.java

@@ -75,6 +75,10 @@ void testConstraintSetWithAllowedValuesContext() {
 
     // Then
     assertNotNull(constraintSet, "Constraint set should not be null");
+    assertEquals(source, constraintSet.getSource(), "Source should match");
+    // Note: Verifying the constraint was actually added requires applying the
+    // constraint set to a module, which is tested in
+    // ExternalConstraintsModulePostProcessorTest
   }
 
   @Test
@@ -102,6 +106,7 @@ void testConstraintSetWithMatchesContext() {
 
     // Then
     assertNotNull(constraintSet, "Constraint set should not be null");
+    assertEquals(source, constraintSet.getSource(), "Source should match");
   }
 
   @Test
@@ -129,6 +134,7 @@ void testConstraintSetWithNestedContexts() {
 
     // Then
     assertNotNull(constraintSet, "Constraint set should not be null");
+    assertEquals(source, constraintSet.getSource(), "Source should match");
   }
 
   @Test
@@ -180,5 +186,6 @@ void testConstraintSetWithMultipleContexts() {
 
     // Then
     assertNotNull(constraintSet, "Constraint set should not be null");
+    assertEquals(source, constraintSet.getSource(), "Source should match");
   }
 }