@letterstory/cli 0.177.20 → 0.177.22

package/lib/cli.mjs

@@ -88,7 +88,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.20";
+export const VERSION = "0.177.22";
 
 /** 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;
@@ -1226,7 +1226,7 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
   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>]
+  admin demo sweep [--prepare] [--pull-requests] [--recipes a,b] [--variation <n|name>] [--orgs a,b] [--exclude a,b] [--buy a,b] [--make-orgs] [--no-refit] | --status [--id <sweep>] | --reset <recipe> [--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

package/lib/commands/admin.mjs

@@ -5938,6 +5938,7 @@ async function cmdAdminLetterpress(ctx) {
 		case "fits": {
 			// list_recipe_fits: the standing fit's verdicts, one per account, site and recipe.
 			const q = new URLSearchParams({ limit: String(flags.limit ?? 100) });
+			if (flags.offset !== undefined) q.set("offset", String(flags.offset));
 			if (flags.recipe) q.set("recipe_id", String(flags.recipe));
 			if (flags.org) q.set("org_id", String(flags.org));
 			if (flags.site) q.set("domain", String(flags.site));
@@ -7006,7 +7007,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>] | sweep [--prepare] [--pull-requests] [--recipes <id>,…] [--orgs <id>,…] [--exclude <id>,…] [--buy <recipe-id>,…] [--make-orgs] [--no-refit] | sweep --status [--id <sweep-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>,…] [--variation <n|name>] [--orgs <id>,…] [--exclude <id>,…] [--buy <recipe-id>,…] [--make-orgs] [--no-refit] | sweep --status [--id <sweep-id>] | sweep --reset <recipe-id> [--id <sweep-id>]";
 
 const readinessLines = (r) =>
 	r
@@ -7051,7 +7052,7 @@ const recipeSweepLines = (sweep, appUrl) =>
 				`${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}`,
+						`\n${(SWEEP_MARK[i.result] ?? i.result).padEnd(10)} ${i.name}${i.variation ? ` (variation ${i.variation}: ${i.variation_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
@@ -7062,6 +7063,7 @@ const recipeSweepLines = (sweep, appUrl) =>
 							: null,
 						i.verdict ? `  outcome: ${i.verdict.state}: ${i.verdict.observed}` : null,
 						i.cause ? `  cause: ${i.cause.owner}: ${i.cause.why}` : null,
+						...(i.tried ?? []).map((t) => `  tried ${t.name}: ${t.why}`),
 						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(", ")}`
@@ -7318,6 +7320,18 @@ async function cmdAdminDemo(ctx) {
 			const orgId = requirePositional(positionals, 1, "org-id");
 			const path = `${DEMO}/${encodeURIComponent(orgId)}/ideas`;
 			const id = flagStr(flags.id);
+			// The retest loop: one recipe brought back on its test org (reset_recipe_sweep_item).
+			if (flagStr(flags.reset)) {
+				const reset = await staffPost(ctx, `${path}/reset`, compact({ id, recipe_id: flagStr(flags.reset) }));
+				printResult(io, flags, reset, (r) =>
+					[
+						...r.reset.undone.map((u) => `undone: ${u}`),
+						...r.reset.kept.map((k) => `kept: ${k}`),
+						recipeSweepLines(r.sweep, ctx.client.url),
+					].join("\n")
+				);
+				return 0;
+			}
 			const result =
 				flagBool(flags.status) || id
 					? await staffRequest(ctx, "GET", id ? `${path}?id=${encodeURIComponent(id)}` : path)
@@ -7347,6 +7361,12 @@ async function cmdAdminDemo(ctx) {
 								start: flagBool(flags.prepare) ? false : undefined,
 								delivery: flagBool(flags["pull-requests"]) ? "build_pr" : undefined,
 								recipes: flags.recipes ? flagList(flags.recipes) : undefined,
+								// A number is the variation's place (1 is the recipe itself); anything else its name.
+								variation: flagStr(flags.variation)
+									? /^\d+$/.test(flagStr(flags.variation))
+										? Number(flagStr(flags.variation))
+										: flagStr(flags.variation)
+									: undefined,
 								orgs: flags.orgs ? flagList(flags.orgs) : undefined,
 								exclude: flags.exclude ? flagList(flags.exclude) : undefined,
 								purchases: flags.buy ? flagList(flags.buy) : undefined,

package/package.json

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