@letterstory/cli 0.124.0 → 0.126.0

package/lib/cli.mjs

@@ -61,7 +61,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.124.0";
+export const VERSION = "0.126.0";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value. Every `type: "bool"` flag (and its
@@ -96,6 +96,7 @@ export const BOOLEAN_FLAGS = new Set([
 	"own-beat",
 	"refresh",
 	"preview",
+	"with-preview",
 	"accept",
 	"help",
 	"version",
@@ -1312,8 +1313,9 @@ Repo changes (Claude Code edits your repo in a sandbox; the Letterstory GitHub A
   repo slack-test                                      Post a test into the Send to Slack channel
   repo start --repo <owner/name> --instructions <text>|--instructions-file <path|->
              [--branch <base>] [--attach <path>]... [--attach-url <name>=<https url>]...
-             [--action build|build_pr|build_merge|slack|linear] [--wait]
+             [--action build|build_pr|build_merge|slack|linear] [--with-preview] [--wait]
                                                        Start a change (attached files go to the sandbox);
+                                                       --with-preview keeps a preview up next to the PR;
                                                        --wait follows it to the PR
   repo fix-audit --issue <issue-type>... [--audit <id>] [--branch <base>] [--action build|build_pr|build_merge|slack|linear] [--wait]
                                                        One PR fixing site-audit issues (repeat --issue to bundle) on every affected page,
@@ -1336,6 +1338,8 @@ Repo changes (Claude Code edits your repo in a sandbox; the Letterstory GitHub A
   repo list [--status running|succeeded|no_changes|failed|cancelled] [--limit n] [--audit <id>]
              [--source site_audit_issue|site_quick_check|letterprove_install]
   repo publish <run-id>                                Make PR on a preview in review
+  repo revise <run-id> --instructions <text>|--instructions-file <path|->
+                                                       Ask for more on a preview; it takes over the preview's link
   repo cancel <run-id>                                 Stop it and delete the sandbox; no PR (Discard a preview)
 
 Feedback (tell us what's broken, missing, unclear, or wanted):

package/lib/commands/repo.mjs

@@ -4,6 +4,7 @@
 //   repo activity → get_repo_change_activity (what the sandbox is doing; --follow polls)
 //   repo list    → list_repo_changes     repo cancel → cancel_repo_change
 //   repo publish → publish_repo_change (Make PR on a preview)
+//   repo revise  → revise_repo_change (ask for more on a preview, before the PR)
 //   repo repos   → list_github_app_repos  repo branches → list_repo_branches
 //   repo prs     → list_open_pull_requests (every open PR, whoever opened it)
 //   repo install-letterprove → letterprove_open_install_pr
@@ -62,6 +63,8 @@ const ARGS = {
 		files: { value: (_flags, _positionals, extra) => (extra.files?.length ? extra.files : undefined) },
 		action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack", "linear"] },
 		preview: { flag: "preview", type: "bool" },
+		// --with-preview: the PR opens straight away and a preview of the change stays up next to it.
+		with_preview: { flag: "with-preview", type: "bool" },
 	},
 	create_repo_change_upload: { file_names: { internal: "the basenames of the --attach files" } },
 	list_repo_sites: {},
@@ -167,6 +170,10 @@ const ARGS = {
 	get_repo_change_activity: { run_id: { positional: 0, required: true, label: "run-id" } },
 	cancel_repo_change: { run_id: { positional: 0, required: true, label: "run-id" } },
 	publish_repo_change: { run_id: { positional: 0, required: true, label: "run-id" } },
+	revise_repo_change: {
+		run_id: { positional: 0, required: true, label: "run-id" },
+		instructions: { value: (flags) => readTextInput(flags, "instructions", "instructions-file") },
+	},
 	list_repo_changes: {
 		status: { flag: "status", enum: ["running", "succeeded", "no_changes", "failed", "cancelled", "sent"] },
 		limit: { flag: "limit", type: "num" },
@@ -195,8 +202,14 @@ function describe(run) {
 		`${run.id}  ${run.repo}@${run.baseBranch}  ${run.status} (${run.phase})  $${run.costUsd.toFixed(2)}`,
 	];
 	if (run.preview?.url) lines.push(`  Preview: ${run.preview.url}`);
+	for (const [i, change] of (run.preview?.changes ?? []).entries())
+		lines.push(`    ${i + 1}. ${change.path}  ${change.note}${change.url ? `  ${change.url}` : ""}`);
 	if (run.preview?.state === "failed") lines.push(`  Preview failed: ${run.preview.detail ?? ""}`);
-	if (run.phase === "review") lines.push(`  Make PR: letterstory repo publish ${run.id}`);
+	if (run.preview?.revisionRunId) lines.push(`  Follow-up being built: ${run.preview.revisionRunId}`);
+	else if (run.phase === "review") {
+		lines.push(`  Make PR: letterstory repo publish ${run.id}`);
+		lines.push(`  Ask for more: letterstory repo revise ${run.id} --instructions "…"`);
+	}
 	if (run.prUrl) lines.push(`  PR: ${run.prUrl} (${run.prState ?? "state unknown"})`);
 	if (run.errorCode) lines.push(`  Error (${run.errorCode}): ${run.errorDetail ?? ""}`);
 	if (run.summary) lines.push(...run.summary.split("\n").map((l) => `  ${l}`));
@@ -235,6 +248,8 @@ export async function cmdRepo(ctx) {
 			return repoCancel(rest);
 		case "publish":
 			return repoPublish(rest);
+		case "revise":
+			return repoRevise(rest);
 		case "repos":
 			return repoRepos(rest);
 		case "branches":
@@ -307,6 +322,7 @@ async function repoStart(ctx) {
 		"attach-url",
 		"action",
 		"preview",
+		"with-preview",
 		"wait",
 	]);
 	const files = [
@@ -549,6 +565,17 @@ async function repoPublish(ctx) {
 	return 0;
 }
 
+/** `repo revise <run-id> --instructions <text>`: a follow-up on a preview, built on top of it. */
+async function repoRevise(ctx) {
+	const { client, flags, io } = ctx;
+	const args = argsFromFlags(ARGS.revise_repo_change, flags, ctx.positionals);
+	if (!args.instructions) throw new CliError("Missing --instructions (or --instructions-file <path|->)");
+	const result = await client.callTool("revise_repo_change", args);
+	ok(ctx, result.message);
+	printResult(io, flags, result.run, describe);
+	return 0;
+}
+
 async function repoRepos(ctx) {
 	const { client, flags, io } = ctx;
 	const result = await client.callTool("list_github_app_repos", argsFromFlags(ARGS.list_github_app_repos, flags));

package/lib/commands/site.mjs

@@ -178,6 +178,8 @@ const ARGS = {
 		base_branch: { flag: "base-branch" },
 		preview: { flag: "preview", type: "bool" },
 		action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack", "linear"] },
+		// --with-preview: the PR opens straight away and a preview of the fix stays up next to it.
+		with_preview: { flag: "with-preview", type: "bool" },
 	},
 };
 

package/package.json

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