| name | correcao-fechamento-diario |
| description | Correção do bug de timezone no script fechamento_diario.sh. O date capturava UTC, causando data errada quando executado próximo à meia-noite BRT. |
| category | devops |
Correção: Bug de Timezone no fechamento_diario.sh
Problema
O script {{COMMANDER_HOME}}/projects/pycode-cerebro/scripts/fechamento_diario.sh usava date +%d-%m-%Y sem especificar timezone. O servidor OVH roda em UTC. Quando o script executa às 22:55 BRT (01:55 UTC do dia seguinte), o arquivo hoje.md é renomeado com a data errada (dia anterior).
Exemplo: hoje.md de 11/05/2026 foi renomeado para grupo_10-05-2026.md em vez de grupo_11-05-2026.md.
Causa Raiz
Linha afetada (original):
DATA=$(date +%d-%m-%Y)
Correção Aplicada
DATA=$(TZ=America/Sao_Paulo date +%d-%m-%Y)
Localização do Script
{{COMMANDER_HOME}}/projects/pycode-cerebro/scripts/fechamento_diario.sh
Verificação
Após correção, verificar com:
TZ=America/Sao_Paulo date +%d-%m-%Y
Deve retornar a data correta no horário de São Paulo.
Impacto
- Arquivos historicos em
{{COMMANDER_HOME}}/projects/pycode-cerebro/data/historico/
- Arquivos de blog em
{{COMMANDER_HOME}}/projects/pycode-cerebro/public/content/blog/
- Processo PM2:
fechamento-pycode (precisa estar online)
Protocolo de Diagnóstico — Blog Genérico ou de Baixa Qualidade
Quando um blog gerado sai resumido, genérico, com alucinações ou contaminação de outros dias, seguir este roteiro:
1. Linha do tempo — stat nos arquivos
stat {{COMMANDER_HOME}}/projects/pycode-cerebro/public/content/blog/YYYY-MM-DD.md
stat {{COMMANDER_HOME}}/projects/pycode-cerebro/scripts/sintetizador.py
- Comparar
Modify do blog vs horário esperado do fechamento (22:55 BRT)
- Se o blog foi gerado muito antes das 22:55 → execução prematura, input incompleto
2. Tamanho do input vs output
wc -l -c {{COMMANDER_HOME}}/projects/pycode-cerebro/data/historico/grupo_DD-MM-YYYY.md
wc -c {{COMMANDER_HOME}}/projects/pycode-cerebro/public/content/blog/YYYY-MM-DD.md
- Comparar com outros dias para detectar anomalia (ex: input maior mas output menor)
3. Status do PM2
pm2 show fechamento-pycode | grep -E "status|cron restart"
4. Contaminação e alucinação
- Ler o blog e o input lado a lado
- Verificar se há menções a fatos/pessoas que não estão no input → alucinação
- Verificar se há conteúdo de outro dia → contaminação (input continha mensagens de múltiplos dias)
5. Log do sintetizador
grep -E "Processando|destilar|Dia DD/MM|Erro|Aviso|fallback" {{COMMANDER_HOME}}/.pm2/logs/fechamento-pycode-out.log
- "Processando N dias" → código antigo com
grupo.txt (se N > 1)
- "Aviso: O modelo não devolveu o separador" → fallback ativado, qualidade comprometida
- Ausência de "destilar conhecimento do dia DD/MM" → trava de reprocessamento bloqueou
6. Regeneração
cd {{COMMANDER_HOME}}/projects/pycode-cerebro/scripts
source {{COMMANDER_HOME}}/hermes_env/bin/activate
python3 sintetizador.py --arquivo {{COMMANDER_HOME}}/projects/pycode-cerebro/data/historico/grupo_DD-MM-YYYY.md
O flag --arquivo pula a trava de reprocessamento.
Defesas Anti-Alucinação (adicionadas 16/05/2026)
Implementadas no sintetizador.py após incidente do blog 14/05 (blog gerado às 09:41 com ~10 linhas de input, 80% alucinado):
| # | Defesa | Gatilho |
|---|
| 1 | Parser de linhas órfãs | Linhas sem timestamp herdam data da última mensagem |
| 2 | Threshold mínimo de 2000 chars | len(texto_dia) < 2000 → aborta com warning, não chama IA |
| 3 | Heurística de qualidade na trava | Blog existente < 500 bytes → remove e regenera no cron |
| 4 | Log de auditoria | Toda execução registra whoami, PID, timestamp e args |
Alteração do Prompt (16/05/2026)
Linha 121 do sintetizador.py alterada para:
- Relevância: Priorize discussões técnicas, dicas de ferramentas e decisões do grupo. Quando o dia tiver pouco conteúdo técnico, inclua também outros assuntos discutidos (off-topic, comunidade, eventos, descontração) para manter um registro fiel do que aconteceu no grupo.
Permite resumo não-técnico em dias fracos de tech, evitando alucinação por falta de conteúdo.
Lição: Gatilho Prematuro via Terminal
Incidente 14/05: blog gerado às 09:41 BRT porque {{COMMANDER}} executou o sintetizador manualmente do terminal (.zsh_history modificado às 09:40). O hoje.md tinha apenas ~10 linhas de small talk. O cron das 22:55 encontrou arquivo existente e preservou a versão alucinada. As defesas #2 e #3 acima previnem recorrência.
Dependência
- PM2 cron job
fechamento-pycode com agendamento 55 22 * * *. Status stopped é normal entre execuções.
- Se o cron não estiver configurado, recriar:
pm2 start {{COMMANDER_HOME}}/projects/pycode-cerebro/scripts/fechamento_diario.sh --name fechamento-pycode --cron "55 22 * * *"
- Requer
OPENCODE_GO_API_KEY válida no .env
Bug Relacionado: Contaminação por grupo.txt Cumulativo
Diagnóstico (2026-05-15, {{AUDITOR}})
O sintetizador.py processa grupo.txt + hoje.md como fontes. O grupo.txt nunca é truncado, acumulando:
- 590+ linhas órfãs de data (mensagens multilinha do WhatsApp sem timestamp)
- Histórico de meses já arquivados em
grupo_DATA.md
Isso infla o bucket do dia corrente (ex: 857 mensagens em vez de ~94) e o truncamento texto_dia[:18000] corta fora o conteúdo relevante, gerando blog genérico.
Correção (delegada à {{BACKEND_ENGINEER}})
sintetizador.py linha ~67: remover grupo.txt das fontes, manter apenas hoje.md- Truncar
grupo.txt com truncate -s 0
- Prompt: adicionar trava de escopo — "Use APENAS as informações contidas no LOG abaixo"
- Auditar
fechamento_diario.sh para truncar grupo.txt após renomeação do hoje.md
