@bettercms-ai/mcp 0.74.0 → 0.76.0

package/dist/skills/bettercms/SKILL.md

@@ -43,7 +43,12 @@ Listing tools needs no sign-in; the first tool **call** does.
 4. **A refusal for access: call `whoami` first.** It names the principal, the workspace, the
    scope (project or workspace) and, where visible, the grants (publish, code and deploy,
    sidebar schema), so you can tell the user which one is missing.
-5. **Unsure how a feature works: `search_docs` before guessing.** A tool that fails oddly, a
+5. **"Invalid tool parameters" is the client, not BetterCMS.** A client with tool search (Claude
+   Code) lists most of the 150 tools by name and loads a schema on demand; a call to a tool whose
+   schema it has not loaded is refused before it is sent. Load the tool with the client's tool
+   search, every tool the step needs in one search, then make the same call again. Never change
+   the arguments because of it. The tools a setup starts with are always loaded.
+6. **Unsure how a feature works: `search_docs` before guessing.** A tool that fails oddly, a
    capability you needed and did not have, or docs that misled you: `give_feedback`, and tell the
    user you sent it.
 
@@ -123,7 +128,7 @@ resources: `bettercms://skill/bettercms` for this file, and each reference under
 | Move content out of another CMS (Cosmic, Contentful, Sanity, Strapi, Prismic, WordPress…) | [external-content.md](references/external-content.md) | a CMS SDK in package.json; `envWarning` on import; pages that render empty without a third-party key | Contentful, Sanity, Strapi, envWarning, missing key, empty pages |
 | Read a source site before modelling it | [detection.md](references/detection.md) | converting from a URL or built HTML; deciding what a band, a repeat or a value is | detect, classify, section, repeat, global, carousel clone, hidden state |
 | Pages vs collections, folders, fields, schema changes | [content-modeling.md](references/content-modeling.md) | modelling a route family; a model write returns 409 | schema, model, collection, field, folder, rename, remove field, listing, filter, locked field |
-| Dock layout: groups, rows, tabs, icons, item names, showIf order | [editor-chrome.md](references/editor-chrome.md) | `get_next_steps` lists a `dock-*` rule; the `field-ui` prompt | dock, fieldset, tab, group, itemLabel, showIf, field-ui |
+| Dock layout: groups, rows, tabs, icons, item names, showIf order | [editor-chrome.md](references/editor-chrome.md) | after any import, convert, componentize or extract (the gate's `dock` row); a `dock-*` rule; the `field-ui` prompt | dock, fieldset, tab, group, itemLabel, showIf, field-ui |
 | A custom input for one field in the dock: when, the user's approval, the contract | [dock-input.md](references/dock-input.md) | `get_next_steps` lists `dock-input-candidate`; a 409 `input_needs_confirmation` | custom input, ui.input, dock input, confirmed, swatch |
 | What the server does and does not check on a write | [write-limits.md](references/write-limits.md) | before relying on a limit; reading a refused write; a bulk load or re-run | validation, maxLength, unique, 400, refused write, dry run, externalKey, upsert, re-run |
 | Plan a site by business type | [site-blueprints.md](references/site-blueprints.md) | the IA of a known site type, with its collections, forms and structured data | new site, IA, portfolio, agency, corporate, SaaS, ecommerce, directory, blog, docs, restaurant, events, course, jobs, real estate, nonprofit, multi-brand |

package/dist/skills/bettercms/references/componentize.md

@@ -75,9 +75,14 @@ Never let a component contain itself, directly or through a child.
    `set_component_source` per component is needed. Deploy. A page whose bands could not be
    lifted is wrapped where it stands instead (§5).
 7. Output validation, from step 3 of §6.
+8. Editor chrome, last and not optional: the components this lane made have bare props. Load
+   [editor-chrome.md](editor-chrome.md) and run step 8 of the repair order in
+   [finish-site.md](finish-site.md) for each one; `extract_component` ends the same way.
 
 ## 3. Names and groups
 
+Name each component's closest kit entry as its `kitEntry` (`bettercms://kit/entry/{id}`) and take that entry's ui. When the match is wrong, override it; the `no-kit-match` exemption needs a note.
+
 Name a family by what it is (`Hero`, `CTA`, `Testimonials`) and each variant by how it looks
 (`Hero / Split`, `CTA / Centered`). Never put a page name in a reusable definition; which pages
 use it is a usage question (§8). The componentize lane files a section under its page's slug

package/dist/skills/bettercms/references/finish-site.md

@@ -69,6 +69,7 @@ line), which is what a script waiting on the setup reads.
 | `buttons` | every button field is one of the site's live Button looks, the Button family is the looks setup measured on this build (the same looks, not the same count), and no look is named by a number or a build's class | `blocking.rows`, `route: null` |
 | `components` | the authoring question is answered, and no section is left that a componentize run would place | `blocking.rows`, `route: null` |
 | `forms` | every form of the customer's has an address to notify; a form setup ignored (sign-in, add to basket) is not counted | `blocking.rows`, `route: null` |
+| `dock` | every component with props has at least one prop carrying V2 `ui`, and every list prop (`table`, `array`, `multi-reference`) titles its rows with `ui.preview.title` or `ui.itemLabel`; and every component with props names the `bettercms://kit` entry its dock UI was built from (`update_component { kitEntry }`, `set-kit-entry`), or records `no-kit-match` with a note on `route: "component/<slug>/kit"`; one row per component per half, Button looks not counted | `blocking.rows`, `route: null`, the component, its props and the `bettercms://kit/entry/{id}` to read in `detail` |
 
 `pages` counts routes built, created and published. `coverage` sums `editable` of `total` across
 the site, `svg`, `number` and `attribute` included, and `open` counts the rows still open per
@@ -106,6 +107,7 @@ The other rows name their fix the same way:
 | `derive-buttons` | `editor_setup { force: true }` mints a Button for each look the build draws, retires one it no longer draws and maps each button to its look; rename a look with `update_component` ([components.md](components.md)) |
 | `componentize` | `set_authoring_preference` when nobody answered, then `get_componentize_plan` and `componentize_sections` ([componentize.md](componentize.md)) |
 | `set-form-recipient` | ask the user where the form's submissions go, then `update_form` with `notifyEmails`; `update_form { ignored: true }` when it is not one of their forms |
+| `set-dock-ui` | the last step of the repair order below: `get_component`, then `update_component` with `propUi` and `propTab` for the props the row names ([editor-chrome.md](editor-chrome.md)) |
 
 A row nothing measured reads `unmeasured: true` with `run-setup`, and `gate.unmeasured` lists the
 checks that have one: a release older than a count, or a project set up before setup recorded
@@ -207,8 +209,9 @@ in a sentence a person can verify. `reason: null` withdraws one.
 | `decorative` | `text`, `image`, `svg` |
 | `duplicate-track` | `text`, `image`, `link`, `svg`, `number`, `attribute` (the cloned track of a marquee or slider) |
 | `client-only-island` | nothing: it lists an island the build cannot show, and the route still meets the bar outside it |
-| `user-declined` | `page`, `published`, `text`, `image`, `link`, `svg`, `number`, `attribute`, `seo`, `structuredData`, `collections`, and only with the user's own words quoted in `note` (`User: "leave pricing in code"`) |
+| `user-declined` | `page`, `published`, `text`, `image`, `link`, `svg`, `number`, `attribute`, `seo`, `structuredData`, `collections`, `dock`, and only with the user's own words quoted in `note` (`User: "leave pricing in code"`) |
 | `document-body` | `sections`, and only on a route that places no section at all: a page that is one document (a markdown post, a legal page) |
+| `default-controls` | `dock`, on `route: "component/<slug>"`: a component whose props read right with the dock's default controls (one short heading, a toggle); `note` says why |
 
 Nothing else excuses `sections`, and nothing excuses `style`, `twin`, `names`, `buttons`,
 `components` or `forms`: not the user's decision either. A name is fixed by renaming, and a form
@@ -284,6 +287,7 @@ and add the new result. Update the file as each row moves, so a reset loses at m
 | 5 | Bindings: the site reads BetterCMS data and each intended leaf or attribute is bound; build, preview and runtime agree | [bindings.md](bindings.md), [frameworks.md](frameworks.md) |
 | 6 | Behaviour: forms, links, menus, accordions, modals, consent, custom code | [forms-and-interactions.md](forms-and-interactions.md) |
 | 7 | Discoverability: native SEO, structured data, robots and sitemap, redirects, internal links | [seo.md](seo.md) |
+| 8 | Editor chrome, MANDATORY and last, after any import, convert, componentize or extract: load the reference, and for every component set the V2 `ui` of each prop (control, tab, group, collapsed, layout, preview, itemLabel, icon, and `propHelpText`) by playbook §14 and the nearest `bettercms://kit` entry. The gate's `dock` row stays open until it is done | [editor-chrome.md](editor-chrome.md) |
 
 Load the step's reference when the step starts, and let it go when the step's rows are verified.
 

package/dist/skills/bettercms/references/getting-started.md

@@ -87,6 +87,8 @@ and `get_componentize_plan` proposes nothing more.
 5. Work the rest through [finish-site.md](finish-site.md) (gap ledger, repair order, proof loop).
    The gate's `sections` and `style` rows are part of it: a setup whose pages cannot take a new
    section, a new order or spacing is not finished.
+6. End Phase 3 on the editor chrome of every component (step 8 of finish-site.md's repair order,
+   [editor-chrome.md](editor-chrome.md)): the gate's `dock` row blocks until each has its V2 `ui`.
 
 ### Phase 4 — Publish and verify
 

package/dist/skills/bettercms/references/kit-catalog.md

@@ -92,7 +92,7 @@ Tags: global-synced, conditional, repeater, localized. Proves: Three stacked row
 - A rotating announcement (several messages cycling) is an array, not one string — switch `message` to an array of {message, link} rather than joining with ·.
 - Don't put the account/cart icons in utility links — those are app state; see `nav-ecommerce-header`.
 
-Not carried by a stored component: ai, category, document preview path, item openMode, kind:global.
+Not carried by a stored component: ai, category, item openMode, kind:global.
 
 ### Mega menu with featured cards + promo slot (`nav-mega-featured-promo`)
 
@@ -114,7 +114,7 @@ Tags: deep-nesting, slots, global-synced, conditional, references, variants, com
 - If two menu items share the same panel content, that is still two panels in content; don't invent a shared-panel global for it.
 - Hover-only panels fail keyboard users — the converter should default `openOn` to click when the source has no aria-expanded handling.
 
-Not carried by a stored component: ai, category, kind:global, reference target, slot allow, variants.
+Not carried by a stored component: ai, category, kind:global, shopify reference, variants.
 
 ### Docs sidebar navigation (`nav-docs-sidebar`)
 
@@ -156,7 +156,7 @@ Tags: global-synced, commerce, references, repeater, conditional, media-heavy. P
 - Copying '(2)' from the cart badge into content is the most common converter mistake — it's session state.
 - Free-shipping thresholds belong to commerce settings, not the header; reference them from the renderer.
 
-Not carried by a stored component: category, kind:global, reference target, variants.
+Not carried by a stored component: category, kind:global, shopify reference, variants.
 
 ### Multi-locale header with switchers (`nav-locale-header`)
 
@@ -196,7 +196,7 @@ Tags: responsive-layout, conditional, validation, commerce. Proves: A per-templa
 - 'Add to cart' is an ACTION, not a link — our button type only carries links (gap: action buttons).
 - A bar covering the cookie banner or chat launcher: the renderer must stack them; nothing to model.
 
-Not carried by a stored component: ai, category, document preview path.
+Not carried by a stored component: ai, category.
 
 ### Announcement bar with countdown (`announcement-countdown`)
 
@@ -216,7 +216,7 @@ Tags: global-synced, conditional, validation, repeater, localized, a11y. Proves:
 - Storing the countdown as text ('2 days left') — it's wrong the next day. Always a datetime with offset.
 - Hide-after earlier than the countdown end can't be caught today (gap: cross-field validation).
 
-Not carried by a stored component: ai, category, document preview path, item openMode, kind:global.
+Not carried by a stored component: ai, category, item openMode, kind:global.
 
 ### Cookie consent banner (`cookie-consent`)
 
@@ -338,7 +338,7 @@ Tags: variants, conditional, media-heavy, a11y, repeater. Proves: One media slot
 - A hero with BOTH a background video and a side image is a different section (full-bleed video) — don't merge.
 - Alt text on a decorative hero photo should still describe it when it shows the product.
 
-Not carried by a stored component: ai, category, item settings, variants.
+Not carried by a stored component: ai, category, variants.
 
 ### Centered hero with gradient + screenshot (`hero-centered-gradient`)
 
@@ -359,7 +359,7 @@ Tags: variants, conditional, validation, media-heavy. Proves: Announcement chip
 - Editing the headline can orphan the highlight — the renderer must ignore a highlight that no longer matches (no cross-field validation yet).
 - Don't store raw CSS gradient strings — they can't be re-themed or validated.
 
-Not carried by a stored component: ai, category, document preview path, variants.
+Not carried by a stored component: ai, category, variants.
 
 ### Full-bleed video hero with captions (`hero-video-fullbleed`)
 
@@ -400,7 +400,7 @@ Tags: repeater, media-heavy, conditional, validation, a11y. Proves: Slides array
 - Cloned slides doubling the count — dedupe by image URL + heading.
 - Slide schedules that leave fewer than 2 live slides: the renderer should fall back to a static hero (min can't be enforced over time).
 
-Not carried by a stored component: ai, category, document preview path, fieldset (derived).
+Not carried by a stored component: ai, category, fieldset (derived).
 
 ### Product hero with variant picker (`hero-product`)
 
@@ -421,7 +421,7 @@ Tags: references, commerce, media-heavy, conditional, repeater. Proves: Live com
 - Hard-coding the price in the tagline ('Just $165!') — it goes stale; flag any currency in copy.
 - Picker options are a fixed list here; a product with a 'Handle wrap' option can't be picked until options come from the reference (gap).
 
-Not carried by a stored component: ai, category, document preview path, reference target, variants.
+Not carried by a stored component: ai, category, shopify reference, variants.
 
 ### Search hero (`hero-search`)
 
@@ -460,7 +460,7 @@ Tags: form, references, conditional, validation, repeater. Proves: A form REFERE
 - Copying inputs into the hero's schema — the form then can't be reused or receive submissions properly.
 - Hidden values that contain personal data (an email from the URL) must not be stored in content.
 
-Not carried by a stored component: ai, category, item openMode, item settings, variants.
+Not carried by a stored component: ai, category, item openMode, variants.
 
 ### App download hero (`hero-app-download`)
 
@@ -480,7 +480,7 @@ Tags: media-heavy, conditional, validation, global-synced, repeater. Proves: A f
 - Uploading badge or QR images — they can't be updated and the QR silently breaks when the link changes.
 - Ratings copied from the store go stale; the help text says so because there's no live source.
 
-Not carried by a stored component: ai, category, document preview path, item openMode.
+Not carried by a stored component: ai, category, item openMode.
 
 ### Stats hero (`hero-stats`)
 
@@ -623,7 +623,7 @@ Tags: repeater, conditional, media-heavy, variants, rich-text. Proves: Per-row m
 - Storing `side` on every row breaks the zigzag the moment rows are reordered — store `auto` unless the source deliberately breaks the pattern.
 - Autoplay videos without a poster flash black; always extract or generate a poster.
 
-Not carried by a stored component: ai, category, group (nested), group unused (props), item settings, variants.
+Not carried by a stored component: ai, category, variants.
 
 ### Feature bento (responsive spans) (`bento-feature-showcase`)
 
@@ -644,7 +644,7 @@ Tags: slots, responsive-layout, conditional, media-heavy, variants. Proves: Slot
 - Phones stack cells; if the source reorders them with CSS `order`, capture it or the story reads out of order.
 - 6-column variants need spans up to 6; validate spans against the variant's column count.
 
-Not carried by a stored component: ai, category, slot allow, variants.
+Not carried by a stored component: ai, category, variants.
 
 ### Steps / how it works (`steps-how-it-works`)
 
@@ -683,7 +683,7 @@ Tags: repeater, conditional, media-heavy, validation, rich-text. Proves: Date pr
 - Storing “2014” in a date field becomes 2014-01-01 and later renders as “Jan 1, 2014”.
 - Two milestones with the same year keep their array order as the tie-breaker — keep the array roughly sorted.
 
-Not carried by a stored component: ai, category, group (nested), group unused (props), variants.
+Not carried by a stored component: ai, category, variants.
 
 ### Tabs with media (`tabs-with-media`)
 
@@ -703,7 +703,7 @@ Tags: repeater, conditional, media-heavy, variants, a11y, localized. Proves: Fix
 - Auto-advancing tabs must stop on interaction and respect reduced motion — the renderer handles it; never model a “pause” field.
 - Tab labels longer than ~20 characters wrap on the top variant and break the underline.
 
-Not carried by a stored component: ai, category, group (nested), group unused (props), variants.
+Not carried by a stored component: ai, category, variants.
 
 ### Accordion features with image swap (`accordion-feature-image-swap`)
 
@@ -722,7 +722,7 @@ Tags: repeater, media-heavy, a11y, variants, rich-text. Proves: One required ima
 - Images of different aspect ratios cause the layout to jump on every click — warn when the source images differ.
 - Do not tag these rows as FAQ structured data — they are not questions.
 
-Not carried by a stored component: ai, category, group (nested), group unused (props), variants.
+Not carried by a stored component: ai, category, variants.
 
 ### Comparison vs competitors (`comparison-vs-competitors`)
 
@@ -783,7 +783,7 @@ Tags: conditional, rich-text, variants, localized. Proves: Mode select swaps an
 - Quotation marks typed into content double up with the design's quotes — strip them.
 - Lines split by `<br>` inside one paragraph are still separate lines.
 
-Not carried by a stored component: category, document preview path, item settings, variants.
+Not carried by a stored component: category, variants.
 
 ### Problem → solution (`problem-solution`)
 
@@ -982,7 +982,7 @@ Tags: seo-structured, references, conditional, validation, a11y, commerce. Prove
 - Typed-in ratings drift from the real ones; prefer the connected source and show “Synced …” in the UI.
 - Distribution counts that don't sum to the total look fake; validate the sum.
 
-Not carried by a stored component: category, item openMode, itemNoun (derived), reference target, variants.
+Not carried by a stored component: category, item openMode, itemNoun (derived), shopify reference, variants.
 
 ## Media & galleries
 
@@ -1005,7 +1005,7 @@ Tags: media-heavy, a11y, responsive-layout, repeater, validation, localized. Pro
 - Credits pasted into captions get translated; keep them in the credit object.
 - Empty alt is right for decorative photos but wrong for a portfolio — flag empties for review.
 
-Not carried by a stored component: category, document preview path, validation.items, variants.
+Not carried by a stored component: category, variants.
 
 ### Gallery with category filters (`lightbox-gallery-filters`)
 
@@ -1024,7 +1024,7 @@ Tags: media-heavy, a11y, repeater, validation, localized. Proves: Filters define
 - A photo tagged with a key that no filter defines is invisible under every filter except All — validate keys against the filters.
 - Free-typed keys are error-prone; a select fed by the section's filters is the right control (schema gap).
 
-Not carried by a stored component: category, document preview path, item openMode, validation.items, variants.
+Not carried by a stored component: category, item openMode, variants.
 
 ### Video section (YouTube · Vimeo · hosted) (`video-section`)
 
@@ -1064,7 +1064,7 @@ Tags: media-heavy, a11y, repeater, validation, variants, localized. Proves: Pair
 - Before and after with different crops make the slider useless — dimensions should match (not enforceable in our schema yet).
 - A slider built from a div with mouse events only is not keyboard accessible; the renderer must use a real range input.
 
-Not carried by a stored component: category, document preview path, variants.
+Not carried by a stored component: category, variants.
 
 ### Image with hotspots (shop the look) (`image-hotspots`)
 
@@ -1084,7 +1084,7 @@ Tags: media-heavy, conditional, references, commerce, a11y, validation, variants
 - Copying product price into the note text goes stale; reference the product.
 - Re-cropping the image after placing pins moves every pin. A visual point picker would prevent this (schema gap).
 
-Not carried by a stored component: category, reference target, variants.
+Not carried by a stored component: category, shopify reference, variants.
 
 ### 3D model / Lottie / 360° embed (`interactive-3d-lottie-embed`)
 
@@ -1124,7 +1124,7 @@ Tags: polymorphic-array, media-heavy, a11y, responsive-layout, references, condi
 - Loop mode clones slides in the DOM — import only originals.
 - Autoplaying carousels need a pause control and must stop on focus (WCAG 2.2.2); the renderer adds both.
 
-Not carried by a stored component: category, group unused (props), reference target, variants.
+Not carried by a stored component: category, shopify reference, variants.
 
 ### Full-bleed parallax image with overlay text (`parallax-image-overlay`)
 
@@ -1164,7 +1164,7 @@ Tags: dynamic-query, embed, conditional, media-heavy, references, commerce, vali
 - Widget scripts from UGC vendors add 200–500 KB and third-party cookies — replace, don't import.
 - Never mark rightsGranted true on import; only a person can confirm permission.
 
-Not carried by a stored component: category, reference target, variants.
+Not carried by a stored component: category, shopify reference, variants.
 
 ## Commerce
 
@@ -1213,7 +1213,7 @@ Tags: commerce, deep-nesting, polymorphic-array, conditional, references, media-
 - Variant combinations are typed strings; renaming an option value orphans gallery `forValues` and variant rows.
 - Video posters are required: autoplaying video without a poster hurts LCP on the product page.
 
-Not carried by a stored component: ai, category, document preview path, kind:entry (props), reference target, validation.items.
+Not carried by a stored component: ai, category, kind:entry (props), shopify reference.
 
 ### Featured product spotlight (`commerce-featured-product`)
 
@@ -1336,7 +1336,7 @@ Tags: media-heavy, references, deep-nesting, repeater, commerce, a11y, validatio
 - Coordinates are raw numbers today — there's no visual point picker bound to the image yet (gap).
 - Dots without labels fail WCAG 4.1.2; the label is required for that reason.
 
-Not carried by a stored component: ai, category, document preview path, variants.
+Not carried by a stored component: ai, category, variants.
 
 ### Size guide table (`commerce-size-guide`)
 
@@ -1425,7 +1425,7 @@ Tags: commerce, conditional, validation, repeater, variants. Proves: Both cycle
 - `inherits` is a free string, not a reference to a sibling plan — renaming a plan leaves stale 'Everything in' lines (gap: references within the same entry).
 - Per-seat prices must say 'per seat' near the number, not only in the footnote.
 
-Not carried by a stored component: ai, category, document preview path, variants.
+Not carried by a stored component: ai, category, variants.
 
 ### Usage-based price calculator (`pricing-usage-calculator`)
 
@@ -1492,7 +1492,7 @@ Tags: commerce, repeater, conditional, validation, rich-text. Proves: One plan o
 - A minimum term hidden in small print is a trust killer — it has its own field on purpose.
 - Mixed units (per month + per session) can't be summed into one honest monthly number without an assumption; show the breakdown.
 
-Not carried by a stored component: category, document preview path.
+Not carried by a stored component: category.
 
 ### Enterprise contact card (`pricing-enterprise-card`)
 
@@ -1765,7 +1765,7 @@ Tags: repeater, a11y, variants, conditional, validation, media-heavy. Proves: Ty
 - Payment icons for methods not enabled at checkout are a common trust-breaker.
 - Icon-only badges need text; the title is required.
 
-Not carried by a stored component: category, document preview path, variants.
+Not carried by a stored component: category, variants.
 
 ## Listings & feeds
 
@@ -1903,7 +1903,7 @@ Tags: deep-nesting, repeater, conditional, rich-text, validation, dynamic-query,
 - Version strings with spaces or dates as versions collide as anchors.
 - 60+ releases inline makes the section slow to edit — move to the collection.
 
-Not carried by a stored component: category, segmented>4, validation.items, variants.
+Not carried by a stored component: category, segmented fallback, variants.
 
 ### Public roadmap (`public-roadmap`)
 
@@ -1948,7 +1948,7 @@ Tags: dynamic-query, references, conditional, repeater, validation, a11y. Proves
 - A label-less search input fails WCAG 1.3.1 / 4.1.2 — label is required.
 - Search pages must be noindex — the platform does it natively; never add a field for it.
 
-Not carried by a stored component: category, reference target, variants.
+Not carried by a stored component: category, shopify reference, variants.
 
 ## Long-form & docs
 
@@ -2042,7 +2042,7 @@ Tags: embed, repeater, validation, variants. Proves: One example in N languages
 - API keys in sample code — replace real-looking secrets with $ENV placeholders.
 - The `code` field's built-in language list (html/css/js/liquid/json) doesn't cover API languages — the select carries it.
 
-Not carried by a stored component: category, openMode, variants.
+Not carried by a stored component: category, variants.
 
 ### Knowledge-base article (`kb-article`)
 
@@ -2086,7 +2086,7 @@ Tags: dynamic-query, repeater, conditional, references, seo-structured, a11y, va
 - 300 inline terms is the ceiling — beyond that, use the collection.
 - Localised term lists re-sort per language (Ä, Ø, Ł) — sort with the locale's collation.
 
-Not carried by a stored component: category, validation.items, variants.
+Not carried by a stored component: category, variants.
 
 ### Recipe (`recipe`)
 
@@ -2110,7 +2110,7 @@ Tags: deep-nesting, repeater, seo-structured, media-heavy, conditional, referenc
 - Dietary claims set at recipe level while an optional ingredient breaks them.
 - Timer fields filled but hasTimer off — hidden values still ship unless cleared on save.
 
-Not carried by a stored component: category, kind:entry (props), reference target.
+Not carried by a stored component: category, kind:entry (props), shopify reference.
 
 ### Course curriculum (`course-curriculum`)
 
@@ -2132,7 +2132,7 @@ Tags: deep-nesting, repeater, conditional, references, validation, media-heavy,
 - Live lesson times stored in local time without a zone.
 - Five levels inline (course → module → lesson → resource → file) — keep resources tiny and inline.
 
-Not carried by a stored component: category, segmented>4, variants.
+Not carried by a stored component: category, segmented fallback, variants.
 
 ### Legal / policy page (`legal-policy`)
 
@@ -2268,7 +2268,7 @@ Tags: repeater, media-heavy, variants, validation, a11y. Proves: Values with a r
 - Perks with prices or policies that change — keep them short and dated in HR, not here.
 - Nine-value lists — validation caps at eight; past five, nobody remembers them.
 
-Not carried by a stored component: ai, category, item settings, variants.
+Not carried by a stored component: ai, category, variants.
 
 ### Careers list (`careers-list`)
 
@@ -2313,7 +2313,7 @@ Tags: seo-structured, conditional, references, repeater, validation, form. Prove
 - Closed roles deleted instead of closed: their URLs 404 and lose links. Close them.
 - Benefits retyped on every job drift — use the shared block.
 
-Not carried by a stored component: category, item settings, kind:entry (props).
+Not carried by a stored component: category, kind:entry (props).
 
 ### About & mission with timeline (`about-timeline`)
 
@@ -2356,7 +2356,7 @@ Tags: deep-nesting, repeater, media-heavy, conditional, validation, a11y. Proves
 - Photos without credits get printed uncredited — credit is required for photos.
 - A stale .zip that no longer matches the assets shown.
 
-Not carried by a stored component: category, group unused (props), variants.
+Not carried by a stored component: category, variants.
 
 ## Events & places
 
@@ -2404,7 +2404,7 @@ Tags: deep-nesting, references, seo-structured, conditional, commerce, repeater,
 - Cancelled events deleted rather than marked — Google keeps showing the old date.
 - Sold-out early-bird tiers left 'On sale' after salesEnd — use the window, not the badge.
 
-Not carried by a stored component: category, item settings, kind:entry (props).
+Not carried by a stored component: category, kind:entry (props).
 
 ### Webinar registration (`webinar-registration`)
 
@@ -2426,7 +2426,7 @@ Tags: form, conditional, references, embed, validation, variants. Proves: One se
 - Leaving stage 'live' after the event — the page shows a dead stream.
 - Gating on-demand recordings of public talks lowers reach; gate deliberately.
 
-Not carried by a stored component: ai, category, group unused (props), item settings, variants.
+Not carried by a stored component: ai, category, variants.
 
 ### Locations directory (`locations-directory`)
 
@@ -2523,7 +2523,7 @@ Tags: repeater, conditional, validation, a11y. Proves: Typed columns · rows fro
 - Past ~60 rows, keep the data in CSV or a collection; the grid stays usable but the page gets heavy.
 - Do not model 'striped' or 'compact' as booleans — they are variants.
 
-Not carried by a stored component: ai, category, document preview path, variants.
+Not carried by a stored component: ai, category, variants.
 
 ### Table (`table-comparison`)
 
@@ -2544,7 +2544,7 @@ Tags: validation, a11y, seo-structured, references, commerce. Proves: The `table
 - A blank cell in a yes/no column is 'Not included'; a blank cell anywhere else is 'No value'.
 - Don't retype units in cells — the column carries them.
 
-Not carried by a stored component: ai, category, document preview path.
+Not carried by a stored component: ai, category.
 
 ### Chart with annotations (`chart-attrition`)
 
@@ -2614,7 +2614,7 @@ Tags: commerce, deep-nesting, repeater, conditional, references, validation. Pro
 - SCHEMA GAP: option keys need to be unique within their step only (scoped uniqueness) — `unique` is neither scoped nor enforced.
 - Price deltas drift from Shopify variant prices; prefer reading the variant price and keeping priceDelta only for non-Shopify add-ons.
 
-Not carried by a stored component: ai, category, reference target, variants.
+Not carried by a stored component: ai, category, shopify reference, variants.
 
 ### Map with markers (`stockist-map`)
 
@@ -2773,7 +2773,7 @@ Tags: deep-nesting, slots, repeater, variants, media-heavy. Proves: Guide › Ta
 - Breadcrumb at 7 drills (Guide / Seasoning / Steps and kit / Steps / Season over fire… / Heat it upside down / Card / Button) must fold into the Pathway chip on a 380px inspector — this entry is the test case.
 - Accordion item cards inside a 1/3 column are cramped; that's a variant decision, not a field.
 
-Not carried by a stored component: ai, category, slot allow, variants.
+Not carried by a stored component: ai, category, variants.
 
 ### Any-block module list (`polymorphic-modules`)
 
@@ -2817,7 +2817,7 @@ Tags: conditional, references, dynamic-query, commerce, validation. Proves: Manu
 - SCHEMA GAP: required-if — `maxPrice` is required only when visible; that works because hidden fields skip validation, but 'required when price = between AND minPrice is set' can't be written.
 - minPrice < maxPrice can't be validated (cross-field).
 
-Not carried by a stored component: ai, category, reference target, variants.
+Not carried by a stored component: ai, category, shopify reference, variants.
 
 ### Global block with per-page overrides (`global-announcement-overrides`)
 
@@ -2885,7 +2885,7 @@ Tags: personalization, deep-nesting, conditional, repeater, validation. Proves:
 - SCHEMA GAP: a variant's hidden `content` is still required-validated by its own rules if `isControl` flips — conditions hide but can't relax `required` declaratively.
 - Personalized copy must not change the H1 for SEO purposes; the native page title stays the default's.
 
-Not carried by a stored component: ai, category, document preview path, variants.
+Not carried by a stored component: ai, category, variants.
 
 ### Responsive layout settings (`responsive-layout-settings`)
 
@@ -2928,7 +2928,7 @@ Tags: slots, variants, media-heavy, responsive-layout, commerce. Proves: Slot ce
 - SCHEMA GAP: slotSettings can't be conditional on the child's block type (e.g. padding 'none' only for images) and can't vary per breakpoint.
 - Dense packing changes the visual order but not the DOM order — screen readers follow the DOM.
 
-Not carried by a stored component: ai, category, slot allow, variants.
+Not carried by a stored component: ai, category, variants.
 
 ### References web (`references-web`)
 
@@ -2951,7 +2951,7 @@ Tags: references, dynamic-query, conditional, repeater, validation. Proves: Prod
 - SCHEMA GAP: `unique` on reference arrays isn't enforced; the same story can be pinned twice.
 - Referencing pages by id survives slug changes; storing hrefs doesn't.
 
-Not carried by a stored component: category, reference target.
+Not carried by a stored component: category, shopify reference.
 
 ### Changelog with nested validation (`changelog-nested-validation`)
 
@@ -3041,7 +3041,7 @@ Tags: slots, conditional, a11y, form, repeater, references. Proves: Overlays wit
 - Exit-intent doesn't exist on touch devices; the label says '(desktop)' because the schema can't scope a trigger per device.
 - Focus trap, Esc to close and focus return are renderer requirements, not fields — never make them toggles.
 
-Not carried by a stored component: category, slot allow.
+Not carried by a stored component: category.
 
 ### Sticky scroll story (`scrollytelling`)
 
@@ -3086,7 +3086,7 @@ Tags: a11y, media-heavy, form, validation, conditional. Proves: Captions per lan
 - SCHEMA GAP: the sign-up form is modelled inline because forms are a separate system; ideally the block only references the form and the form owns labels/errors.
 - Autoplay over 5 seconds without a pause control fails WCAG 2.2.2; the help warns, nothing blocks it.
 
-Not carried by a stored component: category, document preview path.
+Not carried by a stored component: category.
 
 ### Section theme tokens (`section-theme-tokens`)
 
@@ -3172,7 +3172,7 @@ Tags: slots, polymorphic-array, repeater, variants. Proves: Array of tabs, each
 - Slot children are `{ componentId, overrides? }` with no `_variant`: a variant is its own component.
 - Give every block, tab and instance a stable `id`; changing one orphans the edits made against it.
 
-Not carried by a stored component: ai, category, slot allow, variants.
+Not carried by a stored component: ai, category, variants.
 
 ### Pricing (`core-pricing`)
 
@@ -3214,7 +3214,7 @@ Tags: slots, polymorphic-array, variants, responsive-layout, media-heavy. Proves
 - A slot child has no `_variant`: a variant is its own component.
 - slotSettings are leaf fields only; a cell's own copy stays in the cell component's props.
 
-Not carried by a stored component: ai, category, slot allow, variants.
+Not carried by a stored component: ai, category, variants.
 
 ### Journal story (`core-journalStory`)
 
@@ -3235,7 +3235,7 @@ Tags: rich-text, references, media-heavy, seo-structured, localized, validation,
 - Reading time is computed by the template; no field stores it today, so don't copy "7 min read" into readingTime.
 - Bind the body wrapper as kind `document`, never `richtext`, or a save repaints the article from plain text.
 
-Not carried by a stored component: ai, kind:entry (props), reference target.
+Not carried by a stored component: ai, kind:entry (props), shopify reference.
 
 ### Hero (`core-hero`)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bettercms-ai/mcp",
-  "version": "0.74.0",
+  "version": "0.76.0",
   "type": "module",
   "description": "BetterCMS MCP server — schema, content, forms + components authoring tools over the Management API, authed via OAuth device-code.",
   "bin": {
@@ -32,7 +32,7 @@
   },
   "dependencies": {
     "@bettercms-ai/device-auth": "^0.2.0",
-    "@bettercms-ai/sdk": "^1.31.0",
+    "@bettercms-ai/sdk": "^1.32.0",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "zod": "^4.3.6"
   },