sbuilder-mcp 0.90.0 → 0.91.0

package/CHANGELOG.md

@@ -6,6 +6,17 @@ 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.91.0] - 2026-10-23
+
+### Added
+- `sb_bind` accepts `record.money.<fid>` for number and integer Collections fields, showing the stored whole-unit value as money in the site's base currency (1850000 renders as 1.850.000 ₫).
+- `sb_review` reports `record_filter_invalid` for filter and sort controls aimed at a record list whose axis is not an ID field, whose target is not a collection record list or is a relation list, whose behaviour is not `filter`, or whose sort value is not `<fieldId>_asc|desc`.
+- Filter controls accept `filterSource: "record"` to filter and sort record lists through the `?f.record.<fld>~<list>=…&s.<list>=<fld>_desc&p.<list>=2` URL contract.
+
+### Changed
+- `sb_set` re-derives a text record tile's binding when `recordFormat`, `recordField` or `recordFieldType` changes, so choosing `recordFormat: "money"` switches it to `record.money.<fid>`.
+- The API catalog is synced with web_builder v1.0.171, and `recordFormat` is now a base-only config key.
+
 ## [0.90.0] - 2026-10-22
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,17 @@ 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.91.0] - 2026-10-23
+
+### Added
+- `sb_bind` nhận `record.money.<fid>` cho field number và integer của Collections, hiển thị giá trị đã lưu (đơn vị nguyên) thành tiền theo tiền tệ gốc của site (1850000 hiện là 1.850.000 ₫).
+- `sb_review` báo `record_filter_invalid` cho control lọc và sắp xếp nhắm vào danh sách record mà axis không phải ID field, target không phải danh sách record của collection hoặc là relation list, behaviour khác `filter`, hay giá trị sort không theo `<fieldId>_asc|desc`.
+- Các control lọc nhận `filterSource: "record"` để lọc và sắp xếp danh sách record qua hợp đồng URL `?f.record.<fld>~<list>=…&s.<list>=<fld>_desc&p.<list>=2`.
+
+### Changed
+- `sb_set` suy lại binding của tile text record khi `recordFormat`, `recordField` hoặc `recordFieldType` đổi, nên chọn `recordFormat: "money"` chuyển binding sang `record.money.<fid>`.
+- Catalog API được đồng bộ với web_builder v1.0.171, và `recordFormat` nay là khoá config base-only.
+
 ## [0.90.0] - 2026-10-22
 
 ### Added

package/dist/catalog/appscaffolds.generated.js

@@ -53,6 +53,7 @@ export const APP_SCAFFOLDS = {
                             "kind": "title",
                             "recordField": "",
                             "recordFieldType": "",
+                            "recordFormat": "",
                             "textValue": "",
                             "descriptionDisplayType": "Full",
                             "descriptionLines": 3,
@@ -98,6 +99,7 @@ export const APP_SCAFFOLDS = {
                             "kind": "summary",
                             "recordField": "",
                             "recordFieldType": "",
+                            "recordFormat": "",
                             "textValue": "",
                             "descriptionDisplayType": "Full",
                             "descriptionLines": 3,
@@ -143,6 +145,7 @@ export const APP_SCAFFOLDS = {
                             "kind": "price",
                             "recordField": "",
                             "recordFieldType": "",
+                            "recordFormat": "",
                             "textValue": "",
                             "descriptionDisplayType": "Full",
                             "descriptionLines": 3,
@@ -238,6 +241,7 @@ export const APP_SCAFFOLDS = {
                             "kind": "description",
                             "recordField": "",
                             "recordFieldType": "",
+                            "recordFormat": "",
                             "textValue": "",
                             "descriptionDisplayType": "Full",
                             "descriptionLines": 3,
@@ -571,6 +575,7 @@ export const APP_SCAFFOLDS = {
                             "kind": "title",
                             "recordField": "",
                             "recordFieldType": "",
+                            "recordFormat": "",
                             "textValue": "",
                             "descriptionDisplayType": "Full",
                             "descriptionLines": 3,
@@ -616,6 +621,7 @@ export const APP_SCAFFOLDS = {
                             "kind": "price",
                             "recordField": "",
                             "recordFieldType": "",
+                            "recordFormat": "",
                             "textValue": "",
                             "descriptionDisplayType": "Full",
                             "descriptionLines": 3,

package/dist/catalog/deadkeys.generated.js

@@ -1,7 +1,7 @@
 export const DEAD_KEY_SOURCE = {
-    "files": 5932,
-    "identifiers": 109368,
-    "seededKeys": 453,
+    "files": 5944,
+    "identifiers": 109564,
+    "seededKeys": 454,
     "dead": 0
 };
 /**

package/dist/catalog/elements.generated.js

@@ -36144,6 +36144,7 @@ export const ELEMENTS = {
                 "kind": "title",
                 "recordField": "",
                 "recordFieldType": "",
+                "recordFormat": "",
                 "textValue": "",
                 "descriptionDisplayType": "Full",
                 "descriptionLines": 3,
@@ -37197,6 +37198,7 @@ export const ELEMENTS = {
                             "datasetSource",
                             "recordField",
                             "recordFieldType",
+                            "recordFormat",
                             "textValue",
                             "descriptionDisplayType",
                             "descriptionLines",
@@ -37221,6 +37223,7 @@ export const ELEMENTS = {
                             "datasetSource",
                             "recordField",
                             "recordFieldType",
+                            "recordFormat",
                             "textValue",
                             "descriptionDisplayType",
                             "descriptionLines",
@@ -37245,6 +37248,7 @@ export const ELEMENTS = {
                             "datasetSource",
                             "recordField",
                             "recordFieldType",
+                            "recordFormat",
                             "textValue",
                             "descriptionDisplayType",
                             "descriptionLines",
@@ -37268,6 +37272,7 @@ export const ELEMENTS = {
                             "datasetSource",
                             "recordField",
                             "recordFieldType",
+                            "recordFormat",
                             "textValue",
                             "descriptionDisplayType",
                             "descriptionLines",
@@ -37284,7 +37289,8 @@ export const ELEMENTS = {
                         "key": "record",
                         "label": "Data",
                         "controls": [
-                            "record_field"
+                            "record_field",
+                            "record_format"
                         ]
                     },
                     {
@@ -37404,6 +37410,7 @@ export const ELEMENTS = {
             "datasetSource",
             "recordField",
             "recordFieldType",
+            "recordFormat",
             "textValue",
             "descriptionDisplayType",
             "descriptionLines",
@@ -37417,6 +37424,7 @@ export const ELEMENTS = {
             "collection",
             "article",
             "record_field",
+            "record_format",
             "description_display",
             "width_select",
             "height_select",
@@ -37457,7 +37465,8 @@ export const ELEMENTS = {
             "Set config.kind to \"title\", \"vendor\", or \"description\"",
             "For a description, set config.descriptionDisplayType to \"Compact\" and config.descriptionLines to clamp it; enable specials.moreButtonEnabled for the toggle",
             "Customise config.moreText / config.lessText and config.icon (the chevron) for the toggle",
-            "Style per state (default / hover / active) via the state switcher"
+            "Style per state (default / hover / active) via the state switcher",
+            "In a record list on a number/integer field, set config.recordFormat to \"money\" to print it in the site currency (record.money.<fieldId>)"
         ],
         "semantics": [
             "product",
@@ -45690,6 +45699,69 @@ export const RECORD_BINDING_PROBES = [
             }
         ]
     },
+    {
+        "type": "text-dataset",
+        "config": {
+            "datasetSource": "record",
+            "recordField": "fld_0123456789abcdef",
+            "recordFieldType": "integer",
+            "recordFormat": "money"
+        },
+        "bindings": [
+            {
+                "id": "bind-text",
+                "source": "record.money.fld_0123456789abcdef",
+                "field": "specials.boundText",
+                "target": {
+                    "type": "record",
+                    "id": "",
+                    "kind": "title"
+                }
+            }
+        ]
+    },
+    {
+        "type": "text-dataset",
+        "config": {
+            "datasetSource": "record",
+            "recordField": "fld_0123456789abcdef",
+            "recordFieldType": "number",
+            "recordFormat": "money"
+        },
+        "bindings": [
+            {
+                "id": "bind-text",
+                "source": "record.money.fld_0123456789abcdef",
+                "field": "specials.boundText",
+                "target": {
+                    "type": "record",
+                    "id": "",
+                    "kind": "title"
+                }
+            }
+        ]
+    },
+    {
+        "type": "text-dataset",
+        "config": {
+            "datasetSource": "record",
+            "recordField": "fld_0123456789abcdef",
+            "recordFieldType": "text",
+            "recordFormat": "money"
+        },
+        "bindings": [
+            {
+                "id": "bind-text",
+                "source": "record.fld_0123456789abcdef",
+                "field": "specials.boundText",
+                "target": {
+                    "type": "record",
+                    "id": "",
+                    "kind": "title"
+                }
+            }
+        ]
+    },
     {
         "type": "text-dataset",
         "config": {
@@ -49547,6 +49619,7 @@ export const ELEMENT_VALUES = {
                 "custom",
                 "price",
                 "purchase_history",
+                "record",
                 "search",
                 "sort",
                 "tag"
@@ -49618,6 +49691,7 @@ export const ELEMENT_VALUES = {
                 "custom",
                 "price",
                 "purchase_history",
+                "record",
                 "search",
                 "sort",
                 "tag"
@@ -49689,6 +49763,7 @@ export const ELEMENT_VALUES = {
                 "custom",
                 "price",
                 "purchase_history",
+                "record",
                 "search",
                 "sort",
                 "tag"
@@ -49760,6 +49835,7 @@ export const ELEMENT_VALUES = {
                 "custom",
                 "price",
                 "purchase_history",
+                "record",
                 "search",
                 "sort",
                 "tag"
@@ -49831,6 +49907,7 @@ export const ELEMENT_VALUES = {
                 "custom",
                 "price",
                 "purchase_history",
+                "record",
                 "search",
                 "sort",
                 "tag"
@@ -50091,6 +50168,7 @@ export const BASE_ONLY_CONFIG = [
     "openItems",
     "kind",
     "datasetSource",
+    "recordFormat",
     "collectionId",
     "collectionType",
     "quantity",

package/dist/catalog/overlays.generated.js

@@ -363,6 +363,7 @@ export const OVERLAY_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "Product name",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -1354,6 +1355,7 @@ export const OVERLAY_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -1769,6 +1771,7 @@ export const OVERLAY_SEEDS = {
                     "kind": "description",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -2409,6 +2412,7 @@ export const CART_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "Product name",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -3245,6 +3249,7 @@ export const CART_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "Product name",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,

package/dist/catalog/shapes.generated.js

@@ -4,7 +4,7 @@ export const SHAPE_SOURCE = {
     "fromHandlers": 334,
     "fromSwaggerOnly": 10,
     "withReadOnly": 29,
-    "structsRead": 3453
+    "structsRead": 3457
 };
 export const REQUEST_SHAPES = {
     "post:/api/sites/{id}/ai-credits/purchase": {

package/dist/catalog/source.generated.js

@@ -1,7 +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": "872f5f0185153ba1509017738dd56f6d91c5b2ff",
-    "committedAt": "2026-10-22T17:57:52+07:00",
+    "commit": "4a6a6b151a18713d4f6c3235f063b870d314a968",
+    "committedAt": "2026-10-23T14:44:15+07:00",
     "dirty": false
 };

package/dist/catalog/storepages.generated.js

@@ -881,6 +881,7 @@ export const PAGE_LAYOUT_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "Article title",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -926,6 +927,7 @@ export const PAGE_LAYOUT_SEEDS = {
                     "kind": "summary",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "Article summary",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -971,6 +973,7 @@ export const PAGE_LAYOUT_SEEDS = {
                     "kind": "date",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "2026-08-13",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -2057,6 +2060,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -2472,6 +2476,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "description",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -2899,6 +2904,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -3334,6 +3340,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "Product name",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -4054,6 +4061,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "Product name",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -4347,6 +4355,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -4607,6 +4616,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "Article title",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -4652,6 +4662,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "summary",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "Article summary",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -4697,6 +4708,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "date",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "2026-08-13",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -4967,6 +4979,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "title",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -5012,6 +5025,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "date",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,
@@ -5057,6 +5071,7 @@ export const STORE_PAGE_SEEDS = {
                     "kind": "description",
                     "recordField": "",
                     "recordFieldType": "",
+                    "recordFormat": "",
                     "textValue": "",
                     "descriptionDisplayType": "Full",
                     "descriptionLines": 3,

package/dist/domains/site/builder.js

@@ -512,9 +512,9 @@ export function baseOnlyKeys(doc, id, keys, opts) {
  * binding is worse.
  */
 function rebindPatch(doc, id, keys) {
-    // `recordField` / `recordFieldType` are a record tile's field axis
-    // (datasetBindings.ts:517-530) — the editor's `setRecordField` heals on both.
-    const touchesAxis = ['kind', 'datasetSource', 'recordField', 'recordFieldType'].some((k) => k in keys);
+    // `recordField` / `recordFieldType` / `recordFormat` are a record tile's field
+    // axis (datasetBindings.ts recordSource) — `setRecordField` / `setRecordFormat` heal on them.
+    const touchesAxis = ['kind', 'datasetSource', 'recordField', 'recordFieldType', 'recordFormat'].some((k) => k in keys);
     if (!touchesAxis)
         return null;
     const node = doc.node(id);

package/dist/domains/site/findings.js

@@ -120,6 +120,10 @@ export const FIX = {
         'datasetSource is "record" — one card template, rows edited as data. Logic the platform has ' +
         'no native control for yet (visitor filters, computed totals) may stay in code, reading ' +
         'GET /_wb/collections/{slug}/records instead of its own copy.',
+    record_filter_invalid: 'Aim it at ONE collection\'s record list(s) and a field: sb_set id "<id>", namespace specials, keys ' +
+        '{ "filterSource": "record", "filterAxis": "fld_…", "filterTargets": ["<list id>"], "filterBehavior": "filter" } — ' +
+        'axis types text/select/reference/url/date/boolean/integer/number. A sort select takes filterValues ' +
+        '[{ "value": "fld_…_asc" | "fld_…_desc", "label": "…" }].',
     record_relation_unset: 'Link it to its parent row: sb_set id "<id>", namespace config, keys { "recordRelationField": "fld_…" } — ' +
         'the ID of a "reference" field in THIS list\'s collection that targets the enclosing list\'s collection ' +
         '(GET /api/sites/{siteId}/collections/{id}/fields, refCollectionId).',
@@ -129,8 +133,8 @@ export const FIX = {
         'e.g. a short "Chưa có dữ liệu" line.',
     record_field_unset: 'Name the field by its ID: sb_set id "<id>", namespace config, keys { "recordField": "fld_…", ' +
         '"recordFieldType": "<the field\'s type>" } — ids and types are on GET /api/sites/{siteId}/collections/{id}/fields. ' +
-        'A text-dataset shows text/richtext/number/integer/boolean/date/select/url/reference (integer prints ' +
-        'unformatted, 3330000); a collection-media shows image. A gallery field binds nothing yet.',
+        'A text-dataset shows text/richtext/number/integer/boolean/date/select/url/reference (a number/integer ' +
+        'prints as money with "recordFormat": "money"); a collection-media shows image. A gallery field binds nothing yet.',
     unread_value: 'Write a value the renderer reads: sb_traits_for "<type>" lists them; sb_set id "<id>" ' +
         'with one, at the same breakpoint it is stored at.',
     unknown_icon: 'Write a real icon name: sb_set id "<id>", namespace <ns>, keys { "<key>": "<name>" } — the ' +

package/dist/domains/site/record.js

@@ -10,10 +10,13 @@
 /** `collections.NewID("fld")` — schema/src/elements/recordContext.ts:33. Anything else binds nothing. */
 export const RECORD_FIELD_ID = /^fld_[0-9a-f]{16}$/;
 /**
- * A `record.*` source a context can supply: `record.<fid>`, `record.html.<fid>`, or
- * `record.id` — the row's own record id (recordContext.ts, web_builder 986c96a96).
+ * A `record.*` source a context can supply: `record.<fid>`, `record.html.<fid>`,
+ * `record.money.<fid>` (a number/integer field formatted in the site's currency),
+ * or `record.id` — the row's own record id (recordContext.ts).
  */
-export const RECORD_SOURCE = /^record\.(?:id|(?:html\.)?fld_[0-9a-f]{16})$/;
+export const RECORD_SOURCE = /^record\.(?:id|(?:html\.|money\.)?fld_[0-9a-f]{16})$/;
+/** The field types `record.money.<fid>` formats — recordContext.ts RECORD_MONEY_FIELD_TYPES. */
+export const RECORD_MONEY_TYPES = new Set(['number', 'integer']);
 /** The only record source `specials.boundHtml` admits — schema/src/rawSinkBindings.ts:102. */
 export const RECORD_HTML_SOURCE = /^record\.html\.fld_[0-9a-f]{16}$/;
 /** The tile elements whose binding the record field drives (editor/src/element/recordList.ts TILE_FIELD_TYPES). */
@@ -33,6 +36,8 @@ export function recordTileBindings(type, config, rows) {
     const fid = config.recordField;
     const ok = typeof fid === 'string' && RECORD_FIELD_ID.test(fid);
     const html = type === 'text-dataset' && config.recordFieldType === 'richtext';
+    // datasetBindings.ts isRecordMoney: a stale recordFormat on any other type is ignored.
+    const money = type === 'text-dataset' && config.recordFormat === 'money' && RECORD_MONEY_TYPES.has(String(config.recordFieldType));
     return rows.map((row) => {
         const b = row;
         if (b.id === 'bind-image')
@@ -40,7 +45,7 @@ export function recordTileBindings(type, config, rows) {
         if (b.id === 'bind-text') {
             return {
                 ...b,
-                source: ok ? `record.${html ? 'html.' : ''}${fid}` : '',
+                source: ok ? `record.${html ? 'html.' : money ? 'money.' : ''}${fid}` : '',
                 field: html ? 'specials.boundHtml' : 'specials.boundText',
             };
         }
@@ -85,7 +90,8 @@ export function recordFieldProblem(source, scope) {
     if (source === 'record.id')
         return undefined;
     const html = source.startsWith('record.html.');
-    const fid = source.slice(html ? 12 : 7);
+    const money = source.startsWith('record.money.');
+    const fid = source.slice(html ? 12 : money ? 13 : 7);
     const f = scope.flatMap((s) => s.fields).find((x) => x.id === fid);
     if (!f) {
         const avail = scope
@@ -95,6 +101,8 @@ export function recordFieldProblem(source, scope) {
     }
     if (f.type === 'gallery')
         return `${fid} (${f.key}) is a gallery field, which the renderers do not bind yet — it emits nothing.`;
+    if (money && !RECORD_MONEY_TYPES.has(f.type))
+        return `${fid} (${f.key}) is ${f.type} — record.money. formats only a number or integer field.`;
     if (html && f.type !== 'richtext')
         return `${fid} (${f.key}) is ${f.type}, not richtext — bind it as "record.${fid}".`;
     if (!html && f.type === 'richtext')

package/dist/domains/site/review.js

@@ -670,6 +670,46 @@ opts = {}) {
                     });
                 }
             }
+            // RECORD FILTERS (web_builder PR #157, contract §7.1): a filter/sort control aimed at a
+            // record list. Every miss below renders a control that empties the list or narrows nothing.
+            {
+                const sp = (n.specials ?? {});
+                const targets = Array.isArray(sp.filterTargets) ? sp.filterTargets.map(String) : [];
+                const recordTargets = targets.filter((t) => {
+                    const c = d.nodes[t]?.config;
+                    return d.nodes[t]?.data.type === 'list-dataset' && c?.datasetSource === 'record';
+                });
+                const why = [];
+                if (sp.filterSource === 'record') {
+                    if (!RECORD_FIELD_ID.test(String(sp.filterAxis ?? '')))
+                        why.push(`filterAxis "${String(sp.filterAxis ?? '')}" is not a field ID`);
+                    if (targets.length && recordTargets.length !== targets.length)
+                        why.push('a filterTargets entry is not a record list');
+                    const cfgOf = (t) => d.nodes[t].config ?? {};
+                    if (recordTargets.some((t) => String(cfgOf(t).recordRelationField ?? '')))
+                        why.push('it targets a relation list');
+                    if (new Set(recordTargets.map((t) => String(cfgOf(t).recordCollectionId ?? ''))).size > 1)
+                        why.push('its targets read different collections');
+                    if (sp.filterBehavior !== undefined && sp.filterBehavior !== 'filter')
+                        why.push(`filterBehavior "${String(sp.filterBehavior)}" — a record filter only narrows ("filter")`);
+                }
+                if (sp.filterSource === 'sort' && recordTargets.length) {
+                    const bad = (Array.isArray(sp.filterValues) ? sp.filterValues : [])
+                        .map((v) => String(v?.value ?? ''))
+                        .filter((v) => !/^fld_[0-9a-f]{16}_(?:asc|desc)$/.test(v));
+                    if (bad.length)
+                        why.push(`sort values ${bad.slice(0, 3).map((v) => `"${v}"`).join(', ')} are not "<fieldId>_asc|desc" — a record list ignores product sort keys`);
+                }
+                if (why.length) {
+                    out.push({
+                        code: 'record_filter_invalid',
+                        nodeId: id,
+                        type,
+                        problem: `A record ${sp.filterSource === 'sort' ? 'sort' : 'filter'} control that narrows nothing or empties its list: ${why.join('; ')}.`,
+                        fix: fill('record_filter_invalid', { id }),
+                    });
+                }
+            }
             if (RECORD_TILES.has(type) && cfg.datasetSource === 'record') {
                 const fid = cfg.recordField;
                 if (typeof fid !== 'string' || !RECORD_FIELD_ID.test(fid)) {

package/package.json

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