Votre brief cron de 7 h ressemble à un avis machine — deux interrupteurs suffisent


Chaque matin, un brief arrive dans Telegram : combien de PR ont été fusionnées la veille, si le build est passé, tout ce qui attend votre décision. Le contenu est bon. Le premier écran ne l’est pas :

Cronjob Response: Morning brief
(job_id: 8322078a1a06)
-------------

12 PRs merged yesterday...

Quatre lignes de boilerplate mangent l’aperçu de la notification et donnent à l’ensemble l’allure d’un avis système qu’on peut ignorer sans risque. Faites défiler jusqu’en bas : une ligne de plus explique comment arrêter la tâche.

Le formatage est le petit problème. Le gros apparaît à la seconde où vous répondez : « c’était quelle troisième PR ? » L’agent ne sait pas de quoi vous parlez, parce que ce message n’a jamais fait partie de la conversation — c’était une notification à sens unique.

Les deux problèmes ont leur propre interrupteur, et les deux sont par tâche.

Premier interrupteur : arrêter d’emballer la sortie

L’emballage est actif par défaut, au niveau global, sous cron.wrap_response. Quand il est actif, chaque livraison est habillée ainsi :

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>").

Pour un « rappelle-moi de sortir les pâtes dans 20 minutes » ponctuel, c’est réellement utile : il faut savoir comment annuler. Pour un brief qui arrive à la même heure chaque jour, c’est du simple bruit.

Vous pouvez désormais le surcharger par tâche :

# le créer propre du premier coup
hermes cron create "0 7 * * *" "Summarize yesterday's PRs and build status in under 200 words." \
  --name "Morning brief" --no-wrap-response

# corriger une tâche existante
hermes cron edit 8322078a1a06 --no-wrap-response

# revenir au défaut global (qui vaut true)
hermes cron edit 8322078a1a06 --inherit-wrap-response

Les trois flags sont exactement ce qu’ils annoncent : --wrap-response force l’emballage, --no-wrap-response le coupe, et --inherit-wrap-response supprime la surcharge de cette tâche pour qu’elle suive de nouveau cron.wrap_response. Ce dernier compte après vos expérimentations : il supprime le champ au lieu de laisser un false traîner, donc un changement ultérieur du défaut global atteint bien la tâche.

Si tous les briefs de la machine doivent être propres, réglez-le au niveau global :

cron:
  wrap_response: false

Cela s’applique aux tâches existantes comme aux futures ; toute tâche avec un réglage explicite gagne toujours.

Deuxième interrupteur : donner aux follow-ups leur propre fil

Une notification est du fire-and-forget. Pour qu’un brief devienne quelque chose dans quoi vous pouvez répondre, la tâche doit être continuable :

cron:
  mirror_delivery: true    # les livraisons entrent dans l'historique de la conversation cible

ou, pour une seule tâche :

hermes cron edit 8322078a1a06 --attach-to-session

Activé, le comportement privilégie le fil :

  • Plateformes à fils (topics de forum Telegram, threads Discord / Slack / Matrix) : chaque livraison ouvre un fil dédié et le brief est injecté dans la session de ce fil, donc une réponse reprend avec tout le brief en contexte.
  • Plateformes en DM uniquement (WhatsApp, Signal, SMS) : il n’y a pas de fils, donc le brief est mirroré dans la session DM cible et le DM lui-même sert de surface de continuation.
  • Le miroir est écrit comme un tour utilisateur étiqueté, [Cron delivery: <job name>], ce qui garde l’historique lisible et l’alternance des tours légale d’un provider à l’autre.

Un détail piège les gens : une tâche créée à l’intérieur d’un topic Telegram continue de livrer dans ce topic, parce que son origine fige la cible. C’est précisément ce qu’un brief récurrent ne veut pas — sinon le follow-up d’hier et le brief d’aujourd’hui partagent un fil, et « et le deuxième, alors ? » devient ambigu.

Pour ces tâches, il existe un interrupteur au niveau plateforme :

platforms:
  telegram:
    extra:
      cron_fresh_thread_per_run: true

Il n’affecte que les livraisons vers le topic de la tâche elle-même ; une cible explicite chat_id:thread_id n’est jamais surchargée. Discord fait exception : il ne peut pas imbriquer un fil dans le fil de la tâche, donc une tâche créée dans un thread Discord continue d’y livrer.

Pendant que vous y êtes : deux réglages de timing

Deux autres réglages par tâche expliquent la plupart des « pourquoi mon brief n’est pas arrivé aujourd’hui ».

catch_up : ce qui arrive aux exécutions manquées pendant que la machine était éteinte. --catch-up on rejoue l’occurrence manquée une fois au retour ; off la saute et l’inscrit comme ligne missed dans hermes cron runs. Le défaut suit cron.catch_up_missed (true) pour les tâches récurrentes, et les one-shots sautent — un rappel « dans 20 minutes » ne vaut rien deux heures en retard.

grace_minutes : à quel point une exécution peut être en retard. La fenêtre par défaut est la moitié de la période, bornée à 2–120 minutes. --grace-minutes 0 est une vraie valeur, pas un « non défini » : elle ne rattrape jamais, donc une occurrence manquée est sautée plutôt que jouée en retard. Une tâche nocturne qui doit tourner même si le portable se réveille tard peut être élargie jusqu’à 1440 minutes (un jour).

--timezone : dans quelle horloge murale l’expression cron est lue. Omis, c’est la zone du profile qui s’applique. Le bug classique qu’il corrige est le « j’ai pourtant écrit 9 h » — écrit dans une zone que vous ne visiez pas.

Un exemple configuré

Mis ensemble, un brief propre, interrogeable, à 7 h de Hong Kong ressemble à ceci :

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

et dans config.yaml, un fil neuf par exécution sur Telegram :

platforms:
  telegram:
    extra:
      cron_fresh_thread_per_run: true

Le résultat : un brief propre dans son propre fil à 7 h, et quand vous répondez « qui a fusionné la troisième PR ? », l’agent sait de quel brief et de quel élément vous parlez.

Des cas limites à connaître

  • Couper l’emballage ne change rien à la livraison elle-même — cible, avis d’échec et retries sont intacts ; seule la décoration du texte disparaît.
  • Les avis d’échec ont leur propre interrupteur. failure_deliver route les messages d’échec ailleurs, et local les supprime entièrement tout en enregistrant l’échec dans hermes cron list et hermes cron runs.
  • Continuable ne veut pas dire « une session sans fin ». Les fils sont par exécution et les historiques par fil. Si vous voulez qu’une tâche voie sa propre sortie précédente d’une exécution à l’autre, c’est --continuity, une autre fonctionnalité — ne mélangez pas les deux.
  • Toutes les cibles ne peuvent pas être continuables. Les expansions de diffusion (deliver: all) ne sont jamais mirrorées, parce que cela réécrirait plusieurs conversations d’un coup.

Si votre installation cron se comporte mal de façon générale, commencez par hermes cron doctor ; si vous voulez une tâche qui se souvienne de ce qu’elle a rapporté la fois précédente, lisez la continuité de mémoire cron. La liste complète des flags est dans la référence hermes cron, et ce changement est arrivé dans v0.23.2.

La version courte

Qu’un brief ressemble à un avis machine ou au message d’un collègue tient à deux couches : l’emballage (wrap_response) décide de l’allure, et la livraison continuable (attach_to_session, plus un fil neuf par exécution) décide si vous pouvez y répondre. Les deux tiennent à un flag par tâche, les deux prennent moins d’une minute, et les deux rapportent chaque matin.