@typeroll/mcp-server 0.45.43 → 0.45.45

package/skills/tr-migrate-wp.md

@@ -1,6 +1,6 @@
 ---
 name: tr-migrate-wp
-description: Use when the user asks to migrate a WordPress site to Typeroll, mentions wp-json, or names a WP source URL. Walks the WP REST API, preserves cleaned HTML and shared references, transfers media, sets redirects, and leaves everything as drafts for human review. Do not apply automatic HTML-to-blocks conversion.
+description: Use when the user asks to migrate a WordPress site to Typeroll, mentions wp-json, or names a WP source URL. Walks the WP REST API, preserves cleaned HTML and shared references, transfers media, sets redirects, and leaves everything as drafts for human review. Typeroll does not convert HTML into blocks.
 ---
 
 # Migrate from WordPress to Typeroll
@@ -19,9 +19,13 @@ Its shared evidence record is required for visual acceptance.
 > `trigger_deploy`. Preview your drafts with `include_working_copy: true`.
 
 
-The platform's in-portal migration workflow is the "managed" path for
-customers who want one-click. This skill is the "power-user" path: you
-do it locally, mix data sources freely, and the user reviews each step in their terminal.
+The platform's migration workflow is the "managed" path for customers who
+want one-click. It runs on the server and is also available to you:
+`start_workflow type="migration" config={ wp_url }` on an existing site, or
+`create_site_and_migrate` (organization key) for a new one; poll `get_workflow`
+and approve its review gate only with the user's consent. This skill is the
+"power-user" path: you do it locally, mix data sources freely, and the user
+reviews each step in their terminal.
 
 ## Preconditions
 
@@ -145,7 +149,7 @@ c. Migrate referenced images with `upload_media_from_url`. The customer's
    media reference only after verification. Stop and report a failed required
    transfer; do not silently hotlink the WordPress source.
 
-The managed importer stores cleaned HTML and does not run HTML-to-blocks conversion. Do not call `convert_page_to_blocks` or `set_page_mode` to rewrite that HTML. A person previews and accepts a conversion in the page editor.
+The managed importer stores cleaned HTML. Typeroll does not convert HTML into blocks, and `set_page_mode` never rewrites HTML. Pages move to blocks only when someone rebuilds them with blocks.
 
 d. Preserve exact text, headings, anchors, links, media and semantic structure with native blocks first. Read the
    available block types and map headings, prose, images, buttons and layout

package/skills/tr-new-site.md

@@ -32,7 +32,9 @@ wrapper. Load only the relevant guide section and recipe. Discover site apps wit
 read_app_documentation when needed; do not bundle private app guides locally.
 
 No Site yet? Use hosted MCP with an Organization key and create_site, or create it
-in the portal. Read back its ID before editing. Use one explicit Site/Version for
+in the portal. To start from an AI site plan instead of a blank Site, use
+create_site_and_plan, poll get_workflow and approve its structure review only
+with the user's consent. Read back its ID before editing. Use one explicit Site/Version for
 related operations. Larger changes to an existing site should use a branch.
 
 Before importing content or a media library, require get_import_readiness to pass.
@@ -359,9 +361,8 @@ For migrated legacy pages or a hand-crafted one-off, `content_mode:
   negative-margin escape (`margin-left: calc(50% - 50vw); width: 100vw`)
   — never combine with `overflow-x: clip` on a wrapper.
 - `set_page_mode` flips a page between modes and does not convert HTML.
-  `convert_page_to_blocks` previews a heuristic conversion, including
-  what it could not convert, and does not write. A person accepts that
-  preview in the page editor.
+  Typeroll has no HTML-to-blocks conversion: to move a page to blocks,
+  build its content with blocks.
 
 ## Pitfalls
 

package/skills/tr-redesign-branch.md

@@ -245,6 +245,15 @@ compiled output or merge. Wait for an explicit "looks good, ship it."
 
 ### 7. Merge + deploy
 
+Before asking for sign-off, summarise exactly what will land:
+
+```
+diff_version version_id="<branch>"        # added / modified / deleted per collection
+```
+
+Then, once approved (creating and merging branches need site admin
+permission):
+
 ```
 merge_branch version_id="<branch>"        # branch's diffs land on main
 trigger_deploy
@@ -274,7 +283,12 @@ disk cost is tiny.)
   the DB, reflects edits on reload); deploy only for the compiled static
   output or merge (steps 6–7).
 - **Auto-merge.** Don't `merge_branch` without explicit user sign-off.
-  Once merged, the only undo is another branch + reverse edits.
+  Once merged, the only undo is another branch + reverse edits (or
+  restoring individual saved states with `restore_page_revision` /
+  `restore_partial_revision` on main).
+- **Starting over.** To abandon a direction but keep the branch and its
+  address, `reset_version version_id="<branch>"` discards every change on it
+  (check `diff_version` and ask first); `delete_branch` removes it entirely.
 - **Header rewrites that drop the brand block.** Even when the
   redesign is dramatic, preserve the brand mark + the nav skeleton
   unless the user said to redo them.

package/skills/tr-seo.md

@@ -97,11 +97,25 @@ batch_update_pages updates=[
 OG image dimensions: 1200×630px ideal. The platform doesn't resize —
 use a correctly-sized source image.
 
+For pages without their own image, set a site-wide fallback and the X/Twitter
+handle (admin permission, as in the portal Settings form):
+
+```
+update_site_settings default_og_image="<cdn_url>" twitter_handle="@acmestudio"
+```
+
 ### 5. Add structured data (JSON-LD)
 
 Typeroll auto-generates Article and Page schema, but you can override or
 extend with custom JSON-LD per page. Example: LocalBusiness on the homepage.
 
+The site-wide Organization schema comes from settings — set it once instead of
+repeating it on every page (`null` clears it):
+
+```
+update_site_settings organization={"name":"Acme Studio","logo":"<cdn_url>","same_as":["https://www.linkedin.com/company/acme"]}
+```
+
 ```
 update_page page_id="home" patch={
   "json_ld": "{\"@context\":\"https://schema.org\",\"@type\":\"LocalBusiness\",\"name\":\"Acme Studio\",\"url\":\"https://acme.se\",\"telephone\":\"+46812345\",\"address\":{\"@type\":\"PostalAddress\",\"streetAddress\":\"Drottninggatan 1\",\"addressLocality\":\"Stockholm\",\"postalCode\":\"111 51\",\"addressCountry\":\"SE\"}}"