sbuilder-mcp 0.42.0 → 0.44.0

package/CHANGELOG.md

@@ -6,6 +6,26 @@ 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.44.0] - 2026-09-14
+
+### Changed
+- The live-edit socket's auth frame now names the calling harness (client, clientVersion), so the editor's presence bar and cursors can tell Claude Code, Cursor, or another agent apart instead of drawing the same robot glyph for all of them; the fields are omitted entirely when nothing identifies itself, so a client that never identified sends the exact same frame as before.
+
+### Fixed
+- Codegen's config-value vocabulary now provably prefers a platform declaration over a renderer's own (necessarily partial) list wherever both exist for the same key, closing a precedence that was only correct by accident of loop order and could have silently flipped on the next reshuffle; pinned by a new test rather than a runtime check, since an under-report from a renderer-only key is undetectable by construction.
+
+## [0.43.0] - 2026-09-14
+
+### Added
+- The catalog's legal-value vocabulary (sb_traits_for's config_values / specials_values, and sb_set's out-of-vocabulary warning) grows from 3 to 57 entries.
+- spline-scene and the shared background-scene config keys on flex-section, flex-block and dataset-block now carry a full vocabulary: source/effect/gallery/speed/intensity/effectColors, including the 3D shader ids and built-in scene names read out of the runtime island.
+- filter-checkbox, filter-radio, filter-color, filter-tag, select and filter-slider now carry a vocabulary for filterSource (13 values) plus the derived filterValueMode, filterMatch, filterArity and filterBehavior keys; filter-slider is correctly limited to price alone, since a range control cannot express a sort.
+- Codegen now reads a fifth source directory, runtime/src, so a 3D vocabulary that only exists in the browser island is no longer invisible to the catalog; the dirty-checkout and unpublished-commit checks now cover it too.
+
+### Fixed
+- backgroundSceneSource's vocabulary no longer omits its "model" and "spline" values; the previous release read a guard-shaped Go switch as a complete vocabulary and published only two of the key's five legal values, which would have told an agent that setting a spline scene was invalid.
+- Codegen now tells a normalizing switch (which enumerates every legal value) apart from a guard switch (which only tests a subset and falls through for everything else), so a filter-shaped switch can no longer be read as a complete vocabulary.
+
 ## [0.42.0] - 2026-09-14
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,26 @@ 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.44.0] - 2026-09-14
+
+### Changed
+- Frame xác thực của socket live-edit giờ nêu rõ harness đang gọi (client, clientVersion), nhờ đó thanh presence và con trỏ của editor có thể phân biệt Claude Code, Cursor hay một agent khác thay vì vẽ chung một biểu tượng robot cho tất cả; các trường này bị bỏ qua hoàn toàn khi không có gì tự nhận diện, nên một client chưa từng tự nhận diện vẫn gửi đúng frame như trước.
+
+### Fixed
+- Bảng giá trị config của codegen giờ chứng minh được là ưu tiên một khai báo của nền tảng hơn danh sách tự thân (vốn luôn chỉ là một phần) của renderer bất cứ khi nào cả hai cùng tồn tại cho một key, khép lại một thứ tự ưu tiên trước đây chỉ đúng nhờ tình cờ của thứ tự vòng lặp và có thể âm thầm đảo ngược ở lần sắp xếp lại kế tiếp; được ghim bằng một test mới thay vì một kiểm tra lúc chạy, vì việc báo thiếu từ một key chỉ có nguồn renderer là không thể phát hiện được về mặt cấu trúc.
+
+## [0.43.0] - 2026-09-14
+
+### Added
+- Bảng giá trị hợp lệ của catalog (config_values / specials_values của sb_traits_for, và cảnh báo giá trị nằm ngoài bảng của sb_set) tăng từ 3 lên 57 mục.
+- spline-scene và các config key nền cảnh 3D dùng chung trên flex-section, flex-block và dataset-block giờ có đầy đủ bảng giá trị: source/effect/gallery/speed/intensity/effectColors, bao gồm cả các id shader 3D và tên cảnh dựng sẵn đọc ra từ runtime island.
+- filter-checkbox, filter-radio, filter-color, filter-tag, select và filter-slider giờ có bảng giá trị cho filterSource (13 giá trị) cùng các key dẫn xuất filterValueMode, filterMatch, filterArity và filterBehavior; filter-slider được giới hạn đúng còn mỗi price, vì một control dạng khoảng không thể diễn đạt một phép sắp xếp.
+- Codegen giờ đọc thêm thư mục nguồn thứ năm, runtime/src, nhờ đó một bảng giá trị 3D chỉ tồn tại trong browser island không còn vô hình với catalog; các kiểm tra checkout-bẩn và commit-chưa-publish giờ cũng bao phủ thư mục này.
+
+### Fixed
+- Bảng giá trị của backgroundSceneSource không còn thiếu hai giá trị "model" và "spline"; bản phát hành trước đã đọc một switch Go dạng guard như thể một bảng giá trị đầy đủ và chỉ công bố hai trong năm giá trị hợp lệ của key này, khiến một agent tưởng rằng đặt cảnh spline là không hợp lệ.
+- Codegen giờ phân biệt được một switch chuẩn hóa (liệt kê đầy đủ mọi giá trị hợp lệ) với một switch dạng guard (chỉ kiểm tra một tập con rồi rơi qua nhánh mặc định cho mọi trường hợp còn lại), nhờ đó một switch dạng lọc không còn bị đọc nhầm thành một bảng giá trị đầy đủ.
+
 ## [0.42.0] - 2026-09-14
 
 ### Added

package/dist/catalog/elements.generated.js

@@ -36876,19 +36876,6 @@ export const CONFIG_VALUES = {
  * the key.
  */
 export const ELEMENT_VALUES = {
-    "*": {
-        "backgroundSceneSource": {
-            "target": "config",
-            "writeKey": "backgroundSceneSource",
-            "values": [
-                "",
-                "effect",
-                "gallery"
-            ],
-            "fallback": "",
-            "readBy": "nodes/helpers.go:bgSceneColorRule"
-        }
-    },
     "media-dataset": {
         "mediaImageRatio": {
             "target": "config",
@@ -36981,6 +36968,426 @@ export const ELEMENT_VALUES = {
             "readBy": "nodes/tab/html.go:position"
         }
     },
+    "spline-scene": {
+        "source": {
+            "target": "specials",
+            "writeKey": "source",
+            "values": [
+                "effect",
+                "gallery",
+                "model",
+                "spline"
+            ],
+            "readBy": "SCENE_SOURCES (schema/src/elements/spline-scene/meta.ts)"
+        },
+        "effect": {
+            "target": "config",
+            "writeKey": "effect",
+            "values": [
+                "aurora",
+                "gradient-mesh",
+                "particles",
+                "waves"
+            ],
+            "readBy": "EFFECT_IDS (runtime/src/services/effect-shaders.ts)"
+        },
+        "sceneGallery": {
+            "target": "specials",
+            "writeKey": "sceneGallery",
+            "values": [
+                "card",
+                "geometry",
+                "gift",
+                "podium",
+                "sphere",
+                "torus"
+            ],
+            "readBy": "GALLERY_CATALOGUE (runtime/src/services/gallery-scenes.ts)"
+        },
+        "speed": {
+            "target": "config",
+            "writeKey": "speed",
+            "values": [
+                "fast",
+                "normal",
+                "slow"
+            ],
+            "readBy": "SCENE_SPEEDS (schema/src/elements/spline-scene/meta.ts)"
+        },
+        "intensity": {
+            "target": "config",
+            "writeKey": "intensity",
+            "values": [
+                "normal",
+                "soft",
+                "strong"
+            ],
+            "readBy": "SCENE_INTENSITIES (schema/src/elements/spline-scene/meta.ts)"
+        },
+        "effectColors": {
+            "target": "config",
+            "writeKey": "effectColors",
+            "values": [
+                "custom",
+                "theme"
+            ],
+            "readBy": "COLOR_MODES (editor/src/components/inspector/ScenePaletteRows.vue)"
+        }
+    },
+    "*": {
+        "backgroundSceneSource": {
+            "target": "config",
+            "writeKey": "backgroundSceneSource",
+            "values": [
+                "",
+                "effect",
+                "gallery",
+                "model",
+                "spline"
+            ],
+            "readBy": "BACKGROUND_SCENE_SOURCES (schema/src/elements/backgroundScene.ts)"
+        },
+        "backgroundSceneEffect": {
+            "target": "config",
+            "writeKey": "backgroundSceneEffect",
+            "values": [
+                "aurora",
+                "gradient-mesh",
+                "particles",
+                "waves"
+            ],
+            "readBy": "EFFECT_IDS (runtime/src/services/effect-shaders.ts)"
+        },
+        "backgroundSceneGallery": {
+            "target": "config",
+            "writeKey": "backgroundSceneGallery",
+            "values": [
+                "card",
+                "geometry",
+                "gift",
+                "podium",
+                "sphere",
+                "torus"
+            ],
+            "readBy": "GALLERY_CATALOGUE (runtime/src/services/gallery-scenes.ts)"
+        },
+        "backgroundSceneSpeed": {
+            "target": "config",
+            "writeKey": "backgroundSceneSpeed",
+            "values": [
+                "fast",
+                "normal",
+                "slow"
+            ],
+            "readBy": "SCENE_SPEEDS (schema/src/elements/spline-scene/meta.ts)"
+        },
+        "backgroundSceneIntensity": {
+            "target": "config",
+            "writeKey": "backgroundSceneIntensity",
+            "values": [
+                "normal",
+                "soft",
+                "strong"
+            ],
+            "readBy": "SCENE_INTENSITIES (schema/src/elements/spline-scene/meta.ts)"
+        },
+        "backgroundSceneColors": {
+            "target": "config",
+            "writeKey": "backgroundSceneColors",
+            "values": [
+                "custom",
+                "theme"
+            ],
+            "readBy": "COLOR_MODES (editor/src/components/inspector/ScenePaletteRows.vue)"
+        }
+    },
+    "filter-checkbox": {
+        "filterSource": {
+            "target": "specials",
+            "writeKey": "filterSource",
+            "values": [
+                "attribute",
+                "availability",
+                "blog_category",
+                "brand",
+                "category",
+                "course_level",
+                "course_tag",
+                "custom",
+                "price",
+                "purchase_history",
+                "search",
+                "sort",
+                "tag"
+            ],
+            "readBy": "FILTER_SOURCES + SORT_SOURCE (schema/src/filters/sources.ts)"
+        },
+        "filterValueMode": {
+            "target": "specials",
+            "writeKey": "filterValueMode",
+            "values": [
+                "all",
+                "manual"
+            ],
+            "readBy": "FilterConfig.valueMode (editor/src/features/filters/types.ts)"
+        },
+        "filterMatch": {
+            "target": "specials",
+            "writeKey": "filterMatch",
+            "values": [
+                "all",
+                "any"
+            ],
+            "readBy": "FilterConfig.matchMode (editor/src/features/filters/types.ts)"
+        },
+        "filterArity": {
+            "target": "specials",
+            "writeKey": "filterArity",
+            "values": [
+                "",
+                "multi",
+                "single"
+            ],
+            "readBy": "FilterConfig.arity (editor/src/features/filters/types.ts)"
+        },
+        "filterBehavior": {
+            "target": "specials",
+            "writeKey": "filterBehavior",
+            "values": [
+                "event",
+                "filter"
+            ],
+            "readBy": "FilterConfig.behavior (editor/src/features/filters/types.ts)"
+        }
+    },
+    "filter-radio": {
+        "filterSource": {
+            "target": "specials",
+            "writeKey": "filterSource",
+            "values": [
+                "attribute",
+                "availability",
+                "blog_category",
+                "brand",
+                "category",
+                "course_level",
+                "course_tag",
+                "custom",
+                "price",
+                "purchase_history",
+                "search",
+                "sort",
+                "tag"
+            ],
+            "readBy": "FILTER_SOURCES + SORT_SOURCE (schema/src/filters/sources.ts)"
+        },
+        "filterValueMode": {
+            "target": "specials",
+            "writeKey": "filterValueMode",
+            "values": [
+                "all",
+                "manual"
+            ],
+            "readBy": "FilterConfig.valueMode (editor/src/features/filters/types.ts)"
+        },
+        "filterMatch": {
+            "target": "specials",
+            "writeKey": "filterMatch",
+            "values": [
+                "all",
+                "any"
+            ],
+            "readBy": "FilterConfig.matchMode (editor/src/features/filters/types.ts)"
+        },
+        "filterArity": {
+            "target": "specials",
+            "writeKey": "filterArity",
+            "values": [
+                "",
+                "multi",
+                "single"
+            ],
+            "readBy": "FilterConfig.arity (editor/src/features/filters/types.ts)"
+        },
+        "filterBehavior": {
+            "target": "specials",
+            "writeKey": "filterBehavior",
+            "values": [
+                "event",
+                "filter"
+            ],
+            "readBy": "FilterConfig.behavior (editor/src/features/filters/types.ts)"
+        }
+    },
+    "filter-color": {
+        "filterSource": {
+            "target": "specials",
+            "writeKey": "filterSource",
+            "values": [
+                "attribute",
+                "availability",
+                "blog_category",
+                "brand",
+                "category",
+                "course_level",
+                "course_tag",
+                "custom",
+                "price",
+                "purchase_history",
+                "search",
+                "sort",
+                "tag"
+            ],
+            "readBy": "FILTER_SOURCES + SORT_SOURCE (schema/src/filters/sources.ts)"
+        },
+        "filterValueMode": {
+            "target": "specials",
+            "writeKey": "filterValueMode",
+            "values": [
+                "all",
+                "manual"
+            ],
+            "readBy": "FilterConfig.valueMode (editor/src/features/filters/types.ts)"
+        },
+        "filterMatch": {
+            "target": "specials",
+            "writeKey": "filterMatch",
+            "values": [
+                "all",
+                "any"
+            ],
+            "readBy": "FilterConfig.matchMode (editor/src/features/filters/types.ts)"
+        },
+        "filterArity": {
+            "target": "specials",
+            "writeKey": "filterArity",
+            "values": [
+                "",
+                "multi",
+                "single"
+            ],
+            "readBy": "FilterConfig.arity (editor/src/features/filters/types.ts)"
+        },
+        "filterBehavior": {
+            "target": "specials",
+            "writeKey": "filterBehavior",
+            "values": [
+                "event",
+                "filter"
+            ],
+            "readBy": "FilterConfig.behavior (editor/src/features/filters/types.ts)"
+        }
+    },
+    "filter-tag": {
+        "filterSource": {
+            "target": "specials",
+            "writeKey": "filterSource",
+            "values": [
+                "attribute",
+                "availability",
+                "blog_category",
+                "brand",
+                "category",
+                "course_level",
+                "course_tag",
+                "custom",
+                "price",
+                "purchase_history",
+                "search",
+                "sort",
+                "tag"
+            ],
+            "readBy": "FILTER_SOURCES + SORT_SOURCE (schema/src/filters/sources.ts)"
+        },
+        "filterValueMode": {
+            "target": "specials",
+            "writeKey": "filterValueMode",
+            "values": [
+                "all",
+                "manual"
+            ],
+            "readBy": "FilterConfig.valueMode (editor/src/features/filters/types.ts)"
+        },
+        "filterMatch": {
+            "target": "specials",
+            "writeKey": "filterMatch",
+            "values": [
+                "all",
+                "any"
+            ],
+            "readBy": "FilterConfig.matchMode (editor/src/features/filters/types.ts)"
+        },
+        "filterArity": {
+            "target": "specials",
+            "writeKey": "filterArity",
+            "values": [
+                "",
+                "multi",
+                "single"
+            ],
+            "readBy": "FilterConfig.arity (editor/src/features/filters/types.ts)"
+        },
+        "filterBehavior": {
+            "target": "specials",
+            "writeKey": "filterBehavior",
+            "values": [
+                "event",
+                "filter"
+            ],
+            "readBy": "FilterConfig.behavior (editor/src/features/filters/types.ts)"
+        }
+    },
+    "select": {
+        "filterSource": {
+            "target": "specials",
+            "writeKey": "filterSource",
+            "values": [
+                "attribute",
+                "availability",
+                "blog_category",
+                "brand",
+                "category",
+                "course_level",
+                "course_tag",
+                "custom",
+                "price",
+                "purchase_history",
+                "search",
+                "sort",
+                "tag"
+            ],
+            "readBy": "FILTER_SOURCES + SORT_SOURCE (schema/src/filters/sources.ts)"
+        },
+        "filterBehavior": {
+            "target": "specials",
+            "writeKey": "filterBehavior",
+            "values": [
+                "event",
+                "filter"
+            ],
+            "readBy": "FilterConfig.behavior (editor/src/features/filters/types.ts)"
+        },
+        "dropdown_align": {
+            "target": "config",
+            "writeKey": "panelAlign",
+            "values": [
+                "left",
+                "center",
+                "right"
+            ],
+            "readBy": "dropdown_align (editor picker)"
+        }
+    },
+    "filter-slider": {
+        "filterSource": {
+            "target": "specials",
+            "writeKey": "filterSource",
+            "values": [
+                "price"
+            ],
+            "readBy": "FILTER_SOURCES valueMode:\"range\" (schema/src/filters/sources.ts)"
+        }
+    },
     "cart-total": {
         "cart_total_part": {
             "target": "specials",
@@ -37125,18 +37532,6 @@ export const ELEMENT_VALUES = {
             "readBy": "anchored_placement (editor picker)"
         }
     },
-    "select": {
-        "dropdown_align": {
-            "target": "config",
-            "writeKey": "panelAlign",
-            "values": [
-                "left",
-                "center",
-                "right"
-            ],
-            "readBy": "dropdown_align (editor picker)"
-        }
-    },
     "search-keywords": {
         "keyword_action": {
             "target": "specials",

package/dist/transport/socket.js

@@ -1,3 +1,12 @@
+/**
+ * One connection to the editor's live-edit room.
+ *
+ * The browser-shaped surface narrowed to a `SocketLike` so tests can drive a
+ * hand-written fake — fire `onopen`, deliver a message, fire `onclose` at a
+ * chosen moment — with no network and no server. This is the editor's own
+ * testing seam, and it is why every rule below has a test rather than a comment.
+ */
+import { agentIdentity } from './identity.js';
 /** WebSocket.OPEN per spec, as a literal so this module never reads a global. */
 const OPEN = 1;
 const RETRY_BASE_MS = 500;
@@ -39,7 +48,35 @@ export class RealtimeSocket {
             // Auth is the FIRST message, never a header (a browser cannot set one on a
             // WebSocket) and never a query parameter (a token in a URL lands in logs).
             // The server enforces a 5s deadline, so it goes out immediately.
-            ws.send(JSON.stringify({ t: 'auth', token: this.token() }));
+            //
+            // WHICH HARNESS, because the room draws one robot for all of them.
+            // `identityHeaders` rides on every HTTP call and CANNOT reach this socket
+            // — the header door is the very one the paragraph above closes — so the
+            // frame carries it instead. The editor paints 🤖 for `kind === 'agent'`
+            // (`PresenceBar.vue`, `PeerCursors.vue`) whether the peer is Claude Code,
+            // Cursor or a cron job, so a merchant watching their canvas move cannot
+            // tell which of their tools is doing it.
+            //
+            // ADDITIVE BY CONSTRUCTION, the same property `Peer.Kind` shipped on:
+            // `realtime.Decode` is a plain `json.Unmarshal` with no
+            // `DisallowUnknownFields`, so every deployed server IGNORES these two
+            // today and a later one reads them without this client changing again.
+            // Omitted rather than sent blank when the client named nothing — a client
+            // that identified itself and one that did not must not look alike, which
+            // is the same rule `identityHeaders` follows.
+            //
+            // A LABEL AND NEVER A CLAIM. `kind` is derived server-side from the
+            // credential (`auth.Authorize`), which is what makes it trustworthy;
+            // this is asserted by the caller and must never gate anything. It is the
+            // same string `X-Agent-Client` already puts on every HTTP request, so the
+            // socket is catching up with what the platform is told regardless.
+            const id = agentIdentity();
+            ws.send(JSON.stringify({
+                t: 'auth',
+                token: this.token(),
+                ...(id.client ? { client: id.client } : {}),
+                ...(id.clientVersion ? { clientVersion: id.clientVersion } : {}),
+            }));
         };
         ws.onmessage = (ev) => {
             // A frame ARRIVING is the only evidence this connection is usable. An open

package/package.json

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