sbuilder-mcp 0.61.0 → 0.61.1

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.61.1] - 2026-09-17
+
+### Added
+- `sb_connect` now reports how old the generated catalog's platform knowledge is, in words (e.g. "45 days old"), along with the web_builder commit it was generated from, so a stale install reads as staleness instead of as a missing element or key.
+- `sb_set`'s precondition warning now also covers `filterMatch: "all"` on filter elements, which only takes effect where a product can hold several of a source's values.
+
+### Fixed
+- `sb_set`'s precondition warning no longer reports a false positive when a sibling `specials` key is simply unset, since a `null` clause now correctly means "not set" instead of being compared as a literal value.
+
 ## [0.61.0] - 2026-09-16
 
 ### 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.61.1] - 2026-09-17
+
+### Added
+- `sb_connect` giờ báo cáo kiến thức nền tảng của catalog được sinh ra đã cũ đến mức nào, bằng lời (ví dụ "45 days old"), cùng với commit web_builder mà nó được sinh ra từ đó, để một bản cài đặt lỗi thời được đọc đúng là lỗi thời thay vì bị hiểu nhầm là thiếu element hay key.
+- Cảnh báo tiền điều kiện của `sb_set` giờ bao phủ thêm `filterMatch: "all"` trên các element bộ lọc, giá trị này chỉ có tác dụng ở nơi một sản phẩm có thể mang nhiều giá trị của một nguồn.
+
+### Fixed
+- Cảnh báo tiền điều kiện của `sb_set` không còn báo sai (false positive) khi một key `specials` liền kề đơn giản là chưa được thiết lập, vì một clause `null` giờ được hiểu đúng là "chưa thiết lập" thay vì bị so sánh như một giá trị literal.
+
 ## [0.61.0] - 2026-09-16
 
 ### Added

package/dist/catalog/deadkeys.generated.js

@@ -1,6 +1,6 @@
 export const DEAD_KEY_SOURCE = {
     "files": 4065,
-    "identifiers": 77969,
+    "identifiers": 77979,
     "seededKeys": 388,
     "dead": 0
 };

package/dist/catalog/elements.generated.js

@@ -36905,6 +36905,38 @@ export const WRITE_PRECONDITIONS = [
             }
         ],
         "otherwise": "no extra row is drawn. It is the way BACK OUT of a browse tree — a link to the category the page is serving — so it needs the page to be followed and the rows to be links. Under in-place filtering, \"everything\" is already what an untouched filter shows."
+    },
+    {
+        "key": "filterMatch",
+        "value": "all",
+        "types": [
+            "filter-checkbox",
+            "filter-radio",
+            "filter-color",
+            "filter-tag"
+        ],
+        "requires": [
+            {
+                "key": "filterSource",
+                "anyOf": [
+                    "category",
+                    "attribute",
+                    "tag",
+                    "blog_category",
+                    "course_tag"
+                ]
+            },
+            {
+                "key": "filterBehavior",
+                "anyOf": [
+                    "filter",
+                    "navigate",
+                    "",
+                    null
+                ]
+            }
+        ],
+        "otherwise": "the filter combines ticked values with OR, as it always did. Both predicates IGNORE the mode outside these cases rather than honouring it — a product holds ONE brand, one price and one stock state, so \"match all\" on two ticked values could only return an empty shelf, and a stale URL degrades to the ordinary OR instead of to a blank page."
     }
 ];
 export const HOVER_HOMES = {

package/dist/catalog/source.generated.js

@@ -0,0 +1,7 @@
+// GENERATED by scripts/gen-catalog.ts — do not edit by hand.
+// The platform commit every other generated file here describes.
+export const PLATFORM_SOURCE = {
+    "commit": "d6a68b77a7a00a6a9ca66da5161d57e845aae628",
+    "committedAt": "2026-09-17T00:01:02+07:00",
+    "dirty": false
+};

package/dist/domains/site/vocabulary.js

@@ -414,6 +414,27 @@ export function deadKeyNote(namespace, key) {
  * not have, and a newer deployment may honour a combination this catalog was
  * generated before. The sentence says what the PAGE does, never "invalid".
  */
+/**
+ * One clause against one stored value — a MIRROR of `holds` in
+ * schema/src/filters/preconditions.ts, and the two must agree.
+ *
+ * `null` in a clause means NOT SET, which is a real state rather than a hole:
+ * a node written before a key existed does not carry it, and both renderers
+ * then read their own fallback. Without this mapping the two copies disagreed
+ * within an hour of being written — this one called a perfectly good tag filter
+ * broken, which is a FALSE POSITIVE and worse than the silence the whole
+ * mechanism replaced, because a caller warned about correct work stops reading
+ * the warnings.
+ *
+ * It is a copy because this package has no runtime dependency on the schema —
+ * the table arrives as generated data. The cases that separate the two are
+ * asserted on both sides (`test/write-preconditions.test.ts` here,
+ * `schema/test/filter-preconditions.test.ts` there) rather than left to the
+ * reading.
+ */
+function holdsClause(c, stored) {
+    return c.anyOf.includes(stored === undefined ? null : stored);
+}
 export function preconditionNotes(type, specials) {
     const out = [];
     for (const p of WRITE_PRECONDITIONS) {
@@ -421,13 +442,15 @@ export function preconditionNotes(type, specials) {
             continue;
         if (specials[p.key] !== p.value)
             continue;
-        const missing = p.requires.filter((c) => !c.anyOf.includes(specials[c.key]));
+        const missing = p.requires.filter((c) => !holdsClause(c, specials[c.key]));
         if (missing.length === 0)
             continue;
         const held = missing
             .map((c) => {
             const now = specials[c.key];
-            const want = c.anyOf.map((v) => JSON.stringify(v)).join(' or ');
+            const want = c.anyOf
+                .map((v) => (v === null ? 'to be left unset' : JSON.stringify(v)))
+                .join(' or ');
             // An ABSENT key is not `null`, and saying so would send a caller looking
             // for a null they never wrote. The platform's own default applies here,
             // which is a different thing to fix than a wrong value.

package/dist/tools/session.js

@@ -2,6 +2,26 @@ import { z } from 'zod';
 import { request } from '../transport/http.js';
 import { text } from '../mcp/response.js';
 import { API_OPERATIONS } from '../catalog/api.generated.js';
+import { PLATFORM_SOURCE } from '../catalog/source.generated.js';
+/**
+ * The provenance line, or '' when the generator had no git to ask.
+ *
+ * Reads as an AGE rather than a commit id, because the age is the actionable
+ * half — nobody can tell whether `d6a68b7` is recent, and everybody can tell
+ * whether four months is. The id rides along for the person who then has to
+ * find it.
+ */
+export function catalogAge(now = new Date()) {
+    const { commit, committedAt, dirty } = PLATFORM_SOURCE;
+    if (!commit || !committedAt)
+        return '';
+    const days = Math.floor((now.getTime() - new Date(committedAt).getTime()) / 86_400_000);
+    const age = days <= 1 ? 'today' : days < 45 ? `${days} days old` : `${Math.floor(days / 30)} months old`;
+    return (`Built from web_builder ${commit.slice(0, 9)} (${committedAt.slice(0, 10)}, ${age})` +
+        (dirty ? ', from an UNCOMMITTED tree — it may describe work no deployment has' : '') +
+        `. The platform reports no version of its own, so nothing here can compare the two: if an ` +
+        `element or key you expect is missing, regenerate rather than working around it.`);
+}
 /**
  * Log in and report what this server can actually reach.
  *
@@ -26,6 +46,7 @@ export async function connect(ctx, args) {
             ...(ctx.siteId ? { site: ctx.siteId } : {}),
             ...(ctx.siteId && ctx.siteName ? { site_name: ctx.siteName } : {}),
             operations: API_OPERATIONS.length,
+            ...(catalogAge() ? { catalog: catalogAge() } : {}),
             note: ctx.siteId
                 ? `Connected with an API key alone, on site ${ctx.siteId} (SB_SITE)${ctx.siteName ? `, the store called ${JSON.stringify(ctx.siteName)}` : ''}. Every tool ` +
                     'defaults to it, so site_id is optional. Set SB_EMAIL and SB_PASSWORD as well if ' +
@@ -71,6 +92,7 @@ export async function connect(ctx, args) {
         sites: (listed?.sites ?? []).map((s) => ({ id: s.id, name: s.name })),
         api_key: ctx.apiKey ? 'present' : 'missing',
         operations: API_OPERATIONS.length,
+        ...(catalogAge() ? { catalog: catalogAge() } : {}),
     };
     if (!ctx.apiKey) {
         result.note =

package/package.json

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