sbuilder-mcp 0.68.0 → 0.70.0

package/CHANGELOG.md

@@ -6,6 +6,27 @@ 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
+- `sb_store` gains action `checkout_sync`, which re-reads a store's current payment gateways and shipping methods into every existing order form (keeping each method's own label) and republishes the checkout pages, for when a gateway or shipping method is added after the checkout was built and the form's select is left pointing at stale options.
+
+### Changed
+- The generated catalog was regenerated against the platform (`web_builder` `a3a735283`): a cart-line's image now catalogs as a single thumbnail instead of a bottom strip, and a category's derived `slug` is now catalogued.
+
+### Fixed
+- The catalog generator was dropping every Go field that carried a trailing line comment, silently hiding `slug`, `parentId`, and `position` on categories and `description`, `images`, `attributes`, and `variants[].priceCents` on products from the catalog; `sb_api_find` also now reports a described body for `POST /api/sites` instead of `undescribed`.
+- `sb_media_upload` and the store's own upload path now read the uploaded file's URL from the response's top-level `url` when the asset entry itself carries none, instead of reporting every successful upload as having no URL.
+- `sb_store` action `chrome` now builds a footer whenever its columns carry two or more links in total, instead of skipping it whenever every individual column holds fewer than two — a footer with two columns of one link each was rendered empty.
+
 ## [0.68.0] - 2026-09-25
 
 ### Changed

package/CHANGELOG.vi.md

@@ -6,6 +6,27 @@ 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
+- `sb_store` có thêm action `checkout_sync`, đọc lại các cổng thanh toán và phương thức giao hàng hiện tại của store rồi ghi vào mọi order form đang có (giữ nguyên label riêng của từng phương thức) và republish lại các trang checkout, dùng cho trường hợp một gateway hay phương thức giao hàng được thêm sau khi checkout đã được dựng, khiến select trong form vẫn trỏ vào các tùy chọn cũ.
+
+### Changed
+- Catalog được sinh ra đã được làm mới dựa trên nền tảng (`web_builder` `a3a735283`): ảnh của cart line giờ được catalog là một thumbnail duy nhất thay vì một dải ảnh phía dưới, và `slug` suy ra của category giờ cũng được catalog.
+
+### Fixed
+- Bộ sinh catalog trước đây bỏ rơi mọi field Go có comment cuối dòng, âm thầm làm mất `slug`, `parentId`, `position` của category và `description`, `images`, `attributes`, `variants[].priceCents` của product khỏi catalog; `sb_api_find` giờ cũng báo body của `POST /api/sites` là "described" thay vì "undescribed".
+- `sb_media_upload` và đường upload riêng của store giờ đọc URL của file đã tải lên từ trường `url` ở cấp cao nhất của response khi bản thân asset không mang URL, thay vì báo mọi lần upload thành công là không có URL.
+- Action `chrome` của `sb_store` giờ dựng footer bất cứ khi nào tổng số link trên các cột đạt từ hai trở lên, thay vì bỏ qua khi mỗi cột riêng lẻ có ít hơn hai link — một footer có hai cột mỗi cột một link trước đây bị dựng trống.
+
 ## [0.68.0] - 2026-09-25
 
 ### Changed

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; `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_store` | Run a store flow that must happen in a fixed order — `checkout` (the four writes that make a working one), `checkout_sync` (the store's current payment and delivery methods into every existing order form, checkout page republished), `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, **574 API operations** (197 of the 255 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ó; `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_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), `checkout_sync` (đưa phương thức thanh toán và giao hàng hiện tại vào mọi form đặt hàng đã có, publish lại 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, **574 operation API** (197 trong 255 lệnh ghi có hình dạng body đọc thẳng

package/dist/catalog/api.generated.js

@@ -18953,7 +18953,7 @@ export const API_DEFINITIONS = {
                 "type": "string"
             },
             "slug": {
-                "description": "unique per (siteId, slug) within its own type",
+                "description": "unique per (siteId, slug) within its own type; derived from Name when empty on create",
                 "type": "string"
             },
             "updatedAt": {

package/dist/catalog/deadkeys.generated.js

@@ -1,6 +1,6 @@
 export const DEAD_KEY_SOURCE = {
     "files": 4486,
-    "identifiers": 84430,
+    "identifiers": 84432,
     "seededKeys": 442,
     "dead": 0
 };

package/dist/catalog/overlays.generated.js

@@ -277,7 +277,7 @@ export const OVERLAY_SEEDS = {
                             "alt": ""
                         }
                     ],
-                    "layout": "bottom",
+                    "layout": "single",
                     "activeIndex": 0
                 },
                 "specials": {},
@@ -2317,7 +2317,7 @@ export const CART_SEEDS = {
                             "alt": ""
                         }
                     ],
-                    "layout": "bottom",
+                    "layout": "single",
                     "activeIndex": 0
                 },
                 "specials": {},
@@ -3151,7 +3151,7 @@ export const CART_SEEDS = {
                             "alt": ""
                         }
                     ],
-                    "layout": "bottom",
+                    "layout": "single",
                     "activeIndex": 0
                 },
                 "specials": {},

package/dist/catalog/search.js

@@ -458,7 +458,11 @@ export function summarizeOperation(op) {
         out.summary_shared = true;
     // A copied body is not this route's, so the line says nothing rather than
     // `described` — see `copiedBodyDonor`.
-    if (hasBody && !copiedBodyDonor(op.id))
+    // The handler's own decode outranks the document, as it does on the call sheet;
+    // without this the line said `undescribed` for a body the sheet then described.
+    if (REQUEST_SHAPES[op.id])
+        out.body = 'described';
+    else if (hasBody && !copiedBodyDonor(op.id))
         out.body = op.bodyDescribed && op.bodyRef ? 'described' : 'undescribed';
     else if (isWrite)
         out.body = 'none_declared';