sbuilder-mcp 0.69.0 → 0.70.0

package/CHANGELOG.md

@@ -6,6 +6,14 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.70.0] - 2026-09-26
+
+### Added
+- `sb_review` warns once per site (`cartDrawerThumbnail`) when a cart drawer seeded before the platform fixed its seed renders a line's thumbnail as a gallery (feature image plus a thumbs strip) squeezed into a 64px line, and `sb_store` action `cart` with `relocalize: true` now also fixes it, setting that thumbnail to a single image through the open page's save.
+
+### Changed
+- `sb_store` action `cart`'s `relocalize` no longer requires `settings.locale` to be set when the only thing left to fix is a gallery thumbnail; it still refuses when there is neither a locale word nor a thumbnail to relocalize.
+
 ## [0.69.0] - 2026-09-26
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,14 @@ Mọi thay đổi đáng chú ý của dự án được ghi lại trong file n
 Định dạng dựa trên [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 và dự án tuân theo [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.70.0] - 2026-09-26
+
+### Added
+- `sb_review` cảnh báo một lần cho mỗi site (`cartDrawerThumbnail`) khi cart drawer được gieo trước khi nền tảng sửa lại seed hiện thumbnail của một line dưới dạng gallery (ảnh chính cộng dải ảnh thu nhỏ) bị nhồi vào một line cao 64px, và action `cart` của `sb_store` với `relocalize: true` giờ cũng sửa luôn, đặt thumbnail đó thành một ảnh duy nhất thông qua lần lưu của trang đang mở.
+
+### Changed
+- `relocalize` của action `cart` trong `sb_store` không còn yêu cầu `settings.locale` phải được đặt khi thứ duy nhất cần sửa là thumbnail dạng gallery; nó vẫn từ chối khi không có cả từ ngôn ngữ lẫn thumbnail nào cần relocalize.
+
 ## [0.69.0] - 2026-09-26
 
 ### Added

package/dist/domains/site/cartlang.js

@@ -56,3 +56,18 @@ export function cartRelocalize(doc, rootId, locale) {
     });
     return out;
 }
+/**
+ * A CART LINE THUMBNAIL SEEDED AS A GALLERY. Drawers seeded before
+ * web_builder `3e5efbb52` carry a childless `media-dataset` with no `layout`,
+ * which renders the feature image PLUS a thumbs strip inside a 64px line. The
+ * seed now says `single`; a layout the merchant chose explicitly is theirs.
+ */
+export function cartGalleryThumbs(doc, rootId) {
+    const out = [];
+    walk(doc, rootId, (n) => {
+        const layout = n.config?.layout;
+        if (n.data.type === 'media-dataset' && !(n.data.nodes ?? []).length && (layout === undefined || layout === 'bottom'))
+            out.push(n.id);
+    });
+    return out;
+}

package/dist/domains/site/readiness.js

@@ -16,7 +16,7 @@
  * fetched reports nothing rather than a gap the store may not have. A warning
  * that fires on a correctly built site is one the reader learns to ignore.
  */
-import { cartRelocalize, cartSeedLocale } from './cartlang.js';
+import { cartGalleryThumbs, cartRelocalize, cartSeedLocale } from './cartlang.js';
 /** The purchase binding an Add-to-cart / Buy-now button carries. */
 const PRODUCT_ACTION_BINDING_ID = 'bind-product-action';
 /** Element types that only make sense in a store. */
@@ -280,6 +280,15 @@ export function readinessGaps(input) {
             });
         }
     }
+    if (input.cartOverlay?.root_node_id && cartGalleryThumbs(input.cartOverlay, input.cartOverlay.root_node_id).length) {
+        gaps.push({
+            id: 'cartDrawerThumbnail',
+            draft: false,
+            problem: 'The cart drawer\'s line thumbnail is a GALLERY (feature image plus a thumbs strip) squeezed ' +
+                'into a 64px line — a drawer seeded before the platform fixed its seed.',
+            fix: 'Open any page of this site, then sb_store action:"cart" relocalize:true dry_run:false — it sets that thumbnail to a single image.',
+        });
+    }
     if (!isStore(input))
         return gaps;
     if (pages && !published(pages, 'checkout')) {

package/dist/tools/overlay.js

@@ -57,7 +57,7 @@ import { siteToken } from './credentialpick.js';
 import { setKeys } from '../domains/site/builder.js';
 import { CART_SEEDS, OVERLAY_SEEDS } from '../catalog/overlays.generated.js';
 import { withFreshIds } from '../domains/site/ids.js';
-import { cartRelocalize, cartSeedLocale } from '../domains/site/cartlang.js';
+import { cartGalleryThumbs, cartRelocalize, cartSeedLocale } from '../domains/site/cartlang.js';
 const KIND_NAME = {
     popup: 'Pop-up',
     quickview: 'Quick view',
@@ -363,29 +363,34 @@ export async function relocalizeCartDrawer(ctx, session, siteId, dryRun) {
         throw new Error('sbuilder: this site has no cart drawer — sb_store action:"cart" without relocalize creates one.');
     const settings = (await get(`/api/sites/${site}/settings`));
     const raw = settings.settings?.locale;
-    if (typeof raw !== 'string' || !raw) {
-        throw new Error('sbuilder: settings.locale is unset, so there is no site language to relocalize to — set it with sb_theme locale first.');
-    }
-    const language = cartSeedLocale(raw);
+    // No locale means no language to move the WORDS to; the thumbnail needs none.
+    const language = typeof raw === 'string' && raw ? cartSeedLocale(raw) : null;
     const open = session.peek() ? session.location() : null;
     const composed = open?.siteId === siteId
         ? Object.values(session.current().doc.nodes).find((n) => n.specials?.overlayId === cart.id)
         : undefined;
-    const changes = composed
-        ? cartRelocalize(session.current().doc, composed.id, language)
+    const target = composed
+        ? { doc: session.current().doc, root: composed.id }
         : cart.document?.root_node_id
-            ? cartRelocalize(cart.document, cart.document.root_node_id, language)
-            : [];
-    if (dryRun || changes.length === 0) {
+            ? { doc: cart.document, root: cart.document.root_node_id }
+            : null;
+    const changes = target && language ? cartRelocalize(target.doc, target.root, language) : [];
+    const thumbnails = target ? cartGalleryThumbs(target.doc, target.root) : [];
+    if (!language && thumbnails.length === 0) {
+        throw new Error('sbuilder: settings.locale is unset, so there is no site language to relocalize to — set it with sb_theme locale first.');
+    }
+    const thumbNote = thumbnails.length ? { thumbnails, thumbnails_note: 'These line thumbnails become a single image (config.layout "single").' } : {};
+    if (dryRun || changes.length + thumbnails.length === 0) {
         return {
             ...(dryRun ? { dry_run: true } : {}),
             overlay_id: cart.id,
             language,
             changes,
-            ...(changes.length === 0
-                ? { note: 'Nothing to change — no seed word from another language is left in the drawer.' }
+            ...thumbNote,
+            ...(changes.length + thumbnails.length === 0
+                ? { note: 'Nothing to change — no seed word from another language and no gallery thumbnail is left in the drawer.' }
                 : {
-                    plan: redact([{ step: 1, what: 'rewrite those strings in the composed drawer and save the open page', method: 'PUT', path: `/api/sites/${site}/pages/{open page}/source` }]),
+                    plan: redact([{ step: 1, what: 'apply those changes to the composed drawer and save the open page', method: 'PUT', path: `/api/sites/${site}/pages/{open page}/source` }]),
                     note: 'Nothing was sent. Re-call with dry_run:false; it writes through the open page\'s save.',
                 }),
         };
@@ -393,11 +398,15 @@ export async function relocalizeCartDrawer(ctx, session, siteId, dryRun) {
     if (!composed) {
         throw new Error(`sbuilder: the drawer is written through a page save, so relocalize needs a page of site "${siteId}" open — sb_page_open one, then re-run.`);
     }
-    await session.applyAndSave(changes.map((c) => ({ op: 'set', path: ['nodes', c.node_id, 'specials', c.key], value: c.to })));
+    await session.applyAndSave([
+        ...changes.map((c) => ({ op: 'set', path: ['nodes', c.node_id, 'specials', c.key], value: c.to })),
+        ...thumbnails.map((id) => ({ op: 'set', path: ['nodes', id, 'config', 'layout'], value: 'single' })),
+    ]);
     return {
         overlay_id: cart.id,
         language,
         changes,
+        ...thumbNote,
         next: 'Publish the pages: the drawer reaches a shopper through each published page.',
     };
 }

package/dist/tools/store.js

@@ -1,7 +1,7 @@
 /**
  * THE STORE FLOWS THAT MUST BE ORDERED.
  *
- * `sb_review` names EIGHTEEN readiness gaps (`ReadinessGapId`). Most are one
+ * `sb_review` names its readiness gaps (`ReadinessGapId`). Most are one
  * call each — a delivery option, a payment gateway, a product, a page of the
  * right type — because `REQUEST_SHAPES` tells the caller what those calls take.
  * The ones that are not are the flows in this file: each is several writes in
@@ -533,7 +533,8 @@ export function registerStoreTools(server, ctx, session) {
                 .boolean()
                 .optional()
                 .describe('action:"cart" — rewrite an EXISTING drawer\'s seed words that are in another language ' +
-                'to the site locale\'s (edited text untouched); needs a page of the site open'),
+                'to the site locale\'s (edited text untouched), and turn a gallery line thumbnail into a ' +
+                'single image; needs a page of the site open'),
             dry_run: z.boolean().optional(),
         },
         annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sbuilder-mcp",
-  "version": "0.69.0",
+  "version": "0.70.0",
   "description": "MCP server that designs and operates a Store Builder site — pages, data, theme and publish — through the platform's own API and live-edit protocol.",
   "mcpName": "io.github.vuluu2k/sbuilder-mcp",
   "type": "module",