@cmo-so/cli 0.12.2 → 0.12.4

package/README.md

@@ -46,7 +46,9 @@ cmo wp redirects [ls] | set <from> <to> [--code 301] | remove <from…>
 cmo wp menu [get] | set --from menu.json      cmo wp header|footer [get] | set --replace a=b --link old=new
 cmo wp header set --button-text "Book Now" --button-url …   cmo wp style [get] | set olive=#4F5B48
 cmo wp pattern contact --replace "old=new"   shared contact band / share buttons on every page
-cmo wp child-theme <slug> --name "…" --from-site [--out dir]   the site's look as a child theme of Maggie Core
+cmo wp child [status] | create maggie-<name> --name … [--activate] | update --color olive=#4F5B48 --css-file x.css
+cmo wp child activate <slug|maggie-core> | restore <slug> <backup>   the site's child theme, on the site (backups kept)
+cmo wp child-theme <slug> --name "…" --from-site [--out dir]   export the site's look as a child theme folder (for git)
 cmo wp migrate plan [--out wp-baseline.json]  |  migrate verify --baseline wp-baseline.json   the SEO gate
 ```
 

package/dist/cmo.mjs

@@ -16983,6 +16983,371 @@ var mediaTools = [
     }
   })
 ];
+var childInfo = (site, slug) => call(site, { path: "/maggie-core/v1/child-theme", query: { slug } });
+async function childSlug(site, slug) {
+  if (typeof slug === "string" && slug) return slug;
+  const info = await childInfo(site);
+  const active = info.children.find((c) => c.active);
+  if (!active)
+    throw new Error("No Maggie child theme is active here: name one (slug), or create one with wp_child_theme_create.");
+  return active.slug;
+}
+async function homeShape(site) {
+  if (!site.fetchPage || !site.url) return null;
+  const r = await site.fetchPage(`${site.url}/?maggie-check=${Date.now()}`).catch(() => null);
+  if (!r) return null;
+  const text3 = r.html.replace(/<script[\s\S]*?<\/script>|<style[\s\S]*?<\/style>/g, " ").replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
+  const fonts = [
+    ...new Set([...r.html.matchAll(/font-family:\s*([^;"}]+)/g)].map((m) => m[1].trim()))
+  ].sort();
+  const colors = [...r.html.matchAll(/--wp--preset--color--([a-z0-9-]+):\s*([^;]+);/g)].map((m) => `${m[1]}=${m[2].trim()}`).sort();
+  return { status: r.status, words: new Set(text3.toLowerCase().split(" ")), fonts, colors };
+}
+function compareShapes(a, b) {
+  if (!a || !b) return { checked: false };
+  const shared = [...a.words].filter((w) => b.words.has(w)).length;
+  const text3 = Math.round(shared / Math.max(1, Math.max(a.words.size, b.words.size)) * 100);
+  const fontsSame = a.fonts.join("|") === b.fonts.join("|");
+  const colorsSame = a.colors.join("|") === b.colors.join("|");
+  const problems = [
+    b.status >= 400 ? `the homepage answers HTTP ${b.status}` : "",
+    text3 < 90 ? `only ${text3}% of the homepage's words are the same` : "",
+    fontsSame ? "" : "the fonts changed",
+    colorsSame ? "" : "the brand colours changed"
+  ].filter(Boolean);
+  return {
+    checked: true,
+    same_text_percent: text3,
+    fonts_same: fontsSame,
+    colors_same: colorsSame,
+    ok: !problems.length,
+    problems
+  };
+}
+var PATTERN_SCHEMA = obj("A pattern for the editor's inserter.", {
+  slug: str2("File name: lowercase, dashes (e.g. spring-offer)."),
+  title: str2("Name shown in the inserter."),
+  content: str2("Block markup (e.g. a section from wp_section_library written out, or copied from a page)."),
+  description: str2(""),
+  categories: arr("Pattern categories (default maggie).", { type: "string" })
+});
+var childTools = [
+  tool({
+    name: "wp_child_theme_status",
+    description: "The site's Maggie child themes (Maggie Core is the parent): which is active, their files and backups, and whether files can be written on this host. With slug: that child's text files in full (theme.json, style.css, parts, patterns) to read before changing them.",
+    parameters: { type: "object", properties: { slug: str2("A child theme to read in full, e.g. maggie-moonlake.") } },
+    group: "site",
+    need: READ,
+    risk: "R0",
+    gates: ["WP"],
+    run: async (ctx, a) => {
+      const info = await childInfo(siteOf(ctx), a.slug || void 0);
+      const files = info.files ? Object.fromEntries(
+        Object.entries(info.files).map(([k, v]) => [k, v.length > 2e4 ? `${v.slice(0, 2e4)}\u2026` : v])
+      ) : void 0;
+      return {
+        ...info,
+        children: info.children.map((c) => ({
+          ...c,
+          files: Object.keys(c.files).length,
+          file_list: Object.keys(c.files)
+        })),
+        ...files ? { files } : {}
+      };
+    }
+  }),
+  tool({
+    name: "wp_child_theme_create",
+    description: "Create a child theme of Maggie Core for this site (slug maggie-<name>), by default from the site's current look: its Global Styles (colours, fonts with their files, styles), edited header and footer. Data files only, never code. activate: true switches the site to it and checks the homepage looks the same. Switching keeps the look only because it is copied into the child; Global Styles and edited parts are kept per theme in WordPress.",
+    parameters: {
+      type: "object",
+      properties: {
+        slug: str2("maggie-<name>, e.g. maggie-moonlake."),
+        name: str2("Theme name, e.g. Moon Lake Spa."),
+        from_site: bool("Copy the site's current look into it (default true)."),
+        activate: bool("Switch the site to it now (default false).")
+      },
+      required: ["slug", "name"]
+    },
+    group: "site",
+    need: WRITE,
+    risk: "W3",
+    gates: [...GATES],
+    confirm: (a, lang) => say(
+      lang,
+      `Create the child theme ${q2(a.slug, "")} on your website${a.activate ? " and switch to it" : ""}.`,
+      `\u5728\u7DB2\u7AD9\u4E0A\u5EFA\u7ACB\u5B50\u4E3B\u984C ${q2(a.slug, "")}${a.activate ? "\u4E26\u5207\u63DB\u904E\u53BB" : ""}\u3002`
+    ),
+    run: async (ctx, a) => {
+      const site = siteOf(ctx);
+      const out = await call(site, {
+        method: "POST",
+        path: "/maggie-core/v1/child-theme",
+        body: { slug: a.slug, name: a.name, from_site: a.from_site !== false }
+      });
+      if (!a.activate)
+        return {
+          ...out,
+          next: "Switch to it with wp_child_theme_activate when ready (the tool checks the homepage looks the same)."
+        };
+      const before = await homeShape(site);
+      const act2 = await call(site, {
+        method: "POST",
+        path: "/maggie-core/v1/child-theme/activate",
+        body: { slug: out.slug }
+      });
+      return { ...out, activated: act2, check: compareShapes(before, await homeShape(site)) };
+    }
+  }),
+  tool({
+    name: "wp_child_theme_update",
+    description: "Change a Maggie child theme's files (default: the active child): brand colours (by name, hex) and fonts (by name, CSS font-family of fonts already in it) in theme.json, extra theme.json styles, plain CSS (replace or append), the header or footer (block markup), templates, and the site's own patterns (shown in the editor's inserter). Data only, never code. Each change keeps a backup (wp_child_theme_restore). Changes made with wp_style_set / wp_header_set are stored in the database and win over the child's files.",
+    parameters: {
+      type: "object",
+      properties: {
+        slug: str2("The child theme (default the active one)."),
+        colors: obj('e.g. { "olive": "#4F5B48" }.'),
+        fonts: obj('Font families by slug: { "body": "Jost, sans-serif" } (files must already be in the child).'),
+        styles: obj('theme.json styles to merge in (e.g. { "elements": { "button": { \u2026 } } }).'),
+        css: str2("Replace the child's CSS (plain CSS)."),
+        css_append: str2("Add CSS at the end."),
+        header: str2("Header block markup (parts/header.html)."),
+        footer: str2("Footer block markup (parts/footer.html)."),
+        templates: obj('Templates by slug \u2192 block markup, e.g. { "page-landing": "\u2026" }.'),
+        patterns: arr("Patterns to add or replace.", PATTERN_SCHEMA),
+        remove_patterns: arr("Pattern slugs to remove.", { type: "string" })
+      }
+    },
+    group: "site",
+    need: WRITE,
+    risk: "W3",
+    gates: [...GATES],
+    confirm: (a, lang) => say(
+      lang,
+      `Change the child theme ${q2(a.slug, "(the active one)")} on your website.`,
+      `\u4FEE\u6539\u7DB2\u7AD9\u7684\u5B50\u4E3B\u984C ${q2(a.slug, "\uFF08\u76EE\u524D\u4F7F\u7528\u4E2D\u7684\uFF09")}\u3002`
+    ),
+    run: async (ctx, a) => {
+      const site = siteOf(ctx);
+      const slug = await childSlug(site, a.slug);
+      const info = await childInfo(site, slug);
+      const cur = info.files ?? {};
+      const files = {};
+      const notes = [];
+      if (a.colors || a.fonts || a.styles) {
+        const tj = JSON.parse(cur["theme.json"] ?? '{"version":3,"settings":{}}');
+        tj.settings = tj.settings ?? {};
+        if (a.colors) {
+          let palette = tj.settings.color?.palette ?? [];
+          if (!palette.length) palette = ((await styleGet(site))._palette ?? []).map((c) => ({ ...c }));
+          for (const [slugC, color] of Object.entries(a.colors)) {
+            if (!/^#([0-9a-f]{3}|[0-9a-f]{6})$/i.test(color))
+              throw new Error(`${slugC}: "${color}" isn't a hex colour.`);
+            const c = palette.find((x) => x.slug === slugC);
+            if (c) c.color = color;
+            else
+              palette.push({
+                slug: slugC,
+                color,
+                name: slugC.replace(/-/g, " ").replace(/\b\w/g, (m) => m.toUpperCase())
+              });
+          }
+          const map = Object.fromEntries(palette.map((c) => [c.slug, c.color]));
+          const bad = contrastReport(map).filter((r) => !r.ok);
+          if (bad.length)
+            notes.push(`Low contrast: ${bad.map((r) => `${r.text} on ${r.background} ${r.ratio}:1`).join(", ")}.`);
+          tj.settings.color = { ...tj.settings.color ?? {}, palette };
+        }
+        if (a.fonts) {
+          const fams = tj.settings.typography?.fontFamilies ?? [];
+          if (!fams.length)
+            throw new Error(
+              "This child has no font list yet (fonts come from the parent): create it from the site first, then change fonts."
+            );
+          for (const [slugF, family] of Object.entries(a.fonts)) {
+            const f = fams.find((x) => x.slug === slugF);
+            if (!f) throw new Error(`No font "${slugF}" in the child. Fonts: ${fams.map((x) => x.slug).join(", ")}`);
+            f.fontFamily = family;
+          }
+        }
+        if (a.styles)
+          tj.styles = deepMerge(tj.styles ?? {}, a.styles);
+        files["theme.json"] = JSON.stringify(tj, null, "	");
+      }
+      if (typeof a.css === "string") files["style.css"] = a.css;
+      if (typeof a.css_append === "string")
+        files["style.css"] = `${(files["style.css"] ?? cur["style.css"] ?? "").replace(/\n*$/, "\n")}${a.css_append}
+`;
+      const markup = (path3, m) => {
+        if (typeof m !== "string" || !m.trim()) return;
+        if (!parse(m).some((b) => b.name)) throw new Error(`${path3}: give block markup (<!-- wp:\u2026 -->).`);
+        files[path3] = m;
+      };
+      markup("parts/header.html", a.header);
+      markup("parts/footer.html", a.footer);
+      for (const [t, m] of Object.entries(a.templates ?? {}))
+        markup(`templates/${t}.html`, m);
+      for (const p of a.patterns ?? []) {
+        if (!/^[a-z0-9][a-z0-9-]{0,60}$/.test(p.slug ?? ""))
+          throw new Error(`Pattern slug "${p.slug}": lowercase letters, digits and dashes.`);
+        files[`maggie-patterns/${p.slug}.json`] = JSON.stringify({
+          title: p.title,
+          content: p.content,
+          description: p.description ?? "",
+          categories: p.categories?.length ? p.categories : ["maggie"]
+        });
+      }
+      const del = (a.remove_patterns ?? []).map((x) => `maggie-patterns/${x}.json`);
+      if (!Object.keys(files).length && !del.length) throw new Error("Nothing to change.");
+      const out = await call(site, {
+        method: "POST",
+        path: "/maggie-core/v1/child-theme",
+        body: { slug, files, delete: del }
+      });
+      return {
+        slug,
+        ...out,
+        ...notes.length ? { notes } : {},
+        ...out.active ? {} : { note: "This child isn't active: switch with wp_child_theme_activate to see it." }
+      };
+    }
+  }),
+  tool({
+    name: "wp_child_theme_activate",
+    description: "Switch the site to a Maggie child theme, or back to Maggie Core (slug maggie-core). Checks the homepage before and after (words, fonts, brand colours) and reports differences. WordPress keeps Global Styles and edited header/footer per theme: a child made with wp_child_theme_create from the site carries them; switching back to Maggie Core brings its own back.",
+    parameters: {
+      type: "object",
+      properties: { slug: str2("maggie-<name>, or maggie-core to go back.") },
+      required: ["slug"]
+    },
+    group: "site",
+    need: WRITE,
+    risk: "W3",
+    gates: [...GATES],
+    confirm: (a, lang) => say(lang, `Switch your website's theme to ${q2(a.slug, "")}.`, `\u628A\u7DB2\u7AD9\u7684\u4E3B\u984C\u5207\u63DB\u70BA ${q2(a.slug, "")}\u3002`),
+    run: async (ctx, a) => {
+      const site = siteOf(ctx);
+      const before = await homeShape(site);
+      const out = await call(site, {
+        method: "POST",
+        path: "/maggie-core/v1/child-theme/activate",
+        body: { slug: a.slug }
+      });
+      const check2 = compareShapes(before, await homeShape(site));
+      return {
+        ...out,
+        check: check2,
+        ...check2.checked && !check2.ok ? { undo: `Switch back with wp_child_theme_activate slug ${out.before}.` } : {}
+      };
+    }
+  }),
+  tool({
+    name: "wp_child_theme_restore",
+    description: "Put a child theme's files back as they were before one change (backup ids from wp_child_theme_status). The current files are backed up first, so a restore can be undone too.",
+    parameters: {
+      type: "object",
+      properties: { slug: str2("The child theme."), backup: str2("Backup id, e.g. 20261104-183208-728.") },
+      required: ["slug", "backup"]
+    },
+    group: "site",
+    need: WRITE,
+    risk: "W3",
+    gates: [...GATES],
+    confirm: (a, lang) => say(
+      lang,
+      `Restore the child theme ${q2(a.slug, "")} to backup ${String(a.backup ?? "")}.`,
+      `\u628A\u5B50\u4E3B\u984C ${q2(a.slug, "")} \u9084\u539F\u5230\u5099\u4EFD ${String(a.backup ?? "")}\u3002`
+    ),
+    run: (ctx, a) => call(siteOf(ctx), {
+      method: "POST",
+      path: "/maggie-core/v1/child-theme/restore",
+      body: { slug: a.slug, backup: a.backup }
+    })
+  })
+];
+var themeTools = [
+  tool({
+    name: "wp_theme_updates",
+    description: "Is there a newer Maggie Core for this site? The installed and latest versions, release notes link, whether this host lets it update itself, auto-updates on or off, and the earlier versions kept for rollback.",
+    parameters: { type: "object", properties: {} },
+    group: "site",
+    need: READ,
+    risk: "R0",
+    gates: ["WP"],
+    run: (ctx) => call(siteOf(ctx), { path: "/maggie-core/v1/update", query: { fresh: 1 } })
+  }),
+  tool({
+    name: "wp_theme_update",
+    description: "Update Maggie Core on the site to the latest version (checked against its published checksum; the current version is kept for rollback), then compare the homepage before and after (words, fonts, brand colours). If the site breaks (an error page or most of the homepage gone) it rolls back by itself. rollback_to puts an earlier kept version back instead. The site's look lives in the database and its child theme, so an update doesn't change it.",
+    parameters: {
+      type: "object",
+      properties: { rollback_to: str2("Put this kept version back instead (from wp_theme_updates backups).") }
+    },
+    group: "site",
+    need: WRITE,
+    risk: "W3",
+    gates: [...GATES],
+    confirm: (a, lang) => a.rollback_to ? say(
+      lang,
+      `Put Maggie Core ${String(a.rollback_to)} back on your website.`,
+      `\u628A\u7DB2\u7AD9\u7684 Maggie Core \u9084\u539F\u5230 ${String(a.rollback_to)}\u3002`
+    ) : say(
+      lang,
+      "Update Maggie Core on your website to the latest version (rolled back by itself if the site breaks).",
+      "\u628A\u7DB2\u7AD9\u7684 Maggie Core \u66F4\u65B0\u5230\u6700\u65B0\u7248\u672C\uFF08\u7DB2\u7AD9\u51FA\u932F\u6703\u81EA\u52D5\u9084\u539F\uFF09\u3002"
+    ),
+    run: async (ctx, a) => {
+      const site = siteOf(ctx);
+      const before = await homeShape(site);
+      if (a.rollback_to) {
+        const r2 = await call(site, {
+          method: "POST",
+          path: "/maggie-core/v1/update/rollback",
+          body: { version: a.rollback_to }
+        });
+        return { ...r2, check: compareShapes(before, await homeShape(site)) };
+      }
+      const info = await call(site, { path: "/maggie-core/v1/update", query: { fresh: 1 } });
+      if (!info.available)
+        return {
+          updated: false,
+          current: info.current,
+          latest: info.latest,
+          note: info.check_error ?? "Already the latest Maggie Core."
+        };
+      if (!info.can_update)
+        throw new Error(info.update_issue ?? "This host doesn't let WordPress update themes itself.");
+      const r = await call(site, {
+        method: "POST",
+        path: "/maggie-core/v1/update"
+      });
+      const check2 = compareShapes(before, await homeShape(site));
+      const broken = check2.checked && (check2.problems.some((p) => p.startsWith("the homepage answers")) || (check2.same_text_percent ?? 100) < 60);
+      if (broken) {
+        const back = await call(site, {
+          method: "POST",
+          path: "/maggie-core/v1/update/rollback",
+          body: { version: r.before }
+        }).catch((e) => ({ error: e.message }));
+        return {
+          ...r,
+          check: check2,
+          rolled_back: back,
+          note: `The homepage looked broken after the update, so Maggie Core ${r.before} was put back.`
+        };
+      }
+      return { ...r, check: check2, notes: info.notes, undo: `wp_theme_update rollback_to ${r.before}` };
+    }
+  })
+];
+function deepMerge(a, b) {
+  const out = { ...a };
+  for (const [k, v] of Object.entries(b)) {
+    const cur = out[k];
+    out[k] = v && typeof v === "object" && !Array.isArray(v) && cur && typeof cur === "object" && !Array.isArray(cur) ? deepMerge(cur, v) : v;
+  }
+  return out;
+}
 var seoFields = {
   title: str2("SEO title (\u224860 characters; the site name is added by the theme)."),
   description: str2("Meta description (\u2248150-160 characters)."),
@@ -17243,6 +17608,8 @@ var wordpressTools = [
   ...pageTools,
   ...sectionTools,
   ...mediaTools,
+  ...childTools,
+  ...themeTools,
   ...seoTools,
   ...elementTools
 ];
@@ -20655,7 +21022,7 @@ var program = new Command();
 // package.json
 var package_default = {
   name: "@cmo-so/cli",
-  version: "0.12.2",
+  version: "0.12.4",
   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",
@@ -31804,7 +32171,36 @@ ${table(r.issues, ["severity", "code", "path", "detail"])}`;
       }
     })
   );
-  wp.command("child-theme <slug>").description("write a child theme of Maggie Core (the site's brand, header, footer, patterns) to a folder").requiredOption("--name <name>", 'theme name, e.g. "Moon Lake Spa"').option("--out <dir>", "where to write it (default ./<slug>)").option("--from-site", "take the brand, header and footer from the connected site").option("--color <slug=hex...>", "brand colours").option("--font <slug=family...>", "fonts (replaces Maggie Core's font list: ship their files too)").action(
+  const theme = wp.command("theme").description("Maggie Core updates");
+  theme.command("status", { isDefault: true }).description("installed and latest version, rollback versions").action((_o, c) => run(g(c), "wp_theme_updates", {}));
+  theme.command("update").description("update to the latest (homepage checked; rolled back by itself if it breaks)").action((_o, c) => run(g(c), "wp_theme_update", {}));
+  theme.command("rollback <version>").description("put a kept earlier version back").action((version2, _o, c) => run(g(c), "wp_theme_update", { rollback_to: version2 }));
+  const child = wp.command("child").description("the site's Maggie child theme, on the site itself (data files only, backups kept)");
+  child.command("status [slug]", { isDefault: true }).description("child themes, their files and backups; with a slug, its files in full").action((slug, _o, c) => run(g(c), "wp_child_theme_status", { slug }));
+  child.command("create <slug>").description("create maggie-<name> from the site's current look").requiredOption("--name <name>").option("--empty", "start empty instead of from the site").option("--activate", "switch the site to it (checks the homepage looks the same)").action(
+    (slug, o, c) => run(g(c), "wp_child_theme_create", { slug, name: o.name, from_site: !o.empty, activate: !!o.activate })
+  );
+  child.command("update [slug]").description(
+    "change the child: colours, fonts, CSS, header/footer, templates, patterns (JSON file with the tool's arguments)"
+  ).option(
+    "--from <file>",
+    "JSON: { colors, fonts, styles, css, css_append, header, footer, templates, patterns, remove_patterns }"
+  ).option("--color <slug=hex...>").option("--css-file <file>", "replace the CSS with this file").option("--header-file <file>", "header block markup").option("--footer-file <file>", "footer block markup").action(
+    async (slug, o, c) => {
+      const args = o.from ? await json(o.from) : {};
+      if (slug) args.slug = slug;
+      if (o.color) args.colors = Object.fromEntries(pairs(o.color));
+      if (o.cssFile) args.css = await readFile2(o.cssFile, "utf8");
+      if (o.headerFile) args.header = await readFile2(o.headerFile, "utf8");
+      if (o.footerFile) args.footer = await readFile2(o.footerFile, "utf8");
+      await run(g(c), "wp_child_theme_update", args);
+    }
+  );
+  child.command("activate <slug>").description("switch the site to a child (or maggie-core to go back); checks the homepage before and after").action((slug, _o, c) => run(g(c), "wp_child_theme_activate", { slug }));
+  child.command("restore <slug> <backup>").description("put a backup of the child's files back").action((slug, backup, _o, c) => run(g(c), "wp_child_theme_restore", { slug, backup }));
+  wp.command("child-theme <slug>").description(
+    "export the site's look as a child theme folder on this computer (to keep in git); cmo wp child works on the site itself"
+  ).requiredOption("--name <name>", 'theme name, e.g. "Moon Lake Spa"').option("--out <dir>", "where to write it (default ./<slug>)").option("--from-site", "take the brand, header and footer from the connected site").option("--color <slug=hex...>", "brand colours").option("--font <slug=family...>", "fonts (replaces Maggie Core's font list: ship their files too)").action(
     async (slug, o, c) => {
       const opts = g(c);
       const colors = Object.fromEntries(pairs(o.color));

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cmo-so/cli",
-	"version": "0.12.2",
+	"version": "0.12.4",
 	"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",