@danhachuel/thunderbolt 0.4.22 → 0.4.24

package/app/main.py

@@ -45,7 +45,7 @@ from app.modules.niche_finder.data_loader import DatasetError, download_kaggle_d
 from app.modules.niche_finder.summarizer import summarize_items
 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 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_channel
+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.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
@@ -1570,8 +1570,11 @@ def render_thumbnail_blueprints():
             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}")
             if st.button("Guardar associação deste card", key=f"thumbnail_card_pair_save_{path.stem}"):
-                save_thumbnail_blueprint_pair(path.stem, pair)
-                st.success("Associação guardada; canais com esse Blueprint usarão esta thumbnail blueprint automaticamente.")
+                try:
+                    save_thumbnail_blueprint_pair(path.stem, pair)
+                    st.success("Associação guardada; canais com esse Blueprint usarão esta thumbnail blueprint automaticamente.")
+                except ValueError as exc:
+                    st.error(str(exc))
             st.code(path.read_text(encoding="utf-8"), language="markdown")
     st.divider()
     st.subheader("Associar ao canal e ao Blueprint de roteiro")
@@ -1597,9 +1600,12 @@ 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}", use_container_width=True):
-                    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()
+                    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()
 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:
@@ -4271,18 +4277,14 @@ def render_automation():
             with header_cols[3]:
                 schedule_time = st.text_input("Horário (HH:MM)", value=channel.get("automation_time", "00:00"), key=f"automation_time_{channel_id}")
             blueprint_ids, blueprint_labels, current_blueprint, voice_options, current_voice = channel_default_options(channel)
-            thumbnail_items = thumbnail_blueprint_catalog()
-            thumbnail_ids = [item[0] for item in thumbnail_items]
-            thumbnail_labels = {item[0]: item[1] for item in thumbnail_items}
-            current_thumbnail = str(channel.get("default_thumbnail_blueprint_id") or channel.get("thumbnail_blueprint_id") or "")
-            default_cols = st.columns([1.0, 1.0, 1.35, 1.55, 1.55, 1.0], gap="small")
+            default_cols = st.columns([1.0, 1.0, 1.35, 1.45, 1.55, 1.0], gap="small")
             with default_cols[0]:
                 st.markdown("**Idioma Padrão**")
                 st.caption(language_label(channel.get("language") or "pt"))
             with default_cols[1]:
                 st.markdown("**Nicho Padrão**")
                 st.caption(channel_niche_label(channel))
-            with default_cols[2]:
+            with default_cols[3]:
                 automation_blueprint = st.selectbox(
                     "Blueprint Padrão",
                     blueprint_ids,
@@ -4290,7 +4292,11 @@ def render_automation():
                     format_func=lambda item: blueprint_labels.get(item, item or "Sem Blueprint padrão"),
                     key=f"automation_blueprint_{channel_id}",
                 )
-            with default_cols[3]:
+            with default_cols[2]:
+                paired_thumbnail = thumbnail_blueprint_for_blueprint(automation_blueprint)
+                st.markdown("**Thumbnail Blueprint**")
+                st.caption(str(paired_thumbnail.get("name") or "Generic_Thumbnail_Blueprint"))
+            with default_cols[4]:
                 automation_voice = st.selectbox(
                     "Narrador/Voz Padrão",
                     voice_options,
@@ -4298,14 +4304,6 @@ def render_automation():
                     format_func=lambda item: item or "Sem voz padrão",
                     key=f"automation_voice_{channel_id}",
                 )
-            with default_cols[4]:
-                automation_thumbnail = st.selectbox(
-                    "Thumbnail Blueprint",
-                    thumbnail_ids,
-                    index=thumbnail_ids.index(current_thumbnail) if current_thumbnail in thumbnail_ids else 0,
-                    format_func=lambda item: thumbnail_labels.get(item, item or "Sem Thumbnail Blueprint"),
-                    key=f"automation_thumbnail_blueprint_{channel_id}",
-                )
             with default_cols[5]:
                 if st.button("Guardar", key=f"automation_save_{channel_id}", use_container_width=True):
                     if not valid_hhmm(schedule_time):
@@ -4316,7 +4314,8 @@ def render_automation():
                             "automation_time": schedule_time.strip(),
                         })
                         set_channel_defaults(channel_id, automation_blueprint, automation_voice)
-                        update_channel(channel_id, {"thumbnail_blueprint_id": automation_thumbnail, "default_thumbnail_blueprint_id": automation_thumbnail})
+                        paired_id = str(paired_thumbnail.get("id") or "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

@@ -6,6 +6,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
 
 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
@@ -180,7 +181,7 @@ def create_tasks_for_batch(batch: dict[str, Any]) -> list[dict[str, Any]]:
                 "generation_settings": payload.get("generation_settings", options.get("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", ""),
+                "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,
                 "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"),

package/hermes_ui/pipeline_worker.py

@@ -24,6 +24,7 @@ from hermes_ui.media_generation import MediaGenerationError, _append_generation_
 from hermes_ui.media_providers import FULL_IA_VIDEO_PROVIDER_CODES, media_cards_for_pool, media_provider_definition
 from hermes_ui.material_sources import material_api_keys, material_source_cards, selected_material_source
 from hermes_ui.thumbnail_generation import ThumbnailGenerationError, generate_thumbnail_image
+from hermes_ui.thumbnail_blueprints import thumbnail_blueprint_for_channel
 
 PIPELINE_LOCK_FILENAME = "pipeline_worker.lock"
 PIPELINE_LOG_FILENAME = "pipeline_worker.json"
@@ -1229,6 +1230,9 @@ 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)
+    if visual_blueprint.get("content"):
+        blueprint = {**blueprint, "thumbnail_blueprint_rules": visual_blueprint["content"]}
     route = _normalise_video_route(task, settings)
     topic = str(task.get("topic") or "").strip()
     if route != "music" and (not topic or str(task.get("topic_source") or "") in {"auto", "llm_pending"}):

package/hermes_ui/thumbnail_blueprints.py

@@ -9,6 +9,9 @@ from typing import Any, Mapping
 from .provider_routing import route_llm_json
 from .storage import BLUEPRINTS, atomic_write, list_blueprint_files, load_blueprint_file
 
+GENERIC_THUMBNAIL_BLUEPRINT_ID = "Generic_Thumbnail_Blueprint"
+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.
 The output must be a practical, locked visual system, not a script blueprint. Infer recurring composition, framing, lighting, color, typography, overlay text, symbols, emotional triggers, mobile readability, aspect ratio, quality and negative constraints. Use the exact Markdown structure of the requested reference: STYLE LOCK, FRAMING & POSE, BACKGROUND & LIGHTING, GEOPOLITICAL SYMBOLS when relevant, VISUAL ATTENTION ELEMENT, TEXT STYLE, TEXT PSYCHOLOGY, COMPOSITION RULES, FORMAT & QUALITY, FINAL OBJECTIVE, FINAL INPUT FORMAT and FINAL SYSTEM INSTRUCTION. Write the document in English. Do not invent channel analytics. The document must instruct future thumbnail generation and include a concise, ready-to-use image prompt template.'''
 
@@ -48,7 +51,13 @@ def thumbnail_blueprint_for_channel(channel: Mapping[str, Any]) -> dict[str, Any
         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, ""))
+    return resolve_thumbnail_blueprint(pairs.get(script_id, "") or GENERIC_THUMBNAIL_BLUEPRINT_ID)
+
+
+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)
 
 
 def _pair_state() -> dict[str, str]:
@@ -61,6 +70,8 @@ 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):
+        raise ValueError(GENERIC_ASSOCIATION_ERROR)
     pairs = _pair_state()
     if blueprint_id:
         pairs[str(blueprint_id)] = str(thumbnail_id)

package/package.json

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

package/seed/blueprints/thumbnails/Generic_Thumbnail_Blueprint.md

@@ -0,0 +1,114 @@
+🔒 STYLE LOCK — NON-NEGOTIABLE
+
+[One paragraph describing the overall visual style of the channel: e.g., "Clean, minimalist tech-review style with high‑key lighting and product‑centric compositions."]
+
+❌ Not allowed (list of elements the channel never uses, based on observed thumbnails):
+- [e.g., No text overlays, no human faces, no saturated colours, etc.]
+- [List all prohibitions observed]
+
+🧍‍♂️ FRAMING & POSE
+
+Primary subject(s): [describe the typical main visual element – person, product, scene, etc.]
+
+Framing rules:
+- [e.g., Subject placed centre‑left, camera at eye level, etc.]
+- [Additional rules]
+
+Camera angle: [typical angle – low, high, eye‑level, etc.]
+
+Cropping: [how much of the subject fills the frame, any cropping conventions]
+
+Energy / action: [static, dynamic, action‑oriented, etc.]
+
+🎨 BACKGROUND & LIGHTING
+
+Background environment: [typical setting – studio, outdoor, dark, etc.]
+
+Lighting: [high‑key, low‑key, natural, dramatic, etc.]
+
+Effects: [any recurring visual effects – bokeh, lens flare, smoke, etc.]
+
+Depth: [shallow depth of field, deep focus, etc.]
+
+Visual noise: [level of detail, busy vs. clean]
+
+🧭 IDENTIFICADORES / SÍMBOLOS DO CANAL
+
+[Describe any recurring symbols that instantly communicate context – e.g., national flags, brand logos, specific icons, recurring faces, etc. If none, state explicitly: "The channel does not use any recurring symbolic identifiers."]
+
+🚨 VISUAL ATTENTION ELEMENT
+
+[Describe if the channel uses arrows, circles, zooms, emojis, etc. – specify colour, shape, position, and usage rules. If the channel does NOT use any such elements, state explicitly: "The channel does not use any visual attention elements."]
+
+📝 TEXT STYLE
+
+Structure:
+- [Number of text lines / bands, placement – e.g., bottom banner, top left, etc.]
+- [Hierarchy – e.g., main headline larger, sub‑headline smaller]
+
+Typography:
+- [Font family, weight, casing – e.g., bold sans‑serif, all caps]
+
+Colour hierarchy:
+- [Background colour, text colour for each layer]
+
+Text coverage: [approximate % of thumbnail occupied by text – e.g., bottom 30%]
+
+🧠 TEXT PSYCHOLOGY
+
+[Describe typical emotional triggers used in headlines – e.g., urgency, curiosity, shock, numbers, questions, etc.]
+
+Examples of observed words/phrases:
+- [e.g., "You Won't Believe", "Destroyed", "New", "Why", etc.]
+
+🎯 COMPOSITION RULES
+
+- Rule of thirds application: [where key elements are placed]
+- Focal hierarchy: [order of visual importance – main subject, secondary, text, etc.]
+- Negative space: [how empty areas are used]
+- Distraction control: [what is avoided to keep focus]
+- Mobile‑first design: [ensuring readability on small screens]
+
+📐 FORMAT & QUALITY
+
+*Aspect ratio:
+16:9
+
+*Resolution:
+1280 × 720 minimum
+
+*Image style:
+[Photorealistic / illustrated / mixed – describe level of realism]
+
+*Sharpness:
+[Expected clarity – e.g., crisp details, slightly soft background]
+
+*Restrictions:
+- [List any technical restrictions observed – e.g., no watermarks, no blur, no flat lighting, etc.]
+
+🧠 FINAL OBJECTIVE
+
+*Primary goal:
+Maximize YouTube CTR for [nicho do canal – e.g., technology reviews, personal finance, true crime, etc.]
+
+*Emotional triggers:
+[Target emotions – e.g., curiosity, fear, excitement, etc.]
+
+*Audience:
+[Describe target viewer – e.g., tech enthusiasts, investors, etc.]
+
+*Thumbnail must instantly communicate:
+[Core message – e.g., "A shocking revelation", "A must‑see product", etc.]
+
+🧾 FINAL INPUT FORMAT
+
+*VIDEO TITLE:
+"[Insert the actual video title or script topic here]"
+
+⚙️ FINAL SYSTEM INSTRUCTION
+
+Using the locked style defined above, generate a YouTube thumbnail that strictly follows all compositional, textual, and visual rules.
+
+Automatically extract 2–4 words from the provided VIDEO TITLE to serve as the headline, and place it according to the TEXT STYLE rules (including any banner structure).
+
+Output must be a ready‑to‑upload 16:9 thumbnail (minimum 1280×720) replicating the channel’s exact visual identity. [Specify if logo is to be included or not – e.g., "WITHOUT LOGO" or "INCLUDE CHANNEL LOGO in top‑left corner".]