<?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.33.0 — DASHBOARD WIDGET "LE AI E IL TUO SITO"                     */
/*  The one screen a customer opens every day is the WordPress         */
/*  dashboard. This widget puts there what the plugin actually knows: */
/*  which AI crawlers came in the last 7 days and which pages they    */
/*  read, which pages no AI has read, the URLs the assistants         */
/*  invented, the wrong facts still open on the platform, the AEO     */
/*  average, the state of /ai-info and of the About page. Every       */
/*  number links to the tab that fixes it. Works without the          */
/*  platform (the platform-only figures show as "—").                  */
/* ────────────────────────────────────────────────────────────────── */

define('CITAMI_SITE_SUMMARY_OPT', 'citami_site_summary');
define('CITAMI_WIDGET_DAYS', 7);

/** Search-engine crawlers are not "AI reading the site". */
function citami_widget_search_only_bots() {
    return array('googlebot', 'bingbot', 'applebot');
}

// The platform's summary travels with the sync (open misconceptions, last audit).
add_action('citami_sync_response', function ($data) {
    if (!is_array($data) || !isset($data['site_summary']) || !is_array($data['site_summary'])) {
        return;
    }
    $s = $data['site_summary'];
    $clean = array(
        'misconceptions_open' => isset($s['misconceptions_open']) && is_numeric($s['misconceptions_open']) ? (int) $s['misconceptions_open'] : null,
        'last_audit_score'    => isset($s['last_audit_score']) && is_numeric($s['last_audit_score']) ? (int) $s['last_audit_score'] : null,
        'last_audit_at'       => isset($s['last_audit_at']) ? sanitize_text_field((string) $s['last_audit_at']) : '',
        'citations'           => isset($s['citations']) && is_numeric($s['citations']) ? (int) $s['citations'] : null,
        'prompts'             => isset($s['prompts']) && is_numeric($s['prompts']) ? (int) $s['prompts'] : null,
        'received_at'         => time(),
    );
    update_option(CITAMI_SITE_SUMMARY_OPT, $clean, false);
});

function citami_site_summary() {
    $s = get_option(CITAMI_SITE_SUMMARY_OPT, array());
    return is_array($s) ? $s : array();
}

/** AI crawler activity in the last N days: hits, pages read (path → hits, bots), bots seen. */
function citami_widget_ai_activity($days = CITAMI_WIDGET_DAYS) {
    $log = get_option(CITAMI_BOTS_LOG_OPT, array());
    $since = time() - $days * DAY_IN_SECONDS;
    $skip = citami_widget_search_only_bots();
    $pages = array();
    $bots = array();
    $hits = 0;
    foreach ((array) $log as $e) {
        if (!is_array($e) || (int) $e['ts'] < $since || in_array($e['bot'], $skip, true)) {
            continue;
        }
        if (isset($e['verified']) && $e['verified'] === false) {
            continue; // spoofed
        }
        $hits++;
        $path = citami_redirect_normalise_path(isset($e['path']) ? (string) $e['path'] : '/');
        if (!isset($pages[$path])) {
            $pages[$path] = array('path' => $path, 'hits' => 0, 'bots' => array(), 'last' => 0);
        }
        $pages[$path]['hits']++;
        $pages[$path]['bots'][$e['bot']] = true;
        $pages[$path]['last'] = max($pages[$path]['last'], (int) $e['ts']);
        $bots[$e['bot']] = isset($bots[$e['bot']]) ? $bots[$e['bot']] + 1 : 1;
    }
    uasort($pages, function ($a, $b) { return $b['hits'] <=> $a['hits'] ?: $b['last'] <=> $a['last']; });
    foreach ($pages as &$p) {
        $p['bots'] = array_keys($p['bots']);
    }
    unset($p);
    arsort($bots);
    return array('days' => $days, 'hits' => $hits, 'pages' => $pages, 'bots' => $bots);
}

/** Published pages and posts nobody from the AI catalogue has read: the ones with most internal links first. */
function citami_widget_unread_pages(array $read_paths, $limit = 5) {
    if (!function_exists('citami_links_index')) {
        return array('total' => 0, 'unread' => 0, 'sample' => array());
    }
    $idx = citami_links_index();
    $entries = isset($idx['entries']) && is_array($idx['entries']) ? $idx['entries'] : array();
    $inbound = function_exists('citami_links_inbound_counts') ? citami_links_inbound_counts($idx) : array();
    $read = array();
    foreach ($read_paths as $p) {
        $read[rtrim($p, '/')] = true;
    }
    $unread = array();
    foreach ($entries as $e) {
        if (empty($e['url']) || !empty($e['noindex'])) continue;
        $path = rtrim((string) wp_parse_url((string) $e['url'], PHP_URL_PATH), '/');
        if (isset($read[$path])) continue;
        $unread[] = array('id' => (int) $e['id'], 'title' => (string) $e['title'], 'url' => (string) $e['url'], 'inbound' => isset($inbound[$e['id']]) ? (int) $inbound[$e['id']] : 0);
    }
    usort($unread, function ($a, $b) { return $b['inbound'] <=> $a['inbound'] ?: $a['title'] <=> $b['title']; });
    return array('total' => count($entries), 'unread' => count($unread), 'sample' => array_slice($unread, 0, $limit));
}

/** Title for a path from the links index, or the path itself. */
function citami_widget_title_for_path($path) {
    if (function_exists('citami_links_index')) {
        $idx = citami_links_index();
        foreach ((array) (isset($idx['entries']) ? $idx['entries'] : array()) as $e) {
            if (!empty($e['url']) && rtrim((string) wp_parse_url((string) $e['url'], PHP_URL_PATH), '/') === rtrim($path, '/')) {
                return (string) $e['title'];
            }
        }
    }
    return $path === '' ? '/' : $path;
}

/** Everything the widget shows, in one array (also handy for tests). */
function citami_widget_data() {
    $activity = citami_widget_ai_activity();
    $unread = citami_widget_unread_pages(array_keys($activity['pages']));
    $hall = function_exists('citami_404_ai_entries') ? citami_404_ai_entries(5) : array();
    $hall_all = function_exists('citami_404_ai_entries') ? count(citami_404_ai_entries(1000)) : 0;
    $health = function_exists('citami_content_health_snapshot') ? citami_content_health_snapshot() : array();
    $truth = isset($health['truth']) && is_array($health['truth']) ? $health['truth'] : array();
    $aeo = isset($health['aeo']) && is_array($health['aeo']) ? $health['aeo'] : array();
    $summary = citami_site_summary();
    return array(
        'activity'   => $activity,
        'unread'     => $unread,
        'hallucinated' => array('count' => $hall_all, 'list' => $hall),
        'aeo_avg'    => isset($aeo['avg']) ? $aeo['avg'] : null,
        'aeo_scored' => isset($aeo['scored']) ? (int) $aeo['scored'] : 0,
        'ai_info'    => function_exists('citami_truth_ai_info_enabled') && citami_truth_ai_info_enabled() ? citami_truth_ai_info_url() : '',
        'has_sheet'  => !empty($truth['has_sheet']),
        'truth_errors' => isset($truth['errors']) ? (int) $truth['errors'] : 0,
        'about'      => isset($truth['about']) && is_array($truth['about']) ? $truth['about'] : null,
        'summary'    => $summary,
        'connected'  => citami_get_api_key() !== '',
    );
}

function citami_widget_bot_label($slug) {
    $cat = function_exists('citami_bots_catalog') ? citami_bots_catalog() : array();
    return isset($cat[$slug]['label']) ? $cat[$slug]['label'] : $slug;
}

function citami_render_ai_widget() {
    $d = citami_widget_data();
    $tab = function ($t) { return admin_url('admin.php?page=citami-connector&tab=' . $t); };
    $a = $d['activity'];
    $s = $d['summary'];
    $mis = isset($s['misconceptions_open']) && $s['misconceptions_open'] !== null ? (int) $s['misconceptions_open'] : null;
    // 2.60 — every KPI opens the list behind it, same targets as the Overview KPIs.
    $overview = function_exists('citami_admin_url') ? citami_admin_url('overview') : admin_url('admin.php?page=citami-connector&tab=overview');
    $site_base = function_exists('citami_brand_site') ? citami_brand_site() : citami_get_endpoint();
    $mis_href = $mis !== null ? citami_lang_url($site_base . '/dashboard/brand') : $tab('brand');
    ?>
    <div class="citami-ai-widget">
        <div class="citami-kpis">
            <a class="citami-kpi" href="<?php echo esc_url($tab('bots') . '#citami-bots-log'); ?>">
                <span class="citami-kpi-label"><?php echo esc_html(sprintf(citami_t('Visite di AI (%d gg)', 'AI visits (%d days)'), (int) $a['days'])); ?></span>
                <span class="citami-kpi-value"><?php echo (int) $a['hits']; ?></span>
                <span class="citami-kpi-delta"><?php echo esc_html(count($a['bots']) === 0 ? citami_t('nessun crawler', 'no crawler') : implode(', ', array_map('citami_widget_bot_label', array_slice(array_keys($a['bots']), 0, 3)))); ?></span>
            </a>
            <a class="citami-kpi" data-citami="kpi-read" href="<?php echo esc_url($overview . '#citami-read-pages'); ?>">
                <span class="citami-kpi-label"><?php echo esc_html(citami_t('Pagine lette dalle AI', 'Pages read by AI')); ?></span>
                <span class="citami-kpi-value"><?php echo (int) count($a['pages']); ?><?php if ($d['unread']['total'] > 0): ?><small> / <?php echo (int) $d['unread']['total']; ?></small><?php endif; ?></span>
                <span class="citami-kpi-delta"><?php echo esc_html(sprintf(citami_t('ultimi %d gg', 'last %d days'), (int) $a['days'])); ?></span>
            </a>
            <a class="citami-kpi" data-citami="kpi-unread" href="<?php echo esc_url($overview . '#citami-unread-pages'); ?>">
                <span class="citami-kpi-label"><?php echo esc_html(citami_t('Mai lette da un\'AI', 'Never read by an AI')); ?></span>
                <span class="citami-kpi-value <?php echo (int) $d['unread']['unread'] > 0 ? 'citami-warn' : ''; ?>"><?php echo (int) $d['unread']['unread']; ?></span>
                <span class="citami-kpi-delta"><?php echo esc_html(citami_t('linkale dalla home', 'link them from the home')); ?></span>
            </a>
            <a class="citami-kpi" href="<?php echo esc_url($tab('redirects')); ?>">
                <span class="citami-kpi-label"><?php echo esc_html(citami_t('URL inventati dalle AI', 'URLs invented by AI')); ?></span>
                <span class="citami-kpi-value <?php echo $d['hallucinated']['count'] > 0 ? 'citami-warn' : ''; ?>"><?php echo (int) $d['hallucinated']['count']; ?></span>
                <span class="citami-kpi-delta"><?php echo esc_html($d['hallucinated']['count'] > 0 ? citami_t('da reindirizzare', 'to redirect') : citami_t('nessuno', 'none')); ?></span>
            </a>
            <a class="citami-kpi" data-citami="kpi-facts" href="<?php echo esc_url($mis_href); ?>"<?php echo $mis !== null ? ' target="_blank" rel="noopener"' : ''; ?>>
                <span class="citami-kpi-label"><?php echo esc_html(citami_t('Fatti sbagliati aperti', 'Wrong facts open')); ?></span>
                <span class="citami-kpi-value <?php echo $mis !== null && $mis > 0 ? 'citami-bad' : ''; ?>"><?php echo $mis === null ? '—' : (int) $mis; ?></span>
                <span class="citami-kpi-delta"><?php echo esc_html($mis === null ? ($d['connected'] ? citami_t('dopo il prossimo audit', 'after the next audit') : citami_t('serve Citami', 'needs Citami')) : citami_t('leggili sulla piattaforma ↗', 'read them on the platform ↗')); ?></span>
            </a>
            <a class="citami-kpi" data-citami="kpi-aeo" href="<?php echo esc_url(function_exists('citami_admin_url') ? citami_admin_url('pages') : $tab('pages')); ?>">
                <span class="citami-kpi-label"><?php echo esc_html(citami_t('AEO medio', 'Average AEO')); ?></span>
                <span class="citami-kpi-value"><?php echo $d['aeo_avg'] === null ? '—' : (int) $d['aeo_avg']; ?></span>
                <span class="citami-kpi-delta"><?php echo esc_html(sprintf(citami_t('su %d pagine', 'over %d pages'), (int) $d['aeo_scored'])); ?></span>
            </a>
        </div>

        <?php
        // 2.61 — the dashboard is not the place for lists: the three things worth a click, then the plugin.
        $todo = array();
        if (!empty($d['hallucinated']['list'])) {
            $h = $d['hallucinated']['list'][0];
            $todo[] = array(
                'text' => sprintf(citami_t('%1$d URL inventati dalle AI, il più chiesto: %2$s', '%1$d URLs invented by AI, the most requested: %2$s'), (int) $d['hallucinated']['count'], $h['path']),
                'href' => $tab('redirects') . '&source=' . rawurlencode($h['path']) . ($h['suggested'] !== '' ? '&target=' . rawurlencode($h['suggested']) : ''),
                'cta'  => citami_t('crea redirect', 'create redirect'),
            );
        }
        if ((int) $d['unread']['unread'] > 0) {
            $todo[] = array(
                'text' => sprintf(citami_t('%d pagine importanti mai lette da un\'AI', '%d important pages no AI has read'), (int) $d['unread']['unread']),
                'href' => function_exists('citami_admin_url') ? citami_admin_url('links') : $tab('links'),
                'cta'  => citami_t('collegale', 'link them'),
            );
        }
        if (function_exists('citami_pages_rows') && get_transient(CITAMI_PAGES_TRANSIENT)) {
            foreach (citami_pages_rows(1) as $pr) {
                $todo[] = array(
                    'text' => ($pr['post_id'] ? get_the_title($pr['post_id']) : $pr['path']) . ' — ' . citami_pages_kind_meta($pr['verdict']['kind'])['label'],
                    'href' => $pr['post_id'] ? citami_pages_card_url($pr['post_id']) : citami_admin_url('pages'),
                    'cta'  => citami_t('vedi', 'open'),
                );
            }
        }
        ?>
        <?php if (!empty($todo)): ?>
        <h4><?php echo esc_html(citami_t('Da fare', 'To do')); ?></h4>
        <ul class="citami-widget-list citami-widget-todo" data-citami="widget-todo">
            <?php foreach (array_slice($todo, 0, 3) as $t): ?>
                <li><span><?php echo esc_html($t['text']); ?></span> <a href="<?php echo esc_url($t['href']); ?>"><?php echo esc_html($t['cta']); ?> →</a></li>
            <?php endforeach; ?>
        </ul>
        <?php endif; ?>
        <p class="citami-widget-open"><a class="button button-primary" href="<?php echo esc_url($overview); ?>"><?php echo esc_html(sprintf(citami_t('Apri %s', 'Open %s'), citami_brand_name())); ?></a></p>

        <p class="citami-widget-status">
            <?php if ($d['ai_info'] !== ''): ?>
                <span class="citami-good">●</span> <a href="<?php echo esc_url($d['ai_info']); ?>" target="_blank" rel="noopener">/<?php echo esc_html(trim((string) wp_parse_url($d['ai_info'], PHP_URL_PATH), '/')); ?></a>
                <?php echo esc_html($d['truth_errors'] > 0 ? sprintf(citami_t(' · %d incoerenze col sito', ' · %d site inconsistencies'), (int) $d['truth_errors']) : citami_t(' · sito coerente con la scheda', ' · site consistent with the sheet')); ?>
            <?php elseif ($d['has_sheet']): ?>
                <span class="citami-muted">●</span> <a data-citami="ai-info-off" href="<?php echo esc_url($tab('brand') . '#citami-ai-info'); ?>"><?php echo esc_html(citami_t('/ai-info spenta (facoltativa)', '/ai-info off (optional)')); ?></a>
            <?php else: ?>
                <span class="citami-warn">●</span> <a href="<?php echo esc_url($tab('brand')); ?>"><?php echo esc_html(citami_t('Compila la scheda dei fatti', 'Fill in the fact sheet')); ?></a>
            <?php endif; ?>
            <?php if (is_array($d['about'])): ?>
                · <a href="<?php echo esc_url($tab('brand')); ?>"><?php echo esc_html(citami_t('Chi siamo', 'About')); ?></a>
                <?php echo !empty($d['about']['found']) ? esc_html((int) $d['about']['score'] . '/100') : esc_html(citami_t('mancante', 'missing')); ?>
            <?php endif; ?>
            <?php if (isset($s['last_audit_score']) && $s['last_audit_score'] !== null): ?>
                · <?php echo esc_html(sprintf(citami_t('ultimo audit %d/100', 'last audit %d/100'), (int) $s['last_audit_score'])); ?><?php if (!empty($s['last_audit_at'])): ?> (<?php echo esc_html(substr((string) $s['last_audit_at'], 0, 10)); ?>)<?php endif; ?>
            <?php endif; ?>
        </p>
    </div>
    <?php
}

add_action('wp_dashboard_setup', function () {
    if (!current_user_can('manage_options')) {
        return;
    }
    wp_add_dashboard_widget('citami_ai', citami_brand_name() . ' · ' . citami_t('Le AI e il tuo sito', 'AI and your site'), 'citami_render_ai_widget');
});