Merge pull request #327 from WordPress/release/0.6.0

Release/0.6.0

Co-authored-by: dkotter <dkotter@git.wordpress.org>

Author: jeffpaul

CHANGELOG.md

@@ -4,6 +4,35 @@ All notable changes to this project will be documented in this file, per [the Ke
 
 ## [Unreleased] - TBD
 
+## [0.6.0] - 2026-03-20
+**There are Breaking Changes in this release.**
+
+### Breaking Changes
+- Refactor `Experiments` to be a type of `Feature`, improving how functionality is organized and surfaced ([#316](https://github.com/WordPress/ai/pull/316)).
+
+The following classes have been removed. Anyone that was directly using these will need to make updates to utilize the correct replacements: `Abstract_Experiment`, `Invalid_Experiment_Metadata_Exception`, `Invalid_Experiment_Exception`, `Experiment_Loader`, `Experiment_Registry`.
+
+- Standardize the Title Generation Ability to align with other registered Abilities ([#227](https://github.com/WordPress/ai/pull/227)).
+
+The `ai/title-generation` Ability now uses a `context` argument instead of a `post_id` argument in the `input_schema`. Anyone directly using this Ability will need to make updates to account for that.
+
+### Added
+- New Experiment: Image Editing via prompt-based image refining in the Post Editor and Media Library ([#292](https://github.com/WordPress/ai/pull/292)).
+- New Experiment: Image Editing via expanding or removing background and removing or replacing items in the Media Libary ([#305](https://github.com/WordPress/ai/pull/305), [#312](https://github.com/WordPress/ai/pull/312)).
+
+### Changed
+- Rename the plugin from "AI Experiments" to "AI" ([#287](https://github.com/WordPress/ai/pull/287)).
+- Replace `Invalid_Experiment_Exception` with `_doing_it_wrong()` ([#303](https://github.com/WordPress/ai/pull/303)).
+- Rename hook prefixes in `helpers.php` ([#315](https://github.com/WordPress/ai/pull/315)).
+- Rename plugin constants to `WPAI_*` ([#317](https://github.com/WordPress/ai/pull/317)).
+- Refactor the upgrade routine and add v0.6.0 migrations ([#321](https://github.com/WordPress/ai/pull/321)).
+- Move the Generate Alt Text button to the new Content tab for improved discoverability ([#306](https://github.com/WordPress/ai/pull/306)).
+- Remove stray "AI" references from UI for improved consistency ([#320](https://github.com/WordPress/ai/pull/320)).
+- Update documentation ([#314](https://github.com/WordPress/ai/pull/314)).
+
+### Fixed
+- Remove duplicate error display in the Generate Alt Text flow ([#255](https://github.com/WordPress/ai/pull/255)).
+
 ## [0.5.0] - 2026-03-12
 **Note this version bumps the WordPress minimum supported version from 6.9 to 7.0.**
 

CREDITS.md

@@ -12,4 +12,4 @@ The following individuals are responsible for curating the list of issues, respo
 
 Thank you to all the people who have already contributed to this repository via bug reports, code, design, ideas, project management, translation, testing, etc.
 
-[Darin Kotter (@dkotter)](https://github.com/dkotter), [Jeffrey Paul (@jeffpaul)](https://github.com/jeffpaul), [Jason Adams (@JasonTheAdams)](https://github.com/JasonTheAdams), [Dovid Levine (@justlevine)](https://github.com/justlevine),[Md Aminul Islam (@theaminuli)](https://github.com/theaminuli), [Felix Arntz (@felixarntz)](https://github.com/felixarntz), [Jonathan Desrosiers (@desrosj)](https://github.com/desrosj), [Mohamed Khaled (@Ref34t)](https://github.com/Ref34t), [Iqbal Hossain (iqbal-web)](https://github.com/iqbal-web), [Lina Wiezkowiak (@linawiezkowiak)](https://github.com/linawiezkowiak), [Rachael Cortellessa (@rachaelcortellessa)](https://github.com/rachaelcortellessa), [James LePage (@Jameswlepage)](https://github.com/Jameswlepage), [Tammie Lister (@karmatosed)](https://github.com/karmatosed), [Aki Hamano (@t-hamano)](https://github.com/t-hamano), [Blake Bertuccelli-Booth (@bbertucc)](https://github.com/bbertucc), [Mujeebu Rahman (@mujuonly)](https://github.com/mujuonly), [Mukesh Panchal (@mukeshpanchal27)](https://github.com/mukeshpanchal27), [Pascal Birchler (@swissspidy)](https://github.com/swissspidy), [Dhruvang Shah (@dhruvang21)](https://github.com/dhruvang21), [Aslam Doctor (@aslamdoctor)](https://github.com/aslamdoctor), [John Parris (@mindctrl)](https://github.com/mindctrl), [James Morrison (@jamesmorrison)](https://github.com/jamesmorrison), [Paul Bearne (@pbearne)](https://github.com/pbearne), [Matt Cromwell (@mathetos)](https://github.com/mathetos), [Huzaifa Al Mesbah (@huzaifaalmesbah)](https://github.com/huzaifaalmesbah), [Mehraz Morshed (@mehrazmorshed)](https://github.com/mehrazmorshed), [JuanMa Garrido (@juanmaguitar)](https://github.com/juanmaguitar), [Adam Zieliński (@adamziel)](https://github.com/adamziel), [Weston Ruter (@westonruter)](https://github.com/westonruter), [Jonathan Bossenger (@jonathanbossenger)](https://github.com/jonathanbossenger), [Juan Aldasoro (@juanfra)](https://github.com/juanfra), [Casey Manos (@caseymanos)](https://github.com/caseymanos), [Stephanie Walters (@PypWalters)](https://github.com/PypWalters), [prabinjha (@prabinjha)](https://github.com/prabinjha), [Kurt Rank (@kurtrank)](https://github.com/kurtrank), [Lauren Woodmansee (@lwoodmansee)](https://github.com/lwoodmansee), [Andrew Palmer (@hellobertha)](https://github.com/hellobertha), [Md Aminul Islam (@theaminulai)](https://github.com/theaminulai), [Joe Dolson (@joedolson)](https://github.com/joedolson), [Andrei Zanouski (@andreizanik)](https://github.com/andreizanik), [Om vataliya (@Omcodes23)](https://github.com/Omcodes23), [Greg Ziółkowski (@gziolo)](https://github.com/gziolo), [Sapayth Hossain (@sapayth)](https://github.com/sapayth), [Ryuji Yasukochi (@Ryujiyasu)](https://github.com/Ryujiyasu), [Nischay (@zeus2611)](https://github.com/zeus2611).
+[Darin Kotter (@dkotter)](https://github.com/dkotter), [Jeffrey Paul (@jeffpaul)](https://github.com/jeffpaul), [Jason Adams (@JasonTheAdams)](https://github.com/JasonTheAdams), [Dovid Levine (@justlevine)](https://github.com/justlevine),[Md Aminul Islam (@theaminuli)](https://github.com/theaminuli), [Felix Arntz (@felixarntz)](https://github.com/felixarntz), [Jonathan Desrosiers (@desrosj)](https://github.com/desrosj), [Mohamed Khaled (@Ref34t)](https://github.com/Ref34t), [Iqbal Hossain (iqbal-web)](https://github.com/iqbal-web), [Lina Wiezkowiak (@linawiezkowiak)](https://github.com/linawiezkowiak), [Rachael Cortellessa (@rachaelcortellessa)](https://github.com/rachaelcortellessa), [James LePage (@Jameswlepage)](https://github.com/Jameswlepage), [Tammie Lister (@karmatosed)](https://github.com/karmatosed), [Aki Hamano (@t-hamano)](https://github.com/t-hamano), [Blake Bertuccelli-Booth (@bbertucc)](https://github.com/bbertucc), [Mujeebu Rahman (@mujuonly)](https://github.com/mujuonly), [Mukesh Panchal (@mukeshpanchal27)](https://github.com/mukeshpanchal27), [Pascal Birchler (@swissspidy)](https://github.com/swissspidy), [Dhruvang Shah (@dhruvang21)](https://github.com/dhruvang21), [Aslam Doctor (@aslamdoctor)](https://github.com/aslamdoctor), [John Parris (@mindctrl)](https://github.com/mindctrl), [James Morrison (@jamesmorrison)](https://github.com/jamesmorrison), [Paul Bearne (@pbearne)](https://github.com/pbearne), [Matt Cromwell (@mathetos)](https://github.com/mathetos), [Huzaifa Al Mesbah (@huzaifaalmesbah)](https://github.com/huzaifaalmesbah), [Mehraz Morshed (@mehrazmorshed)](https://github.com/mehrazmorshed), [JuanMa Garrido (@juanmaguitar)](https://github.com/juanmaguitar), [Adam Zieliński (@adamziel)](https://github.com/adamziel), [Weston Ruter (@westonruter)](https://github.com/westonruter), [Jonathan Bossenger (@jonathanbossenger)](https://github.com/jonathanbossenger), [Juan Aldasoro (@juanfra)](https://github.com/juanfra), [Casey Manos (@caseymanos)](https://github.com/caseymanos), [Stephanie Walters (@PypWalters)](https://github.com/PypWalters), [prabinjha (@prabinjha)](https://github.com/prabinjha), [Kurt Rank (@kurtrank)](https://github.com/kurtrank), [Lauren Woodmansee (@lwoodmansee)](https://github.com/lwoodmansee), [Andrew Palmer (@hellobertha)](https://github.com/hellobertha), [Md Aminul Islam (@theaminulai)](https://github.com/theaminulai), [Joe Dolson (@joedolson)](https://github.com/joedolson), [Andrei Zanouski (@andreizanik)](https://github.com/andreizanik), [Om vataliya (@Omcodes23)](https://github.com/Omcodes23), [Greg Ziółkowski (@gziolo)](https://github.com/gziolo), [Sapayth Hossain (@sapayth)](https://github.com/sapayth), [Ryuji Yasukochi (@Ryujiyasu)](https://github.com/Ryujiyasu), [Nischay (@zeus2611)](https://github.com/zeus2611), [Deepak Gupta (@raftaar1191)](https://github.com/raftaar1191), [George Mamadashvili (@Mamaduka)](https://github.com/Mamaduka).

README.md

@@ -38,7 +38,7 @@ This [Canonical Plugin](https://make.wordpress.org/core/2022/09/11/canonical-plu
 * **[Content Summarization](docs/experiments/summarization.md)** - Summarizes long-form content into digestible overviews.
 * **[Excerpt Generation](docs/experiments/excerpt-generation.md)** - Generates excerpt suggestions from content.
 * **Experiment Framework** - Opt-in system that lets you enable only the AI features you want to use.
-* **[Image Generation](docs/experiments/image-generation.md)** - Create images from post content in the editor, also via the Media Library.
+* **[Image Generation and Editing](docs/experiments/image-generation.md)** - Create and edit images from post content in the editor, also via the Media Library.
 * **Multi-Provider Support** - Works with popular AI providers like OpenAI, Google, and Anthropic.
 * **Review Notes** - Reviews post content block-by-block and adds Notes with suggestions for Accessibility, Readability, Grammar, and SEO.
 * **Title Generation** -  Generates title suggestions from content.

ai.php

@@ -11,7 +11,7 @@
  * Plugin Name:       AI
  * Plugin URI:        https://github.com/WordPress/ai
  * Description:       AI features, experiments and capabilities for WordPress.
- * Version:           0.5.0
+ * Version:           0.6.0
  * Requires at least: 7.0
  * Requires PHP:      7.4
  * Author:            WordPress.org Contributors

includes/Abilities/Image/Generate_Image.php

@@ -229,7 +229,7 @@ protected function generate_image( string $prompt, ?string $reference_image = nu
 	/**
 	 * Gets a prompt builder for generating an image.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 *
 	 * @param string $prompt The prompt to generate an image from.
 	 * @param string|null $reference_image Optional base64-encoded image to use as a reference for edits.

includes/Abstracts/Abstract_Feature.php

@@ -19,45 +19,45 @@
  *
  * Provides common functionality for all features including enable/disable state.
  *
- * @since x.x.x
+ * @since 0.6.0
  */
 abstract class Abstract_Feature implements Feature {
 	/**
 	 * Feature identifier.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 * @var non-empty-string
 	 */
 	protected string $id;
 
 	/**
 	 * Feature label.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 * @var non-empty-string
 	 */
 	protected string $label;
 
 	/**
 	 * Feature description.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 * @var non-empty-string
 	 */
 	protected string $description;
 
 	/**
 	 * Feature category.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 * @var non-empty-string
 	 */
 	protected string $category;
 
 	/**
 	 * Cache for this feature's enabled status.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 * @var bool|null
 	 */
 	private ?bool $enabled_cache = null;
@@ -73,7 +73,7 @@ abstract class Abstract_Feature implements Feature {
 	 *
 	 * Loads feature metadata and initializes properties.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 *
 	 * @throws \InvalidArgumentException If feature metadata is invalid.
 	 */
@@ -114,7 +114,7 @@ final public function __construct() {
 	 * Must return an array with keys: label, description.
 	 * Optionally includes: category, stability.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 *
 	 * @return array{
 	 *  label: string,
@@ -172,7 +172,7 @@ final public function is_enabled(): bool {
 		$is_enabled = (bool) apply_filters_deprecated(
 			"ai_experiments_experiment_{$this->id}_enabled",
 			array( $feature_enabled ),
-			'x.x.x',
+			'0.6.0',
 			"wpai_feature_{$this->id}_enabled",
 			esc_html__( 'This will be removed in v1.0', 'ai' )
 		);
@@ -182,7 +182,7 @@ final public function is_enabled(): bool {
 		 *
 		 * The dynamic portion of the hook name, `$this->id`, refers to the feature ID.
 		 *
-		 * @since x.x.x
+		 * @since 0.6.0
 		 *
 		 * @param bool $feature_enabled Whether the feature is enabled.
 		 */
@@ -207,7 +207,7 @@ final public function get_stability(): string {
 	 * Override this method in child classes to register custom settings options
 	 * using WordPress Settings API (register_setting).
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 *
 	 * @return void
 	 */
@@ -223,7 +223,7 @@ public function register_settings(): void {
 	 * that will appear within the feature's card on the settings page.
 	 * This is called after the feature's main toggle control.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 *
 	 * @return void
 	 */
@@ -239,7 +239,7 @@ public function render_settings_fields(): void {
 	 * Use this when registering and rendering custom settings fields to ensure
 	 * consistent naming across the plugin.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 *
 	 * @param string $option_name The base option name (e.g., 'api_key', 'temperature').
 	 * @return string The fully namespaced option name.

includes/Admin/Activation.php

@@ -3,7 +3,7 @@
  * Runs on plugin activation.
  *
  * @package WordPress\AI\Admin
- * @since x.x.x
+ * @since 0.6.0
  */
 
 declare( strict_types=1 );
@@ -18,13 +18,13 @@
  *
  * @internal
  *
- * @since x.x.x
+ * @since 0.6.0
  */
 final class Activation {
 	/**
 	 * Runs on plugin activation.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 */
 	public static function activation_callback(): void {
 		// Check and run any pending upgrades.

includes/Admin/Upgrades.php

@@ -3,7 +3,7 @@
  * Handles any routines or migrations necessary when upgrading to a new version of the plugin.
  *
  * @package WordPress\AI\Admin
- * @since x.x.x
+ * @since 0.6.0
  */
 
 declare( strict_types=1 );
@@ -21,20 +21,20 @@
  *
  * @internal
  *
- * @since x.x.x
+ * @since 0.6.0
  */
 final class Upgrades {
 	/**
 	 * The key to store the version.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 */
 	private const VERSION_OPTION_KEY = 'wpai_version';
 
 	/**
 	 * The key to store failed upgrade information for the admin notice.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 */
 	private const FAILED_UPGRADE_OPTION_KEY = 'wpai_failed_upgrade_message';
 
@@ -43,7 +43,7 @@ final class Upgrades {
 	 *
 	 * New upgrade routine classes should be added here, in order of oldest to newest.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 *
 	 * @var class-string<\WordPress\AI\Admin\Upgrades\Abstract_Upgrade>[]
 	 */
@@ -55,7 +55,7 @@ final class Upgrades {
 	/**
 	 * Initialize the class.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 */
 	public function init(): void {
 		// Runs as a fallback, in case the activation hook is missed.
@@ -67,7 +67,7 @@ public function init(): void {
 	/**
 	 * Checks for and runs any pending upgrades.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 */
 	public static function do_upgrades(): void {
 		$db_version = get_option( self::VERSION_OPTION_KEY, '' );
@@ -107,7 +107,7 @@ public static function do_upgrades(): void {
 	/**
 	 * Displays an admin notice if a plugin upgrade failed, with the error message.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 */
 	public function failed_upgrade_notice(): void {
 		// Skip if there's no failures.

includes/Admin/Upgrades/Abstract_Upgrade.php

@@ -7,7 +7,7 @@
  * Error are caught during the upgrade routine and stored in an option for use in an admin notice.
  *
  * @package WordPress\AI\Admin\Upgrades
- * @since x.x.x
+ * @since 0.6.0
  */
 
 declare( strict_types=1 );
@@ -22,7 +22,7 @@
  *
  * @internal
  *
- * @since x.x.x
+ * @since 0.6.0
  */
 abstract class Abstract_Upgrade {
 
@@ -31,7 +31,7 @@ abstract class Abstract_Upgrade {
 	 *
 	 * This should be overloaded
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 *
 	 * @var string
 	 */
@@ -42,7 +42,7 @@ abstract class Abstract_Upgrade {
 	 *
 	 * This is the version we're migrating from.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 *
 	 * @var string
 	 */
@@ -51,7 +51,7 @@ abstract class Abstract_Upgrade {
 	/**
 	 * Constructor.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 *
 	 * @param string $db_version The version of the plugin in the database.
 	 *
@@ -69,7 +69,7 @@ public function __construct( string $db_version ) {
 	/**
 	 * Performs the upgrade routine.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 *
 	 * @return true|\WP_Error True on success, or a WP_Error on failure.
 	 */

includes/Admin/Upgrades/V0_5_0.php

@@ -5,7 +5,7 @@
  * Originally this file was located in `includes/Migrations/Credential_Migration.php`, which is why the since tags don't match.
  *
  * @package WordPress\AI\Admin\Upgrades
- * @since x.x.x
+ * @since 0.6.0
  */
 
 declare( strict_types=1 );
@@ -18,14 +18,14 @@
 /**
  * Upgrade routine for migrating provider credentials to the new Connectors-based storage format.
  *
- * @since x.x.x
+ * @since 0.6.0
  * @internal
  */
 class V0_5_0 extends Abstract_Upgrade {
 	/**
 	 * The legacy option that stored all provider credentials as an array.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 * @var string
 	 */
 	private const OLD_OPTION = 'wp_ai_client_provider_credentials';
@@ -42,7 +42,7 @@ class V0_5_0 extends Abstract_Upgrade {
 	/**
 	 * {@inheritDoc}
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 */
 	public static string $version = '0.5.0';
 
@@ -54,7 +54,7 @@ class V0_5_0 extends Abstract_Upgrade {
 	 * Reads the old combined credentials option and, for each known provider,
 	 * copies the credential to the new option only when the new option is empty.
 	 *
-	 * @since x.x.x
+	 * @since 0.6.0
 	 */
 	protected function upgrade(): void {
 		$old_credentials = get_option( self::OLD_OPTION, array() );