diff --git a/includes/Abilities/DiscoverAbilitiesAbility.php b/includes/Abilities/DiscoverAbilitiesAbility.php index fc129663..311cb810 100644 --- a/includes/Abilities/DiscoverAbilitiesAbility.php +++ b/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; diff --git a/includes/Abilities/ExecuteAbilityAbility.php b/includes/Abilities/ExecuteAbilityAbility.php index b9359e28..b5798849 100644 --- a/includes/Abilities/ExecuteAbilityAbility.php +++ b/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; diff --git a/includes/Abilities/GetAbilityInfoAbility.php b/includes/Abilities/GetAbilityInfoAbility.php index b1a9335d..dc78a846 100644 --- a/includes/Abilities/GetAbilityInfoAbility.php +++ b/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; diff --git a/includes/Core/McpServer.php b/includes/Core/McpServer.php index 130c5163..af47fe14 100644 --- a/includes/Core/McpServer.php +++ b/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; } diff --git a/includes/Core/McpVersionNegotiator.php b/includes/Core/McpVersionNegotiator.php index 5d64e556..2f6783be 100644 --- a/includes/Core/McpVersionNegotiator.php +++ b/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. * diff --git a/includes/Domain/Resources/RegisterAbilityAsMcpResource.php b/includes/Domain/Resources/RegisterAbilityAsMcpResource.php index 2b70bb9d..29bfd5ce 100644 --- a/includes/Domain/Resources/RegisterAbilityAsMcpResource.php +++ b/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 ); diff --git a/includes/Domain/Tools/RegisterAbilityAsMcpTool.php b/includes/Domain/Tools/RegisterAbilityAsMcpTool.php index 40dc2074..d64a67e5 100644 --- a/includes/Domain/Tools/RegisterAbilityAsMcpTool.php +++ b/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 ); diff --git a/includes/Handlers/Initialize/InitializeHandler.php b/includes/Handlers/Initialize/InitializeHandler.php index c3f1975f..53446e07 100644 --- a/includes/Handlers/Initialize/InitializeHandler.php +++ b/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. * diff --git a/includes/Plugin.php b/includes/Plugin.php index 79a150c6..018d8d8f 100644 --- a/includes/Plugin.php +++ b/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 ); diff --git a/includes/Transport/Infrastructure/HttpRequestContext.php b/includes/Transport/Infrastructure/HttpRequestContext.php index 91ae1a11..20a98bda 100644 --- a/includes/Transport/Infrastructure/HttpRequestContext.php +++ b/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 */ diff --git a/includes/Transport/Infrastructure/HttpRequestHandler.php b/includes/Transport/Infrastructure/HttpRequestHandler.php index b7435bb9..39130beb 100644 --- a/includes/Transport/Infrastructure/HttpRequestHandler.php +++ b/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. *