@letterstory/cli 0.176.58 → 0.176.60

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.58";
+export const VERSION = "0.176.60";
 
 /** 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;
@@ -1745,6 +1745,7 @@ Build (a change to your site, or launching what isn't code; the Build box's own
                                                        build reads Done with no PR to merge. --again repeats an open build's ask.
                                                        --new-site: a website of its own, built and hosted (deploy create)
                                                        --look-like a.com,b.com (with --new-site): sites to model its look after
+                                                       --site-name <name> (with --new-site): its name; left out, named after --site
   build talk <words…> [--conversation <id>|--build <id>] [--site <host>] [--harness letterpress-1|claude-code|codex]
              [--repo owner/name] [--action build|build_pr|build_merge]
                                                        One turn of a conversation with Build (questions, follow-ups on a build)
@@ -1955,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/build.mjs

@@ -69,6 +69,8 @@ const ARGS = {
 		new_site: { flag: "new-site", type: "bool" },
 		// --new-site --look-like linear.app,supabase.com: other companies' sites to model its look after.
 		look_like: { value: (flags) => (flagCsv(flags["look-like"]).length ? flagCsv(flags["look-like"]) : undefined) },
+		// --new-site --site-name OLAPdb: the name it keeps; left out, it is named after --site.
+		site_name: "site-name",
 		// --plan-only: answer what it would do and start nothing (--json for the plan to send back).
 		plan_only: { flag: "plan-only", type: "bool" },
 		// --plan-only always plans what it's given, as /plan does: it was asked for by name.

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.58",
+	"version": "0.176.60",
 	"description": "Spin up and manage Letter phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",