story-theme-mcp 1.7.2 → 1.7.4

package/README.md

@@ -2,7 +2,7 @@
 
 Votre assistant IA connaît le [Story Thème](https://story-theme.com) par cœur — chaque section, chaque bloc, chaque réglage — et construit des boutiques Shopify propres et professionnelles, sans jamais produire un fichier que Shopify refuserait.
 
-Réservé aux titulaires d'une licence Story Thème. Le jeton se génère dans l'espace membre : **Story Thème > MCP & Appli**.
+Réservé aux titulaires d'une licence Story Thème. Le jeton se génère dans l'espace membre : **Story Thème > MCP**.
 
 ```
 Vous : « Crée la boutique Maison Lumen : bougies parfumées coulées à la main à Lyon. »
@@ -15,7 +15,7 @@ IA   : une seule salve de questions (photos, collection, conditions… ou « vas
 
 ## Installation
 
-**Le plus simple — l'extension Claude.** Téléchargez `story-theme-mcp.mcpb` depuis votre espace membre (page MCP & Appli) et ouvrez le fichier : Claude installe le serveur et vous demande votre jeton dans un formulaire. Rien d'autre à installer, Node compris.
+**Le plus simple — l'extension Claude.** Téléchargez `story-theme-mcp.mcpb` depuis votre espace membre (page MCP) et ouvrez le fichier : Claude installe le serveur et vous demande votre jeton dans un formulaire. Rien d'autre à installer, Node compris.
 
 Les deux méthodes ci-dessous restent valables si vous préférez configurer à la main. Elles demandent Node 20 ou plus ([nodejs.org](https://nodejs.org)).
 
@@ -82,7 +82,7 @@ Prompts prêts à l'emploi : `creer-boutique`, `refaire-une-page`, `auditer-un-t
 
 | Variable | Défaut | Rôle |
 |---|---|---|
-| `STORY_MCP_TOKEN` | — | Jeton personnel (espace membre > MCP & Appli). Vérifie la licence et donne accès au thème publié. |
+| `STORY_MCP_TOKEN` | — | Jeton personnel (espace membre > MCP). Vérifie la licence et donne accès au thème publié. |
 | `STORY_MCP_HOME` | `~/Documents/Story Theme MCP` | Projets, historique, exports, cache du thème. |
 | `STORY_MCP_LANGUAGE` | `fr` | Langue par défaut des projets et des textes. |
 | `STORY_MCP_CANAL` | `stable` | `test` pour la version en test du thème (comptes testeurs). |
@@ -117,7 +117,7 @@ npm run fonts     # recharge la bibliothèque de polices Shopify (shopify.dev)
 npm run bundle    # fabrique build/story-theme-mcp-<version>.mcpb (extension Claude, un clic)
 ```
 
-Après `npm run bundle`, déposer le `.mcpb` dans le dossier `mcp/` de l'espace membre : la page MCP & Appli sert automatiquement la version la plus récente qu'elle y trouve.
+Après `npm run bundle`, déposer le `.mcpb` dans le dossier `mcp/` de l'espace membre : la page MCP sert automatiquement la version la plus récente qu'elle y trouve.
 
 Avec `STORY_THEME_DIR` sur le dépôt du thème, le MCP lit le thème en cours d'écriture et n'appelle pas l'espace membre. Les connaissances rédigées à la main vivent dans `src/knowledge/` (descriptions de chaque section et bloc, compositions par métier, directions artistiques, guides) ; tout le reste vient du thème. `npm run check` signale une section ou un bloc public sans description.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "story-theme-mcp",
-  "version": "1.7.2",
+  "version": "1.7.4",
   "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/config.js

@@ -11,7 +11,7 @@ export function loadConfig(env = process.env) {
   const themeDir = env.STORY_THEME_DIR || '';
   return {
     version: VERSION,
-    // Jeton personnel du client (espace membre > MCP & Appli). Sans lui, pas de thème à distance :
+    // Jeton personnel du client (espace membre > MCP). Sans lui, pas de thème à distance :
     // le MCP retombe sur son cache, puis sur un dossier local.
     token: (env.STORY_MCP_TOKEN || '').trim(),
     apiBase: (env.STORY_MCP_API || DEFAULT_API).trim(),

package/src/index.js

@@ -25,7 +25,7 @@ if (process.argv.includes('--help') || process.argv.includes('-h')) {
       'construit des boutiques Shopify prêtes à importer. Il ne s’utilise pas à la main.',
       '',
       'Variables d’environnement :',
-      '  STORY_MCP_TOKEN     jeton personnel (espace membre Story Thème > MCP & Appli) — indispensable',
+      '  STORY_MCP_TOKEN     jeton personnel (espace membre Story Thème > MCP) — indispensable',
       '  STORY_MCP_HOME      dossier des projets et exports (défaut : ~/Documents/Story Theme MCP)',
       '  STORY_MCP_LANGUAGE  langue des textes (défaut : fr)',
       '  STORY_MCP_CANAL     « test » pour la version en test du thème (comptes testeurs)',
@@ -57,6 +57,7 @@ try {
   // l'interface de Claude.
 }
 
-const server = createServer({ ...config, source });
+// L'appli Story Theme Apps n'est proposée que si l'espace membre la dit disponible pour ce compte.
+const server = createServer({ ...config, source, appli: source.appli });
 await server.connect(new StdioServerTransport());
 journal(`prêt (projets : ${config.homeDir})`);

package/src/knowledge/brancher.js

@@ -18,7 +18,7 @@ const ETAPES = [
   'Dans l’administration Shopify, installez l’application gratuite Theme Access (éditée par Shopify) : https://apps.shopify.com/theme-access',
   'Dans Theme Access : « Créer un mot de passe », avec votre propre adresse e-mail.',
   'Ouvrez l’e-mail reçu et affichez le mot de passe : il commence par shptka_ et ne s’affiche qu’une fois.',
-  `Collez-le dans votre espace membre Story Thème, page MCP & Appli > « Brancher une boutique » (${PAGE_BRANCHEMENT}). Jamais dans la conversation.`,
+  `Collez-le dans votre espace membre Story Thème, page MCP > « Brancher une boutique » (${PAGE_BRANCHEMENT}). Jamais dans la conversation.`,
 ];
 
 /** La marche à suivre complète, prête à recopier au marchand. */
@@ -33,3 +33,31 @@ export const TUTO_BRANCHEMENT = [
 
 /** Une ligne pour les réponses où la boutique n'est pas (ou peut-être pas) branchée. */
 export const INVITATION_BRANCHEMENT = `Boutique pas encore branchée ? Proposez Theme Access au marchand (deux minutes, une seule fois) : list_shops donne la marche à suivre${VIDEO_BRANCHEMENT ? ` et la vidéo (${VIDEO_BRANCHEMENT})` : ''}. Sans lui, le zip reste la solution de repli, à importer à chaque version.`;
+
+/* --------------------------------------------- le connecteur Shopify officiel */
+
+// Theme Access n'ouvre que les thèmes. Le connecteur Shopify officiel, édité par Shopify pour
+// ChatGPT et Claude (mai 2026), ouvre le reste : produits, prix, stocks, collections, réductions,
+// commandes. Avec lui, l'assistant remplit les pages des vrais produits et crée les réductions des
+// offres au lieu de laisser une liste au marchand : le MCP le propose donc, surtout au début.
+
+/** La fiche du connecteur dans l'annuaire de Claude (vérifiée le 20/10/2026). */
+export const LIEN_CONNECTEUR_SHOPIFY_CLAUDE = 'https://claude.com/connectors/shopify';
+
+/** Le conseil, tel que l'assistant le lit dans un résultat d'outil. */
+// Le MCP ne voit pas les autres connecteurs de l'assistant ; l'assistant, lui, voit ses outils :
+// c'est à lui de vérifier, et de se taire si le connecteur est déjà là.
+export const CONSEIL_CONNECTEUR_SHOPIFY = `Connecteur Shopify officiel — seulement s'il n'est pas déjà en place. Vérifiez d'abord vos outils : si vous avez déjà ceux du connecteur Shopify (produits, commandes, réductions…), n'en parlez pas. S'il est installé mais pas actif dans cette conversation, dites simplement de l'activer (ChatGPT : @Shopify). Sinon, proposez-le au marchand en une phrase : édité par Shopify, il vous ouvre, en plus du thème, ses produits, prix, stocks, collections, réductions et commandes (pages remplies de ses vrais produits, réductions des offres créées pour lui, photos déposées dans Fichiers). Où l'ajouter : Claude, ${LIEN_CONNECTEUR_SHOPIFY_CLAUDE} ; ChatGPT, Applis › « Shopify » ; ailleurs, l'annuaire de connecteurs de son IA. S'il l'a refusé ou dit l'avoir déjà, n'y revenez plus.`;
+
+/**
+ * Surtout au début, pas tout le temps : un compteur par conversation (une session MCP) qui
+ * rend le conseil aux deux premiers résultats, puis à un sur cinq. Chaque appel compte.
+ * @returns {() => string} le conseil, ou une chaîne vide
+ */
+export function rappelConnecteurShopify() {
+  let appels = 0;
+  return () => {
+    appels += 1;
+    return appels <= 2 || appels % 5 === 0 ? CONSEIL_CONNECTEUR_SHOPIFY : '';
+  };
+}

package/src/knowledge/demos.js

@@ -22,7 +22,7 @@ export function creerDemos(config) {
   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).',
+        'Les boutiques démo demandent un jeton : ajoutez STORY_MCP_TOKEN (espace membre Story Thème > MCP).',
       );
     }
     const reponse = await fetch(`${config.apiBase.replace(/\/+$/, '')}${chemin}`, {

package/src/knowledge/guides.js

@@ -217,8 +217,8 @@ Formats conseillés :
   limites: {
     title: 'Ce que le MCP (V1) ne fait pas',
     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 Theme 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 n'ouvre que les THÈMES d'une boutique branchée par Theme Access (list_shops le dit) : ni ses produits, ni ses commandes, ni ses clients.
+- Il ne crée pas de lui-même produits, collections, menus, pages, réductions ni images : le connecteur Shopify officiel du marchand 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.`,
   },

package/src/migrate/extract.js

@@ -53,7 +53,9 @@ const ROLES = [
   ['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)$/],
+  // L'image qui remplace un pictogramme (3.x : image_custom, icon_N_custom_icon) reste un pictogramme.
+  ['icon_image', /^(image_custom|custom_icon|icon_custom|icon_image)$/],
+  ['image', /^(image|avatar|cover_image|background_image|image_before|image_after|logo|photo)$/],
   ['image_mobile', /^(image_mobile|background_image_mobile)$/],
   ['video', /^(video|video_url|video_link|video_mobile|video_link_mobile)$/],
 ];
@@ -92,9 +94,14 @@ const texteVide = (valeur) => !plainText(isHtml(valeur) ? valeur.html : valeur).
 // (« Écrire un avis », « Voir plus », jours/heures du compte à rebours…), que la 4.0 traduit elle-même.
 const INTERFACE = /^(section_id|custom_class|anchor|write_review_\w+|success_message|plus|less|button_show_all_text|placeholder|error_message|default_value|days|hours|mins|secs|free_label|reviews_based_on_text|reviews_suffix_text|reviews_count|cart_\w+|sale_badge|share_label|size_guide_trigger|product_trigger|trigger|final_message|track)$/;
 
+// Le pictogramme choisi dans la bibliothèque du thème (« truck », « leaf ») : la 4.0 a la même.
+const PICTO = /(^|_)icon(_type)?$/;
+
 /** Un réglage lu : sa clé, son rôle (titre, texte, lien…), son genre et sa valeur. */
 function lireReglage(cle, valeur, type) {
   if (INTERFACE.test(cle)) return null;
+  // « none » compte aussi : la colonne n'avait pas de pictogramme, la 4.0 n'en devine pas un.
+  if (PICTO.test(cle) && typeof valeur === 'string' && /^[a-z_]+$/.test(valeur)) return { cle, genre: 'icon', valeur };
   const genre = type ? SCHEMA_GENRE[type] ?? null : genreDeviné(cle, valeur);
   if (!genre || valeur === '' || valeur == null) return null;
   if (genre === 'html' || genre === 'text') {
@@ -119,11 +126,13 @@ function ranger(contenu, reglages) {
     const { genre, valeur } = reglage;
 
     if (genre === 'palette') contenu.palette ??= valeur;
+    else if (genre === 'icon') contenu.icon ??= valeur;
     else if (genre === 'code') contenu.code.push(valeur);
     else if (['product', 'collection', 'blog', 'page', 'menu', 'article'].includes(genre)) contenu[genre] ??= valeur;
     else if (genre === 'products' || genre === 'collections') contenu[genre] = [...(contenu[genre] || []), ...(Array.isArray(valeur) ? valeur : [valeur])];
     else if (genre === 'image') {
-      if (role === 'image_mobile') contenu.image_mobile ??= valeur;
+      if (role === 'icon_image') contenu.icon_image ??= valeur;
+      else if (role === 'image_mobile') contenu.image_mobile ??= valeur;
       else if (/after/.test(base)) contenu.image_after ??= valeur;
       else if (/before/.test(base)) contenu.image_before ??= valeur;
       else if (!contenu.image) contenu.image = valeur;
@@ -191,7 +200,7 @@ function element(reglages, genre = null) {
 }
 
 const utile = (item) =>
-  item.title !== undefined || item.text !== undefined || item.name !== undefined || item.image || item.video || item.product || item.collection || item.buttons.length || item.eyebrow !== undefined;
+  item.title !== undefined || item.text !== undefined || item.name !== undefined || item.image || item.icon_image || item.video || item.product || item.collection || item.buttons.length || item.eyebrow !== undefined;
 
 /**
  * Le contenu d'une section 3.x.
@@ -244,13 +253,16 @@ export function extraireSection(section, schema, { elements: typesElements = nul
     }
     if (lu.elements.length && !lu.simples.some((r) => ['text', 'html'].includes(r.genre) && /^(heading|title|name|description|text)$/.test(r.cle))) {
       // Un bloc qui porte plusieurs éléments numérotés (icônes, questions, avis).
-      contenu.items.push(...lu.elements.map((el) => ({ ...el, kind: bloc.type })));
+      contenu.items.push(...lu.elements.map((el) => ({ ...el, kind: bloc.type, bloc: id })));
       continue;
     }
     const item = element(lu.simples, bloc.type);
+    item.bloc = id;
     if (lu.elements.length) item.sous = lu.elements;
     if (bloc.blocks) item.enfants = bloc;
     if (utile(item) || item.enfants) contenu.items.push(item);
+    // Un bloc qui ne porte que du code (Liquid, HTML) : le code de la section, dans l'ordre.
+    else if (item.code.length) contenu.code.push(...item.code);
   }
   return contenu;
 }

package/src/migrate/source.js

@@ -15,26 +15,80 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { unzipSync, strFromU8 } from 'fflate';
-import { parseThemeJson } from '../theme/loader.js';
+import { stripJsonComment } 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*-?%\}/;
 
+/**
+ * Le JSON tel que Shopify l'accepte : commentaires et virgule finale permis. Le thème 3.x d'origine
+ * en a (schéma de main-product, cart-drawer…), et un settings_schema.json retouché à la main aussi :
+ * un JSON.parse strict perdait la version du thème et le type de chaque réglage.
+ */
+export function parseJsonSouple(texte) {
+  const source = stripJsonComment(String(texte));
+  try {
+    return JSON.parse(source);
+  } catch (erreur) {
+    try {
+      return JSON.parse(sansVirguleFinale(sansCommentaires(source)));
+    } catch {
+      throw erreur;
+    }
+  }
+}
+
+// Parcourt le texte hors des chaînes : `quoi(c, i)` rend ce qu'il faut écrire et où reprendre.
+function horsChaines(source, quoi) {
+  let sortie = '';
+  for (let i = 0; i < source.length; i++) {
+    if (source[i] === '"') {
+      let j = i + 1;
+      while (j < source.length && source[j] !== '"') j += source[j] === '\\' ? 2 : 1;
+      sortie += source.slice(i, j + 1);
+      i = j;
+      continue;
+    }
+    const [texte, suite] = quoi(source, i);
+    sortie += texte;
+    i = suite;
+  }
+  return sortie;
+}
+
+const sansCommentaires = (source) =>
+  horsChaines(source, (t, i) => {
+    if (t[i] === '/' && t[i + 1] === '/') {
+      const fin = t.indexOf('\n', i);
+      return ['\n', fin === -1 ? t.length : fin];
+    }
+    if (t[i] === '/' && t[i + 1] === '*') {
+      const fin = t.indexOf('*/', i + 2);
+      return [' ', fin === -1 ? t.length : fin + 1];
+    }
+    return [t[i], i];
+  });
+
+const sansVirguleFinale = (source) => horsChaines(source, (t, i) => (t[i] === ',' && /^\s*[}\]]/.test(t.slice(i + 1, i + 200)) ? ['', i] : [t[i], i]));
+
 function lireSchema(liquid) {
   const match = SCHEMA_RE.exec(liquid);
   if (!match) return null;
   try {
-    return JSON.parse(match[1]);
+    return parseJsonSouple(match[1]);
   } catch {
     return null;
   }
 }
 
+// La langue par défaut du thème 3.x : locales/da.default.json → « da ». Seul le nom compte.
+const LOCALE_DEFAUT = /^locales\/([a-z]{2}(?:-[A-Za-z]{2,4})?)\.default\.json$/;
+
 /** Les fichiers utiles d'un thème : chemin relatif → texte. */
 function lireFichiers(source) {
   const fichiers = new Map();
-  const garder = (rel) => fileKind(rel) || rel === 'config/settings_schema.json' || /^(sections|blocks)\/[^/]+\.liquid$/.test(rel);
+  const garder = (rel) => fileKind(rel) || rel === 'config/settings_schema.json' || /^(sections|blocks)\/[^/]+\.liquid$/.test(rel) || LOCALE_DEFAUT.test(rel);
 
   if (fs.statSync(source).isDirectory()) {
     const parcourir = (dossier) => {
@@ -46,7 +100,7 @@ function lireFichiers(source) {
         else if (garder(rel)) fichiers.set(rel, fs.readFileSync(path.join(source, rel), 'utf8'));
       }
     };
-    for (const dossier of ['templates', 'sections', 'blocks', 'config']) parcourir(dossier);
+    for (const dossier of ['templates', 'sections', 'blocks', 'config', 'locales']) parcourir(dossier);
     return fichiers;
   }
 
@@ -81,7 +135,14 @@ export function lireThemeV3DepuisFichiers(fichiers, origine = 'boutique') {
   const schemas = { sections: new Map(), blocks: new Map() };
   let version = null;
   let nom = null;
+  let langueParDefaut = null;
+  let reglagesSchema = [];
   for (const [rel, texte] of fichiers) {
+    const locale = LOCALE_DEFAUT.exec(rel);
+    if (locale) {
+      langueParDefaut = locale[1];
+      continue;
+    }
     const liquid = /^(sections|blocks)\/([^/]+)\.liquid$/.exec(rel);
     if (liquid) {
       const schema = lireSchema(texte);
@@ -90,28 +151,33 @@ export function lireThemeV3DepuisFichiers(fichiers, origine = 'boutique') {
     }
     if (rel === 'config/settings_schema.json') {
       try {
-        const info = parseThemeJson(texte).find((groupe) => groupe.name === 'theme_info');
+        const groupes = parseJsonSouple(texte);
+        const info = groupes.find((groupe) => groupe.name === 'theme_info');
         version = info?.theme_version || null;
         nom = info?.theme_name || null;
+        reglagesSchema = groupes.flatMap((groupe) => groupe.settings || []).filter((reglage) => reglage?.id);
       } catch {
         /* version inconnue */
       }
       continue;
     }
     try {
-      fichiersJson.set(rel, parseThemeJson(texte));
+      fichiersJson.set(rel, parseJsonSouple(texte));
     } catch (error) {
       erreurs.push(`${rel} : JSON illisible (${error.message})`);
     }
   }
 
-  // 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 };
+
+  // La langue de la boutique se lit dans SES textes (modèles, groupes, et sections fixes comme le
+  // panier). Le fichier de traductions par défaut du thème (en.default.json) est l'anglais pour
+  // toutes les boutiques Story Thème : il ne départage que s'il a été changé (da.default.json…).
+  const modeles = [...fichiersJson].filter(([rel]) => rel.startsWith('templates/') || rel.startsWith('sections/')).map(([, data]) => data);
+  const textes = textesDesModeles([...modeles, { sections: courant?.sections || {} }]);
+  const langue = devinerLangue(textes) || (langueParDefaut && langueParDefaut !== 'en' ? langueParDefaut : null);
+  return { origine, version, nom, langue, langueParDefaut, fichiers: fichiersJson, schemas, reglages: courant || {}, reglagesSchema, erreurs };
 }
 
 /** La version majeure d'un numéro « 3.7.0 », ou null. */