sbuilder-mcp 0.5.0 → 0.6.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.6.0] - 2026-09-08
+
+### Added
+- sb_store now takes action:"form" alongside action:"checkout", seeding any of the platform's 17 form templates (contact, subscribe, order, address, consult, booking, stay, feedback, event, quote, apply, and the five auth forms login, register, forgot, verify, reset) with their own field document, instead of the checkout order form being the only one this server could build; it creates the form, PUTs it back whole (a bare create is otherwise silently renamed and turned custom), then saves the template's field document, deleting the form again if either write fails. It makes no page, since where a login form belongs is a design decision — place it with sb_add and point specials.formId at the id returned.
+
+### Fixed
+- sb_review no longer reports empty_container on a global section's or app block's reference node, since a page stores its shared header or footer as an empty node stamped globalRef or appBlockRef that the platform composes the master into on read; the fix the finding used to name, adding something inside it, was decomposed away by the very next save.
+
 ## [0.5.0] - 2026-09-08
 
 ### 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.6.0] - 2026-09-08
+
+### Added
+- sb_store giờ nhận action:"form" bên cạnh action:"checkout", gieo bất kỳ template nào trong 17 template form của nền tảng (contact, subscribe, order, address, consult, booking, stay, feedback, event, quote, apply, và năm form xác thực login, register, forgot, verify, reset) cùng field document riêng của nó, thay vì trước đây server này chỉ dựng được đúng order form của checkout; nó tạo form, PUT lại nguyên vẹn (nếu không thì một lần tạo đơn thuần sẽ bị âm thầm đổi tên và chuyển thành custom), rồi lưu field document của template, và xoá lại form nếu một trong hai lệnh ghi đó thất bại. Nó không tạo trang, vì đặt form login ở đâu là quyết định thiết kế — hãy đặt form bằng sb_add rồi trỏ specials.formId vào id được trả về.
+
+### Fixed
+- sb_review không còn báo cáo empty_container trên node tham chiếu của một global section hay app block, vì một trang lưu header hoặc footer dùng chung dưới dạng node rỗng gắn cờ globalRef hoặc appBlockRef mà nền tảng sẽ ghép bản gốc vào khi đọc; cách sửa mà finding này từng nêu ra — thêm gì đó vào bên trong — sẽ bị lần lưu kế tiếp phân rã mất ngay.
+
 ## [0.5.0] - 2026-09-08
 
 ### Added

package/README.md

@@ -98,7 +98,7 @@ make, because those mean "this person's account".
 | `sb_look` | Save, render, and return screenshots plus measured node boxes and layout defects measured on the render |
 | `sb_event` | Give a node a click action — open the cart, go to a page, open a pop-up |
 | `sb_bind` | Bind a node's content to real store data, or make a button add to the cart |
-| `sb_store` | Run a store flow that must happen in a fixed order — today, the four writes that make a working checkout |
+| `sb_store` | Run a store flow that must happen in a fixed order — the four writes that make a working checkout, or any of the platform's 17 form templates (login, register, forgot, contact, subscribe …) with its own field document |
 | `sb_undo` | Put back what a PUT replaced — the platform has no page history or restore, so this is the only way back |
 
 Twenty-eight tools, **484 API operations** (158 of the 212 writes carrying a body shape read

package/README.vi.md

@@ -95,7 +95,7 @@ là "tài khoản của người này".
 | `sb_look` | Lưu, render, trả về ảnh chụp kèm box đo được của node và lỗi bố cục đo trên bản render |
 | `sb_event` | Gắn click action cho một node — mở giỏ, sang trang, mở pop-up |
 | `sb_bind` | Gắn nội dung một node vào dữ liệu cửa hàng thật, hoặc biến một nút thành nút thêm vào giỏ |
-| `sb_store` | Chạy một luồng cửa hàng bắt buộc đúng thứ tự — hiện là bốn lệnh ghi tạo nên một trang thanh toán hoạt động |
+| `sb_store` | Chạy một luồng cửa hàng bắt buộc đúng thứ tự — bốn lệnh ghi tạo nên trang thanh toán, hoặc gieo bất kỳ template nào trong 17 form của nền tảng (login, register, forgot, contact, subscribe …) kèm field document của nó |
 | `sb_undo` | Trả lại thứ mà một lệnh PUT đã ghi đè — nền tảng không có lịch sử trang hay restore, nên đây là đường về duy nhất |
 
 Hai mươi tám tool, **484 operation API** (158 trong 212 lệnh ghi có hình dạng body đọc thẳng

package/dist/catalog/api.generated.js

@@ -1,6 +1,6 @@
 export const SWAGGER_SOURCE = {
-    "operations": 484,
-    "definitions": 99,
+    "operations": 485,
+    "definitions": 102,
     "bodyCarrying": 171,
     "bodyUndescribed": 62,
     "generatedFrom": "server/docs/swagger.json"
@@ -10646,6 +10646,34 @@ export const API_OPERATIONS = [
         "bodyRef": null,
         "credential": "siteScoped"
     },
+    {
+        "id": "get:/api/sites/{siteId}/relation-slots/usage",
+        "method": "GET",
+        "path": "/api/sites/{siteId}/relation-slots/usage",
+        "tags": [
+            "relations"
+        ],
+        "summary": "How many curated shelves reference an item",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "itemId",
+                "in": "query",
+                "required": true,
+                "type": "string",
+                "description": "Product or article id"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
     {
         "id": "post:/api/sites/{siteId}/restore",
         "method": "POST",
@@ -15482,6 +15510,36 @@ export const API_DEFINITIONS = {
             }
         }
     },
+    "github_com_webbuilder_server_internal_products.BundleItem": {
+        "type": "object",
+        "properties": {
+            "position": {
+                "description": "Position is the merchant's arrangement — the order the components are\nlisted on the product page.",
+                "type": "integer"
+            },
+            "productId": {
+                "type": "string"
+            },
+            "quantity": {
+                "description": "Quantity is how many units of the component one combo contains (≥ 1).",
+                "type": "integer"
+            },
+            "variantId": {
+                "type": "string"
+            }
+        }
+    },
+    "github_com_webbuilder_server_internal_products.BundlePricing": {
+        "type": "string",
+        "enum": [
+            "fixed",
+            "percent"
+        ],
+        "x-enum-varnames": [
+            "BundlePricingFixed",
+            "BundlePricingPercent"
+        ]
+    },
     "github_com_webbuilder_server_internal_products.MetaTag": {
         "type": "object",
         "properties": {
@@ -15533,6 +15591,24 @@ export const API_DEFINITIONS = {
             "brand": {
                 "type": "string"
             },
+            "bundleItems": {
+                "description": "BundleItems is what one combo contains. Empty on every simple product, and\non a combo a merchant has not finished building — which is authorable but\nnot sellable (ApplyBundleTotals).",
+                "type": "array",
+                "items": {
+                    "$ref": "#/definitions/github_com_webbuilder_server_internal_products.BundleItem"
+                }
+            },
+            "bundlePricing": {
+                "description": "BundlePricing and BundleValue are how a combo is priced: a flat price in\ncents (\"fixed\") or a percentage off the components' total (\"percent\",\n0–100). The two share one Value field for the reason discounts.Discount\ndoes — the unit is a function of the mode, and two fields would let a\nmerchant leave the unused one holding a number that means nothing.\n\nBoth are ignored (and cleared) on a simple product.",
+                "allOf": [
+                    {
+                        "$ref": "#/definitions/github_com_webbuilder_server_internal_products.BundlePricing"
+                    }
+                ]
+            },
+            "bundleValue": {
+                "type": "integer"
+            },
             "compareAtCents": {
                 "description": "CompareAt of the min-price visible variant; 0 = none",
                 "type": "integer"
@@ -15558,6 +15634,14 @@ export const API_DEFINITIONS = {
                     "type": "string"
                 }
             },
+            "kind": {
+                "description": "Kind says whether this is an ordinary product or a COMBO whose price and\navailability are derived from the components in BundleItems. Absent on the\nwire means simple — see bundle.go, which owns every rule below.",
+                "allOf": [
+                    {
+                        "$ref": "#/definitions/github_com_webbuilder_server_internal_products.ProductKind"
+                    }
+                ]
+            },
             "moneyOverride": {
                 "description": "MoneyOverride is an opaque per-product money-display override (compact-convert\nrules + exchange-rate overrides), stored as a JSONB blob. The domain keeps it\nopaque — it is decoded at the render boundary (bindings.ProductSource →\nrender.ProductData) — so products stays decoupled from render/money, the same\nway the site settings document is an opaque blob. Empty ({}/null) → no override.",
                 "type": "array",
@@ -15694,6 +15778,17 @@ export const API_DEFINITIONS = {
             }
         }
     },
+    "github_com_webbuilder_server_internal_products.ProductKind": {
+        "type": "string",
+        "enum": [
+            "simple",
+            "bundle"
+        ],
+        "x-enum-varnames": [
+            "ProductKindSimple",
+            "ProductKindBundle"
+        ]
+    },
     "github_com_webbuilder_server_internal_products.ProductStatus": {
         "type": "string",
         "enum": [