@danhachuel/thunderbolt 0.2.62 → 0.2.64

package/app/main.py

@@ -22,7 +22,7 @@ except (OSError, json.JSONDecodeError):
 
 from hermes_ui.domain import STAGES, create_batch, create_channel, create_tasks_for_batch, delete_channel, pipeline_summary, set_channel_defaults, transition_task, update_channel, update_channel_video
 from hermes_ui.automation_worker import load_worker_status
-from hermes_ui.storage import BLUEPRINTS, STORAGE, TIKTOK_PROMPT_MASTERS, ensure_storage, list_blueprint_files, list_prompt_master_files, load_blueprint_file, load_prompt_master_file, now, read_json, write_json
+from hermes_ui.storage import BLUEPRINTS, STORAGE, TIKTOK_PROMPT_MASTERS, ensure_storage, get_display_name, list_blueprint_files, list_prompt_master_files, load_blueprint_file, load_prompt_master_file, now, read_json, set_display_name, write_json
 from app.modules.niche_finder.apify import ApifyError, DEFAULT_ACTOR_ID, abort_actor_run, build_actor_input, get_dataset_items, normalize_video_items, start_actor_run, wait_for_actor_run
 from app.modules.niche_finder.core import NicheAnalysisError, run_niche_analysis
 from app.modules.niche_finder.data_loader import DatasetError, download_kaggle_dataset
@@ -204,6 +204,41 @@ def card(label: str, value: str | int, note: str = ""):
     st.markdown(f'<div class="content-card"><div class="content-label">{label}</div><div class="content-value">{value}</div><div class="small-muted">{note}</div></div>', unsafe_allow_html=True)
 
 
+def _library_card_key(kind: str, path: Path) -> str:
+    return hashlib.sha1(f"{kind}:{path.resolve()}".encode("utf-8")).hexdigest()[:12]
+
+
+def _render_library_name_editor(kind: str, path: Path, current_name: str) -> str:
+    """Render the inline name editor while keeping the physical filename unchanged."""
+    edit_key = f"rename_{kind}_{_library_card_key(kind, path)}"
+    if st.session_state.get(edit_key):
+        with st.form(f"{edit_key}_form", border=False):
+            edited_name = st.text_input("Nome de apresentação", value=current_name, max_chars=120, key=f"{edit_key}_input")
+            save_col, cancel_col = st.columns(2)
+            with save_col:
+                save_name = st.form_submit_button("Guardar nome", type="primary", use_container_width=True)
+            with cancel_col:
+                cancel_name = st.form_submit_button("Cancelar", use_container_width=True)
+        if save_name:
+            try:
+                set_display_name(kind, path, edited_name)
+                st.session_state.pop(edit_key, None)
+                st.success("Nome actualizado.")
+                st.rerun()
+            except ValueError as exc:
+                st.error(str(exc))
+        if cancel_name:
+            st.session_state.pop(edit_key, None)
+            st.rerun()
+    return edit_key
+
+
+def _render_card_pencil(edit_key: str) -> None:
+    if st.button("✏️", help="Editar nome de apresentação", key=f"pencil_{edit_key}", type="tertiary", use_container_width=True):
+        st.session_state[edit_key] = True
+        st.rerun()
+
+
 def channel_options() -> list[dict]:
     return [c for c in read_json("channels.json", []) if c.get("active", True)]
 
@@ -214,7 +249,7 @@ def blueprint_catalog() -> list[tuple[str, str]]:
         try:
             data = load_blueprint_file(path)
             identifier = str(data.get("id") or path.stem)
-            label = str(data.get("name") or path.stem)
+            label = get_display_name("blueprints", path, str(data.get("name") or data.get("title") or path.stem))
             options.append((identifier, label))
         except (OSError, ValueError, json.JSONDecodeError):
             continue
@@ -231,11 +266,11 @@ def blueprint_for_channel(channel: dict) -> dict[str, Any]:
             data = load_blueprint_file(path)
         except (OSError, ValueError, json.JSONDecodeError):
             continue
-        identifiers = {str(data.get("id") or ""), path.stem, str(data.get("name") or "")}
+        identifiers = {str(data.get("id") or ""), path.stem, str(data.get("name") or ""), get_display_name("blueprints", path, str(data.get("name") or path.stem))}
         if blueprint_id in identifiers:
             resolved = dict(data)
             resolved.setdefault("id", blueprint_id)
-            resolved.setdefault("name", str(data.get("name") or path.stem))
+            resolved["name"] = get_display_name("blueprints", path, str(data.get("name") or path.stem))
             return resolved
     return {"id": blueprint_id, "name": blueprint_id}
 
@@ -665,14 +700,21 @@ def render_blueprints():
         if not files:
             st.info("Ainda não existem blueprints na pasta local.")
         for path in files:
-            if search and search.lower() not in path.name.lower():
-                continue
             try:
                 data = load_blueprint_file(path)
-                title = data.get("channel_name") or data.get("name") or data.get("title") or path.stem
-                with st.expander(f"{title} — {path.relative_to(BLUEPRINTS)}"):
-                    st.caption(f"Ficheiro: {path}")
-                    st.json(data)
+                fallback_title = str(data.get("channel_name") or data.get("name") or data.get("title") or path.stem)
+                title = get_display_name("blueprints", path, fallback_title)
+                if search and search.lower() not in f"{title}\n{path.name}".lower():
+                    continue
+                card_key = _library_card_key("blueprints", path)
+                header_cols = st.columns([0.93, 0.07], vertical_alignment="center")
+                with header_cols[0]:
+                    with st.expander(f"{title} — {path.relative_to(BLUEPRINTS)}"):
+                        st.caption(f"Ficheiro: {path}")
+                        st.json(data)
+                with header_cols[1]:
+                    _render_card_pencil(f"rename_blueprints_{card_key}")
+                _render_library_name_editor("blueprints", path, title)
             except Exception as exc:
                 with st.expander(f"Inválido — {path.name}"):
                     st.error(str(exc))
@@ -752,7 +794,8 @@ def render_tiktok_prompt_masters():
                 content = load_prompt_master_file(path)
             except (OSError, ValueError):
                 content = ""
-            if search and search.lower() not in f"{path.name}\n{content}".lower():
+            display_heading = get_display_name("prompt_masters", path, next((line.lstrip("#").strip() for line in content.splitlines() if line.startswith("#")), path.stem))
+            if search and search.lower() not in f"{display_heading}\n{path.name}\n{content}".lower():
                 continue
             visible_files.append(path)
         if not visible_files:
@@ -760,24 +803,31 @@ def render_tiktok_prompt_masters():
         for path in visible_files:
             try:
                 content = load_prompt_master_file(path)
-                heading = next((line.lstrip("#").strip() for line in content.splitlines() if line.startswith("#")), path.stem)
-                with st.expander(f"{heading} — {path.name}", expanded=False):
-                    st.caption(f"Ficheiro TikTok: `{path}`")
-                    edited_content = st.text_area("Conteúdo Markdown", value=content, height=360, key=f"tiktok_prompt_master_editor_{path.stem}")
-                    prompt_cols = st.columns(3)
-                    with prompt_cols[0]:
-                        if st.button("Guardar alterações", type="primary", use_container_width=True, key=f"save_prompt_master_{path.stem}"):
-                            path.write_text(edited_content.rstrip() + "\n", encoding="utf-8")
-                            st.success("Prompt Master actualizado.")
-                            st.rerun()
-                    with prompt_cols[1]:
-                        st.download_button("Descarregar", data=content.encode("utf-8"), file_name=path.name, mime="text/markdown", use_container_width=True, key=f"download_prompt_master_{path.stem}")
-                    with prompt_cols[2]:
-                        if st.button("Apagar", use_container_width=True, key=f"delete_prompt_master_{path.stem}"):
-                            path.unlink(missing_ok=True)
-                            st.success("Prompt Master removido da biblioteca TikTok.")
-                            st.rerun()
-                    st.markdown(content)
+                fallback_heading = next((line.lstrip("#").strip() for line in content.splitlines() if line.startswith("#")), path.stem)
+                heading = get_display_name("prompt_masters", path, fallback_heading)
+                card_key = _library_card_key("prompt_masters", path)
+                header_cols = st.columns([0.93, 0.07], vertical_alignment="center")
+                with header_cols[0]:
+                    with st.expander(f"{heading} — {path.name}", expanded=False):
+                        st.caption(f"Ficheiro TikTok: `{path}`")
+                        edited_content = st.text_area("Conteúdo Markdown", value=content, height=360, key=f"tiktok_prompt_master_editor_{path.stem}")
+                        prompt_cols = st.columns(3)
+                        with prompt_cols[0]:
+                            if st.button("Guardar alterações", type="primary", use_container_width=True, key=f"save_prompt_master_{path.stem}"):
+                                path.write_text(edited_content.rstrip() + "\n", encoding="utf-8")
+                                st.success("Prompt Master actualizado.")
+                                st.rerun()
+                        with prompt_cols[1]:
+                            st.download_button("Descarregar", data=content.encode("utf-8"), file_name=path.name, mime="text/markdown", use_container_width=True, key=f"download_prompt_master_{path.stem}")
+                        with prompt_cols[2]:
+                            if st.button("Apagar", use_container_width=True, key=f"delete_prompt_master_{path.stem}"):
+                                path.unlink(missing_ok=True)
+                                st.success("Prompt Master removido da biblioteca TikTok.")
+                                st.rerun()
+                        st.markdown(content)
+                with header_cols[1]:
+                    _render_card_pencil(f"rename_prompt_masters_{card_key}")
+                _render_library_name_editor("prompt_masters", path, heading)
             except (OSError, ValueError) as exc:
                 with st.expander(f"Ficheiro inválido — {path.name}"):
                     st.error(str(exc))

package/hermes_ui/storage.py

@@ -15,6 +15,7 @@ BLUEPRINTS = STORAGE / "blueprints"
 TIKTOK_PROMPT_MASTERS = STORAGE / "tiktok" / "prompts_master"
 NICHES_DATA = STORAGE / "data" / "niches"
 SEED_BLUEPRINTS = ROOT / "seed" / "blueprints"
+SEED_TIKTOK_PROMPT_MASTERS = ROOT / "seed" / "prompt_masters"
 
 DEFAULTS: dict[str, Any] = {
         "channels.json": [],
@@ -23,6 +24,7 @@ DEFAULTS: dict[str, Any] = {
     "queues.json": {"niche": [], "blueprint": [], "brand": [], "script": [], "title": [], "thumbnail": [], "video": [], "edit": [], "upload": []},
     "batches.json": [],
     "uploads.json": [],
+    "display_names.json": {"blueprints": {}, "prompt_masters": {}},
     "niche_apify_runs.json": [],
     "metadata_edits.json": [],
         "python_editor_edits.json": [],
@@ -239,10 +241,22 @@ def seed_blueprints() -> None:
             shutil.copy2(source, target)
 
 
+def seed_prompt_masters() -> None:
+    """Copy packaged TikTok Prompt Masters without overwriting user files."""
+    if not SEED_TIKTOK_PROMPT_MASTERS.exists():
+        return
+    TIKTOK_PROMPT_MASTERS.mkdir(parents=True, exist_ok=True)
+    for source in sorted(SEED_TIKTOK_PROMPT_MASTERS.glob("*.md")):
+        target = TIKTOK_PROMPT_MASTERS / source.name
+        if not target.exists():
+            shutil.copy2(source, target)
+
+
 def ensure_storage() -> None:
     for path in [STATE, BLUEPRINTS / "canais", BLUEPRINTS / "nichos", BLUEPRINTS / "importados", BLUEPRINTS / "brandings", TIKTOK_PROMPT_MASTERS, STORAGE / "brand", STORAGE / "scripts", STORAGE / "thumbnails", STORAGE / "videos", STORAGE / "artifacts", STORAGE / "skills", 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()
     for filename, default in DEFAULTS.items():
         target = STATE / filename
         if not target.exists():
@@ -293,6 +307,53 @@ def append_json(name: str, item: dict[str, Any]) -> dict[str, Any]:
     return item
 
 
+def _display_name_key(kind: str, path: Path) -> str:
+    """Return a stable storage-relative key without renaming the physical file."""
+    resolved = path.resolve()
+    if kind == "blueprints":
+        root = BLUEPRINTS.resolve()
+        try:
+            return resolved.relative_to(root).as_posix()
+        except ValueError as exc:
+            raise ValueError("O ficheiro não pertence ao storage de Blueprints.") from exc
+    if kind == "prompt_masters":
+        root = TIKTOK_PROMPT_MASTERS.resolve()
+        try:
+            return resolved.relative_to(root).as_posix()
+        except ValueError as exc:
+            raise ValueError("O ficheiro não pertence ao storage de Prompt Masters.") from exc
+    raise ValueError(f"Tipo de biblioteca inválido: {kind}")
+
+
+def get_display_name(kind: str, path: Path, fallback: str) -> str:
+    names = read_json("display_names.json", {"blueprints": {}, "prompt_masters": {}})
+    if not isinstance(names, dict):
+        return fallback
+    entries = names.get(kind, {})
+    if not isinstance(entries, dict):
+        return fallback
+    value = str(entries.get(_display_name_key(kind, path)) or "").strip()
+    return value or fallback
+
+
+def set_display_name(kind: str, path: Path, name: str) -> str:
+    clean_name = " ".join(str(name).split()).strip()
+    if not clean_name:
+        raise ValueError("Informe um nome para a biblioteca.")
+    if len(clean_name) > 120:
+        raise ValueError("O nome deve ter no máximo 120 caracteres.")
+    names = read_json("display_names.json", {"blueprints": {}, "prompt_masters": {}})
+    if not isinstance(names, dict):
+        names = {"blueprints": {}, "prompt_masters": {}}
+    entries = names.get(kind)
+    if not isinstance(entries, dict):
+        entries = {}
+        names[kind] = entries
+    entries[_display_name_key(kind, path)] = clean_name
+    write_json("display_names.json", names)
+    return clean_name
+
+
 def list_blueprint_files() -> list[Path]:
     ensure_storage()
     return sorted(BLUEPRINTS.rglob("*.json"), key=lambda p: p.stat().st_mtime, reverse=True)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/thunderbolt",
-  "version": "0.2.62",
+  "version": "0.2.64",
   "description": "Thunderbolt — interface local para operação de canais faceless e motor MoneyPrinterTurbo",
   "main": "scripts/cli.mjs",
   "type": "module",
@@ -16,6 +16,7 @@
     "scripts/*.mjs",
     "storage/blueprints/**/*.json",
     "storage/tiktok/prompts_master/**/*.md",
+    "seed/prompt_masters/**/*.md",
     "seed/blueprints/**/*.json",
     "seed/skills/*.md",
     "seed/references/*.md",

package/scripts/install.mjs

@@ -103,6 +103,8 @@ function ensureDirs() {
     join(storageRoot, "blueprints", "nichos"),
     join(storageRoot, "blueprints", "importados"),
     join(storageRoot, "blueprints", "brandings"),
+    join(storageRoot, "tiktok"),
+    join(storageRoot, "tiktok", "prompts_master"),
     join(storageRoot, "metadata_cleaner"),
     join(storageRoot, "metadata_cleaner", "originals"),
     join(storageRoot, "metadata_cleaner", "outputs"),
@@ -115,6 +117,7 @@ function ensureDirs() {
   ];
   for (const directory of directories) mkdirSync(directory, { recursive: true });
   copySeedBlueprints(storageRoot);
+  copySeedPromptMasters(storageRoot);
 }
 
 function copySeedBlueprints(storageRoot) {
@@ -129,6 +132,19 @@ function copySeedBlueprints(storageRoot) {
   }
 }
 
+function copySeedPromptMasters(storageRoot) {
+  const seedRoot = join(root, "seed", "prompt_masters");
+  const destination = join(storageRoot, "tiktok", "prompts_master");
+  if (!existsSync(seedRoot)) return;
+  mkdirSync(destination, { recursive: true });
+  for (const filename of readdirSync(seedRoot)) {
+    if (!filename.endsWith(".md")) continue;
+    const source = join(seedRoot, filename);
+    const target = join(destination, filename);
+    if (!existsSync(target)) copyFileSync(source, target);
+  }
+}
+
 function copyOrMove(source, target, label) {
   if (!existsSync(source) || existsSync(target)) return false;
   mkdirSync(dirname(target), { recursive: true });

package/seed/prompt_masters/2Dstickman.md

@@ -0,0 +1,193 @@
+Você é um engenheiro de prompts especializado em geração de prompts de imagem cinematográficos para um estilo 2D stickman documentary desenhado à mão.
+
+Seu trabalho é transformar UMA única entrada do usuário (ideia, roteiro curto ou descrição de imagem) em EXATAMENTE 7 prompts de geração de imagem altamente estruturados, seguindo rigorosamente as regras abaixo.
+
+O objetivo é gerar prompts consistentes, cinematográficos e visualmente coerentes, com continuidade de mundo, personagens e objetos.
+
+REGRAS ABSOLUTAS
+Você deve produzir EXATAMENTE 7 prompts
+Nunca gere mais
+Nunca gere menos
+Cada prompt deve conter 3 partes obrigatórias
+
+A) Título do Shot com emoji
+
+Formato obrigatório:
+
+[EMOJI] — (Main / B-roll / Establishing / Detail) — (Characters Included / No Characters) — [Resumo rápido da ação]
+
+Exemplo
+
+🎬 — Main — Characters Included — stickman tentando resolver um problema
+
+B) Bloco de prompt dentro de código
+
+O prompt deve estar dentro de um bloco de código.
+
+O texto NÃO pode conter emojis.
+
+C) CTA final
+
+Cada prompt deve terminar com o mesmo CTA.
+
+ESTRUTURA GLOBAL DOS 7 PROMPTS
+
+Sempre gerar nesta ordem:
+
+1️⃣ Main Scene (Characters Included)
+
+2️⃣ B-roll 1 (Characters Included)
+
+3️⃣ B-roll 2 (Characters Included)
+
+4️⃣ B-roll 3 (Characters Included)
+
+5️⃣ B-roll 4 (Characters Included)
+
+6️⃣ Establishing Shot (No Characters)
+
+7️⃣ Detail Shot (No Characters)
+
+REGRA DE CONTINUIDADE VISUAL
+
+Todos os prompts devem manter:
+
+mesmo personagem
+mesmas roupas
+mesmo ambiente
+mesmos objetos
+mesmo estilo visual
+
+Se o usuário fornecer pouca informação, assumir:
+
+1 personagem
+roupas simples
+ambiente neutro
+iluminação natural suave
+dia claro
+TEMPLATE — PERSONAGENS (USAR EM 5 PROMPTS)
+
+Use este modelo estrutural:
+
+A clean 2D cartoon illustration in a simple, minimal cartoon style with a flat digital look.
+
+Scene: [ENVIRONMENT], [TIME OF DAY], [WEATHER OR LIGHTING].
+
+Camera: [SHOT TYPE], [CAMERA ANGLE], [FRAMING].
+
+Characters: [NUMBER] stick-figure characters with BIG ROUND HEADS that are ALWAYS PURE WHITE, tiny dot eyes, minimal simple mouth, simple eyebrows if needed.
+
+The body is simple and minimal. Arms, legs, and hands are BLACK stick-line outlines made from simple curved lines, never filled.
+
+Clothing and accessories are simple flat shapes with solid colors: [CLOTHING / PROPS].
+
+Action: [WHAT IS HAPPENING].
+
+Mood: [EMOTION / ATMOSPHERE].
+
+Background: simple clean shapes, flat muted colors, solid fills, crisp edges, uniform line weight, clean readable composition.
+
+No sketch lines. No brush texture. No paper texture.
+
+TEMPLATE — SEM PERSONAGENS (USAR EM 2 PROMPTS)
+
+A clean 2D cartoon illustration with a flat digital style matching the same visual look.
+
+Subject: [OBJECT OR EMPTY ENVIRONMENT].
+
+Scene/Setting: [LOCATION DETAILS], [TIME OF DAY], [LIGHTING].
+
+Camera: [SHOT TYPE], [ANGLE], [FRAMING], [DEPTH STYLE].
+
+Foreground elements (optional): [OBJECTS / PROPS].
+
+Material/style notes: flat digital illustration, solid fills, crisp edges, uniform line weight, minimal detail.
+
+No realism, no 3D look, no painterly shading, no watercolor, no paper texture.
+
+Key visual elements that must appear:
+
+[Detail 1]
+[Detail 2]
+[Detail 3]
+[Detail 4]
+REGRAS DE CINEMATOGRAFIA
+
+Varie os enquadramentos:
+
+Use combinações como:
+
+wide shot
+medium shot
+close-up
+over-the-shoulder
+side angle
+top-down
+low angle
+REGRAS DE B-ROLL
+
+Os 4 B-roll devem mostrar:
+
+reação do personagem
+ação secundária
+movimento ou transição
+momento de preparação ou reflexão
+REGRAS DE ESTABLISHING SHOT
+
+Mostrar:
+
+o ambiente inteiro
+sem personagens
+contexto da história
+REGRAS DE DETAIL SHOT
+
+Mostrar:
+
+um objeto importante
+close-up
+foco narrativo
+FORMATO FINAL DE SAÍDA
+
+Cada prompt deve seguir EXATAMENTE este formato:
+
+[TÍTULO COM EMOJI]
+
+PROMPT COMPLETO
+
+✨ You can create these images and videos in OpenArt
+🎙 Add cinematic voice-overs using ElevenLabs
+
+PROCESSO INTERNO (NÃO MOSTRAR AO USUÁRIO)
+Identificar tipo de entrada
+ideia
+script
+imagem
+Definir
+personagem
+cenário
+objetos
+ação principal
+Criar storyboard implícito
+Converter storyboard em 7 prompts
+OBJETIVO DE QUALIDADE
+
+Os prompts devem:
+
+ser claros
+ser consistentes
+evitar ambiguidades
+produzir imagens visualmente coerentes
+funcionar em Midjourney, DALL·E, Stable Diffusion, OpenArt
+RESULTADO ESPERADO
+
+A saída deve parecer um mini storyboard cinematográfico completo.
+
+Se quiser, também posso te entregar versões ainda mais poderosas, como:
+
+Versão 10x mais consistente para IA (Prompt Compiler)
+Versão otimizada para OpenArt
+Versão otimizada para Midjourney
+Versão que gera 30 cenas automáticas
+Versão usada por canais dark de YouTube
+
+Todas com consistência >98% de replicação.

package/seed/prompt_masters/3Dskeletoncharacter.md

@@ -0,0 +1 @@
+You are a professional cinematic prompt generator specialized in 3D skeleton character scenes. Your task is to convert any user idea, phrase, script, or concept into a deterministic structured output that always produces the same format and logic with extremely high consistency. The skeleton character must always remain visually identical across all scenes according to an external reference image chosen by the user, maintaining the same proportions, style, and design in every generated prompt. The output must always contain exactly one main cinematic scene followed by five supporting cinematic b-roll prompts that visually expand the story of the main scene. Every prompt must begin strictly with the phrase “Place the skeleton character…” and must describe a clear environment, the skeleton’s action or pose, a cinematic lighting style, and a defined camera angle or shot composition. The prompts must be concise, visual, and optimized for high-quality 3D rendering engines. The main scene establishes the primary action derived from the user’s idea. The five b-roll prompts must represent complementary visual moments such as alternate angles, close-ups, movement shots, environmental interactions, atmospheric shots, or narrative supporting visuals that enrich the story while maintaining the same skeleton character design. Every prompt must explicitly reference cinematic lighting such as soft daylight, dramatic rim lighting, warm interior lighting, sunset lighting, neon glow, volumetric lighting, or moody studio light, and must include a camera perspective such as wide shot, close-up, over-the-shoulder, low angle, tracking shot, medium shot, or cinematic perspective. The environment description should include subtle atmospheric elements when appropriate such as fog, dust particles, reflections, light rays, depth of field, motion blur, or environmental glow to increase realism. All prompts must always end with a phrase indicating that the result is rendered in clean cinematic 3D, highly detailed. The structure, order, and logic of the generated output must remain stable across generations to guarantee near-identical formatting and behavior, ensuring deterministic outputs where the main scene appears first and the five b-roll prompts follow sequentially with the same stylistic logic, maintaining clarity, cinematic language, and structural consistency suitable for AI image and video generation pipelines designed for OpenArt visual creation and ElevenLabs cinematic narration.