@letterstory/cli 0.176.44 → 0.176.46

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.46";
 
 /** 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/automate.mjs

@@ -5,7 +5,7 @@
 // Same flag/positional/io conventions as posts.mjs — no commander, no color.
 
 import { CliError } from "../client.mjs";
-import { printResult, ok, argsFromFlags, flagList, refuseUnknownFlags } from "./shared.mjs";
+import { printResult, ok, argsFromFlags, flagList, flagStr, refuseUnknownFlags } from "./shared.mjs";
 
 const TRIGGERS = ["competitor_page", "visitor_identified", "issue_found", "build_suggestion", "plan_update", "custom"];
 const TEMPLATES = [
@@ -74,6 +74,13 @@ function factsOf(flags) {
 }
 
 /** See `argsFromFlags` in shared.mjs; `scripts/parity-check.ts` diffs these keys against the tool. */
+const destination = {
+	value: (flags) => {
+		const v = flagStr(flags.destination);
+		return v === undefined ? undefined : v === "none" ? null : { collection_id: v === "waiting" ? null : v };
+	},
+};
+
 export const ARGS = {
 	describe_automation_options: {},
 	list_event_automations: {},
@@ -81,6 +88,7 @@ export const ARGS = {
 		automation_id: { positional: 0, label: "automation-id", required: true },
 	},
 	create_event_automation: {
+		destination,
 		template: { flag: "template", enum: TEMPLATES },
 		name: { flag: "name" },
 		trigger: { flag: "trigger", enum: TRIGGERS },
@@ -92,6 +100,8 @@ export const ARGS = {
 		backfill,
 	},
 	update_event_automation: {
+		destination,
+		expected_updated_at: "expected-updated-at",
 		automation_id: { positional: 0, label: "automation-id", required: true },
 		name: { flag: "name" },
 		trigger_params: triggerParams,

package/lib/commands/automations.mjs

@@ -86,6 +86,8 @@ export const ARGS = {
 		},
 	},
 	update_automation: {
+		expected_updated_at: "expected-updated-at",
+		expected_source: { value: () => undefined },
 		collection_id: { flag: "collection", required: true },
 		automation_id: { positional: 0, label: "automation-id", required: true },
 		pace_per_week: { flag: "pace", type: "num" },
@@ -116,6 +118,7 @@ export const ARGS = {
 		reason: { flag: "reason" },
 	},
 	delete_automation: {
+		expected_source: { value: () => undefined },
 		collection_id: { flag: "collection", required: true },
 		automation_id: { positional: 0, label: "automation-id", required: true },
 	},
@@ -163,7 +166,15 @@ export async function cmdAutomations(ctx) {
 
 async function run(ctx, tool, said) {
 	const { client, flags, io } = ctx;
-	const result = await client.callTool(tool, argsFromFlags(ARGS[tool], flags, ctx.positionals));
+	const args = argsFromFlags(ARGS[tool], flags, ctx.positionals);
+	if ((tool === "update_automation" || tool === "delete_automation") && args.automation_id?.startsWith("derived:")) {
+		const { automation: a } = await client.callTool("get_automation", {
+			collection_id: args.collection_id,
+			automation_id: args.automation_id,
+		});
+		args.expected_source = { kind: a.kind, cluster_id: a.cluster_id, target_id: a.target_id, seer_id: a.seer_id };
+	}
+	const result = await client.callTool(tool, args);
 	if (said) ok(ctx, said);
 	printResult(io, flags, result);
 	return 0;

package/lib/commands/build.mjs

@@ -21,6 +21,16 @@ import { attachmentUrls, uploadAttachments } from "./repo.mjs";
 
 const ARGS = {
 	start_build: {
+		purpose: {
+			value: (flags) => {
+				if (typeof flags.purpose !== "string") return undefined;
+				try {
+					return JSON.parse(flags.purpose);
+				} catch {
+					throw new CliError("--purpose takes JSON.");
+				}
+			},
+		},
 		// The words after `build`, or --prompt for a longer ask.
 		prompt: { value: (flags, positionals) => flagStr(flags.prompt) ?? (positionals.join(" ").trim() || undefined) },
 		domain: "site",
@@ -59,6 +69,16 @@ const ARGS = {
 		},
 	},
 	send_build_message: {
+		work_context: {
+			value: (flags) => {
+				if (typeof flags["work-context"] !== "string") return undefined;
+				try {
+					return JSON.parse(flags["work-context"]);
+				} catch {
+					throw new CliError("--work-context takes JSON.");
+				}
+			},
+		},
 		message: {
 			value: (flags, positionals) => flagStr(flags.message) ?? (positionals.join(" ").trim() || undefined),
 		},

package/lib/commands/plan.mjs

@@ -17,6 +17,17 @@
 import { CliError } from "../client.mjs";
 import { argsFromFlags, flagStr, printResult, refuseUnknownFlags } from "./shared.mjs";
 
+const jsonFlag = (name) => ({
+	value: (flags) => {
+		const v = flagStr(flags[name]);
+		if (v === undefined) return undefined;
+		try {
+			return JSON.parse(v);
+		} catch {
+			throw new CliError("--" + name + " takes JSON.");
+		}
+	},
+});
 const onOff = (name) => (flags) => {
 	const v = flagStr(flags[name]);
 	if (v === undefined) return undefined;
@@ -26,6 +37,19 @@ const onOff = (name) => (flags) => {
 };
 
 export const ARGS = {
+	list_plan_work_purposes: { resource: jsonFlag("resource"), strategy_id: "strategy" },
+	set_plan_work_purpose: {
+		resource: jsonFlag("resource"),
+		purpose: jsonFlag("purpose"),
+		attached: { value: (flags) => !flags.remove },
+	},
+	get_plan_work: {
+		purpose: jsonFlag("purpose"),
+		section: { flag: "section", enum: ["writing", "watching"] },
+		resource_id: "resource",
+		offset: { flag: "offset", type: "num" },
+		limit: { flag: "limit", type: "num" },
+	},
 	get_auto_plan: { domain: "site" },
 	set_auto_plan: {
 		domain: "site",
@@ -99,6 +123,38 @@ export async function cmdPlan(ctx) {
 	const { client, flags, io } = ctx;
 	const sub = ctx.positionals[0];
 	const rest = ctx.positionals.slice(1);
+	if (sub === "purposes" || sub === "purpose") {
+		const tool = sub === "purposes" ? "list_plan_work_purposes" : "set_plan_work_purpose";
+		refuseUnknownFlags(ctx, ARGS[tool]);
+		const r = await client.callTool(tool, argsFromFlags(ARGS[tool], flags, rest));
+		printResult(
+			io,
+			flags,
+			r,
+			(v) =>
+				v.purposes.map((p) => p.title + " · " + p.resource.type + " " + p.resource.id).join("\n") ||
+				"No goal associations."
+		);
+		return 0;
+	}
+	if (sub === "work") {
+		refuseUnknownFlags(ctx, ARGS.get_plan_work);
+		const result = await client.callTool("get_plan_work", argsFromFlags(ARGS.get_plan_work, flags, rest));
+		printResult(
+			io,
+			flags,
+			result,
+			(r) =>
+				[
+					...r.items.map(
+						(w) => w.title + " · " + w.status_label + "\n  " + (w.attention || w.summary) + "\n  " + w.href
+					),
+					...r.unavailable.map((u) => u.reason),
+					...(r.next_offset !== null ? ["More: plan work --offset " + r.next_offset] : []),
+				].join("\n") || "No ongoing work."
+		);
+		return 0;
+	}
 	if (sub === "auto") {
 		refuseUnknownFlags(ctx, {}, ["site", ...SETTING_FLAGS]);
 		if (rest[0] && !["activate", "disable"].includes(rest[0]))
@@ -210,6 +266,6 @@ export async function cmdPlan(ctx) {
 		throw new CliError('Usage: plan strategy add "<words…>" | plan strategy archive <strategy-id> [--restore]');
 	}
 	throw new CliError(
-		"Usage: plan auto [settings…] | plan pending | plan veto <proposal-id> | plan start <proposal-id> | plan preview | plan later <action-id> | plan later remove <id> | plan strategies | plan strategy add|archive"
+		"Usage: plan work [--section writing|watching] | plan auto [settings…] | plan pending | plan veto <proposal-id> | plan start <proposal-id> | plan preview | plan later <action-id> | plan later remove <id> | plan strategies | plan strategy add|archive"
 	);
 }

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.46",
 	"description": "Spin up and manage Letter phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",