sbuilder-mcp 0.66.1 → 0.67.0

package/CHANGELOG.md

@@ -6,6 +6,18 @@ 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.67.0] - 2026-09-25
+
+### Added
+- `sb_review` warns once per site (`cartDrawerLanguage`) when the site's cart drawer still carries another locale's seed words, and `sb_store` action `cart` gains a `relocalize` argument that rewrites exactly those words to the site locale's seed, leaving merchant-edited text untouched; a real run needs a page of the site open, since the drawer is written through the page save.
+
+### Changed
+- The generated catalog was regenerated against the platform: a category/search card's media-dataset repeater now shows a single thumbnail instead of a strip, and several defaults (form/menu hover, cart-count badge) now read the theme's `var(--wb-sc-*)` tokens instead of a hardcoded color.
+
+### Fixed
+- A non-GET write to a shared global section, or a global/overlay frame from the live room, now marks the open page's copy stale when it composes that master, so the next save re-pulls the page instead of decomposing an old header, footer, or cart drawer back over the merchant's change.
+- `sb_store` action `cart`'s dry run now explains why a newly created drawer would come out in English — unreadable site settings, an unset `settings.locale`, or a locale with no seed — instead of staying silent about the fallback.
+
 ## [0.66.1] - 2026-09-25
 
 ### Fixed

package/CHANGELOG.vi.md

@@ -6,6 +6,18 @@ 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.67.0] - 2026-09-25
+
+### Added
+- `sb_review` cảnh báo một lần cho mỗi site (`cartDrawerLanguage`) khi cart drawer của site vẫn còn mang từ seed của một locale khác, và `sb_store` action `cart` có thêm tham số `relocalize` để viết lại đúng những từ đó thành seed của locale site, giữ nguyên text đã được merchant chỉnh sửa; một lần chạy thật cần có một trang của site đang mở, vì drawer được ghi thông qua lần lưu trang.
+
+### Changed
+- Catalog được sinh ra đã được làm mới dựa trên nền tảng: repeater media-dataset trên thẻ category/search giờ hiện một thumbnail duy nhất thay vì một dải ảnh, và một số giá trị mặc định (hover của form/menu, badge cart-count) giờ đọc theo token `var(--wb-sc-*)` của theme thay vì màu cố định.
+
+### Fixed
+- Một lần ghi không phải GET vào một global section dùng chung, hoặc một frame global/overlay từ phòng live, giờ đánh dấu bản sao của trang đang mở là cũ khi nó compose từ master đó, để lần lưu tiếp theo đọc lại trang thay vì decompose header, footer hay cart drawer cũ đè lên thay đổi của merchant.
+- Dry run của action `cart` trong `sb_store` giờ giải thích lý do vì sao một drawer mới tạo sẽ ra tiếng Anh — không đọc được settings của site, `settings.locale` chưa được đặt, hoặc một locale không có seed — thay vì im lặng về việc rơi về tiếng Anh.
+
 ## [0.66.1] - 2026-09-25
 
 ### Fixed

package/README.md

@@ -111,7 +111,7 @@ in this client: one would put the very key the platform exists to hold back into
 | `sb_import` | Read a page from any public URL and add its structure and content to the open page as real elements, styled with THIS page's own tokens — a translation, not a clone |
 | `sb_import_site` | Read a WHOLE site from one URL — its sitemap, or the links on that page — and give each page found its own draft page here, built from this site's tokens; the entry page's own colours and type scale also patch into this SITE'S theme, so it stops being purely a read |
 | `sb_theme` | Read or patch the site's palette and type scale — the layer every style preset resolves from, so one token repaints every page; `locale` sets the site's language |
-| `sb_store` | Run a store flow that must happen in a fixed order — `checkout` (the four writes that make a working one), `form` (any of the platform's 17 templates with its own field document), `chrome` (one shared header or footer on a real site menu — desktop menu, mobile drawer, cart and account icons), `menu` (a menu node bound to the site's menu, its links resolved), `overlay_attach` (a pop-up or quick view on the open page), `cart` (the site's cart drawer, when it has none) and `app` (a built-in app plus the pages it needs), `global_attach` / `global_detach` (put an EXISTING shared section on the open page, or take it off) |
+| `sb_store` | Run a store flow that must happen in a fixed order — `checkout` (the four writes that make a working one), `form` (any of the platform's 17 templates with its own field document), `chrome` (one shared header or footer on a real site menu — desktop menu, mobile drawer, cart and account icons), `menu` (a menu node bound to the site's menu, its links resolved), `overlay_attach` (a pop-up or quick view on the open page), `cart` (the site's cart drawer, when it has none; `relocalize` puts an existing one in the site's language) and `app` (a built-in app plus the pages it needs), `global_attach` / `global_detach` (put an EXISTING shared section on the open page, or take it off) |
 | `sb_undo` | Put back what a PUT replaced. The SECOND answer for a page, not the only one: the platform has versions, history and restore (`sb_api_find` "page versions"), which outlive this process — reach for those first and use this for every other shaped PUT |
 
 Twenty-eight tools, **568 API operations** (195 of the 253 writes carrying a body shape read

package/README.vi.md

@@ -108,7 +108,7 @@ nhét ngược lại vào mọi bản cài.
 | `sb_import` | Đọc một trang từ URL công khai bất kỳ và thêm cấu trúc + nội dung của nó vào trang đang mở dưới dạng element thật, mang token của CHÍNH trang này — là dịch lại, không phải sao chép |
 | `sb_import_site` | Đọc CẢ website từ một URL — sitemap của nó, hoặc các link trên trang đó — và tạo cho mỗi trang tìm được một trang nháp riêng ở đây, dựng bằng token của site này; màu và thang chữ của trang gốc cũng được vá vào THEME của site này, nên đây không còn thuần là đọc |
 | `sb_theme` | Đọc hoặc vá bảng màu và thang chữ của site — tầng mà mọi style preset phân giải từ đó, nên một token thay áo cho mọi trang; `locale` đặt ngôn ngữ của site |
-| `sb_store` | Chạy một luồng cửa hàng bắt buộc đúng thứ tự — `checkout` (bốn lệnh ghi tạo nên trang thanh toán), `form` (một trong 17 template của nền tảng kèm field document của nó), `chrome` (một header hoặc footer dùng chung trên menu thật của site — menu desktop, drawer mobile, icon giỏ hàng và tài khoản), `menu` (một node menu bind vào menu của site, link đã phân giải), `overlay_attach` (một pop-up hay quick view trên trang đang mở), `cart` (ngăn giỏ hàng của site, khi chưa có), `app` (một app dựng sẵn kèm những trang nó cần), và `global_attach` / `global_detach` (đặt một section dùng chung ĐÃ CÓ lên trang đang mở, hoặc gỡ ra) |
+| `sb_store` | Chạy một luồng cửa hàng bắt buộc đúng thứ tự — `checkout` (bốn lệnh ghi tạo nên trang thanh toán), `form` (một trong 17 template của nền tảng kèm field document của nó), `chrome` (một header hoặc footer dùng chung trên menu thật của site — menu desktop, drawer mobile, icon giỏ hàng và tài khoản), `menu` (một node menu bind vào menu của site, link đã phân giải), `overlay_attach` (một pop-up hay quick view trên trang đang mở), `cart` (ngăn giỏ hàng của site, khi chưa có; `relocalize` đưa ngăn giỏ đã có về ngôn ngữ của site), `app` (một app dựng sẵn kèm những trang nó cần), và `global_attach` / `global_detach` (đặt một section dùng chung ĐÃ CÓ lên trang đang mở, hoặc gỡ ra) |
 | `sb_undo` | Trả lại thứ mà một lệnh PUT đã ghi đè. Với TRANG thì đây là đường về thứ hai chứ không phải duy nhất: nền tảng có version, history và restore (`sb_api_find` "page versions"), và chúng sống lâu hơn tiến trình này — hãy dùng chúng trước, còn tool này cho mọi PUT có hình dạng khác |
 
 Hai mươi tám tool, **568 operation API** (195 trong 253 lệnh ghi có hình dạng body đọc thẳng

package/dist/catalog/checkout.generated.js

@@ -70,7 +70,7 @@ export const CHECKOUT_FORM_DOCUMENT = {
                 "lineHeight": "130%",
                 "fontSize": "20px",
                 "fontWeight": "600",
-                "color": "#171717"
+                "color": "var(--wb-sc-heading, #171717)"
             },
             "config": {},
             "specials": {
@@ -902,7 +902,7 @@ export const FORM_TEMPLATES = {
                         "lineHeight": "130%",
                         "fontSize": "20px",
                         "fontWeight": "600",
-                        "color": "#171717"
+                        "color": "var(--wb-sc-heading, #171717)"
                     },
                     "config": {},
                     "specials": {
@@ -1168,7 +1168,7 @@ export const FORM_TEMPLATES = {
                         "lineHeight": "130%",
                         "fontSize": "20px",
                         "fontWeight": "600",
-                        "color": "#171717"
+                        "color": "var(--wb-sc-heading, #171717)"
                     },
                     "config": {},
                     "specials": {
@@ -1345,7 +1345,7 @@ export const FORM_TEMPLATES = {
                         "lineHeight": "130%",
                         "fontSize": "20px",
                         "fontWeight": "600",
-                        "color": "#171717"
+                        "color": "var(--wb-sc-heading, #171717)"
                     },
                     "config": {},
                     "specials": {
@@ -1745,7 +1745,7 @@ export const FORM_TEMPLATES = {
                         "lineHeight": "130%",
                         "fontSize": "20px",
                         "fontWeight": "600",
-                        "color": "#171717"
+                        "color": "var(--wb-sc-heading, #171717)"
                     },
                     "config": {},
                     "specials": {
@@ -2255,7 +2255,7 @@ export const FORM_TEMPLATES = {
                         "lineHeight": "130%",
                         "fontSize": "20px",
                         "fontWeight": "600",
-                        "color": "#171717"
+                        "color": "var(--wb-sc-heading, #171717)"
                     },
                     "config": {},
                     "specials": {
@@ -2627,7 +2627,7 @@ export const FORM_TEMPLATES = {
                         "lineHeight": "130%",
                         "fontSize": "20px",
                         "fontWeight": "600",
-                        "color": "#171717"
+                        "color": "var(--wb-sc-heading, #171717)"
                     },
                     "config": {},
                     "specials": {
@@ -2993,7 +2993,7 @@ export const FORM_TEMPLATES = {
                         "lineHeight": "130%",
                         "fontSize": "20px",
                         "fontWeight": "600",
-                        "color": "#171717"
+                        "color": "var(--wb-sc-heading, #171717)"
                     },
                     "config": {},
                     "specials": {
@@ -3248,7 +3248,7 @@ export const FORM_TEMPLATES = {
                         "lineHeight": "130%",
                         "fontSize": "20px",
                         "fontWeight": "600",
-                        "color": "#171717"
+                        "color": "var(--wb-sc-heading, #171717)"
                     },
                     "config": {},
                     "specials": {
@@ -3547,7 +3547,7 @@ export const FORM_TEMPLATES = {
                         "lineHeight": "130%",
                         "fontSize": "20px",
                         "fontWeight": "600",
-                        "color": "#171717"
+                        "color": "var(--wb-sc-heading, #171717)"
                     },
                     "config": {},
                     "specials": {
@@ -3914,7 +3914,7 @@ export const FORM_TEMPLATES = {
                         "lineHeight": "130%",
                         "fontSize": "20px",
                         "fontWeight": "600",
-                        "color": "#171717"
+                        "color": "var(--wb-sc-heading, #171717)"
                     },
                     "config": {},
                     "specials": {
@@ -4138,7 +4138,7 @@ export const FORM_TEMPLATES = {
                         "lineHeight": "130%",
                         "fontSize": "20px",
                         "fontWeight": "600",
-                        "color": "#171717"
+                        "color": "var(--wb-sc-heading, #171717)"
                     },
                     "config": {},
                     "specials": {
@@ -4401,7 +4401,7 @@ export const FORM_TEMPLATES = {
                         "lineHeight": "130%",
                         "fontSize": "20px",
                         "fontWeight": "600",
-                        "color": "#171717"
+                        "color": "var(--wb-sc-heading, #171717)"
                     },
                     "config": {},
                     "specials": {
@@ -4670,7 +4670,7 @@ export const FORM_TEMPLATES = {
                         "lineHeight": "130%",
                         "fontSize": "20px",
                         "fontWeight": "600",
-                        "color": "#171717"
+                        "color": "var(--wb-sc-heading, #171717)"
                     },
                     "config": {},
                     "specials": {
@@ -4969,7 +4969,7 @@ export const FORM_TEMPLATES = {
                         "lineHeight": "130%",
                         "fontSize": "20px",
                         "fontWeight": "600",
-                        "color": "#171717"
+                        "color": "var(--wb-sc-heading, #171717)"
                     },
                     "config": {},
                     "specials": {
@@ -5216,7 +5216,7 @@ export const FORM_TEMPLATES = {
                         "lineHeight": "130%",
                         "fontSize": "20px",
                         "fontWeight": "600",
-                        "color": "#171717"
+                        "color": "var(--wb-sc-heading, #171717)"
                     },
                     "config": {},
                     "specials": {
@@ -5511,7 +5511,7 @@ export const FORM_TEMPLATES = {
                         "lineHeight": "130%",
                         "fontSize": "20px",
                         "fontWeight": "600",
-                        "color": "#171717"
+                        "color": "var(--wb-sc-heading, #171717)"
                     },
                     "config": {},
                     "specials": {
@@ -5686,7 +5686,7 @@ export const FORM_TEMPLATES = {
                         "lineHeight": "130%",
                         "fontSize": "20px",
                         "fontWeight": "600",
-                        "color": "#171717"
+                        "color": "var(--wb-sc-heading, #171717)"
                     },
                     "config": {},
                     "specials": {
@@ -5874,7 +5874,7 @@ export const FORM_TEMPLATES = {
                         "lineHeight": "130%",
                         "fontSize": "20px",
                         "fontWeight": "600",
-                        "color": "#171717"
+                        "color": "var(--wb-sc-heading, #171717)"
                     },
                     "config": {},
                     "specials": {

package/dist/catalog/deadkeys.generated.js

@@ -1,6 +1,6 @@
 export const DEAD_KEY_SOURCE = {
     "files": 4426,
-    "identifiers": 83749,
+    "identifiers": 83752,
     "seededKeys": 436,
     "dead": 0
 };

package/dist/catalog/elements.generated.js

@@ -9376,7 +9376,7 @@ export const ELEMENTS = {
                 "lineHeight": "130%",
                 "fontSize": "20px",
                 "fontWeight": "600",
-                "color": "#171717"
+                "color": "var(--wb-sc-heading, #171717)"
             }
         },
         "inspector": [
@@ -13819,7 +13819,7 @@ export const ELEMENTS = {
             "states": {
                 "hover": {
                     "style": {
-                        "color": "#676767"
+                        "color": "var(--wb-sc-text, #676767)"
                     }
                 }
             }
@@ -13942,7 +13942,7 @@ export const ELEMENTS = {
         "contentTips": [
             "this skin carries no text of its own — labels come from the menu data",
             "Default and Hover are separate state slots; edit Hover with the State switcher",
-            "the default look is the theme link colour (ink #171717 on a default theme) and the text-2 font, with a #676767 hover"
+            "the default look is the theme link colour (ink #171717 on a default theme) and the text-2 font, with a hover in the theme body-text colour"
         ],
         "semantics": [
             "menu-item",
@@ -14834,8 +14834,8 @@ export const ELEMENTS = {
                 "paddingLeft": "6px",
                 "paddingRight": "6px",
                 "borderRadius": "999px",
-                "backgroundColor": "#171717",
-                "color": "#ffffff",
+                "backgroundColor": "var(--wb-sc-buttonBg, #171717)",
+                "color": "var(--wb-sc-buttonText, #ffffff)",
                 "fontSize": "12px",
                 "fontWeight": "600",
                 "lineHeight": "1"
@@ -26460,8 +26460,8 @@ export const ELEMENTS = {
                 "height": "fit-content",
                 "padding": "2px 8px",
                 "borderRadius": "4px",
-                "backgroundColor": "#171717",
-                "color": "#ffffff",
+                "backgroundColor": "var(--wb-sc-buttonBg, #171717)",
+                "color": "var(--wb-sc-buttonText, #ffffff)",
                 "fontSize": "12px",
                 "fontWeight": "600",
                 "lineHeight": "1"

package/dist/catalog/source.generated.js

@@ -1,7 +1,7 @@
 // GENERATED by scripts/gen-catalog.ts — do not edit by hand.
 // The platform commit every other generated file here describes.
 export const PLATFORM_SOURCE = {
-    "commit": "eb36ffb27d036e14093aa524c3179f4d1d193d77",
-    "committedAt": "2026-09-25T21:24:32+07:00",
+    "commit": "2fba72c10b84e624cb05709f9759bba93d36dbec",
+    "committedAt": "2026-09-25T22:15:50+07:00",
     "dirty": false
 };

package/dist/catalog/storepages.generated.js

@@ -3100,7 +3100,7 @@ export const STORE_PAGE_SEEDS = {
                             "alt": ""
                         }
                     ],
-                    "layout": "bottom",
+                    "layout": "single",
                     "activeIndex": 0
                 },
                 "specials": {},
@@ -3812,7 +3812,7 @@ export const STORE_PAGE_SEEDS = {
                             "alt": ""
                         }
                     ],
-                    "layout": "bottom",
+                    "layout": "single",
                     "activeIndex": 0
                 },
                 "specials": {},

package/dist/domains/site/cartlang.js

@@ -0,0 +1,58 @@
+import { walk } from '../../core/tree.js';
+import { CART_SEEDS } from '../../catalog/overlays.generated.js';
+/**
+ * A CART DRAWER IN ANOTHER LANGUAGE THAN ITS SITE. A store made before the
+ * per-locale seed keeps "Your cart" / "Checkout" / "Your cart is empty" on a
+ * Vietnamese site, and nothing on the page says so. Only strings EXACTLY equal
+ * to another locale's seed word count — anything else is the merchant's text.
+ */
+const KEYS = ['text', 'label', 'emptyText'];
+/** The seed a site's `settings.locale` picks: primary subtag, `en` when there is none. */
+export function cartSeedLocale(locale) {
+    const l = String(locale ?? '').toLowerCase().split('-')[0];
+    return Object.hasOwn(CART_SEEDS, l) ? l : 'en';
+}
+const order = (d) => {
+    const out = [];
+    walk(d, d.root_node_id, (n) => out.push(n));
+    return out;
+};
+/**
+ * `key \0 other-locale word` → the site-locale word, by pairing each other
+ * seed's nodes with the target seed's in walk order (same seed shape, so the
+ * same position is the same word). A pair whose types differ is skipped.
+ */
+function seedWords(to) {
+    const target = order(CART_SEEDS[to]);
+    const out = new Map();
+    for (const [l, seed] of Object.entries(CART_SEEDS)) {
+        if (l === to)
+            continue;
+        order(seed).forEach((n, i) => {
+            const t = target[i];
+            if (!t || t.data.type !== n.data.type)
+                return;
+            for (const k of KEYS) {
+                const a = n.specials?.[k];
+                const b = t.specials?.[k];
+                if (typeof a === 'string' && typeof b === 'string' && a !== b)
+                    out.set(`${k}\0${a}`, b);
+            }
+        });
+    }
+    return out;
+}
+/** Every seed word under `rootId` that belongs to a locale other than `locale`'s seed. */
+export function cartRelocalize(doc, rootId, locale) {
+    const words = seedWords(locale);
+    const out = [];
+    walk(doc, rootId, (n) => {
+        for (const key of KEYS) {
+            const from = n.specials?.[key];
+            const to = typeof from === 'string' ? words.get(`${key}\0${from}`) : undefined;
+            if (to !== undefined)
+                out.push({ node_id: n.id, key, from: from, to });
+        }
+    });
+    return out;
+}

package/dist/domains/site/readiness-fetch.js

@@ -62,6 +62,8 @@ export async function gatherReadiness(ctx, siteId, pageNodes, openPageId) {
         get(`/api/sites/${site}`),
         // THE OVERLAYS, for the one a cart control opens: no `cart` overlay means
         // every `open_cart` on the site opens nothing.
+        // The list ships each overlay's FULL document (overlays/rest/rest.go), so the
+        // cart drawer's words are read here too — see cartDrawerLanguage.
         get(`/api/sites/${site}/overlays`),
         // `<html lang>` is served from this; see siteLanguage in readiness.ts.
         get(`/api/sites/${site}/settings`),
@@ -116,6 +118,9 @@ export async function gatherReadiness(ctx, siteId, pageNodes, openPageId) {
         pageNodes,
         globalNodes,
         globalKinds,
+        cartOverlay: Array.isArray(overlayList?.overlays)
+            ? (overlayList.overlays.find((o) => o.kind === 'cart')?.document ?? null)
+            : null,
         overlayKinds: Array.isArray(overlayList?.overlays) ? overlayList.overlays.map((o) => o.kind ?? '') : null,
         categories,
         categoryPageLinks,

package/dist/domains/site/readiness.js

@@ -16,6 +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';
 /** 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. */
@@ -262,6 +263,23 @@ export function readinessGaps(input) {
                 : `Create a page of type "${type}" and publish it.`,
         });
     }
+    // A CART DRAWER IN ANOTHER LANGUAGE. Asked before the store gate: a drawer
+    // that exists is shown on every page, whatever this page sells.
+    if (input.siteLocale && input.cartOverlay?.root_node_id) {
+        const locale = cartSeedLocale(input.siteLocale);
+        const changes = cartRelocalize(input.cartOverlay, input.cartOverlay.root_node_id, locale);
+        if (changes.length > 0) {
+            gaps.push({
+                id: 'cartDrawerLanguage',
+                draft: false,
+                problem: `The site's locale is "${input.siteLocale}", but the cart drawer still carries another ` +
+                    `language's seed words: ${[...new Set(changes.map((c) => `"${c.from}"`))].join(', ')}. ` +
+                    'Every page shows it.',
+                fix: 'Open any page of this site, then sb_store action:"cart" relocalize:true dry_run:false — it ' +
+                    `rewrites exactly those seed strings to the "${locale}" seed's, and leaves edited text alone.`,
+            });
+        }
+    }
     if (!isStore(input))
         return gaps;
     if (pages && !published(pages, 'checkout')) {

package/dist/live/session.js

@@ -231,6 +231,13 @@ export class LiveSession {
                 }
                 break;
             }
+            case 'global':
+            case 'overlay': {
+                const id = e.t === 'global' ? e.globalId : e.overlayId;
+                if (typeof id === 'string' && id)
+                    this.opts.onMaster?.(e.t, id, String(e.op ?? ''), Number(e.rev ?? 0));
+                break;
+            }
             case 'snapreq':
                 // THE YIELD RULE. Never answered. Sending a snapshot would make this
                 // client an authority on the document — exactly the position it declines

package/dist/tools/live.js

@@ -260,6 +260,7 @@ export function joinRoom(ctx, session, siteId) {
         onRemote: (patches) => session.applyRemote(patches),
         onDesync: (reason) => session.markStale(reason),
         onSource: (pageId, rev, peerId) => session.sourceSaved(pageId, rev, peerId),
+        onMaster: (kind, id, op, rev) => session.masterSaved(kind, id, op, rev),
     });
     socket.connect();
     session.attachLive(live, siteId);

package/dist/tools/overlay.js

@@ -57,6 +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';
 const KIND_NAME = {
     popup: 'Pop-up',
     quickview: 'Quick view',
@@ -306,12 +307,18 @@ export async function ensureCartDrawer(ctx, session, siteId, dryRun) {
     }).catch(() => null));
     const locale = String(settings?.settings?.locale ?? '').toLowerCase().split('-')[0];
     const seedLocale = Object.hasOwn(CART_SEEDS, locale) ? locale : 'en';
+    const languageNote = seedLocale === locale
+        ? undefined
+        : settings === null
+            ? 'The site settings could not be read, so the drawer is in English — edit its words if the store is not.'
+            : `settings.locale is ${locale ? `"${locale}", which has no seed` : 'unset'}, so the drawer is in English — set it with sb_theme locale first if the store is not.`;
     const seed = CART_SEEDS[seedLocale] ?? OVERLAY_SEEDS.cart;
     const body = { kind: 'cart', name: 'Cart', document: withFreshIds(seed) };
     if (dryRun) {
         return {
             dry_run: true,
             language: seedLocale,
+            ...(languageNote ? { language_note: languageNote } : {}),
             plan: redact([{ step: 1, what: 'create the site\'s cart drawer', method: 'POST', path, body }]),
             note: 'Nothing was sent. Re-call with dry_run:false to create it; it shows on every page.',
         };
@@ -332,7 +339,65 @@ export async function ensureCartDrawer(ctx, session, siteId, dryRun) {
         overlay_id: made.overlay.id,
         created: true,
         language: seedLocale,
+        ...(languageNote ? { language_note: languageNote } : {}),
         ...(nodeId ? { node_id: nodeId } : {}),
         next: 'Publish the pages: the drawer reaches a shopper through each published page.',
     };
 }
+/**
+ * `sb_store action:"cart" relocalize:true` — PUT THE SITE'S LANGUAGE ON AN
+ * EXISTING DRAWER. Rewrites only strings EXACTLY equal to another locale's seed
+ * word, node ids and styles untouched.
+ *
+ * THROUGH THE PAGE SAVE, never the overlays API: `PATCH /overlays/{id}` ignores
+ * a `document` and answers 200, and there is no document PUT — the page save
+ * carries the composed drawer and the page context decomposes it into the
+ * master (overlays/rest/rest.go). So a real run needs a page of this site open.
+ */
+export async function relocalizeCartDrawer(ctx, session, siteId, dryRun) {
+    const site = encodeURIComponent(siteId);
+    const get = (path) => request({ base: ctx.base, method: 'GET', path, token: siteToken(ctx), fetchImpl: ctx.fetchImpl });
+    const listed = (await get(`/api/sites/${site}/overlays`));
+    const cart = (listed.overlays ?? []).find((o) => o.kind === 'cart');
+    if (!cart?.id)
+        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);
+    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)
+        : cart.document?.root_node_id
+            ? cartRelocalize(cart.document, cart.document.root_node_id, language)
+            : [];
+    if (dryRun || changes.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.' }
+                : {
+                    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` }]),
+                    note: 'Nothing was sent. Re-call with dry_run:false; it writes through the open page\'s save.',
+                }),
+        };
+    }
+    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 })));
+    return {
+        overlay_id: cart.id,
+        language,
+        changes,
+        next: 'Publish the pages: the drawer reaches a shopper through each published page.',
+    };
+}

package/dist/tools/page.js

@@ -17,7 +17,8 @@ import { animationNote, deadKeyNote, unknownValueNote, unknownWriteNote, precond
 import { skinLevelNote } from '../domains/site/fieldskin.js';
 import { siteTheme } from '../domains/site/theme-fetch.js';
 import { ensureSiteTheme } from './theme.js';
-import { request, redact, watchPageWrites, onPageSourceWrite } from '../transport/http.js';
+import { request, redact, watchPageWrites, onPageSourceWrite, onGlobalWrite } from '../transport/http.js';
+import { SPEC_GLOBAL_ID, SPEC_GLOBAL_REV, SPEC_OVERLAY_ID, SPEC_OVERLAY_REV } from '../core/tree.js';
 import { siteToken } from './credentialpick.js';
 import { validateForSave } from '../domains/site/validate.js';
 import { reviewDesign, REVIEW_NOTICE } from '../domains/site/review.js';
@@ -112,6 +113,41 @@ export class PageSession {
             if (doc !== this.doc?.doc && this.isOpen(site, page))
                 this.markStale('the page was written by another call');
         });
+        onGlobalWrite((site, id) => {
+            if (this.siteId === site && this.composedMaster('global', id)) {
+                this.markStale(`shared section ${id} was written by another call`);
+            }
+        });
+    }
+    /** The node this copy composed from that master (stamped `globalId` / `overlayId`), if any. */
+    composedMaster(kind, id) {
+        if (!this.doc)
+            return undefined;
+        const stamp = kind === 'global' ? SPEC_GLOBAL_ID : SPEC_OVERLAY_ID;
+        return Object.values(this.doc.doc.nodes).find((n) => n.specials?.[stamp] === id);
+    }
+    /**
+     * A shared master was saved or deleted (the room's `global` / `overlay`
+     * frame). Past the rev this copy composed — or re-stamped from its OWN save,
+     * whose echo this is otherwise — the copy is stale: the yield rule, the next
+     * write re-pulls first. `meta` is a rename, and moves no content. Judged
+     * after any save in flight, whose re-stamp carries the new rev.
+     */
+    masterSaved(kind, id, op, rev) {
+        if (op === 'meta')
+            return;
+        const check = () => {
+            const n = this.composedMaster(kind, id);
+            if (!n || this.siteId !== this.liveSite)
+                return;
+            const had = Number(n.specials?.[kind === 'global' ? SPEC_GLOBAL_REV : SPEC_OVERLAY_REV] ?? 0);
+            if (op === 'deleted' || rev > had)
+                this.markStale(`${kind} ${id} was ${op} elsewhere (rev ${rev})`);
+        };
+        if (this.saving)
+            void this.saving.then(check, check);
+        else
+            check();
     }
     /**
      * ONE ROOM AT A TIME. A second join (sb_live_join again, or a page on another

package/dist/tools/store.js

@@ -44,7 +44,7 @@ import { siteChrome, wearChrome } from './page.js';
 import { addSubtree } from '../domains/site/builder.js';
 import { attachGlobal, buildChrome, detachGlobal } from './chrome.js';
 import { bindMenu } from './menu.js';
-import { attachOverlay, ensureCartDrawer } from './overlay.js';
+import { attachOverlay, ensureCartDrawer, relocalizeCartDrawer } from './overlay.js';
 import { installApp } from './app.js';
 import { BUILTIN_APP_KEYS } from '../catalog/appscaffolds.generated.js';
 import { ELEMENTS } from '../catalog/elements.generated.js';
@@ -436,10 +436,15 @@ export function registerStoreTools(server, ctx, session) {
                 .optional()
                 .describe('action:"global_attach"/"global_detach" — the shared section; omitted on attach it ' +
                 'lists the site\'s own'),
+            relocalize: z
+                .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'),
             dry_run: z.boolean().optional(),
         },
         annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
-    }, async ({ action, site_id: given, language, page_name, headline, template, name, footer, node_id, menu_id, kind, overlay_id, list_id, app_key, global_id, dry_run, }) => {
+    }, async ({ action, site_id: given, language, page_name, headline, template, name, footer, node_id, menu_id, kind, overlay_id, list_id, app_key, global_id, relocalize, dry_run, }) => {
         const siteId = siteFor(ctx, given);
         if (action === 'global_attach' || action === 'global_detach') {
             // THE COMPOSED STAMP IS NEVER THE CALLER'S TO WRITE. A page references
@@ -498,7 +503,8 @@ export function registerStoreTools(server, ctx, session) {
             }));
         }
         if (action === 'cart') {
-            return text(await ensureCartDrawer(ctx, session, siteId, dry_run !== false));
+            const run = relocalize === true ? relocalizeCartDrawer : ensureCartDrawer;
+            return text(await run(ctx, session, siteId, dry_run !== false));
         }
         if (action === 'chrome') {
             return text(await buildChrome(ctx, session, siteId, footer === true ? 'footer' : 'header', {

package/dist/transport/http.js

@@ -134,6 +134,14 @@ export function onPageSourceWrite(fn) {
         sourceWritten.delete(fn);
     };
 }
+const globalWritten = new Set();
+export function onGlobalWrite(fn) {
+    globalWritten.add(fn);
+    return () => {
+        globalWritten.delete(fn);
+    };
+}
+const GLOBAL_WRITE = /^\/api\/sites\/([^/]+)\/global-sections\/([^/]+)(?:\/document)?$/;
 const SOURCE_WRITE = /^\/api\/sites\/([^/]+)\/pages\/([^/]+)\/source$/;
 /**
  * A restore replaces the draft ON THE PLATFORM with no document in the body —
@@ -151,6 +159,13 @@ const SOURCE_RESTORE = /^\/api\/sites\/([^/]+)\/pages\/([^/]+)\/(?:versions|hist
  * peer is on that page) and published as node-level ops.
  */
 export async function request(opts) {
+    const global = opts.method !== 'GET' ? GLOBAL_WRITE.exec(opts.path) : null;
+    if (global) {
+        const out = await send(opts);
+        for (const fn of globalWritten)
+            fn(decodeURIComponent(global[1]), decodeURIComponent(global[2]));
+        return out;
+    }
     const restore = opts.method === 'POST' ? SOURCE_RESTORE.exec(opts.path) : null;
     if (restore) {
         const out = await send(opts);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sbuilder-mcp",
-  "version": "0.66.1",
+  "version": "0.67.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",