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
This commit is contained in:
João Henrique
@@ -5,7 +5,8 @@ têm posição na timeline diferente da posição no arquivo de origem — o mes
|
||||
descompasso encontrado no projeto real entre ``inicio_na_timeline`` e
|
||||
``inicio_na_origem`` do banco de análises. Implementa só as ferramentas MCP
|
||||
que o módulo ``engine.editor`` usa: ``get_active_sequence``, ``split_clip``,
|
||||
``remove_from_timeline``, ``remove_linked_from_timeline``, ``set_clip_properties`` e ``add_marker``.
|
||||
``remove_from_timeline``, ``remove_linked_from_timeline``,
|
||||
``duplicate_linked_range_to_start``, ``set_clip_properties`` e ``add_marker``.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
@@ -100,6 +101,7 @@ class ClienteMCPFalso(ClienteMCP):
|
||||
"split_clip": self._simular_split_clip,
|
||||
"remove_from_timeline": self._simular_ripple_delete,
|
||||
"remove_linked_from_timeline": self._simular_remocao_vinculada,
|
||||
"duplicate_linked_range_to_start": self._simular_gancho_vinculado_no_inicio,
|
||||
"set_clip_properties": self._simular_set_clip_properties,
|
||||
"add_marker": self._simular_add_marker,
|
||||
"undo": self._simular_undo,
|
||||
@@ -223,6 +225,43 @@ class ClienteMCPFalso(ClienteMCP):
|
||||
self._simular_ripple_delete({"node_id": identificador, "ripple": True})
|
||||
return {"removed": True, "verified": True}
|
||||
|
||||
def _simular_gancho_vinculado_no_inicio(self, argumentos: dict[str, Any]) -> dict[str, Any]:
|
||||
"""Duplica um par isolado no início e preserva sua ocorrência original."""
|
||||
identificadores = argumentos["node_ids"]
|
||||
encontrados: list[tuple[str, _ClipeFalso]] = []
|
||||
for identificador_da_faixa, clipes in self._faixas.items():
|
||||
for clipe in clipes:
|
||||
if clipe.identificador in identificadores:
|
||||
encontrados.append((identificador_da_faixa, clipe))
|
||||
if len(encontrados) != 2 or {faixa.split("_")[0] for faixa, _ in encontrados} != {"video", "audio"}:
|
||||
raise ErroDeFerramentaMCP("O gancho exige um par de vídeo e áudio existente.")
|
||||
inicios = {round(clipe.inicio_na_timeline, 6) for _, clipe in encontrados}
|
||||
fins = {round(clipe.fim_na_timeline, 6) for _, clipe in encontrados}
|
||||
if len(inicios) != 1 or len(fins) != 1:
|
||||
raise ErroDeFerramentaMCP("O par não ocupa o mesmo intervalo.")
|
||||
|
||||
self._salvar_estado()
|
||||
inicio_na_origem = float(argumentos["source_in_seconds"])
|
||||
fim_na_origem = float(argumentos["source_out_seconds"])
|
||||
duracao = fim_na_origem - inicio_na_origem
|
||||
novos_ids: list[str] = []
|
||||
for identificador_da_faixa, clipe in encontrados:
|
||||
faixa = self._faixas[identificador_da_faixa]
|
||||
for outro in faixa:
|
||||
outro.inicio_na_timeline += duracao
|
||||
outro.fim_na_timeline += duracao
|
||||
novo = self._novo_clipe(
|
||||
clipe.nome,
|
||||
0.0,
|
||||
duracao,
|
||||
inicio_na_origem,
|
||||
fim_na_origem,
|
||||
)
|
||||
faixa.append(novo)
|
||||
faixa.sort(key=lambda item: item.inicio_na_timeline)
|
||||
novos_ids.append(novo.identificador)
|
||||
return {"duplicated": True, "verified": True, "insertedNodeIds": novos_ids}
|
||||
|
||||
def _simular_set_clip_properties(self, argumentos: dict[str, Any]) -> dict[str, Any]:
|
||||
"""Aceita a alteração de propriedades sem simular geometria (não é usada pelos testes)."""
|
||||
del argumentos
|
||||
|
||||
@@ -249,6 +249,64 @@ class TesteAplicadorDePlanoDeEdicao(unittest.TestCase):
|
||||
self.assertEqual(len(chamadas_de_marcador), 1)
|
||||
self.assertIn("MASTOPEXIA", chamadas_de_marcador[0][1]["comments"])
|
||||
|
||||
def test_gancho_isola_video_e_audio_e_duplica_no_inicio(self):
|
||||
cliente = ClienteMCPFalso(clipe_unico=True)
|
||||
aplicador = AplicadorDePlanoDeEdicao(
|
||||
acesso_ao_editor=AcessoAoEditor(AcessoATimeline(cliente)),
|
||||
conversor_de_timeline=ConversorDeTimeline(),
|
||||
escrita=EscritaNoEditor(cliente),
|
||||
mapeador=MapeadorDeTempoDeOrigemParaTimeline(),
|
||||
)
|
||||
plano = PlanoDeEdicao("0E6A8290.mp4", (
|
||||
AcaoDeEdicao(
|
||||
TipoDeAcao.GANCHO,
|
||||
inicio=80.0,
|
||||
fim=90.0,
|
||||
motivo="gancho de abertura",
|
||||
parametros={"target": 0, "keep_original": True},
|
||||
),
|
||||
))
|
||||
|
||||
resultado = aplicador.aplicar(plano)
|
||||
|
||||
self.assertTrue(resultado.todas_bem_sucedidas, msg=[item.detalhe for item in resultado.falhas])
|
||||
ganchos = [chamada for chamada in cliente.chamadas if chamada[0] == "duplicate_linked_range_to_start"]
|
||||
self.assertEqual(len(ganchos), 1)
|
||||
self.assertEqual(len(ganchos[0][1]["node_ids"]), 2)
|
||||
self.assertEqual(cliente._faixas["video_0"][0].inicio_na_origem, 80.0)
|
||||
self.assertEqual(cliente._faixas["audio_0"][0].inicio_na_origem, 80.0)
|
||||
self.assertEqual(cliente._faixas["video_0"][0].inicio_na_timeline, 0.0)
|
||||
self.assertEqual(cliente._faixas["audio_0"][0].inicio_na_timeline, 0.0)
|
||||
self.assertEqual(
|
||||
sum(1 for clipe in cliente._faixas["video_0"] if clipe.inicio_na_origem == 80.0),
|
||||
2,
|
||||
)
|
||||
self.assertEqual(
|
||||
sum(1 for clipe in cliente._faixas["audio_0"] if clipe.inicio_na_origem == 80.0),
|
||||
2,
|
||||
)
|
||||
|
||||
def test_gancho_e_executado_apos_cortes_e_antes_de_zoom(self):
|
||||
cliente = ClienteMCPFalso(clipe_unico=True)
|
||||
aplicador = AplicadorDePlanoDeEdicao(
|
||||
acesso_ao_editor=AcessoAoEditor(AcessoATimeline(cliente)),
|
||||
conversor_de_timeline=ConversorDeTimeline(),
|
||||
escrita=EscritaNoEditor(cliente),
|
||||
mapeador=MapeadorDeTempoDeOrigemParaTimeline(),
|
||||
)
|
||||
plano = PlanoDeEdicao("0E6A8290.mp4", (
|
||||
AcaoDeEdicao(TipoDeAcao.CORTE, 20.0, 30.0, "retirar bastidor"),
|
||||
AcaoDeEdicao(TipoDeAcao.GANCHO, 80.0, 90.0, "gancho"),
|
||||
AcaoDeEdicao(TipoDeAcao.ZOOM, 100.0, 105.0, "ênfase", {"scale": 1.15}),
|
||||
))
|
||||
|
||||
resultado = aplicador.aplicar(plano)
|
||||
|
||||
self.assertTrue(resultado.todas_bem_sucedidas, msg=[item.detalhe for item in resultado.falhas])
|
||||
nomes = [nome for nome, _ in cliente.chamadas]
|
||||
self.assertLess(nomes.index("remove_linked_from_timeline"), nomes.index("duplicate_linked_range_to_start"))
|
||||
self.assertLess(nomes.index("duplicate_linked_range_to_start"), nomes.index("set_clip_properties"))
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
unittest.main()
|
||||
|
||||
@@ -7,7 +7,7 @@ from pathlib import Path
|
||||
from unittest.mock import patch
|
||||
|
||||
from engine import aplicar_plano_de_edicao
|
||||
from engine.editor import ErroDePlanoInvalido
|
||||
from engine.editor import AcaoDeEdicao, ErroDePlanoInvalido, PlanoDeEdicao, TipoDeAcao
|
||||
|
||||
|
||||
class TesteResolucaoDoNode(unittest.TestCase):
|
||||
@@ -62,6 +62,23 @@ class TestePreValidacaoDoPlano(unittest.TestCase):
|
||||
validar.assert_called_once()
|
||||
resolver_node.assert_not_called()
|
||||
|
||||
def test_gancho_exige_backup_confirmado(self) -> None:
|
||||
"""A operação composta não começa quando a recuperação não foi criada."""
|
||||
plano = PlanoDeEdicao("video.mp4", (
|
||||
AcaoDeEdicao(TipoDeAcao.GANCHO, 10.0, 15.0, "gancho"),
|
||||
))
|
||||
|
||||
with self.assertRaisesRegex(ErroDePlanoInvalido, "não confirmou o backup"):
|
||||
aplicar_plano_de_edicao._garantir_backup_para_ganchos(plano, False)
|
||||
|
||||
def test_corte_preserva_comportamento_legado_quando_backup_falha(self) -> None:
|
||||
"""A exigência adicional fica restrita ao gancho estrutural."""
|
||||
plano = PlanoDeEdicao("video.mp4", (
|
||||
AcaoDeEdicao(TipoDeAcao.CORTE, 10.0, 15.0, "retirada"),
|
||||
))
|
||||
|
||||
aplicar_plano_de_edicao._garantir_backup_para_ganchos(plano, False)
|
||||
|
||||
def test_painel_rejeita_corte_sem_plano_associado_ao_banco(self) -> None:
|
||||
"""Não permite contornar a validação colando um corte sem transcrição vinculada."""
|
||||
with tempfile.TemporaryDirectory() as pasta:
|
||||
|
||||
@@ -71,5 +71,19 @@ class TesteDividirClipeSeNecessario(unittest.TestCase):
|
||||
self._dividir("razor changed the track clip count from 4 to 7, expected 5")
|
||||
|
||||
|
||||
class TesteDuplicarTrechosVinculados(unittest.TestCase):
|
||||
"""Cobre o contrato estreito da escrita do gancho editorial."""
|
||||
|
||||
def test_exige_exatamente_dois_identificadores(self):
|
||||
escrita = EscritaNoEditor(_ClienteQueRecusa("não deveria chamar"))
|
||||
with self.assertRaisesRegex(ErroDeEscritaNoEditor, "exatamente"):
|
||||
escrita.duplicar_trecho_vinculado_para_o_inicio(["somente-video"], 10.0, 15.0)
|
||||
|
||||
def test_converte_falha_da_ferramenta_em_erro_de_escrita(self):
|
||||
escrita = EscritaNoEditor(_ClienteQueRecusa("faixa adicional ocupada"))
|
||||
with self.assertRaisesRegex(ErroDeEscritaNoEditor, "faixa adicional ocupada"):
|
||||
escrita.duplicar_trecho_vinculado_para_o_inicio(["video", "audio"], 10.0, 15.0)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
unittest.main()
|
||||
|
||||
@@ -66,6 +66,50 @@ class TesteLeitorDePlanoDeEdicao(unittest.TestCase):
|
||||
"actions": [{"kind": "voar", "start": 0, "end": 1, "reason": "x"}],
|
||||
})
|
||||
|
||||
def test_le_gancho_duplicado_para_o_inicio(self):
|
||||
plano = self.leitor.ler_de_dicionario({
|
||||
"source": "a.mp4",
|
||||
"actions": [{
|
||||
"kind": "hook",
|
||||
"start": 40,
|
||||
"end": 46,
|
||||
"reason": "gancho de abertura",
|
||||
"params": {"target": 0, "keep_original": True},
|
||||
}],
|
||||
})
|
||||
self.assertEqual(plano.acoes[0].tipo, TipoDeAcao.GANCHO)
|
||||
self.assertEqual(plano.acoes[0].parametros["target"], 0)
|
||||
|
||||
def test_gancho_para_destino_diferente_do_inicio_e_rejeitado(self):
|
||||
with self.assertRaisesRegex(ErroDePlanoInvalido, "target precisa ser 0"):
|
||||
self.leitor.ler_de_dicionario({
|
||||
"source": "a.mp4",
|
||||
"actions": [{
|
||||
"kind": "hook", "start": 40, "end": 46,
|
||||
"reason": "reordenar", "params": {"target": 12},
|
||||
}],
|
||||
})
|
||||
|
||||
def test_gancho_que_remove_o_original_e_rejeitado(self):
|
||||
with self.assertRaisesRegex(ErroDePlanoInvalido, "keep_original precisa ser true"):
|
||||
self.leitor.ler_de_dicionario({
|
||||
"source": "a.mp4",
|
||||
"actions": [{
|
||||
"kind": "hook", "start": 40, "end": 46,
|
||||
"reason": "abertura", "params": {"keep_original": False},
|
||||
}],
|
||||
})
|
||||
|
||||
def test_corte_sobreposto_ao_gancho_e_rejeitado(self):
|
||||
with self.assertRaisesRegex(ErroDePlanoInvalido, "não pode sobrepor"):
|
||||
self.leitor.ler_de_dicionario({
|
||||
"source": "a.mp4",
|
||||
"actions": [
|
||||
{"kind": "cut", "start": 42, "end": 44, "reason": "cortar"},
|
||||
{"kind": "hook", "start": 40, "end": 46, "reason": "abertura"},
|
||||
],
|
||||
})
|
||||
|
||||
def test_fim_menor_ou_igual_ao_inicio_levanta_erro(self):
|
||||
with self.assertRaises(ErroDePlanoInvalido):
|
||||
self.leitor.ler_de_dicionario({
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
"""Testes de regressão da integridade semântica dos cortes editoriais."""
|
||||
"""Testes de regressão da integridade semântica das emendas editoriais."""
|
||||
|
||||
import unittest
|
||||
|
||||
@@ -8,7 +8,7 @@ from engine.scanner.modelos import PalavraDeTranscricao, SegmentoDeTranscricao
|
||||
|
||||
|
||||
class TesteValidadorSemanticoDePlano(unittest.TestCase):
|
||||
"""Impede cortes de palavra e retomadas no meio de uma frase."""
|
||||
"""Impede cortes de palavra, frases incompletas e ganchos truncados."""
|
||||
|
||||
def setUp(self) -> None:
|
||||
"""Cria o validador com a margem segura usada pela aplicação real."""
|
||||
@@ -104,6 +104,46 @@ class TesteValidadorSemanticoDePlano(unittest.TestCase):
|
||||
|
||||
self.assertIn("palavra_interceptada", {problema.codigo for problema in problemas})
|
||||
|
||||
def test_aceita_gancho_de_frase_completa_com_margens(self) -> None:
|
||||
falas = (
|
||||
SegmentoDeTranscricao(0.0, 4.0, "Antes.", palavras=(
|
||||
PalavraDeTranscricao("Antes.", 3.4, 4.0),
|
||||
)),
|
||||
SegmentoDeTranscricao(10.4, 13.5, "Gancho completo.", palavras=(
|
||||
PalavraDeTranscricao("Gancho", 10.4, 10.9),
|
||||
PalavraDeTranscricao("completo.", 13.0, 13.5),
|
||||
)),
|
||||
SegmentoDeTranscricao(20.0, 21.0, "Depois.", palavras=(
|
||||
PalavraDeTranscricao("Depois.", 20.0, 21.0),
|
||||
)),
|
||||
)
|
||||
plano = PlanoDeEdicao("video.mp4", (
|
||||
AcaoDeEdicao(TipoDeAcao.GANCHO, 10.1, 13.8, "gancho"),
|
||||
))
|
||||
|
||||
self.assertEqual(self.validador.validar(plano, falas), ())
|
||||
|
||||
def test_rejeita_gancho_que_termina_com_frase_truncada(self) -> None:
|
||||
falas = (
|
||||
SegmentoDeTranscricao(0.0, 4.0, "Antes.", palavras=(
|
||||
PalavraDeTranscricao("Antes.", 3.4, 4.0),
|
||||
)),
|
||||
SegmentoDeTranscricao(10.4, 13.5, "Trazer uma seguran", palavras=(
|
||||
PalavraDeTranscricao("Trazer", 10.4, 10.9),
|
||||
PalavraDeTranscricao("seguran", 13.0, 13.5),
|
||||
)),
|
||||
SegmentoDeTranscricao(20.0, 21.0, "Depois.", palavras=(
|
||||
PalavraDeTranscricao("Depois.", 20.0, 21.0),
|
||||
)),
|
||||
)
|
||||
plano = PlanoDeEdicao("video.mp4", (
|
||||
AcaoDeEdicao(TipoDeAcao.GANCHO, 10.1, 13.8, "gancho"),
|
||||
))
|
||||
|
||||
problemas = self.validador.validar(plano, falas)
|
||||
|
||||
self.assertIn("gancho_termina_no_meio_da_frase", {problema.codigo for problema in problemas})
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
unittest.main()
|
||||
|
||||
@@ -0,0 +1,72 @@
|
||||
"""Testes da leitura estrutural depois da aplicação do plano."""
|
||||
|
||||
import unittest
|
||||
|
||||
from engine.dominio import Clipe, Faixa, IntervaloDeTempo, Timeline
|
||||
from engine.editor.modelos import AcaoDeEdicao, PlanoDeEdicao, TipoDeAcao
|
||||
from engine.editor.verificador_da_aplicacao import VerificadorDaAplicacao
|
||||
|
||||
|
||||
class TesteVerificadorDaAplicacao(unittest.TestCase):
|
||||
"""Garante que sobras e lacunas na timeline sejam detectadas."""
|
||||
|
||||
def _timeline(self, fim_do_ultimo_clipe: float) -> Timeline:
|
||||
"""Monta uma timeline simples com vídeo e áudio vinculados por intervalo."""
|
||||
faixas = []
|
||||
for tipo in ("video", "audio"):
|
||||
faixas.append(Faixa(
|
||||
f"{tipo}_0", tipo, tipo, 0, [Clipe(
|
||||
f"clipe_{tipo}", "fonte.mp4",
|
||||
IntervaloDeTempo(0.0, fim_do_ultimo_clipe),
|
||||
IntervaloDeTempo(0.0, fim_do_ultimo_clipe),
|
||||
)]
|
||||
))
|
||||
return Timeline("sequencia", "Sequência", 100.0, faixas=faixas)
|
||||
|
||||
def test_aprova_cobertura_exata_depois_do_corte(self):
|
||||
"""Aprova quando os dois tipos de faixa preservam exatamente o esperado."""
|
||||
antes = self._timeline(100.0)
|
||||
depois = Timeline("sequencia", "Sequência", 90.0, faixas=[
|
||||
Faixa("video_0", "video", "video", 0, [
|
||||
Clipe("v1", "fonte.mp4", IntervaloDeTempo(0, 10), IntervaloDeTempo(0, 10)),
|
||||
Clipe("v2", "fonte.mp4", IntervaloDeTempo(10, 90), IntervaloDeTempo(20, 100)),
|
||||
]),
|
||||
Faixa("audio_0", "audio", "audio", 0, [
|
||||
Clipe("a1", "fonte.mp4", IntervaloDeTempo(0, 10), IntervaloDeTempo(0, 10)),
|
||||
Clipe("a2", "fonte.mp4", IntervaloDeTempo(10, 90), IntervaloDeTempo(20, 100)),
|
||||
]),
|
||||
])
|
||||
plano = PlanoDeEdicao("fonte.mp4", (
|
||||
AcaoDeEdicao(TipoDeAcao.CORTE, 10, 20, "remover trecho"),
|
||||
))
|
||||
|
||||
resultado = VerificadorDaAplicacao().verificar(antes, depois, plano)
|
||||
|
||||
self.assertTrue(resultado.aprovada)
|
||||
self.assertTrue(resultado.avisos)
|
||||
|
||||
def test_reprova_quando_sobra_um_trecho_na_timeline(self):
|
||||
"""Reprova quando o Premiere deixa uma sobra além do plano."""
|
||||
antes = self._timeline(100.0)
|
||||
depois = Timeline("sequencia", "Sequência", 91.0, faixas=[
|
||||
Faixa("video_0", "video", "video", 0, [
|
||||
Clipe("v1", "fonte.mp4", IntervaloDeTempo(0, 10), IntervaloDeTempo(0, 10)),
|
||||
Clipe("v2", "fonte.mp4", IntervaloDeTempo(10, 91), IntervaloDeTempo(20, 101)),
|
||||
]),
|
||||
Faixa("audio_0", "audio", "audio", 0, [
|
||||
Clipe("a1", "fonte.mp4", IntervaloDeTempo(0, 10), IntervaloDeTempo(0, 10)),
|
||||
Clipe("a2", "fonte.mp4", IntervaloDeTempo(10, 91), IntervaloDeTempo(20, 101)),
|
||||
]),
|
||||
])
|
||||
plano = PlanoDeEdicao("fonte.mp4", (
|
||||
AcaoDeEdicao(TipoDeAcao.CORTE, 10, 20, "remover trecho"),
|
||||
))
|
||||
|
||||
resultado = VerificadorDaAplicacao().verificar(antes, depois, plano)
|
||||
|
||||
self.assertFalse(resultado.aprovada)
|
||||
self.assertIn("esperado", resultado.mensagem)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
unittest.main()
|
||||
Reference in New Issue
Block a user