@letterstory/cli 0.103.2 → 0.104.1

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.103.2";
+export const VERSION = "0.104.1";
 
 // 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
@@ -1172,9 +1178,12 @@ Repo changes (Claude Code edits your repo in a sandbox; the Letterstory GitHub A
   repo branches --repo owner/name                      Branches a change can start from (default 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]
                                                        The org's defaults for every fix: build (preview first),
-                                                       build_pr, or slack (post it for your own agent, tagging
-                                                       --slack-agent), and the branch changes go to
+                                                       build_pr, or slack (post it to --slack-channel for your
+                                                       own agent, tagging --slack-agent), and the branch changes go to
+  repo slack-targets                                   Slack channels and people Send to Slack can use, with ids
+  repo slack-test                                      Post a test into the Send to Slack channel
   repo start --repo <owner/name> --instructions <text>|--instructions-file <path|->
              [--branch <base>] [--attach <path>]... [--attach-url <name>=<https url>]...
              [--action build|build_pr|slack] [--wait]

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

@@ -7,6 +7,7 @@
 //   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
+//   repo slack-targets → list_slack_fix_targets   repo slack-test → send_slack_test_message
 
 import { readFileSync } from "node:fs";
 import { basename } from "node:path";
@@ -81,12 +82,18 @@ const ARGS = {
 	},
 	get_repo_change_settings: {},
 	list_suggested_fixes: {},
+	list_slack_fix_targets: {},
+	send_slack_test_message: {},
 	set_repo_change_settings: {
 		default_action: { flag: "action", enum: ["build", "build_pr", "slack"] },
 		// --branch <name>, or --branch none for each repo's own default.
 		default_branch: { value: (flags) => (flags.branch === "none" ? null : flagStr(flags.branch)) },
 		// --slack-agent Devin (or a U… member id), or --slack-agent none to tag nobody.
 		slack_agent: { value: (flags) => (flags["slack-agent"] === "none" ? null : flagStr(flags["slack-agent"])) },
+		// --slack-channel C0123ABCD (from repo slack-targets), or none for the first linked channel.
+		slack_channel: {
+			value: (flags) => (flags["slack-channel"] === "none" ? null : flagStr(flags["slack-channel"])),
+		},
 	},
 	get_repo_change: { run_id: { positional: 0, required: true, label: "run-id" } },
 	cancel_repo_change: { run_id: { positional: 0, required: true, label: "run-id" } },
@@ -151,9 +158,13 @@ export async function cmdRepo(ctx) {
 			return repoSettings(rest);
 		case "suggestions":
 			return repoSuggestions(rest);
+		case "slack-targets":
+			return repoSlackTargets(rest);
+		case "slack-test":
+			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`
+				`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`
 			);
 	}
 }
@@ -407,8 +418,12 @@ async function repoBranches(ctx) {
  */
 async function repoSettings(ctx) {
 	const { client, flags, io } = ctx;
-	refuseUnknownFlags(ctx, {}, ["action", "branch", "slack-agent"]);
-	const setting = flags.action !== undefined || flags.branch !== undefined || flags["slack-agent"] !== undefined;
+	refuseUnknownFlags(ctx, {}, ["action", "branch", "slack-agent", "slack-channel"]);
+	const setting =
+		flags.action !== undefined ||
+		flags.branch !== undefined ||
+		flags["slack-agent"] !== undefined ||
+		flags["slack-channel"] !== undefined;
 	const result = setting
 		? await client.callTool("set_repo_change_settings", argsFromFlags(ARGS.set_repo_change_settings, flags))
 		: await client.callTool("get_repo_change_settings", {});
@@ -441,4 +456,30 @@ async function repoSuggestions(ctx) {
 	return 0;
 }
 
+/** `repo slack-targets`: the channels and people Send to Slack can use, with their ids. */
+async function repoSlackTargets(ctx) {
+	const { client, flags, io } = ctx;
+	refuseUnknownFlags(ctx, {}, []);
+	const result = await client.callTool("list_slack_fix_targets", {});
+	printResult(io, flags, result, (r) =>
+		[
+			"Channels (repo settings --slack-channel <id>):",
+			...r.channels.map((c) => `  ${c.id}  #${c.name}`),
+			"People (repo settings --slack-agent <id>):",
+			...r.people.map((p) => `  ${p.id}  ${p.name}${p.is_bot ? " (bot)" : ""}`),
+		].join("\n")
+	);
+	return 0;
+}
+
+/** `repo slack-test`: post a test into the Send to Slack channel. */
+async function repoSlackTest(ctx) {
+	const { client, flags, io } = ctx;
+	refuseUnknownFlags(ctx, {}, []);
+	const result = await client.callTool("send_slack_test_message", {});
+	ok(ctx, result.message);
+	printResult(io, flags, result);
+	return 0;
+}
+
 export { ARGS };

package/lib/commands/site.mjs

@@ -128,6 +128,7 @@ const ARGS = {
 		},
 		base_branch: { flag: "base-branch" },
 		preview: { flag: "preview", type: "bool" },
+		action: { flag: "action", enum: ["build", "build_pr", "slack"] },
 	},
 };
 

package/package.json

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