Généré le 21/11/2026 04:48

📘 Notice Officielle des Outils MCP Jarvis (JUTL)

Système : Jarvis Universal Tool Layer (JUTL)
Dernière Synchronisation : 21/11/2026 04:37:56 (UTC-4)
Localisation Permanente de Référence : Guadeloupe (UTC-4 toute l'année)
Statut Global : 🟢 Opérationnel & Synchronisé en Temps Réel (19 outils actifs, 6 pôles)


🧭 1. Principes Fondamentaux de la Couche Universelle

La Couche Universelle JUTL (Jarvis Universal Tool Layer) transforme l'ensemble des scripts de Raphaël en un catalogue d'outils universellement consommables par n'importe quel modèle d'IA connectable (Claude 3.5/3.7, Google Antigravity, Gemini 2.5/3.8, DeepSeek-V3/R1, Qwen 2.5, Ollama, etc.) sans aucun réentraînement.

flowchart LR
    A["Modèles d'IA Connectés<br/>(Claude, Antigravity, DeepSeek, Gemini)"] <-->|MCP JSON-RPC / API Directe| B["Serveur Pivot JUTL<br/>(jarvis_mcp_server.py)"]
    B <-->|Typage Pydantic V2| C["Registre Canonique<br/>(tools/registry.py + mcp_plugins/)"]
    C --> D["Scripts Opérationnels<br/>(tools/*.py)"]
    C -.->|Auto-Sync en Temps Réel| E["Notice MCP & Schémas JSON<br/>(NOTICE_MCP_OUTILS.md)"]

Les 5 Piliers d'Intégrité :

  1. Découverte Automatique Immédiate : Tout nouvel outil ajouté dans tools/registry.py ou déposé dans tools/mcp_plugins/*.py est automatiquement détecté par le démon watcher, référencé dans cette notice, et rendu accessible instantanément à tous les modèles sans aucune commande manuelle.
  2. Typage Strict & Zéro Crash : Chaque appel est validé en amont par des modèles Pydantic V2 (extra="forbid" : tout champ non déclaré est rejeté, jamais ignoré silencieusement). Un argument erroné est rejeté proprement avec une explication claire pour l'IA, sans jamais interrompre le serveur.
  3. Validateurs de Sécurité & Conformité (tools/mcp_validators.py) : tout chemin de fichier fourni par un modèle d'IA est confiné aux racines autorisées (anti path-traversal, fichiers sensibles comme .env bloqués), toute URL est filtrée (schéma http/https uniquement, garde-fou SSRF anti-IP interne/loopback), et les champs texte libres sont bornés en taille. Les exceptions internes imprévues du handler sont journalisées en intégralité côté serveur mais jamais exposées en détail au modèle d'IA appelant.
  4. Respect Absolu de la Localisation : Fuseau horaire strictement calé sur UTC-4 (Guadeloupe) pour toute heure, météo, agenda ou échéance.
  5. Intégrité des Livrables : Tout document ou rapport généré réside exclusivement sous C:\ASSISTANT_IA\artifacts\ pour être rendu cliquable dans la Web UI Jarvis.

📊 2. Matrice Globale des Outils Disponibles

Outil Pôle / Catégorie Description Succincte Timeout Commande CLI Équivalente
usine_boutique business Gère l'Usine Boutique : création complète, publication un clic avec audit d'intégrité MD5, ou audit global de tous les fichiers du thème Shopify. 300s python tools/usine_boutique.py
usine_studio business Usine Studio Creatif et Medias : genere et controle tous les visuels (packshots studio detoures, scenes lifestyle multi-references, micro-animations video, pubs statiques Meta, videos UGC verticales 9:16 et avatars par inpainting avec remplacement du produit en main). 600s python tools/usine_studio.py
chasse_orchestrateur ecommerce Pilotage mécanique et sans décision live du pipeline de Chasse Produit (Minea -> Tri Croisé -> Sourcing AliExpress -> Jugement vidéo dual-IA -> Inscription Tracker). Évite les blocages et surveille les garde-fous. 60s python tools/chasse_orchestrateur.py
generer_rapport_produit_jarvis ecommerce Génère un rapport HTML interactif complet pour un produit ou une liste de produits du Product Tracker. Conforme au format officiel Jarvis (verdict Col X dépliable, stockage sous artifacts/ et envoi Telegram automatique). 120s python tools/generer_rapport_produit_jarvis.py
juge_produit_orchestrateur ecommerce Orchestrateur mécanique du Juge Produit (les 7 filtres Ecom Revolution). Vérifie l'éligibilité, collecte les données concurrentielles (Amazon/Google Shopping/AliExpress), calcule les marges réelles et applique le verdict structuré. 90s python tools/juge_produit_orchestrateur.py
lookup_cerfa_forms fiscalite Recherche par mot-clé dans la cartographie des formulaires Cerfa et cases fiscales (numéro de formulaire, libellé, usage, ministère). Index en dur — aucune navigation web réelle malgré ce que son nom source (form_navigator) pourrait suggérer. 10s python tools/lookup_cerfa_forms.py
simulate_ir_fiscal fiscalite Simule l'Impôt sur le Revenu (IR) français avec barème par tranches progressif, quotient familial et plafonnement des demi-parts, décote, abattement territorial Outre-mer (DOM) et crédits d'impôt. Moteur 100% déterministe (aucun appel réseau/LLM), basé sur le barème fiscal certifié en dur. 10s python tools/simulate_ir_fiscal.py
simulate_micro_entreprise fiscalite Simule les cotisations sociales URSSAF, l'imposition (versement libératoire ou barème avec abattement) et les seuils de CA/franchise de TVA d'une micro-entreprise. Moteur 100% déterministe (aucun appel réseau/LLM). 10s python tools/simulate_micro_entreprise.py
stats_rejets reporting Génère et met à jour le tableau de bord statistique persistant des motifs de rejets (rejets Pre-Tracker au tri croisé/sourcing + rejets Post-Tracker des 7 filtres du Juge). Produit C:\ASSISTANT_IA\rapport_stats_rejets_dashboard.html et l'envoie sur Telegram. 40s python tools/stats_rejets.py
centraliser_script_ugc studio Centralise obligatoirement tous les scripts publicitaires, hooks et idées UGC par produit dans un unique fichier d'artefact existant (SCRIPT_UGC__BASE.md) sous C:\ASSISTANT_IA\artifacts. Ajoute les nouvelles idées à la suite (append horodaté UTC-4) et synchronise le rendu HTML cliquable pour l'UI Jarvis. 30s python tools/centraliser_script_ugc.py
extract_ads_library studio Extrait les vidéos de publicités concurrentes ACTIVES depuis la Bibliothèque publicitaire Meta publique (sans login, légal, zéro risque compte). Classe par ancienneté de diffusion (signal de rentabilité). 90s python tools/extract_ads_library.py
studio_pub_cli studio Moteur de production vidéo UGC e-commerce autonome. Porte A ('recycle') : suppression watermarks -> coupe brand-safety -> voix ElevenLabs -> sous-titres -> export. Porte B ('create') : photo produit -> cadrage nano-banana -> animation Kling/Seedance -> montage final. 120s python tools/studio_pub_cli.py
annuler_mission_planifiee system Annule une action planifiée (délai ou condition) avant son déclenchement, par son identifiant. 10s python tools/annuler_mission_planifiee.py
fast_check_daemons system Audit instantané des services et démons résidents en arrière-plan (Proxy 8099, Calendar Dispatcher, Moniteur Pipeline, Pulse Daemon, Task Watchdog). Permet de vérifier leur santé et de les relancer si nécessaire. 15s python tools/fast_check_daemons.py
jarvis_inbox_engine system Gestion, indexation et analyse multimodale de l'espace partagé INBOX JARVIS (C:\ASSISTANT_IA\INBOX_JARVIS). Permet de répertorier les fichiers déposés par Raphaël (photos, vidéos, notes, liens) et d'en tirer des synthèses. 45s python tools/jarvis_inbox_engine.py
meteo_guadeloupe system Consulte l'heure exacte et la météo en temps réel pour la Guadeloupe (UTC-4, localisation officielle permanente de Raphaël). Source Open-Meteo haute précision, zéro clé requise. 10s python tools/meteo_guadeloupe.py
planifier_mission system Planifie le lancement différé d'une mission : soit après un délai en minutes ('lance X dans 10 minutes'), soit dès qu'une autre mission du pipeline atteint un statut terminal ('quand la mission Y est terminée, lance Z'). Surveillé par un démon dédié (scheduler_daemon.py), résiste au redémarrage du serveur/de la machine. 10s python tools/planifier_mission.py
telegram_reliable system Envoi fiable et garanti de notifications, rapports, photos et documents vers le Telegram de Raphaël. Gère le découpage automatique > 4096 caractères, les re-tentatives et le logging d'erreurs. 30s python tools/telegram_reliable.py
workflow_architect system Analyse un besoin d'automatisation ou de pipeline de Raphaël et détermine automatiquement la meilleure architecture technique (scripts, plugins MCP, pipeline DAG, démon, skill ou navigateur), avec possibilité d'échafaudage direct. 60s python tools/workflow_architect.py

📑 3. Fiches Techniques & Spécifications Détaillées des Outils

⚙️ usine_boutique (Pôle : business)

Description : Gère l'Usine Boutique : création complète, publication un clic avec audit d'intégrité MD5, ou audit global de tous les fichiers du thème Shopify.
Timeout maximal : 300 secondes

📋 Paramètres Reçus :

Paramètre Type Requis Défaut Description
action string Non create Action : 'create' (création complète), 'publish' (publication un clic Shopify avec isolation slug), 'audit' (audit d'intégrité complet du thème Shopify).
slug any Non None Identifiant court du produit en minuscules avec tirets (ex: sneaksafe, defroisseur-vapeur). Requis pour 'create' et 'publish'.
produit_url any Non None URL source de la fiche produit (AliExpress, Shopify ou fournisseur).
concurrent_url any Non None URL de la boutique Shopify concurrente a analyser et surpasser.
mode string Non autonome Mode d'execution : 'autonome' (selection automatique de l'angle) ou 'supervise' (arbitrage interactif Telegram).

💡 Exemple d'Appel JSON-RPC MCP :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "usine_boutique",
    "arguments": {
      "action": "create",
      "mode": "autonome"
    }
  }
}

⚙️ usine_studio (Pôle : business)

Description : Usine Studio Creatif et Medias : genere et controle tous les visuels (packshots studio detoures, scenes lifestyle multi-references, micro-animations video, pubs statiques Meta, videos UGC verticales 9:16 et avatars par inpainting avec remplacement du produit en main).
Timeout maximal : 600 secondes

📋 Paramètres Reçus :

Paramètre Type Requis Défaut Description
action string Non run Action : 'run' (lancer la production), 'status' (voir avancement), 'valider' (valider une porte), 'collecter_avatars' (collecte Wikimedia).
slug string Oui — Identifiant court du produit (ex: test-ember-20261031, defroisseur-vapeur).
lots any Non 1,2,3,4,5,6,7 Lots a produire separes par virgules : 1 (packshots), 2 (lifestyle), 3 (animations), 4 (pubs statiques), 5 (video UGC), 6 (avatars), 7 (integration). Ex: '1,4' ou '1,2,3,4,5,6,7'.
mode string Non supervise Mode d'execution : 'supervise' (avec portes Telegram) ou 'autonome'.
porte any Non None Nom de la porte a valider si action='valider' (ex: gate-visuels, gate-avatars, gate-medias-final).
choix any Non ok Choix de validation : 'ok' ou consigne (ex: 'sauf:id1,id2').
niche any Non bureau_boisson Niche ciblee si action='collecter_avatars'.
nb_avatars any Non 2 Nombre d'avatars a collecter si action='collecter_avatars'.

💡 Exemple d'Appel JSON-RPC MCP :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "usine_studio",
    "arguments": {
      "action": "run",
      "slug": "valeur_exemple",
      "lots": "1,2,3,4,5,6,7",
      "mode": "supervise",
      "choix": "ok",
      "niche": "bureau_boisson",
      "nb_avatars": 2
    }
  }
}

⚙️ chasse_orchestrateur (Pôle : ecommerce)

Description : Pilotage mécanique et sans décision live du pipeline de Chasse Produit (Minea -> Tri Croisé -> Sourcing AliExpress -> Jugement vidéo dual-IA -> Inscription Tracker). Évite les blocages et surveille les garde-fous.
Timeout maximal : 60 secondes

📋 Paramètres Reçus :

Paramètre Type Requis Défaut Description
action string Oui — Action : 'status' (état de la mission), 'scan' (scan boutiques Minea), 'guardrail_check' (vérification garde-fous), 'setup' (initialisation mission).
mission_name string Non chasse-mcp-run Identifiant unique de la mission de chasse.
limit integer Non 5 Nombre maximum de candidats à scanner lors de l'action 'scan'.
objectif integer Non 3 Nombre de produits validés visés lors de l'action 'setup'.

💡 Exemple d'Appel JSON-RPC MCP :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "chasse_orchestrateur",
    "arguments": {
      "action": "valeur_exemple",
      "mission_name": "chasse-mcp-run",
      "limit": 5,
      "objectif": 3
    }
  }
}

⚙️ generer_rapport_produit_jarvis (Pôle : ecommerce)

Description : Génère un rapport HTML interactif complet pour un produit ou une liste de produits du Product Tracker. Conforme au format officiel Jarvis (verdict Col X dépliable, stockage sous artifacts/ et envoi Telegram automatique).
Timeout maximal : 120 secondes

📋 Paramètres Reçus :

Paramètre Type Requis Défaut Description
statut any Non None Filtre par statut de la colonne R (ex: 'Validé', 'En attente', 'Rejeté').
validation_finale any Non None Filtre par validation finale manuelle de Raphaël (colonne T), distinct de statut.
produit any Non None Sous-chaîne du nom de produit recherché (colonne A).
ligne any Non None Numéro de ligne précis dans le Product Tracker Google Sheet.
tous boolean Non False Si vrai, exporte l'ensemble des lignes renseignées sans aucun filtre.
titre any Non None Titre personnalisé affiché en haut du rapport HTML.
no_telegram boolean Non False Si vrai, ne transmet pas le document HTML sur Telegram.
no_images boolean Non False Si vrai, n'essaie pas de récupérer les photos AliExpress (génération ultra-rapide).

💡 Exemple d'Appel JSON-RPC MCP :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generer_rapport_produit_jarvis",
    "arguments": {
      "tous": false,
      "no_telegram": false,
      "no_images": false
    }
  }
}

⚙️ juge_produit_orchestrateur (Pôle : ecommerce)

Description : Orchestrateur mécanique du Juge Produit (les 7 filtres Ecom Revolution). Vérifie l'éligibilité, collecte les données concurrentielles (Amazon/Google Shopping/AliExpress), calcule les marges réelles et applique le verdict structuré.
Timeout maximal : 90 secondes

📋 Paramètres Reçus :

Paramètre Type Requis Défaut Description
row any Non None Numéro de ligne précis du produit à évaluer dans le Product Tracker.
all_eligible boolean Non False Si vrai, traite tous les produits éligibles dans l'ordre du Tracker.
dry_run boolean Non True Si vrai, mode simulation sécurisé : aucune écriture dans le Google Sheet ni notification Telegram.

💡 Exemple d'Appel JSON-RPC MCP :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "juge_produit_orchestrateur",
    "arguments": {
      "all_eligible": false,
      "dry_run": true
    }
  }
}

⚙️ lookup_cerfa_forms (Pôle : fiscalite)

Description : Recherche par mot-clé dans la cartographie des formulaires Cerfa et cases fiscales (numéro de formulaire, libellé, usage, ministère). Index en dur — aucune navigation web réelle malgré ce que son nom source (form_navigator) pourrait suggérer.
Timeout maximal : 10 secondes

📋 Paramètres Reçus :

Paramètre Type Requis Défaut Description
terme_recherche string Oui — Mot-clé à rechercher parmi les cases fiscales et formulaires Cerfa référencés (ex: 'crypto', 'lmnp', 'micro', 'cfe', 'dons').

💡 Exemple d'Appel JSON-RPC MCP :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "lookup_cerfa_forms",
    "arguments": {
      "terme_recherche": "valeur_exemple"
    }
  }
}

⚙️ simulate_ir_fiscal (Pôle : fiscalite)

Description : Simule l'Impôt sur le Revenu (IR) français avec barème par tranches progressif, quotient familial et plafonnement des demi-parts, décote, abattement territorial Outre-mer (DOM) et crédits d'impôt. Moteur 100% déterministe (aucun appel réseau/LLM), basé sur le barème fiscal certifié en dur.
Timeout maximal : 10 secondes

📋 Paramètres Reçus :

Paramètre Type Requis Défaut Description
salaire_net_imposable number Non 0.0 Salaire net imposable annuel (avant abattement 10% ou frais réels).
revenus_micro_apres_abattement number Non 0.0 Revenus de micro-entreprise déjà nets de l'abattement forfaitaire, à intégrer au revenu global.
autres_revenus_imposables number Non 0.0 Autres revenus imposables (fonciers, pensions, etc.) non couverts par les deux champs précédents.
statut_marital string Non celibataire 'celibataire', 'marie', 'pacse', 'divorce' ou 'veuf'.
nb_enfants integer Non 0 Nombre d'enfants à charge (impacte le quotient familial).
frais_reels number Non 0.0 Montant des frais réels déduits si > 0 (sinon abattement forfaitaire de 10% appliqué automatiquement).
territoire string Non Metropole Territoire fiscal ('Metropole', 'Guadeloupe', 'Martinique', 'Reunion', 'Guyane', 'Mayotte') pour l'abattement DOM applicable.
credits_impot number Non 0.0 Montant total des crédits et réductions d'impôt déjà acquis à déduire de l'impôt brut.

💡 Exemple d'Appel JSON-RPC MCP :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "simulate_ir_fiscal",
    "arguments": {
      "salaire_net_imposable": 0.0,
      "revenus_micro_apres_abattement": 0.0,
      "autres_revenus_imposables": 0.0,
      "statut_marital": "celibataire",
      "nb_enfants": 0,
      "frais_reels": 0.0,
      "territoire": "Metropole",
      "credits_impot": 0.0
    }
  }
}

⚙️ simulate_micro_entreprise (Pôle : fiscalite)

Description : Simule les cotisations sociales URSSAF, l'imposition (versement libératoire ou barème avec abattement) et les seuils de CA/franchise de TVA d'une micro-entreprise. Moteur 100% déterministe (aucun appel réseau/LLM).
Timeout maximal : 10 secondes

📋 Paramètres Reçus :

Paramètre Type Requis Défaut Description
ca_annuel number Oui — Chiffre d'affaires annuel encaissé (pas facturé) de la micro-entreprise, en euros.
type_activite string Non services_bnc 'vente_marchandises' (micro-BIC), 'services_bic' (BIC commercial/artisanal) ou 'services_bnc' (BNC libéral).
option_versement_liberatoire boolean Non False Si vrai, applique le versement libératoire de l'IR en plus des cotisations URSSAF.
acre boolean Non False Si vrai, applique l'exonération partielle ACRE (50% la 1ère année) sur les cotisations sociales.

💡 Exemple d'Appel JSON-RPC MCP :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "simulate_micro_entreprise",
    "arguments": {
      "ca_annuel": "valeur_exemple",
      "type_activite": "services_bnc",
      "option_versement_liberatoire": false,
      "acre": false
    }
  }
}

⚙️ stats_rejets (Pôle : reporting)

Description : Génère et met à jour le tableau de bord statistique persistant des motifs de rejets (rejets Pre-Tracker au tri croisé/sourcing + rejets Post-Tracker des 7 filtres du Juge). Produit C:\ASSISTANT_IA\rapport_stats_rejets_dashboard.html et l'envoie sur Telegram.
Timeout maximal : 40 secondes

📋 Paramètres Reçus :

Paramètre Type Requis Défaut Description
regenerate boolean Non True Recalcule toutes les statistiques depuis l'ensemble des missions et le Google Sheet Tracker.
no_telegram boolean Non False Si vrai, n'envoie pas le document HTML mis à jour sur Telegram.

💡 Exemple d'Appel JSON-RPC MCP :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "stats_rejets",
    "arguments": {
      "regenerate": true,
      "no_telegram": false
    }
  }
}

⚙️ centraliser_script_ugc (Pôle : studio)

Description : Centralise obligatoirement tous les scripts publicitaires, hooks et idées UGC par produit dans un unique fichier d'artefact existant (SCRIPT_UGC__BASE.md) sous C:\ASSISTANT_IA\artifacts. Ajoute les nouvelles idées à la suite (append horodaté UTC-4) et synchronise le rendu HTML cliquable pour l'UI Jarvis.
Timeout maximal : 30 secondes

📋 Paramètres Reçus :

Paramètre Type Requis Défaut Description
produit string Oui — Nom ou identifiant du produit (ex: 'Vivi Care', 'Cultivez Facilement').
script any Non None Contenu du script publicitaire, variante de copy ou idée UGC à consigner.
titre any Non `` Titre court ou libellé de l'idée (ex: 'Soulagement cervical bureau').
angle any Non `` Angle marketing (ex: 'Douleur / Bénéfice immédiat', 'Preuve sociale').
hook any Non `` Accroche ou première phrase percutante (hook).
statut any Non Idée validée par Raphaël Statut de l'idée ou du script.
action any Non append 'append' pour ajouter une idée, 'list' pour lister les idées existantes.

💡 Exemple d'Appel JSON-RPC MCP :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "centraliser_script_ugc",
    "arguments": {
      "produit": "valeur_exemple",
      "titre": "",
      "angle": "",
      "hook": "",
      "statut": "Idée validée par Raphaël",
      "action": "append"
    }
  }
}

⚙️ extract_ads_library (Pôle : studio)

Description : Extrait les vidéos de publicités concurrentes ACTIVES depuis la Bibliothèque publicitaire Meta publique (sans login, légal, zéro risque compte). Classe par ancienneté de diffusion (signal de rentabilité).
Timeout maximal : 90 secondes

📋 Paramètres Reçus :

Paramètre Type Requis Défaut Description
query any Non None Mots-clés de recherche de publicités actives dans la Meta Ad Library (ex: 'bracelet réveil').
page_id any Non None ID numérique de la page Facebook du concurrent à aspirer.
from_tracker boolean Non False Si vrai, lit le Google Sheet Product Tracker et extrait les pubs pour les produits validés.
max_videos integer Non 5 Nombre maximum de vidéos à extraire.
country string Non FR Code pays ciblé (FR, BE, CH, CA, LU).

💡 Exemple d'Appel JSON-RPC MCP :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "extract_ads_library",
    "arguments": {
      "from_tracker": false,
      "max_videos": 5,
      "country": "FR"
    }
  }
}

⚙️ studio_pub_cli (Pôle : studio)

Description : Moteur de production vidéo UGC e-commerce autonome. Porte A ('recycle') : suppression watermarks -> coupe brand-safety -> voix ElevenLabs -> sous-titres -> export. Porte B ('create') : photo produit -> cadrage nano-banana -> animation Kling/Seedance -> montage final.
Timeout maximal : 120 secondes

📋 Paramètres Reçus :

Paramètre Type Requis Défaut Description
mode string Oui — Mode Studio Pub : 'recycle' (Porte A - adapter pub concurrente) ou 'create' (Porte B - création pure) ou 'status'.
video_path any Non None Chemin absolu de la vidéo concurrente source (pour mode 'recycle').
script any Non None Texte du script audio à doubler via ElevenLabs.
voix string Non jane Voix ElevenLabs choisie ('jane', 'adam', ou 'dub' pour traduction fidèle conservant l'ambiance).
slug any Non None Slug identifiant unique du projet publicitaire (ex: 'reveil_vibrant_pub1').
send_telegram boolean Non False Si vrai, transmet la vidéo montée finalisée sur Telegram.
dry_run boolean Non True Si vrai, vérifie la faisabilité technique et les dépendances sans consommer de crédits fal.ai/ElevenLabs.
model any Non kling3-pro Modèle d'animation vidéo Porte B ('kling3-pro', 'kling3-std', 'seedance-mini'). Par défaut Kling 3.0 Pro.
element_consistency boolean Non True Active l'option Element Consistency (@Element1) sur Kling 3.0 Pro fal.ai.

💡 Exemple d'Appel JSON-RPC MCP :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "studio_pub_cli",
    "arguments": {
      "mode": "valeur_exemple",
      "voix": "jane",
      "send_telegram": false,
      "dry_run": true,
      "model": "kling3-pro",
      "element_consistency": true
    }
  }
}

⚙️ annuler_mission_planifiee (Pôle : system)

Description : Annule une action planifiée (délai ou condition) avant son déclenchement, par son identifiant.
Timeout maximal : 10 secondes

📋 Paramètres Reçus :

Paramètre Type Requis Défaut Description
id string Oui — Identifiant de l'action planifiée à annuler (retourné par planifier_mission).

💡 Exemple d'Appel JSON-RPC MCP :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "annuler_mission_planifiee",
    "arguments": {
      "id": "valeur_exemple"
    }
  }
}

⚙️ fast_check_daemons (Pôle : system)

Description : Audit instantané des services et démons résidents en arrière-plan (Proxy 8099, Calendar Dispatcher, Moniteur Pipeline, Pulse Daemon, Task Watchdog). Permet de vérifier leur santé et de les relancer si nécessaire.
Timeout maximal : 15 secondes

📋 Paramètres Reçus :

Paramètre Type Requis Défaut Description
auto_start boolean Non False Si vrai, relance automatiquement en arrière-plan les démons trouvés inactifs.

💡 Exemple d'Appel JSON-RPC MCP :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "fast_check_daemons",
    "arguments": {
      "auto_start": false
    }
  }
}

⚙️ jarvis_inbox_engine (Pôle : system)

Description : Gestion, indexation et analyse multimodale de l'espace partagé INBOX JARVIS (C:\ASSISTANT_IA\INBOX_JARVIS). Permet de répertorier les fichiers déposés par Raphaël (photos, vidéos, notes, liens) et d'en tirer des synthèses.
Timeout maximal : 45 secondes

📋 Paramètres Reçus :

Paramètre Type Requis Défaut Description
action string Oui — Action : 'scan' (mise à jour index), 'list' (derniers dépôts), 'status' (statistiques), 'drop_link' (enregistrer URL), 'drop_text' (enregistrer note), 'analyze' (analyser un média par IA).
url any Non None URL cible pour l'action 'drop_link'.
texte any Non None Texte ou note pour l'action 'drop_text'.
titre any Non None Titre optionnel pour la note ou le lien déposé.
item_id any Non None Identifiant ou chemin de l'élément à analyser pour l'action 'analyze'.

💡 Exemple d'Appel JSON-RPC MCP :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "jarvis_inbox_engine",
    "arguments": {
      "action": "valeur_exemple"
    }
  }
}

⚙️ meteo_guadeloupe (Pôle : system)

Description : Consulte l'heure exacte et la météo en temps réel pour la Guadeloupe (UTC-4, localisation officielle permanente de Raphaël). Source Open-Meteo haute précision, zéro clé requise.
Timeout maximal : 10 secondes

📋 Paramètres Reçus :

Paramètre Type Requis Défaut Description
inclure_previsions boolean Non True Si vrai, inclut les prévisions de température min/max et probabilité de pluie.

💡 Exemple d'Appel JSON-RPC MCP :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "meteo_guadeloupe",
    "arguments": {
      "inclure_previsions": true
    }
  }
}

⚙️ planifier_mission (Pôle : system)

Description : Planifie le lancement différé d'une mission : soit après un délai en minutes ('lance X dans 10 minutes'), soit dès qu'une autre mission du pipeline atteint un statut terminal ('quand la mission Y est terminée, lance Z'). Surveillé par un démon dédié (scheduler_daemon.py), résiste au redémarrage du serveur/de la machine.
Timeout maximal : 10 secondes

📋 Paramètres Reçus :

Paramètre Type Requis Défaut Description
mode string Oui — 'delai' (lance l'action après un nombre de minutes donné) ou 'condition' (lance l'action dès qu'une mission cible atteint un statut terminal).
delai_minutes any Non None Obligatoire si mode='delai' : nombre de minutes à attendre avant de lancer l'action.
mission_cible_slug any Non None Obligatoire si mode='condition' : slug exact du pipeline surveillé (dossier sous pipelines//state.json). Ne jamais inventer ce slug -- le confirmer avec Raphael ou le lire dans le Tracker/les missions en cours si incertain.
statuts_attendus any Non None Liste optionnelle de sous-chaînes de statut qui valident la condition (ex: ['lance_actif']). Si omis, utilise la détection terminale standard du projet (mission_complete, termine, clos...).
timeout_minutes integer Non 360 Pour mode='condition' uniquement : délai max d'attente avant d'abandonner la condition (expiration notifiée sur Telegram, jamais un item qui reste en attente indéfiniment). Défaut 6h.
instruction string Oui — Instruction en langage naturel de l'action à lancer une fois le délai/la condition atteint(e).
brain string Non claude Moteur qui exécutera l'action planifiée ('claude' ou 'antigravity').

💡 Exemple d'Appel JSON-RPC MCP :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "planifier_mission",
    "arguments": {
      "mode": "valeur_exemple",
      "timeout_minutes": 360,
      "instruction": "valeur_exemple",
      "brain": "claude"
    }
  }
}

⚙️ telegram_reliable (Pôle : system)

Description : Envoi fiable et garanti de notifications, rapports, photos et documents vers le Telegram de Raphaël. Gère le découpage automatique > 4096 caractères, les re-tentatives et le logging d'erreurs.
Timeout maximal : 30 secondes

📋 Paramètres Reçus :

Paramètre Type Requis Défaut Description
message any Non None Texte du message à transmettre à Raphaël. Découpe automatique si > 3900 caractères.
photo_path any Non None Chemin local absolu d'une photo/image à envoyer sur Telegram.
doc_path any Non None Chemin local absolu d'un document (HTML, PDF, texte) à envoyer sur Telegram.
caption string Non `` Légende facultative accompagnant la photo ou le document envoyé.

💡 Exemple d'Appel JSON-RPC MCP :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "telegram_reliable",
    "arguments": {
      "caption": ""
    }
  }
}

⚙️ workflow_architect (Pôle : system)

Description : Analyse un besoin d'automatisation ou de pipeline de Raphaël et détermine automatiquement la meilleure architecture technique (scripts, plugins MCP, pipeline DAG, démon, skill ou navigateur), avec possibilité d'échafaudage direct.
Timeout maximal : 60 secondes

📋 Paramètres Reçus :

Paramètre Type Requis Défaut Description
request string Oui — Description en langage naturel du workflow, pipeline ou automatisation demandé par Raphaël.
scaffold boolean Non False Si True, génère automatiquement l'arborescence et le code squelette sur disque selon l'architecture retenue.
actuate boolean Non False Si True, exécute l'actuation complète en boucle fermée (échafaudage brouillon sécurisé -> vérification par assertions mécaniques -> livraison fonctionnelle certifiée).
workflow_name any Non None Nom technique (slug) du workflow à utiliser lors de l'échafaudage de code.
format_output string Non structured Format de sortie souhaité : 'structured' (dictionnaire d'évaluation complet), 'text' (rapport textuel mis en forme) ou 'both'.

💡 Exemple d'Appel JSON-RPC MCP :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "workflow_architect",
    "arguments": {
      "request": "valeur_exemple",
      "scaffold": false,
      "actuate": false,
      "format_output": "structured"
    }
  }
}

🧠 4. Notice d'Apprentissage Cognitive (System Prompt pour Nouveau Modèle d'IA)

Tout modèle d'IA intégrant l'écosystème peut immédiatement comprendre le système en recevant le bloc d'instructions suivant :

Tu es l'assistant IA opérationnel de Raphaël au sein de l'environnement C:\ASSISTANT_IA.
Tu as accès à la Couche Universelle MCP (JUTL).

RÈGLES D'OR SYSTÈME :
1. Heure et Météo : Raphaël réside en Guadeloupe (UTC-4 toute l'année). Utilise `meteo_guadeloupe` pour obtenir l'heure exacte.
2. Livrables : Tout rapport HTML doit être créé dans C:\ASSISTANT_IA\artifacts\ (via `generer_rapport_produit_jarvis` pour les produits).
3. Notifications : Utilise `telegram_reliable` pour envoyer des messages, photos ou documents à Raphaël.
4. Typage strict : Respecte les types attendus par les outils définis dans la notice MCP.

🔄 5. Fonctionnement du Mécanisme de Mise à Jour Automatique

Le pipeline de mise à jour automatique garantit une propagation instantanée et sans friction :

  1. Création d'un Outil : Un développeur ou une IA crée un nouveau module dans tools/mcp_plugins/<mon_outil>.py ou l'enregistre avec @registry.register dans tools/registry.py.
  2. Détection Immédiate : Le démon résident mcp_watcher.py (ou le watchdog) détecte l'événement en moins de 2 secondes.
  3. Synchronisation Totale (tools/sync_mcp_registry.py) :
    - Régénération instantanée de cette Notice MCP (NOTICE_MCP_OUTILS.md et artifacts/NOTICE_MCP_OUTILS.md).
    - Création du schéma JSON dans ~/.gemini/antigravity-cli/mcp/jarvis_universal_tools/<mon_outil>.json.
    - Mise à jour de instructions.md pour le moteur Antigravity.
    - Mise à jour des configurations Claude Code (.claude.json), Cursor (cursor_mcp.json) et du manifeste projet (.mcp.json).
    - Mise à jour des manifestes multi-LLM (tools_openai_schema.json, tools_gemini_schema.json).
    - Notification de confirmation transmise à Raphaël sur Telegram si un nouvel outil a été ajouté.
  4. Disponibilité Instantanée : Tous les modèles d'IA connectés voient le nouvel outil lors de leur prochain appel tools/list sans nécessiter de redémarrage manuel du serveur.

Notice générée automatiquement par tools/sync_mcp_registry.py — Version JUTL 2.0 (Heure Guadeloupe : 21/11/2026 04:37:56 (UTC-4)).