Asana & Git Automation Retex

Ce skill documente les points de friction rencontrés lors de l'exécution des workflows automatisés (Asana → KiloClaw et sauvegarde Git) et les solutions appliquées pour garantir une exécution fluide.

🔍 Points Bloquants Identifiés & Solutions

1. Token GitHub Expiré ou Invalide

• Symptôme : Échec silencieux du git push lors de la sauvegarde hebdomadaire, erreur HTTP 401.
• Cause : Le Personal Access Token (PAT) GitHub stocké dans l'URL du remote était périmé.
• Solution :
  1. Récupérer le nouveau PAT depuis 1Password (op item get "GitHub Personal Access Token" --vault "KiloClaw" --fields identifiant --reveal).
  2. Mettre à jour l'URL du remote : git remote set-url origin "https://x-access-token:<TOKEN>@github.com/rez0/kiloclaw-workspace.git".
  3. Prévention : Ajouter une vérification de santé du token (curl -s -H "Authorization: token $TOKEN" https://api.github.com/user) dans le script de backup avant toute opération Git.

2. Token Asana Désynchronisé

• Symptôme : Les tâches Asana assignées à KiloClaw ne sont pas traitées, erreur 401 Not Authorized lors de l'appel API.
• Cause : Le fichier local ~/.config/tokens/asana-kiloclaw.txt contenait un ancien token, tandis que le token à jour était dans 1Password.
• Solution :
  1. Synchroniser systématiquement le token local avec 1Password avant l'exécution du script : op item get "Asana" --vault "KiloClaw" --fields identifiant --reveal > ~/.config/tokens/asana-kiloclaw.txt.
  2. Prévention : Modifier le script asana_daily_fetch.sh pour qu'il récupère dynamiquement le token via 1Password à chaque exécution, éliminant la dépendance à un fichier statique potentiellement obsolète.

3. Structure Incohérente du Fichier d'État Asana

• Symptôme : Le script asana_daily.py échoue avec l'erreur 'completed_gids' lors de la tentative de marquage d'une tâche comme "done".
• Cause : Le fichier .asana-task-state.json avait une structure différente (processed_gids au lieu de completed_gids) de celle attendue par le script Python.
• Solution :
  1. Corriger manuellement la structure du fichier JSON pour qu'elle corresponde au schéma attendu : {"completed_gids": [...]}.
  2. Prévention : Ajouter une validation de schéma ou une migration automatique dans asana_daily.py pour gérer les anciennes versions du fichier d'état sans planter.

4. Fichiers Non Versionnés Polluant le Dépôt

• Symptôme : Le script de backup tente de committer des dossiers entiers clonés temporairement (ex: SkillClaw/) ou des logs locaux (records/).
• Cause : Absence de règles d'ignorance dans .gitignore.
• Solution :
  1. Ajouter explicitement SkillClaw/ et records/ au fichier .gitignore du workspace.
  2. Prévention : Réviser le .gitignore lors de l'installation de tout nouvel outil ou workflow pour éviter l'encombrement du dépôt principal.

5. Collisions et Échecs de Jobs Cron (Morning Briefing / Backup)

• Symptôme : Double exécution ou échec du "Briefing Quotidien" et du backup hebdomadaire le dimanche à 7h00 (erreur 502 ou conflit de ressources).
• Cause : Plusieurs jobs cron (GitHub Awesome Check, Morning Briefing, Git Backup) étaient programmés exactement à la même heure, saturant les ressources ou entrant en conflit. De plus, le Morning Briefing tentait d'appeler un plugin inexistant.
• Solution :
  1. Décaler les jobs non critiques (ex: GitHub Awesome Check) à 7h15 pour laisser la priorité absolue au backup hebdomadaire à 7h00.
  2. Reconfigurer le Morning Briefing pour qu'il exécute directement le script Python local (scripts/morning_brief.py) via agentTurn avec les outils autorisés (exec, read, write, message), plutôt que de dépendre d'un plugin externe.
  3. Prévention : Lors de l'ajout d'un nouveau job cron, toujours vérifier l'horaire via cron list et éviter les chevauchements avec les fenêtres de backup (dimanche 7h00) ou de brief matinal (8h00).

🔄 Intégration au Workflow de Sauvegarde

Ce skill et les corrections apportées (scripts mis à jour, .gitignore enrichi) font désormais partie intégrante du périmètre de la sauvegarde hebdomadaire Git. Toute future modification de ces mécanismes devra être validée par ce référentiel.