@bettercms-ai/mcp 0.66.0 → 0.66.2

package/dist/index.js

@@ -2277,10 +2277,10 @@ var STRUCTURE_EXAMPLE_PAYLOAD = {
   doc: {
     schema: 1,
     folders: [
-      { id: "home:pages", parentId: null, name: "Other pages", icon: "files", sort: 1e3 },
+      { id: "home:pages", parentId: null, name: "Other 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: "newspaper", sort: 0 },
-      { id: "fld_std_products", parentId: null, name: "Products", icon: "shopping-bag", sort: 1 }
+      { 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 }
     ],
     items: [
       { kind: "page", id: "pg_home", folderId: "home:root", sort: 0, icon: null },
@@ -2293,7 +2293,7 @@ var STRUCTURE_EXAMPLE_PAYLOAD = {
       { kind: "collection", id: "cm_tags", folderId: "home:collections", sort: 0, icon: null },
       { kind: "page", id: "pg_about", folderId: "home:pages", sort: 0, icon: null },
       { kind: "page", id: "pg_contact", folderId: "home:pages", sort: 1, icon: null },
-      { kind: "page", id: "pg_404", folderId: "home:pages", sort: 2, icon: "file-code" }
+      { kind: "page", id: "pg_404", folderId: "home:pages", sort: 2, icon: "code" }
     ]
   }
 };
@@ -2337,8 +2337,9 @@ ever changes.
 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.
-8. **Icons** (lucide names): \`newspaper\` for posts, \`shopping-bag\` for products, \`book-open\`
-   for docs, \`files\` for Other pages, \`folder\` by default.
+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
+   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.
 10. **Organisation only.** Never rename a page, change a slug, touch a schema or move content to
@@ -2367,8 +2368,8 @@ What the structure writes refuse, and the code each refusal carries:
   refuses a kind mismatch: it returns \`warnings\` and \`kindMismatches\` instead.
 - **Page-bound models** are refused with 400 \`NAV_PAGE_BOUND_MODEL\` naming their page; organise
   the page, by its page id.
-- **Shape:** folders nest at most 4 levels deep; names are 1-80 characters; icons are lucide
-  names (a-z, 0-9, dashes) and null clears one.
+- **Shape:** folders nest at most 4 levels deep; names are 1-80 characters; icons are kit
+  names (bettercms://icons/dock; a-z, 0-9, dashes) and null clears one.
 - **Access:** 403 \`SCHEMA_ACCESS_REQUIRED\` (rule 12).
 - **Version:** 412 \`VERSION_CONFLICT\` (workflow step 4).
 
@@ -2736,6 +2737,7 @@ function entryListSearch(args) {
   for (const key of ["modelId", "pageId", "status"]) if (args[key]) q.set(key, String(args[key]));
   for (const [k, v] of whereToQuery(args.where)) q.append(k, v);
   for (const key of ["sort", "page", "limit"]) if (args[key] !== void 0 && args[key] !== null) q.set(key, String(args[key]));
+  if (args.detail !== true) q.set("select", "summary");
   const s = q.toString();
   return s ? `?${s}` : "";
 }
@@ -3127,6 +3129,7 @@ var ENTRY_MERGE_NOTE = "true = keep the fields you leave out: the entry is read,
 var ENTRY_IF_MATCH_NOTE = "optimisticVersion from get_content_entry: the write applies only at that version, and a 409 means it changed since: read it again and re-apply. With merge it defaults to the version merge read.";
 var ENTRY_SCHEDULED_AT_NOTE = "ISO datetime to publish this draft at (needs publish permission); null cancels. An edit that omits scheduledAt CANCELS a pending publish schedule, so send it again with every edit made before it fires.";
 var ENTRY_UNPUBLISH_AT_NOTE = "ISO datetime at which the published entry returns to draft; null cancels. Omitting it never cancels it.";
+var ENTRY_LIST_DETAIL_NOTE = "true = full rows with every field value and the published copy. Large: read one entry with get_content_entry instead.";
 var ENTRY_LIST_LIMIT_NOTE = "entries per page, 1-200; 50 when omitted. Read `meta.totalPages` and ask for the next `page`.";
 var PAGE_HEAD_NOTE = "noindex, canonical, og and twitter set the page's head extras; each MERGES into what is stored (a key you leave out is kept, null or an empty string clears it).";
 var STRUCTURE_FENCE = "ORGANISATION ONLY: Content sidebar folders never change a URL, slug, content or publish state, and nothing is rebuilt or delivered; URL folders (page folders) are set in the dashboard. Read the resource bettercms://playbook/structure before you organise anything: it holds the rules this refuses on \u2014 system folders, type purity, the Admin/Developer access check, root pins and page-bound models.";
@@ -3411,7 +3414,8 @@ function buildToolDefs(deps) {
     where: z.record(z.string(), z.unknown()).optional().describe(PARAM_TEXT.where),
     sort: z.string().max(100).optional().describe(PARAM_TEXT.sort),
     page: z.number().int().min(1).optional().describe(PARAM_TEXT.page),
-    limit: z.number().int().min(1).max(200).optional().describe(ENTRY_LIST_LIMIT_NOTE)
+    limit: z.number().int().min(1).max(200).optional().describe(ENTRY_LIST_LIMIT_NOTE),
+    detail: z.boolean().optional().describe(ENTRY_LIST_DETAIL_NOTE)
   });
   const clearableText = (max) => z.string().max(max).nullable().optional();
   const headPatchShape = {
@@ -3568,7 +3572,7 @@ function buildToolDefs(deps) {
     projectId: z.string().min(1).optional().describe("required only for a workspace-scoped grant")
   });
   const layoutBinding = z.object({ inputId: z.string().min(1), fieldId: z.string().min(1) });
-  const layoutIcon = z.string().min(1).max(80).regex(/^(?:[a-z0-9]+(?:-[a-z0-9]+)*|[A-Z][A-Za-z0-9]+)$/).refine((value) => LAYOUT_SECTION_ICON_SET.has(value), "Select a supported Lucide icon").describe("Lucide icon name in canonical kebab-case; legacy CamelCase Layout icon names remain accepted");
+  const layoutIcon = z.string().min(1).max(80).regex(/^(?:[a-z0-9]+(?:-[a-z0-9]+)*|[A-Z][A-Za-z0-9]+)$/).refine((value) => DOCK_ICON_NAME_SET.has(value) || LAYOUT_SECTION_ICON_SET.has(value), "Select a kit icon (bettercms://icons/dock) or a legacy Lucide icon").describe("kit icon name from bettercms://icons/dock (e.g. 'document-text'); legacy Lucide names (kebab-case or CamelCase) remain accepted");
   const sectionTarget = { sectionId: z.string().min(1) };
   const layoutCommand = z.discriminatedUnion("type", [
     z.object({ type: z.literal("set-section-values"), ...sectionTarget, values: z.record(z.string(), z.unknown()) }),
@@ -3842,7 +3846,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, lucide icons. 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, 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}`,
         z.object({
           doc: z.object({
             schema: z.literal(1),
@@ -3850,7 +3854,7 @@ ${d.outline}` : "Proposed Content structure.", d);
               id: z.string().min(1).describe("your own stable id, up to 64 chars"),
               parentId: z.string().nullable().describe("parent folder id; null = top level"),
               name: z.string(),
-              icon: z.string().nullable().describe("lucide icon name or null"),
+              icon: z.string().nullable().describe("kit icon name (bettercms://icons/dock) or null"),
               sort: z.number()
             })),
             items: z.array(z.object({
@@ -3872,7 +3876,7 @@ ${d.outline}` : "Proposed Content structure.", d);
         z.object({
           name: z.string().min(1).describe("the folder's label, 1-80 chars"),
           parentId: z.string().min(1).optional().describe("optional parent folder id (from get_content_structure); omit it, or send 'root', for the top level"),
-          icon: z.string().min(1).optional().describe("optional lucide icon name, e.g. 'folder'")
+          icon: z.string().min(1).optional().describe("optional kit icon name (bettercms://icons/dock), e.g. 'folder'")
         }).shape,
         async (c, a) => structureResult(await data(c, "POST", `/management/content-structure/folders`, { name: a.name, parentId: a.parentId, icon: a.icon }))
       ),
@@ -3938,7 +3942,7 @@ ${d.outline}` : "Proposed Content structure.", d);
             "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"),
-          icon: z.string().min(1).nullable().describe("lucide icon name, e.g. 'file-text'; null clears it")
+          icon: z.string().min(1).nullable().describe("kit icon name (bettercms://icons/dock), e.g. 'document-text'; null clears it")
         }).shape,
         async (c, a) => structureResult(await data(c, "POST", `/management/content-structure/icon`, { kind: a.kind, id: a.id, icon: a.icon }))
       ),
@@ -5216,20 +5220,11 @@ ${notes.join("\n")}` : summary, created);
       name: "list_content_entries",
       config: {
         title: "List content entries (incl. drafts)",
-        description: "List content entries \u2014 including drafts \u2014 filtered by model and/or page, by field values (`where`), sorted and paged. Use it to SEE existing content before editing. For a singleton page, pass its pageId to get its single entry. A project-scoped connection sees its own project's entries plus workspace-level ones, which it can read but not change. Returns `limit` entries per `page` (50 by default); the summary says which page of how many.",
+        description: "List content entries \u2014 including drafts \u2014 filtered by model and/or page, by field values (`where`), sorted and paged. Use it to SEE existing content before editing. For a singleton page, pass its pageId to get its single entry. A project-scoped connection sees its own project's entries plus workspace-level ones, which it can read but not change. Returns `limit` entries per `page` (50 by default); the summary says which page of how many. Each entry is a SUMMARY (id, slug, title, status, model, page, dates, optimisticVersion) \u2014 read values with get_content_entry, or pass `detail: true` for full rows.",
         inputSchema: listEntriesInput.shape
       },
       handler: guard(
         async (args) => withClient(async (client) => {
-          const filter = {
-            ...args.modelId ? { modelId: args.modelId } : {},
-            ...args.pageId ? { pageId: args.pageId } : {},
-            ...args.status ? { status: args.status } : {}
-          };
-          if ([args.limit, args.where, args.sort, args.page].every((v) => v === void 0)) {
-            const entries = await client.listEntries(filter);
-            return ok(`${entries.length} entr(y/ies).`, entries);
-          }
           const res = await client.fetchJSON(
             client.url(`/management/content/entries${entryListSearch(args)}`),
             { method: "GET" }
@@ -6131,6 +6126,10 @@ components \u2014 is \`editor_setup\`, run on demand against the live build. The
 \`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.
 
+**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"\`),
+keeping any step the build needs. The convert codemod adds it; never edit \`build\` for BetterCMS.
+
 \`deploy_project\` and \`promote_project\` both answer **409
 AUTHORING_DECISION_REQUIRED** until a human has chosen this project's architecture. This is
 asked ONCE per project, ever. It is not an error to retry or route around: read the message