sbuilder-mcp 0.74.1 → 0.75.0

package/CHANGELOG.md

@@ -6,6 +6,11 @@ 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.75.0] - 2026-09-28
+
+### Added
+- `sb_review` gains a `productImages` readiness gap: since the renderer falls back to its grey `ImagePlaceholder` whenever a node has no `src`, an active product created without `images` shows that same placeholder on every card, cart line, and its own product page with nothing erroring anywhere; it counts active products with no non-empty `images` entry and fires after the pricing gaps, pointing at `sb_media_upload` (or `POST /api/media/{siteId}/from-url`) followed by a `PUT` of the product with `images: [url, …]`.
+
 ## [0.74.1] - 2026-09-28
 
 ### Fixed

package/CHANGELOG.vi.md

@@ -6,6 +6,11 @@ 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.75.0] - 2026-09-28
+
+### Added
+- `sb_review` có thêm gap readiness `productImages`: vì renderer dùng `ImagePlaceholder` màu xám mặc định bất cứ khi nào một node không có `src`, một sản phẩm active được tạo mà không có `images` sẽ hiện cùng ô xám đó trên mọi thẻ, mọi dòng giỏ hàng và trên chính trang sản phẩm mà không lỗi ở đâu cả; gap đếm số sản phẩm active không có mục `images` nào khác rỗng và báo sau các gap về giá, trỏ tới `sb_media_upload` (hoặc `POST /api/media/{siteId}/from-url`) rồi `PUT` lại sản phẩm với `images: [url, …]`.
+
 ## [0.74.1] - 2026-09-28
 
 ### Fixed

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

@@ -110,6 +110,9 @@ export async function gatherReadiness(ctx, siteId, pageNodes, openPageId) {
             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,
+            // Active and pictureless: the grey placeholder on every card.
+            unpictured: rows.filter((p) => (p.status ?? 'active') === 'active' &&
+                !(Array.isArray(p.images) && p.images.some((u) => typeof u === 'string' && u !== ''))).length,
         }
         : null;
     // A page an entity links to is that entity's own; only the shared template

package/dist/domains/site/readiness.js

@@ -558,6 +558,26 @@ export function readinessGaps(input) {
             });
         }
     }
+    // A CARD WITH THE PLATFORM'S GREY SQUARE WHERE THE PHOTO GOES.
+    //
+    // render/nodes/image/html.go: no src → nodes.ImagePlaceholder, "a card
+    // instead of a broken icon". So a product created without `images` renders
+    // on every card, in every drawer line and on its own page as the same grey
+    // placeholder — nothing errors, and a catalogue of twenty reads as a
+    // template nobody finished. Asked after the money questions: a store with
+    // no photos still takes an order.
+    if (input.products && input.products.active > 0 && (input.products.unpictured ?? 0) > 0) {
+        const n = input.products.unpictured;
+        gaps.push({
+            id: 'productImages',
+            draft: false,
+            problem: `${n} of ${input.products.active} active products have no image, so every card, cart ` +
+                "line and product page shows the platform's grey placeholder where the photo goes.",
+            fix: 'Get a picture into the library (sb_media_upload: a file, a url, or query + pick), then ' +
+                'PUT the whole product back with images: [url, …] — first is the primary. POST ' +
+                '/api/media/{siteId}/from-url ingests straight from a url in one hop.',
+        });
+    }
     if (input.shippingMethods === 0) {
         gaps.push({
             id: 'shipping',

package/package.json

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