@bettercms-ai/mcp 0.24.0 → 0.25.0

package/dist/index.js

@@ -3299,6 +3299,13 @@ function buildToolDefs(deps) {
         z.object({ slot: z.enum(["current", "staging"]).optional().describe("which release tree to read; defaults to the one this project deploys to") }).shape,
         async (c, a) => ok("Binding report.", await data(c, "GET", `/management/projects/current/binding-report${q({ slot: a.slot })}`))
       ),
+      def(
+        "get_conversion_brief",
+        "Get the brief for making this site's bindings durable",
+        "The per-project brief for making this site's bindings DURABLE \u2014 read it before you touch the templates. Returns what already exists in the CMS: every live page with its route, and every bindable field path with its `label`, `kind`, the value the CMS holds now (`current`) and the copy the repo renders today (`original`, the field's defaultValue) \u2014 plus the exact attributes to declare, and the ordered steps. Call it for any site whose pages were DERIVED at import, and whenever get_next_steps reports `bindings-not-declared`. It REPLACES re-registering a schema: these pages, fields and values exist already, so create_page / add_page_field / create_content_model would build a second schema over the first \u2014 edit values with set_page_content instead. `lane` says how to get the source ('git-connected' = pull_project_source returns a repo; 'archive' = a tarball). The full recipe is section 13 of the bettercms://playbook/schema resource; get_binding_report is the receipt that says you finished.",
+        z.object({}).shape,
+        async (c) => ok("Conversion brief.", await data(c, "GET", `/management/projects/current/conversion-brief`))
+      ),
       def(
         "get_analytics_overview",
         "Get traffic overview",
@@ -4300,6 +4307,13 @@ and only the canvas sees it \u2014 a release scan cannot.
                                     draft reads
     Presentation tool overlays  ->  the visual editor canvas, framing your own build
 
+**Imported site whose pages were DERIVED.** If this project was imported and made editable from
+its build, the schema and the values already exist \u2014 a page per route, a field per element, and
+the original copy carried on each field as its \`defaultValue\`. Call \`get_conversion_brief\`
+first: it lists those pages, their routes, every bindable path with its current and original
+value, and the attributes to declare. SKIP steps 3 and 4 below and bind the keys it names \u2014
+registering the schema again builds a second one over the first.
+
 **The steps.**
 
 1. \`pull_project_source\` (or clone the \`github\` remote it returns). Read the SOURCE. Never