@bettercms-ai/mcp 0.46.0 → 0.48.0

package/dist/index.js

@@ -1991,8 +1991,8 @@ var STRUCTURE_EXAMPLE_PAYLOAD = {
   doc: {
     schema: 1,
     folders: [
-      { id: "home:pages", parentId: null, name: "Static pages", icon: "files", sort: -3 },
-      { id: "home:collections", parentId: null, name: "Other content", icon: null, sort: -2 },
+      { id: "home:pages", parentId: null, name: "Other pages", icon: "files", 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 }
     ],
@@ -2028,30 +2028,36 @@ ever changes.
 2. **Pinned at the top:** the home page, then each collection's LIST page (the dynamic page that
    lists it, e.g. /blog). A single document opens straight into the editor, so it is a pin, not a
    folder with one page in it.
-3. **One folder per content family.**
+3. **One folder per content family, named for the DETAIL type its route holds.** /blog gives
+   "Blog posts", /case-studies "Case studies", /careers "Jobs".
    - Blog: a "Blog posts" folder holding the blog collection. A folder with exactly one
      collection opens that collection's table directly.
    - Commerce: a "Products" folder holding the product collection AND its taxonomies (product
-     categories, product tags, materials, colours, sizes, merch collections, ...).
+     categories, product tags, merch collections, ...). Once there are more than four taxonomies,
+     the VARIANT OPTIONS (colours, sizes, materials) move into an "Attributes" subfolder; the
+     categories and tags stay beside the catalogue.
    - Decide the rest by the REFERENCE GRAPH: a collection that is referenced only by one family,
      or that references only one family (reviews \u2192 products), belongs in that family's folder.
      The family's main collection comes first, then the others in the order its fields reference
      them.
-4. **Other pages.** Standalone static pages go in the system folder \`home:pages\` ("Static
-   pages"). 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) get
-   a subfolder of Static pages; a large route family or one named for what it is (/docs/...) gets
-   its own top-level folder.
-5. **Shared taxonomies.** A vocabulary several families reference (Tags used by posts AND
-   products) goes in the system folder \`home:collections\`, named "Other content". So does
-   supporting content no family owns (testimonials, FAQs with no list page).
-6. **Icons** (lucide names): \`newspaper\` for posts, \`shopping-bag\` for products, \`book-open\`
-   for docs, \`files\` for Static pages, \`folder\` by default.
-7. **Depth:** nest at most 2 levels by default. The hard limit is 4; do not use it without a
+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
+   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.
+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.
+8. **Icons** (lucide names): \`newspaper\` for posts, \`shopping-bag\` for products, \`book-open\`
+   for docs, \`files\` for Other pages, \`folder\` by default.
+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.
-8. **Organisation only.** Never rename a page, change a slug, touch a schema or move content to
+10. **Organisation only.** Never rename a page, change a slug, touch a schema or move content to
    make a structure fit. The structure fits the site, not the other way round.
-9. **Page-bound models are not collections.** A page with fields has a content model bound to
+11. **Page-bound models are not collections.** A page with fields has a content model bound to
    it; it is never filed (400 \`NAV_PAGE_BOUND_MODEL\`). Organise the PAGE.
 
 ## The workflow
@@ -2084,14 +2090,15 @@ collection (\`cm_posts\`), a /shop list page (\`pg_shop\`, dynamic) for Products
 [pinned page] Home
 [pinned page] Blog            (/blog lists Blog)
 [pinned page] Shop            (/shop lists Products)
-[system folder] Static pages  icon=files
-  About, Contact, Not found (icon=file-code)
-[system folder] Other content
-  Tags                        (referenced by Blog AND Products: shared)
 [folder] Blog posts           icon=newspaper
   Blog
 [folder] Products             icon=shopping-bag
   Products, Product categories, Colours   (referenced only by Products)
+[system folder] Other pages   icon=files
+  About, Contact, Not found (icon=file-code)
+[system folder] Shared
+  Tags                        (referenced by Blog AND Products: shared)
+[system folder] Settings      (navigation, header, footer, site settings, SEO defaults)
 \`\`\`
 
 The exact \`set_content_structure\` payload (\`version: 0\` because the project had no structure):
@@ -2102,6 +2109,19 @@ ${JSON.stringify(STRUCTURE_EXAMPLE_PAYLOAD, null, 2)}
 `;
 
 // src/tools.ts
+async function askHuman(deps, q) {
+  if (!deps.elicit) return { prompt: q.prompt };
+  try {
+    const res = await deps.elicit({
+      message: q.message,
+      requestedSchema: { type: "object", properties: { [q.key]: q.property }, required: [q.key] }
+    });
+    const picked = res.action === "accept" ? res.content?.[q.key] : void 0;
+    if (q.accept(picked)) return { value: picked };
+  } catch {
+  }
+  return { prompt: q.prompt };
+}
 var FRAMEWORK_CHOICES = ["astro", "next", "react-ts", "other"];
 var FRAMEWORK_LABELS = {
   astro: "Astro \u2014 recommended default, static by default and fastest to publish",
@@ -2115,32 +2135,20 @@ var FRAMEWORK_PROMPT = [
   "",
   "Do not choose on their behalf. Sites cannot be built as plain HTML/CSS \u2014 every project is backed by one of these starters, which is what keeps its content editable in the CMS."
 ].join("\n");
-async function askFramework(deps) {
-  if (!deps.elicit) return { prompt: FRAMEWORK_PROMPT };
-  try {
-    const res = await deps.elicit({
-      message: "Which technology should this site be built with?",
-      requestedSchema: {
-        type: "object",
-        properties: {
-          framework: {
-            type: "string",
-            title: "Technology",
-            description: "The frontend stack this project's starter is based on.",
-            enum: [...FRAMEWORK_CHOICES],
-            enumNames: FRAMEWORK_CHOICES.map((c) => FRAMEWORK_LABELS[c])
-          }
-        },
-        required: ["framework"]
-      }
-    });
-    const picked = res.action === "accept" ? res.content?.framework : void 0;
-    if (typeof picked === "string" && FRAMEWORK_CHOICES.includes(picked)) {
-      return { framework: picked };
-    }
-  } catch {
-  }
-  return { prompt: FRAMEWORK_PROMPT };
+function askFramework(deps) {
+  return askHuman(deps, {
+    key: "framework",
+    message: "Which technology should this site be built with?",
+    property: {
+      type: "string",
+      title: "Technology",
+      description: "The frontend stack this project's starter is based on.",
+      enum: [...FRAMEWORK_CHOICES],
+      enumNames: FRAMEWORK_CHOICES.map((c) => FRAMEWORK_LABELS[c])
+    },
+    accept: (v) => typeof v === "string" && FRAMEWORK_CHOICES.includes(v),
+    prompt: FRAMEWORK_PROMPT
+  });
 }
 var AUTHORING_CHOICES = ["components", "fields"];
 var AUTHORING_LABELS = {
@@ -2156,32 +2164,41 @@ var AUTHORING_PROMPT = [
   "Recommend components unless the user says the site is schema-first.",
   "Do not choose on their behalf. This is asked once per project."
 ].join("\n");
-async function askAuthoring(deps) {
-  if (!deps.elicit) return { prompt: AUTHORING_PROMPT };
-  try {
-    const res = await deps.elicit({
-      message: "Which authoring architecture should this site use? Components is recommended for a marketing site.",
-      requestedSchema: {
-        type: "object",
-        properties: {
-          preference: {
-            type: "string",
-            title: "Authoring architecture",
-            description: "How this site's pages are composed. Components is recommended unless this is a schema-first site (a blog, catalogue or directory). Asked once per project.",
-            enum: [...AUTHORING_CHOICES],
-            enumNames: AUTHORING_CHOICES.map((c) => AUTHORING_LABELS[c])
-          }
-        },
-        required: ["preference"]
-      }
-    });
-    const picked = res.action === "accept" ? res.content?.preference : void 0;
-    if (typeof picked === "string" && AUTHORING_CHOICES.includes(picked)) {
-      return { preference: picked };
-    }
-  } catch {
-  }
-  return { prompt: AUTHORING_PROMPT };
+function askAuthoring(deps) {
+  return askHuman(deps, {
+    key: "preference",
+    message: "Which authoring architecture should this site use? Components is recommended for a marketing site.",
+    property: {
+      type: "string",
+      title: "Authoring architecture",
+      description: "How this site's pages are composed. Components is recommended unless this is a schema-first site (a blog, catalogue or directory). Asked once per project.",
+      enum: [...AUTHORING_CHOICES],
+      enumNames: AUTHORING_CHOICES.map((c) => AUTHORING_LABELS[c])
+    },
+    accept: (v) => typeof v === "string" && AUTHORING_CHOICES.includes(v),
+    prompt: AUTHORING_PROMPT
+  });
+}
+var USE_CDN_PROMPT = [
+  "Ask the user where this site's media should be served from, then call set_media_delivery again with their answer as `useCdn`:",
+  "  1. true  \u2014 the BetterCMS CDN (recommended, and the default). Media URLs are minted on the CDN host, or on the project's own CDN base if it stores media in its own bucket.",
+  "  2. false \u2014 the API origin. Media URLs are minted on the API host instead. Same bytes, same service; only the hostname differs.",
+  "",
+  "This applies to URLs minted FROM NOW ON. Already-published content keeps the URLs it has, and they keep working."
+].join("\n");
+function askMediaDelivery(deps) {
+  return askHuman(deps, {
+    key: "useCdn",
+    message: "Serve this site's media from the BetterCMS CDN (recommended), or from the API origin?",
+    property: {
+      type: "boolean",
+      title: "Use the CDN",
+      description: "On (default): media URLs are minted on the CDN \u2014 or on this project's own CDN base if it uses its own bucket. Off: they are minted on the API origin instead. Same bytes either way; only the host changes, and only for URLs minted from now on.",
+      default: true
+    },
+    accept: (v) => typeof v === "boolean",
+    prompt: USE_CDN_PROMPT
+  });
 }
 var fieldType = z.enum([
   "text",
@@ -2393,7 +2410,7 @@ function toField(f) {
     ...f.config ? { config: f.config } : {}
   };
 }
-var STRUCTURE_NOTE = 'ORGANISATION ONLY: folders never change a URL, slug, content or publish state, and nothing is rebuilt or delivered. Folders nest at most 4 levels deep (a page or collection may sit in a level-4 folder). Icons are lucide icon names, e.g. "folder", "file-text", "rows-3", "house" (a-z, 0-9 and dashes); null clears one. SYSTEM FOLDERS (CPO-129): "home:pages" (Static pages), "home:collections" (Collections) and "home:globals" (Globals) always exist, even when the document has no record for them. They stay at the top level and can never be moved or deleted (400 NAV_SYSTEM_FOLDER), but rename_folder and set_icon work on them and create their record on first use. TYPE PURITY: anything inside Static pages, at any depth, must be a page, and anything inside Collections must be a collection, and Globals holds NO pages or collections at all, because globals are not sidebar items (subfolders under Globals are allowed but stay empty). Any of these is 400 NAV_TYPE_MISMATCH. Your own folders hold either kind. ACCESS (CPO-131): Requires Admin or Developer access to CHANGE the structure, the same access as editing the schema; anyone who can read content can call get_content_structure. A 403 SCHEMA_ACCESS_REQUIRED means the person behind this connection is not an Admin or Developer: stop and tell the user, do not retry. ROOT PINS (CPO-132): folderId \'root\' pins a page or collection at the top level; null returns it to its home (Static pages / Collections). Pins sit above the folders, in their own order, and may be 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). KIND CHECK: an id is either a page or a collection, never both, and a custom folder holds either \u2014 so move_to_folder and set_icon VERIFY that the id really is the `kind` you named on this branch, and refuse a mismatch with 400 NAV_KIND_MISMATCH naming the kind to use; call it again with that kind, which also clears the wrong-kind entry. An id that resolves to nothing is allowed (it may exist on another branch) and the result says so. set_content_structure never refuses: it returns `warnings` and `kindMismatches`. get_content_structure marks such items `kindMismatch: true` and lists them in `summary.kindMismatches`. PAGE-BOUND MODELS (CPO-135): a page with fields has a content model bound to it. That model is NOT a collection \u2014 get_content_structure never lists it among collections or in the tree, and move_to_folder / set_icon / set_content_structure refuse it with 400 NAV_PAGE_BOUND_MODEL naming the owning page (\'This model belongs to the page "\u2026"; organise the page.\'). Organise the PAGE instead, by its page id. If a stored document still references one it appears in `summary.hiddenItems` with `boundToPageId`, and the next single write drops it.';
+var STRUCTURE_NOTE = 'ORGANISATION ONLY: folders never change a URL, slug, content or publish state, and nothing is rebuilt or delivered. Folders nest at most 4 levels deep (a page or collection may sit in a level-4 folder). Icons are lucide icon names, e.g. "folder", "file-text", "rows-3", "house" (a-z, 0-9 and dashes); null clears one. SYSTEM FOLDERS (CPO-129): "home:pages" (Other pages), "home:collections" (Shared) and "home:globals" (Settings) always exist, even when the document has no record for them. They close the sidebar, below the folders you make, and can never be moved or deleted (400 NAV_SYSTEM_FOLDER), but rename_folder and set_icon work on them and create their record on first use. TYPE PURITY: anything inside Other pages, at any depth, must be a page, and anything inside Shared must be a collection, and Settings holds NO pages or collections at all, because globals are not sidebar items (subfolders under Settings are allowed but stay empty). Any of these is 400 NAV_TYPE_MISMATCH. Your own folders hold either kind. ACCESS (CPO-131): Requires Admin or Developer access to CHANGE the structure, the same access as editing the schema; anyone who can read content can call get_content_structure. A 403 SCHEMA_ACCESS_REQUIRED means the person behind this connection is not an Admin or Developer: stop and tell the user, do not retry. ROOT PINS (CPO-132): folderId \'root\' pins a page or collection at the top level; null returns it to its home (Other pages / Shared). Pins sit above the folders, in their own order, and may be 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). KIND CHECK: an id is either a page or a collection, never both, and a custom folder holds either \u2014 so move_to_folder and set_icon VERIFY that the id really is the `kind` you named on this branch, and refuse a mismatch with 400 NAV_KIND_MISMATCH naming the kind to use; call it again with that kind, which also clears the wrong-kind entry. An id that resolves to nothing is allowed (it may exist on another branch) and the result says so. set_content_structure never refuses: it returns `warnings` and `kindMismatches`. get_content_structure marks such items `kindMismatch: true` and lists them in `summary.kindMismatches`. PAGE-BOUND MODELS (CPO-135): a page with fields has a content model bound to it. That model is NOT a collection \u2014 get_content_structure never lists it among collections or in the tree, and move_to_folder / set_icon / set_content_structure refuse it with 400 NAV_PAGE_BOUND_MODEL naming the owning page (\'This model belongs to the page "\u2026"; organise the page.\'). Organise the PAGE instead, by its page id. If a stored document still references one it appears in `summary.hiddenItems` with `boundToPageId`, and the next single write drops it.';
 function structureResult(d) {
   const message = d?.message;
   return ok(typeof message === "string" ? message : "Updated the Content structure.", d);
@@ -3067,7 +3084,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 platform's own implementation of the standard over the project's pages, collections, their references and the routes its build serves: the home page and each collection's list page pinned at the top, one folder per content family (Blog posts, Products with its taxonomies, grouped by the reference graph), shared taxonomies in Other content, standalone and code-only pages in Static 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 platform's own implementation of the standard over the project's pages, collections, their references and the routes its build serves: the home page and each collection's list page pinned at the top, one folder per content family named for the detail type its route holds (Blog posts, Case studies, Jobs, Products with its taxonomies and an Attributes subfolder for its variant options), ordered by entry count (or the site navigation, when the caller supplies its link order), shared taxonomies in Shared, every remaining standalone and code-only 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.`,
         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,
@@ -3094,7 +3111,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 (Static pages for a page, the Collections list for a collection)'),
+              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)'),
               sort: z.number(),
               icon: z.string().nullable()
             }))
@@ -3127,11 +3144,11 @@ ${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: Static pages for a page, the Collections 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_NOTE}`,
+        `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_NOTE}`,
         z.object({
           kind: z.enum(["page", "collection", "folder"]),
           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 (Static pages, the Collections 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 (Other 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 }))
       ),
@@ -3299,7 +3316,7 @@ ${d.outline}` : "Proposed Content structure.", d);
           if (framework === void 0) {
             const asked = await askFramework(deps);
             if ("prompt" in asked) return fail(asked.prompt);
-            framework = asked.framework;
+            framework = asked.value;
           }
           return ok("Created project.", await data(c, "POST", `/management/projects`, { ...a, framework }));
         }
@@ -3318,7 +3335,7 @@ ${d.outline}` : "Proposed Content structure.", d);
           if (preference === void 0) {
             const asked = await askAuthoring(deps);
             if ("prompt" in asked) return fail(asked.prompt);
-            preference = asked.preference;
+            preference = asked.value;
           }
           return ok("Recorded the authoring architecture.", await data(c, "PATCH", `/management/projects/current/authoring-preference`, { preference }));
         }
@@ -3330,6 +3347,24 @@ ${d.outline}` : "Proposed Content structure.", d);
         z.object({ declaredBindings: z.boolean().describe("true = trust the template's declared bindings; false = text-match (the default)") }).shape,
         async (c, a) => ok("Recorded the binding mode.", await data(c, "PATCH", `/management/projects/current/binding-mode`, { declaredBindings: a.declaredBindings }))
       ),
+      def(
+        "set_media_delivery",
+        "Choose where this site's media is served from",
+        "Record whether this project's media (images, video, files) is served from the BetterCMS CDN or from the API origin. `useCdn: true` is the DEFAULT and the recommendation: URLs are minted on the CDN host, or on the project's own CDN base when it stores media in its own bucket (BYOK). `useCdn: false` mints them on the API origin instead \u2014 the same service serving the same bytes, only under a different hostname. ASK THE USER; do not pick for them. Called without `useCdn`, this tool asks them directly (or hands you the question to ask). \u{1F534} IT APPLIES TO URLs MINTED FROM NOW ON \u2014 new uploads, entry saves, get_media. It does NOT rewrite URLs already stored in published content, and it does not need to: the old URLs keep resolving. To move an existing image, re-save the field that holds it. \u{1F534} IT IS THE BACKEND HALF ONLY. A deployed frontend builds its own transform URLs with @bettercms-ai/image-url, which has its own media host \u2014 set `PUBLIC_BCMS_MEDIA_URL` (or the integration's `mediaUrl` option) to match, or that site's resized images stay on the CDN while everything else moves. Read the current answer from get_project (`useCdn`). Re-callable; the last answer wins.",
+        // Optional in the schema for the same reason `framework` and `preference` are: a
+        // required arg is rejected by the SDK before the handler runs, which would kill the
+        // elicitation below and leave the model guessing.
+        z.object({ useCdn: z.boolean().optional().describe("REQUIRED in effect \u2014 the USER's answer. true = CDN (the default), false = API origin. Ask them; never default it.") }).shape,
+        async (c, a) => {
+          let useCdn = a.useCdn;
+          if (useCdn === void 0) {
+            const asked = await askMediaDelivery(deps);
+            if ("prompt" in asked) return fail(asked.prompt);
+            useCdn = asked.value;
+          }
+          return ok("Recorded the media delivery origin.", await data(c, "PATCH", `/management/projects/current/media-delivery`, { useCdn }));
+        }
+      ),
       def(
         "submit_conversion_receipt",
         "Record what the conversion codemod could and could not do",
@@ -6007,7 +6042,7 @@ and \`ui\` only changes editor chrome, so there is nothing to flip.`
 
 // src/server.ts
 var SERVER_NAME = "bettercms";
-var SERVER_VERSION = "1.4.0";
+var SERVER_VERSION = "1.5.0";
 var SERVER_DISPLAY = {
   title: "BetterCMS",
   websiteUrl: "https://bettercms.ai",
@@ -6034,7 +6069,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 grouped by the reference graph, shared taxonomies in Other content, Static pages for the rest, 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, Other pages for the rest, Settings last, at most 2 levels. With a worked set_content_structure payload.",
       mimeType: "text/markdown"
     },
     () => ({