#!/usr/bin/env python3 """ Enhanced Landing Page Template — Reference for LLM-enriched card generation. This file documents the HTML card pattern that Phase 2 (LLM enrichment) produces. It is NOT meant to be executed directly — it's a structural reference for agents rewriting ~/.hermes/landing/YYYY-MM-DD.html. Pattern: vertical stack of cards, each containing: - Rank badge (absolute positioned top-left) - Header: repo name as link + star count badge - Meta badges: language tag, category tag - Problem section ("🎯 Problema que resolve" — full sentence) - Advantages section ("🌟 Vantagens" — 3-5 bullet points) - Footer: "Ver no GitHub →" link The file is regenerated each day; index.html is updated separately. """ import re CARD_HTML_TEMPLATE = '''
#{rank}

{name}

{language} ⭐ {stars_formatted} {category_label}
🎯 Problema que resolve

{problem}

🌟 Vantagens
    {advantages_items}
Ver no GitHub →
''' PAGE_HTML_TEMPLATE = ''' GitHub Trending — {date}
← Arquivo Histórico

🔥 GitHub Trending {date}

Análise aprimorada por IA dos 20 repositórios mais populares do dia

📦 20 repositórios 📊 Análise via README 🤖 Aprimorado por Hermes Agent
{cards}
Gerado por Hermes Agent em {date}
📈 Fonte: GitHub Trending
''' # ── Helpers ────────────────────────────────────────────────────────── def esc(s: str) -> str: """HTML-escape a string.""" return str(s).replace('&', '&').replace('<', '<').replace('>', '>').replace('"', '"') def format_stars(n) -> str: """Format star count with commas (e.g. 70260 → '70,260').""" if isinstance(n, str): n = int(n.replace(',', '')) return f"{n:,}" def lang_slug(language: str) -> str: """Normalize language name into a CSS-safe class.""" return re.sub(r'[^a-z0-9]', '-', language.lower())[:15] or 'outro' def strip_html(text: str) -> str: """Remove HTML tags and collapse whitespace.""" clean = re.sub(r'<[^>]+>', ' ', text) return re.sub(r'\s+', ' ', clean).strip() # ── Card builders ──────────────────────────────────────────────────── def build_card(rank: int, name: str, url: str, language: str, stars: int, problem: str, advantages: list[str], category_label: str) -> str: """Generate a single enhanced card HTML block. All content args (problem, advantages, category_label) should be LLM-extracted clean text — not raw README fragments. """ adv_items = ''.join(f'
  • {esc(a)}
    • ' for a in advantages[:5]) stars_fmt = format_stars(stars) return CARD_HTML_TEMPLATE.format( rank=rank, name=esc(name), url=url, language=esc(language), lang_slug=lang_slug(language), stars_formatted=stars_fmt, category_label=esc(category_label), problem=esc(problem), advantages_items=adv_items, ) def build_page(date: str, cards_html: str) -> str: """Wrap cards in the full HTML page including header, nav, footer.""" return PAGE_HTML_TEMPLATE.format(date=date, cards=cards_html) # ── Base README analysis (override in Phase 2 with LLM) ────────────── def analyze_readme(readme_text: str, trending_description: str) -> tuple[str, list[str], str]: """Default heuristic analysis of a README. Returns (problem, advantages_list, category_string). NOTE: This heuristic is unreliable for HTML-rich READMEs. Override in Phase 2 (LLM enrichment) for quality results. See: phase-2-llm-enrichment in github-trending-reporting SKILL.md. """ clean = strip_html(readme_text) lines = clean.split('\n') # Problem: first non-header paragraph >40 chars, or fallback to trending description problem = trending_description for line in lines: s = line.strip() if s and not s.startswith('#') and not s.startswith('[') and not s.startswith('