@letterstory/cli 0.10.0 → 0.12.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.12.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.
@@ -203,6 +203,11 @@ Connectors:
                                                        [--confirm-missing-target] re-publish even though
                                                        the item was deleted/unpublished on the provider
   connectors status --connector <connector> --publish-id <id>
+  connectors pull [--collection <uuid>] [--provider <webflow|framer|sanity|contentful>]
+                                                       Pull existing posts FROM a connected CMS into a
+                                                       collection, reconciling (adopt/update/create/orphan).
+                                                       --collection for a bound collection, --provider to
+                                                       auto-resolve, or both to wire an unbound collection.
 
 Strategy & onboarding:
   strategy company get | set [--name] [--domain] [--manifesto <text>|--manifesto-file <path>]
@@ -270,14 +275,23 @@ Phantom onboarding recipe (domain -> live phantom blog with first posts):
 
 Collection onboarding (your OWN blog, on your org's domain — no provisioning):
   ${bin === "phantom" ? "onboard" : "phantom-onboard"} collection [--collection <uuid>] [--name "<collection name>"]
-          [--about "the direction"] [--sitemap <url>] [--watch]
+          [--about "the direction"] [--sitemap <url>] [--cms <provider>] [--watch]
                                                        Import the existing blog from its sitemap
                                                        (auto-discovered from the org's domain unless
-                                                       --sitemap pins one), derive content areas +
-                                                       series, build the topic map, bind SEO demand,
-                                                       and stock Headlines & Queue. Omit --collection
-                                                       to create a fresh one (--name, default Blog).
-                                                       The Planner stays OFF (manual approval).
+                                                       --sitemap pins one) OR from a connected CMS with
+                                                       --cms <webflow|framer|sanity|contentful>, then
+                                                       derive content areas + series, build the topic
+                                                       map, bind SEO demand, 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/connectors.mjs

@@ -17,8 +17,11 @@ export async function cmdConnectors(ctx) {
 			return connectorsPublish(rest);
 		case "status":
 			return connectorsStatus(rest);
+		case "pull":
+		case "import":
+			return connectorsPull(rest);
 		default:
-			throw new CliError(`Unknown connectors subcommand: ${sub ?? "(none)"}. Try: list, publish, status`);
+			throw new CliError(`Unknown connectors subcommand: ${sub ?? "(none)"}. Try: list, publish, status, pull`);
 	}
 }
 
@@ -59,3 +62,22 @@ async function connectorsStatus(ctx) {
 	printResult(io, flags, result);
 	return 0;
 }
+
+async function connectorsPull(ctx) {
+	const { client, flags, io } = ctx;
+	// Dual key: --collection (a CMS-bound collection), or --provider (resolve/wire),
+	// or both (--provider wires an unbound --collection first). At least one required.
+	const collectionId = flagStr(flags.collection);
+	const provider = flagStr(flags.provider);
+	if (!collectionId && !provider) {
+		throw new CliError("Pass --collection <id> and/or --provider <webflow|framer|sanity|contentful>");
+	}
+	const args = compact({ collection_id: collectionId, provider });
+	const result = await client.callTool("import_from_cms", args);
+	ok(
+		ctx,
+		`Pulled from ${result?.provider ?? provider ?? "CMS"} into collection ${result?.collection_id ?? collectionId ?? ""}.`
+	);
+	printResult(io, flags, result);
+	return 0;
+}

package/lib/commands/onboard.mjs

@@ -140,6 +140,8 @@ async function cmdOnboardCollection(ctx) {
 		collection_name: flagStr(flags.name),
 		direction: flagStr(flags.about) ?? flagStr(flags.direction),
 		sitemap_url: flagStr(flags.sitemap),
+		// Source the existing blog from a connected CMS instead of a sitemap.
+		cms_provider: flagStr(flags.cms),
 	});
 
 	ok(ctx, "Starting collection onboarding…");
@@ -182,12 +184,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.12.0",
 	"description": "Spin up and manage Letterstory phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",