sbuilder-mcp 0.51.0 → 0.52.0

package/CHANGELOG.md

@@ -6,6 +6,15 @@ 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.52.0] - 2026-09-15
+
+### Added
+- `sb_page_list`'s `usually_also` advisory now names a missing `faq` page.
+- `sb_page_list`'s `usually_also` advisory now names a missing blog listing page, but only on a site that already has a `post` (article) template to list — a site with no articles is no longer told to build one.
+
+### Changed
+- `sb_page_list`'s `usually_also` advisory splits the single `policy` entry into `policy-delivery` (shipping and returns) and `policy-privacy` (privacy and terms of use), so a site carrying only one of the two no longer reads as having both.
+
 ## [0.51.0] - 2026-09-15
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,15 @@ 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.52.0] - 2026-09-15
+
+### Added
+- Gợi ý `usually_also` của `sb_page_list` giờ nêu tên trang `faq` nếu site còn thiếu.
+- Gợi ý `usually_also` của `sb_page_list` giờ nêu tên trang danh sách blog nếu site còn thiếu, nhưng chỉ khi site đã có template bài viết (`post`) để liệt kê — site chưa có bài viết nào thì không còn bị nhắc xây trang này.
+
+### Changed
+- Gợi ý `usually_also` của `sb_page_list` tách mục `policy` duy nhất thành `policy-delivery` (giao hàng và đổi trả) và `policy-privacy` (bảo mật và điều khoản sử dụng), để một site chỉ có một trong hai trang không còn bị đọc nhầm là đã có đủ cả hai.
+
 ## [0.51.0] - 2026-09-15
 
 ### Added

package/dist/domains/site/inventory.js

@@ -54,15 +54,46 @@ export const USUAL_PAGES = [
         match: ['about', 'gioi-thieu', 'giới thiệu', 've-chung-toi'],
         why: 'Nothing says who the shop is, which is the page a first-time buyer opens before paying.',
     },
+    // TWO POLICIES, NOT ONE BUCKET. These were a single entry, and it read a shop
+    // carrying only "Chính sách giao hàng & đổi trả" as complete — which is
+    // exactly the shop that was measured, and it had no privacy terms at all. One
+    // policy page satisfying a check about all of them is the check answering a
+    // question it was not asked.
     {
-        key: 'policy',
+        key: 'policy-delivery',
         match: [
-            'policy', 'policies', 'chinh-sach', 'chính sách', 'dieu-khoan', 'điều khoản',
-            'terms', 'privacy', 'bao-mat', 'bảo mật', 'doi-tra', 'đổi trả', 'return',
-            'shipping', 'van-chuyen', 'vận chuyển', 'giao-hang', 'giao hàng', 'refund',
+            'doi-tra', 'đổi trả', 'return', 'refund', 'hoan-tien', 'hoàn tiền',
+            'shipping', 'van-chuyen', 'vận chuyển', 'giao-hang', 'giao hàng', 'delivery',
         ],
-        why: 'No delivery, return or privacy terms a shopper can read before paying — the pages a ' +
-            'marketplace and a payment provider both ask for.',
+        why: 'No delivery or return terms a shopper can read before paying. This is the page a buyer ' +
+            'looks for when the parcel is late and the one a dispute is settled against.',
+    },
+    {
+        key: 'policy-privacy',
+        match: [
+            'privacy', 'bao-mat', 'bảo mật', 'dieu-khoan', 'điều khoản', 'terms',
+            'quy-dinh', 'quy định',
+        ],
+        why: 'No privacy policy or terms of use. Payment providers and marketplaces ask for both ' +
+            'before they will list a shop, and a checkout form collects personal data either way.',
+    },
+    {
+        key: 'faq',
+        match: ['faq', 'cau-hoi', 'câu hỏi', 'hoi-dap', 'hỏi đáp', 'help', 'tro-giup', 'trợ giúp'],
+        why: 'The same handful of questions reach support one message at a time, with no page to link ' +
+            'an answer to. The accordion element is what this page is built from.',
+    },
+    {
+        key: 'blog',
+        // ONLY ONCE THERE IS SOMETHING TO LIST. `post` is the ARTICLE template —
+        // it answers /blog/{slug} and has no address of its own — so a site with
+        // one can publish articles that nothing on the site links to. A site
+        // without one has no articles, and telling it to build a listing page is
+        // advice about a section it never asked for.
+        when: (pages) => pages.some((x) => x.type === 'post'),
+        match: ['blog', 'tin-tuc', 'tin tức', 'news', 'bai-viet', 'bài viết', 'kien-thuc', 'cẩm nang'],
+        why: 'This site has an article template, so /blog/{slug} works — but no page LISTS the ' +
+            'articles, so each one is reachable only by someone who already has its URL.',
     },
 ];
 /**
@@ -80,5 +111,5 @@ export function missingUsualPages(pages) {
         .filter((p) => (typeof p.type === 'string' ? p.type === 'page' : true))
         .map((p) => `${typeof p.slug === 'string' ? p.slug : ''} ${typeof p.name === 'string' ? p.name : ''}`.toLowerCase())
         .join('\n');
-    return USUAL_PAGES.filter((u) => !u.match.some((m) => hay.includes(m)));
+    return USUAL_PAGES.filter((u) => (u.when ? u.when(pages) : true) && !u.match.some((m) => hay.includes(m)));
 }

package/package.json

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