<?php
// Citami Connector — module. Loaded by citami-connector.php in a fixed
// order; never load this file on its own.
if (!defined('ABSPATH')) {
    exit;
}

/* ────────────────────────────────────────────────────────────────── */
/*  2.54 — Pages: one verdict per page, one AI action                  */
/* ────────────────────────────────────────────────────────────────── */
/*
 * The platform crosses, per page, Search Console (now vs the 28 days
 * before, and the queries per page), the AI engines (questions the page
 * is cited for or loses), the AI bots (crawler reads, reads to answer
 * someone) and the people sent by AI assistants, and returns one verdict.
 * This module shows them and runs the action behind each one: an AI title
 * and description, an AI update brief, the AI short answer, IndexNow, or
 * a pointer. Every AI output is a draft the owner approves; each applied
 * action is remembered with the numbers of that day so the page can show
 * what changed afterwards.
 */

define('CITAMI_PAGES_TRANSIENT', 'citami_page_insights');
define('CITAMI_PAGES_TTL', 6 * HOUR_IN_SECONDS);
define('CITAMI_PAGES_ACTIONS_OPT', 'citami_page_actions');
define('CITAMI_META_PAGE_DRAFT', '_citami_page_ai_meta');
define('CITAMI_META_PAGE_BRIEF', '_citami_page_ai_brief');
define('CITAMI_PAGES_LIST_MAX', 25);
define('CITAMI_PAGES_MEASURE_DAYS', 14);
define('CITAMI_PAGES_CARD_NOTICE', 'citami_pages_card_notice');

/** Raw fetch from the platform; array with 'ok' => bool. */
function citami_pages_fetch() {
    $key = citami_get_api_key();
    if ($key === '') {
        return array('ok' => false, 'error' => 'no_key');
    }
    $res = wp_remote_get(citami_get_endpoint() . '/api/plugin/page-insights', array(
        'timeout' => 45,
        'headers' => array(
            'Authorization' => 'Bearer ' . $key,
            'User-Agent'    => 'CitamiConnector/' . CITAMI_PLUGIN_VERSION . '; ' . home_url('/'),
        ),
    ));
    if (is_wp_error($res)) {
        return array('ok' => false, 'error' => $res->get_error_message());
    }
    $code = (int) wp_remote_retrieve_response_code($res);
    $data = json_decode((string) wp_remote_retrieve_body($res), true);
    if ($code < 200 || $code >= 300 || !is_array($data) || !isset($data['pages'])) {
        return array('ok' => false, 'error' => 'HTTP ' . $code);
    }
    $data['ok'] = true;
    $data['cached_at'] = time();
    return $data;
}

/** Cached insights (6 h). $force refreshes. Failures keep the last good copy. */
function citami_pages_data($force = false) {
    $cached = get_transient(CITAMI_PAGES_TRANSIENT);
    if (!$force && is_array($cached)) {
        return $cached;
    }
    $fresh = citami_pages_fetch();
    if (!empty($fresh['ok'])) {
        set_transient(CITAMI_PAGES_TRANSIENT, $fresh, CITAMI_PAGES_TTL);
        return $fresh;
    }
    if (is_array($cached)) {
        $cached['stale_error'] = isset($fresh['error']) ? (string) $fresh['error'] : '';
        return $cached;
    }
    $fresh['cached_at'] = time();
    set_transient(CITAMI_PAGES_TRANSIENT, $fresh, 10 * MINUTE_IN_SECONDS);
    return $fresh;
}

/** Page rows with a verdict to act on, mapped to posts, ordered by priority. */
function citami_pages_rows($limit = CITAMI_PAGES_LIST_MAX) {
    $data = citami_pages_data();
    if (empty($data['ok']) || empty($data['pages'])) {
        return array();
    }
    $rows = array();
    foreach ((array) $data['pages'] as $p) {
        if (!is_array($p) || empty($p['verdict']['kind']) || $p['verdict']['kind'] === 'ok' || empty($p['url'])) {
            continue;
        }
        $p['post_id'] = function_exists('citami_gsc_post_for_url') ? citami_gsc_post_for_url($p['url']) : (int) url_to_postid($p['url']);
        $rows[] = $p;
        if (count($rows) >= $limit) {
            break;
        }
    }
    return $rows;
}

function citami_pages_pct($ctr) {
    return number_format_i18n(100 * (float) $ctr, 1) . '%';
}

/** The verdict in one plain sentence, with the numbers behind it. */
function citami_pages_verdict_text(array $p, array $curve = array()) {
    $v = $p['verdict'];
    $g = isset($p['gsc']) && is_array($p['gsc']) ? $p['gsc'] : array();
    $ai = isset($p['ai']) && is_array($p['ai']) ? $p['ai'] : array();
    switch ($v['kind']) {
        case 'lost_clicks':
            return sprintf(citami_t('Ha perso clic su Google: %1$d negli ultimi 28 giorni contro %2$d nei 28 prima.', 'Losing clicks on Google: %1$d in the last 28 days against %2$d in the 28 before.'), (int) $g['clicks'], (int) $g['clicksPrev']);
        case 'low_ctr':
            $bucket = citami_pages_bucket((float) $g['position']);
            $typ = ($bucket !== '' && isset($curve[$bucket])) ? citami_pages_pct($curve[$bucket]) : '';
            return $typ !== ''
                ? sprintf(citami_t('Google la mostra %1$s volte ma la cliccano solo il %2$s: le tue pagine in posizione simile arrivano al %3$s.', 'Google shows it %1$s times but only %2$s click: your pages at a similar position reach %3$s.'), number_format_i18n((int) $g['impressions']), citami_pages_pct($g['ctr']), $typ)
                : sprintf(citami_t('Google la mostra %1$s volte ma la cliccano solo il %2$s.', 'Google shows it %1$s times but only %2$s click.'), number_format_i18n((int) $g['impressions']), citami_pages_pct($g['ctr']));
        case 'read_not_cited':
            $lost = isset($ai['lostQuestions']) ? (array) $ai['lostQuestions'] : array();
            $s = sprintf(citami_t('Le AI non ti citano su %1$d domande a cui questa pagina dovrebbe rispondere, per esempio «%2$s».', 'The AI engines do not cite you on %1$d questions this page should answer, e.g. "%2$s".'), count($lost), isset($lost[0]) ? $lost[0] : '');
            if (!empty($ai['answerReads'])) {
                $s .= ' ' . sprintf(citami_t('Gli assistenti l\'hanno aperta %d volte per rispondere a qualcuno: la leggono ma non la citano.', 'Assistants opened it %d times to answer someone: they read it but do not cite it.'), (int) $ai['answerReads']);
            }
            return $s;
        case 'cannibal':
            $c = isset($v['competing']) && is_array($v['competing']) ? $v['competing'] : array('url' => '', 'query' => '');
            return sprintf(citami_t('Compete con un\'altra tua pagina per «%1$s» («%2$s»). Google ne mostra una a scapito dell\'altra.', 'Competes with another of your pages for "%1$s" ("%2$s"). Google shows one at the expense of the other.'), $c['query'], citami_pages_title_for_url((string) $c['url']));
        case 'near_top':
            return sprintf(citami_t('In posizione %1$s con %2$s impressioni: a un passo dalla prima pagina.', 'At position %1$s with %2$s impressions: one step from page one.'), number_format_i18n((float) $g['position'], 1), number_format_i18n((int) $g['impressions']));
        case 'not_read_by_ai':
            return sprintf(citami_t('Google la mostra %s volte, ma nessun bot AI l\'ha aperta negli ultimi 30 giorni.', 'Google shows it %s times, but no AI bot opened it in the last 30 days.'), number_format_i18n((int) $g['impressions']));
    }
    return '';
}

function citami_pages_bucket($position) {
    if ($position <= 0) return '';
    if ($position <= 3) return '1-3';
    if ($position <= 6) return '4-6';
    if ($position <= 10) return '7-10';
    if ($position <= 20) return '11-20';
    return '';
}

function citami_pages_action_label($action) {
    $labels = array(
        'meta_draft'    => citami_t('Riscrivi titolo e descrizione con AI', 'Rewrite title and description with AI'),
        'refresh_brief' => citami_t('Prepara l\'aggiornamento con AI', 'Prepare the update with AI'),
        'aeo_draft'     => citami_t('Scrivi la risposta in apertura con AI', 'Write the opening answer with AI'),
        'indexnow'      => citami_t('Invia ai motori (IndexNow)', 'Send to the engines (IndexNow)'),
        'links'         => citami_t('Aggiungi link interni', 'Add internal links'),
        'review'        => citami_t('Confronta le due pagine', 'Compare the two pages'),
    );
    return isset($labels[$action]) ? $labels[$action] : '';
}

/* ---------------------------------------------------------------- */
/*  Before / after                                                    */
/* ---------------------------------------------------------------- */

function citami_pages_actions_log() {
    $log = get_option(CITAMI_PAGES_ACTIONS_OPT, array());
    return is_array($log) ? $log : array();
}

/** Remembers an applied action with the page's numbers of that day. */
function citami_pages_log_action($post_id, $kind) {
    $url = get_permalink((int) $post_id);
    if (!$url) {
        return;
    }
    $path = rtrim((string) wp_parse_url($url, PHP_URL_PATH), '/');
    $path = $path === '' ? '/' : $path;
    $before = null;
    $data = get_transient(CITAMI_PAGES_TRANSIENT);
    foreach ((array) (is_array($data) && isset($data['pages']) ? $data['pages'] : array()) as $p) {
        if (is_array($p) && isset($p['path']) && $p['path'] === $path && !empty($p['gsc'])) {
            $before = array('clicks' => (int) $p['gsc']['clicks'], 'impressions' => (int) $p['gsc']['impressions'], 'ctr' => (float) $p['gsc']['ctr'], 'position' => (float) $p['gsc']['position']);
            break;
        }
    }
    $log = citami_pages_actions_log();
    $log[$path] = array('post' => (int) $post_id, 'kind' => (string) $kind, 'ts' => time(), 'before' => $before);
    if (count($log) > 200) {
        uasort($log, function ($a, $b) { return $b['ts'] - $a['ts']; });
        $log = array_slice($log, 0, 200, true);
    }
    update_option(CITAMI_PAGES_ACTIONS_OPT, $log, false);
}

/** "Since Oct 3: CTR 1.2% → 2.8%, clicks 14 → 31" — or "measuring" in the first two weeks. */
function citami_pages_effect_text(array $p) {
    $log = citami_pages_actions_log();
    if (empty($p['path']) || !isset($log[$p['path']])) {
        return '';
    }
    $e = $log[$p['path']];
    $fmt = (string) get_option('date_format');
    $when = date_i18n($fmt !== '' ? $fmt : 'j M Y', (int) $e['ts']);
    if (time() - (int) $e['ts'] < CITAMI_PAGES_MEASURE_DAYS * DAY_IN_SECONDS || empty($e['before']) || empty($p['gsc'])) {
        return sprintf(citami_t('Modifica fatta (%s): lo misuriamo, servono 2-4 settimane di dati Google.', 'Change made (%s): being measured, it takes 2-4 weeks of Google data.'), $when);
    }
    return sprintf(
        citami_t('Dopo la modifica (%1$s): CTR %2$s → %3$s, clic %4$d → %5$d nei 28 giorni.', 'After the change (%1$s): CTR %2$s → %3$s, clicks %4$d → %5$d over 28 days.'),
        $when,
        citami_pages_pct($e['before']['ctr']),
        citami_pages_pct($p['gsc']['ctr']),
        (int) $e['before']['clicks'],
        (int) $p['gsc']['clicks']
    );
}

/* ---------------------------------------------------------------- */
/*  AI drafts from the platform                                       */
/* ---------------------------------------------------------------- */

function citami_pages_brand() {
    if (function_exists('citami_truth_sheet')) {
        $s = citami_truth_sheet();
        if (is_array($s) && !empty($s['name'])) {
            return (string) $s['name'];
        }
    }
    return (string) get_bloginfo('name');
}

/** Calls /api/plugin/page-ai for one post; stores the draft. kind: meta | refresh. */
function citami_pages_ai_request($post_id, $kind) {
    $post_id = (int) $post_id;
    $kind = $kind === 'refresh' ? 'refresh' : 'meta';
    if (!get_post($post_id)) {
        return array('ok' => false, 'message' => citami_t('Pagina non trovata.', 'Page not found.'));
    }
    if (citami_get_api_key() === '') {
        return array('ok' => false, 'message' => citami_t('Collega prima il sito alla piattaforma (Impostazioni → API key).', 'Connect the site to the platform first (Settings → API key).'));
    }
    $page = citami_aeo_draft_page_text($post_id);
    if (mb_strlen($page['text']) < 80) {
        return array('ok' => false, 'message' => citami_t('La pagina ha troppo poco testo salvato per lavorarci: aggiungi contenuto e salva.', 'The page has too little saved text to work from: add content and save.'));
    }
    $seo = function_exists('citami_seo_get_post_fields') ? citami_seo_get_post_fields($post_id) : array('title' => '', 'description' => '');
    $res = wp_remote_post(citami_get_endpoint() . '/api/plugin/page-ai', array(
        'timeout' => 60,
        'headers' => array(
            'Authorization' => 'Bearer ' . citami_get_api_key(),
            'Content-Type'  => 'application/json',
            'User-Agent'    => 'CitamiConnector/' . CITAMI_PLUGIN_VERSION . '; ' . home_url('/'),
        ),
        'body' => wp_json_encode(array(
            'kind'                => $kind,
            'url'                 => get_permalink($post_id),
            'page_title'          => $page['title'] !== '' ? $page['title'] : '(senza titolo)',
            'current_title'       => (string) $seo['title'],
            'current_description' => (string) $seo['description'],
            'brand'               => citami_pages_brand(),
            'text'                => mb_substr($page['text'], 0, 10000),
            'locale'              => citami_lang(),
        ), JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE | JSON_HEX_TAG),
    ));
    if (is_wp_error($res)) {
        return array('ok' => false, 'message' => sprintf(citami_t('Piattaforma non raggiungibile (%s).', 'Platform unreachable (%s).'), $res->get_error_message()));
    }
    $code = (int) wp_remote_retrieve_response_code($res);
    $data = json_decode((string) wp_remote_retrieve_body($res), true);
    if ($code === 429) {
        return array('ok' => false, 'message' => citami_t('Troppe richieste in un minuto: riprova tra poco.', 'Too many requests in a minute: try again shortly.'));
    }
    if ($code < 200 || $code >= 300 || !is_array($data)) {
        return array('ok' => false, 'message' => sprintf(citami_t('La piattaforma ha risposto con un errore (HTTP %d).', 'The platform answered with an error (HTTP %d).'), $code));
    }
    if (isset($data['reason']) && $data['reason'] === 'quota') {
        return array('ok' => false, 'upgrade' => 'page_ai', 'message' => sprintf(citami_t('Riscritture AI finite per questo mese (%1$d su %2$d): riprendono il mese prossimo.', 'AI rewrites used up for this month (%1$d of %2$d): back next month.'), (int) $data['used'], (int) $data['quota']));
    }
    if (isset($data['reason']) && $data['reason'] === 'no_queries') {
        return array('ok' => false, 'message' => citami_t('Search Console non ha ancora ricerche per questa pagina: senza quelle non c\'è su cosa riscrivere titolo e descrizione.', 'Search Console has no queries for this page yet: without them there is nothing to rewrite the title and description on.'));
    }
    if ($kind === 'meta') {
        if (!empty($data['dropped']) || empty($data['title'])) {
            return array('ok' => false, 'message' => citami_t('Bozza scartata: conteneva numeri o fatti non presenti nella pagina. Riprova o scrivi il titolo a mano.', 'Draft dropped: it carried numbers or facts not on the page. Try again or write the title by hand.'));
        }
        $draft = array(
            'title'       => mb_substr(sanitize_text_field((string) $data['title']), 0, 70),
            'description' => mb_substr(sanitize_text_field((string) $data['description']), 0, 170),
            'why'         => mb_substr(sanitize_text_field((string) (isset($data['why']) ? $data['why'] : '')), 0, 240),
            // 2.64 — the platform may also propose the page heading (H1 = the post title).
            'h1'          => mb_substr(sanitize_text_field((string) (isset($data['h1']) ? $data['h1'] : '')), 0, 80),
            'query'       => isset($data['queries'][0]['query']) ? sanitize_text_field((string) $data['queries'][0]['query']) : '',
            'ts'          => time(),
        );
        update_post_meta($post_id, CITAMI_META_PAGE_DRAFT, $draft);
        return array('ok' => true, 'message' => citami_t('Titolo e descrizione proposti: leggili qui sotto e decidi se usarli.', 'Title and description proposed: read them below and decide whether to use them.'));
    }
    $sections = array();
    foreach ((array) (isset($data['sections']) ? $data['sections'] : array()) as $s) {
        if (is_array($s) && !empty($s['heading'])) {
            $sections[] = array('heading' => sanitize_text_field((string) $s['heading']), 'why' => sanitize_text_field((string) (isset($s['why']) ? $s['why'] : '')));
        }
    }
    $updates = array();
    foreach ((array) (isset($data['updates']) ? $data['updates'] : array()) as $u) {
        if (is_string($u) && trim($u) !== '') {
            $updates[] = sanitize_text_field($u);
        }
    }
    if (empty($sections) && empty($updates)) {
        return array('ok' => false, 'message' => citami_t('Dai dati non è emerso un aggiornamento da proporre: la pagina potrebbe perdere clic per stagionalità.', 'The data did not point to an update worth proposing: the page may be losing clicks to seasonality.'));
    }
    update_post_meta($post_id, CITAMI_META_PAGE_BRIEF, array(
        'summary'  => sanitize_text_field((string) (isset($data['summary']) ? $data['summary'] : '')),
        'sections' => array_slice($sections, 0, 5),
        'updates'  => array_slice($updates, 0, 5),
        'ts'       => time(),
    ));
    return array('ok' => true, 'message' => citami_t('Scaletta dell\'aggiornamento pronta: la trovi qui sotto. Aprila accanto all\'editor mentre aggiorni la pagina.', 'Update brief ready: you find it below. Keep it open next to the editor while you update the page.'));
}

/* ---------------------------------------------------------------- */
/*  Actions                                                           */
/* ---------------------------------------------------------------- */

/** The Pages tab scrolled to one card. */
function citami_pages_card_url($post_id) {
    return citami_admin_url('pages', array('focus' => (int) $post_id)) . '#citami-page-' . (int) $post_id;
}

function citami_pages_action_url($do, $post_id = 0, $back = '') {
    return wp_nonce_url(admin_url('admin-post.php?action=citami_pages_action&do=' . rawurlencode($do) . ($post_id ? '&post=' . (int) $post_id : '') . ($back === 'overview' ? '&back=overview' : '')), 'citami_pages', '_citami_pages_nonce');
}

/** 2.59 — pages with an AI short answer waiting for approval (newest first). */
function citami_pages_pending_aeo_drafts($limit = 10) {
    if (!defined('CITAMI_META_AEO_DRAFT')) {
        return array();
    }
    return array_map('intval', get_posts(array(
        'post_type'      => 'any',
        'post_status'    => array('publish', 'draft', 'pending', 'future', 'private'),
        'meta_key'       => CITAMI_META_AEO_DRAFT, // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_key -- pages with a draft only
        'posts_per_page' => (int) $limit,
        'orderby'        => 'modified',
        'fields'         => 'ids',
    )));
}

/** 2.59 — Overview: the drafts written from there, approved there. */
function citami_pages_render_overview_drafts() {
    $ids = citami_pages_pending_aeo_drafts();
    $rows = array();
    foreach ($ids as $pid) {
        $d = citami_aeo_draft_get($pid);
        if ($d !== null) $rows[$pid] = $d;
    }
    if (empty($rows)) {
        return '';
    }
    // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- display only: which draft to highlight
    $focus = isset($_GET['focus']) ? (int) $_GET['focus'] : 0;
    $notice = $focus ? get_transient(CITAMI_PAGES_CARD_NOTICE) : null;
    ob_start();
    ?>
    <section class="citami-card citami-overview-drafts" id="citami-drafts" data-citami="overview-drafts">
        <header class="citami-card-head"><span class="citami-eyebrow"><?php echo esc_html(sprintf(count($rows) === 1 ? citami_t('1 bozza AI da approvare', '1 AI draft to approve') : citami_t('%d bozze AI da approvare', '%d AI drafts to approve'), count($rows))); ?></span></header>
        <?php foreach ($rows as $pid => $d): $is_focus = $pid === $focus; ?>
            <article class="citami-overview-draft<?php echo $is_focus ? ' is-focus' : ''; ?>" id="citami-draft-<?php echo (int) $pid; ?>">
                <?php if ($is_focus && is_array($notice) && (int) $notice['post'] === $pid): delete_transient(CITAMI_PAGES_CARD_NOTICE); ?>
                    <p class="citami-card-notice citami-card-notice--<?php echo esc_attr($notice['type']); ?>" data-citami="card-notice" role="status"><?php echo wp_kses(citami_notice_text_html($notice), citami_kses_allowed()); ?></p>
                <?php endif; ?>
                <h3 class="citami-page-title"><a href="<?php echo esc_url(get_permalink($pid)); ?>" target="_blank" rel="noopener"><?php echo esc_html(get_the_title($pid)); ?></a></h3>
                <?php echo wp_kses(citami_pages_aeo_draft_html($pid, $d, 'overview'), citami_kses_allowed()); ?>
            </article>
        <?php endforeach; ?>
    </section>
    <?php
    return ob_get_clean();
}

function citami_handle_pages_action() {
    if (!current_user_can('edit_posts')) {
        wp_die('Permesso negato.', '', array('response' => 403));
    }
    if (!wp_verify_nonce(isset($_REQUEST['_citami_pages_nonce']) ? sanitize_text_field(wp_unslash($_REQUEST['_citami_pages_nonce'])) : '', 'citami_pages')) {
        wp_die('Nonce non valido.', '', array('response' => 403));
    }
    $do = isset($_REQUEST['do']) ? sanitize_key((string) $_REQUEST['do']) : '';
    $post_id = isset($_REQUEST['post']) ? (int) $_REQUEST['post'] : 0;
    if ($post_id && !current_user_can('edit_post', $post_id)) {
        wp_die('Permesso negato.', '', array('response' => 403));
    }
    $r = citami_pages_do($do, $post_id);
    $notice = array('type' => !empty($r['ok']) ? 'success' : 'error', 'message' => $r['message'], 'upgrade' => isset($r['upgrade']) ? $r['upgrade'] : '');
    $back = isset($_REQUEST['back']) ? sanitize_key((string) $_REQUEST['back']) : '';
    if ($post_id && $back === 'overview') {
        // 2.59 — started from the Overview: back there, on the draft when one is waiting.
        if (function_exists('citami_aeo_draft_get') && citami_aeo_draft_get($post_id) !== null) {
            set_transient(CITAMI_PAGES_CARD_NOTICE, $notice + array('post' => $post_id), 60);
            wp_safe_redirect(citami_admin_url('overview', array('focus' => $post_id)) . '#citami-draft-' . $post_id);
            exit;
        }
        set_transient('citami_action_notice', $notice, 30);
        wp_safe_redirect(citami_admin_url('overview'));
        exit;
    }
    if ($post_id) {
        // 2.58 — back to the same card, scrolled into view, with the outcome
        // (and the draft, when there is one) inside it, not at the page top.
        set_transient(CITAMI_PAGES_CARD_NOTICE, $notice + array('post' => $post_id), 60);
        wp_safe_redirect(citami_pages_card_url($post_id));
        exit;
    }
    set_transient('citami_action_notice', $notice, 30);
    wp_safe_redirect(citami_admin_url('pages'));
    exit;
}
add_action('admin_post_citami_pages_action', 'citami_handle_pages_action');

/** Runs one action; returns array('ok', 'message'). Split from the handler for tests. */
function citami_pages_do($do, $post_id) {
    switch ($do) {
        case 'refresh_data':
            $d = citami_pages_data(true);
            return !empty($d['ok'])
                ? array('ok' => true, 'message' => citami_t('Dati aggiornati.', 'Data refreshed.'))
                : array('ok' => false, 'message' => citami_t('La piattaforma non ha risposto: restano i dati precedenti.', 'The platform did not answer: the previous data stays.'));
        case 'meta':
            return citami_pages_ai_request($post_id, 'meta');
        case 'refresh':
            return citami_pages_ai_request($post_id, 'refresh');
        case 'meta_apply':
            $d = get_post_meta($post_id, CITAMI_META_PAGE_DRAFT, true);
            if (!is_array($d) || empty($d['title'])) {
                return array('ok' => false, 'message' => citami_t('Nessuna bozza da usare.', 'No draft to use.'));
            }
            $r = citami_gsc_apply_meta($post_id, $d['title'], $d['description'], isset($d['query']) ? $d['query'] : '');
            if (!empty($r['ok'])) {
                // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- nonce checked by the handler
                if (!empty($_REQUEST['apply_h1']) && !empty($d['h1'])) {
                    $h = citami_pages_apply_h1($post_id, $d['h1']);
                    $r['message'] .= ' ' . $h['message'];
                }
                delete_post_meta($post_id, CITAMI_META_PAGE_DRAFT);
                citami_pages_log_action($post_id, 'meta');
            }
            return $r;
        case 'meta_discard':
            delete_post_meta($post_id, CITAMI_META_PAGE_DRAFT);
            return array('ok' => true, 'message' => citami_t('Bozza scartata.', 'Draft discarded.'));
        case 'brief_done':
            delete_post_meta($post_id, CITAMI_META_PAGE_BRIEF);
            citami_pages_log_action($post_id, 'refresh');
            return array('ok' => true, 'message' => citami_t('Segnato come aggiornato: da qui misuriamo l\'effetto.', 'Marked as updated: we measure the effect from here.'));
        case 'brief_discard':
            delete_post_meta($post_id, CITAMI_META_PAGE_BRIEF);
            return array('ok' => true, 'message' => citami_t('Scaletta scartata.', 'Brief discarded.'));
        case 'aeo':
            $r = citami_aeo_draft_request($post_id);
            if (!empty($r['ok'])) {
                // 2.58 — the draft is shown on the card itself: read it there, then decide.
                $r['message'] = citami_t('Bozza pronta: la leggi qui sotto. Non è ancora nella pagina: la inserisci solo se ti va bene.', 'Draft ready: read it below. It is not on the page yet: you add it only if you like it.');
            }
            return $r;
        case 'aeo_apply':
            return citami_aeo_draft_apply($post_id);
        case 'aeo_discard':
            citami_aeo_draft_discard($post_id);
            return array('ok' => true, 'message' => citami_t('Bozza scartata: la pagina non è cambiata.', 'Draft discarded: the page did not change.'));
        case 'indexnow':
            $url = get_permalink($post_id);
            if (!$url || !function_exists('citami_indexnow_submit_now')) {
                return array('ok' => false, 'message' => citami_t('IndexNow non disponibile.', 'IndexNow not available.'));
            }
            citami_indexnow_submit_now(array($url));
            citami_pages_log_action($post_id, 'indexnow');
            return array('ok' => true, 'message' => sprintf(citami_t('"%s" inviata a Bing e agli altri motori IndexNow, che alimentano ChatGPT e Copilot.', '"%s" sent to Bing and the other IndexNow engines, which feed ChatGPT and Copilot.'), get_the_title($post_id)));
    }
    return array('ok' => false, 'message' => citami_t('Azione sconosciuta.', 'Unknown action.'));
}

/**
 * 2.64 — the page heading: in WordPress themes the H1 is the post title, so
 * changing the H1 means changing the title (the address does not change).
 * The old title goes in the activity log, to put it back by hand if needed.
 */
function citami_pages_apply_h1($post_id, $h1) {
    $post = get_post((int) $post_id);
    $h1 = trim(sanitize_text_field((string) $h1));
    if (!$post || $h1 === '') {
        return array('ok' => false, 'message' => '');
    }
    $old = (string) $post->post_title;
    if ($old === $h1) {
        return array('ok' => true, 'message' => '');
    }
    $r = wp_update_post(array('ID' => (int) $post_id, 'post_title' => $h1), true);
    if (is_wp_error($r)) {
        return array('ok' => false, 'message' => citami_t('Il titolo della pagina (H1) non è stato cambiato.', 'The page title (H1) was not changed.'));
    }
    if (function_exists('citami_activity_log')) {
        citami_activity_log('meta', sprintf(citami_t('Titolo della pagina (H1) cambiato: "%1$s" → "%2$s"', 'Page title (H1) changed: "%1$s" → "%2$s"'), $old, $h1), 1, array('post' => (int) $post_id, 'before' => $old));
    }
    return array('ok' => true, 'message' => sprintf(citami_t('Anche il titolo della pagina (H1) ora è "%s".', 'The page title (H1) is now "%s" too.'), $h1));
}

/** 2.64 — the H1 proposal row + the "change it too" checkbox, shared by the Pages and Search Console tabs. */
function citami_pages_h1_choice_html($post_id, array $draft, $form = '') {
    if (empty($draft['h1'])) {
        return '';
    }
    $cur = get_the_title((int) $post_id);
    return '<label class="citami-h1-choice" data-citami="h1-choice"><input type="checkbox" name="apply_h1" value="1"' . ($form !== '' ? ' form="' . esc_attr($form) . '"' : '') . '> '
        . esc_html(citami_t('Cambia anche il titolo della pagina (H1)', 'Also change the page title (H1)')) . '<span class="citami-h1-compare"><span class="is-old">' . esc_html($cur) . '</span> → <strong>' . esc_html($draft['h1']) . '</strong></span>'
        . '<span class="citami-muted">' . esc_html(citami_t('È il titolo che si vede in cima alla pagina; l\'indirizzo non cambia.', 'It is the heading shown at the top of the page; the address does not change.')) . '</span></label>';
}

/** Logs an applied AI short answer as a page action (called from aeo-draft apply). */
function citami_pages_on_aeo_applied($post_id) {
    citami_pages_log_action($post_id, 'aeo');
}

/* ---------------------------------------------------------------- */
/*  Render (2.54.1 design)                                            */
/* ---------------------------------------------------------------- */

function citami_pages_kind_meta($kind) {
    $m = array(
        'lost_clicks'    => array('label' => citami_t('Perde clic', 'Losing clicks'), 'tone' => 'bad', 'icon' => '<path d="M2.5 4.5 6.5 8.5l2.5-2.5 4.5 4.5"/><path d="M13.5 7.5v3h-3"/>'),
        'low_ctr'        => array('label' => citami_t('Pochi clic', 'Few clicks'), 'tone' => 'warn', 'icon' => '<path d="M5 2.5v7l2-1.6 1.6 3.6 1.6-.7-1.6-3.5H11z"/><path d="M11.5 3.5l1.5-1.5M12.5 6h2M3 6H1.5"/>'),
        'read_not_cited' => array('label' => citami_t('Le AI la saltano', 'Skipped by AI'), 'tone' => 'ai', 'icon' => '<path d="M2.5 3.5h11v7h-6l-3 2.5v-2.5h-2z"/><path d="M5.5 6.5h5M5.5 8.5h3"/>'),
        'near_top'       => array('label' => citami_t('Quasi in prima pagina', 'Almost on page one'), 'tone' => 'good', 'icon' => '<path d="M8 13.5v-10M4 7.5l4-4 4 4"/>'),
        'not_read_by_ai' => array('label' => citami_t('Le AI non la leggono', 'Not read by AI'), 'tone' => 'ai', 'icon' => '<path d="M1.8 8s2.2-4 6.2-4 6.2 4 6.2 4-2.2 4-6.2 4-6.2-4-6.2-4z"/><circle cx="8" cy="8" r="1.8"/><path d="M2.5 13.5l11-11"/>'),
        'cannibal'       => array('label' => citami_t('Due pagine in conflitto', 'Two pages competing'), 'tone' => 'bad', 'icon' => '<path d="M2.5 5.5h9l-2-2M13.5 10.5h-9l2 2"/>'),
    );
    return isset($m[$kind]) ? $m[$kind] : array('label' => $kind, 'tone' => 'ai', 'icon' => '<circle cx="8" cy="8" r="5"/>');
}

function citami_pages_svg($paths, $class = 'citami-ico') {
    return '<svg class="' . esc_attr($class) . '" viewBox="0 0 16 16" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">' . $paths . '</svg>';
}

/** The short reason used in the compact weekly list. */
function citami_pages_short_reason(array $p, array $curve) {
    $v = $p['verdict'];
    $g = isset($p['gsc']) && is_array($p['gsc']) ? $p['gsc'] : array();
    $ai = isset($p['ai']) && is_array($p['ai']) ? $p['ai'] : array();
    switch ($v['kind']) {
        case 'lost_clicks':
            return sprintf(citami_t('%1$d clic contro %2$d nei 28 giorni prima', '%1$d clicks against %2$d in the 28 days before'), (int) $g['clicks'], (int) $g['clicksPrev']);
        case 'low_ctr':
            $b = citami_pages_bucket((float) $g['position']);
            return ($b !== '' && isset($curve[$b]))
                ? sprintf(citami_t('CTR %1$s contro il %2$s tipico delle tue pagine', 'CTR %1$s against your pages\' typical %2$s'), citami_pages_pct($g['ctr']), citami_pages_pct($curve[$b]))
                : sprintf(citami_t('CTR %s con %s impressioni', 'CTR %s on %s impressions'), citami_pages_pct($g['ctr']), number_format_i18n((int) $g['impressions']));
        case 'read_not_cited':
            return sprintf(citami_t('%d domande su cui le AI non ti citano', '%d questions the AI engines skip you on'), count((array) (isset($ai['lostQuestions']) ? $ai['lostQuestions'] : array())));
        case 'near_top':
            return sprintf(citami_t('Posizione %s, %s impressioni', 'Position %s, %s impressions'), number_format_i18n((float) $g['position'], 1), number_format_i18n((int) $g['impressions']));
        case 'not_read_by_ai':
            return citami_t('Nessun bot AI l\'ha aperta in 30 giorni', 'No AI bot opened it in 30 days');
        case 'cannibal':
            return sprintf(citami_t('In conflitto con %s', 'Competing with %s'), citami_pages_title_for_url(isset($v['competing']['url']) ? $v['competing']['url'] : ''));
    }
    return '';
}

function citami_pages_short_action($action) {
    $l = array(
        'meta_draft'    => citami_t('Riscrivi con AI', 'Rewrite with AI'),
        'refresh_brief' => citami_t('Prepara l\'aggiornamento', 'Prepare the update'),
        'aeo_draft'     => citami_t('Scrivi la risposta', 'Write the answer'),
        'indexnow'      => citami_t('Invia a IndexNow', 'Send to IndexNow'),
        'links'         => citami_t('Aggiungi link', 'Add links'),
        'review'        => citami_t('Confronta', 'Compare'),
    );
    return isset($l[$action]) ? $l[$action] : '';
}

/** A site URL as its page title (or its path). */
function citami_pages_title_for_url($url) {
    if ($url === '') return '';
    $id = function_exists('citami_gsc_post_for_url') ? citami_gsc_post_for_url($url) : 0;
    if ($id) return get_the_title($id);
    $path = (string) wp_parse_url($url, PHP_URL_PATH);
    return $path !== '' ? $path : $url;
}

/** The URL or edit link a page's action points to; '' when it is a POST action. */
function citami_pages_action_href(array $p) {
    $pid = (int) $p['post_id'];
    $v = $p['verdict'];
    $map = array('meta_draft' => 'meta', 'refresh_brief' => 'refresh', 'aeo_draft' => 'aeo', 'indexnow' => 'indexnow');
    if (isset($map[$v['action']])) return citami_pages_action_url($map[$v['action']], $pid);
    if ($v['action'] === 'links') return get_edit_post_link($pid, 'raw');
    if ($v['action'] === 'review' && !empty($v['competing']['url'])) return $v['competing']['url'];
    return '';
}

/** Metric pills: clicks with delta, CTR vs typical, position, AI questions and reads. */
function citami_pages_metrics(array $p, array $curve) {
    $g = isset($p['gsc']) && is_array($p['gsc']) ? $p['gsc'] : null;
    $ai = isset($p['ai']) && is_array($p['ai']) ? $p['ai'] : array();
    $out = array();
    if ($g) {
        $delta = '';
        if (isset($g['clicksPrev']) && $g['clicksPrev'] !== null && (int) $g['clicksPrev'] > 0) {
            $d = (int) $g['clicks'] - (int) $g['clicksPrev'];
            if ($d !== 0) {
                $pct = round(100 * $d / (int) $g['clicksPrev']);
                $delta = '<span class="citami-delta citami-delta--' . ($d < 0 ? 'down' : 'up') . '">' . ($d < 0 ? '▼' : '▲') . ' ' . esc_html(($d > 0 ? '+' : '') . $pct . '%') . '</span>';
            }
        }
        $out[] = '<span class="citami-metric"><span class="citami-metric-k">' . esc_html(citami_t('Clic', 'Clicks')) . '</span><span class="citami-metric-v">' . esc_html(number_format_i18n((int) $g['clicks'])) . '</span>' . $delta . '</span>';
        $b = citami_pages_bucket((float) $g['position']);
        $typ = ($b !== '' && isset($curve[$b])) ? (float) $curve[$b] : null;
        $ctr = (float) $g['ctr'];
        $bar = '';
        if ($typ !== null && $typ > 0) {
            $w = max(4, min(100, round(100 * $ctr / max($typ, $ctr))));
            $bar = '<span class="citami-ctrbar" title="' . esc_attr(sprintf(citami_t('Tipico delle tue pagine: %s', 'Typical for your pages: %s'), citami_pages_pct($typ))) . '"><span style="width:' . (int) $w . '%"></span></span><span class="citami-metric-sub">' . esc_html(sprintf(citami_t('tipico %s', 'typical %s'), citami_pages_pct($typ))) . '</span>';
        }
        $out[] = '<span class="citami-metric"><span class="citami-metric-k">CTR</span><span class="citami-metric-v">' . esc_html(citami_pages_pct($ctr)) . '</span>' . $bar . '</span>';
        $out[] = '<span class="citami-metric"><span class="citami-metric-k">' . esc_html(citami_t('Posizione', 'Position')) . '</span><span class="citami-metric-v">' . esc_html(number_format_i18n((float) $g['position'], 1)) . '</span></span>';
        $out[] = '<span class="citami-metric"><span class="citami-metric-k">' . esc_html(citami_t('Impressioni', 'Impressions')) . '</span><span class="citami-metric-v">' . esc_html(number_format_i18n((int) $g['impressions'])) . '</span></span>';
    }
    $lost = count((array) (isset($ai['lostQuestions']) ? $ai['lostQuestions'] : array()));
    $cited = count((array) (isset($ai['citedQuestions']) ? $ai['citedQuestions'] : array()));
    if ($lost > 0 || $cited > 0) {
        $out[] = '<span class="citami-metric citami-metric--ai"><span class="citami-metric-k">' . esc_html(citami_t('Domande AI', 'AI questions')) . '</span><span class="citami-metric-v">' . esc_html(($cited === 1 ? citami_t('1 citata', '1 cited') : sprintf(citami_t('%d citate', '%d cited'), $cited)) . ' · ' . ($lost === 1 ? citami_t('1 persa', '1 lost') : sprintf(citami_t('%d perse', '%d lost'), $lost))) . '</span></span>';
    }
    $reads = (int) (isset($ai['answerReads']) ? $ai['answerReads'] : 0);
    if ($reads > 0) {
        $out[] = '<span class="citami-metric citami-metric--ai"><span class="citami-metric-k">' . esc_html(citami_t('Letta dalle AI', 'Read by AI')) . '</span><span class="citami-metric-v">' . esc_html(sprintf(citami_t('%d× per rispondere', '%d× to answer'), $reads)) . '</span></span>';
    }
    return empty($out) ? '' : '<div class="citami-metrics">' . implode('', $out) . '</div>';
}

/* ---------------------------------------------------------------- */
/*  2.58 — what the AI said, and the AI draft, on the card           */
/* ---------------------------------------------------------------- */

function citami_pages_engine_label($engine) {
    $l = array('chatgpt' => 'ChatGPT', 'openai' => 'ChatGPT', 'perplexity' => 'Perplexity', 'gemini' => 'Gemini', 'google_ai' => 'Google AI', 'claude' => 'Claude', 'copilot' => 'Copilot', 'grok' => 'Grok');
    $k = strtolower((string) $engine);
    return isset($l[$k]) ? $l[$k] : ucfirst($k);
}

/** The AI questions behind the "AI questions" pill: [lost[], cited[]], each array('q', 'engines', 'instead'). */
function citami_pages_question_rows(array $p) {
    $ai = isset($p['ai']) && is_array($p['ai']) ? $p['ai'] : array();
    $lost = array();
    $cited = array();
    if (!empty($ai['questions']) && is_array($ai['questions'])) {
        foreach ($ai['questions'] as $q) {
            if (!is_array($q) || empty($q['q'])) continue;
            $row = array('q' => (string) $q['q'], 'engines' => array_map('strval', (array) (isset($q['engines']) ? $q['engines'] : array())), 'instead' => isset($q['instead']) ? (string) $q['instead'] : '');
            if (isset($q['status']) && $q['status'] === 'cited') $cited[] = $row; else $lost[] = $row;
        }
        return array($lost, $cited);
    }
    // Older platform: the plain lists.
    foreach ((array) (isset($ai['lostQuestions']) ? $ai['lostQuestions'] : array()) as $q) {
        if (is_string($q) && $q !== '') $lost[] = array('q' => $q, 'engines' => array(), 'instead' => '');
    }
    foreach ((array) (isset($ai['citedQuestions']) ? $ai['citedQuestions'] : array()) as $q) {
        if (is_string($q) && $q !== '') $cited[] = array('q' => $q, 'engines' => array(), 'instead' => '');
    }
    return array($lost, $cited);
}

/** The questions themselves, lost first: what the engines answer without you, and where they do cite you. */
function citami_pages_questions_html(array $p, $open = false) {
    list($lost, $cited) = citami_pages_question_rows($p);
    if (empty($lost) && empty($cited)) {
        return '';
    }
    $h = '<details class="citami-page-queries citami-page-aiq" data-citami="ai-questions"' . ($open ? ' open' : '') . '>';
    $n_lost = count($lost) === 1 ? citami_t('1 persa', '1 lost') : sprintf(citami_t('%d perse', '%d lost'), count($lost));
    $n_cited = count($cited) === 1 ? citami_t('1 citata', '1 cited') : sprintf(citami_t('%d citate', '%d cited'), count($cited));
    $h .= '<summary>' . esc_html(sprintf(citami_t('Quali domande: %1$s, %2$s', 'Which questions: %1$s, %2$s'), $n_lost, $n_cited)) . '</summary>';
    if (!empty($lost)) {
        $h .= '<p class="citami-aiq-k citami-aiq-k--lost">' . esc_html(citami_t('Le AI rispondono senza citarti', 'The AI engines answer without citing you')) . '</p><ul class="citami-aiq-list">';
        foreach (array_slice($lost, 0, 10) as $q) {
            $h .= '<li class="is-lost"><span class="citami-aiq-q">«' . esc_html($q['q']) . '»</span>';
            if ($q['instead'] !== '') {
                $h .= ' <span class="citami-aiq-meta">' . esc_html(sprintf(citami_t('citano invece %s', 'they cite %s instead'), $q['instead'])) . '</span>';
            }
            $h .= '</li>';
        }
        $h .= '</ul>';
    }
    if (!empty($cited)) {
        $h .= '<p class="citami-aiq-k citami-aiq-k--cited">' . esc_html(citami_t('Le AI citano questa pagina', 'The AI engines cite this page')) . '</p><ul class="citami-aiq-list">';
        foreach (array_slice($cited, 0, 10) as $q) {
            $h .= '<li class="is-cited"><span class="citami-aiq-q">«' . esc_html($q['q']) . '»</span>';
            if (!empty($q['engines'])) {
                $h .= ' <span class="citami-aiq-meta">' . esc_html(implode(', ', array_map('citami_pages_engine_label', $q['engines']))) . '</span>';
            }
            $h .= '</li>';
        }
        $h .= '</ul>';
    }
    $base = function_exists('citami_brand_site') ? citami_brand_site() : citami_get_endpoint();
    $h .= '<p class="citami-aiq-foot"><a class="citami-link" href="' . esc_url(citami_lang_url($base . '/dashboard/query')) . '" target="_blank" rel="noopener">' . esc_html(citami_t('Leggi le risposte complete nella dashboard', 'Read the full answers in the dashboard')) . '</a></p>';
    return $h . '</details>';
}

/** The pending AI short answer + FAQ, with "now" next to it and the three choices. */
function citami_pages_aeo_draft_html($pid, array $draft, $back = '') {
    $cur = function_exists('citami_content_tldr') ? (string) citami_content_tldr($pid) : '';
    $h = '<div class="citami-page-draft" data-citami="aeo-draft-card">';
    $h .= '<div class="citami-draft-head">' . citami_ui_icon('spark') . ' <strong>' . esc_html(citami_t('Proposta AI: risposta in apertura e FAQ', 'AI proposal: opening answer and FAQ')) . '</strong> <span class="citami-muted">· ' . esc_html(citami_t('non è ancora nella pagina', 'not on the page yet')) . '</span></div>';
    if ($draft['tldr'] !== '') {
        $h .= '<div class="citami-compare">';
        $h .= '<div class="citami-compare-col"><span class="citami-compare-k">' . esc_html(citami_t('Ora', 'Now')) . '</span><p class="citami-snippet-d is-old">' . ($cur !== '' ? esc_html($cur) : '<em>' . esc_html(citami_t('nessuna risposta in apertura', 'no opening answer')) . '</em>') . '</p></div>';
        $h .= '<div class="citami-compare-col is-new"><span class="citami-compare-k">' . esc_html(citami_t('Proposta', 'Proposed')) . '</span><p class="citami-snippet-d">' . esc_html($draft['tldr']) . '</p></div>';
        $h .= '</div>';
    }
    if (!empty($draft['faq'])) {
        $h .= '<span class="citami-compare-k">' . esc_html(sprintf(citami_t('%d FAQ da aggiungere in fondo alla pagina', '%d FAQ to add at the bottom of the page'), count($draft['faq']))) . '</span><dl class="citami-aiq-faq">';
        foreach ($draft['faq'] as $it) {
            $h .= '<dt>' . esc_html($it['q']) . '</dt><dd>' . esc_html($it['a']) . '</dd>';
        }
        $h .= '</dl>';
    }
    $h .= '<p class="citami-muted">' . esc_html(citami_t('Scritta solo dal testo della pagina. "Inserisci" la scrive nella pagina e la salva; le FAQ già presenti restano.', 'Written from the page text only. "Add to the page" writes it into the page and saves it; existing FAQ stay.')) . '</p>';
    $h .= '<div class="citami-draft-actions">';
    $h .= '<a class="citami-btn citami-btn--primary" data-citami-busy="' . esc_attr(citami_t('Inserisco…', 'Adding…')) . '" href="' . esc_url(citami_pages_action_url('aeo_apply', $pid, $back)) . '">' . citami_ui_icon('check') . ' ' . esc_html(citami_t('Inserisci nella pagina', 'Add to the page')) . '</a>';
    $h .= '<a class="citami-btn" href="' . esc_url(citami_aeo_draft_edit_url($pid)) . '">' . esc_html(citami_t('Modifica nell\'editor', 'Edit in the editor')) . ' ' . citami_ui_icon('external') . '</a>';
    $h .= '<a class="citami-btn citami-btn--ghost" data-citami-busy="' . esc_attr(citami_t('Riscrivo… 10-20 secondi', 'Rewriting… 10-20 seconds')) . '" href="' . esc_url(citami_pages_action_url('aeo', $pid, $back)) . '">' . esc_html(citami_t('Riscrivi', 'Rewrite')) . '</a>';
    $h .= '<a class="citami-btn citami-btn--ghost" href="' . esc_url(citami_pages_action_url('aeo_discard', $pid, $back)) . '">' . esc_html(citami_t('Scarta', 'Discard')) . '</a>';
    return $h . '</div></div>';
}

/** One page card: verdict, numbers, the action, drafts, effect of past changes. */
function citami_pages_render_card(array $p, array $curve, $compact = false) {
    $v = $p['verdict'];
    $pid = (int) $p['post_id'];
    $km = citami_pages_kind_meta($v['kind']);
    $title = $pid ? get_the_title($pid) : $p['path'];
    $draft = $pid ? get_post_meta($pid, CITAMI_META_PAGE_DRAFT, true) : null;
    $brief = $pid ? get_post_meta($pid, CITAMI_META_PAGE_BRIEF, true) : null;
    $has_draft = is_array($draft) && !empty($draft['title']);
    $has_brief = is_array($brief) && (!empty($brief['sections']) || !empty($brief['updates']));
    $aeo = ($pid && function_exists('citami_aeo_draft_get')) ? citami_aeo_draft_get($pid) : null;
    $href = $pid ? citami_pages_action_href($p) : '';
    $effect = citami_pages_effect_text($p);
    // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- display only: which card to highlight
    $focus = $pid && isset($_GET['focus']) && (int) $_GET['focus'] === $pid;
    $notice = $focus ? get_transient(CITAMI_PAGES_CARD_NOTICE) : null;
    if (is_array($notice) && (int) $notice['post'] === $pid) {
        delete_transient(CITAMI_PAGES_CARD_NOTICE);
    } else {
        $notice = null;
    }
    ob_start();
    ?>
    <article class="citami-page-card citami-tone--<?php echo esc_attr($km['tone']); ?><?php echo $focus ? ' is-focus' : ''; ?>" data-citami="page-card" data-kind="<?php echo esc_attr($v['kind']); ?>"<?php echo $pid ? ' id="citami-page-' . (int) $pid . '"' : ''; ?>>
        <div class="citami-page-icon"><?php echo wp_kses(citami_pages_svg($km['icon']), citami_kses_allowed()); ?></div>
        <div class="citami-page-body">
            <?php if ($notice): ?>
                <p class="citami-card-notice citami-card-notice--<?php echo esc_attr($notice['type']); ?>" data-citami="card-notice" role="status"><?php echo wp_kses(citami_notice_text_html($notice), citami_kses_allowed()); ?></p>
            <?php endif; ?>
            <span class="citami-page-kind"><?php echo esc_html($km['label']); ?></span>
            <h3 class="citami-page-title"><a href="<?php echo esc_url($p['url']); ?>" target="_blank" rel="noopener"><?php echo esc_html($title); ?></a></h3>
            <span class="citami-page-path"><?php echo esc_html($p['path']); ?></span>
            <p class="citami-page-why"><?php echo esc_html(citami_pages_verdict_text($p, $curve)); ?></p>
            <?php echo wp_kses(citami_pages_metrics($p, $curve), citami_kses_allowed()); ?>
            <?php echo wp_kses(citami_pages_questions_html($p, $v['kind'] === 'read_not_cited' && !$aeo), citami_kses_allowed()); ?>
            <?php if ($effect !== ''): ?>
                <p class="citami-page-effect" data-citami="page-effect"><?php echo wp_kses(citami_pages_svg('<circle cx="8" cy="8" r="5.5"/><path d="M8 5v3l2 1.5"/>'), citami_kses_allowed()); ?> <?php echo esc_html($effect); ?></p>
            <?php endif; ?>
            <?php if (!empty($p['queries'])): ?>
                <details class="citami-page-queries"><summary><?php echo esc_html(count((array) $p['queries']) === 1 ? citami_t('La ricerca principale', 'The top search') : sprintf(citami_t('Le %d ricerche principali', 'The top %d searches'), min(5, count((array) $p['queries'])))); ?></summary>
                    <table class="citami-mini-table"><thead><tr><th><?php echo esc_html(citami_t('Ricerca', 'Search')); ?></th><th><?php echo esc_html(citami_t('Impr.', 'Impr.')); ?></th><th>CTR</th><th><?php echo esc_html(citami_t('Pos.', 'Pos.')); ?></th></tr></thead><tbody>
                    <?php foreach (array_slice((array) $p['queries'], 0, 5) as $q): ?>
                        <tr><td><?php echo esc_html($q['query']); ?><?php if (!empty($q['isNew'])): ?> <span class="citami-new"><?php echo esc_html(citami_t('nuova', 'new')); ?></span><?php endif; ?></td><td><?php echo esc_html(number_format_i18n((int) $q['impressions'])); ?></td><td><?php echo esc_html(citami_pages_pct($q['ctr'])); ?></td><td><?php echo esc_html(number_format_i18n((float) $q['position'], 1)); ?></td></tr>
                    <?php endforeach; ?></tbody></table>
                </details>
            <?php endif; ?>
        </div>
        <aside class="citami-page-aside">
            <?php if (!empty($v['estimatedGain'])): ?>
                <div class="citami-gain"><span class="citami-gain-v">+<?php echo (int) $v['estimatedGain']; ?></span><span class="citami-gain-k"><?php echo esc_html(citami_t('clic in più ogni 28 giorni (stima)', 'more clicks every 28 days (estimate)')); ?></span></div>
            <?php endif; ?>
            <?php if (!$has_draft && !$has_brief && !$aeo && $pid && $href !== ''): ?>
                <?php $primary = in_array($v['action'], array('meta_draft', 'refresh_brief', 'aeo_draft', 'indexnow', 'links'), true); ?>
                <a class="citami-btn <?php echo $primary ? 'citami-btn--primary' : ''; ?>" data-action="<?php echo esc_attr($v['action']); ?>"<?php echo in_array($v['action'], array('meta_draft', 'refresh_brief', 'aeo_draft'), true) ? ' data-citami-busy="' . esc_attr(citami_t('Sto scrivendo… 10-20 secondi', 'Writing… 10-20 seconds')) . '"' : ''; ?> href="<?php echo esc_url($href); ?>"<?php echo $v['action'] === 'review' ? ' target="_blank" rel="noopener"' : ''; ?>><?php echo wp_kses(in_array($v['action'], array('meta_draft', 'refresh_brief', 'aeo_draft'), true) ? citami_ui_icon('spark') . ' ' : '', citami_kses_allowed()); ?><?php echo esc_html(citami_pages_action_label($v['action'])); ?></a>
                <?php if ($v['action'] === 'links'): ?><span class="citami-aside-hint"><?php echo esc_html(citami_t('Nell\'editor, il box Citami propone le pagine da cui linkarla.', 'In the editor, the Citami box suggests the pages to link it from.')); ?></span><?php endif; ?>
                <?php if ($v['action'] === 'review'): ?><span class="citami-aside-hint"><?php echo esc_html(citami_t('Scegli quale delle due risponde: rendi diversa l\'altra o uniscile con un redirect.', 'Pick which of the two answers: make the other different or merge them with a redirect.')); ?></span><?php endif; ?>
            <?php elseif (!$pid): ?>
                <span class="citami-aside-hint"><?php echo esc_html(citami_t('Non è una pagina di WordPress (archivio o URL con parametri).', 'Not a WordPress page (archive or URL with parameters).')); ?></span>
            <?php endif; ?>
        </aside>
        <?php if ($aeo): ?>
            <?php echo wp_kses(citami_pages_aeo_draft_html($pid, $aeo), citami_kses_allowed()); ?>
        <?php elseif ($has_draft): ?>
            <?php
            $seo = function_exists('citami_seo_get_post_fields') ? citami_seo_get_post_fields($pid) : array('title' => '', 'description' => '');
            $cur_t = $seo['title'] !== '' ? $seo['title'] : get_the_title($pid);
            $cur_d = $seo['description'];
            ?>
            <div class="citami-page-draft" data-citami="meta-draft">
                <div class="citami-draft-head"><?php echo wp_kses(citami_ui_icon('spark'), citami_kses_allowed()); ?> <strong><?php echo esc_html(citami_t('Proposta AI', 'AI proposal')); ?></strong><?php if (!empty($draft['why'])): ?> <span class="citami-muted">· <?php echo esc_html($draft['why']); ?></span><?php endif; ?></div>
                <div class="citami-compare">
                    <div class="citami-compare-col">
                        <span class="citami-compare-k"><?php echo esc_html(citami_t('Ora', 'Now')); ?></span>
                        <p class="citami-snippet-t is-old"><?php echo esc_html($cur_t); ?> <span class="citami-count"><?php echo (int) mb_strlen($cur_t); ?></span></p>
                        <p class="citami-snippet-d is-old"><?php echo $cur_d !== '' ? esc_html($cur_d) . ' <span class="citami-count">' . (int) mb_strlen($cur_d) . '</span>' : '<em>' . esc_html(citami_t('nessuna descrizione: Google ne inventa una', 'no description: Google makes one up')) . '</em>'; ?></p>
                    </div>
                    <div class="citami-compare-col is-new">
                        <span class="citami-compare-k"><?php echo esc_html(citami_t('Proposta', 'Proposed')); ?></span>
                        <p class="citami-snippet-t"><?php echo esc_html($draft['title']); ?> <span class="citami-count"><?php echo (int) mb_strlen($draft['title']); ?></span></p>
                        <p class="citami-snippet-d"><?php echo esc_html($draft['description']); ?> <span class="citami-count"><?php echo (int) mb_strlen($draft['description']); ?></span></p>
                    </div>
                </div>
                <?php $mfid = 'citami-meta-apply-' . (int) $pid; ?>
                <form method="post" action="<?php echo esc_url(admin_url('admin-post.php')); ?>" id="<?php echo esc_attr($mfid); ?>" class="citami-inline-form"><input type="hidden" name="action" value="citami_pages_action"><input type="hidden" name="do" value="meta_apply"><input type="hidden" name="post" value="<?php echo (int) $pid; ?>"><?php wp_nonce_field('citami_pages', '_citami_pages_nonce'); ?></form>
                <?php echo wp_kses(citami_pages_h1_choice_html($pid, $draft, $mfid), citami_kses_allowed()); ?>
                <div class="citami-draft-actions">
                    <button class="citami-btn citami-btn--primary" form="<?php echo esc_attr($mfid); ?>"><?php echo wp_kses(citami_ui_icon('check'), citami_kses_allowed()); ?> <?php echo esc_html(citami_t('Usa questi', 'Use these')); ?></button>
                    <a class="citami-btn citami-btn--ghost" href="<?php echo esc_url(citami_pages_action_url('meta_discard', $pid)); ?>"><?php echo esc_html(citami_t('Scarta', 'Discard')); ?></a>
                </div>
            </div>
        <?php elseif ($has_brief): ?>
            <div class="citami-page-draft" data-citami="refresh-brief">
                <div class="citami-draft-head"><?php echo wp_kses(citami_ui_icon('spark'), citami_kses_allowed()); ?> <strong><?php echo esc_html(citami_t('Scaletta dell\'aggiornamento', 'Update brief')); ?></strong></div>
                <?php if (!empty($brief['summary'])): ?><p class="citami-brief-summary"><?php echo esc_html($brief['summary']); ?></p><?php endif; ?>
                <div class="citami-brief-cols">
                    <?php if (!empty($brief['sections'])): ?><div><span class="citami-compare-k"><?php echo esc_html(citami_t('Sezioni da aggiungere', 'Sections to add')); ?></span><ol class="citami-brief-list">
                        <?php foreach ($brief['sections'] as $s): ?><li><span class="citami-h2">H2</span> <strong><?php echo esc_html($s['heading']); ?></strong><?php if ($s['why'] !== ''): ?><span class="citami-brief-why"><?php echo esc_html($s['why']); ?></span><?php endif; ?></li><?php endforeach; ?>
                    </ol></div><?php endif; ?>
                    <?php if (!empty($brief['updates'])): ?><div><span class="citami-compare-k"><?php echo esc_html(citami_t('Da aggiornare', 'To update')); ?></span><ul class="citami-brief-checks">
                        <?php foreach ($brief['updates'] as $u): ?><li><?php echo wp_kses(citami_ui_icon('check'), citami_kses_allowed()); ?> <?php echo esc_html($u); ?></li><?php endforeach; ?>
                    </ul></div><?php endif; ?>
                </div>
                <div class="citami-draft-actions">
                    <a class="citami-btn" href="<?php echo esc_url(citami_edit_link($pid)); ?>"><?php echo esc_html(citami_t('Apri nell\'editor', 'Open in the editor')); ?> <?php echo wp_kses(citami_ui_icon('external'), citami_kses_allowed()); ?></a>
                    <a class="citami-btn citami-btn--primary" href="<?php echo esc_url(citami_pages_action_url('brief_done', $pid)); ?>"><?php echo wp_kses(citami_ui_icon('check'), citami_kses_allowed()); ?> <?php echo esc_html(citami_t('Fatto, ho aggiornato', 'Done, I updated it')); ?></a>
                    <a class="citami-btn citami-btn--ghost" href="<?php echo esc_url(citami_pages_action_url('brief_discard', $pid)); ?>"><?php echo esc_html(citami_t('Scarta', 'Discard')); ?></a>
                </div>
            </div>
        <?php endif; ?>
    </article>
    <?php
    return ob_get_clean();
}

function citami_render_pages_tab() {
    $data = citami_pages_data();
    $curve = isset($data['curve']) && is_array($data['curve']) ? $data['curve'] : array();
    if (empty($data['ok']) && citami_get_api_key() === '') {
        echo wp_kses(citami_connect_card_html('pages'), citami_kses_allowed());
        return;
    }
    if (empty($data['ok'])) {
        ?>
        <section class="citami-card citami-pages-empty">
            <h2><?php echo esc_html(citami_t('Cosa fare su ogni pagina', 'What to do on each page')); ?></h2>
            <p class="citami-empty"><?php echo esc_html(citami_get_api_key() === '' ? citami_t('Collega il sito alla piattaforma per vedere le diagnosi.', 'Connect the site to the platform to see the diagnoses.') : citami_t('La piattaforma non ha risposto: riprova tra poco.', 'The platform did not answer: try again shortly.')); ?></p>
        </section>
        <?php
        return;
    }
    $rows = citami_pages_rows();
    $gain = 0;
    $kinds = array();
    foreach ($rows as $r) {
        $gain += (int) (isset($r['verdict']['estimatedGain']) ? $r['verdict']['estimatedGain'] : 0);
        $kinds[$r['verdict']['kind']] = (isset($kinds[$r['verdict']['kind']]) ? $kinds[$r['verdict']['kind']] : 0) + 1;
    }
    $period = isset($data['period']['start'], $data['period']['end']) ? date_i18n('j M', strtotime($data['period']['start'])) . ' – ' . date_i18n('j M', strtotime($data['period']['end'])) : '';
    $age = !empty($data['cached_at']) ? human_time_diff((int) $data['cached_at'], time()) : '';
    $used = isset($data['usage']['used']) ? (int) $data['usage']['used'] : 0;
    $quota = isset($data['usage']['quota']) ? (int) $data['usage']['quota'] : 0;
    ?>
    <section class="citami-pages-hero">
        <div class="citami-pages-hero-main">
            <span class="citami-eyebrow"><?php echo esc_html(citami_t('Diagnosi pagina per pagina', 'Page-by-page diagnosis')); ?></span>
            <h2 class="citami-pages-hero-title"><?php echo esc_html(empty($rows) ? citami_t('Nessuna pagina da sistemare oggi', 'No page to fix today') : sprintf(count($rows) === 1 ? citami_t('%d pagina da sistemare', '%d page to fix') : citami_t('%d pagine da sistemare', '%d pages to fix'), count($rows))); ?></h2>
            <p class="citami-pages-hero-sub"><?php echo esc_html(citami_t('Search Console, risposte delle AI, bot che leggono il sito e visite dalle AI, incrociati per ogni pagina. Una diagnosi, un\'azione: le bozze AI le approvi tu.', 'Search Console, AI answers, the bots reading the site and visits from AI, crossed for every page. One diagnosis, one action: you approve the AI drafts.')); ?></p>
        </div>
        <div class="citami-pages-hero-stats">
            <?php if ($gain > 0): ?>
                <div class="citami-hero-stat"><span class="citami-hero-stat-v">+<?php echo (int) $gain; ?></span><span class="citami-hero-stat-k"><?php echo esc_html(citami_t('clic recuperabili ogni 28 giorni (stima)', 'recoverable clicks every 28 days (estimate)')); ?></span></div>
            <?php endif; ?>
            <?php if ($quota > 0): ?>
                <div class="citami-hero-stat" data-citami="page-ai-usage"><span class="citami-hero-stat-v"><?php echo (int) $used; ?><small>/<?php echo (int) $quota; ?></small></span><span class="citami-hero-stat-k"><?php echo esc_html(sprintf(citami_t('Riscritture AI questo mese: %1$d su %2$d', 'AI rewrites this month: %1$d of %2$d'), $used, $quota)); ?></span><span class="citami-meter"><span style="width:<?php echo (int) min(100, round(100 * $used / max(1, $quota))); ?>%"></span></span></div>
            <?php endif; ?>
        </div>
        <div class="citami-pages-hero-foot">
            <span class="citami-source <?php echo !empty($data['gscConnected']) ? 'is-on' : 'is-off'; ?>"><?php echo esc_html('Search Console' . ($period !== '' && !empty($data['gscConnected']) ? ' · ' . $period : '')); ?></span>
            <span class="citami-source <?php echo !empty($data['hasBotData']) ? 'is-on' : 'is-off'; ?>"><?php echo esc_html(citami_t('Bot AI · 30 giorni', 'AI bots · 30 days')); ?></span>
            <span class="citami-source is-on"><?php echo esc_html(citami_t('Risposte delle AI · ultimo audit', 'AI answers · latest audit')); ?></span>
            <span class="citami-muted"><?php echo esc_html($age !== '' ? sprintf(citami_t('aggiornati %s fa', 'updated %s ago'), $age) : ''); ?></span>
            <a class="citami-link" href="<?php echo esc_url(citami_pages_action_url('refresh_data')); ?>"><?php echo esc_html(citami_t('Aggiorna', 'Refresh')); ?></a>
        </div>
        <?php if (empty($data['gscConnected'])): ?>
            <p class="citami-pages-hero-warn"><?php echo esc_html(citami_t('Search Console non è collegato: vedi solo le diagnosi che vengono dalle AI. Collegalo dalla piattaforma per avere clic, CTR e posizioni.', 'Search Console is not connected: you only see the diagnoses that come from AI. Connect it on the platform to get clicks, CTR and positions.')); ?></p>
        <?php endif; ?>
    </section>
    <?php if (!empty($rows)): ?>
        <div class="citami-filters" role="toolbar" aria-label="<?php echo esc_attr(citami_t('Filtra per problema', 'Filter by problem')); ?>">
            <button type="button" class="citami-filter is-active" data-citami-page-filter="all"><?php echo esc_html(citami_t('Tutte', 'All')); ?> <b><?php echo count($rows); ?></b></button>
            <?php foreach ($kinds as $k => $n): $km = citami_pages_kind_meta($k); ?>
                <button type="button" class="citami-filter citami-tone--<?php echo esc_attr($km['tone']); ?>" data-citami-page-filter="<?php echo esc_attr($k); ?>"><?php echo esc_html($km['label']); ?> <b><?php echo (int) $n; ?></b></button>
            <?php endforeach; ?>
        </div>
        <div class="citami-page-list" data-citami="page-list">
            <?php foreach ($rows as $p) echo wp_kses(citami_pages_render_card($p, $curve), citami_kses_allowed()); ?>
        </div>
    <?php endif; ?>
    <?php
}

/** Overview card: the three highest-priority actions of the week, as a compact list. */
function citami_pages_render_overview_card() {
    $data = get_transient(CITAMI_PAGES_TRANSIENT);
    if (!is_array($data)) {
        $data = citami_get_api_key() !== '' ? citami_pages_data() : array();
    }
    if (empty($data['ok'])) {
        return '';
    }
    $rows = citami_pages_rows(3);
    if (empty($rows)) {
        return '';
    }
    $curve = isset($data['curve']) && is_array($data['curve']) ? $data['curve'] : array();
    ob_start();
    ?>
    <section class="citami-card citami-week" data-citami="week-actions">
        <header class="citami-card-head">
            <div>
                <span class="citami-eyebrow"><?php echo esc_html(citami_t('Questa settimana', 'This week')); ?></span>
                <h3 class="citami-week-title"><?php echo esc_html(citami_t('Le 3 cose da fare questa settimana', 'The 3 things to do this week')); ?></h3>
            </div>
            <a class="citami-link" href="<?php echo esc_url(citami_admin_url('pages')); ?>"><?php echo esc_html(citami_t('Tutte le pagine', 'All pages')); ?> <?php echo wp_kses(citami_ui_icon('arrow'), citami_kses_allowed()); ?></a>
        </header>
        <ol class="citami-week-list">
            <?php $i = 0; foreach ($rows as $p): $i++; $km = citami_pages_kind_meta($p['verdict']['kind']); $pid = (int) $p['post_id']; $href = $pid ? citami_pages_action_href($p) : ''; ?>
                <li class="citami-week-item citami-tone--<?php echo esc_attr($km['tone']); ?>" data-citami="page-card" data-kind="<?php echo esc_attr($p['verdict']['kind']); ?>">
                    <span class="citami-week-n"><?php echo (int) $i; ?></span>
                    <span class="citami-page-icon citami-page-icon--sm"><?php echo wp_kses(citami_pages_svg($km['icon']), citami_kses_allowed()); ?></span>
                    <span class="citami-week-main">
                        <span class="citami-week-page"><?php echo esc_html($pid ? get_the_title($pid) : $p['path']); ?></span>
                        <span class="citami-week-why"><span class="citami-page-kind"><?php echo esc_html($km['label']); ?></span> · <?php echo esc_html(citami_pages_short_reason($p, $curve)); ?></span>
                    </span>
                    <?php if (!empty($p['verdict']['estimatedGain'])): ?><span class="citami-week-gain">+<?php echo (int) $p['verdict']['estimatedGain']; ?> <?php echo esc_html(citami_t('clic', 'clicks')); ?></span><?php endif; ?>
                    <?php if ($href !== ''): ?><a class="citami-btn citami-btn--sm <?php echo $p['verdict']['action'] === 'review' ? '' : 'citami-btn--primary'; ?>" data-action="<?php echo esc_attr($p['verdict']['action']); ?>" href="<?php echo esc_url($href); ?>"><?php echo esc_html(citami_pages_short_action($p['verdict']['action'])); ?></a><?php endif; ?>
                </li>
            <?php endforeach; ?>
        </ol>
    </section>
    <?php
    return ob_get_clean();
}