@letterstory/cli 0.176.100 → 0.176.102

package/README.md

@@ -144,6 +144,7 @@ letterstory domains                                             # every domain y
 letterstory domains scan                                        # brainstorms the searches in your space, free .com/.org (no charge)
 letterstory domains scan "nano banana pro"                      # or the phrases you give
 letterstory domains scan "nano banana pro" --tld com,org,ai,xyz --expand space
+letterstory domains scan --domain olapdatabase.com              # whether a domain you have in mind is free
 letterstory domains buy nanobananaprofree.com --dry-run         # the price and whose account pays
 letterstory domains buy nanobananaprofree.com --yes             # buys it (spends money; domains:write)
 ```

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.102";
 
 /** 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.
@@ -1981,6 +1983,7 @@ Domains (the domains you hold, and free ones that match what people search):
                [--no-modifiers] [--market US] [--limit <n>]
                                                        Free .com/.org domains on what people search in your
                                                        space (brainstormed, or the phrases given), ranked
+  domains scan --domain <domain> [--domain …]          Whether each domain is free (a bare name: .com and .org)
   domains buy <domain> --dry-run | --yes               The price and whose account pays; --yes buys it
   domains plan <domain> [--phrase "<search>"] [--searches <n>] [--version <version>] [--no-write]
                                                        The most strategic site for the domain, every version

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/domains.mjs

@@ -5,6 +5,7 @@
 //   letterstory domains [list]
 //   letterstory domains scan                          brainstorms the searches in your space, checks .com and .org
 //   letterstory domains scan "nano banana pro" ["ai headshots" …] [--tld com,org,ai] [--expand none|searches|space]
+//   letterstory domains scan --domain olapdatabase.com [--domain …]   whether each is free (a bare name: .com and .org)
 //   letterstory domains buy nanobananaprofree.com --dry-run     the price and whose account pays; buys nothing
 //   letterstory domains buy nanobananaprofree.com --yes          buys it (spends money; domains:write)
 //   letterstory domains plan bestaidatalabs.com [--phrase "best ai data labs"] [--searches 880] [--version comparison]
@@ -22,6 +23,13 @@ export const ARGS = {
 	// `domains scan "nano banana pro" ["ai headshots" …]` — each positional is one phrase; none brainstorms your space.
 	scan_domains: {
 		phrases: { value: (flags, positionals) => (positionals.length ? positionals : undefined) },
+		// `--domain olapdatabase.com` (repeatable or comma-separated): checked as it is; alone, it is only that check.
+		domains: {
+			value: (flags) => {
+				const domains = flagCsv(flags.domain).map(stripScheme);
+				return domains.length ? domains : undefined;
+			},
+		},
 		// `--tld com,org` or `--tld com --tld org`.
 		tlds: {
 			value: (flags) => {
@@ -205,6 +213,7 @@ async function domainsLaunch(ctx) {
 }
 
 const STATUS_MARK = { available: "free", taken: "·", unknown: "?", unchecked: " " };
+const NAMED_MARK = { available: "free", taken: "taken", unknown: "?" };
 
 async function domainsScan(ctx) {
 	const { client, flags, io } = ctx;
@@ -218,20 +227,34 @@ async function domainsScan(ctx) {
 					? "not sold here"
 					: `$${p.purchase_usd}${p.purchasable ? "" : " (over cap)"}`;
 		const lines = [];
-		if (r.space) lines.push(`Searches brainstormed for your space: ${r.space}`);
-		lines.push(`Free domains (${r.available} of ${r.checked} checked, searches in ${r.market}):`);
-		for (const d of r.domains) {
-			lines.push(
-				`  ${String(d.score).padStart(5)}  ${d.domain.padEnd(32)} ${d.match.padEnd(8)} ${searches(d.monthly_searches).padStart(8)}/mo  ${d.phrase}  ${price(d.price)}`
-			);
+		const named = r.named ?? [];
+		if (named.length) {
+			const rows = new Map(r.domains.map((d) => [d.domain, d]));
+			lines.push("Domains you named:");
+			for (const n of named) {
+				lines.push(
+					`  ${NAMED_MARK[n.status].padEnd(6)} ${n.domain.padEnd(32)} ${price(rows.get(n.domain)?.price)}`.trimEnd()
+				);
+			}
 		}
-		if (!r.domains.length) lines.push("  None free. Try phrases of your own, --expand space, or more --tld.");
-		lines.push("", `Exact match on each TLD (free / · taken):`);
-		lines.push(`  ${"".padEnd(30)} ${"searches".padStart(8)}  ${r.tlds.map((t) => t.padEnd(5)).join("")}`);
-		for (const row of r.coverage) {
-			lines.push(
-				`  ${row.phrase.slice(0, 30).padEnd(30)} ${searches(row.monthly_searches).padStart(8)}  ${row.cells.map((c) => STATUS_MARK[c.status].padEnd(5)).join("")}`
-			);
+		// Named alone, the check is the whole answer: there was no scan of searches to print.
+		if (!named.length || r.phrases.length) {
+			if (named.length) lines.push("");
+			if (r.space) lines.push(`Searches brainstormed for your space: ${r.space}`);
+			lines.push(`Free domains (${r.available} of ${r.checked} checked, searches in ${r.market}):`);
+			for (const d of r.domains) {
+				lines.push(
+					`  ${String(d.score).padStart(5)}  ${d.domain.padEnd(32)} ${d.match.padEnd(8)} ${searches(d.monthly_searches).padStart(8)}/mo  ${d.phrase}  ${price(d.price)}`
+				);
+			}
+			if (!r.domains.length) lines.push("  None free. Try phrases of your own, --expand space, or more --tld.");
+			lines.push("", `Exact match on each TLD (free / · taken):`);
+			lines.push(`  ${"".padEnd(30)} ${"searches".padStart(8)}  ${r.tlds.map((t) => t.padEnd(5)).join("")}`);
+			for (const row of r.coverage) {
+				lines.push(
+					`  ${row.phrase.slice(0, 30).padEnd(30)} ${searches(row.monthly_searches).padStart(8)}  ${row.cells.map((c) => STATUS_MARK[c.status].padEnd(5)).join("")}`
+				);
+			}
 		}
 		for (const note of r.notes) lines.push(`Note: ${note}`);
 		return lines.join("\n");

package/package.json

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