sbuilder-mcp 0.57.0 → 0.58.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.58.0] - 2026-09-15
+
+### Added
+- `sb_review` now reports `blogCategoryPage` and `coursePage` readiness gaps when a site has blog categories or courses but no published page of the `blog` or `course` type, since `/blog-categories/{slug}` and `/courses/{slug}` fall back to those templates and every entity link 404s without them, completing the check against all five entity prefixes the storefront registers.
+
 ## [0.57.0] - 2026-09-15
 
 ### Added

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.58.0] - 2026-09-15
+
+### Added
+- `sb_review` giờ báo lỗi sẵn sàng `blogCategoryPage` và `coursePage` khi site có danh mục blog hoặc khoá học nhưng chưa có trang loại `blog` hoặc `course` nào được publish, vì `/blog-categories/{slug}` và `/courses/{slug}` sẽ dùng các template đó, và mọi liên kết sẽ trả về 404 nếu thiếu — hoàn tất việc kiểm tra cho cả năm tiền tố thực thể mà storefront đăng ký.
+
 ## [0.57.0] - 2026-09-15
 
 ### Added

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

@@ -24,7 +24,7 @@ export async function gatherReadiness(ctx, siteId, pageNodes) {
         }
     };
     const site = encodeURIComponent(siteId);
-    const [pageList, gateways, shipping, globals, productList, categoryList, pageLinks, formList, articleList] = await Promise.all([
+    const [pageList, gateways, shipping, globals, productList, categoryList, pageLinks, formList, articleList, blogCategoryList, courseList] = await Promise.all([
         get(`/api/sites/${site}/pages`),
         get(`/api/sites/${site}/payment-gateways`),
         get(`/api/sites/${site}/shipping-methods`),
@@ -52,6 +52,13 @@ export async function gatherReadiness(ctx, siteId, pageNodes) {
         // resolves to the site's `post` template, so a site that has written
         // articles and has no template 404s every one of them.
         get(`/api/sites/${site}/articles?limit=1`),
+        // THE LAST TWO ENTITY PREFIXES the storefront registers
+        // (storefront/entityroute.go): /blog-categories/{slug} and /courses/{slug}.
+        // Each resolves to the site's published page of its own TYPE, so each has
+        // the hole /products/{slug} has, and counting is how we know the site uses
+        // the prefix at all.
+        get(`/api/sites/${site}/blog-categories?limit=1`),
+        get(`/api/sites/${site}/courses?limit=1`),
     ]);
     // 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:
@@ -62,6 +69,10 @@ export async function gatherReadiness(ctx, siteId, pageNodes) {
         : null;
     const methods = shipping?.shippingMethods ?? shipping?.methods;
     const shippingMethods = Array.isArray(methods) ? methods.length : null;
+    // Either key, like the product categories below: this reader has met both
+    // spellings from the platform and guessing one would read a real list as none.
+    const rawBlogCats = blogCategoryList?.blogCategories ?? blogCategoryList?.categories;
+    const blogCats = Array.isArray(rawBlogCats) ? rawBlogCats : null;
     const cats = categoryList?.categories ?? categoryList?.productCategories;
     const categories = Array.isArray(cats) ? (categoryList?.total ?? cats.length) : null;
     const links = pageLinks?.links ?? pageLinks?.pageLinks;
@@ -101,5 +112,9 @@ export async function gatherReadiness(ctx, siteId, pageNodes) {
         articles: Array.isArray(articleList?.articles)
             ? (articleList?.total ?? articleList.articles.length)
             : null,
+        blogCategories: blogCats ? (blogCategoryList?.total ?? blogCats.length) : null,
+        courses: Array.isArray(courseList?.courses)
+            ? (courseList?.total ?? courseList.courses.length)
+            : null,
     };
 }

package/dist/domains/site/readiness.js

@@ -203,6 +203,35 @@ export function readinessGaps(input) {
                     'headline, date and body an article cannot be read without.',
         });
     }
+    // THE LAST TWO ENTITY PREFIXES, the same hole in the same shape.
+    //
+    // storefront/entityroute.go registers five: /products, /collections, /blog,
+    // /blog-categories and /courses. Each resolves to the site's published page of
+    // its own TYPE, so each 404s everything under it when that page is missing.
+    // Four of the five are now checked above; these are the other two.
+    //
+    // COUNTED, NOT ASSUMED. A site with no blog categories has nothing under
+    // /blog-categories to break, and a site with no courses has not installed the
+    // app — the count IS the gate, which is why neither needs to ask about the
+    // app separately. Both sit above the store gate: a course is sold, but a blog
+    // is not commerce, and a site can be neither and still have one.
+    for (const [count, type, id, prefix, what] of [
+        [input.blogCategories, 'blog', 'blogCategoryPage', '/blog-categories/{slug}', 'blog category'],
+        [input.courses, 'course', 'coursePage', '/courses/{slug}', 'course'],
+    ]) {
+        if (!pages || (count ?? 0) === 0 || published(pages, type))
+            continue;
+        const draft = drafted(pages, type);
+        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.`,
+        });
+    }
     if (!isStore(input))
         return gaps;
     if (pages && !published(pages, 'checkout')) {

package/package.json

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