@letterstory/cli 0.99.0 → 0.100.0

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.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
@@ -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/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.0",
 	"description": "Spin up and manage Letterstory phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",