sbuilder-mcp 0.49.0 → 0.50.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.50.0] - 2026-09-15
+
+### Changed
+- `sb_catalog_search` raises its `limit` ceiling from 30 to 60 so a category can be read whole; the `basic` category alone holds 39 element types, and a 30-cap silently dropped the nine an agent had never used, the same failure browsing exists to fix.
+- `sb_catalog_search`'s browse note now tells the caller to pass a category name with `limit` 60 to read that whole group's descriptions at once, on top of passing a type for its fields.
+
 ## [0.49.0] - 2026-09-15
 
 ### 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.50.0] - 2026-09-15
+
+### Changed
+- `sb_catalog_search` nâng trần `limit` từ 30 lên 60 để có thể đọc trọn một category; riêng category `basic` đã có 39 loại phần tử, và mức trần 30 âm thầm bỏ sót chín phần tử mà agent chưa từng dùng đến — đúng lỗi mà tính năng duyệt catalog vốn sinh ra để khắc phục.
+- Ghi chú duyệt catalog của `sb_catalog_search` giờ hướng dẫn người gọi truyền tên một category cùng `limit` 60 để đọc toàn bộ mô tả của nhóm đó một lần, bên cạnh việc truyền một loại phần tử để xem các trường lựa chọn của nó.
+
 ## [0.49.0] - 2026-09-15
 
 ### Added

package/dist/catalog/element-search.js

@@ -36,6 +36,18 @@ export function catalogBrowse() {
         out[k].sort();
     return out;
 }
+/**
+ * The biggest category, which is what `limit` has to clear for a caller to read
+ * one group WHOLE.
+ *
+ * A group query that silently returns its first 30 of 39 is the worst answer
+ * available here: it looks like the whole group, and the nine it dropped are
+ * exactly the elements nobody knew to look for. `catalog-browse.test.ts` fails
+ * when a category outgrows the cap, which is the only way anyone would notice.
+ */
+export function largestCategorySize() {
+    return Math.max(...Object.values(catalogBrowse()).map((g) => g.length));
+}
 /**
  * Four fields to CHOOSE by.
  *

package/dist/tools/page.js

@@ -561,7 +561,7 @@ export function registerPageTools(server, ctx) {
             'does sb_traits_for.',
         inputSchema: {
             query: z.string().optional(),
-            limit: z.number().int().min(1).max(30).optional().describe('Default 8'),
+            limit: z.number().int().min(1).max(60).optional().describe('Default 8'),
             detail: z.boolean().optional().describe('Include useWhen / avoidWhen / contentTips per match'),
         },
         annotations: { readOnlyHint: true },
@@ -574,8 +574,10 @@ export function registerPageTools(server, ctx) {
         ? catalogMatches(query, { limit, detail })
         : {
             elements: catalogBrowse(),
-            note: 'Every element type, grouped as the palette groups them. Pass one as query for ' +
-                'the fields to choose by, then sb_traits_for for its controls and hints.',
+            note: 'Every element type, grouped as the palette groups them. Pass a TYPE as query ' +
+                'for the fields to choose by, or a CATEGORY NAME with limit 60 to read that ' +
+                "whole group's descriptions at once — which is how you find out what the ones " +
+                'you have never used are for. sb_traits_for then has the controls and hints.',
         }));
     server.registerTool('sb_traits_for', {
         description: "This element's INSPECTOR, as a person sees it: tabs, groups, and every control name — " +

package/package.json

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