feat: copiada a skill editar-por-voz e seus critérios para as skil

- copiada a skill editar-por-voz e seus critérios para as skills do projeto
- adaptada a skill editar-por-voz para usar o banco SQLite como fonte oficial
- corrigida a cópia do JSON do tipo de vídeo para priorizar clipboard Unicode
- criado carregador único do contexto de edição por voz a partir do SQLite
- criada entrada para registrar planos no SQLite e reaproveitar o mesmo plano na aplicação
- habilitado carregamento do plano editorial diretamente do SQLite na interface
- corrigido o bloqueio visual da etapa de carregamento do plano salvo
- configurado carregamento automático do plano salvo após selecionar a sequência
- documentada a sequência como raiz de retomada do fluxo de edição
- criada a estrutura local para análise de músicas instrumentais com Essentia

Resumo:
- 22 arquivos alterados
- 11 novos
- 11 modificados
- 0 removidos

 11 files changed, 270 insertions(+), 34 deletions(-)

Arquivos:
  - .jhonny/analises.db
  - CONTEXT.md
  - code/cep-plugin/index.html
  - code/cep-plugin/main.js
  - code/engine/README.md
  - code/engine/aplicar_plano_de_edicao.py
  - code/engine/integracoes/audio/__init__.py
  - code/engine/persistencia/consultas.py
  - code/engine/requirements-audio.txt
  - code/engine/testes/test_consultas_de_persistencia.py
  - code/tests/cep-tipos-video-encoding.test.ts
  - code/.jhonny/
  - code/engine/carregar_plano_de_edicao.py
  - code/engine/integracoes/audio/contratos.py
  - code/engine/integracoes/audio/modelos_de_analise_musical.py
  - code/engine/integracoes/audio/provider_de_analise_musical_essentia.py
  - code/engine/preparar_edicao_por_voz.py
  - code/engine/registrar_plano_de_edicao.py
  - code/engine/testes/test_analisador_de_musica_essentia.py
  - code/engine/testes/test_carregar_plano_de_edicao.py
  - code/engine/testes/test_registrar_plano_de_edicao.py
  - code/plugins/premiere-pro/skills/editar-por-voz/

code/engine/registrar_plano_de_edicao.py

@@ -0,0 +1,77 @@
+"""Entrada de linha de comando para salvar um plano de edição no SQLite."""
+
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+import sys
+
+CAMINHO_DO_CODIGO = Path(__file__).resolve().parent.parent
+if str(CAMINHO_DO_CODIGO) not in sys.path:
+    sys.path.insert(0, str(CAMINHO_DO_CODIGO))
+
+from engine.persistencia.conexao import abrir_banco
+from engine.persistencia.repositorio_de_planos import RepositorioDePlanos, plano_de_dict
+
+
+def registrar(
+    caminho_do_plano: Path,
+    caminho_do_banco: Path,
+    video_id: str | None = None,
+    tipo_de_video: str | None = None,
+    modelo_da_ia: str | None = None,
+    intencao: str | None = None,
+) -> int:
+    """Lê o JSON devolvido pela IA e registra o plano associado à edição mais recente."""
+    dados = json.loads(caminho_do_plano.read_text(encoding="utf-8"))
+    conexao = abrir_banco(caminho_do_banco)
+    try:
+        if video_id is None:
+            origem = dados.get("source")
+            linha = conexao.execute(
+                """SELECT video_id FROM edicoes_de_video
+                   WHERE origem = ? OR sequencia = ?
+                   ORDER BY concluida_em DESC, id DESC LIMIT 1""",
+                (origem, origem),
+            ).fetchone()
+            video_id = linha["video_id"] if linha is not None else None
+        plano = plano_de_dict(
+            dados,
+            video_id=video_id,
+            tipo_de_video=tipo_de_video,
+            modelo_da_ia=modelo_da_ia,
+            intencao=intencao,
+        )
+        return RepositorioDePlanos(conexao).registrar_plano(plano)
+    finally:
+        conexao.close()
+
+
+def principal() -> None:
+    """Executa o registro do plano pela linha de comando."""
+    argumentos = argparse.ArgumentParser()
+    argumentos.add_argument("plano", type=Path)
+    argumentos.add_argument("--banco", type=Path, default=Path(".jhonny/analises.db"))
+    argumentos.add_argument("--video-id")
+    argumentos.add_argument("--tipo-de-video")
+    argumentos.add_argument("--modelo-da-ia")
+    argumentos.add_argument("--intencao")
+    opcoes = argumentos.parse_args()
+    try:
+        identificador = registrar(
+            opcoes.plano,
+            opcoes.banco,
+            video_id=opcoes.video_id,
+            tipo_de_video=opcoes.tipo_de_video,
+            modelo_da_ia=opcoes.modelo_da_ia,
+            intencao=opcoes.intencao,
+        )
+        print(json.dumps({"ok": True, "plano_id": identificador}, ensure_ascii=False))
+    except (OSError, ValueError) as erro:
+        print(json.dumps({"ok": False, "erro": str(erro)}, ensure_ascii=False))
+        raise SystemExit(1) from erro
+
+
+if __name__ == "__main__":
+    principal()