@letterstory/cli 0.104.0 → 0.105.0

package/README.md

@@ -817,8 +817,8 @@ here can SEND email or spend money, so they refuse unknown flags instead of igno
 ```bash
 # Mailers
 letterstory mail vercel-key set --token-file - --team team_AbC123   # optional: buy domains on YOUR Vercel team (token on stdin)
-letterstory mail registrant --first-name Dana --last-name Lee --email d@acme.com --phone +1.4155550100 \
-  --address "1 Main St" --city Oakland --state CA --zip 94607 --country US   # WHOIS owner for purchases on that key
+letterstory mail registrant --first-name Dana --last-name Lee --email d@acme.com --phone "(415) 555-0100" \
+  --address "1 Main St" --city Oakland --state CA --zip 94607 --country "United States"   # WHOIS owner; any phone format
 letterstory mailers quote acme-mail.com                      # price it first: nothing is bought
 letterstory mailers launch acme-mail.com --mailer "hello:Hello Team" --forward-to me@acme.com --yes
 letterstory mailers domains                                  # every domain: setup job, mailers, warmup

package/lib/cli.mjs

@@ -60,7 +60,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.104.0";
+export const VERSION = "0.105.0";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value. Every `type: "bool"` flag (and its
@@ -186,6 +186,8 @@ export const BOOLEAN_FLAGS = new Set([
 	"no-postal-address-footer",
 	// `mailers launch … --no-warmup` / `--warmup` / `--consent`: value-less switches.
 	"no-warmup",
+	"move-vercel-key",
+	"keep-vercel-key",
 	"warmup",
 	"consent",
 	"no-redesign",
@@ -1108,6 +1110,9 @@ Mailers (the sending mailboxes):
                                                        Buy or reuse the domain, create mailers, warm them up
                                                        (a net-new domain is a real, auto-renewing purchase)
   mailers domains                                      Every domain you own: mail status, setup job, mailers
+  mailers move <owned-domain-id> --to <org-id> --yes [--keep-vercel-key]
+                                                       Move a domain, its setup and mailers to another org you
+                                                       admin (with this org's Vercel key unless --keep-vercel-key)
   mailers list [--domain <apex>]                       Your mailers + status + daily send limit
   mailers domain <owned-domain-id>                     Provisioning stage, DNS state, mailers on a domain
   mailers messages <mailer-id> [--folder all|inbox|sent] [--limit <n>]
@@ -1129,9 +1134,10 @@ Mail:
   mail vercel-key set (--token <t> | --token-file <path|->) [--team <team_id>]
                                                        Buy and own mail domains on your Vercel account / team
   mail vercel-key remove --yes                         Future purchases go back to Letterstory's account
-  mail registrant --first-name <f> --last-name <l> --email <e> --phone +1.4155551234
-           --address <a> [--address2 <a>] --city <c> --state <s> --zip <z> --country US [--company <c>]
+  mail registrant --first-name <f> --last-name <l> --email <e> --phone "(415) 555-1234"
+           --address <a> [--address2 <a>] --city <c> --state <s> --zip <z> --country "United States" [--company <c>]
                                                        WHOIS registrant for purchases on your Vercel key
+                                                       (any phone format; country as a name or a 2-letter code)
 
 Insights:
   insights summary [--period …] [--part <block>]...    Measure Overview: AI named/cited rates, share of voice, search, targets
@@ -1170,6 +1176,7 @@ The Site (one model of your whole marketing site, keyed by host and path):
 Repo changes (Claude Code edits your repo in a sandbox; the Letterstory GitHub App opens a PR):
   repo repos                                           Repos the Letterstory GitHub App can reach
   repo branches --repo owner/name                      Branches a change can start from (default first)
+  repo prs [--repo owner/name]                         Every open PR (whoever opened it), longest-idle first
   repo suggestions                                     Fixes found and not acted on yet, and how to start each
   repo settings [--action build|build_pr|slack] [--branch <name>|none] [--slack-agent <name|U…>|none]
                 [--slack-channel <C…>|none]

package/lib/commands/outbound.mjs

@@ -394,6 +394,11 @@ export const ARGS = {
 		mail_postal_address: { positional: 0, label: "address", required: true },
 	},
 	list_mail_domains: {},
+	move_mail_domain: {
+		owned_domain_id: { positional: 0, label: "owned-domain-id", required: true },
+		to_org_id: { flag: "to", required: true },
+		move_vercel_key: { flag: "move-vercel-key", type: "bool", negate: "keep-vercel-key" },
+	},
 	quote_mail_domain: {
 		domain: { positional: 0, label: "domain", required: true },
 	},
@@ -693,7 +698,7 @@ async function prospectsColumns(ctx, sub) {
 	}
 }
 
-const MAILERS_USAGE = `Usage: mailers <list|domains|domain|quote|launch|messages|message|forward|warmup|limit|retire|suppressions>`;
+const MAILERS_USAGE = `Usage: mailers <list|domains|domain|quote|launch|move|messages|message|forward|warmup|limit|retire|suppressions>`;
 
 export async function cmdMailers(ctx) {
 	const sub = ctx.positionals[0];
@@ -708,6 +713,21 @@ export async function cmdMailers(ctx) {
 			return run(rest, "get_mailer_domain_status");
 		case "quote":
 			return run(rest, "quote_mail_domain");
+		case "move": {
+			// Re-homes the domain, its mailers and (by default) the org's Vercel key: confirm first.
+			if (!rest.flags.yes) {
+				const id = flagStr(rest.positionals[0]) ?? "<owned-domain-id>";
+				ctx.io.error(
+					`Moving re-homes the domain, its setup and mailers (and this org's Vercel key unless --keep-vercel-key) in the other organization. Re-run with --yes to confirm: ${ctx.bin} mailers move ${id} --to <org-id> --yes`
+				);
+				return 1;
+			}
+			return run(
+				rest,
+				"move_mail_domain",
+				(r) => `Moved ${r?.domain ?? "the domain"} to ${r?.to_org_id ?? "the other organization"}.`
+			);
+		}
 		case "launch": {
 			// A net-new domain is a real purchase, so a launch needs --yes (quote it first).
 			if (!rest.flags.yes) {

package/lib/commands/repo.mjs

@@ -4,6 +4,7 @@
 //   repo list    → list_repo_changes     repo cancel → cancel_repo_change
 //   repo publish → publish_repo_change (Make PR on a preview)
 //   repo repos   → list_github_app_repos  repo branches → list_repo_branches
+//   repo prs     → list_open_pull_requests (every open PR, whoever opened it)
 //   repo install-letterprove → letterprove_open_install_pr
 //   repo suggestions → list_suggested_fixes
 //   repo settings → get_repo_change_settings, or set_repo_change_settings with --action / --branch
@@ -109,6 +110,10 @@ const ARGS = {
 		repo_owner: { value: (flags) => splitRepo(flags).owner },
 		repo_name: { value: (flags) => splitRepo(flags).name },
 	},
+	list_open_pull_requests: {
+		repo_owner: { value: (flags) => (flags.repo === undefined ? undefined : splitRepo(flags).owner) },
+		repo_name: { value: (flags) => (flags.repo === undefined ? undefined : splitRepo(flags).name) },
+	},
 };
 
 const TERMINAL = new Set(["succeeded", "no_changes", "failed", "cancelled"]);
@@ -154,6 +159,8 @@ export async function cmdRepo(ctx) {
 			return repoRepos(rest);
 		case "branches":
 			return repoBranches(rest);
+		case "prs":
+			return repoPrs(rest);
 		case "settings":
 			return repoSettings(rest);
 		case "suggestions":
@@ -164,7 +171,7 @@ export async function cmdRepo(ctx) {
 			return repoSlackTest(rest);
 		default:
 			throw new CliError(
-				`Unknown repo subcommand: ${sub ?? "(none)"}. Try: start, fix-audit, install-letterprove, sites, set-site, reset-site, status, list, publish, cancel, repos, branches, settings, suggestions, slack-targets, slack-test`
+				`Unknown repo subcommand: ${sub ?? "(none)"}. Try: start, fix-audit, install-letterprove, sites, set-site, reset-site, status, list, publish, cancel, repos, branches, prs, settings, suggestions, slack-targets, slack-test`
 			);
 	}
 }
@@ -401,6 +408,24 @@ async function repoRepos(ctx) {
 	return 0;
 }
 
+/** `repo prs [--repo owner/name]`: every open PR, longest-idle first, and which Letterstory opened. */
+async function repoPrs(ctx) {
+	const { client, flags, io } = ctx;
+	refuseUnknownFlags(ctx, {}, ["repo"]);
+	const result = await client.callTool("list_open_pull_requests", argsFromFlags(ARGS.list_open_pull_requests, flags));
+	printResult(io, flags, result, (r) =>
+		r.pullRequests.length === 0
+			? "No open pull requests."
+			: r.pullRequests
+					.map(
+						(p) =>
+							`${p.repo}#${p.number}  ${p.title}  (${p.daysSinceUpdate}d idle${p.draft ? ", draft" : ""}${p.letterRun ? `, Letterstory run ${p.letterRun.status}` : ""})\n  ${p.url}`
+					)
+					.join("\n")
+	);
+	return 0;
+}
+
 /** `repo branches --repo owner/name`: the branches a run can start from, default first. */
 async function repoBranches(ctx) {
 	const { client, flags, io } = ctx;

package/package.json

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