@cmo-so/cli 0.12.4 → 0.12.6

package/README.md

@@ -36,6 +36,7 @@ cmo wp status | map [--sections] | pages [--search …] [--missing-seo] | sectio
 cmo wp page <page> [--section s2]         a page's sections (ids: m… bands, s… reading column, a… sidebar)
 cmo wp page create --title … --from sections.json [--parent …] [--publish] [--menu-parent …]
 cmo wp page update <page> title=… slug=… status=…   |  delete <page> [--redirect-to …]  |  undo <page>
+cmo wp page publish <page> [--homepage]   |  cmo wp home <page> [--posts-page …] [--latest-posts]
 cmo wp page duplicate <page> --title … --replace Fairfax=Vienna
 cmo wp section add <page> <type> --from slots.json [--after s1] [--preview]
 cmo wp section update <page> <section> --from change.json [--preview]   (edits | slots | faq)

package/dist/cmo.mjs

@@ -14160,7 +14160,7 @@ var SECTIONS2 = [
         [
           S(s.heading) || S(s.intro) ? prose([...headed(s), para(S(s.intro))]) : "",
           group(boxes, {
-            cls: `maggie-stagger grid gap-5 ${boxes.length >= 4 ? "grid-cols-2 md:grid-cols-4" : "sm:grid-cols-3"}`
+            cls: `maggie-stagger grid gap-5 ${boxes.length === 3 ? "sm:grid-cols-3" : "sm:grid-cols-2"}`
           })
         ],
         "flex flex-col gap-8"
@@ -14383,6 +14383,7 @@ var SECTIONS2 = [
     slots: {
       title: str('e.g. "Book your HydraFacial".'),
       text: str("One sentence."),
+      button_label: str('Default "Book Now".'),
       button_url: str("Default: the booking link.")
     },
     required: ["title"],
@@ -14393,7 +14394,7 @@ var SECTIONS2 = [
         buttons(
           [
             button(
-              "Book Now",
+              S(s.button_label) || "Book Now",
               S(s.button_url) || kit.bookUrl || "/contact-us/",
               "w-full [&_a]:w-full [&_a]:bg-white [&_a]:text-ink hover:[&_a]:bg-panel"
             )
@@ -15041,7 +15042,7 @@ async function menuSet(site, ops2, id) {
   const blocks = parse(nav.content.raw);
   const before = toItems(blocks);
   const after = applyMenuOps(before, ops2);
-  const rest = blocks.filter((b) => b.name && !["core/navigation-link", "core/navigation-submenu"].includes(b.name));
+  const rest = ops2.items ? [] : blocks.filter((b) => b.name && !["core/navigation-link", "core/navigation-submenu"].includes(b.name));
   const content = [fromItems(after), serialize(rest)].filter(Boolean).join("\n");
   await call(site, {
     method: "POST",
@@ -15612,7 +15613,11 @@ function composePage(sections, kit, aside = {}) {
     const asideParts = [
       kit.synced?.share ? group([syncedRef(kit.synced.share)], { cls: "px-2" }) : "",
       serialize([
-        buildSection("cta-card", { title: aside.ctaTitle || "Book your visit", text: aside.ctaText ?? "" }, kit)
+        buildSection(
+          "cta-card",
+          { title: aside.ctaTitle || "Book your visit", text: aside.ctaText ?? "", button_label: aside.ctaButton },
+          kit
+        )
       ])
     ];
     const body = band(
@@ -16176,6 +16181,27 @@ async function changePage(ctx, a, fn) {
     undo: "wp_page_undo goes back to the version before this change."
   };
 }
+var findAllBlocks = (list3) => list3.flatMap((b) => [b, ...findAllBlocks(b.inner)]);
+async function setHome(site, id, postsPage) {
+  const before = await call(site, {
+    path: "/wp/v2/settings",
+    query: { _fields: "show_on_front,page_on_front,page_for_posts" }
+  });
+  const body = { show_on_front: "page", page_on_front: id };
+  if (postsPage !== void 0) body.page_for_posts = postsPage;
+  if (postsPage === id) throw new Error("The homepage and the posts page can't be the same page.");
+  const after = await call(site, {
+    method: "POST",
+    path: "/wp/v2/settings",
+    query: { _fields: "show_on_front,page_on_front,page_for_posts" },
+    body
+  });
+  return {
+    before,
+    after,
+    undo: before.show_on_front === "page" && before.page_on_front ? `wp_site_home_set page ${before.page_on_front}` : "wp_site_home_set latest_posts true"
+  };
+}
 function position(a) {
   return {
     after: a.after || void 0,
@@ -16399,7 +16425,11 @@ var pageTools = [
           description: str2(""),
           keywords: str2("")
         }),
-        cta: obj("Sidebar booking card: title, text.", { title: str2(""), text: str2("") }),
+        cta: obj("Sidebar booking card: title, text, button label (default Book Now).", {
+          title: str2(""),
+          text: str2(""),
+          button: str2("")
+        }),
         related: bool(
           "Add a related-services band from sibling pages (default true when the page has a reading column)."
         ),
@@ -16444,7 +16474,8 @@ var pageTools = [
       const cta = a.cta ?? {};
       const blocks = composePage(sections, kit, {
         ctaTitle: cta.title || `Book ${String(a.title)}`,
-        ctaText: cta.text
+        ctaText: cta.text,
+        ctaButton: cta.button
       });
       const outline = brief2(blocks, kit.syncedTitles);
       if (a.preview) return { preview: true, title: a.title, sections: outline };
@@ -16543,6 +16574,103 @@ var pageTools = [
       };
     }
   }),
+  tool({
+    name: "wp_page_publish",
+    description: "Publish a page (a draft or private page) so visitors and search engines see it. Checks it first: one H1, an SEO title and description (warns when missing). homepage: true also makes it the site's homepage. Afterwards the live page is opened to confirm it works. To take it down again, wp_page_update status draft.",
+    parameters: {
+      type: "object",
+      properties: {
+        page: PAGE,
+        homepage: bool("Also make it the site's homepage."),
+        expect_modified: EXPECT
+      },
+      required: ["page"]
+    },
+    group: "site",
+    need: WRITE,
+    risk: "W3",
+    gates: [...GATES],
+    confirm: (a, lang) => say(
+      lang,
+      `Publish page ${q2(a.page, "")} on your website${a.homepage ? " and make it the homepage" : ""}.`,
+      `\u767C\u4F48\u7DB2\u7AD9\u4E0A\u7684\u9801\u9762 ${q2(a.page, "")}${a.homepage ? "\uFF0C\u4E26\u8A2D\u70BA\u9996\u9801" : ""}\u3002`
+    ),
+    run: async (ctx, a) => {
+      const site = siteOf(ctx);
+      const p = await findPage(site, a.page, true);
+      checkFresh(p, a.expect_modified);
+      const m = p.meta ?? {};
+      const blocks = parse(p.content?.raw ?? "");
+      const h1 = findAllBlocks(blocks).filter((b) => b.name === "core/heading" && Number(b.attrs.level) === 1).length;
+      const warnings = [
+        h1 === 1 ? "" : h1 === 0 ? "The page has no H1 in its content (a template may add one)." : `The page has ${h1} H1 headings.`,
+        m.maggie_seo_title ? "" : "No SEO title: the page title is used.",
+        m.maggie_seo_description ? "" : "No meta description: set one with wp_seo_set."
+      ].filter(Boolean);
+      const wasStatus = p.status;
+      const saved = p.status === "publish" ? p : await savePage(site, p.id, null, { status: "publish" });
+      let home = null;
+      if (a.homepage) home = await setHome(site, p.id);
+      const live = await check(site, saved.link, "publish");
+      return {
+        published: true,
+        id: p.id,
+        path: path(saved.link),
+        before: wasStatus,
+        homepage: home,
+        check: live,
+        warnings
+      };
+    }
+  }),
+  tool({
+    name: "wp_site_home_set",
+    description: "Choose the site's homepage (a published page) and, optionally, the page that lists the blog posts. Returns the previous setting so it can be put back. latest_posts: true shows the newest posts as the homepage instead.",
+    parameters: {
+      type: "object",
+      properties: {
+        page: str2("The page to show as the homepage (path, slug or id)."),
+        posts_page: str2('The page that lists the blog posts (optional; "" to clear).'),
+        latest_posts: bool("Show the newest posts as the homepage instead of a page.")
+      }
+    },
+    group: "site",
+    need: WRITE,
+    risk: "W3",
+    gates: [...GATES],
+    confirm: (a, lang) => a.latest_posts ? say(lang, "Show your newest posts as your website's homepage.", "\u628A\u7DB2\u7AD9\u9996\u9801\u6539\u70BA\u986F\u793A\u6700\u65B0\u6587\u7AE0\u3002") : say(
+      lang,
+      `Make ${q2(a.page, "that page")} your website's homepage.`,
+      `\u628A ${q2(a.page, "\u8A72\u9801\u9762")} \u8A2D\u70BA\u7DB2\u7AD9\u9996\u9801\u3002`
+    ),
+    run: async (ctx, a) => {
+      const site = siteOf(ctx);
+      if (a.latest_posts) {
+        const before = await call(site, {
+          path: "/wp/v2/settings",
+          query: { _fields: "show_on_front,page_on_front,page_for_posts" }
+        });
+        await call(site, {
+          method: "POST",
+          path: "/wp/v2/settings",
+          query: { _fields: "show_on_front" },
+          body: { show_on_front: "posts" }
+        });
+        return { before, after: { show_on_front: "posts" } };
+      }
+      if (!a.page) throw new Error("Which page should be the homepage?");
+      const p = await findPage(site, a.page);
+      if (p.status !== "publish")
+        throw new Error(
+          `${path(p.link)} isn't published yet: publish it first (wp_page_publish homepage: true does both).`
+        );
+      let postsPage;
+      if (typeof a.posts_page === "string")
+        postsPage = a.posts_page === "" ? 0 : (await findPage(site, a.posts_page)).id;
+      const r = await setHome(site, p.id, postsPage);
+      return { ...r, check: await check(site, `${site.url ?? ""}/`, "publish") };
+    }
+  }),
   tool({
     name: "wp_page_delete",
     description: "Move a page to the WordPress trash (restorable for 30 days) and redirect its address (301) to another page, by default its parent or the homepage.",
@@ -17108,6 +17236,17 @@ var childTools = [
         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).'),
+        font_files: arr(
+          "Install fonts in the child from https links to font files (woff2/woff/ttf), e.g. Google Fonts' fonts.gstatic.com files: each becomes a fontFace of its family (slug display / body / any).",
+          obj("", {
+            slug: str2("Family slug in theme.json: display, body, \u2026"),
+            family: str2('Family name, e.g. "Roboto Slab".'),
+            fallback: str2('Fallback stack, e.g. "Georgia, serif".'),
+            url: str2("https link to the font file."),
+            weight: str2('e.g. "400", "800" or "100 900".'),
+            style: str2('"normal" or "italic".')
+          })
+        ),
         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."),
@@ -17134,9 +17273,54 @@ var childTools = [
       const cur = info.files ?? {};
       const files = {};
       const notes = [];
+      if (Array.isArray(a.font_files) && a.font_files.length) {
+        const tj0 = JSON.parse(files["theme.json"] ?? cur["theme.json"] ?? '{"version":3,"settings":{}}');
+        if (!tj0.settings || Array.isArray(tj0.settings)) tj0.settings = {};
+        const typo = tj0.settings.typography ?? {};
+        const fams = typo.fontFamilies ?? [];
+        for (const f of a.font_files) {
+          if (!/^[a-z0-9-]{2,30}$/.test(f.slug ?? ""))
+            throw new Error(`Font slug "${f.slug}": lowercase letters, digits and dashes.`);
+          if (!/^https:\/\//.test(f.url ?? "")) throw new Error(`${f.family}: the font's link must be https.`);
+          const r = await fetch(f.url);
+          if (!r.ok) throw new Error(`${f.family}: the font's link answered HTTP ${r.status}.`);
+          const bytes = new Uint8Array(await r.arrayBuffer());
+          const head = String.fromCharCode(...bytes.subarray(0, 4));
+          const ext = head === "wOF2" ? "woff2" : head === "wOFF" ? "woff" : head === "OTTO" ? "otf" : head === "\0
\0\0" || head === "true" ? "ttf" : "";
+          if (!ext) throw new Error(`${f.family}: that link isn't a font file.`);
+          if (bytes.length > 4 * 1024 * 1024) throw new Error(`${f.family}: the font file is larger than 4 MB.`);
+          const weight = f.weight || "400";
+          const style = f.style || "normal";
+          const name = `${f.family.toLowerCase().replace(/[^a-z0-9]+/g, "-")}-${weight.replace(/\s+/g, "-")}${style === "italic" ? "-italic" : ""}.${ext}`;
+          let bin = "";
+          for (let i = 0; i < bytes.length; i += 32768) bin += String.fromCharCode(...bytes.subarray(i, i + 32768));
+          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}"`)) {
+            const keep = fam ? fams.indexOf(fam) : -1;
+            fam = { slug: f.slug, name: f.family, fontFamily: stack, fontFace: [] };
+            if (keep >= 0) fams[keep] = fam;
+            else fams.push(fam);
+          }
+          fam.fontFace = [
+            ...(fam.fontFace ?? []).filter((x) => !(x.fontWeight === weight && x.fontStyle === style)),
+            {
+              fontFamily: f.family,
+              fontWeight: weight,
+              fontStyle: style,
+              fontDisplay: "swap",
+              src: [`file:./assets/fonts/${name}`]
+            }
+          ];
+        }
+        tj0.settings.typography = { ...typo, fontFamilies: fams };
+        files["theme.json"] = JSON.stringify(tj0, null, "	");
+      }
       if (a.colors || a.fonts || a.styles) {
-        const tj = JSON.parse(cur["theme.json"] ?? '{"version":3,"settings":{}}');
-        tj.settings = tj.settings ?? {};
+        const tj = JSON.parse(files["theme.json"] ?? cur["theme.json"] ?? '{"version":3,"settings":{}}');
+        if (!tj.settings || Array.isArray(tj.settings)) tj.settings = {};
+        if (Array.isArray(tj.styles)) tj.styles = {};
         if (a.colors) {
           let palette = tj.settings.color?.palette ?? [];
           if (!palette.length) palette = ((await styleGet(site))._palette ?? []).map((c) => ({ ...c }));
@@ -21022,7 +21206,7 @@ var program = new Command();
 // package.json
 var package_default = {
   name: "@cmo-so/cli",
-  version: "0.12.4",
+  version: "0.12.6",
   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",
@@ -31993,6 +32177,9 @@ function registerWp(program3) {
   wp.command("pages").description("find pages").option("--search <words>", "words in the title").option("--missing-seo", "only pages without their own SEO title or description").option("--template <slug>", "only this template").action(
     (o, c) => run(g(c), "wp_pages_list", { search: o.search, missing_seo: !!o.missingSeo, template: o.template })
   );
+  wp.command("home [page]").description("choose the homepage (a published page), the posts page, or the latest posts").option("--posts-page <page>", 'the page that lists the blog posts ("" to clear)').option("--latest-posts", "show the newest posts as the homepage").action(
+    (p, o, c) => run(g(c), "wp_site_home_set", { page: p, posts_page: o.postsPage, latest_posts: !!o.latestPosts })
+  );
   wp.command("sections").description("the section library and page blueprints").action(
     (_o, c) => run(
       g(c),
@@ -32037,6 +32224,9 @@ function registerWp(program3) {
       replace: pairs(o.replace).map(([find2, replace2]) => ({ find: find2, replace: replace2 }))
     })
   );
+  page.command("publish <page>").description("publish a page (checks it first); --homepage also makes it the homepage").option("--homepage", "make it the site's homepage").action(
+    (p, o, c) => run(g(c), "wp_page_publish", { page: p, homepage: !!o.homepage })
+  );
   page.command("undo <page>").description("back to the version before the last change").action((p, _o, c) => run(g(c), "wp_page_undo", { page: p }));
   const section = wp.command("section").description("add, change, move or remove a page's sections");
   const pos = (cmd) => cmd.option("--after <section>", "after this section (id or type)").option("--before <section>", "before this section").option("--region <region>", "main, story or aside").option("--index <n>", "position in the region");

package/package.json

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