@letterstory/cli 0.176.39 → 0.176.41

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.39";
+export const VERSION = "0.176.41";
 
 /** 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>]
@@ -1670,7 +1673,7 @@ Insights:
                                                        Plan tab's box), what's broken (--lens fix, most pressing
                                                        first), what to build (--lens build), or your own words. Nothing asked:
                                                        each list's head. The same answer as the console and Slack.
-  plan auto [activate|disable] [--site host] [--veto-hours <1-168>|off] [--auto-merge on|off]
+  plan auto [activate|disable] [--site host] [--veto-hours <1-168>|off] [--pace-hours <1-168>] [--auto-merge on|off]
             [--aggression low|medium|high|xhigh] [--goal geo|seo|agent_conviction|inbound_conversion|any]
             [--slack-channel <C…>|none]
                                                        Auto-Plan on a site: Letterpress picks its strategies and builds
@@ -1725,7 +1728,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

@@ -1,7 +1,7 @@
 // `plan` — Auto-Plan on one site (Plan → Auto-Plan; Plan is scoped to one website, --site, else the
 // organization's own domain). The same calls as the Plan's modal and its sidebar's Pending rows.
 //   plan auto                                  → get_auto_plan
-//   plan auto [activate|disable] [--veto-hours <1-168>|off] [--auto-merge on|off]
+//   plan auto [activate|disable] [--veto-hours <1-168>|off] [--pace-hours <1-168>] [--auto-merge on|off]
 //             [--aggression low|medium|high|xhigh] [--goal geo|seo|agent_conviction|inbound_conversion|any]
 //             [--slack-channel <C…>|none]  → set_auto_plan
 //   plan pending                               → list_auto_plan_proposals (status pending)
@@ -43,6 +43,8 @@ export const ARGS = {
 				return n;
 			},
 		},
+		// --pace-hours <1-168> how often it picks the next action (1 every hour, 24 every day, 168 every week).
+		pace_hours: { flag: "pace-hours", type: "num" },
 		merge: { value: onOff("auto-merge") },
 		aggression: { flag: "aggression", enum: ["low", "medium", "high", "xhigh"] },
 		// --goal geo picks strategies for that goal only; --goal any (the default) reads every strategy.
@@ -87,7 +89,7 @@ export const ARGS = {
 	},
 };
 
-const SETTING_FLAGS = ["veto-hours", "auto-merge", "aggression", "goal", "slack-channel"];
+const SETTING_FLAGS = ["veto-hours", "pace-hours", "auto-merge", "aggression", "goal", "slack-channel"];
 
 export async function cmdPlan(ctx) {
 	const { client, flags, io } = ctx;

package/package.json

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