@letterstory/cli 0.8.0 → 0.9.0

package/lib/cli.mjs

@@ -40,7 +40,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.8.0";
+export const VERSION = "0.9.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.
@@ -254,12 +254,19 @@ Phantom orchestrator:
   phantom-job status <job-id>                          Check a job's stage
 
 Phantom onboarding recipe (domain -> live phantom blog with first posts):
-  ${bin === "phantom" ? "onboard" : "phantom-onboard"} <domain> [--name X] [--posts N] [--cadence N]
-          [--cover editorial_image|full_ai|line_art] [--theme T] [--accept] [--dry-run]
+  ${bin === "phantom" ? "onboard" : "phantom-onboard"} <domain> [--about "the beat"] [--name X]
+          [--posts N] [--cadence N] [--cover editorial_image|full_ai|line_art] [--theme T]
+          [--real] [--domain host] [--domain-mode subdomain|buy_now|connect_later]
+          [--accept] [--dry-run]
                                                        Plan (read-only) then, with --accept
                                                        or an override flag, provision + configure
-                                                       + seed. --name is committed at create (it
-                                                       seeds the URL); pass it before applying.
+                                                       + seed. --about becomes the planner's
+                                                       steering prompt, so it shapes the topic map
+                                                       and every post — use it for a client's
+                                                       second phantom. --name is committed at
+                                                       create (it seeds the URL); pass it before
+                                                       applying. --domain-mode buy_now SPENDS
+                                                       money (2/org, $30 cap).
 
 Seers (event-driven signals -> drafts):
   seers list                                           List seers with recent activity

package/lib/commands/onboard.mjs

@@ -6,6 +6,13 @@
 //     durable onboarding job server-side and returns a job_id; this command then polls
 //     `get_phantom_onboard_status` until the job is done (provision → configure → seed).
 //
+// `--about "<the beat>"` is the highest-leverage flag: it becomes the publication's planner
+// steering prompt, so it shapes the topic map and every post the site ever writes — not just
+// the name. Use it when the client already has a phantom and this one needs a different beat.
+//
+// `--domain <host>` records a custom domain; nothing is bought unless you also pass
+// `--domain-mode buy_now`, which SPENDS money against a 2-per-org, $30-per-domain cap.
+//
 // IMPORTANT: the masthead name is committed when the site is created (it seeds the URL),
 // so to use a name other than the inferred one, pass --name BEFORE applying. The first
 // posts are written by background jobs (20-40min each); they're reported as job ids and
@@ -15,6 +22,7 @@ import { CliError } from "../client.mjs";
 import { flagStr, flagNum, flagBool, requirePositional, printResult, compact, ok, pollUntil } from "./shared.mjs";
 
 const COVER_STYLES = ["editorial_image", "full_ai", "line_art"];
+const DOMAIN_MODES = ["subdomain", "buy_now", "connect_later"];
 
 function formatPlan(plan) {
 	const lines = [
@@ -23,6 +31,10 @@ function formatPlan(plan) {
 		`  description:   ${plan.description}`,
 		`  defaults:      ${plan.defaults.cadence_per_week}/week · ${plan.defaults.cover_canvas} · seed ${plan.defaults.posts_to_seed}`,
 	];
+	if (plan.direction) lines.push(`  direction:     ${plan.direction}`);
+	if (plan.domain_plan?.site_domain) {
+		lines.push(`  domain:        ${plan.domain_plan.site_domain} (${plan.domain_plan.mode})`);
+	}
 	if (plan.strategy) {
 		lines.push(`  topics:        ${(plan.strategy.priority_topics ?? []).slice(0, 5).join(", ") || "(none)"}`);
 	} else {
@@ -54,12 +66,28 @@ function overridesFromFlags(flags) {
 	if (cover !== undefined && !COVER_STYLES.includes(cover)) {
 		throw new CliError(`--cover must be one of: ${COVER_STYLES.join(", ")}`);
 	}
+	const domainMode = flagStr(flags["domain-mode"]);
+	if (domainMode !== undefined && !DOMAIN_MODES.includes(domainMode)) {
+		throw new CliError(`--domain-mode must be one of: ${DOMAIN_MODES.join(", ")}`);
+	}
+	const siteDomain = flagStr(flags.domain);
+	// buy_now spends real money against a 2-per-org cap; refusing the mismatch here beats
+	// silently downgrading it to a subdomain launch the caller didn't ask for.
+	if (domainMode && domainMode !== "subdomain" && !siteDomain) {
+		throw new CliError(`--domain-mode ${domainMode} needs --domain <bare-domain>`);
+	}
 	return compact({
 		name: flagStr(flags.name),
 		cadence_per_week: flagNum(flags.cadence),
 		cover_canvas: cover,
 		theme: flagStr(flags.theme),
 		posts_to_seed: flagNum(flags.posts),
+		// The highest-leverage override: it becomes the planner's steering prompt, so it
+		// shapes the topic map and every post, not just the masthead.
+		direction: flagStr(flags.about) ?? flagStr(flags.direction),
+		site_domain: siteDomain,
+		domain_mode: domainMode,
+		is_test: flagBool(flags["real"]) ? false : undefined,
 	});
 }
 
@@ -84,7 +112,7 @@ export async function cmdOnboard(ctx) {
 	if (!flagBool(flags.accept) && !overrideGiven) {
 		ok(
 			ctx,
-			"Re-run with --accept to apply, or pass --name/--cadence/--cover/--posts/--theme to adjust. " +
+			"Re-run with --accept to apply, or pass --about/--name/--cadence/--cover/--posts/--theme/--domain to adjust. " +
 				"Note: --name is committed at create (it seeds the URL)."
 		);
 		return 0;

package/package.json

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