@bettercms-ai/mcp 0.66.2 → 0.66.4

package/dist/index.js

@@ -2277,7 +2277,7 @@ var STRUCTURE_EXAMPLE_PAYLOAD = {
   doc: {
     schema: 1,
     folders: [
-      { id: "home:pages", parentId: null, name: "Other pages", icon: "documents", sort: 1e3 },
+      { id: "home:pages", parentId: null, name: "Pages", icon: "documents", sort: 1e3 },
       { id: "home:collections", parentId: null, name: "Shared", icon: null, sort: 1001 },
       { id: "fld_std_blog", parentId: null, name: "Blog posts", icon: "document-text", sort: 0 },
       { id: "fld_std_products", parentId: null, name: "Products", icon: "basket", sort: 1 }
@@ -2327,18 +2327,20 @@ ever changes.
      The family's main collection comes first, then the others in the order its fields reference
      them.
 4. **Family order:** the site's navigation order; failing that, entry count, then name.
-5. **Other pages.** EVERY remaining standalone page goes in the system folder \`home:pages\`
-   ("Other pages") \u2014 no standalone page ever gets a top-level folder. Code-only routes (a 404, a
+5. **Pages.** EVERY remaining standalone page goes in the system folder \`home:pages\`
+   ("Pages") \u2014 no standalone page ever gets a top-level folder. Code-only routes (a 404, a
    page built by code with nothing to edit) stay there too, marked with the \`file-code\` icon.
    Pages that share a route (/legal/terms, /legal/privacy, /docs/...) get a subfolder of it.
+   A site in more than one language files every page, home included, under Pages \u203A <language>
+   (named in itself: English, Fran\xE7ais, Deutsch), default language first.
 6. **Shared taxonomies.** A vocabulary several families reference (Tags used by posts AND
    products) goes in the system folder \`home:collections\`, named "Shared". So does supporting
    content no family owns (testimonials, FAQs with no list page).
 7. **Settings closes the sidebar.** \`home:globals\` ("Settings") holds NO pages or collections \u2014
    navigation, header, footer, site settings and SEO defaults open from it in the dashboard. The
-   three system folders always sort BELOW the folders you make: \u2026 Other pages, Shared, Settings.
+   three system folders always sort BELOW the folders you make: \u2026 Pages, Shared, Settings.
 8. **Icons** (kit names, bettercms://icons/dock): \`document-text\` for posts, \`basket\` for products,
-   \`book\` for docs, \`documents\` for Other pages, \`folder\` by default. Lucide names already stored
+   \`book\` for docs, \`documents\` for Pages, \`folder\` by default. Lucide names already stored
    still draw.
 9. **Depth:** nest at most 2 levels by default. The hard limit is 4; do not use it without a
    reason the user gave you.
@@ -2354,15 +2356,15 @@ ever changes.
 
 What the structure writes refuse, and the code each refusal carries:
 
-- **System folders.** \`home:pages\` (Other pages), \`home:collections\` (Shared) and
+- **System folders.** \`home:pages\` (Pages), \`home:collections\` (Shared) and
   \`home:globals\` (Settings) always exist and can never be moved or deleted (400
   \`NAV_SYSTEM_FOLDER\`); \`rename_folder\` and \`set_icon\` work on them.
-- **Type purity** (400 \`NAV_TYPE_MISMATCH\`): Other pages holds only pages at any depth, Shared
+- **Type purity** (400 \`NAV_TYPE_MISMATCH\`): Pages holds only pages at any depth, Shared
   only collections, Settings neither \u2014 globals are not sidebar items.
 - **Pins** sit above the folders in their own order, pages or collections. In a document a pin is
   \`folderId: "home:root"\`, a virtual id with no folder record; a folder record with that id is
   400 \`NAV_SYSTEM_FOLDER\`. In \`move_to_folder\`, \`folderId: 'root'\` pins and \`null\` returns
-  the item to its home (Other pages / Shared).
+  the item to its home (Pages / Shared).
 - **Kind.** \`move_to_folder\` and \`set_icon\` VERIFY what an id is: a page id sent as a
   collection is 400 \`NAV_KIND_MISMATCH\` naming the kind to use. \`set_content_structure\` never
   refuses a kind mismatch: it returns \`warnings\` and \`kindMismatches\` instead.
@@ -2407,7 +2409,7 @@ collection (\`cm_posts\`), a /shop list page (\`pg_shop\`, dynamic) for Products
   Blog
 [folder] Products             icon=shopping-bag
   Products, Product categories, Colours   (referenced only by Products)
-[system folder] Other pages   icon=files
+[system folder] Pages   icon=files
   About, Contact, Not found (icon=file-code)
 [system folder] Shared
   Tags                        (referenced by Blog AND Products: shared)
@@ -2518,6 +2520,14 @@ function mergeConfig(current, patch) {
   }
   return out;
 }
+var wordsOf = (v) => (typeof v === "string" ? v : typeof v?.label === "string" ? v.label : "").replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim().toLowerCase();
+function helpTextEcho(helpText, field) {
+  if (typeof helpText !== "string" || !helpText.trim()) return null;
+  const said = wordsOf(helpText.replace(/^\s*e\.?g\.?[:,]?\s*/i, "")).replace(/^["'“”‘’]+|["'“”‘’.…]+$/g, "");
+  const value = wordsOf(field.defaultValue);
+  const echoes = said === wordsOf(field.label) || value !== "" && (said === value || /…["”]?$/.test(helpText.trim()) && value.startsWith(said));
+  return echoes ? `helpText repeats the field's label or value, which the editor already shows. Say what belongs here or its format in under 60 characters ("Whole number, no currency symbol."), or send null for none.` : null;
+}
 function planFieldEdit(model, edit, callerIfMatch) {
   const fields = model.fields ?? [];
   const keys = typeof edit.path === "string" && edit.path ? edit.path.split(".") : [];
@@ -2540,6 +2550,8 @@ function planFieldEdit(model, edit, callerIfMatch) {
   if (!retype && rename === void 0 && edit.config === void 0 && changes.length === 0) {
     return { ok: false, error: "Nothing to change: pass label, helpText, required, config, showIf, ui, placement, type or key." };
   }
+  const echo = helpTextEcho(edit.helpText, { label: edit.label ?? current.label, defaultValue: current.defaultValue });
+  if (echo) return { ok: false, error: echo };
   const next = patchAt(fields, keys, (f) => {
     let out = { ...f };
     for (const k of changes) {
@@ -2698,8 +2710,10 @@ var PARAM_TEXT = {
   sourceUrl: "instead of data: a public http(s) URL the server fetches and stores (private or internal addresses are refused)",
   focalX: "focal point, 0-1 across from the left edge; null resets to the centre",
   focalY: "focal point, 0-1 down from the top edge; null resets to the centre",
-  mergeHref: "pageId only: the link field paired with `path` (the label). Both become ONE `button` field keyed `key` (default: their stem, primaryCtaHref \u2192 primaryCta). Each entry's DRAFT gets {label, href} and keeps the old values; the live copy changes on publish. ifMatch is the page's version"
+  mergeHref: "pageId only: the link field paired with `path` (the label). Both become ONE `button` field keyed `key` (default: their stem, primaryCtaHref \u2192 primaryCta). Each entry's DRAFT gets {label, href} and keeps the old values; the live copy changes on publish. ifMatch is the page's version",
+  confirmedInput: "true only after the user explicitly approved adding this custom input (`ui.input`); else setting or changing one is refused input_needs_confirmation. Removing one needs no approval"
 };
+var INPUT_CONFIRMED_HEADER = "x-bcms-confirmed-input";
 var BUTTON_FIELD_NOTE = "'button' is ONE call to action, value {label, href, variant?, size?, arrow?, icon?, newTab?}: never a text field beside a link field.";
 var UPDATE_FIELD_DESCRIPTION = "Change ONE existing field of a content model (`modelId`) or of a page's schema (`pageId`), addressed by `path`: its key, or dot-separated keys through groups and repeaters ('hero.title'). Set its label, helpText, required, validation `config` (merged by key; null deletes one), showIf, ui or placement (null clears those). The rest of the schema is written back unchanged at the version read; a 409 means it changed since, so read again. `type` changes how every stored value is read and needs allowRetype: true. `key` renames it: stored values stay under the old key, so the route answers 409 with the entry count unless allowFieldRemoval: true discards them \u2014 migrate the values first. Ask the user before a retype or a rename. A page's label + link pair (primaryCtaText + primaryCtaHref) becomes one button with `mergeHref`.";
 var GET_SEO_DESCRIPTION = "Get the connected project's site-wide SEO settings \u2014 every key update_seo writes: seoDefaults (metaTitle, metaDescription, ogImage, twitterHandle, og, twitter, collectionSchemaTypes), siteSchema (the site's JSON-LD), robotsConfig, sitemapConfig, rssConfig, indexnowConfig and searchConfig.";
@@ -2902,7 +2916,13 @@ var uiObject = z.strictObject({
   // A refine, not an enum: 236 names inlined into every schema that carries `ui` would be paid on
   // every tools/list. The layoutIcon precedent; the server's z.enum is the guard.
   icon: z.string().min(1).max(40).refine((v) => DOCK_ICON_SET.has(v), `not a dock icon, see ${DOCK_ICONS_URI}`).optional().describe(`the branch row's icon, a name from ${DOCK_ICONS_URI}. Nesting fields only.`),
-  itemLabel: z.string().min(1).max(24).optional().describe("what ONE item is called ('Slide'): the add button, crumbs and empty state. Nesting fields only.")
+  itemLabel: z.string().min(1).max(24).optional().describe("what ONE item is called ('Slide'): the add button, crumbs and empty state. Nesting fields only."),
+  input: z.object({
+    name: z.string().regex(/^[a-z][a-z0-9-]{0,47}$/),
+    writes: z.array(z.string().min(1).max(64)).max(16).optional()
+  }).optional().describe(
+    "a custom dock input by NAME (the project's bettercms/inputs/<name>.tsx), a last resort after `control`, `preview` and groups. `writes`: sibling field keys it may also write, nothing else. Setting or changing it needs `confirmed: true`, sent only after the user approved it."
+  )
 });
 var propUiObject = uiObject.extend({
   group: z.strictObject({
@@ -3054,6 +3074,8 @@ function proseType(f) {
   if (f.type !== "text") return f.type;
   return f.richText === false ? "text" : "richtext";
 }
+var confirmedHeaders = (confirmed) => confirmed === true ? { [INPUT_CONFIRMED_HEADER]: "true" } : {};
+var withHeaders = (headers) => Object.keys(headers).length > 0 ? { headers } : {};
 function toField(f) {
   const base = {
     key: f.key,
@@ -3238,7 +3260,7 @@ function authPrompt(err) {
 var currentProject = new AsyncLocalStorage();
 var currentBranch = new AsyncLocalStorage();
 var projectIdArg = z.string().min(1).optional().describe(
-  "project id (list_projects); workspace-wide grants only"
+  "list_projects id; workspace-wide grants only"
 );
 var branchIdArg = z.string().min(1).optional().describe("content branch id (from list_branches); omit to work on main");
 var withProjectId = (def) => ({
@@ -3373,7 +3395,8 @@ function buildToolDefs(deps) {
     modelId: z.string().min(1).optional().describe("the content model to extend (from list_content_models); or send pageId"),
     pageId: z.string().min(1).optional().describe("instead of modelId: the page whose schema to extend (from list_pages / create_page)"),
     ...fieldShape,
-    after: afterArg
+    after: afterArg,
+    confirmed: z.boolean().optional().describe(PARAM_TEXT.confirmedInput)
   });
   const uploadAssetInput = z.object({
     localPath: z.string().min(1).optional().describe("absolute path to a local file (e.g. a repo image); provide this OR url"),
@@ -3663,7 +3686,8 @@ function buildToolDefs(deps) {
     propLabel: z.record(z.string(), z.string().min(1).max(255)).optional().describe("prop key \u2192 label"),
     propHelpText: z.record(z.string(), z.string().max(200).nullable()).optional().describe("prop key \u2192 help text, null clears it"),
     override: z.boolean().optional().describe(OVERRIDE_NOTE),
-    ifMatch: z.number().int().min(0).optional().describe(COMPONENT_IF_MATCH_NOTE)
+    ifMatch: z.number().int().min(0).optional().describe(COMPONENT_IF_MATCH_NOTE),
+    confirmed: z.boolean().optional().describe(PARAM_TEXT.confirmedInput)
   });
   const setComponentSourceInput = z.object({
     componentId: z.string().min(1).describe("component id (from list_components)"),
@@ -3833,7 +3857,7 @@ ${d.summary.outline}` : "Content structure.", d);
       def(
         "suggest_content_structure",
         "Propose the standard Content structure",
-        `READ-ONLY: propose the standard Content sidebar structure for the connected project (${STRUCTURE_PLAYBOOK_URI}) and write NOTHING. Runs the standard over the project's pages, collections, references and built routes: the home page and each collection's list page pinned, one folder per content family named for its detail type (Blog posts, Case studies, Products with its taxonomies and an Attributes subfolder), ordered by entry count (or the caller's nav order), shared taxonomies in Shared, every remaining page in Other pages, at most 2 levels deep. Page-bound models are never filed. Returns { doc, version, hasDocument, outline, rationale }. To apply it: show the user the outline, then call set_content_structure with this doc and this version (the If-Match; a 412 means someone changed the sidebar, so suggest again). When hasDocument is true the project already has a structure somebody made: never replace it without the user's yes; file only what is new with move_to_folder instead.`,
+        `READ-ONLY: propose the standard Content sidebar structure for the connected project (${STRUCTURE_PLAYBOOK_URI}) and write NOTHING. Runs the standard over the project's pages, collections, references and built routes: the home page and each collection's list page pinned, one folder per content family named for its detail type (Blog posts, Case studies, Products with its taxonomies and an Attributes subfolder), ordered by entry count (or the caller's nav order), shared taxonomies in Shared, every remaining page in Pages, at most 2 levels deep. Page-bound models are never filed. Returns { doc, version, hasDocument, outline, rationale }. To apply it: show the user the outline, then call set_content_structure with this doc and this version (the If-Match; a 412 means someone changed the sidebar, so suggest again). When hasDocument is true the project already has a structure somebody made: never replace it without the user's yes; file only what is new with move_to_folder instead.`,
         z.object({
           maxDepth: z.number().int().min(1).max(4).optional().describe("folder nesting to propose; default 2 (the standard), 4 is the hard limit")
         }).shape,
@@ -3846,7 +3870,7 @@ ${d.outline}` : "Proposed Content structure.", d);
       def(
         "set_content_structure",
         "Replace the Content sidebar structure",
-        `Replace the whole Content sidebar document in one write. Follow the structure standard (read ${STRUCTURE_PLAYBOOK_URI} first; suggest_content_structure returns a ready doc). Send the complete \`doc\` and the \`version\` get_content_structure returned (0 when the project has none yet). Validated exactly like the dashboard: unique folder ids, every parentId/folderId a folder in the doc, no cycles, depth \u22644, names 1-80 chars, icons are kit names (bettercms://icons/dock; legacy lucide names still draw). A 412 VERSION_CONFLICT means someone changed it since you read it: read again and re-apply. Returns the new version and a diff. ${STRUCTURE_FENCE}`,
+        `Replace the whole Content sidebar document in one write. Follow the structure standard (read ${STRUCTURE_PLAYBOOK_URI} first; suggest_content_structure returns a ready doc). Send the complete \`doc\` and the \`version\` get_content_structure returned (0 when the project has none yet). Validated exactly like the dashboard: unique folder ids, every parentId/folderId a folder in the doc, no cycles, depth \u22644, names 1-80 chars, kit icons (bettercms://icons/dock). A 412 VERSION_CONFLICT means someone changed it since you read it: read again and re-apply. Returns the new version and a diff. ${STRUCTURE_FENCE}`,
         z.object({
           doc: z.object({
             schema: z.literal(1),
@@ -3860,7 +3884,7 @@ ${d.outline}` : "Proposed Content structure.", d);
             items: z.array(z.object({
               kind: z.enum(["page", "collection"]),
               id: z.string().min(1).describe("page id or collection (content model) id"),
-              folderId: z.string().nullable().describe('folder id; "home:root" = pinned at the top level; null = its home (Other pages for a page, the Shared list for a collection)'),
+              folderId: z.string().nullable().describe('folder id; "home:root" = pinned at the top level; null = its home (Pages for a page, the Shared list for a collection)'),
               sort: z.number(),
               icon: z.string().nullable()
             }))
@@ -3893,13 +3917,13 @@ ${d.outline}` : "Proposed Content structure.", d);
       def(
         "move_to_folder",
         "Move into a Content sidebar folder",
-        `Move a page, a collection or a folder into a folder. folderId null moves it back to its home: Other pages for a page, the Shared list for a collection, the top level for a folder. It lands after what is already there. Moving a folder takes its contents with it and is refused if the result would nest deeper than 4 levels or put a folder inside itself. ${STRUCTURE_POINTER}`,
+        `Move a page, a collection or a folder into a folder. folderId null moves it back to its home: Pages for a page, the Shared list for a collection, the top level for a folder. It lands after what is already there. Moving a folder takes its contents with it and is refused if the result would nest deeper than 4 levels or put a folder inside itself. ${STRUCTURE_POINTER}`,
         z.object({
           kind: z.enum(["page", "collection", "folder"]).describe(
             "what the id IS on this branch \u2014 VERIFIED, not assumed: an id is either a page or a collection, never both, and a mismatch is refused with 400 NAV_KIND_MISMATCH naming the kind to use. Call it again with that kind, which also clears the wrong-kind entry."
           ),
           id: z.string().min(1).describe("the page id, collection (content model) id, or folder id"),
-          folderId: z.string().min(1).nullable().describe("target folder id; 'root' pins a page or collection at the top level (for a folder, 'root' is the top level); null moves it back to its home (Other pages, the Shared list, or the top level for a folder)")
+          folderId: z.string().min(1).nullable().describe("target folder id; 'root' pins a page or collection at the top level (for a folder, 'root' is the top level); null moves it back to its home (Pages, the Shared list, or the top level for a folder)")
         }).shape,
         async (c, a) => structureResult(await data(c, "POST", `/management/content-structure/move`, { kind: a.kind, id: a.id, folderId: a.folderId }))
       ),
@@ -4244,7 +4268,8 @@ ${d.outline}` : "Proposed Content structure.", d);
           override: z.boolean().optional().describe(OVERRIDE_NOTE),
           ifMatch: z.number().int().min(0).optional().describe(MODEL_IF_MATCH_NOTE),
           removeFields: z.array(z.string().min(1)).min(1).max(100).optional().describe(FIELD_REMOVAL_NOTE),
-          allowFieldRemoval: z.boolean().optional().describe(ALLOW_FIELD_REMOVAL_NOTE)
+          allowFieldRemoval: z.boolean().optional().describe(ALLOW_FIELD_REMOVAL_NOTE),
+          confirmed: z.boolean().optional().describe(PARAM_TEXT.confirmedInput)
         }).shape,
         // `fields` is sent only by removeFields, rebuilt from the model just read: the PATCH
         // replaces `fields` wholesale when present.
@@ -4269,7 +4294,7 @@ ${d.outline}` : "Proposed Content structure.", d);
             (await c.fetchJSON(c.url(path), {
               method: "PATCH",
               body: JSON.stringify(body),
-              ...ifMatch !== void 0 ? { headers: { "if-match": `W/"${ifMatch}"` } } : {}
+              ...withHeaders({ ...ifMatch !== void 0 ? { "if-match": `W/"${ifMatch}"` } : {}, ...confirmedHeaders(a.confirmed) })
             })).data
           );
         }
@@ -4468,7 +4493,8 @@ ${res.warnings.join("\n")}` : summary, res.data);
           allowRetype: z.boolean().optional().describe("confirm a type change, once the user has agreed"),
           allowFieldRemoval: z.boolean().optional().describe("with a rename: discard the old key's stored values"),
           mergeHref: z.string().min(1).optional().describe(PARAM_TEXT.mergeHref),
-          ifMatch: z.number().int().min(0).optional().describe("the model's optimisticVersion; the version read when omitted")
+          ifMatch: z.number().int().min(0).optional().describe("the model's optimisticVersion; the version read when omitted"),
+          confirmed: z.boolean().optional().describe(PARAM_TEXT.confirmedInput)
         }).shape,
         // Read the model (a page's through its backingModel), patch ONE field with the helper the
         // hosted catalogue uses, and PATCH the whole list at the version read. `mergeHref` is the
@@ -4496,7 +4522,7 @@ ${res.warnings.join("\n")}` : summary, res.data);
           const updated = (await c.fetchJSON(c.url(path), {
             method: "PATCH",
             body: JSON.stringify({ fields: plan.fields, ...a.allowFieldRemoval === true ? { allowFieldRemoval: true } : {} }),
-            ...plan.ifMatch !== void 0 ? { headers: { "If-Match": `W/"${plan.ifMatch}"` } } : {}
+            ...withHeaders({ ...plan.ifMatch !== void 0 ? { "If-Match": `W/"${plan.ifMatch}"` } : {}, ...confirmedHeaders(a.confirmed) })
           })).data;
           return ok(plan.renamed ? `Renamed '${plan.renamed.from}' to '${plan.renamed.to}'.` : `Updated field '${s(a.path)}'.`, updated);
         }
@@ -5132,12 +5158,17 @@ ${notes.join("\n")}` : summary, created);
         async (args) => withClient(async (client) => {
           if (!args.modelId === !args.pageId) return fail("Pass exactly one of modelId (a content model) or pageId (a page).");
           if (args.pageId) {
-            const page = await client.addPageFields(args.pageId, {
+            const input2 = {
               // Cast: the SDK types `options` as string[], narrower than the API, which also takes
               // {label, value} (backend selectFieldSchema).
               addFields: [toField(args)],
               ...args.after !== void 0 ? { after: args.after } : {}
-            });
+            };
+            const page = args.confirmed === true ? (await client.fetchJSON(client.url(`/management/pages/${args.pageId}`), {
+              method: "PATCH",
+              body: JSON.stringify(input2),
+              headers: confirmedHeaders(true)
+            })).data : await client.addPageFields(args.pageId, input2);
             return ok(`Added field '${args.key}' to page '${page.title}'. Page now has ${page.fields.length} field(s).`, page);
           }
           const modelId = args.modelId;
@@ -5160,7 +5191,12 @@ ${notes.join("\n")}` : summary, created);
           const nextFields = [...existingFields];
           nextFields.splice(at, 0, toField(args));
           const input = { fields: nextFields };
-          const updated = model.optimisticVersion !== void 0 ? await client.updateModel(modelId, input, { ifMatch: model.optimisticVersion }) : await client.updateModel(modelId, input);
+          const opts = model.optimisticVersion !== void 0 ? { ifMatch: model.optimisticVersion } : void 0;
+          const updated = args.confirmed === true ? (await client.fetchJSON(client.url(`/management/content/models/${modelId}`), {
+            method: "PATCH",
+            body: JSON.stringify(input),
+            headers: { ...opts ? { "If-Match": `W/"${opts.ifMatch}"` } : {}, ...confirmedHeaders(true) }
+          })).data : opts ? await client.updateModel(modelId, input, opts) : await client.updateModel(modelId, input);
           return ok(
             `Added field '${args.key}' to '${updated.name}'${args.after ? ` after '${args.after}'` : ""}. Model now has ${updated.fields.length} field(s).`,
             updated
@@ -5683,8 +5719,12 @@ ${lines.join("\n")}`, found);
       },
       handler: guard(
         async (args) => withClient(async (client) => {
-          const { componentId, ifMatch, ...input } = args;
-          const cmp = await client.updateComponent(componentId, input, { ifMatch });
+          const { componentId, ifMatch, confirmed, ...input } = args;
+          const cmp = confirmed === true ? (await client.fetchJSON(client.url(`/management/components/${componentId}`), {
+            method: "PATCH",
+            body: JSON.stringify(input),
+            headers: { ...ifMatch !== void 0 ? { "If-Match": `W/"${ifMatch}"` } : {}, ...confirmedHeaders(true) }
+          })).data : await client.updateComponent(componentId, input, { ifMatch });
           return ok(`Updated component '${cmp.name}' (id ${cmp.id}).`, cmp);
         })
       )
@@ -6124,7 +6164,9 @@ components \u2014 is \`editor_setup\`, run on demand against the live build. The
     ->  submit_conversion_receipt / submit_componentize_receipt  ->  deploy
 
 \`get_deploy_status\` \`editorSetup\` (and get_next_steps) say when it has not run for the live
-build: \`never\` or \`stale\` \u2192 run it before anything below.
+build: \`never\` or \`stale\` \u2192 run it before anything below. It also fills missing meta from the
+pages' own copy, merges components that are identical, and switches to declared bindings when the
+build proves every binding declared; get_next_steps lists only what it could not do.
 
 **Builds run \`build:bcms\` instead of \`build\`** when package.json declares one: the build alone,
 without CI checks (\`"build:bcms": "astro build"\` beside \`"build": "astro check && astro build"\`),
@@ -6602,7 +6644,8 @@ hand. THE ORDER, and every step of it matters:
    \`unmatched\` 0 and \`unaddressable\` under 2% of each route's visible text (\xA711). Fix what it
    names IN THE SOURCE and release again until \`coverage.pending\` is empty.
 7. \`set_binding_mode { declaredBindings: true }\` and release ONE MORE TIME \u2014 the mode applies to
-   the next release, not to the one already out.
+   the next release, not to the one already out. (editor_setup sets it itself when the build
+   already declares every binding; skip this step when get_binding_report reads \`declared\`.)
 
 **Or let BetterCMS propose the edit.** \`get_conversion_plan\` returns an APPROVED conversion \u2014 the
 exact new contents of each template file, reviewed by a human in the dashboard and already checked
@@ -6852,7 +6895,8 @@ Importance orders a screen: required fields first, then array order.
   schema: the same call with \`pageId\` instead of \`modelId\`, and the version from \`get_page\`'s
   \`backingModel\`.
 - A component's props: \`update_component\` with \`propUi\`, \`propGroup\`, \`propLabel\`, \`propHelpText\` (keyed by prop key).
-  Name props from the code (\`plan.cents\` \u2192 Cents), help text as \`e.g. "49"\`; repeated cards are one \`table\` prop.
+  Name props from the code (\`plan.cents\` \u2192 Cents); help text guides ("Whole number, no currency symbol."), never repeats
+  the value; repeated cards are one \`table\` prop. An icon (\`config.media: "icon"\`) is content: group it, never prune it.
   They write the DRAFT props; no publish is needed for the editor to show them.
 - Always send \`ifMatch\`, the \`optimisticVersion\` you read.
 - A NEW field carries its chrome in the same \`add_field\` call.
@@ -7647,7 +7691,7 @@ function buildServer(deps) {
     STRUCTURE_PLAYBOOK_URI,
     {
       title: "BetterCMS Content structure playbook",
-      description: "How to organise a project's Content sidebar: one place per document, the home page and list pages pinned, one folder per content family named for the detail type its route holds and ordered by entry count, shared taxonomies in Shared, Other pages for the rest, Settings last, at most 2 levels. With a worked set_content_structure payload.",
+      description: "How to organise a project's Content sidebar: one place per document, the home page and list pages pinned, one folder per content family named for the detail type its route holds and ordered by entry count, shared taxonomies in Shared, Pages for the rest, Settings last, at most 2 levels. With a worked set_content_structure payload.",
       mimeType: "text/markdown"
     },
     () => ({