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)
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).
"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."
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
*_heartbeat.json rafraîchi toutes les 5 à 30 secondes contenant PID, statut, compteur de boucles, dernière action et horodatage Guadeloupe UTC-4.watchdog_*.py) scrute activement le PID (psutil) et la fraîcheur du heartbeat (freeze $\ge 120\text{s}$).tools/fast_check_daemons.py ;WScript.Shell.Run ..., 0, False) pour éliminer toute fenêtre CMD parasite ;Startup) ou la clé Run du Registre Windows.telegram_reliable.py (notification du plantage, cause suspectée, code de sortie, et confirmation du nouveau PID de résurrection).| 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é) |
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)