@danhachuel/thunderbolt 0.3.25 → 0.3.27

package/app/main.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import hashlib
+import html
 import json
 import re
 from contextlib import nullcontext
@@ -201,6 +202,30 @@ st.markdown("""
 [data-testid="stSidebar"] [data-testid="stExpander"] summary p { margin:0; line-height:1; }
 [data-testid="stSidebar"] [data-testid="stExpander"] > div { padding:0 0 0 0.42rem !important; }
 [data-testid="stSidebar"] [data-testid="stExpander"] > div [data-testid="stButton"] button { padding-left:0.92rem; font-size:0.83rem; min-height:1.62rem; height:1.62rem; }
+.tb-channel-kanban-card { box-sizing:border-box; min-height:330px; height:330px; padding:0.85rem 0.9rem; border:1px solid color-mix(in srgb, var(--tb-accent) 42%, currentColor 18%); border-radius:14px; background:color-mix(in srgb, currentColor 5%, transparent); color:inherit; box-shadow:0 10px 24px color-mix(in srgb, currentColor 12%, transparent); overflow:hidden; }
+.tb-channel-kanban-card__header { display:flex; align-items:center; gap:0.58rem; min-width:0; }
+.tb-channel-kanban-card__avatar { width:46px; height:46px; flex:0 0 46px; border-radius:10px; object-fit:cover; background:color-mix(in srgb, var(--tb-accent) 14%, transparent); }
+.tb-channel-kanban-card__avatar--fallback { display:flex; align-items:center; justify-content:center; font-weight:800; color:var(--tb-accent); }
+.tb-channel-kanban-card__identity { min-width:0; flex:1 1 auto; }
+.tb-channel-kanban-card__name { font-size:1rem; font-weight:750; line-height:1.18; white-space:nowrap; overflow:hidden; text-overflow:ellipsis; }
+.tb-channel-kanban-card__niche { margin-top:0.22rem; font-size:0.76rem; opacity:.66; white-space:nowrap; overflow:hidden; text-overflow:ellipsis; }
+.tb-channel-kanban-card__badges { display:flex; gap:0.28rem; flex:0 0 auto; align-items:center; }
+.tb-channel-kanban-card__badge { padding:0.18rem 0.42rem; border-radius:6px; font-size:0.67rem; font-weight:750; line-height:1.1; white-space:nowrap; }
+.tb-channel-kanban-card__badge--youtube { background:#dc2626; color:#fff; }
+.tb-channel-kanban-card__badge--active { background:color-mix(in srgb, #22c55e 25%, transparent); color:#16a34a; border:1px solid color-mix(in srgb, #22c55e 50%, transparent); }
+.tb-channel-kanban-card__badge--inactive { background:color-mix(in srgb, #ef4444 18%, transparent); color:#dc2626; border:1px solid color-mix(in srgb, #ef4444 45%, transparent); }
+.tb-channel-kanban-card__rule { height:1px; margin:0.72rem 0 0.62rem; background:color-mix(in srgb, currentColor 13%, transparent); }
+.tb-channel-kanban-card__metrics { display:grid; grid-template-columns:repeat(3, minmax(0, 1fr)); gap:0.34rem; }
+.tb-channel-kanban-card__metric { min-width:0; min-height:67px; padding:0.48rem 0.28rem 0.36rem; border-radius:8px; text-align:center; background:color-mix(in srgb, currentColor 4%, transparent); }
+.tb-channel-kanban-card__metric-value { font-size:1.12rem; font-weight:800; line-height:1.15; white-space:nowrap; overflow:hidden; text-overflow:ellipsis; }
+.tb-channel-kanban-card__metric-label { margin-top:0.3rem; font-size:0.66rem; opacity:.64; white-space:nowrap; overflow:hidden; text-overflow:ellipsis; }
+.tb-channel-kanban-card__status-row { display:grid; grid-template-columns:repeat(2, minmax(0, 1fr)); gap:0.34rem; margin-top:0.6rem; }
+.tb-channel-kanban-card__status { min-width:0; padding:0.42rem 0.28rem; border-radius:8px; text-align:center; font-size:0.71rem; white-space:nowrap; overflow:hidden; text-overflow:ellipsis; }
+.tb-channel-kanban-card__status strong { font-size:0.92rem; margin-right:0.18rem; }
+.tb-channel-kanban-card__status--doing { color:#d97706; background:color-mix(in srgb, #f59e0b 14%, transparent); border:1px solid color-mix(in srgb, #f59e0b 35%, transparent); }
+.tb-channel-kanban-card__status--done { color:#16a34a; background:color-mix(in srgb, #22c55e 11%, transparent); border:1px solid color-mix(in srgb, #22c55e 30%, transparent); }
+.tb-channel-kanban-card__titles { margin-top:0.58rem; font-size:0.73rem; opacity:.7; white-space:nowrap; overflow:hidden; text-overflow:ellipsis; }
+@media (max-width: 900px) { .tb-channel-kanban-card { min-height:310px; height:310px; } .tb-channel-kanban-card__name { font-size:.9rem; } }
 .content-card { box-sizing:border-box; padding:1rem 1.1rem; border:1px solid rgba(128,128,128,.28); border-radius:14px; background:rgba(128,128,128,.10); color:inherit; min-height:110px; box-shadow:0 4px 14px rgba(0,0,0,.12); }
 .content-card { border:1px solid color-mix(in srgb, currentColor 18%, transparent); background:color-mix(in srgb, currentColor 5%, transparent); box-shadow:0 4px 14px color-mix(in srgb, currentColor 12%, transparent); }
 .content-label { color:inherit; opacity:.72; font-size:.8rem; text-transform:uppercase; letter-spacing:.07em; }
@@ -939,7 +964,7 @@ def render_channel_videos(channel: dict) -> None:
     channel_id = str(channel.get("id") or "")
     st.markdown("### Últimos 10 vídeos publicados")
     st.caption("A lista usa o feed público do YouTube, sem Data API Key. Pode actualizar manualmente e editar os metadados locais apresentados.")
-    refresh_col, view_col = st.columns([1.4, 1])
+    refresh_col = st.columns(1)[0]
     with refresh_col:
         if st.button("Actualizar últimos 10 vídeos", key=f"refresh_channel_videos_{channel_id}", use_container_width=True):
             result = fetch_channel_videos_public(channel, limit=10)
@@ -950,42 +975,25 @@ def render_channel_videos(channel: dict) -> None:
                 st.rerun()
             else:
                 st.warning(result.message)
-    with view_col:
-        view_mode = st.radio("Vista", ["Lista", "Kanban"], horizontal=True, key=f"channel_videos_view_{channel_id}", label_visibility="collapsed")
     videos = st.session_state.get(f"channel_videos_{channel_id}") or channel_videos_for(channel, limit=10)
     if not videos:
         st.info("Ainda não existem vídeos sincronizados. Clique em **Actualizar últimos 10 vídeos**.")
         return
-    if view_mode == "Lista":
-        for video in videos[:10]:
-            with st.container(border=True):
-                cols = st.columns([0.7, 3.4, 1.4, 1.1])
-                with cols[0]:
-                    if video.get("thumbnail_url"):
-                        st.image(video["thumbnail_url"], width=64)
-                    else:
-                        st.markdown("### YT")
-                with cols[1]:
-                    st.write(f"**{video.get('title', 'Vídeo sem título')}**")
-                    st.caption(f"{video.get('published_at') or 'Sem data'} · {video.get('url') or 'Sem URL'}")
-                with cols[2]:
-                    st.caption(str(video.get("status") or "publicado").title())
-                with cols[3]:
-                    render_channel_video_editor(video, channel_id)
-    else:
-        columns = st.columns(4)
-        groups = [("planejamento", "Planejamento"), ("produção", "Produção"), ("finalizado", "Finalizado"), ("publicado", "Agendado/Publicado")]
-        for column, (status_key, label) in zip(columns, groups):
-            with column:
-                st.markdown(f"**{label}**")
-                group = [video for video in videos[:10] if str(video.get("status") or "publicado").lower() in ({status_key} if status_key != "publicado" else {"publicado", "agendado"})]
-                if not group:
-                    st.caption("Sem vídeos")
-                for video in group:
-                    with st.container(border=True):
-                        st.write(f"**{video.get('title', 'Vídeo sem título')}**")
-                        st.caption(video.get("published_at") or "Sem data")
-                        render_channel_video_editor(video, channel_id)
+    for video in videos[:10]:
+        with st.container(border=True):
+            cols = st.columns([0.7, 3.4, 1.4, 1.1])
+            with cols[0]:
+                if video.get("thumbnail_url"):
+                    st.image(video["thumbnail_url"], width=64)
+                else:
+                    st.markdown("### YT")
+            with cols[1]:
+                st.write(f"**{video.get('title', 'Vídeo sem título')}**")
+                st.caption(f"{video.get('published_at') or 'Sem data'} · {video.get('url') or 'Sem URL'}")
+            with cols[2]:
+                st.caption(str(video.get("status") or "publicado").title())
+            with cols[3]:
+                render_channel_video_editor(video, channel_id)
 
 
 def render_channel_edit_form(channel: dict, youtube_account_ids: list[str], youtube_account_labels: dict[str, str], youtube_accounts_by_id: dict[str, dict[str, Any]]) -> None:
@@ -1424,6 +1432,101 @@ def render_tiktok_prompt_masters():
                     st.error(str(exc))
 
 
+def _format_channel_metric(value: Any) -> str:
+    """Format a channel metric compactly for the Kanban card."""
+    if value is None or value == "":
+        return "—"
+    try:
+        number = int(value)
+    except (TypeError, ValueError):
+        return html.escape(str(value))
+    if abs(number) >= 1_000_000:
+        return f"{number / 1_000_000:.1f}M".replace(".0M", "M")
+    if abs(number) >= 1_000:
+        return f"{number / 1_000:.1f}K".replace(".0K", "K")
+    return f"{number:,}".replace(",", ".")
+
+
+def _channel_pipeline_counts(channel: dict[str, Any]) -> tuple[int, int, int]:
+    """Return in-production, completed and titled task counts for one channel."""
+    channel_id = str(channel.get("id") or "")
+    tasks = read_json("tasks.json", [])
+    if not channel_id or not isinstance(tasks, list):
+        return 0, 0, 0
+    related = [
+        task for task in tasks
+        if isinstance(task, dict) and str(task.get("channel_id") or "") == channel_id
+    ]
+    in_production = sum(1 for task in related if str(task.get("state") or "").lower() == "doing")
+    completed = sum(1 for task in related if str(task.get("state") or "").lower() == "done")
+    titled = sum(1 for task in related if str(task.get("title") or "").strip() or task.get("title_candidates"))
+    return in_production, completed, titled
+
+
+def _render_channel_kanban_card(channel: dict[str, Any]) -> None:
+    """Render one compact, square-style channel card for the global Kanban view."""
+    ui_language = current_ui_language()
+    name = html.escape(str(channel.get("name") or "Sem nome"))
+    niche = html.escape(channel_niche_label(channel))
+    thumbnail_url = str(channel.get("thumbnail_url") or "").strip()
+    if thumbnail_url:
+        avatar = f'<img class="tb-channel-kanban-card__avatar" src="{html.escape(thumbnail_url, quote=True)}" alt="">'
+    else:
+        avatar = '<div class="tb-channel-kanban-card__avatar tb-channel-kanban-card__avatar--fallback">YT</div>'
+    active = bool(channel.get("active", True))
+    active_label = ui_text("Activo" if active else "Inactivo", ui_language)
+    active_class = "active" if active else "inactive"
+    subscribers = _format_channel_metric(channel.get("subscriber_count"))
+    views = _format_channel_metric(channel.get("view_count"))
+    videos = _format_channel_metric(channel.get("video_count"))
+    in_production, completed, titled = _channel_pipeline_counts(channel)
+    youtube_label = ui_text("YouTube", ui_language)
+    subscribers_label = ui_text("Inscritos", ui_language)
+    views_label = ui_text("Visualizações", ui_language)
+    videos_label = ui_text("Vídeos", ui_language)
+    production_label = ui_text("Em produção", ui_language)
+    completed_label = ui_text("Finalizados", ui_language)
+    titles_label = ui_text("Títulos", ui_language)
+    st.markdown(
+        f"""
+        <div class="tb-channel-kanban-card">
+          <div class="tb-channel-kanban-card__header">
+            {avatar}
+            <div class="tb-channel-kanban-card__identity">
+              <div class="tb-channel-kanban-card__name">{name}</div>
+              <div class="tb-channel-kanban-card__niche">{niche}</div>
+            </div>
+            <div class="tb-channel-kanban-card__badges">
+              <span class="tb-channel-kanban-card__badge tb-channel-kanban-card__badge--youtube">{youtube_label}</span>
+              <span class="tb-channel-kanban-card__badge tb-channel-kanban-card__badge--{active_class}">{active_label}</span>
+            </div>
+          </div>
+          <div class="tb-channel-kanban-card__rule"></div>
+          <div class="tb-channel-kanban-card__metrics">
+            <div class="tb-channel-kanban-card__metric"><div class="tb-channel-kanban-card__metric-value">{subscribers}</div><div class="tb-channel-kanban-card__metric-label">{subscribers_label}</div></div>
+            <div class="tb-channel-kanban-card__metric"><div class="tb-channel-kanban-card__metric-value">{views}</div><div class="tb-channel-kanban-card__metric-label">{views_label}</div></div>
+            <div class="tb-channel-kanban-card__metric"><div class="tb-channel-kanban-card__metric-value">{videos}</div><div class="tb-channel-kanban-card__metric-label">{videos_label}</div></div>
+          </div>
+          <div class="tb-channel-kanban-card__status-row">
+            <div class="tb-channel-kanban-card__status tb-channel-kanban-card__status--doing"><strong>{in_production}</strong>{production_label}</div>
+            <div class="tb-channel-kanban-card__status tb-channel-kanban-card__status--done"><strong>{completed}</strong>{completed_label}</div>
+          </div>
+          <div class="tb-channel-kanban-card__titles">▣ <strong>{titled}</strong> {titles_label}</div>
+        </div>
+        """,
+        unsafe_allow_html=True,
+    )
+
+
+def render_registered_channels_kanban(channels: list[dict[str, Any]]) -> None:
+    """Render all registered channels in a responsive three-column Kanban grid."""
+    for row_start in range(0, len(channels), 3):
+        channel_columns = st.columns(3)
+        for column, channel in zip(channel_columns, channels[row_start:row_start + 3]):
+            with column:
+                _render_channel_kanban_card(channel)
+
+
 def render_channels():
     st.title("Canais Youtube")
     st.caption("Escolha entre importar dados públicos do YouTube ou preencher o canal manualmente.")
@@ -1439,7 +1542,11 @@ def render_channels():
     with import_tab:
         st.caption("A pesquisa pública funciona sem API Key. A Data API é opcional e fica disponível numa opção separada para métricas oficiais.")
         source = st.text_input("URL, handle ou ID do canal", placeholder="https://youtube.com/@seucanal", key="youtube_channel_source")
-        lookup_mode = st.radio("Método de consulta", ["Página pública — sem API Key", "YouTube Data API — API Key opcional"], horizontal=True, key="youtube_channel_lookup_mode")
+        lookup_cols = st.columns(2)
+        with lookup_cols[0]:
+            lookup_mode = st.radio("Método de consulta", ["Página pública — sem API Key", "YouTube Data API — API Key opcional"], horizontal=True, key="youtube_channel_lookup_mode")
+        with lookup_cols[1]:
+            st.radio("Apresentação dos canais", ["Lista", "Kanban"], horizontal=True, key="youtube_channels_view_mode")
         col1, col2 = st.columns([1, 1])
         with col1:
             if st.button("Buscar no YouTube", type="primary", use_container_width=True, key="youtube_channel_lookup"):
@@ -1675,6 +1782,9 @@ def render_channels():
     if not channels:
         st.info("Nenhum canal cadastrado.")
         return
+    if st.session_state.get("youtube_channels_view_mode", "Lista") == "Kanban":
+        render_registered_channels_kanban(channels)
+        return
     for channel in channels:
         channel_id = str(channel["id"])
         edit_key = f"edit_channel_{channel_id}"
@@ -2152,7 +2262,16 @@ def render_new_video(page_title: str = "Criação de Vídeos", prefix: str = "ne
                             thumbnail_path = str(variant.get("image_path") or payload.get("thumbnail_path") or "").strip()
                             if st.button("Gerar imagem com Nano Banana", key=f"{prefix}_general_generate_thumbnail_{channel['id']}", use_container_width=True):
                                 try:
-                                    thumbnail_path = str(generate_thumbnail_image(read_json("settings.json", {}), variant.get("image_prompt", ""), topic=str(payload.get("topic") or ""), variant_index=variant_index))
+                                    thumbnail_path = str(
+                                        generate_thumbnail_image(
+                                            read_json("settings.json", {}),
+                                            variant.get("image_prompt", ""),
+                                            topic=str(payload.get("topic") or ""),
+                                            variant_index=variant_index,
+                                            lettering_text=str(variant.get("overlay_text") or payload.get("thumbnail_text") or ""),
+                                            lettering_prompt=str(variant.get("lettering_prompt") or ""),
+                                        )
+                                    )
                                     variant["image_path"] = thumbnail_path
                                     payload["thumbnail_path"] = thumbnail_path
                                     payload["thumbnail_status"] = "generated"
@@ -2216,7 +2335,16 @@ def render_new_video(page_title: str = "Criação de Vídeos", prefix: str = "ne
                         thumbnail_path = str(variant.get("image_path") or payload.get("thumbnail_path") or "").strip()
                         if st.button("Gerar imagem da thumbnail com Nano Banana", key=f"{prefix}_generate_thumbnail_image", use_container_width=True):
                             try:
-                                thumbnail_path = str(generate_thumbnail_image(read_json("settings.json", {}), variant.get("image_prompt", ""), topic=str(payload.get("topic") or ""), variant_index=variant_index))
+                                thumbnail_path = str(
+                                    generate_thumbnail_image(
+                                        read_json("settings.json", {}),
+                                        variant.get("image_prompt", ""),
+                                        topic=str(payload.get("topic") or ""),
+                                        variant_index=variant_index,
+                                        lettering_text=str(variant.get("overlay_text") or payload.get("thumbnail_text") or ""),
+                                        lettering_prompt=str(variant.get("lettering_prompt") or ""),
+                                    )
+                                )
                                 variant["image_path"] = thumbnail_path
                                 payload["thumbnail_path"] = thumbnail_path
                                 payload["thumbnail_status"] = "generated"

package/hermes_ui/creative_generation.py

@@ -266,7 +266,7 @@ def generate_thumbnail_prompt(
         "És um director de arte de thumbnails para YouTube. Refaz um prompt de imagem forte e específico "
         "para o tópico fornecido, mantendo a intenção visual quando já existir um prompt. "
         "Separa rigorosamente a imagem sem texto do lettering: image_prompt nunca deve pedir texto renderizado, "
-        "enquanto overlay_text deve ser curto, legível e ter no máximo quatro palavras. "
+        "enquanto overlay_text é obrigatório, deve ser curto, legível e ter entre três e quatro palavras. "
         "Responde apenas com JSON válido nas chaves concept, overlay_text, composition, color_palette, subject, "
         "image_prompt, title_synergy e lettering_prompt."
     )
@@ -279,8 +279,8 @@ def generate_thumbnail_prompt(
             "reference_rules": reference_bundle(),
             "requirements": {
                 "image_prompt": "cinematic visual direction, no words, letters, logos or watermarks rendered in the image",
-                "overlay_text": "maximum 4 words, emotionally strong, not the full title",
-                "lettering_prompt": "instructions for changing only the lettering after the base image exists",
+                "overlay_text": "required, 3 to 4 words, emotionally strong, not the full title",
+                "lettering_prompt": "required instructions for rendering the exact overlay_text after the base image exists",
             },
         },
         ensure_ascii=False,
@@ -289,7 +289,11 @@ def generate_thumbnail_prompt(
     image_prompt = str(result.get("image_prompt") or "").strip()
     if not image_prompt:
         raise CreativeGenerationError("O provider não devolveu um prompt de imagem válido.")
-    overlay_text = _short_overlay(result.get("overlay_text"))
+    overlay_text = _short_overlay(result.get("overlay_text")) or _short_overlay(topic) or "WATCH NOW"
+    lettering_prompt = str(result.get("lettering_prompt") or "").strip() or (
+        "Render the exact overlay_text as bold, readable, high-contrast sans-serif lettering with an outline or shadow, "
+        "inside a safe zone and away from the main face or subject."
+    )
     return {
         "concept": str(result.get("concept") or "Thumbnail renovada").strip(),
         "overlay_text": overlay_text,
@@ -298,7 +302,7 @@ def generate_thumbnail_prompt(
         "subject": str(result.get("subject") or topic).strip(),
         "image_prompt": image_prompt,
         "title_synergy": str(result.get("title_synergy") or "").strip(),
-        "lettering_prompt": str(result.get("lettering_prompt") or "").strip(),
+        "lettering_prompt": lettering_prompt,
         "status": "prompt_ready",
     }
 
@@ -317,7 +321,7 @@ def generate_creative_package(
         "És director editorial e de thumbnails para YouTube. Cria um pacote coerente de título e thumbnail "
         "para o tópico fornecido. Gera exactamente pelo menos 20 títulos candidatos e entre 3 e 5 variantes de thumbnail. "
         "O título deve carregar keywords no início, ter curiosidade, especificidade e emoção, sem clickbait falso. "
-        "A thumbnail deve ter no máximo três elementos, alto contraste, uma composição clara, texto opcional de até 4 palavras, "
+        "A thumbnail deve ter no máximo três elementos, alto contraste, uma composição clara e lettering obrigatório de 3 a 4 palavras, "
         "safe zones e leitura em 120px. O texto da thumbnail não pode repetir o título integralmente. Remove AI tells. "
         "Responde apenas com JSON válido nas chaves selected_title, title_candidates, keywords e thumbnail_variants."
     )
@@ -337,12 +341,13 @@ def generate_creative_package(
             },
             "thumbnail_variant_schema": {
                 "concept": "string",
-                "overlay_text": "string, maximum 4 words",
+                "overlay_text": "required string, 3 to 4 words",
                 "composition": "string",
                 "color_palette": "string",
                 "subject": "string",
-                "image_prompt": "string, no text rendered in the image",
+                "image_prompt": "string describing the clean image base, without rendered text; lettering is specified separately",
                 "title_synergy": "string",
+                "lettering_prompt": "string describing how to render the exact overlay_text",
             },
         },
         ensure_ascii=False,
@@ -384,15 +389,21 @@ def generate_creative_package(
             continue
         if not str(item.get("concept") or "").strip() or not str(item.get("image_prompt") or "").strip():
             continue
+        overlay_text = _short_overlay(item.get("overlay_text")) or _short_overlay(topic) or "WATCH NOW"
+        lettering_prompt = str(item.get("lettering_prompt") or "").strip() or (
+            "Render the exact overlay_text as bold, readable, high-contrast sans-serif lettering with an outline or shadow, "
+            "inside a safe zone and away from the main face or subject."
+        )
         variants.append(
             {
                 "concept": str(item.get("concept") or "").strip(),
-                "overlay_text": _short_overlay(item.get("overlay_text")),
+                "overlay_text": overlay_text,
                 "composition": str(item.get("composition") or "").strip(),
                 "color_palette": str(item.get("color_palette") or "").strip(),
                 "subject": str(item.get("subject") or "").strip(),
                 "image_prompt": str(item.get("image_prompt") or "").strip(),
                 "title_synergy": str(item.get("title_synergy") or "").strip(),
+                "lettering_prompt": lettering_prompt,
                 "status": "prompt_ready",
             }
         )

package/hermes_ui/languages.py

@@ -756,6 +756,18 @@ _CONTENT_TRANSLATION_ROWS = (
     ("Conteúdo Markdown", "Conteúdo Markdown", "Markdown content", "Markdown 内容", "Markdown-Inhalt", "Nội dung Markdown", "Markdown içeriği", "Содержимое Markdown", "Contenido Markdown", "Konten Markdown", "Contenuto Markdown"),
     ("Canais Youtube", "Canais Youtube", "YouTube Channels", "YouTube 频道", "YouTube-Kanäle", "Kênh YouTube", "YouTube Kanalları", "Каналы YouTube", "Canales de YouTube", "Kanal YouTube", "Canali YouTube"),
     ("Método de consulta", "Método de consulta", "Lookup method", "查询方式", "Abfragemethode", "Phương thức tra cứu", "Arama yöntemi", "Метод запроса", "Método de consulta", "Metode pencarian", "Metodo di ricerca"),
+    ("Apresentação dos canais", "Apresentação dos canais", "Channel presentation", "频道展示", "Kanaldarstellung", "Hiển thị kênh", "Kanal görünümü", "Представление каналов", "Presentación de canales", "Tampilan kanal", "Presentazione dei canali"),
+    ("Lista", "Lista", "List", "列表", "Liste", "Danh sách", "Liste", "Список", "Lista", "Daftar", "Elenco"),
+    ("Kanban", "Kanban", "Kanban", "看板", "Kanban", "Kanban", "Kanban", "Канбан", "Kanban", "Kanban", "Kanban"),
+    ("YouTube", "YouTube", "YouTube", "YouTube", "YouTube", "YouTube", "YouTube", "YouTube", "YouTube", "YouTube", "YouTube"),
+    ("Inscritos", "Inscritos", "Subscribers", "订阅者", "Abonnenten", "Người đăng ký", "Aboneler", "Подписчики", "Suscriptores", "Subscriber", "Iscritti"),
+    ("Visualizações", "Visualizações", "Views", "观看次数", "Aufrufe", "Lượt xem", "Görüntülemeler", "Просмотры", "Visualizaciones", "Tayangan", "Visualizzazioni"),
+    ("Vídeos", "Vídeos", "Videos", "视频", "Videos", "Video", "Videolar", "Видео", "Vídeos", "Video", "Video"),
+    ("Em produção", "Em produção", "In production", "制作中", "In Produktion", "Đang sản xuất", "Üretimde", "В производстве", "En producción", "Sedang diproduksi", "In produzione"),
+    ("Finalizados", "Finalizados", "Completed", "已完成", "Abgeschlossen", "Đã hoàn tất", "Tamamlandı", "Завершено", "Finalizados", "Selesai", "Completati"),
+    ("Títulos", "Títulos", "Titles", "标题", "Titel", "Tiêu đề", "Başlık", "Заголовки", "Títulos", "Judul", "Titoli"),
+    ("Activo", "Activo", "Active", "活跃", "Aktiv", "Đang hoạt động", "Aktif", "Активен", "Activo", "Aktif", "Attivo"),
+    ("Inactivo", "Inactivo", "Inactive", "不活跃", "Inaktiv", "Không hoạt động", "Pasif", "Неактивен", "Inactivo", "Tidak aktif", "Inattivo"),
     ("Página pública — sem API Key", "Página pública — sem API Key", "Public page — no API Key", "公开页面 — 无 API 密钥", "Öffentliche Seite — kein API-Schlüssel", "Trang công khai — không cần API Key", "Herkese açık sayfa — API anahtarı yok", "Публичная страница — без API-ключа", "Página pública — sin clave API", "Halaman publik — tanpa Kunci API", "Pagina pubblica — senza API Key"),
     ("YouTube Data API — API Key opcional", "YouTube Data API — API Key opcional", "YouTube Data API — optional API Key", "YouTube Data API — 可选 API 密钥", "YouTube Data API — optionaler API-Schlüssel", "YouTube Data API — API Key tùy chọn", "YouTube Data API — isteğe bağlı API anahtarı", "YouTube Data API — необязательный API-ключ", "YouTube Data API — clave API opcional", "YouTube Data API — Kunci API opsional", "YouTube Data API — API Key opzionale"),
     ("Buscar no YouTube", "Buscar no YouTube", "Search YouTube", "搜索 YouTube", "YouTube durchsuchen", "Tìm trên YouTube", "YouTube'da ara", "Поиск на YouTube", "Buscar en YouTube", "Cari di YouTube", "Cerca su YouTube"),

package/hermes_ui/pipeline_worker.py

@@ -223,12 +223,33 @@ def _run_task(task: dict[str, Any]) -> dict[str, Any]:
 
     _update(task_id, stage="keywords", state="doing", progress=48)
     variant = creative.get("thumbnail_variant") if isinstance(creative.get("thumbnail_variant"), dict) else {}
-    prompt_payload = {"topic": topic, "title": title, "keywords": keywords, "thumbnail": variant, "requirements": {"aspect_ratio": "16:9", "resolution": "1920x1080", "max_elements": 3, "max_overlay_words": 4}}
+    prompt_payload = {
+        "topic": topic,
+        "title": title,
+        "keywords": keywords,
+        "thumbnail": variant,
+        "requirements": {
+            "aspect_ratio": "16:9",
+            "resolution": "1920x1080",
+            "max_elements": 3,
+            "max_overlay_words": 4,
+            "lettering_required": True,
+            "lettering_text": str(variant.get("overlay_text") or ""),
+            "lettering_prompt": str(variant.get("lettering_prompt") or ""),
+        },
+    }
     prompt_artifact = _save_json_artifact(task_id, "thumbnail-prompt", prompt_payload)
     artifacts = {**artifacts, "thumbnail_prompt_json": prompt_artifact}
     _update(task_id, stage="thumbnail_prompt", state="doing", progress=52, thumbnail_prompt=str(variant.get("image_prompt") or ""), thumbnail_text=str(variant.get("overlay_text") or ""), thumbnail_status="prompt_ready", artifacts=artifacts)
     _update(task_id, stage="thumbnail", state="doing", progress=56, thumbnail_prompt=str(variant.get("image_prompt") or ""), thumbnail_text=str(variant.get("overlay_text") or ""), thumbnail_status="prompt_ready", artifacts=artifacts)
-    thumbnail_path = generate_thumbnail_image(settings, str(variant.get("image_prompt") or ""), topic=topic, variant_index=0)
+    thumbnail_path = generate_thumbnail_image(
+        settings,
+        str(variant.get("image_prompt") or ""),
+        topic=topic,
+        variant_index=0,
+        lettering_text=str(variant.get("overlay_text") or ""),
+        lettering_prompt=str(variant.get("lettering_prompt") or ""),
+    )
     artifacts["thumbnail"] = str(thumbnail_path)
     _update(task_id, artifacts=artifacts, thumbnail_status="generated", progress=62)
 

package/hermes_ui/thumbnail_generation.py

@@ -4,6 +4,7 @@ import hashlib
 import mimetypes
 import json
 import os
+import re
 import tempfile
 from pathlib import Path
 from typing import Any
@@ -30,6 +31,51 @@ def _clean_detail(value: Any, api_key: str) -> str:
     return detail.replace(api_key, "[REDACTED]") if api_key else detail
 
 
+def _fallback_lettering(topic: str) -> str:
+    """Return a short headline when an older task has no overlay_text."""
+    words = re.findall(r"[\wÀ-ÿ$%'-]+", str(topic or ""), flags=re.UNICODE)
+    headline = " ".join(words[:4]).strip()
+    return headline.upper() if headline else "WATCH NOW"
+
+
+def _normalise_lettering_text(value: Any, topic: str) -> str:
+    """Keep the required thumbnail headline concise and never empty."""
+    words = re.findall(r"[\wÀ-ÿ$%'-]+", str(value or ""), flags=re.UNICODE)
+    if not words:
+        return _fallback_lettering(topic)
+    return " ".join(words[:4]).strip()
+
+
+def _compose_thumbnail_prompt(
+    base_prompt: str,
+    *,
+    topic: str = "",
+    lettering_text: str = "",
+    lettering_prompt: str = "",
+) -> tuple[str, str]:
+    """Combine the visual base and a mandatory, model-readable lettering layer."""
+    headline = _normalise_lettering_text(lettering_text, topic)
+    lettering_guidance = str(lettering_prompt or "").strip() or (
+        "Use a bold sans-serif headline with high contrast, a thick outline or shadow, "
+        "safe margins and placement that does not cover the face or main subject."
+    )
+    effective_prompt = (
+        "IMAGE BASE LAYER — create the requested cinematic YouTube thumbnail composition, subject, "
+        "lighting, colour palette and visual hierarchy. Keep the base image clean and uncluttered.\n"
+        f"{str(base_prompt or '').strip()}\n\n"
+        "MANDATORY LETTERING LAYER — the final image MUST visibly contain readable lettering. "
+        "If the image-base description says no text, no words or no lettering, that restriction is overridden "
+        "by this layer. Render the exact headline between the delimiters below; do not omit it, paraphrase it, "
+        "translate it, replace it with placeholder text or hide it.\n"
+        f"EXACT HEADLINE TO RENDER: <<<{headline}>>>\n"
+        f"LETTERING DESIGN: {lettering_guidance}\n"
+        "Use no more than three or four words, bold sans-serif typography, strong contrast, outline/shadow, "
+        "a safe-zone margin and a position that does not cover the face or main object. Do not add unrelated text, "
+        "logos or watermarks. The thumbnail must not be delivered without the exact headline visible."
+    )
+    return effective_prompt, headline
+
+
 def _decode_image_data(value: Any) -> bytes | None:
     if not isinstance(value, str) or not value.strip():
         return None
@@ -105,6 +151,8 @@ def generate_thumbnail_image(
     topic: str = "",
     variant_index: int = 0,
     reference_image: str | Path | None = None,
+    lettering_text: str = "",
+    lettering_prompt: str = "",
 ) -> Path:
     api_key = str(settings.get("gemini_image_api_key") or "").strip()
     if not api_key:
@@ -112,14 +160,20 @@ def generate_thumbnail_image(
     clean_prompt = str(prompt or "").strip()
     if not clean_prompt:
         raise ThumbnailGenerationError("A thumbnail não tem um prompt de imagem para gerar.")
+    effective_prompt, headline = _compose_thumbnail_prompt(
+        clean_prompt,
+        topic=topic,
+        lettering_text=lettering_text,
+        lettering_prompt=lettering_prompt,
+    )
 
     model = str(settings.get("gemini_image_model") or DEFAULT_GEMINI_IMAGE_MODEL).strip()
     aspect_ratio = str(settings.get("gemini_image_aspect_ratio") or DEFAULT_ASPECT_RATIO).strip()
     image_size = str(settings.get("gemini_image_size") or DEFAULT_IMAGE_SIZE).strip()
-    request_input: str | list[dict[str, str]] = clean_prompt
+    request_input: str | list[dict[str, str]] = effective_prompt
     if reference_image:
         request_input = [
-            {"type": "text", "text": clean_prompt},
+            {"type": "text", "text": effective_prompt},
             _image_input(Path(reference_image)),
         ]
     body = {
@@ -161,7 +215,12 @@ def generate_thumbnail_image(
     ensure_storage()
     output_dir = STORAGE / "thumbnails"
     output_dir.mkdir(parents=True, exist_ok=True)
-    destination = output_dir / _thumbnail_filename(clean_prompt, topic, variant_index, model)
+    destination = output_dir / _thumbnail_filename(
+        f"{effective_prompt}\nEXACT HEADLINE TO RENDER: {headline}",
+        topic,
+        variant_index,
+        model,
+    )
     fd, temp_name = tempfile.mkstemp(prefix=f".{destination.name}.", dir=output_dir)
     try:
         with os.fdopen(fd, "wb") as handle:

package/hermes_ui/thumbnails.py

@@ -205,6 +205,8 @@ def generate_thumbnail_for_task(task_id: str, settings: dict[str, Any]) -> tuple
         record["prompt"],
         topic=record["title"] or record["topic"],
         variant_index=record["variant_index"],
+        lettering_text=record.get("thumbnail_text") or "",
+        lettering_prompt=record.get("lettering_prompt") or "",
     )
     _persist_thumbnail_result(tasks, task, record, image_path)
     write_json("tasks.json", tasks)
@@ -258,6 +260,8 @@ def regenerate_thumbnail_prompt_and_image(
         prompt,
         topic=record["title"] or record["topic"],
         variant_index=record["variant_index"],
+        lettering_text=str((variant or {}).get("overlay_text") or ""),
+        lettering_prompt=str((variant or {}).get("lettering_prompt") or ""),
     )
     _persist_thumbnail_result(tasks, task, record, image_path, variant=variant, source="prompt_regenerated")
     write_json("tasks.json", tasks)
@@ -298,6 +302,7 @@ def regenerate_thumbnail_lettering(
         topic=record["title"] or record["topic"],
         variant_index=record["variant_index"],
         reference_image=previous_image,
+        lettering_prompt=edit_prompt,
     )
     variant = _variant_for_record(record)
     variant["image_prompt"] = base_prompt

package/package.json

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