@letterstory/cli 0.177.5 → 0.177.7

package/lib/cli.mjs

@@ -87,7 +87,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.177.5";
+export const VERSION = "0.177.7";
 
 /** 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;
@@ -1881,6 +1881,8 @@ The Site (one model of your whole marketing site, keyed by host and path):
   site highlight <domain> [--off]                      Highlight a competitor; its changes lead the top changes
   site prospect <url> [--pages <n>] [--max-pages <n>] [--depth <n>]
                                                        Staff: any company's site, no account: what Fix would list, each PR
+  site suggest <host> --idea <id> | --draft-id <id>... | --pattern <folder> | --item <id> --path <path>
+                                                       Open PR on a suggestion the Site stores, as one job
 
 Repo changes (Claude Code edits your repo in a sandbox; the Letter GitHub App opens a PR):
   repo repos [--gitlab [--search <text>] [--page n]]   Repos the Letter GitHub App can reach (--gitlab: the GitLab

package/lib/commands/build.mjs

@@ -71,6 +71,8 @@ const ARGS = {
 		recipe: "recipe",
 		// Preserve the account-specific task selected by the Plan.
 		fit_run: "fit-run",
+		// --plan-action <id>: a Plan row's account action started as an Idea (blog:post, outbound:campaign, …).
+		action: "plan-action",
 		// --accepted-quote '<json>': the price the Ideas row showed, echoed to accept what it buys.
 		accepted_quote: {
 			value: (flags) => {
@@ -256,6 +258,7 @@ async function buildStart(ctx) {
 		"subject",
 		"recipe",
 		"fit-run",
+		"plan-action",
 		"accepted-quote",
 		"action",
 		"notify-slack",

package/lib/commands/site.mjs

@@ -15,12 +15,14 @@
 //   site competitors         → list_competitor_sites    site watch-competitors [d] → watch_competitor_sites
 //   site highlight <domain> [--off] → set_competitor_highlight
 //   site prospect <url>      → read_prospect_site (staff: any company's site, no account, nothing stored)
+//   site suggest <host> --idea <id> | --draft-id <id>… | --pattern <folder> | --item <id> --path <p> → start_suggestion
 
 import { writeFileSync } from "node:fs";
 
 import { CliError } from "../client.mjs";
 import {
 	argsFromFlags,
+	flagCsv,
 	flagList,
 	flagNum,
 	flagStr,
@@ -193,6 +195,14 @@ const ARGS = {
 		decision: { flag: "decision", required: true, enum: ["accept", "dismiss"] },
 		reason: "reason",
 	},
+	start_suggestion: {
+		domain: { positional: 0, required: true, label: "host" },
+		idea_id: "idea",
+		draft_ids: { value: (flags) => (flagCsv(flags["draft-id"]).length ? flagCsv(flags["draft-id"]) : undefined) },
+		pattern_folder: "pattern",
+		observation_id: "item",
+		path: "path",
+	},
 	fix_site_observations: {
 		host: { positional: 0, required: true, label: "host" },
 		// Every positional after the host, plus --observation <id> (repeatable).
@@ -264,9 +274,11 @@ export async function cmdSite(ctx) {
 			return siteHighlight(rest);
 		case "prospect":
 			return siteProspect(rest);
+		case "suggest":
+			return siteSuggest(rest);
 		default:
 			throw new CliError(
-				`Unknown site subcommand: ${sub ?? "(none)"}. Try: list, map, refresh, unmap, tree, builds, metrics, page, observations, observe, dismiss, families, decide-family, proposals, propose, decide, fix, competitors, watch-competitors, highlight, prospect`
+				`Unknown site subcommand: ${sub ?? "(none)"}. Try: list, map, refresh, unmap, tree, builds, metrics, page, observations, observe, dismiss, families, decide-family, proposals, propose, decide, fix, competitors, watch-competitors, highlight, prospect, suggest`
 			);
 	}
 }
@@ -396,6 +408,24 @@ async function siteMap(ctx) {
 	return 0;
 }
 
+/** A suggestion the Site stores, started as the Site's Open PR does: one job, its words read from what Letter stores. */
+async function siteSuggest(ctx) {
+	const { client, flags, io } = ctx;
+	refuseUnknownFlags(ctx, ARGS.start_suggestion, ["idea", "draft-id", "pattern", "item", "path"]);
+	const args = argsFromFlags(ARGS.start_suggestion, flags, ctx.positionals);
+	const named = [args.idea_id, args.draft_ids, args.pattern_folder, args.observation_id].filter(Boolean).length;
+	if (named !== 1 || (args.observation_id && !args.path))
+		throw new CliError(
+			"Name one suggestion: site suggest <host> --idea <id> | --draft-id <id>… | --pattern <folder> | --item <id> --path <path>"
+		);
+	const result = await client.callTool("start_suggestion", args);
+	printResult(io, flags, result, (r) => {
+		if (r.status !== "started") return r.message ?? r.status;
+		return `Started: ${r.build.title}  (${r.build.id})`;
+	});
+	return 0;
+}
+
 /** Any company's site read as the Site and Fix read a customer's: what Fix would list, and each pull request. */
 async function siteProspect(ctx) {
 	const { client, flags, io } = ctx;

package/lib/commands/vary.mjs

@@ -78,6 +78,9 @@ export const ARGS = {
 	},
 	launch_variational_test: {
 		brief: "brief",
+		// --block "<its words>" --after "<the challenger's>": test exactly these, with no model choosing.
+		block: "block",
+		after: "after",
 		page_url: "page",
 		site_id: "site",
 		name: "name",

package/package.json

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