@letterstory/cli 0.124.0 → 0.125.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.125.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
@@ -1336,6 +1336,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
@@ -167,6 +168,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 +200,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 +246,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":
@@ -549,6 +562,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/package.json

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