@letterstory/cli 0.177.28 → 0.177.30

package/lib/cli.mjs

@@ -88,7 +88,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.177.28";
+export const VERSION = "0.177.30";
 
 /** 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;
@@ -242,6 +242,7 @@ export const BOOLEAN_FLAGS = new Set([
 	"more",
 	"preview",
 	"keep-preview",
+	"sample-banner",
 	"with-preview",
 	// repo …: the repo is a GitLab project (--repo group/subgroup/project).
 	"gitlab",
@@ -2098,7 +2099,9 @@ Models (your own writing models, each trained on writing you give it so it write
   models remove <id> <link-id>…                        Take links out of the next version
   models train <id> [--retry]                          Train the next version, or try a stopped one again
   models stop <id>                                     Stop what is training; what it spent is charged
-  models write <id> "<what to write>" [--words <n>]    Write with its trained version
+  models rewrite <id> "<source text>"                 Rewrite supplied prose in its trained voice
+  models compare <id> "<source text>"                 Compare the model with Claude and GPT using examples
+  models write <id> "<what to write>" [--words <n>]    Legacy ask-based generation
   models update <id> [--name <n>] [--budget <usd>] [--description <d>]
   models archive <id> | models restore <id>
 
@@ -2120,13 +2123,13 @@ 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; free, within fair-use limits):
-  replicate <https://site> [--max-pages <n>] [--path <p>]… [--refine-budget <usd>] [--repo-name <r>] [--repo-owner <o>]
+  replicate <https://site> [--max-pages <n>] [--path <p>]… [--sample-banner] [--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, preview link;
                                                        the limits (in progress, pages this month, preview days)
   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] [--preview] [--extend-preview <days>] [--keep-preview]
+  replicate advance <id> [--retry] [--again] [--preview] [--extend-preview <days>] [--keep-preview] [--sample-banner]
                                                        Move it on now; --retry once blocked_on is done (checks the tag or TXT record);
                                                        --again replicates from the start; --preview deploys its staging link again;
                                                        --extend-preview keeps the preview up longer (Letter's team only)

package/lib/commands/models.mjs

@@ -46,6 +46,14 @@ export const ARGS = {
 		urls: { value: rest(1) },
 		train: { flag: "train", type: "bool" },
 	},
+	add_writing_model_texts: {
+		model_id: modelId,
+		documents: {
+			value: (flags, positionals) => [
+				{ title: flagStr(flags.title) ?? "Supplied writing", text: positionals.slice(1).join(" ") },
+			],
+		},
+	},
 	find_writing_model_links: {
 		model_id: modelId,
 		prompt: { value: (flags, positionals) => positionals.slice(1).join(" ").trim() || undefined },
@@ -60,6 +68,14 @@ export const ARGS = {
 	remove_writing_model_links: { model_id: modelId, source_ids: { value: rest(1) } },
 	train_writing_model: { model_id: modelId, retry: { flag: "retry", type: "bool" } },
 	cancel_writing_model_run: { model_id: modelId },
+	rewrite_with_writing_model: {
+		model_id: modelId,
+		text: { value: (flags, positionals) => positionals.slice(1).join(" ").trim() || undefined },
+	},
+	compare_writing_model: {
+		model_id: modelId,
+		text: { value: (flags, positionals) => positionals.slice(1).join(" ").trim() || undefined },
+	},
 	write_with_writing_model: {
 		model_id: modelId,
 		ask: { value: (flags, positionals) => positionals.slice(1).join(" ").trim() || undefined },
@@ -109,6 +125,11 @@ export async function cmdModels(ctx) {
 		}
 		case "show":
 			return modelShow(next, await call(next, "get_writing_model"));
+		case "add-text": {
+			refuseUnknownFlags(next, ARGS.add_writing_model_texts, ["title"]);
+			const result = await call(next, "add_writing_model_texts");
+			return modelShow(next, result);
+		}
 		case "add": {
 			refuseUnknownFlags(next, ARGS.add_writing_model_links, []);
 			const args = argsFromFlags(ARGS.add_writing_model_links, next.flags, next.positionals);
@@ -160,6 +181,23 @@ export async function cmdModels(ctx) {
 			printResult(next.io, next.flags, result, (r) => runLine(r.run));
 			return 0;
 		}
+		case "rewrite":
+		case "compare": {
+			const tool = sub === "rewrite" ? "rewrite_with_writing_model" : "compare_writing_model";
+			refuseUnknownFlags(next, ARGS[tool], []);
+			const args = argsFromFlags(ARGS[tool], next.flags, next.positionals);
+			if (!args.text) throw new CliError(`Supply source text: models ${sub} <id> "<text>"`);
+			const result = await next.client.callTool(tool, args);
+			printResult(next.io, next.flags, result, (r) =>
+				sub === "rewrite"
+					? r.text
+					: Object.entries(r.outputs)
+							.map(([name, out]) => `${name}:\n${out.text ?? out.error}`)
+							.join("\n\n")
+			);
+			return 0;
+		}
+
 		case "write": {
 			refuseUnknownFlags(next, ARGS.write_with_writing_model, []);
 			const args = argsFromFlags(ARGS.write_with_writing_model, next.flags, next.positionals);
@@ -176,7 +214,7 @@ export async function cmdModels(ctx) {
 			return modelShow(next, await call(next, "update_writing_model", { archived: sub === "archive" }));
 		default:
 			throw new CliError(
-				"Usage: models [list|create|show|add|find|confirm|remove|train|stop|write|update|archive|restore]"
+				"Usage: models [list|create|show|add|find|confirm|remove|train|stop|rewrite|compare|write|update|archive|restore]"
 			);
 	}
 }

package/lib/commands/replicate.mjs

@@ -25,6 +25,7 @@ export const ARGS = {
 		url: { positional: 0, label: "url", required: true },
 		max_pages: { flag: "max-pages", type: "num" },
 		paths: { flag: "path", type: "list" },
+		sample_banner: { flag: "sample-banner", type: "bool" },
 		refine_budget_usd: { flag: "refine-budget", type: "num" },
 		repo_name: "repo-name",
 		repo_owner: "repo-owner",
@@ -46,6 +47,7 @@ export const ARGS = {
 		preview: { flag: "preview", type: "bool" },
 		extend_preview_days: { flag: "extend-preview", type: "num" },
 		keep_preview: { flag: "keep-preview", type: "bool" },
+		sample_banner: { flag: "sample-banner", type: "bool" },
 	},
 	archive_replication: { replication_id: replicationId },
 	get_replication_forms_key: { replication_id: replicationId },

package/package.json

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