@letterstory/cli 0.10.0 → 0.11.0

package/lib/cli.mjs

@@ -40,7 +40,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.10.0";
+export const VERSION = "0.11.0";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value.
@@ -278,6 +278,14 @@ Collection onboarding (your OWN blog, on your org's domain — no provisioning):
                                                        and stock Headlines & Queue. Omit --collection
                                                        to create a fresh one (--name, default Blog).
                                                        The Planner stays OFF (manual approval).
+  ${bin === "phantom" ? "onboard" : "phantom-onboard"} sync-sitemap --collection <uuid>
+                                                       Re-check an already-onboarded blog's sitemap
+                                                       right now instead of waiting for its cadence
+                                                       (default every 14 days). Skips pages whose
+                                                       <lastmod> hasn't moved, imports new posts,
+                                                       refreshes changed ones. Only for collections
+                                                       with no CMS connected — once one is, use the
+                                                       CMS pull/reconcile path instead.
                                                        --watch polls to completion, printing each
                                                        review note as it lands.
 

package/lib/commands/onboard.mjs

@@ -182,12 +182,48 @@ async function cmdOnboardCollection(ctx) {
 	return 0;
 }
 
+// `onboard sync-sitemap --collection <uuid>` — the periodic-refresh sibling: re-check a
+// collection's sitemap right now instead of waiting for its cadence
+// (collections.sitemap_sync_cadence_days). One-shot, no polling — the underlying work is
+// bounded per run, so it returns synchronously.
+async function cmdOnboardSyncSitemap(ctx) {
+	const { client, flags } = ctx;
+	const collectionId = flagStr(flags.collection);
+	if (!collectionId) {
+		throw new CliError("onboard sync-sitemap requires --collection <uuid>.");
+	}
+
+	ok(ctx, "Re-checking the sitemap…");
+	const result = await client.callTool("sync_collection_sitemap", { collection_id: collectionId });
+
+	printResult(ctx.io, flags, result, (r) =>
+		[
+			`Sitemap sync complete — ${r.checked} post${r.checked === 1 ? "" : "s"} checked.`,
+			`  created:   ${r.created}`,
+			`  updated:   ${r.updated}`,
+			`  unchanged: ${r.unchanged} (skipped — <lastmod> hadn't moved)`,
+			r.skipped ? `  skipped:   ${r.skipped} (nothing readable)` : null,
+			r.failed
+				? `  failed:    ${r.failed}${r.failure_reasons?.length ? ` (${r.failure_reasons.join("; ")})` : ""}`
+				: null,
+			r.truncated ? `  capped this run — rerun (or wait for the cadence) to catch up the rest.` : null,
+		]
+			.filter(Boolean)
+			.join("\n")
+	);
+	return 0;
+}
+
 export async function cmdOnboard(ctx) {
 	const { client, flags, io } = ctx;
 	// `onboard collection …` — the client-blog variant (no <domain>; org from the key).
 	if (ctx.positionals[0] === "collection") {
 		return cmdOnboardCollection({ ...ctx, positionals: ctx.positionals.slice(1) });
 	}
+	// `onboard sync-sitemap --collection <uuid>` — refresh an already-onboarded blog.
+	if (ctx.positionals[0] === "sync-sitemap") {
+		return cmdOnboardSyncSitemap({ ...ctx, positionals: ctx.positionals.slice(1) });
+	}
 	const domain = requirePositional(ctx.positionals, 0, "domain");
 	const overrides = overridesFromFlags(flags);
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@letterstory/cli",
-	"version": "0.10.0",
+	"version": "0.11.0",
 	"description": "Spin up and manage Letterstory phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",