@letterstory/cli 0.99.0 → 0.100.1

package/lib/cli.mjs

@@ -59,7 +59,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.99.0";
+export const VERSION = "0.100.1";
 
 // 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
@@ -1118,6 +1118,7 @@ Insights:
 
 Repo changes (Claude Code edits your repo in a sandbox; the Letterstory GitHub App opens a PR):
   repo repos                                           Repos the Letterstory GitHub App can reach
+  repo branches --repo owner/name                      Branches a change can start from (default first)
   repo start --repo <owner/name> --instructions <text>|--instructions-file <path|->
              [--branch <base>] [--attach <path>]... [--attach-url <name>=<https url>]... [--wait]
                                                        Start a change (attached files go to the sandbox);

package/lib/commands/admin.mjs

@@ -2838,6 +2838,7 @@ async function cmdAdminCrmCapture(ctx, paths) {
  *   outreach add "Jane Doe" [--company …] [--owner …] [--channel x] [--relationship …]
  *                [--ask …] [--linkedin …] [--email …] [--lookup]
  *   outreach lookup "Jane Doe from Acme" [shot.png …]  prefilled from the web; writes nothing
+ *   outreach catch-up [--dry-run]                    handle #launch-outreach posts the bot missed
  *   outreach set <id> [--reached|--not-reached] [--response "…" --tone positive]
  *                [--owner-id <uuid>] [--channel …] [--ask …] [--draft "…"] [--archive|--restore]
  */
@@ -2952,8 +2953,36 @@ async function cmdAdminCrmOutreach(ctx, args) {
 			const r = await staffRequest(ctx, "PATCH", `${CRM}/outreach/${id}`, body);
 			return json ? printResult(io, flags, r) : io.log(line(r));
 		}
+		case "catch-up": {
+			// admin crm outreach catch-up [--dry-run] — handle #launch-outreach posts the bot
+			// missed, calling again until none remain (each call is bounded server-side).
+			const dryRun = flagBool(flags["dry-run"]);
+			let total = 0;
+			let after;
+			for (let i = 0; i < 20; i++) {
+				const r = await staffPost(
+					ctx,
+					`${CRM}/outreach/catch-up`,
+					dryRun ? { dryRun: true } : compact({ after })
+				);
+				after = r.nextAfter ?? after;
+				if (json) printResult(io, flags, r);
+				else
+					for (const it of r.items)
+						io.log(
+							`${it.ts}  ${it.outcome ?? "pending"}  ${it.preview}${it.files ? ` [${it.files} file(s)]` : ""}`
+						);
+				total += r.processed;
+				if (dryRun || r.remaining === 0 || r.items.some((it) => it.outcome?.startsWith("failed:"))) {
+					if (!json)
+						io.log(dryRun ? `${r.pending} post(s) the bot missed` : `caught up: ${total} post(s) handled`);
+					return;
+				}
+			}
+			return;
+		}
 		default:
-			throw new CliError("Usage: admin crm outreach [list|add|lookup|set] … (see --help)");
+			throw new CliError("Usage: admin crm outreach [list|add|lookup|set|catch-up] … (see --help)");
 	}
 }
 

package/lib/commands/repo.mjs

@@ -2,7 +2,7 @@
 // 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 list    → list_repo_changes     repo cancel → cancel_repo_change
-//   repo repos   → list_github_app_repos
+//   repo repos   → list_github_app_repos  repo branches → list_repo_branches
 
 import { readFileSync } from "node:fs";
 import { basename } from "node:path";
@@ -64,6 +64,10 @@ const ARGS = {
 		audit_id: "audit",
 	},
 	list_github_app_repos: {},
+	list_repo_branches: {
+		repo_owner: { value: (flags) => splitRepo(flags).owner },
+		repo_name: { value: (flags) => splitRepo(flags).name },
+	},
 };
 
 const TERMINAL = new Set(["succeeded", "no_changes", "failed", "cancelled"]);
@@ -100,9 +104,11 @@ export async function cmdRepo(ctx) {
 			return repoCancel(rest);
 		case "repos":
 			return repoRepos(rest);
+		case "branches":
+			return repoBranches(rest);
 		default:
 			throw new CliError(
-				`Unknown repo subcommand: ${sub ?? "(none)"}. Try: start, fix-audit, sites, set-site, reset-site, status, list, cancel, repos`
+				`Unknown repo subcommand: ${sub ?? "(none)"}. Try: start, fix-audit, sites, set-site, reset-site, status, list, cancel, repos, branches`
 			);
 	}
 }
@@ -302,4 +308,15 @@ async function repoRepos(ctx) {
 	return 0;
 }
 
+/** `repo branches --repo owner/name`: the branches a run can start from, default first. */
+async function repoBranches(ctx) {
+	const { client, flags, io } = ctx;
+	refuseUnknownFlags(ctx, {}, ["repo", "owner", "name"]);
+	const result = await client.callTool("list_repo_branches", argsFromFlags(ARGS.list_repo_branches, flags));
+	printResult(io, flags, result, (r) =>
+		r.branches.map((b) => (b === r.defaultBranch ? `${b}  (default)` : b)).join("\n")
+	);
+	return 0;
+}
+
 export { ARGS };

package/package.json

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