deploy-plugin

name	deploy-plugin
description	Realiza o deploy do plugin whatsapp-manager no servidor Hermes — commit, push, pull e restart do container.
category	deploy

Deploy do Plugin WhatsApp Manager

Esta skill guia o processo completo de deploy de alterações no plugin whatsapp-manager para o servidor Hermes em produção.

---

Quando usar esta skill

Use quando o usuário disser algo como:

• "faz o deploy"
• "publica as alterações"
• "sobe pro servidor"
• "atualiza o plugin"
• "deploy do whatsapp"
• "deploy do plugin"
• "manda pro hermes"

---

Pré-requisitos

• O repositório local está no workspace ativo
• O remote origin aponta para o repositório no GitHub
• O servidor Hermes tem o plugin clonado em /opt/data/.hermes/plugins/whatsapp-manager
• Acesso ao Dashboard do Hermes e ao Portainer do servidor

---

Etapa 1 — Commit e Push no GitHub

1.1 Verificar o que mudou

git status

Revisar as alterações e confirmar com o usuário se está tudo certo.

1.2 Adicionar e commitar

git add -A && git commit -m "MENSAGEM_DO_COMMIT"

Regra: A mensagem de commit deve ser descritiva e em português. Exemplos:

• fix: bot continuava respondendo após stop_bot
• feat: adiciona delay na primeira resposta ao cliente
• chore: atualiza SOUL_WHATSAPP.md com novas regras

1.3 Push para o GitHub

git push origin main

Se der erro de divergência, usar git pull --rebase origin main antes do push.

---

Etapa 2 — Git Pull no Dashboard do Hermes

O plugin é atualizado diretamente pelo painel do Hermes, na aba de Plugins.

2.1 Acessar o Dashboard do Hermes

1. Acesse o Dashboard do Hermes
2. Navegue até a aba Plugins

2.2 Atualizar o plugin

1. Localize o plugin whatsapp-manager na lista
2. Clique no botão de Pull / Atualizar do plugin
3. Aguarde a confirmação de que o pull foi concluído

Verificar: Confirme que a mensagem de sucesso aparece. Se aparecer Already up to date, o push da Etapa 1 pode não ter sido concluído.

---

Etapa 3 — Restart do Container

As alterações no plugin só são carregadas quando o Hermes reinicia.

Opção A — Pelo Portainer (Recomendado)

1. Acesse o Portainer do servidor
2. Vá em Containers → selecione o container do Hermes
3. Clique em Restart
4. Aguarde o container subir (status running)

Opção B — Pelo Portainer Stack

1. Vá em Stacks → selecione a stack do Hermes
2. Clique em Update the stack → Update

Opção C — Via CLI (se tiver acesso SSH ao host)

docker restart hermes

---

Verificação Pós-Deploy

Conferir se o container subiu

No Portainer → Containers → verificar que o status é running e que o uptime é recente (poucos segundos/minutos).

Conferir logs do plugin

No terminal do container (via Console do Portainer):

grep "whatsapp-manager" /opt/data/.hermes/logs/hermes.log | tail -20

Procurar por:

• ✓ bridge.js atualizado — confirma que o bridge foi copiado
• ✓ Skills registradas — confirma que as skills carregaram
• Ausência de erros ⚠️ ou ❌

Testar o bot

Envie start_bot ou stop_bot no WhatsApp para confirmar que o bridge está respondendo.

---

Troubleshooting

Problema	Solução
git pull dá conflito no container	cd /opt/data/.hermes/plugins/whatsapp-manager && git reset --hard origin/main
Container não sobe após restart	Verificar logs no Portainer → Containers → Logs
Plugin não carrega as alterações	Conferir se o git pull trouxe os arquivos e se o container foi reiniciado
bridge.js não atualiza no bridge	O register() do plugin copia automaticamente no boot — verificar logs por bridge.js atualizado
Push rejeitado por divergência	git pull --rebase origin main && git push origin main

---

Notas Importantes

• O branch principal é main
• O plugin é carregado automaticamente pelo Hermes no boot via register() em __init__.py
• O bridge.js é copiado automaticamente do plugin para /opt/data/.hermes/platforms/whatsapp/bridge/ durante o register()
• Arquivos como SOUL_WHATSAPP.md, support_rules.md e SOUL_EMAIL.md são baixados automaticamente na primeira inicialização se não existirem no volume
• O bot_state.json (estado de pause do bot) é persistido e não é afetado pelo restart