@letterstory/cli 0.177.8 → 0.177.10

package/lib/cli.mjs

@@ -87,7 +87,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.8";
+export const VERSION = "0.177.10";
 
 /** 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;
@@ -100,6 +100,11 @@ export const BOOLEAN_FLAGS = new Set([
 	"connect-only",
 	// admin demo ideas: every live recipe, not only the Ideas that fit.
 	"library",
+	// admin demo sweep: prepare each recipe's org for a person to start, pull requests, make orgs, skip the refit.
+	"prepare",
+	"pull-requests",
+	"make-orgs",
+	"no-refit",
 	// admin targets check: check every target again, checked or not.
 	"recheck",
 	// build list: also move the builds' open changes along while polling.
@@ -1204,6 +1209,14 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
   admin demo check <org-id>                            Is it ready to show? Competitors, targets, answers, the
                                                        Plan's rows, the issues open, no PR open, GitHub, the
                                                        phantom's site. Exits 1 when not ready.
+  admin demo ideas <org-id> [--library] [--preview] [--force] | --status [--id <run>]
+                                                       Start every Idea on a demo org for real (pull requests, or
+                                                       previews), or read how the latest run went.
+  admin demo sweep [--prepare] [--pull-requests] [--recipes a,b] [--orgs a,b] [--exclude a,b] [--buy a,b] [--make-orgs] [--no-refit] | --status [--id <sweep>]
+                                                       Every live recipe end to end: each gets a test org whose Ideas
+                                                       offers it, its Start pressed (or, with --prepare, left for you
+                                                       to press in the app), and its outcome judged, with who owns a
+                                                       failure. Exits 1 when the sweep failed.
   admin brand-detection <org-id> [--term <t>]... [--exact <t>]... [--exclude <phrase>]... [--note "…"] | --clear [--note "…"]
                                                        How a client's brand is detected in AI answers, with
                                                        every earlier setting; with flags, set the exact set

package/lib/commands/admin.mjs

@@ -6910,7 +6910,7 @@ const DEMO_ITEM_FLAGS = [
 	"setup",
 ];
 const DEMO_USAGE =
-	"Usage: admin demo guide | list [--enrollable] | show <org-id> [--moves] | set <org-id> [--enroll] [--unenroll] [--file <state.json>] [--phantom parked|shown] [--main-blog …] [--visitors …] [--probes not_run|shown] [--cms hidden|shown] [--publish-target …] [--search-console …] [--github …] [--domain …] [--setup fresh|finished] [--domain-cap n] [--inject <key>]... [--hide <key>]... [--save-as <name>] [--baseline <owner/repo>[@sha] | --clear-baseline] [--copy-from <org-id> [--copy-scenarios a,b] [--overwrite]] [--auto-reset <scenario>|off] [--every <minutes>] [--release] | domains | new <domain> [--name <n>] [--brief <t>] [--full] [--host vercel|pages] [--no-wait] | teardown <org-id> [--keep-repo] | bootstrap <org-id>... --from <org-id> [--scenarios a,b] [--overwrite] | reset <org-id> <scenario> [--clean-slate] [--close-prs since_applied|all_open|none] [--hold <minutes>] [--restore-repo revert|force] [--rebuild] [--reread-company] [--forget-company] [--forget-site] | check <org-id> | ideas <org-id> [--library] [--preview] [--force] | ideas <org-id> --status [--id <run-id>]";
+	"Usage: admin demo guide | list [--enrollable] | show <org-id> [--moves] | set <org-id> [--enroll] [--unenroll] [--file <state.json>] [--phantom parked|shown] [--main-blog …] [--visitors …] [--probes not_run|shown] [--cms hidden|shown] [--publish-target …] [--search-console …] [--github …] [--domain …] [--setup fresh|finished] [--domain-cap n] [--inject <key>]... [--hide <key>]... [--save-as <name>] [--baseline <owner/repo>[@sha] | --clear-baseline] [--copy-from <org-id> [--copy-scenarios a,b] [--overwrite]] [--auto-reset <scenario>|off] [--every <minutes>] [--release] | domains | new <domain> [--name <n>] [--brief <t>] [--full] [--host vercel|pages] [--no-wait] | teardown <org-id> [--keep-repo] | bootstrap <org-id>... --from <org-id> [--scenarios a,b] [--overwrite] | reset <org-id> <scenario> [--clean-slate] [--close-prs since_applied|all_open|none] [--hold <minutes>] [--restore-repo revert|force] [--rebuild] [--reread-company] [--forget-company] [--forget-site] | check <org-id> | ideas <org-id> [--library] [--preview] [--force] | ideas <org-id> --status [--id <run-id>] | sweep [--prepare] [--pull-requests] [--recipes <id>,…] [--orgs <id>,…] [--exclude <id>,…] [--buy <recipe-id>,…] [--make-orgs] [--no-refit] | sweep --status [--id <sweep-id>]";
 
 const readinessLines = (r) =>
 	r
@@ -6936,6 +6936,49 @@ const ideasRunLines = (run) =>
 			].join("\n")
 		: "No run yet.";
 
+const SWEEP_MARK = {
+	ready: "READY",
+	passed: "PASS",
+	failed: "FAIL",
+	waiting: "WAIT",
+	held: "HELD",
+	no_org: "NO ORG",
+	not_derivable: "NO PROFILE",
+	pending: "…",
+};
+
+/** A recipe sweep's report (get_recipe_sweep), one block per recipe. */
+const recipeSweepLines = (sweep, appUrl) =>
+	sweep
+		? [
+				`${sweep.summary}  (${sweep.state}${sweep.note && sweep.state !== "done" ? `: ${sweep.note}` : ""})`,
+				`${sweep.start ? "started by the sweep" : "prepared for you to start"}, ${sweep.delivery === "build" ? "previews" : "pull requests"}, by ${sweep.started_by_name ?? "staff"} at ${sweep.created_at}  sweep ${sweep.id}`,
+				...sweep.items.map((i) =>
+					[
+						`\n${(SWEEP_MARK[i.result] ?? i.result).padEnd(10)} ${i.name}`,
+						i.org ? `  org: ${i.org.name} (${i.org.host})${i.org.made ? ", made for it" : ""}` : null,
+						i.fit[0] ? `  fit: ${i.fit[0].fits}: ${i.fit[0].why}` : null,
+						i.row
+							? `  row: ${i.row.title}${i.row.line ? ` / ${i.row.line}` : ""}${i.row.button ? ` [${i.row.button}]` : ""}`
+							: null,
+						i.did
+							? `  did: ${i.did.tools.join(", ") || "no tools"}${i.did.sandbox ? ", a sandbox" : ""}${i.did.cost_usd != null ? `, $${i.did.cost_usd}` : ""}`
+							: null,
+						i.verdict ? `  outcome: ${i.verdict.state}: ${i.verdict.observed}` : null,
+						i.cause ? `  cause: ${i.cause.owner}: ${i.cause.why}` : null,
+						i.profile_problem ? `  profile: ${i.profile_problem}` : null,
+						i.profile?.unsettable?.length
+							? `  can't be made on a test org: ${i.profile.unsettable.map((u) => u.key).join(", ")}`
+							: null,
+						i.links?.ideas ? `  open: ${appUrl}${i.links.ideas}` : null,
+						i.links?.build ? `  build: ${appUrl}${i.links.build}` : null,
+					]
+						.filter(Boolean)
+						.join("\n")
+				),
+			].join("\n")
+		: "No sweep yet.";
+
 async function cmdAdminDemo(ctx) {
 	const { flags, positionals, io } = ctx;
 	const sub = positionals[0];
@@ -7194,6 +7237,30 @@ async function cmdAdminDemo(ctx) {
 			printResult(io, flags, result, (r) => ideasRunLines(r.run));
 			return result.run?.state === "failed" ? 1 : 0;
 		}
+		case "sweep": {
+			// Every live recipe end to end on test orgs (run_recipe_sweep), or the latest sweep's report (get_recipe_sweep).
+			const path = `${DEMO}/sweeps`;
+			const id = flagStr(flags.id);
+			const result =
+				flagBool(flags.status) || id
+					? await staffRequest(ctx, "GET", id ? `${path}?id=${encodeURIComponent(id)}` : path)
+					: await staffPost(
+							ctx,
+							path,
+							compact({
+								start: flagBool(flags.prepare) ? false : undefined,
+								delivery: flagBool(flags["pull-requests"]) ? "build_pr" : undefined,
+								recipes: flags.recipes ? flagList(flags.recipes) : undefined,
+								orgs: flags.orgs ? flagList(flags.orgs) : undefined,
+								exclude: flags.exclude ? flagList(flags.exclude) : undefined,
+								purchases: flags.buy ? flagList(flags.buy) : undefined,
+								make_orgs: flagBool(flags["make-orgs"]) || undefined,
+								refit: flagBool(flags["no-refit"]) ? false : undefined,
+							})
+						);
+			printResult(io, flags, result, (r) => recipeSweepLines(r.sweep, ctx.client.url));
+			return result.sweep?.state === "failed" ? 1 : 0;
+		}
 		default:
 			throw new CliError(DEMO_USAGE);
 	}

package/lib/commands/build.mjs

@@ -44,6 +44,8 @@ const ARGS = {
 		prompt: { value: (flags, positionals) => flagStr(flags.prompt) ?? (positionals.join(" ").trim() || undefined) },
 		// --ask "<words>": the person's own words, when --prompt was written from them.
 		ask: "ask",
+		// --confirms <build id>: the person's yes to the price a build stopped on.
+		confirms: "confirms",
 		// --build-it: the words are a request to build, never read as a question.
 		asked_to_build: { flag: "build-it", type: "bool" },
 		domain: "site",
@@ -254,6 +256,7 @@ async function buildStart(ctx) {
 		"prompt",
 		"ask",
 		"build-it",
+		"confirms",
 		"site",
 		"subject",
 		"recipe",

package/package.json

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