breakpilot-compliance/backend-compliance/compliance/api/agent_check/_b19_wiring.py

"""B19 wiring — Cookie-Coherence-Check (Salesforce-as-essential)."""

from __future__ import annotations

import html
import logging
from collections import Counter

from compliance.services.cookie_coherence_check import check_cookie_coherence

logger = logging.getLogger(__name__)


def run_b19(state: dict) -> None:
    # Step 3 — Auto-Learning: alle deklarierten Cookies dieser Site
    # in cookie_behavior_audits loggen (Cross-Site-Konsens-Basis).
    try:
        from compliance.services.cookie_observation_logger import (
            log_observations,
        )
        stats = log_observations(state)
        logger.info("B19 observation-logger: %s", stats)
    except Exception as e:
        logger.warning("observation-logger skipped: %s", e)

    new = check_cookie_coherence(state)
    if not new:
        return
    extras = state.get("extra_findings") or []
    extras.extend(new)
    state["extra_findings"] = extras
    state["cookie_coherence_html"] = _render(new)
    state["cookie_coherence_findings"] = new
    logger.info("B19 cookie-coherence: %d finding(s)", len(new))


def _render(findings: list[dict]) -> str:
    # Aggregate per type for the summary chip
    by_type = Counter(f.get("check_id") for f in findings)
    severity_color = {
        "HIGH": "#dc2626", "MEDIUM": "#f59e0b", "LOW": "#64748b",
    }
    # Show only the top 12 cards in the mail; rest goes to CSV
    cards = []
    for f in findings[:12]:
        sev = (f.get("severity") or "").upper()
        color = severity_color.get(sev, "#475569")
        meta = ""
        if f.get("cookie_name"):
            meta += (
                "<div style='font-size:12px;color:#475569;margin-top:6px;'>"
                f"<em>Cookie: <code>{html.escape(f['cookie_name'])}</code>"
                f" · Vendor: {html.escape(f.get('vendor') or '?')}</em>"
                "</div>"
            )
        if f.get("declared_category"):
            meta += (
                "<div style='font-size:11px;color:#7f1d1d;margin-top:3px;'>"
                f"declared: <code>{html.escape(f['declared_category'])}</code>"
                + (f" · actual (KB): <code>{html.escape(f['actual_category'])}</code>"
                   if f.get("actual_category") else "")
                + "</div>"
            )
        cards.append(
            f"<div style='margin:12px 0;padding:14px;background:#fff;"
            f"border-left:3px solid {color};border-radius:4px;'>"
            f"<div style='font-weight:600;color:{color};font-size:14px;'>"
            f"{sev} · {html.escape(f.get('check_id') or '')}</div>"
            f"<div style='font-size:14px;margin-top:4px;'>"
            f"<strong>{html.escape(f.get('title') or '')}</strong></div>"
            f"<div style='font-size:12px;color:#64748b;margin-top:2px;'>"
            f"{html.escape(f.get('norm') or '')}</div>"
            f"{meta}"
            f"<div style='font-size:12px;color:#475569;margin-top:6px;'>"
            f"<em>{html.escape(f.get('evidence') or '')}</em></div>"
            f"<div style='font-size:13px;margin-top:8px;background:#dcfce7;"
            f"padding:8px 10px;border-radius:4px;'>"
            f"<strong>→ Abstellung:</strong> "
            f"{html.escape(f.get('recommended_action') or '')}</div>"
            "</div>"
        )
    type_summary = " · ".join(
        f"{k.split('-')[-1]}: {v}" for k, v in by_type.most_common()
    )
    return (
        "<div style='margin:24px 0;padding:16px;border-left:4px solid #dc2626;"
        "background:#fef2f2;border-radius:4px;'>"
        "<h2 style='margin:0 0 8px;color:#7f1d1d;font-size:16px;'>"
        f"🍪 Cookie-Kohärenz ({len(findings)} Befunde)"
        "</h2>"
        f"<p style='margin:0 0 8px;font-size:12px;color:#475569;'>"
        f"Vergleich Site-Deklaration vs Open Cookie Database (2287) + "
        f"BreakPilot-KB.<br><strong>Verteilung:</strong> {type_summary}</p>"
        + "".join(cards)
        + (f"<p style='font-size:12px;color:#64748b;margin-top:8px;'>"
           f"<em>… und {len(findings)-12} weitere — vollständige Liste "
           f"in <code>cookies-full.csv</code> im ZIP-Anhang.</em></p>"
           if len(findings) > 12 else "")
        + "</div>"
    )