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_deliver roteia mensagens de falha para outro lugar, e local as suprime por completo, registrando a falha ainda assim em hermes cron list e hermes 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ã.