@letterstory/cli 0.176.44 → 0.176.45

package/lib/cli.mjs

@@ -84,7 +84,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.44";
+export const VERSION = "0.176.45";
 
 /** 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;
@@ -1853,6 +1853,7 @@ Visits (Visitors: AI agents reading your site, and AI answers sending people to
                                                        Pages one agent read that the other didn't
   visits export [--since 30d] [--format json|csv] [--table agent_visits|citations]
   visits sites                                         Your Visitors sites and their install checks
+  visits domain <domain> [--site <id>] [--name <n>]    Move a site to a new domain, keeping its key
   visits pages [--since 28d] [--path '/docs/*'] [--agent <id>] [--limit <n>] [--site <id>]
                                                        People and AI agents per page
   visits health --site <id>                            Staff: how far to trust a site's numbers, each check and its fix

package/lib/commands/visits.mjs

@@ -11,6 +11,7 @@
 //   letterstory visits people --since 30d   people who read the site, and how many were identified
 //   letterstory visits export --since 30d --format csv
 //   letterstory visits sites
+//   letterstory visits domain composal.com [--site <id>]   move the site to a new domain, keeping its key
 //   letterstory visits pages --since 28d [--path '/docs/*'] [--agent openai-crawler]
 //   letterstory visits health --site <id>   staff: how far to trust a site's numbers, and what to fix
 //   letterstory visits connect vercel|cloudflare   send the host's request logs (no code to deploy)
@@ -26,6 +27,11 @@ const days = { value: (flags) => sinceDays(flags.since) };
 
 export const ARGS = {
 	visitors_list_sites: {},
+	visitors_update_site: {
+		site_id: "site",
+		domain: { positional: 0, label: "new domain (e.g. acme.com)", required: true },
+		name: "name",
+	},
 	visitors_get_agent_visits: {
 		site_id: "site",
 		days,
@@ -99,6 +105,8 @@ export async function cmdVisits(ctx) {
 			return visitsExport(rest);
 		case "sites":
 			return visitsSites(rest);
+		case "domain":
+			return visitsDomain(rest);
 		case "pages":
 			return visitsPages(rest);
 		case "health":
@@ -111,7 +119,7 @@ export async function cmdVisits(ctx) {
 			return visitsDisconnect(rest);
 		default:
 			throw new CliError(
-				"Usage: visits [list|citations|people|compare|export|sites|pages|health|connect|connectors|disconnect]"
+				"Usage: visits [list|citations|people|compare|export|sites|domain|pages|health|connect|connectors|disconnect]"
 			);
 	}
 }
@@ -359,6 +367,25 @@ async function visitsPages(ctx) {
 	return 0;
 }
 
+async function visitsDomain(ctx) {
+	const { flags, io } = ctx;
+	const result = await call(ctx, "visitors_update_site");
+	printResult(io, flags, result, (r) => {
+		const domain = r.site?.domain ?? "";
+		if (!r.changed) return `Already on ${domain}.`;
+		const check = r.verification;
+		return [
+			`Moved ${r.previous_domain ?? "the site"} to ${domain}; the key stays ${r.site?.key ?? ""}.`,
+			check
+				? check.found
+					? `Proven: the script was found on ${check.checked_url ?? domain}.`
+					: `Not proven yet: ${check.reason}`
+				: "Same site: its proof carried over.",
+		].join("\n");
+	});
+	return 0;
+}
+
 async function visitsSites(ctx) {
 	const { flags, io } = ctx;
 	const result = await call(ctx, "visitors_list_sites");

package/package.json

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