@letterstory/cli 0.176.25 → 0.176.26

package/lib/cli.mjs

@@ -82,7 +82,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.25";
+export const VERSION = "0.176.26";
 
 /** 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;
@@ -1088,12 +1088,14 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
                                                        domain typed into Set-up maps and reads it all afresh.
   admin demo domains                                   The farm domains a new demo org could take (live
                                                        phantoms; the phantom is kept). Needs demo:read.
-  admin demo new <domain> [--name <n>] [--brief <t>] [--full] [--no-wait]
+  admin demo new <domain> [--name <n>] [--brief <t>] [--full] [--host vercel|pages] [--no-wait]
                                                        A new demo org on a farm phantom's domain: a made-up
                                                        company, a one-page site in the demo GitHub org served by
                                                        Pages, the domain moved off its phantom (kept), the org
-                                                       enrolled and shown as blank. Takes minutes; calls again
-                                                       until done (--no-wait: once). Auto-Plan stays off.
+                                                       enrolled and shown as blank. Served from Vercel (a project
+                                                       linked to the repo: a merged PR redeploys it); --host pages
+                                                       for GitHub Pages, and --host vercel on an org that has a Pages
+                                                       site moves it. Calls again until done (--no-wait: once).
   admin demo teardown <org-id> [--keep-repo]           Put the site back: the domain to its phantom, the repo gone.
   admin demo check <org-id>                            Is it ready to show? Competitors, targets, answers, the
                                                        Plan's rows, the issues open, no PR open, GitHub, the
@@ -1803,8 +1805,10 @@ Repo changes (Claude Code edits your repo in a sandbox; the Letter GitHub App op
   repo publish <run-id>                                Make PR on a preview in review
   repo merge <run-id>                                  Merge its open PR (a squash; the repo's branch rules decide)
   repo revise <run-id> --instructions <text>|--instructions-file <path|->  [--copy-edits-file <path|->]
+             [--attach <path>]… [--attach-ref <path>]… [--attach-url name=url]… [--attach-url-ref name=url]…
                                                        Ask for more on a preview (it takes over the preview's link) or an
-                                                       open PR (one more commit); copy edits: JSON [{ path, before, after }]
+                                                       open PR (one more commit); copy edits: JSON [{ path, before, after }];
+                                                       files as repo start takes them (--attach-ref: read, never committed)
   repo cancel <run-id> [--force]                       Stop it and delete the sandbox; no PR (Discard a preview)
 
 Feedback (tell us what's broken, missing, unclear, or wanted):

package/lib/commands/admin.mjs

@@ -6518,7 +6518,7 @@ const DEMO_ITEM_FLAGS = [
 	"setup",
 ];
 const DEMO_USAGE =
-	"Usage: admin demo guide | list [--enrollable] | show <org-id> [--moves] | set <org-id> [--enroll] [--unenroll] [--file <state.json>] [--phantom parked|shown] [--main-blog …] [--visitors …] [--probes not_run|shown] [--cms hidden|shown] [--publish-target …] [--search-console …] [--github …] [--domain …] [--setup fresh|finished] [--domain-cap n] [--inject <key>]... [--hide <key>]... [--save-as <name>] [--baseline <owner/repo>[@sha] | --clear-baseline] [--copy-from <org-id> [--copy-scenarios a,b] [--overwrite]] [--auto-reset <scenario>|off] [--every <minutes>] [--release] | domains | new <domain> [--name <n>] [--brief <t>] [--full] [--no-wait] | teardown <org-id> [--keep-repo] | bootstrap <org-id>... --from <org-id> [--scenarios a,b] [--overwrite] | reset <org-id> <scenario> [--clean-slate] [--close-prs since_applied|all_open|none] [--hold <minutes>] [--restore-repo revert|force] [--rebuild] [--reread-company] [--forget-company] [--forget-site] | check <org-id>";
+	"Usage: admin demo guide | list [--enrollable] | show <org-id> [--moves] | set <org-id> [--enroll] [--unenroll] [--file <state.json>] [--phantom parked|shown] [--main-blog …] [--visitors …] [--probes not_run|shown] [--cms hidden|shown] [--publish-target …] [--search-console …] [--github …] [--domain …] [--setup fresh|finished] [--domain-cap n] [--inject <key>]... [--hide <key>]... [--save-as <name>] [--baseline <owner/repo>[@sha] | --clear-baseline] [--copy-from <org-id> [--copy-scenarios a,b] [--overwrite]] [--auto-reset <scenario>|off] [--every <minutes>] [--release] | domains | new <domain> [--name <n>] [--brief <t>] [--full] [--host vercel|pages] [--no-wait] | teardown <org-id> [--keep-repo] | bootstrap <org-id>... --from <org-id> [--scenarios a,b] [--overwrite] | reset <org-id> <scenario> [--clean-slate] [--close-prs since_applied|all_open|none] [--hold <minutes>] [--restore-repo revert|force] [--rebuild] [--reread-company] [--forget-company] [--forget-site] | check <org-id>";
 
 const readinessLines = (r) =>
 	r
@@ -6668,6 +6668,7 @@ async function cmdAdminDemo(ctx) {
 				name: flagStr(flags.name),
 				brief: flagStr(flags.brief),
 				full: flagBool(flags.full) || undefined,
+				host: flagStr(flags.host),
 			});
 			for (let attempt = 0; ; attempt++) {
 				const r = await staffPost(ctx, `${DEMO}/orgs`, body);

package/lib/commands/build.mjs

@@ -32,6 +32,8 @@ const ARGS = {
 		delivery: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack", "linear"] },
 		notify_slack: { flag: "notify-slack", type: "bool" },
 		harness: { flag: "harness", enum: ["letterpress-1", "claude-code", "codex"] },
+		// --branch <name>: where its changes start and its pull requests go; omitted, the branch that builds the site.
+		base_branch: "branch",
 		// --effort low|medium|high|xhigh: how hard the coding agent works on each change; omitted, its own default.
 		effort: { flag: "effort", enum: ["low", "medium", "high", "xhigh"] },
 		again: { flag: "again", type: "bool" },
@@ -59,6 +61,8 @@ const ARGS = {
 		conversation_id: "conversation",
 		build_id: "build",
 		domain: "site",
+		// --branch <name>: where a build this message starts works from.
+		base_branch: "branch",
 		subjects: { flag: "subject", type: "list" },
 		// --recipe <id>: the recipe the words carry out (a Plan row's), recorded on the build it starts.
 		recipe: "recipe",
@@ -189,6 +193,7 @@ async function buildStart(ctx) {
 		"again",
 		"plan-only",
 		"plan-file",
+		"branch",
 		...FILE_FLAGS,
 	]);
 	const files = await attachedFiles(ctx);
@@ -220,6 +225,7 @@ async function buildTalk(ctx) {
 		"subject",
 		"harness",
 		"repo",
+		"branch",
 		"action",
 		"intent",
 		...FILE_FLAGS,

package/lib/commands/repo.mjs

@@ -257,6 +257,7 @@ const ARGS = {
 		run_id: { positional: 0, required: true, label: "run-id" },
 		instructions: { value: (flags) => readTextInput(flags, "instructions", "instructions-file") },
 		copy_edits: { value: (flags) => copyEdits(flags) },
+		files: { value: (_flags, _positionals, extra) => (extra.files?.length ? extra.files : undefined) },
 	},
 	list_repo_changes: {
 		status: { flag: "status", enum: ["running", "succeeded", "no_changes", "failed", "cancelled", "sent"] },
@@ -437,6 +438,19 @@ export async function uploadAttachments(ctx, paths) {
 	return uploads.map((slot) => ({ name: slot.name, upload_path: slot.path }));
 }
 
+/** --attach / --attach-ref (uploaded) and --attach-url / --attach-url-ref, as a change's `files`. */
+async function attachedFiles(ctx) {
+	const { flags } = ctx;
+	// One upload for every file (names must be unique across both), then the references marked.
+	const place = flagList(flags.attach);
+	const uploaded = await uploadAttachments(ctx, [...place, ...flagList(flags["attach-ref"])]);
+	return [
+		...uploaded.map((f, i) => (i < place.length ? f : { ...f, reference: true })),
+		...attachmentUrls(flagList(flags["attach-url"])),
+		...attachmentUrls(flagList(flags["attach-url-ref"])).map((f) => ({ ...f, reference: true })),
+	];
+}
+
 async function repoStart(ctx) {
 	const { client, flags, io } = ctx;
 	refuseUnknownFlags(ctx, {}, [
@@ -460,15 +474,7 @@ async function repoStart(ctx) {
 		"page",
 		"wait",
 	]);
-	// One upload for every file (names must be unique across both), then the references marked.
-	const place = flagList(flags.attach);
-	const uploaded = await uploadAttachments(ctx, [...place, ...flagList(flags["attach-ref"])]);
-	const files = [
-		...uploaded.map((f, i) => (i < place.length ? f : { ...f, reference: true })),
-		...attachmentUrls(flagList(flags["attach-url"])),
-		...attachmentUrls(flagList(flags["attach-url-ref"])).map((f) => ({ ...f, reference: true })),
-	];
-	const args = argsFromFlags(ARGS.start_repo_change, flags, ctx.positionals, { files });
+	const args = argsFromFlags(ARGS.start_repo_change, flags, ctx.positionals, { files: await attachedFiles(ctx) });
 	if (!args.repo_owner || !args.repo_name) throw new CliError("Missing --repo owner/name");
 	if (!args.instructions) throw new CliError("Missing --instructions (or --instructions-file <path|->)");
 
@@ -795,10 +801,13 @@ function copyEdits(flags) {
 	return list;
 }
 
-/** `repo revise <run-id> --instructions <text> [--copy-edits-file <path|->]`: a follow-up, built on top of the change. */
+/**
+ * `repo revise <run-id> --instructions <text> [--copy-edits-file <path|->] [--attach-ref <path>]…`: a follow-up,
+ * built on top of the change, with any files it needs (a screenshot to read, an image to place) as `repo start` takes them.
+ */
 async function repoRevise(ctx) {
 	const { client, flags, io } = ctx;
-	const args = argsFromFlags(ARGS.revise_repo_change, flags, ctx.positionals);
+	const args = argsFromFlags(ARGS.revise_repo_change, flags, ctx.positionals, { files: await attachedFiles(ctx) });
 	if (!args.instructions && !args.copy_edits) {
 		throw new CliError("Missing --instructions (or --instructions-file <path|->), or --copy-edits-file <path|->");
 	}

package/package.json

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