<?php
/**
 * ARSCAN_Settings ÃƒÂ¢Ã¢â€šÂ¬Ã¢â‚¬Â Admin settings page (Settings > AgentReadyScan)
 *
 * Stores everything in a single WP option: arscan_settings (associative array).
 */

defined( 'ABSPATH' ) || exit;

class ARSCAN_Settings {

    private static ?ARSCAN_Settings $instance = null;

    public static function get_instance(): ARSCAN_Settings {
        if ( null === self::$instance ) {
            self::$instance = new self();
        }
        return self::$instance;
    }

    private function __construct() {
        add_action( 'admin_menu',    array( $this, 'add_menu' ) );
        add_action( 'admin_init',    array( $this, 'register_settings' ) );
        add_action( 'admin_post_arscan_save_settings', array( $this, 'handle_save' ) );
        add_action( 'admin_post_arscan_verify_license', array( $this, 'handle_verify_license' ) );
        add_action( 'admin_post_arscan_regenerate_files', array( $this, 'handle_regenerate_files' ) );
        add_action( 'admin_post_arscan_sync_license', array( $this, 'handle_sync_license' ) );
        add_action( 'admin_post_arscan_load_site_data', array( $this, 'handle_load_site_data' ) );
        add_action( 'admin_post_arscan_refresh_golden_questions', array( $this, 'handle_refresh_golden_questions' ) );
        add_action( 'admin_post_arscan_prepare_pro_setup', array( $this, 'handle_prepare_pro_setup' ) );
        add_action( 'admin_post_arscan_manage_billing', array( $this, 'handle_manage_billing' ) );
        add_action( 'admin_notices', array( $this, 'admin_notices' ) );
        add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_styles' ) );
        add_action( 'wp_ajax_arscan_dismiss_upsell', array( $this, 'ajax_dismiss_upsell' ) );
        add_filter( 'plugin_action_links_' . plugin_basename( ARSCAN_PLUGIN_FILE ), array( $this, 'plugin_action_links' ) );
        add_action( 'admin_footer', array( $this, 'deactivation_survey_modal' ) );
        add_action( 'wp_ajax_arscan_submit_deactivation_survey', array( $this, 'ajax_submit_deactivation_survey' ) );
    }

    public function ajax_dismiss_upsell(): void {
        check_ajax_referer( 'arscan_dismiss_upsell' );
        update_user_meta( get_current_user_id(), 'arscan_upsell_dismissed', '1' );
        wp_die();
    }

    // -----------------------------------------------------------------------
    // Menu
    // -----------------------------------------------------------------------

    public function add_menu(): void {
        add_options_page(
            __( 'AgentReadyScan', 'agentreadyscan' ),
            __( 'AgentReadyScan', 'agentreadyscan' ),
            'manage_options',
            'agentreadyscan',
            array( $this, 'render_page' )
        );
    }

    // -----------------------------------------------------------------------
    // Settings registration (for nonce + sanitisation via Settings API)
    // -----------------------------------------------------------------------

    public function register_settings(): void {
        register_setting( 'arscan_settings_group', ARSCAN_OPTION_KEY, array(
            'type'              => 'array',
            'default'           => arscan_default_settings(),
            'sanitize_callback' => array( $this, 'sanitize' ),
        ) );
    }

    public function sanitize( $input ): array {
        $clean   = arscan_default_settings();
        wp_cache_delete( ARSCAN_OPTION_KEY, 'options' );
        $current = get_option( ARSCAN_OPTION_KEY, arscan_default_settings() );

        $readonly_text_fields = array(
            'license_status',
            'license_message',
            'license_checked_at',
            'license_renewal_date',
            'license_error_code',
            'license_last_sync_at',
            'license_last_sync_message',
            'pro_health_status',
            'pro_health_score',
            'pro_health_checked_at',
            'pro_health_last_error',
            'last_written',
            'last_write_hash',
        );
        foreach ( $readonly_text_fields as $readonly_field ) {
            if ( isset( $current[ $readonly_field ] ) ) {
                $clean[ $readonly_field ] = sanitize_text_field( (string) $current[ $readonly_field ] );
            }
        }
        // license_features is an array Ã¢â‚¬â€ sanitize each element
        if ( isset( $current['license_features'] ) && is_array( $current['license_features'] ) ) {
            $clean['license_features'] = array_map( 'sanitize_text_field', $current['license_features'] );
        }
        if ( isset( $current['pro_health_top_issues'] ) && is_array( $current['pro_health_top_issues'] ) ) {
            $clean['pro_health_top_issues'] = array_map( 'sanitize_text_field', $current['pro_health_top_issues'] );
        }
        if ( isset( $current['pro_health_recommendations'] ) && is_array( $current['pro_health_recommendations'] ) ) {
            $clean['pro_health_recommendations'] = array_map( 'sanitize_text_field', $current['pro_health_recommendations'] );
        }
        if ( isset( $current['pro_health_issue_count'] ) ) {
            $clean['pro_health_issue_count'] = max( 0, absint( $current['pro_health_issue_count'] ) );
        }

        // API key ÃƒÂ¢Ã¢â€šÂ¬Ã¢â‚¬Â sanitize and store as-is (validation against server is future work)
        $clean['api_key'] = isset( $current['api_key'] ) ? sanitize_text_field( $current['api_key'] ) : '';
        if ( isset( $input['api_key'] ) ) {
            $clean['api_key'] = sanitize_text_field( $input['api_key'] );
        }

        $text_fields = array(
            'business_name', 'industry', 'description',
            'phone', 'address', 'city', 'state', 'zip', 'country',
            'services', 'hours', 'schema_type', 'legal_name',
            'service_area', 'pricing_summary', 'primary_contact', 'founded_on',
        );
        foreach ( $text_fields as $f ) {
            if ( isset( $input[ $f ] ) ) {
                $clean[ $f ] = sanitize_text_field( $input[ $f ] );
            }
        }
        if ( isset( $input['business_url'] ) ) {
            $clean['business_url'] = esc_url_raw( trim( (string) $input['business_url'] ) );
        }
        if ( isset( $input['contact_url'] ) ) {
            $clean['contact_url'] = esc_url_raw( trim( (string) $input['contact_url'] ) );
        }
        if ( isset( $input['email'] ) ) {
            $clean['email'] = sanitize_email( $input['email'] );
        }
        if ( isset( $input['explicit_exclusions'] ) ) {
            $lines = preg_split( '/\r\n|\r|\n/', (string) $input['explicit_exclusions'] );
            $lines = array_filter( array_map( static function( $line ) {
                return sanitize_text_field( trim( $line ) );
            }, $lines ) );
            $clean['explicit_exclusions'] = implode( "\n", $lines );
        }
        $bool_fields = array( 'inject_jsonld', 'inject_robots', 'write_llms_txt', 'write_agent_facts' );
        foreach ( $bool_fields as $f ) {
            $clean[ $f ] = ! empty( $input[ $f ] );
        }

        // Q&A pairs: array of {q, a} submitted from repeating rows
        $clean['qa_pairs'] = array();
        if ( ! empty( $input['qa_pairs'] ) && is_array( $input['qa_pairs'] ) ) {
            foreach ( $input['qa_pairs'] as $pair ) {
                $q = isset( $pair['q'] ) ? sanitize_text_field( $pair['q'] ) : '';
                $a = isset( $pair['a'] ) ? sanitize_textarea_field( $pair['a'] ) : '';
                if ( $q !== '' ) {
                    $clean['qa_pairs'][] = array( 'q' => $q, 'a' => $a );
                }
            }
        }

        // If no Q&A pairs were submitted yet, seed from industry template
        if ( empty( $clean['qa_pairs'] ) ) {
            $clean['qa_pairs'] = ARSCAN_Files::seed_qa_pairs( $clean );
        }

        return $clean;
    }

    private function persist_settings( array $settings ): void {
        wp_cache_delete( ARSCAN_OPTION_KEY, 'options' );
        wp_cache_delete( 'alloptions', 'options' );

        $updated = update_option( ARSCAN_OPTION_KEY, $settings, true );
        if ( false === $updated ) {
            delete_option( ARSCAN_OPTION_KEY );
            add_option( ARSCAN_OPTION_KEY, $settings, '', 'yes' );
        }

        wp_cache_delete( ARSCAN_OPTION_KEY, 'options' );
        wp_cache_delete( 'alloptions', 'options' );
    }

    private function debug_log( string $message, array $context = array() ): void {
        if ( ! defined( 'WP_DEBUG' ) || ! WP_DEBUG ) {
            return;
        }
        $payload = array(
            'time'    => current_time( 'mysql' ),
            'message' => $message,
            'context' => $context,
        );
        // phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log
        error_log( 'ARS: ' . wp_json_encode( $payload ) );
    }

    private function extract_page_links( string $html ): array {
        if ( empty( $html ) ) {
            return array();
        }

        preg_match_all( '/href=["\']([^"\']+)["\']/i', $html, $matches );
        if ( empty( $matches[1] ) ) {
            return array();
        }

        $links = array();
        foreach ( $matches[1] as $href ) {
            if ( empty( $href ) || '#' === $href[0] || 0 === strpos( $href, 'mailto:' ) || 0 === strpos( $href, 'tel:' ) ) {
                continue;
            }

            $absolute = wp_http_validate_url( $href ) ? $href : home_url( ltrim( $href, '/' ) );
            if ( $absolute ) {
                $links[] = $absolute;
            }
        }

        return array_values( array_unique( $links ) );
    }

    private function collect_site_pages(): array {
        $pages = array();
        $queue = array(
            home_url( '/' ),
            home_url( '/about/' ),
            home_url( '/about' ),
            home_url( '/contact/' ),
            home_url( '/contact' ),
            home_url( '/services/' ),
            home_url( '/services' ),
            home_url( '/faq/' ),
            home_url( '/faq' ),
        );
        $allowed_host = wp_parse_url( home_url(), PHP_URL_HOST );

        foreach ( $queue as $url ) {
            $response = wp_remote_get(
                $url,
                array(
                    'timeout' => 12,
                    'redirection' => 3,
                )
            );
            if ( is_wp_error( $response ) ) {
                continue;
            }
            if ( 200 !== (int) wp_remote_retrieve_response_code( $response ) ) {
                continue;
            }

            $html = wp_remote_retrieve_body( $response );
            if ( empty( $html ) ) {
                continue;
            }

            $pages[ $url ] = $html;

            foreach ( $this->extract_page_links( $html ) as $link ) {
                $host = wp_parse_url( $link, PHP_URL_HOST );
                if ( $host && $allowed_host === $host ) {
                    $path = wp_parse_url( $link, PHP_URL_PATH ) ?: '';
                    if ( preg_match( '#/(about|contact|services|faq|team|locations?)/?#i', $path ) ) {
                        $queue[] = $link;
                    }
                }
            }
        }

        return $pages;
    }

    private function extract_between_tags( string $html, string $tag ): string {
        if ( preg_match( '/<' . preg_quote( $tag, '/' ) . '[^>]*>(.*?)<\/' . preg_quote( $tag, '/' ) . '>/is', $html, $matches ) ) {
            return trim( wp_strip_all_tags( html_entity_decode( $matches[1], ENT_QUOTES | ENT_HTML5 ) ) );
        }

        return '';
    }

    private function extract_meta_description( string $html ): string {
        // name="description" (attribute order variant 1)
        if ( preg_match( '/<meta\s[^>]*name=["\']description["\']\s[^>]*content=["\']([^"\']{10,})["\'][^>]*>/i', $html, $m ) ) {
            return trim( wp_strip_all_tags( html_entity_decode( $m[1], ENT_QUOTES | ENT_HTML5 ) ) );
        }
        // name="description" (attribute order variant 2 Ã¢â‚¬â€ content before name)
        if ( preg_match( '/<meta\s[^>]*content=["\']([^"\']{10,})["\']\s[^>]*name=["\']description["\']/i', $html, $m ) ) {
            return trim( wp_strip_all_tags( html_entity_decode( $m[1], ENT_QUOTES | ENT_HTML5 ) ) );
        }
        // og:description (variant 1)
        if ( preg_match( '/<meta\s[^>]*property=["\']og:description["\']\s[^>]*content=["\']([^"\']{10,})["\'][^>]*>/i', $html, $m ) ) {
            return trim( wp_strip_all_tags( html_entity_decode( $m[1], ENT_QUOTES | ENT_HTML5 ) ) );
        }
        // og:description (variant 2 Ã¢â‚¬â€ content before property)
        if ( preg_match( '/<meta\s[^>]*content=["\']([^"\']{10,})["\']\s[^>]*property=["\']og:description["\']/i', $html, $m ) ) {
            return trim( wp_strip_all_tags( html_entity_decode( $m[1], ENT_QUOTES | ENT_HTML5 ) ) );
        }
        return '';
    }

    private function extract_first_paragraph( string $html ): string {
        // Walk <p> tags and return the first one that looks like real prose (50+ chars)
        if ( preg_match_all( '/<p[^>]*>(.*?)<\/p>/is', $html, $matches ) ) {
            foreach ( $matches[1] as $raw ) {
                $text = trim( preg_replace( '/\s+/', ' ', wp_strip_all_tags( html_entity_decode( $raw, ENT_QUOTES | ENT_HTML5 ) ) ) );
                if ( strlen( $text ) >= 50 ) {
                    return $text;
                }
            }
        }
        return '';
    }

    private function is_valid_service_candidate( string $candidate ): bool {
        $candidate = trim( preg_replace( '/\s+/', ' ', $candidate ) );
        if ( '' === $candidate ) {
            return false;
        }

        // Service names should be concise Ã¢â‚¬â€ reject very short or long strings.
        if ( strlen( $candidate ) < 4 || strlen( $candidate ) > 60 ) {
            return false;
        }

        // Reject strings that look like phone numbers.
        if ( preg_match( '/\(?\d{3}\)?[\s\-\.]\d{3}[\s\-\.]\d{4}/', $candidate ) ) {
            return false;
        }
        if ( preg_match( '/^\+?[\d\s\-\.\(\)]{8,}$/', $candidate ) ) {
            return false;
        }

        // Reject strings that look like times or hours.
        if ( preg_match( '/\d{1,2}:\d{2}\s*(?:am|pm)/i', $candidate ) ) {
            return false;
        }

        // Reject multi-sentence text Ã¢â‚¬â€ service names don't have periods.
        if ( substr_count( $candidate, '.' ) > 0 && strlen( $candidate ) > 30 ) {
            return false;
        }

        $blocked_patterns = array(
            '/^(home|about|contact|services|faq|menu|reviews?)$/i',
            '/^recent posts?$/i',
            '/^recent comments?$/i',
            '/^hello world!?$/i',
            '/^archives?$/i',
            '/^categories$/i',
            '/^search$/i',
            '/^uncategorized$/i',
            '/^powered by wordpress$/i',
            '/^proudly powered by wordpress$/i',
            '/^skip to content$/i',
            '/^new patient$/i',
            '/^get started$/i',
            '/^learn more$/i',
            '/^read more$/i',
            '/^click here$/i',
            '/^view all$/i',
            '/^see all$/i',
            '/^submit$/i',
            '/^sign up$/i',
            '/^log ?in$/i',
            '/^call us/i',
            '/^contact us/i',
            '/comments? (are )?closed/i',
            '/skip to/i',
            '/welcome to/i',
        );

        foreach ( $blocked_patterns as $pattern ) {
            if ( preg_match( $pattern, $candidate ) ) {
                return false;
            }
        }

        return true;
    }

    private function infer_industry_from_text( string $text ): string {
        $text = strtolower( $text );

        // Weighted terms improve resilience compared to plain keyword-hit counting.
        $map = array(
            'dental' => array( 'dentist' => 1.2, 'dental' => 1.2, 'orthodont' => 1.0, 'hygienist' => 1.0, 'tooth' => 0.8, 'teeth' => 0.8 ),
            'healthcare' => array( 'clinic' => 1.0, 'medical' => 1.0, 'physician' => 1.0, 'patient care' => 1.0, 'healthcare' => 1.0, 'urgent care' => 1.2 ),
            'personal_injury' => array( 'personal injury' => 1.4, 'injury attorney' => 1.2, 'accident lawyer' => 1.2, 'car accident' => 1.0 ),
            'family_law' => array( 'family law' => 1.4, 'divorce' => 1.2, 'custody' => 1.2, 'child support' => 1.0 ),
            'criminal_law' => array( 'criminal defense' => 1.4, 'dui' => 1.2, 'felony' => 1.0, 'misdemeanor' => 1.0 ),
            'general_law' => array( 'law firm' => 1.2, 'attorney' => 1.0, 'lawyer' => 1.0, 'legal services' => 1.0 ),
            'restaurant' => array( 'restaurant' => 1.2, 'reservation' => 1.0, 'menu' => 0.6, 'dine in' => 1.0, 'takeout' => 0.8, 'catering' => 0.8 ),
            'real_estate' => array( 'real estate' => 1.4, 'realtor' => 1.2, 'mls' => 1.0, 'homes for sale' => 1.0, 'open house' => 1.0 ),
            'home_services' => array( 'roofing' => 1.2, 'plumbing' => 1.2, 'hvac' => 1.2, 'electrician' => 1.0, 'contractor' => 0.8 ),
            'financial' => array( 'financial advisor' => 1.4, 'wealth management' => 1.2, 'retirement planning' => 1.0, 'tax preparation' => 1.0, 'bookkeeping' => 0.8, 'mortgage' => 0.8 ),
            'saas' => array( 'saas' => 1.2, 'software' => 1.0, 'api' => 0.8, 'dashboard' => 0.8, 'platform' => 0.8 ),
            'ecommerce' => array( 'add to cart' => 1.4, 'checkout' => 1.0, 'product catalog' => 1.0, 'shop now' => 1.0, 'free shipping' => 0.8 ),
            'education' => array( 'course' => 1.0, 'academy' => 1.0, 'curriculum' => 1.0, 'enroll' => 1.0, 'student' => 0.8 ),
            'professional' => array( 'consulting' => 1.0, 'professional services' => 1.0, 'advisory' => 1.0, 'strategy' => 0.8 ),
        );

        $scores = array();
        foreach ( $map as $industry => $terms ) {
            $score = 0.0;
            $max   = 0.0;
            foreach ( $terms as $term => $weight ) {
                $max += $weight;
                $pattern = '/\b' . preg_quote( $term, '/' ) . '\b/i';
                $hits = preg_match_all( $pattern, $text, $matches );
                if ( $hits ) {
                    $score += min( $hits, 3 ) * $weight;
                }
            }

            if ( $score > 0.0 ) {
                $scores[ $industry ] = array(
                    'score'      => $score,
                    'confidence' => $max > 0 ? ( $score / $max ) : 0,
                );
            }
        }

        if ( empty( $scores ) ) {
            return 'general';
        }

        uasort(
            $scores,
            static function( array $a, array $b ): int {
                if ( $a['score'] === $b['score'] ) {
                    return $b['confidence'] <=> $a['confidence'];
                }
                return $b['score'] <=> $a['score'];
            }
        );

        $industries = array_keys( $scores );
        $best_key   = $industries[0];
        $best       = $scores[ $best_key ];
        $runner_up  = isset( $industries[1] ) ? $scores[ $industries[1] ] : array( 'score' => 0.0, 'confidence' => 0.0 );

        // Guardrails to reduce false positives on generic websites.
        if ( $best['score'] < 1.5 || $best['confidence'] < 0.14 ) {
            return 'general';
        }
        if ( abs( (float) $best['score'] - (float) $runner_up['score'] ) < 0.25 ) {
            return 'general';
        }

        return $best_key;
    }

    private function extract_site_data(): array {
        $pages = $this->collect_site_pages();
        $combined_text = '';
        $emails = array();
        $phones = array();

        foreach ( $pages as $html ) {
            $combined_text .= "\n" . preg_replace( '/\s+/', ' ', wp_strip_all_tags( $html ) );
            preg_match_all( '/[A-Z0-9._%+\-]+@[A-Z0-9.\-]+\.[A-Z]{2,}/i', $html, $email_matches );
            preg_match_all( '/(?:\+?1[\s\-.]?)?(?:\(?\d{3}\)?[\s\-.]?)\d{3}[\s\-.]?\d{4}/', $html, $phone_matches );
            if ( ! empty( $email_matches[0] ) ) {
                $emails = array_merge( $emails, $email_matches[0] );
            }
            if ( ! empty( $phone_matches[0] ) ) {
                $phones = array_merge( $phones, $phone_matches[0] );
            }
        }

        $homepage = $pages[ home_url( '/' ) ] ?? reset( $pages );
        $title = is_string( $homepage ) ? $this->extract_between_tags( $homepage, 'title' ) : '';

        // Description: meta tag first (most reliable), then WP tagline, then first real paragraph.
        $description = is_string( $homepage ) ? $this->extract_meta_description( $homepage ) : '';
        if ( '' === $description ) {
            $description = trim( (string) get_bloginfo( 'description' ) );
        }
        if ( '' === $description && is_string( $homepage ) ) {
            $description = $this->extract_first_paragraph( $homepage );
        }
        $service_candidates = array();
        if ( preg_match_all( '/<(?:li|h2|h3)[^>]*>(.*?)<\/(?:li|h2|h3)>/is', (string) $homepage, $service_matches ) ) {
            foreach ( $service_matches[1] as $candidate ) {
                $candidate = trim( preg_replace( '/\s+/', ' ', wp_strip_all_tags( html_entity_decode( $candidate, ENT_QUOTES | ENT_HTML5 ) ) ) );
                if ( $this->is_valid_service_candidate( $candidate ) ) {
                    $service_candidates[] = $candidate;
                }
            }
        }

        $service_candidates = array_values( array_unique( $service_candidates ) );
        $service_candidates = array_slice( $service_candidates, 0, 8 );

        $industry = $this->infer_industry_from_text( $combined_text );

        return array(
            'business_name' => get_bloginfo( 'name' ),
            'business_url' => home_url(),
            'description' => $description,
            'email' => ! empty( $emails ) ? sanitize_email( $emails[0] ) : '',
            'phone' => ! empty( $phones ) ? sanitize_text_field( $phones[0] ) : '',
            'services' => ! empty( $service_candidates ) ? implode( ', ', $service_candidates ) : '',
            'industry' => $industry,
            'title_hint' => $title,
        );
    }

    private function get_cached_site_data(): array {
        $cache_key = 'arscan_detected_site_data';
        $cached = get_transient( $cache_key );
        if ( is_array( $cached ) ) {
            return $cached;
        }

        $detected = $this->extract_site_data();
        set_transient( $cache_key, $detected, 30 * MINUTE_IN_SECONDS );
        return $detected;
    }

    private function combined_consistency_issues( array $settings, ?array $detected = null ): array {
        $detected = is_array( $detected ) ? $detected : $this->get_cached_site_data();
        $issues = array_merge(
            ARSCAN_Files::consistency_issues( $settings ),
            ARSCAN_Files::website_conflict_issues( $settings, $detected )
        );

        return array_values( array_unique( array_filter( array_map( 'trim', $issues ) ) ) );
    }

    private function maybe_send_consistency_alert( array $settings, ?array $detected = null ): void {
        $issues = $this->combined_consistency_issues( $settings, $detected );
        if ( empty( $issues ) ) {
            return;
        }

        $hash = md5( (string) wp_json_encode( $issues ) );
        $cache_key = 'arscan_consistency_alert_' . md5( home_url() );
        $last = get_transient( $cache_key );
        if ( is_array( $last ) && ( $last['hash'] ?? '' ) === $hash ) {
            return;
        }
        set_transient(
            $cache_key,
            array(
                'hash' => $hash,
                'at'   => time(),
            ),
            DAY_IN_SECONDS
        );

        $to = array();
        $admin_email = sanitize_email( (string) get_option( 'admin_email', '' ) );
        if ( is_email( $admin_email ) ) {
            $to[] = $admin_email;
        }
        $contact_email = sanitize_email( (string) ( $settings['email'] ?? '' ) );
        if ( is_email( $contact_email ) ) {
            $to[] = $contact_email;
        }
        $to = array_values( array_unique( $to ) );
        if ( empty( $to ) ) {
            return;
        }

        $host = wp_parse_url( home_url(), PHP_URL_HOST );
        $subject = sprintf(
            /* translators: %s: website host */
            __( '[%s] AgentReadyScan detected data conflicts', 'agentreadyscan' ),
            (string) $host
        );

        $lines = array(
            __( 'AgentReadyScan found consistency conflicts between your saved plugin settings and website-detected content.', 'agentreadyscan' ),
            '',
            __( 'Conflicts found:', 'agentreadyscan' ),
        );
        foreach ( $issues as $issue ) {
            $lines[] = '- ' . $issue;
        }
        $lines[] = '';
        $lines[] = __( 'Open Settings > AgentReadyScan in wp-admin, review the conflicts, and republish your files.', 'agentreadyscan' );
        $lines[] = admin_url( 'options-general.php?page=agentreadyscan' );

        wp_mail( $to, $subject, implode( "\n", $lines ) );
    }

    private function build_pro_snapshot_payload( array $settings, ?array $detected = null ): array {
        $detected = is_array( $detected ) ? $detected : $this->get_cached_site_data();
        $qa_pairs = is_array( $settings['qa_pairs'] ?? null ) ? $settings['qa_pairs'] : array();
        $issues   = $this->combined_consistency_issues( $settings, $detected );
        $qa_questions = array();
        foreach ( $qa_pairs as $pair ) {
            if ( ! is_array( $pair ) ) {
                continue;
            }
            $question = sanitize_text_field( (string) ( $pair['q'] ?? '' ) );
            if ( '' !== $question ) {
                $qa_questions[] = $question;
            }
        }
        $qa_questions = array_values( array_unique( $qa_questions ) );
        $agent_facts_preview = ARSCAN_Files::build_agent_facts( $settings );
        $llms_preview = ARSCAN_Files::build_llms_txt( $settings );

        return array(
            'captured_at' => gmdate( 'c' ),
            'settings'    => array(
                'business_name' => sanitize_text_field( (string) ( $settings['business_name'] ?? '' ) ),
                'description'   => sanitize_textarea_field( (string) ( $settings['description'] ?? '' ) ),
                'phone'         => sanitize_text_field( (string) ( $settings['phone'] ?? '' ) ),
                'email'         => sanitize_email( (string) ( $settings['email'] ?? '' ) ),
                'services'      => sanitize_text_field( (string) ( $settings['services'] ?? '' ) ),
                'industry'      => sanitize_key( (string) ( $settings['industry'] ?? 'general' ) ),
                'schema_type'   => sanitize_text_field( (string) ( $settings['schema_type'] ?? '' ) ),
                'qa_count'      => count( $qa_pairs ),
                'qa_questions'  => $qa_questions,
                'explicit_exclusions_count' => count(
                    array_filter(
                        array_map(
                            'trim',
                            preg_split( '/\r\n|\r|\n/', (string) ( $settings['explicit_exclusions'] ?? '' ) ) ?: array()
                        )
                    )
                ),
            ),
            'files'       => array(
                'llms_exists'        => file_exists( ABSPATH . 'llms.txt' ),
                'agent_facts_exists' => file_exists( ABSPATH . 'agent-facts.html' ),
                'agent_facts_preview' => $agent_facts_preview,
                'llms_preview'        => $llms_preview,
            ),
            'detected'    => array(
                'industry'    => sanitize_key( (string) ( $detected['industry'] ?? 'general' ) ),
                'description' => sanitize_textarea_field( (string) ( $detected['description'] ?? '' ) ),
                'services'    => sanitize_text_field( (string) ( $detected['services'] ?? '' ) ),
                'phone'       => sanitize_text_field( (string) ( $detected['phone'] ?? '' ) ),
                'email'       => sanitize_email( (string) ( $detected['email'] ?? '' ) ),
            ),
            'consistency_issues' => array_values( array_map( 'sanitize_text_field', $issues ) ),
        );
    }

    private function apply_pro_health_audit( array $settings, array $audit ): array {
        $settings['pro_health_status'] = sanitize_key( (string) ( $audit['status'] ?? '' ) );
        $settings['pro_health_score'] = isset( $audit['score'] ) ? (string) round( (float) $audit['score'], 1 ) : '';
        $settings['pro_health_checked_at'] = sanitize_text_field( (string) ( $audit['created_at'] ?? current_time( 'mysql' ) ) );
        $findings = is_array( $audit['findings'] ?? null ) ? $audit['findings'] : array();
        $recommendations = is_array( $audit['recommendations'] ?? null ) ? $audit['recommendations'] : array();

        $top_issues = array();
        foreach ( $findings as $finding ) {
            if ( ! is_array( $finding ) ) {
                continue;
            }
            $message = sanitize_text_field( (string) ( $finding['message'] ?? '' ) );
            if ( '' !== $message ) {
                $top_issues[] = $message;
            }
            if ( count( $top_issues ) >= 5 ) {
                break;
            }
        }

        $settings['pro_health_top_issues'] = $top_issues;
        $settings['pro_health_issue_count'] = count( $top_issues );
        $settings['pro_health_recommendations'] = array_values(
            array_slice(
                array_filter(
                    array_map(
                        static function( $item ) {
                            return sanitize_text_field( (string) $item );
                        },
                        $recommendations
                    )
                ),
                0,
                5
            )
        );
        $settings['pro_health_last_error'] = '';

        return $settings;
    }

    private function refresh_pro_health( array $settings, ?array $detected = null ): array {
        if ( empty( $settings['api_key'] ) || 'active' !== ( $settings['license_status'] ?? '' ) ) {
            return $settings;
        }

        $snapshot = $this->build_pro_snapshot_payload( $settings, $detected );
        $sync = ARSCAN_License::sync_pro_snapshot(
            (string) $settings['api_key'],
            $snapshot,
            (string) ARSCAN_Files::settings_hash( $settings )
        );
        if ( is_wp_error( $sync ) ) {
            $settings['pro_health_last_error'] = sanitize_text_field( $sync->get_error_message() );
            return $settings;
        }

        if ( ! empty( $sync['audit'] ) && is_array( $sync['audit'] ) ) {
            return $this->apply_pro_health_audit( $settings, $sync['audit'] );
        }

        $latest = ARSCAN_License::fetch_latest_pro_audit( (string) $settings['api_key'] );
        if ( is_wp_error( $latest ) ) {
            $settings['pro_health_last_error'] = sanitize_text_field( $latest->get_error_message() );
            return $settings;
        }
        if ( ! empty( $latest['audit'] ) && is_array( $latest['audit'] ) ) {
            return $this->apply_pro_health_audit( $settings, $latest['audit'] );
        }

        return $settings;
    }

    private function maybe_populate_pro_exclusions( array $settings ): array {
        if ( 'active' !== ( $settings['license_status'] ?? '' ) ) {
            return $settings;
        }

        $existing = trim( (string) ( $settings['explicit_exclusions'] ?? '' ) );
        if ( '' !== $existing ) {
            return $settings;
        }

        $seed = ARSCAN_Files::seed_exclusions( $settings );
        if ( empty( $seed ) ) {
            return $settings;
        }

        $settings['explicit_exclusions'] = implode(
            "\n",
            array_values(
                array_filter(
                    array_map(
                        static function( $line ) {
                            return sanitize_text_field( (string) $line );
                        },
                        $seed
                    )
                )
            )
        );

        return $settings;
    }

    // -----------------------------------------------------------------------
    // Handle save + regenerate files
    // -----------------------------------------------------------------------

    public function handle_save(): void {
        if ( ! current_user_can( 'manage_options' ) ) {
            wp_die( esc_html__( 'Unauthorized', 'agentreadyscan' ) );
        }
        check_admin_referer( 'arscan_save_settings_action', 'arscan_nonce' );

        // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- entire array sanitized field-by-field inside $this->sanitize()
        $input    = isset( $_POST['arscan_settings'] ) ? wp_unslash( $_POST['arscan_settings'] ) : array();
        $settings = $this->sanitize( $input );
        $detected = $this->extract_site_data();
        set_transient( 'arscan_detected_site_data', $detected, 30 * MINUTE_IN_SECONDS );
        if ( ! empty( $settings['api_key'] ) ) {
            $settings = ARSCAN_License::refresh_license_state( $settings );
            if ( 'active' === ( $settings['license_status'] ?? '' ) ) {
                $seed_source = $settings;
                $seed_source['industry'] = $settings['industry'] ?? 'general';
                $current_pairs = is_array( $settings['qa_pairs'] ?? null ) ? $settings['qa_pairs'] : array();
                if ( count( $current_pairs ) < 12 ) {
                    $settings['qa_pairs'] = ARSCAN_Files::seed_pro_qa_pairs( $seed_source );
                }
                $settings = $this->maybe_populate_pro_exclusions( $settings );
            }
        } else {
            $settings = ARSCAN_License::clear_license_state( $settings, __( 'Pro features are off until you save a valid API key.', 'agentreadyscan' ) );
        }
        $settings['last_written'] = current_time( 'mysql' );

        // Regenerate static files
        $result = ARSCAN_Files::write_all( $settings );
        if ( $result['success'] ) {
            $settings['last_write_hash'] = ARSCAN_Files::settings_hash( $settings );
        }
        $settings = $this->refresh_pro_health( $settings, $detected );
        $this->persist_settings( $settings );
        $this->maybe_send_consistency_alert( $settings, $detected );

        $status = $result['success'] ? 'saved' : 'error';
        $msg    = $result['success']
            ? urlencode( __( 'Settings saved and files updated.', 'agentreadyscan' ) )
            : urlencode( $result['error'] );

        wp_safe_redirect( add_query_arg(
            array( 'page' => 'agentreadyscan', 'arscan_status' => $status, 'arscan_msg' => $msg ),
            admin_url( 'options-general.php' )
        ) );
        exit;
    }

    public function handle_regenerate_files(): void {
        if ( ! current_user_can( 'manage_options' ) ) {
            wp_die( esc_html__( 'Unauthorized', 'agentreadyscan' ) );
        }
        check_admin_referer( 'arscan_regenerate_files_action', 'arscan_regenerate_nonce' );

        $settings = get_option( ARSCAN_OPTION_KEY, arscan_default_settings() );
        $settings = ARSCAN_License::maybe_refresh_license_state( $settings );
        $settings['last_written'] = current_time( 'mysql' );

        $result = ARSCAN_Files::write_all( $settings );
        if ( $result['success'] ) {
            $settings['last_write_hash'] = ARSCAN_Files::settings_hash( $settings );
        }
        $settings = $this->refresh_pro_health( $settings );
        $this->persist_settings( $settings );

        $status = $result['success'] ? 'saved' : 'error';
        $msg    = $result['success']
            ? urlencode( __( 'Files regenerated successfully.', 'agentreadyscan' ) )
            : urlencode( $result['error'] );

        wp_safe_redirect( add_query_arg(
            array( 'page' => 'agentreadyscan', 'arscan_status' => $status, 'arscan_msg' => $msg ),
            admin_url( 'options-general.php' )
        ) );
        exit;
    }

    public function handle_verify_license(): void {
        if ( ! current_user_can( 'manage_options' ) ) {
            wp_die( esc_html__( 'Unauthorized', 'agentreadyscan' ) );
        }
        check_admin_referer( 'arscan_verify_license_action', 'arscan_verify_nonce' );

        // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- only api_key is used; sanitized with sanitize_text_field() on the next line
        $submitted = isset( $_POST['arscan_settings'] ) ? wp_unslash( $_POST['arscan_settings'] ) : array();
        $settings  = wp_parse_args( get_option( ARSCAN_OPTION_KEY, array() ), arscan_default_settings() );
        $settings['api_key'] = isset( $submitted['api_key'] ) ? sanitize_text_field( $submitted['api_key'] ) : '';
        $this->debug_log(
            'verify_start',
            array(
                'api_key_suffix' => substr( $settings['api_key'], -8 ),
                'existing_status' => $settings['license_status'] ?? '',
            )
        );

        if ( empty( $settings['api_key'] ) ) {
            $settings = ARSCAN_License::clear_license_state( $settings, __( 'Enter a Pro API key before verifying.', 'agentreadyscan' ) );
            $this->persist_settings( $settings );
            $this->debug_log( 'verify_missing_key', array( 'saved_status' => $settings['license_status'] ?? '' ) );

            wp_safe_redirect( add_query_arg(
                array(
                    'page' => 'agentreadyscan',
                    'arscan_status' => 'error',
                    'arscan_msg' => urlencode( __( 'Enter a Pro API key before verifying.', 'agentreadyscan' ) ),
                ),
                admin_url( 'options-general.php' )
            ) );
            exit;
        }

        $detected = null;
        $settings = ARSCAN_License::refresh_license_state( $settings );
        if ( 'active' === ( $settings['license_status'] ?? '' ) ) {
            $detected = $this->extract_site_data();

            foreach ( array( 'business_name', 'business_url', 'description', 'email', 'phone', 'services' ) as $field ) {
                if ( ! empty( $detected[ $field ] ) && empty( $settings[ $field ] ) ) {
                    $settings[ $field ] = $detected[ $field ];
                }
            }

            if ( ! empty( $detected['industry'] ) && 'general' !== $detected['industry'] && 'general' === ( $settings['industry'] ?? 'general' ) ) {
                $settings['industry'] = $detected['industry'];
                if ( empty( $settings['schema_type'] ) || 'Organization' === ( $settings['schema_type'] ?? '' ) ) {
                    $settings['schema_type'] = arscan_default_schema_type_for_industry( $detected['industry'] );
                }
            }

            $seed_source = $settings;
            $seed_source['industry'] = $settings['industry'] ?? 'general';
            $settings['qa_pairs'] = ARSCAN_Files::seed_pro_qa_pairs( $seed_source );
            $settings = $this->maybe_populate_pro_exclusions( $settings );
        }
        $settings = $this->refresh_pro_health( $settings, $detected );
        $this->debug_log(
            'verify_after_refresh',
            array(
                'license_status' => $settings['license_status'] ?? '',
                'license_message' => $settings['license_message'] ?? '',
                'license_checked_at' => $settings['license_checked_at'] ?? '',
                'renewal_date' => $settings['license_renewal_date'] ?? '',
            )
        );
        $this->persist_settings( $settings );
        $persisted = get_option( ARSCAN_OPTION_KEY, array() );
        $this->debug_log(
            'verify_after_persist',
            array(
                'persisted_status' => $persisted['license_status'] ?? '',
                'persisted_checked_at' => $persisted['license_checked_at'] ?? '',
                'persisted_renewal_date' => $persisted['license_renewal_date'] ?? '',
                'persisted_api_key_suffix' => ! empty( $persisted['api_key'] ) ? substr( $persisted['api_key'], -8 ) : '',
            )
        );

        $status = ( 'active' === ( $settings['license_status'] ?? '' ) ) ? 'saved' : 'error';
        $msg    = urlencode(
            'active' === ( $settings['license_status'] ?? '' )
                ? __( 'Pro license active. AgentReadyScan rebuilt the Golden Questions from the current site and industry.', 'agentreadyscan' )
                : ( $settings['license_message'] ?? __( 'License check complete.', 'agentreadyscan' ) )
        );

        wp_safe_redirect( add_query_arg(
            array(
                'page' => 'agentreadyscan',
                'arscan_status' => $status,
                'arscan_msg' => $msg,
            ),
            admin_url( 'options-general.php' )
        ) );
        exit;
    }

    public function handle_sync_license(): void {
        if ( ! current_user_can( 'manage_options' ) ) {
            wp_die( esc_html__( 'Unauthorized', 'agentreadyscan' ) );
        }
        check_admin_referer( 'arscan_sync_license_action', 'arscan_sync_nonce' );

        $settings = get_option( ARSCAN_OPTION_KEY, arscan_default_settings() );
        if ( empty( $settings['api_key'] ) ) {
            wp_safe_redirect( add_query_arg(
                array(
                    'page' => 'agentreadyscan',
                    'arscan_status' => 'error',
                    'arscan_msg' => urlencode( __( 'Enter a Pro API key before syncing.', 'agentreadyscan' ) ),
                ),
                admin_url( 'options-general.php' )
            ) );
            exit;
        }

        $settings = ARSCAN_License::refresh_license_state( $settings );
        if ( 'active' === ( $settings['license_status'] ?? '' ) ) {
            $seed_source = $settings;
            $seed_source['industry'] = arscan_effective_industry();
            $settings['qa_pairs'] = ARSCAN_Files::seed_pro_qa_pairs( $seed_source );
            $settings = $this->maybe_populate_pro_exclusions( $settings );
        }
        $settings = $this->refresh_pro_health( $settings );
        $this->persist_settings( $settings );

        $status = ( 'active' === ( $settings['license_status'] ?? '' ) ) ? 'saved' : 'error';
        $msg    = urlencode( $settings['license_message'] ?? __( 'License sync complete.', 'agentreadyscan' ) );

        wp_safe_redirect( add_query_arg(
            array( 'page' => 'agentreadyscan', 'arscan_status' => $status, 'arscan_msg' => $msg ),
            admin_url( 'options-general.php' )
        ) );
        exit;
    }

    public function handle_load_site_data(): void {
        if ( ! current_user_can( 'manage_options' ) ) {
            wp_die( esc_html__( 'Unauthorized', 'agentreadyscan' ) );
        }
        check_admin_referer( 'arscan_load_site_data_action', 'arscan_load_site_data_nonce' );

        $settings = wp_parse_args( get_option( ARSCAN_OPTION_KEY, array() ), arscan_default_settings() );
        $settings = ARSCAN_License::maybe_refresh_license_state( $settings );
        $detected = $this->extract_site_data();
        set_transient( 'arscan_detected_site_data', $detected, 30 * MINUTE_IN_SECONDS );

        foreach ( array( 'business_name', 'business_url', 'description', 'email', 'phone', 'services' ) as $field ) {
            if ( ! empty( $detected[ $field ] ) ) {
                $settings[ $field ] = $detected[ $field ];
            }
        }

        if ( ! empty( $detected['industry'] ) && 'general' === ( $settings['industry'] ?? 'general' ) ) {
            $settings['industry'] = $detected['industry'];
            if ( empty( $settings['schema_type'] ) || 'Organization' === ( $settings['schema_type'] ?? '' ) ) {
                $settings['schema_type'] = arscan_default_schema_type_for_industry( $detected['industry'] );
            }
        }
        if ( 'active' === ( $settings['license_status'] ?? '' ) ) {
            $seed_source = $settings;
            $seed_source['industry'] = arscan_effective_industry();
            $settings['qa_pairs'] = ARSCAN_Files::seed_pro_qa_pairs( $seed_source );
            $settings = $this->maybe_populate_pro_exclusions( $settings );
        } else {
            $settings['qa_pairs'] = ARSCAN_Files::seed_qa_pairs( $settings );
        }

        $settings = $this->refresh_pro_health( $settings, $detected );
        $this->persist_settings( $settings );
        $this->maybe_send_consistency_alert( $settings, $detected );

        wp_safe_redirect( add_query_arg(
            array(
                'page' => 'agentreadyscan',
                'arscan_status' => 'saved',
                'arscan_msg' => urlencode( __( 'Loaded available business data from the existing site.', 'agentreadyscan' ) ),
            ),
            admin_url( 'options-general.php' )
        ) );
        exit;
    }

    public function handle_refresh_golden_questions(): void {
        if ( ! current_user_can( 'manage_options' ) ) {
            wp_die( esc_html__( 'Unauthorized', 'agentreadyscan' ) );
        }
        check_admin_referer( 'arscan_refresh_golden_questions_action', 'arscan_refresh_golden_questions_nonce' );

        $settings = wp_parse_args( get_option( ARSCAN_OPTION_KEY, array() ), arscan_default_settings() );
        $seed_source = $settings;
        $seed_source['industry'] = arscan_effective_industry();
        if ( 'active' === ( $settings['license_status'] ?? '' ) ) {
            $settings['qa_pairs'] = ARSCAN_Files::seed_pro_qa_pairs( $seed_source );
            $settings = $this->maybe_populate_pro_exclusions( $settings );
        } else {
            $settings['qa_pairs'] = ARSCAN_Files::seed_qa_pairs( $seed_source );
        }
        $this->persist_settings( $settings );

        wp_safe_redirect( add_query_arg(
            array(
                'page' => 'agentreadyscan',
                'arscan_status' => 'saved',
                'arscan_msg' => urlencode( __( 'Golden Questions rebuilt from the current industry template.', 'agentreadyscan' ) ),
            ),
            admin_url( 'options-general.php' )
        ) );
        exit;
    }

    public function handle_prepare_pro_setup(): void {
        if ( ! current_user_can( 'manage_options' ) ) {
            wp_die( esc_html__( 'Unauthorized', 'agentreadyscan' ) );
        }
        check_admin_referer( 'arscan_prepare_pro_setup_action', 'arscan_prepare_pro_setup_nonce' );

        $settings = wp_parse_args( get_option( ARSCAN_OPTION_KEY, array() ), arscan_default_settings() );
        $detected = $this->extract_site_data();
        set_transient( 'arscan_detected_site_data', $detected, 30 * MINUTE_IN_SECONDS );

        foreach ( array( 'business_name', 'business_url', 'description', 'email', 'phone', 'services' ) as $field ) {
            if ( ! empty( $detected[ $field ] ) ) {
                $settings[ $field ] = $detected[ $field ];
            }
        }

        if ( ! empty( $detected['industry'] ) && 'general' === ( $settings['industry'] ?? 'general' ) ) {
            $settings['industry'] = $detected['industry'];
            if ( empty( $settings['schema_type'] ) || 'Organization' === ( $settings['schema_type'] ?? '' ) ) {
                $settings['schema_type'] = arscan_default_schema_type_for_industry( $detected['industry'] );
            }
        }

        if ( ! empty( $settings['api_key'] ) ) {
            $settings = ARSCAN_License::refresh_license_state( $settings );
        }

        $seed_source = $settings;
        $seed_source['industry'] = arscan_effective_industry();
        if ( 'active' === ( $settings['license_status'] ?? '' ) ) {
            $settings['qa_pairs'] = ARSCAN_Files::seed_pro_qa_pairs( $seed_source );
            $settings = $this->maybe_populate_pro_exclusions( $settings );
        } else {
            $settings['qa_pairs'] = ARSCAN_Files::seed_qa_pairs( $seed_source );
        }
        $settings['last_written'] = current_time( 'mysql' );

        $result = ARSCAN_Files::write_all( $settings );
        if ( $result['success'] ) {
            $settings['last_write_hash'] = ARSCAN_Files::settings_hash( $settings );
        }
        $settings = $this->refresh_pro_health( $settings, $detected );
        $this->persist_settings( $settings );
        $this->maybe_send_consistency_alert( $settings, $detected );

        $status = $result['success'] ? 'saved' : 'error';
        $msg    = $result['success']
            ? urlencode( __( 'Pro setup loaded site data, rebuilt Golden Questions, and republished your AI files.', 'agentreadyscan' ) )
            : urlencode( $result['error'] );

        wp_safe_redirect( add_query_arg(
            array(
                'page' => 'agentreadyscan',
                'arscan_status' => $status,
                'arscan_msg' => $msg,
            ),
            admin_url( 'options-general.php' )
        ) );
        exit;
    }

    public function handle_manage_billing(): void {
        if ( ! current_user_can( 'manage_options' ) ) {
            wp_die( esc_html__( 'Unauthorized', 'agentreadyscan' ) );
        }
        check_admin_referer( 'arscan_manage_billing_action', 'arscan_manage_billing_nonce' );

        $settings = wp_parse_args( get_option( ARSCAN_OPTION_KEY, array() ), arscan_default_settings() );
        if ( empty( $settings['api_key'] ) ) {
            wp_safe_redirect( add_query_arg(
                array(
                    'page' => 'agentreadyscan',
                    'arscan_status' => 'error',
                    'arscan_msg' => urlencode( __( 'No Pro License key is saved for this site.', 'agentreadyscan' ) ),
                ),
                admin_url( 'options-general.php' )
            ) );
            exit;
        }

        $result = ARSCAN_License::create_billing_portal_session( $settings['api_key'] );
        if ( is_wp_error( $result ) || empty( $result['portal_url'] ) ) {
            $message = is_wp_error( $result )
                ? $result->get_error_message()
                : ( $result['error'] ?? __( 'Could not open the Stripe billing portal.', 'agentreadyscan' ) );

            wp_safe_redirect( add_query_arg(
                array(
                    'page' => 'agentreadyscan',
                    'arscan_status' => 'error',
                    'arscan_msg' => urlencode( $message ),
                ),
                admin_url( 'options-general.php' )
            ) );
            exit;
        }

        wp_safe_redirect( esc_url_raw( $result['portal_url'] ) );
        exit;
    }

    // -----------------------------------------------------------------------
    // Admin notices
    // -----------------------------------------------------------------------

    public function admin_notices(): void {
        // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- read-only display of result from a prior nonce-verified POST redirect
        $status = isset( $_GET['arscan_status'] ) ? sanitize_key( wp_unslash( $_GET['arscan_status'] ) ) : '';
        if ( empty( $status ) ) {
            return;
        }
        // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- read-only display of result from a prior nonce-verified POST redirect
        $msg = isset( $_GET['arscan_msg'] ) ? sanitize_text_field( wp_unslash( $_GET['arscan_msg'] ) ) : '';
        $class  = ( 'saved' === $status ) ? 'notice-success' : 'notice-error';
        printf( '<div class="notice %s is-dismissible"><p>%s</p></div>', esc_attr( $class ), esc_html( $msg ) );
    }

    // -----------------------------------------------------------------------
    // Styles
    // -----------------------------------------------------------------------

    public function enqueue_styles( $hook ): void {
        if ( 'settings_page_agentreadyscan' === $hook ) {
            wp_enqueue_style(
                'arscan-admin',
                plugins_url( 'assets/admin.css', ARSCAN_PLUGIN_FILE ),
                array(),
                ARSCAN_VERSION
            );
            wp_enqueue_script(
                'arscan-admin',
                plugins_url( 'assets/admin.js', ARSCAN_PLUGIN_FILE ),
                array( 'jquery' ),
                ARSCAN_VERSION,
                true
            );
            wp_localize_script(
                'arscan-admin',
                'arscanAdmin',
                array(
                    'dismissUpsellNonce' => wp_create_nonce( 'arscan_dismiss_upsell' ),
                )
            );
            return;
        }

        if ( 'plugins.php' === $hook ) {
            wp_enqueue_style(
                'arscan-deactivation-modal',
                plugins_url( 'assets/deactivation-modal.css', ARSCAN_PLUGIN_FILE ),
                array(),
                ARSCAN_VERSION
            );
            wp_enqueue_script(
                'arscan-deactivation-modal',
                plugins_url( 'assets/deactivation-modal.js', ARSCAN_PLUGIN_FILE ),
                array(),
                ARSCAN_VERSION,
                true
            );
            wp_localize_script(
                'arscan-deactivation-modal',
                'arscanDeactivate',
                array(
                    'nonce' => wp_create_nonce( 'arscan_deactivation_survey' ),
                )
            );
        }
    }

    // -----------------------------------------------------------------------
    // Render page
    // -----------------------------------------------------------------------

    private function format_file_timestamp( string $path ): string {
        if ( ! file_exists( $path ) ) {
            return __( 'Not generated yet', 'agentreadyscan' );
        }

        $timestamp = filemtime( $path );
        if ( false === $timestamp ) {
            return __( 'Generated, timestamp unavailable', 'agentreadyscan' );
        }

        return wp_date( 'Y-m-d H:i:s', $timestamp );
    }

    private function build_loaded_facts( array $s ): array {
        return array(
            __( 'Business name', 'agentreadyscan' ) => $s['business_name'] ?: '-',
            __( 'Website', 'agentreadyscan' ) => $s['business_url'] ?: '-',
            __( 'Phone', 'agentreadyscan' ) => $s['phone'] ?: '-',
            __( 'Email', 'agentreadyscan' ) => $s['email'] ?: '-',
            __( 'Address', 'agentreadyscan' ) => trim( implode( ', ', array_filter( array( $s['address'], $s['city'], $s['state'], $s['zip'] ) ) ) ) ?: '-',
            __( 'Hours', 'agentreadyscan' ) => $s['hours'] ?: '-',
            __( 'Industry', 'agentreadyscan' ) => arscan_effective_industry(),
            __( 'Schema type', 'agentreadyscan' ) => arscan_effective_schema_type(),
        );
    }

    private function build_robots_preview( array $s ): string {
        if ( empty( $s['inject_robots'] ) ) {
            return __( 'robots.txt AI crawler permissions are currently disabled.', 'agentreadyscan' );
        }

        $lines = array(
            'User-agent: *',
            'Allow: /',
            '',
            '# AI crawlers explicitly allowed',
            '# OpenAI',
            'User-agent: GPTBot',
            'Allow: /',
            'User-agent: ChatGPT-User',
            'Allow: /',
            'User-agent: OAI-SearchBot',
            'Allow: /',
            '',
            '# Anthropic',
            'User-agent: ClaudeBot',
            'Allow: /',
            'User-agent: anthropic-ai',
            'Allow: /',
            '',
            '# Perplexity',
            'User-agent: PerplexityBot',
            'Allow: /',
            '',
            '# Google AI training and retrieval',
            'User-agent: Google-Extended',
            'Allow: /',
            '',
            '# Meta',
            'User-agent: meta-externalagent',
            'Allow: /',
            '',
            '# Common Crawl',
            'User-agent: CCBot',
            'Allow: /',
            '',
            '# ByteDance',
            'User-agent: Bytespider',
            'Allow: /',
            '',
            '# Cohere',
            'User-agent: cohere-ai',
            'Allow: /',
            '',
            '# You.com',
            'User-agent: YouBot',
            'Allow: /',
            '',
            '# Apple',
            'User-agent: Applebot',
            'Allow: /',
            '',
            'Sitemap: ' . home_url( '/sitemap.xml' ),
        );

        if ( ! empty( $s['write_llms_txt'] ) || ! empty( $s['write_agent_facts'] ) ) {
            $lines[] = '';
            $lines[] = '# AI-facing public files';
            if ( ! empty( $s['write_llms_txt'] ) ) {
                $lines[] = '# ' . home_url( '/llms.txt' );
            }
            if ( ! empty( $s['write_agent_facts'] ) ) {
                $lines[] = '# ' . home_url( '/agent-facts.html' );
            }
        }

        return implode( "\n", $lines );
    }

    private function exclusion_examples( string $industry ): string {
        $examples = array(
            'personal_injury' => __( 'Example: We do not handle divorce cases. We do not give legal advice over the phone. We do not practice outside Illinois.', 'agentreadyscan' ),
            'family_law'      => __( 'Example: We do not handle criminal defense cases. We do not guarantee outcomes. We do not accept matters outside our licensed states.', 'agentreadyscan' ),
            'criminal_law'    => __( 'Example: We do not handle divorce cases. We do not guarantee dismissals. We do not provide legal advice without an engagement.', 'agentreadyscan' ),
            'dental'          => __( 'Example: We do not provide emergency medical care. We do not confirm insurance coverage without verification. We do not publish exact treatment pricing unless listed here.', 'agentreadyscan' ),
            'healthcare'      => __( 'Example: We do not provide emergency room services. We do not diagnose patients over email. We do not confirm insurance acceptance without verification.', 'agentreadyscan' ),
            'home_services'   => __( 'Example: We do not service areas not listed here. We do not guarantee same-day appointments unless posted. We do not perform trades outside our listed services.', 'agentreadyscan' ),
            'financial'       => __( 'Example: We do not promise returns. We do not give tax advice unless stated. We do not serve clients in states where we are not authorized.', 'agentreadyscan' ),
        );

        return $examples[ $industry ] ?? __( 'Example: We do not offer services not listed here. We do not serve locations not published on this site. We do not guarantee pricing, availability, or outcomes unless explicitly stated.', 'agentreadyscan' );
    }

    public function render_page(): void {
        if ( ! current_user_can( 'manage_options' ) ) {
            return;
        }
        wp_cache_delete( ARSCAN_OPTION_KEY, 'options' );
        wp_cache_delete( 'alloptions', 'options' );
        $s      = get_option( ARSCAN_OPTION_KEY, arscan_default_settings() );
        $refreshed = ARSCAN_License::maybe_refresh_license_state( $s );
        if ( $refreshed !== $s ) {
            $this->persist_settings( $refreshed );
            $s = $refreshed;
            wp_cache_delete( ARSCAN_OPTION_KEY, 'options' );
            wp_cache_delete( 'alloptions', 'options' );
        }
        $is_pro = arscan_is_pro();
        $license_status = $s['license_status'] ?? 'inactive';
        $license_features = ! empty( $s['license_features'] ) && is_array( $s['license_features'] ) ? $s['license_features'] : array();

        $industries = array(
            'general'           => 'General Business',
            'dental'            => 'Dental',
            'healthcare'        => 'General Healthcare',
            'personal_injury'   => 'Personal Injury Law',
            'family_law'        => 'Family Law',
            'criminal_law'      => 'Criminal Law',
            'general_law'       => 'General Law',
            'restaurant'        => 'Restaurant / Food',
            'real_estate'       => 'Real Estate',
            'home_services'     => 'Home Services',
            'financial'         => 'Financial Services',
            'saas'              => 'SaaS / Technology',
            'ecommerce'         => 'E-commerce / Retail',
            'education'         => 'Education',
            'professional'      => 'Professional Services',
        );

        $schema_types = array(
            'LocalBusiness'     => 'LocalBusiness (general)',
            'MedicalBusiness'   => 'MedicalBusiness (healthcare/dental)',
            'LegalService'      => 'LegalService (law firm)',
            'Restaurant'        => 'Restaurant',
            'RealEstateAgent'   => 'RealEstateAgent',
            'HomeAndConstructionBusiness' => 'HomeAndConstructionBusiness',
            'FinancialService'  => 'FinancialService',
            'SoftwareApplication' => 'SoftwareApplication (SaaS)',
            'Store'             => 'Store (e-commerce)',
            'EducationalOrganization' => 'EducationalOrganization',
            'ProfessionalService' => 'ProfessionalService',
        );

        // File status check
        $llms_exists  = file_exists( ABSPATH . 'llms.txt' );
        $facts_exists = file_exists( ABSPATH . 'agent-facts.html' );
        $preview_error = '';
        try {
            $llms_preview = ARSCAN_Files::build_llms_txt( $s );
            $facts_preview = ARSCAN_Files::build_agent_facts( $s );
        } catch ( \Throwable $e ) {
            $preview_error = $e->getMessage();
            $llms_preview = __( 'Preview unavailable due to a generation error.', 'agentreadyscan' );
            $facts_preview = __( 'Preview unavailable due to a generation error.', 'agentreadyscan' );
        }
        $robots_preview = $this->build_robots_preview( $s );
        $qa_pairs = ! empty( $s['qa_pairs'] ) ? $s['qa_pairs'] : ARSCAN_Files::seed_qa_pairs( $s );
        $schema_value = arscan_effective_schema_type();
        ?>
        <div class="wrap ars-wrap">

            <div class="ars-logo">
                <h1>AgentReadyScan <span class="ars-badge">AI Visibility</span></h1>
            </div>

            <?php if ( '' !== $preview_error ) : ?>
            <div class="notice notice-error"><p><?php
                /* translators: %s: error message text */
                echo esc_html( sprintf( __( 'AgentReadyScan preview error: %s', 'agentreadyscan' ), $preview_error ) ); ?></p></div>
            <?php endif; ?>

            <?php if ( ! $is_pro && ! get_user_meta( get_current_user_id(), 'arscan_upsell_dismissed', true ) ) : ?>
            <div class="ars-upsell-banner">
                <p>
                    <strong>Ready for more control?</strong>
                    Upgrade to Pro for just $99/year for license-backed sync, hosted rule updates, and ongoing verification for one WordPress site.
                </p>
                <a class="ars-cta" href="https://agentreadyscan.com/pricing.html" target="_blank" rel="noopener">Upgrade to Pro - $99/year &rarr;</a>
                <a class="ars-dismiss-upsell" href="#" title="Dismiss">&times;</a>
            </div>
            <?php endif; ?>

            <!-- Pro License Section -->
            <div class="ars-pro-section">
                <h2>AgentReadyScan Pro License <span class="ars-pro-badge">Pro</span></h2>
                <?php if ( $is_pro ) : ?>
                    <div class="ars-pro-active">&#10003; Pro license active. This site can use API-backed sync, hosted rule updates, and billing-managed service features.</div>
                <?php elseif ( 'error' === $license_status ) : ?>
                    <div class="ars-pro-error"><?php echo esc_html( $s['license_message'] ?? __( 'We could not reach the AgentReadyScan API.', 'agentreadyscan' ) ); ?></div>
                <?php elseif ( ! empty( $s['api_key'] ) ) : ?>
                    <div class="ars-pro-warning"><?php echo esc_html( $s['license_message'] ?? __( 'Saved API key is not active yet.', 'agentreadyscan' ) ); ?></div>
                <?php else : ?>
                    <p style="margin:0 0 12px;font-size:13px;">Enter your Pro API key to connect this site to the optional AgentReadyScan service for license-backed sync, hosted rule updates, and ongoing verification. Each Pro License covers one WordPress site. Upgrade on the website for $99/year if you still need a license.</p>
                <?php endif; ?>
                <form method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>">
                    <input type="hidden" name="action" value="arscan_verify_license">
                    <?php wp_nonce_field( 'arscan_verify_license_action', 'arscan_verify_nonce' ); ?>
                    <div class="ars-field" style="max-width:460px;">
                        <label for="arscan_api_key" style="font-weight:600;font-size:13px;display:block;margin-bottom:4px;"><?php esc_html_e( 'Pro License Key', 'agentreadyscan' ); ?></label>
                        <input type="text" id="arscan_api_key" name="arscan_settings[api_key]"
                               class="ars-key-input" style="width:100%;box-sizing:border-box;"
                               placeholder="arscan_live_xxxxxxxxxxxxxxxxxxxx"
                               value="<?php echo esc_attr( $s['api_key'] ?? '' ); ?>">
                    </div>
                    <p style="margin:10px 0 0; display:flex; gap:10px; flex-wrap:wrap;">
                        <button type="submit" class="button button-secondary"><?php esc_html_e( 'Verify License', 'agentreadyscan' ); ?></button>
                        <?php if ( ! $is_pro ) : ?>
                        <a class="button button-primary" href="https://www.agentreadyscan.com/pricing.html?checkout=1" target="_blank" rel="noopener"><?php esc_html_e( 'Purchase Pro License - $99/year', 'agentreadyscan' ); ?></a>
                        <?php endif; ?>
                        <?php if ( $is_pro ) : ?>
                        <button type="submit" class="button" form="ars-manage-billing-form"><?php esc_html_e( 'Manage Billing / Cancel', 'agentreadyscan' ); ?></button>
                        <?php endif; ?>
                    </p>
                    <p style="margin:8px 0 0;font-size:12px;color:#7c2d12;"><?php esc_html_e( 'Single-site annual subscription. Buy one Pro License per WordPress site.', 'agentreadyscan' ); ?></p>
                    <?php if ( $is_pro ) : ?>
                        <p style="margin:8px 0 0;font-size:12px;color:#7c2d12;"><?php esc_html_e( 'Cancellation is handled through Stripe billing, not inside WordPress settings.', 'agentreadyscan' ); ?></p>
                    <?php endif; ?>
                    <?php if ( ! empty( $s['api_key'] ) ) : ?>
                    <dl class="ars-meta-list">
                        <dt><?php esc_html_e( 'Status', 'agentreadyscan' ); ?></dt>
                        <dd><?php echo esc_html( ucfirst( (string) $license_status ) ); ?></dd>
                        <dt><?php esc_html_e( 'Last checked', 'agentreadyscan' ); ?></dt>
                        <dd><?php echo esc_html( ! empty( $s['license_checked_at'] ) ? $s['license_checked_at'] : __( 'Not checked yet', 'agentreadyscan' ) ); ?></dd>
                        <dt><?php esc_html_e( 'Renewal date', 'agentreadyscan' ); ?></dt>
                        <dd><?php echo esc_html( ! empty( $s['license_renewal_date'] ) ? $s['license_renewal_date'] : '-' ); ?></dd>
                        <dt><?php esc_html_e( 'Last sync', 'agentreadyscan' ); ?></dt>
                        <dd><?php echo esc_html( ! empty( $s['license_last_sync_at'] ) ? $s['license_last_sync_at'] : __( 'No sync yet', 'agentreadyscan' ) ); ?></dd>
                    </dl>
                    <?php if ( ! empty( $s['license_last_sync_message'] ) ) : ?>
                        <p style="margin:12px 0 0;"><?php echo esc_html( $s['license_last_sync_message'] ); ?></p>
                    <?php endif; ?>
                    <?php if ( $is_pro ) : ?>
                        <div class="ars-pro-health" style="margin-top:14px;padding:12px;border:1px solid #d1d5db;border-radius:8px;background:#fff;">
                            <h3 style="margin:0 0 8px;"><?php esc_html_e( 'Pro Health Snapshot', 'agentreadyscan' ); ?></h3>
                            <p style="margin:0 0 8px;font-size:13px;">
                                <?php
                                $score = isset( $s['pro_health_score'] ) && '' !== (string) $s['pro_health_score'] ? (string) $s['pro_health_score'] : 'N/A';
                                $checked = ! empty( $s['pro_health_checked_at'] ) ? (string) $s['pro_health_checked_at'] : __( 'Not available yet', 'agentreadyscan' );
                                /* translators: 1: Pro health score value, 2: Last audit timestamp. */
                                echo esc_html( sprintf( __( 'Score: %1$s / 100 | Last audit: %2$s', 'agentreadyscan' ), $score, $checked ) );
                                ?>
                            </p>
                            <?php if ( ! empty( $s['pro_health_last_error'] ) ) : ?>
                                <p style="margin:0 0 8px;color:#b91c1c;"><?php echo esc_html( $s['pro_health_last_error'] ); ?></p>
                            <?php endif; ?>
                            <?php
                            $pro_issues = is_array( $s['pro_health_top_issues'] ?? null ) ? $s['pro_health_top_issues'] : array();
                            $pro_recs = is_array( $s['pro_health_recommendations'] ?? null ) ? $s['pro_health_recommendations'] : array();
                            ?>
                            <?php if ( ! empty( $pro_issues ) ) : ?>
                                <p style="margin:0 0 4px;font-weight:600;"><?php esc_html_e( 'Top issues', 'agentreadyscan' ); ?></p>
                                <ul style="margin:0 0 8px 18px;">
                                    <?php foreach ( $pro_issues as $issue ) : ?>
                                        <li><?php echo esc_html( (string) $issue ); ?></li>
                                    <?php endforeach; ?>
                                </ul>
                            <?php endif; ?>
                            <?php if ( ! empty( $pro_recs ) ) : ?>
                                <p style="margin:0 0 4px;font-weight:600;"><?php esc_html_e( 'Recommended fixes', 'agentreadyscan' ); ?></p>
                                <ul style="margin:0 0 0 18px;">
                                    <?php foreach ( $pro_recs as $rec ) : ?>
                                        <li><?php echo esc_html( (string) $rec ); ?></li>
                                    <?php endforeach; ?>
                                </ul>
                            <?php endif; ?>
                        </div>
                    <?php endif; ?>
                    <?php if ( ! empty( $license_features ) ) : ?>
                        <div class="ars-pill-list">
                            <?php foreach ( $license_features as $feature ) : ?>
                                <span class="ars-pill"><?php echo esc_html( ucwords( str_replace( '_', ' ', $feature ) ) ); ?></span>
                            <?php endforeach; ?>
                        </div>
                    <?php endif; ?>
                    <?php endif; ?>
                    <!-- Pass all current settings along so saving the key doesn't wipe other fields -->
                    <?php foreach ( $s as $k => $v ) : ?>
                        <?php if ( in_array( $k, array( 'api_key', 'license_status', 'license_message', 'license_checked_at', 'license_renewal_date', 'license_error_code', 'license_last_sync_at', 'license_last_sync_message', 'license_features', 'pro_health_status', 'pro_health_score', 'pro_health_checked_at', 'pro_health_issue_count', 'pro_health_top_issues', 'pro_health_recommendations', 'pro_health_last_error' ), true ) ) continue; ?>
                        <?php if ( is_array( $v ) ) : ?>
                            <?php foreach ( $v as $i => $pair ) : ?>
                                <input type="hidden" name="arscan_settings[<?php echo esc_attr( $k ); ?>][<?php echo absint( $i ); ?>][q]" value="<?php echo esc_attr( $pair['q'] ?? '' ); ?>">
                                <input type="hidden" name="arscan_settings[<?php echo esc_attr( $k ); ?>][<?php echo absint( $i ); ?>][a]" value="<?php echo esc_attr( $pair['a'] ?? '' ); ?>">
                            <?php endforeach; ?>
                        <?php elseif ( is_bool( $v ) || in_array( $k, array( 'inject_jsonld', 'inject_robots', 'write_llms_txt', 'write_agent_facts' ), true ) ) : ?>
                            <?php if ( $v ) : ?><input type="hidden" name="arscan_settings[<?php echo esc_attr( $k ); ?>]" value="1"><?php endif; ?>
                        <?php else : ?>
                            <input type="hidden" name="arscan_settings[<?php echo esc_attr( $k ); ?>]" value="<?php echo esc_attr( (string) $v ); ?>">
                        <?php endif; ?>
                    <?php endforeach; ?>
                </form>
                <?php if ( $is_pro ) : ?>
                <form id="ars-manage-billing-form" method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>" style="display:none;">
                    <input type="hidden" name="action" value="arscan_manage_billing">
                    <?php wp_nonce_field( 'arscan_manage_billing_action', 'arscan_manage_billing_nonce' ); ?>
                </form>
                <?php endif; ?>
            </div>

            <div class="ars-scan-bar">
                <form method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>" style="display:inline;">
                    <input type="hidden" name="action" value="arscan_prepare_pro_setup">
                    <?php wp_nonce_field( 'arscan_prepare_pro_setup_action', 'arscan_prepare_pro_setup_nonce' ); ?>
                    <button type="submit" class="button button-secondary"><?php esc_html_e( 'Re-Scan Website', 'agentreadyscan' ); ?></button>
                </form>
                <span class="ars-detected-industry">
                    <?php
                    $detected_label = $industries[ arscan_effective_industry() ] ?? esc_html__( 'General Business', 'agentreadyscan' );
                    echo esc_html( sprintf( 'Detected: %s  &bull;  Schema: %s', $detected_label, arscan_effective_schema_type() ) );
                    ?>
                </span>
            </div>


            <?php if ( ! ARSCAN_Files::is_in_sync( $s ) && ( $llms_exists || $facts_exists ) ) : ?>
            <div class="ars-pro-warning" style="display:flex;align-items:center;justify-content:space-between;gap:12px;margin-bottom:16px;">
                <span>
                    <strong><?php esc_html_e( 'Drift detected.', 'agentreadyscan' ); ?></strong>
                    <?php esc_html_e( 'Your settings have changed since the files were last published. AI crawlers are still reading the old version. Republish to push the latest data.', 'agentreadyscan' ); ?>
                </span>
                <form method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>" style="flex-shrink:0;margin:0;">
                    <input type="hidden" name="action" value="arscan_regenerate_files">
                    <?php wp_nonce_field( 'arscan_regenerate_files_action', 'arscan_regenerate_nonce' ); ?>
                    <button type="submit" class="button" style="background:#9a3412;border-color:#7c2d12;color:#fff;"><?php esc_html_e( 'Republish Now', 'agentreadyscan' ); ?></button>
                </form>
            </div>
            <?php endif; ?>
            <?php
            $consistency_issues = $this->combined_consistency_issues( $s );
            if ( ! empty( $consistency_issues ) ) :
            ?>
            <div class="ars-pro-warning" style="margin-bottom:16px;">
                <strong><?php esc_html_e( 'Consistency issues found:', 'agentreadyscan' ); ?></strong>
                <ul style="margin:8px 0 0;padding-left:18px;">
                    <?php foreach ( $consistency_issues as $issue ) : ?>
                    <li style="margin-bottom:4px;"><?php echo esc_html( $issue ); ?></li>
                    <?php endforeach; ?>
                </ul>
            </div>
            <?php endif; ?>

            <div class="ars-section">
                <h2><?php esc_html_e( 'Published Files and Previews', 'agentreadyscan' ); ?></h2>
                <div class="ars-file-grid">
                    <div class="ars-dashboard-card">
                        <h3><?php esc_html_e( 'llms.txt', 'agentreadyscan' ); ?></h3>
                        <p class="ars-preview-meta">
                            <?php echo $llms_exists ? '<span class="ars-status-good">' . esc_html__( 'Live', 'agentreadyscan' ) . '</span>' : '<span class="ars-status-warn">' . esc_html__( 'Not written yet', 'agentreadyscan' ) . '</span>'; ?>
                            <?php echo esc_html( ' | ' . $this->format_file_timestamp( ABSPATH . 'llms.txt' ) ); ?>
                        </p>
                        <pre class="ars-preview"><?php echo esc_html( $llms_preview ); ?></pre>
                    </div>
                    <div class="ars-dashboard-card">
                        <h3><?php esc_html_e( 'agent-facts.html', 'agentreadyscan' ); ?></h3>
                        <p class="ars-preview-meta">
                            <?php echo $facts_exists ? '<span class="ars-status-good">' . esc_html__( 'Live', 'agentreadyscan' ) . '</span>' : '<span class="ars-status-warn">' . esc_html__( 'Not written yet', 'agentreadyscan' ) . '</span>'; ?>
                            <?php echo esc_html( ' | ' . $this->format_file_timestamp( ABSPATH . 'agent-facts.html' ) ); ?>
                        </p>
                        <pre class="ars-preview ars-preview-light"><?php echo esc_html( $facts_preview ); ?></pre>
                    </div>
                    <div class="ars-dashboard-card">
                        <h3><?php esc_html_e( 'robots.txt AI Rules', 'agentreadyscan' ); ?></h3>
                        <p class="ars-preview-meta"><?php echo esc_html( ! empty( $s['inject_robots'] ) ? __( 'Preview of the crawler rules AgentReadyScan applies through the WordPress robots.txt filter.', 'agentreadyscan' ) : __( 'Enable robots.txt AI entries in Features to publish these rules.', 'agentreadyscan' ) ); ?></p>
                        <pre class="ars-preview"><?php echo esc_html( $robots_preview ); ?></pre>
                    </div>
                </div>
            </div>

            <!-- Settings form -->
            <form method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>">
                <input type="hidden" name="action" value="arscan_save_settings">
                <?php wp_nonce_field( 'arscan_save_settings_action', 'arscan_nonce' ); ?>

                <!-- Business Identity -->
                <div class="ars-section">
                    <h2>Business Identity</h2>
                    <div class="ars-grid">
                        <div class="ars-field">
                            <label for="arscan_name"><?php esc_html_e( 'Business Name', 'agentreadyscan' ); ?></label>
                            <input type="text" id="arscan_name" name="arscan_settings[business_name]"
                                   value="<?php echo esc_attr( $s['business_name'] ); ?>">
                        </div>
                        <div class="ars-field">
                            <label for="arscan_url"><?php esc_html_e( 'Business URL', 'agentreadyscan' ); ?></label>
                            <input type="text" id="arscan_url" name="arscan_settings[business_url]"
                                   value="<?php echo esc_attr( $s['business_url'] ); ?>">
                        </div>
                        <div class="ars-field">
                            <label for="arscan_industry"><?php esc_html_e( 'Industry', 'agentreadyscan' ); ?></label>
                            <select id="arscan_industry" name="arscan_settings[industry]">
                                <?php foreach ( $industries as $val => $label ) : ?>
                                    <option value="<?php echo esc_attr( $val ); ?>"
                                        <?php selected( $s['industry'], $val ); ?>>
                                        <?php echo esc_html( $label ); ?>
                                    </option>
                                <?php endforeach; ?>
                            </select>
                        </div>
                        <div class="ars-field ars-field-full">
                            <label for="arscan_services"><?php esc_html_e( 'Services (comma-separated list)', 'agentreadyscan' ); ?></label>
                            <input type="text" id="arscan_services" name="arscan_settings[services]"
                                   placeholder="Tax Preparation, Bookkeeping, Payroll Services, Business Consulting"
                                   value="<?php echo esc_attr( $s['services'] ); ?>">
                            <p class="ars-preview-meta"><?php esc_html_e( 'List the core services your business offers, separated by commas. AI agents use this when asked what you do.', 'agentreadyscan' ); ?></p>
                        </div>
                        <div class="ars-field ars-field-full">
                            <label for="arscan_desc"><?php esc_html_e( 'Business Description (1-2 sentences for AI agents)', 'agentreadyscan' ); ?></label>
                            <?php
                            $desc_display = $s['description'];
                            if ( '' === trim( $desc_display ) ) {
                                $desc_display = trim( (string) get_bloginfo( 'description' ) );
                            }
                            if ( '' === trim( $desc_display ) ) {
                                $front_id = (int) get_option( 'page_on_front' );
                                if ( $front_id > 0 ) {
                                    $yoast   = trim( (string) get_post_meta( $front_id, '_yoast_wpseo_metadesc', true ) );
                                    $aioseo  = trim( (string) get_post_meta( $front_id, '_aioseop_description', true ) );
                                    $excerpt = trim( (string) get_the_excerpt( $front_id ) );
                                    $desc_display = $yoast ?: $aioseo ?: $excerpt;
                                }
                            }
                            ?>
                            <textarea id="arscan_desc" name="arscan_settings[description]"><?php echo esc_textarea( $desc_display ); ?></textarea>
                        </div>
                        <div class="ars-field ars-field-full">
                            <label for="arscan_exclusions"><?php esc_html_e( 'Explicit Exclusions (optional)', 'agentreadyscan' ); ?></label>
                            <textarea id="arscan_exclusions" name="arscan_settings[explicit_exclusions]" placeholder="<?php esc_attr_e( 'One exclusion per line. Example: We do not offer emergency services.', 'agentreadyscan' ); ?>"><?php echo esc_textarea( $s['explicit_exclusions'] ?? '' ); ?></textarea>
                            <p class="ars-preview-meta"><?php esc_html_e( 'These lines are added to the "does not do" section in agent-facts.html so AI systems avoid unsupported claims.', 'agentreadyscan' ); ?></p>
                        </div>
                        <div class="ars-field ars-field-full">
                            <details class="ars-advanced-toggle">
                                <summary><?php
                                    /* translators: %s: current schema type value, e.g. "LocalBusiness" */
                                    printf( esc_html__( 'Advanced schema override: %s', 'agentreadyscan' ), esc_html( $schema_value ) ); ?></summary>
                                <p class="ars-preview-meta"><?php esc_html_e( 'AgentReadyScan suggests a schema type automatically from the selected industry. Only change this if you know a more specific Schema.org type is appropriate.', 'agentreadyscan' ); ?></p>
                                <select id="arscan_schema_type" name="arscan_settings[schema_type]">
                                    <?php foreach ( $schema_types as $val => $label ) : ?>
                                        <option value="<?php echo esc_attr( $val ); ?>" <?php selected( $schema_value, $val ); ?>>
                                            <?php echo esc_html( $label ); ?>
                                        </option>
                                    <?php endforeach; ?>
                                </select>
                            </details>
                        </div>
                    </div>
                </div>

                <!-- Contact -->
                <div class="ars-section">
                    <h2>Contact &amp; Location</h2>
                    <div class="ars-grid">
                        <div class="ars-field">
                            <label for="arscan_phone"><?php esc_html_e( 'Phone', 'agentreadyscan' ); ?></label>
                            <input type="text" id="arscan_phone" name="arscan_settings[phone]"
                                   placeholder="+1-555-000-0000"
                                   value="<?php echo esc_attr( $s['phone'] ); ?>">
                        </div>
                        <div class="ars-field">
                            <label for="arscan_email"><?php esc_html_e( 'Contact Email', 'agentreadyscan' ); ?></label>
                            <input type="text" id="arscan_email" name="arscan_settings[email]"
                                   value="<?php echo esc_attr( $s['email'] ); ?>">
                        </div>
                        <div class="ars-field ars-field-full">
                            <label for="arscan_hours"><?php esc_html_e( 'Business Hours', 'agentreadyscan' ); ?></label>
                            <textarea id="arscan_hours" name="arscan_settings[hours]"
                                      placeholder="Mon-Fri: 8:30am-5:30pm&#10;Sat: By appointment&#10;Sun: Closed"><?php echo esc_textarea( $s['hours'] ); ?></textarea>
                            <p class="ars-preview-meta"><?php esc_html_e( 'Use one line per day or day range. Example: Mon-Fri: 8:30am-5:30pm', 'agentreadyscan' ); ?></p>
                        </div>
                    </div>
                </div>

                                <!-- Feature toggles -->
                <div class="ars-section">
                    <details class="ars-advanced-toggle">
                        <summary><strong><?php esc_html_e( 'Publishing Options', 'agentreadyscan' ); ?></strong> <span class="ars-preview-meta" style="font-weight:400;"><?php esc_html_e( '-- JSON-LD, robots.txt, and file publishing (all on by default)', 'agentreadyscan' ); ?></span></summary>
                        <div style="margin-top:12px;">
                        <div class="ars-toggle-row">
                            <input type="checkbox" id="arscan_jsonld" name="arscan_settings[inject_jsonld]" value="1"
                                   <?php checked( $s['inject_jsonld'] ); ?>>
                            <label for="arscan_jsonld"><?php esc_html_e( 'Inject JSON-LD structured data on every page (recommended)', 'agentreadyscan' ); ?></label>
                        </div>
                        <div class="ars-toggle-row">
                            <input type="checkbox" id="arscan_robots" name="arscan_settings[inject_robots]" value="1"
                                   <?php checked( $s['inject_robots'] ); ?>>
                            <label for="arscan_robots"><?php esc_html_e( 'Add AI crawler permissions to robots.txt (GPTBot, ClaudeBot, PerplexityBot)', 'agentreadyscan' ); ?></label>
                        </div>
                        <div class="ars-toggle-row">
                            <input type="checkbox" id="arscan_llms" name="arscan_settings[write_llms_txt]" value="1"
                                   <?php checked( $s['write_llms_txt'] ); ?>>
                            <label for="arscan_llms"><?php esc_html_e( 'Write /llms.txt to site root (machine-readable business summary)', 'agentreadyscan' ); ?></label>
                        </div>
                        <div class="ars-toggle-row">
                            <input type="checkbox" id="arscan_facts" name="arscan_settings[write_agent_facts]" value="1"
                                   <?php checked( $s['write_agent_facts'] ); ?>>
                            <label for="arscan_facts"><?php esc_html_e( 'Write /agent-facts.html (AgentFacts protocol -- AI Q&amp;A page)', 'agentreadyscan' ); ?></label>
                        </div>
                        </div>
                    </details>
                </div>

                <!-- Q&A Pairs -->
                <div class="ars-section">
                    <h2>
                        <?php esc_html_e( 'Questions & Answers', 'agentreadyscan' ); ?>
                        <span style="font-weight:400;color:#888;font-size:.85em">
                            <?php esc_html_e( '(what AI agents will say about your business)', 'agentreadyscan' ); ?>
                        </span>
                    </h2>
                    <p class="ars-qa-hint">
                        <?php esc_html_e( 'Edit the answers below. These are written directly into your agent-facts.html and llms.txt files.', 'agentreadyscan' ); ?>
                        <a href="https://www.agent-facts.com" target="_blank" rel="noopener"><?php esc_html_e( 'Writing guidelines \u2192', 'agentreadyscan' ); ?></a>
                    </p>
                    <div class="ars-core-qa-list">
                    <?php foreach ( $qa_pairs as $i => $pair ) : ?>
                        <div class="ars-qa-row">
                            <div class="ars-qa-header">
                                <strong><?php echo esc_html( sprintf( 'Q&A #%d', $i + 1 ) ); ?></strong>
                                <button type="button" class="ars-remove-qa" aria-label="<?php esc_attr_e( 'Remove question', 'agentreadyscan' ); ?>">&times;</button>
                            </div>
                            <input type="text"
                                   name="arscan_settings[qa_pairs][<?php echo absint( $i ); ?>][q]"
                                   value="<?php echo esc_attr( $pair['q'] ?? '' ); ?>"
                                   placeholder="Question - e.g. What is the primary website URL?">
                            <textarea name="arscan_settings[qa_pairs][<?php echo absint( $i ); ?>][a]"
                                      placeholder="<?php esc_attr_e( 'Answer - 35-70 words. Start with the fact, active voice, present tense.', 'agentreadyscan' ); ?>"><?php echo esc_textarea( $pair['a'] ?? '' ); ?></textarea>
                        </div>
                    <?php endforeach; ?>
                    </div>
                    <button type="button" class="button ars-add-qa"><?php esc_html_e( 'Add Question', 'agentreadyscan' ); ?></button>
                </div>

                <?php submit_button( __( 'Publish AI Files', 'agentreadyscan' ) ); ?>
            </form>

            <p class="ars-footer">
                Powered by <a href="https://agentreadyscan.com" target="_blank" rel="noopener">AgentReadyScan</a>
                &mdash; AI Visibility for the post-search web.
                <?php if ( ! $is_pro ) : ?>
                &nbsp;|&nbsp; <a href="https://agentreadyscan.com/pricing.html" target="_blank" rel="noopener">Purchase Pro License - $99/year &rarr;</a>
                <?php endif; ?>
            </p>

        </div>
        <?php
    }

    // -----------------------------------------------------------------------
    // Plugin row: action links + deactivation survey
    // -----------------------------------------------------------------------

    /**
     * Adds Settings and (for free users) Upgrade to Pro links to the plugin row.
     *
     * @param string[] $links Existing action links.
     * @return string[]
     */
    public function plugin_action_links( array $links ): array {
        $settings_link = sprintf(
            '<a href="%s">%s</a>',
            esc_url( admin_url( 'options-general.php?page=agentreadyscan' ) ),
            esc_html__( 'Settings', 'agentreadyscan' )
        );
        array_unshift( $links, $settings_link );

        if ( ! arscan_is_pro() ) {
            $upgrade_link = sprintf(
                '<a href="%s" target="_blank" rel="noopener" style="color:#FF6B35;font-weight:700;">%s</a>',
                esc_url( 'https://agentreadyscan.com/pricing.html' ),
                esc_html__( 'Upgrade to Pro', 'agentreadyscan' )
            );
            array_unshift( $links, $upgrade_link );
        }

        return $links;
    }

    /**
     * Injects a deactivation-reason survey modal on the Plugins screen.
     * JavaScript intercepts the Deactivate link, shows the modal, then
     * proceeds to the original deactivate URL on submit or skip.
     */
    public function deactivation_survey_modal(): void {
        $screen = get_current_screen();
        if ( ! $screen || 'plugins' !== $screen->id ) {
            return;
        }
        ?>
        <div id="ars-deactivation-modal" class="ars-deactivation-modal">
            <div class="ars-deactivation-dialog">
                <h3><?php esc_html_e( 'Quick question before you go', 'agentreadyscan' ); ?></h3>
                <p><?php esc_html_e( 'Why are you deactivating AgentReadyScan? Your answer helps us improve.', 'agentreadyscan' ); ?></p>
                <form id="ars-deactivation-form">
                    <?php
                    $reasons = array(
                        'better_plugin'   => __( 'Found a better plugin', 'agentreadyscan' ),
                        'temporary'       => __( 'Only needed it temporarily', 'agentreadyscan' ),
                        'broke_site'      => __( 'Plugin caused an issue on my site', 'agentreadyscan' ),
                        'missing_feature' => __( 'Missing a feature I need', 'agentreadyscan' ),
                        'too_complex'     => __( 'Too complicated to set up', 'agentreadyscan' ),
                        'other'           => __( 'Other', 'agentreadyscan' ),
                    );
                    foreach ( $reasons as $value => $label ) :
                    ?>
                    <label class="ars-deactivation-option">
                        <input type="radio" name="arscan_reason" value="<?php echo esc_attr( $value ); ?>">
                        <?php echo esc_html( $label ); ?>
                    </label>
                    <?php endforeach; ?>
                    <textarea name="arscan_detail" id="ars-deactivation-detail"
                              placeholder="<?php esc_attr_e( 'Any details? (optional)', 'agentreadyscan' ); ?>"></textarea>
                    <div class="ars-deactivation-actions">
                        <button type="submit" id="ars-deactivation-submit" class="button button-primary"><?php esc_html_e( 'Submit &amp; Deactivate', 'agentreadyscan' ); ?></button>
                        <button type="button" id="ars-deactivation-skip" class="button"><?php esc_html_e( 'Skip &amp; Deactivate', 'agentreadyscan' ); ?></button>
                        <button type="button" id="ars-deactivation-cancel" class="button button-link ars-deactivation-cancel"><?php esc_html_e( 'Cancel', 'agentreadyscan' ); ?></button>
                    </div>
                </form>
            </div>
        </div>
        <?php
    }

    /**
     * AJAX handler for deactivation survey submission.
     * Currently a no-op Ã¢â‚¬â€ extend to log to a remote endpoint when ready.
     */
    public function ajax_submit_deactivation_survey(): void {
        check_ajax_referer( 'arscan_deactivation_survey' );
        wp_die();
    }
}