@letterstory/cli 0.148.1 → 0.148.2

package/lib/cli.mjs

@@ -53,6 +53,7 @@ import {
 	cmdAdmin,
 	cmdFeedback,
 	cmdRepo,
+	cmdBuild,
 	cmdSite,
 	cmdEvals,
 	cmdOfferings,
@@ -65,12 +66,15 @@ import {
 
 // Matches cli/package.json; publish-cli.yml rewrites both to the published version.
 // Matches cli/package.json; publish-cli.yml rewrites both to the published version.
-export const VERSION = "0.148.1";
+export const VERSION = "0.148.2";
 
 // 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
 // `negate` spelling) in a command's ARGS map must be listed; boolean-flags.test.ts enforces it.
 export const BOOLEAN_FLAGS = new Set([
+	// build: repeat an open build's ask; post its progress in the org's Slack channel.
+	"again",
+	"notify-slack",
 	"remap",
 	// login: one-link device sign-in instead of the loopback browser flow.
 	"device",
@@ -1378,6 +1382,17 @@ Insights:
                                                        Page access: who's reading your phantom sites
   insights activity [--phantom <uuid>] [--limit <n>]   What hit your phantom sites in the last 7 days, newest first
 
+Build (a change to your site, or launching what isn't code; the Build box's own door):
+  build <words…> [--prompt <text>] [--site <host>] [--subject <host/path>]... [--action build|build_pr|build_merge|slack|linear]
+             [--attach <path>]... [--attach-url <name>=<https url>]... [--attach-ref <path>]... [--attach-url-ref <name>=<https url>]...
+             [--harness claude-code|letterpress-1] [--notify-slack] [--again]
+                                                       Build from your words: "add a pricing page" opens a preview or PR;
+                                                       "launch a phantom for us", "set up mailers" or "onboard my blog" is
+                                                       done by Build itself (a phantom site buys its own domain), and the
+                                                       build reads Done with no PR to merge. --again repeats an open build's ask
+  build talk <words…> [--conversation <id>|--build <id>] [--site <host>] [--harness claude-code|letterpress-1]
+                                                       One turn of a conversation with Build (questions, follow-ups on a build)
+
 The Site (one model of your whole marketing site, keyed by host and path):
   site list                                            Mapped hosts, and hosts you already have elsewhere
   site map <host> [--sitemap <url>] [--max-pages <n>] [--no-audit] [--relation owned|watched]
@@ -1587,6 +1602,7 @@ const CLIENT_COMMANDS = {
 	mailers: cmdMailers,
 	feedback: cmdFeedback,
 	repo: cmdRepo,
+	build: cmdBuild,
 	site: cmdSite,
 	evals: cmdEvals,
 	visits: cmdVisits,

package/lib/commands/build.mjs

@@ -0,0 +1,99 @@
+// `build` — Build from words, the way the Build box and the letterpress terminal do it
+// (src/lib/growth-builds/start-build.ts). What the words name is done: a change to the site
+// becomes a preview or a pull request, and launching phantom sites or mailers, or onboarding the
+// main blog, is carried out by Build itself with nothing to merge.
+//   build <words…>          → start_build         (--prompt for a long ask; --again to repeat one)
+//   build talk <words…>     → send_build_message  (--conversation <id> | --build <id> to continue)
+
+import { CliError } from "../client.mjs";
+import { argsFromFlags, flagList, flagStr, ok, printResult, refuseUnknownFlags } from "./shared.mjs";
+import { attachmentUrls, uploadAttachments } from "./repo.mjs";
+
+const ARGS = {
+	start_build: {
+		// The words after `build`, or --prompt for a longer ask.
+		prompt: { value: (flags, positionals) => flagStr(flags.prompt) ?? (positionals.join(" ").trim() || undefined) },
+		domain: "site",
+		// --subject host/path (repeatable): the pages it is about.
+		subjects: { flag: "subject", type: "list" },
+		// --attach <path> (uploaded first) and --attach-url <name>=<https url>, both repeatable;
+		// -ref ones are context the agent reads, never put in the repo.
+		files: { value: (_flags, _positionals, extra) => (extra.files?.length ? extra.files : undefined) },
+		delivery: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack", "linear"] },
+		notify_slack: { flag: "notify-slack", type: "bool" },
+		harness: { flag: "harness", enum: ["claude-code", "letterpress-1"] },
+		again: { flag: "again", type: "bool" },
+	},
+	send_build_message: {
+		message: {
+			value: (flags, positionals) => flagStr(flags.message) ?? (positionals.join(" ").trim() || undefined),
+		},
+		conversation_id: "conversation",
+		build_id: "build",
+		domain: "site",
+		subjects: { flag: "subject", type: "list" },
+		files: { value: (_flags, _positionals, extra) => (extra.files?.length ? extra.files : undefined) },
+		harness: { flag: "harness", enum: ["claude-code", "letterpress-1"] },
+	},
+};
+
+const FILE_FLAGS = ["attach", "attach-url", "attach-ref", "attach-url-ref"];
+
+/** The files named by --attach / --attach-url (and their -ref forms), uploaded first. */
+async function attachedFiles(ctx) {
+	const { flags } = ctx;
+	const place = flagList(flags.attach);
+	const uploaded = await uploadAttachments(ctx, [...place, ...flagList(flags["attach-ref"])]);
+	return [
+		...uploaded.map((f, i) => (i < place.length ? f : { ...f, reference: true })),
+		...attachmentUrls(flagList(flags["attach-url"])),
+		...attachmentUrls(flagList(flags["attach-url-ref"])).map((f) => ({ ...f, reference: true })),
+	];
+}
+
+export async function cmdBuild(ctx) {
+	if (ctx.positionals[0] === "talk") return buildTalk({ ...ctx, positionals: ctx.positionals.slice(1) });
+	return buildStart(ctx);
+}
+
+async function buildStart(ctx) {
+	const { client, flags, io } = ctx;
+	refuseUnknownFlags(ctx, {}, [
+		"prompt",
+		"site",
+		"subject",
+		"action",
+		"notify-slack",
+		"harness",
+		"again",
+		...FILE_FLAGS,
+	]);
+	const files = await attachedFiles(ctx);
+	const args = argsFromFlags(ARGS.start_build, flags, ctx.positionals, { files });
+	if (!args.prompt) throw new CliError('Say what to build: letterstory build "launch a phantom for us"');
+	const result = await client.callTool("start_build", args);
+	printResult(io, flags, result, (r) => {
+		if (r.status !== "started") return r.message ?? r.status;
+		const steps = (r.build?.steps ?? []).map((s) => `  ${s.status}  ${s.title}${s.note ? `: ${s.note}` : ""}`);
+		return [`Started: ${r.build.title}  (${r.build.id})`, ...steps].join("\n");
+	});
+	if (result.status !== "started" && !flags.json) ok(ctx, "Nothing was started.");
+	return 0;
+}
+
+async function buildTalk(ctx) {
+	const { client, flags, io } = ctx;
+	refuseUnknownFlags(ctx, {}, ["message", "conversation", "build", "site", "subject", "harness", ...FILE_FLAGS]);
+	const files = await attachedFiles(ctx);
+	const args = argsFromFlags(ARGS.send_build_message, flags, ctx.positionals, { files });
+	if (!args.message) throw new CliError('Say something: letterstory build talk "make the hero darker"');
+	const result = await client.callTool("send_build_message", args);
+	printResult(io, flags, result, (r) =>
+		[r.reply, ...(r.questions ?? []).map((q) => `? ${q.question}`), r.build ? `Build: ${r.build.id}` : null]
+			.filter(Boolean)
+			.join("\n")
+	);
+	return 0;
+}
+
+export { ARGS };

package/lib/commands/repo.mjs

@@ -347,7 +347,7 @@ export async function cmdRepo(ctx) {
 }
 
 /** `--attach-url name=https://…` → `{ name, url }`. */
-function attachmentUrls(specs) {
+export function attachmentUrls(specs) {
 	return specs.map((spec) => {
 		const at = spec.indexOf("=");
 		if (at < 1) throw new CliError(`--attach-url must be name=https://… (got ${spec})`);
@@ -356,7 +356,7 @@ function attachmentUrls(specs) {
 }
 
 /** Reserve an upload per --attach file, PUT the bytes, and return `{ name, upload_path }` for each. */
-async function uploadAttachments(ctx, paths) {
+export async function uploadAttachments(ctx, paths) {
 	if (!paths.length) return [];
 	const names = paths.map((p) =>
 		basename(p)

package/lib/commands.mjs

@@ -44,6 +44,7 @@ export * from "./commands/targets.mjs";
 export * from "./commands/admin.mjs";
 export * from "./commands/feedback.mjs";
 export * from "./commands/repo.mjs";
+export * from "./commands/build.mjs";
 export * from "./commands/site.mjs";
 export * from "./commands/evals.mjs";
 export * from "./commands/visits.mjs";

package/package.json

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