story-theme-mcp 1.7.1 → 1.7.3

package/README.md

@@ -63,7 +63,7 @@ Le MCP ne contient pas le thème : au démarrage, il demande à l'espace membre
 | Livrer | `export_theme` (zip à importer + check-list), `import_theme` (auditer un thème téléchargé d'une boutique) |
 | Passer en 4.x | `migrate_v3` : une boutique en Story Thème 3.7 ou avant, reconstruite en 4.x avec son contenu (textes, photos, avis, FAQ, produits, couleurs, polices, logo, menus), section par section — ce que la mise à jour de l'espace membre ne sait pas faire |
 | Vos boutiques (Theme Access) | `list_shops` (et la marche à suivre pour brancher une boutique), `pull_from_shop` (relire le thème de la boutique), `push_to_shop` (écrire le projet dans un thème non publié, sans zip), `update_theme` (mettre à jour le Story Thème dans un thème neuf non publié) — la boutique se branche une fois depuis l'espace membre avec un mot de passe Theme Access, qui n'ouvre que ses thèmes |
-| L'appli Story Thème (Story Apps, gratuite) | `app_status`, `app_reviews` (import CSV, modération, réponses), `app_ab_tests`, `app_offers` (la remise des offres du thème), `app_discount_codes`, `shops_overview`, `shop_graphql` — sur les boutiques où le marchand a installé l'appli (depuis son espace membre) |
+| L'appli Story Thème (Story Theme Apps, gratuite) | `app_status`, `app_reviews` (import CSV, modération, réponses), `app_ab_tests`, `app_offers` (la remise des offres du thème), `app_discount_codes`, `shops_overview`, `shop_graphql` — sur les boutiques où le marchand a installé l'appli (depuis son espace membre) |
 
 Prompts prêts à l'emploi : `creer-boutique`, `refaire-une-page`, `auditer-un-theme`. Les guides sont aussi exposés en ressources (`storytheme://guides/<sujet>`).
 
@@ -106,7 +106,7 @@ Prompts prêts à l'emploi : `creer-boutique`, `refaire-une-page`, `auditer-un-t
 
 ## Limites
 
-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.
+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 Theme 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.7.1",
+  "version": "1.7.3",
   "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/index.js

@@ -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/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 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. */