story-theme-mcp 1.7.1 → 1.7.2

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.2",
   "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/guides.js

@@ -217,7 +217,7 @@ 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.
+- 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 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/server.js

@@ -107,7 +107,7 @@ Si le marchand tourne sur le Story Thème 3.7 ou avant (pull_from_shop le détec
 
 **Mise à jour** (boutique branchée déjà en 4.x) : update_theme({ shops }) crée un thème NON publié avec la dernière version du Story Thème et y recopie les modèles, les groupes de sections et les réglages de la boutique. Dites au marchand ce qui a été écarté (sections ou réglages que la nouvelle version n'a plus), et que les textes modifiés dans les fichiers de langue et le code ajouté à la main ne suivent pas. Il prévisualise et publie lui-même. En 3.x : migrate_v3.
 
-**L'appli Story Thème** (Story Apps) est gratuite : le marchand l'installe lui-même depuis son espace membre (page MCP & Appli). Elle ajoute les avis clients, les tests A/B, les offres cumulables et récompenses panier, et les codes promo. Sur une boutique branchée où elle est installée, commencez par app_status, puis :
+**L'appli Story Theme Apps** est gratuite : le marchand l'installe lui-même depuis son espace membre (page MCP & Appli). Elle ajoute les avis clients, les tests A/B, les offres cumulables et récompenses panier, et les codes promo. Sur une boutique branchée où elle est installée, commencez par app_status, puis :
 - app_reviews : importer un export CSV (Judge.me, Loox…), ajouter, modérer, répondre aux avis ;
 - app_ab_tests : opposer deux modèles de page. Le modèle B doit exister dans le thème PUBLIÉ : composez-le (compose_page, edit_template), puis, avec l'accord du marchand, envoyez CE SEUL fichier : push_to_shop({ shops, theme: <thème publié>, files: ["templates/product.offre-b.json"], confirm: true }) — un modèle en plus ne change aucune page en ligne. Suivez les résultats (14 jours au moins), puis appliquez le gagnant ;
 - app_offers : les paliers et lots se règlent dans le thème (offres de la fiche produit), l'appli applique la remise au panier : activate la met en place, diagnostic dit pourquoi une offre ne s'applique pas ;
@@ -1649,7 +1649,7 @@ Read the file first (read_file) to get ids.`,
     );
   }
 
-  // Boutiques du compte, via l'appli Shopify Story Apps (src/shops/).
+  // Boutiques du compte, via l'appli Shopify Story Theme Apps (src/shops/).
   registerShopTools(server, config, { ctx });
 
   return server;

package/src/shops/app-tools.js

@@ -11,9 +11,9 @@ import { formatApp } from './format.js';
 export const DEMANDER_APPLI =
   "depuis son espace membre, page MCP & Appli (https://story-theme.com/mcp) : « Installer l'appli », gratuite, en un clic — ou « Demander l'appli » si l'installation en un clic n'y est pas encore ouverte ; à défaut, contact@story-theme.com";
 
-export const APPLI_ABSENTE = `L'appli Story Thème (Story Apps) n'est pas installée sur cette boutique, ou la boutique n'est pas branchée par Theme Access dans l'espace membre. Elle est gratuite : dites au marchand de l'installer ${DEMANDER_APPLI}, et de brancher sa boutique avec Theme Access (même page). En attendant, ses thèmes restent accessibles : pull_from_shop, push_to_shop, update_theme.`;
+export const APPLI_ABSENTE = `L'appli Story Theme Apps n'est pas installée sur cette boutique, ou la boutique n'est pas branchée par Theme Access dans l'espace membre. Elle est gratuite : dites au marchand de l'installer ${DEMANDER_APPLI}, et de brancher sa boutique avec Theme Access (même page). En attendant, ses thèmes restent accessibles : pull_from_shop, push_to_shop, update_theme.`;
 
-const PREREQUIS = `Nécessite l'appli Story Thème (Story Apps, gratuite) installée sur la boutique et la boutique branchée par Theme Access ; sinon, le marchand l'installe ${DEMANDER_APPLI}. Réglage par l'assistant : Story Thème 4.0+ publié et licence active.`;
+const PREREQUIS = `Nécessite l'appli Story Theme Apps (gratuite) installée sur la boutique et la boutique branchée par Theme Access ; sinon, le marchand l'installe ${DEMANDER_APPLI}. Réglage par l'assistant : Story Thème 4.0+ publié et licence active.`;
 
 const cibles = z
   .union([z.string(), z.array(z.string())])
@@ -31,7 +31,7 @@ export function registerAppTools(server, { client, ok, fail }) {
       const data = await client.app(module, { shops: shops ?? 'all', ...reste });
       return ok(formatApp(data), data);
     } catch (e) {
-      if (/sans Story Apps/.test(e.message)) return fail(`${e.message}\n\n${APPLI_ABSENTE}`);
+      if (/sans Story (Theme )?Apps/.test(e.message)) return fail(`${e.message}\n\n${APPLI_ABSENTE}`);
       return fail(e.message);
     }
   };

package/src/shops/client.js

@@ -1,4 +1,4 @@
-// Client de la passerelle multi-boutiques de Story Apps (l'appli Shopify du Story Thème).
+// Client de la passerelle multi-boutiques de Story Theme Apps (l'appli Shopify du Story Thème).
 // Le jeton est celui du MCP (STORY_MCP_TOKEN) : aucune clé Shopify n'est jamais stockée ici.
 
 const DEFAULT_APPS = 'https://apps.story-theme.com';
@@ -24,7 +24,7 @@ export function createShopsClient({ token, base = appsBase(), fetchImpl = global
         signal: AbortSignal.timeout(30000),
       });
     } catch {
-      throw new ShopsError('Story Apps injoignable. Vérifiez votre connexion, puis réessayez.');
+      throw new ShopsError('Story Theme Apps injoignable. Vérifiez votre connexion, puis réessayez.');
     }
     const data = await res.json().catch(() => ({}));
     if (!res.ok) throw new ShopsError(data.error || `Erreur ${res.status}`);

package/src/shops/format.js

@@ -17,7 +17,7 @@ export function formatShopList(data) {
   const lignes = [BANDEAU, `Compte : ${data.account?.email || '?'} · ${shops.length} boutique${shops.length > 1 ? 's' : ''} connectée${shops.length > 1 ? 's' : ''}`, ''];
   if (!shops.length) {
     lignes.push(
-      "Aucune boutique connectée. Pour en connecter une : installez l'appli Story Apps sur la boutique (depuis l'App Store Shopify ou l'espace Story Thème), et vérifiez qu'elle est déclarée dans votre espace membre (Boutiques).",
+      "Aucune boutique connectée. Pour en connecter une : installez l'appli Story Theme Apps sur la boutique (depuis l'espace membre Story Thème, page MCP & Appli), et branchez la boutique avec Theme Access (même page).",
     );
     return lignes.join('\n');
   }
@@ -38,7 +38,7 @@ export function formatOverview(data) {
     lignes.push(`  ${n(s.products)} produits · ${n(s.collections)} collections`);
     const m = s.modules || {};
     lignes.push(
-      `  Story Apps : ${n(m.reviews)} avis${m.reviewsPending ? ` (${m.reviewsPending} à modérer)` : ''} · ${n(m.abTests)} test${m.abTests > 1 ? 's' : ''} A/B · offres cumulables ${m.offers ? 'actives' : 'non activées'}`,
+      `  Story Theme Apps : ${n(m.reviews)} avis${m.reviewsPending ? ` (${m.reviewsPending} à modérer)` : ''} · ${n(m.abTests)} test${m.abTests > 1 ? 's' : ''} A/B · offres cumulables ${m.offers ? 'actives' : 'non activées'}`,
     );
     if (s.errors?.length) lignes.push(`  ⚠️ ${s.errors.map((e) => e.message).join(' · ')}`);
   }

package/src/shops/tools.js

@@ -1,5 +1,5 @@
 // Outils « multi-boutiques » du MCP Story Thème : lire et modifier TOUTES les boutiques d'un
-// client en même temps, sans se déconnecter, via l'appli Shopify Story Apps.
+// client en même temps, sans se déconnecter, via l'appli Shopify Story Theme Apps.
 //
 // Branchement : dans src/server.js, juste avant `return server;` de createServer :
 //     registerShopTools(server, config);
@@ -22,7 +22,7 @@ const garde = (fn) => async (args) => {
   try {
     return await fn(args || {});
   } catch (e) {
-    if (e instanceof ShopsError && /sans Story Apps/.test(e.message)) {
+    if (e instanceof ShopsError && /sans Story (Theme )?Apps/.test(e.message)) {
       // La boutique est sans doute branchée par Theme Access : l'outil n'est pas le bon.
       return fail(`${e.message}\nSi elle est branchée par Theme Access (● dans list_shops) sans l'appli Story Thème, seuls ses thèmes sont accessibles : pull_from_shop, push_to_shop, update_theme, migrate_v3. Pour les avis, tests A/B, offres et codes promo, le marchand demande l'appli ${DEMANDER_APPLI}. Pour ses produits, collections, pages et menus : le connecteur Shopify officiel du marchand.`);
     }
@@ -44,7 +44,7 @@ export function registerShopTools(server, config, { fetchImpl, ctx } = {}) {
     {
       title: 'Vos boutiques',
       description:
-        "Lists every Shopify store of this Story Theme account that has the Story Apps app installed: name, domain, handle, theme version, licence. Call it first before any multi-store work. Stores are reached through Story Apps: no Shopify key needed.",
+        "Lists every Shopify store of this Story Theme account that has the Story Theme Apps app installed: name, domain, handle, theme version, licence. Call it first before any multi-store work. Stores are reached through Story Theme Apps: no Shopify key needed.",
       annotations: { readOnlyHint: true, openWorldHint: true },
     },
     garde(async () => {
@@ -58,7 +58,7 @@ export function registerShopTools(server, config, { fetchImpl, ctx } = {}) {
     {
       title: "Vue d'ensemble des boutiques",
       description:
-        'Only for stores where the private Story Theme app (Story Apps) is installed. Key figures in one call: products, collections, Shopify plan, theme version and pending update, licence, and Story Apps modules (reviews, pending reviews, A/B tests, stackable offers). A store connected with Theme Access only, without the app, is NOT reachable here: app_status says what to tell the merchant.',
+        'Only for stores where the Story Theme Apps app is installed. Key figures in one call: products, collections, Shopify plan, theme version and pending update, licence, and Story Theme Apps modules (reviews, pending reviews, A/B tests, stackable offers). A store connected with Theme Access only, without the app, is NOT reachable here: app_status says what to tell the merchant.',
       annotations: { readOnlyHint: true, openWorldHint: true },
     },
     garde(async () => {
@@ -72,7 +72,7 @@ export function registerShopTools(server, config, { fetchImpl, ctx } = {}) {
     {
       title: 'Requête sur une ou plusieurs boutiques',
       description:
-        'Only for stores where the private Story Theme app (Story Apps) is installed — NOT for a store connected with Theme Access only, which only opens its themes (use pull_from_shop / push_to_shop; for products, collections, pages, menus and discounts, use the merchant\'s official Shopify connector). Runs one Shopify Admin GraphQL operation on one, several or all Story Apps stores, in parallel, within the app scopes. For reviews, A/B tests, offers and discount codes prefer the app_* tools. A mutation on several stores needs confirm: true, only after the user explicitly agreed. Every access is logged.',
+        'Only for stores where the Story Theme Apps app is installed — NOT for a store connected with Theme Access only, which only opens its themes (use pull_from_shop / push_to_shop; for products, collections, pages, menus and discounts, use the merchant\'s official Shopify connector). Runs one Shopify Admin GraphQL operation on one, several or all Story Theme Apps stores, in parallel, within the app scopes. For reviews, A/B tests, offers and discount codes prefer the app_* tools. A mutation on several stores needs confirm: true, only after the user explicitly agreed. Every access is logged.',
       inputSchema: {
         shops: cibleSchema,
         query: z.string().describe('Requête ou mutation GraphQL Admin.'),

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