Changeset 14710

Timestamp:

03/13/2026 04:50:39 PM (4 weeks ago)

Author:

obenland

Message:

WP.org Abilities: Add plugin status and review feedback tool.

Introduce a new MCP tool that returns plugin submission status and
reviewer feedback from HelpScout for plugins owned by the authenticated
user. Strips boilerplate from review emails to keep responses focused
on actionable issues.

Also adds output schemas and MCP annotations (idempotent, destructive)
to both tools, and updates the address-review-feedback prompt to
reference the new tool name.

Location:

sites/trunk/wordpress.org/public_html/wp-content/plugins/wporg-abilities

Files:

• class-registrar.php (modified) (1 diff)
• plugins/plugin-directory/class-ability-base.php (modified) (2 diffs)
• plugins/plugin-directory/prompts/class-address-review-feedback.php (modified) (1 diff)
• plugins/plugin-directory/tools/class-get-plugin-status.php (added)
• plugins/plugin-directory/tools/class-validate-readme.php (modified) (1 diff)

sites/trunk/wordpress.org/public_html/wp-content/plugins/wporg-abilities/class-registrar.php

@@ -56 +56 @@
         // Tools.
         Plugin_Directory\Tools\Validate_Readme::register();
+        Plugin_Directory\Tools\Get_Plugin_Status::register();
 
         // Prompts.

sites/trunk/wordpress.org/public_html/wp-content/plugins/wporg-abilities/plugins/plugin-directory/class-ability-base.php

@@ -28 +28 @@
 
     /**
-     * Register the plugin-directory autoloader if it hasn't been loaded yet.
+     * Blog ID for the plugin directory (wordpress.org/plugins) in the multisite network.
      *
-     * This is needed when abilities reference classes from the plugin-directory
-     * plugin (e.g. Readme\Validator, Trademarks) that may not be autoloaded yet.
+     * @var int
+     */
+    const PLUGINS_BLOG_ID = 367;
+
+    /**
+     * Load the plugin-directory autoloader and switch to the plugins blog.
+     *
+     * Registers the plugin-directory autoloader so abilities can reference classes
+     * like Readme\Validator and Trademarks, and switches to the plugins blog so
+     * queries run against the correct posts table.
      */
     protected static function maybe_load_plugin_directory(): void {
@@ -51 +59 @@
             WP_PLUGIN_DIR . '/plugin-directory'
         );
+
+        switch_to_blog( self::PLUGINS_BLOG_ID );
 
         $loaded = true;

sites/trunk/wordpress.org/public_html/wp-content/plugins/wporg-abilities/plugins/plugin-directory/prompts/class-address-review-feedback.php

@@ -60 +60 @@
 Help me address the review feedback for my plugin `{$plugin_slug}` submitted to the WordPress.org plugin directory.
 
-## Step 1: Fetch Review Feedback
+## Step 1: Fetch Plugin Status and Review Feedback
 
-Use the `wporg/get-review-feedback` tool with slug `{$plugin_slug}` to retrieve the reviewer's feedback.
+Use the `wporg/plugins/plugin-directory/get-plugin-status` tool with slug `{$plugin_slug}` to retrieve the latest reviewer feedback. If the plugin status is not "pending", there is no actionable feedback to address.
 
 ## Step 2: Parse Each Issue

sites/trunk/wordpress.org/public_html/wp-content/plugins/wporg-abilities/plugins/plugin-directory/tools/class-validate-readme.php

@@ -40 +40 @@
                     'required'   => array( 'content' ),
                 ),
+                'output_schema'       => array(
+                    'type'       => 'object',
+                    'properties' => array(
+                        'errors'   => array(
+                            'type'                 => 'object',
+                            'description'          => 'Validation errors that must be fixed before submission.',
+                            'additionalProperties' => array( 'type' => 'string' ),
+                        ),
+                        'warnings' => array(
+                            'type'                 => 'object',
+                            'description'          => 'Warnings that should be reviewed and fixed if applicable.',
+                            'additionalProperties' => array( 'type' => 'string' ),
+                        ),
+                        'notes'    => array(
+                            'type'                 => 'object',
+                            'description'          => 'Informational notes and suggestions.',
+                            'additionalProperties' => array( 'type' => 'string' ),
+                        ),
+                    ),
+                ),
                 'execute_callback'    => array( __CLASS__, 'execute' ),
                 'permission_callback' => '__return_true',
                 'meta'                => array(
                     'mcp'         => array( 'type' => 'tool' ),
-                    'annotations' => array( 'readonly' => true ),
+                    'annotations' => array(
+                        'readonly'     => true,
+                        'idempotent'   => true,
+                        'destructive'  => false,
+                    ),
                 ),
             )