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

admin/DEV-NOTES.md

@@ -1,9 +1,11 @@
 # DEV-NOTES — Registro de Alterações (Jhonny Editor)
 
 > **Como usar:**
-> 1. Ao fazer alterações, adicione bullets na seção `## NOVO NESTE LOTE`
-> 2. Rod `admin/deploy.command` — ele lê essas notas e usa como descrição do commit
-> 3. Após o deploy, mova os bullets para `## Histórico` e esvazie `NOVO NESTE LOTE`
+> 1. Para alterações feitas pelo agente, use `admin/COMMIT-DETAILS.md`.
+> 2. Rode `admin/deploy.command` — ele usa o resumo como detalhe do commit.
+> 3. Após um commit bem-sucedido, o arquivo temporário é limpo automaticamente.
+>
+> O bloco abaixo continua como fallback para notas manuais ou histórico do projeto.
 
 ---
 

admin/deploy.command

@@ -21,6 +21,7 @@ umask 077
 ROOT="$(cd "$(dirname "$0")/.." && pwd -P)"
 ADMIN="$ROOT/admin"
 NOTES="$ADMIN/DEV-NOTES.md"
+COMMIT_DETAILS="$ADMIN/COMMIT-DETAILS.md"
 REMOTE="origin"
 BRANCH="main"
 
@@ -57,10 +58,16 @@ echo "   ... ($(echo "$CHANGES" | grep -c .) itens)"
 echo
 
 # ------------------------------------------------------------
-# 2) Extrair notas do DEV-NOTES.md
+# 2) Extrair detalhes preparados pelo agente
 # ------------------------------------------------------------
 MSG_NOTA=""
-if [[ -f "$NOTES" && -s "$NOTES" ]]; then
+if [[ -f "$COMMIT_DETAILS" && -s "$COMMIT_DETAILS" ]]; then
+  MSG_NOTA="$(sed 's/^[[:space:]]*//; s/[[:space:]]*$//' "$COMMIT_DETAILS" \
+    | grep -v '^$' \
+    | grep -v '^<!--' \
+    | grep -v '^-->' || true)"
+fi
+if [[ -z "$MSG_NOTA" && -f "$NOTES" && -s "$NOTES" ]]; then
   MSG_NOTA="$(awk '
     /^## NOVO NESTE LOTE/ {f=1; next}
     /^## / && f {exit}
@@ -124,6 +131,9 @@ fi
 say "Adicionando arquivos e commitando..."
 git add -A
 git commit -m "$COMMIT_MSG" || die "commit falhou"
+if [[ -f "$COMMIT_DETAILS" ]]; then
+  : > "$COMMIT_DETAILS"
+fi
 ok "commit criado: $(git rev-parse --short HEAD)"
 echo