@letterstory/cli 0.176.40 → 0.176.42

package/lib/cli.mjs

@@ -83,7 +83,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.40";
+export const VERSION = "0.176.42";
 
 /** 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;
@@ -94,6 +94,8 @@ export const EXIT_PAYMENT_REQUIRED = 3;
 export const BOOLEAN_FLAGS = new Set([
 	// build list: also move the builds' open changes along while polling.
 	"advance",
+	// build list: only what the Plan started.
+	"from-plan",
 	// build: a website or app of its own (deploy create's path). deploy create: hold until its build starts.
 	"new-site",
 	"wait",
@@ -625,16 +627,17 @@ Reviewers:
   automate list                                        Your automations: an event, which ones it acts on,
                                                        and what Letterpress then does
   automate show <automation-id>
-  automate add [--template post_new_issues|recommended_actions|competitor_pages|icp_visitors|plan_updates]
+  automate add [--template post_new_issues|recommended_actions|competitor_pages|icp_visitors|vc_visitors|plan_updates]
                [--name <n>] [--trigger competitor_page|visitor_identified|issue_found|build_suggestion|plan_update|custom]
                [--prompt <what Letterpress does with each event>] [--slack-channel <C…>] [--instruction <which events>]
                [--event <name>] [--kind post|landing] [--competitor <host>] [--site <host>]
-               [--hot-leads-only] [--per-day <n>] [--off]
+               [--hot-leads-only] [--per-day <n>] [--backfill all|<YYYY-MM-DD>] [--off]
                                                        Make one (a template fills what you leave out): it starts
-                                                       from now, acts on its own, and posts each event it acts on
+                                                       from now (--backfill also runs it on past events, oldest
+                                                       first), acts on its own, and posts each event it acts on
                                                        to --slack-channel with its buttons
   automate set <automation-id> [--name <n>] [--instruction <text>] [--prompt <text>] [--slack-channel <C…>|none]
-               [--on|--off] ...
+               [--backfill all|<YYYY-MM-DD>] [--on|--off] ...
   automate try [<automation-id>] [--trigger <t> --prompt <text> --instruction <text> ...] [--limit <n>]
                                                        What it would do with the latest events (acts on none)
   automate runs [--automation <id>] [--status acting|acted|skipped|failed|proposed|rejected] [--limit <n>]
@@ -1677,6 +1680,8 @@ Insights:
                                                        them (--goal: one goal's strategies, else any); each pick waits --veto-hours for a veto. Settings shown when none given.
   plan pending [--site host]                           What Auto-Plan picked and is waiting to build
   plan veto <proposal-id>                              Veto one: it is never built
+  plan start <proposal-id>                             Start one now (a Needs you pick, or one waiting out its review window)
+  plan preview [--site host]                           What Auto-Plan would do first, before it is on
   plan later <action-id> [--outcome geo|…] [--site host]  Queue a Plan row for later: Auto-Plan starts it once it's ready
   plan later remove <queued-id>                        Take a queued row back off
   plan strategies [--site host] [--archived]           The goals typed on the Plan, each a strategy
@@ -1725,7 +1730,7 @@ Build (a change to your site, or launching what isn't code; the Build box's own
                                                        Staff only. The same prompt on Letterpress-1 (as Build runs it) and on
                                                        stock Claude Code and stock Codex, each a preview to compare
   build benchmarks [--id <uuid>] [--limit <n>]          Staff only. Benchmarks, each arm's state, preview, cost and agent time
-  build list [--limit <n>] [--site <host>] [--kind build|fix] [--open|--archived]
+  build list [--limit <n>] [--site <host>] [--kind build|fix] [--open|--archived] [--from-plan]
                                                        Your builds, newest first, with where each stands
   build status <build-id>                              One build: each change's state, its preview and pull request
   build follow <build-id> [--json]                     What its agents do, line by line, until nothing in it is at

package/lib/commands/automate.mjs

@@ -8,7 +8,14 @@ import { CliError } from "../client.mjs";
 import { printResult, ok, argsFromFlags, flagList, refuseUnknownFlags } from "./shared.mjs";
 
 const TRIGGERS = ["competitor_page", "visitor_identified", "issue_found", "build_suggestion", "plan_update", "custom"];
-const TEMPLATES = ["post_new_issues", "recommended_actions", "competitor_pages", "icp_visitors", "plan_updates"];
+const TEMPLATES = [
+	"post_new_issues",
+	"recommended_actions",
+	"competitor_pages",
+	"icp_visitors",
+	"vc_visitors",
+	"plan_updates",
+];
 const STATUSES = ["pending", "proposed", "acting", "acted", "skipped", "failed", "rejected"];
 
 const triggerParams = {
@@ -31,6 +38,19 @@ const slackChannel = {
 				: String(flags["slack-channel"]),
 };
 const enabled = { value: (flags) => (flags.off === true ? false : flags.on === true ? true : undefined) };
+// --backfill all (the whole history the trigger's source keeps) or --backfill 2026-09-01 (from that day):
+// also run it on past events, oldest first.
+const backfill = {
+	value: (flags) => {
+		const v = flags.backfill;
+		if (v === undefined) return undefined;
+		if (v === true || v === "all") return "all";
+		const day = String(v);
+		if (!/^\d{4}-\d{2}-\d{2}$/.test(day))
+			throw new CliError(`--backfill takes all or a day (YYYY-MM-DD), got: ${day}`);
+		return { since: `${day}T00:00:00Z` };
+	},
+};
 
 /** --fact plan=team --fact seats=40 → { plan: "team", seats: 40 } (numbers and true/false read as such). */
 function factsOf(flags) {
@@ -69,6 +89,7 @@ export const ARGS = {
 		prompt: { flag: "prompt" },
 		slack_channel: slackChannel,
 		enabled,
+		backfill,
 	},
 	update_event_automation: {
 		automation_id: { positional: 0, label: "automation-id", required: true },
@@ -78,6 +99,7 @@ export const ARGS = {
 		prompt: { flag: "prompt" },
 		slack_channel: slackChannel,
 		enabled,
+		backfill,
 	},
 	delete_event_automation: {
 		automation_id: { positional: 0, label: "automation-id", required: true },

package/lib/commands/build.mjs

@@ -8,7 +8,7 @@
 //   build benchmark <words…> → start_build_benchmark (staff only: Letterpress-1, stock Claude Code
 //                              and stock Codex on the same prompt, each a preview)
 //   build benchmarks        → list_build_benchmarks (staff only; --id <uuid> for one)
-//   build list              → list_growth_builds  (newest first; --site, --kind, --open/--archived)
+//   build list              → list_growth_builds  (newest first; --site, --kind, --open/--archived, --from-plan)
 //   build status <id>       → list_growth_builds  (one build: its steps, previews and PRs)
 //   build follow <id>       → list_growth_builds (advance) + get_repo_change_activity, until nothing is at work
 //   build conversations     → list_build_conversations
@@ -101,6 +101,8 @@ const ARGS = {
 		archived: { flag: "archived", type: "bool", negate: "open" },
 		// --advance: also move the builds' open changes along while polling (a queued change takes its sandbox, a merge asked for its next step).
 		advance: { flag: "advance", type: "bool" },
+		// --from-plan: only what the Plan started (a strategy's row, Auto-Plan's pick), as the Plan's Actions list shows it.
+		from_plan: { flag: "from-plan", type: "bool" },
 	},
 	list_build_conversations: { limit: { flag: "limit", type: "num" } },
 	get_build_conversation: {
@@ -272,7 +274,7 @@ async function readBuild(client, args) {
 /** `build list`: the organization's builds, newest first. */
 async function buildList(ctx) {
 	const { client, flags, io } = ctx;
-	refuseUnknownFlags(ctx, {}, ["limit", "kind", "site", "archived", "open", "advance"]);
+	refuseUnknownFlags(ctx, {}, ["limit", "kind", "site", "archived", "open", "advance", "from-plan"]);
 	const args = argsFromFlags(ARGS.list_growth_builds, flags, []);
 	const result = await client.callTool("list_growth_builds", args);
 	printResult(io, flags, result, (r) =>

package/lib/commands/plan.mjs

@@ -6,6 +6,8 @@
 //             [--slack-channel <C…>|none]  → set_auto_plan
 //   plan pending                               → list_auto_plan_proposals (status pending)
 //   plan veto <proposal-id>                    → veto_auto_plan_proposal
+//   plan start <proposal-id>                   → start_auto_plan_proposal (a Needs you pick, or one waiting out its review window)
+//   plan preview                               → preview_auto_plan (what Auto-Plan would do first)
 //   plan later <action-id> [--outcome geo|…]   → queue_plan_action (Auto-Plan starts it once it's ready)
 //   plan later remove <queued-id>              → unqueue_plan_action
 //   plan strategies [--archived]               → list_plan_strategies (the goals typed on the Plan)
@@ -78,6 +80,8 @@ export const ARGS = {
 	},
 	unqueue_plan_action: { id: { positional: 0, required: true, label: "queued-id" } },
 	veto_auto_plan_proposal: { id: { positional: 0, required: true, label: "proposal-id" } },
+	start_auto_plan_proposal: { id: { positional: 0, required: true, label: "proposal-id" } },
+	preview_auto_plan: { domain: "site" },
 	list_plan_strategies: { domain: "site", archived: { flag: "archived", type: "bool" } },
 	create_plan_strategy: {
 		domain: "site",
@@ -143,6 +147,25 @@ export async function cmdPlan(ctx) {
 		);
 		return 0;
 	}
+	if (sub === "start") {
+		refuseUnknownFlags(ctx, {}, []);
+		const result = await client.callTool(
+			"start_auto_plan_proposal",
+			argsFromFlags(ARGS.start_auto_plan_proposal, flags, rest)
+		);
+		printResult(io, flags, result, (r) => r.message);
+		return 0;
+	}
+	if (sub === "preview") {
+		refuseUnknownFlags(ctx, {}, ["site"]);
+		const result = await client.callTool("preview_auto_plan", argsFromFlags(ARGS.preview_auto_plan, flags, rest));
+		printResult(io, flags, result, (r) =>
+			[r.message, ...r.picks.map((p) => `  ${p.kind === "pr" ? "opens a PR " : "needs you  "} ${p.title}`)].join(
+				"\n"
+			)
+		);
+		return 0;
+	}
 	if (sub === "veto") {
 		refuseUnknownFlags(ctx, {}, []);
 		const result = await client.callTool(
@@ -187,6 +210,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 later <action-id> | plan later remove <id> | plan strategies | plan strategy add|archive"
+		"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"
 	);
 }

package/package.json

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