@letterstory/cli 0.11.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.11.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,15 @@ 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

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…");

package/package.json

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