@danhachuel/thunderbolt 0.7.37 → 0.7.38

package/app/main.py

@@ -2155,7 +2155,7 @@ def render_thumbnail_blueprints():
                 script = st.selectbox("Blueprint de roteiro associado", blueprint_ids, index=blueprint_ids.index(current_script) if current_script in blueprint_ids else 0, format_func=lambda item: blueprint_labels.get(item, item or "Sem Blueprint padrão"), key=f"thumbnail_script_blueprint_channel_{channel_id}")
             with cols[2]:
                 if st.button("Guardar par", key=f"thumbnail_blueprint_save_{channel_id}", width="stretch"):
-                    if thumb == "Generic_Thumbnail_Blueprint" and script:
+                    if thumb in {"Youtube_Generic_Thumbnail_Blueprint", "Tiktok_Generic_Thumbnail_Blueprint"} and script:
                         st.error("Not Allowed to Associate, System Use Only")
                     else:
                         update_channel(channel_id, {"thumbnail_blueprint_id": thumb, "default_thumbnail_blueprint_id": thumb, "blueprint_id": script, "default_blueprint_id": script})
@@ -6508,7 +6508,7 @@ def render_automation():
                         st.link_button("Abrir canal", channel_url, type="primary", width="content")
                 with header_cols[2]:
                     st.markdown("**Thumbnail Blueprint**")
-                    st.caption(str(paired_thumbnail.get("name") or "Generic_Thumbnail_Blueprint"))
+                    st.caption(str(paired_thumbnail.get("name") or "Youtube_Generic_Thumbnail_Blueprint"))
                 with header_cols[3]:
                     st.markdown("**Idioma do roteiro**")
                     st.caption(video_language_label(normalize_video_language(channel.get("language") or "pt")))
@@ -6561,7 +6561,7 @@ def render_automation():
                                 "format": automation_format,
                             })
                             set_channel_defaults(channel_id, automation_blueprint, automation_voice)
-                            paired_id = str(paired_thumbnail.get("id") or "Generic_Thumbnail_Blueprint")
+                            paired_id = str(paired_thumbnail.get("id") or "Youtube_Generic_Thumbnail_Blueprint")
                             update_channel(channel_id, {"thumbnail_blueprint_id": paired_id, "default_thumbnail_blueprint_id": paired_id})
                             st.success("Agendamento guardado.")
                             st.rerun()

package/hermes_ui/domain.py

@@ -7,7 +7,7 @@ from typing import Any
 
 from .notifications import record_notification
 from .storage import StorageIntegrityError, append_json, now, read_json, update_json, write_json
-from .thumbnail_blueprints import GENERIC_THUMBNAIL_BLUEPRINT_ID
+from .thumbnail_blueprints import thumbnail_blueprint_for_channel
 
 STAGES = ["niche", "blueprint", "brand", "topic", "script", "title", "keywords", "video", "thumbnail_prompt", "thumbnail", "upload"]
 # Ordem executada pelo worker. Cada etapa só é executada quando o seu artefacto
@@ -242,7 +242,7 @@ def create_tasks_for_batch(batch: dict[str, Any]) -> list[dict[str, Any]]:
                 "generation_settings": generation_settings,
                 "blueprint_id": payload.get("blueprint_id") or channel.get("default_blueprint_id") or channel.get("blueprint_id", ""),
                 "blueprint_name": payload.get("blueprint_name", ""),
-                "thumbnail_blueprint_id": payload.get("thumbnail_blueprint_id") or channel.get("default_thumbnail_blueprint_id") or channel.get("thumbnail_blueprint_id") or GENERIC_THUMBNAIL_BLUEPRINT_ID,
+                "thumbnail_blueprint_id": payload.get("thumbnail_blueprint_id") or channel.get("default_thumbnail_blueprint_id") or channel.get("thumbnail_blueprint_id") or thumbnail_blueprint_for_channel({**channel, "thumbnail_blueprint_id": ""}, payload.get("format", options.get("format", ""))).get("id", ""),
                 "voice": payload.get("voice") or channel.get("default_voice") or channel.get("voice", ""),
                 "automation_on": bool(channel.get("automation_on", False)),
                 "automation_time": channel.get("automation_time", "00:00"),
@@ -525,7 +525,7 @@ def _refresh_task_channel_video_settings(task: dict[str, Any]) -> None:
         channel.get("default_thumbnail_blueprint_id")
         or channel.get("thumbnail_blueprint_id")
         or task.get("thumbnail_blueprint_id")
-        or GENERIC_THUMBNAIL_BLUEPRINT_ID
+        or thumbnail_blueprint_for_channel({**channel, "thumbnail_blueprint_id": ""}, task.get("format", "")).get("id", "")
     )
     task["blueprint_id"] = channel.get("default_blueprint_id") or channel.get("blueprint_id") or task.get("blueprint_id", "")
     if channel.get("style_wide"):

package/hermes_ui/pipeline_worker.py

@@ -1353,7 +1353,8 @@ def _run_task(task: dict[str, Any]) -> dict[str, Any]:
     blueprint = _blueprint_for_channel(channel)
     if not blueprint and (task.get("blueprint_id") or task.get("blueprint_name")):
         blueprint = {"id": str(task.get("blueprint_id") or ""), "name": str(task.get("blueprint_name") or task.get("blueprint_id") or "")}
-    visual_blueprint = thumbnail_blueprint_for_channel(channel)
+    visual_format = task.get("format") or ("portrait" if str(task.get("platform") or "").casefold() in {"tiktok", "instagram"} else "wide")
+    visual_blueprint = thumbnail_blueprint_for_channel(channel, visual_format)
     if visual_blueprint.get("content"):
         blueprint = {**blueprint, "thumbnail_blueprint_rules": visual_blueprint["content"]}
     route = _normalise_video_route(task, settings)

package/hermes_ui/thumbnail_blueprints.py

@@ -7,9 +7,12 @@ from pathlib import Path
 from typing import Any, Mapping
 
 from .provider_routing import route_llm_json
-from .storage import BLUEPRINTS, atomic_write, list_blueprint_files, load_blueprint_file
+from .storage import BLUEPRINTS, SEED_THUMBNAIL_BLUEPRINTS, atomic_write, list_blueprint_files, load_blueprint_file
 
-GENERIC_THUMBNAIL_BLUEPRINT_ID = "Generic_Thumbnail_Blueprint"
+HORIZONTAL_GENERIC_THUMBNAIL_BLUEPRINT_ID = "Youtube_Generic_Thumbnail_Blueprint"
+VERTICAL_GENERIC_THUMBNAIL_BLUEPRINT_ID = "Tiktok_Generic_Thumbnail_Blueprint"
+# Backwards-compatible name for callers that only need the landscape default.
+GENERIC_THUMBNAIL_BLUEPRINT_ID = HORIZONTAL_GENERIC_THUMBNAIL_BLUEPRINT_ID
 GENERIC_ASSOCIATION_ERROR = "Not Allowed to Associate, System Use Only"
 
 PROMPT_MASTER = '''You are a forensic YouTube thumbnail analyst. Build a reusable Thumbnail Blueprint from the reference channel videos below.
@@ -38,26 +41,41 @@ def resolve_thumbnail_blueprint(identifier: Any) -> dict[str, Any]:
     wanted = str(identifier or "").strip()
     if not wanted:
         return {}
-    folder = BLUEPRINTS / "thumbnails"
-    for path in folder.glob("*.md"):
-        if path.stem == wanted or path.name == wanted:
-            return {"id": path.stem, "name": path.stem, "path": str(path), "content": path.read_text(encoding="utf-8")}
+    if wanted == "Generic_Thumbnail_Blueprint":
+        wanted = HORIZONTAL_GENERIC_THUMBNAIL_BLUEPRINT_ID
+    folders = (BLUEPRINTS / "thumbnails", SEED_THUMBNAIL_BLUEPRINTS)
+    for folder in folders:
+        for path in folder.glob("*.md"):
+            if path.stem == wanted or path.name == wanted:
+                return {"id": path.stem, "name": path.stem, "path": str(path), "content": path.read_text(encoding="utf-8")}
     return {"id": wanted, "name": wanted}
 
 
-def thumbnail_blueprint_for_channel(channel: Mapping[str, Any]) -> dict[str, Any]:
+def _generic_thumbnail_blueprint_id(format_value: Any = "", platform: Any = "") -> str:
+    raw = str(format_value or "").strip().casefold()
+    if raw in {"portrait", "vertical", "shorts", "9:16", "tiktok", "reels"}:
+        return VERTICAL_GENERIC_THUMBNAIL_BLUEPRINT_ID
+    platform_raw = str(platform or "").strip().casefold()
+    if platform_raw in {"tiktok", "instagram", "instagram reels", "shorts"} and not raw:
+        return VERTICAL_GENERIC_THUMBNAIL_BLUEPRINT_ID
+    return HORIZONTAL_GENERIC_THUMBNAIL_BLUEPRINT_ID
+
+
+def thumbnail_blueprint_for_channel(channel: Mapping[str, Any], format_value: Any = "") -> dict[str, Any]:
     direct = channel.get("default_thumbnail_blueprint_id") or channel.get("thumbnail_blueprint_id")
     if direct:
         return resolve_thumbnail_blueprint(direct)
     script_id = str(channel.get("default_blueprint_id") or channel.get("blueprint_id") or "").strip()
     pairs = _pair_state()
-    return resolve_thumbnail_blueprint(pairs.get(script_id, "") or GENERIC_THUMBNAIL_BLUEPRINT_ID)
+    return resolve_thumbnail_blueprint(
+        pairs.get(script_id, "") or _generic_thumbnail_blueprint_id(format_value, channel.get("platform"))
+    )
 
 
 def thumbnail_blueprint_for_blueprint(blueprint_id: Any) -> dict[str, Any]:
     """Resolve the visual pair for a script Blueprint, falling back to Generic."""
     paired_id = _pair_state().get(str(blueprint_id or "").strip(), "")
-    return resolve_thumbnail_blueprint(paired_id or GENERIC_THUMBNAIL_BLUEPRINT_ID)
+    return resolve_thumbnail_blueprint(paired_id or HORIZONTAL_GENERIC_THUMBNAIL_BLUEPRINT_ID)
 
 
 def _pair_state() -> dict[str, str]:
@@ -70,7 +88,7 @@ def _pair_state() -> dict[str, str]:
 
 
 def save_thumbnail_blueprint_pair(thumbnail_id: str, blueprint_id: str) -> None:
-    if str(thumbnail_id) == GENERIC_THUMBNAIL_BLUEPRINT_ID and str(blueprint_id):
+    if str(thumbnail_id) in {HORIZONTAL_GENERIC_THUMBNAIL_BLUEPRINT_ID, VERTICAL_GENERIC_THUMBNAIL_BLUEPRINT_ID} and str(blueprint_id):
         raise ValueError(GENERIC_ASSOCIATION_ERROR)
     pairs = _pair_state()
     if blueprint_id:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/thunderbolt",
-  "version": "0.7.37",
+  "version": "0.7.38",
   "description": "Thunderbolt — interface local para operação de canais faceless e motor MoneyPrinterTurbo",
   "license": "MIT",
   "main": "scripts/cli.mjs",

package/seed/blueprints/thumbnails/Tiktok_Generic_Thumbnail_Blueprint.md

@@ -0,0 +1,181 @@
+🔒 TRAVA DE ESTILO — NÃO NEGOCIÁVEL
+[Um parágrafo descrevendo o estilo visual geral do canal: ex.: "Estilo limpo, minimalista, com iluminação high‑key, cores sólidas e composição centrada no rosto/produto, otimizado para consumo em tela vertical de celular."]
+
+❌ Não permitido (elementos que o canal nunca usa, com base nas capas observadas):
+
+[ex.: Sem texto no rodapé da tela, sem rostos cortados, sem cores saturadas, etc.]
+
+[Liste todas as proibições observadas]
+
+📱 ZONAS SEGURAS (VERTICAL 9:16) — OBRIGATÓRIO
+A capa é feita para 1080 × 1920 px. A UI do TikTok/Reels cobre partes da imagem — nada essencial pode ficar ali.
+
+text
+0 px ─────────────────────────────
+      ┌────────────────────┐
+      │  ZONA MORTA TOPO   │  ~150 px (barra de progresso / "Seguindo")
+      ├───────────────┬────┤
+      │               │ UI │
+      │  ÁREA SEGURA  │ DI │  ~220 px (curtir, comentar,
+      │  texto +      │ RE │   compartilhar, som, avatar)
+      │  rosto/produto│    │
+      │               │    │
+      ├───────────────┴────┤
+      │  ZONA MORTA BASE   │  ~480 px (legenda, @usuário,
+      │                    │   música, CTA, barra de navegação)
+      └────────────────────┘
+1920 px ────────────────────────────
+Regras rígidas de zona segura:
+
+Margem superior: 150 px livres
+
+Margem inferior: 480 px livres
+
+Margem direita: 220 px livres
+
+Margem esquerda: 80 px livres
+
+Área útil real: aproximadamente 780 × 1290 px (canto superior esquerdo em 80,150)
+
+Recorte do grid do perfil (3:4):
+
+O TikTok e o Instagram cortam a capa em 3:4 no grid do perfil.
+
+O núcleo da mensagem (rosto + 2–4 palavras) deve caber dentro do recorte central 1080 × 1440 px (y entre 240 e 1680).
+
+Teste sempre: "se essa capa for cortada em 3:4, ainda entendo a mensagem?"
+
+🧍‍♂️ ENQUADRAMENTO E POSE
+Sujeito principal: [descreva o elemento visual principal – pessoa, produto, cena, etc.]
+
+Regras de enquadramento:
+
+[ex.: Sujeito centralizado horizontalmente, ocupando o terço médio do quadro]
+
+[ex.: Rosto/produto nunca abaixo de y = 1400 px]
+
+[Adicione regras]
+
+Ângulo de câmera: [baixo, alto, nível dos olhos, etc.]
+
+Corte (cropping): [quanto do sujeito preenche o quadro — em vertical, o sujeito costuma ocupar 50–70% da altura útil]
+
+Energia / ação: [estático, dinâmico, expressivo, ação congelada, etc.]
+
+Expressão / leitura à distância: [a emoção precisa ser legível a 2 metros de distância do celular]
+
+🎨 FUNDO E ILUMINAÇÃO
+Ambiente de fundo: [estúdio, externo, escuro, cor sólida, etc.]
+
+Iluminação: [high‑key, low‑key, natural, dramática, etc.]
+
+Efeitos: [bokeh, flare, fumaça, glow, etc.]
+
+Profundidade: [profundidade de campo rasa, foco profundo, etc.]
+
+Ruído visual: [nível de detalhe, poluído vs. limpo — em vertical, prefira fundos simples para não competir com o texto]
+
+🧭 IDENTIFICADORES / SÍMBOLOS DO CANAL
+[Descreva símbolos recorrentes que comunicam contexto instantaneamente — bandeiras, logos, ícones específicos, rostos recorrentes, cores-assinatura. Se não houver, escreva explicitamente: "O canal não utiliza identificadores simbólicos recorrentes."]
+
+🚨 ELEMENTO DE ATENÇÃO VISUAL
+[Descreva se o canal usa setas, círculos, zooms, emojis, contornos — especifique cor, forma, posição e regras de uso. Em vertical, o elemento deve ficar acima da zona morta inferior. Se o canal NÃO usa, escreva explicitamente: "O canal não utiliza elementos de atenção visual."]
+
+📝 ESTILO DE TEXTO
+Estrutura:
+
+[Número de linhas / faixas de texto e posicionamento — ex.: bloco de 2 linhas no terço superior, alinhado à esquerda]
+
+[Hierarquia — ex.: headline grande + sub‑headline menor]
+
+Tipografia:
+
+[Família, peso, caixa — ex.: sans‑serif bold, CAIXA ALTA, contorno grosso]
+
+Hierarquia de cor:
+
+[Cor de fundo do bloco, cor do texto de cada camada, contorno/sombra]
+
+Tamanho mínimo legível:
+
+Fonte nunca menor que 90 px de altura de caixa (em 1080 px de largura)
+
+Contraste alto obrigatório (texto claro sobre fundo escuro ou vice‑versa)
+
+Cobertura de texto: [% aproximado da capa ocupada por texto — ex.: faixa superior ocupando 25%]
+
+Regra do mudo: a capa precisa funcionar com o som desligado.
+
+🧠 PSICOLOGIA DO TEXTO
+[Descreva os gatilhos emocionais usados nas headlines — urgência, curiosidade, choque, números, perguntas, etc.]
+
+Exemplos de palavras/frases observadas:
+
+[ex.: "Você não vai acreditar", "Destruiu", "Novo", "Por quê", "Ninguém fala disso"]
+
+Restrição de comprimento: 2–4 palavras. Máximo 5. Texto longo morre em tela vertical.
+
+🎯 REGRAS DE COMPOSIÇÃO
+Aplicação da regra dos terços: [onde os elementos-chave são posicionados no quadro vertical]
+
+Hierarquia focal: [ordem de importância visual — sujeito, texto, elemento de atenção, fundo]
+
+Espaço negativo: [como as áreas vazias são usadas — em vertical, o espaço negativo é o que evita que o texto seja engolido pela UI]
+
+Controle de distração: [o que é evitado para manter o foco — ex.: nada de detalhes no canto inferior direito]
+
+Mobile‑first: [garantir leitura em tela de 5–6 polegadas, com brilho ambiente alto]
+
+📐 FORMATO E QUALIDADE
+Proporção:
+9:16 (vertical)
+
+Resolução:
+1080 × 1920 px (mínimo) — 1440 × 2560 px (ideal / futuro‑proof)
+
+Compatibilidade:
+TikTok · Instagram Reels · YouTube Shorts · Kwai — mesma capa, sem reenquadramento
+
+Estilo de imagem:
+[Fotorrealista / ilustrado / misto — descreva o nível de realismo]
+
+Nitidez:
+[Clareza esperada — ex.: detalhes nítidos no sujeito, fundo levemente suave]
+
+Restrições:
+
+[Liste restrições técnicas observadas — sem marca d'água, sem blur, sem iluminação chapada, sem texto cortado pela UI, etc.]
+
+[Nenhum elemento essencial fora da ÁREA SEGURA definida acima]
+
+🧠 OBJETIVO FINAL
+Objetivo primário:
+Maximizar CTR / taxa de retenção nos 3 primeiros segundos para [nicho do canal — ex.: reviews de tecnologia, finanças pessoais, true crime, etc.] em formato vertical.
+
+Gatilhos emocionais:
+[Emoções-alvo — ex.: curiosidade, medo, surpresa, excitação, indignação]
+
+Público:
+[Descreva o espectador-alvo — ex.: entusiastas de tech, investidores, público 18–34]
+
+A capa deve comunicar instantaneamente:
+[Mensagem central — ex.: "Uma revelação chocante", "Um produto imperdível", "Você está fazendo isso errado"]
+
+Teste de aprovação (checklist):
+
+□ Mensagem compreendida em menos de 1 segundo
+□ Nada importante abaixo de y = 1440 px
+□ Nada importante à direita de x = 860 px
+□ Funciona no recorte 3:4 do grid do perfil
+□ Funciona com o som desligado
+□ Legível em tela de celular a 2 metros de distância
+🧾 FORMATO DE ENTRADA FINAL
+TÍTULO DO VÍDEO / TEMA:
+"[Insira o título real do vídeo ou o tópico do roteiro aqui]"
+
+⚙️ INSTRUÇÃO FINAL DE SISTEMA
+Usando o estilo travado definido acima, gere uma capa vertical para TikTok/Instagram Reels que siga rigorosamente todas as regras composicionais, textuais e visuais.
+
+Extraia automaticamente 2–4 palavras do TÍTULO DO VÍDEO fornecido para servir como headline e posicione-a de acordo com as regras de ESTILO DE TEXTO e de ZONAS SEGURAS (nada abaixo de y = 1440 px, nada à direita de x = 860 px).
+
+A saída deve ser uma capa pronta para upload em 9:16, mínimo 1080 × 1920 px, replicando a identidade visual exata do canal — válida simultaneamente para TikTok, Reels e Shorts, e legível também no recorte 3:4 do grid do perfil. [Especifique se o logo deve ser incluído ou não — ex.: "SEM LOGO" ou "INCLUIR LOGO DO CANAL no canto superior esquerdo, dentro da área segura".]