sbuilder-mcp 0.83.0 → 0.83.1

package/CHANGELOG.md

@@ -6,6 +6,17 @@ 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.83.1] - 2026-10-11
+
+### Added
+- `sb_bind` accepts `brand.*` and `blogCategory.*` binding sources, raising the known binding sources from 82 to 94.
+
+### Changed
+- `sb_page_create` with the `brand` or `course` page type, or with `seed: false`, returns a `next` hint explaining how to build the page, since publishing an empty one makes every entity URL answer 500.
+
+### Fixed
+- `sb_review` no longer reports `dead_binding_source` for valid `blogCategory.*` bindings.
+
 ## [0.83.0] - 2026-10-11
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,17 @@ 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.83.1] - 2026-10-11
+
+### Added
+- `sb_bind` nhận nguồn binding `brand.*` và `blogCategory.*`, nâng số nguồn binding được biết từ 82 lên 94.
+
+### Changed
+- `sb_page_create` với loại trang `brand` hoặc `course`, hoặc với `seed: false`, trả gợi ý `next` nêu cách dựng trang, vì publish trang rỗng khiến mọi URL thực thể trả 500.
+
+### Fixed
+- `sb_review` không còn báo `dead_binding_source` cho binding `blogCategory.*` hợp lệ.
+
 ## [0.83.0] - 2026-10-11
 
 ### Added

package/README.md

@@ -119,7 +119,7 @@ in this client: one would put the very key the platform exists to hold back into
 | `sb_undo` | Undo / redo this session's writes — page and form edits and `sb_api_call` PUTs; a page is refused if someone else saved it since. The platform's versions and history (`sb_page_version`) outlive this process |
 
 Twenty-eight tools, **830 API operations** (302 of the 381 writes carrying a body shape read
-off the handler), 123 elements, 82 binding sources. `sb_api_find`
+off the handler), 123 elements, 94 binding sources. `sb_api_find`
 is an index rather than a tool per endpoint, so the tool list stays short while everything
 the platform can do stays reachable — and operations added to the platform arrive with the
 next `npm run codegen`.

package/README.vi.md

@@ -116,7 +116,7 @@ nhét ngược lại vào mọi bản cài.
 | `sb_undo` | Hoàn tác / làm lại các thao tác ghi trong phiên — chỉnh sửa trang, form và PUT qua `sb_api_call`; trang bị từ chối nếu người khác đã lưu sau đó. Version và history của nền tảng (`sb_page_version`) sống lâu hơn process này |
 
 Hai mươi tám tool, **830 operation API** (302 trong 381 lệnh ghi có hình dạng body đọc thẳng
-từ handler), 123 element, 82 nguồn binding. `sb_api_find` là
+từ handler), 123 element, 94 nguồn binding. `sb_api_find` là
 một chỉ mục chứ không phải mỗi endpoint một tool, nên danh sách tool vẫn ngắn trong khi mọi
 thứ nền tảng làm được vẫn với tới — và operation mới thêm bên nền tảng sẽ tự có sau lần
 `npm run codegen` kế tiếp.

package/dist/catalog/elements.generated.js

@@ -41952,6 +41952,17 @@ export const BINDING_SOURCES = [
     "article.tags",
     "article.title",
     "article.url",
+    "blogCategory.description",
+    "blogCategory.image",
+    "blogCategory.title",
+    "blogCategory.url",
+    "brand.description",
+    "brand.image",
+    "brand.title",
+    "brand.url",
+    "cartLine.lineTotalCents",
+    "cartLine.quantity",
+    "cartLine.variant",
     "category.description",
     "category.image",
     "category.title",
@@ -42008,6 +42019,7 @@ export const BINDING_SOURCES = [
     "review.stars",
     "review.title",
     "review.verified",
+    "searchRow.url",
     "site.addressLine",
     "site.country",
     "site.description",

package/dist/domains/site/readiness.js

@@ -18,6 +18,7 @@
  */
 import { cartGalleryThumbs, cartRelocalize, cartSeedLocale } from './cartlang.js';
 import { PRODUCT_ACTION_BINDING_ID } from './navhref.js';
+import { hasSeed } from './storepage.js';
 /** Element types that only make sense in a store. */
 const COMMERCE_TYPES = [
     'cart-order',
@@ -435,14 +436,21 @@ export function readinessGaps(input) {
         if (!pages || (count ?? 0) === 0 || published(pages, type))
             continue;
         const draft = drafted(pages, type);
+        // A type the platform ships no seed for opens EMPTY, and an empty entity
+        // template answers 500 at every one of its URLs (storefront/entityroute.go:
+        // empty body → "entity render failed") — so "publish it" alone trades the
+        // 404s for 500s and clears this gap. Measured on a brand page.
+        const withContent = hasSeed(type)
+            ? ''
+            : ` WITH content on it — an empty one answers 500 at every ${prefix}; sb_page_create's \`next\` says what to add`;
         gaps.push({
             id,
             draft,
             problem: `This site has ${count} ${what}${count === 1 ? '' : count && count > 1 ? 's' : ''} and no ` +
                 `published page of the "${type}" type. ${prefix} needs one, so every ${what} link 404s.`,
             fix: draft
-                ? `Publish the ${what} template page that already exists.`
-                : `Create a page of type "${type}" and publish it.`,
+                ? `Publish the ${what} template page that already exists${withContent}.`
+                : `Create a page of type "${type}" and publish it${withContent}.`,
         });
     }
     // A CART DRAWER IN ANOTHER LANGUAGE. Asked before the store gate: a drawer

package/dist/domains/site/review.js

@@ -131,17 +131,19 @@ function drawsItsOwnContent(type) {
     return (BOUND_SPECIALS[type] ?? []).some((k) => !LINK_SPECIALS.has(k));
 }
 /** Binding-source prefixes that name a RECORD (not `site.*`, which every page has). */
-const RECORD_ENTITIES = new Set(['product', 'category', 'course', 'article', 'blogCategory']);
+const RECORD_ENTITIES = new Set(['product', 'category', 'course', 'article', 'blogCategory', 'brand']);
 /**
  * Which records a page TYPE supplies outside any repeater — read off the
  * platform's own seeds (STORE_PAGE_SEEDS bind exactly these at top level).
  */
-const PAGE_ENTITIES = {
+export const PAGE_ENTITIES = {
     product: ['product'],
     category: ['category'],
     course: ['course'],
     post: ['article'],
     blog: ['blogCategory', 'category'],
+    // /brands/{slug} — the page supplies brandContext (web_builder f70fe86d1).
+    brand: ['brand'],
 };
 /** Does this node or an ancestor PIN a record (`bindings[0].target.id`)? */
 function pinnedAbove(d, id) {

package/dist/domains/site/storepage.js

@@ -1,5 +1,7 @@
-import { COMPLETION_HEADLINE, COMPLETION_HEADLINE_SENTINEL, PAGE_LAYOUT_SEEDS, STORE_PAGE_SEEDS } from '../../catalog/storepages.generated.js';
+import { COMPLETION_HEADLINE, COMPLETION_HEADLINE_SENTINEL, PAGE_LAYOUT_SEEDS, PAGE_TYPES, STORE_PAGE_SEEDS } from '../../catalog/storepages.generated.js';
+import { BINDING_SOURCES } from '../../catalog/elements.generated.js';
 import { withFreshIds } from './ids.js';
+import { PAGE_ENTITIES } from './review.js';
 /**
  * WHAT A NEW STORE PAGE OPENS WITH — for an agent, as for a merchant.
  *
@@ -55,6 +57,37 @@ export function seedDocument(type, opts = {}) {
     const escaped = JSON.stringify(headline).slice(1, -1);
     return withFreshIds(JSON.parse(raw.split(COMPLETION_HEADLINE_SENTINEL).join(escaped)));
 }
+/**
+ * What to put on an ENTITY TEMPLATE that opens empty, or null.
+ *
+ * An entity template (a type whose route carries `{slug}`) with an empty
+ * document answers 500 "entity render failed" at EVERY one of its URLs once
+ * published — `storefront/entityroute.go` refuses an empty body rather than
+ * serve a blank 200. Measured on a brand page: empty → 500 at /brands/acme,
+ * one heading → 200. The editor seeds some of these types and not others
+ * (brand and course today), and `seed:false` or a refused seed write leaves any
+ * of them empty, so the rule is "entity template + nothing seeded", not a name.
+ *
+ * A NOTE, NOT AN INVENTED SEED: the platform ships none for brand, and a seed
+ * authored here would be a document nothing upstream keeps current.
+ */
+export function emptyEntityTemplateNote(type) {
+    const route = PAGE_TYPES.find((t) => t.type === type)?.routePattern;
+    const entity = type ? PAGE_ENTITIES[type]?.[0] : undefined;
+    if (!route?.includes('{slug}') || !entity)
+        return null;
+    const has = (k) => BINDING_SOURCES.includes(`${entity}.${k}`);
+    const parts = [
+        ...(has('title') ? [`a heading bound to ${entity}.title`] : []),
+        ...(has('description') ? [`a text bound to ${entity}.description`] : []),
+        ...(type === 'brand'
+            ? ['a product grid narrowed to the brand the URL names: sb_template_use template_id "sb_product_shelf", then sb_set its list-dataset config.collectionType "page_brand" (a bare list-dataset has no card and renders empty)']
+            : []),
+    ];
+    return (`This "${type}" page is EMPTY. Published like that, every ${route} answers 500 ` +
+        '"entity render failed". ' +
+        `Before publishing, sb_add ${parts.join(', ')} — bind the heading and text with sb_bind, field "specials.text".`);
+}
 /** A one-line summary of what a seed puts on the page, for the tool result. */
 export function seedSummary(type) {
     const seed = STORE_PAGE_SEEDS[type];

package/dist/tools/page.js

@@ -12,7 +12,7 @@ import { addSubtree, setMany, baseOnlyKeys, moveNode, removeNode, duplicateNode,
 import { baseOnlyNote } from '../domains/site/baseonly.js';
 import { detachNote, presetIdOf, presetLayer } from '../domains/site/theme.js';
 import { inertHintsFor } from '../domains/site/inert.js';
-import { hasSeed, layoutDocument, seedDocument, seedSummary, seededTypes, } from '../domains/site/storepage.js';
+import { emptyEntityTemplateNote, hasSeed, layoutDocument, seedDocument, seedSummary, seededTypes, } from '../domains/site/storepage.js';
 import { PAGE_TYPES } from '../catalog/storepages.generated.js';
 import { skinLevelNote } from '../domains/site/fieldskin.js';
 import { siteTheme } from '../domains/site/theme-fetch.js';
@@ -2358,6 +2358,7 @@ export function registerPageTools(server, ctx) {
                 body: redact(body),
                 ...(summary ? { would_seed: { type, ...summary } } : {}),
                 ...(layout ? { would_open_as: layout } : {}),
+                ...(!summary && !layout && emptyEntityTemplateNote(type) ? { next: emptyEntityTemplateNote(type) } : {}),
                 ...(wear.header || wear.footer
                     ? { would_wear: { ...(wear.header ? { header: wear.header } : {}), ...(wear.footer ? { footer: wear.footer } : {}) } }
                     : {}),
@@ -2415,9 +2416,14 @@ export function registerPageTools(server, ctx) {
             }
         }
         const wearing = typeof newId === 'string' && newId ? await wearChrome(session, site_id, newId, wear) : undefined;
+        // An entity template that ended up with nothing on it 500s at every
+        // entity URL once published — say what to add, whatever the reason
+        // (no platform seed, seed:false, a refused seed write).
+        const blankNote = !seeded || 'failed' in seeded ? emptyEntityTemplateNote(type) : null;
         return text({
             ...res,
             ...(seeded ? { seeded } : {}),
+            ...(blankNote ? { next: blankNote } : {}),
             ...(wearing ? { chrome: wearing } : {}),
             ...(renamed
                 ? {

package/package.json

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