Généré le 22/10/2026 21:44

Pulsation Rétrospective & Débogage — 20/10/2026

Routine : retrospective_debug (Routine 1, SOP_Pulsations_Proactives)
Exécutée par : Claude Code (agent de secours)
Déclenchement : [COGNITIVE PULSE] Mode: retrospective_debug


1. Extraction des erreurs (scratch/audit_errors.py)

2. Analyse de la cause racine

Dans JARVIS_LIVE_VOICE/server.py, la fonction call_ai_brain() (dialogue vocal rapide, mode "Orchestrateur Robuste") dispose déjà de deux replis automatiques entre cerveaux, construits au fil d'incidents précédents :
- agy en échec (quota/crash silencieux) → repli sur claude-code (ajouté 23/09 et 04/10/2026)
- claude-secours en échec → repli direct sur l'API OpenRouter (ajouté antérieurement)

Mais aucun repli n'existait quand claude-code lui-même (le cerveau primaire des sessions vocales) est en échec de quota/session limit. Résultat : le message d'erreur brut d'Anthropic ("You've hit your session limit") était renvoyé tel quel à Raphaël en voix, répété à chaque tour de parole, sans jamais basculer vers claude-secours — qui utilise pourtant le même binaire claude.exe, juste pointé vers le proxy local BRIDGE_MOTEUR_SECOURS (port 8082/8083) au lieu de l'API Anthropic directe, et qui était donc disponible et fonctionnel pendant toute cette fenêtre.

C'est une asymétrie de conception : le repli existait dans les deux autres sens (agy→claude-code, claude-secours→OpenRouter) mais pas pour le maillon central lui-même.

3. Correctif développé et validé

Validation isolée (scratch/patch_fallback_claude_code_session_limit_20261020.py) : la condition de déclenchement ("session limit", "usage limit", "rate limit", "resource_exhausted" dans le texte d'erreur) a été testée sur les vrais messages du log + des messages d'erreur claude-code non liés au quota (timeout, binaire introuvable) pour confirmer l'absence de faux positif. Résultat : OK, aucune régression.

Patch appliqué dans JARVIS_LIVE_VOICE/server.py (juste avant le repli claude-secours → OpenRouter existant) : quand claude-code échoue avec un message de quota/session limit, le système retente immédiatement le même appel via claude-secours (même binaire, même prompt, env CLAUDE_SECOURS_ENV). Si ce repli réussit, la réponse de claude-secours est utilisée normalement (silencieusement pour Raphaël, pas d'interruption) ; s'il échoue aussi, le message d'erreur combiné est conservé (comportement de secours identique aux replis existants, rien de régressif).

Syntaxe du fichier revérifiée après patch (python -m py_compile) : OK.

4. Point important — serveur non redémarré

JARVIS_LIVE_VOICE/server.py tourne actuellement en direct (port 8000, PID actif) et sert potentiellement une session vocale en cours avec Raphaël. Le correctif est écrit sur disque mais ne prendra effet qu'au prochain redémarrage du serveur — je n'ai pas forcé de redémarrage pour ne pas risquer de couper un appel en cours. À redémarrer dès que Raphaël confirme que c'est un bon moment (ou automatiquement au prochain cycle naturel de redémarrage du service).

5. Conclusion

1 incident réel identifié et corrigé (asymétrie de repli claude-code → claude-secours sur quota épuisé), validé isolément avant application, aucune régression introduite. Reste une action humaine : valider le moment du redémarrage du serveur pour activer le correctif.