@letterstory/cli 0.176.99 → 0.176.100

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.100";
 
 /** 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;
@@ -1992,6 +1992,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/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.100",
 	"description": "Spin up and manage Letter phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",