@bettercms-ai/mcp 0.73.2 → 0.75.0

package/dist/index.js

@@ -2,12 +2,12 @@
 
 // src/index.ts
 import { realpathSync } from "fs";
-import { fileURLToPath as fileURLToPath2 } from "url";
+import { fileURLToPath as fileURLToPath3 } from "url";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { loadConfig, FileTokenStore, DeviceAuthClient } from "@bettercms-ai/device-auth";
 
 // src/server.ts
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { BetterCMS } from "@bettercms-ai/sdk";
 
 // src/tools.ts
@@ -2758,11 +2758,11 @@ function patchAt(fields, [key, ...rest], edit) {
   let next = null;
   if (rest.length === 0) next = edit(field);
   else {
-    for (const list of CHILD_LISTS) {
-      const kids = getIn(field, list);
+    for (const list2 of CHILD_LISTS) {
+      const kids = getIn(field, list2);
       const patched = Array.isArray(kids) ? patchAt(kids, rest, edit) : null;
       if (patched) {
-        next = setIn(field, list, patched);
+        next = setIn(field, list2, patched);
         break;
       }
     }
@@ -2777,8 +2777,8 @@ function fieldAt(fields, keys) {
 function allKeys(fields) {
   return fields.flatMap((f) => [
     String(f.key),
-    ...CHILD_LISTS.flatMap((list) => {
-      const kids = getIn(f, list);
+    ...CHILD_LISTS.flatMap((list2) => {
+      const kids = getIn(f, list2);
       return Array.isArray(kids) ? allKeys(kids) : [];
     })
   ]);
@@ -2936,6 +2936,19 @@ function listsTool(name, sets) {
   if (ABM_TOOLS.has(name)) return sets.has("abm");
   return !sets.has("core") || !LISTING_TAIL.has(name);
 }
+var ALWAYS_LOADED = /* @__PURE__ */ new Set([
+  "get_next_steps",
+  "editor_setup",
+  "get_deploy_status",
+  "get_conversion_brief",
+  "get_binding_report",
+  "list_projects",
+  "list_pages",
+  "get_page",
+  "list_content_models"
+]);
+var toolMeta = (name) => ALWAYS_LOADED.has(name) ? { "anthropic/alwaysLoad": true } : void 0;
+var TOOL_LOADING_INSTRUCTION = `TOOL SCHEMAS: a client with tool search lists most BetterCMS tools by name only. Before the first call to a tool whose schema you have not been shown, load it with the client's tool search, and load every tool the task needs in ONE search (for a renaming pass: update_field, update_content_model, update_component, list_components). A call made without the schema is refused by the client before it reaches BetterCMS ("Invalid tool parameters"): that is this, never a BetterCMS error, and never a reason to change the arguments.`;
 
 // src/tool-text.ts
 var ADD_FIELD_DESCRIPTION = "Append ONE field to a content model (`modelId`) or to a page's schema (`pageId`) \u2014 additive, never overwrites; a key already in use is refused. For a section/zone add ONE 'group' (fixed block) or 'repeater' (repeating list) carrying its child `fields`, not the zone's inner fields as separate top-level fields. Pass `after` to insert it after an existing top-level field instead of at the end; `ui`, `helpText`, `showIf`, `placement` and `fieldsetId` declare how it presents in the editor \u2014 read them back with get_content_model or get_page. On a page a 'group' is stored as type 'array' with `config.zones.nonRepeatable`: entry and delivery data carry `<key>.nonRepeatable.<sub>`, while data-bcms-field paths are `<key>.<sub>`. Schema only \u2014 never places a section; use componentize_sections to turn a group into a section. `multiselect` stores a string[] of `config.options`; `icon` is a BetterCMS icon name or an uploaded icon. To change a field that exists, use update_field. V2 keys (object, openMode, advanced, helpMore, recommendedMax, config.scale): \xA714 of bettercms://playbook/schema.";
@@ -2991,6 +3004,7 @@ var PARAM_TEXT = {
   fromBuiltin: "a builtin:* id from list_components: copies it into the project; fields you send win",
   componentPreview: "a slot row's look: {title?, subtitle?, media?} TOP-LEVEL prop keys, fallback?, icon?; null clears. \xA73 of bettercms://playbook/schema",
   componentIcon: "the block icon, a dock icon name; null clears. \xA73 of bettercms://playbook/schema",
+  componentTabs: "/kit tabs no top-level prop sits in: [{id,label,icon?,order?}]. \xA73 of bettercms://playbook/schema",
   describes: "for editors: what it is and holds; omitted: written for you",
   runtimeBundle: "instead of pageId: the server-app bundle cleanup",
   pageRef: "page id or path ('/de/about'); a bare slug only when one page has it",
@@ -3308,8 +3322,8 @@ var fieldShape = {
     rules: z.array(
       z.object({
         field: z.string().describe("the BARE KEY of another field on this same model"),
-        op: z.enum(["eq", "neq", "in", "isSet", "notEmpty", "empty"]),
-        value: z.union([z.string(), z.array(z.string())]).optional().describe("omit for 'isSet'/'notEmpty' (the source holds any value) and 'empty' (it holds none); required for every other op")
+        op: z.enum(["eq", "neq", "in", "notIn", "gt", "lt", "isSet", "notEmpty", "empty"]),
+        value: z.union([z.string(), z.array(z.string())]).optional().describe(`omit for 'isSet'/'notEmpty' (the source holds any value) and 'empty' (it holds none); 'gt'/'lt' take one number as a string ("10"); required for every other op`)
       })
     )
   }).optional().describe(
@@ -3565,6 +3579,7 @@ function publishedLines(outcome, summary) {
   if (outcome.status !== "live") return [`${summary} Publish status: ${outcome.status}.`];
   return [`${summary} Published: ${outcome.live > 0 ? `${outcome.live} ${outcome.live === 1 ? "value" : "values"} live on the served page` : "live"}.`];
 }
+var DOCK_UI_NEXT = "Give every prop of this component its V2 ui (control, tab, group, collapsed, layout, preview, itemLabel, icon) by playbook \xA714 and the closest bettercms://kit entry: get_component, then ONE update_component with propUi, propTab and propHelpText (the field-ui prompt). The setup gate's dock row stays open until it is done.";
 function ok(summary, data) {
   return {
     content: [
@@ -3995,14 +4010,18 @@ function buildToolDefs(deps) {
       match: z.enum(["all", "any"]),
       rules: z.array(z.object({
         field: z.string().min(1),
-        op: z.enum(["eq", "neq", "in", "isSet", "notEmpty", "empty"]),
+        op: z.enum(["eq", "neq", "in", "notIn", "gt", "lt", "isSet", "notEmpty", "empty"]),
         value: z.union([z.string(), z.array(z.string())]).optional()
       })).min(1).max(20)
-    }).optional().describe("show this prop only while SIBLING props (by key) match: {match:'all'|'any', rules:[{field, op:'eq'|'neq'|'in'|'isSet'|'notEmpty'|'empty', value?}]}. 'isSet', 'notEmpty' and 'empty' take no value. Editor-only."),
+    }).optional().describe("show this prop only while SIBLING props (by key) match: {match:'all'|'any', rules:[{field, op:'eq'|'neq'|'in'|'notIn'|'gt'|'lt'|'isSet'|'notEmpty'|'empty', value?}]}. 'isSet', 'notEmpty' and 'empty' take no value; 'gt'/'lt' one number as a string. Editor-only."),
     // V2 editor-only keys, the model field's (playbook §14). Declared: this is a strip site.
     helpMore: z.string().max(2e3).optional().describe(PARAM_TEXT.helpMore),
     advanced: z.boolean().optional().describe(PARAM_TEXT.advanced),
     recommendedMax: z.number().int().positive().optional().describe(PARAM_TEXT.recommendedMax),
+    // F1.x `unique` (a list's items / a table's rows distinct) and the server's `stale` marker:
+    // undeclared here, an agent's `unique` and an echoed `stale` were dropped with a 200.
+    unique: z.boolean().optional(),
+    stale: z.boolean().optional(),
     openMode: z.enum(["inline", "drill", "popover", "dialog"], { error: OPEN_MODE_INVALID }).optional().describe("object/group/table props: how the value (or each row) opens"),
     // ⚠ A STRIP SITE, exactly like OutField above: this is a `z.object`, so a key the model
     // sends and this shape does not declare is dropped BEFORE the request leaves — a 200 with
@@ -4094,6 +4113,7 @@ function buildToolDefs(deps) {
     description: z.string().optional().describe(PARAM_TEXT.describes),
     preview: componentPreviewArg.optional(),
     icon: dockIconArg.nullable().optional().describe(PARAM_TEXT.componentIcon),
+    tabs: z.array(z.object({ id: z.string(), label: z.string(), icon: z.string().optional(), order: z.number().int().optional() })).nullable().optional().describe(PARAM_TEXT.componentTabs),
     blockJson: z.array(blockObject).default([]).describe("the component's block tree"),
     props: z.array(componentPropObject).default([]).describe(
       "overridable fields. DECLARE A PROP \u2014 WITH A `target` \u2014 for every string, link and image a marketer will ever touch: only the leaves a prop targets are click-to-edit. Each one may carry `ui` to say how its control presents in the inspector \u2014 a collapsed group, what titles and thumbnails a table's rows, whether that table's rows can be dragged at all. 'button' is ONE unit {label, href, variant?, size?, arrow?, icon?, newTab?} on a button block's 'props', never a text prop plus a url prop. 'link' an href, 'date' YYYY-MM-DD, 'color' a hex, 'file' {url, name?}, 'icon' an icon name or an image, 'multiselect' a string[] from config.options (required). " + SLOT_MULTIPLE_NOTE + " " + PROP_V2_NOTE
@@ -6039,13 +6059,13 @@ ${notes.join("\n")}` : summary, created);
       handler: guard(
         async (args) => withClient(async (client) => {
           if (args.detail) {
-            const list2 = await client.listComponents();
-            return ok(`${list2.length} component(s) in the bound project (full definitions).`, list2);
+            const list3 = await client.listComponents();
+            return ok(`${list3.length} component(s) in the bound project (full definitions).`, list3);
           }
-          const list = await client.listComponents({ select: "summary" });
+          const list2 = await client.listComponents({ select: "summary" });
           return ok(
-            `${list.length} component(s) in the bound project.`,
-            list.map((cmp) => ({
+            `${list2.length} component(s) in the bound project.`,
+            list2.map((cmp) => ({
               id: cmp.id,
               name: cmp.name,
               slug: cmp.slug,
@@ -6235,7 +6255,7 @@ ${lines.join("\n")}`, found);
           const { component, replaced } = await client.extractComponent(args);
           return ok(
             `Created component '${component.name}' (id ${component.id}) and repointed ${replaced} sections to it. Page drafts changed; publish those pages to make it live.`,
-            component
+            { ...component, nextAction: DOCK_UI_NEXT }
           );
         })
       )
@@ -6462,7 +6482,8 @@ function registerTools(server, deps, tools = process.env.BETTERCMS_MCP_TOOLS) {
   };
   const sets = toolsetsOf(tools);
   for (const def of buildToolDefs(withElicit).filter((d) => listsTool(d.name, sets))) {
-    server.registerTool(def.name, def.config, def.handler);
+    const _meta = toolMeta(def.name);
+    server.registerTool(def.name, _meta ? { ...def.config, _meta } : def.config, def.handler);
   }
 }
 
@@ -6490,6 +6511,11 @@ DERIVED by \`editor_setup\`, where the componentize lane in \xA710 reuses every
 
 ## 2. The decision tree
 
+    Designing ANY section?                 -> FIRST find its closest kit entry in bettercms://kit
+                                              (by category, then edge tag); follow that entry's
+                                              mcp notes and avoid its pitfalls (tag rules below).
+                                              Its props carry NO target: give each one a target
+                                              into YOUR blockJson (\xA73) before create_component
     Repeated visual region on a page?      -> a COMPONENT with sectionType (a Section)
       ...and it comes in more than one look? -> siblings sharing that sectionType = VARIANTS
     A stack of mixed, reorderable content? -> kind:'block' models + a \`modular\` field
@@ -6510,6 +6536,29 @@ DERIVED by \`editor_setup\`, where the componentize lane in \xA710 reuses every
     Site-wide nav/footer/modal?            -> the LAYOUT (get_layout/update_layout), never a
                                               page section and never one component per page
 
+Kit edge tags, one rule each (long form with entry ids: the skill's kit-scenarios reference):
+
+    deep-nesting       levels = content kinds, not wrappers; past 6, split the deepest subtree out
+    repeater           one band holds the list; never store what order says (step no., totals)
+    polymorphic-array  each item names its _type; merge consecutive prose into one text item
+    slots              children differ in shape; span/surface/phone order go in slotSettings
+    variants           column count, side, carousel = a variant, never a free number or boolean
+    conditional        a select reveals one branch; fill only it (hidden values still publish)
+    references         reference the entry/product/page; store only what differs as overrides
+    dynamic-query      store collection + filters + sort + limit; import the items as entries first
+    global-synced      same on ~80% of pages = one global; an instance overrides only what differs
+    localized          match locales by position, never text; never translate on import; no hreflang
+    rich-text          one body; callouts, tables, media, instances are islands; no h1, no chrome
+    media-heavy        largest source, real alt, video poster + caption file, positions in %
+    embed              store provider + id or canonical URL, never the script; iframes need a title
+    form               a Form reference by id; never the inputs copied into the section
+    commerce           the store owns price, stock, SKU, options, cart: reference, never copy
+    personalization    only with evidence; complete default, audiences hold only the differences
+    validation         numbers as numbers, datetimes with offset; check cross-field rules on import
+    a11y               every visual-only element gets text: logo name, pin label, iframe title
+    seo-structured     JSON-LD is emitted from content; never model meta or JSON-LD fields (\xA75b)
+    responsive-layout  per-breakpoint values as settings that inherit desktop; spacing as tokens
+
 ## 3. Anatomy of a real section component
 
 A component that is only headings and text renders as an unstyled stack \u2014 plain text on white
@@ -6547,8 +6596,9 @@ dashboard's prop editor renders. \`helpText\` is three-state: a string is yours,
 purpose (send it for a prop whose /kit schema has no description; nothing refills it), and omitted
 lets the platform write one. They are HINTS: nothing on the write path refuses a placement
 that leaves a required prop empty, so \`get_site_composition\` is what reports one.
-A /kit schema's document-level \`preview\` \u2192 the component's \`preview\`: how ONE instance reads as a ROW in a parent's slot list. {title?, subtitle?, media?} each name a TOP-LEVEL prop key (422 \`preview_key_unknown\` otherwise), \`fallback?\` is a literal row label (\u2264 120) and \`icon?\` a dock icon name; null clears it.
+A /kit schema's document-level \`preview\` \u2192 the component's \`preview\`: how ONE instance reads as a ROW in a parent's slot list. {title?, subtitle?, media?} each name a TOP-LEVEL prop key or a dotted path into one (\`slides.0.heading\`; 422 \`preview_key_unknown\` otherwise), \`fallback?\` is a literal row label (\u2264 120) and \`icon?\` a dock icon name; null clears it.
 A /kit schema's document-level \`icon\` \u2192 the component's \`icon\` (a dock icon name from bettercms://icons/dock, null clears): the block icon on the root crumb, slot rows and slot child frames.
+A /kit schema's \`groups\` \u2192 each prop's \`ui.tab\` (defined on the first top-level prop in it; a nested field's \`group\` \u2192 its \`ui.tab: {id}\`); a group NO top-level prop sits in \u2192 the component's \`tabs\` ([{id, label, icon?, order?}], 422 \`component_tab_invalid\` for a prop's own tab). A slot's \`of.allow\` \u2192 \`config.allow\` (block names); a scalar list's item settings (\`of[0]\` validation, description, localized) \u2192 \`config.item\`.
 
 **Prop types, one rule each.** 'select' REQUIRES \`config.options\` (a default must be one of them). 'group'/'table'/'object' REQUIRE \`config.fields\` (\`[{key,label,type,options?,fields?}]\`); a group writes an object, a table an array of them (\`config.mode: 'data'\`: ONE V2 table value, no fields). 'number' takes optional \`config.min/max/step\`. 'slot' holds ONE nested component instance: \`target.path: 'props'\` on an EMPTY component block (\`props.componentId: ""\`), \`config.componentIds\` restricts fills, defaultValue \`{componentId, overrides?}\`. 'form' holds ONE Form document: \`target.path: 'props'\` on an EMPTY form block (\`props.formId: ""\`), defaultValue \`{formId}\`, never the hydrated \`{formId, form}\` (400); do NOT re-declare the form's FIELDS as props, the Form document owns them. 'button' is ONE unit \`{label, href, variant?, size?, arrow?, icon?, newTab?}\` on a button block's 'props', never a text prop plus a url prop. 'link' an href, 'date' YYYY-MM-DD, 'color' a hex, 'file' \`{url, name?}\`, 'icon' an icon name or an image, 'multiselect' a string[] from \`config.options\` (required).
 
@@ -7263,7 +7313,7 @@ conversion is yours to write.
    markup inside a \`text\` field.
    **Prose MIGRATED from another CMS needs one extra check.** Every block's \`_type\` must be one
    this platform stores \u2014 \`block\`, \`table\` (\`{_type:"table", rows:[{_key, cells:[{_key,
-   content:[...blocks], header?, group?, highlight?, sortable?}], group?, footer?, highlight?}], caption?, notes?, rowGroups?, columnGroups?, filterable?, jsonLd?: {type: "ItemList"|"Dataset"|"Offers", axis?, priceRow?}, design?: {responsive?: "stack"|"cards", sticky?}}\`,
+   content:[...blocks], header?, group?, highlight?, sortable?, note?, column?: {type?: "text"|"number"|"money"|"boolean"|"rating"|"link", unit?, currency?, decimals?, align?, trueLabel?, falseLabel?, max?, description?} (first row only), type?, value?: number|boolean (content keeps its words)}], group?, footer?, highlight?, type?}], caption?, notes?, rowGroups?, columnGroups?, filterable?, jsonLd?: {type: "ItemList"|"Dataset"|"Offers", axis?, priceRow?}, design?: {responsive?: "stack"|"cards", sticky?}, footnotes?: [{_key, text}]}\`,
    groups \`[{_key, label}]\`; Sanity's row of plain strings, \`rows:[{cells:["a","b"]}]\`,
    is admitted too), \`bcmsCode\`, \`bcmsDivider\`, \`bcmsMention\`, \`pullQuote\`
    (\`{quote, name, role?, link?}\`), \`keyTakeaways\` (\`{title?, points:[...strings]}\`,
@@ -7502,7 +7552,7 @@ Importance orders a screen: required fields first, then array order.
 | Calm defaults for rare settings | \`advanced: true\` |
 | A soft length warning (amber, never a refusal) | \`recommendedMax: 60\` |
 | A marketer cannot change it | \`readOnly: 'developer'\` plus \`lockReason\` |
-| A field that shows only sometimes | \`showIf\` (it SHOWS the field): ops \`eq\`, \`neq\`, \`in\`, \`isSet\`, \`notEmpty\`, \`empty\` |
+| A field that shows only sometimes | \`showIf\` (it SHOWS the field): ops \`eq\`, \`neq\`, \`in\`, \`notIn\`, \`gt\`, \`lt\` (one number as a string), \`isSet\`, \`notEmpty\`, \`empty\` |
 | A good row title and thumbnail | \`ui.preview: { title, subtitle, media, fallback }\` (\`fallback\` is a literal label) |
 | Labels that classify or filter (topics, keywords), never a feature list | \`type: 'tags'\`: a string[], trimmed, de-duplicated, each \u226464 characters; \`config.options\` are suggestions, \`config.max\`, \`config.allowCustom: false\` closes the list (\`tags_value_invalid\`) |
 | A star rating | \`type: 'rating'\`: a number from 0 to \`config.max\` (5), \`config.step\` 1 or 0.5 (\`rating_value_invalid\`) |
@@ -7620,6 +7670,7 @@ disagrees with the array the moment anyone drags a row in the builder.
 // src/prompts.ts
 var STRUCTURE_RULE = `### Page structure (non-negotiable)
 ${SECTION_DOCTRINE}`;
+var DOCK_UI_STEP = "EDITOR CHROME: for every component, run the field-ui lane (the `field-ui` prompt, playbook \xA714): `get_component`, then one `update_component` with `propUi`, `propTab` and `propHelpText` giving each prop its V2 ui (control, tab, group, collapsed, layout, preview, itemLabel, icon) after the closest `bettercms://kit` entry. The gate's `dock` row stays open until each has it, or a true `default-controls` exception.";
 var CONVERT_SITE_TEXT = (projectId) => `Convert my site so every visible element is editable in BetterCMS${projectId ? `, project ${projectId}` : ""}.
 Do not stop at the plan or at a partial receipt \u2014 finish the whole site, never editing a class or style.
 
@@ -7650,8 +7701,8 @@ Do not stop at the plan or at a partial receipt \u2014 finish the whole site, ne
    do the same with \`npx @bettercms-ai/convert@latest --upgrade-element-styles --root . --dry-run\`. Run \`--verify-styles\` again
    and restore what it lists (the marker, and the inline style from \`block.style\` or \`fieldAttrs\`, are allowed; changing a class
    or an existing style is not). Deploy, poll, call \`get_next_steps\` again and run \`receipt.gate.nextAction\` until \`receipt.complete\` is true; what else it lists, tell me by name. Not listed: say so; invent no work. Its \`receipt.gate\` fails a route on \`sections\` or \`style\` while I could not add a section to that page, reorder it or space it: run each such row's \`fix\` too. A write that answers \`held\`, or a publish whose \`outcome\` is \`partial\`, is not done until its action is taken.
-11. Ask me whether to commit and push to my repository, commit only, or leave it uncommitted (unpushed, the
-   next rebuild from my repo drops it). Touch git only as I answer.`;
+11. ${DOCK_UI_STEP}
+12. Ask me whether to commit and push to my repository, commit only, or leave it uncommitted (unpushed, the next rebuild from my repo drops it). Touch git only as I answer.`;
 var FIELD_UI_PROMPT = {
   title: "Declare how fields LOOK in the editor (guided)",
   description: "Set the editor chrome of an existing schema and its component props: groups, tabs, rows, icons, item names, what titles and thumbnails a list's rows, help text, conditional visibility. Derives it from your source, then from the field shapes, and asks only what it cannot know.",
@@ -8083,6 +8134,8 @@ ${COMPONENTIZE_SITE_FLOW}
 
 ${STRUCTURE_RULE}
 
+Last, before the summary: ${DOCK_UI_STEP}
+
 Confirm the component library with the user before creating it. End with the summary \xA712 asks
 for: the group hierarchy, each family and its variants, what you left in the site's code because
 the platform does not model it, and which components are still waiting for the owner's approval
@@ -8221,7 +8274,8 @@ Read bettercms://playbook/schema section 11 first, then work this order:
 4. PRESENTATION MANIFEST \u2014 add bcms-presentation.json to public/ (container width, type
    scale, nav position/background, footer surface as DTCG {"$type","$value"} entries) and
    redeploy, or structural draft previews render in a generic theme, not this site's design.
-5. VERIFY \u2014 call get_next_steps and fix what it lists (it knows about missing manifests,
+5. ${DOCK_UI_STEP}
+6. VERIFY \u2014 call get_next_steps and fix what it lists (it knows about missing manifests,
    a setup that has not run, and placed-but-unpublished components). You are finished only
    when its receipt.complete is true: run receipt.gate.nextAction, read it again after each
    batch, and record an item you cannot close with editor_setup { exempt } only under an allowed
@@ -8307,6 +8361,93 @@ function loadSkillDocs(dir = defaultSkillDir()) {
   return docs;
 }
 
+// src/kit.ts
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
+import { fileURLToPath as fileURLToPath2 } from "url";
+var KIT_URI = "bettercms://kit";
+var KIT_ENTRY_URI_PREFIX = "bettercms://kit/entry/";
+var KIT_ENTRY_URI_TEMPLATE = `${KIT_ENTRY_URI_PREFIX}{id}`;
+function loadKitCatalog(path = fileURLToPath2(new URL("./kit-catalog.json", import.meta.url))) {
+  return existsSync2(path) ? JSON.parse(readFileSync2(path, "utf8")) : null;
+}
+var list = (xs) => xs.map((x) => `- ${x}`).join("\n");
+function entryNotes(e, h = "###") {
+  const out = [`${h} ${e.name} (\`${e.id}\`)`, "", `Tags: ${e.tags.join(", ") || "none"}. Proves: ${e.proves}`];
+  if (!e.why && !e.mcp) out.push("", "No model notes in the kit for this entry: read its props.");
+  if (e.why) out.push("", `**Why this shape.** ${e.why}`);
+  if (e.htmlSignals.length) out.push("", "**HTML signals.**", list(e.htmlSignals));
+  if (e.mcp) out.push("", `**Do.** ${e.mcp}`);
+  if (e.pitfalls.length) out.push("", "**Pitfalls.**", list(e.pitfalls));
+  if (e.notCarried.length) out.push("", `Not carried by a stored component: ${e.notCarried.join(", ")}.`);
+  return out.join("\n");
+}
+function kitIndexText(k) {
+  const byId = new Map(k.entries.map((e) => [e.id, e]));
+  return [
+    "# BetterCMS kit catalogue",
+    "",
+    `${k.entries.length} modelled website sections. Before designing a section, find the closest entry by its edge tag or category, read its notes and follow its mcp + pitfalls; its create_component props are at ${KIT_ENTRY_URI_TEMPLATE}.`,
+    "",
+    "## Categories",
+    "",
+    ...k.categories.map((c) => `- ${c.name} (${c.entries.length}): ${KIT_URI}/${c.slug}`),
+    "",
+    "## Edge tags",
+    "",
+    ...k.tags.map((t) => `- \`${t.tag}\` (${t.hint}): ${t.entries.join(", ") || "none"}`),
+    "",
+    "## Entries",
+    "",
+    ...k.categories.flatMap((c) => [
+      `### ${c.name}`,
+      "",
+      ...c.entries.map((id) => {
+        const e = byId.get(id);
+        return `- \`${e.id}\` ${e.name} [${e.tags.join(", ")}]: ${e.proves}`;
+      }),
+      ""
+    ])
+  ].join("\n");
+}
+function kitCategoryText(k, slug2) {
+  const c = k.categories.find((x) => x.slug === slug2);
+  const byId = new Map(k.entries.map((e) => [e.id, e]));
+  return [
+    `# Kit: ${c.name}`,
+    "",
+    `${c.entries.length} entries. Each one's create_component props: ${KIT_ENTRY_URI_TEMPLATE}. Index: ${KIT_URI}.`,
+    "",
+    ...c.entries.map((id) => entryNotes(byId.get(id), "##") + "\n")
+  ].join("\n");
+}
+function kitEntryText(e) {
+  return [
+    entryNotes(e, "#"),
+    "",
+    "## create_component payload",
+    "",
+    "Props in the exact shape create_component accepts. Adapt keys and copy to the site; keep the types, `ui` and config.",
+    "",
+    "```json",
+    JSON.stringify(e.component, null, 1),
+    "```",
+    ""
+  ].join("\n");
+}
+function kitDocs(k = loadKitCatalog()) {
+  if (!k) return [];
+  const doc = (uri, name, title, description, text2) => ({ uri, name, title, description, mimeType: "text/markdown", text: text2 });
+  return [
+    doc(KIT_URI, "kit", "BetterCMS kit catalogue", "Index of modelled website sections by category and edge tag: find the closest one before designing a section.", kitIndexText(k)),
+    ...k.categories.map(
+      (c) => doc(`${KIT_URI}/${c.slug}`, `kit-${c.slug}`, `Kit: ${c.name}`, `Model notes for the ${c.entries.length} ${c.name} entries: why, HTML signals, mcp, pitfalls.`, kitCategoryText(k, c.slug))
+    )
+  ];
+}
+function kitEntryTexts(k = loadKitCatalog()) {
+  return k ? Object.fromEntries(k.entries.map((e) => [`${KIT_ENTRY_URI_PREFIX}${e.id}`, kitEntryText(e)])) : {};
+}
+
 // src/server.ts
 var SERVER_NAME = "bettercms";
 var SERVER_VERSION = "1.5.0";
@@ -8332,7 +8473,7 @@ function buildServer(deps) {
       // 🔴 The plain-language ask, routed — the stdio twin of the hosted connector's line
       // (src/routes/mcp/index.ts MCP_INSTRUCTIONS). "Make my site editable" has one recipe and
       // one definition of done; without this an agent converts the page it landed on and stops.
-      instructions: RECEIPT_FIRST_INSTRUCTION + " When the user asks to make a site or all of its pages editable, to convert it, or to bind its fields: this is playbook \xA713. Read `bettercms://playbook/schema` \xA713, call get_binding_report and get_conversion_brief { complete: true }, convert EVERY route the brief lists, and finish only when get_binding_report shows coverage.pending empty on every route \u2014 not when the first page works. On a workspace-wide connection pass projectId on every call; never ask the user to re-scope the connection. " + LAYOUT_CHROME_INSTRUCTION + " " + CTA_BUTTON_INSTRUCTION + " When the user asks to componentize the whole site, to turn every section into a component, or to build a component library from the site: this is playbook \xA712. Read `bettercms://playbook/schema` \xA712, start with get_site_composition, and use the batch tools \u2014 componentize_sections, compose_pages, update_layout with `commands`, publish_components \u2014 rather than one call per component. Finish with get_site_composition and tell the user what the platform does not model (cookie banners, modals, breadcrumbs, pagination) and which components still need the owner's approval in the dashboard before they can be published. " + // The default after authoring (the structure standard): organise what you made. Same
+      instructions: TOOL_LOADING_INSTRUCTION + " " + RECEIPT_FIRST_INSTRUCTION + " When the user asks to make a site or all of its pages editable, to convert it, or to bind its fields: this is playbook \xA713. Read `bettercms://playbook/schema` \xA713, call get_binding_report and get_conversion_brief { complete: true }, convert EVERY route the brief lists, and finish only when get_binding_report shows coverage.pending empty on every route \u2014 not when the first page works. On a workspace-wide connection pass projectId on every call; never ask the user to re-scope the connection. " + LAYOUT_CHROME_INSTRUCTION + " " + CTA_BUTTON_INSTRUCTION + " When the user asks to componentize the whole site, to turn every section into a component, or to build a component library from the site: this is playbook \xA712. Read `bettercms://playbook/schema` \xA712, start with get_site_composition, and use the batch tools \u2014 componentize_sections, compose_pages, update_layout with `commands`, publish_components \u2014 rather than one call per component. Finish with get_site_composition and tell the user what the platform does not model (cookie banners, modals, breadcrumbs, pagination) and which components still need the owner's approval in the dashboard before they can be published. " + // The default after authoring (the structure standard): organise what you made. Same
       // sentence as the hosted connector's MCP_INSTRUCTIONS.
       STRUCTURE_DEFAULT_INSTRUCTION + " " + SKILLS_ROUTING_INSTRUCTION + " " + DOCK_UI_ROUTING_INSTRUCTION + " " + PUBLISH_HOLD_INSTRUCTION
     }
@@ -8368,6 +8509,22 @@ function buildServer(deps) {
   for (const { uri, name, text: text2, ...meta } of loadSkillDocs()) {
     server.registerResource(name, uri, meta, () => ({ contents: [{ uri, mimeType: meta.mimeType, text: text2 }] }));
   }
+  for (const { uri, name, text: text2, ...meta } of kitDocs()) {
+    server.registerResource(name, uri, meta, () => ({ contents: [{ uri, mimeType: meta.mimeType, text: text2 }] }));
+  }
+  const kitEntries = kitEntryTexts();
+  if (Object.keys(kitEntries).length) {
+    server.registerResource(
+      "kit-entry",
+      new ResourceTemplate(KIT_ENTRY_URI_TEMPLATE, { list: void 0 }),
+      { title: "Kit entry", description: "One kit entry: its model notes and the create_component props. Ids are in bettercms://kit.", mimeType: "text/markdown" },
+      (uri) => {
+        const text2 = kitEntries[uri.href];
+        if (text2 === void 0) throw new Error(`Unknown kit entry: ${uri.href}`);
+        return { contents: [{ uri: uri.href, mimeType: "text/markdown", text: text2 }] };
+      }
+    );
+  }
   registerTools(server, {
     auth: deps.auth,
     // `project` is the per-call target of a workspace-wide grant; the SDK sends it as
@@ -8395,7 +8552,7 @@ function isMainModule() {
   const argv1 = process.argv[1];
   if (!argv1) return false;
   try {
-    return realpathSync(argv1) === fileURLToPath2(import.meta.url);
+    return realpathSync(argv1) === fileURLToPath3(import.meta.url);
   } catch {
     return false;
   }