@letterstory/cli 0.91.0 → 0.92.0

package/lib/cli.mjs

@@ -57,7 +57,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.91.0";
+export const VERSION = "0.92.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. Every `type: "bool"` flag (and its
@@ -121,6 +121,8 @@ export const BOOLEAN_FLAGS = new Set([
 	// `phantom-onboard collection --enable-planner`, `strategy sitemap --posts-only`, and the
 	// `strategy positioning set --clear-*` switches: value-less, and each sits next to a value.
 	"enable-planner",
+	// `phantom-onboard primitives --retry [<domain>]` re-reads a domain whose read failed.
+	"retry",
 	"posts-only",
 	"clear-topics",
 	"clear-stances",
@@ -581,6 +583,9 @@ Propose lane (the Fleet wizard's Plan and Name screens; persists nothing, spends
                                                        (--plan '<json>' inline, or - for stdin).
 
 What does this org still need? (the router — reads only, decides nothing):
+  ${bin === "phantom" ? "onboard" : "phantom-onboard"} primitives [<domain>] [--retry]  The primitives that fit a domain (default:
+                                                       yours), each with the exact call that sets
+                                                       it up — the plan Instances shows
   ${bin === "phantom" ? "onboard" : "phantom-onboard"} plan                         Every onboarding step (context, main blog,
                                                        Planner, CMS, phantom) with its status:
                                                        done / running / ready / blocked, and what

package/lib/commands/onboard.mjs

@@ -174,6 +174,12 @@ export const ARGS = {
 	get_phantom_launch_status: {
 		job_id: { internal: "the job id plan_phantom just returned" },
 	},
+	// The primitive plan: a domain (default: the org's own) read into the calls that would
+	// stand each primitive up. Printed, never run — approving an item is running its call.
+	propose_primitive_plan: {
+		domain: { positional: 0, label: "domain" },
+		retry: { flag: "retry", type: "bool" },
+	},
 	propose_phantom_plan: {
 		client_domain: { positional: 0, label: "client-domain" },
 		direction: ["about", "direction"],
@@ -752,8 +758,62 @@ async function cmdOnboardNext(ctx) {
 	return 0;
 }
 
+// `onboard primitives [<domain>]` — what Letterstory would stand up for this company: one
+// read of propose_primitive_plan, printed as a table whose last column is the exact
+// `call` that sets each item up. Nothing runs; approving an item is running its line.
+// A first read crawls the site; `pending` means one is already in flight, so wait and ask.
+function shellQuote(json) {
+	return `'${json.replace(/'/g, "'\\''")}'`;
+}
+
+function formatPrimitivePlan(ctx) {
+	return (res) => {
+		if (res.status !== "complete") {
+			return res.status === "pending"
+				? `Still reading ${res.domain} — run this again in a few seconds.`
+				: `Couldn't read ${res.domain}: ${res.error ?? "unknown error"} (retry with --retry)`;
+		}
+		const { plan } = res;
+		const lines = [`${plan.company_name} (${plan.domain})`, `  ${plan.priority_topics.join(" · ")}`, ""];
+		for (const item of plan.items) {
+			// A part of its parent's setup prints indented under it.
+			const pad = item.parent ? "    " : "";
+			const mark = item.status === "exists" ? "running " : "proposed";
+			lines.push(`${pad}${mark}  ${item.title}`);
+			lines.push(
+				item.status === "exists"
+					? `${pad}          already: ${item.existing.map((e) => e.name).join(", ")}`
+					: `${pad}          ${item.detail}`
+			);
+			if (item.call) {
+				lines.push(
+					`${pad}          ${ctx.bin} call ${item.call.tool} --args ${shellQuote(JSON.stringify(item.call.args))}`
+				);
+				for (const [arg, ref] of Object.entries(item.refs ?? {})) {
+					lines.push(`${pad}          with ${arg} = ${ref.field} from ${ref.item}`);
+				}
+				if (item.after?.length) lines.push(`${pad}          after: ${item.after.join(", ")}`);
+				if (item.poll) lines.push(`${pad}          then poll: ${item.poll.tool}`);
+			}
+		}
+		return lines.join("\n");
+	};
+}
+
+async function cmdOnboardPrimitives(ctx) {
+	const args = argsFromFlags(ARGS.propose_primitive_plan, ctx.flags, ctx.positionals);
+	ok(ctx, "Reading the domain…");
+	const res = await ctx.client.callTool("propose_primitive_plan", args);
+	printResult(ctx.io, ctx.flags, res, formatPrimitivePlan(ctx));
+	return 0;
+}
+
 export async function cmdOnboard(ctx) {
 	const { client, flags, io } = ctx;
+	// `onboard primitives [<domain>]` — the primitive plan and the call behind each item.
+	if (ctx.positionals[0] === "primitives") {
+		return cmdOnboardPrimitives({ ...ctx, positionals: ctx.positionals.slice(1) });
+	}
 	// `onboard plan` / `onboard next` — the router: what does this org still need?
 	if (ctx.positionals[0] === "plan") return cmdOnboardPlan(ctx);
 	if (ctx.positionals[0] === "next") return cmdOnboardNext(ctx);

package/package.json

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