nextcloud-sync-cal-time-mananger/AGENTS.md

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.