@letterstory/cli 0.176.60 → 0.176.62

package/README.md

@@ -139,7 +139,8 @@ Your organization's domains, whatever each is used for, and finding new ones:
 
 ```bash
 letterstory domains                                             # every domain you hold and what it's used for
-letterstory domains scan "nano banana pro"                      # free domains matching what people search (no charge)
+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 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

@@ -85,7 +85,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.60";
+export const VERSION = "0.176.62";
 
 /** 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;
@@ -1897,9 +1897,10 @@ Sim (Simulations: a free, simulated copy of your API for agents, and what they d
 
 Domains (the domains you hold, and free ones that match what people search):
   domains [list]                                       Every domain you hold and what each is used for
-  domains scan "<phrase>" ["<phrase>" …] [--tld com,org,ai] [--expand none|searches|space]
+  domains scan ["<phrase>" …] [--tld com,org,ai] [--expand none|searches|space]
                [--no-modifiers] [--market US] [--limit <n>]
-                                                       Free domains matching what people search, ranked
+                                                       Free .com/.org domains on what people search in your
+                                                       space (brainstormed, or the phrases given), ranked
   domains buy <domain> --dry-run | --yes               The price and whose account pays; --yes buys it
 
 Vary (A/B tests of a page's words and images on your own site):

package/lib/commands/admin.mjs

@@ -5131,6 +5131,8 @@ const RECIPE_FILE_FIELDS = [
 	"weight",
 	"approaches",
 	"reads",
+	// The inputs the fit is told a recipe cannot run without (2026-11-08: left out here, an import never carried them).
+	"requires",
 	"runs",
 	"primitives_access",
 	"immediate",

package/lib/commands/domains.mjs

@@ -3,6 +3,7 @@
 // wrappers over list_domains, scan_domains and register_domain, the same lib functions the app calls.
 //
 //   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 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)
@@ -12,14 +13,9 @@ import { flagCsv, requirePositional, printResult, argsFromFlags } from "./shared
 
 export const ARGS = {
 	list_domains: {},
-	// `domains scan "nano banana pro" ["ai headshots" …]` — each positional is one phrase.
+	// `domains scan "nano banana pro" ["ai headshots" …]` — each positional is one phrase; none brainstorms your space.
 	scan_domains: {
-		phrases: {
-			value: (flags, positionals) => {
-				requirePositional(positionals, 0, "phrase");
-				return positionals;
-			},
-		},
+		phrases: { value: (flags, positionals) => (positionals.length ? positionals : undefined) },
 		// `--tld com,org` or `--tld com --tld org`.
 		tlds: {
 			value: (flags) => {
@@ -79,7 +75,7 @@ async function domainsList(ctx) {
 			(d) =>
 				`${d.domain.padEnd(32)} ${(d.used_for.length ? d.used_for.map((u) => (u === "site" && d.site ? `site (${d.site.name})` : u)).join(", ") : "not yet used").padEnd(28)} ${d.status.padEnd(8)} ${d.registered_on === "org_vercel_key" ? "your Vercel" : d.registered_on === "letter" ? "Letter" : "connected"} ${usd(d.purchase_price_usd)}`
 		);
-		if (!lines.length) lines.push('No domains yet. Find one with: letterstory domains scan "<what people search>"');
+		if (!lines.length) lines.push("No domains yet. Find one with: letterstory domains scan");
 		const g = r.registration;
 		lines.push(
 			"",
@@ -134,13 +130,15 @@ async function domainsScan(ctx) {
 				: p.purchase_usd == null
 					? "not sold here"
 					: `$${p.purchase_usd}${p.purchasable ? "" : " (over cap)"}`;
-		const lines = [`Free domains (${r.available} of ${r.checked} checked, searches in ${r.market}):`];
+		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)}`
 			);
 		}
-		if (!r.domains.length) lines.push("  None free. Try more phrases, --expand space, or more --tld.");
+		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) {

package/package.json

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