@danhachuel/thunderbolt 0.4.22 → 0.4.23

package/app/main.py

@@ -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:

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,7 @@ 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 _pair_state() -> dict[str, str]:
@@ -61,6 +64,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.23",
   "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".]