@letterstory/cli 0.176.59 → 0.176.61

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.59";
+export const VERSION = "0.176.61";
 
 /** 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;
@@ -1956,7 +1956,7 @@ Bench (Benches: open-source benchmarks on their own domains, kept running; @lett
   bench replicate <id>                                 REPLICATE.md: how an agent reproduces the results
 
 Replicate (the Replicator: a website rebuilt as a native Next.js repo, page for page; @letterstory.com only):
-  replicate <https://site> [--max-pages <n>] [--repo-name <r>] [--repo-owner <o>]
+  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 show <id> [--failing]                      Pages with their routes and pixel match; collections; events

package/lib/commands/admin.mjs

@@ -5131,6 +5131,8 @@ const RECIPE_FILE_FIELDS = [
 	"weight",
 	"approaches",
 	"reads",
+	// The inputs the fit is told a recipe cannot run without (2026-11-08: left out here, an import never carried them).
+	"requires",
 	"runs",
 	"primitives_access",
 	"immediate",

package/lib/commands/replicate.mjs

@@ -5,7 +5,7 @@
 // attach_replication_repo, advance_replication, archive_replication), the same lib functions the
 // app calls.
 //
-//   letterstory replicate https://example.com [--max-pages 300] [--repo-name example-site] [--repo-owner <account>]
+//   letterstory replicate https://example.com [--max-pages 300] [--refine-budget 25] [--repo-name example-site] [--repo-owner <account>]
 //   letterstory replicate list
 //   letterstory replicate show <id> [--failing]
 //   letterstory replicate attach <id> <repo-name> [--repo-owner <account>]
@@ -21,6 +21,7 @@ export const ARGS = {
 	create_replication: {
 		url: { positional: 0, label: "url", required: true },
 		max_pages: { flag: "max-pages", type: "num" },
+		refine_budget_usd: { flag: "refine-budget", type: "num" },
 		repo_name: "repo-name",
 		repo_owner: "repo-owner",
 	},
@@ -100,6 +101,12 @@ 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)})`,
 				]
 			: []),
+		...(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`,
+					...(x.agent_pass.refused ? [`  Agent pass stopped: ${x.agent_pass.refused}`] : []),
+				]
+			: []),
 		...(x.media
 			? [
 					`  Media   ${x.media.files} large file${x.media.files === 1 ? "" : "s"} (${(x.media.bytes / 1e6).toFixed(1)} MB) served from Letter's media CDN, not the repo`,
@@ -128,10 +135,19 @@ function replicationDetail(ctx, result) {
 		const lines = headline(r.replication);
 		if (r.pages?.length) {
 			lines.push("", "Pages:");
-			for (const p of r.pages)
+			for (const p of r.pages) {
 				lines.push(
 					`  ${p.passing ? "✓" : "✗"} ${p.path.padEnd(48)} ${p.scores.map((s) => `${s.viewport} ${pct(s.pixel)}`).join("  ")}${p.error ? `  (${p.error})` : ""}`
 				);
+				// Where a page under the bar is off: its worst section at each width.
+				if (!p.passing)
+					for (const s of p.scores) {
+						const worst = [...(s.sections ?? [])].sort((a, b) => a.pixel - b.pixel)[0];
+						if (worst && worst.pixel < 0.995)
+							lines.push(`      ${s.viewport}: "${worst.label}" ${pct(worst.pixel)}`);
+					}
+				if (p.refined) lines.push(`      changed by the agent pass: ${p.refined}`);
+			}
 		}
 		if (r.dropped?.length)
 			lines.push("", `The site's own code left out (needs its builder's runtime): ${r.dropped.length}`);

package/package.json

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