@lugom.io/hefesto 0.3.0 → 1.0.0

package/skills/hefesto-design/scripts/core.py

@@ -1,155 +0,0 @@
-#!/usr/bin/env python3
-"""Motor de busca BM25 reutilizável para os scripts de design do Hefesto.
-
-Carrega CSVs, constrói índice invertido e ranqueia resultados usando BM25.
-Usado como módulo por search.py, design_system.py e outros scripts.
-"""
-
-import csv
-import math
-import re
-import unicodedata
-from pathlib import Path
-
-STOP_WORDS = frozenset({
-    # Português BR
-    "de", "da", "do", "das", "dos", "em", "no", "na", "nos", "nas",
-    "um", "uma", "uns", "umas", "ao", "aos", "por", "para", "com",
-    "sem", "sob", "sobre", "entre", "que", "se", "ou", "mas", "nem",
-    "como", "mais", "muito", "bem", "mal", "ja", "ainda", "tambem",
-    "so", "apenas", "ate", "desde", "esse", "essa", "este", "esta",
-    "isso", "isto", "aquilo", "ele", "ela", "eles", "elas", "nos",
-    "vos", "lhe", "lhes", "me", "te", "meu", "minha", "seu", "sua",
-    "teu", "tua", "nosso", "nossa", "vosso", "vossa", "ser", "estar",
-    "ter", "haver", "ir", "vir", "fazer", "dar", "dizer", "ver",
-    "saber", "poder", "querer", "dever", "foi", "sao", "era", "tem",
-    # English
-    "the", "be", "to", "of", "and", "in", "that", "have", "it",
-    "for", "not", "on", "with", "he", "as", "you", "do", "at",
-    "this", "but", "his", "by", "from", "they", "we", "say", "her",
-    "she", "or", "an", "will", "my", "one", "all", "would", "there",
-    "their", "what", "so", "up", "out", "if", "about", "who", "get",
-    "which", "go", "me", "when", "make", "can", "like", "no", "just",
-    "him", "know", "take", "how", "come", "could", "them", "see",
-    "than", "now", "its", "is", "are", "was", "were", "been", "has",
-    "had", "did", "does", "a", "am",
-})
-
-def _remove_accents(text):
-    """Remove acentos usando unicodedata NFKD."""
-    nfkd = unicodedata.normalize("NFKD", text)
-    return "".join(c for c in nfkd if not unicodedata.combining(c))
-
-
-class BM25:
-    """Motor de busca BM25 sobre arquivos CSV."""
-
-    def __init__(self, csv_path, search_fields, k1=1.5, b=0.75):
-        """Carrega CSV e constrói índice invertido.
-
-        Args:
-            csv_path: Caminho para o arquivo CSV.
-            search_fields: Lista de nomes de colunas para indexar.
-            k1: Parâmetro de saturação de termo (padrão 1.5).
-            b: Parâmetro de normalização por comprimento (padrão 0.75).
-        """
-        self.k1 = k1
-        self.b = b
-        self.search_fields = search_fields
-        self.docs = []
-        self.doc_lengths = []
-        self.inverted_index = {}  # token → set of doc IDs
-        self.doc_term_freq = []   # doc_id → {token: count}
-        self.avg_dl = 0.0
-
-        self._load_csv(csv_path)
-        self._build_index()
-
-    def _load_csv(self, csv_path):
-        """Carrega documentos do CSV."""
-        path = Path(csv_path)
-        if not path.exists():
-            raise FileNotFoundError(f"Arquivo não encontrado: {csv_path}")
-        with open(path, "r", encoding="utf-8") as f:
-            reader = csv.DictReader(f)
-            for row in reader:
-                self.docs.append(dict(row))
-
-    def _build_index(self):
-        """Constrói índice invertido e calcula estatísticas."""
-        total_length = 0
-        for doc_id, doc in enumerate(self.docs):
-            text = " ".join(doc.get(f, "") or "" for f in self.search_fields)
-            tokens = self.tokenize(text)
-            self.doc_lengths.append(len(tokens))
-            total_length += len(tokens)
-
-            tf = {}
-            for token in tokens:
-                tf[token] = tf.get(token, 0) + 1
-                if token not in self.inverted_index:
-                    self.inverted_index[token] = set()
-                self.inverted_index[token].add(doc_id)
-
-            self.doc_term_freq.append(tf)
-
-        n = len(self.docs)
-        self.avg_dl = total_length / n if n > 0 else 1.0
-
-    def tokenize(self, text):
-        """Tokeniza texto: lowercase, remove acentos, split, filtra stop words.
-
-        Args:
-            text: Texto para tokenizar.
-
-        Returns:
-            Lista de tokens filtrados.
-        """
-        text = _remove_accents(text.lower())
-        tokens = re.split(r"[^a-z0-9]+", text)
-        return [t for t in tokens if len(t) >= 2 and t not in STOP_WORDS]
-
-    def search(self, query, max_results=5):
-        """Busca e retorna resultados ranqueados por BM25.
-
-        Args:
-            query: Texto da consulta.
-            max_results: Número máximo de resultados.
-
-        Returns:
-            Lista de dicts com os documentos e score.
-        """
-        query_tokens = self.tokenize(query)
-        if not query_tokens:
-            return []
-
-        n = len(self.docs)
-        scores = {}
-
-        for token in query_tokens:
-            if token not in self.inverted_index:
-                continue
-            doc_ids = self.inverted_index[token]
-            df = len(doc_ids)
-            idf = math.log((n - df + 0.5) / (df + 0.5) + 1.0)
-
-            for doc_id in doc_ids:
-                tf = self.doc_term_freq[doc_id].get(token, 0)
-                dl = self.doc_lengths[doc_id]
-                numerator = tf * (self.k1 + 1)
-                denominator = tf + self.k1 * (1 - self.b + self.b * dl / self.avg_dl)
-                score = idf * numerator / denominator
-                scores[doc_id] = scores.get(doc_id, 0.0) + score
-
-        ranked = sorted(scores.items(), key=lambda x: x[1], reverse=True)
-        results = []
-        for doc_id, score in ranked[:max_results]:
-            result = dict(self.docs[doc_id])
-            result["_score"] = round(score, 4)
-            results.append(result)
-
-        return results
-
-
-if __name__ == "__main__":
-    print("core.py é um módulo. Importe BM25 de outro script.")

package/skills/hefesto-design/scripts/design_system.py

@@ -1,311 +0,0 @@
-#!/usr/bin/env python3
-"""Gerador de sistema de design coerente para o Hefesto.
-
-Busca em múltiplos domínios e produz uma recomendação unificada de
-estilo, cores, tipografia, espaçamento, animações, regras de UX e
-anti-patterns a evitar.
-"""
-
-import argparse
-import json
-import sys
-from pathlib import Path
-
-_SCRIPT_DIR = Path(__file__).resolve().parent
-sys.path.insert(0, str(_SCRIPT_DIR))
-
-from core import BM25
-
-DATA_DIR = _SCRIPT_DIR.parent / "data"
-
-# Regras de raciocínio: estilo → preferências de sub-domínios
-REASONING = {
-    "brutalist":              {"typography_style": "monospace",       "palette_type": "high-contrast",       "spacing_style": "dense",       "animation_style": "minimal"},
-    "glassmorphism":          {"typography_style": "geometric",      "palette_type": "gradient-translucent", "spacing_style": "generous",    "animation_style": "fade blur"},
-    "minimalist":             {"typography_style": "clean sans",     "palette_type": "monochromatic",       "spacing_style": "generous",    "animation_style": "subtle fade"},
-    "maximalist":             {"typography_style": "display mixed",  "palette_type": "multi-chromatic",     "spacing_style": "dense",       "animation_style": "parallax scroll"},
-    "retro-futuristic":       {"typography_style": "display bold",   "palette_type": "neon-dark",           "spacing_style": "moderate",    "animation_style": "glow scanner"},
-    "organic-natural":        {"typography_style": "rounded",        "palette_type": "earth-tones",         "spacing_style": "relaxed",     "animation_style": "gentle flow"},
-    "editorial-magazine":     {"typography_style": "serif",          "palette_type": "neutral-accent",      "spacing_style": "generous",    "animation_style": "scroll reveal"},
-    "art-deco":               {"typography_style": "serif condensed","palette_type": "gold-dark",           "spacing_style": "symmetric",   "animation_style": "elegant reveal"},
-    "soft-pastel":            {"typography_style": "rounded sans",   "palette_type": "pastel",              "spacing_style": "generous",    "animation_style": "bounce elastic"},
-    "industrial-utilitarian": {"typography_style": "condensed mono", "palette_type": "grey-safety",         "spacing_style": "compact",     "animation_style": "functional"},
-    "luxury-refined":         {"typography_style": "serif",          "palette_type": "dark-gold",           "spacing_style": "generous",    "animation_style": "subtle parallax"},
-    "playful-toy":            {"typography_style": "rounded bold",   "palette_type": "primary-saturated",   "spacing_style": "generous",    "animation_style": "bouncy playful"},
-    "neo-memphis":            {"typography_style": "geometric bold", "palette_type": "vibrant-contrast",    "spacing_style": "moderate",    "animation_style": "rotation scale"},
-    "swiss-international":    {"typography_style": "neutral sans",   "palette_type": "bw-accent",           "spacing_style": "rigid-grid",  "animation_style": "minimal fast"},
-    "dark-mode-premium":      {"typography_style": "sans",           "palette_type": "dark-layered",        "spacing_style": "moderate",    "animation_style": "subtle glow"},
-    "gradient-mesh":          {"typography_style": "clean sans",     "palette_type": "multi-gradient",      "spacing_style": "generous",    "animation_style": "gradient morph"},
-    "monochromatic":          {"typography_style": "clean sans",     "palette_type": "single-hue",          "spacing_style": "generous",    "animation_style": "tonal fade"},
-    "high-contrast":          {"typography_style": "bold sans",      "palette_type": "bw-accent",           "spacing_style": "moderate",    "animation_style": "assertive cut"},
-    "handcrafted-artisanal":  {"typography_style": "handwritten",    "palette_type": "warm-natural",        "spacing_style": "organic",     "animation_style": "sketch reveal"},
-    "cyberpunk-neon":          {"typography_style": "monospace",      "palette_type": "neon-dark",           "spacing_style": "compact",     "animation_style": "glitch flicker"},
-    "scandinavian":           {"typography_style": "humanist sans",  "palette_type": "warm-neutral",        "spacing_style": "airy",        "animation_style": "subtle micro"},
-    "wabi-sabi":              {"typography_style": "delicate serif",  "palette_type": "earth-stone",         "spacing_style": "generous",    "animation_style": "slow breath"},
-    "bauhaus":                {"typography_style": "geometric pure", "palette_type": "primary-bw",          "spacing_style": "modular",     "animation_style": "geometric scale"},
-    "material-you":           {"typography_style": "variable sans",  "palette_type": "dynamic-tonal",       "spacing_style": "moderate",    "animation_style": "container shared"},
-    "neumorphism":            {"typography_style": "clean sans",     "palette_type": "monochromatic-soft",  "spacing_style": "generous",    "animation_style": "shadow shift"},
-    "flat-design":            {"typography_style": "geometric sans", "palette_type": "solid-vibrant",       "spacing_style": "uniform",     "animation_style": "color position"},
-    "skeuomorphic":           {"typography_style": "serif textured", "palette_type": "realistic-textured",  "spacing_style": "metaphor",    "animation_style": "physics depth"},
-    "retro-vintage":          {"typography_style": "retro serif",    "palette_type": "sepia-warm",          "spacing_style": "moderate",    "animation_style": "grain fade"},
-    "vaporwave":              {"typography_style": "chrome display", "palette_type": "pink-purple-cyan",    "spacing_style": "moderate",    "animation_style": "drift vhs"},
-    "corporate-modern":       {"typography_style": "neutral sans",   "palette_type": "blue-neutral",        "spacing_style": "standard",    "animation_style": "minimal hover"},
-    "ai-native":              {"typography_style": "variable sans",  "palette_type": "dark-gradient",       "spacing_style": "moderate",    "animation_style": "streaming reveal"},
-    "dashboard-dense":        {"typography_style": "condensed sans", "palette_type": "neutral-functional",  "spacing_style": "tight",       "animation_style": "data transition"},
-    "bento-grid":             {"typography_style": "bold sans",      "palette_type": "neutral-accent",      "spacing_style": "modular",     "animation_style": "card hover"},
-    "claymorphism":           {"typography_style": "rounded bold",   "palette_type": "pastel-saturated",    "spacing_style": "generous",    "animation_style": "squish bounce"},
-    "y2k-revival":            {"typography_style": "pixel display",  "palette_type": "chrome-candy",        "spacing_style": "moderate",    "animation_style": "sparkle blink"},
-    "acid-graphics":          {"typography_style": "distorted display", "palette_type": "acid-neon",        "spacing_style": "chaotic",     "animation_style": "warp distort"},
-    "kinetic-typography":     {"typography_style": "variable display", "palette_type": "monochromatic",     "spacing_style": "generous",    "animation_style": "text motion"},
-    "data-visualization":     {"typography_style": "tabular sans",   "palette_type": "sequential-diverging","spacing_style": "tight",       "animation_style": "data morph"},
-    "dark-academia":          {"typography_style": "classic serif",  "palette_type": "sepia-dark",          "spacing_style": "generous",    "animation_style": "page turn"},
-    "cottagecore-digital":    {"typography_style": "rounded serif",  "palette_type": "warm-pastel",         "spacing_style": "generous",    "animation_style": "gentle fade"},
-    "afrofuturism":           {"typography_style": "geometric bold", "palette_type": "gold-vibrant",        "spacing_style": "moderate",    "animation_style": "tribal pulse"},
-    "solarpunk":              {"typography_style": "rounded sans",   "palette_type": "green-solar",         "spacing_style": "generous",    "animation_style": "organic grow"},
-    "retro-computing":        {"typography_style": "monospace",      "palette_type": "phosphor-dark",       "spacing_style": "rigid-grid",  "animation_style": "terminal type"},
-    "pixel-art":              {"typography_style": "pixel bitmap",   "palette_type": "limited-palette",     "spacing_style": "grid-8px",    "animation_style": "frame step"},
-    "isometric":              {"typography_style": "geometric sans", "palette_type": "flat-vibrant",        "spacing_style": "modular",     "animation_style": "perspective shift"},
-    "3d-immersive":           {"typography_style": "variable sans",  "palette_type": "atmospheric-dark",    "spacing_style": "generous",    "animation_style": "parallax depth"},
-    "psychedelic":            {"typography_style": "display organic","palette_type": "rainbow-saturated",   "spacing_style": "fluid",       "animation_style": "morph flow"},
-    "magazine-grid":          {"typography_style": "serif mixed",    "palette_type": "neutral-accent",      "spacing_style": "asymmetric",  "animation_style": "scroll reveal"},
-    "text-only":              {"typography_style": "serif or sans",  "palette_type": "monochromatic",       "spacing_style": "generous",    "animation_style": "minimal fade"},
-    "micro-interaction-heavy":{"typography_style": "clean sans",     "palette_type": "neutral-accent",      "spacing_style": "moderate",    "animation_style": "rich micro"},
-    "neobrutalism":           {"typography_style": "bold sans",      "palette_type": "vibrant-contrast",    "spacing_style": "moderate",    "animation_style": "hard cut"},
-    "japanese-minimal":       {"typography_style": "delicate sans",  "palette_type": "warm-neutral",        "spacing_style": "very-generous","animation_style": "zen fade"},
-}
-
-DOMAIN_CONFIGS = {
-    "style":        ("styles.csv",       ["name", "keywords_pt", "keywords_en", "description", "mood", "best_for"]),
-    "color":        ("colors.csv",       ["name", "industry", "mood", "description"]),
-    "typography":   ("typography.csv",   ["name", "mood", "best_for", "display_font", "body_font", "pairing_reason"]),
-    "spacing":      ("spacing.csv",      ["name", "style", "description", "density"]),
-    "animation":    ("animations.csv",   ["name", "context", "description"]),
-    "anti-pattern": ("anti-patterns.csv",["name", "category", "description", "why_bad"]),
-    "ux":           ("ux-rules.csv",     ["name", "category", "rule", "standard", "reasoning"]),
-    "product":      ("products.csv",     ["name", "category", "audience", "recommended_style", "key_components", "layout_pattern", "description"]),
-    "chart":        ("charts.csv",       ["name", "category", "best_for", "data_type", "a11y_notes", "description"]),
-    "landing":      ("landing-pages.csv",["name", "section_type", "purpose", "key_elements", "copywriting_pattern", "description"]),
-    "icon":         ("icons.csv",        ["name", "style", "best_for", "avoid_with", "description"]),
-    "font":         ("google-fonts.csv", ["name", "category", "mood", "best_for", "pair_with", "description"]),
-}
-
-
-def _load_engine(domain):
-    """Carrega BM25 para um domínio, retorna None se CSV não existir."""
-    csv_file, fields = DOMAIN_CONFIGS[domain]
-    csv_path = DATA_DIR / csv_file
-    if not csv_path.exists():
-        return None
-    return BM25(str(csv_path), fields)
-
-
-def _safe_search(engine, query, n=3):
-    """Busca segura, retorna lista vazia se engine for None."""
-    if engine is None:
-        return []
-    return engine.search(query, n)
-
-
-def generate_system(query, project_name=None):
-    """Gera recomendação de design system completa."""
-    engines = {k: _load_engine(k) for k in DOMAIN_CONFIGS}
-
-    # 1. Buscar estilos
-    styles = _safe_search(engines["style"], query, 3)
-
-    if not styles:
-        # Nenhum estilo encontrado — retorna resultado vazio sem crashar
-        return {
-            "project": project_name or "Projeto",
-            "query": query,
-            "style": [],
-            "reasoning": {},
-            "colors": _safe_search(engines["color"], query, 3),
-            "typography": _safe_search(engines["typography"], query, 3),
-            "spacing": _safe_search(engines["spacing"], query, 2),
-            "animations": _safe_search(engines["animation"], query, 3),
-            "products": _safe_search(engines.get("product"), query, 3) if "product" in engines else [],
-            "charts": _safe_search(engines.get("chart"), query, 3) if "chart" in engines else [],
-            "landing": _safe_search(engines.get("landing"), query, 3) if "landing" in engines else [],
-            "icons": _safe_search(engines.get("icon"), query, 3) if "icon" in engines else [],
-            "fonts": _safe_search(engines.get("font"), query, 3) if "font" in engines else [],
-            "anti_patterns": _safe_search(engines["anti-pattern"], query, 3),
-            "ux_rules": _safe_search(engines["ux"], query, 5),
-        }
-
-    top_style_name = styles[0].get("name", "").lower().replace(" ", "-")
-
-    # 2. Enriquecer query com raciocínio do estilo
-    reasoning = REASONING.get(top_style_name, {})
-    color_query = query
-    typo_query = reasoning.get("typography_style", query)
-    spacing_query = reasoning.get("spacing_style", query)
-    anim_query = reasoning.get("animation_style", query)
-
-    # 3. Buscar sub-domínios
-    colors = _safe_search(engines["color"], color_query, 3)
-    typography = _safe_search(engines["typography"], f"{query} {typo_query}", 3)
-    spacing = _safe_search(engines["spacing"], f"{query} {spacing_query}", 2)
-    animations = _safe_search(engines["animation"], f"{query} {anim_query}", 3)
-    products = _safe_search(engines.get("product"), query, 3) if "product" in engines else []
-    charts = _safe_search(engines.get("chart"), query, 3) if "chart" in engines else []
-    landing = _safe_search(engines.get("landing"), query, 3) if "landing" in engines else []
-    icons = _safe_search(engines.get("icon"), query, 3) if "icon" in engines else []
-    fonts = _safe_search(engines.get("font"), f"{query} {typo_query}", 3) if "font" in engines else []
-    anti_patterns = _safe_search(engines["anti-pattern"], query, 3)
-    ux_rules = _safe_search(engines["ux"], query, 5)
-
-    return {
-        "project": project_name or "Projeto",
-        "query": query,
-        "style": styles,
-        "reasoning": reasoning,
-        "colors": colors,
-        "typography": typography,
-        "spacing": spacing,
-        "animations": animations,
-        "products": products,
-        "charts": charts,
-        "landing": landing,
-        "icons": icons,
-        "fonts": fonts,
-        "anti_patterns": anti_patterns,
-        "ux_rules": ux_rules,
-    }
-
-
-def _fmt_items(items, fields, indent="    "):
-    """Formata lista de itens como linhas de texto."""
-    lines = []
-    for i, item in enumerate(items, 1):
-        parts = []
-        for f in fields:
-            val = item.get(f, "")
-            if val:
-                parts.append(f"{f}: {val}")
-        lines.append(f"{indent}{i}. " + " | ".join(parts))
-    return "\n".join(lines) if lines else f"{indent}(nenhum resultado)"
-
-
-# Seções para formatação data-driven: (chave no dict, título texto, título markdown, campos)
-_SECTIONS = [
-    ("colors",       "PALETAS DE CORES",         "Paletas de Cores",       ["name", "mood", "description"]),
-    ("typography",   "TIPOGRAFIA",               "Tipografia",             ["name", "display_font", "body_font", "pairing_reason"]),
-    ("products",     "TIPOS DE PRODUTO",         "Tipos de Produto",       ["name", "category", "recommended_style", "layout_pattern"]),
-    ("spacing",      "ESPAÇAMENTO",              "Espaçamento",            ["name", "style", "density"]),
-    ("animations",   "ANIMAÇÕES",                "Animações",              ["name", "context", "description"]),
-    ("charts",       "GRÁFICOS",                 "Gráficos",               ["name", "category", "best_for"]),
-    ("landing",      "LANDING PAGES",            "Landing Pages",          ["name", "section_type", "purpose"]),
-    ("icons",        "ÍCONES",                   "Ícones",                 ["name", "style", "best_for"]),
-    ("fonts",        "GOOGLE FONTS",             "Google Fonts",           ["name", "category", "mood", "pair_with"]),
-    ("anti_patterns","ANTI-PATTERNS A EVITAR",   "Anti-Patterns a Evitar", ["name", "why_bad"]),
-    ("ux_rules",     "REGRAS DE UX",             "Regras de UX",           ["name", "rule"]),
-]
-
-
-def format_text(system):
-    """Formata como texto legível."""
-    lines = [
-        f"\n{'='*60}",
-        f"  SISTEMA DE DESIGN — {system['project']}",
-        f"  Consulta: \"{system['query']}\"",
-        f"{'='*60}",
-        "",
-        "  ESTILO VISUAL",
-        _fmt_items(system["style"], ["name", "mood", "best_for"]),
-        "",
-    ]
-    if system["reasoning"]:
-        r = system["reasoning"]
-        lines.append("  RACIOCÍNIO DE ESTILO")
-        lines.append(f"    Tipografia recomendada: {r.get('typography_style', '-')}")
-        lines.append(f"    Espaçamento recomendado: {r.get('spacing_style', '-')}")
-        lines.append(f"    Animação recomendada: {r.get('animation_style', '-')}")
-        lines.append("")
-
-    for key, title_text, _, fields in _SECTIONS:
-        items = system.get(key, [])
-        if items:
-            lines.append(f"  {title_text}")
-            lines.append(_fmt_items(items, fields))
-            lines.append("")
-
-    lines.append(f"\n{'='*60}\n")
-    return "\n".join(lines)
-
-
-def format_markdown(system):
-    """Formata como Markdown estruturado."""
-    lines = [
-        f"# Sistema de Design — {system['project']}",
-        f"",
-        f"> Consulta: `{system['query']}`",
-        "",
-        "## Estilo Visual",
-        "",
-    ]
-    for s in system["style"]:
-        lines.append(f"- **{s.get('name', '')}** — {s.get('mood', '')} | {s.get('best_for', '')}")
-    lines.append("")
-
-    if system["reasoning"]:
-        r = system["reasoning"]
-        lines.append("## Raciocínio de Estilo")
-        lines.append("")
-        lines.append(f"| Aspecto | Recomendação |")
-        lines.append(f"|---------|-------------|")
-        lines.append(f"| Tipografia | {r.get('typography_style', '-')} |")
-        lines.append(f"| Espaçamento | {r.get('spacing_style', '-')} |")
-        lines.append(f"| Animação | {r.get('animation_style', '-')} |")
-        lines.append("")
-
-    for key, _, title_md, fields in _SECTIONS:
-        items = system.get(key, [])
-        lines.append(f"## {title_md}")
-        lines.append("")
-        if items:
-            header = " | ".join(fields)
-            sep = " | ".join("---" for _ in fields)
-            lines.append(f"| {header} |")
-            lines.append(f"| {sep} |")
-            for item in items:
-                vals = " | ".join(str(item.get(f, "")) for f in fields)
-                lines.append(f"| {vals} |")
-        else:
-            lines.append("_Nenhum resultado encontrado._")
-        lines.append("")
-
-    return "\n".join(lines)
-
-
-def main():
-    parser = argparse.ArgumentParser(
-        description="Gera sistema de design coerente a partir de uma consulta.",
-        epilog="""Exemplos:
-  python3 design_system.py "fintech modern dark"
-  python3 design_system.py "wellness organic calm" -p MeuProjeto
-  python3 design_system.py "saas dashboard" -f markdown
-""",
-    )
-    parser.add_argument("query", help="Termos descritivos do projeto/estilo desejado")
-    parser.add_argument("-p", "--project", default=None, help="Nome do projeto")
-    parser.add_argument(
-        "-f", "--format",
-        choices=["text", "markdown", "json"],
-        default="text",
-        help="Formato de saída (padrão: text)",
-    )
-
-    args = parser.parse_args()
-    system = generate_system(args.query, args.project)
-
-    if args.format == "json":
-        print(json.dumps(system, indent=2, ensure_ascii=False))
-    elif args.format == "markdown":
-        print(format_markdown(system))
-    else:
-        print(format_text(system))
-
-
-if __name__ == "__main__":
-    main()