@danhachuel/thunderbolt 0.3.95 → 0.3.97

package/app/main.py

@@ -4,6 +4,7 @@ import hashlib
 import json
 import mimetypes
 import re
+import time
 from contextlib import nullcontext
 from datetime import date, datetime, timezone
 import sys
@@ -22,7 +23,7 @@ try:
 except (OSError, json.JSONDecodeError):
     APP_VERSION = ""
 
-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.domain import STAGES, create_batch, create_channel, create_tasks_for_batch, delete_channel, delete_task, pipeline_summary, retry_task_with_current_settings, 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
@@ -49,6 +50,7 @@ from hermes_ui.logs import list_logs, logs_to_rows
 from hermes_ui.languages import LANGUAGE_CODES, VIDEO_LANGUAGE_CODES, LANGUAGE_FLAG_DATA_URIS, language_code, language_label, ui_language_menu_label, ui_text, video_language_label, video_language_options
 from hermes_ui.api_key_tests import test_apify_credentials, test_influencer_database, test_innertube_api_key, test_kaggle_credentials, test_material_source_credentials, test_media_provider_card, test_nano_banana_credentials, test_postiz_credentials, test_telegram_credentials, test_tiktok_credentials, test_upload_post_credentials, test_voice_provider
 from hermes_ui.tutorials import tutorial_body, tutorial_caption, tutorial_title
+from hermes_ui.update_manager import check_version, update_to_latest
 
 from hermes_ui.script_documents import list_script_documents, read_script_document, save_script_document, script_storage_path
 from hermes_ui.script_generation import generate_script_document
@@ -1269,6 +1271,48 @@ def render_channel_edit_form(channel: dict, youtube_account_ids: list[str], yout
 
 def render_dashboard():
     ui_language = current_ui_language()
+    update_area, version_area = st.columns([1.45, 4.55])
+    with update_area:
+        st.markdown(
+            """
+            <style>
+            div[data-testid="stButton"] button[kind="primary"] {
+                background: linear-gradient(135deg, #2563eb 0%, #7c3aed 100%);
+                color: #ffffff;
+                border: 1px solid #8b5cf6;
+                font-weight: 700;
+                box-shadow: 0 8px 20px rgba(79, 70, 229, 0.28);
+            }
+            div[data-testid="stButton"] button[kind="primary"]:hover {
+                border-color: #c4b5fd;
+                filter: brightness(1.08);
+            }
+            </style>
+            """,
+            unsafe_allow_html=True,
+        )
+        if st.button("Atualizar Versão", key="home_update_version", use_container_width=True, type="primary", icon=":material/system_update:"):
+            with st.spinner("A instalar a versão mais recente…"):
+                st.session_state["home_update_result"] = update_to_latest(APP_VERSION)
+    with version_area:
+        cache_key = "home_update_version_check"
+        checked_at_key = "home_update_version_checked_at"
+        if not st.session_state.get(cache_key) or time.monotonic() - float(st.session_state.get(checked_at_key, 0)) > 300:
+            st.session_state[cache_key] = check_version(APP_VERSION)
+            st.session_state[checked_at_key] = time.monotonic()
+        version_status = st.session_state[cache_key]
+        if version_status.update_available:
+            st.info(f"Nova versão disponível: {version_status.latest_version}. A versão actual é {APP_VERSION or 'desconhecida'}.")
+        elif version_status.error:
+            st.caption(f"Versão actual: {APP_VERSION or 'desconhecida'} · verificação de actualização indisponível.")
+        else:
+            st.caption(f"Versão actual: {APP_VERSION or 'desconhecida'} · já está actualizada ({version_status.latest_version}).")
+    update_result = st.session_state.get("home_update_result")
+    if update_result is not None:
+        if update_result.ok:
+            st.success(update_result.message)
+        else:
+            st.error(update_result.message)
     st.title("Thunderbolt")
     st.caption(ui_text("Interface local para operação e automação de conteúdo faceless", ui_language))
     summary = pipeline_summary()
@@ -4054,7 +4098,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.")
+    st.caption("Start retoma as etapas já concluídas e só gera novamente o que ainda não estiver pronto. Em tarefas falhadas ou bloqueadas, a nova tentativa lê as chaves, prioridades e configurações actualmente guardadas. 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.")
@@ -4074,7 +4118,10 @@ def render_automation():
                 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")
+                        if state in {"failed", "blocked"}:
+                            retry_task_with_current_settings(task["id"])
+                        else:
+                            transition_task(task["id"], "doing")
                         st.rerun()
                 with stop_col:
                     if st.button("Stop", key=f"automation_stop_{task['id']}", use_container_width=True, disabled=state != "doing"):

package/hermes_ui/domain.py

@@ -328,6 +328,37 @@ def transition_task(task_id: str, state: str | None = None, stage: str | None =
     return None
 
 
+def retry_task_with_current_settings(task_id: str) -> dict[str, Any] | None:
+    """Queue a failed or blocked task without persisting API credentials or provider snapshots.
+
+    The pipeline reloads settings.json immediately before every execution, so a
+    retry always uses the currently saved API keys, active provider priorities,
+    and provider endpoints while retaining the task's completed artefacts.
+    """
+    tasks = read_json("tasks.json", [])
+    for task in tasks:
+        if task.get("id") != task_id:
+            continue
+        previous_state = str(task.get("state") or "")
+        if previous_state not in {"failed", "blocked"}:
+            raise ValueError("Apenas tarefas falhadas ou bloqueadas podem ser retomadas.")
+        try:
+            retry_count = int(task.get("retry_count") or 0)
+        except (TypeError, ValueError):
+            retry_count = 0
+        task["state"] = "to_do"
+        task["error"] = None
+        task["retry_count"] = retry_count + 1
+        task["retry_requested_at"] = now()
+        task["retry_config_source"] = "settings.json_at_execution"
+        for field in ("failure_api", "failure_provider", "failure_service", "failure_config_fields"):
+            task.pop(field, None)
+        task["updated_at"] = now()
+        write_json("tasks.json", tasks)
+        return task
+    return None
+
+
 def pipeline_summary() -> dict[str, Any]:
     tasks = read_json("tasks.json", [])
     channels = read_json("channels.json", [])

package/hermes_ui/update_manager.py

@@ -0,0 +1,108 @@
+"""Verificação e actualização local da versão distribuída pelo NPM.
+
+O módulo não recebe nem manipula credenciais. A instalação só é iniciada após o
+clique explícito do utilizador na interface local.
+"""
+
+from __future__ import annotations
+
+import os
+import subprocess
+from dataclasses import dataclass
+from typing import Any, Callable
+
+import requests
+
+
+PACKAGE_NAME = "@danhachuel/thunderbolt"
+REGISTRY_URL = "https://registry.npmjs.org/@danhachuel/thunderbolt/latest"
+UPDATE_TIMEOUT_SECONDS = 20 * 60
+
+
+@dataclass(frozen=True)
+class VersionCheck:
+    """Version information displayed on the local home page."""
+
+    current_version: str
+    latest_version: str = ""
+    error: str = ""
+
+    @property
+    def update_available(self) -> bool:
+        return bool(self.latest_version and self.current_version and self.latest_version != self.current_version)
+
+
+@dataclass(frozen=True)
+class UpdateResult:
+    """Sanitised result of an explicit local package update request."""
+
+    ok: bool
+    latest_version: str = ""
+    message: str = ""
+
+
+def latest_package_version(*, timeout: int = 8, get: Callable[..., Any] = requests.get) -> str:
+    """Return the latest public package version without sending local configuration."""
+    response = get(REGISTRY_URL, timeout=timeout)
+    response.raise_for_status()
+    payload = response.json()
+    version = str(payload.get("version") or "").strip() if isinstance(payload, dict) else ""
+    if not version:
+        raise ValueError("O registry NPM não devolveu uma versão válida.")
+    return version
+
+
+def check_version(current_version: str, *, timeout: int = 8, get: Callable[..., Any] = requests.get) -> VersionCheck:
+    """Fetch only the package metadata needed for the version badge."""
+    current = str(current_version or "").strip()
+    try:
+        return VersionCheck(current_version=current, latest_version=latest_package_version(timeout=timeout, get=get))
+    except (requests.RequestException, ValueError) as exc:
+        return VersionCheck(current_version=current, error=f"Não foi possível verificar actualizações agora ({type(exc).__name__}).")
+
+
+def update_command() -> list[str]:
+    """Build the same cross-platform install command documented for Thunderbolt."""
+    executable = "npx.cmd" if os.name == "nt" else "npx"
+    return [executable, "--yes", "--prefer-online", PACKAGE_NAME, "install"]
+
+
+def update_to_latest(
+    current_version: str,
+    *,
+    timeout: int = UPDATE_TIMEOUT_SECONDS,
+    get: Callable[..., Any] = requests.get,
+    run: Callable[..., Any] = subprocess.run,
+) -> UpdateResult:
+    """Install the latest package only after an explicit UI action.
+
+    The running local process keeps its current code until it is restarted. No
+    subprocess output is returned to the UI, preventing accidental display of
+    environment values from third-party installers.
+    """
+    status = check_version(current_version, get=get)
+    if status.error:
+        return UpdateResult(False, message=status.error)
+    if not status.update_available:
+        return UpdateResult(True, latest_version=status.latest_version, message="O Thunderbolt já está na versão mais recente.")
+    try:
+        completed = run(
+            update_command(),
+            stdin=subprocess.DEVNULL,
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL,
+            timeout=timeout,
+            check=False,
+        )
+    except (OSError, subprocess.TimeoutExpired) as exc:
+        return UpdateResult(False, latest_version=status.latest_version, message=f"Não foi possível concluir a actualização ({type(exc).__name__}).")
+    if int(getattr(completed, "returncode", 1)) != 0:
+        return UpdateResult(False, latest_version=status.latest_version, message="A actualização não foi concluída. Feche processos Thunderbolt em execução e tente novamente.")
+    return UpdateResult(
+        True,
+        latest_version=status.latest_version,
+        message=(
+            f"A versão {status.latest_version} foi instalada. Reinicie o Thunderbolt para abrir a versão nova; "
+            "os dados e configurações locais foram preservados."
+        ),
+    )

package/package.json

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