sbuilder-mcp 0.93.0 → 0.95.0

package/CHANGELOG.md

@@ -6,6 +6,24 @@ 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.95.0] - 2026-10-27
+
+### Changed
+- `sb_review` accepts a record-list filter key of the form `f.record.fld_<16 hex>[~<node>]` as an `hrefParams` name, so a card in one record list can link to another list narrowed to its record, and reserved names apply only to plain names.
+- The API catalog is synced with web_builder v1.0.175.
+
+## [0.94.0] - 2026-10-27
+
+### Added
+- `sb_bind` accepts `record.ref.<a>.<b>` and `record.money.ref.<a>.<b>` to bind a field of the record a reference names, reading the referenced collection's fields to check the target, and a text-dataset tile with `recordField: "ref.<a>.<b>"` derives its binding the way the platform does.
+- `sb_review` reports `href_params_invalid`, `href_params_unresolved` and `href_params_stranded` for link parameters (`hrefParams`) that are malformed, have no record to read from, or sit on a button without exactly one click action.
+- `sb_review` reports `record_favorite_invalid` for a favorites heart or tab that is wired wrongly, and `show_record_favorites` requires a `targetId`.
+- Buttons gain the `toggle_record_favorite` and `show_record_favorites` actions, and the element catalog gains the `tags` field type.
+
+### Changed
+- `hrefParams` is treated as an untranslated key, and `filterMatch: "all"` is valid on record sources.
+- The API catalog is synced with web_builder v1.0.174.
+
 ## [0.93.0] - 2026-10-26
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,24 @@ 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.95.0] - 2026-10-27
+
+### Changed
+- `sb_review` chấp nhận khoá lọc danh sách record dạng `f.record.fld_<16 hex>[~<node>]` làm tên `hrefParams`, để thẻ trong một danh sách record liên kết tới danh sách khác đã lọc theo record của nó, và tên dành riêng chỉ áp dụng cho tên thường.
+- Catalog API được đồng bộ với web_builder v1.0.175.
+
+## [0.94.0] - 2026-10-27
+
+### Added
+- `sb_bind` nhận `record.ref.<a>.<b>` và `record.money.ref.<a>.<b>` để bind field của record mà một reference trỏ tới, đọc field của collection được tham chiếu để kiểm tra đích, và tile text-dataset có `recordField: "ref.<a>.<b>"` suy ra binding giống nền tảng.
+- `sb_review` báo `href_params_invalid`, `href_params_unresolved` và `href_params_stranded` cho tham số liên kết (`hrefParams`) sai định dạng, không có record để đọc, hoặc nằm trên button không có đúng một hành động click.
+- `sb_review` báo `record_favorite_invalid` cho nút tim hoặc tab yêu thích nối sai, và `show_record_favorites` yêu cầu `targetId`.
+- Button thêm hai hành động `toggle_record_favorite` và `show_record_favorites`, và catalog element thêm loại field `tags`.
+
+### Changed
+- `hrefParams` được coi là khoá không dịch, và `filterMatch: "all"` hợp lệ trên nguồn record.
+- Catalog API được đồng bộ với web_builder v1.0.174.
+
 ## [0.93.0] - 2026-10-26
 
 ### Added

package/dist/catalog/api.generated.js

@@ -29687,7 +29687,8 @@ export const API_DEFINITIONS = {
             "select",
             "integer",
             "reference",
-            "gallery"
+            "gallery",
+            "tags"
         ],
         "x-enum-varnames": [
             "TypeText",
@@ -29700,7 +29701,8 @@ export const API_DEFINITIONS = {
             "TypeSelect",
             "TypeInteger",
             "TypeReference",
-            "TypeGallery"
+            "TypeGallery",
+            "TypeTags"
         ]
     },
     "github_com_webbuilder_server_internal_collections.UpsertItem": {

package/dist/catalog/deadkeys.generated.js

@@ -1,6 +1,6 @@
 export const DEAD_KEY_SOURCE = {
-    "files": 5992,
-    "identifiers": 110190,
+    "files": 6012,
+    "identifiers": 110443,
     "seededKeys": 460,
     "dead": 0
 };

package/dist/catalog/elements.generated.js

@@ -833,7 +833,9 @@ export const ELEMENTS = {
                 "logout_customer",
                 "toggle_wishlist",
                 "quick_view",
-                "close_quick_view"
+                "close_quick_view",
+                "toggle_record_favorite",
+                "show_record_favorites"
             ]
         },
         "bindingEvents": {
@@ -46050,6 +46052,67 @@ export const RECORD_BINDING_PROBES = [
             }
         ]
     },
+    {
+        "type": "text-dataset",
+        "config": {
+            "datasetSource": "record",
+            "recordField": "ref.fld_0123456789abcdef.fld_0123456789abcdef",
+            "recordFieldType": "text"
+        },
+        "bindings": [
+            {
+                "id": "bind-text",
+                "source": "record.ref.fld_0123456789abcdef.fld_0123456789abcdef",
+                "field": "specials.boundText",
+                "target": {
+                    "type": "record",
+                    "id": "",
+                    "kind": "title"
+                }
+            }
+        ]
+    },
+    {
+        "type": "text-dataset",
+        "config": {
+            "datasetSource": "record",
+            "recordField": "ref.fld_0123456789abcdef.fld_0123456789abcdef",
+            "recordFieldType": "integer",
+            "recordFormat": "money"
+        },
+        "bindings": [
+            {
+                "id": "bind-text",
+                "source": "record.money.ref.fld_0123456789abcdef.fld_0123456789abcdef",
+                "field": "specials.boundText",
+                "target": {
+                    "type": "record",
+                    "id": "",
+                    "kind": "title"
+                }
+            }
+        ]
+    },
+    {
+        "type": "text-dataset",
+        "config": {
+            "datasetSource": "record",
+            "recordField": "ref.fld_0123456789abcdef.fld_0123456789abcdef",
+            "recordFieldType": "richtext"
+        },
+        "bindings": [
+            {
+                "id": "bind-text",
+                "source": "",
+                "field": "specials.boundHtml",
+                "target": {
+                    "type": "record",
+                    "id": "",
+                    "kind": "title"
+                }
+            }
+        ]
+    },
     {
         "type": "collection-media",
         "config": {
@@ -49164,7 +49227,8 @@ export const WRITE_PRECONDITIONS = [
                     "tag",
                     "blog_category",
                     "blog_tag",
-                    "course_tag"
+                    "course_tag",
+                    "record"
                 ]
             },
             {
@@ -49177,7 +49241,7 @@ export const WRITE_PRECONDITIONS = [
                 ]
             }
         ],
-        "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."
+        "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. On a `record` source only a `tags` field honours it."
     }
 ];
 export const HOVER_HOMES = {

package/dist/catalog/search.js

@@ -372,6 +372,11 @@ export function describeOperation(op) {
                 'product priceCents). reference = "rec_…" of a record in the field\'s refCollectionId, ' +
                 'same site; gallery = 1..30 image URLs; date = YYYY-MM-DD. A field\'s type and ' +
                 'refCollectionId cannot change after creation.',
+            tags: 'tags = a multi-select: options REQUIRED (1..100, unique, no comma); a value is a JSON array of ' +
+                'options or one comma-separated string, stored in options order; CSV cell ", "-joined. A page ' +
+                'prints it joined. Filter: filterSource "record", filterAxis = its fld_…, filterValues = its options; ' +
+                'f.record.<fid> matches ANY, fm.record.<fid>=all (specials.filterMatch "all") ALL — only a tags axis ' +
+                'honours all. type is immutable: migrate a text column to a NEW tags field and upsert.',
             revision: 'PUT a record with the rev you read: a different stored rev is 409 stale_record and ' +
                 'nothing is written — re-read and reapply, never retry blind. PUT always needs published.',
             import: 'records/upsert is the idempotent import: EVERY item needs an externalId (1..120, no ' +

package/dist/catalog/shapes.generated.js

@@ -1533,7 +1533,7 @@ export const REQUEST_SHAPES = {
             },
             {
                 "name": "type",
-                "type": "\"text\" | \"richtext\" | \"number\" | \"boolean\" | \"image\" | \"url\" | \"date\" | \"select\" | \"integer\" | \"reference\" | \"gallery\""
+                "type": "\"text\" | \"richtext\" | \"number\" | \"boolean\" | \"image\" | \"url\" | \"date\" | \"select\" | \"integer\" | \"reference\" | \"gallery\" | \"tags\""
             },
             {
                 "name": "required",
@@ -1580,7 +1580,7 @@ export const REQUEST_SHAPES = {
             },
             {
                 "name": "type",
-                "type": "\"text\" | \"richtext\" | \"number\" | \"boolean\" | \"image\" | \"url\" | \"date\" | \"select\" | \"integer\" | \"reference\" | \"gallery\""
+                "type": "\"text\" | \"richtext\" | \"number\" | \"boolean\" | \"image\" | \"url\" | \"date\" | \"select\" | \"integer\" | \"reference\" | \"gallery\" | \"tags\""
             },
             {
                 "name": "required",

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": "e909f77a5b8c33c635657cc906e45b99f6d253d8",
-    "committedAt": "2026-10-26T17:18:35+07:00",
+    "commit": "41847d6540bdc1151bc3b780001a11e1713db217",
+    "committedAt": "2026-10-27T09:30:41+07:00",
     "dirty": false
 };

package/dist/catalog/translations.generated.js

@@ -3,7 +3,7 @@
 export const TRANSLATION_SOURCE = {
     "elements": 68,
     "pairs": 190,
-    "neverKeys": 182,
+    "neverKeys": 183,
     "entityTypes": 12
 };
 /** Every entity type a translation record can name, including "node". */
@@ -440,6 +440,7 @@ export const NEVER_TRANSLATED = [
     "hideWhenEmpty",
     "hoverHostDepth",
     "href",
+    "hrefParams",
     "htmlTag",
     "icon",
     "iconEnabled",

package/dist/domains/site/findings.js

@@ -142,6 +142,17 @@ export const FIX = {
         'namespace config, keys { "recordRelationField": "" }.',
     record_relation_no_empty: 'Give it an empty state: sb_add a "list-empty" into id "<id>" (it becomes config.emptyStateId), ' +
         'e.g. a short "Chưa có dữ liệu" line.',
+    href_params_invalid: 'Rewrite them: sb_set id "<id>", namespace specials, keys { "href": "/<same-site path>", "hrefParams": ' +
+        '[{ "name": "hotel", "source": "record.fld_…" }, { "name": "room", "source": "record.id" }] } — name ' +
+        '^[a-z][a-z0-9_]{0,23}$, unique, not lang/s/t/lesson; source record.id | record.url | record.fld_<16 hex>; ≤ 8. ' +
+        'Pass ids, never names, emails or phones — a query is visible in the address bar and logs.',
+    href_params_unresolved: 'Move it inside a record list\'s card (sb_move), use it on a record detail page, or drop them: sb_set id "<id>", ' +
+        'namespace specials, keys { "hrefParams": [] }.',
+    href_params_stranded: 'Give it ONE click action — open_page or go_to_url (sb_event) — and no purchase binding, or drop them: ' +
+        'sb_set id "<id>", namespace specials, keys { "hrefParams": [] }.',
+    record_favorite_invalid: 'A heart is a button inside a record list\'s card (or on a record page) with click toggle_record_favorite {}; a tab ' +
+        'is a button with show_record_favorites { "targetId": "<record list id, not a relation list>", "view": ' +
+        '"favorites" | "all", "showCount": true } (sb_event id "<id>"). Give the list a list-empty.',
     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 (a number/integer ' +

package/dist/domains/site/navhref.js

@@ -177,6 +177,11 @@ export const PAYLOAD_NEEDS = {
         why: 'publishes a PopupControl call with no target, which opens nothing',
         shape: '{ "id": "<the pop-up\'s overlay id, from sb_store popup>", "label": "<name>" }',
     },
+    show_record_favorites: {
+        key: 'targetId',
+        why: 'publishes a favorites tab aimed at no list, which narrows nothing',
+        shape: '{ "targetId": "<record list-dataset id>", "view": "favorites" | "all", "showCount": true }',
+    },
     scroll_to: {
         key: 'targetId',
         why: 'publishes a ScrollControl call with no target, which scrolls nowhere',

package/dist/domains/site/record.js

@@ -13,9 +13,66 @@ export const RECORD_FIELD_ID = /^fld_[0-9a-f]{16}$/;
  * 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),
  * `record.id` — the row's own record id — or `record.url` — `/records/<id>`, emitted
- * only when the row's collection has a published record detail page (recordContext.ts).
+ * only when the row's collection has a published record detail page (recordContext.ts),
+ * or `record.ref.<refFid>.<fid>` / `record.money.ref.…` — a field of the record a
+ * `reference` field names, one hop, never rich (contract §7.8).
  */
-export const RECORD_SOURCE = /^record\.(?:id|url|(?:html\.|money\.)?fld_[0-9a-f]{16}|(?:money\.)?agg\.[a-z][a-zA-Z0-9_]{0,31})$/;
+export const RECORD_SOURCE = /^record\.(?:id|url|(?:html\.|money\.)?fld_[0-9a-f]{16}|(?:money\.)?agg\.[a-z][a-zA-Z0-9_]{0,31}|(?:money\.)?ref\.fld_[0-9a-f]{16}\.fld_[0-9a-f]{16})$/;
+/** recordContext.ts parseRecordRefAxis — `ref.<referenceFid>.<targetFid>`, else null. */
+export function parseRecordRefAxis(axis) {
+    const m = /^ref\.(fld_[0-9a-f]{16})\.(fld_[0-9a-f]{16})$/.exec(axis);
+    return m ? { ref: m[1], field: m[2] } : null;
+}
+/** recordContext.ts RECORD_REF_TARGET_TYPES — what a `ref.<a>.<b>` tile may show. */
+export const RECORD_REF_TARGET_TYPES = new Set(['text', 'select', 'url', 'date', 'number', 'integer', 'boolean', 'tags']);
+/**
+ * RECORD LINK PARAMETERS (contract §7.6, schema/src/elements/hrefParams.ts).
+ * `specials.hrefParams: [{name, source}]` appends row values to a same-site
+ * `specials.href`; every malformed entry is DROPPED at render, never repaired.
+ */
+export const HREF_PARAM_NAME = /^[a-z][a-z0-9_]{0,23}$/;
+/** A record-list filter key as a name (v1.0.175): `/?f.record.<fld>~<list node>=<record.id>` narrows that list. */
+export const HREF_PARAM_FILTER_KEY = /^f\.record\.fld_[0-9a-f]{16}(?:~[A-Za-z0-9_-]{1,64})?$/;
+export const HREF_PARAM_SOURCE = /^record\.(?:id|url|fld_[0-9a-f]{16})$/;
+export const HREF_PARAM_RESERVED = new Set(['lang', 's', 't', 'lesson']);
+export const MAX_HREF_PARAMS = 8;
+/** hrefParams.ts isSameSitePath — the only hrefs params are appended to. */
+export function isSameSitePath(p) {
+    if (!p.startsWith('/') || p[1] === '/' || p[1] === '\\')
+        return false;
+    return ![...p].some((c) => c.charCodeAt(0) <= 0x20 || c.charCodeAt(0) === 0x7f || c === '\\');
+}
+/** Why entries of `hrefParams` would be dropped at render (hrefWithParams), in the renderer's own order. */
+export function hrefParamProblems(raw) {
+    if (raw === undefined || (Array.isArray(raw) && !raw.length))
+        return [];
+    if (!Array.isArray(raw))
+        return ['specials.hrefParams is not an array of { name, source }'];
+    const out = [];
+    if (raw.length > MAX_HREF_PARAMS)
+        out.push(`only the first ${MAX_HREF_PARAMS} entries are read — ${raw.length - MAX_HREF_PARAMS} more are ignored`);
+    const seen = new Set();
+    for (const item of raw.slice(0, MAX_HREF_PARAMS)) {
+        const { name, source } = (item ?? {});
+        if (typeof name !== 'string') {
+            out.push('an entry has no string name');
+            continue;
+        }
+        if (seen.has(name)) {
+            out.push(`"${name}" is named twice — only the first entry is read`);
+            continue;
+        }
+        seen.add(name);
+        const filterKey = HREF_PARAM_FILTER_KEY.test(name);
+        if (!filterKey && !HREF_PARAM_NAME.test(name))
+            out.push(`name "${name}" is neither ^[a-z][a-z0-9_]{0,23}$ nor a filter key f.record.fld_<16 hex>[~<node>]`);
+        else if (!filterKey && HREF_PARAM_RESERVED.has(name))
+            out.push(`name "${name}" is reserved (lang, s, t, lesson are read by the platform)`);
+        else if (typeof source !== 'string' || !HREF_PARAM_SOURCE.test(source))
+            out.push(`"${name}"'s source "${String(source)}" is not record.id, record.url or record.fld_<16 hex>`);
+    }
+    return out;
+}
 /** An aggregate key — recordAggregates.ts RECORD_AGG_KEY. A tile names it as `agg.<key>`. */
 export const RECORD_AGG_KEY = /^[a-z][a-zA-Z0-9_]{0,31}$/;
 const RECORD_PARAM_NAME = /^[a-z][a-z0-9_]{0,23}$/;
@@ -91,7 +148,9 @@ export function recordTileBindings(type, config, rows) {
     const fid = config.recordField;
     const html = type === 'text-dataset' && config.recordFieldType === 'richtext';
     // An aggregate (`agg.<key>`) is a number on the row — datasetBindings.ts recordSource.
-    const ok = typeof fid === 'string' && (RECORD_FIELD_ID.test(fid) || (!html && recordAggKeyOf(fid) !== ''));
+    // A referenced record's field (`ref.<a>.<b>`) — one hop, never rich.
+    const ok = typeof fid === 'string' &&
+        (RECORD_FIELD_ID.test(fid) || (!html && (recordAggKeyOf(fid) !== '' || parseRecordRefAxis(fid) !== null)));
     // 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) => {
@@ -139,7 +198,9 @@ export function recordScope(nodeAt, id) {
  * stringification is recordContext.ts: gallery emits nothing yet, richtext only
  * under `record.html.`, every other type only under `record.`.
  */
-export function recordFieldProblem(source, scope) {
+export function recordFieldProblem(source, scope, 
+/** The fields of each collection a scope `reference` field targets, by collection id (§7.8). */
+refFields = {}) {
     if (!scope.length) {
         return `"${source}" sits in no record-list row and this is no record detail page — only a list-dataset with datasetSource "record" (or a relation list inside one), or a page of type "record" attached to a collection, supplies a record, so it would render its placeholder.`;
     }
@@ -151,6 +212,21 @@ export function recordFieldProblem(source, scope) {
     const html = source.startsWith('record.html.');
     const money = source.startsWith('record.money.');
     const fid = source.slice(html ? 12 : money ? 13 : 7);
+    const ref = parseRecordRefAxis(fid);
+    if (ref) {
+        const r = scope.flatMap((s) => s.fields).find((x) => x.id === ref.ref);
+        if (!r || r.type !== 'reference')
+            return `${ref.ref} is not a reference field of the collection(s) this row reads.`;
+        const target = r.refCollectionId ?? '';
+        const t = (refFields[target] ?? []).find((x) => x.id === ref.field);
+        if (!t)
+            return `${ref.field} is not a field of ${target || 'the referenced collection'} (what ${r.key} points at).`;
+        if (!RECORD_REF_TARGET_TYPES.has(t.type))
+            return `${ref.field} (${t.key}) is ${t.type} — a referenced field shows only ${[...RECORD_REF_TARGET_TYPES].join(', ')}.`;
+        if (money && !RECORD_MONEY_TYPES.has(t.type))
+            return `${ref.field} (${t.key}) is ${t.type} — record.money. formats only a number or integer field.`;
+        return undefined;
+    }
     const f = scope.flatMap((s) => s.fields).find((x) => x.id === fid);
     if (!f) {
         const avail = scope

package/dist/domains/site/review.js

@@ -7,9 +7,9 @@ import { SEED_COPY_VI, langOf } from './seedcopy.js';
 import { HOVER_STATE, hoverHome } from './hover.js';
 import { ELEMENTS, BINDING_SOURCES, BOUND_SPECIALS, FIRST_CHILD_ONLY, SATELLITE_RULES, ELEMENT_SEEDS } from '../../catalog/elements.generated.js';
 import { fill } from './findings.js';
-import { isRecordSource, readRecordAggregates, recordAggKeyOf, recordAggregateParams, RECORD_FIELD_ID, RECORD_HTML_SOURCE, RECORD_SOURCE, RECORD_TILES, } from './record.js';
+import { hrefParamProblems, isRecordSource, isSameSitePath, parseRecordRefAxis, readRecordAggregates, recordAggKeyOf, recordAggregateParams, RECORD_FIELD_ID, RECORD_HTML_SOURCE, RECORD_SOURCE, RECORD_TILES, recordScope, } from './record.js';
 import { formFieldFindings } from './formdoc.js';
-import { deadNavigation, liveEventTable, PAYLOAD_NEEDS } from './navhref.js';
+import { deadNavigation, hasPurchaseBinding, liveEventTable, PAYLOAD_NEEDS, soleNavigationClick } from './navhref.js';
 import { unknownValueNote, unknownWriteNote, vocabularyFor, vocabularyForWrite } from './vocabulary.js';
 import { iconNote } from './icons.js';
 /**
@@ -813,6 +813,65 @@ opts = {}) {
                     });
                 }
             }
+            // RECORD LINK PARAMETERS and VISITOR FAVORITES (web_builder v1.0.174, contract §7.6/§7.7).
+            // Both read the record of the row they sit in — or the page's, on a record page.
+            {
+                const sp = (n.specials ?? {});
+                const nodeAt = (x) => d.nodes[x];
+                let list = n.data.parent;
+                while (list && d.nodes[list] && d.nodes[list].data.type !== 'list-dataset')
+                    list = d.nodes[list].data.parent;
+                const hasRecord = recordScope(nodeAt, id).length > 0 || (opts.pageType === 'record' && !list);
+                const evs = n.events ?? [];
+                const binds = n.bindings ?? [];
+                const params = sp.hrefParams;
+                if (Array.isArray(params) ? params.length > 0 : params !== undefined) {
+                    const why = hrefParamProblems(params);
+                    // A bound path (record.url) is the platform's own same-site address.
+                    const boundHref = binds.some((b) => b?.field === 'specials.href');
+                    if (!boundHref && !isSameSitePath(String(sp.href ?? '')))
+                        why.push(`specials.href "${String(sp.href ?? '')}" is not a same-site path ("/…"), so no param is ever added`);
+                    if (why.length)
+                        out.push({ code: 'href_params_invalid', nodeId: id, type, problem: `Link parameters the renderer drops: ${why.join('; ')}.`, fix: fill('href_params_invalid', { id }) });
+                    if (!hasRecord)
+                        out.push({
+                            code: 'href_params_unresolved',
+                            nodeId: id,
+                            type,
+                            problem: 'specials.hrefParams on a node in no record-list row and not on a record page — no record supplies a value, so the link carries no params.',
+                            fix: fill('href_params_unresolved', { id }),
+                        });
+                    const purchase = hasPurchaseBinding(binds);
+                    if (purchase || (evs.some((e) => e?.name === 'click') && !soleNavigationClick(evs, false)))
+                        out.push({
+                            code: 'href_params_stranded',
+                            nodeId: id,
+                            type,
+                            problem: `specials.hrefParams are not applied: ${purchase ? 'the node is purchase-bound' : 'its click is not ONE Open page / Go to URL action'}, so the href never renders as the link.`,
+                            fix: fill('href_params_stranded', { id }),
+                        });
+                }
+                for (const ev of evs) {
+                    if (ev?.name !== 'click')
+                        continue;
+                    const why = [];
+                    if (ev.action === 'toggle_record_favorite' && !hasRecord)
+                        why.push('the heart sits in no record-list row and not on a record page, so it publishes nothing');
+                    if (ev.action === 'show_record_favorites') {
+                        const p = ev.payload ?? {};
+                        const t = String(p.targetId ?? '');
+                        const tc = d.nodes[t]?.config;
+                        if (t && (d.nodes[t]?.data.type !== 'list-dataset' || tc?.datasetSource !== 'record'))
+                            why.push(`targetId "${t}" is not a record list on this page`);
+                        else if (t && String(tc?.recordRelationField ?? ''))
+                            why.push(`targetId "${t}" is a relation list, which ignores favorites`);
+                        if (p.view !== 'favorites' && p.view !== 'all')
+                            why.push(`view "${String(p.view)}" is neither "favorites" nor "all"`);
+                    }
+                    if (why.length)
+                        out.push({ code: 'record_favorite_invalid', nodeId: id, type, problem: `Its "${String(ev.action)}" does nothing: ${why.join('; ')}.`, key: String(ev.action), fix: fill('record_favorite_invalid', { id }) });
+                }
+            }
             if (RECORD_TILES.has(type) && cfg.datasetSource === 'record') {
                 const fid = cfg.recordField;
                 const aggKey = typeof fid === 'string' ? recordAggKeyOf(fid) : '';
@@ -833,7 +892,7 @@ opts = {}) {
                         fix: fill('record_field_unset', { id }),
                     });
                 }
-                else if (!aggKey && (typeof fid !== 'string' || !RECORD_FIELD_ID.test(fid))) {
+                else if (!aggKey && (typeof fid !== 'string' || (!RECORD_FIELD_ID.test(fid) && !parseRecordRefAxis(fid)))) {
                     out.push({
                         code: 'record_field_unset',
                         nodeId: id,

package/dist/tools/live.js

@@ -3,7 +3,7 @@ import { z } from 'zod';
 import { text, images } from '../mcp/response.js';
 import { BINDING_SOURCES, ELEMENTS } from '../catalog/elements.generated.js';
 import { bindableFields } from '../domains/site/writecheck.js';
-import { isRecordSource, RECORD_HTML_SOURCE, RECORD_SOURCE, recordFieldProblem, recordScope, } from '../domains/site/record.js';
+import { isRecordSource, parseRecordRefAxis, RECORD_HTML_SOURCE, RECORD_SOURCE, recordFieldProblem, recordScope, } from '../domains/site/record.js';
 import { previewUrl } from '../vision/preview.js';
 import { uploadMedia } from '../transport/media.js';
 import { request } from '../transport/http.js';
@@ -69,7 +69,8 @@ export function bindNode(doc, id, source, field, action, guard) {
         if (!RECORD_SOURCE.test(source)) {
             throw new Error(`sbuilder: "${source}" names no record field. A record source is "record.fld_<16 hex>" ` +
                 '(or "record.html.fld_<16 hex>" for a richtext field) — the field ID from ' +
-                'GET …/collections/{id}/fields, never its key — or "record.id", the row\'s own record id; ' +
+                'GET …/collections/{id}/fields, never its key — or "record.id", the row\'s own record id, or ' +
+                '"record.ref.<reference fld_>.<target fld_>" (and its record.money.ref. form), a field of the record a reference names; ' +
                 'anything else binds nothing.');
         }
         // record.html.<fid> is HTML: in a text sink its tags print as text.
@@ -771,10 +772,27 @@ export function registerLiveTools(server, ctx, session) {
                     throw new Error(`sbuilder: could not read the fields to check "${source}" against: ${msg}`);
                 });
             }
+            // A REFERENCED record's field (contract §7.8): its target is a field of the
+            // reference's refCollectionId, so that collection's fields are read too.
+            const refFields = {};
+            const ref = parseRecordRefAxis(source.replace(/^record\.(?:money\.)?/, ''));
+            const target = ref && withFields?.flatMap((s) => s.fields).find((f) => f.id === ref.ref)?.refCollectionId;
+            if (target) {
+                try {
+                    const got = (await get(`/collections/${encodeURIComponent(target)}/fields`));
+                    refFields[target] = got.fields ?? [];
+                }
+                catch (e) {
+                    const msg = e instanceof Error ? e.message : String(e);
+                    soft(guard, () => {
+                        throw new Error(`sbuilder: could not read ${target}'s fields to check "${source}" against: ${msg}`);
+                    });
+                }
+            }
             if (withFields) {
                 const fields = withFields;
                 soft(guard, () => {
-                    const why = recordFieldProblem(source, fields);
+                    const why = recordFieldProblem(source, fields, refFields);
                     if (why)
                         throw new Error(`sbuilder: ${why}`);
                 });

package/package.json

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