@cmo-so/mcp 0.12.7 → 0.12.9

package/dist/cmo-mcp.mjs

@@ -7199,7 +7199,7 @@ var require_dist = __commonJS({
 // package.json
 var package_default = {
   name: "@cmo-so/cli",
-  version: "0.12.7",
+  version: "0.12.9",
   description: "CMO.so on the command line: your websites, ideas, blog posts, LinkedIn queue and results, plus a local MCP server for Claude Desktop, Cursor and other MCP clients.",
   type: "module",
   license: "MIT",
@@ -14718,6 +14718,54 @@ function replace(blocks, ref, next, synced = {}) {
 function sectionAt(blocks, ref, synced = {}) {
   return pick(locate(blocks), ref, synced);
 }
+function widthValue(width) {
+  const w = String(width ?? "").trim();
+  if (w === "content") return null;
+  if (w === "wide") return "var(--wp--style--global--wide-size)";
+  if (/^\d{2,4}(\.\d+)?(px|rem|em|vw|%)$/.test(w)) return w;
+  throw new Error('width: "content", "wide" or a CSS length such as 1240px.');
+}
+var NARROW_PX = 700;
+var sizePx = (v) => {
+  const m = /^(\d+(?:\.\d+)?)(px|rem|em)$/.exec(v);
+  return m ? Number(m[1]) * (m[2] === "px" ? 1 : 16) : null;
+};
+function setSectionWidth(b, width) {
+  const size = widthValue(width);
+  const before = [];
+  const visit = (x, top) => {
+    let changed = false;
+    for (const c of x.inner) if (visit(c, false)) changed = true;
+    const lay = x.attrs.layout;
+    const constrained = lay?.type === "constrained";
+    const cur = lay?.contentSize;
+    const px = cur ? sizePx(cur) : null;
+    const eligible = constrained && (!cur || cur.includes("--wp--style--global") || px == null || px >= NARROW_PX);
+    if (eligible || top && !lay && (x.name === "core/group" || x.name === "core/cover")) {
+      if ((cur ?? null) !== size) {
+        before.push(cur ?? "content");
+        const next = { ...lay ?? {}, type: "constrained" };
+        if (size) next.contentSize = size;
+        else delete next.contentSize;
+        x.attrs = { ...x.attrs, layout: next };
+        changed = true;
+      }
+    }
+    if (changed) delete x.raw;
+    return changed;
+  };
+  visit(b, true);
+  return { containers: before.length, before };
+}
+function refreshRaw(list3) {
+  let any = false;
+  for (const b of list3) {
+    const inner = refreshRaw(b.inner);
+    if (inner) delete b.raw;
+    if (inner || b.raw == null) any = true;
+  }
+  return any;
+}
 var escRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 function applyEdits(b, e) {
   let m = serializeBlock(b);
@@ -15155,6 +15203,15 @@ async function styleGet(site) {
       fonts: (user.settings?.typography?.fontFamilies?.theme ?? []).map((f) => f.slug)
     },
     contrast: contrastReport(Object.fromEntries([...palette.values()].map((c) => [c.slug, c.color]))),
+    layout: {
+      content: user.settings?.layout?.contentSize ?? base.settings?.layout?.contentSize ?? null,
+      wide: user.settings?.layout?.wideSize ?? base.settings?.layout?.wideSize ?? null,
+      padding: {
+        left: user.styles?.spacing?.padding?.left ?? base.styles?.spacing?.padding?.left ?? null,
+        right: user.styles?.spacing?.padding?.right ?? base.styles?.spacing?.padding?.right ?? null
+      }
+    },
+    css: user.styles?.css ?? "",
     _palette: [...palette.values()],
     _fonts: [...fonts.values()],
     _user: user
@@ -15195,6 +15252,17 @@ function contrastReport(colors) {
   });
 }
 async function styleSet(site, change, force = false) {
+  const len = (v, what) => {
+    const t = String(v ?? "").trim();
+    if (!/^(0|\d{1,4}(\.\d+)?(px|rem|em|vw|%)|var\(--wp--preset--spacing--[a-z0-9-]+\)|clamp\([0-9a-z.,%+\-\s()]+\))$/i.test(
+      t
+    ))
+      throw new Error(`${what}: "${t}" isn't a CSS length like 1240px, 2rem or var(--wp--preset--spacing--50).`);
+    return t;
+  };
+  for (const css of [change.css, change.css_append])
+    if (css != null && /<\/?style|<\?|<script|@import\s+url\(\s*['"]?(?!https:)/i.test(css))
+      throw new Error("css: plain CSS only (no <style>, <script>, PHP or non-https imports).");
   const cur = await styleGet(site);
   const palette = cur._palette.map((c) => ({ ...c }));
   for (const [slug, color] of Object.entries(change.colors ?? {})) {
@@ -15219,15 +15287,48 @@ async function styleSet(site, change, force = false) {
     );
   const user = cur._user;
   const settings = { ...user.settings ?? {} };
+  const styles = { ...user.styles ?? {} };
   if (change.colors) settings.color = { ...settings.color ?? {}, palette: { theme: palette } };
   if (change.fonts)
     settings.typography = { ...settings.typography ?? {}, fontFamilies: { theme: fonts } };
+  if (change.layout) {
+    const layout = { ...settings.layout ?? {} };
+    if (change.layout.content != null) layout.contentSize = len(change.layout.content, "layout.content");
+    if (change.layout.wide != null) layout.wideSize = len(change.layout.wide, "layout.wide");
+    settings.layout = layout;
+  }
+  if (change.padding) {
+    const spacing = { ...styles.spacing ?? {} };
+    const pad = { ...spacing.padding ?? {} };
+    if (change.padding.left != null) pad.left = len(change.padding.left, "padding.left");
+    if (change.padding.right != null) pad.right = len(change.padding.right, "padding.right");
+    styles.spacing = { ...spacing, padding: pad };
+    settings.useRootPaddingAwareAlignments = true;
+  }
+  if (change.css != null) styles.css = change.css;
+  if (change.css_append)
+    styles.css = `${String(styles.css ?? "").trimEnd()}
+
+${change.css_append.trim()}
+`.trimStart();
   await call(site, {
     method: "POST",
     path: `/wp/v2/global-styles/${cur.id}`,
-    body: { settings, styles: user.styles ?? {} }
+    body: { settings, styles }
   });
+  const changedLayout = change.layout || change.padding;
   return {
+    ...changedLayout ? {
+      layout: {
+        before: cur.layout,
+        after: {
+          content: settings.layout?.contentSize ?? cur.layout.content,
+          wide: settings.layout?.wideSize ?? cur.layout.wide,
+          padding: change.padding ? { ...cur.layout.padding, ...change.padding } : cur.layout.padding
+        }
+      }
+    } : {},
+    ...change.css != null || change.css_append ? { css: { before: cur.css.length, after: String(styles.css ?? "").length, before_text: cur.css } } : {},
     colors: Object.fromEntries(
       Object.entries(change.colors ?? {}).map(([k, v]) => [k, { before: cur.colors[k], after: v }])
     ),
@@ -16269,7 +16370,7 @@ var siteTools = [
   }),
   tool({
     name: "wp_style_get",
-    description: "The brand: colours (by name: canvas, panel, soft, ink, muted, olive, accent\u2026) and fonts (display, body), and the text contrast of each colour pair.",
+    description: "The site's look: colours (by name: canvas, panel, soft, ink, muted, olive, accent\u2026), fonts (display, body), layout widths (content, wide) and page padding, the extra CSS, and the text contrast of each colour pair.",
     parameters: { type: "object", properties: {} },
     group: "site",
     need: READ,
@@ -16277,7 +16378,14 @@ var siteTools = [
     gates: ["WP"],
     run: async (ctx) => {
       const s = await styleGet(siteOf(ctx));
-      return { colors: s.colors, fonts: s.fonts, customized: s.customized, contrast: s.contrast };
+      return {
+        colors: s.colors,
+        fonts: s.fonts,
+        layout: s.layout,
+        css: s.css,
+        customized: s.customized,
+        contrast: s.contrast
+      };
     }
   })
 ];
@@ -16719,12 +16827,15 @@ var sectionTools = [
   }),
   tool({
     name: "wp_section_update",
-    description: "Change one section. edits: change text, links or pictures inside it and keep its design (works on any section, the homepage too). slots: write the section again from new content (generated types; give the complete content). faq: add, remove (1-based numbers) or replace questions.",
+    description: 'Change one section. width: line its content up with the header and footer ("wide") or another width, one section or all. edits: change text, links or pictures inside it and keep its design (works on any section, the homepage too). slots: write the section again from new content (generated types; give the complete content). faq: add, remove (1-based numbers) or replace questions.',
     parameters: {
       type: "object",
       properties: {
         page: PAGE,
-        section: str2("Section id from wp_page_get (s2, m4) or its type (faq)."),
+        section: str2('Section id from wp_page_get (s2, m4) or its type (faq); "all" with width only.'),
+        width: str2(
+          `The section's inner width: "content" (the site's content width), "wide" (the site's wide width, as the header and footer) or a CSS length (1240px). Changes the section and its containers wider than 700px; with section "all", every section on the page.`
+        ),
         edits: EDITS,
         slots: obj("Complete new content for the section (same type unless type is given)."),
         markup: str2(
@@ -16753,6 +16864,19 @@ var sectionTools = [
     ),
     run: (ctx, a) => changePage(ctx, a, (blocks, kit) => {
       const ref = String(a.section);
+      if (a.width != null && a.width !== "") {
+        const targets = ref === "all" ? locate(blocks) : [sectionAt(blocks, ref, kit.syncedTitles)];
+        const changed = {};
+        for (const t of targets) {
+          if (t.block.name === "core/block") continue;
+          const r = setSectionWidth(t.block, a.width);
+          if (r.containers) changed[t.id] = r;
+        }
+        refreshRaw(blocks);
+        if (!Object.keys(changed).length) throw new Error("Those sections already have that width.");
+        return { blocks, note: { width: String(a.width), sections: changed } };
+      }
+      if (ref === "all") throw new Error('section "all" works with width only.');
       const target = sectionAt(blocks, ref, kit.syncedTitles);
       const type = classify(target.block, target.region, kit.syncedTitles);
       let next;
@@ -17187,7 +17311,7 @@ var childTools = [
           files[`assets/fonts/${name}`] = btoa(bin);
           let fam = fams.find((x) => x.slug === f.slug);
           const stack = `"${f.family}", ${f.fallback || "sans-serif"}`;
-          if (!fam || !fam.fontFamily.includes(`"${f.family}"`)) {
+          if (!fam?.fontFamily.includes(`"${f.family}"`)) {
             const keep = fam ? fams.indexOf(fam) : -1;
             fam = { slug: f.slug, name: f.family, fontFamily: stack, fontFace: [] };
             if (keep >= 0) fams[keep] = fam;
@@ -17658,23 +17782,41 @@ var elementTools = [
   }),
   tool({
     name: "wp_style_set",
-    description: "Change brand colours (by name, hex) and fonts (by name, CSS font-family) for the whole site. Refuses colours that would make text hard to read (contrast under 4.5:1).",
+    description: "Change the whole site's look: brand colours (by name, hex), fonts (by name, CSS font-family), layout widths (content: the width sections and text use; wide: the header, footer and wide blocks), the left and right page padding, and extra CSS. Saved in the site's Global Styles (works on any block theme; returns before and after). Refuses colours that would make text hard to read (contrast under 4.5:1). One section's width: wp_section_update width.",
     parameters: {
       type: "object",
       properties: {
         colors: obj('e.g. { "olive": "#4F5B48", "accent": "#A8834F" }.'),
-        fonts: obj('e.g. { "display": "\\"Playfair Display\\", Georgia, serif" }.')
+        fonts: obj('e.g. { "display": "\\"Playfair Display\\", Georgia, serif" }.'),
+        layout: obj('Widths, e.g. { "content": "1240px", "wide": "1240px" }.', {
+          content: str2("Content width (CSS length)."),
+          wide: str2("Wide width (CSS length).")
+        }),
+        padding: obj('Left and right page padding, e.g. { "left": "24px", "right": "24px" }.', {
+          left: str2(""),
+          right: str2("")
+        }),
+        css: str2("Replace the site's extra CSS (Global Styles \u2192 Additional CSS); plain CSS only."),
+        css_append: str2("Add this CSS after the site's extra CSS.")
       }
     },
     group: "site",
     need: WRITE,
     risk: "W3",
     gates: [...GATES],
-    confirm: (_a3, lang) => say(lang, "Change the website's brand colours or fonts (every page).", "\u4FEE\u6539\u7DB2\u7AD9\u7684\u54C1\u724C\u984F\u8272\u6216\u5B57\u9AD4\uFF08\u6240\u6709\u9801\u9762\uFF09\u3002"),
-    run: async (ctx, a) => {
-      const r = await styleSet(siteOf(ctx), { colors: a.colors, fonts: a.fonts });
-      return r;
-    }
+    confirm: (_a3, lang) => say(
+      lang,
+      "Change the website's look for every page (colours, fonts, widths, padding or extra CSS); the result shows before and after.",
+      "\u4FEE\u6539\u7DB2\u7AD9\u6240\u6709\u9801\u9762\u7684\u5916\u89C0\uFF08\u984F\u8272\u3001\u5B57\u9AD4\u3001\u5BEC\u5EA6\u3001\u908A\u8DDD\u6216\u984D\u5916 CSS\uFF09\uFF1B\u7D50\u679C\u6703\u5217\u51FA\u4FEE\u6539\u524D\u5F8C\u3002"
+    ),
+    run: async (ctx, a) => styleSet(siteOf(ctx), {
+      colors: a.colors,
+      fonts: a.fonts,
+      layout: a.layout,
+      padding: a.padding,
+      css: typeof a.css === "string" ? a.css : void 0,
+      css_append: typeof a.css_append === "string" ? a.css_append : void 0
+    })
   })
 ];
 function checkMarkup(markup, what) {
@@ -18006,6 +18148,49 @@ var fullTools = [
       });
     }
   }),
+  tool({
+    name: "wp_term_delete",
+    description: "Delete a category or tag by id. Posts keep their other terms; posts left without a category go to the default category, which can't be deleted. Terms have no trash: the result gives name, slug and description to recreate it with wp_term_save.",
+    parameters: {
+      type: "object",
+      properties: {
+        taxonomy: { type: "string", enum: ["categories", "tags"], description: "Default categories." },
+        id: int2("The term to delete (from wp_terms_list).")
+      },
+      required: ["id"]
+    },
+    group: "site",
+    need: WRITE,
+    risk: "W3",
+    gates: [...GATES],
+    confirm: (a, lang) => say(
+      lang,
+      `Delete the ${a.taxonomy === "tags" ? "tag" : "category"} #${String(a.id)} from your website (posts stay; it can be recreated, not restored).`,
+      `\u522A\u9664\u7DB2\u7AD9\u7684${a.taxonomy === "tags" ? "\u6A19\u7C64" : "\u5206\u985E"} #${String(a.id)}\uFF08\u6587\u7AE0\u4FDD\u7559\uFF1B\u53EF\u91CD\u65B0\u5EFA\u7ACB\uFF0C\u7121\u6CD5\u9084\u539F\uFF09\u3002`
+    ),
+    run: async (ctx, a) => {
+      const site = siteOf(ctx);
+      const tax = a.taxonomy === "tags" ? "tags" : "categories";
+      const id = Number(a.id);
+      if (!Number.isInteger(id) || id <= 0) throw new Error("id: the term id from wp_terms_list.");
+      if (tax === "categories") {
+        const st = await call(site, {
+          path: "/wp/v2/settings",
+          query: { _fields: "default_category" }
+        });
+        if (Number(st.default_category ?? 1) === id)
+          throw new Error("That is the default category; it can't be deleted.");
+      }
+      const before = await call(site, { path: `/wp/v2/${tax}/${id}`, query: { _fields: "id,name,slug,description,count,parent" } });
+      await call(site, { method: "DELETE", path: `/wp/v2/${tax}/${id}`, query: { force: "true" } });
+      return {
+        deleted: true,
+        taxonomy: tax,
+        ...before,
+        undo: `wp_term_save ${tax} name "${before.name}" slug ${before.slug}`
+      };
+    }
+  }),
   tool({
     name: "wp_settings_get",
     description: "The site's general settings: title, tagline, search-engine visibility, language, timezone, date and time formats, start of week, posts per page, homepage and posts page, logo and icon.",
@@ -18091,7 +18276,7 @@ var fullTools = [
   }),
   tool({
     name: "wp_plugin_set",
-    description: "Install a plugin from WordPress.org by its slug (e.g. wpforms-lite), and/or activate or deactivate an installed one (plugin id from wp_plugins_list, e.g. akismet/akismet). Plugins can't be deleted from here. Installing runs the plugin's code on the site: only well-known plugins the owner asked for.",
+    description: "Install a plugin from WordPress.org by its slug (e.g. wpforms-lite), and/or activate, deactivate or delete an installed one (plugin id from wp_plugins_list, e.g. akismet/akismet; only an inactive plugin can be deleted, and its settings may go with it). Installing runs the plugin's code on the site: only well-known plugins the owner asked for.",
     parameters: {
       type: "object",
       properties: {
@@ -18099,8 +18284,8 @@ var fullTools = [
         plugin: str2("Installed plugin id (folder/file) to change."),
         status: {
           type: "string",
-          enum: ["active", "inactive"],
-          description: "Activate or deactivate (after installing, default inactive)."
+          enum: ["active", "inactive", "deleted"],
+          description: "Activate, deactivate (after installing, default inactive), or deleted: remove an inactive plugin's files (deactivate it first; Maggie Press can't be removed here)."
         }
       }
     },
@@ -18112,6 +18297,10 @@ var fullTools = [
       lang,
       `Install the plugin ${q2(a.install, "")} from WordPress.org on your website${a.status === "active" ? " and activate it" : ""}.`,
       `\u5728\u7DB2\u7AD9\u4E0A\u5B89\u88DD WordPress.org \u63D2\u4EF6 ${q2(a.install, "")}${a.status === "active" ? "\u4E26\u555F\u7528" : ""}\u3002`
+    ) : a.status === "deleted" ? say(
+      lang,
+      `Delete the plugin ${q2(a.plugin, "")} from your website (its files are removed; reinstall it from WordPress.org to undo, its settings may be lost).`,
+      `\u5F9E\u7DB2\u7AD9\u522A\u9664\u63D2\u4EF6 ${q2(a.plugin, "")}\uFF08\u6A94\u6848\u6703\u88AB\u79FB\u9664\uFF1B\u53EF\u5F9E WordPress.org \u91CD\u65B0\u5B89\u88DD\uFF0C\u8A2D\u5B9A\u53EF\u80FD\u907A\u5931\uFF09\u3002`
     ) : say(
       lang,
       `${a.status === "active" ? "Activate" : "Deactivate"} the plugin ${q2(a.plugin, "")} on your website.`,
@@ -18132,9 +18321,29 @@ var fullTools = [
       if (!a.plugin || !a.status) throw new Error("Give install (a slug), or plugin and status.");
       if (!/^[a-z0-9._-]+(\/[a-z0-9._-]+)?$/i.test(String(a.plugin)))
         throw new Error("plugin: the id from wp_plugins_list, e.g. akismet/akismet.");
+      const id = String(a.plugin).replace(/\.php$/, "");
+      if (a.status === "deleted") {
+        if (/^maggie-?press\//i.test(id))
+          throw new Error("Maggie Press runs the site's styles; it can't be deleted here.");
+        const cur = await call(site, {
+          path: `/wp/v2/plugins/${id}`,
+          query: { _fields: "plugin,name,version,status" }
+        });
+        if (cur.status !== "inactive")
+          throw new Error(`${cur.name} is ${cur.status}: deactivate it first (status inactive), then delete it.`);
+        await call(site, { method: "DELETE", path: `/wp/v2/plugins/${id}` });
+        const slug = id.split("/")[0];
+        return {
+          deleted: true,
+          plugin: cur.plugin,
+          name: cur.name,
+          version: cur.version,
+          undo: `wp_plugin_set install ${slug}`
+        };
+      }
       return call(site, {
         method: "POST",
-        path: `/wp/v2/plugins/${String(a.plugin).replace(/\.php$/, "")}`,
+        path: `/wp/v2/plugins/${id}`,
         query: { _fields: "plugin,name,version,status" },
         body: { status: a.status }
       });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cmo-so/mcp",
-	"version": "0.12.7",
+	"version": "0.12.9",
 	"description": "CMO.so's MCP server for Claude Desktop, Cursor, VS Code and other MCP clients: manage your websites, blog posts, LinkedIn queue and results with Maggie.",
 	"type": "module",
 	"license": "MIT",