sbuilder-mcp 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -6,6 +6,12 @@ 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.4.0] - 2026-09-08
+
+### Added
+- sb_review reports a catalogue gap when a site has no active products, since every repeater on the site renders its empty state and the product template is bound to nothing on a store that otherwise reports ready.
+- sb_review reports the same catalogue gap when every active product is priced at zero, since a zero-priced product still renders, adds to the cart and totals nothing.
+
 ## [0.3.0] - 2026-09-08
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,12 @@ 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.4.0] - 2026-09-08
+
+### Added
+- sb_review giờ báo cáo gap catalogue khi site chưa có sản phẩm active nào, vì mọi repeater trên site sẽ render trạng thái rỗng và product template không bind vào đâu cả trên một cửa hàng vốn báo cáo là đã sẵn sàng.
+- sb_review giờ báo cáo cùng gap catalogue khi mọi sản phẩm active đều có giá bằng không, vì một sản phẩm giá 0 vẫn render, vẫn thêm được vào giỏ hàng và tổng đơn hàng bằng không.
+
 ## [0.3.0] - 2026-09-08
 
 ### Added

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

@@ -24,11 +24,16 @@ export async function gatherReadiness(ctx, siteId, pageNodes) {
         }
     };
     const site = encodeURIComponent(siteId);
-    const [pageList, gateways, shipping, globals] = await Promise.all([
+    const [pageList, gateways, shipping, globals, productList] = await Promise.all([
         get(`/api/sites/${site}/pages`),
         get(`/api/sites/${site}/payment-gateways`),
         get(`/api/sites/${site}/shipping-methods`),
         get(`/api/sites/${site}/global-sections`),
+        // The SITE-SCOPED list, not /api/v1/products: this one takes either
+        // credential, so the check answers for a session install as well as a
+        // key-only one. A page is enough to tell empty from not; `total` carries the
+        // real count when the platform sends it.
+        get(`/api/sites/${site}/products?limit=200`),
     ]);
     // A gateway counts only when it is BOTH enabled and configured — the editor's
     // `live` getter also filters by the store's currency, which is a narrowing:
@@ -42,8 +47,19 @@ export async function gatherReadiness(ctx, siteId, pageNodes) {
     const globalNodes = globals?.globalSections
         ? globals.globalSections.flatMap((g) => Object.values(g.document?.nodes ?? {}))
         : null;
+    // ACTIVE means a shopper can see it; PURCHASABLE adds a price above zero. A
+    // product priced at zero renders, adds to the cart, and totals nothing — which
+    // reads as a working store right up to the money.
+    const rows = productList?.products;
+    const products = Array.isArray(rows)
+        ? {
+            active: rows.filter((p) => (p.status ?? 'active') === 'active').length,
+            purchasable: rows.filter((p) => (p.status ?? 'active') === 'active' && (p.priceCents ?? 0) > 0).length,
+        }
+        : null;
     return {
         pages: pageList?.pages ?? null,
+        products,
         liveGateways,
         shippingMethods,
         pageNodes,

package/dist/domains/site/readiness.js

@@ -100,6 +100,30 @@ export function readinessGaps(input) {
                 : 'Create a page of type "product" and publish it.',
         });
     }
+    // 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) {
+            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.',
+            });
+        }
+        else if (input.products.purchasable === 0) {
+            gaps.push({
+                id: 'catalogue',
+                draft: false,
+                problem: `All ${input.products.active} active products are priced at zero. They render, they add ` +
+                    'to the cart, and the order totals nothing — which reads as a working store right up ' +
+                    'to the money.',
+                fix: 'Set priceCents on each product and its variants. Minor units: VND × 100.',
+            });
+        }
+    }
     if (input.shippingMethods === 0) {
         gaps.push({
             id: 'shipping',

package/package.json

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