@danhachuel/thunderbolt 0.4.20 → 0.4.22

package/app/main.py

@@ -45,6 +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.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
@@ -605,6 +606,17 @@ def render_channel_blueprint_panel(channel: dict, *, compact: bool = False) -> N
         st.info(f"**Blueprint utilizado pelo canal:** {summary['name']} · `{summary['id']}` · **Voz:** {voice} · **Idioma:** {video_language}")
 
 
+def render_channel_thumbnail_blueprint_panel(channel: dict, *, compact: bool = False) -> None:
+    document = thumbnail_blueprint_for_channel(channel)
+    name = str(document.get("name") or "SEM THUMBNAIL BLUEPRINT CONFIGURADO")
+    if name == "SEM THUMBNAIL BLUEPRINT CONFIGURADO":
+        st.warning("**SEM THUMBNAIL BLUEPRINT CONFIGURADO** · associe um Thumbnail Blueprint na aba Thumbnail Blueprints.")
+    elif compact:
+        st.caption(f"**Thumbnail Blueprint:** {name}")
+    else:
+        st.info(f"**Thumbnail Blueprint utilizado pelo canal:** {name} · apenas leitura")
+
+
 def creative_payload_from_result(channel: dict, topic: str, creative: dict, topic_source: str = "manual") -> dict[str, Any]:
     variant = creative.get("thumbnail_variant") or {}
     return {
@@ -620,6 +632,7 @@ def creative_payload_from_result(channel: dict, topic: str, creative: dict, topi
         "thumbnail_status": str(creative.get("thumbnail_status") or "prompt_ready"),
         "blueprint_id": str(channel.get("default_blueprint_id") or channel.get("blueprint_id") or ""),
         "blueprint_name": str(channel_blueprint_summary(channel).get("name") or "SEM BLUEPRINT CONFIGURADO"),
+        "thumbnail_blueprint_id": str(channel.get("default_thumbnail_blueprint_id") or channel.get("thumbnail_blueprint_id") or ""),
         "voice": str(channel.get("default_voice") or channel.get("voice") or ""),
         "ai_generation": {"creative": creative},
     }
@@ -839,11 +852,15 @@ def generate_thumbnail_for_ui(
     topic = str(topic or "").strip()
     if not topic:
         raise CreativeGenerationError("É necessário um tópico antes de gerar a thumbnail.")
+    script_blueprint = blueprint_for_channel(channel)
+    visual_blueprint = thumbnail_blueprint_for_channel(channel)
+    if visual_blueprint.get("content"):
+        script_blueprint = {**script_blueprint, "thumbnail_blueprint_rules": visual_blueprint.get("content", "")}
     variant = generate_thumbnail_prompt(
         settings,
         channel,
         topic,
-        blueprint=blueprint_for_channel(channel),
+        blueprint=script_blueprint,
         language=str(channel.get("language") or "Português"),
     )
     return {
@@ -1514,6 +1531,75 @@ def render_youtube_brandings():
 
 def render_thumbnail_blueprints():
     st.title("Thumbnail Blueprints")
+    st.caption(f"Documentos de estilo visual por nicho · armazenamento em `{BLUEPRINTS / 'thumbnails'}`")
+    st.info("Crie uma regra visual reutilizável a partir das thumbnails públicas de um canal concorrente. O documento gerado é separado do Blueprint de roteiro e será aplicado automaticamente ao canal associado.")
+    with st.form("create_thumbnail_blueprint_from_link"):
+        source_url = st.text_input("Link do canal ou vídeo YouTube", placeholder="https://www.youtube.com/@canal ou https://youtu.be/video")
+        niche = st.text_input("Nicho (usado no nome do ficheiro)", placeholder="Ex.: Militar")
+        channel_name = st.text_input("Nome do canal concorrente (opcional)")
+        sample_limit = st.slider("Vídeos públicos para analisar", 3, 10, 10)
+        submitted = st.form_submit_button("Analisar e criar Thumbnail Blueprint", type="primary")
+    if submitted:
+        if not source_url.strip() or not niche.strip():
+            st.error("Informe o link do YouTube e o nicho antes de criar.")
+        else:
+            try:
+                public = fetch_channel_videos_public(source_url, limit=sample_limit)
+                if not public.ok and not public.data.get("videos"):
+                    raise ValueError(public.message)
+                document = generate_thumbnail_blueprint(read_json("settings.json", {}), source_url=source_url.strip(), niche=niche.strip(), channel_name=channel_name.strip(), videos=public.data.get("videos", []))
+                path = save_thumbnail_blueprint(document)
+                st.success(f"Thumbnail Blueprint criado: {path.name} · {len(document.get('sample_videos', []))} referência(s) analisada(s).")
+                st.rerun()
+            except (ValueError, OSError) as exc:
+                st.error(str(exc))
+    st.divider()
+    st.subheader("Thumbnail Blueprints existentes")
+    search = st.text_input("Pesquisar Thumbnail Blueprints", key="thumbnail_blueprint_search")
+    documents = list_thumbnail_blueprint_documents()
+    if not documents:
+        st.info("Ainda não existem Thumbnail Blueprints. Use um link público do YouTube para criar o primeiro.")
+    for path in documents:
+        if search and search.casefold() not in path.name.casefold():
+            continue
+        with st.container(border=True):
+            st.markdown(f"### {path.stem}")
+            st.caption(f"Ficheiro: `{path.name}`")
+            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}")
+            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.")
+            st.code(path.read_text(encoding="utf-8"), language="markdown")
+    st.divider()
+    st.subheader("Associar ao canal e ao Blueprint de roteiro")
+    channels = read_json("channels.json", [])
+    thumbnail_options = thumbnail_blueprint_catalog()
+    thumbnail_ids = [item[0] for item in thumbnail_options]
+    thumbnail_labels = {item[0]: item[1] for item in thumbnail_options}
+    blueprint_options = blueprint_catalog()
+    blueprint_ids = [item[0] for item in blueprint_options]
+    blueprint_labels = {item[0]: item[1] for item in blueprint_options}
+    for channel in channels:
+        channel_id = str(channel.get("id") or "")
+        if not channel_id:
+            continue
+        with st.container(border=True):
+            st.write(f"**{channel.get('name', 'Canal')}**")
+            cols = st.columns(3)
+            current_thumb = str(channel.get("default_thumbnail_blueprint_id") or channel.get("thumbnail_blueprint_id") or "")
+            current_script = str(channel.get("default_blueprint_id") or channel.get("blueprint_id") or "")
+            with cols[0]:
+                thumb = st.selectbox("Thumbnail Blueprint", thumbnail_ids, index=thumbnail_ids.index(current_thumb) if current_thumb in thumbnail_ids else 0, format_func=lambda item: thumbnail_labels.get(item, item), key=f"thumbnail_blueprint_channel_{channel_id}")
+            with cols[1]:
+                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()
 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:
@@ -2038,6 +2124,7 @@ def render_channels():
                 render_channel_edit_form(channel, youtube_account_ids, youtube_account_labels, youtube_accounts_by_id)
             else:
                 summary = channel_blueprint_summary(channel)
+                render_channel_thumbnail_blueprint_panel(channel, compact=True)
                 channel_language = language_label(channel.get("language") or "pt")
                 block_cols = st.columns(4, gap="small")
                 with block_cols[0]:
@@ -2374,6 +2461,7 @@ def render_new_video(page_title: str = "Criação de Vídeos", prefix: str = "ne
                     selected = [selected_one["id"]]
                     # Intentionally sits between Canal and the generation settings, as requested.
                     render_channel_blueprint_panel(selected_one)
+                    render_channel_thumbnail_blueprint_panel(selected_one)
                     generation_settings = render_video_generation_settings(
                         prefix,
                         current_language=str(st.session_state.get("video_language") or ""),
@@ -4183,7 +4271,11 @@ 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)
-            default_cols = st.columns([1.15, 1.15, 1.5, 1.7, 1.35], gap="small")
+            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")
             with default_cols[0]:
                 st.markdown("**Idioma Padrão**")
                 st.caption(language_label(channel.get("language") or "pt"))
@@ -4207,6 +4299,14 @@ def render_automation():
                     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):
                         st.error("Use o formato HH:MM, por exemplo 08:30.")
@@ -4216,6 +4316,7 @@ 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})
                         st.success("Agendamento guardado.")
                         st.rerun()
 

package/hermes_ui/automation_worker.py

@@ -182,6 +182,7 @@ def _creative_payload(channel: dict[str, Any]) -> tuple[str, dict[str, Any]]:
         "thumbnail_status": "pending_prompt",
         "blueprint_id": str(channel.get("default_blueprint_id") or channel.get("blueprint_id") or ""),
         "blueprint_name": str(blueprint.get("name") or "SEM BLUEPRINT CONFIGURADO"),
+        "thumbnail_blueprint_id": str(channel.get("default_thumbnail_blueprint_id") or channel.get("thumbnail_blueprint_id") or ""),
         "voice": str(channel.get("default_voice") or channel.get("voice") or ""),
         "material_source": material_source,
         "generation_settings": {"video_keywords": editorial.get("keywords", []), "material_source": material_source},
@@ -228,6 +229,7 @@ def _pending_payload(channel: dict[str, Any]) -> tuple[str, dict[str, Any]]:
         "language": language,
         "blueprint_id": str(channel.get("default_blueprint_id") or channel.get("blueprint_id") or ""),
         "blueprint_name": str(blueprint.get("name") or "SEM BLUEPRINT CONFIGURADO"),
+        "thumbnail_blueprint_id": str(channel.get("default_thumbnail_blueprint_id") or channel.get("thumbnail_blueprint_id") or ""),
         "voice": str(channel.get("default_voice") or channel.get("voice") or ""),
         "material_source": material_source,
         "generation_settings": {"material_source": material_source},

package/hermes_ui/creative_generation.py

@@ -136,6 +136,7 @@ def channel_context(channel: dict[str, Any], blueprint: dict[str, Any] | None =
         "blueprint_id": str(blueprint.get("id") or channel.get("default_blueprint_id") or channel.get("blueprint_id") or ""),
         "blueprint_name": str(blueprint.get("name") or "SEM BLUEPRINT CONFIGURADO"),
         "blueprint_niche": str(blueprint.get("target_niche") or blueprint.get("niche") or metadata.get("target_niche") or metadata.get("niche") or ""),
+        "thumbnail_blueprint_rules": str(blueprint.get("thumbnail_blueprint_rules") or "").strip(),
         "default_voice": str(channel.get("default_voice") or channel.get("voice") or ""),
     }
 

package/hermes_ui/domain.py

@@ -45,6 +45,8 @@ def create_channel(name: str, url: str = "", metadata: dict[str, Any] | None = N
         "language": "Português",
         "blueprint_id": "",
         "default_blueprint_id": "",
+        "thumbnail_blueprint_id": "",
+        "default_thumbnail_blueprint_id": "",
         "style_wide": "pexels",
         "voice": "",
         "default_voice": "",
@@ -178,6 +180,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", ""),
                 "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/storage.py

@@ -21,6 +21,7 @@ TIKTOK_PROMPT_MASTERS = STORAGE / "tiktok" / "prompts_master"
 MEDIA_DOWNLOADS = STORAGE / "downloads"
 NICHES_DATA = STORAGE / "data" / "niches"
 SEED_BLUEPRINTS = ROOT / "seed" / "blueprints"
+SEED_THUMBNAIL_BLUEPRINTS = SEED_BLUEPRINTS / "thumbnails"
 SEED_TIKTOK_PROMPT_MASTERS = ROOT / "seed" / "prompt_masters"
 
 DEFAULTS: dict[str, Any] = {
@@ -359,6 +360,16 @@ def seed_blueprints() -> None:
         target = destination / source.name
         if not target.exists():
             shutil.copy2(source, target)
+    thumbnail_destination = BLUEPRINTS / "thumbnails"
+    thumbnail_destination.mkdir(parents=True, exist_ok=True)
+    for source in sorted(SEED_THUMBNAIL_BLUEPRINTS.glob("*.md")):
+        target = thumbnail_destination / source.name
+        if not target.exists():
+            shutil.copy2(source, target)
+    pair_source = SEED_BLUEPRINTS / "thumbnail_blueprint_pairs.json"
+    pair_target = BLUEPRINTS / "thumbnail_blueprint_pairs.json"
+    if pair_source.exists() and not pair_target.exists():
+        shutil.copy2(pair_source, pair_target)
 
 
 def seed_prompt_masters() -> None:
@@ -400,7 +411,7 @@ def _migrate_settings(settings: Any) -> tuple[dict[str, Any], bool]:
 
 
 def ensure_storage() -> None:
-    for path in [STATE, BLUEPRINTS / "canais", BLUEPRINTS / "nichos", BLUEPRINTS / "importados", BLUEPRINTS / "brandings", TIKTOK_PROMPT_MASTERS, MEDIA_DOWNLOADS, STORAGE / "brand", STORAGE / "scripts", STORAGE / "thumbnails", STORAGE / "videos", STORAGE / "artifacts", STORAGE / "python_editor", STORAGE / "influencers", STORAGE / "metadata_cleaner", STORAGE / "metadata_cleaner" / "outputs", STORAGE / "music", STORAGE / "voice_previews", STORAGE / "python_editor", NICHES_DATA]:
+    for path in [STATE, BLUEPRINTS / "canais", BLUEPRINTS / "nichos", BLUEPRINTS / "importados", BLUEPRINTS / "brandings", BLUEPRINTS / "thumbnails", TIKTOK_PROMPT_MASTERS, MEDIA_DOWNLOADS, STORAGE / "brand", STORAGE / "scripts", STORAGE / "thumbnails", STORAGE / "videos", STORAGE / "artifacts", STORAGE / "python_editor", STORAGE / "influencers", STORAGE / "metadata_cleaner", STORAGE / "metadata_cleaner" / "outputs", STORAGE / "music", STORAGE / "voice_previews", STORAGE / "python_editor", NICHES_DATA]:
         path.mkdir(parents=True, exist_ok=True)
     seed_blueprints()
     seed_prompt_masters()

package/hermes_ui/thumbnail_blueprints.py

@@ -0,0 +1,127 @@
+from __future__ import annotations
+
+import re
+import uuid
+from datetime import datetime, timezone
+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
+
+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.'''
+
+
+def _slug(value: Any) -> str:
+    text = re.sub(r"[^A-Za-z0-9]+", "_", str(value or "").strip()).strip("_")
+    return text or "General"
+
+
+def _record_name(niche: str) -> str:
+    return f"{_slug(niche)}_Thumbnail_Blueprint"
+
+
+def thumbnail_blueprint_catalog() -> list[tuple[str, str]]:
+    folder = BLUEPRINTS / "thumbnails"
+    folder.mkdir(parents=True, exist_ok=True)
+    result: list[tuple[str, str]] = [("", "Sem Thumbnail Blueprint padrão")]
+    for path in sorted(folder.glob("*.md"), key=lambda p: p.stat().st_mtime, reverse=True):
+        result.append((path.stem, path.stem))
+    return result
+
+
+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")}
+    return {"id": wanted, "name": wanted}
+
+
+def thumbnail_blueprint_for_channel(channel: Mapping[str, Any]) -> dict[str, Any]:
+    direct = channel.get("default_thumbnail_blueprint_id") or channel.get("thumbnail_blueprint_id")
+    if direct:
+        return resolve_thumbnail_blueprint(direct)
+    script_id = str(channel.get("default_blueprint_id") or channel.get("blueprint_id") or "").strip()
+    pairs = _pair_state()
+    return resolve_thumbnail_blueprint(pairs.get(script_id, ""))
+
+
+def _pair_state() -> dict[str, str]:
+    path = BLUEPRINTS / "thumbnail_blueprint_pairs.json"
+    try:
+        value = __import__("json").loads(path.read_text(encoding="utf-8"))
+        return {str(k): str(v) for k, v in value.items()} if isinstance(value, dict) else {}
+    except (OSError, ValueError, TypeError):
+        return {}
+
+
+def save_thumbnail_blueprint_pair(thumbnail_id: str, blueprint_id: str) -> None:
+    pairs = _pair_state()
+    if blueprint_id:
+        pairs[str(blueprint_id)] = str(thumbnail_id)
+    else:
+        for key, value in list(pairs.items()):
+            if value == thumbnail_id:
+                pairs.pop(key, None)
+    atomic_write(BLUEPRINTS / "thumbnail_blueprint_pairs.json", pairs)
+
+
+def generate_thumbnail_blueprint(
+    settings: Mapping[str, Any],
+    *,
+    source_url: str,
+    niche: str,
+    channel_name: str = "",
+    videos: list[Mapping[str, Any]] | None = None,
+) -> dict[str, Any]:
+    clean_niche = str(niche or "General").strip() or "General"
+    samples = list(videos or [])[:10]
+    sample_text = "\n".join(
+        f"- Title: {item.get('title', '')}\n  URL: {item.get('url', '')}\n  Thumbnail URL: {item.get('thumbnail_url', '')}"
+        for item in samples
+    ) or "- No public sample videos were available; produce a clearly marked baseline system from the niche."
+    user_prompt = f"Niche: {clean_niche}\nChannel: {channel_name}\nSource: {source_url}\nReference videos:\n{sample_text}\nReturn JSON with one key content containing only the complete Markdown document."
+    try:
+        routed = route_llm_json(settings, PROMPT_MASTER, user_prompt)
+        content = str(routed.payload.get("content") or "").strip()
+    except Exception as exc:
+        raise ValueError(f"Não foi possível gerar o Thumbnail Blueprint no provider configurado: {exc}") from exc
+    if not content:
+        raise ValueError("O provider não devolveu um documento Thumbnail Blueprint válido.")
+    if not content.startswith("#"):
+        content = f"# {_record_name(clean_niche)}\n\n" + content
+    return {
+        "id": _record_name(clean_niche),
+        "name": _record_name(clean_niche),
+        "niche": clean_niche,
+        "channel_name": channel_name,
+        "source_url": source_url,
+        "created_at": datetime.now(timezone.utc).isoformat(),
+        "version": 1,
+        "sample_videos": samples,
+        "content": content.rstrip() + "\n",
+    }
+
+
+def save_thumbnail_blueprint(document: Mapping[str, Any]) -> Path:
+    name = _record_name(str(document.get("niche") or document.get("name") or "General").replace("_Thumbnail_Blueprint", ""))
+    folder = BLUEPRINTS / "thumbnails"
+    folder.mkdir(parents=True, exist_ok=True)
+    target = folder / f"{name}.md"
+    content = str(document.get("content") or "").strip()
+    if not content:
+        raise ValueError("O documento Thumbnail Blueprint não pode ficar vazio.")
+    front = ["---", f"type: thumbnail_blueprint", f"id: {name}", f"name: {name}", f"niche: {document.get('niche', '')}", f"source_url: {document.get('source_url', '')}", f"created_at: {document.get('created_at', '')}", "---", ""]
+    target.write_text("\n".join(front) + content + "\n", encoding="utf-8")
+    return target
+
+
+def list_thumbnail_blueprint_documents() -> list[Path]:
+    folder = BLUEPRINTS / "thumbnails"
+    folder.mkdir(parents=True, exist_ok=True)
+    return sorted(folder.glob("*.md"), key=lambda p: p.stat().st_mtime, reverse=True)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/thunderbolt",
-  "version": "0.4.20",
+  "version": "0.4.22",
   "description": "Thunderbolt — interface local para operação de canais faceless e motor MoneyPrinterTurbo",
   "license": "MIT",
   "main": "scripts/cli.mjs",
@@ -18,6 +18,7 @@
     "scripts/*.mjs",
     "seed/prompt_masters/**/*.md",
     "seed/blueprints/**/*.json",
+    "seed/blueprints/**/*.md",
     "seed/skills/*.md",
     "seed/skills/*.py",
     "seed/references/*.md",

package/scripts/cli.mjs

@@ -75,6 +75,7 @@ function ensureRuntimeStorage() {
     join(storageRoot, "blueprints", "nichos"),
     join(storageRoot, "blueprints", "importados"),
     join(storageRoot, "blueprints", "brandings"),
+    join(storageRoot, "blueprints", "thumbnails"),
     join(storageRoot, "metadata_cleaner"),
     join(storageRoot, "metadata_cleaner", "originals"),
     join(storageRoot, "metadata_cleaner", "outputs"),
@@ -93,6 +94,19 @@ function ensureRuntimeStorage() {
       const target = join(destination, filename);
       if (!existsSync(target)) copyFileSync(join(seedRoot, filename), target);
     }
+    const thumbnailSeedRoot = join(seedRoot, "thumbnails");
+    const thumbnailDestination = join(storageRoot, "blueprints", "thumbnails");
+    if (existsSync(thumbnailSeedRoot)) {
+      for (const filename of readdirSync(thumbnailSeedRoot)) {
+        if (filename.endsWith(".md")) {
+          const target = join(thumbnailDestination, filename);
+          if (!existsSync(target)) copyFileSync(join(thumbnailSeedRoot, filename), target);
+        }
+      }
+    }
+    const pairSeed = join(seedRoot, "thumbnail_blueprint_pairs.json");
+    const pairTarget = join(storageRoot, "blueprints", "thumbnail_blueprint_pairs.json");
+    if (existsSync(pairSeed) && !existsSync(pairTarget)) copyFileSync(pairSeed, pairTarget);
   }
 }
 

package/scripts/install.mjs

@@ -103,6 +103,7 @@ function ensureDirs() {
     join(storageRoot, "blueprints", "nichos"),
     join(storageRoot, "blueprints", "importados"),
     join(storageRoot, "blueprints", "brandings"),
+    join(storageRoot, "blueprints", "thumbnails"),
     join(storageRoot, "tiktok"),
     join(storageRoot, "tiktok", "prompts_master"),
     join(storageRoot, "metadata_cleaner"),
@@ -130,6 +131,19 @@ function copySeedBlueprints(storageRoot) {
     const target = join(destination, filename);
     if (!existsSync(target)) copyFileSync(source, target);
   }
+  const thumbnailSeedRoot = join(seedRoot, "thumbnails");
+  const thumbnailDestination = join(storageRoot, "blueprints", "thumbnails");
+  if (existsSync(thumbnailSeedRoot)) {
+    for (const thumbnailFilename of readdirSync(thumbnailSeedRoot)) {
+      if (!thumbnailFilename.endsWith(".md")) continue;
+      const source = join(thumbnailSeedRoot, thumbnailFilename);
+      const target = join(thumbnailDestination, thumbnailFilename);
+      if (!existsSync(target)) copyFileSync(source, target);
+    }
+  }
+  const pairSource = join(seedRoot, "thumbnail_blueprint_pairs.json");
+  const pairTarget = join(storageRoot, "blueprints", "thumbnail_blueprint_pairs.json");
+  if (existsSync(pairSource) && !existsSync(pairTarget)) copyFileSync(pairSource, pairTarget);
 }
 
 function copySeedPromptMasters(storageRoot) {

package/seed/blueprints/thumbnail_blueprint_pairs.json

@@ -0,0 +1,4 @@
+{
+  "BLUEPRINTCANALMILITAR": "Militar_Thumbnail_Blueprint",
+  "MILITAR": "Militar_Thumbnail_Blueprint"
+}

package/seed/blueprints/thumbnails/Militar_Thumbnail_Blueprint.md

@@ -0,0 +1,241 @@
+🔒 STYLE LOCK — NON-NEGOTIABLE
+
+*Ultra-dramatic military breaking-news YouTube thumbnail style used by naval defense news channels.
+Photorealistic war imagery featuring modern naval combat scenarios, explosions, missiles, submarines, fighter jets, and warships.
+
+​The tone is urgent, dramatic, geopolitical crisis, resembling a live military emergency broadcast.
+The visual language must replicate:
+
+Breaking news urgency
+High contrast war photography
+Clear geopolitical symbolism using national flags
+Explosions, smoke, missiles, and large red arrows highlighting action
+News-style banner occupying the bottom of the frame
+The style must feel like a shocking military incident that just happened seconds ago.
+
+❌ No stylized illustration
+​❌ No cartoon elements
+❌ No minimalism
+❌ No soft colors
+❌ No alternate layout structures
+
+The system must replicate the exact visual storytelling structure of the reference.
+🧍‍♂️ FRAMING & POSE
+
+Primary subject: large military hardware
+
+*Examples:
+Warships
+Missile launches
+Submarines
+Fighter jets
+Naval fleets
+Explosions on ships
+
+*Framing rules:
+Main military object center-left or center frame
+Secondary object in background distance
+Action element (missile / explosion / aircraft) top-right or mid-air
+
+*Camera angle:
+Cinematic telephoto military photography
+Slightly low or horizon-level perspective
+Ocean horizon visible
+Subjects large and clear
+
+*Cropping:
+Military assets must dominate the frame
+Avoid excessive sky
+Ensure action area is visible
+
+*Energy:
+Active combat moment
+Missile firing
+Explosion mid-blast
+Smoke rising
+Jets flying overhead
+
+🎨 BACKGROUND & LIGHTING
+*Background environment:
+Open ocean battlefield
+Arctic sea
+Cold war naval environment
+Overcast sky or cold blue daylight
+
+*Lighting:
+Natural daylight or cold military lighting
+High contrast
+Realistic shadows
+
+*Effects required:
+Thick black smoke
+Bright orange explosions
+Missile exhaust flames
+Water splash or waves
+
+*Depth:
+Strong atmospheric depth
+Background ships slightly blurred
+
+*Visual noise:
+Moderate realism
+Military hardware details must remain sharp
+
+🧭 GEOPOLITICAL SYMBOLS
+*Flags used as identifiers:
+National flags placed above ships or aircraft
+Small but clearly visible
+Floating overlay style
+
+*Purpose:
+Instantly communicate international conflict
+
+*Typical combinations:
+NATO vs Russia
+Western fleets vs adversary forces
+
+🚨 VISUAL ATTENTION ELEMENT
+Large red arrow pointing to the key action moment.
+
+*Arrow rules:
+Bright red
+Thick outline
+Positioned top-right or top-center
+Pointing directly at explosion, missile, aircraft, or submarine
+Immediate viewer focus
+Mobile screen clarity
+
+📝 TEXT STYLE
+Text is placed in a large news banner at the bottom of the thumbnail.
+
+*Structure:
+
+*Top strip:
+BREAKING NEWS
+
+*Main headline:
+2–4 WORDS MAX
+JUST HAPPENED
+1 MINUTE AGO
+THEY ATTACKED
+WAR BEGINS
+SHIP DESTROYED
+
+*Bottom strip:
+URGENT ALERT
+
+*Typography:
+Bold condensed sans-serif
+Extremely heavy weight
+All caps
+
+*Color hierarchy:
+*Top strip:
+Red background
+White text
+
+*Main headline:
+Bright yellow background
+Black text
+Text must occupy bottom 30–35% of the thumbnail.
+
+🧠 TEXT PSYCHOLOGY
+*The headline must trigger:
+Urgency
+Breaking news shock
+Military escalation
+Fear of global conflict
+Immediate curiosity
+
+*Psychological triggers:
+“Just happened”
+“Minutes ago”
+“Attack”
+“War”
+“Emergency”
+
+*Goal:
+Viewer must feel they are seeing breaking world news right now.
+
+🎯 COMPOSITION RULES
+*Rule of thirds:
+Main military subject center-left
+Action element top-right
+
+*Focal hierarchy:
+Explosion / missile / aircraft
+Warship or submarine
+Red arrow
+Headline text
+
+*Negative space:
+Sky area used to highlight arrows or aircraft
+
+*Distraction control:
+​No cluttered UI elements
+Only essential military imagery
+
+*Mobile-first design:
+All key elements readable at small mobile sizes
+Text extremely large
+High color contrast
+
+📐 FORMAT & QUALITY
+
+*Aspect ratio:
+16:9
+
+*Resolution:
+1280 × 720 minimum
+
+*Image style:
+Hyper-realistic military photography
+High detail naval equipment
+
+*Sharpness:
+Military hardware extremely crisp
+Explosion glow vivid
+
+*Restrictions:
+❌ No stock-photo watermarks
+❌ No blurry subjects
+❌ No flat lighting
+❌ No modern graphic design layouts
+
+🧠 FINAL OBJECTIVE
+
+*Primary goal:
+Maximize YouTube CTR for geopolitical military content.
+
+*Emotional triggers:
+Shock
+Fear
+Curiosity
+Global conflict intrigue
+
+*Audience:
+Military enthusiasts
+Geopolitical news viewers
+Defense technology audiences
+The thumbnail must instantly communicate:
+“A major military incident just happened.”
+
+🧾 FINAL INPUT FORMAT
+
+*VIDEO TITLE:
+“China's SECRET Kill Chain TARGETS US Carrier — America's 22-Minute Response Left Beijing SPEECHLESS”
+
+⚙️ FINAL SYSTEM INSTRUCTION
+
+*Using the locked style above, generate a photorealistic military breaking-news thumbnail featuring:
+Modern naval combat scene
+Warships or submarines
+Missiles or explosions
+National flags indicating opposing forces
+Large red arrow highlighting the key moment
+Ocean battlefield environment
+
+Auto-generate 2–4 word breaking news headline text and place it in the yellow center banner, maintaining the full BREAKING NEWS / URGENT ALERT news-bar structure.
+
+Output must be a ready-to-upload 16:9 YouTube thumbnail replicating the reference style exactly. WITHOUT LOGO
+