sbuilder-mcp 0.70.0 → 0.72.0

package/CHANGELOG.md

@@ -6,6 +6,21 @@ 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.72.0] - 2026-09-28
+
+### Added
+- `sb_review` gains a `pageSeo` readiness gap: it lists published page, about, contact, policy, faq, and blog pages missing `settings.title` or `settings.description`, since the storefront falls back to the site name as `<title>` and drops the meta description entirely when either is unset, leaving every such page indistinguishable in a search result even though nothing on the canvas or in a screenshot shows it.
+
+## [0.71.0] - 2026-09-28
+
+### Added
+- `sb_review`'s `catalogue` readiness gap now reports "N products and none active" separately from an empty catalogue, for a store whose products were all created without `status` and stored as drafts.
+- `sb_api_find`'s `product_traps` gains a `status` trap: a product created without `status` is stored as "draft" — the storefront never lists it and the checkout refuses it as a line — even though the write still answers 201.
+- The translation call sheet (via `sb_api_find`) gains `review_gate`, explaining that `PUT /api/v1/translations` defaults a row's `source` to "machine", which is stored and counted but never shown on the storefront, in search, in slug routing, or in shopper mail until `POST /api/sites/{siteId}/translations/review` (or its `/bulk` form) approves it.
+
+### Changed
+- The generated catalog was regenerated against the platform (`web_builder` `84f1f10bc`): flash sale campaign listing operations gain query parameters `q`, `status`, `limit`, and `offset`; the order/checkout request shapes now catalog a `locale` field that snapshots the shopper's storefront language at checkout; `slug` is now catalogued as a translatable field on products, categories, articles, blog categories, courses, and pages; and `review` is no longer a translatable entity type.
+
 ## [0.70.0] - 2026-09-26
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,21 @@ 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.72.0] - 2026-09-28
+
+### Added
+- `sb_review` có thêm gap readiness `pageSeo`: liệt kê các trang page, about, contact, policy, faq và blog đã publish nhưng thiếu `settings.title` hoặc `settings.description`, vì storefront sẽ dùng tên site làm `<title>` và bỏ hẳn meta description khi thiếu một trong hai — khiến các trang này không thể phân biệt trên kết quả tìm kiếm dù canvas hay screenshot đều không cho thấy điều đó.
+
+## [0.71.0] - 2026-09-28
+
+### Added
+- Gap readiness `catalogue` của `sb_review` giờ báo riêng "có N sản phẩm, không cái nào active" thay vì gộp chung với catalogue rỗng, dành cho store có toàn bộ sản phẩm được tạo mà không kèm `status` nên bị lưu thành draft.
+- `product_traps` của `sb_api_find` có thêm bẫy `status`: một sản phẩm tạo không kèm `status` sẽ bị lưu thành "draft" — storefront không liệt kê và checkout từ chối nó như một dòng hàng — dù request ghi vẫn trả về 201.
+- Call sheet bản dịch (qua `sb_api_find`) có thêm `review_gate`, giải thích rằng `PUT /api/v1/translations` mặc định `source` của một dòng là "machine", dòng này được lưu và tính vào tiến độ nhưng không hiện ở storefront, trong tìm kiếm, trong slug routing hay trong mail gửi khách cho tới khi `POST /api/sites/{siteId}/translations/review` (hoặc bản `/bulk`) duyệt nó.
+
+### Changed
+- Catalog được sinh ra đã được làm mới dựa trên nền tảng (`web_builder` `84f1f10bc`): các operation liệt kê flash sale campaign có thêm tham số truy vấn `q`, `status`, `limit`, `offset`; request shape của order/checkout giờ catalog thêm field `locale` lưu lại ngôn ngữ storefront của khách tại thời điểm checkout; `slug` giờ được catalog là field dịch được trên product, category, article, blog category, course và page; và `review` không còn là một entity type dịch được nữa.
+
 ## [0.70.0] - 2026-09-26
 
 ### Added

package/dist/catalog/api.generated.js

@@ -8050,6 +8050,34 @@ export const API_OPERATIONS = [
                 "type": "string",
                 "description": "Site ID"
             },
+            {
+                "name": "q",
+                "in": "query",
+                "required": false,
+                "type": "string",
+                "description": "Case-insensitive substring of the campaign name (GET only)"
+            },
+            {
+                "name": "status",
+                "in": "query",
+                "required": false,
+                "type": "string",
+                "description": "off|scheduled|running|ended — derived status, evaluated now (GET only)"
+            },
+            {
+                "name": "limit",
+                "in": "query",
+                "required": false,
+                "type": "integer",
+                "description": "Page size, default 50, max 200 (GET only)"
+            },
+            {
+                "name": "offset",
+                "in": "query",
+                "required": false,
+                "type": "integer",
+                "description": "Page offset, default 0 (GET only)"
+            },
             {
                 "name": "flashSale",
                 "in": "body",
@@ -8078,6 +8106,34 @@ export const API_OPERATIONS = [
                 "type": "string",
                 "description": "Site ID"
             },
+            {
+                "name": "q",
+                "in": "query",
+                "required": false,
+                "type": "string",
+                "description": "Case-insensitive substring of the campaign name (GET only)"
+            },
+            {
+                "name": "status",
+                "in": "query",
+                "required": false,
+                "type": "string",
+                "description": "off|scheduled|running|ended — derived status, evaluated now (GET only)"
+            },
+            {
+                "name": "limit",
+                "in": "query",
+                "required": false,
+                "type": "integer",
+                "description": "Page size, default 50, max 200 (GET only)"
+            },
+            {
+                "name": "offset",
+                "in": "query",
+                "required": false,
+                "type": "integer",
+                "description": "Page offset, default 0 (GET only)"
+            },
             {
                 "name": "flashSale",
                 "in": "body",
@@ -18416,6 +18472,10 @@ export const API_DEFINITIONS = {
                     "$ref": "#/definitions/github_com_webbuilder_server_internal_orders.OrderItem"
                 }
             },
+            "locale": {
+                "description": "Locale is the language the SHOPPER was reading the storefront in at\ncheckout — a SNAPSHOT, for the same reason every other checkout-time fact\non this struct is one: a merchant who later reorders or trims the site's\nlanguage list must not have an already-placed order start mailing its\nbuyer in a different language than the one they bought in.\n\n\"\" means the site's DEFAULT locale — every order placed before this field\nexisted, every order typed by staff, and every order placed through a\nsurface that has not been taught to send one yet. It is never trusted\noutright: Checkout.Create normalises it against the site's published\nlocales (SiteLocales port) before it is stored, so a stale or tampered\nclaim can only ever fall back to \"\", never choose an unpublished\nlanguage. See Checkout.normalizeLocale.",
+                "type": "string"
+            },
             "note": {
                 "type": "string"
             },

package/dist/catalog/deadkeys.generated.js

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

package/dist/catalog/search.js

@@ -352,12 +352,19 @@ export function describeOperation(op) {
                 '/apps/blocks again for what it contributed.',
         };
     }
-    // FILLING A CATALOGUE WAS REACHABLE AND FIVE FACTS ABOUT IT WERE NOT, each
+    // FILLING A CATALOGUE WAS REACHABLE AND SIX FACTS ABOUT IT WERE NOT, each
     // failing silently. Attached to the call sheet for the same reason the
     // translation table is: this is where the agent is when it decides what to
     // send, on both credential surfaces a product can be created or replaced on.
     if (PRODUCT_WRITE_IDS.has(op.id)) {
         out.product_traps = {
+            // THE STATUS NOBODY SENDS. An empty Status becomes ProductStatusDraft
+            // (products/product.go), the storefront lists only "active", and since
+            // web_builder b4d60a862 the checkout REFUSES any other status as a line.
+            // The write answers 201 either way.
+            status: 'Send status: "active". A product created without one is stored as "draft" — the ' +
+                'storefront never lists it and the checkout refuses it — and the write still ' +
+                'answers 201. PATCH is 405: to activate later, PUT the whole object back.',
             price: 'Price lives on the VARIANT, not the product — variants[].priceCents. A product ' +
                 'posted with no variant renders a catalogue entry nobody can buy.',
             // MINOR UNITS, SAID WHERE THE NUMBER IS BEING WRITTEN.

package/dist/catalog/shapes.generated.js

@@ -4,7 +4,7 @@ export const SHAPE_SOURCE = {
     "fromHandlers": 197,
     "fromSwaggerOnly": 0,
     "withReadOnly": 28,
-    "structsRead": 1931
+    "structsRead": 1977
 };
 export const REQUEST_SHAPES = {
     "post:/api/sites/{id}/ai-credits/purchase": {
@@ -4736,6 +4736,11 @@ export const REQUEST_SHAPES = {
                 "name": "currency",
                 "type": "string"
             },
+            {
+                "name": "locale",
+                "type": "string",
+                "note": "Locale is the language the SHOPPER was reading the storefront in at checkout — a SNAPSHOT, for the same reason every other checkout-time fact on this struct is one: a merchant who later reorders or trims the site's language list must not…"
+            },
             {
                 "name": "discountCode",
                 "type": "string",
@@ -5047,6 +5052,11 @@ export const REQUEST_SHAPES = {
                 "name": "currency",
                 "type": "string"
             },
+            {
+                "name": "locale",
+                "type": "string",
+                "note": "Locale is the language the SHOPPER was reading the storefront in at checkout — a SNAPSHOT, for the same reason every other checkout-time fact on this struct is one: a merchant who later reorders or trims the site's language list must not…"
+            },
             {
                 "name": "discountCode",
                 "type": "string",

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": "a3a7352834d9d774f5a8162663fe8b27a0422d22",
-    "committedAt": "2026-09-26T11:21:05+07:00",
+    "commit": "84f1f10bcbef0748d0b18e19283ccb0458599c1b",
+    "committedAt": "2026-09-26T21:25:06+07:00",
     "dirty": false
 };

package/dist/catalog/translations.generated.js

@@ -4,7 +4,7 @@ export const TRANSLATION_SOURCE = {
     "elements": 66,
     "pairs": 180,
     "neverKeys": 178,
-    "entityTypes": 12
+    "entityTypes": 11
 };
 /** Every entity type a translation record can name, including "node". */
 export const TRANSLATION_ENTITY_TYPES = [
@@ -13,7 +13,6 @@ export const TRANSLATION_ENTITY_TYPES = [
     "article",
     "blogCategory",
     "course",
-    "review",
     "courseSection",
     "courseLesson",
     "node",
@@ -546,6 +545,9 @@ export const TRANSLATABLE_ENTITY_FIELDS = {
             "key": "attributes",
             "list": "attributes"
         },
+        {
+            "key": "slug"
+        },
         {
             "key": "seoTitle"
         },
@@ -570,6 +572,9 @@ export const TRANSLATABLE_ENTITY_FIELDS = {
             "key": "description",
             "html": true
         },
+        {
+            "key": "slug"
+        },
         {
             "key": "seoTitle"
         },
@@ -601,6 +606,9 @@ export const TRANSLATABLE_ENTITY_FIELDS = {
         {
             "key": "tags"
         },
+        {
+            "key": "slug"
+        },
         {
             "key": "seoTitle"
         },
@@ -624,6 +632,9 @@ export const TRANSLATABLE_ENTITY_FIELDS = {
         {
             "key": "description"
         },
+        {
+            "key": "slug"
+        },
         {
             "key": "seoTitle"
         },
@@ -666,6 +677,9 @@ export const TRANSLATABLE_ENTITY_FIELDS = {
         {
             "key": "tags"
         },
+        {
+            "key": "slug"
+        },
         {
             "key": "seoTitle"
         },
@@ -682,12 +696,6 @@ export const TRANSLATABLE_ENTITY_FIELDS = {
             "key": "ogDesc"
         }
     ],
-    "review": [
-        {
-            "key": "reply",
-            "html": true
-        }
-    ],
     "courseSection": [
         {
             "key": "title"
@@ -713,6 +721,9 @@ export const TRANSLATABLE_ENTITY_FIELDS = {
         },
         {
             "key": "ogDesc"
+        },
+        {
+            "key": "slug"
         }
     ],
     "uiString": [

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

@@ -104,6 +104,8 @@ export async function gatherReadiness(ctx, siteId, pageNodes, openPageId) {
         ? {
             active: rows.filter((p) => (p.status ?? 'active') === 'active').length,
             purchasable: rows.filter((p) => (p.status ?? 'active') === 'active' && (p.priceCents ?? 0) > 0).length,
+            // Drafts and archived: what a catalogue built without status:"active" is.
+            inactive: rows.filter((p) => (p.status ?? 'active') !== 'active').length,
         }
         : null;
     // A page an entity links to is that entity's own; only the shared template

package/dist/domains/site/readiness.js

@@ -31,6 +31,15 @@ const COMMERCE_TYPES = [
     'dataset-block',
     'list-dataset',
 ];
+/**
+ * The page types a search engine INDEXES under the page's own settings. Entity
+ * templates (product, category, post, course) get their <title> and
+ * description merged from the entity (storefront/entityroute.go
+ * mergeEntitySettings); error and maintain have no address; the fixed-path and
+ * auth types are chrome a crawler is not sent to. Mirrors page.SlugTypes minus
+ * the auth four, plus the blog listing.
+ */
+const INDEXED_PAGE_TYPES = new Set(['page', 'about', 'contact', 'policy', 'faq', 'blog']);
 /** Does this node carry a purchase action (add to cart, buy now)? */
 function boundProductAction(n) {
     return (n.bindings ?? []).some((b) => b.id === PRODUCT_ACTION_BINDING_ID && !!b.target?.action);
@@ -163,6 +172,45 @@ export function readinessGaps(input) {
                     'footer and a link back to the home page.',
         });
     }
+    // EVERY PAGE ANSWERS WITH THE SAME <title>, AND NO DESCRIPTION.
+    //
+    // storefront.go pageSettings.head: a page whose settings carry no `title`
+    // serves the SITE NAME as its <title>, and no `description` means no meta
+    // description at all — so a site built through these tools, where nothing
+    // ever asks for either, publishes N pages that a search result cannot tell
+    // apart. Invisible on the canvas, invisible in a screenshot, and the one
+    // thing a search engine reads first.
+    //
+    // Only the types whose head IS the page's own settings (INDEXED_PAGE_TYPES),
+    // only published pages, and only when the list carried `settings` at all —
+    // an absent blob is "not read", not "empty".
+    if (pages) {
+        const bare = pages.filter((p) => {
+            if (p.status !== 'published' || !INDEXED_PAGE_TYPES.has(p.type))
+                return false;
+            const st = p.settings;
+            if (!st || typeof st !== 'object')
+                return false;
+            const has = (k) => typeof st[k] === 'string' && st[k].trim() !== '';
+            return !(has('title') && has('description'));
+        });
+        if (bare.length > 0) {
+            const named = bare.map((p) => p.name).filter((n) => !!n).slice(0, 3);
+            gaps.push({
+                id: 'pageSeo',
+                draft: false,
+                problem: `${bare.length} published page${bare.length === 1 ? '' : 's'}` +
+                    (named.length ? ` (${named.join(', ')}${bare.length > named.length ? ', …' : ''})` : '') +
+                    ' carry no settings.title or settings.description. Each serves the SITE NAME as its ' +
+                    '<title> and no meta description — a search result cannot tell them apart, and ' +
+                    'nothing on the canvas or in a screenshot shows it.',
+                fix: 'PATCH /api/v1/pages/{id} with {settings: {...existing, title, description}} — ' +
+                    '`settings` REPLACES the blob, so read the page and send it back whole. Title is ' +
+                    'what the tab and the result show (under ~60 chars); description is the ' +
+                    'two-line summary under it. ogImage takes a share picture.',
+            });
+        }
+    }
     // ONE PAGE QUIETLY BECAME THE WHOLE ACCOUNT AREA.
     //
     // This server used to tell agents, in as many words, to put the login and the
@@ -363,14 +411,31 @@ export function readinessGaps(input) {
     // NOTHING TO SELL. Checked before the delivery option, because a shipping
     // method for an empty catalogue is furniture.
     if (input.products) {
-        if (input.products.active === 0) {
+        if (input.products.active === 0 && (input.products.inactive ?? 0) > 0) {
+            // PRODUCTS EXIST AND NONE IS ACTIVE. A product created without a status is
+            // stored as "draft" (products.go: an empty Status becomes ProductStatusDraft),
+            // the storefront lists only "active", and since web_builder b4d60a862 the
+            // checkout refuses any other status outright — so a catalogue built through
+            // the API without saying status:"active" is a store with nothing to buy.
+            gaps.push({
+                id: 'catalogue',
+                draft: false,
+                problem: `The store has ${input.products.inactive} products and none is active — a product ` +
+                    'created without status is stored as "draft", which the storefront never lists and ' +
+                    'the checkout refuses. Every product list renders its empty state.',
+                fix: 'PUT /api/v1/products/{id} with the whole object read back and status: "active" ' +
+                    '(PATCH is 405). Send status: "active" on every POST /api/v1/products from now on.',
+            });
+        }
+        else if (input.products.active === 0) {
             gaps.push({
                 id: 'catalogue',
                 draft: false,
                 problem: 'The store has no active products. Every product list on the site renders its empty ' +
                     'state, the product template has nothing to bind to, and there is nothing to add to a ' +
                     'cart — on a site that otherwise reports ready.',
-                fix: 'Create products (sb_api_find "create product"). priceCents is minor units — VND × 100.',
+                fix: 'Create products (sb_api_find "create product") with status: "active" — one created ' +
+                    'without a status is a draft. priceCents is minor units — VND × 100.',
             });
         }
         else if (input.products.purchasable === 0) {

package/dist/domains/site/translate.js

@@ -68,5 +68,17 @@ export function translationCallSheet() {
             'that element allows. Translating any OTHER special BREAKS the render rather than ' +
             'degrading it: `name` is a lucide icon id, `src` a URL, `filterSource` a registry id the ' +
             'renderer switches on. Never walk a document translating every string you find.',
+        // THE REVIEW GATE (web_builder c6184c085). The storefront, search, slug routing
+        // and shopper mail read only rows whose source is "human". The key surface
+        // defaults source to "machine" — deliberately, so an app cannot mislabel an
+        // unread value as reviewed — so a translation written there is stored,
+        // counted by /progress, and never SHOWN until a review call approves it.
+        review_gate: 'Only rows with source "human" are served — on the storefront, in search, in slug ' +
+            'routing and in shopper mail. PUT /api/v1/translations defaults source to "machine": ' +
+            'the row is stored and counted by GET /api/v1/translations/progress, and shown to ' +
+            'nobody until POST /api/sites/{siteId}/translations/review {locale, entityType, ' +
+            'entityId, field} or …/review/bulk approves it (session credential). Send ' +
+            '"source": "human" only when a person read the text; the site-scoped PUT ' +
+            '/api/sites/{siteId}/translations already defaults to "human".',
     };
 }

package/package.json

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