docs: add missing Javadoc to clear verify warnings

Complete enum, method, and parameter documentation so javadoc:jar runs without warnings.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: codeboyzhou

src/main/java/com/github/thought2code/mcp/annotated/enums/McpServerError.java

@@ -1,15 +1,36 @@
 package com.github.thought2code.mcp.annotated.enums;
 
+/**
+ * Stable error codes and messages for MCP server failures.
+ *
+ * @author codeboyzhou
+ */
 public enum McpServerError {
+
+  /** Configuration file was not found on the classpath. */
   CONFIG_FILE_NOT_FOUND("MCP_CONFIG_FILE_NOT_FOUND", "Configuration file not found."),
+
+  /** Configuration file path or URI is invalid. */
   INVALID_CONFIG_FILE("MCP_INVALID_CONFIG_FILE", "Invalid configuration file."),
+
+  /** YAML configuration file could not be read or parsed. */
   YAML_READ_ERROR("MCP_YAML_READ_ERROR", "Error reading YAML configuration file."),
+
+  /** Object could not be serialized to JSON. */
   JSON_SERIALIZE_ERROR("MCP_JSON_SERIALIZE_ERROR", "Error serializing object to JSON."),
+
+  /** JSON payload could not be deserialized. */
   JSON_DESERIALIZE_ERROR("MCP_JSON_DESERIALIZE_ERROR", "Error deserializing JSON."),
+
+  /** Jetty HTTP server failed to start. */
   JETTY_SERVER_START_ERROR(
       "MCP_JETTY_SERVER_START_ERROR", "Failed to start Jetty-based MCP server."),
+
+  /** MCP component instance could not be created. */
   COMPONENT_INSTANCE_CREATE_ERROR(
       "MCP_COMPONENT_INSTANCE_CREATE_ERROR", "Failed to create component instance."),
+
+  /** Annotated MCP method invocation failed unexpectedly. */
   METHOD_INVOCATION_ERROR(
       "MCP_METHOD_INVOCATION_ERROR", "Internal server error while executing MCP method.");
 
@@ -21,14 +42,30 @@ public enum McpServerError {
     this.message = message;
   }
 
+  /**
+   * Returns the stable machine-readable error code.
+   *
+   * @return the error code
+   */
   public String getCode() {
     return code;
   }
 
+  /**
+   * Returns the human-readable error message.
+   *
+   * @return the error message
+   */
   public String getMessage() {
     return message;
   }
 
+  /**
+   * Formats this error with an additional detail suffix.
+   *
+   * @param detail contextual detail appended to the message
+   * @return formatted error text including code, message, and detail
+   */
   public String withDetail(String detail) {
     return String.format("[%s] %s Detail: %s", getCode(), getMessage(), detail);
   }

src/main/java/com/github/thought2code/mcp/annotated/enums/ServerMode.java

@@ -29,6 +29,11 @@ public enum ServerMode {
     this.description = description;
   }
 
+  /**
+   * Returns a short human-readable label for this server mode.
+   *
+   * @return the mode description used in logs and diagnostics
+   */
   public String description() {
     return description;
   }

src/main/java/com/github/thought2code/mcp/annotated/enums/ServerType.java

@@ -21,6 +21,11 @@ public enum ServerType {
     this.description = description;
   }
 
+  /**
+   * Returns a short human-readable label for this server type.
+   *
+   * @return the type description used in logs and diagnostics
+   */
   public String description() {
     return description;
   }

src/main/java/com/github/thought2code/mcp/annotated/reflect/Invocation.java

@@ -17,7 +17,11 @@ public static Builder builder() {
     return new Builder();
   }
 
-  /** Returns the invocation result as text. */
+  /**
+   * Returns the invocation result as text.
+   *
+   * @return the string representation of the invocation result
+   */
   public String asText() {
     return result.toString();
   }

src/main/java/com/github/thought2code/mcp/annotated/server/component/ResourceBundleProvider.java

@@ -19,6 +19,7 @@
  */
 public final class ResourceBundleProvider {
 
+  /** Logger for resource bundle loading diagnostics. */
   public static final Logger log = LoggerFactory.getLogger(ResourceBundleProvider.class);
 
   /** Immutable map of localized values resolved from a resource bundle. */
@@ -31,6 +32,8 @@ private ResourceBundleProvider(ResourceBundle bundle) {
   /**
    * Loads i18n values from the main class configuration.
    *
+   * @param mainClass application entry class inspected for {@link McpI18nEnabled}
+   * @return a provider with localized values, or an empty provider when i18n is disabled
    * @throws IllegalArgumentException if {@code resourceBundleBaseName} is blank
    * @throws MissingResourceException if the configured bundle cannot be found
    */
@@ -52,7 +55,13 @@ public static ResourceBundleProvider loadResourceBundle(Class<?> mainClass) {
     return new ResourceBundleProvider(resourceBundle);
   }
 
-  /** Returns localized text by key, or falls back to the provided default. */
+  /**
+   * Returns localized text by key, or falls back to the provided default.
+   *
+   * @param i18nKey localization key to resolve
+   * @param defaultValue value used when the key is missing or blank
+   * @return localized text, or the default when no translation exists
+   */
   public String getString(String i18nKey, String defaultValue) {
     if (localizedValues.containsKey(i18nKey)) {
       return localizedValues.get(i18nKey);