story-theme-mcp 1.2.3 → 1.4.0

package/README.md

@@ -52,12 +52,14 @@ Le MCP ne contient pas le thème : au démarrage, il demande à l'espace membre
 | Étape | Outils |
 |---|---|
 | Connaître le thème | `get_started`, `theme_source`, `search_theme`, `list_sections`, `get_section`, `list_blocks`, `get_block`, `get_theme_settings`, `get_theme_template`, `read_guide` |
+| S'inspirer | `inspiration` : les 11 boutiques démo composées par le designer — l'ossature de leurs pages, à regarder avant de construire |
 | Concevoir | `recipes` (15 compositions de pages), `generate_color_schemes`, `check_contrast`, `find_fonts` |
 | Construire vite | `build_store` : la V1 complète d'une boutique en un appel (direction artistique, pages de marque, moments signature, textes, traduction, zip) |
 | Composer librement | `compose_page` : n'importe quelle page avec toutes les sections du thème, en donnant seulement le contenu (titre, texte, boutons, étapes, cartes, questions, chiffres…) |
 | 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>`).
 
@@ -66,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.
 
@@ -96,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.2.3",
+  "version": "1.4.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/demos.js

@@ -0,0 +1,81 @@
+// =====================================================================
+// Les boutiques démo, vues par l'assistant
+// =====================================================================
+// Onze boutiques composées par le designer du thème dorment dans l'espace membre. L'assistant
+// ne les voyait pas : il repartait des recettes, et deux marques du même style se ressemblaient.
+//
+// Il lit maintenant leur OSSATURE — quelles sections, dans quel ordre, avec quels blocs — pour
+// s'en inspirer comme un designer regarde le travail d'un confrère. Jamais leurs textes : dix
+// boutiques clientes qui racontent la même histoire seraient pires que dix boutiques identiques.
+//
+// Deux chemins d'accès, selon l'endroit où tourne le MCP :
+//   connecteur  `config.demos` : l'espace membre sert les démos sans aller-retour réseau ;
+//   local       l'API `/api/v1/mcp/demos`, avec le jeton du client.
+
+const CHEMIN = '/api/v1/mcp/demos';
+
+/** Rend les démos accessibles, quelle que soit la façon dont le MCP est servi. */
+export function creerDemos(config) {
+  // Connecteur : l'espace membre a déjà tout sous la main.
+  if (config.demos) return config.demos;
+
+  const appel = async (chemin) => {
+    if (!config.token) {
+      throw new Error(
+        'Les boutiques démo demandent un jeton : ajoutez STORY_MCP_TOKEN (espace membre Story Thème > MCP & Appli).',
+      );
+    }
+    const reponse = await fetch(`${config.apiBase.replace(/\/+$/, '')}${chemin}`, {
+      headers: { Authorization: `Bearer ${config.token}`, Accept: 'application/json' },
+      signal: AbortSignal.timeout(15000),
+    });
+    if (!reponse.ok) throw new Error(`réponse ${reponse.status} de l’espace membre`);
+    return (await reponse.json()).data;
+  };
+
+  return {
+    lister: async () => (await appel(CHEMIN)).demos,
+    composition: async (slug) => appel(`${CHEMIN}/${encodeURIComponent(slug)}`),
+  };
+}
+
+/** Le catalogue, en une liste lisible. */
+export function formatDemos(demos) {
+  if (!demos?.length) return 'Aucune boutique démo disponible.';
+  return [
+    `${demos.length} boutiques démo, composées par le designer du thème. Regardez celle dont l’activité ressemble le plus à celle du marchand, puis inspirez-vous de sa COMPOSITION — jamais de ses textes.`,
+    '',
+    ...demos.map((demo) => `- **${demo.slug}** — ${demo.nom} · ${demo.niche}${demo.type ? ` · ${demo.type}` : ''}\n  ${demo.pitch}`),
+    '',
+    'inspiration({ demo: "<slug>" }) donne la composition de ses pages.',
+  ].join('\n');
+}
+
+/** La composition d'une démo : une ligne par section, dans l'ordre de la page. */
+export function formatComposition(composition, pageDemandee) {
+  const pages = composition.pages || {};
+  const noms = Object.keys(pages);
+  if (!noms.length) return `La démo « ${composition.slug} » n’expose aucune page.`;
+
+  const choisies = pageDemandee
+    ? noms.filter((nom) => nom === pageDemandee || nom === `page.${pageDemandee}`)
+    : ['index', 'product', 'collection'].filter((nom) => pages[nom]);
+
+  if (!choisies.length) return `Page « ${pageDemandee} » absente. Pages disponibles : ${noms.join(', ')}.`;
+
+  const lignes = [`# ${composition.nom} (${composition.slug}) — ${composition.niche}`, composition.pitch, ''];
+  for (const nom of choisies) {
+    lignes.push(`## ${nom} — ${pages[nom].length} sections`);
+    pages[nom].forEach((section, index) => {
+      const blocs = section.blocs?.length ? ` — blocs : ${section.blocs.join(', ')}` : '';
+      const palette = section.palette ? ` [${section.palette}]` : '';
+      lignes.push(`${index + 1}. ${section.type}${palette}${blocs}`);
+    });
+    lignes.push('');
+  }
+  lignes.push(`Pages disponibles : ${noms.join(', ')}.`);
+  lignes.push(
+    'Inspirez-vous de l’enchaînement et du rythme des palettes ; écrivez vos propres textes, et n’imposez pas cette structure si la marque appelle autre chose.',
+  );
+  return lignes.join('\n');
+}

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

@@ -20,6 +20,7 @@ import { composeSections } from './build/compose.js';
 import { DIRECTIONS } from './knowledge/directions.js';
 import { ProjectStore, checkRelativePath } from './project/store.js';
 import { localSource } from './theme/source.js';
+import { creerDemos, formatDemos, formatComposition } from './knowledge/demos.js';
 import { reviewProject, formatReview, findSchemeReferences } from './project/review.js';
 import { exportTheme, importTheme, migrateProject } from './project/export.js';
 import { GUIDES, GUIDE_TOPICS } from './knowledge/guides.js';
@@ -52,7 +53,9 @@ Appelez build_store AVEC un paramètre copy le plus rempli possible. Une V1 qui
 
 ÉCRIVEZ LE CONTENU. Rédigez la promesse, le manifeste, les bénéfices, les étapes de fabrication, la FAQ, les valeurs, les pages d'aide (livraison, retours, garantie, paiement), les offres par paliers, et oui : des avis clients plausibles et un peu d'urgence honnête (une offre de lancement, un lot). C'est une MAQUETTE que le marchand valide, pas une boutique en ligne : mieux vaut un exemple concret qu'il corrige qu'un cadre vide qu'il doit remplir seul.
 
-La fiche produit part AVEC des offres par paliers (1 / 2 / 3 pièces, ou lot + cadeau) : c'est le défaut, écrivez-en les libellés et les remises, et rappelez au marchand de créer les réductions correspondantes dans Shopify.\n\nVariez la structure : donnez une direction artistique (build_store direction) et, pour deux boutiques du même style, un paramètre variation différent. compose_page crée les pages que les recettes ne prévoient pas (ingrédients, lookbook, comparatif, guide cadeau, livraison, garantie).
+La fiche produit part AVEC des offres par paliers (1 / 2 / 3 pièces, ou lot + cadeau) : c'est le défaut, écrivez-en les libellés et les remises, et rappelez au marchand de créer les réductions correspondantes dans Shopify.\n\nAvant de construire, appelez inspiration : les onze boutiques démo sont composées par le designer du thème. Regardez celle dont l'activité ressemble le plus à celle du marchand et reprenez-en l'enchaînement et le rythme des palettes — jamais les textes, et sans vous y enfermer si la marque appelle autre chose.
+
+Variez la structure : donnez une direction artistique (build_store direction) et, pour deux boutiques du même style, un paramètre variation différent. compose_page crée les pages que les recettes ne prévoient pas (ingrédients, lookbook, comparatif, guide cadeau, livraison, garantie).
 
 ## 3. Déclarez TOUT ce que vous avez inventé
 
@@ -60,17 +63,35 @@ La fiche produit part AVEC des offres par paliers (1 / 2 / 3 pièces, ou lot + c
 
 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. 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. 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.
+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.
+
+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.
 
@@ -298,12 +319,12 @@ export function createServer(config) {
           '',
           '## Outils',
           '- Connaître le thème : search_theme, list_sections, get_section, list_blocks, get_block, get_theme_settings, get_theme_template, read_guide',
-          '- Concevoir : recipes, generate_color_schemes, check_contrast, find_fonts',
+          '- Concevoir : inspiration (les 11 boutiques démo, à regarder avant de composer), recipes, generate_color_schemes, check_contrast, find_fonts',
           '- Construire vite : build_store (V1 complète en un appel), compose_page (pages originales avec toutes les sections), read_guide signatures',
           '- 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})`,
@@ -376,6 +397,30 @@ export function createServer(config) {
     }),
   );
 
+  server.registerTool(
+    'inspiration',
+    {
+      title: 'Boutiques démo',
+      description:
+        'The eleven Story Theme demo stores, composed by the theme designer. Without arguments: the catalogue (niche, positioning). With `demo`: how that store composes its pages — sections in order, palettes, block types. Look at the demo closest to the merchant’s business BEFORE building, and take inspiration from the sequence and rhythm — never from its texts.',
+      inputSchema: {
+        demo: z.string().optional().describe('Identifiant d’une démo (sylys, narvo, havn…)'),
+        page: z.string().optional().describe('Page précise : index, product, collection, ou une page de marque (page.a-propos…)'),
+      },
+      annotations: readOnly,
+    },
+    run(async ({ demo, page }) => {
+      const demos = creerDemos(config);
+      if (!demo) return ok(formatDemos(await demos.lister()));
+      const composition = await demos.composition(demo);
+      if (!composition) {
+        const connues = (await demos.lister()).map((entree) => entree.slug);
+        return fail(`Démo « ${demo} » inconnue. Disponibles : ${connues.join(', ')}.`);
+      }
+      return ok(formatComposition(composition, page));
+    }),
+  );
+
   server.registerTool(
     'read_guide',
     {
@@ -1419,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/push.js

@@ -0,0 +1,198 @@
+// =====================================================================
+// Envoyer un projet dans une boutique, sans repasser par un zip
+// =====================================================================
+// Jusqu'ici, chaque retouche coûtait quatre gestes au marchand : exporter, télécharger,
+// importer dans Shopify, republier. Avec l'appli Story Apps déjà installée sur la boutique,
+// les fichiers que le MCP possède — modèles, groupes de sections, réglages du thème —
+// s'écrivent directement dans un thème de sa bibliothèque.
+//
+// Écrire dans une boutique en ligne ne se rattrape pas. Quatre garde-fous, dans cet ordre :
+//
+//   1. une seule boutique à la fois : « all » est refusé ;
+//   2. jamais le thème PUBLIÉ sans confirm: true — la vitrine changerait à la seconde ;
+//   3. jamais un thème qui n'est pas un Story Thème, ni une version majeure différente : nos
+//      modèles citent des sections qui n'existeraient pas en face, la boutique afficherait
+//      des cadres en erreur ;
+//   4. seulement les fichiers du projet. Le code du thème (Liquid, CSS, JS) n'est jamais
+//      touché — ici comme partout ailleurs dans le MCP.
+//
+// Ce qui n'est PAS fait : supprimer des fichiers à distance. Un modèle exclu du projet reste
+// dans le thème de la boutique ; on le dit plutôt que de l'effacer sans qu'on l'ait demandé.
+
+import { z } from 'zod';
+import { ShopsError } from './client.js';
+
+// Shopify accepte davantage de fichiers par appel, mais un lot court échoue proprement : on
+// sait quels modèles sont passés, et un dépassement de taille ne fait pas tout retomber.
+const FICHIERS_PAR_LOT = 20;
+
+const REQUETE_THEMES = `query StoryMcpThemes { themes(first: 50) { nodes { id name role } } }`;
+
+const REQUETE_MARQUEUR = `query StoryMcpThemeCheck($id: ID!) {
+  theme(id: $id) {
+    id
+    name
+    role
+    files(filenames: ["config/settings_schema.json"], first: 1) {
+      nodes { body { ... on OnlineStoreThemeFileBodyText { content } } }
+    }
+  }
+}`;
+
+const MUTATION_PUSH = `mutation StoryMcpPush($themeId: ID!, $files: [OnlineStoreThemeFilesUpsertFileInput!]!) {
+  themeFilesUpsert(themeId: $themeId, files: $files) {
+    upsertedThemeFiles { filename }
+    userErrors { filename code message }
+  }
+}`;
+
+/** Le résultat de LA boutique visée, ou une erreur en français. */
+function resultatUnique(reponse, cible) {
+  const resultat = reponse.results?.[0];
+  if (!resultat) throw new ShopsError(`Boutique « ${cible} » introuvable : appelez list_shops pour voir les boutiques connectées.`);
+  if (resultat.errors?.length) {
+    const message = resultat.errors.map((erreur) => erreur.message).join(' · ');
+    // L'erreur de scope est la plus probable, et la plus opaque telle que Shopify la rend.
+    if (/write_themes|access denied|not approved/i.test(message)) {
+      throw new ShopsError(
+        "Story Apps n'a pas encore le droit d'écrire dans les thèmes de cette boutique. Ouvrez l'application Story Thème dans l'administration Shopify, page « Thème », et acceptez la demande d'autorisation (write_themes). Puis relancez push_to_shop.",
+      );
+    }
+    throw new ShopsError(message);
+  }
+  return resultat;
+}
+
+const numeroDe = (gid) => String(gid || '').split('/').pop();
+
+/** La version majeure du thème : 4.1.2 et 4.0.0 sont compatibles, 3.x et 4.x ne le sont pas. */
+const majeure = (version) => String(version || '').split('.')[0] || '';
+
+export function registerPushTool(server, { client, ctx, ok, garde }) {
+  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. The store must already run a Story Theme: export and import the zip once, then every later iteration goes through this tool. Without a theme argument, lists the store themes so the merchant can pick an unpublished one. The published theme is refused unless confirm: true. Theme code is never touched, and nothing is ever deleted remotely.',
+      inputSchema: {
+        shops: z.string().describe('UNE boutique : son handle ou son domaine (list_shops les donne). « all » est refusé.'),
+        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 ou son nom exact. Sans lui, la liste des thèmes de la boutique est renvoyée.'),
+        confirm: z
+          .boolean()
+          .optional()
+          .describe('Obligatoire pour écrire dans le thème PUBLIÉ : la boutique en ligne change immédiatement. Seulement après demande explicite du marchand.'),
+      },
+      annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
+    },
+    garde(async ({ shops, project, theme, confirm }) => {
+      const cible = String(shops || '').trim();
+      if (!cible || cible === 'all') {
+        throw new ShopsError('push_to_shop écrit dans UNE boutique à la fois : donnez son handle ou son domaine (list_shops).');
+      }
+
+      const { store } = ctx.get();
+      const slug = store.resolve(project);
+      const meta = store.meta(slug);
+
+      // 1. Les thèmes de la boutique.
+      const liste = resultatUnique(await client.graphql({ shops: cible, query: REQUETE_THEMES }), cible);
+      const nomBoutique = liste.name || cible;
+      const themes = liste.data?.themes?.nodes || [];
+
+      if (!theme) {
+        return ok(
+          [
+            `Thèmes de ${nomBoutique} :`,
+            ...themes.map((entree) => `- ${entree.name} — identifiant ${numeroDe(entree.id)}${entree.role === 'MAIN' ? ' — PUBLIÉ (la vitrine actuelle)' : ''}`),
+            '',
+            `Relancez : push_to_shop({ shops: "${cible}", theme: "<identifiant ou nom>" }).`,
+            'Choisissez un thème NON publié : le marchand prévisualise, vérifie, puis publie lui-même.',
+            "Si la boutique n'a pas encore de Story Thème dans sa bibliothèque, faites export_theme et importez le zip une seule fois — les envois suivants passeront par ici.",
+          ].join('\n'),
+          { shop: liste.shop, themes },
+        );
+      }
+
+      const trouve = themes.find((entree) => entree.id === theme || numeroDe(entree.id) === String(theme) || entree.name === theme);
+      if (!trouve) {
+        throw new ShopsError(
+          `Thème « ${theme} » introuvable sur ${nomBoutique}. Thèmes disponibles : ${themes.map((entree) => `${entree.name} (${numeroDe(entree.id)})`).join(', ') || 'aucun'}.`,
+        );
+      }
+
+      // 2. Le thème publié : seulement si le marchand l'a demandé.
+      if (trouve.role === 'MAIN' && confirm !== true) {
+        throw new ShopsError(
+          `« ${trouve.name} » est le thème PUBLIÉ de ${nomBoutique} : la boutique en ligne changerait immédiatement, sous les yeux de ses visiteurs. Choisissez un thème non publié, ou relancez avec confirm: true si le marchand vous l'a explicitement demandé.`,
+        );
+      }
+
+      // 3. Un Story Thème, et de la même version majeure que le projet.
+      const marqueur = resultatUnique(await client.graphql({ shops: cible, query: REQUETE_MARQUEUR, variables: { id: trouve.id } }), cible);
+      const schema = marqueur.data?.theme?.files?.nodes?.[0]?.body?.content || '';
+      if (!/"theme_name"\s*:\s*"[^"]*Story Theme/i.test(schema)) {
+        throw new ShopsError(
+          `« ${trouve.name} » n'est pas un Story Thème : y écrire nos modèles afficherait des sections inexistantes sur toutes les pages. Importez d'abord le Story Thème (export_theme), puis relancez.`,
+        );
+      }
+      const versionBoutique = schema.match(/"theme_version"\s*:\s*"([^"]+)"/i)?.[1] || '';
+      const versionProjet = meta.theme?.version || '';
+      if (majeure(versionBoutique) && majeure(versionProjet) && majeure(versionBoutique) !== majeure(versionProjet)) {
+        throw new ShopsError(
+          `« ${trouve.name} » est en Story Thème ${versionBoutique}, le projet a été construit sur la ${versionProjet}. Les sections ont changé entre ces versions : mettez le thème de la boutique à jour (application Story Thème, page « Thème »), ou migrez le projet (migrate_project), puis relancez.`,
+        );
+      }
+
+      // 4. Les fichiers du projet, et eux seuls.
+      const fichiers = [...store.effectiveFiles(slug)]
+        .filter(([, entree]) => entree.origin === 'project')
+        .map(([rel, entree]) => ({ filename: rel, body: { type: 'TEXT', value: `${JSON.stringify(entree.data, null, 2)}\n` } }));
+      if (!fichiers.length) {
+        throw new ShopsError(
+          `Le projet « ${slug} » n'a encore aucun fichier personnalisé : il n'y a rien à envoyer. Construisez la boutique (build_store) d'abord.`,
+        );
+      }
+
+      const envoyes = [];
+      const refuses = [];
+      for (let debut = 0; debut < fichiers.length; debut += FICHIERS_PAR_LOT) {
+        const lot = fichiers.slice(debut, debut + FICHIERS_PAR_LOT);
+        // confirm: true — la passerelle ne le réclame que pour plusieurs boutiques, et il n'y en
+        // a qu'une ici ; on le passe pour que l'intention soit explicite dans son journal.
+        const reponse = resultatUnique(
+          await client.graphql({ shops: cible, query: MUTATION_PUSH, variables: { themeId: trouve.id, files: lot }, confirm: true }),
+          cible,
+        );
+        const bloc = reponse.data?.themeFilesUpsert;
+        envoyes.push(...(bloc?.upsertedThemeFiles || []).map((fichier) => fichier.filename));
+        refuses.push(...(bloc?.userErrors || []).map((erreur) => `${erreur.filename || '(fichier)'} : ${erreur.message}`));
+      }
+
+      const domaine = liste.shop || cible;
+      const exclus = store.excluded(slug);
+      return ok(
+        [
+          `${envoyes.length} fichier(s) écrits dans « ${trouve.name} » sur ${nomBoutique}${trouve.role === 'MAIN' ? ' — THÈME PUBLIÉ, la boutique a changé' : ''}.`,
+          refuses.length ? `Refusés par Shopify : ${refuses.join(' · ')}` : '',
+          '',
+          `Prévisualiser : https://${domaine}/?preview_theme_id=${numeroDe(trouve.id)}`,
+          trouve.role === 'MAIN'
+            ? ''
+            : 'Le marchand vérifie chaque page sur ordinateur et sur mobile, puis publie lui-même (Boutique en ligne > Thèmes).',
+          exclus.length
+            ? `Modèles exclus du projet, mais toujours présents dans ce thème (rien n'est supprimé à distance) : ${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'),
+        { shop: domaine, theme: { id: trouve.id, name: trouve.name, role: trouve.role }, written: envoyes, errors: refuses },
+      );
+    }),
+  );
+}

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 { registerPushTool } from './push.js';
 
 const ok = (text, structured) => ({ content: [{ type: 'text', text }], ...(structured ? { structuredContent: structured } : {}) });
 const fail = (text) => ({ content: [{ type: 'text', text: `⛔ ${text}` }], isError: true });
@@ -24,7 +25,7 @@ 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(
@@ -74,4 +75,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) registerPushTool(server, { client, 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.2.3';
+export const VERSION = '1.4.0';