@letterstory/cli 0.176.99 → 0.176.101

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.176.99";
+export const VERSION = "0.176.101";
 
 /** 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;
@@ -96,6 +96,8 @@ export const EXIT_PAYMENT_REQUIRED = 3;
 // 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([
+	// admin demo ideas: every live recipe, not only the Ideas that fit.
+	"library",
 	// admin targets check: check every target again, checked or not.
 	"recheck",
 	// build list: also move the builds' open changes along while polling.
@@ -1992,6 +1994,7 @@ Domains (the domains you hold, and free ones that match what people search):
 Vary (A/B tests of a page's words and images on your own site):
   vary [list] [--status running] [--site <id>]         Your variationals and how many visitors each has seen
   vary create --page <url> [--name <n>] [--goals-file <path>]
+  vary launch [--brief <words>] [--page <url>]         An A/B test Letter writes from the page and starts
   vary get <id>                                        Variants, their changes, and the results against the original
   vary page <id>                                       The page's copy as changes need it, and whether each variant still applies
   vary save-variant <id> --deltas-file <path> [--key b] [--name <n>]

package/lib/commands/admin.mjs

@@ -22,7 +22,7 @@
 //   admin letterpress companies | company <org-id> | facts <org-id>  (the standing fit, per company)
 //   admin letterpress beyond [--limit N] [--before ISO]  (what members asked that went past the library)
 //   admin letterpress settings|flip|set …                                             (recipes:read / recipes:write)
-//   admin demo guide|list|show|set|reset|check …                                                 (demo:read / demo:write)
+//   admin demo guide|list|show|set|reset|check|ideas …                                           (demo:read / demo:write)
 //   admin deployments [--health down|failing|blocked|setting_up|live|paused|archived] [--org <id>] [--q <text>] [--archived] [--test] [--no-host]   (fleet:read)
 //   admin models runs|run|star|unstar|scoreboard|requests|request|sampling …       (models:read / models:write)
 //   admin replays [--org <id>] [--target <id>] [--status …] [--limit n]                (fleet:read)
@@ -6808,7 +6808,8 @@ async function cmdAdminBilling(ctx) {
 
 // `admin demo` — demo control (docs/architecture/demo-control.md): what each demo org shows,
 // set, rehearsed and reset. The staff routes behind /superadmin/demo, the same functions and
-// schema as list_demo_orgs / get_demo_state / set_demo_state / reset_demo_state / run_demo_readiness_check.
+// schema as list_demo_orgs / get_demo_state / set_demo_state / reset_demo_state / run_demo_readiness_check /
+// run_demo_ideas / get_demo_ideas_run.
 const DEMO = "/api/superadmin/demo";
 const DEMO_ITEM_FLAGS = [
 	"phantom",
@@ -6823,7 +6824,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>";
+	"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>]";
 
 const readinessLines = (r) =>
 	r
@@ -6833,6 +6834,22 @@ const readinessLines = (r) =>
 			].join("\n")
 		: "Not checked yet.";
 
+const ideasRunLines = (run) =>
+	run
+		? [
+				`${run.summary}  (${run.state}${run.note && run.state !== "done" ? `: ${run.note}` : ""})`,
+				`${run.scope === "library" ? "every live recipe" : "Ideas"} on ${run.host}, ${run.delivery === "build" ? "previews" : "pull requests"}${run.force ? ", forced" : ""}, by ${run.started_by_name ?? "staff"} at ${run.created_at}  run ${run.id}`,
+				...run.items.map(
+					(i) =>
+						`  ${i.outcome.padEnd(9)} ${i.title}${i.reason && i.outcome !== "started" ? `  [${i.reason}]` : ""}${
+							i.build
+								? `  build: ${i.build.archived ? "archived" : i.build.detail || i.build.kind}${i.build.pr_url ? ` ${i.build.pr_url}` : ""}`
+								: ""
+						}${i.message && i.outcome !== "started" ? `\n            ${i.message}` : ""}`
+				),
+			].join("\n")
+		: "No run yet.";
+
 async function cmdAdminDemo(ctx) {
 	const { flags, positionals, io } = ctx;
 	const sub = positionals[0];
@@ -7071,6 +7088,26 @@ async function cmdAdminDemo(ctx) {
 			printResult(io, flags, result, (r) => readinessLines(r.readiness));
 			return result.readiness?.ok ? 0 : 1;
 		}
+		case "ideas": {
+			// Every Idea on the demo org started for real (run_demo_ideas), or the latest run read (get_demo_ideas_run).
+			const orgId = requirePositional(positionals, 1, "org-id");
+			const path = `${DEMO}/${encodeURIComponent(orgId)}/ideas`;
+			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({
+								scope: flagBool(flags.library) ? "library" : undefined,
+								delivery: flagBool(flags.preview) ? "build" : undefined,
+								force: flagBool(flags.force) || undefined,
+							})
+						);
+			printResult(io, flags, result, (r) => ideasRunLines(r.run));
+			return result.run?.state === "failed" ? 1 : 0;
+		}
 		default:
 			throw new CliError(DEMO_USAGE);
 	}

package/lib/commands/vary.mjs

@@ -1,10 +1,12 @@
 // `vary` — Variationals from a terminal: A/B tests of a page's words and images on your own site
 // (docs/architecture/variationals.md). Thin wrappers over the variationals tools (list_variationals,
-// get_variational, create_variational, update_variational, save_variational_variant,
+// get_variational, create_variational, launch_variational_test, update_variational, save_variational_variant,
 // remove_variational_variant, delete_variational, ship_variational_winner), the same lib functions the app calls.
 //
 //   letterstory vary list [--status running]
 //   letterstory vary create --page https://acme.com/pricing [--name "Pricing headline"] [--goals-file goals.json]
+//   letterstory vary launch [--brief "Test the hero button"] [--page https://acme.com/] [--name <n>]
+//     made, given a challenger Letter writes from the page, and started (Ideas' A/B test row)
 //   letterstory vary get <id>
 //   letterstory vary page <id>          the page's blocks, as a change's tag/before/occurrence
 //   letterstory vary save-variant <id> --deltas-file b.json [--key b] [--name "Shorter headline"]
@@ -74,6 +76,12 @@ export const ARGS = {
 		name: "name",
 		goals: jsonFile("goals-file", "goals"),
 	},
+	launch_variational_test: {
+		brief: "brief",
+		page_url: "page",
+		site_id: "site",
+		name: "name",
+	},
 	ship_variational_winner: {
 		variational_id: variationalId,
 		variant: "variant",
@@ -135,6 +143,12 @@ export async function cmdVary(ctx) {
 		case "create":
 			refuseUnknownFlags(rest, ARGS.create_variational, ["goals-file"]);
 			return varyShow(rest, await call(rest, "create_variational"));
+		case "launch": {
+			refuseUnknownFlags(rest, ARGS.launch_variational_test, []);
+			const result = await call(rest, "launch_variational_test");
+			printResult(rest.io, rest.flags, result, (r) => `${r.message}\n${r.variational.edit_url}`);
+			return 0;
+		}
 		case "update":
 		case "weights":
 		case "goals":
@@ -170,7 +184,7 @@ export async function cmdVary(ctx) {
 		}
 		default:
 			throw new CliError(
-				"Usage: vary [list|get|page|create|update|weights|goals|start|pause|end|save-variant|remove-variant|ship|delete]"
+				"Usage: vary [list|get|page|create|launch|update|weights|goals|start|pause|end|save-variant|remove-variant|ship|delete]"
 			);
 	}
 }

package/package.json

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