story-theme-mcp 1.2.3 → 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.3",
+  "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",

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/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';
@@ -52,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é
 
@@ -298,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',
@@ -376,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.3';
+export const VERSION = '1.3.0';