story-theme-mcp 1.2.2 → 1.3.0

package/README.md

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "story-theme-mcp",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "description": "Serveur MCP du Story Thème : votre assistant IA connaît le thème Shopify Story par cœur et construit des boutiques propres et professionnelles.",
   "type": "module",
   "main": "src/index.js",
@@ -23,6 +23,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
     "fflate": "^0.8.3",
+    "story-theme-mcp": "^1.2.1",
     "zod": "^4.6.5"
   },
   "keywords": [

package/src/knowledge/demos.js

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

package/src/knowledge/guides.js

@@ -17,7 +17,7 @@ Règles d'or :
 - Partez d'un preset (sections et blocs) ou d'une recette : ils sont réglés par le designer du thème.
 - Les images ne peuvent pas être envoyées par le MCP : laissez les champs image vides, la check-list les liste. Si le marchand a déjà déposé ses images dans Contenu > Fichiers, utilisez shopify://shop_images/<nom-exact>.
 - Les produits, collections, menus et pages se créent dans l'administration Shopify ; le thème ne fait que les afficher. Utilisez les handles donnés par le marchand (ou lus avec un connecteur Shopify).
-- Honnêteté commerciale : pas de faux avis, faux chiffres, faux stock, compte à rebours qui redémarre, logos presse inventés.`,
+- Une V1 est une MAQUETTE : écrivez des avis, des chiffres et des conditions plausibles pour qu'elle ressemble à une boutique finie, puis listez tout ce que vous avez inventé sous « Ce que j'ai inventé, à valider ». Le marchand corrige en une passe et remplace les avis par de vrais avant la mise en ligne.\n- Deux limites qui ne se négocient pas, même en maquette : aucun compte à rebours qui redémarre à l'infini, aucun stock simulé (pratiques commerciales trompeuses).`,
   },
 
   architecture: {
@@ -46,7 +46,7 @@ Règles d'or :
 - **Photos.** Une photo de qualité vaut mieux que trois moyennes. Les visuels d'exemple du thème ne doivent jamais partir en ligne.
 - **Animations.** Celles des presets suffisent. Un seul effet fort par page (zoom au défilement, cartes empilées, scrollytelling).
 - **Mobile d'abord.** Tailles mobiles des titres (size_mobile), stack_on_mobile, bannière avec image mobile dédiée si le visuel est large.
-- **Sobriété commerciale.** Pas de pop-up à l'arrivée, une seule pop-up au total, pas d'urgence inventée, pas de superlatifs sans preuve.`,
+- **Sobriété commerciale.** Pas de pop-up à l'arrivée, une seule pop-up au total, pas de superlatifs sans preuve. Une offre de lancement ou un lot sont légitimes ; un compte à rebours qui redémarre et un stock simulé ne le sont pas.`,
   },
 
   couleurs: {
@@ -246,7 +246,7 @@ GUIDES.signatures = {
 - Comparatif / pourquoi nous : comparison, calculator (coût par usage), stats réels.
 - Landing de campagne : banner, countdown (vraie date), featured-product, comparison, FAQ.
 
-**Règles** : 7 à 10 sections par page, alterner visuel et texte, une section colorée sur trois, un seul effet fort par écran, jamais de faux chiffres ni de faux avis.`,
+**Règles** : 7 à 10 sections par page, alterner visuel et texte, une section colorée sur trois, un seul effet fort par écran. Les avis et chiffres d'une maquette sont des exemples à valider : écrivez-les, puis déclarez-les.`,
 };
 
 export const GUIDE_TOPICS = Object.keys(GUIDES);

package/src/server.js

@@ -20,6 +20,7 @@ import { composeSections } from './build/compose.js';
 import { DIRECTIONS } from './knowledge/directions.js';
 import { ProjectStore, checkRelativePath } from './project/store.js';
 import { localSource } from './theme/source.js';
+import { creerDemos, formatDemos, formatComposition } from './knowledge/demos.js';
 import { reviewProject, formatReview, findSchemeReferences } from './project/review.js';
 import { exportTheme, importTheme, migrateProject } from './project/export.js';
 import { GUIDES, GUIDE_TOPICS } from './knowledge/guides.js';
@@ -42,7 +43,9 @@ Avant la première construction, posez UNE seule salve de questions — jamais d
 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.
+Terminez par : « ou dites-moi simplement "vas-y" et je construis avec ce que j'ai ». S'ils disent d'y aller, construisez immédiatement.
+
+Même quand le premier message semble complet, DEUX questions restent à poser avant de construire, parce que leurs réponses changent la page elle-même et qu'elles manquent presque toujours : les photos déjà déposées dans Shopify (sans elles, héro typographique et sections remplacées) et la collection principale (bouton du héro, meilleures ventes). Posez-les en une ligne, et construisez dès la réponse.
 
 ## 2. La V1 doit être une boutique, pas un squelette
 
@@ -50,7 +53,9 @@ Appelez build_store AVEC un paramètre copy le plus rempli possible. Une V1 qui
 
 ÉCRIVEZ LE CONTENU. Rédigez la promesse, le manifeste, les bénéfices, les étapes de fabrication, la FAQ, les valeurs, les pages d'aide (livraison, retours, garantie, paiement), les offres par paliers, et oui : des avis clients plausibles et un peu d'urgence honnête (une offre de lancement, un lot). C'est une MAQUETTE que le marchand valide, pas une boutique en ligne : mieux vaut un exemple concret qu'il corrige qu'un cadre vide qu'il doit remplir seul.
 
-La fiche produit part AVEC des offres par paliers (1 / 2 / 3 pièces, ou lot + cadeau) : c'est le défaut, écrivez-en les libellés et les remises, et rappelez au marchand de créer les réductions correspondantes dans Shopify.\n\nVariez la structure : donnez une direction artistique (build_store direction) et, pour deux boutiques du même style, un paramètre variation différent. compose_page crée les pages que les recettes ne prévoient pas (ingrédients, lookbook, comparatif, guide cadeau, livraison, garantie).
+La fiche produit part AVEC des offres par paliers (1 / 2 / 3 pièces, ou lot + cadeau) : c'est le défaut, écrivez-en les libellés et les remises, et rappelez au marchand de créer les réductions correspondantes dans Shopify.\n\nAvant de construire, appelez inspiration : les onze boutiques démo sont composées par le designer du thème. Regardez celle dont l'activité ressemble le plus à celle du marchand et reprenez-en l'enchaînement et le rythme des palettes — jamais les textes, et sans vous y enfermer si la marque appelle autre chose.
+
+Variez la structure : donnez une direction artistique (build_store direction) et, pour deux boutiques du même style, un paramètre variation différent. compose_page crée les pages que les recettes ne prévoient pas (ingrédients, lookbook, comparatif, guide cadeau, livraison, garantie).
 
 ## 3. Déclarez TOUT ce que vous avez inventé
 
@@ -296,7 +301,7 @@ export function createServer(config) {
           '',
           '## Outils',
           '- Connaître le thème : search_theme, list_sections, get_section, list_blocks, get_block, get_theme_settings, get_theme_template, read_guide',
-          '- Concevoir : recipes, generate_color_schemes, check_contrast, find_fonts',
+          '- Concevoir : inspiration (les 11 boutiques démo, à regarder avant de composer), recipes, generate_color_schemes, check_contrast, find_fonts',
           '- Construire vite : build_store (V1 complète en un appel), compose_page (pages originales avec toutes les sections), read_guide signatures',
           '- Construire : create_project, update_brief, apply_recipe, localize_template, list_texts, edit_template, write_file, update_theme_settings, read_file, exclude_template',
           '- Contrôler : validate_json, review_project, undo, revert_file',
@@ -374,6 +379,30 @@ export function createServer(config) {
     }),
   );
 
+  server.registerTool(
+    'inspiration',
+    {
+      title: 'Boutiques démo',
+      description:
+        'The eleven Story Theme demo stores, composed by the theme designer. Without arguments: the catalogue (niche, positioning). With `demo`: how that store composes its pages — sections in order, palettes, block types. Look at the demo closest to the merchant’s business BEFORE building, and take inspiration from the sequence and rhythm — never from its texts.',
+      inputSchema: {
+        demo: z.string().optional().describe('Identifiant d’une démo (sylys, narvo, havn…)'),
+        page: z.string().optional().describe('Page précise : index, product, collection, ou une page de marque (page.a-propos…)'),
+      },
+      annotations: readOnly,
+    },
+    run(async ({ demo, page }) => {
+      const demos = creerDemos(config);
+      if (!demo) return ok(formatDemos(await demos.lister()));
+      const composition = await demos.composition(demo);
+      if (!composition) {
+        const connues = (await demos.lister()).map((entree) => entree.slug);
+        return fail(`Démo « ${demo} » inconnue. Disponibles : ${connues.join(', ')}.`);
+      }
+      return ok(formatComposition(composition, page));
+    }),
+  );
+
   server.registerTool(
     'read_guide',
     {

package/src/version.js

@@ -1,3 +1,3 @@
 // Version du serveur MCP. Ici et dans package.json — les deux doivent être identiques
 // (npm test le vérifie), et rien d'autre ne la redéclare.
-export const VERSION = '1.2.2';
+export const VERSION = '1.3.0';