@letterstory/cli 0.176.77 → 0.176.79

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.77";
+export const VERSION = "0.176.79";
 
 /** 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;
@@ -648,7 +648,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 +656,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/lib/commands/replicate.mjs

@@ -107,6 +107,7 @@ function headline(x) {
 					`  ${x.summary.replicated} of ${x.summary.pages} pages replicated; ${x.summary.passing} match the original at every width (mean ${pct(x.summary.meanPixel)})`,
 				]
 			: []),
+		...motionLines(x.motion),
 		...(x.agent_pass
 			? [
 					`  Agent pass: ${x.agent_pass.model}, $${x.agent_pass.cost_usd.toFixed(2)} of $${x.agent_pass.budget_usd.toFixed(2)} spent`,
@@ -134,6 +135,24 @@ function headline(x) {
 	];
 }
 
+const TRIGGERS = ["load", "scroll", "hover", "loop"];
+
+// Motion: what moves on the original against the replica, beside the still scores (never the bar).
+function motionLines(m) {
+	if (!m) return [];
+	const found = TRIGGERS.reduce((s, t) => s + m.found[t], 0);
+	const reproduced = TRIGGERS.reduce((s, t) => s + m.reproduced[t], 0);
+	return [
+		`  Motion  ${reproduced} of ${found} animations reproduced (${TRIGGERS.map((t) => `${t} ${m.reproduced[t]}/${m.found[t]}`).join(", ")})${m.mean_score !== null ? `, frames ${pct(m.mean_score)}` : ""}${m.not_measured ? `; ${m.not_measured} page(s) not measured` : ""}`,
+		...m.gaps
+			.slice(0, 8)
+			.map(
+				(g) =>
+					`    ${g.issue}: ${g.trigger} "${g.element}" (${g.what}) on ${g.pages} page${g.pages === 1 ? "" : "s"}, e.g. ${g.example}`
+			),
+	];
+}
+
 // The staging link: the replica live on a Letter domain, to share before (or without) a repo.
 function previewLines(x) {
 	if (x.staging_url)
@@ -175,6 +194,11 @@ function replicationDetail(ctx, result) {
 							lines.push(`      ${s.viewport}: "${worst.label}" ${pct(worst.pixel)}`);
 					}
 				if (p.refined) lines.push(`      changed by the agent pass: ${p.refined}`);
+				if (p.motion?.error) lines.push(`      motion not measured: ${p.motion.error}`);
+				for (const g of p.motion?.gaps ?? [])
+					lines.push(
+						`      motion ${g.viewport} ${g.trigger} ${g.issue}: "${g.element}" ${g.what}${g.score !== null ? ` (${pct(g.score)})` : ""}`
+					);
 			}
 		}
 		if (r.dropped?.length)

package/package.json

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