Fix PHPDoc inconsistencies and remove duplicate code

includes/Abilities/DiscoverAbilitiesAbility.php

@@ -22,7 +22,7 @@
  * - Only abilities with mcp.public=true metadata will be returned
  * - Requires proper WordPress capability checks for secure operation
  *
- * @see https://github.com/your-repo/mcp-adapter/docs/security.md for detailed security configuration
+ * @see https://developer.wordpress.org/apis/security/ for detailed security guidance
  */
 final class DiscoverAbilitiesAbility {
 	use McpAbilityHelperTrait;

includes/Abilities/ExecuteAbilityAbility.php

@@ -24,7 +24,7 @@
  * - Requires proper WordPress capability checks for secure operation
  * - Caller identity verification is enforced through WordPress authentication
  *
- * @see https://github.com/your-repo/mcp-adapter/docs/security.md for detailed security configuration
+ * @see https://developer.wordpress.org/apis/security/ for detailed security guidance
  */
 final class ExecuteAbilityAbility {
 	use McpAbilityHelperTrait;

includes/Abilities/GetAbilityInfoAbility.php

@@ -22,7 +22,7 @@
  * - Only abilities with mcp.public=true metadata can be queried via default MCP server.
  * - Requires proper WordPress capability checks for secure operation
  *
- * @see https://github.com/your-repo/mcp-adapter/docs/security.md for detailed security configuration
+ * @see https://developer.wordpress.org/apis/security/ for detailed security guidance
  */
 final class GetAbilityInfoAbility {
 	use McpAbilityHelperTrait;

includes/Core/McpServer.php

@@ -324,6 +324,13 @@ public function get_observability_handler(): McpObservabilityHandlerInterface {
 		return $this->observability_handler;
 	}
 
+	/**
+	 * Get the error handler instance.
+	 *
+	 * @since n.e.x.t
+	 *
+	 * @return \WP\MCP\Infrastructure\ErrorHandling\Contracts\McpErrorHandlerInterface
+	 */
 	public function get_error_handler(): McpErrorHandlerInterface {
 		return $this->error_handler;
 	}

includes/Core/McpVersionNegotiator.php

@@ -17,7 +17,7 @@
  *
  * This is a Core layer class — no WordPress function calls.
  *
- * @since n.e.x.t.
+ * @since n.e.x.t
  */
 final class McpVersionNegotiator {
 
@@ -39,7 +39,7 @@ final class McpVersionNegotiator {
 	 * If the client-requested version is in the supported list it is echoed
 	 * back verbatim. Otherwise the latest supported version is returned.
 	 *
-	 * @since n.e.x.t.
+	 * @since n.e.x.t
 	 *
 	 * @param string $client_version The protocol version requested by the client.
 	 *
@@ -56,7 +56,7 @@ public static function negotiate( string $client_version ): string {
 	/**
 	 * Check whether a given version string is supported.
 	 *
-	 * @since n.e.x.t.
+	 * @since n.e.x.t
 	 *
 	 * @param string $version The protocol version to check.
 	 *

includes/Domain/Resources/RegisterAbilityAsMcpResource.php

@@ -262,11 +262,10 @@ private function get_uri() {
 		/**
 		 * Filters the MCP resource URI derived from an ability.
 		 *
-		 * @param string $uri The validated resource URI.
-		 * @param \WP_Ability $ability The source ability instance.
-		 *
 		 * @since n.e.x.t
 		 *
+		 * @param string $uri The validated resource URI.
+		 * @param \WP_Ability $ability The source ability instance.
 		 */
 		$filtered_uri = apply_filters( 'mcp_adapter_resource_uri', $uri, $this->ability );
 
@@ -410,11 +409,10 @@ private function resolve_resource_name(): string {
 		 *
 		 * Unlike tools, resource names have no charset restrictions.
 		 *
-		 * @param string $name The resource name.
-		 * @param \WP_Ability $ability The source ability instance.
-		 *
 		 * @since n.e.x.t
 		 *
+		 * @param string $name The resource name.
+		 * @param \WP_Ability $ability The source ability instance.
 		 */
 		$filtered_name = apply_filters( 'mcp_adapter_resource_name', $name, $this->ability );
 

includes/Domain/Tools/RegisterAbilityAsMcpTool.php

@@ -217,11 +217,10 @@ private function resolve_tool_name() {
 		/**
 		 * Filters the MCP tool name derived from an ability.
 		 *
-		 * @param string $name The sanitized tool name.
-		 * @param \WP_Ability $ability The source ability instance.
-		 *
 		 * @since n.e.x.t
 		 *
+		 * @param string $name The sanitized tool name.
+		 * @param \WP_Ability $ability The source ability instance.
 		 */
 		$filtered_name = apply_filters( 'mcp_adapter_tool_name', $sanitized_name, $this->ability );
 

includes/Handlers/Initialize/InitializeHandler.php

@@ -42,7 +42,7 @@ public function __construct( McpServer $mcp ) {
 	 * If the client requests a supported version, that version is used. Otherwise
 	 * the server falls back to the latest supported version.
 	 *
-	 * @since n.e.x.t.
+	 * @since n.e.x.t
 	 *
 	 * @param string $client_protocol_version The protocol version requested by the client.
 	 *

includes/Plugin.php

@@ -37,6 +37,8 @@ public static function instance(): self {
 			/**
 			 * Fires after the main plugin class has been initialized.
 			 *
+			 * @since 0.1.0
+			 *
 			 * @param self $instance The main plugin class instance.
 			 */
 			do_action( 'wp_mcp_init', self::$instance );

includes/Transport/Infrastructure/HttpRequestContext.php

@@ -46,7 +46,7 @@ class HttpRequestContext {
 	/**
 	 * The MCP-Protocol-Version header from the request.
 	 *
-	 * @since n.e.x.t.
+	 * @since n.e.x.t
 	 *
 	 * @var string|null
 	 */

includes/Transport/Infrastructure/HttpRequestHandler.php

@@ -18,6 +18,7 @@
  * Centralizes request routing logic to eliminate duplication and provide
  * consistent request handling across transport implementations.
  *
+ * @internal
  */
 class HttpRequestHandler {
 
@@ -234,7 +235,7 @@ private function get_transport_name(): string {
 	 * version is also accepted. An unsupported version returns a JSON-RPC
 	 * invalid-request error payload.
 	 *
-	 * @since n.e.x.t.
+	 * @since n.e.x.t
 	 *
 	 * @param \WP\MCP\Transport\Infrastructure\HttpRequestContext $context The HTTP request context.
 	 *