docs: add Javadoc to databind module for complete coverage

Add type-level and method-level Javadoc documentation to achieve
complete Javadoc coverage in the databind module:

- Add interface/class Javadoc to config, io, model packages
- Add Javadoc to annotation types and enum constants
- Fix code generator to produce Javadoc for field value getters/setters
- Fix package-info generation to avoid empty <p> tags
- Regenerate binding classes with improved Javadoc

This enables failOnWarnings=true for the maven-javadoc-plugin.

Author: david-waltermire

databind/src/main/java/gov/nist/secauto/metaschema/databind/IBindingContext.java

@@ -519,7 +519,9 @@ default IConstraintValidator newValidator(
    *          the validation configuration
    * @return the validation result
    * @throws ConstraintValidationException
+   *           if a constraint violation prevents validation from completing
    * @throws IllegalArgumentException
+   *           if the node item is not valid for validation
    */
   default IValidationResult validate(
       @NonNull IDocumentNodeItem nodeItem,
@@ -541,7 +543,9 @@ default IValidationResult validate(
    *          the validation configuration
    * @return the validation result
    * @throws ConstraintValidationException
+   *           if a constraint violation prevents validation from completing
    * @throws IllegalArgumentException
+   *           if the node item is not valid for validation
    */
   default IValidationResult validate(
       @NonNull IDefinitionNodeItem<?, ?> nodeItem,
@@ -577,6 +581,7 @@ default IValidationResult validate(
    * @throws IOException
    *           if an error occurred while reading the target
    * @throws ConstraintValidationException
+   *           if a constraint violation prevents validation from completing
    */
   default IValidationResult validate(
       @NonNull URI target,
@@ -605,6 +610,7 @@ default IValidationResult validate(
    * @throws IOException
    *           if an error occurred while parsing the target
    * @throws ConstraintValidationException
+   *           if a constraint violation prevents validation from completing
    */
   default IValidationResult validateWithConstraints(
       @NonNull URI target,

databind/src/main/java/gov/nist/secauto/metaschema/databind/codegen/IGeneratedDefinitionClass.java

@@ -9,6 +9,9 @@
 
 import edu.umd.cs.findbugs.annotations.NonNull;
 
+/**
+ * Represents a generated Java class for a Metaschema definition.
+ */
 public interface IGeneratedDefinitionClass extends IGeneratedClass {
 
   /**

databind/src/main/java/gov/nist/secauto/metaschema/databind/codegen/config/DefaultBindingConfiguration.java

@@ -39,6 +39,14 @@
 import edu.umd.cs.findbugs.annotations.NonNull;
 import edu.umd.cs.findbugs.annotations.Nullable;
 
+/**
+ * Default implementation of {@link IBindingConfiguration} that provides binding
+ * configuration for Java class generation from Metaschema modules.
+ * <p>
+ * This implementation supports loading configuration from XML files and
+ * provides namespace-to-package mappings and definition-specific binding
+ * configurations.
+ */
 public class DefaultBindingConfiguration implements IBindingConfiguration {
   private static final Logger LOGGER = LogManager.getLogger(DefaultBindingConfiguration.class);
 
@@ -659,6 +667,12 @@ private static IMutableDefinitionBindingConfiguration processDefinitionBindingCo
     return config;
   }
 
+  /**
+   * Holds binding configurations for a specific Metaschema module.
+   * <p>
+   * This class maintains mappings from definition names to their binding
+   * configurations for both assembly and field definitions.
+   */
   public static final class MetaschemaBindingConfiguration {
     private final Map<String, IDefinitionBindingConfiguration> assemblyBindingConfigs = new ConcurrentHashMap<>();
     private final Map<String, IDefinitionBindingConfiguration> fieldBindingConfigs = new ConcurrentHashMap<>();

databind/src/main/java/gov/nist/secauto/metaschema/databind/codegen/config/DefaultDefinitionBindingConfiguration.java

@@ -15,6 +15,10 @@
 import edu.umd.cs.findbugs.annotations.NonNull;
 import edu.umd.cs.findbugs.annotations.Nullable;
 
+/**
+ * Default implementation of {@link IMutableDefinitionBindingConfiguration} that
+ * provides mutable binding configuration for a specific Metaschema definition.
+ */
 public class DefaultDefinitionBindingConfiguration implements IMutableDefinitionBindingConfiguration {
   @Nullable
   private String className;

databind/src/main/java/gov/nist/secauto/metaschema/databind/codegen/config/IBindingConfiguration.java

@@ -13,6 +13,14 @@
 import edu.umd.cs.findbugs.annotations.NonNull;
 import edu.umd.cs.findbugs.annotations.Nullable;
 
+/**
+ * Provides configuration for Java class binding generation from Metaschema
+ * modules.
+ * <p>
+ * This interface defines how Metaschema module elements are mapped to Java
+ * classes, including package names, class names, base classes, and
+ * superinterfaces.
+ */
 public interface IBindingConfiguration {
 
   /**

databind/src/main/java/gov/nist/secauto/metaschema/databind/codegen/config/IDefinitionBindingConfiguration.java

@@ -11,6 +11,13 @@
 import edu.umd.cs.findbugs.annotations.NonNull;
 import edu.umd.cs.findbugs.annotations.Nullable;
 
+/**
+ * Provides binding configuration for a specific Metaschema definition.
+ * <p>
+ * This interface defines how an individual field or assembly definition is
+ * mapped to a generated Java class, including the class name, base class, and
+ * interfaces to implement.
+ */
 public interface IDefinitionBindingConfiguration {
   /**
    * Get the class name to use for the generated class associated with this

databind/src/main/java/gov/nist/secauto/metaschema/databind/codegen/typeinfo/DefaultMetaschemaClassFactory.java

@@ -312,7 +312,7 @@ public IGeneratedClass generatePackageInfoClass(
         writer.format(" * version %s%n", module.getVersion());
         MarkupMultiline remarks = module.getRemarks();
         if (remarks != null) {
-          writer.format(" * <p>%n");
+          // Remarks already include proper HTML formatting
           writer.format(" * %s%n", remarks.toHtml());
         }
       }
@@ -691,9 +691,19 @@ protected Set<IModelDefinition> buildClass(
   protected Set<IModelDefinition> buildClass(
       @NonNull IModelDefinitionTypeInfo typeInfo,
       @NonNull TypeSpec.Builder builder) {
-    MarkupLine description = typeInfo.getDefinition().getDescription();
+    IModelDefinition definition = typeInfo.getDefinition();
+    MarkupLine description = definition.getDescription();
     if (description != null) {
       builder.addJavadoc(description.toHtml());
+    } else {
+      // Fallback to formal-name or definition name when description is missing
+      String formalName = definition.getEffectiveFormalName();
+      if (formalName != null) {
+        builder.addJavadoc("$L.", formalName);
+      } else {
+        // Last resort: use the definition name
+        builder.addJavadoc("A binding class for the {@code $L} definition.", definition.getName());
+      }
     }
 
     Set<IModelDefinition> additionalChildClasses = new LinkedHashSet<>();

databind/src/main/java/gov/nist/secauto/metaschema/databind/codegen/typeinfo/FieldValueTypeInfoImpl.java

@@ -8,6 +8,7 @@
 import com.squareup.javapoet.AnnotationSpec;
 import com.squareup.javapoet.ClassName;
 import com.squareup.javapoet.FieldSpec;
+import com.squareup.javapoet.MethodSpec;
 import com.squareup.javapoet.TypeName;
 import com.squareup.javapoet.TypeSpec;
 
@@ -72,4 +73,19 @@ protected Set<IModelDefinition> buildField(
     fieldBuilder.addAnnotation(fieldValue.build());
     return retval;
   }
+
+  @Override
+  public void buildFieldJavadoc(@NonNull FieldSpec.Builder builder) {
+    builder.addJavadoc("The field value.");
+  }
+
+  @Override
+  public void buildGetterJavadoc(@NonNull MethodSpec.Builder builder) {
+    builder.addJavadoc("Get the field value.\n\n@return the value");
+  }
+
+  @Override
+  public void buildSetterJavadoc(@NonNull MethodSpec.Builder builder, @NonNull String paramName) {
+    builder.addJavadoc("Set the field value.\n\n@param $L\n          the value to set", paramName);
+  }
 }

databind/src/main/java/gov/nist/secauto/metaschema/databind/config/binding/MetaschemaBindings.java

@@ -1481,6 +1481,9 @@ public static class ItemType implements IBoundObject {
               typeAdapter = BooleanAdapter.class)
           private Boolean _useWildcard;
 
+          /**
+           * The field value.
+           */
           @BoundFieldValue(
               valueKeyName = "STRVALUE",
               typeAdapter = TokenAdapter.class)
@@ -1540,11 +1543,22 @@ public void setUseWildcard(@Nullable Boolean value) {
             _useWildcard = value;
           }
 
+          /**
+           * Get the field value.
+           *
+           * @return the value
+           */
           @Nullable
           public String getValue() {
             return _value;
           }
 
+          /**
+           * Set the field value.
+           *
+           * @param value
+           *          the value to set
+           */
           public void setValue(@Nullable String value) {
             _value = value;
           }

databind/src/main/java/gov/nist/secauto/metaschema/databind/config/binding/package-info.java

@@ -10,7 +10,6 @@
  * <p>
  * version 1.0.0
  * <p>
- * <p>
  * This module defines the binding configuration format used to customize Java
  * code generation from Metaschema modules. It allows specifying package names,
  * class names, interface implementations, base classes, and collection types