<?php
/**
 * TMDO_Setup_Wizard — First-run onboarding wizard (v2.3.0 M5).
 *
 * 5 steps:
 *   1. Welcome + anti-EAV concept (4-zone diagram, when needed, when not).
 *   2. Baseline diagnostic — auto-runs Site Health, postmeta count, top
 *      meta_key consumers, predicted optimization upside.
 *   3. Recommendation — checks Classifier suggestions, presents pre-checked
 *      modules with "OK" / "skip" choice (no auto-enable; explicit consent).
 *   4. First snapshot + daily health check (already scheduled by Core, just
 *      confirms here).
 *   5. Done — sets wpdo_setup_wizard_completed=1, wpdo_first_run_at timestamp.
 *
 * Trigger: admin loads any wp-admin page AND wpdo_setup_wizard_completed != '1'.
 * Existing-user shielding: if any module is not idle (= already migrating),
 * we mark wizard completed immediately to avoid ambushing experienced admins.
 *
 * @package WP_Data_Optimizer
 */

// phpcs:ignore WPDO.AntiEAV -- platform admin UI: postmeta inventory for setup wizard

declare(strict_types=1);

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Setup wizard — stateless static API.
 */
class TMDO_Setup_Wizard {

	public const OPT_COMPLETED = 'wpdo_setup_wizard_completed';
	public const OPT_FIRST_RUN = 'wpdo_first_run_at';
	public const QUERY_PARAM   = 'wpdo_wizard';
	public const NONCE_NAME    = 'wpdo_wizard_nonce';
	public const TOTAL_STEPS   = 5;

	/**
	 * Bootstrap hooks.
	 *
	 * @return void
	 */
	public static function register(): void {
		add_action( 'admin_init', array( __CLASS__, 'maybe_redirect_to_wizard' ) );
		add_action( 'admin_menu', array( __CLASS__, 'register_menu_page' ) );
		add_action( 'admin_post_wpdo_wizard_step', array( __CLASS__, 'handle_step_submit' ) );
		add_action( 'admin_post_wpdo_wizard_dismiss', array( __CLASS__, 'handle_dismiss' ) );
		add_action( 'admin_post_wpdo_wizard_reset', array( __CLASS__, 'handle_reset' ) );
	}

	/**
	 * On first activation, decide: run wizard, or shield (already configured).
	 *
	 * @return void
	 */
	public static function maybe_redirect_to_wizard(): void {
		// Don't redirect on AJAX / cron / auto-saves / wp-cli.
		if ( wp_doing_ajax() || wp_doing_cron() || ( defined( 'WP_CLI' ) && WP_CLI ) ) {
			return;
		}
		if ( ! TMDO_Capability::current_user_can_admin() ) {
			return;
		}
		if ( '1' === get_option( self::OPT_COMPLETED ) ) {
			return;
		}

		// Shield existing users: if any module is not idle, the admin already knows
		// what they're doing. Mark wizard completed silently.
		if ( class_exists( 'TMDO_Feature_Flags' ) ) {
			$flags = TMDO_Feature_Flags::all();
			foreach ( $flags as $state ) {
				if ( 'idle' !== $state ) {
					update_option( self::OPT_COMPLETED, '1', false );
					update_option( self::OPT_FIRST_RUN, gmdate( 'Y-m-d H:i:s' ), false );
					return;
				}
			}
		}

		// Don't redirect if already on the wizard page or another WPDO admin page.
		$page = isset( $_GET['page'] ) ? sanitize_key( wp_unslash( (string) $_GET['page'] ) ) : ''; // phpcs:ignore WordPress.Security.NonceVerification.Recommended
		if ( in_array( $page, array( 'wpdo-setup-wizard', '2meet-data-optimizer' ), true ) ) {
			return;
		}

		// Only redirect from the WordPress dashboard top page (avoid plugin install + mu-plugins flow).
		global $pagenow;
		if ( 'index.php' !== $pagenow ) {
			return;
		}

		wp_safe_redirect( admin_url( 'tools.php?page=wpdo-setup-wizard&step=1' ) );
		exit;
	}

	/**
	 * Register the wizard as a visible submenu item under Tools > WP Data Optimizer.
	 *
	 * Appears in the Tools section so admins can re-run the wizard at any time.
	 * The wizard itself is idempotent: re-running it never auto-enables modules.
	 *
	 * @return void
	 */
	public static function register_menu_page(): void {
		$hook_suffix = add_submenu_page(
			'tools.php',
			__( 'WPDO 設定嚮導', '2meet-data-optimizer' ),
			__( 'WPDO 設定嚮導', '2meet-data-optimizer' ),
			'manage_options',
			'wpdo-setup-wizard',
			array( __CLASS__, 'render_page' )
		);
		if ( $hook_suffix ) {
			add_action( 'load-' . $hook_suffix, array( __CLASS__, 'handle_snapshot_post' ) );
		}
	}

	/**
	 * Step 4 baseline snapshot (POST + nonce, prevents Referer leak — v3.3.x
	 * P1-6b hardening), handled on load-{page} so the redirect runs before any
	 * output.
	 *
	 * @return void
	 */
	public static function handle_snapshot_post(): void {
		if ( ! isset( $_POST['wpdo_take_snapshot'] ) || ! TMDO_Capability::current_user_can_admin() || ! class_exists( 'TMDO_Snapshot_Manager' ) ) {
			return;
		}
		check_admin_referer( self::NONCE_NAME );
		$result = TMDO_Snapshot_Manager::create(
			'manual',
			array(),
			array(
				'notes'          => 'wizard_baseline',
				'retention_days' => 365,
			)
		);
		wp_safe_redirect( admin_url( 'tools.php?page=wpdo-setup-wizard&step=4&' . ( empty( $result['ok'] ) ? 'snap_failed=1' : 'snap_done=1' ) ) );
		exit;
	}

	/**
	 * Render the wizard.
	 *
	 * @return void
	 */
	public static function render_page(): void {
		if ( ! TMDO_Capability::current_user_can_admin() ) {
			wp_die( esc_html__( 'Insufficient permissions.', '2meet-data-optimizer' ) );
		}
		$step      = max( 1, min( self::TOTAL_STEPS, absint( wp_unslash( $_GET['step'] ?? 1 ) ) ) ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended
		$completed = '1' === get_option( self::OPT_COMPLETED );
		?>
		<div class="wrap wpdo-max-800">
			<p>
				<a href="<?php echo esc_url( admin_url( 'tools.php?page=wp-data-optimizer' ) ); ?>">
					&larr; <?php esc_html_e( '返回 WP Data Optimizer', '2meet-data-optimizer' ); ?>
				</a>
			</p>
			<h1><?php esc_html_e( 'WP Data Optimizer — 設定嚮導', '2meet-data-optimizer' ); ?></h1>

			<?php if ( $completed ) : ?>
			<div class="wpdo-setup-banner">
				<span>✅ <?php esc_html_e( '嚮導已完成。你可以重新瀏覽任何步驟，或重設為全新執行。', '2meet-data-optimizer' ); ?></span>
				<a class="button button-secondary wpdo-setup-banner-btn"
					href="<?php echo esc_url( wp_nonce_url( admin_url( 'admin-post.php?action=wpdo_wizard_reset' ), self::NONCE_NAME ) ); ?>"
					>
					<?php esc_html_e( '重新執行精靈', '2meet-data-optimizer' ); ?>
				</a>
			</div>
			<?php endif; ?>

			<p class="description">
				<?php esc_html_e( '第', '2meet-data-optimizer' ); ?>
				<strong><?php echo (int) $step; ?></strong> /
				<strong><?php echo (int) self::TOTAL_STEPS; ?></strong>
				<?php esc_html_e( '步', '2meet-data-optimizer' ); ?>
			</p>

			<div class="wpdo-setup-progress-track">
				<div class="wpdo-setup-progress-fill" style="--wpdo-progress-pct:<?php echo (int) ( $step / self::TOTAL_STEPS * 100 ); ?>%"></div>
			</div>

			<div class="card wpdo-setup-card-full">
				<?php call_user_func( array( __CLASS__, 'render_step_' . $step ) ); ?>
			</div>

			<p class="wpdo-mt-3">
				<a href="<?php echo esc_url( wp_nonce_url( admin_url( 'admin-post.php?action=wpdo_wizard_dismiss' ), self::NONCE_NAME ) ); ?>"
					class="wpdo-text-skip">
					<?php esc_html_e( '我熟悉了，跳過嚮導', '2meet-data-optimizer' ); ?>
				</a>
			</p>
		</div>
		<?php
	}

	// ─── steps ─────────────────────────────────────────────────────────

	/**
	 * Render wizard step 1: Welcome.
	 *
	 * @return void
	 */
	private static function render_step_1(): void {
		?>
		<h2><?php esc_html_e( '👋 歡迎使用 WP Data Optimizer', '2meet-data-optimizer' ); ?></h2>
		<p><?php esc_html_e( 'WPDO 解決的是 wp_postmeta 表「meta 爆炸」問題：當 postmeta 累積到數百萬行時，autoload 變大、JOIN 變慢、整站變慢。', '2meet-data-optimizer' ); ?></p>

		<h3><?php esc_html_e( '4 個 Zone 是什麼？', '2meet-data-optimizer' ); ?></h3>
		<table class="widefat wpdo-mb-2">
			<thead>
				<tr><th>Zone</th><th><?php esc_html_e( '用途', '2meet-data-optimizer' ); ?></th><th><?php esc_html_e( '舉例', '2meet-data-optimizer' ); ?></th></tr>
			</thead>
			<tbody>
				<tr><td><strong>Hot</strong></td><td><?php esc_html_e( '高頻 + 索引欄位', '2meet-data-optimizer' ); ?></td><td><?php esc_html_e( 'price, location, vendor_id', '2meet-data-optimizer' ); ?></td></tr>
				<tr><td><strong>Warm</strong></td><td><?php esc_html_e( 'TTL 暫存（會過期）', '2meet-data-optimizer' ); ?></td><td><?php esc_html_e( 'view_count, last_seen', '2meet-data-optimizer' ); ?></td></tr>
				<tr><td><strong>Cold</strong></td><td><?php esc_html_e( '低頻設定型欄位', '2meet-data-optimizer' ); ?></td><td><?php esc_html_e( 'preferences, settings', '2meet-data-optimizer' ); ?></td></tr>
				<tr><td><strong>Archive</strong></td><td><?php esc_html_e( '舊資料 / 已 trashed', '2meet-data-optimizer' ); ?></td><td><?php esc_html_e( '90+ 天前的記錄', '2meet-data-optimizer' ); ?></td></tr>
			</tbody>
		</table>

		<h3><?php esc_html_e( '何時需要 WPDO？', '2meet-data-optimizer' ); ?></h3>
		<ul class="wpdo-list-disc">
			<li><?php esc_html_e( '✅ wp_postmeta 行數 > 100k 開始考慮', '2meet-data-optimizer' ); ?></li>
			<li><?php esc_html_e( '✅ 行數 > 1M 強烈建議啟用', '2meet-data-optimizer' ); ?></li>
			<li><?php esc_html_e( '⚠️ 小站台（< 10k 行）可以裝著但別啟用 module', '2meet-data-optimizer' ); ?></li>
		</ul>

		<form method="get" action="<?php echo esc_url( admin_url( 'tools.php' ) ); ?>" class="wpdo-mt-3">
			<input type="hidden" name="page" value="wpdo-setup-wizard">
			<input type="hidden" name="step" value="2">
			<button class="button button-primary button-hero"><?php esc_html_e( '下一步：跑健診 →', '2meet-data-optimizer' ); ?></button>
		</form>
		<?php
	}

	/**
	 * Render wizard step 2: Baseline diagnostic.
	 *
	 * @return void
	 */
	private static function render_step_2(): void {
		global $wpdb;
		$pm_count       = (int) $wpdb->get_var( "SELECT COUNT(*) FROM `{$wpdb->postmeta}`" ); // phpcs:ignore WordPress.DB
		$autoload_bytes = (int) $wpdb->get_var( "SELECT COALESCE(SUM(LENGTH(option_value)),0) FROM `{$wpdb->options}` WHERE autoload = 'yes'" ); // phpcs:ignore WordPress.DB
		$top_keys       = $wpdb->get_results( "SELECT meta_key, COUNT(*) AS c FROM `{$wpdb->postmeta}` GROUP BY meta_key ORDER BY c DESC LIMIT 10", ARRAY_A ); // phpcs:ignore WordPress.DB
		?>
		<h2><?php esc_html_e( '🔬 Baseline 健診', '2meet-data-optimizer' ); ?></h2>
		<table class="widefat striped wpdo-max-600 wpdo-mb-2">
			<tbody>
				<tr><th><?php esc_html_e( 'wp_postmeta 行數', '2meet-data-optimizer' ); ?></th><td><strong><?php echo esc_html( number_format_i18n( $pm_count ) ); ?></strong></td></tr>
				<tr><th><?php esc_html_e( 'autoload 大小', '2meet-data-optimizer' ); ?></th><td><strong><?php echo esc_html( size_format( $autoload_bytes, 1 ) ); ?></strong></td></tr>
				<tr><th><?php esc_html_e( '建議啟用 WPDO？', '2meet-data-optimizer' ); ?></th>
					<td>
						<?php if ( $pm_count > 1_000_000 ) : ?>
							<span class="wpdo-text-success-em">✅ <?php esc_html_e( '強烈建議', '2meet-data-optimizer' ); ?></span>
						<?php elseif ( $pm_count > 100_000 ) : ?>
							<span class="wpdo-text-warn-em">🟡 <?php esc_html_e( '可以考慮', '2meet-data-optimizer' ); ?></span>
						<?php else : ?>
							<span class="wpdo-text-neutral">⏸ <?php esc_html_e( '尚不必', '2meet-data-optimizer' ); ?></span>
						<?php endif; ?>
					</td>
				</tr>
			</tbody>
		</table>

		<h3><?php esc_html_e( 'Top 10 meta_key（依行數）', '2meet-data-optimizer' ); ?></h3>
		<table class="widefat striped">
			<thead><tr><th>meta_key</th><th><?php esc_html_e( '行數', '2meet-data-optimizer' ); ?></th></tr></thead>
			<tbody>
				<?php foreach ( (array) $top_keys as $k ) : ?>
					<tr><td><code><?php echo esc_html( (string) $k['meta_key'] ); ?></code></td><td><?php echo esc_html( number_format_i18n( (int) $k['c'] ) ); ?></td></tr>
				<?php endforeach; ?>
			</tbody>
		</table>

		<form method="get" action="<?php echo esc_url( admin_url( 'tools.php' ) ); ?>" class="wpdo-mt-3">
			<input type="hidden" name="page" value="wpdo-setup-wizard">
			<input type="hidden" name="step" value="3">
			<button class="button button-primary button-hero"><?php esc_html_e( '下一步：看建議 →', '2meet-data-optimizer' ); ?></button>
		</form>
		<?php
	}

	/**
	 * Render wizard step 3: Recommendations.
	 *
	 * @return void
	 */
	private static function render_step_3(): void {
		?>
		<h2><?php esc_html_e( '🧭 智能推薦', '2meet-data-optimizer' ); ?></h2>
		<p><?php esc_html_e( '系統依你的環境（plugin / post_type / 行數）自動偵測哪些 module 適合啟用。每筆建議含 confidence + reasons。', '2meet-data-optimizer' ); ?></p>

		<?php
		$actionable = array();
		if ( class_exists( 'TMDO_Module_Detector' ) ) {
			$actionable = TMDO_Module_Detector::get_actionable( 0.5 );
		}
		?>

		<?php if ( empty( $actionable ) ) : ?>
			<div class="notice notice-info inline">
				<p><?php esc_html_e( '目前環境暫無高 confidence 的 module 建議。可隨時前往「模組建議」tab 重新檢查。', '2meet-data-optimizer' ); ?></p>
			</div>
		<?php else : ?>
			<h3>
			<?php
				printf(
					/* translators: %d: count */
					esc_html__( '✅ 偵測到 %d 個建議啟用的 module', '2meet-data-optimizer' ),
					count( $actionable )
				);
			?>
				</h3>
			<table class="widefat striped">
				<thead>
					<tr>
						<th><?php esc_html_e( 'Module', '2meet-data-optimizer' ); ?></th>
						<th><?php esc_html_e( 'Confidence', '2meet-data-optimizer' ); ?></th>
						<th><?php esc_html_e( '說明', '2meet-data-optimizer' ); ?></th>
					</tr>
				</thead>
				<tbody>
				<?php foreach ( $actionable as $module => $r ) : ?>
					<tr>
						<td><strong><code><?php echo esc_html( (string) $module ); ?></code></strong></td>
						<td><?php echo esc_html( sprintf( '%.2f', (float) $r['confidence'] ) ); ?></td>
						<td>
							<em><?php echo esc_html( (string) $r['description'] ); ?></em><br/>
							<small><?php echo esc_html( implode( ' · ', (array) $r['reasons'] ) ); ?></small>
						</td>
					</tr>
				<?php endforeach; ?>
				</tbody>
			</table>
			<p class="description"><?php esc_html_e( '完成 wizard 後，到「模組建議」tab 一鍵啟用（推進到 dual_write，FSM Guard 確保不越級）。', '2meet-data-optimizer' ); ?></p>
		<?php endif; ?>

		<h3><?php esc_html_e( '黃金法則', '2meet-data-optimizer' ); ?></h3>
		<ul class="wpdo-list-disc">
			<li><?php esc_html_e( '一次只推進 1 個 module，每階段觀察至少 24-48 小時。', '2meet-data-optimizer' ); ?></li>
			<li><?php esc_html_e( '進 cutover 前一定要有 snapshot（FSM Guard 自動觸發）。', '2meet-data-optimizer' ); ?></li>
			<li><?php esc_html_e( '出事第一件事：rewind 該 module 到 idle（emergency 流程）。', '2meet-data-optimizer' ); ?></li>
		</ul>

		<form method="get" action="<?php echo esc_url( admin_url( 'tools.php' ) ); ?>" class="wpdo-mt-3">
			<input type="hidden" name="page" value="wpdo-setup-wizard">
			<input type="hidden" name="step" value="4">
			<button class="button button-primary button-hero"><?php esc_html_e( '下一步：建第一個 snapshot →', '2meet-data-optimizer' ); ?></button>
		</form>
		<?php
	}

	/**
	 * Render wizard step 4: Snapshot + health check.
	 *
	 * @return void
	 */
	private static function render_step_4(): void {
		// On entry, take the first snapshot if not already done in this wizard run.
		$snapshot_taken = isset( $_GET['snap_done'] ) ? '1' === $_GET['snap_done'] : false; // phpcs:ignore WordPress.Security.NonceVerification.Recommended
		?>
		<h2><?php esc_html_e( '📸 第一個 Snapshot + Daily Health Check', '2meet-data-optimizer' ); ?></h2>

		<h3><?php esc_html_e( '📦 Snapshot', '2meet-data-optimizer' ); ?></h3>
		<?php if ( $snapshot_taken ) : ?>
			<p class="wpdo-text-success-em">✅ <?php esc_html_e( '快照已建立。可隨時於「備份快照」tab 查看與管理。', '2meet-data-optimizer' ); ?></p>
		<?php else : ?>
			<p><?php esc_html_e( '我們會建立一個 baseline snapshot，命名為 wizard_baseline，保留 365 天。即使你日後沒做任何 destructive 操作，這也是一個 known-good 還原點。', '2meet-data-optimizer' ); ?></p>
			<form method="post" action="<?php echo esc_url( admin_url( 'tools.php?page=wpdo-setup-wizard&step=4' ) ); ?>" class="wpdo-form-inline">
				<?php wp_nonce_field( self::NONCE_NAME ); ?>
				<input type="hidden" name="wpdo_take_snapshot" value="1">
				<p>
					<button type="submit" class="button button-secondary">
						<?php esc_html_e( '建立 baseline snapshot', '2meet-data-optimizer' ); ?>
					</button>
				</p>
			</form>
			<?php
			// The snapshot itself is taken in handle_snapshot_post(), before any output.
			if ( isset( $_GET['snap_failed'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended
				echo '<div class="notice notice-error"><p>' . esc_html__( 'Snapshot 建立失敗，請查日誌。', '2meet-data-optimizer' ) . '</p></div>';
			}
			?>
		<?php endif; ?>

		<h3><?php esc_html_e( '🔄 Daily Health Check', '2meet-data-optimizer' ); ?></h3>
		<p>
			<?php
			$next = wp_next_scheduled( 'wpdo_daily_health_check' );
			if ( $next ) {
				printf(
					/* translators: %s: human-readable timestamp */
					esc_html__( 'Daily cron 已排程，下次執行：%s（UTC）', '2meet-data-optimizer' ),
					'<code>' . esc_html( gmdate( 'Y-m-d H:i:s', $next ) ) . '</code>'
				);
			} else {
				esc_html_e( '⚠️ Daily cron 未排程；請重新啟用外掛。', '2meet-data-optimizer' );
			}
			?>
		</p>
		<p class="description"><?php esc_html_e( 'Cron 會跑 7 項 Site Health 檢查；critical 警告寫入 admin notice + audit log。', '2meet-data-optimizer' ); ?></p>

		<form method="get" action="<?php echo esc_url( admin_url( 'tools.php' ) ); ?>" class="wpdo-mt-3">
			<input type="hidden" name="page" value="wpdo-setup-wizard">
			<input type="hidden" name="step" value="5">
			<button class="button button-primary button-hero"><?php esc_html_e( '下一步：完成 →', '2meet-data-optimizer' ); ?></button>
		</form>
		<?php
	}

	/**
	 * Render wizard step 5: Done.
	 *
	 * @return void
	 */
	private static function render_step_5(): void {
		// Mark complete on render of step 5.
		update_option( self::OPT_COMPLETED, '1', false );
		if ( ! get_option( self::OPT_FIRST_RUN ) ) {
			update_option( self::OPT_FIRST_RUN, gmdate( 'Y-m-d H:i:s' ), false );
		}
		?>
		<h2><?php esc_html_e( '🎉 完成！', '2meet-data-optimizer' ); ?></h2>
		<p><?php esc_html_e( 'Setup wizard 已結束。下一步建議：', '2meet-data-optimizer' ); ?></p>

		<ul class="wpdo-list-disc">
			<li><a href="<?php echo esc_url( admin_url( 'tools.php?page=wp-data-optimizer&tab=entity-bridge' ) ); ?>"><?php esc_html_e( '🌉 看 Entity Bridge 健康卡片', '2meet-data-optimizer' ); ?></a> — <?php esc_html_e( 'user / post / term / comment 4 entity 即時健康+模式狀態', '2meet-data-optimizer' ); ?></li>
			<li><a href="<?php echo esc_url( admin_url( 'tools.php?page=wp-data-optimizer&tab=migration-wizard' ) ); ?>"><?php esc_html_e( '🪄 開 User / Post 遷移精靈', '2meet-data-optimizer' ); ?></a> — <?php esc_html_e( '一鍵推進 disabled → dual_write → shadow_read → aeav_only', '2meet-data-optimizer' ); ?></li>
			<li><a href="<?php echo esc_url( admin_url( 'tools.php?page=wp-data-optimizer&tab=classifier' ) ); ?>"><?php esc_html_e( '🔍 跑 Classifier', '2meet-data-optimizer' ); ?></a> — <?php esc_html_e( '看推薦 zone 配置', '2meet-data-optimizer' ); ?></li>
			<li><a href="<?php echo esc_url( admin_url( 'site-health.php' ) ); ?>"><?php esc_html_e( '🏥 WP Site Health', '2meet-data-optimizer' ); ?></a> — <?php esc_html_e( '7 個 WPDO 健康檢查', '2meet-data-optimizer' ); ?></li>
		</ul>

		<p class="wpdo-mt-3">
			<a class="button button-primary button-hero" href="<?php echo esc_url( admin_url( 'tools.php?page=wp-data-optimizer' ) ); ?>">
				<?php esc_html_e( '前往 WPDO 儀表板', '2meet-data-optimizer' ); ?>
			</a>
		</p>
		<?php
	}

	// ─── form / dismiss handlers ──────────────────────────────────────

	/**
	 * Handle wizard step form submit.
	 *
	 * @return void
	 */
	public static function handle_step_submit(): void {
		// v2.13.3: capability check first (matches handle_dismiss / handle_reset
		// pattern; fixes L-AUTH-1). Reserved for future POST-based steps —
		// currently steps use GET nav so body is a no-op redirect.
		if ( ! TMDO_Capability::current_user_can_admin() ) {
			wp_die( esc_html__( 'Insufficient permissions.', '2meet-data-optimizer' ) );
		}
		check_admin_referer( self::NONCE_NAME );
		wp_safe_redirect( admin_url( 'tools.php?page=wpdo-setup-wizard&step=1' ) );
		exit;
	}

	/**
	 * Handle wizard dismiss action.
	 *
	 * @return void
	 */
	public static function handle_dismiss(): void {
		check_admin_referer( self::NONCE_NAME );
		if ( TMDO_Capability::current_user_can_admin() ) {
			update_option( self::OPT_COMPLETED, '1', false );
			update_option( self::OPT_FIRST_RUN, gmdate( 'Y-m-d H:i:s' ), false );
		}
		wp_safe_redirect( admin_url( 'tools.php?page=wp-data-optimizer' ) );
		exit;
	}

	/**
	 * Handle wizard reset — clears OPT_COMPLETED so wizard reruns from step 1.
	 *
	 * @return void
	 */
	public static function handle_reset(): void {
		check_admin_referer( self::NONCE_NAME );
		if ( TMDO_Capability::current_user_can_admin() ) {
			update_option( self::OPT_COMPLETED, '0', false );
		}
		wp_safe_redirect( admin_url( 'tools.php?page=wpdo-setup-wizard&step=1' ) );
		exit;
	}
}