Introduce a stand-alone table to store embedding data

.github/workflows/test.yml

@@ -350,8 +350,11 @@ jobs:
       matrix:
         core:
           - { name: 'WP latest', version: 'latest' }
-          - { name: 'WP minimum', version: 'https://wordpress.org/wordpress-6.9.zip' }
-          - { name: 'WP trunk', version: 'WordPress/WordPress#master' }
+          - { name: 'WP minimum', version: '6.9' }
+          - { name: 'WP trunk', version: 'trunk' }
+    env:
+      WP_ENV_PHP_VERSION: 8.3
+      WP_ENV_CORE: ${{ matrix.core.version == 'trunk' && 'WordPress/WordPress' || format( 'https://wordpress.org/wordpress-{0}.zip', matrix.core.version ) }}
 
     steps:
       - name: Checkout repository
@@ -389,8 +392,10 @@ jobs:
           command: |
             npm run env:start
 
-      - name: Install Playwright browsers
-        run: npx playwright install --with-deps chromium
+      - name: Log versions
+        run: |
+          npm run env -- run cli php -- -v
+          npm run env -- run cli wp core version
 
       - name: Run E2E tests
         run: npm run test:e2e

classifai.php

@@ -162,6 +162,10 @@ function classifai_autoload_notice() {
  */
 function classifai_activation() {
 	set_transient( 'classifai_activation_notice', 'classifai', HOUR_IN_SECONDS );
+
+	if ( classifai_autoload() ) {
+		\Classifai\Embeddings\Schema::maybe_install();
+	}
 }
 register_activation_hook( __FILE__, 'classifai_activation' );
 

includes/Classifai/Command/ClassifaiCommand.php

@@ -1353,6 +1353,72 @@ private function print( $output, $post_id ) {
 			\WP_CLI::warning( "Failed to classify $post_id: " . $output->get_error_message() );
 		}
 	}
+
+	/**
+	 * Migrate legacy embedding meta into the classifai_embeddings table.
+	 *
+	 * Runs the backfill inline, without Action Scheduler. Useful for hosts where
+	 * Action Scheduler is paused or for large sites that want a controlled run.
+	 *
+	 * ## Options
+	 *
+	 * [--batch-size=<int>]
+	 * : Number of objects to process per batch. Default 100.
+	 *
+	 * ## EXAMPLES
+	 *
+	 *     wp classifai migrate-embeddings
+	 *     wp classifai migrate-embeddings --batch-size=500
+	 *
+	 * @param array $args Positional args (unused).
+	 * @param array $opts Associative options.
+	 */
+	public function migrate_embeddings( $args = array(), $opts = array() ) {
+		$batch_size = isset( $opts['batch-size'] ) ? max( 1, (int) $opts['batch-size'] ) : 100;
+
+		\Classifai\Embeddings\Schema::maybe_install();
+		$runner = new \Classifai\Embeddings\MigrationRunner();
+
+		\WP_CLI::log( 'Starting embeddings migration...' );
+
+		$total_migrated = 0;
+		$runner->mark_running();
+
+		while ( true ) {
+			$batch = $runner->scan( $batch_size );
+			if ( empty( $batch ) ) {
+				break;
+			}
+
+			$runner->process_batch( $batch );
+			$total_migrated += count( $batch );
+			\WP_CLI::log( sprintf( 'Migrated %d objects (cumulative: %d).', count( $batch ), $total_migrated ) );
+		}
+
+		$runner->mark_completed();
+		\WP_CLI::success( sprintf( 'Embeddings migration complete. Total objects migrated: %d.', $total_migrated ) );
+	}
+
+	/**
+	 * Show the current status of the embeddings migration.
+	 *
+	 * ## EXAMPLES
+	 *
+	 *     wp classifai embeddings-status
+	 *
+	 * @param array $args Positional args (unused).
+	 * @param array $opts Associative options (unused).
+	 */
+	public function embeddings_status( $args = array(), $opts = array() ) {
+		unset( $args, $opts );
+		\Classifai\Embeddings\Schema::maybe_install();
+		$runner    = new \Classifai\Embeddings\MigrationRunner();
+		$status    = $runner->status();
+		$remaining = count( $runner->scan( PHP_INT_MAX ) );
+
+		\WP_CLI::log( sprintf( 'Status:    %s', $status ) );
+		\WP_CLI::log( sprintf( 'Remaining: %d legacy meta rows', $remaining ) );
+	}
 }
 
 try {