@letterstory/cli 0.177.4 → 0.177.6

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.4";
+export const VERSION = "0.177.6";
 
 /** 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;
@@ -152,6 +152,8 @@ export const BOOLEAN_FLAGS = new Set([
 	// build: repeat an open build's ask; post its progress in the org's Slack channel.
 	"again",
 	"plan-only",
+	// build: the words are a request to build, never read as a question.
+	"build-it",
 	// build: every change reads Letter's tools from its sandbox.
 	"primitives-access",
 	// build list: only Build's Archived tab (--open, already listed, is its Open tab).
@@ -1879,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

@@ -42,6 +42,10 @@ const ARGS = {
 		},
 		// The words after `build`, or --prompt for a longer ask.
 		prompt: { value: (flags, positionals) => flagStr(flags.prompt) ?? (positionals.join(" ").trim() || undefined) },
+		// --ask "<words>": the person's own words, when --prompt was written from them.
+		ask: "ask",
+		// --build-it: the words are a request to build, never read as a question.
+		asked_to_build: { flag: "build-it", type: "bool" },
 		domain: "site",
 		// --subject host/path (repeatable): the pages it is about.
 		subjects: { flag: "subject", type: "list" },
@@ -50,7 +54,7 @@ const ARGS = {
 		files: { value: (_flags, _positionals, extra) => (extra.files?.length ? extra.files : undefined) },
 		delivery: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack", "linear"] },
 		notify_slack: { flag: "notify-slack", type: "bool" },
-		// --primitives-access: every change reads Letter's tools from its sandbox (a read-only MCP key beside the repo).
+		// --primitives-access: its change reads Letter's tools from its sandbox (a read-only MCP key beside the repo).
 		primitives_access: { flag: "primitives-access", type: "bool" },
 		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.
@@ -246,6 +250,8 @@ async function buildStart(ctx) {
 	const { client, flags, io } = ctx;
 	refuseUnknownFlags(ctx, {}, [
 		"prompt",
+		"ask",
+		"build-it",
 		"site",
 		"subject",
 		"recipe",

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/package.json

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