sbuilder-mcp 0.11.2 → 0.12.0

package/CHANGELOG.md

@@ -6,6 +6,19 @@ 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.12.0] - 2026-09-09
+
+### Added
+- npm run codegen:check now also refuses a checkout whose HEAD carries commits touching the directories it reads (schema/src, editor/src, server/render, server/docs) that its upstream branch does not have, naming the commits; an uncommitted-only check had already been fooled once, by a feature committed locally and never pushed, so the tree read clean while the catalog it fed was ahead of every deployed platform. A detached worktree checked out at origin/main has no upstream and is therefore exempt, which is the shape the check itself recommends; `--dirty` still overrides it.
+
+### Fixed
+- The generated request-shape catalog now covers three write operations its handler parser was missing or mis-attributing: `roles/{roleId}` (a case arm listing several HTTP methods together), `products/{productId}/categories` (a dispatcher that routes by a literal path segment rather than by method), and `sites/{siteId}/org` (a doc comment block shared by two adjacent handlers declared in the opposite order, now attributed by the name it opens with). 162 of 276 write operations now carry a shape, up from 157, so sb_api_call and sb_undo can act on all three without guessing a body.
+
+## [0.11.3] - 2026-09-09
+
+### Fixed
+- sb_set now says its hover-routing note once per element type per process instead of once per node, since repairing every button on a page in one batch returned ten copies of the same 300-character paragraph; a different element type still gets its own note, because it says something different.
+
 ## [0.11.2] - 2026-09-09
 
 ### Fixed

package/CHANGELOG.vi.md

@@ -6,6 +6,19 @@ 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.12.0] - 2026-09-09
+
+### Added
+- npm run codegen:check giờ cũng từ chối một checkout mà HEAD của nó mang các commit chạm vào những thư mục mà nó đọc (schema/src, editor/src, server/render, server/docs) mà nhánh upstream không có, nêu tên các commit đó; việc chỉ kiểm tra thay đổi chưa commit từng bị qua mặt một lần, bởi một tính năng đã được commit ở local nhưng chưa từng push, khiến working tree trông sạch trong khi catalog mà nó tạo ra lại đi trước mọi nền tảng đã triển khai. Một worktree tách rời checkout tại origin/main không có upstream nên được miễn kiểm tra này, đúng như cách mà chính kiểm tra này khuyến nghị; `--dirty` vẫn cho phép ghi đè.
+
+### Fixed
+- Catalog request-shape được sinh ra giờ bao phủ thêm ba write operation mà trình phân tích handler trước đây bỏ sót hoặc gán sai: `roles/{roleId}` (một case arm liệt kê nhiều phương thức HTTP cùng lúc), `products/{productId}/categories` (một dispatcher định tuyến theo một đoạn path cố định thay vì theo method), và `sites/{siteId}/org` (một khối doc comment dùng chung cho hai handler liền kề được khai báo theo thứ tự ngược lại, giờ được gán theo đúng tên mà nó mở đầu). 162 trong số 276 write operation giờ đã có shape, tăng từ 157, nhờ đó sb_api_call và sb_undo có thể thao tác trên cả ba mà không cần đoán body.
+
+## [0.11.3] - 2026-09-09
+
+### Fixed
+- sb_set giờ chỉ nói ghi chú định tuyến hover một lần cho mỗi loại element trong mỗi tiến trình thay vì một lần cho mỗi node, vì việc sửa mọi nút button trên một trang trong cùng một batch trước đây trả về mười bản sao của cùng một đoạn văn 300 ký tự; một loại element khác vẫn nhận được ghi chú riêng của nó, vì nó nói một điều khác.
+
 ## [0.11.2] - 2026-09-09
 
 ### Fixed

package/dist/catalog/shapes.generated.js

@@ -1,7 +1,7 @@
 export const SHAPE_SOURCE = {
     "writeOperations": 212,
-    "shaped": 157,
-    "fromHandlers": 157,
+    "shaped": 162,
+    "fromHandlers": 162,
     "fromSwaggerOnly": 0,
     "withReadOnly": 26,
     "structsRead": 1597
@@ -171,6 +171,110 @@ export const REQUEST_SHAPES = {
         "source": "go",
         "goType": "versionInput"
     },
+    "post:/api/orgs/{orgId}/apps/{appId}/versions/{versionId}/withdraw": {
+        "fields": [
+            {
+                "name": "version",
+                "type": "string"
+            },
+            {
+                "name": "scopes",
+                "type": "string[]"
+            },
+            {
+                "name": "embedUrl",
+                "type": "string"
+            },
+            {
+                "name": "redirectUri",
+                "type": "string"
+            },
+            {
+                "name": "summary",
+                "type": "string"
+            },
+            {
+                "name": "description",
+                "type": "string"
+            },
+            {
+                "name": "category",
+                "type": "string",
+                "note": "Category is the marketplace shelf, from apps."
+            },
+            {
+                "name": "pricingModel",
+                "type": "string",
+                "note": "PricingModel, PriceCents, PriceCurrency and BillingInterval are what this version costs a merchant. THIS ROUTE IS A FULL REPLACEMENT, and that includes the price: a client that omits `pricingModel` is saying free, exactly as one that…"
+            },
+            {
+                "name": "priceCents",
+                "type": "number"
+            },
+            {
+                "name": "priceCurrency",
+                "type": "string"
+            },
+            {
+                "name": "billingInterval",
+                "type": "string"
+            }
+        ],
+        "source": "go",
+        "goType": "versionInput"
+    },
+    "post:/api/orgs/{orgId}/apps/{appId}/versions/{versionId}/images": {
+        "fields": [
+            {
+                "name": "version",
+                "type": "string"
+            },
+            {
+                "name": "scopes",
+                "type": "string[]"
+            },
+            {
+                "name": "embedUrl",
+                "type": "string"
+            },
+            {
+                "name": "redirectUri",
+                "type": "string"
+            },
+            {
+                "name": "summary",
+                "type": "string"
+            },
+            {
+                "name": "description",
+                "type": "string"
+            },
+            {
+                "name": "category",
+                "type": "string",
+                "note": "Category is the marketplace shelf, from apps."
+            },
+            {
+                "name": "pricingModel",
+                "type": "string",
+                "note": "PricingModel, PriceCents, PriceCurrency and BillingInterval are what this version costs a merchant. THIS ROUTE IS A FULL REPLACEMENT, and that includes the price: a client that omits `pricingModel` is saying free, exactly as one that…"
+            },
+            {
+                "name": "priceCents",
+                "type": "number"
+            },
+            {
+                "name": "priceCurrency",
+                "type": "string"
+            },
+            {
+                "name": "billingInterval",
+                "type": "string"
+            }
+        ],
+        "source": "go",
+        "goType": "versionInput"
+    },
     "post:/api/sites/{siteId}/quizzes": {
         "fields": [
             {
@@ -1790,7 +1894,7 @@ export const REQUEST_SHAPES = {
         "source": "go",
         "goType": "courses.Course"
     },
-    "put:/api/sites/{siteId}/courses/{courseId}/sections/{sectionId}": {
+    "post:/api/sites/{siteId}/courses/{courseId}/sections": {
         "fields": [
             {
                 "name": "id",
@@ -1833,7 +1937,7 @@ export const REQUEST_SHAPES = {
         "source": "go",
         "goType": "courses.Section"
     },
-    "post:/api/sites/{siteId}/courses/{courseId}/sections": {
+    "put:/api/sites/{siteId}/courses/{courseId}/sections/{sectionId}": {
         "fields": [
             {
                 "name": "id",
@@ -1876,7 +1980,7 @@ export const REQUEST_SHAPES = {
         "source": "go",
         "goType": "courses.Section"
     },
-    "put:/api/sites/{siteId}/courses/{courseId}/lessons/{lessonId}": {
+    "post:/api/sites/{siteId}/courses/{courseId}/lessons": {
         "fields": [
             {
                 "name": "id",
@@ -1972,7 +2076,7 @@ export const REQUEST_SHAPES = {
         "source": "go",
         "goType": "courses.Lesson"
     },
-    "post:/api/sites/{siteId}/courses/{courseId}/lessons": {
+    "put:/api/sites/{siteId}/courses/{courseId}/lessons/{lessonId}": {
         "fields": [
             {
                 "name": "id",
@@ -4762,10 +4866,10 @@ export const REQUEST_SHAPES = {
             "updatedAt"
         ]
     },
-    "put:/api/sites/{siteId}/product-categories/{id}/products": {
+    "put:/api/sites/{siteId}/products/{productId}/categories": {
         "fields": [
             {
-                "name": "productIds",
+                "name": "categoryIds",
                 "type": "string[]"
             }
         ],
@@ -4782,6 +4886,16 @@ export const REQUEST_SHAPES = {
         "source": "go",
         "goType": "(inline)"
     },
+    "put:/api/sites/{siteId}/product-categories/{id}/products": {
+        "fields": [
+            {
+                "name": "productIds",
+                "type": "string[]"
+            }
+        ],
+        "source": "go",
+        "goType": "(inline)"
+    },
     "post:/api/sites/{siteId}/product-categories": {
         "fields": [
             {
@@ -6337,6 +6451,30 @@ export const REQUEST_SHAPES = {
         "source": "go",
         "goType": "(inline)"
     },
+    "put:/api/sites/{siteId}/roles/{roleId}": {
+        "fields": [
+            {
+                "name": "name",
+                "type": "string"
+            },
+            {
+                "name": "permissions",
+                "type": "site.Permission[]"
+            }
+        ],
+        "source": "go",
+        "goType": "(inline)"
+    },
+    "put:/api/sites/{siteId}/org": {
+        "fields": [
+            {
+                "name": "orgId",
+                "type": "string"
+            }
+        ],
+        "source": "go",
+        "goType": "(inline)"
+    },
     "put:/api/sites/{id}/owner": {
         "fields": [
             {

package/dist/tools/page.js

@@ -305,17 +305,26 @@ export function registerPageTools(server, ctx) {
         }
         const { patches, touched } = setMany(d, batch);
         // WHERE A HOVER ACTUALLY WENT. Routing it silently would leave a caller
-        // who reads the node back looking for keys in a slot they never wrote to —
-        // and, for the elements with no compiler on either home, believing they
-        // had styled something.
-        const hoverNotes = {};
+        // who reads the node back looking for keys in a slot they never wrote to.
+        //
+        // ONCE PER PROCESS PER ELEMENT TYPE, not once per node. A batch repairing
+        // every button on a page carried ten copies of the same 300-character
+        // paragraph — measured, on this repo's own storefront — which is the shape
+        // `ctx.notices` exists to prevent. The type is the whole content of the
+        // note, so a second copy tells the caller nothing they were not just told,
+        // and the ids it applies to are already in `set`.
+        const hoverTypes = new Set();
         for (const e of batch) {
             if (e.state !== HOVER_STATE || e.namespace !== 'style')
                 continue;
-            const note = hoverRoutingNote(d.doc.nodes[e.id]?.data.type ?? '');
-            if (note)
-                hoverNotes[e.id] = note;
+            const type = d.doc.nodes[e.id]?.data.type ?? '';
+            if (hoverRoutingNote(type))
+                hoverTypes.add(type);
         }
+        const hoverNote = [...hoverTypes]
+            .map((t) => ctx.notices.once(`hover-home:${t}`, hoverRoutingNote(t)))
+            .filter((n) => !!n)
+            .join(' ');
         // THE STICKY WARNING IS COMPUTED AGAINST THE DOCUMENT AS IT WILL BE, so
         // the dry run and the real run say the same thing. A caller who is told
         // only after committing has already shipped a header that does not move.
@@ -346,7 +355,7 @@ export function registerPageTools(server, ctx) {
                 dry_run: true,
                 patches,
                 ...(Object.keys(sw).length ? { warnings: sw } : {}),
-                ...(Object.keys(hoverNotes).length ? { hover: hoverNotes } : {}),
+                ...(hoverNote ? { hover: hoverNote } : {}),
                 ...(note ? { note } : {}),
             });
         }
@@ -360,19 +369,18 @@ export function registerPageTools(server, ctx) {
         }
         if (!edits) {
             const warn = warnings[batch[0].id];
-            const hv = hoverNotes[batch[0].id];
             return text({
                 set: touched[0].keys,
                 rev: d.rev,
                 ...(warn ? { warning: warn } : {}),
-                ...(hv ? { hover: hv } : {}),
+                ...(hoverNote ? { hover: hoverNote } : {}),
             });
         }
         return text({
             set: touched,
             rev: d.rev,
             ...(Object.keys(warnings).length ? { warnings } : {}),
-            ...(Object.keys(hoverNotes).length ? { hover: hoverNotes } : {}),
+            ...(hoverNote ? { hover: hoverNote } : {}),
         });
     });
     server.registerTool('sb_move', {

package/package.json

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