story-theme-mcp 1.6.0 → 1.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "story-theme-mcp",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "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",

package/src/build/compose.js

@@ -167,6 +167,8 @@ function setOption(catalog, block, key, value, notes) {
 }
 
 const firstOf = (node, type) => [...walk(node)].find((entry) => entry.block.type === type);
+// Un réglage « video » de Shopify n'accepte qu'une vidéo déposée dans Contenu > Fichiers.
+const estVideoShopify = (valeur) => /^shopify:\/\/files\/videos\//.test(String(valeur));
 const blockHas = (catalog, block, id) => (catalog.block(block.type)?.schema?.settings || []).some((setting) => setting.id === id);
 
 // One item of content into one item block, whatever its kind.
@@ -231,7 +233,10 @@ function fillItem(catalog, entry, item, notes) {
     case '_logo':
     case '_ugc-item':
       if (content.image) block.settings.image = imageRef(content.image);
-      if (content.video && blockHas(catalog, block, 'video')) block.settings.video = content.video;
+      if (content.video && blockHas(catalog, block, 'video')) {
+        if (estVideoShopify(content.video)) block.settings.video = content.video;
+        else notes.push(`vidéo externe (${content.video}) non reprise : ce bloc n'accepte que les vidéos déposées dans Shopify`);
+      }
       if (content.title && block.type === '_gallery-item') block.settings.caption = inline(content.title);
       if (content.title && block.type === '_logo') block.settings.name = plain(content.title);
       if (block.type === '_ugc-item') {
@@ -243,7 +248,8 @@ function fillItem(catalog, entry, item, notes) {
       return;
     case '_story':
       if (content.image) block.settings.image = imageRef(content.image);
-      if (content.video) block.settings.video = content.video;
+      if (content.video && estVideoShopify(content.video)) block.settings.video = content.video;
+      else if (content.video) notes.push(`vidéo externe (${content.video}) non reprise : une story n'accepte que les vidéos déposées dans Shopify`);
       if (content.title) block.settings.title = plain(content.title);
       if (content.product) block.settings.product = content.product;
       if (content.link) block.settings.link = content.link;

package/src/migrate/extract.js

@@ -49,7 +49,8 @@ const ROLES = [
   ['name', /^(name|customer_name|author_name|author)$/],
   ['role', /^(role|author_age|verified_text|job|position)$/],
   ['rating', /^(rating|rate_text|rating_text)$/],
-  ['title', /^(heading|title|image_heading|review_title|tab_label|headline|heading_text|question|slides)$/],
+  ['rotation', /^(slides|rotating_words|words)$/],
+  ['title', /^(heading|title|image_heading|review_title|tab_label|headline|heading_text|question)$/],
   ['eyebrow', /^(subheading|image_subheading|subtitle|label|tagline|eyebrow|caption|announcment)$/],
   ['text', /^(description|text|row_content|content|text_footer|caption_text|form_text|text_above|message|body|paragraph|info|tooltip|answer|text_before|text_after|helper_text)$/],
   ['image', /^(image|image_custom|custom_icon|icon_custom|icon_image|avatar|cover_image|background_image|image_before|image_after|logo|photo)$/],
@@ -130,6 +131,7 @@ function ranger(contenu, reglages) {
     } else if (genre === 'video') contenu.video ??= valeur;
     else if (genre === 'link') (secondaire ? second : bouton).link ??= valeur;
     else if (role === 'label') (secondaire ? second : bouton).label ??= valeur;
+    else if (role === 'rotation') contenu.rotation = String(isHtml(valeur) ? lisible(valeur) : valeur).split(/\s*[\n|]\s*/).filter(Boolean);
     else if (role && ['title', 'eyebrow', 'text', 'name', 'role', 'rating'].includes(role) && contenu[role] === undefined) contenu[role] = valeur;
     else if (role === 'text' && contenu.text !== undefined) contenu.text = concat(contenu.text, valeur);
     else contenu.autres.push({ cle: reglage.cle, valeur });

package/src/migrate/source.js

@@ -17,6 +17,7 @@ import path from 'node:path';
 import { unzipSync, strFromU8 } from 'fflate';
 import { parseThemeJson } from '../theme/loader.js';
 import { fileKind } from '../validate/template.js';
+import { devinerLangue, textesDesModeles } from '../validate/design.js';
 
 const SCHEMA_RE = /\{%-?\s*schema\s*-?%\}([\s\S]*?)\{%-?\s*endschema\s*-?%\}/;
 
@@ -33,9 +34,7 @@ function lireSchema(liquid) {
 /** Les fichiers utiles d'un thème : chemin relatif → texte. */
 function lireFichiers(source) {
   const fichiers = new Map();
-  // La langue par défaut de la boutique se lit au nom du fichier de traductions (fr.default.json) :
-  // on garde ce nom, pas son contenu.
-  const garder = (rel) => fileKind(rel) || rel === 'config/settings_schema.json' || /^(sections|blocks)\/[^/]+\.liquid$/.test(rel) || /^locales\/[a-z-]+\.default\.json$/i.test(rel);
+  const garder = (rel) => fileKind(rel) || rel === 'config/settings_schema.json' || /^(sections|blocks)\/[^/]+\.liquid$/.test(rel);
 
   if (fs.statSync(source).isDirectory()) {
     const parcourir = (dossier) => {
@@ -82,14 +81,7 @@ export function lireThemeV3DepuisFichiers(fichiers, origine = 'boutique') {
   const schemas = { sections: new Map(), blocks: new Map() };
   let version = null;
   let nom = null;
-  let langue = null;
-
   for (const [rel, texte] of fichiers) {
-    const locale = /^locales\/([a-z-]+)\.default\.json$/i.exec(rel);
-    if (locale) {
-      langue = locale[1].toLowerCase().split('-')[0];
-      continue;
-    }
     const liquid = /^(sections|blocks)\/([^/]+)\.liquid$/.exec(rel);
     if (liquid) {
       const schema = lireSchema(texte);
@@ -113,6 +105,10 @@ export function lireThemeV3DepuisFichiers(fichiers, origine = 'boutique') {
     }
   }
 
+  // La langue de la boutique se lit dans SES textes : le fichier de traductions par défaut du
+  // thème (en.default.json) est l'anglais pour toutes les boutiques Story Thème.
+  const langue = devinerLangue(textesDesModeles([...fichiersJson].filter(([rel]) => rel.startsWith('templates/') || rel.startsWith('sections/')).map(([, data]) => data)));
+
   const reglages = fichiersJson.get('config/settings_data.json');
   const courant = typeof reglages?.current === 'string' ? reglages.presets?.[reglages.current] : reglages?.current;
   return { origine, version, nom, langue, fichiers: fichiersJson, schemas, reglages: courant || {}, erreurs };

package/src/migrate/v3.js

@@ -16,7 +16,7 @@ import { blockFromPreset, createIdFactory, collectIds } from '../build/scaffold.
 import { localizeData } from '../build/localize.js';
 import { migrateData } from '../build/migrate.js';
 import { stripShowcase } from '../build/quick.js';
-import { validateFile } from '../validate/template.js';
+import { validateFile, EXPECTED_MAIN } from '../validate/template.js';
 import { checkValue } from '../validate/values.js';
 import { templateTypeOf, isInternalTemplate } from '../theme/catalog.js';
 
@@ -194,7 +194,18 @@ export const CORRESPONDANCES = {
   'floating-video': { vers: (c) => ({ type: 'floating-video', preset: 'Floating video', settings: nonVide({ video: c.video, cover_image: c.image }) }) },
   newsletter: { vers: (c) => ({ type: 'newsletter', preset: 'Newsletter', content: tete(c) }) },
   'contact-form': { vers: (c) => ({ type: 'contact', preset: 'Contact form', content: tete(c) }) },
-  'featured-blog': { vers: (c) => ({ type: 'blog-posts', preset: 'Blog posts', settings: nonVide({ blog: c.blog }), content: tete(c, { buttons: [] }) }) },
+  'featured-blog': {
+    vers: (c) => ({
+      type: 'blog-posts',
+      preset: 'Blog posts',
+      content: tete(c, { buttons: [] }),
+      // En 4.0, le blog se choisit dans le bloc de la liste d'articles, pas dans la section.
+      apres: (section) => {
+        const liste = premier(section, 'blog-posts');
+        if (liste && c.blog) liste.bloc.settings.blog = c.blog;
+      },
+    }),
+  },
   'featured-product': { vers: (c) => ({ type: 'featured-product', preset: 'Featured product', settings: nonVide({ product: c.product }) }) },
   'results-progress': {
     elements: ['stat'],
@@ -230,6 +241,7 @@ function heros(c, ctx) {
     content: {
       ...(c.eyebrow !== undefined ? { eyebrow: c.eyebrow } : c.lines.length ? { eyebrow: c.lines.map(lisible).join(' · ') } : {}),
       ...(c.title !== undefined ? { title: c.title, ...(ctx.premiereSection && ctx.typeModele === 'index' ? { title_tag: 'h1' } : {}) } : {}),
+      ...(c.rotation?.length ? { rotating_words: c.rotation } : {}),
       text: c.text ?? '',
       buttons: boutonsDe(c),
     },
@@ -480,8 +492,10 @@ function migrerModele(catalog, rel, donnees, v3, { langue, schemeIds }) {
     if (contenu.code.length) rapport.notes.push(`${type} : code personnalisé (Liquid/HTML) non repris`);
   });
 
-  // Un modèle 4.0 qui exige sa section principale l'a toujours, même si la 3.x l'avait masquée.
-  if (!principalePosee && principalesBase.length) {
+  // Un modèle 4.0 qui EXIGE sa section principale (produit, collection, panier…) l'a toujours,
+  // même si la 3.x n'en avait pas. Une page, elle, n'en a pas besoin : en ajouter une afficherait
+  // le titre et le texte de la page Shopify par-dessus ce que le marchand avait composé.
+  if (!principalePosee && principalesBase.length && EXPECTED_MAIN[typeModele]) {
     poserPrincipales();
     sortie.order.unshift(...sortie.order.splice(sortie.order.length - principalesBase.length));
   }
@@ -724,7 +738,7 @@ export function migrerBoutiqueV3({ catalog, store, source, v3: lu = null, name,
     throw new Error(`ce thème est déjà en ${v3.version} : utilisez import_theme (et migrate_project) pour une mise à jour dans la 4.x`);
   }
   if (!v3.fichiers.size) throw new Error('aucun modèle JSON trouvé dans la source : est-ce bien un thème Shopify exporté ?');
-  // La langue de la boutique : imposée, sinon celle du thème 3.x (fr.default.json), sinon le français.
+  // La langue de la boutique : imposée, sinon devinée d'après ses textes, sinon le français.
   const langueBoutique = language || (v3.langue && catalog.languages.includes(v3.langue) ? v3.langue : 'fr');
 
   const meta = store.create({ name, language: langueBoutique, brief: { migrated_from: lu ? v3.origine : String(source), migrated_from_version: v3.version || 'inconnue' } });
@@ -800,20 +814,24 @@ export function migrerBoutiqueV3({ catalog, store, source, v3: lu = null, name,
 /** Le rapport, lisible par l'assistant et le marchand. */
 export function formaterMigration(resultat) {
   const lignes = [`Migration ${resultat.version || '3.x'} → 4.x : projet ${resultat.slug} (projet en cours, langue ${resultat.langue}).`];
-  if (resultat.langueDevinee) lignes.push(`⚠️ Langue de la boutique introuvable dans le thème exporté : ${resultat.langue} par défaut. Si la boutique est dans une autre langue, relancez migrate_v3 avec language.`);
+  if (resultat.langueDevinee) lignes.push(`⚠️ Langue de la boutique impossible à deviner d'après ses textes : ${resultat.langue} par défaut. Si la boutique est dans une autre langue, relancez migrate_v3 avec language.`);
   lignes.push(
     resultat.reglages.ok
       ? `Réglages du thème : ${resultat.reglages.repris.length} repris (couleurs, polices, boutons, réseaux…). ${resultat.reglages.ignores.length} réglages de présentation 3.x n’ont pas d’équivalent : normal, la 4.0 les a remplacés par ses propres styles.`
       : 'Réglages du thème : non repris (refusés par la 4.0), ceux du thème s’appliquent.',
   );
   let devinees = 0;
+  let verifier = 0;
   let ecartes = 0;
   for (const rapport of resultat.rapports) {
     if (!rapport.sections.length && !rapport.notes.length) continue;
     lignes.push('', `## ${rapport.fichier}`);
     for (const s of rapport.sections) {
       if (s.devinee) devinees += 1;
-      lignes.push(`- ${s.de} → ${s.vers || 'retirée'}${s.devinee ? ' ⚠️ devinée' : ''}${s.masquee ? ' (masquée, comme en 3.x)' : ''}${s.note ? ` — ${s.note}` : ''}`);
+      // Une note dit qu'une partie n'a pas suivi telle quelle : à regarder, comme une devinée.
+      const aVerifier = !s.devinee && Boolean(s.note) && s.vers && !/^(apps|\(même)/.test(s.vers) && !/section principale du modèle|blocs repris tels quels|fiche produit 4\.0/.test(s.note);
+      if (aVerifier) verifier += 1;
+      lignes.push(`- ${s.de} → ${s.vers || 'retirée'}${s.devinee ? ' ⚠️ devinée' : aVerifier ? ' ⚠️ à vérifier' : ''}${s.masquee ? ' (masquée, comme en 3.x)' : ''}${s.note ? ` — ${s.note}` : ''}`);
     }
     for (const note of rapport.notes) lignes.push(`- ${note}`);
     if (rapport.ecartes.length) {
@@ -826,7 +844,7 @@ export function formaterMigration(resultat) {
   lignes.push(
     '',
     'À faire maintenant :',
-    `1. Passez en revue les sections ${devinees ? `devinées (${devinees}) et ` : ''}les notes ci-dessus : read_file sur chaque page, compose_page ou edit_template pour corriger.`,
+    `1. Passez en revue les sections ${devinees ? `devinées (${devinees}), ` : ''}${verifier ? `à vérifier (${verifier}) ` : ''}et les notes ci-dessus : read_file sur chaque page, compose_page ou edit_template pour corriger.`,
     ecartes ? `2. Replacez les textes écartés qui comptent (${ecartes}).` : '2. Aucun texte écarté.',
     '3. review_project, puis envoyez le thème dans un thème NON publié de la boutique (ou export_theme).',
     'Les photos et vidéos restent celles de la boutique (shopify://shop_images…) : elles s’affichent dès que le thème est dans la même boutique.',

package/src/project/review.js

@@ -68,7 +68,7 @@ function buildChecklist({ files, resources, usedBlocks, trustpilotMissing, langu
   const items = [];
   const add = (group, text) => items.push({ group, text });
 
-  add('Installer', 'Boutique en ligne > Thèmes > Ajouter un thème > Importer un fichier zip, puis « Personnaliser » pour vérifier chaque page sur ordinateur et sur mobile avant de publier.');
+  add('Installer', 'Boutique branchée (Theme Access) : push_to_shop place le projet dans un thème non publié, sans zip. Sinon : Boutique en ligne > Thèmes > Ajouter un thème > Importer un fichier zip. Puis « Personnaliser » pour vérifier chaque page sur ordinateur et sur mobile avant de publier.');
   const header = files.get('sections/header-group.json')?.data;
   const logoBlocks = header ? [...Object.values(header.sections || {})].flatMap((section) => [...blocksOf(section)]).filter((block) => block.type === '_header-logo') : [];
   if (!logoBlocks.length || logoBlocks.every((block) => !block.settings?.logo)) add('Images', "Logo : l'ajouter dans le bloc Logo de l'en-tête (PNG ou SVG sur fond transparent, 2× la taille affichée).");

package/src/server.js

@@ -1415,7 +1415,7 @@ Read the file first (read_file) to get ids.`,
         theme: z.string().optional().describe('Avec shop : identifiant numérique du thème 3.x (push_to_shop sans theme liste les thèmes)'),
         source: z.string().optional().describe('Sinon, chemin du thème 3.x exporté de la boutique : dossier, ou .zip (Boutique en ligne > Thèmes > … > Télécharger le fichier du thème)'),
         name: z.string().min(2).describe('Nom du projet (la marque)'),
-        language: z.string().optional().describe('Langue de la boutique ; par défaut celle du thème 3.x (fichier de traductions par défaut)'),
+        language: z.string().optional().describe('Langue de la boutique ; par défaut, devinée d’après ses textes'),
       },
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
     },
@@ -1426,7 +1426,7 @@ Read the file first (read_file) to get ids.`,
       let v3 = null;
       if (shop && theme) {
         // Le contenu, plus le schéma des sections 3.x et la langue : de quoi lire sans deviner.
-        const lu = await lireThemeBoutique(config, shop, theme, [...CONTENU, 'sections/*.liquid', 'blocks/*.liquid', 'config/settings_schema.json', 'locales/*.default.json']);
+        const lu = await lireThemeBoutique(config, shop, theme, [...CONTENU, 'sections/*.liquid', 'blocks/*.liquid', 'config/settings_schema.json']);
         v3 = lireThemeV3DepuisFichiers(new Map((lu.fichiers || []).map((f) => [f.chemin, f.contenu])), `${lu.domaine || shop} › ${lu.theme?.nom || theme}`);
       }
       const resultat = migrerBoutiqueV3({ catalog, store, source, v3, name, language });

package/src/shops/direct.js

@@ -12,8 +12,9 @@
 import crypto from 'node:crypto';
 import { z } from 'zod';
 import { parseThemeJson } from '../theme/loader.js';
-import { fileKind } from '../validate/template.js';
+import { fileKind, validateFile } from '../validate/template.js';
 import { majeure } from '../migrate/source.js';
+import { devinerLangue, textesDesModeles } from '../validate/design.js';
 
 const chemin = (config, suite) => `${String(config.apiBase || 'https://story-theme.com').replace(/\/+$/, '')}/api/v1/mcp${suite}`;
 
@@ -51,7 +52,29 @@ const AIDE_BRANCHEMENT = [
 ].join('\n');
 
 const ATTENTE_MS = 3000;
-const ATTENTE_MAX_MS = 120000;
+// La plateforme qui sert le connecteur (Heroku) coupe une requête au-delà de 30 secondes.
+const ATTENTE_CREATION_MS = 18000;
+// L'espace membre refuse une requête de plus de 500 Ko.
+const TAILLE_LOT = 350000;
+
+/** Des lots de fichiers sous une taille donnée (un fichier plus gros part seul). */
+function parLots(fichiers, taille) {
+  const lots = [];
+  let lot = [];
+  let poids = 0;
+  for (const fichier of fichiers) {
+    const p = Buffer.byteLength(fichier.contenu) + fichier.chemin.length + 64;
+    if (lot.length && poids + p > taille) {
+      lots.push(lot);
+      lot = [];
+      poids = 0;
+    }
+    lot.push(fichier);
+    poids += p;
+  }
+  if (lot.length) lots.push(lot);
+  return lots;
+}
 const pause = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
 /** Les fichiers d'un thème de la boutique, relus par l'espace membre (Theme Access). */
@@ -84,11 +107,12 @@ const empreinte = (texte) => {
 
 const suiviDe = (meta, domaine, theme) => meta.boutiques?.[domaine]?.[String(theme)] || null;
 
-function memoriser(store, slug, domaine, theme, fichiers) {
+function memoriser(store, slug, domaine, theme, fichiers, { cree = false } = {}) {
   const meta = store.meta(slug);
   meta.boutiques = meta.boutiques || {};
   meta.boutiques[domaine] = meta.boutiques[domaine] || {};
   const suivi = meta.boutiques[domaine][String(theme)] || { fichiers: {} };
+  if (cree) suivi.cree = true;
   for (const { chemin, contenu } of fichiers) suivi.fichiers[chemin] = empreinte(contenu);
   suivi.le = new Date().toISOString();
   meta.boutiques[domaine][String(theme)] = suivi;
@@ -117,7 +141,9 @@ export function registerDirectTools(server, config, { ctx, ok, garde }) {
           '',
           ...lignes,
           '',
-          branchees ? 'push_to_shop écrit directement dans une boutique branchée.' : '',
+          branchees
+            ? '● branchée (Theme Access) = ses THÈMES sont accessibles : push_to_shop (lister, écrire, créer), pull_from_shop (relire), migrate_v3 (3.x → 4.x). Ses produits, collections, pages, menus et réductions passent par le connecteur Shopify officiel du marchand, pas par shop_graphql.'
+            : '',
           // 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}` : '',
@@ -148,115 +174,160 @@ export function registerDirectTools(server, config, { ctx, ok, garde }) {
     garde(async ({ shops, project, theme, create, confirm, overwrite }) => {
       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 encode = encodeURIComponent(cible);
+
+      // Sans thème : on montre ce qui existe, le marchand choisit. Regarder ne demande pas de projet.
+      if (!theme && !create) {
+        const { themes = [], domaine } = await appel(config, `/boutiques/${encode}/themes`);
+        return ok(
+          [
+            `Thèmes de ${domaine || cible} (${themes.length}/20, la limite de Shopify) :`,
+            ...themes.map((t) => `- ${t.nom} — identifiant ${t.id}${t.role === 'main' ? ' — PUBLIÉ (la vitrine actuelle)' : ''}${t.traitement ? ' — installation en cours' : ''}`),
+            '',
+            `Écrire dedans : push_to_shop({ shops: "${cible}", theme: "<identifiant>" }).`,
+            `Créer un thème neuf à la place : push_to_shop({ shops: "${cible}", create: true }).`,
+            `Relire un thème dans un projet : pull_from_shop({ shops: "${cible}", theme: "<identifiant>" }).`,
+            'Choisissez un thème NON publié : le marchand prévisualise, puis publie lui-même.',
+          ].join('\n'),
+          { themes },
+        );
+      }
 
       const { store, catalog } = ctx.get();
       const slug = store.resolve(project);
       const meta = store.meta(slug);
-      const encode = encodeURIComponent(cible);
+
+      // Les fichiers du projet, et eux seuls. Un fichier que cette version du thème refuse (une
+      // section disparue, par exemple) ne part pas : Shopify le rejetterait, et le dire vaut mieux.
+      const reglages = store.read(slug, 'config/settings_data.json').data;
+      const courant = typeof reglages?.current === 'string' ? reglages.presets?.[reglages.current] : reglages?.current;
+      const schemeIds = Object.keys(courant?.color_schemes || {});
+      const invalides = [];
+      const tous = [];
+      for (const [rel, entree] of store.effectiveFiles(slug)) {
+        if (entree.origin !== 'project') continue;
+        const validation = validateFile(catalog, rel, entree.data, { schemeIds });
+        if (!validation.ok) {
+          invalides.push(`${rel} : ${validation.errors[0].message}`);
+          continue;
+        }
+        tous.push({ chemin: rel, contenu: `${JSON.stringify(entree.data, null, 2)}\n` });
+      }
+      if (!tous.length) {
+        throw new Error(
+          invalides.length
+            ? `Aucun fichier envoyable : ${invalides.join(' · ')}`
+            : `Le projet « ${slug} » n’a aucun fichier personnalisé : construisez la boutique d’abord.`,
+        );
+      }
 
       // Créer un thème : Shopify part de la dernière version publiée du Story Thème (lien signé
-      // fabriqué par l'espace membre), puis on y écrit les pages du projet. Aucun zip ne transite :
-      // ça marche aussi bien en local qu'en connecteur.
+      // fabriqué par l'espace membre), puis on y écrit les pages du projet. Aucun zip ne transite.
+      let cree = null;
       if (create) {
-        const { theme: cree } = await appel(config, `/boutiques/${encode}/themes`, {
+        // Une relance ne doit pas créer un second thème : la limite de Shopify est de 20.
+        const voulu = cible.toLowerCase().replace(/^https?:\/\//, '').replace(/\/.*$/, '');
+        for (const [domaineSuivi, themes] of Object.entries(meta.boutiques || {})) {
+          if (domaineSuivi !== voulu && !domaineSuivi.startsWith(`${voulu.replace(/\.myshopify\.com$/, '')}.`)) continue;
+          const recent = Object.entries(themes).find(([, suiviTheme]) => suiviTheme.cree && Date.now() - new Date(suiviTheme.le).getTime() < 10 * 60 * 1000);
+          if (recent) {
+            return ok(
+              `Ce projet a déjà créé un thème sur ${domaineSuivi} il y a moins de dix minutes (identifiant ${recent[0]}). Pour y écrire : push_to_shop({ shops: "${cible}", theme: "${recent[0]}" }). Un second thème n'a pas été créé.`,
+            );
+          }
+        }
+        ({ theme: cree } = await appel(config, `/boutiques/${encode}/themes`, {
           method: 'POST',
           body: JSON.stringify({ nom: (meta.name || slug).slice(0, 50), base: 'story' }),
-        });
-        // Shopify télécharge et décompresse l'archive : on attend qu'il ait fini pour écrire.
+        }));
+        // Shopify télécharge et décompresse l'archive. On attend, mais peu : la plateforme qui sert
+        // le connecteur coupe toute requête au-delà de 30 secondes.
         const pas = config.attenteMs ?? ATTENTE_MS;
-        let pret = !cree.traitement;
-        for (let attendu = 0; !pret && attendu < ATTENTE_MAX_MS; attendu += ATTENTE_MS) {
+        let etat = { ...cree, traitement: cree.traitement };
+        let domaine = cible;
+        for (let attendu = 0; ; attendu += ATTENTE_MS) {
+          const liste = await appel(config, `/boutiques/${encode}/themes`);
+          domaine = liste.domaine || domaine;
+          etat = (liste.themes || []).find((t) => String(t.id) === String(cree.id)) || etat;
+          if (!etat.traitement || attendu >= ATTENTE_CREATION_MS) break;
           await pause(pas);
-          const { themes = [] } = await appel(config, `/boutiques/${encode}/themes`);
-          const etat = themes.find((t) => String(t.id) === String(cree.id));
-          pret = Boolean(etat) && !etat.traitement;
         }
-        if (!pret) {
+        // Ce thème est à nous : ce qu'il contient avant notre envoi vient de l'archive, pas du marchand.
+        memoriser(store, slug, domaine, cree.id, [], { cree: true });
+        if (etat.traitement) {
           return ok(
-            `Thème « ${cree.nom} » créé sur ${cible} en NON PUBLIÉ (identifiant ${cree.id}), mais Shopify le décompresse encore. Dans une minute : push_to_shop({ shops: "${cible}", theme: "${cree.id}" }) pour y écrire les pages du projet.`,
+            `Thème « ${cree.nom} » créé sur ${domaine} en NON PUBLIÉ (identifiant ${cree.id}). Shopify l'installe encore (une à deux minutes). Ensuite : push_to_shop({ shops: "${cible}", theme: "${cree.id}" }) y écrit les pages du projet. Ne relancez pas create : un second thème serait créé.`,
             { theme: cree },
           );
         }
         theme = String(cree.id);
       }
 
-      // Sans thème : on montre ce qui existe, le marchand choisit.
-      if (!theme) {
-        const { themes = [], domaine } = await appel(config, `/boutiques/${encode}/themes`);
+      // Avant d'écrire : relire. Rien ne part par-dessus une modification faite dans l'éditeur.
+      const lu = await lireThemeBoutique(config, cible, theme, tous.map((f) => f.chemin));
+      const enBoutique = new Map((lu.fichiers || []).map((f) => [f.chemin, empreinte(f.contenu)]));
+      const domaine = lu.domaine || cible;
+      const suivi = suiviDe(store.meta(slug), domaine, theme);
+      const connu = suivi?.fichiers || {};
+      const conflits = [];
+      let inchanges = 0;
+      const fichiers = tous.filter((f) => {
+        const actuel = enBoutique.get(f.chemin);
+        if (actuel === undefined) return true; // nouveau modèle : rien à écraser
+        if (actuel === empreinte(f.contenu)) {
+          inchanges += 1;
+          return false; // déjà à jour
+        }
+        // Un fichier jamais échangé dans un thème créé par ce projet vient de l'archive du thème.
+        if (connu[f.chemin] === undefined && suivi?.cree) return true;
+        // Jamais relu, ou modifié dans Shopify depuis le dernier échange.
+        if (connu[f.chemin] !== actuel) conflits.push(f.chemin);
+        return true;
+      });
+      if (conflits.length && overwrite !== true) {
         return ok(
           [
-            `Thèmes de ${domaine || cible} :`,
-            ...themes.map((t) => `- ${t.nom} — identifiant ${t.id}${t.role === 'main' ? ' — PUBLIÉ (la vitrine actuelle)' : ''}`),
+            `⚠️ Rien n'a été écrit. ${conflits.length} fichier(s) du thème « ${lu.theme?.nom || theme} » ont été modifiés dans Shopify depuis le dernier échange avec ce projet (ou n'ont jamais été relus) :`,
+            ...conflits.slice(0, 20).map((chemin) => `- ${chemin}`),
+            conflits.length > 20 ? `- … ${conflits.length - 20} autre(s)` : '',
             '',
-            `É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 },
+            `Relisez d'abord : pull_from_shop({ shops: "${cible}", theme: "${theme}" }) — le projet reprend ce que le marchand a fait à la main, puis refaites vos changements et renvoyez.`,
+            'Écraser malgré tout demande l’accord explicite du marchand (overwrite: true).',
+          ]
+            .filter(Boolean)
+            .join('\n'),
+          { conflits },
         );
       }
+      if (!fichiers.length) {
+        memoriser(store, slug, domaine, theme, tous);
+        return ok(`Le thème « ${lu.theme?.nom || theme} » est déjà à jour : les ${inchanges} fichier(s) du projet y sont identiques.${invalides.length ? `\nNon envoyés (refusés par cette version du thème) : ${invalides.join(' · ')}` : ''}`);
+      }
 
-      // Les fichiers du projet, et eux seuls : le serveur refuse tout le reste de toute façon.
-      const tous = [...store.effectiveFiles(slug)]
-        .filter(([, entree]) => entree.origin === 'project')
-        .map(([rel, entree]) => ({ chemin: rel, contenu: `${JSON.stringify(entree.data, null, 2)}\n` }));
-      if (!tous.length) throw new Error(`Le projet « ${slug} » n’a aucun fichier personnalisé : construisez la boutique d’abord.`);
-
-      // Un thème qu'on vient de créer n'a rien que le marchand ait touché. Sinon, on relit
-      // d'abord : rien ne part par-dessus une modification faite dans l'éditeur Shopify.
-      let fichiers = tous;
-      let inchanges = 0;
-      if (!create) {
-        const lu = await lireThemeBoutique(config, cible, theme, tous.map((f) => f.chemin));
-        const enBoutique = new Map((lu.fichiers || []).map((f) => [f.chemin, empreinte(f.contenu)]));
-        const domaine = lu.domaine || cible;
-        const connu = suiviDe(store.meta(slug), domaine, theme)?.fichiers || {};
-        const conflits = [];
-        fichiers = tous.filter((f) => {
-          const actuel = enBoutique.get(f.chemin);
-          if (actuel === undefined) return true; // nouveau modèle : rien à écraser
-          if (actuel === empreinte(f.contenu)) {
-            inchanges += 1;
-            return false; // déjà à jour
-          }
-          // Jamais relu, ou modifié dans Shopify depuis le dernier échange.
-          if (connu[f.chemin] !== actuel) conflits.push(f.chemin);
-          return true;
+      // Par lots : l'espace membre refuse une requête de plus de 500 Ko, un accueil en pèse 150.
+      const resultat = { ecrits: [], refuses: [] };
+      for (const lot of parLots(fichiers, TAILLE_LOT)) {
+        const reponse = await appel(config, `/boutiques/${encode}/themes/${encodeURIComponent(theme)}`, {
+          method: 'PUT',
+          body: JSON.stringify({ fichiers: lot, confirm: confirm === true }),
         });
-        if (conflits.length && overwrite !== true) {
-          return ok(
-            [
-              `⚠️ Rien n'a été écrit. ${conflits.length} fichier(s) du thème « ${lu.theme?.nom || theme} » ont été modifiés dans Shopify depuis le dernier échange avec ce projet (ou n'ont jamais été relus) :`,
-              ...conflits.map((chemin) => `- ${chemin}`),
-              '',
-              `Relisez d'abord : pull_from_shop({ shops: "${cible}", theme: "${theme}" }) — le projet reprend ce que le marchand a fait à la main, puis refaites vos changements et renvoyez.`,
-              'Écraser malgré tout demande l’accord explicite du marchand (overwrite: true).',
-            ].join('\n'),
-            { conflits },
-          );
-        }
-        if (!fichiers.length) {
-          memoriser(store, slug, domaine, theme, tous);
-          return ok(`Le thème « ${lu.theme?.nom || theme} » est déjà à jour : les ${inchanges} fichier(s) du projet y sont identiques.`);
-        }
+        Object.assign(resultat, { theme: reponse.theme, domaine: reponse.domaine, apercu: reponse.apercu });
+        resultat.ecrits.push(...(reponse.ecrits || []));
+        resultat.refuses.push(...(reponse.refuses || []));
+        memoriser(store, slug, reponse.domaine || domaine, theme, lot.filter((f) => (reponse.ecrits || []).includes(f.chemin)));
       }
 
-      const resultat = await appel(config, `/boutiques/${encode}/themes/${encodeURIComponent(theme)}`, {
-        method: 'PUT',
-        body: JSON.stringify({ fichiers, confirm: confirm === true }),
-      });
-      memoriser(store, slug, resultat.domaine || cible, theme, fichiers.filter((f) => resultat.ecrits.includes(f.chemin)));
-
       const exclus = store.excluded(slug);
       return ok(
         [
-          create ? `Thème « ${resultat.theme.nom} » créé sur ${resultat.domaine} à partir du Story Thème ${meta.theme?.version || ''}, en NON PUBLIÉ (identifiant ${resultat.theme.id}).` : '',
+          cree ? `Thème « ${resultat.theme.nom} » créé sur ${resultat.domaine} à partir du Story Thème, en NON PUBLIÉ (identifiant ${resultat.theme.id}).` : '',
           `${resultat.ecrits.length} fichier(s) écrits dans « ${resultat.theme.nom} » sur ${resultat.domaine}${resultat.theme.role === 'main' ? ' — THÈME PUBLIÉ, la boutique a changé' : ''}${inchanges ? ` (${inchanges} déjà à jour)` : ''}.`,
-          resultat.refuses?.length ? `Refusés : ${resultat.refuses.join(' · ')}` : '',
+          resultat.refuses.length ? `Refusés par Shopify : ${resultat.refuses.join(' · ')}` : '',
+          invalides.length ? `Non envoyés (refusés par cette version du thème, à corriger dans le projet) : ${invalides.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(', ')}.` : '',
+          exclus.length ? `Modèles exclus du projet mais toujours présents dans ce thème : ${exclus.slice(0, 8).join(', ')}${exclus.length > 8 ? '…' : ''}.` : '',
           'Images, produits, collections, menus et réductions restent à créer côté Shopify : review_project en donne la liste.',
         ]
           .filter(Boolean)
@@ -284,7 +355,7 @@ export function registerDirectTools(server, config, { ctx, ok, garde }) {
       const cible = String(shops || '').trim();
       if (!cible || cible === 'all') throw new Error('pull_from_shop relit UNE boutique à la fois : donnez son domaine (list_shops).');
       const { store, catalog } = ctx.get();
-      const lu = await lireThemeBoutique(config, cible, theme, [...CONTENU, 'config/settings_schema.json', 'locales/*.default.json']);
+      const lu = await lireThemeBoutique(config, cible, theme, [...CONTENU, 'config/settings_schema.json']);
       const fichiers = lu.fichiers || [];
       const domaine = lu.domaine || cible;
 
@@ -311,7 +382,15 @@ export function registerDirectTools(server, config, { ctx, ok, garde }) {
         }
       }
       if (!slug) {
-        const langue = /^locales\/([a-z]+)/.exec(fichiers.find((f) => f.chemin.startsWith('locales/'))?.chemin || '')?.[1];
+        // La langue de la boutique, d'après ses propres textes.
+        const modeles = fichiers.filter((f) => fileKind(f.chemin) && f.chemin !== 'config/settings_data.json').map((f) => {
+          try {
+            return parseThemeJson(f.contenu);
+          } catch {
+            return null;
+          }
+        });
+        const langue = devinerLangue(textesDesModeles(modeles.filter(Boolean)), catalog.languages);
         const meta = store.create({
           name: name || `${lu.theme?.nom || 'Thème'} (${domaine.replace('.myshopify.com', '')})`,
           language: langue && catalog.languages.includes(langue) ? langue : config.defaultLanguage || 'fr',
@@ -322,8 +401,16 @@ export function registerDirectTools(server, config, { ctx, ok, garde }) {
 
       const repris = [];
       const contenus = [];
+      const vitrines = [];
       for (const { chemin, contenu } of fichiers) {
         if (!fileKind(chemin)) continue;
+        // Le catalogue de sections du thème (collection.sections-…) sert à la démo, pas au marchand :
+        // ni relu, ni renvoyé, ni compté par la revue.
+        if (/^templates\/[^/]+\.sections-[^/]+\.json$/.test(chemin)) {
+          if (!store.excluded(slug).includes(chemin)) store.setExcluded(slug, chemin, true);
+          vitrines.push(chemin);
+          continue;
+        }
         let donnees;
         try {
           donnees = parseThemeJson(contenu);
@@ -341,11 +428,14 @@ export function registerDirectTools(server, config, { ctx, ok, garde }) {
 
       return ok(
         [
-          `Thème « ${lu.theme?.nom || theme} » de ${domaine} relu dans le projet ${slug} (projet en cours) : ${repris.length} fichier(s) mis à jour${version ? `, Story Thème ${version}` : ''}.`,
+          `Thème « ${lu.theme?.nom || theme} » de ${domaine} relu dans le projet ${slug} (projet en cours, langue ${store.meta(slug).language}) : ${repris.length} fichier(s) mis à jour${version ? `, Story Thème ${version}` : ''}.`,
+          vitrines.length ? `${vitrines.length} modèle(s) vitrine du thème (collection.sections-…) laissés de côté : ils servent à la démo, pas à la boutique.` : '',
           repris.length ? repris.slice(0, 20).map((chemin) => `- ${chemin}`).join('\n') + (repris.length > 20 ? `\n- … ${repris.length - 20} autre(s)` : '') : 'Le projet était déjà identique à la boutique.',
           '',
           'Le projet reflète maintenant la boutique, modifications faites à la main comprises. Modifiez (read_file, edit_template, compose_page…), puis renvoyez avec push_to_shop dans ce même thème. undo revient à la version d’avant la relecture.',
-        ].join('\n'),
+        ]
+          .filter(Boolean)
+          .join('\n'),
         { projet: slug, repris },
       );
     }),

package/src/shops/tools.js

@@ -17,6 +17,10 @@ const garde = (fn) => async (args) => {
   try {
     return await fn(args || {});
   } catch (e) {
+    if (e instanceof ShopsError && /sans Story Apps/.test(e.message)) {
+      // La boutique est sans doute branchée par Theme Access : l'outil n'est pas le bon.
+      return fail(`${e.message}\nSi elle est branchée par Theme Access (● dans list_shops), seuls ses thèmes sont accessibles : pull_from_shop, push_to_shop, migrate_v3. Pour ses produits, collections, pages, menus et réductions : le connecteur Shopify officiel du marchand.`);
+    }
     return fail(e instanceof ShopsError ? e.message : `Erreur inattendue : ${e.message}`);
   }
 };
@@ -49,7 +53,7 @@ export function registerShopTools(server, config, { fetchImpl, ctx } = {}) {
     {
       title: "Vue d'ensemble des boutiques",
       description:
-        'Key figures of all connected stores in one call: products, collections, Shopify plan, theme version and pending update, licence, and Story Apps modules (reviews, pending reviews, A/B tests, post-purchase offers).',
+        'Only for stores where the Story Apps app is installed (Story Theme team stores). Key figures in one call: products, collections, Shopify plan, theme version and pending update, licence, and Story Apps modules (reviews, pending reviews, A/B tests, post-purchase offers). A merchant store connected with Theme Access is NOT reachable here.',
       annotations: { readOnlyHint: true, openWorldHint: true },
     },
     garde(async () => {
@@ -63,7 +67,7 @@ export function registerShopTools(server, config, { fetchImpl, ctx } = {}) {
     {
       title: 'Requête sur une ou plusieurs boutiques',
       description:
-        'Runs one Shopify Admin GraphQL operation (API 2025-10) on one, several or all connected stores, in parallel. Queries and mutations within the Story Apps scopes (products, collections, pages, menus, files, discounts, themes read). A mutation on several stores needs confirm: true, only after the user explicitly agreed. Every access is logged.',
+        'Only for stores where the Story Apps app is installed (Story Theme team stores) — NOT for a merchant store connected with Theme Access, which only opens its themes (use pull_from_shop / push_to_shop; for products, collections, pages, menus and discounts, use the merchant\'s official Shopify connector). Runs one Shopify Admin GraphQL operation on one, several or all Story Apps stores, in parallel. A mutation on several stores needs confirm: true, only after the user explicitly agreed. Every access is logged.',
       inputSchema: {
         shops: cibleSchema,
         query: z.string().describe('Requête ou mutation GraphQL Admin.'),

package/src/validate/design.js

@@ -31,6 +31,48 @@ export function looksEnglish(text) {
   return en >= 2 && en > fr * 2;
 }
 
+// The language a store is written in, guessed from its own texts. The theme's default locale file
+// (en.default.json) says nothing about it: it is English for every Story Theme store.
+const MOTS = {
+  fr: FR_WORDS,
+  en: EN_WORDS,
+  de: new Set(['der', 'die', 'das', 'und', 'mit', 'fur', 'ihre', 'ihr', 'unsere', 'ist', 'nicht', 'auf', 'zu', 'den', 'dem', 'ein', 'eine', 'jetzt', 'versand', 'kostenloser']),
+  es: new Set(['el', 'los', 'las', 'y', 'con', 'para', 'tu', 'tus', 'nuestro', 'nuestros', 'es', 'del', 'por', 'una', 'envio', 'gratis', 'descubre', 'productos', 'tienda']),
+  it: new Set(['il', 'gli', 'e', 'con', 'per', 'tuo', 'tua', 'nostro', 'nostri', 'della', 'delle', 'una', 'sono', 'spedizione', 'gratuita', 'scopri', 'prodotti', 'negozio']),
+  nl: new Set(['het', 'een', 'en', 'met', 'voor', 'jouw', 'onze', 'van', 'is', 'op', 'niet', 'gratis', 'verzending', 'ontdek', 'producten', 'winkel']),
+};
+
+/**
+ * @param {string[]} textes textes de la boutique (HTML accepté)
+ * @param {string[]} langues langues proposées par le thème
+ * @returns {string|null} la langue la plus probable, ou null si les textes ne suffisent pas
+ */
+export function devinerLangue(textes, langues = Object.keys(MOTS)) {
+  const compte = Object.fromEntries(Object.keys(MOTS).map((langue) => [langue, 0]));
+  for (const texte of textes) {
+    for (const mot of normalizeText(String(texte).replace(/<[^>]+>/g, ' ')).split(' ')) {
+      for (const [langue, mots] of Object.entries(MOTS)) if (mots.has(mot)) compte[langue] += 1;
+    }
+  }
+  const [meilleure, score] = Object.entries(compte)
+    .filter(([langue]) => langues.includes(langue))
+    .sort((a, b) => b[1] - a[1])[0] || [null, 0];
+  return score >= 8 ? meilleure : null;
+}
+
+/** Les textes saisis dans des modèles de thème (titres, paragraphes, boutons), pour devinerLangue. */
+export function textesDesModeles(modeles) {
+  const textes = [];
+  const parcourir = (noeud) => {
+    for (const valeur of Object.values(noeud?.settings || {})) {
+      if (typeof valeur === 'string' && /\s/.test(valeur) && !/^shopify:\/\//.test(valeur)) textes.push(valeur);
+    }
+    for (const enfant of Object.values(noeud?.blocks || {})) parcourir(enfant);
+  };
+  for (const modele of modeles) for (const section of Object.values(modele?.sections || {})) parcourir(section);
+  return textes;
+}
+
 // Texts shipped as samples: every translated preset string and every shipped template text.
 export function sampleTexts(catalog) {
   if (catalog._samples) return catalog._samples;

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.6.0';
+export const VERSION = '1.6.1';