O resumo das 7h no cron parece aviso de máquina — dois interruptores resolvem

Toda manhã um resumo chega no Telegram: quantos PRs foram mesclados ontem, se o build passou, qualquer coisa esperando sua decisão. O conteúdo está ótimo. A primeira tela, não:
Cronjob Response: Morning brief
(job_id: 8322078a1a06)
-------------
12 PRs merged yesterday...
Quatro linhas de texto padrão comem a prévia da notificação e fazem o conjunto parecer um aviso de sistema que você pode ignorar sem culpa. Role até o fim e tem mais uma linha explicando como parar o job.
A formatação é o problema pequeno. O maior aparece no instante em que você responde: “qual foi o terceiro PR?” O agente não tem ideia do que você está falando, porque aquela mensagem nunca fez parte da conversa — foi uma notificação de mão única.
Os dois problemas têm interruptor próprio, e os dois são por job.
Interruptor um: parar de embrulhar a saída
O wrapper vem ligado por padrão, globalmente, em cron.wrap_response. Quando está ligado, toda entrega fica vestida assim:
Cronjob Response: <job name>
(job_id: <job id>)
-------------
<the actual content>
To stop or manage this job, send me a new message (e.g. "stop reminder <job name>").
Para um “me lembra de tirar o macarrão do fogo em 20 minutos” de uso único, isso é genuinamente útil: você precisa saber como cancelar. Para um resumo que chega no mesmo horário todo dia, é só ruído.
Agora você pode sobrescrever isso por job:
# criar já limpo
hermes cron create "0 7 * * *" "Resuma os PRs de ontem e o status do build em menos de 200 palavras." \
--name "Morning brief" --no-wrap-response
# corrigir um job existente
hermes cron edit 8322078a1a06 --no-wrap-response
# voltar a seguir o padrão global (que é true)
hermes cron edit 8322078a1a06 --inherit-wrap-response
As três flags são exatamente o que parecem: --wrap-response força o wrapper ligado, --no-wrap-response força desligado, e --inherit-wrap-response remove a sobrescrita deste job para que ele volte a seguir cron.wrap_response. Essa última importa depois que você experimentou: ela apaga o campo em vez de deixar um false para trás, então uma mudança posterior no padrão global chega ao job.
Se todo resumo da máquina deve sair limpo, configure globalmente:
cron:
wrap_response: false
Isso vale para jobs existentes e futuros; qualquer job com ajuste explícito continua ganhando.
Interruptor dois: dar aos follow-ups uma thread própria
Uma notificação é dispara e esquece. Para transformar um resumo em algo em que você consegue responder, o job precisa ser continuável:
cron:
mirror_delivery: true # as entregas entram no histórico da conversa de destino
ou, para um job específico:
hermes cron edit 8322078a1a06 --attach-to-session
Com isso ligado, o comportamento prefere thread:
- Plataformas com threads (tópicos de fórum do Telegram, threads de Discord / Slack / Matrix): cada entrega abre uma thread dedicada e o resumo é semeado na sessão daquela thread, então uma resposta continua com o resumo inteiro no contexto.
- Plataformas só de DM (WhatsApp, Signal, SMS): não existem threads, então o resumo é espelhado na sessão de DM de destino e a própria DM é a superfície de continuação.
- O espelho é escrito como um turno de usuário rotulado,
[Cron delivery: <job name>], o que mantém o histórico legível e mantém a alternância de turnos válida entre providers.
Tem um detalhe que derruba muita gente: um job criado dentro de um tópico do Telegram continua entregando naquele tópico, porque a origem dele fixa o destino. É precisamente o que um resumo recorrente não quer — senão o follow-up de ontem e o resumo de hoje dividem a mesma thread, e “e o segundo?” fica ambíguo.
Para esses jobs existe um interruptor no nível da plataforma:
platforms:
telegram:
extra:
cron_fresh_thread_per_run: true
Ele afeta apenas entregas de volta ao tópico do próprio job; um destino explícito chat_id:thread_id nunca é sobrescrito. O Discord é a exceção: ele não consegue aninhar uma thread dentro da thread do job, então um job criado numa thread do Discord continua entregando ali.
Já que você está aí: dois ajustes de tempo
Mais dois ajustes por job explicam a maioria das perguntas do tipo “por que meu resumo não chegou hoje”.
catch_up: o que acontece com execuções perdidas enquanto a máquina estava desligada. --catch-up on roda a ocorrência perdida uma vez no retorno; off pula e registra como uma linha missed em hermes cron runs. O padrão segue cron.catch_up_missed (true) para jobs recorrentes, e os de uso único pulam — um lembrete de “daqui a 20 minutos” não vale nada duas horas atrasado.
grace_minutes: quanto atraso uma execução aceita. A janela padrão é metade do período, limitada a 2–120 minutos. --grace-minutes 0 é um valor real, não “não definido”: nunca há recuperação, então uma ocorrência perdida é pulada em vez de rodar atrasada. Um job noturno que precisa rodar mesmo se o notebook acordar tarde pode ser ampliado até 1440 minutos (um dia).
--timezone: em qual relógio de parede a expressão cron é lida. Omita e vale o fuso do profile. O bug clássico que isso conserta é “eu tenho certeza de que escrevi 9h” — escrito num fuso que não era o que você queria.
Um exemplo configurado
Juntando tudo, um resumo limpo, respondível, das 7h de Hong Kong fica assim:
hermes cron create "0 7 * * *" \
"Colete os PRs de ontem, os resultados de build e de deploy num resumo de menos de 200 palavras; se nada estiver errado, diga isso em uma linha." \
--name "Morning brief" \
--timezone Asia/Hong_Kong \
--no-wrap-response \
--attach-to-session \
--catch-up on
e em config.yaml, uma thread nova por execução no Telegram:
platforms:
telegram:
extra:
cron_fresh_thread_per_run: true
O resultado: um resumo limpo na própria thread às 7h, e quando você responde “quem mesclou o terceiro PR?” o agente sabe de qual resumo e de qual item você está falando.
Detalhes que valem conhecer
- Desligar o wrapper não muda nada na entrega em si — destino, avisos de falha e retries ficam intactos; só a decoração do texto vai embora.
- Avisos de falha têm interruptor próprio.
failure_deliverroteia mensagens de falha para outro lugar, elocalas suprime por completo, registrando a falha ainda assim emhermes cron listehermes cron runs. - Continuável não é “uma sessão sem fim”. As threads são por execução e os históricos são por thread. Se você quer que um job veja a própria saída anterior entre execuções, isso é
--continuity, outra funcionalidade — não misture as duas. - Nem todo destino pode ser continuável. Expansões de broadcast (
deliver: all) nunca são espelhadas, porque isso reescreveria várias conversas de uma vez.
Se sua configuração de cron está se comportando mal de forma geral, comece por hermes cron doctor; se você quer um job que lembre o que reportou da última vez, leia continuidade de memória do cron. A lista completa de flags está na referência de hermes cron, e essa mudança chegou na v0.23.2.
A versão curta
Se um resumo parece aviso de máquina ou mensagem de um colega depende de duas camadas: o wrapper (wrap_response) decide como ele aparece, e a entrega continuável (attach_to_session, mais uma thread nova por execução) decide se você consegue responder a ele. Os dois são uma flag por job, os dois levam menos de um minuto, e os dois compensam toda manhã.