story-theme-mcp 1.6.0 → 1.7.0

package/README.md

@@ -6,9 +6,11 @@ Réservé aux titulaires d'une licence Story Thème. Le jeton se génère dans l
 
 ```
 Vous : « Crée la boutique Maison Lumen : bougies parfumées coulées à la main à Lyon. »
-IA   : couleurs, polices, accueil de 9 sections, fiche produit, collection, pages Notre
-       histoire / Comment utiliser / Contact / FAQ / Suivi, thème traduit, démos retirées,
-       zip prêt à importer — puis trois questions pour affiner.
+IA   : une seule salve de questions (photos, collection, conditions… ou « vas-y »), puis
+       une V1 pensée pour une bougie artisanale : manifeste, atelier, étapes de fabrication,
+       fiche produit à accordéons et badges, pages Notre histoire / Comment utiliser /
+       Contact / FAQ / Suivi, tous les textes écrits pour la marque, aucun texte d'exemple
+       du thème, zip prêt à importer — puis la liste de ce qui a été inventé.
 ```
 
 ## Installation
@@ -52,15 +54,16 @@ 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 |
+| S'inspirer | `inspiration` : les 10 boutiques démo composées par le designer — l'ossature de leurs pages, à regarder avant de construire ; `read_guide metiers` : la composition qui convient à chaque métier |
 | 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…) |
+| Construire vite | `build_store` : la V1 complète d'une boutique en un appel — structure choisie selon ce qui est vendu, ou selon le `plan` de pages de l'assistant ; direction artistique, pages de marque composées pour le métier (routine beauté, prise en main tech, entretien mode…), pages 404, mot de passe et blog dans la langue de la boutique, traduction, zip. Tout ou rien : un échec ramène le projet à son état d'avant |
+| 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, colonnes d'un comparatif de modèles…) et la collection montrée |
 | 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` |
 | 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 | `list_shops`, `shops_overview`, `shop_graphql` (Admin GraphQL sur une, plusieurs ou toutes les boutiques), `push_to_shop` (écrire le projet dans un thème non publié, sans zip) — via l'appli Shopify Story Apps, sans aucune clé Shopify |
+| 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 privée Story Thème | `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ù l'équipe Story Thème a installé l'appli |
 
 Prompts prêts à l'emploi : `creer-boutique`, `refaire-une-page`, `auditer-un-theme`. Les guides sont aussi exposés en ressources (`storytheme://guides/<sujet>`).
 
@@ -68,9 +71,10 @@ Prompts prêts à l'emploi : `creer-boutique`, `refaire-une-page`, `auditer-un-t
 
 - **Aucun fichier invalide n'est enregistré.** Chaque modèle, groupe de sections et `settings_data.json` est validé contre les vrais schémas du thème : types de sections et de blocs, blocs privés, blocs statiques et leurs identifiants, réglages (identifiant, type, options, bornes et pas des curseurs), texte riche, liens, images, palettes, polices de la bibliothèque Shopify, limites Shopify (25 sections, 50 blocs, 8 niveaux). Les erreurs proposent la bonne orthographe (« vouliez-vous dire banner ? »).
 - **Plus strict que Shopify Theme Check** : sur un même fichier piégé, Theme Check ne voit que le bloc interdit ; le MCP refuse aussi le réglage inconnu et la valeur hors limites.
-- **Revue design** : textes d'exemple ou en anglais laissés sur une boutique française, faux avis et faux chiffres des presets, bouton sans lien, plusieurs `<h1>`, contrastes insuffisants (WCAG AA, boutons compris), polices dépréciées par Shopify (Futura → Jost…), compte à rebours qui redémarre et stock simulé (pratiques commerciales trompeuses), pop-ups multiples, rythme des palettes.
+- **Aucun texte d'exemple livré** : après composition, chaque page est relue avec les règles de `list_texts`, dans les quatorze langues du thème ; un texte d'exemple restant part avec son bloc, ou la section part, et c'est dit. Sans annonce de la marque, la barre d'annonce est masquée plutôt que d'afficher les siennes ; le HTML glissé dans un texte est nettoyé.
+- **Revue design** : textes d'exemple ou en anglais laissés sur une boutique française, avis d'exemple à remplacer, faux avis et faux chiffres des presets, bouton sans lien, plusieurs `<h1>`, contrastes insuffisants (WCAG AA, boutons compris), polices dépréciées par Shopify (Futura → Jost…), compte à rebours qui redémarre et stock simulé (pratiques commerciales trompeuses), pop-ups multiples, rythme des palettes.
 - **Jamais le code du thème** : seuls `templates/*.json`, `sections/<groupe>.json` et `config/settings_data.json` sont modifiables, dans un dossier de projet. Le Liquid, le CSS et le JS du thème ne sont jamais touchés, ni en local ni à distance.
-- **Écrire dans une boutique reste encadré** : `push_to_shop` n'envoie que les fichiers du projet, refuse une boutique qui ne tourne pas sur un Story Thème de la même version majeure, refuse le thème publié sans confirmation explicite, et ne supprime jamais rien à distance. Les accès passent par l'appli Story Apps (OAuth par boutique, révocable par le marchand) et sont journalisés.
+- **Écrire dans une boutique reste encadré** : `push_to_shop` n'envoie que les fichiers du projet, refuse une boutique qui ne tourne pas sur un Story Thème de la même version majeure, n'écrit dans le thème publié que des fichiers nommés (`files`, ex. un modèle B de test A/B) avec confirmation explicite, jamais le projet entier, et ne supprime jamais rien à distance. Les thèmes s'ouvrent par Theme Access (mot de passe chiffré dans l'espace membre, révocable par le marchand) ; l'appli privée, seulement sur les boutiques dont le compte a prouvé la propriété. Chaque accès est journalisé.
 - **Historique** : chaque écriture est précédée d'un instantané ; `undo` revient en arrière autant de fois que nécessaire.
 - **Export bloqué** tant qu'une erreur bloquante reste ; signalé « pas prêt à publier » tant qu'un point 🔴 reste.
 
@@ -87,12 +91,14 @@ Prompts prêts à l'emploi : `creer-boutique`, `refaire-une-page`, `auditer-un-t
 
 ## Déroulé type
 
-1. **Premier message** (« Crée la boutique X, qui vend Y ») : l'IA appelle `build_store` sans poser de question. En un appel : couleurs et polices selon le style, accueil de 8 à 10 sections, fiche produit, collection, pages à propos / contact / FAQ / suivi, reste du thème traduit, démos retirées, textes clés de la marque placés, zip exporté.
-   - **Photos** : avec un connecteur Shopify, l'IA copie d'abord 3 à 6 belles photos de la boutique dans Contenu > Fichiers (`fileCreate`) et les passe à `build_store` (`images`) : héro, histoire, ambiance. Seules les photos de 1600 px de large ou plus (`images.large`) vont en plein écran : une petite photo n'est jamais étirée. Sans photo : héro typographique sur la couleur de marque, et les sections qui exigent des photos sont remplacées. Jamais de carré « image manquante ».
-   - **Preuves** : avis, note et chiffres uniquement réels (`proofs`). Sans eux, les sections d'avis, de chiffres et de presse sont remplacées par des sections factuelles ou catalogue, pas supprimées.
-   - **Direction artistique** (`direction`) : editorial, minimal, organique, artisan, douceur, pop, energie, tech. Chacune règle arrondis, boutons, survols, transitions de page, formes de séparation animées et polices.
-   - **Moments signature** (selon la direction et `copy`) : manifeste qui s'illumine au défilement, mots qui tournent dans le titre, cartes empilées, étapes de fabrication.
-   - **Pages de marque** créées d'office : Notre histoire (`page.story`) et Comment utiliser (`page.utilisation`).
+1. **Premier message** (« Crée la boutique X, qui vend Y ») : l'IA pose UNE seule salve de questions (ce qui est vendu et à qui, le style, couleur, logo et photos, les vraies conditions), terminée par « ou dites-moi "vas-y" ». Puis `build_store`, en un appel : couleurs et polices, accueil, fiche produit, collection, pages à propos / utilisation / contact / FAQ / suivi, reste du thème traduit, démos retirées, zip exporté.
+   - **Structure selon le métier** (`business`, déduit de l'activité) : la beauté prouve un résultat (avant / après, actifs, routine), la tech se compare (caractéristiques, comparatif, produit expliqué), la mode se montre portée (lookbook, acheter le look, guide des tailles et stock réel sur la fiche), l'épicerie raconte l'origine et se rachète (étapes, fiche, paliers), l'artisanat montre le geste, la maison fait entrer dans les rayons. Compositions relevées sur les démos du designer.
+   - **Ou le plan de l'assistant** (`plan`) : page par page, les sections au format de `compose_page` ; le MCP assemble, relie le catalogue, traduit et valide.
+   - **Textes** : tout ce qui s'affiche vient de `copy` (promesse, manifeste, bénéfices, histoire, étapes, FAQ, détails produit, caractéristiques, comparatif, paliers d'offre, guide des tailles…). Une section que la marque ne peut pas remplir est écartée, et l'assistant en reçoit la liste : **aucun texte d'exemple du thème** ne part dans une boutique.
+   - **Photos** : avec un connecteur Shopify, l'IA copie d'abord les photos de la boutique dans Contenu > Fichiers (`fileCreate`) et les passe à `build_store` (`images`) : héro, histoire, ambiance, avant / après, scène à points cliquables, photos clientes. Seules les photos de 1600 px de large ou plus (`images.large`) vont en plein écran. Sans le média, la section qui en dépend n'est pas posée : jamais de carré « image manquante ».
+   - **Preuves** : `proofs` ne reçoit que du réel (note, avis, chiffres). Les avis d'exemple d'une maquette vont dans `copy.example_reviews` : placés, déclarés au marchand, et signalés par `review_project` jusqu'à leur remplacement par de vrais avis.
+   - **Offres par paliers** : sur ce qui se rachète (consommables, soin, épicerie) ou à la demande, jamais d'office sur une robe ou une coque.
+   - **Direction artistique** (`direction`) : editorial, minimal, organique, artisan, douceur, pop, energie, tech. Chacune règle arrondis, boutons, survols, transitions de page, formes de séparation animées et polices, et ses moments signature (manifeste qui s'illumine, mots qui tournent, cartes empilées, étapes, grand visuel au défilement).
 2. Elle résume la V1, donne le zip, puis pose 3 à 5 questions (collection principale, avis réels, conditions de livraison, couleur et logo, photos).
 3. Chaque réponse s'applique au **projet en cours**, sans le re-préciser.
 4. `review_project`, puis `export_theme` pour un nouveau zip.
@@ -113,7 +119,7 @@ npm run bundle    # fabrique build/story-theme-mcp-<version>.mcpb (extension Cla
 
 Après `npm run bundle`, déposer le `.mcpb` dans le dossier `mcp/` de l'espace membre : la page MCP & Appli sert automatiquement la version la plus récente qu'elle y trouve.
 
-Avec `STORY_THEME_DIR` sur le dépôt du thème, le MCP lit le thème en cours d'écriture et n'appelle pas l'espace membre. Les connaissances rédigées à la main vivent dans `src/knowledge/` ; tout le reste vient du thème.
+Avec `STORY_THEME_DIR` sur le dépôt du thème, le MCP lit le thème en cours d'écriture et n'appelle pas l'espace membre. Les connaissances rédigées à la main vivent dans `src/knowledge/` (descriptions de chaque section et bloc, compositions par métier, directions artistiques, guides) ; tout le reste vient du thème. `npm run check` signale une section ou un bloc public sans description.
 
 Publication : `npm version <x.y.z>` (mettre à jour `src/version.js` à l'identique), `npm publish` — `prepublishOnly` vérifie l'ensemble.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "story-theme-mcp",
-  "version": "1.6.0",
+  "version": "1.7.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/assemblage.js

@@ -0,0 +1,209 @@
+// =====================================================================
+// Une page à partir de spécifications de sections
+// =====================================================================
+// Le même chemin pour tout ce que build_store écrit : le `plan` de l'assistant comme les moments
+// choisis selon le métier. Les sections sont composées (compose.js), reliées au catalogue (collections,
+// produit phare, lot), débarrassées des médias absents et des textes d'exemple, mises au rythme des
+// palettes et à la direction artistique, puis validées.
+
+import { composeSections } from './compose.js';
+import { composerFiche } from './fiche.js';
+import { collectIds } from './scaffold.js';
+import { elaguerExemples, retirerMediasVides, sansDoublons } from './nettoyage.js';
+import { validateFile } from '../validate/template.js';
+
+const clone = (value) => JSON.parse(JSON.stringify(value));
+const HERO_TYPES = ['banner', 'slideshow', 'video'];
+// Clés internes d'une spécification, qui ne regardent pas compose.js.
+const INTERNES = ['moment', 'role', 'catalogue', 'paliers', 'exemples', 'collection', 'collections', 'product', 'blocks', 'horaires'];
+
+function* parcourir(noeud) {
+  const ids = [...Object.keys(noeud.blocks || {}).filter((id) => noeud.blocks[id].static), ...(noeud.block_order || [])];
+  for (const id of ids) {
+    const bloc = noeud.blocks?.[id];
+    if (!bloc) continue;
+    yield { id, bloc, parent: noeud };
+    yield* parcourir(bloc);
+  }
+}
+
+// ---- rythme et direction
+
+// Le rythme des fonds, comme sur les démos du designer (Havn, Ma Petite Ruche : un fond sur deux
+// change). Deux voisines sur le même fond coloré se lisent comme un seul bloc : la seconde revient
+// au fond principal. Trois sections d'affilée sur le fond principal font un long mur sans relief,
+// surtout sans photo : la troisième passe sur le fond doux. Les héros couverts par leur photo ne
+// comptent pas ; un héro typographique, si. Les palettes choisies par l'assistant (explicites)
+// restent les siennes, sauf deux voisines identiques.
+export function fixPaletteRhythm(catalog, data, { explicites = new Set() } = {}) {
+  let precedente = null;
+  let serie = 0;
+  for (const id of data.order || []) {
+    const section = data.sections[id];
+    if (!section) continue;
+    const schema = catalog.section(section.type)?.schema?.settings || [];
+    const setting = (HERO_TYPES.includes(section.type) ? ['frame_palette', 'color_palette'] : ['color_palette', 'frame_palette']).find((key) => schema.some((item) => item.id === key));
+    const couverte = HERO_TYPES.includes(section.type) && (section.settings?.image || section.settings?.video || section.settings?.video_url || section.type === 'slideshow' || section.settings?.media_type !== 'none');
+    if (!setting || couverte) {
+      precedente = null;
+      serie = 0;
+      continue;
+    }
+    section.settings = section.settings || {};
+    let valeur = section.settings[setting] ?? schema.find((item) => item.id === setting).default;
+    const libre = !explicites.has(id) && !/^main-/.test(section.type);
+    // Un manifeste révélé au défilement est un moment fort : sur fond sombre plutôt que fondu dans
+    // le fond principal (Sylys, Ma Petite Ruche le posent en inverse).
+    const manifeste = section.type === 'rich-text' && [...parcourir(section)].some(({ bloc }) => bloc.type === 'text-reveal');
+    if (precedente && valeur === precedente && valeur !== 'background-1' && !/^main-/.test(section.type)) valeur = manifeste && precedente !== 'inverse' ? 'inverse' : 'background-1';
+    else if (libre && valeur === 'background-1' && serie >= 2) valeur = 'background-2';
+    if (valeur !== (section.settings[setting] ?? schema.find((item) => item.id === setting).default)) section.settings[setting] = valeur;
+    serie = valeur === 'background-1' ? serie + 1 : 0;
+    precedente = valeur;
+  }
+}
+
+// A hero without a photo becomes a typographic one on the brand colour, text and background
+// from the same scheme (an image hero keeps white text for the overlay, unreadable without it).
+export function typographicHero(data) {
+  const hero = (data.order || []).map((id) => data.sections[id]).find((section) => section?.type === 'banner');
+  if (!hero || hero.settings?.image) return false;
+  hero.settings = hero.settings || {};
+  Object.assign(hero.settings, { media_type: 'none', frame_palette: 'scheme', color_palette: 'scheme', overlay: 'none', height: 'medium', height_mobile: 'medium', media_effect: 'none' });
+  return true;
+}
+
+// Coloured bands get the direction's shape at their edges; the hero gets it at the bottom.
+export function decorate(catalog, data, direction, { garder = new Set() } = {}) {
+  if (!direction?.separator) return 0;
+  let count = 0;
+  const has = (section, id) => (catalog.section(section.type)?.schema?.settings || []).some((setting) => setting.id === id);
+  (data.order || []).forEach((id, position) => {
+    const section = data.sections[id];
+    // Les formes choisies par l'assistant (spec.separator) restent les siennes.
+    if (!section || !has(section, 'separator_bottom') || garder.has(id)) return;
+    section.settings = section.settings || {};
+    const palette = section.settings.frame_palette ?? section.settings.color_palette ?? 'background-1';
+    const hero = position === 0 && ['banner', 'slideshow'].includes(section.type);
+    if (!hero && palette === 'background-1') return;
+    if (!hero) section.settings.separator_top = direction.separator.shape;
+    section.settings.separator_bottom = direction.separator.shape;
+    if (direction.separator.animation && has(section, 'separator_animation')) section.settings.separator_animation = direction.separator.animation;
+    count += 1;
+  });
+  return count;
+}
+
+// ---- catalogue
+
+/** Relie une section à la boutique : collection d'une liste, collections montrées, produit phare, lot. */
+function relier(catalog, section, spec, { collections = [] }) {
+  const index = spec.catalogue?.collectionIndex ?? 0;
+  const collection = spec.collection || collections[index] || null;
+  if (section.type === 'featured-product' && (spec.product || spec.settings?.product)) section.settings.product = spec.product || spec.settings.product;
+  for (const { bloc } of parcourir(section)) {
+    bloc.settings = bloc.settings || {};
+    if (bloc.type === 'collection-list' && (bloc.settings.source ?? 'collections') === 'collections') {
+      const liste = spec.collections || collections;
+      if (liste.length) bloc.settings.collections = liste.slice(0, bloc.settings.limit || 8);
+      else bloc.settings.source = 'all';
+    }
+    if (bloc.type === 'product-list' && (bloc.settings.source ?? 'collection') === 'collection' && collection) bloc.settings.collection = collection;
+    if (bloc.type === 'bundle-builder' && collection) {
+      bloc.settings.source = 'collection';
+      bloc.settings.collection = collection;
+    }
+    // Horaires d'ouverture : ceux de la marque, sinon aucun (des horaires d'exemple seraient faux).
+    if (bloc.type === 'contact-info') {
+      for (const cle of (bloc.block_order || []).filter((item) => bloc.blocks[item]?.type === '_contact-hours')) {
+        if (spec.horaires) bloc.blocks[cle].settings = { ...bloc.blocks[cle].settings, text: String(spec.horaires).replace(/[<>]/g, ''), hours_weekdays: '', hours_saturday: '', hours_sunday: '', show_status: false };
+        else {
+          delete bloc.blocks[cle];
+          bloc.block_order = bloc.block_order.filter((item) => item !== cle);
+        }
+      }
+    }
+    if (bloc.type === '_bundle-progress' && spec.paliers?.length) {
+      const cles = (bloc.block_order || []).filter((cle) => bloc.blocks[cle]?.type === '_bundle-tier');
+      cles.forEach((cle, rang) => {
+        const palier = spec.paliers[rang];
+        if (!palier) {
+          delete bloc.blocks[cle];
+          bloc.block_order = bloc.block_order.filter((item) => item !== cle);
+          return;
+        }
+        bloc.blocks[cle].settings = {
+          count: Math.max(1, Math.round(Number(palier.count) || rang + 2)),
+          discount: Math.max(0, Math.min(100, Math.round(Number(palier.discount) || 0))),
+          ...(palier.label ? { label: String(palier.label).replace(/[<>]/g, '') } : {}),
+        };
+      });
+    }
+  }
+}
+
+/**
+ * Relie au catalogue les sections fraîchement composées (compose_page comme build_store) : la
+ * collection d'une liste de produits, les collections montrées, le produit en vedette.
+ * @param {string[]} ids identifiants des sections, dans l'ordre des spécifications
+ */
+export function relierAuCatalogue(catalog, data, ids, specs, { collections = [] } = {}) {
+  ids.forEach((id, index) => {
+    if (data.sections[id]) relier(catalog, data.sections[id], specs[index] || {}, { collections });
+  });
+}
+
+/**
+ * Assemble une page complète.
+ * @param {object} catalog
+ * @param {object} options
+ * @param {string} options.fichier modèle écrit (templates/index.json…)
+ * @param {object[]} options.specs sections, au format de compose_page (plus collection, product…)
+ * @param {object} [options.base] modèle de départ (la page collection du thème garde sa grille)
+ * @param {string[]} [options.fiche] blocs de la colonne d'achat : la page commence par la fiche produit
+ * @returns {{ data, notes: string[], retraits: string[], ok: boolean, erreur?: string, poses: string[] }}
+ */
+export function assemblerPage(catalog, { fichier, specs = [], base = null, lang = 'fr', collections = [], proofs = {}, direction = null, fiche = null, copy = {}, offres = false, inventions = [], marque = new Set(), plan = false, garderOrdre = false }) {
+  let data = base ? clone(base) : { sections: {}, order: [] };
+  const notes = [];
+  let poses = [];
+  const pageProduit = fichier.startsWith('templates/product');
+  if (fiche) {
+    const { id, section, poses: blocsPoses } = composerFiche(catalog, fiche, { copy, lang, offres, inventions, remarques: notes, taken: collectIds(data) });
+    data.sections[id] = section;
+    data.order.unshift(id);
+    poses = blocsPoses;
+  }
+  const avant = new Set(data.order);
+  const propres = specs.map((spec) => Object.fromEntries(Object.entries(spec).filter(([cle]) => !INTERNES.includes(cle))));
+  const compose = composeSections(catalog, propres, { language: lang, data, h1First: !pageProduit && !fichier.startsWith('templates/collection') });
+  data = compose.data;
+  notes.push(...compose.notes);
+  const nouvelles = data.order.filter((id) => !avant.has(id));
+  nouvelles.forEach((id, index) => relier(catalog, data.sections[id], specs[index] || {}, { collections }));
+  const separateursChoisis = new Set(nouvelles.filter((id, index) => specs[index]?.separator));
+  // Les palettes écrites dans le plan de l'assistant sont sa décision.
+  const palettesChoisies = new Set(plan ? nouvelles.filter((id, index) => specs[index]?.palette) : []);
+
+  const retraits = [...retirerMediasVides(data, { note: proofs.rating })];
+  const nettoye = elaguerExemples(catalog, fichier, data, { language: lang, marque });
+  data = nettoye.data;
+  // Un plan est la décision de l'assistant : seuls les doublons exacts partent, rien n'est déplacé.
+  retraits.push(...nettoye.retraits, ...sansDoublons(data, { plan: plan || garderOrdre }));
+
+  if (!pageProduit && !fichier.startsWith('templates/collection')) typographicHero(data);
+  fixPaletteRhythm(catalog, data, { explicites: palettesChoisies });
+  decorate(catalog, data, direction, { garder: separateursChoisis });
+  if (plan) {
+    data.order.forEach((id, index) => {
+      // Deux sections de même type sur des fonds différents (les fiches d'ingrédients de Ma Petite
+      // Ruche) se lisent bien ; sur le même fond, elles se confondent.
+      const precedente = data.sections[data.order[index - 1]];
+      const fond = (section) => section?.settings?.color_palette ?? section?.settings?.frame_palette ?? 'background-1';
+      if (index && data.sections[id]?.type === precedente?.type && fond(data.sections[id]) === fond(precedente)) notes.push(`${id} : même type de section et même fond que la précédente (${data.sections[id].type}), les deux se liront comme une seule`);
+    });
+  }
+
+  const verdict = validateFile(catalog, fichier, data);
+  return { data, notes, retraits, poses, ok: verdict.ok, erreur: verdict.ok ? null : `${verdict.errors[0].path} : ${verdict.errors[0].message}` };
+}