Merge branch 'pr726' into reconciliacao/726

# Conflicts:
#	hostgator-setup-kit/_common.sh

Author: Pessoa

.changes/instalador-nao-para-sem-crontab.md

@@ -0,0 +1,11 @@
+---
+impacto: nada_mudou
+secao: corrigido
+titulo: O instalador não para mais em "Ativando as automações" numa VPS nova
+---
+
+Numa VPS recém-criada, o root ainda não tem agendamento nenhum, e o instalador
+parava logo depois de "chave de cifra ativa no banco", sem mensagem de erro,
+mostrando "A instalação parou" com o CRM já no ar. Rodar o instalador de novo
+contornava. Agora ele agenda as automações e o agente de atualização direto,
+na primeira rodada. Quem já instalou não precisa fazer nada. Crédito: @rafaelbatistazz.

hostgator-setup-kit/_common.sh

@@ -805,9 +805,25 @@ setup_event_log_drain_cron() {
   # O dono vê o script morrer sem mensagem, numa instalação que na verdade
   # funcionou.
   #
+  # ACHADO DUAS VEZES, POR DUAS PESSOAS QUE NÃO SE FALARAM, NO MESMO DIA:
+  # @luiscgc91 (PR #683) e @rafaelbatistazz (issue #715 + PR #726), os dois
+  # instalando numa VPS limpa. Os dois escreveram EXATAMENTE a mesma linha. Isso
+  # não é redundância — é a medida de quanto o defeito doía, e a razão de este
+  # comentário ser longo: ele existe para a terceira pessoa não precisar
+  # descobrir de novo.
+  #
+  # A issue #715 descreve o sintoma como quem o viveu: o instalador para logo
+  # depois de "✓ chave de cifra ativa no banco", cai na tela "A instalação
+  # parou", e os contêineres estão SAUDÁVEIS. Rodar de novo passa — porque aí o
+  # crontab já não está vazio, o que faz o defeito parecer fantasma.
+  #
   # Reproduzido com um dublê de `crontab` que sai 1 no `-l`: sem o `|| true`, a
-  # linha seguinte a este bloco nunca é alcançada. Vigiado por
-  # `tests/shell/cron-sem-crontab-previo.test.sh`.
+  # linha seguinte a este bloco nunca é alcançada. Vigiado por DOIS testes, de
+  # propósito: `tests/shell/cron-sem-crontab-previo.test.sh` mede cada função
+  # isolada, e o bloco `cron numa VPS sem crontab nenhum` de
+  # `hostgator-setup-kit/test-validators.sh` (de @rafaelbatistazz) roda AS DUAS
+  # no mesmo processo — como o `install.sh` faz — e confere que as duas linhas
+  # foram gravadas.
   #
   # Stdin vazio para o `cron_merge` é exatamente o que "sem crontab prévio" deve
   # produzir — o comportamento não muda, só o status.

hostgator-setup-kit/test-validators.sh

@@ -2566,6 +2566,33 @@ reexec_neg() {
 reexec_neg
 reexec_ok "o bloco de variáveis conhecidas acha o kit depois do cd"
 
+echo "cron numa VPS sem crontab nenhum (#715)"
+# VPS nova não tem crontab para o root: `crontab -l` sai 1. As rodadas acima
+# nunca mediram isso, porque o sandbox já tinha linhas quando elas agendavam — e
+# o install.sh morria em "Ativando as automações" em toda VPS recém-criada. As
+# duas funções rodam aqui sob o MESMO `set -euo pipefail` do install.sh, com o
+# dublê de crontab apontado para um arquivo que não existe.
+cron_vazio() (
+  # Subshell: `montar_vps` define VPS_* globais, e os blocos seguintes da suíte
+  # não podem herdar esta fixture.
+  montar_vps "$SUITE_TMP/cron-vazio" projeto < <(printf '#!/bin/sh\nexit 0\n')
+  local sandbox="$SUITE_TMP/crontab-vazio.txt"; rm -f "$sandbox"
+  local out rc
+  out="$(cd "$VPS_PROJ" && env PATH="$VPS_RAIZ/bin:$PATH" CRONTAB_SANDBOX="$sandbox" \
+    INTERNAL_SECRET=segredo-de-teste NEXT_PUBLIC_APP_URL=https://crm.exemplo.com.br PROJECT_DIR="$VPS_PROJ" \
+    bash -c 'set -euo pipefail; . "$1/_common.sh"; psql_run() { :; }
+             setup_event_log_drain_cron; setup_update_agent_cron; echo CHEGOU-AO-FIM' _ "$VPS_RAIZ" 2>&1)" \
+    && rc=0 || rc=$?
+  if [ $rc -ne 0 ] || ! printf '%s' "$out" | grep -q CHEGOU-AO-FIM; then
+    printf '  ✗ agendar o cron numa VPS sem crontab derrubou o script (saída %s)\n' "$rc"; return 1
+  fi
+  if [ "$(grep -c '# deskcomm:' "$sandbox" 2>/dev/null)" != 2 ]; then
+    printf '  ✗ esperava 2 linhas (drain + agente) no crontab, veio %s\n' "$(grep -c '# deskcomm:' "$sandbox" 2>/dev/null || echo 0)"; return 1
+  fi
+  printf '  ✓ sem crontab prévio, drain e agente agendados e o script segue\n'
+)
+cron_vazio || fail=1
+
 echo "isolamento: a suíte não escreve no crontab da máquina"
 # Isto não é hipótese defensiva: os testes JÁ escreveram 10 linhas órfãs no
 # crontab do mantenedor, uma delas um `curl` com Bearer disparando a cada minuto