feat: criado monitoramento contínuo de trilhas com varredura recur

- criado monitoramento contínuo de trilhas com varredura recursiva e baixa prioridade
- gerado e validado plano editorial revisável do depoimento da Erika sem aplicação na timeline
- adicionada leitura e comparação estrutural da timeline após aplicar planos de edição
- limitadas as classificações de trilhas às duas maiores probabilidades de cada categoria
- limpo o catálogo musical para reiniciar as análises sem remover dados de vídeo

Resumo:
- 34 arquivos alterados
- 6 novos
- 28 modificados
- 0 removidos

 28 files changed, 833 insertions(+), 75 deletions(-)

Arquivos:
  - .jhonny/analises.db
  - code/cep-plugin/index.html
  - code/cep-plugin/main.js
  - code/engine/analisar_trilhas.py
  - code/engine/aplicar_plano_de_edicao.py
  - code/engine/consultar_detalhes_de_trilha.py
  - code/engine/editor/__init__.py
  - code/engine/editor/aplicador_de_plano_de_edicao.py
  - code/engine/editor/backup_de_sequencia.py
  - code/engine/editor/escrita/escrita_no_editor.py
  - code/engine/editor/modelos.py
  - code/engine/editor/validacao_semantica.py
  - code/engine/integracoes/audio/classificador_de_musica_essentia.py
  - code/engine/integracoes/audio/modelos_de_analise_musical.py
  - code/engine/integracoes/audio/provider_de_analise_musical_essentia.py
  - code/engine/persistencia/esquema.py
  - code/engine/persistencia/repositorio_de_trilhas.py
  - code/engine/testes/duplos_de_premiere.py
  - code/engine/testes/test_aplicador_de_plano_de_edicao.py
  - code/engine/testes/test_aplicar_plano_de_edicao.py
  - code/engine/testes/test_escrita_no_editor.py
  - code/engine/testes/test_leitor_de_plano_de_edicao.py
  - code/engine/testes/test_validador_semantico_de_plano.py
  - code/plugins/premiere-pro/skills/editar-por-voz/SKILL.md
  - code/plugins/premiere-pro/skills/editar-por-voz/criterios/08-formato-de-saida.md
  - code/plugins/premiere-pro/skills/editar-por-voz/criterios/10-revisao-humana.md
  - code/src/tools/timeline.ts
  - code/tests/tools/tool-modules.test.ts
  - .jhonny/planos/
  - code/.jhonny/analises.db-shm
  - code/.jhonny/analises.db-wal
  - code/engine/editor/verificador_da_aplicacao.py
  - code/engine/testes/test_verificador_da_aplicacao.py
  - code/plugins/premiere-pro/skills/editar-por-voz/criterios/11-gancho.md

code/engine/editor/modelos.py

@@ -14,12 +14,13 @@ from typing import Any
 
 
 class TipoDeAcao(str, Enum):
-    """Os quatro tipos de ação que o plano de edição pode descrever."""
+    """Os tipos de ação que o plano de edição pode descrever."""
 
     CORTE = "cut"
     ZOOM = "zoom"
     TEXTO = "text"
     MARCADOR = "marker"
+    GANCHO = "hook"
 
 
 @dataclass(frozen=True)
@@ -46,6 +47,13 @@ class AcaoDeEdicao:
             )
         if not self.motivo.strip():
             raise ValueError("Ação inválida: motivo não pode ser vazio.")
+        if self.tipo is TipoDeAcao.GANCHO:
+            destino = self.parametros.get("target", 0)
+            manter_original = self.parametros.get("keep_original", True)
+            if isinstance(destino, bool) or not isinstance(destino, (int, float)) or float(destino) != 0.0:
+                raise ValueError("Gancho inválido: params.target precisa ser 0 nesta versão.")
+            if manter_original is not True:
+                raise ValueError("Gancho inválido: params.keep_original precisa ser true.")
 
     @property
     def duracao(self) -> float:
@@ -63,6 +71,16 @@ class PlanoDeEdicao:
     def __post_init__(self) -> None:
         if not self.arquivo_de_origem.strip():
             raise ValueError("Plano de edição inválido: arquivo de origem não informado.")
+        ganchos = self.acoes_do_tipo(TipoDeAcao.GANCHO)
+        if len(ganchos) > 1:
+            raise ValueError("Plano de edição inválido: esta versão aceita somente uma ação hook.")
+        if ganchos:
+            gancho = ganchos[0]
+            for acao in self.acoes:
+                if acao is gancho:
+                    continue
+                if acao.inicio < gancho.fim and gancho.inicio < acao.fim:
+                    raise ValueError("Plano de edição inválido: outra ação não pode sobrepor o trecho do hook.")
 
     def acoes_do_tipo(self, tipo: TipoDeAcao) -> tuple[AcaoDeEdicao, ...]:
         """Devolve, na ordem original, só as ações do tipo informado."""