@letterstory/cli 0.28.0 → 0.29.1

package/lib/commands/posts.mjs

@@ -20,6 +20,9 @@ export const ARGS = {
 	publish_article: {
 		article_id: { positional: 0, label: "article-id", required: true },
 	},
+	delete_article: {
+		article_ids: { flag: "id", type: "list", required: true, label: "id" },
+	},
 };
 
 export async function cmdPosts(ctx) {
@@ -37,9 +40,12 @@ export async function cmdPosts(ctx) {
 			return postsPublish(rest);
 		case "unpublish":
 			return postsUnpublish(rest);
+		case "delete":
+		case "rm":
+			return postsDelete(rest);
 		default:
 			throw new CliError(
-				`Unknown posts subcommand: ${sub ?? "(none)"}. Try: list, show, new, publish, unpublish`
+				`Unknown posts subcommand: ${sub ?? "(none)"}. Try: list, show, new, publish, unpublish, delete`
 			);
 	}
 }
@@ -66,8 +72,10 @@ async function postsNew(ctx) {
 	const collection = requireFlag(flags, "collection");
 	const body = readBodyInput(flags);
 	if (!body) throw new CliError("Provide --body or --file <path>.");
-	const result = await client.callTool("ingest_article", { title, body, collection_id: collection });
-	ok(ctx, `Created draft "${title}".`);
+	const articleId = flagStr(flags["article-id"]);
+	const args = compact({ title, body, collection_id: collection, article_id: articleId });
+	const result = await client.callTool("ingest_article", args);
+	ok(ctx, articleId ? `Updated "${title}".` : `Created draft "${title}".`);
 	printResult(io, flags, result);
 	return 0;
 }
@@ -89,6 +97,17 @@ async function postsUnpublish(ctx) {
 	return 0;
 }
 
+// Permanent: no confirmation prompt here — the CLI is a scripting surface, and the
+// tool result reports exactly which ids were deleted vs not found.
+async function postsDelete(ctx) {
+	const { client, flags, io, positionals } = ctx;
+	const args = argsFromFlags(ARGS.delete_article, flags, positionals);
+	const result = await client.callTool("delete_article", args);
+	ok(ctx, `Deleted ${result?.deleted_ids?.length ?? 0} article(s).`);
+	printResult(io, flags, result);
+	return 0;
+}
+
 // --- published (frozen public view) -----------------------------------------
 
 export async function cmdPublished(ctx) {

package/lib/commands.mjs

@@ -1,12 +1,13 @@
 // Command handlers, split into focused modules under ./commands/*.mjs as the surface
-// grew past a single-file's worth of clarity (auth, discovery, deploy/domain, posts,
+// grew past a single-file's worth of clarity (auth, discovery, collection/phantom, posts,
 // collections, flows, connectors, strategy, insights). This file re-exports
 // everything so `cli.mjs` — and any test importing straight from "commands.mjs" —
 // keep a single, stable import path regardless of how the implementation is split.
 
 export * from "./commands/auth.mjs";
 export * from "./commands/discovery.mjs";
-export * from "./commands/deploy.mjs";
+export * from "./commands/collection.mjs";
+export * from "./commands/phantom.mjs";
 export * from "./commands/mcp.mjs";
 export * from "./commands/posts.mjs";
 export * from "./commands/reviewers.mjs";
@@ -24,7 +25,7 @@ export * from "./commands/templates.mjs";
 export * from "./commands/autopen.mjs";
 export * from "./commands/kernel.mjs";
 export * from "./commands/lede.mjs";
-export * from "./commands/phantom-job.mjs";
+
 export * from "./commands/onboard.mjs";
 export * from "./commands/seers.mjs";
 export * from "./commands/shredder.mjs";

package/lib/documents.mjs

@@ -0,0 +1,141 @@
+// Document `--file` flags, resolved through the app's extraction door before any command runs.
+//
+// WHY THE CLI DOES NOT PARSE ANYTHING ITSELF. `--file` used to be `readFileSync(path, "utf8")`,
+// full stop. That is correct for a .md or .txt and silently wrong for everything else: a
+// `letterstory kernel write --file report.docx` sent the zip's raw bytes as the article input,
+// so decompose was handed `PK\x03\x04…` and asked to find a thesis in it. A .pdf was the same.
+// No error, no warning, just a run spent on noise.
+//
+// The app already had a real extractor (mammoth, pdf-parse, and the rest — src/lib/uploads),
+// so the fix is to USE it rather than grow a second one here: the bytes go to
+// `POST /api/documents/extract` and come back as text. One engine, one format list, one
+// refusal message, whether the document arrived from the Studio's dropzone, an MCP tool or
+// this flag. A CLI-local parser would have been the same mistake the browser copy was.
+//
+// Formats we can read without help (.md, .txt, …) are still read locally — no round trip for
+// the common case, and `letterstory` keeps working against a file when the network does not.
+//
+// And only formats the door actually reads are touched at all: `--file` means different things
+// to different commands (see NEEDS_EXTRACTION), so anything else is passed through untouched.
+
+import { readFileSync, statSync } from "node:fs";
+import { basename, extname } from "node:path";
+import { CliError } from "./client.mjs";
+
+/**
+ * Extensions whose bytes a model CANNOT use as they stand — a zip (docx, odt), a binary
+ * container (pdf), or control-word soup (rtf). Only these go to the extraction door.
+ *
+ * NARROW ON PURPOSE, twice over.
+ *
+ * It is an ALLOWLIST rather than "anything not plain text", because `--file` is OVERLOADED
+ * across the CLI: a prose body for `kernel write`, a JSON manifest for `seers apply`, an
+ * output DESTINATION for `seers export`. Resolving every non-plain-text `--file` sent
+ * `seers export --file seers.json` to the door and broke a command that was only ever going
+ * to WRITE that path.
+ *
+ * And it EXCLUDES html/markdown/csv/captions even though the door can read them, because
+ * those already are what the primitives take. `run_shred` accepts HTML and returns it with
+ * its images, embeds, links and attributes exactly as they arrived — extracting first would
+ * strip the scripts, styles and comments the shredder was asked to preserve, and
+ * `cli-shred-kernel-e2e` asserts those bytes cross the wire untouched. Passing them through
+ * is both lossless and what shipped.
+ *
+ * Kept honest by `__tests__/unit/lib/uploads/surface-parity.test.ts`, which asserts this set
+ * equals the registry's `plainText: false` rows rather than trusting them to stay aligned.
+ */
+const NEEDS_EXTRACTION = new Set(["docx", "pdf", "odt", "rtf"]);
+
+/**
+ * The `(inlineFlag, fileFlag)` pairs `readTextInput` reads, which is what makes this
+ * interception possible without touching 75 `argsFromFlags` call sites: the inline value
+ * WINS over the path, so resolving a document means setting the inline flag to its text and
+ * leaving the path alone.
+ *
+ * Adding a new `--x-file` flag means adding its pair here. The CLI parity test asserts that
+ * every `readTextInput` call in the tree has a row.
+ */
+export const DOCUMENT_FLAG_PAIRS = [
+	["body", "file"],
+	["brief", "brief-file"],
+	["text", "text-file"],
+];
+
+/**
+ * `readTextInput` pairs that are STRUCTURED ARGUMENTS, not documents — JSON a command parses
+ * immediately, so extraction must never touch them (a .json is not a document format, and
+ * routing one through the door would refuse it outright).
+ *
+ * Declared rather than merely omitted so the choice is a decision somebody made: the parity
+ * test asserts every `readTextInput` pair in the CLI appears in exactly ONE of these two
+ * lists, so a new `--x-file` flag cannot be added without answering "prose or JSON?".
+ */
+export const JSON_ARG_FLAG_PAIRS = [
+	// A topic plan, or a whole saved proposal (onboard.mjs readTopicPlan).
+	["plan", "plan-file"],
+	// A reviewed plan handed back to be applied verbatim (onboard.mjs readAcceptedPlan).
+	["accept-plan-json", "accept-plan"],
+];
+
+/** Lower-case extension without the dot. */
+function extOf(path) {
+	return extname(path).replace(/^\./, "").toLowerCase();
+}
+
+/**
+ * Extract a document's text by posting it to the app's door.
+ *
+ * Uses the same authenticated client every other command uses, so an expired session or a
+ * missing key fails the way it does everywhere else rather than as an opaque upload error.
+ */
+async function extractViaDoor(client, path) {
+	let bytes;
+	try {
+		bytes = readFileSync(path);
+	} catch (error) {
+		throw new CliError(`Could not read ${path}: ${error.message}`);
+	}
+	const form = new FormData();
+	form.append("file", new Blob([bytes]), basename(path));
+
+	const result = await client.postForm("/api/documents/extract", form);
+	if (typeof result?.text !== "string" || !result.text.trim()) {
+		throw new CliError(`${basename(path)} had no readable text.`);
+	}
+	// Worth saying out loud: a Google Docs export's images are gone, and a silent removal is
+	// how someone wonders later why the article came back without its figure.
+	if (result.notice) process.stderr.write(`${basename(path)}: ${result.notice}\n`);
+	return result.text;
+}
+
+/**
+ * Resolve every document `--*-file` flag in `flags` to text, in place.
+ *
+ * Plain-text formats are read locally; everything else goes through the door. A flag whose
+ * inline twin is already set is left alone — an explicit `--body` beats a `--file`, which is
+ * the precedence `readTextInput` has always had.
+ *
+ * `-` (stdin) is deliberately NOT handled here: it is always text by definition, and
+ * `readTextInput` already reads it.
+ */
+export async function resolveDocumentFlags(client, flags) {
+	for (const [inlineFlag, fileFlag] of DOCUMENT_FLAG_PAIRS) {
+		const path = flags[fileFlag];
+		if (typeof path !== "string" || !path || path === "-") continue;
+		// An explicit inline value wins; nothing to resolve.
+		if (flags[inlineFlag] !== undefined) continue;
+		// Not a format the door reads — leave the flag completely alone, whatever the command
+		// means by it (a JSON manifest, an output path, plain text readTextInput handles).
+		if (!NEEDS_EXTRACTION.has(extOf(path))) continue;
+
+		let size;
+		try {
+			size = statSync(path).size;
+		} catch (error) {
+			throw new CliError(`Could not read --${fileFlag} ${path}: ${error.message}`);
+		}
+		if (size === 0) throw new CliError(`--${fileFlag} ${path} is empty.`);
+
+		flags[inlineFlag] = await extractViaDoor(client, path);
+	}
+}

package/package.json

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

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;
-}