🔍 Audit Exhaustif du Superviseur Jarvis : Analyse d'Écart & Feuille de Route de Proactivité

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%)


Executive Summary (Constat Majeur)

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.


1. Cartographie du Fonctionnement Actuel

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

A. Le Démon WorkflowArchitectSupervisor (tools/workflow_architect_daemon.py)

B. Le Superviseur d'Incidents mission_supervisor.py

C. La Supervision de Mission d'Orchestration (orchestrer-mission-antigravity)


2. Analyse Détaillée de l'Écart (Attendu vs Actuel)

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

3. Origine Systémique de l'Écart (Les 4 Causes Racines)

Cause 1 : L'Architecture en "Boucle Ouverte" (Open-Loop vs Closed-Loop)

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.

Cause 2 : Le Verrou de la Peur du Risque Technique (Sur-protectionnite)

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.

Cause 3 : La Déconnexion entre le Superviseur de Code et le Superviseur de Mission

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.

Cause 4 : L'Absence de Définition du "Fait Fonctionnel"

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é.


4. Feuille de Route pour Rendre le Superviseur Réellement Proactif

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"]

Palier 1 : Passage du Conseil à l'Actuation Automatique (Action Enveloppée)

Palier 2 : Le Modèle "Brouillon Garanti & Porte Sécurisée"

Palier 3 : Validation Fonctionnelle Mécanique (Assertions Réelles)

Palier 4 : Auto-Résolution d'Incidents dans mission_supervisor.py


5. Synthèse des Décisions Pré-Recodage

Avant de passer à la phase de développement et de modification des scripts existants, voici les arbitrages formels arrêtés :

  1. Unification du Mandat : Le "Superviseur" cesse d'être un linter passif. Son rôle officiel devient : "Garant de la Production et de la Livraison du Résultat Fonctionnel".
  2. Suppression des Faux Livrables : Les fichiers ARCH_SUPERVISION_*.md doivent devenir des métadonnées d'arrière-plan, et non l'aboutissement de la tâche.
  3. Contrat d'Achèvement : Aucune mission ne peut être close sans livraison matérielle effective et testée (artefact métier, injection en ligne, notification Telegram substantielle avec preuve).

6. Journal de Déploiement & Validation en Production (27/10/2026)

Le recodage complet du superviseur a été déployé et validé par un banc d'essai mécanique (5/5 assertions réussies) :

  1. Moteur d'Actuation en Boucle Fermée (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.
  2. Échafaudage en Mode Brouillon Sécurisé (WorkflowScaffolder) : Isolation sous suffixes .draft.py, _draft et statut "brouillon_securise" avec méthode atomique promote_draft_to_active().
  3. Moteur d'Assertions Mécaniques Réelles (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.
  4. Auto-Résolution d'Incidents dans tools/mission_supervisor.py : Remplacement de la passivité sur absence de commande_reprise par deduce_resumption_command() et assertion mécanique verify_resumption_assertion().
  5. Démon Résident Proactif (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).
  6. Synchronisation Universelle MCP : Schémas régénérés et synchronisés dans Notice MCP (NOTICE_MCP_OUTILS.md) et configurations Antigravity/Claude.