@letterstory/cli 0.11.0 → 0.13.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.13.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.
@@ -64,6 +64,10 @@ const BOOLEAN_FLAGS = new Set([
 	// both put a value-less flag next to a value: without these entries the parser
 	// hands the following token to the flag and the real argument disappears.
 	"regenerate",
+	// `connectors connect --provider framer --token … --auto-deploy` / `--no-auto-deploy`
+	// are value-less; without these the parser eats the following token.
+	"auto-deploy",
+	"no-auto-deploy",
 	"stock-only",
 	"gate",
 	"skip",
@@ -203,6 +207,21 @@ 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.
+  connectors connect --provider <p> --token <api-token>
+                                                       Save + validate CMS credentials. framer also needs
+                                                       --project-url (+ [--no-auto-deploy]); sanity needs
+                                                       --project-id [--dataset]; contentful needs --space-id
+                                                       [--environment].
+  connectors disconnect --provider <p>                 Forget a CMS connection (keeps imported posts)
+  connectors connections                               Show connection status for every provider
+  connectors mappings --provider <p>                   List the org's field mappings for a provider
+  connectors bind --collection <uuid> --provider <p> [--mapping <uuid>]
+                                                       Wire a collection to a CMS + field mapping
 
 Strategy & onboarding:
   strategy company get | set [--name] [--domain] [--manifesto <text>|--manifesto-file <path>]
@@ -270,14 +289,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,23 @@ export async function cmdConnectors(ctx) {
 			return connectorsPublish(rest);
 		case "status":
 			return connectorsStatus(rest);
+		case "pull":
+		case "import":
+			return connectorsPull(rest);
+		case "connect":
+			return connectorsConnect(rest);
+		case "disconnect":
+			return connectorsDisconnect(rest);
+		case "connections":
+			return connectorsConnections(rest);
+		case "mappings":
+			return connectorsMappings(rest);
+		case "bind":
+			return connectorsBind(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, connect, disconnect, connections, mappings, bind`
+			);
 	}
 }
 
@@ -59,3 +74,86 @@ 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;
+}
+
+async function connectorsConnect(ctx) {
+	const { client, flags, io } = ctx;
+	const provider = requireFlag(flags, "provider");
+	// api_token is required for every provider; the rest are provider-specific.
+	const args = compact({
+		provider,
+		api_token: requireFlag(flags, "token"),
+		project_url: flagStr(flags["project-url"]),
+		auto_deploy: flags["no-auto-deploy"] ? false : flagBool(flags["auto-deploy"]) || undefined,
+		project_id: flagStr(flags["project-id"]),
+		dataset: flagStr(flags.dataset),
+		project_name: flagStr(flags["project-name"]),
+		workspace_name: flagStr(flags.workspace),
+		space_id: flagStr(flags["space-id"]),
+		environment_id: flagStr(flags.environment),
+		space_name: flagStr(flags["space-name"]),
+		default_locale: flagStr(flags.locale),
+	});
+	const result = await client.callTool("connect_cms", args);
+	ok(ctx, `Connected ${provider}${result?.label ? ` (${result.label})` : ""}.`);
+	printResult(io, flags, result);
+	return 0;
+}
+
+async function connectorsDisconnect(ctx) {
+	const { client, flags, io } = ctx;
+	const provider = requireFlag(flags, "provider");
+	const result = await client.callTool("disconnect_cms", { provider });
+	ok(ctx, `Disconnected ${provider}.`);
+	printResult(io, flags, result);
+	return 0;
+}
+
+async function connectorsConnections(ctx) {
+	const { client, flags, io } = ctx;
+	const result = await client.callTool("list_cms_connections", {});
+	printResult(io, flags, result);
+	return 0;
+}
+
+async function connectorsMappings(ctx) {
+	const { client, flags, io } = ctx;
+	const provider = requireFlag(flags, "provider");
+	const result = await client.callTool("list_cms_mappings", { provider });
+	printResult(io, flags, result);
+	return 0;
+}
+
+async function connectorsBind(ctx) {
+	const { client, flags, io } = ctx;
+	const args = compact({
+		collection_id: requireFlag(flags, "collection"),
+		provider: requireFlag(flags, "provider"),
+		mapping_id: flagStr(flags.mapping),
+	});
+	const result = await client.callTool("bind_collection_cms", args);
+	ok(
+		ctx,
+		`Bound collection ${result?.collection_id ?? ""} to ${result?.provider ?? ""} (mapping ${result?.mapping_id ?? ""}).`
+	);
+	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.13.0",
 	"description": "Spin up and manage Letterstory phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",