@letterstory/cli 0.176.45 → 0.176.47

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.45";
+export const VERSION = "0.176.47";
 
 /** 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;

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",
@@ -34,6 +44,9 @@ const ARGS = {
 		harness: { flag: "harness", enum: ["letterpress-1", "claude-code", "codex"] },
 		// --branch <name>: where its changes start and its pull requests go; omitted, the branch that builds the site.
 		base_branch: "branch",
+		// --repo owner/name: which repo, when the site is built from more than one. --folder-repo: the one you work in.
+		repo: "repo",
+		folder_repo: "folder-repo",
 		// --effort low|medium|high|xhigh: how hard the coding agent works on each change; omitted, its own default.
 		effort: { flag: "effort", enum: ["low", "medium", "high", "xhigh"] },
 		again: { flag: "again", type: "bool" },
@@ -59,6 +72,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/package.json

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