Spec: High-Speed Batch Price & Inventory Sync for 30,000+ Products via Action Scheduler & WP-CLI

<?php
declare(strict_types=1);

class AgenticLab_Catalog_Queue {
    public static function dispatch_sync_job(string $file_path): int {
        if (!file_exists($file_path)) {
            throw new \InvalidArgumentException('Файл выгрузки не найден: ' . $file_path);
        }

        $batch = [];
        $batch_size = 500;
        $total_batches = 0;

        $handle = fopen($file_path, 'r');
        // Пропускаем заголовок CSV:
        fgetcsv($handle);

        while (($row = fgetcsv($handle)) !== false) {
            // [0 => SKU, 1 => Price, 2 => StockQty]
            $batch[] = [
                'sku'   => trim($row[0]),
                'price' => (float) $row[1],
                'stock' => (int) $row[2],
            ];

            if (count($batch) >= $batch_size) {
                as_enqueue_async_action('agenticlab_process_stock_batch', [$batch], 'agenticlab_catalog_sync');
                $batch = [];
                $total_batches++;
            }
        }
        fclose($handle);

        if (!empty($batch)) {
            as_enqueue_async_action('agenticlab_process_stock_batch', [$batch], 'agenticlab_catalog_sync');
            $total_batches++;
        }

        return $total_batches;
    }
}