Généré le 14/10/2026 10:01

🛠️ Rétrospective & Débogage — 14/10/2026

Pulsation cognitive autonome, mode retrospective_debug — routine 1 de SOP_Pulsations_Proactives.md


1. Scan automatique (scratch/audit_errors.py)

✅ Aucune erreur critique non gérée dans les logs couverts par le script (*.err.log/*_err.log racine, logs_claude_headless/*.log, démarrage Remoat, erreurs de quota dans live_session.log). 2 logs périmés (>48h, déjà résolus) correctement ignorés.

Le script ne couvre pas uvicorn_supervisor.log ni les logs des proxys de secours (proxy_openrouter_8082.log, proxy_gemini_8083.log) — angle mort connu de l'outil. Vérification manuelle faite en complément ci-dessous, ce qui a permis de trouver le vrai incident de ce soir.


2. Incident réel trouvé et corrigé : processus orphelin non supervisé sur le port 8000 (72 minutes)

Constat

Le script de déploiement du correctif claude-secours lancé plus tôt ce soir (deploy_fix_claude_secours_20261014.ps1) a laissé, de 01:06 à 01:18, un processus orphelin (PID 13020) tenir seul le port 8000 sans aucune supervision, pendant que le nouveau supervisor.py (PID 12392) tentait de se lier au même port en boucle toutes les 2 secondes — 3305+ tentatives échouées enregistrées (WinError 10048, "une seule utilisation de chaque adresse de socket... habituellement autorisée").

Cause racine

  1. restart_differe_verifie.ps1 (étape 1, correcte) tue le worker uvicorn existant → l'ancien supervisor.py (PID 6616), toujours vivant à ce moment, détecte la mort de son enfant et en relance un nouveau automatiquement (son propre comportement de surveillance, normal).
  2. Mon script tue ensuite le parent supervisor.py (PID 6616) via Stop-Process -Force.
  3. Sous Windows, Stop-Process ne tue jamais l'arborescence d'un processus, seulement le PID exact (pas de job object). L'enfant relancé à l'étape 1 devient orphelin mais continue de tourner, toujours lié au port 8000.
  4. Le nouveau supervisor.py relancé juste après tente de se binder sur 8000 → échec immédiat et répété, car le port est déjà occupé par l'orphelin.
  5. Le healthcheck de mon script a néanmoins rapporté "OK" — car c'est l'orphelin qui répondait, pas le nouveau superviseur. Fonctionnellement rien n'était cassé pour Raphaël ce soir, mais plus aucun mécanisme n'aurait relancé le service en cas de plantage.

Point important : pas un incident isolé

La même signature d'erreur (WinError 10048 sur le port 8000) apparaît aussi beaucoup plus tôt dans l'historique de ce même fichier de log (bien avant ce soir) — donc ce n'est pas la première fois qu'un redémarrage du processus parent supervisor.py laisse un orphelin de ce type. Jusqu'ici, jamais diagnostiqué à la racine.

Correction appliquée ce soir (vérifiée en conditions réelles)

  1. Vérifié l'absence d'appel actif (live_session.log silencieux depuis 12+ minutes).
  2. Arrêt ciblé de l'orphelin (PID 13020).
  3. Vérifié que le nouveau supervisor.py (PID 12392) a immédiatement bindé le port 8000 via un nouveau worker (PID 6728) : Uvicorn running on http://0.0.0.0:8000, plus aucune erreur 10048 depuis.
  4. Healthcheck final : 200 OK, version serveur inchangée (9).

Correctif écrit pour éviter la récidive

scratch/restart_supervisor_tree_safe.ps1 (syntaxe validée) : à utiliser désormais pour tout redémarrage du process supervisor.py lui-même (pas son seul worker port 8000, pour lequel restart_differe_verifie.ps1 reste correct tel quel). Utilise taskkill /F /T /PID (tue l'arbre complet, pas juste le PID) au lieu de Stop-Process, revérifie explicitement que le port est libéré avant de relancer, et conserve le même garde-fou "jamais de kill pendant un appel actif".


3. Autres vérifications faites ce soir (aucune anomalie)


Généré par Claude (agent de secours Antigravity) lors de la pulsation retrospective_debug du 14/10/2026. Incident trouvé, corrigé et vérifié en conditions réelles — pas seulement documenté.