@letterstory/cli 0.121.1 → 0.121.2

package/lib/cli.mjs

@@ -60,7 +60,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.121.1";
+export const VERSION = "0.121.2";
 
 // 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
@@ -1262,6 +1262,7 @@ Repo changes (Claude Code edits your repo in a sandbox; the Letterstory GitHub A
                                                        Say which site a repo builds (--not: correct a wrong label)
   repo reset-site --repo <owner/name> --site <host>    Back to automatic detection
   repo status <run-id>                                 Phase, spend, PR link and Claude's summary
+  repo activity <run-id> [--follow]                    What the sandbox is doing, line by line (--follow: until it stops)
   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

package/lib/commands/repo.mjs

@@ -1,6 +1,7 @@
 // `repo` — changes to the org's own repos, made by Claude Code in a sandbox and opened as a
 // pull request by the Letterstory GitHub App (src/lib/repo-changes). One subcommand per tool:
 //   repo start   → start_repo_change     repo status → get_repo_change
+//   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 repos   → list_github_app_repos  repo branches → list_repo_branches
@@ -138,6 +139,7 @@ const ARGS = {
 		autopilot_min_severity: { flag: "autopilot-severity", enum: ["critical", "warning"] },
 	},
 	get_repo_change: { run_id: { positional: 0, required: true, label: "run-id" } },
+	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" } },
 	list_repo_changes: {
@@ -184,6 +186,8 @@ export async function cmdRepo(ctx) {
 			return repoStart(rest);
 		case "status":
 			return repoStatus(rest);
+		case "activity":
+			return repoActivity(rest);
 		case "fix-audit":
 			return repoFixAudit(rest);
 		case "install-letterprove":
@@ -407,6 +411,39 @@ async function repoStatus(ctx) {
 	return 0;
 }
 
+const ACTIVITY_MARK = { progress: "·", stage: "▸", say: "»", tool: "$", error: "!" };
+
+/** `repo activity <run-id> [--follow]`: the build's feed; --follow prints new lines until it stops. */
+async function repoActivity(ctx) {
+	const { client, flags, io } = ctx;
+	refuseUnknownFlags(ctx, {}, ["follow"]);
+	const args = argsFromFlags(ARGS.get_repo_change_activity, flags, ctx.positionals);
+	const line = (l) => `${l.at.slice(11, 19)} ${ACTIVITY_MARK[l.kind] ?? " "} ${l.text}`;
+	let { activity } = await client.callTool("get_repo_change_activity", args);
+	if (flags.json && !flags.follow) {
+		printResult(io, flags, activity);
+		return 0;
+	}
+	let seen = 0;
+	const print = () => {
+		for (const l of activity.lines.slice(seen)) io.log(flags.json ? JSON.stringify(l) : line(l));
+		seen = activity.lines.length;
+	};
+	print();
+	if (!flags.follow) return 0;
+	await followJob(
+		io,
+		async () => {
+			({ activity } = await client.callTool("get_repo_change_activity", args));
+			print();
+			return { done: !activity.live, value: activity };
+		},
+		{ intervalMs: 3000, ceilingMs: 60 * 60 * 1000 }
+	);
+	ok(ctx, `Run ${activity.runId} is ${activity.status} (${activity.phase}).`);
+	return 0;
+}
+
 async function repoList(ctx) {
 	const { client, flags, io } = ctx;
 	const result = await client.callTool(

package/package.json

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