Tu brief de cron de las 7 parece un aviso automático: dos interruptores lo arreglan

Cada mañana llega un brief a Telegram: cuántos PRs se fusionaron ayer, si el build pasó, cualquier cosa que espere una decisión tuya. El contenido está bien. La primera pantalla no:
Cronjob Response: Morning brief
(job_id: 8322078a1a06)
-------------
12 PRs merged yesterday...
Cuatro líneas de relleno se comen la vista previa de la notificación e hacen que todo suene a aviso de sistema que puedes ignorar sin problema. Baja hasta el final y hay una línea más explicando cómo parar el job.
El formato es el problema pequeño. El grande aparece en el momento en que respondes: «¿cuál era el tercer PR?». El agente no tiene ni idea de qué le hablas, porque ese mensaje nunca formó parte de la conversación: era una notificación de un solo sentido.
Los dos problemas tienen su propio interruptor, y los dos son por job.
Interruptor uno: dejar de envolver la salida
El wrapper está activo por defecto, de forma global, en cron.wrap_response. Cuando está activo, cada entrega se viste así:
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 un aviso puntual del tipo «recuérdame apagar la pasta en 20 minutos» es genuinamente útil: necesitas saber cómo cancelarlo. Para un brief que llega a la misma hora todos los días, es simple ruido.
Ahora puedes sobrescribirlo por job:
# créalo limpio
hermes cron create "0 7 * * *" "Summarize yesterday's PRs and build status in under 200 words." \
--name "Morning brief" --no-wrap-response
# arregla un job que ya existe
hermes cron edit 8322078a1a06 --no-wrap-response
# vuelve a seguir el valor global (que es true)
hermes cron edit 8322078a1a06 --inherit-wrap-response
Los tres flags son exactamente lo que parecen: --wrap-response fuerza el wrapper, --no-wrap-response lo desactiva a la fuerza y --inherit-wrap-response borra la sobrescritura de este job para que vuelva a seguir cron.wrap_response. El último importa después de haber experimentado: elimina el campo en lugar de dejar un false detrás, así que un cambio posterior en el valor global llega al job.
Si todos los briefs de la máquina deben ir limpios, ponlo global:
cron:
wrap_response: false
Eso se aplica a los jobs existentes y a los futuros; cualquier job con un ajuste explícito sigue ganando.
Interruptor dos: dar a los follow-ups su propio hilo
Una notificación es fire-and-forget. Para que un brief sea algo a lo que puedas responder, el job tiene que ser continuable:
cron:
mirror_delivery: true # las entregas entran en el historial de la conversación destino
o, para un solo job:
hermes cron edit 8322078a1a06 --attach-to-session
Con eso activo, el comportamiento prefiere el hilo:
- Plataformas con hilos (temas de foro de Telegram, hilos de Discord / Slack / Matrix): cada entrega abre un hilo dedicado y el brief se siembra en la sesión de ese hilo, así que una respuesta continúa con el brief completo en contexto.
- Plataformas solo de DM (WhatsApp, Signal, SMS): no hay hilos, así que el brief se refleja en la sesión del DM destino y el propio DM es la superficie de continuación.
- El reflejo se escribe como un turno de usuario etiquetado,
[Cron delivery: <job name>], que mantiene el historial legible y la alternancia de turnos válida entre proveedores.
Hay un detalle que despista a mucha gente: un job creado dentro de un tema de Telegram sigue entregando a ese tema, porque su origen fija el destino. Eso es justo lo que un brief recurrente no quiere; si no, el follow-up de ayer y el brief de hoy comparten hilo y «¿y el segundo?» queda ambiguo.
Para esos jobs hay un interruptor a nivel de plataforma:
platforms:
telegram:
extra:
cron_fresh_thread_per_run: true
Solo afecta a las entregas de vuelta al tema del propio job; un destino explícito chat_id:thread_id nunca se sobrescribe. Discord es la excepción: no puede anidar un hilo dentro del hilo del job, así que un job creado en un hilo de Discord sigue entregando ahí.
Ya que estás: dos ajustes de temporización
Dos ajustes más por job explican la mayoría de las preguntas del tipo «¿por qué no me llegó el brief hoy?».
catch_up: qué pasa con las ejecuciones perdidas mientras la máquina estaba apagada. --catch-up on ejecuta la ocurrencia perdida una vez al volver; off la salta y la anota como fila missed en hermes cron runs. El valor por defecto sigue a cron.catch_up_missed (true) en jobs recurrentes, y los puntuales se saltan: un recordatorio «dentro de 20 minutos» no vale nada con dos horas de retraso.
grace_minutes: cuánto puede llegar tarde una ejecución. La ventana por defecto es la mitad del periodo, recortada entre 2 y 120 minutos. --grace-minutes 0 es un valor real, no «sin definir»: nunca recupera, así que una ocurrencia perdida se salta en lugar de correr tarde. Un job nocturno que debe ejecutarse aunque el portátil despierte tarde se puede ampliar hasta 1440 minutos (un día).
--timezone: con qué reloj de pared se lee la expresión cron. Si lo omites, se aplica la zona del profile. El bug clásico que arregla es «yo puse las 9 de la mañana, seguro», escrito en una zona que no era la que querías.
Un ejemplo configurado
Juntando todo, un brief limpio, respondible y de las 7 de la mañana en Hong Kong queda así:
hermes cron create "0 7 * * *" \
"Collect yesterday's PRs, build and deploy results into a brief under 200 words; if nothing is wrong, say so in one line." \
--name "Morning brief" \
--timezone Asia/Hong_Kong \
--no-wrap-response \
--attach-to-session \
--catch-up on
y en config.yaml, un hilo nuevo por ejecución en Telegram:
platforms:
telegram:
extra:
cron_fresh_thread_per_run: true
El resultado: un brief limpio en su propio hilo a las 7, y cuando respondes «¿quién fusionó el tercer PR?» el agente sabe de qué brief y de qué ítem le hablas.
Detalles que conviene conocer
- Desactivar el wrapper no cambia nada de la entrega en sí: el destino, los avisos de fallo y los reintentos quedan intactos; solo desaparece la decoración del texto.
- Los avisos de fallo tienen su propio interruptor.
failure_deliverenruta los mensajes de fallo a otro sitio, ylocallos suprime del todo aunque sigue registrando el fallo enhermes cron listyhermes cron runs. - Continuable no es «una sesión sin fin». Los hilos son por ejecución y los historiales por hilo. Si quieres que un job vea su propia salida anterior entre ejecuciones, eso es
--continuity, otra feature distinta; no las mezcles. - No todo destino puede ser continuable. Las expansiones de broadcast (
deliver: all) nunca se reflejan, porque eso reescribiría varias conversaciones a la vez.
Si tu setup de cron falla en general, empieza por hermes cron doctor; si quieres un job que recuerde lo que reportó la última vez, lee continuidad de memoria en cron. La lista completa de flags está en la referencia de hermes cron, y este cambio llegó en v0.23.2.
En resumen
Que un brief suene a aviso automático o a mensaje de un colega depende de dos capas: el wrapper (wrap_response) decide cómo se ve, y la entrega continuable (attach_to_session, más un hilo nuevo por ejecución) decide si puedes responderle. Las dos son un flag por job, las dos se hacen en menos de un minuto y las dos se notan cada mañana.