@letterstory/cli 0.176.100 → 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.100";
+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.

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/package.json

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