@letterstory/cli 0.28.0 → 0.29.0

package/lib/commands/deploy.mjs

@@ -1,389 +0,0 @@
-// Phantom blogs (deployments) and custom domains. `cmdDeploy`/`cmdDomain` are the
-// original, stable command surface; `blogs`/`domains` are Mathew's phantomstory-cli
-// names for the exact same operations. Rather than duplicate handler bodies, `blogs`
-// and `domains` are literal references to `cmdDeploy`/`cmdDomain` (see the bottom of
-// this file) and Mathew's verb spellings (ls/new/show/rm/diag) are additional cases
-// in the same switch statements below — one implementation, two vocabularies.
-
-import { CliError } from "../client.mjs";
-import { flagStr, flagNum, requireFlag, requirePositional, printResult, compact } from "./shared.mjs";
-
-function stripScheme(domain) {
-	return domain.replace(/^https?:\/\//i, "").replace(/\/+$/, "");
-}
-
-function formatDeployment(d) {
-	const lines = [
-		`${d.name}  [${d.deployment_id}]`,
-		`  status:     ${d.status}${d.phase ? ` · ${d.phase}` : ""}`,
-		`  theme:      ${d.theme}`,
-		`  collection: ${d.collection_id ?? "(none)"}`,
-	];
-	if (d.url) lines.push(`  url:        ${d.url}`);
-	if (d.domain) lines.push(`  domain:     ${d.domain}`);
-	if (d.last_error) lines.push(`  error:      ${d.last_error}`);
-	return lines.join("\n");
-}
-
-// Poll get_deployment until the blog reaches a terminal state. Emits a line only
-// when status/phase changes so the output reads as progress, not a firehose.
-async function pollUntilTerminal(client, id, io, bin) {
-	const maxPolls = io.maxPolls ?? 90;
-	const interval = io.pollIntervalMs ?? 4000;
-	let last = "";
-	for (let i = 0; i < maxPolls; i++) {
-		const d = await client.callTool("get_deployment", { deployment_id: id });
-		if (d.status === "live" || d.status === "error") return d;
-		const line = `${d.status}${d.phase ? ` · ${d.phase}` : ""}`;
-		if (line !== last) {
-			io.log(`  … ${line}`);
-			last = line;
-		}
-		await io.sleep(interval);
-	}
-	return {
-		status: "error",
-		last_error: `Timed out waiting for it to go live. Check: ${bin} deploy get ${id}`,
-		url: null,
-	};
-}
-
-// --- deployments (phantom blogs) --------------------------------------------
-
-export async function cmdDeploy(ctx) {
-	const sub = ctx.positionals[0];
-	// Bare `deploy` (no subcommand word) is phantomstory-cli's flagship, flag-only
-	// invocation — `phantom deploy --domain x.com --buy` — not one of the create/
-	// list/get/… verbs below, so route it to the orchestrator before the switch.
-	if (sub === undefined) return deployOrchestrate(ctx);
-	const rest = { ...ctx, positionals: ctx.positionals.slice(1) };
-	switch (sub) {
-		case "create":
-		case "new":
-			return deployCreate(rest);
-		case "list":
-		case "ls":
-			return deployList(rest);
-		case "get":
-		case "status":
-		case "show":
-			return deployGet(rest);
-		case "update":
-			return deployUpdate(rest);
-		case "rebuild":
-			return deployRebuild(rest);
-		case "diagnostics":
-		case "diag":
-			return deployDiagnostics(rest);
-		case "delete":
-		case "rm":
-			return deployDelete(rest);
-		default:
-			throw new CliError(
-				`Unknown deploy subcommand: ${sub}. Try: create, list, get, update, rebuild, diagnostics, delete — or bare ` +
-					`"${ctx.bin} deploy --domain <domain>" to reserve+price+build in one step.`
-			);
-	}
-}
-
-// --- one-shot orchestrator: reserve/locate → price domain → optionally buy →
-// rebuild-if-changed. Mirrors phantomstory-cli's flagship `phantom deploy` in this
-// CLI's own plain-text conventions (no spinners/animation, see commands/README notes
-// on the ui/render toolkit not being ported).
-function nameFromDomain(domain) {
-	if (!domain) return undefined;
-	const host = domain
-		.replace(/^https?:\/\//, "")
-		.replace(/^www\./, "")
-		.split("/")[0];
-	const base = host.split(".")[0];
-	if (!base) return undefined;
-	return base
-		.split(/[-_]/)
-		.filter(Boolean)
-		.map((w) => w.charAt(0).toUpperCase() + w.slice(1))
-		.join(" ");
-}
-
-function pickId(obj) {
-	if (obj && typeof obj === "object") {
-		for (const key of ["deployment_id", "id", "deploymentId"]) {
-			if (typeof obj[key] === "string") return obj[key];
-		}
-	}
-	return undefined;
-}
-
-function liveUrl(domain, collected) {
-	if (domain) return `https://${domain}`;
-	for (const v of Object.values(collected)) {
-		if (v && typeof v === "object") {
-			const url = v.url ?? v.live_url ?? v.blog_url;
-			if (typeof url === "string") return url;
-		}
-	}
-	return undefined;
-}
-
-async function deployOrchestrate(ctx) {
-	const { client, flags, io } = ctx;
-	const domainFlag = flagStr(flags.domain);
-	const nameFlag = flagStr(flags.name);
-	const themeFlag = flagStr(flags.theme);
-	const collectionFlag = flagStr(flags.collection);
-	const blogFlag = flagStr(flags.blog);
-	const buy = Boolean(flags.buy);
-	const forceRebuild = Boolean(flags.rebuild);
-	const domain = domainFlag !== undefined ? stripScheme(domainFlag) : undefined;
-
-	if (!domain && !nameFlag && !blogFlag) {
-		throw new CliError(
-			`Nothing to deploy — pass --domain, --name, or --blog. e.g. "${ctx.bin} deploy --domain yourverticalreview.com"`
-		);
-	}
-	if (buy && !domain) {
-		throw new CliError("--buy needs a --domain to register.");
-	}
-	if (blogFlag && (nameFlag || themeFlag || collectionFlag)) {
-		throw new CliError(
-			`--name/--theme/--collection can't be combined with --blog. Use "${ctx.bin} deploy update <id>" to rename, re-theme, or repoint an existing blog.`
-		);
-	}
-
-	if (flags["dry-run"]) {
-		const name = nameFlag || nameFromDomain(domain) || "Phantom Blog";
-		io.log(`Dry run — would deploy with:`);
-		io.log(
-			JSON.stringify(
-				compact({
-					blog: blogFlag,
-					name: blogFlag ? undefined : name,
-					theme: themeFlag,
-					collection: collectionFlag,
-					domain,
-					buy,
-					rebuild: forceRebuild,
-				}),
-				null,
-				2
-			)
-		);
-		if (domain) io.log(`\nWould be live at https://${domain}`);
-		return 0;
-	}
-
-	const collected = {};
-	let changed = false;
-	let deploymentId = blogFlag;
-
-	if (deploymentId) {
-		collected.blog = await client.callTool("get_deployment", { deployment_id: deploymentId });
-		io.log(`Found phantom blog ${deploymentId}`);
-	} else {
-		const name = nameFlag || nameFromDomain(domain) || "Phantom Blog";
-		const created = await client.callTool(
-			"create_deployment",
-			compact({ name, theme: themeFlag, collection_id: collectionFlag })
-		);
-		collected.blog = created;
-		deploymentId = pickId(created);
-		changed = true;
-		io.log(`Reserved phantom blog "${name}"${deploymentId ? ` (${deploymentId})` : ""}`);
-	}
-
-	if (domain) {
-		collected.domain = await client.callTool("check_domain", { domain });
-		io.log(`Priced ${domain}`);
-
-		if (buy) {
-			if (!deploymentId) throw new CliError("Cannot register a domain without a blog id.");
-			collected.purchase = await client.callTool("buy_domain", { deployment_id: deploymentId, domain });
-			changed = true;
-			io.log(`Registered ${domain}`);
-		}
-	}
-
-	if (deploymentId && (changed || forceRebuild)) {
-		collected.build = await client.callTool("rebuild_deployment", { deployment_id: deploymentId });
-		io.log(`SSL + DNS provisioned · sitemap + schema generated`);
-		try {
-			collected.diagnostics = await client.callTool("get_deployment_diagnostics", {
-				deployment_id: deploymentId,
-			});
-		} catch {
-			// best-effort — diagnostics may not be ready immediately after a build kicks off
-		}
-	} else if (deploymentId) {
-		io.log(`No changes — skipped rebuild (pass --rebuild to force).`);
-	}
-
-	if (flags.json) {
-		io.log(JSON.stringify(collected, null, 2));
-		return 0;
-	}
-
-	const url = liveUrl(domain, collected);
-	io.log(`\nYour phantom blog is live${url ? ` at ${url}` : ""}.`);
-	return 0;
-}
-
-async function deployCreate(ctx) {
-	const { client, flags, io } = ctx;
-	const name = requireFlag(flags, "name");
-	const args = { name };
-	const description = flagStr(flags.description);
-	const theme = flagStr(flags.theme);
-	const collection = flagStr(flags.collection);
-	if (description !== undefined) args.description = description;
-	if (theme !== undefined) args.theme = theme;
-	if (collection !== undefined) args.collection_id = collection;
-
-	if (flags["dry-run"]) {
-		io.log(`Dry run — would create a phantom blog with:`);
-		io.log(JSON.stringify(args, null, 2));
-		return 0;
-	}
-
-	const created = await client.callTool("create_deployment", args);
-	io.log(`Created deployment ${created.deployment_id} (${created.status})`);
-
-	if (flags["no-wait"]) {
-		io.log(`Provisioning in the background. Poll with: ${ctx.bin} deploy get ${created.deployment_id}`);
-		return 0;
-	}
-
-	const final = await pollUntilTerminal(client, created.deployment_id, io, ctx.bin);
-	if (final.status === "live") {
-		io.log(`\n✓ Live at ${final.url}`);
-		return 0;
-	}
-	io.error(`\n✗ Deployment ${final.status}: ${final.last_error ?? "unknown error"}`);
-	return 1;
-}
-
-async function deployList(ctx) {
-	const { client, flags, io } = ctx;
-	const limit = flagNum(flags.limit);
-	const result = await client.callTool("list_deployments", limit !== undefined ? { limit } : {});
-	const items = result.items ?? [];
-	if (flags.json) {
-		io.log(JSON.stringify(result, null, 2));
-		return 0;
-	}
-	if (items.length === 0) {
-		io.log(`No deployments yet. Create one with: ${ctx.bin} deploy create --name <name>`);
-		return 0;
-	}
-	for (const d of items) {
-		io.log(
-			`${d.status.padEnd(13)} ${d.deployment_id}  collection:${d.collection_id ?? "(none)"}  ${d.name}${d.url ? `  ${d.url}` : ""}`
-		);
-	}
-	return 0;
-}
-
-async function deployGet(ctx) {
-	const { client, positionals, flags, io } = ctx;
-	const id = requirePositional(positionals, 0, "deployment-id");
-	const d = await client.callTool("get_deployment", { deployment_id: id });
-	printResult(io, flags, d, formatDeployment);
-	return 0;
-}
-
-async function deployUpdate(ctx) {
-	const { client, positionals, flags, io } = ctx;
-	const id = requirePositional(positionals, 0, "deployment-id");
-	const patch = compact({
-		deployment_id: id,
-		name: flagStr(flags.name),
-		description: flagStr(flags.description),
-		theme: flagStr(flags.theme),
-		collection_id: flagStr(flags.collection),
-	});
-	if (Object.keys(patch).length <= 1) {
-		throw new CliError("Nothing to update — pass at least one of --name/--description/--theme/--collection.");
-	}
-	const d = await client.callTool("update_deployment", patch);
-	io.log(`Updated deployment ${id}.`);
-	printResult(io, flags, d, formatDeployment);
-	return 0;
-}
-
-async function deployRebuild(ctx) {
-	const { client, positionals, io } = ctx;
-	const id = requirePositional(positionals, 0, "deployment-id");
-	await client.callTool("rebuild_deployment", { deployment_id: id });
-	io.log(`Rebuild started for ${id}. New published content will appear once the build finishes.`);
-	return 0;
-}
-
-async function deployDiagnostics(ctx) {
-	const { client, positionals, io } = ctx;
-	const id = requirePositional(positionals, 0, "deployment-id");
-	const diag = await client.callTool("get_deployment_diagnostics", { deployment_id: id });
-	io.log(JSON.stringify(diag, null, 2));
-	return 0;
-}
-
-async function deployDelete(ctx) {
-	const { client, positionals, flags, io } = ctx;
-	const id = requirePositional(positionals, 0, "deployment-id");
-	if (!flags.yes) {
-		io.error(`This tears down the blog's site and revokes its content key (the collection is kept).`);
-		io.error(`Re-run with --yes to confirm: ${ctx.bin} deploy delete ${id} --yes`);
-		return 1;
-	}
-	await client.callTool("delete_deployment", { deployment_id: id });
-	io.log(`Deleted deployment ${id}.`);
-	return 0;
-}
-
-// --- custom domains ---------------------------------------------------------
-
-export async function cmdDomain(ctx) {
-	const sub = ctx.positionals[0];
-	const rest = { ...ctx, positionals: ctx.positionals.slice(1) };
-	switch (sub) {
-		case "check":
-			return domainCheck(rest);
-		case "buy":
-			return domainBuy(rest);
-		default:
-			throw new CliError(`Unknown domain subcommand: ${sub ?? "(none)"}. Try: check, buy`);
-	}
-}
-
-async function domainCheck(ctx) {
-	const { client, positionals, flags, io } = ctx;
-	const domain = stripScheme(requirePositional(positionals, 0, "domain"));
-	const quote = await client.callTool("check_domain", { domain });
-	if (flags.json) {
-		io.log(JSON.stringify(quote, null, 2));
-		return 0;
-	}
-	io.log(`${domain}`);
-	io.log(`  available:   ${quote.available}`);
-	if (quote.price !== undefined) io.log(`  price:       $${quote.price}`);
-	io.log(`  purchasable: ${quote.purchasable}`);
-	return 0;
-}
-
-// No confirm gate: the app's BuyDomainDialog charges on a single "Get this domain"
-// click, and the CLI mirrors the app's user-facing flow. The spend is bounded on the
-// server, not by a client prompt — `buy_domain` is server-priced and hard-capped
-// (≤2 domains/org, <$30, blog must be live with no domain yet).
-async function domainBuy(ctx) {
-	const { client, positionals, flags, io } = ctx;
-	const id = requirePositional(positionals, 0, "deployment-id");
-	const domain = stripScheme(requirePositional(positionals, 1, "domain"));
-	const result = await client.callTool("buy_domain", { deployment_id: id, domain });
-	io.log(`Purchase started for ${domain}. Attach + DNS run in the background.`);
-	io.log(`Poll with: ${ctx.bin} deploy get ${id}`);
-	if (flags.json) io.log(JSON.stringify(result, null, 2));
-	return 0;
-}
-
-// `blogs`/`domains` are phantomstory-cli's names for these exact same commands — a
-// literal reference, not a wrapper, so they can never drift from deploy/domain.
-export const cmdBlogs = cmdDeploy;
-export const cmdDomains = cmdDomain;

package/lib/commands/phantom-job.mjs

@@ -1,41 +0,0 @@
-// `phantom-job` — the topic-to-published-article orchestrator: kick off a job with
-// a topic + collection, then check its stage (topic_set -> kernel_running ->
-// publishing -> rebuilding -> done, or failed). The underlying kernel run alone can
-// take 15-20 minutes, so `create` returns as soon as the job is queued rather than
-// blocking — same shape as `flows run` / `flows status`, not `deploy create`'s
-// wait-until-live loop.
-
-import { CliError } from "../client.mjs";
-import { flagStr, requireFlag, requirePositional, printResult, compact, ok } from "./shared.mjs";
-
-export async function cmdPhantomJob(ctx) {
-	const sub = ctx.positionals[0];
-	const rest = { ...ctx, positionals: ctx.positionals.slice(1) };
-	switch (sub) {
-		case "create":
-			return phantomJobCreate(rest);
-		case "status":
-			return phantomJobStatus(rest);
-		default:
-			throw new CliError(`Unknown phantom-job subcommand: ${sub ?? "(none)"}. Try: create, status`);
-	}
-}
-
-async function phantomJobCreate(ctx) {
-	const { client, flags, io } = ctx;
-	const topic = requireFlag(flags, "topic");
-	const collection = requireFlag(flags, "collection");
-	const args = compact({ topic, collection_id: collection, kernel_id: flagStr(flags.kernel) });
-	const result = await client.callTool("create_phantom_from_topic", args);
-	ok(ctx, `Phantom job started. Check progress with: phantom-job status ${result?.job_id ?? "<job-id>"}`);
-	printResult(io, flags, result);
-	return 0;
-}
-
-async function phantomJobStatus(ctx) {
-	const { client, positionals, flags, io } = ctx;
-	const jobId = requirePositional(positionals, 0, "job-id");
-	const result = await client.callTool("get_phantom_job_status", { job_id: jobId });
-	printResult(io, flags, result);
-	return 0;
-}