@letterstory/cli 0.176.62 → 0.176.64

package/lib/cli.mjs

@@ -85,7 +85,7 @@ import {
 import { fetchParkedSections, withoutParked } from "./parked.mjs";
 
 // Matches cli/package.json; publish-cli.yml rewrites both to the published version.
-export const VERSION = "0.176.62";
+export const VERSION = "0.176.64";
 
 /** The exit code for a gate refusal (CARD_REQUIRED, PAYMENT_FAILED, OUT_OF_TOKENS): 1 is a plain error. */
 export const EXIT_PAYMENT_REQUIRED = 3;
@@ -1902,6 +1902,12 @@ Domains (the domains you hold, and free ones that match what people search):
                                                        Free .com/.org domains on what people search in your
                                                        space (brainstormed, or the phrases given), ranked
   domains buy <domain> --dry-run | --yes               The price and whose account pays; --yes buys it
+  domains plan <domain> [--phrase "<search>"] [--searches <n>]
+                                                       The most strategic site for the domain, every version
+                                                       scored, and whether it can launch; spends nothing
+  domains launch <domain> [--phrase …] [--searches …] [--words "<plan words>"] --yes
+                                                       Build and Launch Site: buys the domain if needed, builds
+                                                       the plan and puts it live
 
 Vary (A/B tests of a page's words and images on your own site):
   vary [list] [--status running] [--site <id>]         Your variationals and how many visitors each has seen
@@ -1962,7 +1968,7 @@ Replicate (the Replicator: a website rebuilt as a native Next.js repo, page for
   replicate [list]                                     Your replications: stage, how closely each matches
   replicate show <id> [--failing]                      Pages with their routes and pixel match; collections; events
   replicate attach <id> <repo-name> [--repo-owner <o>] The repo to commit it into (yours; Letter never creates it)
-  replicate advance <id> [--retry]                     Move it on now; --retry once blocked_on is done
+  replicate advance <id> [--retry] [--again]           Move it on now; --retry once blocked_on is done; --again replicates from the start
   replicate archive <id>                               Stop it; the project stays in storage and in the repo
 
 Evals (how the pipeline is doing on your posts, and the regression cases captured from them):

package/lib/commands/domains.mjs

@@ -7,6 +7,11 @@
 //   letterstory domains scan "nano banana pro" ["ai headshots" …] [--tld com,org,ai] [--expand none|searches|space]
 //   letterstory domains buy nanobananaprofree.com --dry-run     the price and whose account pays; buys nothing
 //   letterstory domains buy nanobananaprofree.com --yes          buys it (spends money; domains:write)
+//   letterstory domains plan bestaidatalabs.com [--phrase "best ai data labs"] [--searches 880]
+//                                                                 the most strategic site for it; spends nothing
+//   letterstory domains launch bestaidatalabs.com [--phrase …] [--searches …] --yes
+//                                                                 Build and Launch Site: buys it if needed, builds the
+//                                                                 plan and puts it live (spends money; domains:write)
 
 import { CliError } from "../client.mjs";
 import { flagCsv, requirePositional, printResult, argsFromFlags } from "./shared.mjs";
@@ -32,6 +37,19 @@ export const ARGS = {
 		domain: { value: (flags, positionals) => stripScheme(requirePositional(positionals, 0, "domain")) },
 		dry_run: { flag: "dry-run", type: "bool" },
 	},
+	// `domains plan <domain>` — the scan row's search and its monthly searches, when you have them.
+	plan_domain_site: {
+		domain: { value: (flags, positionals) => stripScheme(requirePositional(positionals, 0, "domain")) },
+		phrase: { flag: "phrase" },
+		monthly_searches: { flag: "searches", type: "num" },
+	},
+	launch_domain_site: {
+		domain: { value: (flags, positionals) => stripScheme(requirePositional(positionals, 0, "domain")) },
+		phrase: { flag: "phrase" },
+		monthly_searches: { flag: "searches", type: "num" },
+		// The words of a plan already read (`domains plan … --json`'s plan.words): that plan is built as it was.
+		words: { flag: "words" },
+	},
 };
 
 function stripScheme(value) {
@@ -61,8 +79,18 @@ export async function cmdDomains(ctx) {
 				return 1;
 			}
 			return domainsBuy(rest);
+		case "plan":
+			return domainsPlan(rest);
+		case "launch":
+			if (rest.flags.yes !== true) {
+				rest.io.error(
+					"Launching a site buys its domain (real money) and builds it. Run `domains plan` to see the site and the price, then launch with --yes."
+				);
+				return 1;
+			}
+			return domainsLaunch(rest);
 		default:
-			throw new CliError(`Unknown domains subcommand: ${sub}. Try: list, scan, buy`);
+			throw new CliError(`Unknown domains subcommand: ${sub}. Try: list, scan, buy, plan, launch`);
 	}
 }
 
@@ -117,6 +145,59 @@ async function domainsBuy(ctx) {
 	return 0;
 }
 
+/** A plan as the terminal reads it: the version and why, every score, the pages, and what the domain costs. */
+function planLines(plan) {
+	return [
+		`${plan.domain}: ${plan.label} for "${plan.phrase}"${plan.monthly_searches != null ? ` (${plan.monthly_searches.toLocaleString("en-US")} searches/mo)` : ""}`,
+		`  ${plan.promise}`,
+		`  For: ${plan.audience}`,
+		`  Why it wins: ${plan.angle}`,
+		`  ${plan.company_role}`,
+		"  Pages:",
+		...plan.pages.map((p) => `    ${p.path.padEnd(16)} ${p.title}: ${p.purpose}`),
+		"  Scores:",
+		...plan.scores.map((s) =>
+			`    ${String(s.score).padStart(3)}  ${s.label.padEnd(18)} ${s.reasons.join("; ")}`.trimEnd()
+		),
+	];
+}
+
+async function domainsPlan(ctx) {
+	const { client, flags, io } = ctx;
+	const result = await client.callTool(
+		"plan_domain_site",
+		argsFromFlags(ARGS.plan_domain_site, flags, ctx.positionals)
+	);
+	printResult(io, flags, result, (r) => {
+		const s = r.domain_state;
+		const state = !s.launchable
+			? `Can't launch: ${s.reason}`
+			: s.outcome === "held"
+				? "The domain is yours: nothing to buy. Launch with: letterstory domains launch " +
+					r.plan.domain +
+					" --yes"
+				: `The domain is free: $${s.price_usd} for the first year, billed in tokens. Launch with: letterstory domains launch ${r.plan.domain} --yes`;
+		return [...planLines(r.plan), "", state].join("\n");
+	});
+	return 0;
+}
+
+async function domainsLaunch(ctx) {
+	const { client, flags, io } = ctx;
+	const result = await client.callTool(
+		"launch_domain_site",
+		argsFromFlags(ARGS.launch_domain_site, flags, ctx.positionals)
+	);
+	printResult(io, flags, result, (r) =>
+		[
+			...(r.plan ? planLines(r.plan) : []),
+			"",
+			`Launching ${r.app.domain ?? r.app.name} (${r.app.stage}${r.app.stage_note ? `: ${r.app.stage_note}` : ""}). Follow it with: letterstory deploy show ${r.app.id}`,
+		].join("\n")
+	);
+	return 0;
+}
+
 const STATUS_MARK = { available: "free", taken: "·", unknown: "?", unchecked: " " };
 
 async function domainsScan(ctx) {

package/lib/commands/replicate.mjs

@@ -9,7 +9,7 @@
 //   letterstory replicate list
 //   letterstory replicate show <id> [--failing]
 //   letterstory replicate attach <id> <repo-name> [--repo-owner <account>]
-//   letterstory replicate advance <id> [--retry]
+//   letterstory replicate advance <id> [--retry] [--again]
 //   letterstory replicate archive <id>
 
 import { CliError } from "../client.mjs";
@@ -35,7 +35,11 @@ export const ARGS = {
 		repo_name: { positional: 1, label: "repo-name", required: true },
 		repo_owner: "repo-owner",
 	},
-	advance_replication: { replication_id: replicationId, retry: { flag: "retry", type: "bool" } },
+	advance_replication: {
+		replication_id: replicationId,
+		retry: { flag: "retry", type: "bool" },
+		again: { flag: "again", type: "bool" },
+	},
 	archive_replication: { replication_id: replicationId },
 };
 

package/package.json

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