@letterstory/cli 0.149.1 → 0.150.1

package/lib/cli.mjs

@@ -66,7 +66,7 @@ import {
 
 // Matches cli/package.json; publish-cli.yml rewrites both to the published version.
 // Matches cli/package.json; publish-cli.yml rewrites both to the published version.
-export const VERSION = "0.149.1";
+export const VERSION = "0.150.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
@@ -969,7 +969,7 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
           | provision <org-id> --plan starter|growth|scale [--ratio 1|2|4|8 (8 needs --why "…")] [--complimentary N] [--stripe-customer cus_…] [--start ISO] [--review D]
           | reconcile [--org <org-id>] | forward
           | payments [--org <org-id>] [--open] | payments retry <lago-invoice-id> | payments run [--dry]
-          | signups [--status open|card_saved|provisioned|paid|abandoned]
+          | signups [--status open|card_saved|provisioned|paid|abandoned|canceled]
           | cap <org-id> <dollars|off> [--why "…"] | cancel <org-id> --why "…" --yes
           | move <org-id> --plan starter|growth|scale [--ratio N [--why "…"]] [--reason "…"] [--stripe-subscription sub_…] [--dry]
           | changes [--org <org-id>] | changes cancel <org-id>
@@ -1130,10 +1130,11 @@ Seers (event-driven signals -> drafts):
   org export --split <dir>                             …as one file per record (for keeping config in git)
   org join <dir> [--file <path>]                       Rebuild the bundle from a --split directory
   org integrations                                     Every integration and whether it's connected
-  org billing [cap <dollars|off> [--why "…"] | request [--note "…"] | cancel [--why "…"] --yes]
+  org billing [cap <dollars|off> [--why "…"] | card | request [--note "…"] | cancel [--why "…"] --yes]
                                                        Usage billing: plan, this period against the
                                                        allowance and spend cap, failed payments; set
-                                                       the cap (admins) or ask the admins for more
+                                                       the cap or change the card (admins), or ask
+                                                       the admins for more
   org billing usage                                    This period by product and collection: quantities,
                                                        and tokens and dollars when billed by usage
   org linear [teams [--team <id|key>] | set --team <id|key> [--project <id>|none] | disconnect]
@@ -1445,6 +1446,7 @@ The Site (one model of your whole marketing site, keyed by host and path):
 
 Repo changes (Claude Code edits your repo in a sandbox; the Letter GitHub App opens a PR):
   repo repos                                           Repos the Letter GitHub App can reach
+  repo connect                                         Is GitHub connected; the link a person opens to connect it
   repo branches --repo owner/name                      Branches a change can start from (default first)
   repo prs [--repo owner/name]                         Every open PR (whoever opened it), longest-idle first
   repo suggestions                                     Fixes found and not acted on yet, and how to start each
@@ -1502,7 +1504,7 @@ Repo changes (Claude Code edits your repo in a sandbox; the Letter GitHub App op
   repo merge <run-id>                                  Merge its open PR (a squash; the repo's branch rules decide)
   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)
+  repo cancel <run-id> [--force]                       Stop it and delete the sandbox; no PR (Discard a preview)
 
 Feedback (tell us what's broken, missing, unclear, or wanted):
   feedback submit --category bug|missing_feature|unclear|feature_request|praise|other

package/lib/commands/admin.mjs

@@ -5213,7 +5213,7 @@ const LAGO_USAGE = `Usage: admin billing lago <command>
   payments [--org <org-id>] [--open]     failed payments and what the retry loop did about each
   payments retry <lago-invoice-id>       charge one failed invoice again now
   payments run [--dry]                   one pass of the failed-payment loop now (--dry: report only)
-  signups [--status open|card_saved|provisioned|paid|abandoned]   new paying orgs on their way onto Lago
+  signups [--status open|card_saved|provisioned|paid|abandoned|canceled]   new paying orgs on their way onto Lago
   cap <org-id> <dollars|off> [--why "…"]  set an account's monthly spend cap on overage (off: no cap)
   cancel <org-id> --why "…" --yes          end an account's Lago plan now and refund its first invoice
   move <org-id> --plan starter [--ratio 4] [--why "…" above 4x] [--reason "…"] [--complimentary 20000] [--review 2027-05-01] [--stripe-subscription sub_…] [--dry]

package/lib/commands/automations.mjs

@@ -18,6 +18,7 @@ export const ARGS = {
 	},
 	suggest_starter_automations: {
 		collection_id: { flag: "collection", required: true },
+		ground: { flag: "ground", enum: ["answers", "search"] },
 	},
 	get_ground_measures: {
 		collection_id: { flag: "collection", required: true },

package/lib/commands/org.mjs

@@ -35,6 +35,7 @@ export const ARGS = {
 	},
 	request_billing_tokens: { note: { flag: "note" } },
 	cancel_billing_plan: { reason: { flag: "why" } },
+	update_billing_card: {},
 	list_integrations: {},
 	get_linear_connection: {},
 	list_linear_targets: { team_id: { flag: "team" } },
@@ -111,7 +112,8 @@ const usd = (n) => `$${Number(n).toFixed(2)}`;
 /**
  * `org billing`: the org's plan on Lago, this period against its allowance and spend cap, whether
  * it is past due, and its failed payments (get_billing_payments). `org billing cap <dollars|off>`
- * sets the cap (set_billing_spend_cap, admins); `org billing request` asks the admins for more
+ * sets the cap (set_billing_spend_cap, admins); `org billing card` links to Stripe's page for a new
+ * card (update_billing_card, admins); `org billing request` asks the admins for more
  * (request_billing_tokens); `org billing usage` is this period by product and collection (get_billing).
  */
 async function orgBilling(ctx) {
@@ -130,14 +132,30 @@ async function orgBilling(ctx) {
 	if (positionals[0] === "cancel") {
 		refuseUnknownFlags(ctx, ARGS.cancel_billing_plan, ["yes"]);
 		if (!flagBool(flags.yes))
-			throw new CliError("This ends the plan now and refunds its first invoice. Run again with --yes to do it.");
+			throw new CliError(
+				"This ends the plan now and refunds its first invoice (and any overage charged this month). Run again with --yes to do it."
+			);
 		const result = await client.callTool("cancel_billing_plan", argsFromFlags(ARGS.cancel_billing_plan, flags, []));
 		printResult(io, flags, result, (r) =>
-			r.firstInvoice === "refunded"
-				? `Plan cancelled; $${(r.refundedCents / 100).toFixed(2)} refunded to the card.`
-				: r.firstInvoice === "voided"
-					? "Plan cancelled; its unpaid first invoice is voided."
-					: "Plan cancelled."
+			[
+				"Plan cancelled",
+				r.firstInvoice === "voided" ? "; its unpaid first invoice is voided" : "",
+				r.refundedCents ? `; $${(r.refundedCents / 100).toFixed(2)} refunded to the card` : "",
+				r.topUpsRefundedCents ? ` ($${(r.topUpsRefundedCents / 100).toFixed(2)} of it overage)` : "",
+				".",
+			].join("")
+		);
+		return 0;
+	}
+	if (positionals[0] === "card") {
+		refuseUnknownFlags(ctx, ARGS.update_billing_card, []);
+		const result = await client.callTool("update_billing_card", argsFromFlags(ARGS.update_billing_card, flags, []));
+		printResult(
+			io,
+			flags,
+			result,
+			(r) =>
+				`Enter the new card here${r.expiresAt ? ` (until ${r.expiresAt})` : ""}:\n${r.url}\nIt becomes the card we charge, and any failed plan invoice is charged to it.`
 		);
 		return 0;
 	}

package/lib/commands/repo.mjs

@@ -8,6 +8,7 @@
 //   repo revise  → revise_repo_change (ask for more on a preview, before the PR)
 //   repo say     → send_repo_change_message (steer a build while its agent works)
 //   repo repos   → list_github_app_repos  repo branches → list_repo_branches
+//   repo connect → connect_github (the link a person opens to connect GitHub)
 //   repo prs     → list_open_pull_requests (every open PR, whoever opened it)
 //   repo install-letterprove → letterprove_open_install_pr
 //   repo install-visitors → visitors_open_install_pr
@@ -221,7 +222,11 @@ const ARGS = {
 			value: (flags, positionals) => flagStr(flags.message) ?? (positionals.slice(1).join(" ") || undefined),
 		},
 	},
-	cancel_repo_change: { run_id: { positional: 0, required: true, label: "run-id" } },
+	cancel_repo_change: {
+		run_id: { positional: 0, required: true, label: "run-id" },
+		// --force: cancel a change another key or person started.
+		force: { flag: "force", type: "bool" },
+	},
 	publish_repo_change: { run_id: { positional: 0, required: true, label: "run-id" } },
 	merge_repo_change: { run_id: { positional: 0, required: true, label: "run-id" } },
 	revise_repo_change: {
@@ -245,6 +250,7 @@ const ARGS = {
 		site_host: "site",
 	},
 	list_github_app_repos: {},
+	connect_github: {},
 	list_repo_branches: {
 		repo_owner: { value: (flags) => splitRepo(flags).owner },
 		repo_name: { value: (flags) => splitRepo(flags).name },
@@ -329,6 +335,8 @@ export async function cmdRepo(ctx) {
 			return repoSay(rest);
 		case "repos":
 			return repoRepos(rest);
+		case "connect":
+			return repoConnect(rest);
 		case "branches":
 			return repoBranches(rest);
 		case "prs":
@@ -713,6 +721,14 @@ async function repoRepos(ctx) {
 	return 0;
 }
 
+/** `repo connect`: whether GitHub is connected, and the link a person opens to connect it. */
+async function repoConnect(ctx) {
+	const { client, flags, io } = ctx;
+	const result = await client.callTool("connect_github", argsFromFlags(ARGS.connect_github, flags));
+	printResult(io, flags, result, (r) => r.message);
+	return 0;
+}
+
 /** `repo prs [--repo owner/name]`: every open PR, longest-idle first, and which Letter opened. */
 async function repoPrs(ctx) {
 	const { client, flags, io } = ctx;

package/package.json

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