feat: - tornado obrigatório registrar uma linha de resum

- tornado obrigatório registrar uma linha de resumo para cada implementação concluída
- corrigido o Scanner e o Retakes no painel usando o Python do venv (3.14) em vez do /usr/bin/python3 3.9 e injetado o caminho da engine no executar_retakes.py

Resumo:
- 7 arquivos alterados
- 0 novos
- 7 modificados
- 0 removidos

 7 files changed, 57 insertions(+), 8 deletions(-)

Arquivos:
  - .gitignore
  - AGENTS.md
  - CLAUDE.md
  - admin/DEV-NOTES.md
  - admin/deploy.command
  - code/cep-plugin/main.js
  - code/engine/executar_retakes.py

code/cep-plugin/main.js

@@ -230,6 +230,10 @@ function switchTab(name) {
 // A aba apenas controla o processo e mostra resultados; a análise inteira
 // acontece na engine (scanner/retakes), chamada via executar_retakes.py.
 var RETAKES_ENGINE_SCRIPT = "/Volumes/Merongo/SISTEMAS/GENIAL SISTEMAS/Jhonny/code/engine/executar_retakes.py";
+// A engine usa tipos do Python 3.10+ (ex.: `X | None`, `dict[str, ...]`), que
+// o `/usr/bin/python3` do macOS (3.9) não aceita. Usar o mesmo venv do projeto
+// (Python 3.14, com faster_whisper) garante que Scanner e Retakes carreguem bem.
+var SCANNER_PYTHON_BIN = "/Volumes/Merongo/SISTEMAS/venvs/whisperx-transcricao/bin/python";
 var retakesCasoAtual = null;
 var retakesGrupos = [];
 var retakesProcesso = null;
@@ -354,7 +358,7 @@ function retakesAnalisar() {
   taskStart("Retakes", "Preparando análise", null);
   document.getElementById("retakesProgressoCard").hidden = false;
   document.getElementById("retakesProgressoEtapa").textContent = "Analisando retakes…";
-  var child = childProcess.spawn("python3", [RETAKES_ENGINE_SCRIPT, entrada, path.join(retakesRaiz(), retakesCasoAtual)],
+  var child = childProcess.spawn(SCANNER_PYTHON_BIN, [RETAKES_ENGINE_SCRIPT, entrada, path.join(retakesRaiz(), retakesCasoAtual)],
     { cwd: "/Volumes/Merongo/SISTEMAS/GENIAL SISTEMAS/Jhonny/code/engine", stdio: ["ignore", "pipe", "pipe"] });
   retakesProcesso = child;
   var resto = "";
@@ -393,7 +397,7 @@ function retakesRevisar(grupoId, acao) {
   var pedido = { acao: "revisar", video_id: retakesCasoAtual, revisao: { grupo_id: grupoId, acao: acao } };
   var entrada = path.join(os.tmpdir(), "revisao-retakes-" + Date.now() + ".json");
   fs.writeFileSync(entrada, JSON.stringify(pedido), "utf-8");
-  var child = childProcess.spawn("python3", [RETAKES_ENGINE_SCRIPT, entrada, path.join(retakesRaiz(), retakesCasoAtual)],
+  var child = childProcess.spawn(SCANNER_PYTHON_BIN, [RETAKES_ENGINE_SCRIPT, entrada, path.join(retakesRaiz(), retakesCasoAtual)],
     { cwd: "/Volumes/Merongo/SISTEMAS/GENIAL SISTEMAS/Jhonny/code/engine", stdio: ["ignore", "pipe", "pipe"] });
   child.on("close", function (codigo) {
     if (codigo !== 0) { showToast("err", "Não foi possível registrar a revisão."); return; }
@@ -511,7 +515,7 @@ function scannerProcess() {
   setBusy("btnScannerProcess",true); taskStart("Scanner", "Preparando análise", null);
   var spawnOptions={cwd:"/Volumes/Merongo/SISTEMAS/GENIAL SISTEMAS/Jhonny/code",stdio:["ignore","pipe","pipe"]};
   var huggingFaceEnvironment=hfSpawnOptions(); if(huggingFaceEnvironment&&huggingFaceEnvironment.env) spawnOptions.env=huggingFaceEnvironment.env;
-  var child=childProcess.spawn("python3",[SCANNER_ENGINE_SCRIPT,input,scannerReportPath],spawnOptions);
+  var child=childProcess.spawn(SCANNER_PYTHON_BIN,[SCANNER_ENGINE_SCRIPT,input,scannerReportPath],spawnOptions);
   var stderr="", stdout="";
   child.stdout.on("data",function(chunk) {
     stdout += chunk.toString(); var lines=stdout.split("\n"); stdout=lines.pop();

code/engine/executar_retakes.py

@@ -36,6 +36,14 @@ import sys
 from dataclasses import asdict
 from pathlib import Path
 
+# O painel chama este arquivo com cwd ``code/engine`` e o Python inclui apenas
+# essa pasta no caminho de importação. Injetar ``code`` (pai do pacote
+# ``engine``) para que os importes da engine funcionem, como em
+# ``executar_scanner.py``.
+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.scanner.retakes import (
     STATUS_CONFIRMADO,
     STATUS_IGNORADO,