<?php
/**
 * Central Module Controller, Enterprise Admin Workspace & Editor Metabox Manager.
 *
 * Orchestrates conditional zero-bloat module loading, provides static CRUD helpers
 * for the `wp_modulustools_meta` custom table with in-memory caching, and renders the
 * Admin Dashboard, Bulk Quick-Editor Grid, Site Audit, Local SEO, Role Manager,
 * and Editor Metabox.
 *
 * @package ModulusTools\SEO
 */

namespace ModulusTools\SEO;

use ModulusTools\SEO\API\REST_Controller;
use ModulusTools\SEO\Modules\Frontend_Head;
use ModulusTools\SEO\Modules\Schema_Graph;
use ModulusTools\SEO\Modules\Sitemaps;
use ModulusTools\SEO\Modules\Redirects_404;
use ModulusTools\SEO\Modules\GEO_LLMs;
use ModulusTools\SEO\Modules\AI_BYOK;
use ModulusTools\SEO\Modules\Image_SEO;
use ModulusTools\SEO\Modules\Link_Assistant;
use ModulusTools\SEO\Modules\Migrator;

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

/**
 * Class Core
 */
class Core {

	/**
	 * Singleton instance.
	 *
	 * @var Core|null
	 */
	private static ?Core $instance = null;

	/**
	 * Active module instances.
	 *
	 * @var array<string, object>
	 */
	private array $loaded_modules = array();

	/**
	 * In-memory request cache for `wp_modulustools_meta` rows.
	 *
	 * @var array<string, object|null>
	 */
	private static array $meta_cache = array();

	/**
	 * Retrieves singleton instance.
	 *
	 * @return Core
	 */
	public static function get_instance(): Core {
		if ( null === self::$instance ) {
			self::$instance = new self();
		}
		return self::$instance;
	}

	/**
	 * Constructor.
	 */
	private function __construct() {
		$this->boot_enabled_modules();
		$this->register_core_hooks();
	}

	/**
	 * Returns all available modules and their metadata.
	 *
	 * @return array<string, array<string, string>>
	 */
	public static function get_available_modules(): array {
		return array(
			'frontend_head'  => array(
				'title'       => __( 'On-Page Meta, OpenGraph & Breadcrumbs', 'modulustools-seo-suite' ),
				'description' => __( 'Title rewrites, meta descriptions, canonicals, robots directives, social cards, RSS attribution, and breadcrumbs.', 'modulustools-seo-suite' ),
				'badge'       => __( 'Core SEO', 'modulustools-seo-suite' ),
			),
			'schema_graph'   => array(
				'title'       => __( 'Unified JSON-LD Schema, Merchant & E-E-A-T', 'modulustools-seo-suite' ),
				'description' => __( 'Deduplicated @graph supporting Article, Product (GTIN, MPN, Brand, ReturnPolicy), FAQPage, LocalBusiness, and Author E-E-A-T.', 'modulustools-seo-suite' ),
				'badge'       => __( 'Structured Data', 'modulustools-seo-suite' ),
			),
			'sitemaps'       => array(
				'title'       => __( 'XML / News / Video / HTML Sitemaps & IndexNow', 'modulustools-seo-suite' ),
				'description' => __( 'Serves /sitemap_index.xml, /news-sitemap.xml, /video-sitemap.xml, [modulustools_html_sitemap], and IndexNow notifications.', 'modulustools-seo-suite' ),
				'badge'       => __( 'Technical SEO', 'modulustools-seo-suite' ),
			),
			'redirects_404'  => array(
				'title'       => __( 'Regex Redirects, Slug Watcher & 404 Monitor', 'modulustools-seo-suite' ),
				'description' => __( '301/302/307/410/451 redirects, automatic slug-change protection, and privacy-hashed 404 logging with 1-click redirect creation.', 'modulustools-seo-suite' ),
				'badge'       => __( 'Technical SEO', 'modulustools-seo-suite' ),
			),
			'geo_llms'       => array(
				'title'       => __( 'GEO /llms.txt Router & AI Bot Firewall', 'modulustools-seo-suite' ),
				'description' => __( 'Serves /llms.txt and /llms-full.txt prioritizing Pillar Content, manages AI bot rules in robots.txt, and logs crawler visits.', 'modulustools-seo-suite' ),
				'badge'       => __( 'GEO / AI Search', 'modulustools-seo-suite' ),
			),
			'ai_byok'        => array(
				'title'       => __( 'WordPress Core AI Client & Content Assistant', 'modulustools-seo-suite' ),
				'description' => __( 'Integrates with the WordPress Core AI Client, custom gateway endpoints, or local NLP heuristics for 1-click title, meta, and FAQ drafting.', 'modulustools-seo-suite' ),
				'badge'       => __( 'Automation', 'modulustools-seo-suite' ),
			),
			'image_seo'      => array(
				'title'       => __( 'Dynamic Image Alt & Title Automation', 'modulustools-seo-suite' ),
				'description' => __( 'Populates missing alt, title, and async decoding attributes dynamically on front-end render using customizable variable templates.', 'modulustools-seo-suite' ),
				'badge'       => __( 'Automation', 'modulustools-seo-suite' ),
			),
			'link_assistant' => array(
				'title'       => __( 'Topical Cluster Graph & Orphan Detector', 'modulustools-seo-suite' ),
				'description' => __( 'Tracks inbound/outbound internal links, prioritizes Pillar Content, surfaces Orphan Pages, and suggests contextual anchor links.', 'modulustools-seo-suite' ),
				'badge'       => __( 'Internal Links', 'modulustools-seo-suite' ),
			),
			'migrator'       => array(
				'title'       => __( 'Metadata Importer & JSON Snapshot', 'modulustools-seo-suite' ),
				'description' => __( 'Batch imports existing SEO metadata into custom tables and provides 1-click JSON configuration export and restore.', 'modulustools-seo-suite' ),
				'badge'       => __( 'System Utility', 'modulustools-seo-suite' ),
			),
		);
	}

	/**
	 * Checks whether a specific module is enabled.
	 *
	 * @param string $module_key Module slug.
	 * @return bool
	 */
	public static function is_module_enabled( string $module_key ): bool {
		$modules = get_option( 'modulustools_seo_modules', array() );
		if ( ! is_array( $modules ) || ! array_key_exists( $module_key, $modules ) ) {
			return true;
		}
		return (bool) $modules[ $module_key ];
	}

	/**
	 * Checks if the current user's role is permitted to access a specific capability group.
	 *
	 * @param string $group 'metabox' or 'redirects'.
	 * @return bool
	 */
	public static function user_has_role_access( string $group = 'metabox' ): bool {
		if ( current_user_can( 'manage_options' ) ) {
			return true;
		}
		$user = wp_get_current_user();
		if ( ! $user || empty( $user->roles ) ) {
			return false;
		}
		$settings = get_option( 'modulustools_seo_settings', array() );
		$key      = 'redirects' === $group ? 'allowed_roles_redirects' : 'allowed_roles_metabox';
		$allowed  = isset( $settings[ $key ] ) && is_array( $settings[ $key ] )
			? $settings[ $key ]
			: array( 'administrator', 'editor', 'author' );

		foreach ( $user->roles as $role ) {
			if ( in_array( $role, $allowed, true ) ) {
				return true;
			}
		}
		return false;
	}

	/**
	 * Instantiates only enabled modules.
	 *
	 * @return void
	 */
	private function boot_enabled_modules(): void {
		if ( get_option( 'modulustools_seo_db_version' ) !== MODULUSTOOLS_SEO_DB_VERSION ) {
			Activator::create_tables();
		}

		$module_map = array(
			'frontend_head'  => Frontend_Head::class,
			'schema_graph'   => Schema_Graph::class,
			'sitemaps'       => Sitemaps::class,
			'redirects_404'  => Redirects_404::class,
			'geo_llms'       => GEO_LLMs::class,
			'ai_byok'        => AI_BYOK::class,
			'image_seo'      => Image_SEO::class,
			'link_assistant' => Link_Assistant::class,
			'migrator'       => Migrator::class,
		);

		foreach ( $module_map as $key => $class_name ) {
			if ( self::is_module_enabled( $key ) && class_exists( $class_name ) ) {
				$this->loaded_modules[ $key ] = new $class_name();
			}
		}

		$this->loaded_modules['rest_api'] = new REST_Controller();
	}

	/**
	 * Registers admin menus, metaboxes, post save hooks, and asset loaders.
	 *
	 * @return void
	 */
	private function register_core_hooks(): void {
		add_action( 'admin_menu', array( $this, 'register_admin_menu' ) );
		add_action( 'admin_init', array( $this, 'handle_admin_form_submissions' ) );
		add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_admin_assets' ) );
		add_action( 'add_meta_boxes', array( $this, 'register_seo_metabox' ) );
		add_action( 'save_post', array( $this, 'save_post_seo_meta' ), 10, 2 );

		add_filter( 'manage_post_posts_columns', array( $this, 'add_seo_columns' ) );
		add_filter( 'manage_page_posts_columns', array( $this, 'add_seo_columns' ) );
		add_action( 'manage_post_posts_custom_column', array( $this, 'render_seo_column' ), 10, 2 );
		add_action( 'manage_page_posts_custom_column', array( $this, 'render_seo_column' ), 10, 2 );
	}

	/**
	 * Retrieves custom SEO metadata row from `wp_modulustools_meta` with static caching.
	 *
	 * @param int    $object_id   Post ID or Term ID.
	 * @param string $object_type 'post' or 'term'.
	 * @return object|null
	 */
	public static function get_meta( int $object_id, string $object_type = 'post' ): ?object {
		if ( $object_id <= 0 ) {
			return null;
		}

		$cache_key = $object_type . ':' . $object_id;
		if ( array_key_exists( $cache_key, self::$meta_cache ) ) {
			return self::$meta_cache[ $cache_key ];
		}

		global $wpdb;

		// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, PluginCheck.Security.DirectDB.UnescapedDBParameter
		$row = $wpdb->get_row(
			$wpdb->prepare(
				'SELECT * FROM %i WHERE object_id = %d AND object_type = %s LIMIT 1',
				$wpdb->prefix . 'modulustools_meta',
				$object_id,
				$object_type
			)
		);

		self::$meta_cache[ $cache_key ] = $row ? $row : null;
		return self::$meta_cache[ $cache_key ];
	}

	/**
	 * Inserts or updates a row in `wp_modulustools_meta`.
	 *
	 * @param int                  $object_id   Post ID or Term ID.
	 * @param string               $object_type 'post' or 'term'.
	 * @param array<string, mixed> $data        Associative array of column values.
	 * @return bool
	 */
	public static function save_meta( int $object_id, string $object_type, array $data ): bool {
		if ( $object_id <= 0 ) {
			return false;
		}

		global $wpdb;
		$table    = $wpdb->prefix . 'modulustools_meta';
		$existing = self::get_meta( $object_id, $object_type );

		$focus_kw = isset( $data['focus_keyword'] ) ? sanitize_text_field( (string) $data['focus_keyword'] ) : ( $existing->focus_keyword ?? '' );
		$kw_type  = self::classify_keyword_type( $focus_kw );

		$record = array(
			'object_id'            => $object_id,
			'object_type'          => sanitize_key( $object_type ),
			'title'                => isset( $data['title'] ) ? sanitize_text_field( (string) $data['title'] ) : ( $existing->title ?? '' ),
			'description'          => isset( $data['description'] ) ? sanitize_textarea_field( (string) $data['description'] ) : ( $existing->description ?? '' ),
			'focus_keyword'        => $focus_kw,
			'keyword_type'         => $kw_type,
			'secondary_keywords'   => isset( $data['secondary_keywords'] ) ? sanitize_text_field( (string) $data['secondary_keywords'] ) : ( $existing->secondary_keywords ?? '' ),
			'lsi_keywords'         => isset( $data['lsi_keywords'] ) ? sanitize_text_field( (string) $data['lsi_keywords'] ) : ( $existing->lsi_keywords ?? '' ),
			'canonical_url'        => isset( $data['canonical_url'] ) ? esc_url_raw( (string) $data['canonical_url'] ) : ( $existing->canonical_url ?? '' ),
			'robots_index'         => isset( $data['robots_index'] ) && in_array( $data['robots_index'], array( 'index', 'noindex' ), true ) ? $data['robots_index'] : ( $existing->robots_index ?? 'index' ),
			'robots_follow'        => isset( $data['robots_follow'] ) && in_array( $data['robots_follow'], array( 'follow', 'nofollow' ), true ) ? $data['robots_follow'] : ( $existing->robots_follow ?? 'follow' ),
			'robots_advanced'      => isset( $data['robots_advanced'] ) ? sanitize_text_field( (string) $data['robots_advanced'] ) : ( $existing->robots_advanced ?? 'max-snippet:-1,max-image-preview:large,max-video-preview:-1' ),
			'og_title'             => isset( $data['og_title'] ) ? sanitize_text_field( (string) $data['og_title'] ) : ( $existing->og_title ?? '' ),
			'og_description'       => isset( $data['og_description'] ) ? sanitize_textarea_field( (string) $data['og_description'] ) : ( $existing->og_description ?? '' ),
			'og_image'             => isset( $data['og_image'] ) ? esc_url_raw( (string) $data['og_image'] ) : ( $existing->og_image ?? '' ),
			'schema_type'          => isset( $data['schema_type'] ) ? sanitize_text_field( (string) $data['schema_type'] ) : ( $existing->schema_type ?? 'Article' ),
			'product_brand'        => isset( $data['product_brand'] ) ? sanitize_text_field( (string) $data['product_brand'] ) : ( $existing->product_brand ?? '' ),
			'product_gtin'         => isset( $data['product_gtin'] ) ? sanitize_text_field( (string) $data['product_gtin'] ) : ( $existing->product_gtin ?? '' ),
			'product_mpn'          => isset( $data['product_mpn'] ) ? sanitize_text_field( (string) $data['product_mpn'] ) : ( $existing->product_mpn ?? '' ),
			'eeat_reviewed_by'     => isset( $data['eeat_reviewed_by'] ) ? sanitize_text_field( (string) $data['eeat_reviewed_by'] ) : ( $existing->eeat_reviewed_by ?? '' ),
			'eeat_citations'       => isset( $data['eeat_citations'] ) ? sanitize_textarea_field( (string) $data['eeat_citations'] ) : ( $existing->eeat_citations ?? '' ),
			'is_pillar'            => array_key_exists( 'is_pillar', $data ) ? (int) (bool) $data['is_pillar'] : (int) ( $existing->is_pillar ?? 0 ),
			'seo_score'            => isset( $data['seo_score'] ) ? min( 100, absint( $data['seo_score'] ) ) : (int) ( $existing->seo_score ?? 0 ),
			'readability_score'    => isset( $data['readability_score'] ) ? min( 100, absint( $data['readability_score'] ) ) : (int) ( $existing->readability_score ?? 0 ),
			'geo_score'            => isset( $data['geo_score'] ) ? min( 100, absint( $data['geo_score'] ) ) : (int) ( $existing->geo_score ?? 0 ),
			'sge_ready'            => isset( $data['sge_ready'] ) ? (int) (bool) $data['sge_ready'] : (int) ( $existing->sge_ready ?? 0 ),
			'inbound_links_count'  => isset( $data['inbound_links_count'] ) ? absint( $data['inbound_links_count'] ) : (int) ( $existing->inbound_links_count ?? 0 ),
			'outbound_links_count' => isset( $data['outbound_links_count'] ) ? absint( $data['outbound_links_count'] ) : (int) ( $existing->outbound_links_count ?? 0 ),
			'external_links_count' => isset( $data['external_links_count'] ) ? absint( $data['external_links_count'] ) : (int) ( $existing->external_links_count ?? 0 ),
			'updated_at'           => current_time( 'mysql' ),
		);

		$formats = array(
			'%d', '%s', '%s', '%s', '%s', '%s', '%s', '%s', '%s', '%s',
			'%s', '%s', '%s', '%s', '%s', '%s', '%s', '%s', '%s', '%s',
			'%s', '%d', '%d', '%d', '%d', '%d', '%d', '%d', '%d', '%s',
		);

		if ( $existing ) {
			// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, PluginCheck.Security.DirectDB.UnescapedDBParameter
			$result = $wpdb->update(
				$table,
				$record,
				array(
					'object_id'   => $object_id,
					'object_type' => $object_type,
				),
				$formats,
				array( '%d', '%s' )
			);
		} else {
			// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, PluginCheck.Security.DirectDB.UnescapedDBParameter
			$result = $wpdb->insert( $table, $record, $formats );
		}

		unset( self::$meta_cache[ $object_type . ':' . $object_id ] );
		return false !== $result;
	}

	/**
	 * Classifies a focus keyword into Head Term, Body Keyword, or Long-Tail Keyword.
	 *
	 * @param string $keyword Target focus query.
	 * @return string 'head', 'body', or 'long_tail'.
	 */
	public static function classify_keyword_type( string $keyword ): string {
		$trimmed = trim( $keyword );
		if ( '' === $trimmed ) {
			return 'none';
		}
		$words = preg_split( '/\s+/', $trimmed );
		$count = is_array( $words ) ? count( $words ) : 1;

		if ( $count <= 2 ) {
			return 'head';
		}
		if ( $count <= 4 ) {
			return 'body';
		}
		return 'long_tail';
	}

	/**
	 * Registers the top-level ModulusTools SEO Suite admin menu.
	 *
	 * @return void
	 */
	public function register_admin_menu(): void {
		add_menu_page(
			__( 'ModulusTools SEO Suite', 'modulustools-seo-suite' ),
			__( 'ModulusTools SEO', 'modulustools-seo-suite' ),
			'manage_options',
			'modulustools-seo-suite',
			array( $this, 'render_admin_dashboard' ),
			'dashicons-chart-area',
			58
		);
	}

	/**
	 * Enqueues admin CSS and JS on ModulusTools SEO admin screens and post editors.
	 *
	 * @param string $hook Current admin page hook suffix.
	 * @return void
	 */
	public function enqueue_admin_assets( string $hook ): void {
		$allowed_hooks = array( 'toplevel_page_modulustools-seo-suite', 'post.php', 'post-new.php', 'profile.php', 'user-edit.php' );
		if ( ! in_array( $hook, $allowed_hooks, true ) ) {
			return;
		}

		wp_enqueue_style(
			'modulustools-seo-admin',
			MODULUSTOOLS_SEO_URL . 'assets/css/admin-style.css',
			array(),
			MODULUSTOOLS_SEO_VERSION
		);

		wp_enqueue_script(
			'modulustools-seo-admin',
			MODULUSTOOLS_SEO_URL . 'assets/js/admin-app.js',
			array( 'wp-api-fetch' ),
			MODULUSTOOLS_SEO_VERSION,
			true
		);

		$current_post_id = isset( $_GET['post'] ) ? absint( $_GET['post'] ) : 0; // phpcs:ignore WordPress.Security.NonceVerification.Recommended
		wp_localize_script(
			'modulustools-seo-admin',
			'modulustoolsAdminData',
			array(
				'restUrl'   => esc_url_raw( rest_url( 'modulustools-seo/v1/' ) ),
				'nonce'     => wp_create_nonce( 'wp_rest' ),
				'postId'    => $current_post_id,
				'siteName'  => get_bloginfo( 'name' ),
				'siteUrl'   => home_url( '/' ),
				'separator' => get_option( 'modulustools_seo_settings', array() )['title_separator'] ?? '-',
				'i18n'      => array(
					'headTerm'     => __( 'HEAD TERM', 'modulustools-seo-suite' ),
					'bodyKeyword'  => __( 'BODY KEYWORD', 'modulustools-seo-suite' ),
					'longTail'     => __( 'LONG-TAIL QUERY', 'modulustools-seo-suite' ),
					'sgePass'      => __( 'Verified: 40–60 word inverted-pyramid Direct Answer block detected under a question heading.', 'modulustools-seo-suite' ),
					'sgeFail'      => __( 'Recommendation: Place a 40–60 word direct answer paragraph immediately below an H2/H3 question heading.', 'modulustools-seo-suite' ),
					'generating'   => __( 'Processing...', 'modulustools-seo-suite' ),
					'cannibalWarn' => __( 'Competing URL targeting this primary keyword:', 'modulustools-seo-suite' ),
				),
			)
		);
	}

	/**
	 * Handles standard admin form submissions.
	 *
	 * @return void
	 */
	public function handle_admin_form_submissions(): void {
		if ( ! isset( $_POST['modulustools_action'] ) ) {
			return;
		}

		if ( ! current_user_can( 'manage_options' ) ) {
			wp_die( esc_html__( 'You do not have permission to perform this action.', 'modulustools-seo-suite' ) );
		}

		$action = sanitize_key( wp_unslash( $_POST['modulustools_action'] ) );

		if ( 'save_general_settings' === $action ) {
			check_admin_referer( 'modulustools_save_settings_action', 'modulustools_settings_nonce' );

			$settings = get_option( 'modulustools_seo_settings', array() );

			$settings['title_separator']           = isset( $_POST['title_separator'] ) ? sanitize_text_field( wp_unslash( $_POST['title_separator'] ) ) : '-';
			$settings['organization_name']         = isset( $_POST['organization_name'] ) ? sanitize_text_field( wp_unslash( $_POST['organization_name'] ) ) : get_bloginfo( 'name' );
			$settings['organization_logo']         = isset( $_POST['organization_logo'] ) ? esc_url_raw( wp_unslash( $_POST['organization_logo'] ) ) : '';
			$settings['default_schema_type']       = isset( $_POST['default_schema_type'] ) ? sanitize_text_field( wp_unslash( $_POST['default_schema_type'] ) ) : 'Article';
			$settings['image_alt_template']        = isset( $_POST['image_alt_template'] ) ? sanitize_text_field( wp_unslash( $_POST['image_alt_template'] ) ) : '%post_title% - %site_name%';
			$settings['image_title_template']      = isset( $_POST['image_title_template'] ) ? sanitize_text_field( wp_unslash( $_POST['image_title_template'] ) ) : '%post_title%';
			$settings['auto_redirect_slug_change'] = ! empty( $_POST['auto_redirect_slug_change'] );
			$settings['enable_indexnow']           = ! empty( $_POST['enable_indexnow'] );
			$settings['clean_wp_head']             = ! empty( $_POST['clean_wp_head'] );
			$settings['indexnow_webhook_url']      = isset( $_POST['indexnow_webhook_url'] ) ? esc_url_raw( wp_unslash( $_POST['indexnow_webhook_url'] ) ) : '';
			$settings['llms_txt_intro']            = isset( $_POST['llms_txt_intro'] ) ? sanitize_textarea_field( wp_unslash( $_POST['llms_txt_intro'] ) ) : '';
			$settings['custom_robots_rules']       = isset( $_POST['custom_robots_rules'] ) ? sanitize_textarea_field( wp_unslash( $_POST['custom_robots_rules'] ) ) : '';
			$settings['delete_data_on_uninstall']  = ! empty( $_POST['delete_data_on_uninstall'] );

			if ( isset( $_POST['ai_bots_rules'] ) && is_array( $_POST['ai_bots_rules'] ) ) {
				$raw_rules   = wp_unslash( $_POST['ai_bots_rules'] ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
				$clean_rules = array();
				foreach ( $raw_rules as $bot => $directive ) {
					$clean_bot                 = sanitize_text_field( (string) $bot );
					$clean_dir                 = ( 'disallow' === $directive ) ? 'disallow' : 'allow';
					$clean_rules[ $clean_bot ] = $clean_dir;
				}
				$settings['ai_bots_rules'] = $clean_rules;
			}

			update_option( 'modulustools_seo_settings', $settings );
			delete_transient( 'modulustools_seo_llms_txt_cache' );
			delete_transient( 'modulustools_seo_llms_full_cache' );

			wp_safe_redirect( add_query_arg( array( 'page' => 'modulustools-seo-suite', 'tab' => 'settings', 'updated' => 'true' ), admin_url( 'admin.php' ) ) );
			exit;
		}

		if ( 'save_local_rss_settings' === $action ) {
			check_admin_referer( 'modulustools_save_local_action', 'modulustools_local_nonce' );
			$settings = get_option( 'modulustools_seo_settings', array() );

			$fields = array(
				'local_business_type', 'local_phone', 'local_price_range', 'local_street',
				'local_city', 'local_region', 'local_postal', 'local_country',
				'local_lat', 'local_lng', 'local_opening_hours',
				'rss_before_content', 'rss_after_content',
			);
			foreach ( $fields as $f ) {
				if ( isset( $_POST[ $f ] ) ) {
					$settings[ $f ] = sanitize_text_field( wp_unslash( $_POST[ $f ] ) );
				}
			}

			if ( isset( $_POST['allowed_roles_metabox'] ) && is_array( $_POST['allowed_roles_metabox'] ) ) {
				$settings['allowed_roles_metabox'] = array_map( 'sanitize_key', wp_unslash( $_POST['allowed_roles_metabox'] ) );
			}
			if ( isset( $_POST['allowed_roles_redirects'] ) && is_array( $_POST['allowed_roles_redirects'] ) ) {
				$settings['allowed_roles_redirects'] = array_map( 'sanitize_key', wp_unslash( $_POST['allowed_roles_redirects'] ) );
			}

			update_option( 'modulustools_seo_settings', $settings );
			wp_safe_redirect( add_query_arg( array( 'page' => 'modulustools-seo-suite', 'tab' => 'local-roles', 'updated' => 'true' ), admin_url( 'admin.php' ) ) );
			exit;
		}

		if ( 'save_ai_settings' === $action ) {
			check_admin_referer( 'modulustools_save_ai_action', 'modulustools_ai_nonce' );

			$provider   = isset( $_POST['ai_provider'] ) ? sanitize_key( wp_unslash( $_POST['ai_provider'] ) ) : 'wp_core';
			$model      = isset( $_POST['ai_model'] ) ? sanitize_text_field( wp_unslash( $_POST['ai_model'] ) ) : 'default';
			$custom_url = isset( $_POST['ai_custom_endpoint'] ) ? esc_url_raw( wp_unslash( $_POST['ai_custom_endpoint'] ) ) : '';
			$raw_key    = isset( $_POST['ai_api_key'] ) ? trim( sanitize_text_field( wp_unslash( $_POST['ai_api_key'] ) ) ) : '';

			AI_BYOK::save_credentials( $provider, $model, $raw_key, $custom_url );

			wp_safe_redirect( add_query_arg( array( 'page' => 'modulustools-seo-suite', 'tab' => 'ai-byok', 'updated' => 'true' ), admin_url( 'admin.php' ) ) );
			exit;
		}

		if ( 'export_settings_json' === $action ) {
			check_admin_referer( 'modulustools_export_json_action', 'modulustools_export_nonce' );
			$export = array(
				'plugin'     => 'modulustools-seo-suite',
				'version'    => MODULUSTOOLS_SEO_VERSION,
				'exportedAt' => gmdate( DATE_W3C ),
				'modules'    => get_option( 'modulustools_seo_modules', array() ),
				'settings'   => get_option( 'modulustools_seo_settings', array() ),
			);
			nocache_headers();
			header( 'Content-Disposition: attachment; filename="modulustools-seo-settings-' . gmdate( 'Y-m-d' ) . '.json"' );
			wp_send_json( $export );
		}

		if ( 'import_settings_json' === $action ) {
			check_admin_referer( 'modulustools_import_json_action', 'modulustools_import_nonce' );
			$raw_json = isset( $_POST['modulustools_import_payload'] ) ? wp_unslash( $_POST['modulustools_import_payload'] ) : ''; // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
			$decoded  = json_decode( (string) $raw_json, true );
			if ( is_array( $decoded ) && isset( $decoded['plugin'] ) && 'modulustools-seo-suite' === $decoded['plugin'] ) {
				if ( isset( $decoded['modules'] ) && is_array( $decoded['modules'] ) ) {
					$clean_mods = array();
					foreach ( $decoded['modules'] as $mk => $mv ) {
						$clean_mods[ sanitize_key( (string) $mk ) ] = (bool) $mv;
					}
					update_option( 'modulustools_seo_modules', $clean_mods );
				}
				if ( isset( $decoded['settings'] ) && is_array( $decoded['settings'] ) ) {
					$current_settings = get_option( 'modulustools_seo_settings', array() );
					foreach ( $decoded['settings'] as $sk => $sv ) {
						if ( is_scalar( $sv ) ) {
							$current_settings[ sanitize_key( (string) $sk ) ] = sanitize_text_field( (string) $sv );
						}
					}
					update_option( 'modulustools_seo_settings', $current_settings );
				}
			}
			wp_safe_redirect( add_query_arg( array( 'page' => 'modulustools-seo-suite', 'tab' => 'migrator', 'updated' => 'true' ), admin_url( 'admin.php' ) ) );
			exit;
		}
	}

	/**
	 * Registers the Semantic SEO & GEO Metabox on all public post types.
	 *
	 * @return void
	 */
	public function register_seo_metabox(): void {
		if ( ! self::user_has_role_access( 'metabox' ) ) {
			return;
		}
		$post_types = get_post_types( array( 'public' => true ), 'names' );
		foreach ( $post_types as $post_type ) {
			add_meta_box(
				'modulustools_seo_metabox',
				__( 'ModulusTools SEO — Search & Generative Engine Optimization', 'modulustools-seo-suite' ),
				array( $this, 'render_seo_metabox' ),
				$post_type,
				'normal',
				'high'
			);
		}
	}

	/**
	 * Renders the Gutenberg & Classic Editor Metabox UI.
	 *
	 * @param \WP_Post $post Current post object.
	 * @return void
	 */
	public function render_seo_metabox( \WP_Post $post ): void {
		wp_nonce_field( 'modulustools_save_post_meta', 'modulustools_meta_nonce' );
		$meta = self::get_meta( (int) $post->ID, 'post' );

		$title              = $meta->title ?? '';
		$description        = $meta->description ?? '';
		$focus_keyword      = $meta->focus_keyword ?? '';
		$keyword_type       = $meta->keyword_type ?? 'none';
		$secondary_keywords = $meta->secondary_keywords ?? '';
		$lsi_keywords       = $meta->lsi_keywords ?? '';
		$canonical_url      = $meta->canonical_url ?? '';
		$robots_index       = $meta->robots_index ?? 'index';
		$robots_follow      = $meta->robots_follow ?? 'follow';
		$og_title           = $meta->og_title ?? '';
		$og_description     = $meta->og_description ?? '';
		$og_image           = $meta->og_image ?? '';
		$schema_type        = $meta->schema_type ?? 'Article';
		$product_brand      = $meta->product_brand ?? '';
		$product_gtin       = $meta->product_gtin ?? '';
		$product_mpn        = $meta->product_mpn ?? '';
		$eeat_reviewed_by   = $meta->eeat_reviewed_by ?? '';
		$eeat_citations     = $meta->eeat_citations ?? '';
		$is_pillar          = (int) ( $meta->is_pillar ?? 0 );
		$seo_score          = (int) ( $meta->seo_score ?? 0 );
		$readability_score  = (int) ( $meta->readability_score ?? 0 );
		$geo_score          = (int) ( $meta->geo_score ?? 0 );
		$sge_ready          = (int) ( $meta->sge_ready ?? 0 );

		$link_suggestions = array();
		if ( self::is_module_enabled( 'link_assistant' ) && class_exists( Link_Assistant::class ) ) {
			$link_suggestions = Link_Assistant::get_contextual_suggestions( (int) $post->ID, $focus_keyword );
		}
		?>
		<div class="modulustools-metabox-wrap" data-post-id="<?php echo esc_attr( (string) $post->ID ); ?>">
			<div class="modulustools-score-strip">
				<div class="modulustools-score-pill">
					<svg class="modulustools-radial" viewBox="0 0 36 36">
						<path class="modulustools-radial-bg" d="M18 2.0845 a 15.9155 15.9155 0 0 1 0 31.831 a 15.9155 15.9155 0 0 1 0 -31.831" />
						<path id="modulustools-ring-seo" class="modulustools-radial-bar" stroke-dasharray="<?php echo esc_attr( (string) $seo_score ); ?>, 100" d="M18 2.0845 a 15.9155 15.9155 0 0 1 0 31.831 a 15.9155 15.9155 0 0 1 0 -31.831" />
					</svg>
					<div>
						<span class="modulustools-score-label"><?php esc_html_e( 'On-Page SEO', 'modulustools-seo-suite' ); ?></span>
						<strong id="modulustools-live-seo-score" class="modulustools-score-badge"><?php echo esc_html( (string) $seo_score ); ?> / 100</strong>
					</div>
					<input type="hidden" name="modulustools_meta[seo_score]" id="modulustools_input_seo_score" value="<?php echo esc_attr( (string) $seo_score ); ?>" />
				</div>

				<div class="modulustools-score-pill">
					<svg class="modulustools-radial" viewBox="0 0 36 36">
						<path class="modulustools-radial-bg" d="M18 2.0845 a 15.9155 15.9155 0 0 1 0 31.831 a 15.9155 15.9155 0 0 1 0 -31.831" />
						<path id="modulustools-ring-readability" class="modulustools-radial-bar" stroke-dasharray="<?php echo esc_attr( (string) $readability_score ); ?>, 100" d="M18 2.0845 a 15.9155 15.9155 0 0 1 0 31.831 a 15.9155 15.9155 0 0 1 0 -31.831" />
					</svg>
					<div>
						<span class="modulustools-score-label"><?php esc_html_e( 'Readability Index', 'modulustools-seo-suite' ); ?></span>
						<strong id="modulustools-live-readability-score" class="modulustools-score-badge"><?php echo esc_html( (string) $readability_score ); ?> / 100</strong>
					</div>
					<input type="hidden" name="modulustools_meta[readability_score]" id="modulustools_input_readability_score" value="<?php echo esc_attr( (string) $readability_score ); ?>" />
				</div>

				<div class="modulustools-score-pill">
					<svg class="modulustools-radial" viewBox="0 0 36 36">
						<path class="modulustools-radial-bg" d="M18 2.0845 a 15.9155 15.9155 0 0 1 0 31.831 a 15.9155 15.9155 0 0 1 0 -31.831" />
						<path id="modulustools-ring-geo" class="modulustools-radial-bar" stroke-dasharray="<?php echo esc_attr( (string) $geo_score ); ?>, 100" d="M18 2.0845 a 15.9155 15.9155 0 0 1 0 31.831 a 15.9155 15.9155 0 0 1 0 -31.831" />
					</svg>
					<div>
						<span class="modulustools-score-label"><?php esc_html_e( 'GEO / AI Readiness', 'modulustools-seo-suite' ); ?></span>
						<strong id="modulustools-live-geo-score" class="modulustools-score-badge"><?php echo esc_html( (string) $geo_score ); ?> / 100</strong>
					</div>
					<input type="hidden" name="modulustools_meta[geo_score]" id="modulustools_input_geo_score" value="<?php echo esc_attr( (string) $geo_score ); ?>" />
					<input type="hidden" name="modulustools_meta[sge_ready]" id="modulustools_input_sge_ready" value="<?php echo esc_attr( (string) $sge_ready ); ?>" />
				</div>

				<div class="modulustools-pillar-toggle">
					<label title="<?php esc_attr_e( 'Mark as Pillar / Cornerstone Content to prioritize in internal linking and /llms.txt', 'modulustools-seo-suite' ); ?>">
						<input type="checkbox" name="modulustools_meta[is_pillar]" value="1" <?php checked( 1, $is_pillar ); ?> />
						<span><?php esc_html_e( 'Pillar / Cornerstone Content', 'modulustools-seo-suite' ); ?></span>
					</label>
				</div>
			</div>

			<div class="modulustools-tabs-nav" role="tablist">
				<button type="button" class="modulustools-tab-btn active" data-tab="general"><?php esc_html_e( 'Search Snippet & Keywords', 'modulustools-seo-suite' ); ?></button>
				<button type="button" class="modulustools-tab-btn" data-tab="geo-ai"><?php esc_html_e( 'GEO & Direct Answer', 'modulustools-seo-suite' ); ?></button>
				<button type="button" class="modulustools-tab-btn" data-tab="social"><?php esc_html_e( 'OpenGraph & Social', 'modulustools-seo-suite' ); ?></button>
				<button type="button" class="modulustools-tab-btn" data-tab="schema-eeat"><?php esc_html_e( 'Schema, Merchant & E-E-A-T', 'modulustools-seo-suite' ); ?></button>
				<button type="button" class="modulustools-tab-btn" data-tab="links-tech"><?php esc_html_e( 'Links & Directives', 'modulustools-seo-suite' ); ?></button>
			</div>

			<div class="modulustools-tab-panel active" id="modulustools-tab-general">
				<div class="modulustools-grid-2">
					<div class="modulustools-field-group">
						<label for="modulustools_focus_keyword">
							<span><?php esc_html_e( 'Primary Target Keyword', 'modulustools-seo-suite' ); ?></span>
							<span id="modulustools-keyword-class-badge" class="modulustools-kw-badge"><?php echo esc_html( strtoupper( $keyword_type ) ); ?></span>
						</label>
						<input type="text" id="modulustools_focus_keyword" name="modulustools_meta[focus_keyword]" value="<?php echo esc_attr( $focus_keyword ); ?>" placeholder="<?php esc_attr_e( 'Enter primary search query...', 'modulustools-seo-suite' ); ?>" class="widefat" />
						<div id="modulustools-cannibalization-alert" class="modulustools-alert-warning" style="display:none;"></div>

						<label for="modulustools_secondary_keywords">
							<span><?php esc_html_e( 'Secondary Keywords (comma-separated)', 'modulustools-seo-suite' ); ?></span>
						</label>
						<input type="text" id="modulustools_secondary_keywords" name="modulustools_meta[secondary_keywords]" value="<?php echo esc_attr( $secondary_keywords ); ?>" placeholder="<?php esc_attr_e( 'core web vitals, schema markup, xml sitemap', 'modulustools-seo-suite' ); ?>" class="widefat" />

						<label for="modulustools_lsi_keywords">
							<span><?php esc_html_e( 'Semantic LSI Entities (comma-separated)', 'modulustools-seo-suite' ); ?></span>
							<button type="button" class="modulustools-inline-action modulustools-ai-btn" data-ai-task="lsi"><?php esc_html_e( 'Auto-Extract Entities', 'modulustools-seo-suite' ); ?></button>
						</label>
						<textarea id="modulustools_lsi_keywords" name="modulustools_meta[lsi_keywords]" rows="2" class="widefat" placeholder="<?php esc_attr_e( 'search console, structured data, crawl budget, canonical tag', 'modulustools-seo-suite' ); ?>"><?php echo esc_textarea( $lsi_keywords ); ?></textarea>

						<label for="modulustools_seo_title">
							<span><?php esc_html_e( 'SERP Title Tag', 'modulustools-seo-suite' ); ?></span>
							<span class="modulustools-field-actions">
								<span id="modulustools-title-counter" class="modulustools-char-count">0 / 60</span>
								<button type="button" class="modulustools-inline-action modulustools-ai-btn" data-ai-task="title"><?php esc_html_e( 'Draft Title', 'modulustools-seo-suite' ); ?></button>
							</span>
						</label>
						<input type="text" id="modulustools_seo_title" name="modulustools_meta[title]" value="<?php echo esc_attr( $title ); ?>" class="widefat" placeholder="<?php echo esc_attr( get_the_title( $post ) ); ?>" />

						<label for="modulustools_seo_description">
							<span><?php esc_html_e( 'Meta Description', 'modulustools-seo-suite' ); ?></span>
							<span class="modulustools-field-actions">
								<span id="modulustools-desc-counter" class="modulustools-char-count">0 / 160</span>
								<button type="button" class="modulustools-inline-action modulustools-ai-btn" data-ai-task="description"><?php esc_html_e( 'Draft Summary', 'modulustools-seo-suite' ); ?></button>
							</span>
						</label>
						<textarea id="modulustools_seo_description" name="modulustools_meta[description]" rows="3" class="widefat"><?php echo esc_textarea( $description ); ?></textarea>
					</div>

					<div class="modulustools-preview-column">
						<div class="modulustools-serp-header">
							<span class="modulustools-section-title"><?php esc_html_e( 'Search Result Snippet Preview', 'modulustools-seo-suite' ); ?></span>
							<div class="modulustools-device-toggle">
								<button type="button" class="modulustools-seg-btn modulustools-device-btn active" data-device="desktop"><?php esc_html_e( 'Desktop', 'modulustools-seo-suite' ); ?></button>
								<button type="button" class="modulustools-seg-btn modulustools-device-btn" data-device="mobile"><?php esc_html_e( 'Mobile', 'modulustools-seo-suite' ); ?></button>
							</div>
						</div>
						<div id="modulustools-serp-card" class="modulustools-serp-card desktop">
							<div class="modulustools-serp-byline">
								<span class="modulustools-serp-favicon"></span>
								<div>
									<div class="modulustools-serp-sitename"><?php echo esc_html( get_bloginfo( 'name' ) ); ?></div>
									<div class="modulustools-serp-url"><?php echo esc_url( get_permalink( $post ) ? get_permalink( $post ) : home_url( '/?p=' . $post->ID ) ); ?></div>
								</div>
							</div>
							<div id="modulustools-serp-title" class="modulustools-serp-title"><?php echo esc_html( $title ? $title : get_the_title( $post ) ); ?></div>
							<div id="modulustools-serp-desc" class="modulustools-serp-desc"><?php echo esc_html( $description ? $description : wp_trim_words( wp_strip_all_tags( $post->post_content ), 25 ) ); ?></div>
						</div>

						<div class="modulustools-section-title" style="margin-bottom:8px;"><?php esc_html_e( 'On-Page & Readability Diagnostics', 'modulustools-seo-suite' ); ?></div>
						<ul id="modulustools-checklist" class="modulustools-checklist">
							<li><?php esc_html_e( 'Evaluating content structure and semantic coverage...', 'modulustools-seo-suite' ); ?></li>
						</ul>
					</div>
				</div>
			</div>

			<div class="modulustools-tab-panel" id="modulustools-tab-geo-ai">
				<div id="modulustools-sge-status-box" class="modulustools-sge-banner">
					<div class="modulustools-section-title"><?php esc_html_e( 'AI Overview (SGE) Citation Readiness', 'modulustools-seo-suite' ); ?></div>
					<p id="modulustools-sge-message"><?php esc_html_e( 'Checking for a question-based H2/H3 heading followed immediately by a 40–60 word direct answer paragraph...', 'modulustools-seo-suite' ); ?></p>
				</div>
				<div class="modulustools-ai-toolbar">
					<button type="button" class="button button-primary modulustools-ai-btn" data-ai-task="sge_answer"><?php esc_html_e( 'Draft 50-Word Direct Answer Block', 'modulustools-seo-suite' ); ?></button>
					<button type="button" class="button modulustools-ai-btn" data-ai-task="faq_schema"><?php esc_html_e( 'Draft Structured FAQ Section', 'modulustools-seo-suite' ); ?></button>
				</div>
				<div id="modulustools-ai-output-wrap" style="display:none; margin-top:14px;">
					<label class="modulustools-section-title"><?php esc_html_e( 'Generated Draft (Copy into Content Editor)', 'modulustools-seo-suite' ); ?></label>
					<textarea id="modulustools-ai-output-box" rows="5" class="widefat"></textarea>
				</div>
			</div>

			<div class="modulustools-tab-panel" id="modulustools-tab-social">
				<div class="modulustools-grid-2">
					<div class="modulustools-field-group">
						<label for="modulustools_og_title"><span><?php esc_html_e( 'OpenGraph / X Card Title', 'modulustools-seo-suite' ); ?></span></label>
						<input type="text" id="modulustools_og_title" name="modulustools_meta[og_title]" value="<?php echo esc_attr( $og_title ); ?>" class="widefat" />

						<label for="modulustools_og_description"><span><?php esc_html_e( 'OpenGraph / X Card Description', 'modulustools-seo-suite' ); ?></span></label>
						<textarea id="modulustools_og_description" name="modulustools_meta[og_description]" rows="3" class="widefat"><?php echo esc_textarea( $og_description ); ?></textarea>

						<label for="modulustools_og_image"><span><?php esc_html_e( 'Social Share Image URL (1200×630px)', 'modulustools-seo-suite' ); ?></span></label>
						<input type="url" id="modulustools_og_image" name="modulustools_meta[og_image]" value="<?php echo esc_attr( $og_image ); ?>" class="widefat" />
					</div>
					<div>
						<span class="modulustools-section-title"><?php esc_html_e( 'OpenGraph Card Preview', 'modulustools-seo-suite' ); ?></span>
						<div class="modulustools-social-card" style="margin-top:8px;">
							<div class="modulustools-social-img-placeholder"><?php echo $og_image ? esc_html( basename( $og_image ) ) : esc_html__( '1200 × 630 Featured Image Preview', 'modulustools-seo-suite' ); ?></div>
							<div class="modulustools-social-body">
								<span class="modulustools-social-domain"><?php echo esc_html( strtoupper( (string) wp_parse_url( home_url(), PHP_URL_HOST ) ) ); ?></span>
								<h4 id="modulustools-social-preview-title"><?php echo esc_html( $og_title ? $og_title : ( $title ? $title : get_the_title( $post ) ) ); ?></h4>
								<p id="modulustools-social-preview-desc"><?php echo esc_html( $og_description ? $og_description : $description ); ?></p>
							</div>
						</div>
					</div>
				</div>
			</div>

			<div class="modulustools-tab-panel" id="modulustools-tab-schema-eeat">
				<div class="modulustools-grid-2">
					<div class="modulustools-field-group">
						<label for="modulustools_schema_type"><span><?php esc_html_e( 'Primary Schema.org Entity Type', 'modulustools-seo-suite' ); ?></span></label>
						<select id="modulustools_schema_type" name="modulustools_meta[schema_type]" class="widefat">
							<?php
							$schemas = array( 'Article', 'BlogPosting', 'NewsArticle', 'Product', 'FAQPage', 'HowTo', 'LocalBusiness', 'Course', 'Recipe', 'SoftwareApplication' );
							foreach ( $schemas as $s_type ) :
								?>
								<option value="<?php echo esc_attr( $s_type ); ?>" <?php selected( $schema_type, $s_type ); ?>><?php echo esc_html( $s_type ); ?></option>
							<?php endforeach; ?>
						</select>

						<label for="modulustools_product_brand"><span><?php esc_html_e( 'Product Brand Name (Merchant Center)', 'modulustools-seo-suite' ); ?></span></label>
						<input type="text" id="modulustools_product_brand" name="modulustools_meta[product_brand]" value="<?php echo esc_attr( $product_brand ); ?>" placeholder="<?php esc_attr_e( 'e.g., Acme Corp', 'modulustools-seo-suite' ); ?>" class="widefat" />

						<div class="modulustools-grid-2" style="gap:12px;">
							<div>
								<label for="modulustools_product_gtin"><span><?php esc_html_e( 'GTIN / EAN / ISBN', 'modulustools-seo-suite' ); ?></span></label>
								<input type="text" id="modulustools_product_gtin" name="modulustools_meta[product_gtin]" value="<?php echo esc_attr( $product_gtin ); ?>" class="widefat" />
							</div>
							<div>
								<label for="modulustools_product_mpn"><span><?php esc_html_e( 'MPN Code', 'modulustools-seo-suite' ); ?></span></label>
								<input type="text" id="modulustools_product_mpn" name="modulustools_meta[product_mpn]" value="<?php echo esc_attr( $product_mpn ); ?>" class="widefat" />
							</div>
						</div>
					</div>
					<div class="modulustools-field-group">
						<label for="modulustools_eeat_reviewed_by"><span><?php esc_html_e( 'E-E-A-T Fact-Checked / Reviewed By', 'modulustools-seo-suite' ); ?></span></label>
						<input type="text" id="modulustools_eeat_reviewed_by" name="modulustools_meta[eeat_reviewed_by]" value="<?php echo esc_attr( $eeat_reviewed_by ); ?>" placeholder="<?php esc_attr_e( 'e.g., Dr. Jane Doe, PhD Computer Science', 'modulustools-seo-suite' ); ?>" class="widefat" />

						<label for="modulustools_eeat_citations"><span><?php esc_html_e( 'Authoritative Citations (One URL per line)', 'modulustools-seo-suite' ); ?></span></label>
						<textarea id="modulustools_eeat_citations" name="modulustools_meta[eeat_citations]" rows="4" class="widefat" placeholder="https://developers.google.com/search/docs&#10;https://schema.org/Article"><?php echo esc_textarea( $eeat_citations ); ?></textarea>
					</div>
				</div>
			</div>

			<div class="modulustools-tab-panel" id="modulustools-tab-links-tech">
				<div class="modulustools-grid-2">
					<div class="modulustools-field-group">
						<label for="modulustools_canonical_url"><span><?php esc_html_e( 'Canonical URL Override', 'modulustools-seo-suite' ); ?></span></label>
						<input type="url" id="modulustools_canonical_url" name="modulustools_meta[canonical_url]" value="<?php echo esc_attr( $canonical_url ); ?>" class="widefat" placeholder="<?php echo esc_attr( (string) get_permalink( $post ) ); ?>" />

						<div class="modulustools-robots-row" style="margin-top:14px;">
							<label>
								<span><?php esc_html_e( 'Indexing Directive', 'modulustools-seo-suite' ); ?></span>
								<select name="modulustools_meta[robots_index]" class="widefat">
									<option value="index" <?php selected( $robots_index, 'index' ); ?>><?php esc_html_e( 'index — Allow Search & LLM Indexing', 'modulustools-seo-suite' ); ?></option>
									<option value="noindex" <?php selected( $robots_index, 'noindex' ); ?>><?php esc_html_e( 'noindex — Exclude from Search & Sitemaps', 'modulustools-seo-suite' ); ?></option>
								</select>
							</label>
							<label style="margin-top:10px;">
								<span><?php esc_html_e( 'Link Following Directive', 'modulustools-seo-suite' ); ?></span>
								<select name="modulustools_meta[robots_follow]" class="widefat">
									<option value="follow" <?php selected( $robots_follow, 'follow' ); ?>><?php esc_html_e( 'follow — Pass Link Equity', 'modulustools-seo-suite' ); ?></option>
									<option value="nofollow" <?php selected( $robots_follow, 'nofollow' ); ?>><?php esc_html_e( 'nofollow — Do Not Follow Outbound Links', 'modulustools-seo-suite' ); ?></option>
								</select>
							</label>
						</div>
					</div>
					<div>
						<span class="modulustools-section-title"><?php esc_html_e( 'Contextual Internal Link Opportunities', 'modulustools-seo-suite' ); ?></span>
						<?php if ( empty( $link_suggestions ) ) : ?>
							<p class="description" style="margin-top:8px;"><?php esc_html_e( 'Save your target keyword or mark Pillar Content to surface contextual internal linking opportunities.', 'modulustools-seo-suite' ); ?></p>
						<?php else : ?>
							<ul class="modulustools-link-suggestions" style="margin-top:8px;">
								<?php foreach ( $link_suggestions as $suggestion ) : ?>
									<li>
										<strong><?php echo esc_html( $suggestion['title'] ); ?></strong>
										<code>&lt;a href="<?php echo esc_url( $suggestion['url'] ); ?>"&gt;<?php echo esc_html( $suggestion['anchor'] ); ?>&lt;/a&gt;</code>
									</li>
								<?php endforeach; ?>
							</ul>
						<?php endif; ?>
					</div>
				</div>
			</div>
		</div>
		<?php
	}

	/**
	 * Saves custom SEO metadata when a post is saved.
	 *
	 * @param int      $post_id Post ID.
	 * @param \WP_Post $post    Post object.
	 * @return void
	 */
	public function save_post_seo_meta( int $post_id, \WP_Post $post ): void {
		if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
			return;
		}
		if ( wp_is_post_revision( $post_id ) || 'auto-draft' === $post->post_status ) {
			return;
		}
		if ( ! isset( $_POST['modulustools_meta_nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['modulustools_meta_nonce'] ) ), 'modulustools_save_post_meta' ) ) {
			return;
		}
		if ( ! current_user_can( 'edit_post', $post_id ) ) {
			return;
		}

		if ( isset( $_POST['modulustools_meta'] ) && is_array( $_POST['modulustools_meta'] ) ) {
			$raw_meta              = wp_unslash( $_POST['modulustools_meta'] ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
			$raw_meta['is_pillar'] = ! empty( $raw_meta['is_pillar'] ) ? 1 : 0;
			self::save_meta( $post_id, 'post', $raw_meta );
		}
	}

	/**
	 * Adds an SEO/GEO Score column to post/page list tables.
	 *
	 * @param array<string, string> $columns Existing columns.
	 * @return array<string, string>
	 */
	public function add_seo_columns( array $columns ): array {
		$columns['modulustools_score'] = __( 'Search & GEO Index', 'modulustools-seo-suite' );
		return $columns;
	}

	/**
	 * Renders the custom SEO/GEO score badge in post/page list tables.
	 *
	 * @param string $column  Column slug.
	 * @param int    $post_id Post ID.
	 * @return void
	 */
	public function render_seo_column( string $column, int $post_id ): void {
		if ( 'modulustools_score' !== $column ) {
			return;
		}
		$meta = self::get_meta( $post_id, 'post' );
		if ( ! $meta ) {
			echo '<span class="modulustools-pill-neutral">' . esc_html__( 'Unscored', 'modulustools-seo-suite' ) . '</span>';
			return;
		}

		$score  = (int) $meta->seo_score;
		$class  = $score >= 80 ? 'good' : ( $score >= 50 ? 'ok' : 'poor' );
		$pillar = ! empty( $meta->is_pillar ) ? ' <span class="modulustools-pill-pillar" title="Pillar Content">PILLAR</span>' : '';
		printf(
			'<span class="modulustools-pill-%1$s">SEO %2$d</span> <span class="modulustools-pill-geo">GEO %3$d</span>%4$s',
			esc_attr( $class ),
			absint( $score ),
			absint( (int) $meta->geo_score ),
			wp_kses_post( $pillar )
		);
	}

	/**
	 * Computes live telemetry metrics for the Executive KPI Strip and Site Audit using %i placeholders.
	 *
	 * @return array<string, int>
	 */
	private function get_dashboard_telemetry(): array {
		global $wpdb;

		// phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, PluginCheck.Security.DirectDB.UnescapedDBParameter
		$avg_seo       = (int) $wpdb->get_var( $wpdb->prepare( 'SELECT AVG(seo_score) FROM %i WHERE seo_score > %d', $wpdb->prefix . 'modulustools_meta', 0 ) );
		$avg_geo       = (int) $wpdb->get_var( $wpdb->prepare( 'SELECT AVG(geo_score) FROM %i WHERE geo_score > %d', $wpdb->prefix . 'modulustools_meta', 0 ) );
		$indexed_rows  = (int) $wpdb->get_var( $wpdb->prepare( 'SELECT COUNT(*) FROM %i WHERE robots_index = %s', $wpdb->prefix . 'modulustools_meta', 'index' ) );
		$pillar_count  = (int) $wpdb->get_var( $wpdb->prepare( 'SELECT COUNT(*) FROM %i WHERE is_pillar = %d', $wpdb->prefix . 'modulustools_meta', 1 ) );
		$redirects_cnt = (int) $wpdb->get_var( $wpdb->prepare( 'SELECT COUNT(*) FROM %i WHERE is_active = %d', $wpdb->prefix . 'modulustools_redirects', 1 ) );
		$logs_404_cnt  = (int) $wpdb->get_var( $wpdb->prepare( 'SELECT COUNT(*) FROM %i WHERE hits >= %d', $wpdb->prefix . 'modulustools_404_logs', 1 ) );
		$ai_bot_hits   = (int) $wpdb->get_var( $wpdb->prepare( 'SELECT COUNT(*) FROM %i WHERE http_status >= %d', $wpdb->prefix . 'modulustools_ai_bots', 100 ) );
		// phpcs:enable

		return array(
			'avg_seo'       => $avg_seo,
			'avg_geo'       => $avg_geo,
			'indexed_rows'  => $indexed_rows,
			'pillar_count'  => $pillar_count,
			'redirects_cnt' => $redirects_cnt,
			'logs_404_cnt'  => $logs_404_cnt,
			'ai_bot_hits'   => $ai_bot_hits,
		);
	}

	/**
	 * Runs an automated Technical SEO, Database & GEO Diagnostic Audit.
	 *
	 * @return array<string, mixed>
	 */
	private function run_site_health_audit(): array {
		$checks = array();
		$passed = 0;

		$blog_public = '1' === (string) get_option( 'blog_public', '1' );
		$checks[]    = array(
			'category' => __( 'Indexing & Crawlability', 'modulustools-seo-suite' ),
			'label'    => __( 'Search Engine Visibility (blog_public)', 'modulustools-seo-suite' ),
			'status'   => $blog_public ? 'pass' : 'fail',
			'detail'   => $blog_public ? __( 'Site is open to search engines and AI answer crawlers.', 'modulustools-seo-suite' ) : __( 'CRITICAL: "Discourage search engines from indexing this site" is checked in Settings > Reading.', 'modulustools-seo-suite' ),
		);
		if ( $blog_public ) {
			++$passed;
		}

		$permalink_structure = (string) get_option( 'permalink_structure', '' );
		$pretty_permalinks   = '' !== $permalink_structure && false !== strpos( $permalink_structure, '%postname%' );
		$checks[]            = array(
			'category' => __( 'Technical Architecture', 'modulustools-seo-suite' ),
			'label'    => __( 'SEO-Friendly Permalink Structure', 'modulustools-seo-suite' ),
			'status'   => $pretty_permalinks ? 'pass' : 'warn',
			'detail'   => $pretty_permalinks ? __( 'Clean slug-based URLs are active.', 'modulustools-seo-suite' ) : __( 'Update Settings > Permalinks to "Post name" for optimal keyword URLs.', 'modulustools-seo-suite' ),
		);
		if ( $pretty_permalinks ) {
			++$passed;
		}

		$is_https = is_ssl() || 0 === strpos( home_url(), 'https://' );
		$checks[] = array(
			'category' => __( 'Security & Trust', 'modulustools-seo-suite' ),
			'label'    => __( 'HTTPS / TLS Canonical Protocol', 'modulustools-seo-suite' ),
			'status'   => $is_https ? 'pass' : 'warn',
			'detail'   => $is_https ? __( 'Site URL uses HTTPS encryption.', 'modulustools-seo-suite' ) : __( 'Site is running over HTTP; switch to HTTPS for ranking trust.', 'modulustools-seo-suite' ),
		);
		if ( $is_https ) {
			++$passed;
		}

		global $wpdb;
		$meta_table = $wpdb->prefix . 'modulustools_meta';
		// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, PluginCheck.Security.DirectDB.UnescapedDBParameter
		$table_exists = $wpdb->get_var( $wpdb->prepare( 'SHOW TABLES LIKE %s', $meta_table ) ) === $meta_table;
		$checks[]     = array(
			'category' => __( 'Database Architecture', 'modulustools-seo-suite' ),
			'label'    => __( 'Dedicated Custom Index Tables (wp_modulustools_*)', 'modulustools-seo-suite' ),
			'status'   => $table_exists ? 'pass' : 'fail',
			'detail'   => $table_exists ? __( 'All 4 indexed custom tables are active.', 'modulustools-seo-suite' ) : __( 'Deactivate and reactivate plugin to initialize dbDelta tables.', 'modulustools-seo-suite' ),
		);
		if ( $table_exists ) {
			++$passed;
		}

		$sitemaps_on = self::is_module_enabled( 'sitemaps' );
		$checks[]    = array(
			'category' => __( 'Indexing & Crawlability', 'modulustools-seo-suite' ),
			'label'    => __( 'XML, News & Video Sitemap Router (/sitemap_index.xml)', 'modulustools-seo-suite' ),
			'status'   => $sitemaps_on ? 'pass' : 'warn',
			'detail'   => $sitemaps_on ? __( 'XML, Google News (/news-sitemap.xml), Video (/video-sitemap.xml), and IndexNow are active.', 'modulustools-seo-suite' ) : __( 'Enable the Sitemaps module in Module Manager.', 'modulustools-seo-suite' ),
		);
		if ( $sitemaps_on ) {
			++$passed;
		}

		$geo_on   = self::is_module_enabled( 'geo_llms' );
		$checks[] = array(
			'category' => __( 'Generative Engine Optimization', 'modulustools-seo-suite' ),
			'label'    => __( 'LLM Directory (/llms.txt & /llms-full.txt)', 'modulustools-seo-suite' ),
			'status'   => $geo_on ? 'pass' : 'warn',
			'detail'   => $geo_on ? __( 'Dynamic LLM directories are active.', 'modulustools-seo-suite' ) : __( 'Enable the GEO /llms.txt module.', 'modulustools-seo-suite' ),
		);
		if ( $geo_on ) {
			++$passed;
		}

		$schema_on = self::is_module_enabled( 'schema_graph' );
		$checks[]  = array(
			'category' => __( 'Structured Data & E-E-A-T', 'modulustools-seo-suite' ),
			'label'    => __( 'Unified @graph JSON-LD, Merchant & E-E-A-T Credentials', 'modulustools-seo-suite' ),
			'status'   => $schema_on ? 'pass' : 'warn',
			'detail'   => $schema_on ? __( 'Deduplicated Schema.org graph is active in wp_head.', 'modulustools-seo-suite' ) : __( 'Enable Schema Graph module.', 'modulustools-seo-suite' ),
		);
		if ( $schema_on ) {
			++$passed;
		}

		$tagline    = trim( (string) get_bloginfo( 'description' ) );
		$valid_desc = '' !== $tagline && false === stripos( $tagline, 'Just another WordPress site' );
		$checks[]   = array(
			'category' => __( 'On-Page Essentials', 'modulustools-seo-suite' ),
			'label'    => __( 'Custom Brand Tagline Configured', 'modulustools-seo-suite' ),
			'status'   => $valid_desc ? 'pass' : 'warn',
			'detail'   => $valid_desc ? __( 'Active tagline:', 'modulustools-seo-suite' ) . ' "' . $tagline . '"' : __( 'Customize your site tagline under Settings > General.', 'modulustools-seo-suite' ),
		);
		if ( $valid_desc ) {
			++$passed;
		}

		$score = (int) round( ( $passed / count( $checks ) ) * 100 );
		return array(
			'score'  => $score,
			'passed' => $passed,
			'total'  => count( $checks ),
			'checks' => $checks,
		);
	}

	/**
	 * Renders the Spreadsheet-Style Bulk Quick-Editor Grid.
	 *
	 * @return void
	 */
	private function render_bulk_editor_view(): void {
		$posts = get_posts(
			array(
				'post_type'      => array( 'post', 'page' ),
				'post_status'    => 'publish',
				'posts_per_page' => 50,
				'orderby'        => 'date',
				'order'          => 'DESC',
			)
		);
		?>
		<div class="modulustools-bulk-editor-view">
			<div class="modulustools-audit-header">
				<div>
					<h2><?php esc_html_e( 'Bulk Quick-Editor Grid', 'modulustools-seo-suite' ); ?></h2>
					<p><?php esc_html_e( 'Edit SERP Titles, Meta Descriptions, Target Keywords, Indexing Rules, and Pillar status across published posts in one place.', 'modulustools-seo-suite' ); ?></p>
				</div>
				<div>
					<button type="button" id="modulustools-bulk-save-btn" class="button button-primary"><?php esc_html_e( 'Save All Bulk Changes', 'modulustools-seo-suite' ); ?></button>
					<span id="modulustools-bulk-status" style="margin-left:10px; font-weight:600;"></span>
				</div>
			</div>

			<table class="wp-list-table widefat fixed striped modulustools-bulk-table">
				<thead>
					<tr>
						<th style="width:18%;"><?php esc_html_e( 'Post / Page', 'modulustools-seo-suite' ); ?></th>
						<th style="width:22%;"><?php esc_html_e( 'SERP Title Tag', 'modulustools-seo-suite' ); ?></th>
						<th style="width:28%;"><?php esc_html_e( 'Meta Description', 'modulustools-seo-suite' ); ?></th>
						<th style="width:16%;"><?php esc_html_e( 'Focus Keyword', 'modulustools-seo-suite' ); ?></th>
						<th style="width:9%;"><?php esc_html_e( 'Robots', 'modulustools-seo-suite' ); ?></th>
						<th style="width:7%;"><?php esc_html_e( 'Pillar', 'modulustools-seo-suite' ); ?></th>
					</tr>
				</thead>
				<tbody>
					<?php if ( empty( $posts ) ) : ?>
						<tr><td colspan="6"><?php esc_html_e( 'No published posts or pages found.', 'modulustools-seo-suite' ); ?></td></tr>
					<?php else : ?>
						<?php foreach ( $posts as $p ) : ?>
							<?php
							$m      = self::get_meta( (int) $p->ID, 'post' );
							$title  = $m->title ?? '';
							$desc   = $m->description ?? '';
							$kw     = $m->focus_keyword ?? '';
							$r_idx  = $m->robots_index ?? 'index';
							$pillar = (int) ( $m->is_pillar ?? 0 );
							?>
							<tr class="modulustools-bulk-row" data-post-id="<?php echo esc_attr( (string) $p->ID ); ?>">
								<td>
									<strong><a href="<?php echo esc_url( (string) get_edit_post_link( $p->ID ) ); ?>"><?php echo esc_html( get_the_title( $p ) ); ?></a></strong>
									<div style="font-size:11px; color:#71717a;"><?php echo esc_html( strtoupper( $p->post_type ) ); ?> &bull; ID #<?php echo esc_html( (string) $p->ID ); ?></div>
								</td>
								<td><input type="text" class="widefat modulustools-bulk-title" value="<?php echo esc_attr( $title ); ?>" placeholder="<?php echo esc_attr( get_the_title( $p ) ); ?>" /></td>
								<td><textarea rows="2" class="widefat modulustools-bulk-desc"><?php echo esc_textarea( $desc ); ?></textarea></td>
								<td><input type="text" class="widefat modulustools-bulk-kw" value="<?php echo esc_attr( $kw ); ?>" /></td>
								<td>
									<select class="widefat modulustools-bulk-robots">
										<option value="index" <?php selected( $r_idx, 'index' ); ?>>index</option>
										<option value="noindex" <?php selected( $r_idx, 'noindex' ); ?>>noindex</option>
									</select>
								</td>
								<td style="text-align:center;">
									<input type="checkbox" class="modulustools-bulk-pillar" value="1" <?php checked( 1, $pillar ); ?> />
								</td>
							</tr>
						<?php endforeach; ?>
					<?php endif; ?>
				</tbody>
			</table>
		</div>
		<?php
	}

	/**
	 * Renders the Enterprise Admin Dashboard (`admin.php?page=modulustools-seo-suite`).
	 *
	 * @return void
	 */
	public function render_admin_dashboard(): void {
		if ( ! current_user_can( 'manage_options' ) ) {
			return;
		}

		$active_tab = isset( $_GET['tab'] ) ? sanitize_key( wp_unslash( $_GET['tab'] ) ) : 'modules'; // phpcs:ignore WordPress.Security.NonceVerification.Recommended
		$settings   = get_option( 'modulustools_seo_settings', array() );
		$ai_config  = AI_BYOK::get_config();
		$telemetry  = $this->get_dashboard_telemetry();
		?>
		<div class="wrap modulustools-admin-wrap">
			<header class="modulustools-admin-header">
				<div class="modulustools-brand-block">
					<div class="modulustools-logo-mark" aria-hidden="true">MT</div>
					<div>
						<h1><?php esc_html_e( 'ModulusTools SEO Suite', 'modulustools-seo-suite' ); ?> <span class="modulustools-version">v<?php echo esc_html( MODULUSTOOLS_SEO_VERSION ); ?></span></h1>
						<p><?php esc_html_e( 'Technical Search Architecture, Custom Indexed Tables & Generative Engine Optimization', 'modulustools-seo-suite' ); ?></p>
					</div>
				</div>
				<div class="modulustools-quick-links">
					<a href="<?php echo esc_url( home_url( '/sitemap_index.xml' ) ); ?>" target="_blank" class="button"><?php esc_html_e( 'XML Sitemap', 'modulustools-seo-suite' ); ?></a>
					<a href="<?php echo esc_url( home_url( '/news-sitemap.xml' ) ); ?>" target="_blank" class="button"><?php esc_html_e( 'News Sitemap', 'modulustools-seo-suite' ); ?></a>
					<a href="<?php echo esc_url( home_url( '/llms.txt' ) ); ?>" target="_blank" class="button"><?php esc_html_e( '/llms.txt', 'modulustools-seo-suite' ); ?></a>
				</div>
			</header>

			<section class="modulustools-kpi-bar" aria-label="<?php esc_attr_e( 'Site Telemetry', 'modulustools-seo-suite' ); ?>">
				<div class="modulustools-kpi-item">
					<span class="modulustools-kpi-label"><?php esc_html_e( 'Avg. SEO Score', 'modulustools-seo-suite' ); ?></span>
					<strong class="modulustools-kpi-value"><?php echo esc_html( $telemetry['avg_seo'] > 0 ? $telemetry['avg_seo'] . '/100' : '—' ); ?></strong>
				</div>
				<div class="modulustools-kpi-item">
					<span class="modulustools-kpi-label"><?php esc_html_e( 'Avg. GEO Readiness', 'modulustools-seo-suite' ); ?></span>
					<strong class="modulustools-kpi-value"><?php echo esc_html( $telemetry['avg_geo'] > 0 ? $telemetry['avg_geo'] . '/100' : '—' ); ?></strong>
				</div>
				<div class="modulustools-kpi-item">
					<span class="modulustools-kpi-label"><?php esc_html_e( 'Custom Meta Records', 'modulustools-seo-suite' ); ?></span>
					<strong class="modulustools-kpi-value"><?php echo esc_html( number_format_i18n( $telemetry['indexed_rows'] ) ); ?></strong>
				</div>
				<div class="modulustools-kpi-item">
					<span class="modulustools-kpi-label"><?php esc_html_e( 'Pillar Articles', 'modulustools-seo-suite' ); ?></span>
					<strong class="modulustools-kpi-value"><?php echo esc_html( number_format_i18n( $telemetry['pillar_count'] ) ); ?></strong>
				</div>
				<div class="modulustools-kpi-item">
					<span class="modulustools-kpi-label"><?php esc_html_e( 'Active Redirects', 'modulustools-seo-suite' ); ?></span>
					<strong class="modulustools-kpi-value"><?php echo esc_html( number_format_i18n( $telemetry['redirects_cnt'] ) ); ?></strong>
				</div>
				<div class="modulustools-kpi-item">
					<span class="modulustools-kpi-label"><?php esc_html_e( 'AI Crawler Visits', 'modulustools-seo-suite' ); ?></span>
					<strong class="modulustools-kpi-value"><?php echo esc_html( number_format_i18n( $telemetry['ai_bot_hits'] ) ); ?></strong>
				</div>
			</section>

			<nav class="nav-tab-wrapper modulustools-main-nav">
				<a href="<?php echo esc_url( admin_url( 'admin.php?page=modulustools-seo-suite&tab=modules' ) ); ?>" class="nav-tab <?php echo 'modules' === $active_tab ? 'nav-tab-active' : ''; ?>"><?php esc_html_e( 'Modules', 'modulustools-seo-suite' ); ?></a>
				<a href="<?php echo esc_url( admin_url( 'admin.php?page=modulustools-seo-suite&tab=bulk-editor' ) ); ?>" class="nav-tab <?php echo 'bulk-editor' === $active_tab ? 'nav-tab-active' : ''; ?>"><?php esc_html_e( 'Bulk Editor', 'modulustools-seo-suite' ); ?></a>
				<a href="<?php echo esc_url( admin_url( 'admin.php?page=modulustools-seo-suite&tab=site-audit' ) ); ?>" class="nav-tab <?php echo 'site-audit' === $active_tab ? 'nav-tab-active' : ''; ?>"><?php esc_html_e( 'Site Audit', 'modulustools-seo-suite' ); ?></a>
				<a href="<?php echo esc_url( admin_url( 'admin.php?page=modulustools-seo-suite&tab=settings' ) ); ?>" class="nav-tab <?php echo 'settings' === $active_tab ? 'nav-tab-active' : ''; ?>"><?php esc_html_e( 'General & Robots', 'modulustools-seo-suite' ); ?></a>
				<a href="<?php echo esc_url( admin_url( 'admin.php?page=modulustools-seo-suite&tab=local-roles' ) ); ?>" class="nav-tab <?php echo 'local-roles' === $active_tab ? 'nav-tab-active' : ''; ?>"><?php esc_html_e( 'Local SEO, RSS & Roles', 'modulustools-seo-suite' ); ?></a>
				<a href="<?php echo esc_url( admin_url( 'admin.php?page=modulustools-seo-suite&tab=ai-byok' ) ); ?>" class="nav-tab <?php echo 'ai-byok' === $active_tab ? 'nav-tab-active' : ''; ?>"><?php esc_html_e( 'AI Assistant', 'modulustools-seo-suite' ); ?></a>
				<a href="<?php echo esc_url( admin_url( 'admin.php?page=modulustools-seo-suite&tab=redirects' ) ); ?>" class="nav-tab <?php echo 'redirects' === $active_tab ? 'nav-tab-active' : ''; ?>"><?php esc_html_e( 'Redirects & 404s', 'modulustools-seo-suite' ); ?></a>
				<a href="<?php echo esc_url( admin_url( 'admin.php?page=modulustools-seo-suite&tab=ai-bots' ) ); ?>" class="nav-tab <?php echo 'ai-bots' === $active_tab ? 'nav-tab-active' : ''; ?>"><?php esc_html_e( 'AI Bot Logs', 'modulustools-seo-suite' ); ?></a>
				<a href="<?php echo esc_url( admin_url( 'admin.php?page=modulustools-seo-suite&tab=orphans' ) ); ?>" class="nav-tab <?php echo 'orphans' === $active_tab ? 'nav-tab-active' : ''; ?>"><?php esc_html_e( 'Link Graph & Orphans', 'modulustools-seo-suite' ); ?></a>
				<a href="<?php echo esc_url( admin_url( 'admin.php?page=modulustools-seo-suite&tab=migrator' ) ); ?>" class="nav-tab <?php echo 'migrator' === $active_tab ? 'nav-tab-active' : ''; ?>"><?php esc_html_e( 'Import & Backup', 'modulustools-seo-suite' ); ?></a>
			</nav>

			<div class="modulustools-admin-content">
				<?php if ( 'modules' === $active_tab ) : ?>
					<div class="modulustools-modules-grid">
						<?php foreach ( self::get_available_modules() as $m_key => $m_info ) : ?>
							<?php $enabled = self::is_module_enabled( $m_key ); ?>
							<div class="modulustools-module-card <?php echo $enabled ? 'is-enabled' : 'is-disabled'; ?>">
								<div class="modulustools-module-top">
									<span class="modulustools-module-badge"><?php echo esc_html( $m_info['badge'] ); ?></span>
									<label class="modulustools-switch" aria-label="<?php echo esc_attr( $m_info['title'] ); ?>">
										<input type="checkbox" class="modulustools-module-toggle" data-module="<?php echo esc_attr( $m_key ); ?>" <?php checked( $enabled ); ?> />
										<span class="modulustools-slider"></span>
									</label>
								</div>
								<h3><?php echo esc_html( $m_info['title'] ); ?></h3>
								<p><?php echo esc_html( $m_info['description'] ); ?></p>
							</div>
						<?php endforeach; ?>
					</div>

				<?php elseif ( 'bulk-editor' === $active_tab ) : ?>
					<?php $this->render_bulk_editor_view(); ?>

				<?php elseif ( 'site-audit' === $active_tab ) : ?>
					<?php $audit = $this->run_site_health_audit(); ?>
					<div class="modulustools-audit-header">
						<div>
							<h2><?php esc_html_e( 'Technical SEO, Database & GEO Diagnostic Audit', 'modulustools-seo-suite' ); ?></h2>
							<p><?php esc_html_e( 'Automated inspection of indexing rules, custom table integrity, structured data, and AI crawler readiness.', 'modulustools-seo-suite' ); ?></p>
						</div>
						<div class="modulustools-audit-score-box">
							<span class="modulustools-kpi-label"><?php esc_html_e( 'Overall Site Health', 'modulustools-seo-suite' ); ?></span>
							<strong><?php echo esc_html( (string) $audit['score'] ); ?> / 100</strong>
						</div>
					</div>
					<table class="wp-list-table widefat fixed striped">
						<thead>
							<tr>
								<th style="width:180px;"><?php esc_html_e( 'Category', 'modulustools-seo-suite' ); ?></th>
								<th style="width:260px;"><?php esc_html_e( 'Diagnostic Check', 'modulustools-seo-suite' ); ?></th>
								<th style="width:110px;"><?php esc_html_e( 'Status', 'modulustools-seo-suite' ); ?></th>
								<th><?php esc_html_e( 'Finding & Recommendation', 'modulustools-seo-suite' ); ?></th>
							</tr>
						</thead>
						<tbody>
							<?php foreach ( $audit['checks'] as $chk ) : ?>
								<tr>
									<td><strong><?php echo esc_html( $chk['category'] ); ?></strong></td>
									<td><?php echo esc_html( $chk['label'] ); ?></td>
									<td>
										<?php if ( 'pass' === $chk['status'] ) : ?>
											<span class="modulustools-pill-good"><?php esc_html_e( 'Passed', 'modulustools-seo-suite' ); ?></span>
										<?php elseif ( 'warn' === $chk['status'] ) : ?>
											<span class="modulustools-pill-ok"><?php esc_html_e( 'Advisory', 'modulustools-seo-suite' ); ?></span>
										<?php else : ?>
											<span class="modulustools-pill-poor"><?php esc_html_e( 'Action Needed', 'modulustools-seo-suite' ); ?></span>
										<?php endif; ?>
									</td>
									<td><?php echo esc_html( $chk['detail'] ); ?></td>
								</tr>
							<?php endforeach; ?>
						</tbody>
					</table>

				<?php elseif ( 'settings' === $active_tab ) : ?>
					<form method="post" action="">
						<?php wp_nonce_field( 'modulustools_save_settings_action', 'modulustools_settings_nonce' ); ?>
						<input type="hidden" name="modulustools_action" value="save_general_settings" />
						<table class="form-table" role="presentation">
							<tr>
								<th scope="row"><label for="title_separator"><?php esc_html_e( 'Title Separator Character', 'modulustools-seo-suite' ); ?></label></th>
								<td><input type="text" id="title_separator" name="title_separator" value="<?php echo esc_attr( $settings['title_separator'] ?? '-' ); ?>" class="small-text" /></td>
							</tr>
							<tr>
								<th scope="row"><label for="organization_name"><?php esc_html_e( 'Publisher / Organization Name', 'modulustools-seo-suite' ); ?></label></th>
								<td><input type="text" id="organization_name" name="organization_name" value="<?php echo esc_attr( $settings['organization_name'] ?? get_bloginfo( 'name' ) ); ?>" class="regular-text" /></td>
							</tr>
							<tr>
								<th scope="row"><label for="organization_logo"><?php esc_html_e( 'Organization Logo URL', 'modulustools-seo-suite' ); ?></label></th>
								<td><input type="url" id="organization_logo" name="organization_logo" value="<?php echo esc_attr( $settings['organization_logo'] ?? '' ); ?>" class="regular-text" placeholder="https://" /></td>
							</tr>
							<tr>
								<th scope="row"><label for="image_alt_template"><?php esc_html_e( 'Dynamic Image Alt Template', 'modulustools-seo-suite' ); ?></label></th>
								<td>
									<input type="text" id="image_alt_template" name="image_alt_template" value="<?php echo esc_attr( $settings['image_alt_template'] ?? '%post_title% - %site_name%' ); ?>" class="regular-text" />
									<p class="description"><?php esc_html_e( 'Available tags:', 'modulustools-seo-suite' ); ?> <code>%post_title%</code>, <code>%site_name%</code>, <code>%focus_keyword%</code>, <code>%file_name%</code>, <code>%category%</code></p>
								</td>
							</tr>
							<tr>
								<th scope="row"><label for="llms_txt_intro"><?php esc_html_e( '/llms.txt Executive Summary', 'modulustools-seo-suite' ); ?></label></th>
								<td><textarea id="llms_txt_intro" name="llms_txt_intro" rows="3" class="large-text"><?php echo esc_textarea( $settings['llms_txt_intro'] ?? '' ); ?></textarea></td>
							</tr>
							<tr>
								<th scope="row"><?php esc_html_e( 'AI Crawler Policy (robots.txt)', 'modulustools-seo-suite' ); ?></th>
								<td>
									<div class="modulustools-bot-matrix">
										<?php
										$bot_rules = $settings['ai_bots_rules'] ?? array();
										$bots      = array( 'GPTBot', 'OAI-SearchBot', 'ClaudeBot', 'Anthropic-ai', 'Google-Extended', 'PerplexityBot', 'Applebot-Extended', 'CCBot' );
										foreach ( $bots as $bot ) :
											$rule = $bot_rules[ $bot ] ?? 'allow';
											?>
											<div class="modulustools-bot-row">
												<code><?php echo esc_html( $bot ); ?></code>
												<select name="ai_bots_rules[<?php echo esc_attr( $bot ); ?>]">
													<option value="allow" <?php selected( $rule, 'allow' ); ?>><?php esc_html_e( 'Allow Indexing', 'modulustools-seo-suite' ); ?></option>
													<option value="disallow" <?php selected( $rule, 'disallow' ); ?>><?php esc_html_e( 'Disallow (/ )', 'modulustools-seo-suite' ); ?></option>
												</select>
											</div>
										<?php endforeach; ?>
									</div>
								</td>
							</tr>
							<tr>
								<th scope="row"><label for="custom_robots_rules"><?php esc_html_e( 'Custom robots.txt Directives', 'modulustools-seo-suite' ); ?></label></th>
								<td>
									<textarea id="custom_robots_rules" name="custom_robots_rules" rows="4" class="large-text code" placeholder="User-agent: *&#10;Disallow: /wp-admin/"><?php echo esc_textarea( $settings['custom_robots_rules'] ?? '' ); ?></textarea>
								</td>
							</tr>
							<tr>
								<th scope="row"><?php esc_html_e( 'Technical Hardening & Automation', 'modulustools-seo-suite' ); ?></th>
								<td>
									<label><input type="checkbox" name="enable_indexnow" value="1" <?php checked( ! empty( $settings['enable_indexnow'] ) ); ?> /> <?php esc_html_e( 'Ping IndexNow API automatically when content is published or updated', 'modulustools-seo-suite' ); ?></label><br />
									<label><input type="checkbox" name="auto_redirect_slug_change" value="1" <?php checked( ! empty( $settings['auto_redirect_slug_change'] ) ); ?> /> <?php esc_html_e( 'Create automatic 301 redirect when a published post slug changes', 'modulustools-seo-suite' ); ?></label><br />
									<label><input type="checkbox" name="clean_wp_head" value="1" <?php checked( ! empty( $settings['clean_wp_head'] ) ); ?> /> <?php esc_html_e( 'Strip redundant WordPress generator, RSD, WLW, and shortlink tags from <head>', 'modulustools-seo-suite' ); ?></label><br />
									<label><input type="checkbox" name="delete_data_on_uninstall" value="1" <?php checked( ! empty( $settings['delete_data_on_uninstall'] ) ); ?> /> <?php esc_html_e( 'Remove all plugin database tables and options upon uninstall', 'modulustools-seo-suite' ); ?></label>
								</td>
							</tr>
						</table>
						<?php submit_button( __( 'Save Configuration', 'modulustools-seo-suite' ) ); ?>
					</form>

				<?php elseif ( 'local-roles' === $active_tab ) : ?>
					<form method="post" action="">
						<?php wp_nonce_field( 'modulustools_save_local_action', 'modulustools_local_nonce' ); ?>
						<input type="hidden" name="modulustools_action" value="save_local_rss_settings" />

						<h2><?php esc_html_e( 'Local Business Schema & Geo Coordinates', 'modulustools-seo-suite' ); ?></h2>
						<p class="description"><?php esc_html_e( 'Populates LocalBusiness structured data in the sitewide JSON-LD graph and powers the [modulustools_local_info] shortcode.', 'modulustools-seo-suite' ); ?></p>
						<table class="form-table" role="presentation">
							<tr>
								<th scope="row"><label for="local_business_type"><?php esc_html_e( 'Business Entity Subtype', 'modulustools-seo-suite' ); ?></label></th>
								<td>
									<select id="local_business_type" name="local_business_type">
										<?php
										$btypes = array( 'LocalBusiness', 'ProfessionalService', 'Store', 'Restaurant', 'MedicalBusiness', 'LegalService', 'FinancialService', 'RealEstateAgent' );
										foreach ( $btypes as $bt ) :
											?>
											<option value="<?php echo esc_attr( $bt ); ?>" <?php selected( $settings['local_business_type'] ?? 'LocalBusiness', $bt ); ?>><?php echo esc_html( $bt ); ?></option>
										<?php endforeach; ?>
									</select>
								</td>
							</tr>
							<tr>
								<th scope="row"><label for="local_phone"><?php esc_html_e( 'Telephone & Price Range', 'modulustools-seo-suite' ); ?></label></th>
								<td>
									<input type="text" id="local_phone" name="local_phone" value="<?php echo esc_attr( $settings['local_phone'] ?? '' ); ?>" placeholder="+1-555-0199" class="regular-text" />
									<input type="text" name="local_price_range" value="<?php echo esc_attr( $settings['local_price_range'] ?? '$$' ); ?>" placeholder="$$" class="small-text" />
								</td>
							</tr>
							<tr>
								<th scope="row"><label for="local_street"><?php esc_html_e( 'Physical Address', 'modulustools-seo-suite' ); ?></label></th>
								<td>
									<input type="text" id="local_street" name="local_street" value="<?php echo esc_attr( $settings['local_street'] ?? '' ); ?>" placeholder="<?php esc_attr_e( 'Street Address', 'modulustools-seo-suite' ); ?>" class="regular-text" />
									<input type="text" name="local_city" value="<?php echo esc_attr( $settings['local_city'] ?? '' ); ?>" placeholder="<?php esc_attr_e( 'City', 'modulustools-seo-suite' ); ?>" class="regular-text" /><br /><br />
									<input type="text" name="local_region" value="<?php echo esc_attr( $settings['local_region'] ?? '' ); ?>" placeholder="<?php esc_attr_e( 'State / Region', 'modulustools-seo-suite' ); ?>" class="regular-text" />
									<input type="text" name="local_postal" value="<?php echo esc_attr( $settings['local_postal'] ?? '' ); ?>" placeholder="<?php esc_attr_e( 'Postal Code', 'modulustools-seo-suite' ); ?>" class="small-text" />
									<input type="text" name="local_country" value="<?php echo esc_attr( $settings['local_country'] ?? '' ); ?>" placeholder="<?php esc_attr_e( 'Country Code (US, PK, UK)', 'modulustools-seo-suite' ); ?>" class="small-text" />
								</td>
							</tr>
							<tr>
								<th scope="row"><label for="local_lat"><?php esc_html_e( 'Geo Coordinates & Opening Hours', 'modulustools-seo-suite' ); ?></label></th>
								<td>
									<input type="text" id="local_lat" name="local_lat" value="<?php echo esc_attr( $settings['local_lat'] ?? '' ); ?>" placeholder="<?php esc_attr_e( 'Latitude (e.g. 31.5204)', 'modulustools-seo-suite' ); ?>" class="regular-text" />
									<input type="text" name="local_lng" value="<?php echo esc_attr( $settings['local_lng'] ?? '' ); ?>" placeholder="<?php esc_attr_e( 'Longitude (e.g. 74.3587)', 'modulustools-seo-suite' ); ?>" class="regular-text" /><br /><br />
									<input type="text" name="local_opening_hours" value="<?php echo esc_attr( $settings['local_opening_hours'] ?? 'Mo-Fr 09:00-18:00' ); ?>" placeholder="Mo-Fr 09:00-18:00" class="regular-text" />
								</td>
							</tr>
						</table>

						<hr />
						<h2><?php esc_html_e( 'RSS Feed Attribution', 'modulustools-seo-suite' ); ?></h2>
						<p class="description"><?php esc_html_e( 'Injects attribution links into your RSS feed. Available tags:', 'modulustools-seo-suite' ); ?> <code>%post_link%</code>, <code>%site_link%</code>, <code>%author_link%</code></p>
						<table class="form-table" role="presentation">
							<tr>
								<th scope="row"><label for="rss_before_content"><?php esc_html_e( 'Content Before RSS Entry', 'modulustools-seo-suite' ); ?></label></th>
								<td><input type="text" id="rss_before_content" name="rss_before_content" value="<?php echo esc_attr( $settings['rss_before_content'] ?? '' ); ?>" class="large-text" /></td>
							</tr>
							<tr>
								<th scope="row"><label for="rss_after_content"><?php esc_html_e( 'Content After RSS Entry', 'modulustools-seo-suite' ); ?></label></th>
								<td><input type="text" id="rss_after_content" name="rss_after_content" value="<?php echo esc_attr( $settings['rss_after_content'] ?? 'The post %post_link% appeared first on %site_link%.' ); ?>" class="large-text" /></td>
							</tr>
						</table>

						<hr />
						<h2><?php esc_html_e( 'Role & Capability Access Control', 'modulustools-seo-suite' ); ?></h2>
						<table class="form-table" role="presentation">
							<?php
							$wp_roles        = wp_roles()->get_names();
							$allowed_metabox = $settings['allowed_roles_metabox'] ?? array( 'administrator', 'editor', 'author' );
							$allowed_redir   = $settings['allowed_roles_redirects'] ?? array( 'administrator', 'editor' );
							?>
							<tr>
								<th scope="row"><?php esc_html_e( 'Roles Permitted to Use SEO Metabox', 'modulustools-seo-suite' ); ?></th>
								<td>
									<?php foreach ( $wp_roles as $role_key => $role_name ) : ?>
										<label style="margin-right:16px;">
											<input type="checkbox" name="allowed_roles_metabox[]" value="<?php echo esc_attr( $role_key ); ?>" <?php checked( in_array( $role_key, $allowed_metabox, true ) ); ?> />
											<?php echo esc_html( translate_user_role( $role_name ) ); ?>
										</label>
									<?php endforeach; ?>
								</td>
							</tr>
							<tr>
								<th scope="row"><?php esc_html_e( 'Roles Permitted to Manage Redirects', 'modulustools-seo-suite' ); ?></th>
								<td>
									<?php foreach ( $wp_roles as $role_key => $role_name ) : ?>
										<label style="margin-right:16px;">
											<input type="checkbox" name="allowed_roles_redirects[]" value="<?php echo esc_attr( $role_key ); ?>" <?php checked( in_array( $role_key, $allowed_redir, true ) ); ?> />
											<?php echo esc_html( translate_user_role( $role_name ) ); ?>
										</label>
									<?php endforeach; ?>
								</td>
							</tr>
						</table>
						<?php submit_button( __( 'Save Local SEO, RSS & Role Rules', 'modulustools-seo-suite' ) ); ?>
					</form>

				<?php elseif ( 'ai-byok' === $active_tab ) : ?>
					<form method="post" action="">
						<?php wp_nonce_field( 'modulustools_save_ai_action', 'modulustools_ai_nonce' ); ?>
						<input type="hidden" name="modulustools_action" value="save_ai_settings" />
						<h2><?php esc_html_e( 'WordPress Core AI Client & Content Assistant Configuration', 'modulustools-seo-suite' ); ?></h2>
						<p><?php esc_html_e( 'Uses the native WordPress Core AI Client when available, or connects to your custom AI gateway / local heuristic engine.', 'modulustools-seo-suite' ); ?></p>
						<table class="form-table" role="presentation">
							<tr>
								<th scope="row"><label for="ai_provider"><?php esc_html_e( 'Assistant Mode', 'modulustools-seo-suite' ); ?></label></th>
								<td>
									<select id="ai_provider" name="ai_provider">
										<option value="wp_core" <?php selected( $ai_config['provider'], 'wp_core' ); ?>><?php esc_html_e( 'WordPress Core AI Client (Recommended)', 'modulustools-seo-suite' ); ?></option>
										<option value="local_heuristic" <?php selected( $ai_config['provider'], 'local_heuristic' ); ?>><?php esc_html_e( 'Built-in Local NLP Heuristic Engine (Zero External Calls)', 'modulustools-seo-suite' ); ?></option>
										<option value="custom_gateway" <?php selected( $ai_config['provider'], 'custom_gateway' ); ?>><?php esc_html_e( 'Custom Self-Hosted / Gateway Endpoint', 'modulustools-seo-suite' ); ?></option>
									</select>
								</td>
							</tr>
							<tr>
								<th scope="row"><label for="ai_model"><?php esc_html_e( 'Model Identifier (Optional)', 'modulustools-seo-suite' ); ?></label></th>
								<td>
									<input type="text" id="ai_model" name="ai_model" value="<?php echo esc_attr( $ai_config['model'] ); ?>" class="regular-text" placeholder="default" />
								</td>
							</tr>
							<tr>
								<th scope="row"><label for="ai_custom_endpoint"><?php esc_html_e( 'Custom Gateway URL (Optional)', 'modulustools-seo-suite' ); ?></label></th>
								<td>
									<input type="url" id="ai_custom_endpoint" name="ai_custom_endpoint" value="<?php echo esc_attr( $ai_config['custom_endpoint'] ); ?>" class="regular-text" placeholder="http://localhost:11434/v1/chat/completions" />
								</td>
							</tr>
							<tr>
								<th scope="row"><label for="ai_api_key"><?php esc_html_e( 'Gateway Bearer Token (AES-256 Encrypted)', 'modulustools-seo-suite' ); ?></label></th>
								<td>
									<input type="password" id="ai_api_key" name="ai_api_key" value="" class="regular-text" placeholder="<?php echo $ai_config['has_key'] ? esc_attr__( '•••••••••••••••• (Token Active — Enter new token to replace)', 'modulustools-seo-suite' ) : esc_attr__( 'Optional token...', 'modulustools-seo-suite' ); ?>" autocomplete="off" />
								</td>
							</tr>
						</table>
						<?php submit_button( __( 'Save AI Assistant Settings', 'modulustools-seo-suite' ) ); ?>
					</form>

				<?php elseif ( 'redirects' === $active_tab && class_exists( Redirects_404::class ) ) : ?>
					<?php Redirects_404::render_admin_view(); ?>

				<?php elseif ( 'ai-bots' === $active_tab && class_exists( GEO_LLMs::class ) ) : ?>
					<?php GEO_LLMs::render_bot_logs_view(); ?>

				<?php elseif ( 'orphans' === $active_tab && class_exists( Link_Assistant::class ) ) : ?>
					<?php Link_Assistant::render_orphan_pages_view(); ?>

				<?php elseif ( 'migrator' === $active_tab && class_exists( Migrator::class ) ) : ?>
					<?php Migrator::render_migration_wizard(); ?>
					<div class="modulustools-grid-2" style="margin-top:20px;">
						<div class="modulustools-card">
							<h2><?php esc_html_e( 'Export Configuration Snapshot (JSON)', 'modulustools-seo-suite' ); ?></h2>
							<p><?php esc_html_e( 'Download a portable JSON backup of your enabled modules, Local SEO schema, robots rules, and templates.', 'modulustools-seo-suite' ); ?></p>
							<form method="post" action="">
								<?php wp_nonce_field( 'modulustools_export_json_action', 'modulustools_export_nonce' ); ?>
								<input type="hidden" name="modulustools_action" value="export_settings_json" />
								<?php submit_button( __( 'Download JSON Snapshot', 'modulustools-seo-suite' ), 'secondary', 'submit', false ); ?>
							</form>
						</div>
						<div class="modulustools-card">
							<h2><?php esc_html_e( 'Restore Configuration Snapshot (JSON)', 'modulustools-seo-suite' ); ?></h2>
							<form method="post" action="">
								<?php wp_nonce_field( 'modulustools_import_json_action', 'modulustools_import_nonce' ); ?>
								<input type="hidden" name="modulustools_action" value="import_settings_json" />
								<textarea name="modulustools_import_payload" rows="3" class="widefat code" placeholder='{"plugin":"modulustools-seo-suite", ...}'></textarea>
								<div style="margin-top:10px;">
									<?php submit_button( __( 'Restore JSON Snapshot', 'modulustools-seo-suite' ), 'secondary', 'submit', false ); ?>
								</div>
							</form>
						</div>
					</div>
				<?php endif; ?>
			</div>
		</div>
		<?php
	}
}