Généré le 14/10/2026 21:47

🛡️ Nouvelle Règle Permanente & SOP : Surveillance Obligatoire (Watchdog) & Persistance Système de Tout Processus Automatisé

Date d'effet : 14/10/2026
Auteur : Antigravity (Agent d'Exécution Autonome de Jarvis)
Référence Système : SOP-INFRA-RESILIENCE-01
Localisation Raphaël : Guadeloupe UTC-4 (AST)


🎯 1. Contexte & Règle Fondatrice

Dans un environnement de commerce autonome et d'assistance vocale opérant 24h/24, aucun script ne doit plus jamais être déployé en tant que "processus orphelin".

Un script qui crashe sans relance automatique ou qui disparaît après un reboot Windows compromet l'intégrité de la chaîne opérationnelle (veille concurrentielle, classement, détection vocale, ordonnancement des tâches).

⚖️ La Directive Système

"Tout nouveau script, outil ou processus automatisé créé doit obligatoirement inclure un mécanisme de surveillance (watchdog) pour assurer son redémarrage automatique en cas de plantage et sa persistance après un reboot du système."


🏛️ 2. Les 5 Piliers d'une Automatisation Résiliente

flowchart LR
    A["Processus Managé<br/>(Démon/Worker)"] -->|"Heartbeat (5-30s)<br/>UTC-4"| B[("Fichier Heartbeat<br/>*_heartbeat.json")]
    C["Watchdog Sentinelle<br/>(watchdog_*.py)"] -->|"Scrutation (<3s)"| A
    C -->|"Détection Freeze"| B
    C -->|"Relance Immédiate"| A
    C -->|"Alerte Crash / Résurrection"| D["Telegram Raphaël<br/>(telegram_reliable)"]
    E["Reboot Windows"] --> F["1. Startup / Registre HKCU"]
    E --> G["2. fast_check_daemons.py"]
    F --> H["Lanceur VBS Invisible<br/>(lance_*_invisible.vbs)"]
    G --> H
    H --> C
  1. 💓 Télémétrie de Vie (Heartbeat) : Fichier JSON *_heartbeat.json rafraîchi toutes les 5 à 30 secondes contenant PID, statut, compteur de boucles, dernière action et horodatage Guadeloupe UTC-4.
  2. 👁️ Sentinelle Active (< 3s) : Watchdog dédié (watchdog_*.py) scrute activement le PID (psutil) et la fraîcheur du heartbeat (freeze $\ge 120\text{s}$).
  3. ⚡ Relance Immédiate avec Coupe-Circuit (Anti-Crash-Loop Backoff) : Redémarrage instantané en cas de mort inattendue, avec seuil de sécurité (max 5 crashs / 60s) temporisant à 30-60s pour éviter d'asphyxier le processeur.
  4. 🔄 Persistance Reboot Multi-Niveaux :
    - Inscription systématique dans tools/fast_check_daemons.py ;
    - Lanceur VBScript invisible (WScript.Shell.Run ..., 0, False) pour éliminer toute fenêtre CMD parasite ;
    - Inscription dans le dossier de démarrage Windows (Startup) ou la clé Run du Registre Windows.
  5. 📢 Alerting Telegram Fiable : Traçabilité complète via telegram_reliable.py (notification du plantage, cause suspectée, code de sortie, et confirmation du nouveau PID de résurrection).

📂 3. Livrables Concrets & Fichiers Créés / Mis à Jour

Composant / Fichier Statut Emplacement & Rôle
SOP Canonique 🟢 Créé knowledge\SOP_Surveillance_Watchdog_Persistance\artifacts\SOP_Surveillance_Watchdog_Persistance_Automatisations.md
Gabarit Watchdog 🟢 Créé C:\ASSISTANT_IA\tools\templates\template_watchdog.py (boilerplate standard réutilisable)
Gabarit Lanceur VBS 🟢 Créé C:\ASSISTANT_IA\tools\templates\template_lance_invisible.vbs (exécution silencieuse sans fenêtre console)
Règles Globales Gemini 🟢 Mis à jour C:\Users\lisa\.gemini\GEMINI.md (nouvelle règle permanente n°6)
Règles Permanentes Backup 🟢 Mis à jour C:\ASSISTANT_IA\CLAUDE.md (règle n°16 + entrée table de mapping langage naturel)
Sommaire d'Architecture 🟢 Mis à jour knowledge\Architecture_Antigravity.md (routeur + catalogue section 1 + backup catalogué)

☑️ 4. Checklist d'Auto-Validation Avant Clôture de Mission

Avant qu'un script ou outil automatisé ne soit validé, il doit valider 7 points :
- [x] Heartbeat JSON horodaté en Guadeloupe UTC-4
- [x] Sentinelle watchdog réactive ($\le 3\text{s}$)
- [x] Test unitaire de crash (kill simulé et vérification de la résurrection)
- [x] Coupe-circuit anti-crash-loop actif
- [x] Lanceur VBScript invisible créé
- [x] Inscription dans tools/fast_check_daemons.py
- [x] Alerting Telegram opérationnel (telegram_reliable)