chore(agent): adicionar verificacao diaria do bun com bun upgrade --stable

TOOLS

@@ -106,6 +106,11 @@ Este documento lista ferramentas de linha de comando (CLI) e utilitários que ot
 
 ## 7. Utilitários Nativos do Framework .agent
 
+### atualizar-submodulo.sh (`.agent/scripts/atualizar-submodulo.sh`)
+- **Descrição:** Script de ciclo de vida acionado automaticamente via hook `PreInvocation` (`.agent/hooks.json`) ou manualmente via CLI.
+- **Por que ajuda as IAs e Operadores:** Garante que o submódulo `.agent` esteja sincronizado na branch `master` remota no início de cada sessão de conversa (`1x por sessão`) e verifica automaticamente **uma vez por dia** se o runtime Bun está atualizado na versão estável mais recente executando `bun upgrade --stable` (controlado via trava diária `/tmp/.antigravity_bun_upgrade_date`).
+- **Uso:** `bash .agent/scripts/atualizar-submodulo.sh`
+
 ### notificar.sh (`.agent/notificar.sh`)
 - **Descrição:** Utilitário unificado de notificação para o Sistema Operacional, compatível nativamente com **Linux** e **macOS**.
 - **Por que ajuda as IAs e Operadores:** Permite que comandos de longa duração (como `/plano.executar todos` e loops `/goal`) avisem o operador imediatamente no momento da conclusão, emitindo popup no desktop (KDE `kdialog`, FreeDesktop `notify-send` / `gdbus`, macOS Notification Center via `osascript`), som de alerta discreto (PipeWire, PulseAudio ou macOS `afplay`) e campainha no terminal (`\a`). Totalmente assíncrono, não-bloqueante e seguro para ambientes headless.