@letterstory/cli 0.176.52 → 0.176.54

package/lib/cli.mjs

@@ -85,7 +85,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.52";
+export const VERSION = "0.176.54";
 
 /** 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;
@@ -117,10 +117,12 @@ export const BOOLEAN_FLAGS = new Set([
 	"keep-key",
 	"delete-key",
 	"keep",
-	// automate add/set: on or off; only identified visitors marked hot leads.
+	// automate add/set: on or off; only identified visitors marked hot leads; run the prompt in a Build sandbox.
 	"on",
 	"off",
 	"hot-leads-only",
+	"sandbox",
+	"no-sandbox",
 	// admin crm prospect-org: start (or retry) the org prepared for the booked call.
 	"start",
 	// site research-builds: run now even when the stored pass is under an hour old.
@@ -136,6 +138,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: 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).
 	"archived",
 	// plan pending --queued: only the rows a person queued for later.
@@ -198,6 +202,8 @@ export const BOOLEAN_FLAGS = new Set([
 	"no-control",
 	"own-beat",
 	"refresh",
+	// ask --more: every row that fits, not only the top ones.
+	"more",
 	"preview",
 	"with-preview",
 	// repo …: the repo is a GitLab project (--repo group/subgroup/project).
@@ -633,17 +639,22 @@ 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|vc_visitors|plan_updates]
-               [--name <n>] [--trigger competitor_page|visitor_identified|issue_found|build_suggestion|plan_update|custom]
+  automate add [--template post_new_issues|fix_new_issues|recommended_actions|competitor_pages|competitor_takes|
+                           icp_visitors|vc_visitors|plan_updates|weekly_release_notes|monthly_page_refresh]
+               [--name <n>] [--trigger competitor_page|visitor_identified|issue_found|build_suggestion|plan_update|custom|schedule]
                [--prompt <what Letterpress does with each event>] [--slack-channel <C…>] [--instruction <which events>]
                [--event <name>] [--kind post|landing] [--competitor <host>] [--site <host>]
+               [--every <n> --unit hours|days|weeks|months] [--sandbox]
                [--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 (--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
+                                                       to --slack-channel with its buttons. --trigger schedule
+                                                       --every 2 --unit weeks is a recurring one (on the calendar:
+                                                       Monday, the 1st); --sandbox always runs its prompt in a Build
+                                                       sandbox (off, Letterpress decides per event)
   automate set <automation-id> [--name <n>] [--instruction <text>] [--prompt <text>] [--slack-channel <C…>|none]
-               [--backfill all|<YYYY-MM-DD>] [--on|--off] ...
+               [--sandbox|--no-sandbox] [--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>]
@@ -1678,17 +1689,17 @@ Mail:
                                                        (any phone format; country as a name or a 2-letter code)
 
 Insights:
-  ask [<words…>] [--outcome geo|seo|…] [--lens fix|build] [--site host]
+  ask [<words…>] [--outcome geo|seo|…] [--more] [--lens fix|build] [--site host]
                                                        Ask Letterpress what to do next: the plan for an outcome (the
                                                        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] [--pace-hours <1-168>]
             [--delivery build|build_pr|build_merge]
-            [--aggression low|medium|high|xhigh] [--goal geo|seo|agent_conviction|inbound_conversion|any]
+            [--aggression low|medium|high|xhigh] [--strategies geo,seo,agent_conviction,inbound_conversion|any]
             [--slack-channel <C…>|none]
                                                        Auto-Plan on a site: Letterpress picks its strategies and builds
-                                                       them (--goal: one goal's strategies, else any); each pick waits --veto-hours for a veto. Settings shown when none given.
+                                                       them under the site's strategies (--strategies, any by default; the Plan reads the same set); 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)
@@ -1726,6 +1737,7 @@ Build (a change to your site, or launching what isn't code; the Build box's own
   build <words…> [--prompt <text>] [--site <host>] [--subject <host/path>]... [--action build|build_pr|build_merge|slack|linear]
              [--attach <path>]... [--attach-url <name>=<https url>]... [--attach-ref <path>]... [--attach-url-ref <name>=<https url>]...
              [--harness letterpress-1|claude-code|codex] [--effort low|medium|high|xhigh] [--notify-slack] [--again] [--new-site]
+             [--primitives-access]
                                                        Build from your words: "add a pricing page" opens a preview or PR;
                                                        "launch a phantom for us", "set up mailers" or "onboard my blog" is
                                                        done by Build itself (a phantom site buys its own domain), and the

package/lib/commands/ask.mjs

@@ -1,7 +1,7 @@
 // `ask` — ask Letterpress, the one door (docs/architecture/one-recipe-engine.md §9b): what should
 // this account do next. The same answer as the console's Plan, Build and Fix tabs and Slack.
 //   ask                              → each list's head: what's broken, what to build
-//   ask --outcome geo|seo|…          → the plan for that outcome (the Plan tab's box)
+//   ask --outcome geo|seo|…          → the plan for that outcome (Ideas filtered to it); --more: every row that fits
 //   ask --strategy <id>              → a typed strategy's next actions (plan strategies)
 //   ask --lens fix | --lens build    → what's broken (most pressing first) | what to build
 //   ask "<words…>"                   → in your own words; what nothing does comes back as unmet
@@ -21,13 +21,15 @@ export const ARGS = {
 		found: "found",
 		// --refresh: decide every strategy again from the facts as they are now (the standing fit is read otherwise).
 		refresh: { flag: "refresh", type: "bool" },
+		// --more: every row that fits, not only the top ones (the Ideas list's Show all).
+		more: { flag: "more", type: "bool" },
 		domain: "site",
 	},
 };
 
 export async function cmdAsk(ctx) {
 	const { client, flags, io } = ctx;
-	refuseUnknownFlags(ctx, {}, ["outcome", "strategy", "lens", "words", "found", "site", "refresh"]);
+	refuseUnknownFlags(ctx, {}, ["outcome", "strategy", "lens", "words", "found", "site", "refresh", "more"]);
 	const args = argsFromFlags(ARGS.ask_letterpress, flags, ctx.positionals, {});
 	if ([args.outcome, args.strategy_id, args.lens, args.words].filter(Boolean).length > 1)
 		throw new CliError("One ask at a time: --outcome, --strategy <id>, --lens fix|build, or your words.");

package/lib/commands/automate.mjs

@@ -7,15 +7,28 @@
 import { CliError } from "../client.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 TRIGGERS = [
+	"competitor_page",
+	"visitor_identified",
+	"issue_found",
+	"build_suggestion",
+	"plan_update",
+	"custom",
+	"schedule",
+];
 const TEMPLATES = [
 	"post_new_issues",
+	"fix_new_issues",
 	"recommended_actions",
 	"competitor_pages",
+	"competitor_takes",
 	"icp_visitors",
 	"vc_visitors",
 	"plan_updates",
+	"weekly_release_notes",
+	"monthly_page_refresh",
 ];
+const UNITS = ["hours", "days", "weeks", "months"];
 const STATUSES = ["pending", "proposed", "acting", "acted", "skipped", "failed", "rejected"];
 
 const triggerParams = {
@@ -26,8 +39,15 @@ const triggerParams = {
 		hot_leads_only: { flag: "hot-leads-only", type: "bool" },
 		event: { flag: "event" },
 		per_day: { flag: "per-day", type: "num" },
+		// --trigger schedule --every 2 --unit weeks: a recurring automation, on the calendar (Monday, the 1st).
+		every: { flag: "every", type: "num" },
+		unit: { flag: "unit", enum: UNITS },
 	},
 };
+// --sandbox / --no-sandbox: always run the prompt in a Build sandbox (the repo and Letter's tools); off, Letterpress decides per event.
+const sandbox = {
+	value: (flags) => (flags["no-sandbox"] === true ? false : flags.sandbox === true ? true : undefined),
+};
 // --slack-channel C0123ABCD (repo slack-targets), or none to post nothing.
 const slackChannel = {
 	value: (flags) =>
@@ -96,6 +116,7 @@ export const ARGS = {
 		instruction: { flag: "instruction" },
 		prompt: { flag: "prompt" },
 		slack_channel: slackChannel,
+		sandbox,
 		enabled,
 		backfill,
 	},
@@ -108,6 +129,7 @@ export const ARGS = {
 		instruction: { flag: "instruction" },
 		prompt: { flag: "prompt" },
 		slack_channel: slackChannel,
+		sandbox,
 		enabled,
 		backfill,
 	},

package/lib/commands/build.mjs

@@ -50,6 +50,8 @@ 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: { 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.
 		base_branch: "branch",

package/lib/commands/plan.mjs

@@ -2,7 +2,7 @@
 // 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] [--pace-hours <1-168>] [--delivery build|build_pr|build_merge]
-//             [--aggression low|medium|high|xhigh] [--goal geo|seo|agent_conviction|inbound_conversion|any]
+//             [--aggression low|medium|high|xhigh] [--strategies geo,seo|any]
 //             [--slack-channel <C…>|none]  → set_auto_plan
 //   plan pending                               → list_auto_plan_proposals (status pending)
 //   plan veto <proposal-id>                    → veto_auto_plan_proposal
@@ -67,15 +67,23 @@ export const ARGS = {
 		// How far each pick goes: a preview, a pull request, or one merged once ready.
 		delivery: { flag: "delivery", enum: ["build", "build_pr", "build_merge"] },
 		aggression: { flag: "aggression", enum: ["low", "medium", "high", "xhigh"] },
-		// --goal geo picks strategies for that goal only; --goal any (the default) reads every strategy.
-		goal: {
+		// --strategies geo,seo: the site's strategies (what the Plan reads under, what Auto-Plan picks from), replaced
+		// whole; --strategies any (or none) reads every strategy.
+		strategies: {
 			value: (flags) => {
-				const v = flagStr(flags.goal);
+				const v = flagStr(flags.strategies);
 				if (v === undefined) return undefined;
-				if (v === "any") return null;
-				if (!["agent_conviction", "geo", "seo", "inbound_conversion"].includes(v))
-					throw new CliError("--goal takes agent_conviction, geo, seo, inbound_conversion, or any.");
-				return v;
+				if (v === "any" || v === "") return [];
+				const list = v
+					.split(",")
+					.map((x) => x.trim())
+					.filter(Boolean);
+				for (const g of list)
+					if (!["agent_conviction", "geo", "seo", "inbound_conversion"].includes(g))
+						throw new CliError(
+							"--strategies takes agent_conviction, geo, seo, inbound_conversion (comma-separated), or any."
+						);
+				return list;
 			},
 		},
 		slack_channel: {

package/package.json

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