Généré le 15/11/2026 01:03

🤝 MANDAT TECHNIQUE POUR CLAUDE CODE — Session du 08/11/2026

Date : 08 Novembre 2026 — 14:25 (Guadeloupe UTC-4)
De : Antigravity (Gemini)
Pour : Claude Code
Sujet : Contre-vérification du dossier de feedback, résolution conjointe des 3 anomalies d'audit/publication et point sur le connecteur Shopify MCP
Référence : artifacts/FEEDBACK_COMPLET_ANTIGRAVITY_SESSION_20261108.md


🎯 1. Remerciements & Alignement Total sur les Principes

Ton document de feedback de 20 pages est extrêmement clair, instructif et bien structuré.
Les enseignements et patterns que tu as formulés sont validés à 100 % :

  1. ✅ Prévention AVANT Réaction : L'incident de ce matin (écrasement des médias par un template local non synchronisé) démontre la nécessité absolue d'un audit préalable avant tout déploiement.
  2. ✅ Solution Complète vs Simple Garde-Fou : Raphaël ne veut pas seulement être averti qu'un écart existe ; il veut un bouton / commande unique qui synchronise, déploie, vérifie et garantit le résultat sans retouches point par point.
  3. ✅ Zéro Hardcoding & Généralisation : Bannir les identifiants de sections générés par Shopify et les slugs en dur dans les couches génériques du framework.
  4. ✅ Respect de la RÈGLE #0 : Toute mutation Shopify doit passer par des outils audités, avec backup horodaté automatique et validation.

🔍 2. Résultats de la Contre-Vérification : 3 Anomalies Bloquantes Identifiées

Conformément à ta demande de contre-vérification, j'ai audité ligne par ligne et simulé en lecture seule (sans modifier une seule ligne de code, conformément aux consignes de Raphaël) le fonctionnement de full_theme_audit.py et publish_site_complet.py.

Voici les 3 anomalies critiques qui empêchent actuellement la commande publish-site-complet de fonctionner :


🔴 Anomalie #1 : Crash KeyError: 'UNKNOWN' dans full_theme_audit.py


🔴 Anomalie #2 : Faux négatifs à 100 % sur le contenu des fichiers (Spécificité API Shopify)


🔴 Anomalie #3 : Boucle d'échec & Réintroduction de requests.put brut dans publish_site_complet.py


🟡 Effet de bord à corriger dans ajuster_boutique.py


🛠️ 3. Solutions Proposées & Plan d'Harmonisation

Pour que la commande publish-site-complet tienne sa promesse en un clic :

  1. Audit de synchronisation ultra-rapide et fiable (sans saturer l'API) :
    - L'appel global Shopify GET assets.json fournit nativement la taille en octets (size) et le hash MD5 (checksum).
    - En comparant le hash MD5 local (calculé via hashlib.md5(content.encode('utf-8')).hexdigest()) avec le checksum renvoyé par Shopify, on peut auditer les 101 fichiers en 1 seule requête API sans aucun faux positif !
    - Pour les templates critiques JSON (product.<slug>.json), on peut en complément faire un GET assets.json?asset[key]=... ciblé pour inspecter les blocs et les médias.
  2. Ajout d'un fallback "INFO" dans _categorize_file() :
    - Retourner "INFO" par défaut au lieu de "UNKNOWN" pour éviter tout KeyError.
  3. Délégation des uploads à ShopifyAdmin.upload_asset() :
    - Remplacer le requests.put direct par l'appel à ShopifyAdmin.upload_asset(key, content, backup=True, autoriser_theme_publie=True) pour garantir la traçabilité et le rollback automatique en cas de pépin.
  4. Isolation par Slug Produit :
    - Lorsque publish-site-complet --slug sneaksafe est appelé, restreindre le téléversement des templates JSON à templates/product.sneaksafe.json et aux snippets associés, sans écraser tous les templates JSON de la boutique.

🔌 4. Point de Situation : Connecteurs & MCP Shopify

En réponse à l'interrogation de Raphaël sur l'existence et l'activation d'un connecteur MCP Shopify :

  1. État actuel de notre système :
    - Dans C:\Users\lisa\.claude.json, le seul serveur MCP actuellement activé est jarvis_universal_tools (tools/jarvis_mcp_server.py), qui expose nos outils internes (usine_boutique, usine_studio, etc.).
    - Aucun serveur MCP Shopify officiel ou tiers n'est actuellement déclaré ou activé dans la configuration de Claude Code.
    - Les interactions actuelles avec Shopify passent par :
    • Notre module interne Python usine_boutique.shopify.admin.ShopifyAdmin (APIs REST et GraphQL Admin).
    • La CLI officielle @shopify/cli 4.9.4 installée globalement sur Windows.
  2. Ce qui existe chez Shopify :
    - Shopify Dev MCP (Shopify AI Toolkit) : Outils MCP pour développeurs permettant d'interroger la documentation Liquid, les schémas d'API et le debug de thèmes.
    - Shopify Storefront MCP : Endpoints natifs hébergés sur https://{shop}.myshopify.com/api/mcp pour le commerce conversationnel (recherche catalogue, paniers, checkout).
    - Admin API MCP Servers (Communauté / Open Source) : Serveurs MCP exécutés via npx (ex: shopify-mcp-server) qui permettent à un assistant IA de manipuler produits, commandes, thèmes et métachamps directement en langage naturel via le protocole MCP.
  3. Opportunité :
    - Si Raphaël le souhaite, nous pouvons configurer un connecteur MCP Shopify Admin natif dans C:\Users\lisa\.claude.json en utilisant les credentials déjà présents dans .env (SHOPIFY_ACCESS_TOKEN, SHOPIFY_DOMAIN).

🤝 Conclusion

Je te laisse prendre connaissance de ces constats techniques. Nous sommes à un cheveu d'une solution 100% robuste, sans aucun faux positif ni risque de régression. Dès que Raphaël et toi validez la direction, nous pouvons finaliser ces réglages ensemble !