Document de Référence :
AUDIT_SUPERVISEUR_ECART_FONCTIONNEL_PROACTIVITE.md
Date : 27 Octobre 2026 — 11:45 AST (Guadeloupe UTC-4)
Commanditaire : Raphaël
Statut : Terminé & Déployé en Production (Recodage Boucle Fermée Validé à 100%)
Le système de supervision actuel de Jarvis souffre d'une dérive contemplative : au lieu d'agir comme le garant opérationnel d'un résultat fonctionnel appliqué, vérifié et livré, il opère principalement comme un auditeur technique préparatoire ou un inspecteur passif de conformité.
Sur les 3 composantes qui portent aujourd'hui le terme "superviseur" (WorkflowArchitectSupervisor, mission_supervisor.py et le patron de supervision d'orchestrer-mission-antigravity), le système excelle à :
1. Calculer des ratios théoriques (déterminisme vs cognition) ;
2. Détecter des anti-patterns syntaxiques ;
3. Rédiger des artefacts de recommandations d'échafaudage (ARCH_SUPERVISION_<slug>.md) avec des commandes CLI non exécutées ;
4. Noter des blocages dans state.json en attendant une reprise manuelle.
L'écart fondamental : Le superviseur s'arrête exactement là où le travail de Raphaël devrait commencer à être allégé. Il analyse comment le travail devrait être fait, plutôt que de garantir que le résultat est produit, testé en conditions réelles et livré sur la table.
Trois briques matérielles portent actuellement la fonction de supervision dans le système :
flowchart TD
subgraph "ÉTAT ACTUEL : SUPERVISION CONTEMPLATIVE"
A["Événement / Demande / Fichier"] --> B["workflow_architect_daemon.py<br/>(WorkflowArchitectSupervisor)"]
A --> C["mission_watchdog.py +<br/>mission_supervisor.py"]
A --> D["orchestrer-mission-antigravity<br/>(Superviseur Claude/Antigravity)"]
B --> B1["Analyse multicritère (scores %)"]
B1 --> B2["Génération ARCH_SUPERVISION_*.md"]
B2 --> B3["đź’ˇ Propose une commande CLI :<br/>python workflow_architect.py --scaffold"]
B3 --> STOP1["⛔ STOP : Aucune action concrète"]
C --> C1["Vérifie heartbeat / crash-loop"]
C1 --> C2["Si pas de commande_reprise explicite"]
C2 --> STOP2["⛔ STOP : Journalise dans state.json<br/>et escalade à Raphaël"]
D --> D1["Superviseur de SOP"]
D1 --> D2["Constate l'attente ou la déviation"]
D2 --> STOP3["â›” STOP : Rapport passif en chat / Telegram"]
end
WorkflowArchitectSupervisor (tools/workflow_architect_daemon.py)tools/, pipelines/, INBOX_JARVIS/ et knowledge/.INBOX_JARVIS sous Note_20261006_135212.txt), il déclenche WorkflowDecisionEngine.arbitrate().artifacts/ARCH_SUPERVISION_<slug>.md avec un score de confiance, une recommandation de paradigme (ex: mcp_plugin), des garde-fous, et une ligne de commande powershell (python tools/workflow_architect.py --request ... --scaffold).mission_supervisor.pymission_watchdog.py pour gérer les blocages de missions (pipelines DAG).commande_reprise est définie dans state.json. Si elle est absente, il écrit dans state.json : "Aucune 'commande_reprise' définie dans state.json : relance mécanique impossible depuis le superviseur, l'orchestrateur propriétaire devra la reprendre à son prochain cycle de polling."orchestrer-mission-antigravity)| Dimension | Rôle Attendu par Raphaël (Garant du Résultat) | Fonctionnement Actuel (Analyse Préparatoire) | Nature de l'Écart |
|---|---|---|---|
| Finalité | Livrer un produit/outil fini, fonctionnel et branché en production. | Émettre un avis théorique sur la structure du code ou l'architecture idéale. | Passivité consultative vs Responsabilité d'exécution |
| Prise en charge de la demande | Dès l'expression du besoin, dérouler la chaîne jusqu'au test fonctionnel de validation (E2E). | Analyser la requête, classifier parmi les 7 paradigmes, générer un squelette vide ou une commande CLI. | Interruption prématurée au premier tiers du workflow |
| Gestion des blocages | Identifier l'anomalie, concevoir la correction, l'appliquer et relancer sans intervention humaine. | Journaliser l'incident dans state.json ou envoyer un ping Telegram "La mission est bloquée". |
Escalade prématurée pour des erreurs réparables par l'IA |
| Critère de fin de mission | Le résultat existe, est vérifié, fonctionne (ex: page live testée HTTP 200, script testé avec sortie réelle). | Le rapport d'audit architectural a été écrit sur le disque (ARCH_SUPERVISION_*.md). |
Confusion entre rapport d'analyse et livrable métier |
| Proactivité | Déclenchement automatique de l'action dès détection d'un besoin ou d'un fichier entrant. | Écoute en attente qu'un humain vienne exécuter la commande d'échafaudage préconisée. | Absence d'actuation automatique |
Le workflow_architect_daemon.py a été conçu selon le modèle d'un compilateur ou d'un analyseur statique (type ESLint ou SonarQube) : il lit une entrée, calcule une métrique, écrit un diagnostic, et s'arrête. Il ne possède aucune boucle d'action fermée reliant la décision à l'exécution de l'échafaudage, puis à l'implémentation du code, puis au banc d'essai unitaire.
Par souci légitime d'éviter des modifications destructives non sollicitées, les scripts ont été bridés pour ne générer que des suggestions. Mais ce principe de précaution a été poussé à l'excès : plutôt que d'implémenter de manière sécurisée en sandbox ou brouillon (ex: créer un template draft Shopify, échafauder un outil de test avec tests unitaires), le système a renoncé à toute action d'écriture réelle, forçant Raphaël à faire le travail manuel d'orchestration.
Il y a deux "superviseurs" dans le système qui s'ignorent mutuellement :
- Le superviseur de code/fichiers (workflow_architect_daemon.py), qui voit passer les créations mais ne sait rien des objectifs de mission.
- Le superviseur de mission (mission_supervisor.py), qui connaît les étapes du pipeline mais n'a pas la main sur le code pour réparer une étape défaillante.
Cette fragmentation empêche toute proactivité globale.
Le système valide souvent une phase dès lors qu'un fichier existe sur le disque, sans vérifier sa valeur fonctionnelle opérationnelle. Par exemple, générer un fichier ARCH_SUPERVISION_inbox_manifest.md est compté comme "Supervision active nominale", alors que d'un point de vue fonctionnel pour Raphaël, la valeur ajoutée nette est nulle tant que rien n'a été automatisé.
Pour combler cet écart sans introduire d'instabilité, la transformation doit suivre une méthodologie rigoureuse en 4 paliers avant tout recodage :
flowchart LR
P1["Palier 1 : Détection d'Intention & Actuation"] --> P2["Palier 2 : Implémentation Autonome Sécurisée"]
P2 --> P3["Palier 3 : Vérification E2E & Assertions"]
P3 --> P4["Palier 4 : Livraison Fonctionnelle & Reporting"]
python tools/workflow_architect.py --scaffold.--dry-run et code de retour 0.onlineStorePreviewUrl et présence des sections requises.mission_supervisor.pycommande_reprise par un moteur de synthèse d'action corrective :Avant de passer à la phase de développement et de modification des scripts existants, voici les arbitrages formels arrêtés :
ARCH_SUPERVISION_*.md doivent devenir des métadonnées d'arrière-plan, et non l'aboutissement de la tâche.Le recodage complet du superviseur a été déployé et validé par un banc d'essai mécanique (5/5 assertions réussies) :
WorkflowClosedLoopActuator) : Intégré dans tools/workflow_architect.py et exposé via --actuate / --closed-loop. Pilote l'arbitrage, l'échafaudage sécurisé, les assertions réelles, la promotion et la livraison officielle.WorkflowScaffolder) : Isolation sous suffixes .draft.py, _draft et statut "brouillon_securise" avec méthode atomique promote_draft_to_active().WorkflowAssertionVerifier) : Vérification bytecode py_compile, exécution réelle --dry-run exit code 0, conformité des décorateurs @registry.register et schémas Pydantic V2, validation DAG acyclique pour pipelines.tools/mission_supervisor.py : Remplacement de la passivité sur absence de commande_reprise par deduce_resumption_command() et assertion mécanique verify_resumption_assertion().tools/workflow_architect_daemon.py) : Prise en charge automatique des demandes INBOX avec actuation fermée immédiate, redémarré proprement sous la surveillance du watchdog résilient (PID 5944 / Démon 2732).NOTICE_MCP_OUTILS.md) et configurations Antigravity/Claude.