@letterstory/cli 0.176.67 → 0.176.69

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.67";
+export const VERSION = "0.176.69";
 
 /** 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;
@@ -1970,11 +1970,13 @@ Bench (Benches: open-source benchmarks on their own domains, kept running; @lett
 Replicate (the Replicator: a website rebuilt as a native Next.js repo, page for page; @letterstory.com only):
   replicate <https://site> [--max-pages <n>] [--refine-budget <usd>] [--repo-name <r>] [--repo-owner <o>]
                                                        Capture every page, rebuild it, compare it pixel by pixel
-  replicate [list]                                     Your replications: stage, how closely each matches
+  replicate [list]                                     Your replications: stage, how closely each matches, preview link
   replicate show <id> [--failing]                      Pages with their routes and pixel match; collections; events
   replicate attach <id> <repo-name> [--repo-owner <o>] The repo to commit it into (yours; Letter never creates it)
-  replicate advance <id> [--retry] [--again]           Move it on now; --retry once blocked_on is done; --again replicates from the start
-  replicate archive <id>                               Stop it; the project stays in storage and in the repo
+  replicate advance <id> [--retry] [--again] [--preview]
+                                                       Move it on now; --retry once blocked_on is done; --again replicates from the start;
+                                                       --preview deploys its staging link again
+  replicate archive <id>                               Stop it and take its preview down; the project stays in storage and in the repo
 
 Evals (how the pipeline is doing on your posts, and the regression cases captured from them):
   evals scoreboard [--collection <id>] [--days N]      Every measure by stage: posts, failing, rate
@@ -2146,7 +2148,13 @@ export async function run(argv, io = defaultIo()) {
 	}
 
 	try {
-		const config = resolveConfig({ url: str(flags.url), key: str(flags.key) });
+		// A subcommand that declares its own `--key`/`--url` (`automate send --key <event id> --url <page>`) keeps them;
+		// they never become the API key or the API's URL (2026-11-08 E2E: a 401 and a "path not found").
+		const owns = handler.ownFlags?.(positionals[1]) ?? [];
+		const config = resolveConfig({
+			url: owns.includes("url") ? undefined : str(flags.url),
+			key: owns.includes("key") ? undefined : str(flags.key),
+		});
 		// A silent refresh mid-command should persist the new tokens so the next
 		// invocation doesn't have to refresh again — but only when the config we
 		// resolved actually came from a saved OAuth session (a --key/env override

package/lib/commands/automate.mjs

@@ -31,7 +31,7 @@ const TEMPLATES = [
 	"monthly_page_refresh",
 ];
 const UNITS = ["hours", "days", "weeks", "months"];
-const STATUSES = ["pending", "proposed", "acting", "acted", "skipped", "failed", "rejected"];
+const STATUSES = ["pending", "proposed", "acting", "acted", "answered", "skipped", "failed", "rejected"];
 
 const triggerParams = {
 	object: {
@@ -211,6 +211,9 @@ export async function cmdAutomate(ctx) {
 	}
 }
 
+/** The global flags a subcommand reads as its own arguments, so the CLI never takes them as its key or URL. */
+cmdAutomate.ownFlags = (sub) => (sub === "send" ? ["key", "url"] : []);
+
 async function run(ctx, tool, said, extra = {}) {
 	const { client, flags, io } = ctx;
 	const result = await client.callTool(tool, { ...argsFromFlags(ARGS[tool], flags, ctx.positionals), ...extra });

package/lib/commands/replicate.mjs

@@ -9,7 +9,7 @@
 //   letterstory replicate list
 //   letterstory replicate show <id> [--failing]
 //   letterstory replicate attach <id> <repo-name> [--repo-owner <account>]
-//   letterstory replicate advance <id> [--retry] [--again]
+//   letterstory replicate advance <id> [--retry] [--again] [--preview]
 //   letterstory replicate archive <id>
 
 import { CliError } from "../client.mjs";
@@ -39,6 +39,7 @@ export const ARGS = {
 		replication_id: replicationId,
 		retry: { flag: "retry", type: "bool" },
 		again: { flag: "again", type: "bool" },
+		preview: { flag: "preview", type: "bool" },
 	},
 	archive_replication: { replication_id: replicationId },
 };
@@ -88,7 +89,7 @@ async function replicationList(ctx) {
 						x.summary
 							? `${x.summary.passing}/${x.summary.replicated} pages match, mean ${pct(x.summary.meanPixel)}`
 							: ""
-					}`
+					}${x.staging_url ? `  ${x.staging_url}` : ""}`
 			)
 			.join("\n");
 	});
@@ -100,6 +101,7 @@ function headline(x) {
 		`${x.host} — ${x.status}, stage ${x.stage}`,
 		...(x.blocked_on ? [`  Blocked: ${x.blocked_on}`, `  Then: replicate advance ${x.id} --retry`] : []),
 		...(x.stage_note && !x.blocked_on ? [`  ${x.stage_note}`] : []),
+		...previewLines(x),
 		...(x.summary
 			? [
 					`  ${x.summary.replicated} of ${x.summary.pages} pages replicated; ${x.summary.passing} match the original at every width (mean ${pct(x.summary.meanPixel)})`,
@@ -129,6 +131,25 @@ function headline(x) {
 	];
 }
 
+// The staging link: the replica live on a Letter domain, to share before (or without) a repo.
+function previewLines(x) {
+	if (x.staging_url)
+		return [
+			`  Preview ${x.staging_url}${x.staging_state === "deploying" || x.staging_state === "pending" ? " (redeploying)" : ""}`,
+			...(x.staging_state === "failed" && x.staging_error
+				? [`  Preview redeploy failed: ${x.staging_error}`]
+				: []),
+		];
+	if (x.staging_state === "pending" || x.staging_state === "deploying") return ["  Preview deploying…"];
+	if (x.staging_state === "failed")
+		return [
+			`  Preview failed: ${x.staging_error ?? "no reason given"}`,
+			`  Then: replicate advance ${x.id} --preview`,
+		];
+	if (x.can_deploy_staging && !x.staging_state) return [`  No preview yet: replicate advance ${x.id} --preview`];
+	return [];
+}
+
 function replicationShow(ctx, result) {
 	printResult(ctx.io, ctx.flags, result, (r) => headline(r.replication).join("\n"));
 	return 0;

package/package.json

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