@danhachuel/thunderbolt 0.7.37 → 0.7.39

package/app/main.py

@@ -97,7 +97,7 @@ from app.modules.token_optimizer.metrics import get_stats as get_token_optimizer
 from app.influencers_ui import render_ai_influencer_characters, render_ai_influencer_content, render_ai_influencers_api_status, render_motion_control, render_ugc_products
 from app.social_networks_ui import render_meta_api_cards, render_social_networks
 from hermes_ui.blueprints import create_blueprint_from_link, list_branding_files, save_generated_blueprint
-from hermes_ui.thumbnail_blueprints import generate_thumbnail_blueprint, list_thumbnail_blueprint_documents, resolve_thumbnail_blueprint, save_thumbnail_blueprint, save_thumbnail_blueprint_pair, thumbnail_blueprint_catalog, thumbnail_blueprint_for_blueprint, thumbnail_blueprint_for_channel
+from hermes_ui.thumbnail_blueprints import generate_thumbnail_blueprint, list_thumbnail_blueprint_documents, resolve_thumbnail_blueprint, save_thumbnail_blueprint, save_thumbnail_blueprint_pair, save_thumbnail_blueprint_pairs, thumbnail_blueprint_associations, thumbnail_blueprint_catalog, thumbnail_blueprint_for_blueprint, thumbnail_blueprint_for_channel
 from hermes_ui.metadata_cleaner import build_description, clean_video_metadata, list_edit_records, metadata_manifest, normalize_tags, save_edit_record, store_external_video
 from hermes_ui.python_editor import AUDIO_EXTENSIONS, VIDEO_EXTENSIONS, PythonEditorError, change_speed, editor_manifest, extract_audio, list_edit_records as list_python_editor_records, list_generated_videos, list_scripts, list_video_files, read_script, remove_audio, replace_audio, resize_video, save_edit_record as save_python_editor_record, save_script, store_uploaded_asset, trim_video
 from hermes_ui.cuts import CutsError, download_direct_video_url, generate_clips, list_generated_videos as list_cut_generated_videos, list_runs as list_cut_runs, list_video_files as list_cut_video_files, manifest_bytes as cut_manifest_bytes, store_uploaded_video, zip_run as zip_cut_run
@@ -2122,11 +2122,13 @@ def render_thumbnail_blueprints():
             pair_options = blueprint_catalog()
             pair_ids = [item[0] for item in pair_options]
             pair_labels = {item[0]: item[1] for item in pair_options}
-            pair = st.selectbox("Blueprint de roteiro associado", pair_ids, format_func=lambda item: pair_labels.get(item, item or "Sem Blueprint padrão"), key=f"thumbnail_card_pair_{path.stem}")
+            existing_pairs = thumbnail_blueprint_associations()
+            associated = [key for key, value in existing_pairs.items() if value == path.stem]
+            pair = st.multiselect("Blueprints de roteiro associados", pair_ids, default=[item for item in associated if item in pair_ids], format_func=lambda item: pair_labels.get(item, item or "Sem Blueprint padrão"), key=f"thumbnail_card_pair_{path.stem}")
             if st.button("Guardar associação deste card", key=f"thumbnail_card_pair_save_{path.stem}"):
                 try:
-                    save_thumbnail_blueprint_pair(path.stem, pair)
-                    st.success("Associação guardada; canais com esse Blueprint usarão esta thumbnail blueprint automaticamente.")
+                    save_thumbnail_blueprint_pairs(path.stem, pair)
+                    st.success("Associações guardadas; todos os Blueprints selecionados usarão esta Thumbnail Blueprint automaticamente.")
                 except ValueError as exc:
                     st.error(str(exc))
             with st.expander("Abrir documento completo", expanded=False):
@@ -2155,12 +2157,11 @@ 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:
-                        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})
-                        st.success("Par Blueprint de roteiro + Thumbnail Blueprint guardado.")
-                        st.rerun()
+                    update_channel(channel_id, {"thumbnail_blueprint_id": thumb, "default_thumbnail_blueprint_id": thumb, "blueprint_id": script, "default_blueprint_id": script})
+                    if script:
+                        save_thumbnail_blueprint_pair(thumb, script)
+                    st.success("Par Blueprint de roteiro + Thumbnail Blueprint guardado.")
+                    st.rerun()
 def _tiktok_accounts_from_settings(settings: dict[str, Any]) -> list[dict[str, Any]]:
     raw_accounts = settings.get("tiktok_accounts")
     if not isinstance(raw_accounts, list) or not raw_accounts:
@@ -6508,7 +6509,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 +6562,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/media_generation.py

@@ -317,7 +317,12 @@ def _image_endpoint(card: Mapping[str, Any]) -> str:
     raise MediaGenerationError(f"O provider {card.get('provider')} não tem endpoint de imagem configurado.")
 
 
-def _image_request(card: dict[str, Any], prompt: str, *, topic: str = "", lettering_text: str = "", lettering_prompt: str = "") -> Any:
+def _thumbnail_aspect_ratio(thumbnail_blueprint: Mapping[str, Any] | None) -> str:
+    content = str((thumbnail_blueprint or {}).get("content") or "")
+    return "9:16" if re.search(r"\b9\s*:\s*16\b|VERTICAL", content, flags=re.IGNORECASE) else "16:9"
+
+
+def _image_request(card: dict[str, Any], prompt: str, *, topic: str = "", lettering_text: str = "", lettering_prompt: str = "", thumbnail_blueprint: Mapping[str, Any] | None = None) -> Any:
     provider = str(card.get("provider") or "").strip().lower()
     style = str(card.get("api_style") or media_provider_definition(provider).api_style)
     endpoint = _image_endpoint(card)
@@ -327,11 +332,12 @@ def _image_request(card: dict[str, Any], prompt: str, *, topic: str = "", letter
         lettering_text=lettering_text,
         lettering_prompt=lettering_prompt,
     )
-    requested_size = "1792x1024" if provider == "pollinations" else "1280x720 minimum"
+    aspect_ratio = _thumbnail_aspect_ratio(thumbnail_blueprint)
+    requested_size = ("1024x1792" if aspect_ratio == "9:16" else "1792x1024") if provider == "pollinations" else ("720x1280 minimum" if aspect_ratio == "9:16" else "1280x720 minimum")
     constrained_prompt = _append_generation_constraints(
         image_prompt,
         kind="image",
-        aspect_ratio="16:9",
+        aspect_ratio=aspect_ratio,
         size=requested_size,
     )
     constrained_prompt = _fit_provider_prompt(constrained_prompt, provider)
@@ -348,7 +354,7 @@ def _image_request(card: dict[str, Any], prompt: str, *, topic: str = "", letter
     if style == "kie":
         body = {
             "model": _model(card),
-            "input": {"prompt": constrained_prompt, "aspect_ratio": "16:9", "resolution": "1K"},
+            "input": {"prompt": constrained_prompt, "aspect_ratio": aspect_ratio, "resolution": "1K"},
         }
         return requests.post(endpoint, headers=_headers(card), json=body, timeout=180)
     if provider == "agnes":
@@ -356,7 +362,7 @@ def _image_request(card: dict[str, Any], prompt: str, *, topic: str = "", letter
             "model": _model(card) or AGNES_IMAGE_MODEL,
             "prompt": constrained_prompt,
             "size": "1K",
-            "ratio": "16:9",
+            "ratio": aspect_ratio,
             "return_base64": True,
             "extra_body": {"response_format": "b64_json"},
         }
@@ -365,12 +371,12 @@ def _image_request(card: dict[str, Any], prompt: str, *, topic: str = "", letter
         return requests.post(
             endpoint,
             headers=_headers(card),
-            json={"model": _model(card), "prompt": constrained_prompt, "n": 1, "aspect_ratio": "16:9"},
+            json={"model": _model(card), "prompt": constrained_prompt, "n": 1, "aspect_ratio": aspect_ratio},
             timeout=180,
         )
     body = {"model": _model(card), "prompt": constrained_prompt, "n": 1, "response_format": "b64_json"}
     if provider == "pollinations":
-        body["size"] = "1792x1024"
+        body["size"] = "1024x1792" if aspect_ratio == "9:16" else "1792x1024"
     return requests.post(endpoint, headers=_headers(card), json=body, timeout=180)
 
 
@@ -427,6 +433,7 @@ def generate_image_for_card(
             )
         except Exception as exc:
             raise MediaGenerationError(str(exc)) from exc
+    aspect_ratio = _thumbnail_aspect_ratio(thumbnail_blueprint)
     if provider == "nano_banana":
         merged = dict(settings)
         merged["gemini_image_api_key"] = _api_key(card)
@@ -439,8 +446,8 @@ def generate_image_for_card(
                 _append_generation_constraints(
                     prompt,
                     kind="image",
-                    aspect_ratio="16:9",
-                    size="1280x720 minimum",
+                    aspect_ratio=aspect_ratio,
+                    size="720x1280 minimum" if aspect_ratio == "9:16" else "1280x720 minimum",
                 ),
                 topic=topic,
                 variant_index=variant_index,
@@ -469,8 +476,8 @@ def generate_image_for_card(
             constrained_prompt = _append_generation_constraints(
                 image_prompt,
                 kind="image",
-                aspect_ratio="16:9",
-                size="1280x720 minimum",
+                aspect_ratio=aspect_ratio,
+                size="720x1280 minimum" if aspect_ratio == "9:16" else "1280x720 minimum",
             )
             from huggingface_hub import InferenceClient
             image = InferenceClient(token=token or None, provider="hf-inference").text_to_image(
@@ -484,7 +491,7 @@ def generate_image_for_card(
             raise MediaGenerationError(f"Hugging Face text-to-image falhou: {str(exc)[:240]}") from exc
 
     def request(current: dict[str, Any]) -> Any:
-        return _image_request(current, prompt, topic=topic, lettering_text=lettering_text, lettering_prompt=lettering_prompt)
+        return _image_request(current, prompt, topic=topic, lettering_text=lettering_text, lettering_prompt=lettering_prompt, thumbnail_blueprint=thumbnail_blueprint)
 
     try:
         routed = route_json_request(settings, pool=POOL_IMAGE, cards=[card], request=request)

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/storage.py

@@ -379,9 +379,9 @@ def seed_blueprints() -> None:
     thumbnail_destination = BLUEPRINTS / "thumbnails"
     thumbnail_destination.mkdir(parents=True, exist_ok=True)
     legacy_thumbnail = thumbnail_destination / "FINANCE_Thumbnail_Blueprint.md"
-    current_thumbnail = thumbnail_destination / "FINANCE USA_Thumbnail_Blueprint.md"
-    if legacy_thumbnail.is_file() and not current_thumbnail.exists():
-        legacy_thumbnail.replace(current_thumbnail)
+    renamed_thumbnail = thumbnail_destination / "FINANCE USA_Thumbnail_Blueprint.md"
+    if renamed_thumbnail.is_file() and not legacy_thumbnail.exists():
+        renamed_thumbnail.replace(legacy_thumbnail)
     for source in sorted(SEED_THUMBNAIL_BLUEPRINTS.glob("*.md")):
         target = thumbnail_destination / source.name
         if not target.exists():
@@ -393,7 +393,15 @@ def seed_blueprints() -> None:
             seeded_pairs = json.loads(pair_source.read_text(encoding="utf-8"))
             current_pairs = json.loads(pair_target.read_text(encoding="utf-8")) if pair_target.exists() else {}
             if isinstance(seeded_pairs, dict) and isinstance(current_pairs, dict):
+                finance_ids = {
+                    "blueprintcanalfinanças", "blueprintcanalfinancas", "BLUEPRINT CANAL FINANÇAS",
+                    "FINANÇAS", "FINANCAS", "FINANCE", "FINANCE USA", "FINANCE BRAZIL", "FINANCE CANADA",
+                    "FINANCE FRANCE", "FINANCE GERMANY", "FINANCE IRELAND", "FINANCE ISRAEL", "FINANCE ITALY",
+                    "FINANCE JAPAN", "FINANCE MEXICO", "FINANCE POLONY", "FINANCE SOUTH AFRICA",
+                    "FINANCE SOUTH COREA", "FINANCE SPAIN", "FINANCE UK", "FINANCE AUSTRALIA",
+                }
                 merged_pairs = {**seeded_pairs, **current_pairs}
+                merged_pairs.update({key: "FINANCE_Thumbnail_Blueprint" for key in finance_ids})
                 if merged_pairs != current_pairs:
                     atomic_write(pair_target, merged_pairs)
         except (OSError, UnicodeError, json.JSONDecodeError):
@@ -402,15 +410,15 @@ def seed_blueprints() -> None:
 
 
 def _rename_pending_finance_thumbnail_references(value: Any) -> tuple[Any, bool]:
-    """Rename the legacy finance thumbnail only in unfinished work items."""
-    legacy = "FINANCE_Thumbnail_Blueprint"
-    current = "FINANCE USA_Thumbnail_Blueprint"
+    """Restore the finance thumbnail name in unfinished persisted records."""
+    renamed = "FINANCE USA_Thumbnail_Blueprint"
+    current = "FINANCE_Thumbnail_Blueprint"
     changed = False
 
     def replace(item: Any) -> Any:
         nonlocal changed
         if isinstance(item, str):
-            if item == legacy:
+            if item == renamed:
                 changed = True
                 return current
             return item
@@ -424,7 +432,7 @@ def _rename_pending_finance_thumbnail_references(value: Any) -> tuple[Any, bool]
 
 
 def migrate_finance_thumbnail_blueprint() -> None:
-    """Move pending automation/video records to the renamed finance thumbnail."""
+    """Restore the finance thumbnail name in pending records and map finance variants."""
     def load_state(name: str, default: Any) -> Any:
         path = STATE / name
         try:
@@ -477,6 +485,50 @@ def migrate_finance_thumbnail_blueprint() -> None:
             save_state("queues.json", updated_queues)
 
 
+def migrate_tiktok_thumbnail_blueprint() -> None:
+    """Adopt the vertical generic thumbnail for legacy TikTok state."""
+    def load_state(name: str, default: Any) -> Any:
+        try:
+            return _load_json_unlocked(STATE / name)
+        except (OSError, json.JSONDecodeError):
+            return default
+
+    def save_state(name: str, value: Any) -> None:
+        _atomic_write_unlocked(STATE / name, value)
+
+    channels = load_state("channels.json", [])
+    channel_map = {str(item.get("id") or ""): item for item in channels if isinstance(item, dict)} if isinstance(channels, list) else {}
+    vertical_ids = {"Generic_Thumbnail_Blueprint", "Youtube_Generic_Thumbnail_Blueprint"}
+    channel_changes = False
+    if isinstance(channels, list):
+        for channel in channels:
+            platform = str(channel.get("platform") or "").strip().casefold()
+            current = str(channel.get("thumbnail_blueprint_id") or channel.get("default_thumbnail_blueprint_id") or "").strip()
+            if platform in {"tiktok", "instagram", "instagram reels"} and (not current or current in vertical_ids):
+                channel["thumbnail_blueprint_id"] = "Tiktok_Generic_Thumbnail_Blueprint"
+                channel["default_thumbnail_blueprint_id"] = "Tiktok_Generic_Thumbnail_Blueprint"
+                channel_changes = True
+        if channel_changes:
+            save_state("channels.json", channels)
+
+    tasks = load_state("tasks.json", [])
+    tasks_changed = False
+    if isinstance(tasks, list):
+        for task in tasks:
+            if not isinstance(task, dict):
+                continue
+            channel = channel_map.get(str(task.get("channel_id") or ""), {})
+            platform = str(task.get("platform") or channel.get("platform") or "").strip().casefold()
+            format_value = str(task.get("format") or (task.get("generation_settings") or {}).get("video_aspect_ratio") or "").strip().casefold()
+            vertical = platform in {"tiktok", "instagram", "instagram reels"} or format_value in {"portrait", "vertical", "shorts", "9:16"}
+            current = str(task.get("thumbnail_blueprint_id") or "").strip()
+            if vertical and (not current or current in vertical_ids):
+                task["thumbnail_blueprint_id"] = "Tiktok_Generic_Thumbnail_Blueprint"
+                tasks_changed = True
+        if tasks_changed:
+            save_state("tasks.json", tasks)
+
+
 def seed_prompt_masters() -> None:
     """Copy packaged TikTok Prompt Masters without overwriting user files."""
     if not SEED_TIKTOK_PROMPT_MASTERS.exists():
@@ -525,6 +577,7 @@ def ensure_storage() -> None:
         if not target.exists():
             atomic_write(target, default)
     migrate_finance_thumbnail_blueprint()
+    migrate_tiktok_thumbnail_blueprint()
 
 
 _LOCK_TIMEOUT_SECONDS = 30.0

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,60 @@ 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", "portrait 9:16", "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:
+    if direct and str(direct).strip() not in {
+        "Generic_Thumbnail_Blueprint",
+        HORIZONTAL_GENERIC_THUMBNAIL_BLUEPRINT_ID,
+        VERTICAL_GENERIC_THUMBNAIL_BLUEPRINT_ID,
+    }:
         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_task(channel: Mapping[str, Any], task: Mapping[str, Any]) -> dict[str, Any]:
+    """Resolve a task thumbnail, replacing stale generic orientation defaults."""
+    format_value = task.get("format") or (task.get("generation_settings") or {}).get("video_aspect_ratio")
+    direct = str(task.get("thumbnail_blueprint_id") or "").strip()
+    if direct and direct not in {
+        "Generic_Thumbnail_Blueprint",
+        HORIZONTAL_GENERIC_THUMBNAIL_BLUEPRINT_ID,
+        VERTICAL_GENERIC_THUMBNAIL_BLUEPRINT_ID,
+    }:
+        return resolve_thumbnail_blueprint(direct)
+    return thumbnail_blueprint_for_channel({**channel, "thumbnail_blueprint_id": ""}, format_value)
 
 
-def thumbnail_blueprint_for_blueprint(blueprint_id: Any) -> dict[str, Any]:
+def thumbnail_blueprint_for_blueprint(blueprint_id: Any, format_value: 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)
+    if isinstance(paired_id, list):
+        paired_id = paired_id[0] if paired_id else ""
+    return resolve_thumbnail_blueprint(paired_id or _generic_thumbnail_blueprint_id(format_value))
 
 
 def _pair_state() -> dict[str, str]:
@@ -69,9 +106,11 @@ def _pair_state() -> dict[str, str]:
         return {}
 
 
+def thumbnail_blueprint_associations() -> dict[str, str]:
+    return _pair_state()
+
+
 def save_thumbnail_blueprint_pair(thumbnail_id: str, blueprint_id: str) -> None:
-    if str(thumbnail_id) == GENERIC_THUMBNAIL_BLUEPRINT_ID and str(blueprint_id):
-        raise ValueError(GENERIC_ASSOCIATION_ERROR)
     pairs = _pair_state()
     if blueprint_id:
         pairs[str(blueprint_id)] = str(thumbnail_id)
@@ -82,6 +121,21 @@ def save_thumbnail_blueprint_pair(thumbnail_id: str, blueprint_id: str) -> None:
     atomic_write(BLUEPRINTS / "thumbnail_blueprint_pairs.json", pairs)
 
 
+def save_thumbnail_blueprint_pairs(thumbnail_id: str, blueprint_ids: list[str]) -> None:
+    """Associate one thumbnail blueprint with any number of script blueprints."""
+    selected = {str(item).strip() for item in blueprint_ids if str(item).strip()}
+    pairs = _pair_state()
+    for key, value in list(pairs.items()):
+        values = value if isinstance(value, list) else [value]
+        if str(key) in selected:
+            continue
+        if str(thumbnail_id) in {str(item) for item in values}:
+            pairs.pop(key, None)
+    for blueprint_id in selected:
+        pairs[blueprint_id] = str(thumbnail_id)
+    atomic_write(BLUEPRINTS / "thumbnail_blueprint_pairs.json", pairs)
+
+
 def generate_thumbnail_blueprint(
     settings: Mapping[str, Any],
     *,

package/hermes_ui/thumbnail_generation.py

@@ -23,18 +23,21 @@ DEFAULT_MIME_TYPE = "image/jpeg"
 DEFAULT_IMAGE_EXTENSION = ".jpg"
 THUMBNAIL_WIDTH = 1792
 THUMBNAIL_HEIGHT = 1024
+VERTICAL_THUMBNAIL_WIDTH = 1024
+VERTICAL_THUMBNAIL_HEIGHT = 1792
 
 
 class ThumbnailGenerationError(RuntimeError):
     """Raised when Nano Banana cannot produce a thumbnail image."""
 
 
-def normalize_thumbnail_bytes(image_bytes: bytes) -> bytes:
-    """Return a non-distorted, YouTube-ready 16:9 JPEG at 1792×1024."""
+def normalize_thumbnail_bytes(image_bytes: bytes, aspect_ratio: str = DEFAULT_ASPECT_RATIO) -> bytes:
+    """Return a non-distorted JPEG in the requested thumbnail orientation."""
     try:
         with Image.open(__import__("io").BytesIO(image_bytes)) as source:
             image = ImageOps.exif_transpose(source).convert("RGB")
-            image = ImageOps.fit(image, (THUMBNAIL_WIDTH, THUMBNAIL_HEIGHT), method=Image.Resampling.LANCZOS, centering=(0.5, 0.5))
+            size = (VERTICAL_THUMBNAIL_WIDTH, VERTICAL_THUMBNAIL_HEIGHT) if str(aspect_ratio) == "9:16" else (THUMBNAIL_WIDTH, THUMBNAIL_HEIGHT)
+            image = ImageOps.fit(image, size, method=Image.Resampling.LANCZOS, centering=(0.5, 0.5))
             output = __import__("io").BytesIO()
             image.save(output, format="JPEG", quality=95, optimize=True)
             return output.getvalue()
@@ -171,6 +174,7 @@ def generate_thumbnail_image(
     reference_image: str | Path | None = None,
     lettering_text: str = "",
     lettering_prompt: str = "",
+    aspect_ratio: str = DEFAULT_ASPECT_RATIO,
 ) -> Path:
     api_key = str(settings.get("gemini_image_api_key") or "").strip()
     if not api_key:
@@ -186,9 +190,6 @@ def generate_thumbnail_image(
     )
 
     model = str(settings.get("gemini_image_model") or DEFAULT_GEMINI_IMAGE_MODEL).strip()
-    # YouTube thumbnails are never square: do not allow a legacy/provider setting
-    # to override the required horizontal canvas.
-    aspect_ratio = DEFAULT_ASPECT_RATIO
     image_size = DEFAULT_IMAGE_SIZE
     request_input: str | list[dict[str, str]] = effective_prompt
     if reference_image:
@@ -229,7 +230,7 @@ def generate_thumbnail_image(
         raise ThumbnailGenerationError("A API Nano Banana devolveu uma resposta que não é JSON.") from exc
     if str(payload.get("status") or "completed").lower() not in {"completed", "succeeded"}:
         raise ThumbnailGenerationError(f"A interação Nano Banana terminou com estado inesperado: {payload.get('status') or 'desconhecido'}.")
-    image_bytes = normalize_thumbnail_bytes(_extract_image_bytes(payload))
+    image_bytes = normalize_thumbnail_bytes(_extract_image_bytes(payload), aspect_ratio)
 
     ensure_storage()
     output_dir = STORAGE / "thumbnails"

package/hermes_ui/thumbnails.py

@@ -12,7 +12,7 @@ from .media_generation import generate_image_from_pool
 from .media_providers import media_cards_for_pool
 from .storage import STORAGE, ensure_storage, now, read_json, update_json, write_json
 from .thumbnail_generation import ThumbnailGenerationError, generate_thumbnail_image
-from .thumbnail_blueprints import thumbnail_blueprint_for_channel
+from .thumbnail_blueprints import thumbnail_blueprint_for_task
 
 
 def _generate_image_with_pool(
@@ -41,6 +41,7 @@ def _generate_image_with_pool(
             reference_image=reference_image,
             lettering_text=lettering_text,
             lettering_prompt=lettering_prompt,
+            aspect_ratio="9:16" if "9:16" in str((thumbnail_blueprint or {}).get("content") or "") else "16:9",
         )
     return generate_image_from_pool(
         settings,
@@ -270,15 +271,13 @@ def generate_thumbnail_for_task(
         and bool(item.get("enabled", True))
         for item in configured_cards
     ) if isinstance(configured_cards, list) else False
-    if not effective_blueprint and canva_selected:
+    if not effective_blueprint:
         channels = read_json("channels.json", [])
         channel = next(
             (item for item in channels if isinstance(item, dict) and str(item.get("id") or "") == record["channel_id"]),
             {},
         ) if isinstance(channels, list) else {}
-        effective_blueprint = thumbnail_blueprint_for_channel(
-            {**channel, "thumbnail_blueprint_id": record["thumbnail_blueprint_id"] or channel.get("thumbnail_blueprint_id", "")}
-        )
+        effective_blueprint = thumbnail_blueprint_for_task(channel, task)
     rules = str(effective_blueprint.get("content") or "").strip()
     if canva_selected and not rules:
         raise ThumbnailGenerationError("A tarefa não tem um Thumbnail Blueprint local válido.")
@@ -316,9 +315,7 @@ def regenerate_thumbnail_prompt(
     if not topic:
         raise ThumbnailGenerationError("A tarefa não tem tópico para refazer o prompt da thumbnail.")
     ensure_storage()
-    visual_blueprint = thumbnail_blueprint_for_channel(
-        {**(channel or {}), "thumbnail_blueprint_id": record.get("thumbnail_blueprint_id") or (channel or {}).get("thumbnail_blueprint_id", "")}
-    )
+    visual_blueprint = thumbnail_blueprint_for_task(channel or {}, task)
     effective_blueprint = {**(blueprint or {})}
     if visual_blueprint.get("content"):
         effective_blueprint["thumbnail_blueprint_rules"] = visual_blueprint["content"]
@@ -350,6 +347,12 @@ def regenerate_thumbnail_prompt_and_image(
     prompt = str((variant or {}).get("image_prompt") or "").strip()
     if not prompt:
         raise ThumbnailGenerationError("O provider não devolveu um prompt de imagem válido.")
+    channels = read_json("channels.json", [])
+    channel = next(
+        (item for item in channels if isinstance(item, dict) and str(item.get("id") or "") == str(task.get("channel_id") or "")),
+        {},
+    ) if isinstance(channels, list) else {}
+    effective_blueprint = thumbnail_blueprint_for_task(channel, task)
     _archive_image(str(task_id), record.get("image_path"))
     image_path = _generate_image_with_pool(
         settings,
@@ -358,6 +361,7 @@ def regenerate_thumbnail_prompt_and_image(
         variant_index=record["variant_index"],
         lettering_text=str((variant or {}).get("overlay_text") or ""),
         lettering_prompt=str((variant or {}).get("lettering_prompt") or ""),
+        thumbnail_blueprint=effective_blueprint,
     )
     updated = _update_thumbnail_task(
         task_id,
@@ -433,6 +437,7 @@ def regenerate_thumbnail_lettering(
         reference_image=previous_image,
         lettering_text=exact_headline,
         lettering_prompt=edit_prompt,
+        thumbnail_blueprint=thumbnail_blueprint_for_task(resolved_channel, task),
     )
     variant = _variant_for_record(record)
     variant["image_prompt"] = base_prompt

package/package.json

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

package/seed/blueprints/thumbnail_blueprint_pairs.json

@@ -1,9 +1,26 @@
 {
   "BLUEPRINTCANALMILITAR": "Militar_Thumbnail_Blueprint",
   "MILITAR": "Militar_Thumbnail_Blueprint",
-  "blueprintcanalfinanças": "FINANCE USA_Thumbnail_Blueprint",
-  "blueprintcanalfinancas": "FINANCE USA_Thumbnail_Blueprint",
-  "BLUEPRINT CANAL FINANÇAS": "FINANCE USA_Thumbnail_Blueprint",
-  "FINANÇAS": "FINANCE USA_Thumbnail_Blueprint",
-  "FINANCAS": "FINANCE USA_Thumbnail_Blueprint"
+  "blueprintcanalfinanças": "FINANCE_Thumbnail_Blueprint",
+  "blueprintcanalfinancas": "FINANCE_Thumbnail_Blueprint",
+  "BLUEPRINT CANAL FINANÇAS": "FINANCE_Thumbnail_Blueprint",
+  "FINANÇAS": "FINANCE_Thumbnail_Blueprint",
+  "FINANCAS": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE USA": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE AUSTRALIA": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE BRAZIL": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE CANADA": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE FRANCE": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE GERMANY": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE IRELAND": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE ISRAEL": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE ITALY": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE JAPAN": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE MEXICO": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE POLONY": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE SOUTH AFRICA": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE SOUTH COREA": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE SPAIN": "FINANCE_Thumbnail_Blueprint",
+  "FINANCE UK": "FINANCE_Thumbnail_Blueprint"
 }

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".]