Export caldav with logs

AGENTS.md

@@ -0,0 +1,28 @@
+# Consignes de maintenance
+
+- Mettre à jour `docs/crealead-caldav.md` lors de toute évolution impactant
+  `crealead-caldav.py`, notamment ses pré-requis, sa configuration, son
+  lancement, le traitement des événements, ses sorties CSV, sa journalisation
+  ou ses tests dans `tests/`.
+- Garder les exemples de configuration, les commandes d'exécution et les cas
+  de test documentés cohérents avec le comportement du script.
+- Chaque nouvelle ligne écrite dans `logs/crealead-caldav.log` doit commencer
+  par l'heure d'écriture en UTC au format ISO 8601 avec suffixe `Z`, entre
+  crochets. Le format par défaut est :
+  `[2026-10-15T12:34:56Z]: [info] - message`.
+  Cela s'applique aux sorties standard et d'erreur ainsi qu'aux lignes des
+  traces d'exception.
+- Tout événement non exporté doit laisser une trace au format
+  `[2026-10-15T12:34:56Z]: [warning][event] - message`, sans préfixe `[info]`
+  supplémentaire. Préciser le calendrier concerné, le titre, le moment de
+  l'événement (début et fin disponibles) et la raison de son exclusion.
+  Ajouter le fichier CSV et l'UID pour faciliter son identification.
+- Ne jamais ignorer silencieusement un événement, notamment en cas de
+  `SUMMARY` absent, de dates absentes ou invalides, de document iCalendar
+  illisible ou d'export CSV interrompu. Récupérer les métadonnées disponibles
+  dans les données brutes si nécessaire et indiquer `indisponible` pour celles
+  qui ne peuvent pas être retrouvées. Échapper les retours à la ligne des
+  métadonnées et du motif pour conserver un avertissement sur une seule ligne.
+- Lors d'une évolution du traitement des événements ou de la journalisation,
+  vérifier dans les tests que les événements écartés sont bien tracés avec les
+  informations et les préfixes ci-dessus.