@cmo-so/cli 0.12.5 → 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

@@ -16181,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,
@@ -16553,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.",
@@ -21088,7 +21206,7 @@ var program = new Command();
 // package.json
 var package_default = {
   name: "@cmo-so/cli",
-  version: "0.12.5",
+  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",
@@ -32059,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),
@@ -32103,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.5",
+	"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",