@danhachuel/thunderbolt 0.3.56 → 0.3.57

package/MANUAL-INSTALACAO.md

@@ -2,7 +2,7 @@
 
 Este manual descreve a instalação local da UI Thunderbolt, baseada no MoneyPrinterTurbo, utilizando o pacote npm `@danhachuel/thunderbolt`. O fluxo recomendado instala automaticamente o ambiente Python, as dependências da aplicação, as dependências do MoneyPrinterTurbo, o Streamlit e o suporte FFmpeg através de `imageio-ffmpeg`.
 
-> **Versão deste manual:** 0.3.56
+> **Versão deste manual:** 0.3.57
 > **Pacote npm:** `@danhachuel/thunderbolt`
 > **Porta padrão da UI:** `localhost:3030`  
 > **Repositório:** [github.com/DanHachuel/thunderbolt](https://github.com/DanHachuel/thunderbolt)
@@ -114,13 +114,13 @@ Execute:
 Windows PowerShell ou MobaXterm:
 
 ```powershell
-npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.56 install
+npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.57 install
 ```
 
 Linux/macOS:
 
 ```bash
-npx --yes --prefer-online @danhachuel/thunderbolt@0.3.56 install
+npx --yes --prefer-online @danhachuel/thunderbolt@0.3.57 install
 ```
 
 A instalação normal é **segura para actualizações**: preserva `storage`, Blueprints, Brandings, configurações e artefactos do utilizador. Remove apenas `.venv`, o clone técnico do MoneyPrinterTurbo e dependências que serão recriadas. Uma pasta antiga sem dados do utilizador, como `C:\Users\<utilizador>\AppData\Local\hermes` da tentativa incompleta, pode ser removida; uma pasta antiga que contenha Blueprints, Brandings ou storage é preservada e apenas avisada no terminal. Feche processos Python, Node, Streamlit e MobaXterm que estejam a usar as pastas antes de executar.
@@ -128,7 +128,7 @@ A instalação normal é **segura para actualizações**: preserva `storage`, Bl
 Se quiser apagar absolutamente tudo de forma intencional, use o comando destrutivo separado:
 
 ```powershell
-npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.56 install --purge-data
+npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.57 install --purge-data
 ```
 
 O parâmetro `--purge-data` apaga Blueprints, Brandings, configurações, storage e artefactos locais. Não o use numa actualização normal.
@@ -453,7 +453,7 @@ Se o launcher ou o worker for encerrado abruptamente, uma tarefa `doing` sem act
 
 O **Backlog Vídeos** e a lista **Automação > Automação Youtube > Vídeos cadastrados** usam o mesmo catálogo completo de `storage/state/tasks.json`. Por isso, tarefas criadas manualmente e tarefas criadas pelo worker diário aparecem nos dois locais, sem filtragem implícita por origem. O filtro do Backlog mostra os estados conhecidos e inclui automaticamente estados adicionais encontrados nos dados.
 
-Nos dois cards, o bloco de estado apresenta o valor técnico, o rótulo legível, a barra de progresso e a mensagem de erro quando existir. O bloco **Formato** resolve nesta ordem `format`, `style_wide`, `style` e, por fim, `wide`, mantendo a apresentação de formatos como `wide`, `shorts`, `music` ou `full_ia` mesmo em tarefas antigas.
+Nos dois cards, o bloco de estado apresenta o valor técnico, o rótulo legível, a barra de progresso e a mensagem de erro quando existir. O bloco **Formato** resolve nesta ordem `format`, `style_wide`, `style` e, por fim, `wide`, mantendo a apresentação de formatos como `wide`, `shorts`, `music` ou `full_ia` mesmo em tarefas antigas. Em **Automação Youtube > Vídeos cadastrados**, o botão **Start** retoma a partir dos artefactos persistidos: reutiliza roteiro, título/keywords, vídeo, prompt e thumbnail prontos e só executa novamente uma etapa cujo resultado não exista. O botão **Apagar** remove o card da fila depois de confirmação e preserva os ficheiros de artefactos; uma tarefa em execução deve ser parada antes da remoção.
 
 ### Upload Música — JewelMusic, Pushtunes e ytmusicapi
 
@@ -542,7 +542,7 @@ Ao abrir a página, o Thunderbolt não prepara dados públicos, não descarrega
 
 Os parâmetros da UI são número de clusters entre 2 e 10, suporte mínimo entre 0,01 e 0,50, país, engagement, intervalo de datas e tags, todos dentro da área principal da aba. O núcleo normaliza os dados, calcula engagement, aplica filtros, faz transformação logarítmica e standardização, executa K-Means e calcula itemsets/regras com FP-Growth. Não são apresentados resultados até ao primeiro clique em **Analisar Nichos**; o mesmo botão aplica alterações posteriores aos filtros. Os resultados são DataFrames de clusters, itemsets frequentes, regras de associação e dados analisados; o gráfico de dispersão é criado nativamente com Plotly.
 
-As dependências adicionais — `scikit-learn`, `mlxtend`, `plotly`, `seaborn`, `matplotlib` e `kagglehub` — são instaladas pelo procedimento normal de `npx`. Em instalações existentes, execute novamente `npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.56 install`; o instalador detecta e reutiliza o que já estiver válido.
+As dependências adicionais — `scikit-learn`, `mlxtend`, `plotly`, `seaborn`, `matplotlib` e `kagglehub` — são instaladas pelo procedimento normal de `npx`. Em instalações existentes, execute novamente `npx.cmd --yes --prefer-online @danhachuel/thunderbolt@0.3.57 install`; o instalador detecta e reutiliza o que já estiver válido.
 
 ### Niche Finder Apify
 
@@ -580,7 +580,7 @@ O modo `Pexels/Pixabay` representa materiais de stock. Ao seleccionar `full_ia`,
 
 A aba **Roteiros**, colocada entre **Criação de Músicas** e **Upload**, permite seleccionar um canal opcional, um Blueprint, **Roteiro de vídeo** ou **Letra de música**, idioma, tema e estrutura. O botão **Gerar com IA a partir do Blueprint** usa o provider LLM configurado e devolve um rascunho Markdown editável; o utilizador deve rever e clicar em **Guardar documento no storage**. Os ficheiros são guardados em `storage/scripts/` e o índice em `storage/state/scripts.json`; o caminho absoluto aparece no topo da página. Na subaba **Vídeos** de **Criação de Vídeos**, a aplicação mostra a frase `Os vídeos são guardados em <storage>/videos`, que identifica a pasta local dos vídeos.
 
-A aba **Automação Youtube**, dentro do menu expansível **Automação**, apresenta os cartões no layout compacto de duas linhas: na primeira ficam avatar, nome, handle, toggle **Automação ligada** e horário; na segunda ficam **Idioma Padrão**, **Nicho Padrão**, **Blueprint Padrão**, **Narrador/Voz Padrão** e o botão **Guardar**. Blueprint e Narrador/Voz continuam editáveis no card; Idioma e Nicho são mostrados a partir da configuração guardada no canal. A aba também guarda **Automação ligada** e valida horários diários no formato `HH:MM`. Os valores ficam sincronizados com o editor existente no cartão da aba **Canais Youtube** e são copiados para novas tarefas. O launcher inicia o worker local, que consulta o relógio do computador, gera um briefing, título e pacote de thumbnail específicos com o provider LLM configurado, cria o lote agendado na fila e evita duplicar o mesmo canal no mesmo dia. Se a geração não puder ser executada, o erro fica registado e o placeholder antigo não é usado.
+A aba **Automação Youtube**, dentro do menu expansível **Automação**, apresenta os cartões no layout compacto de duas linhas: na primeira ficam avatar, nome, handle, toggle **Automação ligada** e horário; na segunda ficam **Idioma Padrão**, **Nicho Padrão**, **Blueprint Padrão**, **Narrador/Voz Padrão** e o botão **Guardar**. Blueprint e Narrador/Voz continuam editáveis no card; Idioma e Nicho são mostrados a partir da configuração guardada no canal. A aba também guarda **Automação ligada** e valida horários diários no formato `HH:MM`. Os valores ficam sincronizados com o editor existente no cartão da aba **Canais Youtube** e são copiados para novas tarefas. O launcher inicia o worker local, que consulta o relógio do computador, gera um briefing, título e pacote de thumbnail específicos com o provider LLM configurado, cria o lote agendado na fila e evita duplicar o mesmo canal no mesmo dia. Se a geração não puder ser executada, o erro fica registado e o placeholder antigo não é usado. Ao iniciar um vídeo cadastrado, o worker retoma o ponto persistido sem regenerar as etapas concluídas; se um roteiro não estiver guardado, ele é criado antes de continuar. O card inclui **Start**, **Stop** e **Apagar**, sendo a remoção protegida por confirmação.
 
 A área **Teste de vozes**, dentro de **Configurações > Configuração API**, é isolada da pipeline. O preview pode ser reproduzido e descarregado de `storage/voice_previews/`. Caminhos vazios, directórios, ficheiros vazios e previews sem permissões de leitura são ignorados com uma mensagem clara, sem traceback. Se uma instalação antiga mostrar que `edge-tts` está em falta, execute `npx.cmd --yes @danhachuel/thunderbolt install`; o detector reinstala apenas a dependência ausente.
 

package/README.md

@@ -79,7 +79,7 @@ No topo da área principal da aplicação existe o menu nativo de idioma no padr
 
 A UI suporta os temas **Dark** e **Light** através do menu nativo de três pontos do Streamlit, no local original do toolbar. Não existe um selector Theme adicional dentro da página. A configuração distribuída em `.streamlit/config.toml` disponibiliza as variantes nomeadas **Dark** e **Light**, e o menu nativo continua responsável por alternar entre os modos, seguindo o padrão do [MoneyPrinterTurbo](https://github.com/harry0703/MoneyPrinterTurbo). O CSS próprio do Thunderbolt usa cores semânticas, `currentColor` e `color-mix` para acompanhar o tema activo, sem alterar a posição nem a funcionalidade do toolbar, do botão Deploy e do menu principal.
 
-## Navegação da UI 0.3.56
+## Navegação da UI 0.3.57
 
 A barra lateral mantém os níveis principais, nesta ordem: **Início**, **Niche Finder**, **Pipeline**, **Pipeline TikTok**, **Automação**, **Edição**, **AI Influencers** e **Configurações**. **Pipeline Vídeos** é expansível e contém **Criação de Vídeos**, **Backlog Vídeos**, **Roteiros**, **Thumbnails** e **Upload**. **Pipeline Música** é expansível e contém **Criação de Músicas** e **Upload Música**. **Automação** também é expansível e contém **Automação Youtube**. **Edição** é expansível e contém **Limpador de Metadados**, **Cortes**, **Editor Python** e **Download Mídia**, nessa ordem. **AI Influencers** é expansível e contém **Personagens**, **Geração de Conteúdo IA**, **Redes Sociais**, **Tutorial Meta** e **Tutorial Supabase**, nessa ordem. A página Geração de Conteúdo IA divide-se em **Imagens**, **Vídeos** e **Motion Control**; a subaba Motion Control permanece vazia nesta release.
  **Niche Finder** é expansível e contém **Niche Finder Kaggle** e **Niche Finder Apify**. **Configurações** é expansível e contém **Canais Youtube**, **Blueprints Youtube**, **MCP**, **Contas Google**, **Notificações**, **Logs** e **Configuração API**, nessa ordem. O Início reúne o dashboard e as filas do Pipeline, sem botões de acções rápidas.
@@ -118,6 +118,8 @@ A página **Edição > Download Mídia** utiliza a API Python do [yt-dlp](https:
 
 Os dois cards mostram de forma consistente o estado técnico, o rótulo legível, a barra de progresso, a etapa e o formato do vídeo. São suportados estados como `to_do`, `doing`, `blocked`, `done`, `failed` e `cancelled`; formatos ausentes usam `format`, `style_wide` ou `wide` como fallback. Quando existe `artifacts.video`, o Backlog mostra que o vídeo está pronto e disponibiliza a descarga do MP4 mesmo que a thumbnail esteja pendente.
 
+Em **Automação Youtube > Vídeos cadastrados**, o botão **Start** retoma a tarefa a partir dos artefactos persistidos. O worker reutiliza o roteiro, título/keywords, MP4, prompt de thumbnail e imagem já existentes; só volta a gerar uma etapa quando o respectivo resultado não está disponível, e repete o upload apenas quando ele ainda não foi concluído. O botão **Apagar** remove o vídeo da fila e de `tasks.json` após confirmação, preservando os ficheiros de artefactos; tarefas em execução devem ser paradas antes de serem removidas.
+
 ## Canais Youtube — edição por cartão e vídeos recentes
 
 A página **Canais Youtube** mantém o cadastro e a importação existentes, mas cada cartão agora tem o botão **Editar**. O editor permite alterar nome, URL, handle, idioma, estilo wide, **Nicho**, **Blueprint Padrão**, **Narrador/Voz Padrão**, conta Google do Upload directo, descrição e Automação ON/horário. O nicho aparece imediatamente abaixo do nome do canal no cartão; quando não existe, a UI mostra **SEM NICHO CONFIGURADO**.
@@ -356,7 +358,7 @@ A subaba **Roteiros**, entre **Criação de Músicas** e **Upload**, permite esc
 
 Na subaba **Vídeos** de **Criação de Vídeos**, a frase `Os vídeos são guardados em <storage>/videos` identifica a pasta real onde os artefactos de vídeo devem ser procurados.
 
-O agente musical guarda os ficheiros em `storage/music/`, aceita formatos de áudio comuns e pode descarregar uma URL de áudio devolvida por um endpoint Suno compatível. Em **Canais Youtube**, abra **Definir Blueprint e voz padrão** no cartão do canal para guardar os defaults; em **Automação Youtube**, os mesmos dois selectores aparecem no cartão e são sincronizados. Esses valores são usados automaticamente em novas tarefas criadas para o canal. A aba **Automação Youtube** também guarda `Automação ON` e um horário diário `HH:MM` por canal e lista os vídeos cadastrados; por definição, esta entrega não executa workers de fundo.
+O agente musical guarda os ficheiros em `storage/music/`, aceita formatos de áudio comuns e pode descarregar uma URL de áudio devolvida por um endpoint Suno compatível. Em **Canais Youtube**, abra **Definir Blueprint e voz padrão** no cartão do canal para guardar os defaults; em **Automação Youtube**, os mesmos dois selectores aparecem no cartão e são sincronizados. Esses valores são usados automaticamente em novas tarefas criadas para o canal. A aba **Automação Youtube** também guarda `Automação ON` e um horário diário `HH:MM` por canal e lista os vídeos cadastrados. Nos cards, **Start** retoma o processamento sem regenerar etapas já prontas, enquanto **Apagar** remove o card da fila após confirmação e preserva os artefactos locais. O worker continua a ser executado pelo processo local configurado.
 
 ## Teste de vozes
 

package/app/main.py

@@ -22,7 +22,7 @@ try:
 except (OSError, json.JSONDecodeError):
     APP_VERSION = ""
 
-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.domain import STAGES, create_batch, create_channel, create_tasks_for_batch, delete_channel, delete_task, pipeline_summary, set_channel_defaults, transition_task, update_channel, update_channel_video
 from hermes_ui.drafts import list_drafts, save_draft
 from hermes_ui.automation_worker import load_worker_status
 from hermes_ui.pipeline_worker import load_pipeline_worker_status, recover_stale_tasks, STALE_TASK_SECONDS, WORKER_HEARTBEAT_TIMEOUT_SECONDS
@@ -3887,6 +3887,7 @@ def render_automation():
 
     st.divider()
     st.subheader("Vídeos cadastrados")
+    st.caption("Start retoma as etapas já concluídas e só gera novamente o que ainda não estiver pronto. Apagar remove o card da fila após confirmação e preserva os artefactos locais.")
     tasks = load_video_tasks_for_catalog()
     if not tasks:
         st.info("Ainda não existem vídeos cadastrados.")
@@ -3903,7 +3904,7 @@ def render_automation():
                 st.write(_video_task_format(task))
             with task_cols[3]:
                 state = str(task.get("state") or "")
-                start_col, stop_col = st.columns(2)
+                start_col, stop_col, delete_col = st.columns(3)
                 with start_col:
                     if st.button("Start", key=f"automation_start_{task['id']}", use_container_width=True, disabled=state not in {"to_do", "blocked", "failed"}):
                         transition_task(task["id"], "doing")
@@ -3912,6 +3913,26 @@ def render_automation():
                     if st.button("Stop", key=f"automation_stop_{task['id']}", use_container_width=True, disabled=state != "doing"):
                         transition_task(task["id"], "blocked")
                         st.rerun()
+                with delete_col:
+                    confirm_delete_key = f"automation_confirm_delete_{task['id']}"
+                    if st.button("Apagar", key=f"automation_delete_{task['id']}", use_container_width=True, disabled=state == "doing"):
+                        st.session_state[confirm_delete_key] = True
+                        st.rerun()
+                    if st.session_state.get(confirm_delete_key):
+                        st.warning("Remover este vídeo da fila? Os ficheiros de artefactos serão preservados.")
+                        confirm_col, cancel_col = st.columns(2)
+                        with confirm_col:
+                            if st.button("Confirmar", key=f"automation_confirm_delete_button_{task['id']}", use_container_width=True, type="primary"):
+                                try:
+                                    delete_task(task["id"])
+                                    st.session_state.pop(confirm_delete_key, None)
+                                    st.rerun()
+                                except ValueError as exc:
+                                    st.error(str(exc))
+                        with cancel_col:
+                            if st.button("Cancelar", key=f"automation_cancel_delete_{task['id']}", use_container_width=True):
+                                st.session_state.pop(confirm_delete_key, None)
+                                st.rerun()
 
 
 def render_upload_direct():

package/hermes_ui/domain.py

@@ -259,6 +259,29 @@ def update_task(task_id: str, updates: dict[str, Any]) -> dict[str, Any] | None:
     return None
 
 
+def delete_task(task_id: str) -> dict[str, Any] | None:
+    """Remove uma tarefa de vídeo da fila sem apagar os ficheiros dos artefactos."""
+    normalized_id = str(task_id or "").strip()
+    if not normalized_id:
+        return None
+    tasks = read_json("tasks.json", [])
+    if not isinstance(tasks, list):
+        return None
+    removed = next((task for task in tasks if isinstance(task, dict) and str(task.get("id") or "") == normalized_id), None)
+    if removed is None:
+        return None
+    if str(removed.get("state") or "") == "doing":
+        raise ValueError("Pare a tarefa antes de a remover da fila.")
+    write_json("tasks.json", [task for task in tasks if not (isinstance(task, dict) and str(task.get("id") or "") == normalized_id)])
+    queues = read_json("queues.json", {})
+    if isinstance(queues, dict):
+        for queue_name, queue_items in list(queues.items()):
+            if isinstance(queue_items, list):
+                queues[queue_name] = [item for item in queue_items if str(item) != normalized_id]
+        write_json("queues.json", queues)
+    return removed
+
+
 def transition_task(task_id: str, state: str | None = None, stage: str | None = None, error: str | None = None) -> dict[str, Any] | None:
     if state and state not in VALID_STATES:
         raise ValueError(f"Estado inválido: {state}")

package/hermes_ui/pipeline_worker.py

@@ -459,6 +459,58 @@ def _run_video_helper(task: dict[str, Any]) -> Path:
     return video_path
 
 
+def _read_persisted_script(task: dict[str, Any], channel: dict[str, Any], blueprint: dict[str, Any], topic: str) -> dict[str, Any] | None:
+    """Load a previously saved script so retries do not regenerate it."""
+    artifacts = task.get("artifacts") if isinstance(task.get("artifacts"), dict) else {}
+    script_path = Path(str(artifacts.get("script") or "")).expanduser()
+    if not script_path.is_file() or script_path.stat().st_size <= 0:
+        return None
+    try:
+        raw = script_path.read_text(encoding="utf-8").strip()
+    except OSError:
+        return None
+    if not raw:
+        return None
+    content = raw
+    if raw.startswith("---"):
+        parts = raw.split("---", 2)
+        if len(parts) == 3:
+            content = parts[2].strip()
+            if content.startswith(">"):
+                content = "\n".join(line[1:].lstrip() if line.startswith(">") else line for line in content.splitlines()).strip()
+    return {
+        "document_type": "video_script",
+        "title": str(task.get("title") or topic),
+        "summary": topic,
+        "content": content,
+        "language": str(task.get("language") or channel.get("language") or "Português"),
+        "blueprint_id": str(blueprint.get("id") or ""),
+        "blueprint_name": str(blueprint.get("name") or "SEM BLUEPRINT CONFIGURADO"),
+        "channel_id": str(channel.get("id") or ""),
+        "channel_name": str(channel.get("name") or "Canal sem nome"),
+        "generated_by": "persisted_pipeline_artifact",
+    }
+
+
+def _valid_artifact_path(value: Any) -> Path | None:
+    path = Path(str(value or "")).expanduser()
+    try:
+        return path if path.is_file() and path.stat().st_size > 0 else None
+    except OSError:
+        return None
+
+
+def _read_json_artifact(value: Any) -> dict[str, Any] | None:
+    path = _valid_artifact_path(value)
+    if path is None:
+        return None
+    try:
+        payload = json.loads(path.read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError):
+        return None
+    return payload if isinstance(payload, dict) else None
+
+
 def _run_task(task: dict[str, Any]) -> dict[str, Any]:
     task_id = str(task.get("id") or "")
     channel = _channel_for_task(task)
@@ -473,116 +525,130 @@ def _run_task(task: dict[str, Any]) -> dict[str, Any]:
             raise PipelineError("A IA não devolveu um tema válido.")
         _update(task_id, topic=topic, topic_source="llm", ai_generation={"topic": topic_result}, progress=12)
 
-    _update(task_id, stage="script", state="doing", progress=18, error=None)
     generation_settings = task.get("generation_settings") if isinstance(task.get("generation_settings"), dict) else {}
-    provided_script = str(generation_settings.get("video_script") or "").strip()
-    if provided_script:
-        script = {
-            "document_type": "video_script",
-            "title": str(task.get("title") or topic),
-            "summary": topic,
-            "content": provided_script,
-            "language": str(task.get("language") or channel.get("language") or "Português"),
-            "blueprint_id": str(blueprint.get("id") or ""),
-            "blueprint_name": str(blueprint.get("name") or "SEM BLUEPRINT CONFIGURADO"),
-            "channel_id": str(channel.get("id") or ""),
-            "channel_name": str(channel.get("name") or "Canal sem nome"),
-            "generation_settings": generation_settings,
-            "generated_by": "video_creation_form",
-        }
-    else:
-        script = generate_script_document(
-            settings,
-            document_type="Roteiro de vídeo",
-            title=str(task.get("title") or topic),
-            brief=topic,
-            language=str(task.get("language") or channel.get("language") or "Português"),
-            channel=channel,
-            blueprint=blueprint,
-            structure_notes=str(generation_settings.get("script_structure_notes") or ""),
-            generation_settings=generation_settings,
-        )
-    script_record = save_script_document(script)
     artifacts = dict(task.get("artifacts") or {})
-    artifacts["script"] = script_record.get("path", "")
-    _update(task_id, artifacts=artifacts, progress=30)
+    script = _read_persisted_script(task, channel, blueprint, topic)
+    if script is None:
+        _update(task_id, stage="script", state="doing", progress=18, error=None)
+        provided_script = str(generation_settings.get("video_script") or "").strip()
+        if provided_script:
+            script = {
+                "document_type": "video_script",
+                "title": str(task.get("title") or topic),
+                "summary": topic,
+                "content": provided_script,
+                "language": str(task.get("language") or channel.get("language") or "Português"),
+                "blueprint_id": str(blueprint.get("id") or ""),
+                "blueprint_name": str(blueprint.get("name") or "SEM BLUEPRINT CONFIGURADO"),
+                "channel_id": str(channel.get("id") or ""),
+                "channel_name": str(channel.get("name") or "Canal sem nome"),
+                "generation_settings": generation_settings,
+                "generated_by": "video_creation_form",
+            }
+        else:
+            script = generate_script_document(
+                settings,
+                document_type="Roteiro de vídeo",
+                title=str(task.get("title") or topic),
+                brief=topic,
+                language=str(task.get("language") or channel.get("language") or "Português"),
+                channel=channel,
+                blueprint=blueprint,
+                structure_notes=str(generation_settings.get("script_structure_notes") or ""),
+                generation_settings=generation_settings,
+            )
+        script_record = save_script_document(script)
+        artifacts["script"] = script_record.get("path", "")
+        _update(task_id, artifacts=artifacts, progress=max(30, int(task.get("progress") or 0)))
+    else:
+        _update(task_id, artifacts=artifacts, error=None, progress=max(30, int(task.get("progress") or 0)))
 
-    _update(task_id, stage="title", state="doing", progress=35)
-    provided_title = str(task.get("title") or "").strip()
-    provided_keywords = generation_settings.get("video_keywords") or task.get("keywords")
+    title = str(task.get("title") or "").strip()
+    provided_keywords = generation_settings.get("video_keywords") or task.get("keywords") or task.get("tags")
     if isinstance(provided_keywords, str):
         provided_keywords = re.split(r"[,\n;|]+", provided_keywords)
-    provided_keywords = [str(item).strip() for item in provided_keywords or [] if str(item).strip()]
+    keywords = [str(item).strip() for item in provided_keywords or [] if str(item).strip()][:15]
     title_candidates = task.get("title_candidates") if isinstance(task.get("title_candidates"), list) else []
-    editorial: dict[str, Any] = {
-        "title": provided_title or topic,
-        "title_candidates": title_candidates,
-        "keywords": provided_keywords,
-    }
-    if not provided_title:
-        try:
-            editorial = generate_title_and_keywords(
-                settings,
-                channel,
-                topic,
-                blueprint,
-                language=str(task.get("language") or channel.get("language") or "Português"),
-            )
-        except CreativeGenerationError:
-            # A falha editorial não deve impedir a geração do vídeo: usa o tema
-            # como título e keywords determinísticas, deixando o erro de imagem
-            # para a etapa posterior e independente da criação do MP4.
-            editorial = {"title": topic, "title_candidates": [], "keywords": []}
-    title = str(editorial.get("title") or provided_title or topic).strip()
-    keywords = provided_keywords[:15] or (
-        editorial.get("keywords") if isinstance(editorial.get("keywords"), list) else []
-    )
-    keywords = [str(item).strip() for item in keywords if str(item).strip()][:15] or _keywords(
-        topic,
-        title,
-        str(channel.get("niche") or ""),
-    )
-    title_candidates = editorial.get("title_candidates") if isinstance(editorial.get("title_candidates"), list) else title_candidates
-    title_artifact = _save_json_artifact(
-        task_id,
-        "title-keywords",
-        {"topic": topic, "title": title, "keywords": keywords, "title_candidates": title_candidates},
-    )
-    artifacts = {**artifacts, "title_keywords": title_artifact}
-    _update(task_id, title=title, tags=keywords, artifacts=artifacts, title_candidates=title_candidates, progress=45)
+    if not title or not keywords:
+        _update(task_id, stage="title", state="doing", progress=max(35, int(task.get("progress") or 0)), error=None)
+        editorial: dict[str, Any] = {
+            "title": title or topic,
+            "title_candidates": title_candidates,
+            "keywords": keywords,
+        }
+        if not title:
+            try:
+                editorial = generate_title_and_keywords(
+                    settings,
+                    channel,
+                    topic,
+                    blueprint,
+                    language=str(task.get("language") or channel.get("language") or "Português"),
+                )
+            except CreativeGenerationError:
+                # A falha editorial não deve impedir a geração do vídeo: usa o tema
+                # como título e keywords determinísticas, deixando o erro de imagem
+                # para a etapa posterior e independente da criação do MP4.
+                editorial = {"title": topic, "title_candidates": [], "keywords": []}
+        title = str(editorial.get("title") or title or topic).strip()
+        keywords = keywords or (
+            editorial.get("keywords") if isinstance(editorial.get("keywords"), list) else []
+        )
+        keywords = [str(item).strip() for item in keywords if str(item).strip()][:15] or _keywords(
+            topic,
+            title,
+            str(channel.get("niche") or ""),
+        )
+        title_candidates = editorial.get("title_candidates") if isinstance(editorial.get("title_candidates"), list) else title_candidates
+        title_artifact = _save_json_artifact(
+            task_id,
+            "title-keywords",
+            {"topic": topic, "title": title, "keywords": keywords, "title_candidates": title_candidates},
+        )
+        artifacts["title_keywords"] = title_artifact
+        _update(task_id, title=title, tags=keywords, artifacts=artifacts, title_candidates=title_candidates, progress=max(45, int(task.get("progress") or 0)))
+    else:
+        _update(task_id, title=title, tags=keywords, artifacts=artifacts, title_candidates=title_candidates, error=None, progress=max(50, int(task.get("progress") or 0)))
 
-    _update(task_id, stage="keywords", state="doing", progress=48)
-    _update(task_id, tags=keywords, progress=50)
+    _update(task_id, stage="keywords", state="doing", progress=max(50, int(task.get("progress") or 0)), error=None)
+    _update(task_id, tags=keywords, progress=max(50, int(task.get("progress") or 0)))
 
     # O vídeo é deliberadamente concluído antes de qualquer chamada ao provider
     # de imagem. O artefacto fica persistido mesmo que a quota da thumbnail falhe.
-    _update(task_id, stage="video", state="doing", progress=52, error=None)
-    video_cards = media_cards_for_pool(settings, "video")
-    if bool(settings.get("media_video_pool_enabled")) and video_cards:
-        try:
-            video_prompt = _append_generation_constraints(
-                f"Título: {title}\n\nRoteiro:\n{str(script.get('content') or '')[:12000]}",
-                kind="video",
-            )
-            video_path = generate_video_from_pool(settings, video_prompt)
-        except MediaGenerationError as exc:
-            raise PipelineError(f"Pool de vídeo externo: {exc}") from exc
+    existing_video = _valid_artifact_path(artifacts.get("video"))
+    if existing_video is None:
+        _update(task_id, stage="video", state="doing", progress=max(52, int(task.get("progress") or 0)), error=None)
+        video_cards = media_cards_for_pool(settings, "video")
+        if bool(settings.get("media_video_pool_enabled")) and video_cards:
+            try:
+                video_prompt = _append_generation_constraints(
+                    f"Título: {title}\n\nRoteiro:\n{str(script.get('content') or '')[:12000]}",
+                    kind="video",
+                )
+                video_path = generate_video_from_pool(settings, video_prompt)
+            except MediaGenerationError as exc:
+                raise PipelineError(f"Pool de vídeo externo: {exc}") from exc
+        else:
+            video_path = _run_video_helper({**task, "topic": topic, "title": title})
+        current_after_video = _task_by_id(task_id) or {}
+        artifacts = dict(current_after_video.get("artifacts") or artifacts)
+        artifacts["video"] = str(video_path)
+        _update(task_id, artifacts=artifacts, video_ready=True, progress=max(80, int(task.get("progress") or 0)))
     else:
-        video_path = _run_video_helper({**task, "topic": topic, "title": title})
-    current_after_video = _task_by_id(task_id) or {}
-    artifacts = dict(current_after_video.get("artifacts") or artifacts)
-    artifacts["video"] = str(video_path)
-    _update(task_id, artifacts=artifacts, video_ready=True, progress=80)
+        video_path = existing_video
+        artifacts["video"] = str(existing_video)
+        _update(task_id, stage="video", state="doing", artifacts=artifacts, video_ready=True, error=None, progress=max(80, int(task.get("progress") or 0)))
 
-    _update(task_id, stage="thumbnail_prompt", state="doing", progress=82, error=None)
+    persisted_prompt = _read_json_artifact(artifacts.get("thumbnail_prompt_json"))
+    persisted_variant = persisted_prompt.get("thumbnail") if isinstance(persisted_prompt, dict) and isinstance(persisted_prompt.get("thumbnail"), dict) else {}
     existing_variant = task.get("thumbnail_variant") if isinstance(task.get("thumbnail_variant"), dict) else {}
-    existing_variant = dict(existing_variant)
-    if not str(existing_variant.get("image_prompt") or "").strip() and str(task.get("thumbnail_prompt") or "").strip():
-        existing_variant["image_prompt"] = str(task.get("thumbnail_prompt") or "").strip()
-    if not str(existing_variant.get("overlay_text") or "").strip() and str(task.get("thumbnail_text") or "").strip():
-        existing_variant["overlay_text"] = str(task.get("thumbnail_text") or "").strip()
-    variant = existing_variant
+    variant = {**persisted_variant, **dict(existing_variant)}
+    if not str(variant.get("image_prompt") or "").strip() and str(task.get("thumbnail_prompt") or "").strip():
+        variant["image_prompt"] = str(task.get("thumbnail_prompt") or "").strip()
+    if not str(variant.get("overlay_text") or "").strip() and str(task.get("thumbnail_text") or "").strip():
+        variant["overlay_text"] = str(task.get("thumbnail_text") or "").strip()
     if not str(variant.get("image_prompt") or "").strip():
+        _update(task_id, stage="thumbnail_prompt", state="doing", progress=max(82, int(task.get("progress") or 0)), error=None)
         try:
             variant = generate_thumbnail_prompt(
                 settings,
@@ -608,24 +674,25 @@ def _run_task(task: dict[str, Any]) -> dict[str, Any]:
             "lettering_prompt": str(variant.get("lettering_prompt") or ""),
         },
     }
-    prompt_artifact = _save_json_artifact(task_id, "thumbnail-prompt", prompt_payload)
-    artifacts["thumbnail_prompt_json"] = prompt_artifact
+    if _valid_artifact_path(artifacts.get("thumbnail_prompt_json")) is None:
+        artifacts["thumbnail_prompt_json"] = _save_json_artifact(task_id, "thumbnail-prompt", prompt_payload)
     _update(
         task_id,
         stage="thumbnail_prompt",
         state="doing",
-        progress=84,
+        progress=max(84, int(task.get("progress") or 0)),
         thumbnail_variant=variant,
         thumbnail_prompt=str(variant.get("image_prompt") or ""),
         thumbnail_text=str(variant.get("overlay_text") or ""),
         thumbnail_status="prompt_ready",
         artifacts=artifacts,
+        error=None,
     )
 
-    _update(task_id, stage="thumbnail", state="doing", progress=86, error=None)
+    _update(task_id, stage="thumbnail", state="doing", progress=max(86, int(task.get("progress") or 0)), error=None)
     current_artifacts = dict((_task_by_id(task_id) or {}).get("artifacts") or artifacts)
-    existing_thumbnail = Path(str(current_artifacts.get("thumbnail") or variant.get("image_path") or "")).expanduser()
-    if existing_thumbnail.is_file() and existing_thumbnail.stat().st_size > 0:
+    existing_thumbnail = _valid_artifact_path(current_artifacts.get("thumbnail") or variant.get("image_path"))
+    if existing_thumbnail is not None:
         thumbnail_path = existing_thumbnail
     else:
         try:
@@ -641,9 +708,13 @@ def _run_task(task: dict[str, Any]) -> dict[str, Any]:
             raise PipelineError(f"A thumbnail não foi gerada; o vídeo já está disponível em {video_path}: {exc}") from exc
     artifacts = dict((_task_by_id(task_id) or {}).get("artifacts") or current_artifacts)
     artifacts["thumbnail"] = str(thumbnail_path)
-    _update(task_id, artifacts=artifacts, thumbnail_status="generated", progress=90)
+    _update(task_id, artifacts=artifacts, thumbnail_status="generated", progress=max(90, int(task.get("progress") or 0)))
+
+    stored_upload = artifacts.get("upload")
+    if isinstance(stored_upload, dict) and stored_upload:
+        return _update(task_id, stage="upload", state="done", progress=100, artifacts=artifacts, video_ready=True, error=None)
 
-    _update(task_id, stage="upload", state="doing", progress=94, error=None)
+    _update(task_id, stage="upload", state="doing", progress=max(94, int(task.get("progress") or 0)), error=None)
     result = upload_with_default_route(
         settings,
         storage_root=STORAGE,

package/package.json

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