story-theme-mcp 1.3.0 → 1.5.0

package/README.md

@@ -59,6 +59,7 @@ Le MCP ne contient pas le thème : au démarrage, il demande à l'espace membre
 | Construire | `create_project`, `update_brief`, `apply_recipe`, `localize_template`, `list_texts`, `edit_template`, `write_file`, `update_theme_settings`, `read_file`, `exclude_template` |
 | Contrôler | `validate_json`, `review_project`, `undo`, `revert_file` |
 | Livrer | `export_theme` (zip à importer + check-list), `import_theme` (auditer un thème téléchargé d'une boutique) |
+| Vos boutiques | `list_shops`, `shops_overview`, `shop_graphql` (Admin GraphQL sur une, plusieurs ou toutes les boutiques), `push_to_shop` (écrire le projet dans un thème non publié, sans zip) — via l'appli Shopify Story Apps, sans aucune clé Shopify |
 
 Prompts prêts à l'emploi : `creer-boutique`, `refaire-une-page`, `auditer-un-theme`. Les guides sont aussi exposés en ressources (`storytheme://guides/<sujet>`).
 
@@ -67,7 +68,8 @@ Prompts prêts à l'emploi : `creer-boutique`, `refaire-une-page`, `auditer-un-t
 - **Aucun fichier invalide n'est enregistré.** Chaque modèle, groupe de sections et `settings_data.json` est validé contre les vrais schémas du thème : types de sections et de blocs, blocs privés, blocs statiques et leurs identifiants, réglages (identifiant, type, options, bornes et pas des curseurs), texte riche, liens, images, palettes, polices de la bibliothèque Shopify, limites Shopify (25 sections, 50 blocs, 8 niveaux). Les erreurs proposent la bonne orthographe (« vouliez-vous dire banner ? »).
 - **Plus strict que Shopify Theme Check** : sur un même fichier piégé, Theme Check ne voit que le bloc interdit ; le MCP refuse aussi le réglage inconnu et la valeur hors limites.
 - **Revue design** : textes d'exemple ou en anglais laissés sur une boutique française, faux avis et faux chiffres des presets, bouton sans lien, plusieurs `<h1>`, contrastes insuffisants (WCAG AA, boutons compris), polices dépréciées par Shopify (Futura → Jost…), compte à rebours qui redémarre et stock simulé (pratiques commerciales trompeuses), pop-ups multiples, rythme des palettes.
-- **Jamais le code du thème**, jamais une boutique en ligne : seuls `templates/*.json`, `sections/<groupe>.json` et `config/settings_data.json` sont modifiables, dans un dossier de projet.
+- **Jamais le code du thème** : seuls `templates/*.json`, `sections/<groupe>.json` et `config/settings_data.json` sont modifiables, dans un dossier de projet. Le Liquid, le CSS et le JS du thème ne sont jamais touchés, ni en local ni à distance.
+- **Écrire dans une boutique reste encadré** : `push_to_shop` n'envoie que les fichiers du projet, refuse une boutique qui ne tourne pas sur un Story Thème de la même version majeure, refuse le thème publié sans confirmation explicite, et ne supprime jamais rien à distance. Les accès passent par l'appli Story Apps (OAuth par boutique, révocable par le marchand) et sont journalisés.
 - **Historique** : chaque écriture est précédée d'un instantané ; `undo` revient en arrière autant de fois que nécessaire.
 - **Export bloqué** tant qu'une erreur bloquante reste ; signalé « pas prêt à publier » tant qu'un point 🔴 reste.
 
@@ -97,7 +99,7 @@ Prompts prêts à l'emploi : `creer-boutique`, `refaire-une-page`, `auditer-un-t
 
 ## Limites
 
-Pas de connexion à une boutique : le MCP fabrique un thème à importer, il ne publie rien et ne crée ni produits, ni collections, ni menus, ni images, ni réductions (la check-list les liste). Il ne remplace pas une vérification visuelle dans l'éditeur Shopify.
+Le MCP ne publie jamais un thème : il écrit dans un thème non publié, le marchand vérifie et publie lui-même. Sans l'appli Story Apps installée sur la boutique, il fabrique seulement un zip à importer. Il ne crée ni produits, ni collections, ni menus, ni images, ni réductions par lui-même : `shop_graphql` le permet quand une boutique est connectée, sinon la check-list les liste. Et il ne remplace pas une vérification visuelle dans l'éditeur Shopify.
 
 ## Développement (New Story)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "story-theme-mcp",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "Serveur MCP du Story Thème : votre assistant IA connaît le thème Shopify Story par cœur et construit des boutiques propres et professionnelles.",
   "type": "module",
   "main": "src/index.js",
@@ -23,7 +23,6 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
     "fflate": "^0.8.3",
-    "story-theme-mcp": "^1.2.1",
     "zod": "^4.6.5"
   },
   "keywords": [

package/src/build/quick.js

@@ -16,16 +16,16 @@ const clone = (value) => JSON.parse(JSON.stringify(value));
 // A style picks sensible defaults when the merchant has not said more: brand colour, neutrals,
 // font pairing and home page recipe.
 export const STYLES = {
-  essentiel: { label: 'polyvalent', color: '#2F4B3A', neutral: 'tinted', fonts: 'clean-sans', home: 'accueil-essentiel' },
-  premium: { label: 'premium, luxe', color: '#2B2622', neutral: 'warm', fonts: 'editorial', home: 'accueil-marque-premium' },
-  mode: { label: 'mode, prêt-à-porter', color: '#1A1A1A', neutral: 'pure', fonts: 'fashion-sans', home: 'accueil-marque-premium' },
-  beaute: { label: 'beauté, soin, bien-être', color: '#A45C68', neutral: 'warm', fonts: 'soft-modern', home: 'accueil-beaute' },
-  nature: { label: 'naturel, artisanal, épicerie', color: '#3F5A3C', neutral: 'warm', fonts: 'natural', home: 'accueil-artisan' },
-  maison: { label: 'maison, déco, grand catalogue', color: '#7A5C44', neutral: 'warm', fonts: 'minimal', home: 'accueil-catalogue' },
-  tech: { label: 'tech, accessoires', color: '#2F5BEA', neutral: 'cool', fonts: 'tech', home: 'accueil-produit-phare' },
-  sport: { label: 'sport, énergie', color: '#D8432B', neutral: 'pure', fonts: 'bold-sport', home: 'accueil-essentiel' },
-  enfant: { label: 'enfants, animaux, ludique', color: '#E08A2E', neutral: 'warm', fonts: 'friendly', home: 'accueil-essentiel' },
-  'produit-unique': { label: 'marque d’un produit phare (DTC)', color: '#1F3A5F', neutral: 'cool', fonts: 'contemporary', home: 'accueil-produit-phare' },
+  essentiel: { label: 'polyvalent', color: '#2F4B3A', neutral: 'tinted', fonts: 'clean-sans', home: 'accueil-essentiel', homes: ['accueil-essentiel', 'accueil-produit-phare', 'accueil-catalogue'] },
+  premium: { label: 'premium, luxe', color: '#2B2622', neutral: 'warm', fonts: 'editorial', home: 'accueil-marque-premium', homes: ['accueil-marque-premium', 'accueil-essentiel', 'accueil-produit-phare'] },
+  mode: { label: 'mode, prêt-à-porter', color: '#1A1A1A', neutral: 'pure', fonts: 'fashion-sans', home: 'accueil-marque-premium', homes: ['accueil-marque-premium', 'accueil-catalogue', 'accueil-essentiel'] },
+  beaute: { label: 'beauté, soin, bien-être', color: '#A45C68', neutral: 'warm', fonts: 'soft-modern', home: 'accueil-beaute', homes: ['accueil-beaute', 'accueil-produit-phare', 'accueil-essentiel'] },
+  nature: { label: 'naturel, artisanal, épicerie', color: '#3F5A3C', neutral: 'warm', fonts: 'natural', home: 'accueil-artisan', homes: ['accueil-artisan', 'accueil-essentiel', 'accueil-catalogue'] },
+  maison: { label: 'maison, déco, grand catalogue', color: '#7A5C44', neutral: 'warm', fonts: 'minimal', home: 'accueil-catalogue', homes: ['accueil-catalogue', 'accueil-marque-premium', 'accueil-essentiel'] },
+  tech: { label: 'tech, accessoires', color: '#2F5BEA', neutral: 'cool', fonts: 'tech', home: 'accueil-produit-phare', homes: ['accueil-produit-phare', 'accueil-essentiel', 'accueil-catalogue'] },
+  sport: { label: 'sport, énergie', color: '#D8432B', neutral: 'pure', fonts: 'bold-sport', home: 'accueil-essentiel', homes: ['accueil-essentiel', 'accueil-produit-phare', 'accueil-beaute'] },
+  enfant: { label: 'enfants, animaux, ludique', color: '#E08A2E', neutral: 'warm', fonts: 'friendly', home: 'accueil-essentiel', homes: ['accueil-essentiel', 'accueil-catalogue', 'accueil-artisan'] },
+  'produit-unique': { label: 'marque d’un produit phare (DTC)', color: '#1F3A5F', neutral: 'cool', fonts: 'contemporary', home: 'accueil-produit-phare', homes: ['accueil-produit-phare', 'accueil-beaute', 'accueil-essentiel'] },
 };
 
 const KEYWORDS = {
@@ -411,6 +411,81 @@ export function enrichir(steps, { direction = 'editorial', graine = 0, hasImages
   return sortie;
 }
 
+// ---- variété des structures
+//
+// Le reproche était juste : deux boutiques du même style sortaient avec le même enchaînement de
+// sections, parce que la recette imposait l'ordre et que l'enrichissement tombait toujours au même
+// endroit (juste avant la FAQ). On garde la tête (le héros, le bandeau qui le suit) et la queue
+// (FAQ, newsletter) — leur place est justifiée — et on rebat le MILIEU avec la graine de la marque.
+//
+// Rebattre ne veut pas dire mélanger au hasard : une page doit rester vendeuse. Les sections sont
+// donc réparties en deux familles (commerce et récit) et réassemblées selon l'un des quatre rythmes
+// ci-dessous. Deux sections de même type ne se retrouvent jamais collées.
+
+const COMMERCE = new Set(['product-list', 'collection-list', 'featured-product', 'bundle-builder', 'image-hotspots', 'hotspots']);
+
+// Chaque rythme est une intention de page, pas un tirage : C = commerce, R = récit.
+const RYTHMES = [
+  'CRRCRRC', // le produit d'abord, la marque autour
+  'RCRRCRC', // une respiration de marque, puis le produit
+  'CCRRCRR', // vitrine groupée en haut
+  'CRCRRRC', // alternance serrée
+];
+
+const alea = (graine) => {
+  let x = (graine % 2147483647) || 1;
+  return () => (x = (x * 48271) % 2147483647) / 2147483647;
+};
+
+const melanger = (liste, tirage) => {
+  const out = [...liste];
+  for (let i = out.length - 1; i > 0; i--) {
+    const j = Math.floor(tirage() * (i + 1));
+    [out[i], out[j]] = [out[j], out[i]];
+  }
+  return out;
+};
+
+/** La queue d'une page : ce qui se lit en dernier et ne se déplace pas. */
+const FIN = new Set(['faq', 'newsletter', 'contact-form', 'map', 'blog-posts']);
+
+/**
+ * Rebat le milieu de l'accueil pour que deux marques du même style n'aient pas la même page.
+ * @param {object[]} steps sections déjà adaptées et enrichies
+ * @param {{graine: number}} options
+ */
+export function varier(steps, { graine = 0 } = {}) {
+  // La tête : le héros, plus le bandeau défilant ou la barre de réassurance qui le suit.
+  let debut = 1;
+  while (debut < steps.length && ['marquee', 'marquee-text', 'trust-badges', 'announcement'].includes(steps[debut]?.type)) debut += 1;
+  let fin = steps.length;
+  while (fin > debut && FIN.has(steps[fin - 1]?.type)) fin -= 1;
+
+  const milieu = steps.slice(debut, fin);
+  // En dessous de quatre sections mobiles, permuter ne produit pas de variété, seulement du bruit.
+  if (milieu.length < 4) return steps;
+
+  const tirage = alea(graine + 7);
+  const commerce = melanger(milieu.filter((etape) => COMMERCE.has(etape.type)), tirage);
+  const recit = melanger(milieu.filter((etape) => !COMMERCE.has(etape.type)), tirage);
+  const rythme = RYTHMES[graine % RYTHMES.length];
+
+  const sortie = [];
+  for (let i = 0; sortie.length < milieu.length; i++) {
+    const veutCommerce = rythme[i % rythme.length] === 'C';
+    let premier = veutCommerce ? commerce : recit;
+    let second = veutCommerce ? recit : commerce;
+    // Deux sections du même type à la suite : on prend dans l'autre famille, sinon on décale.
+    const dernier = sortie.at(-1)?.type;
+    if (premier.length && premier[0].type === dernier && second.length) [premier, second] = [second, premier];
+    const choisi = (premier.length ? premier : second).shift();
+    if (!choisi) break;
+    sortie.push(choisi);
+  }
+
+  return [...steps.slice(0, debut), ...sortie, ...steps.slice(fin)];
+}
+
 export function adaptSteps(steps, { templateType, hasImages, hasLarge = hasImages, proofs, collections }) {
   const out = [];
   const planned = steps.map((step) => `${step.type}|${step.preset}`);
@@ -753,7 +828,10 @@ export function buildStore({ catalog, store }, input) {
 
   // Pages
   const recipes = [];
-  const home = findRecipe(input.home) ? input.home : preset.home;
+  // Trois accueils par style, et la graine de la marque tranche : deux boutiques « beauté » ne
+  // partent plus de la même recette. input.home reste prioritaire si l'assistant en impose une.
+  const famille = (preset.homes || [preset.home]).filter((id) => findRecipe(id));
+  const home = findRecipe(input.home) ? input.home : famille[graineDe(input.variation || input.name) % famille.length] || preset.home;
   recipes.push([home, 'templates/index.json']);
   const avecOffres = input.offers !== false;
   recipes.push([avecOffres ? 'produit-offres' : 'produit-complet', 'templates/product.json']);
@@ -777,9 +855,10 @@ export function buildStore({ catalog, store }, input) {
     const adaptes = adaptSteps(recipe.steps, { templateType, hasImages, hasLarge, proofs, collections });
     // Enrichissement APRÈS l'adaptation : c'est la page finale qu'on complète, sinon les
     // remplissages d'adaptSteps repoussaient les sections tirées derrière la FAQ.
+    const graine = graineDe(input.variation || input.name);
     const steps =
       templateType === 'index'
-        ? enrichir(adaptes, { direction: directionId, graine: graineDe(input.variation || input.name), hasImages, proofs })
+        ? varier(enrichir(adaptes, { direction: directionId, graine, hasImages, proofs }), { graine })
         : adaptes;
     const { data } = buildFromRecipe(catalog, { ...recipe, steps }, { language: lang, base: recipe.base ? catalog.theme.templates.get(recipe.base) : null });
     const baseCount = recipe.base ? catalog.theme.templates.get(recipe.base).order.length : 0;

package/src/knowledge/guides.js

@@ -206,8 +206,9 @@ Formats conseillés :
 
   limites: {
     title: 'Ce que le MCP (V1) ne fait pas',
-    body: `- Il ne se connecte à aucune boutique : il fabrique un thème (zip) à importer, il ne publie rien.
-- Il ne crée ni produits, ni collections, ni menus, ni pages, ni réductions, ni images : il les liste dans la check-list.
+    body: `- Il ne publie jamais un thème : il écrit dans un thème NON publié (push_to_shop) ou fabrique un zip à importer (export_theme) ; le marchand vérifie et publie lui-même.
+- Sans l'appli Story Apps sur la boutique, il n'a accès à rien d'elle : ni ses produits, ni ses thèmes. Appelez list_shops pour le savoir.
+- Il ne crée pas de lui-même produits, collections, menus, pages, réductions ni images : avec une boutique connectée, shop_graphql le permet ; sinon la check-list les liste.
 - Il ne modifie jamais le code du thème (Liquid, CSS, JS) : seulement les modèles, les groupes de sections et les réglages, comme l'éditeur de thème.
 - Il ne garantit pas le rendu visuel : prévisualisez toujours dans l'éditeur Shopify avant de publier.`,
   },
@@ -249,4 +250,40 @@ GUIDES.signatures = {
 **Règles** : 7 à 10 sections par page, alterner visuel et texte, une section colorée sur trois, un seul effet fort par écran. Les avis et chiffres d'une maquette sont des exemples à valider : écrivez-les, puis déclarez-les.`,
 };
 
+
+GUIDES.reproduire = {
+  title: 'Reproduire une section vue ailleurs (capture d’écran, site concurrent)',
+  body: `Le marchand montre une capture et dit « refais-moi ça ». La tentation est d'écrire du Liquid : c'est
+le plus rapide pour VOUS, et le plus coûteux pour LUI. Une section en code sort de l'éditeur Shopify —
+plus un mot modifiable, plus de palette, plus d'animation, rien à traduire — et aucune mise à jour du
+thème ne la corrigera. Le thème est fait pour éviter ça : 109 blocs publics, acceptés presque partout,
+imbriqués jusqu'à 8 niveaux.
+
+**L'ordre, sans exception**
+1. **Une section du thème qui fait déjà ça.** search_theme sur ce que vous voyez (« comparatif », « chiffres », « étapes »), puis get_section pour les presets. 60 sections, 200 presets : la plupart des maquettes y sont déjà.
+2. **advanced-custom-section** (« Section personnalisée », preset « Advanced custom section »). C'est le cadre vide qui accepte tous les blocs : vous posez la grille avec des groupes et vous la remplissez. Réglages utiles : direction, gap, align_horizontal, stack_on_mobile, color_palette, layout_width, padding, separators.
+3. **Le bloc custom_liquid en dernier recours, jamais de votre initiative** : dites ce qui manque, ce que le marchand y perd, et laissez-le décider. Le code reste légitime pour un script tiers (suivi, widget d'avis), pas pour une mise en page.
+
+**Exemple : la bande « 6 chiffres » (emoji, gros chiffre, sous-titre, phrase) vue sur beaucoup de sites DTC**
+advanced-custom-section (color_palette de la teinte voulue, direction horizontal, stack_on_mobile, gap)
+└ heading — title en richtext, le dernier mot en **gras** pour la couleur d'accent
+└ text — description, color_bold_words: accent-1 : les mots en gras se colorent tout seuls
+└ group (direction horizontal, align_vertical top, gap)
+  └ 6 × counter — icon (ou image_custom pour un emoji), heading « -80% », subheading, description, heading_font_size, duration pour le comptage animé
+Résultat : le rendu, ET chaque mot modifiable dans l'éditeur, ET la version mobile gérée, ET la traduction possible.
+
+**Les détails qui n'existent pas dans le thème** (surlignage jaune façon feutre, filets en pointillés entre
+colonnes, polices tierces) : ne les inventez pas en silence. Construisez les 90 % modifiables, puis une
+ligne : « deux détails ne sont pas natifs — le surlignage et les pointillés ; je peux les ajouter en code,
+mais cette section ne sera alors plus modifiable dans l'éditeur. »
+
+**Grilles courantes, en blocs**
+- Deux colonnes inégales : group horizontal + deux group width custom (8/12 et 4/12).
+- Carte avec image de fond et texte dessus : content-over-image, ou group avec background_image + overlay_opacity.
+- Onglets, carrousel : blocs tabs et carousel (ils acceptent eux aussi @theme).
+- Bande de logos, d'avis, de badges : logo-list, testimonial, trust-badges, badge.
+- Tableau comparatif : section comparison (preset « Us vs them ») plutôt qu'un tableau HTML.`,
+};
+
+// En dernier : la liste doit contenir TOUS les guides, y compris ceux ajoutés après l'objet.
 export const GUIDE_TOPICS = Object.keys(GUIDES);

package/src/server.js

@@ -63,17 +63,35 @@ Variez la structure : donnez une direction artistique (build_store direction) et
 
 Dites aussi ce qui doit exister côté Shopify pour que ça marche : les réductions correspondant aux offres, les pages et leurs modèles, les menus, l'application d'avis.
 
+Ne prétendez jamais avoir vu le rendu : le MCP écrit des fichiers, il n'affiche rien. Dites « à vérifier dans l'éditeur Shopify », jamais « je l'ai ouverte sur ordinateur et sur mobile ».
+
 Deux limites qui ne se négocient pas : ne publiez jamais un compte à rebours qui redémarre à l'infini ni un stock simulé (pratiques commerciales trompeuses, review_project les refuse), et prévenez que des avis inventés doivent être remplacés par de vrais avant la mise en ligne.
 
-## 4. Proposez de brancher le MCP Shopify
+## 4. Reproduire une mise en page : avec les blocs du thème, jamais avec du code
+
+Quand le marchand montre une capture d'écran, un site concurrent ou une section qu'il aime et demande « refais-moi ça », vous la composez avec le thème, dans cet ordre :
+
+1. **une section du thème qui fait déjà ça** — list_sections, search_theme et get_section donnent les vrais presets ;
+2. **sinon advanced-custom-section** (« Section personnalisée », preset « Advanced custom section »). Elle accepte TOUS les blocs du thème, et les groupes s'imbriquent les uns dans les autres : c'est ainsi que se fabrique n'importe quelle mise en page. Une bande de six colonnes « emoji + gros chiffre + sous-titre + phrase », ce sont six blocs counter dans un groupe horizontal (stack_on_mobile). Deux colonnes inégales, deux groupes de largeurs différentes. 109 blocs sont disponibles presque partout : c'est la force du thème, servez-vous-en ;
+3. **seulement si un détail reste impossible** : dites-le en une ligne et PROPOSEZ le bloc custom_liquid. Ne l'écrivez jamais de votre propre initiative.
+
+Le code personnalisé a un coût que le marchand paiera sans le savoir : la section sort de l'éditeur Shopify — plus un texte modifiable, plus de palette, plus d'animation, rien à traduire — et les mises à jour du thème ne la corrigeront pas. Une reproduction à 90 % entièrement modifiable vaut mieux qu'une copie exacte figée : construisez les 90 %, puis dites quels 10 % manquent (un surlignage jaune, un pointillé de séparation) et laissez le marchand choisir.
 
-Le Story Thème affiche ; il ne crée ni produits, ni collections, ni pages, ni menus, ni réductions. Dès la V1, proposez au marchand de connecter aussi un MCP Shopify à son assistant : vous pourrez alors créer les pages et leur attribuer les modèles, monter les menus, créer les réductions des offres, déposer les photos dans Contenu > Fichiers, et lire ses vrais produits et collections. Sans lui, listez ce qu'il doit faire à la main.
+Quelques blocs qui reviennent souvent : group (imbriquable, horizontal ou vertical, fond et image de fond), counter (icône ou image, gros chiffre animé, sous-titre, description), heading (titre en richtext), text (color_bold_words colore les mots en gras), icon, image, button, accordion, testimonial, specs, checklist, timeline. get_block donne les réglages réels. Avant d'envisager du code, appelez search_theme : neuf fois sur dix, le bloc existe.
+
+## 5. Ses vraies boutiques, avant tout le reste
+
+Appelez list_shops AVANT de construire. Il dit aussi quelles boutiques sont BRANCHÉES en direct : sur celles-là, vous écrivez dans un thème sans que le marchand importe quoi que ce soit — push_to_shop({ shops, create: true }) crée un thème non publié à partir du projet, et push_to_shop({ shops, theme }) écrit les retouches suivantes dedans. Le marchand prévisualise et publie lui-même ; le thème publié est refusé sauf demande explicite. Si aucune boutique n'est branchée, list_shops donne la marche à suivre (deux minutes, une seule fois) : proposez-la, c'est ce qui évite l'aller-retour par un zip à chaque modification. Si le marchand a installé l'application Story Apps, ses boutiques sont là : vous lisez ses vrais produits, collections et pages, et vous écrivez dedans (shop_graphql) sans aucune clé Shopify. Une boutique réelle bat toujours un contenu inventé — servez-vous-en pour les noms de produits, les prix, les collections, les photos déjà en ligne.
+
+Le Story Thème affiche ; il ne crée ni produits, ni collections, ni pages, ni menus, ni réductions. Si list_shops ne renvoie rien, proposez au marchand d'installer Story Apps (apps.story-theme.com) ou de brancher un MCP Shopify à son assistant : vous pourrez alors créer les pages et leur attribuer les modèles, monter les menus, créer les réductions des offres, et déposer les photos dans Contenu > Fichiers. Sans l'un ni l'autre, listez ce qu'il doit faire à la main.
 
 Si un connecteur Shopify est déjà disponible : lisez les collections et les produits réels, copiez 3 à 6 belles photos dans Contenu > Fichiers (read_guide images donne la requête fileCreate), puis passez leurs noms dans images (celles de 1600 px et plus dans images.large) et les handles dans collections.
 
-## 5. Après la V1
+## 6. Après la V1
+
+Résumez en quelques lignes, donnez le lien ou le chemin du zip, listez ce que vous avez inventé, puis posez 3 à 5 questions pour affiner.
 
-Résumez en quelques lignes, donnez le lien ou le chemin du zip, listez ce que vous avez inventé, puis posez 3 à 5 questions pour affiner. Chaque réponse s'applique au projet en cours sans le re-préciser : edit_template, update_theme_settings, apply_recipe, compose_page, puis export_theme.
+Le zip ne sert qu'une fois : une fois le Story Thème présent dans la bibliothèque de la boutique, push_to_shop écrit les retouches suivantes directement dans un thème NON publié (le marchand prévisualise, puis publie lui-même). Proposez-le dès que list_shops renvoie une boutique — quatre gestes en moins à chaque aller-retour. Chaque réponse s'applique au projet en cours sans le re-préciser : edit_template, update_theme_settings, apply_recipe, compose_page, puis export_theme.
 
 Garde-fous : aucun type de section, de bloc ou d'identifiant de réglage inventé (get_section, get_block, search_theme donnent les vrais) ; tout fichier est validé avant d'être enregistré ; undo annule. Le MCP ne touche ni au code du thème ni à une boutique en ligne.
 
@@ -306,7 +324,7 @@ export function createServer(config) {
           '- Construire : create_project, update_brief, apply_recipe, localize_template, list_texts, edit_template, write_file, update_theme_settings, read_file, exclude_template',
           '- Contrôler : validate_json, review_project, undo, revert_file',
           '- Livrer : export_theme (zip + check-list) ; import_theme pour auditer un thème exporté d’une boutique',
-          '- Vos boutiques en direct (appli Story Apps) : list_shops, shops_overview, shop_graphql',
+          '- Vos boutiques en direct (appli Story Apps) : list_shops, shops_overview, shop_graphql, push_to_shop (envoyer le projet dans un thème sans zip)',
           `Guides : ${GUIDE_TOPICS.join(', ')}`,
           '',
           `## Projets (${projects.length})`,
@@ -1446,7 +1464,7 @@ Read the file first (read_file) to get ids.`,
   }
 
   // Boutiques du compte, via l'appli Shopify Story Apps (src/shops/).
-  registerShopTools(server, config);
+  registerShopTools(server, config, { ctx });
 
   return server;
 }

package/src/shops/direct.js

@@ -0,0 +1,187 @@
+// =====================================================================
+// Écrire dans la boutique du marchand, sans zip
+// =====================================================================
+// Première tentative : l'API GraphQL des thèmes de Shopify. Refusée — `themeFilesUpsert` et
+// `themeCreate` exigent une dérogation accordée au cas par cas, y compris à une application
+// personnalisée (vérifié en production : ACCESS_DENIED).
+//
+// L'API REST, elle, ne restreint que les applications distribuées sur l'App Store. Le marchand
+// crée donc une application personnalisée dans sa propre administration, colle son jeton une
+// fois dans son espace membre, et tout passe ensuite par là (vérifié : PUT assets.json → 200).
+//
+// Le MCP ne voit jamais ce jeton : il parle à l'espace membre, qui détient les jetons chiffrés
+// et applique les règles — boutiques du compte seulement, fichiers autorisés seulement, thème
+// publié refusé sauf demande explicite.
+
+import { z } from 'zod';
+
+const chemin = (config, suite) => `${String(config.apiBase || 'https://story-theme.com').replace(/\/+$/, '')}/api/v1/mcp${suite}`;
+
+/** Un appel à l'espace membre, avec le jeton de la session. */
+async function appel(config, suite, options = {}) {
+  if (!config.token) {
+    throw new Error(
+      'Aucun jeton : connectez le MCP à votre espace Story Thème (bouton « Se connecter » du connecteur), ou ajoutez STORY_MCP_TOKEN.',
+    );
+  }
+  let reponse;
+  try {
+    reponse = await fetch(chemin(config, suite), {
+      ...options,
+      headers: { Authorization: `Bearer ${config.token}`, 'Content-Type': 'application/json', Accept: 'application/json', ...(options.headers || {}) },
+      signal: AbortSignal.timeout(120000),
+    });
+  } catch {
+    throw new Error('Espace Story Thème injoignable. Réessayez dans un instant.');
+  }
+  const data = await reponse.json().catch(() => ({}));
+  if (!reponse.ok) throw new Error(data.message || `Erreur ${reponse.status}`);
+  return data.data || {};
+}
+
+const AIDE_BRANCHEMENT = [
+  'Pour brancher une boutique (une fois, deux minutes) :',
+  '1. Espace membre Story Thème > MCP & Appli > « Brancher une boutique ».',
+  '2. Le lien ouvre l’administration Shopify : Paramètres > Applications > Développer des applications > Créer une application.',
+  '3. Autorisations Admin : cochez write_themes et read_themes, puis installez.',
+  '4. Révélez le jeton (shpat_…) et collez-le dans l’espace membre.',
+  'Ensuite, tout s’écrit directement dans la boutique : plus aucun zip à importer.',
+].join('\n');
+
+export function registerDirectTools(server, config, { ctx, ok, garde }) {
+  server.registerTool(
+    'list_shops',
+    {
+      title: 'Vos boutiques',
+      description:
+        'Lists the Shopify stores declared in this Story Theme account, and says which ones are wired for direct writing. Call it before any store work.',
+      annotations: { readOnlyHint: true, openWorldHint: true },
+    },
+    garde(async () => {
+      const { boutiques = [] } = await appel(config, '/boutiques');
+      if (!boutiques.length) {
+        return ok(`Aucune boutique déclarée dans ce compte Story Thème (espace membre > Boutiques).\n\n${AIDE_BRANCHEMENT}`, { boutiques });
+      }
+      const lignes = boutiques.map((b) => `${b.branchee ? '●' : '○'} ${b.nom} — ${b.domaine}${b.branchee ? '' : ' (non branchée)'}`);
+      const branchees = boutiques.filter((b) => b.branchee).length;
+      return ok(
+        [
+          `${boutiques.length} boutique(s) · ${branchees} branchée(s) en direct`,
+          '',
+          ...lignes,
+          '',
+          branchees ? 'push_to_shop écrit directement dans une boutique branchée.' : '',
+          // Une seule boutique branchée sur trois, c'est deux marchands qui ignorent encore
+          // que c'est possible : la marche à suivre reste affichée tant qu'il en manque une.
+          branchees < boutiques.length ? `${branchees ? '\n' : ''}${AIDE_BRANCHEMENT}` : '',
+        ]
+          .filter((ligne) => ligne !== '')
+          .join('\n'),
+        { boutiques },
+      );
+    }),
+  );
+
+  server.registerTool(
+    'push_to_shop',
+    {
+      title: 'Envoyer le projet dans une boutique',
+      description:
+        'Writes the project files (page templates, section groups, theme settings) straight into a theme of one connected store — no zip, no manual import. Without `theme`, lists the store themes. With `create: true`, creates a brand new unpublished theme from the project and writes nothing else. The published theme is refused unless confirm: true. Theme code is never touched.',
+      inputSchema: {
+        shops: z.string().describe('UNE boutique : son domaine ou son nom (list_shops les donne).'),
+        project: z.string().optional().describe('Projet à envoyer (par défaut : le projet en cours).'),
+        theme: z.string().optional().describe('Thème de destination : son identifiant numérique. Sans lui, la liste des thèmes est renvoyée.'),
+        create: z.boolean().optional().describe('Créer un thème NON PUBLIÉ à partir du projet, au lieu d’écrire dans un thème existant.'),
+        confirm: z.boolean().optional().describe('Obligatoire pour écrire dans le thème PUBLIÉ. Seulement après demande explicite du marchand.'),
+      },
+      annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
+    },
+    garde(async ({ shops, project, theme, create, confirm }) => {
+      const cible = String(shops || '').trim();
+      if (!cible || cible === 'all') throw new Error('push_to_shop écrit dans UNE boutique à la fois : donnez son domaine (list_shops).');
+
+      const { store, catalog } = ctx.get();
+      const slug = store.resolve(project);
+      const meta = store.meta(slug);
+      const encode = encodeURIComponent(cible);
+
+      // Créer un thème : l'espace membre fabrique le zip, Shopify vient le chercher.
+      if (create) {
+        if (typeof config.publishExport !== 'function') {
+          throw new Error(
+            'La création de thème demande que le MCP soit servi par l’espace membre (connecteur). En local, exportez le zip (export_theme) et importez-le une fois.',
+          );
+        }
+        const { exportTheme } = await import('../project/export.js');
+        const resultat = exportTheme({ catalog, store, slug });
+        if (!resultat.ok) throw new Error(resultat.message);
+        // Le zip part sur notre stockage : c'est de là que Shopify viendra le chercher, par un
+        // lien signé que l'espace membre fabrique lui-même. Il ne passe jamais par l'assistant.
+        await config.publishExport({ zip: resultat.zip, checklist: resultat.checklist, project: slug, catalog: meta.theme?.version });
+        const fichier = resultat.zip.split('/').pop();
+
+        const { theme: cree } = await appel(config, `/boutiques/${encode}/themes`, {
+          method: 'POST',
+          body: JSON.stringify({ nom: meta.name || slug, projet: slug, fichier }),
+        });
+        return ok(
+          [
+            `Thème « ${cree.nom} » créé sur ${cible}, en NON PUBLIÉ (identifiant ${cree.id}).`,
+            cree.traitement ? 'Shopify le décompresse : comptez une minute avant qu’il soit consultable.' : '',
+            '',
+            `Prévisualiser : https://${cible}/?preview_theme_id=${cree.id}`,
+            'Le marchand vérifie chaque page, puis publie lui-même (Boutique en ligne > Thèmes).',
+            'Les retouches suivantes iront directement dedans : push_to_shop avec son identifiant.',
+          ]
+            .filter(Boolean)
+            .join('\n'),
+          { theme: cree },
+        );
+      }
+
+      // Sans thème : on montre ce qui existe, le marchand choisit.
+      if (!theme) {
+        const { themes = [], domaine } = await appel(config, `/boutiques/${encode}/themes`);
+        return ok(
+          [
+            `Thèmes de ${domaine || cible} :`,
+            ...themes.map((t) => `- ${t.nom} — identifiant ${t.id}${t.role === 'main' ? ' — PUBLIÉ (la vitrine actuelle)' : ''}`),
+            '',
+            `Écrire dedans : push_to_shop({ shops: "${cible}", theme: "<identifiant>" }).`,
+            `Créer un thème neuf à la place : push_to_shop({ shops: "${cible}", create: true }).`,
+            'Choisissez un thème NON publié : le marchand prévisualise, puis publie lui-même.',
+          ].join('\n'),
+          { themes },
+        );
+      }
+
+      // Les fichiers du projet, et eux seuls : le serveur refuse tout le reste de toute façon.
+      const fichiers = [...store.effectiveFiles(slug)]
+        .filter(([, entree]) => entree.origin === 'project')
+        .map(([rel, entree]) => ({ chemin: rel, contenu: `${JSON.stringify(entree.data, null, 2)}\n` }));
+      if (!fichiers.length) throw new Error(`Le projet « ${slug} » n’a aucun fichier personnalisé : construisez la boutique d’abord.`);
+
+      const resultat = await appel(config, `/boutiques/${encode}/themes/${encodeURIComponent(theme)}`, {
+        method: 'PUT',
+        body: JSON.stringify({ fichiers, confirm: confirm === true }),
+      });
+
+      const exclus = store.excluded(slug);
+      return ok(
+        [
+          `${resultat.ecrits.length} fichier(s) écrits dans « ${resultat.theme.nom} » sur ${resultat.domaine}${resultat.theme.role === 'main' ? ' — THÈME PUBLIÉ, la boutique a changé' : ''}.`,
+          resultat.refuses?.length ? `Refusés : ${resultat.refuses.join(' · ')}` : '',
+          '',
+          `Prévisualiser : ${resultat.apercu}`,
+          resultat.theme.role === 'main' ? '' : 'Le marchand vérifie sur ordinateur et sur mobile, puis publie lui-même.',
+          exclus.length ? `Modèles exclus du projet mais toujours présents dans ce thème : ${exclus.join(', ')}.` : '',
+          'Images, produits, collections, menus et réductions restent à créer côté Shopify : review_project en donne la liste.',
+        ]
+          .filter(Boolean)
+          .join('\n'),
+        resultat,
+      );
+    }),
+  );
+}

package/src/shops/tools.js

@@ -8,6 +8,7 @@
 import { z } from 'zod';
 import { createShopsClient, appsBase, ShopsError } from './client.js';
 import { formatShopList, formatOverview, formatGraphql } from './format.js';
+import { registerDirectTools } from './direct.js';
 
 const ok = (text, structured) => ({ content: [{ type: 'text', text }], ...(structured ? { structuredContent: structured } : {}) });
 const fail = (text) => ({ content: [{ type: 'text', text: `⛔ ${text}` }], isError: true });
@@ -24,10 +25,12 @@ const cibleSchema = z
   .union([z.string(), z.array(z.string())])
   .describe('Boutique(s) : handle (ex. "maison-lumen"), domaine, liste, ou "all" pour toutes.');
 
-export function registerShopTools(server, config, { fetchImpl } = {}) {
+export function registerShopTools(server, config, { fetchImpl, ctx } = {}) {
   const client = createShopsClient({ token: config.token, base: appsBase(), fetchImpl });
 
-  server.registerTool(
+  // `list_shops` est servi par direct.js quand un projet est disponible : il dit en plus
+  // quelles boutiques sont branchées pour l'écriture directe. Ici, c'est le repli.
+  if (!ctx) server.registerTool(
     'list_shops',
     {
       title: 'Vos boutiques',
@@ -74,4 +77,7 @@ export function registerShopTools(server, config, { fetchImpl } = {}) {
       return ok(formatGraphql(data), data);
     }),
   );
+
+  // L'envoi direct suppose un projet sous la main : seul le serveur complet passe `ctx`.
+  if (ctx) registerDirectTools(server, config, { ctx, ok, garde });
 }

package/src/validate/design.js

@@ -135,7 +135,12 @@ export function lintTemplate(catalog, file, data, { language = 'fr' } = {}) {
     if (section.type === 'popup') popups += 1;
     if ((section.type === 'banner' && settings.media_type === 'video') || section.type === 'video') autoplayMedia += 1;
     if (settings.hide_desktop && settings.hide_mobile) add('info', id, 'section masquée sur ordinateur et sur mobile');
-    if (section.type === 'custom-liquid') add('suggestion', id, 'code Liquid personnalisé : le marchand ne pourra pas le modifier sans développeur');
+    // Le code personnalisé est légitime pour un script tiers (suivi, widget) ; il ne l'est pas
+    // pour une mise en page. Le thème accepte ses 109 blocs presque partout, imbriqués les uns
+    // dans les autres : advanced-custom-section reproduit la même chose, et reste modifiable.
+    if (section.type === 'custom-liquid') {
+      add('suggestion', id, 'section en code Liquid : ni modifiable dans l’éditeur Shopify, ni traduisible, ni corrigée par les mises à jour du thème. Si elle sert une mise en page, refaites-la avec advanced-custom-section et des blocs ; gardez le code pour un script tiers.');
+    }
     if (position === 0 && templateType === 'index' && !HERO_TYPES.has(section.type)) {
       add('suggestion', id, `la page d'accueil commence par « ${section.type} » : un héro (banner, slideshow, video) pose la promesse de la marque dès l'arrivée`);
     }
@@ -165,6 +170,9 @@ export function lintTemplate(catalog, file, data, { language = 'fr' } = {}) {
       if (block.type === 'product-stock' && blockSettings.source === 'simulated') {
         add('important', path, 'stock simulé : afficher un faux stock est une pratique commerciale trompeuse. Utilisez le stock Shopify.');
       }
+      if (block.type === 'custom_liquid') {
+        add('suggestion', path, 'bloc en code Liquid : le marchand ne pourra en changer ni un mot ni une couleur depuis l’éditeur. Pour une mise en page, les blocs du thème (group imbriqué, counter, heading, text, icon, image) font la même chose en modifiable.');
+      }
       if (block.type === 'image' && !blockSettings.image) add('important', path, "image vide : un carré gris « image manquante » s'affiche. Placez une photo ou retirez le bloc");
       if (block.type === 'rating' || (block.type === 'product-rating' && blockSettings.source === 'manual')) {
         add('suggestion', path, 'note saisie à la main : elle doit refléter vos avis réels (sinon supprimez le bloc)');

package/src/version.js

@@ -1,3 +1,3 @@
 // Version du serveur MCP. Ici et dans package.json — les deux doivent être identiques
 // (npm test le vérifie), et rien d'autre ne la redéclare.
-export const VERSION = '1.3.0';
+export const VERSION = '1.5.0';