story-theme-mcp 1.1.2 → 1.2.0

package/package.json

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

package/src/build/quick.js

@@ -310,6 +310,105 @@ function hasProof(type, proofs) {
 
 // Rewrites a recipe for what the store really has: no grey placeholder when there is no photo,
 // no invented review, press or figure, and a home page that stays full (8 to 10 sections).
+// Enrichissements de l'accueil : des sections tirées selon la DIRECTION ARTISTIQUE, pour que
+// deux boutiques du même style cessent de se ressembler. Une recette par style donnait, à style
+// égal, exactement la même page — c'est le reproche le plus juste qu'on puisse faire au MCP.
+//
+// Le tirage dépend du nom de la boutique : reproductible (reconstruire la même boutique donne
+// la même page), mais différent d'une marque à l'autre. `variation` le force à changer.
+export const ENRICHISSEMENTS_POUR_TESTS = {
+  editorial: [
+    { type: 'timeline', preset: 'Our story', role: 'Les étapes de la marque, en frise' },
+    { type: 'gallery', preset: 'Lookbook', role: 'Lookbook : les pièces en situation', needsImages: true },
+    { type: 'comparison', preset: 'Us vs them', role: 'Ce qui vous distingue, point par point' },
+    { type: 'featured-product', preset: 'Product showcase', role: 'La pièce emblématique, en grand' },
+    { type: 'collection-list', preset: 'Collection grid', role: 'Les familles de produits' },
+  ],
+  minimal: [
+    { type: 'comparison', preset: 'Product comparison', role: 'Comparatif des modèles' },
+    { type: 'gallery', preset: 'Image gallery', role: 'Les produits en situation', needsImages: true },
+    { type: 'timeline', preset: 'How it works', role: 'Comment ça se passe, en 3 étapes' },
+    { type: 'featured-product', preset: 'Product showcase', role: 'Le produit phare, en grand' },
+    { type: 'collection-list', preset: 'Collection grid', role: 'Toutes les familles de produits' },
+  ],
+  organique: [
+    { type: 'timeline', preset: 'How it works', role: 'De la matière au produit fini' },
+    { type: 'comparison', preset: 'Us vs them', role: 'Votre façon de faire, face à l’industrie' },
+    { type: 'before-after', preset: 'Before / after', role: 'Le résultat, avant et après', needsImages: true },
+    { type: 'featured-product', preset: 'Product showcase', role: 'Le produit emblématique, en grand' },
+    { type: 'multicolumn', preset: 'Icons with text', role: 'Les engagements, en pictogrammes' },
+  ],
+  artisan: [
+    { type: 'timeline', preset: 'Our story', role: 'L’atelier, étape par étape' },
+    { type: 'comparison', preset: 'Us vs them', role: 'Fait main contre fabrication industrielle' },
+    { type: 'gallery', preset: 'Image gallery', role: 'L’atelier et les gestes', needsImages: true },
+    { type: 'featured-product', preset: 'Product showcase', role: 'La pièce emblématique, en grand' },
+    { type: 'timeline', preset: 'How it works', role: 'De la commande à la livraison' },
+  ],
+  douceur: [
+    { type: 'timeline', preset: 'How it works', role: 'Le rituel, étape par étape' },
+    { type: 'before-after', preset: 'Transformation', role: 'Avant / après', needsImages: true },
+    { type: 'stats', preset: 'Results', role: 'Résultats mesurés', needsProof: 'figures' },
+    { type: 'comparison', preset: 'Product comparison', role: 'Quelle formule pour quelle peau' },
+    { type: 'featured-product', preset: 'Product showcase', role: 'Le soin phare, en grand' },
+  ],
+  pop: [
+    { type: 'gallery', preset: 'Image gallery', role: 'La galerie qui donne le ton', needsImages: true },
+    { type: 'timeline', preset: 'How it works', role: 'Comment ça marche, en 3 étapes' },
+    { type: 'bundle-builder', preset: 'Build your bundle', role: 'Composez votre lot' },
+    { type: 'collection-list', preset: 'Collection grid', role: 'Toutes les collections, en grille' },
+    { type: 'featured-product', preset: 'Product showcase', role: 'Le best-seller, en grand' },
+  ],
+  energie: [
+    { type: 'stats', preset: 'Key figures', role: 'Les chiffres qui comptent', needsProof: 'figures' },
+    { type: 'comparison', preset: 'Product comparison', role: 'Quel modèle pour quel usage' },
+    { type: 'timeline', preset: 'How it works', role: 'Le programme, étape par étape' },
+    { type: 'bundle-builder', preset: 'Build your bundle', role: 'Le pack complet' },
+    { type: 'featured-product', preset: 'Product showcase', role: 'Le produit phare, en grand' },
+  ],
+  tech: [
+    { type: 'comparison', preset: 'Product comparison', role: 'Les modèles comparés, caractéristique par caractéristique' },
+    { type: 'timeline', preset: 'How it works', role: 'Mise en route en 3 étapes' },
+    { type: 'stats', preset: 'Key figures', role: 'Les chiffres techniques', needsProof: 'figures' },
+    { type: 'featured-product', preset: 'Product showcase', role: 'Le modèle phare, en grand' },
+    { type: 'multicolumn', preset: 'Icons with text', role: 'Les caractéristiques clés' },
+  ],
+};
+
+/** Graine stable tirée d'une chaîne : deux marques différentes, deux pages différentes. */
+export function graineDe(texte) {
+  let h = 0;
+  for (const caractere of String(texte)) h = (h * 31 + caractere.codePointAt(0)) % 100000;
+  return h;
+}
+
+/**
+ * Insère 1 à 2 sections d'enrichissement avant la FAQ. Celles qui exigent des photos ou des
+ * preuves qu'on n'a pas sont écartées : mieux vaut une page plus courte qu'un cadre vide.
+ */
+export function enrichir(steps, { direction = 'editorial', graine = 0, hasImages, proofs = {} }) {
+  const pool = (ENRICHISSEMENTS_POUR_TESTS[direction] || ENRICHISSEMENTS_POUR_TESTS.editorial).filter(
+    (candidat) =>
+      !(candidat.needsImages && !hasImages) &&
+      !(candidat.needsProof && !proofs[candidat.needsProof]?.length) &&
+      !steps.some((etape) => etape.type === candidat.type),
+  );
+  if (!pool.length) return steps;
+
+  // Deux indices INDÉPENDANTS : `graine + i` faisait tomber trois marques sur quatre sur le
+  // même duo, dans le même ordre. Le second saute d'un pas tiré de la graine, jamais nul.
+  const premier = graine % pool.length;
+  const pas = 1 + (Math.floor(graine / pool.length) % Math.max(1, pool.length - 1));
+  const tirage = pool.length === 1 ? [pool[0]] : [pool[premier], pool[(premier + pas) % pool.length]];
+  const uniques = tirage.filter((etape, i) => tirage.findIndex((autre) => autre.type === etape.type) === i);
+
+  const sortie = [...steps];
+  const avantFaq = sortie.findIndex((etape) => etape.type === 'faq');
+  const position = avantFaq === -1 ? Math.max(0, sortie.length - 1) : avantFaq;
+  sortie.splice(position, 0, ...uniques.map((etape) => ({ ...etape })));
+  return sortie;
+}
+
 export function adaptSteps(steps, { templateType, hasImages, hasLarge = hasImages, proofs, collections }) {
   const out = [];
   const planned = steps.map((step) => `${step.type}|${step.preset}`);
@@ -670,7 +769,15 @@ export function buildStore({ catalog, store }, input) {
   for (const [recipeId, file] of recipes) {
     const recipe = findRecipe(recipeId);
     const templateType = file === 'templates/index.json' ? 'index' : file.startsWith('templates/product') ? 'product' : 'other';
-    const steps = adaptSteps(recipe.steps, { templateType, hasImages, hasLarge, proofs, collections });
+    // L'accueil est enrichi AVANT l'adaptation : les sections tirées passent ensuite par les
+    // mêmes règles que les autres (pas de cadre vide, pas de preuve inventée, minimum de 8).
+    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 steps =
+      templateType === 'index'
+        ? enrichir(adaptes, { direction: directionId, graine: graineDe(input.variation || input.name), hasImages, proofs })
+        : 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;
     const filled = clone(data);

package/src/server.js

@@ -33,21 +33,46 @@ import { VERSION } from './version.js';
 
 const INSTRUCTIONS = `Serveur MCP du Story Thème (thème Shopify premium de New Story). Il connaît chaque section, bloc, preset et réglage du thème, et fabrique des boutiques propres et professionnelles sous forme de thème à importer dans Shopify.
 
-Règle n°1 : AGIR D'ABORD, DEMANDER ENSUITE.
-- Dès la première demande, si vous savez de quelle boutique il s'agit (un nom, ou ce qu'elle vend), appelez build_store IMMÉDIATEMENT, sans poser de question avant. Déduisez le reste (style, ton) et rédigez les textes clés de la marque dans le paramètre copy. build_store livre une V1 complète en un seul appel : couleurs, polices, accueil, fiche produit, collection, pages, traduction, zip prêt à importer.
-- Une boutique qui claque a des PHOTOS. Si un connecteur Shopify est disponible, juste avant build_store : lisez les collections (image) et les produits (images), choisissez 3 à 6 belles photos (une large et lumineuse pour le héro, des photos en situation plutôt que des packshots ; notez leur largeur : celles de 1600 px ou plus vont dans images.large), copiez-les dans Contenu > Fichiers avec la mutation fileCreate (read_guide images donne la requête), puis passez leurs noms de fichiers dans images, et les handles des collections dans collections. Sans connecteur, build_store fait un héro typographique propre et n'affiche jamais de carré vide.
-- Une boutique BRANDÉE : choisissez une direction artistique (build_store direction : editorial, minimal, organique, artisan, douceur, pop, energie, tech) et remplissez copy au maximum : manifesto (s'illumine au défilement), rotating_words (mots qui tournent dans le titre), benefits (cartes empilées), process (étapes), story_steps et values (page Notre histoire), usage_steps, tips et usage_faq (page Comment utiliser, adaptée au produit). Titres avec **mot fort** en gras.
-- Pour aller au-delà des recettes (page ingrédients, lookbook, guide cadeau, comparatif, landing), utilisez compose_page : toutes les sections du thème sont disponibles (read_guide signatures).
-- Ne retirez jamais une section sans la remplacer par une section honnête (bénéfices, FAQ, liste de produits, bandeau défilant, collections) : l'accueil garde 8 à 10 sections.
-- La seule question autorisée avant d'agir : « Pour quelle boutique ? », si la demande ne donne ni nom ni activité.
-- Après la V1 : résumez en quelques lignes ce qui a été fait et les choix supposés, donnez le chemin du zip, puis posez 3 à 5 questions pour affiner (celles que renvoie build_store).
-- Ensuite, chaque demande du marchand s'applique au projet en cours (inutile de préciser project) : edit_template, update_theme_settings, apply_recipe, puis export_theme pour un nouveau zip.
-
-Honnêteté : n'inventez ni avis, ni note, ni chiffres, ni presse, ni labels. Pour les conditions (livraison, retours), restez général ou reprenez celles données par le marchand ; la revue signale ce qui reste à confirmer.
+## 1. Un brief éclair, puis vous construisez
 
-Le thème vient de l'espace membre Story Thème : toujours la dernière version publiée. Si le marchand parle d'une nouvelle version, ou si une section semble manquer, appelez theme_source (update: true).
+Avant la première construction, posez UNE seule salve de questions — jamais deux tours, jamais une question isolée :
+
+1. Que vendez-vous, à quel prix, et à qui ?
+2. Quel style : sobre et éditorial, chaleureux et artisanal, coloré et pop, technique, doux ? (ou le nom d'une marque dont ils aiment le site)
+3. Une couleur de marque, un logo ? Des photos déjà déposées dans Shopify ?
+4. Vos vraies conditions : livraison, retours, garantie ?
+
+Terminez par : « ou dites-moi simplement "vas-y" et je construis avec ce que j'ai ». S'ils disent d'y aller, ou si le premier message contient déjà tout, construisez immédiatement sans rien demander.
+
+## 2. La V1 doit être une boutique, pas un squelette
+
+Appelez build_store AVEC un paramètre copy le plus rempli possible. Une V1 qui laisse 90 textes d'exemple est un échec : le marchand ne voit pas son magasin, il voit le thème de démonstration.
+
+É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.
+
+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é
+
+À la fin de votre réponse, une section « Ce que j'ai inventé, à valider » qui liste, poste par poste : les avis et leurs prénoms, les dates et l'histoire, les conditions de livraison et de retour, les prix des offres, les horaires, les chiffres. Le marchand corrige en une passe.
+
+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.
 
-Garde-fous : aucun type de section/bloc ni identifiant de réglage inventé (get_section, get_block, search_theme donnent les vrais) ; tout fichier est validé contre les schémas du thème et un fichier invalide n'est jamais enregistré ; undo annule la dernière modification. Le MCP ne touche ni au code du thème ni à une boutique en ligne. Si un connecteur Shopify est disponible, servez-vous-en pour lire le nom de la boutique, ses collections et ses produits réels, et passez leurs handles à build_store.
+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
+
+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.
+
+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
+
+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.
+
+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.
+
+Le thème vient de l'espace membre Story Thème : toujours la dernière version publiée. Si le marchand parle d'une nouvelle version, ou si une section semble manquer, appelez theme_source (update: true).
 
 Répondez au marchand dans sa langue, en vouvoyant en français, brièvement.`;
 
@@ -748,6 +773,12 @@ export function createServer(config) {
           .optional()
           .describe('Uniquement des preuves réelles. Sans elles, les sections d’avis et de chiffres sont remplacées par des sections factuelles'),
         shop_domain: z.string().optional().describe('Boutique Shopify (xxx.myshopify.com), pour mémoire'),
+      variation: z
+        .string()
+        .optional()
+        .describe(
+          'Change le tirage des sections d’enrichissement de l’accueil. Par défaut il dépend du nom : deux marques différentes n’ont pas la même page. Donnez n’importe quel mot pour obtenir une autre structure sur la même marque.',
+        ),
         language: z.string().optional(),
         copy: COPY.optional(),
       },
@@ -778,6 +809,11 @@ export function createServer(config) {
         `Textes de la marque placés : ${placed}${result.translated ? ` · textes du thème traduits : ${result.translated}` : ''} · textes d’exemple encore à personnaliser : ${toWrite} (list_texts puis edit_template).`,
         exported.ok ? `Zip : ${(await livrerZip(config, { zip: exported.zip, checklist: exported.checklist, project: result.slug, version: catalog.version })).texte}\nÀ importer dans Shopify : Boutique en ligne > Thèmes > Ajouter un thème > Importer un fichier zip (sans publier), puis Personnaliser pour voir le rendu.` : `Export impossible : ${exported.message}`,
         '',
+        // Rappelé dans la sortie de l'outil et pas seulement dans les instructions : c'est ce
+        // que l'assistant relit juste avant d'écrire sa réponse au marchand.
+        'À dire au marchand, dans cet ordre : ce qui a été construit ; « Ce que j’ai inventé, à valider » (avis, dates, conditions de livraison et de retour, prix des offres, horaires, chiffres) ; ce qu’il doit créer dans Shopify (réductions des offres, pages et modèles, menus, application d’avis).',
+        'Proposez-lui aussi de connecter un MCP Shopify à son assistant : vous pourrez alors créer les pages et leurs modèles, monter les menus, créer les réductions et déposer ses photos, au lieu de lui laisser une liste à faire à la main.',
+        '',
         'Questions à poser maintenant pour affiner (pas plus de 5) :',
         ...questions.slice(0, 5).map((question) => `- ${question}`),
       ].join('\n'));

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