@letterstory/cli 0.176.78 → 0.176.80

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.78";
+export const VERSION = "0.176.80";
 
 /** 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;
@@ -274,9 +274,9 @@ export const BOOLEAN_FLAGS = new Set([
 	"resolve",
 	"reopen",
 	"skip",
-	// `phantom-onboard domain` / `admin create-org --onboard` switches.
+	// `phantom-onboard domain` / `admin create-org --onboard` switches. (`--status` is a switch only on
+	// phantom-onboard, SWITCH_FLAGS_BY_COMMAND: everywhere else it takes a value, `--status parked`.)
 	"watch",
-	"status",
 	"no-phantom",
 	"no-visuals",
 	"no-enhance",
@@ -424,6 +424,13 @@ export const BOOLEAN_FLAGS = new Set([
  */
 const VALUE_FLAGS_BY_COMMAND = { automations: new Set(["on"]) };
 
+/**
+ * Flags that are switches on one command and take a value everywhere else. `--status` is "show me the job" on
+ * phantom-onboard (onboard.mjs), and a value on every other (`admin recipes save --status parked`, `admin crm
+ * prospect-orgs --status ready`): as a global switch, `--status parked` dropped "parked" (2026-11-09).
+ */
+export const SWITCH_FLAGS_BY_COMMAND = { "phantom-onboard": new Set(["status"]), onboard: new Set(["status"]) };
+
 /**
  * @param {string[]} argv
  * @returns {{ positionals: string[], flags: Record<string, string | boolean | string[]> }}
@@ -432,6 +439,7 @@ export function parseArgs(argv) {
 	const positionals = [];
 	const flags = {};
 	const valueFlags = VALUE_FLAGS_BY_COMMAND[argv[0]] ?? new Set();
+	const switchFlags = SWITCH_FLAGS_BY_COMMAND[argv[0]] ?? new Set();
 	const setFlag = (name, value) => {
 		if (Object.prototype.hasOwnProperty.call(flags, name)) {
 			flags[name] = [].concat(flags[name], value);
@@ -452,7 +460,12 @@ export function parseArgs(argv) {
 		}
 		const name = tok.slice(2);
 		const next = argv[i + 1];
-		if ((BOOLEAN_FLAGS.has(name) && !valueFlags.has(name)) || next === undefined || next.startsWith("--")) {
+		if (
+			(BOOLEAN_FLAGS.has(name) && !valueFlags.has(name)) ||
+			switchFlags.has(name) ||
+			next === undefined ||
+			next.startsWith("--")
+		) {
 			flags[name] = true;
 		} else {
 			setFlag(name, next);
@@ -648,7 +661,7 @@ Reviewers:
                            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]
+               [--every <n> --unit hours|days|weeks|months] [--facts <a,b>] [--sandbox] [--recipe <id>]
                [--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
@@ -656,7 +669,10 @@ Reviewers:
                                                        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)
+                                                       sandbox (off, Letterpress decides per event); --facts
+                                                       names what each tick carries (merged_changes, page_reads,
+                                                       new_pages_unlinked, striking_queries, losing_pages);
+                                                       --recipe makes a Plan recipe's own
   automate set <automation-id> [--name <n>] [--instruction <text>] [--prompt <text>] [--slack-channel <C…>|none]
                [--sandbox|--no-sandbox] [--backfill all|<YYYY-MM-DD>] [--on|--off] ...
   automate try [<automation-id>] [--trigger <t> --prompt <text> --instruction <text> ...] [--limit <n>]

package/lib/commands/admin.mjs

@@ -5134,6 +5134,10 @@ const RECIPE_FILE_FIELDS = [
 	// The inputs the fit is told a recipe cannot run without (2026-11-08: left out here, an import never carried them).
 	"requires",
 	"runs",
+	// The recurring automation a recipe carries (runs automation:recipe); left out here, an import never reached prod.
+	"automation",
+	// The build's declared tools and scoped writes (left out here, an export dropped them).
+	"tool_access",
 	"primitives_access",
 	"immediate",
 	"status",
@@ -5176,6 +5180,12 @@ function recipeDetail(r) {
 		`  reads:            ${r.reads?.length ? r.reads.join(", ") : "— (not written: every probe runs)"}`,
 		`  status:           ${r.status === "parked" ? `parked${r.needs ? `, needs ${r.needs}` : ""}` : "live"}`,
 		`  runs:             ${r.runs || "one change to the site's code, from its own directions"}`,
+		...(r.automation
+			? [
+					`  automation:       "${r.automation.name}" every ${r.automation.every} ${r.automation.unit}, carrying ${(r.automation.facts ?? []).join(", ") || "no facts"}`,
+					`  its prompt:       ${r.automation.prompt}`,
+				]
+			: []),
 		...(r.primitives_access ? ["  letter's tools:   its build may use them (primitives_access)"] : []),
 		...(r.immediate ? ["  immediate:        a quick win: the Plan puts one in every top three"] : []),
 		...(variations.length > 1

package/lib/commands/automate.mjs

@@ -46,6 +46,8 @@ const triggerParams = {
 		// --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 },
+		// --facts striking_queries,losing_pages: what each tick of a schedule carries, read by Letter before the turn.
+		facts: { flag: "facts", type: "list" },
 	},
 };
 // --sandbox / --no-sandbox: always run the prompt in a Build sandbox (the repo and Letter's tools); off, Letterpress decides per event.
@@ -114,6 +116,8 @@ export const ARGS = {
 	create_event_automation: {
 		destination,
 		template: { flag: "template", enum: TEMPLATES },
+		// --recipe <id>: make the automation a Plan recipe carries (the Plan row's own call).
+		recipe: { flag: "recipe" },
 		name: { flag: "name" },
 		trigger: { flag: "trigger", enum: TRIGGERS },
 		trigger_params: triggerParams,

package/package.json

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