@letterstory/cli 0.177.12 → 0.177.13

package/lib/cli.mjs

@@ -88,7 +88,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.177.12";
+export const VERSION = "0.177.13";
 
 /** 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;

package/lib/commands/build.mjs

@@ -46,6 +46,17 @@ const ARGS = {
 		ask: "ask",
 		// --confirms <build id>: the person's yes to the price a build stopped on.
 		confirms: "confirms",
+		// --purchase '{"tool":"register_domain","args":{"domain":"olapdb.com"}}': priced and held for a yes, never bought.
+		purchase: {
+			value: (flags) => {
+				if (typeof flags.purchase !== "string") return undefined;
+				try {
+					return JSON.parse(flags.purchase);
+				} catch {
+					throw new CliError("--purchase takes JSON: {tool, args}.");
+				}
+			},
+		},
 		// --build-it: the words are a request to build, never read as a question.
 		asked_to_build: { flag: "build-it", type: "bool" },
 		domain: "site",

package/lib/commands/deploy.mjs

@@ -12,7 +12,7 @@
 //   letterstory deploy page <id>
 
 import { CliError } from "../client.mjs";
-import { argsFromFlags, flagStr, printResult, refuseUnknownFlags } from "./shared.mjs";
+import { argsFromFlags, domainPrice, flagStr, printResult, refuseUnknownFlags } from "./shared.mjs";
 
 const appId = { positional: 0, label: "app-id", required: true };
 
@@ -46,6 +46,8 @@ export const ARGS = {
 		writing: { flag: "writing", enum: ["on"] },
 		// --no-spend: with --domain, buy nothing; the domain is one you hold, or one registered elsewhere.
 		no_spend: { flag: "no-spend", type: "bool" },
+		// A new domain's price: read with register_domain's dry run on this key and echoed with --yes (deploy create's way).
+		accepted_quote: { internal: "the new domain's price read by the command (domainPrice), echoed with --yes" },
 	},
 	advance_deployment: { id: appId, retry: { flag: "retry", type: "bool" } },
 	add_deployment_page: { id: appId },
@@ -70,19 +72,49 @@ export async function cmdDeploy(ctx) {
 		case "ls":
 			return deployList(rest);
 		case "create": {
-			refuseUnknownFlags(rest, ARGS.create_deployment, ["prompt"]);
+			refuseUnknownFlags(rest, ARGS.create_deployment, ["prompt", "yes"]);
 			const args = argsFromFlags(ARGS.create_deployment, rest.flags, rest.positionals);
 			if (!args.prompt)
 				throw new CliError(
 					'Say what to build: letterstory deploy create "a website for HVAC contractors to collect leads"'
 				);
+			// Its domain is bought only at the price Letter shows this key, with --yes, echoed (domains buy's own way).
+			if (args.domain && !args.no_spend && args.domain_quote === undefined) {
+				const priced = await domainPrice(rest.client, rest.io, args.domain);
+				if (priced?.held) args.no_spend = true;
+				else if (priced?.quote) {
+					if (rest.flags.yes !== true) {
+						rest.io.error(
+							"Building it buys this domain (real money). Run again with --yes to buy it at that price."
+						);
+						return 1;
+					}
+					args.domain_quote = priced.quote;
+				}
+			}
 			return deployShow(rest, await rest.client.callTool("create_deployment", args));
 		}
 		case "show":
 			return deployShow(rest, await call(rest, "get_deployment"));
-		case "update":
-			refuseUnknownFlags(rest, ARGS.update_deployment, []);
-			return deployShow(rest, await call(rest, "update_deployment"));
+		case "update": {
+			refuseUnknownFlags(rest, ARGS.update_deployment, ["yes"]);
+			const args = argsFromFlags(ARGS.update_deployment, rest.flags, rest.positionals);
+			// A new domain is bought only at the price Letter shows this key, with --yes, echoed (deploy create's way).
+			if (args.domain && !args.no_spend) {
+				const priced = await domainPrice(rest.client, rest.io, args.domain);
+				if (priced?.held) args.no_spend = true;
+				else if (priced?.quote) {
+					if (rest.flags.yes !== true) {
+						rest.io.error(
+							"Its new domain is bought (real money). Run again with --yes to buy it at that price."
+						);
+						return 1;
+					}
+					args.accepted_quote = priced.quote;
+				}
+			}
+			return deployShow(rest, await rest.client.callTool("update_deployment", args));
+		}
 		case "pause":
 		case "resume":
 		case "archive":

package/lib/commands/domains.mjs

@@ -16,7 +16,7 @@
 //                                                                 plan and puts it live (spends money; domains:write)
 
 import { CliError } from "../client.mjs";
-import { flagCsv, requirePositional, printResult, argsFromFlags } from "./shared.mjs";
+import { flagCsv, requirePositional, printResult, argsFromFlags, domainPrice } from "./shared.mjs";
 
 export const ARGS = {
 	list_domains: {},
@@ -152,10 +152,16 @@ async function domainsList(ctx) {
 
 async function domainsBuy(ctx) {
 	const { client, flags, io } = ctx;
-	const result = await client.callTool(
-		"register_domain",
-		argsFromFlags(ARGS.register_domain, flags, ctx.positionals)
-	);
+	const args = argsFromFlags(ARGS.register_domain, flags, ctx.positionals);
+	// A purchase goes only at a price Letter issued to this key (Mahir, 2026-11-11): --yes reads it first and buys at
+	// that price, echoing its quote, unless one was given (--accepted-quote).
+	if (flags.yes === true && !args.dry_run && args.accepted_quote === undefined && !args.no_spend) {
+		const priced = await domainPrice(client, io, args.domain);
+		// One the org holds is made its own with nothing bought; anything else at its price.
+		if (priced?.held) args.no_spend = true;
+		else if (priced?.quote) args.accepted_quote = priced.quote;
+	}
+	const result = await client.callTool("register_domain", args);
 	printResult(io, flags, result, (r) => {
 		const p = r.purchase;
 		const on = p?.on === "org_vercel_key" ? "on your own Vercel account" : "by Letter, billed in tokens";
@@ -214,10 +220,13 @@ async function domainsPlan(ctx) {
 
 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)
-	);
+	const args = argsFromFlags(ARGS.launch_domain_site, flags, ctx.positionals);
+	// --yes buys its domain at the price Letter shows this key, echoed (domains buy's own way): never above it.
+	if (args.accepted_quote === undefined) {
+		const priced = await domainPrice(client, io, args.domain);
+		if (priced?.quote) args.accepted_quote = priced.quote;
+	}
+	const result = await client.callTool("launch_domain_site", args);
 	printResult(io, flags, result, (r) =>
 		[
 			...(r.plan ? planLines(r.plan) : []),

package/lib/commands/onboard.mjs

@@ -61,6 +61,7 @@ import {
 	pollUntil,
 	readTextInput,
 	argsFromFlags,
+	domainPrice,
 } from "./shared.mjs";
 
 const COVER_STYLES = ["editorial_image", "full_ai", "line_art"];
@@ -120,6 +121,8 @@ export const ARGS = {
 		is_test: { flag: "test", type: "bool" },
 		readiness_minutes: { flag: "readiness-minutes", type: "num" },
 		client_email: "client-email",
+		// A buy_now phantom's domain price: read with register_domain's dry run on this key and echoed with --yes.
+		accepted_quote: { internal: "the phantom domain's price read by the command (domainPrice), echoed with --yes" },
 	},
 	get_domain_onboard_status: {
 		job_id: "attach",
@@ -134,6 +137,8 @@ export const ARGS = {
 		// flag mapping straight through: it comes from `--accept-plan <path|->` /
 		// `--accept-plan-json`, or from the dry run this same command just printed.
 		plan: { internal: "the reviewed plan — from --accept-plan, or the dry run just printed" },
+		// A buy_now launch's domain price: read with register_domain's dry run on this key and echoed with --yes.
+		accepted_quote: { internal: "the domain's price read by the command (domainPrice), echoed with --yes" },
 		overrides: {
 			object: {
 				name: "name",
@@ -654,6 +659,19 @@ async function cmdOnboardDomain(ctx) {
 	}
 
 	const args = argsFromFlags(ARGS.onboard_domain, flags, ctx.positionals);
+	// Its phantom's domain is bought only at the price Letter shows this key, with --yes, echoed (domains buy's way).
+	if (args.phantom?.domain_mode === "buy_now" && args.phantom.site_domain) {
+		const priced = await domainPrice(client, ctx.io, args.phantom.site_domain);
+		if (priced?.quote) {
+			if (!flagBool(flags.yes)) {
+				ctx.io.error(
+					"Onboarding buys the phantom's domain (real money). Run again with --yes to buy it at that price."
+				);
+				return 1;
+			}
+			args.accepted_quote = priced.quote;
+		}
+	}
 
 	ok(ctx, "Starting domain onboarding…");
 	const started = await client.callTool("onboard_domain", args);
@@ -889,6 +907,19 @@ export async function cmdOnboard(ctx) {
 		reviewedPlan = dryRun.plan;
 	}
 
+	// A launch that buys its domain goes only at the price Letter shows this key, with --yes, echoed (domains buy's way).
+	let accepted_quote;
+	if (overrides.domain_mode === "buy_now" && overrides.site_domain) {
+		const priced = await domainPrice(client, io, overrides.site_domain);
+		if (priced?.quote) {
+			if (!flagBool(flags.yes)) {
+				io.error("Launching it buys this domain (real money). Run again with --yes to buy it at that price.");
+				return 1;
+			}
+			accepted_quote = priced.quote;
+		}
+	}
+
 	// Step 3: apply — start the durable onboarding job.
 	ok(ctx, "Applying — starting the onboarding job…");
 	const started = await client.callTool(
@@ -898,6 +929,7 @@ export async function cmdOnboard(ctx) {
 			accept: true,
 			overrides: Object.keys(overrides).length ? overrides : undefined,
 			plan: reviewedPlan,
+			accepted_quote,
 		})
 	);
 	const jobId = started.job_id;

package/lib/commands/phantom.mjs

@@ -8,7 +8,16 @@
 
 import { readFileSync } from "node:fs";
 import { CliError } from "../client.mjs";
-import { flagStr, requirePositional, printResult, ok, toolField, followJob, argsFromFlags } from "./shared.mjs";
+import {
+	flagStr,
+	requirePositional,
+	printResult,
+	ok,
+	toolField,
+	followJob,
+	argsFromFlags,
+	domainPrice,
+} from "./shared.mjs";
 
 function readJsonFileFlag(flags, flag) {
 	const path = flagStr(flags[flag]);
@@ -130,6 +139,8 @@ export const ARGS = {
 	buy_domain: {
 		phantom_id: { positional: 0, label: "phantom-id", required: true },
 		domain: { value: (flags, positionals) => stripScheme(requirePositional(positionals, 1, "domain")) },
+		// Its price: read with register_domain's dry run on this key and echoed with --yes (domains buy's way).
+		accepted_quote: { internal: "the domain's price read by the command (domainPrice), echoed with --yes" },
 	},
 	connect_domain: {
 		phantom_id: { positional: 0, label: "phantom-id", required: true },
@@ -265,7 +276,14 @@ async function phantomDomain(ctx) {
 				rest.io.error("Buying a domain spends real money. Re-run with --yes.");
 				return 1;
 			}
-			return call(rest, "buy_domain");
+			{
+				const args = argsFromFlags(ARGS.buy_domain, rest.flags, rest.positionals);
+				const priced = await domainPrice(rest.client, rest.io, args.domain);
+				if (priced?.quote) args.accepted_quote = priced.quote;
+				const result = await rest.client.callTool("buy_domain", args);
+				printResult(rest.io, rest.flags, result);
+				return 0;
+			}
 		case "connect":
 			return call(rest, "connect_domain");
 		default:

package/lib/commands/shared.mjs

@@ -385,3 +385,21 @@ export function readTextInput(flags, valueFlag, fileFlag) {
 export function readBodyInput(flags) {
 	return readTextInput(flags, "body", "file");
 }
+
+/**
+ * The price Letter shows for buying `domain`, read with register_domain's dry run on this key, for a command that buys
+ * (domains buy, domains launch, deploy create, onboard): a purchase goes only at a price Letter issued to this key,
+ * echoed, and never above it (Mahir, 2026-11-11). `held`: the organization has it, or takes it over: nothing is bought.
+ * `quote`: what to echo, the price said on stderr. Null: no purchase to price (the dispatcher says why if one is made).
+ */
+export async function domainPrice(client, io, domain) {
+	if (!domain) return null;
+	const priced = await client.callTool("register_domain", { domain, dry_run: true });
+	const held = priced?.outcome === "already_owned" || priced?.outcome === "would_adopt";
+	// A held domain the registrar would still sell (recorded, never bought) carries a quote too: a purchase of it (a
+	// phantom's buy, a launch) moves money and goes only at that price (review of #6952).
+	if (!priced?.quote) return held ? { held: true } : null;
+	const usd = priced.purchase?.price_usd ?? priced.quote.purchase_usd;
+	io.error(`${priced.domain}: $${usd} for the first year, if bought.`);
+	return { ...(held ? { held: true } : {}), quote: priced.quote, price_usd: usd ?? null };
+}

package/package.json

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