@letterstory/cli 0.176.75 → 0.176.77

package/lib/cli.mjs

@@ -85,7 +85,7 @@ import {
 import { fetchParkedSections, withoutParked } from "./parked.mjs";
 
 // Matches cli/package.json; publish-cli.yml rewrites both to the published version.
-export const VERSION = "0.176.75";
+export const VERSION = "0.176.77";
 
 /** The exit code for a gate refusal (CARD_REQUIRED, PAYMENT_FAILED, OUT_OF_TOKENS): 1 is a plain error. */
 export const EXIT_PAYMENT_REQUIRED = 3;
@@ -1253,8 +1253,11 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
   admin billing free grant <org-id> <tokens> --why "…" [--key k] | grants [--org <org-id>] | revoke <org-id> <ref> --why "…"
                                                        Give an org free tokens (a Lago org: a one-off wallet),
                                                        list staff grants, take one back; posted to #billing
-  admin billing desk [--json]                          The Billing desk: switches, failed payments, the
-                                                       nightly reconcile, refusals, signups, grants
+  admin billing desk [--card-forms-since ISO] [--json] The Billing desk: switches, failed payments, the
+                                                       nightly reconcile, refusals, signups, card forms, grants
+  admin billing card-forms [--since ISO] [--json]      Where each card form stopped (default the last 7
+                                                       days): the browser's last step, Stripe's status and
+                                                       error codes, one verdict. Read only.
   admin billing free preflight [--json]                Who the paywall stops the moment it is enforced:
                                                        out of tokens, low, paying but covered, undecided
   admin billing org test <org-id> --why "…" [--off]   Mark an org a test org (never gated or billed), or with
@@ -1858,8 +1861,9 @@ Repo changes (Claude Code edits your repo in a sandbox; the Letter GitHub App op
                                                        One PR adding the Visitors script tag and server snippet to the repo that
                                                        builds the site (--repo: another repo)
   repo sites [--detect [--force]]                      Which website each repo builds, and the evidence
-  repo set-site --repo <owner/name> [--gitlab] --site <host> [--not] [--branch <name>|none]
-                                                       Say which site a repo builds (--not: correct a wrong label)
+  repo set-site --repo <owner/name> [--gitlab] --site <host> [--not] [--branch <name>|none] [--sections blog,docs|none]
+                                                       Say which site a repo builds (--not: correct a wrong label;
+                                                       --sections: the parts of it, when only those)
   repo reset-site --repo <owner/name> [--gitlab] --site <host>
                                                        Back to automatic detection
   repo secrets --repo <owner/name> [--gitlab]            Preview secrets: names and when set (never values)

package/lib/commands/admin.mjs

@@ -6013,6 +6013,7 @@ async function cmdAdminRecipes(ctx) {
 
 const LAGO = "/api/superadmin/billing/lago";
 const LAGO_USAGE = `Usage: admin billing desk [--json]       the Billing desk: switches, failed payments, reconcile, refusals, grants
+       admin billing card-forms [--since ISO]   where each card form stopped: browser step, Stripe's status, verdict
        admin billing org test <org-id> --why "…" [--off]   mark an org a test org (or not), kept with who and why
        admin billing lago <command>
   catalog [--apply] [--include-drafts]   what the plan catalog would change in Lago; --apply makes it so
@@ -6299,14 +6300,33 @@ async function cmdAdminBillingFree(ctx) {
 	throw new CliError(FREE_USAGE);
 }
 
+/** The desk's GET, with the card forms' window when one is named (--since / --card-forms-since). */
+function deskPath(since) {
+	return `/api/superadmin/billing/desk${since ? `?${new URLSearchParams({ card_forms_since: since })}` : ""}`;
+}
+
 /**
- * admin billing desk [--json] — the Billing desk in one read (lib/billing/desk.ts, docs/billing/billing-desk.md):
- * the switches, what needs a person now, and the week's numbers. The same as GET /api/superadmin/billing/desk
- * and MCP billing_desk.
+ * Where each card form stopped (the desk's signups.cardForms, lib/billing/lago/card-form.ts): one line per
+ * signup with its verdict, the browser's last step and Stripe's status.
+ */
+function cardFormLines(d) {
+	const forms = d.signups.cardForms ?? [];
+	const lines = [`Card forms since ${String(d.signups.cardFormsSince ?? "").slice(0, 10)}: ${forms.length}`];
+	for (const c of forms)
+		lines.push(
+			`  ${c.orgName ?? c.orgId.slice(0, 8)}  ${c.planCode}  ${c.status}  ${c.words}  (browser: ${c.browser.lastStep ?? "nothing"}, Stripe: ${c.stripe ? (c.stripe.status ?? "no setup") : "not read yet"})${c.alertedAt ? "  #billing told" : ""}`
+		);
+	return lines;
+}
+
+/**
+ * admin billing desk [--card-forms-since ISO] [--json] — the Billing desk in one read (lib/billing/desk.ts,
+ * docs/billing/billing-desk.md): the switches, what needs a person now, and the week's numbers. The same as
+ * GET /api/superadmin/billing/desk and MCP billing_desk.
  */
 async function cmdAdminBillingDesk(ctx) {
 	const { flags, io } = ctx;
-	const r = await staffRequest(ctx, "GET", "/api/superadmin/billing/desk");
+	const r = await staffRequest(ctx, "GET", deskPath(flagStr(flags["card-forms-since"])));
 	printResult(io, flags, r, (d) => {
 		const n = (x) => Number(x ?? 0).toLocaleString("en-US");
 		const sw = d.switches;
@@ -6336,8 +6356,9 @@ async function cmdAdminBillingDesk(ctx) {
 		if (d.signups.stuck.length) lines.push(`Stuck signups: ${d.signups.stuck.length}`);
 		for (const s of d.signups.stuck)
 			lines.push(
-				`  ${s.orgName ?? s.orgId.slice(0, 8)}  ${s.planCode}  ${s.status}${s.lastError ? `: ${s.lastError}` : ""}`
+				`  ${s.orgName ?? s.orgId.slice(0, 8)}  ${s.planCode}  ${s.status}${s.lastError ? `: ${s.lastError}` : ""}${s.cardForm ? `  (card form: ${s.cardForm})` : ""}`
 			);
+		lines.push(...cardFormLines(d));
 		const refusalWords = Object.entries(d.refusals.byReason)
 			.map(([k, c]) => `${c} ${k}`)
 			.join(", ");
@@ -6361,6 +6382,22 @@ async function cmdAdminBillingDesk(ctx) {
 	return 0;
 }
 
+const CARD_FORMS_USAGE = `Usage: admin billing card-forms [--since 2026-11-08 | 2026-11-08T09:30:00Z] [--json]
+  where each card form started since --since (a date is 00:00 UTC; default the last 7 days) stopped: the browser's last step,
+  Stripe's SetupIntent status and error codes, and one verdict ("opened, never submitted",
+  "submitted, Stripe refused: card_declined / insufficient_funds"). The desk's card forms, alone. Read only.`;
+
+/** admin billing card-forms [--since ISO] — the desk's card forms alone (lib/billing/lago/card-form.ts). */
+async function cmdAdminBillingCardForms(ctx) {
+	const { flags, positionals, io } = ctx;
+	if (positionals.length > 1) throw new CliError(CARD_FORMS_USAGE);
+	const r = await staffRequest(ctx, "GET", deskPath(flagStr(flags.since)));
+	printResult(io, flags, { cardFormsSince: r.signups.cardFormsSince, cardForms: r.signups.cardForms }, () =>
+		cardFormLines(r).join("\n")
+	);
+	return 0;
+}
+
 const EMAILS_USAGE = `Usage: admin billing emails [--bounced] [--org <org-id>] [--limit N]
   the invoice and receipt emails we sent for Lago and what became of each, bounced first
   (--bounced: only the ones that bounced, were marked as spam or failed)`;
@@ -6420,6 +6457,7 @@ async function cmdAdminBilling(ctx) {
 	if (positionals[0] === "legacy") return cmdAdminBillingLegacy(ctx);
 	if (positionals[0] === "free") return cmdAdminBillingFree(ctx);
 	if (positionals[0] === "desk") return cmdAdminBillingDesk(ctx);
+	if (positionals[0] === "card-forms") return cmdAdminBillingCardForms(ctx);
 	if (positionals[0] === "emails") return cmdAdminBillingEmails(ctx);
 	if (positionals[0] === "org") return cmdAdminBillingOrg(ctx);
 	if (positionals[0] !== "lago") throw new CliError(LAGO_USAGE);
@@ -6553,7 +6591,7 @@ async function cmdAdminBilling(ctx) {
 					...(r.signups.length
 						? r.signups.map(
 								(x) =>
-									`  ${x.orgName ?? x.orgId}  ${x.planCode}${x.ratio !== 1 ? ` ${x.ratio}x` : ""}  ${x.status}  ${x.source}${x.lastError ? `  (${x.lastError})` : ""}`
+									`  ${x.orgName ?? x.orgId}  ${x.planCode}${x.ratio !== 1 ? ` ${x.ratio}x` : ""}  ${x.status}  ${x.source}${x.cardForm ? `  ${x.cardForm}` : ""}${x.lastError ? `  (${x.lastError})` : ""}`
 							)
 						: ["  None."]),
 				].join("\n")

package/lib/commands/repo.mjs

@@ -131,6 +131,18 @@ const ARGS = {
 		builds: { flag: "not", type: "bool", invert: true },
 		// --branch <name>: the branch that deploys the site (one repo, a site per branch); none = default.
 		branch: { value: (flags) => (flags.branch === "none" ? null : flagStr(flags.branch)) },
+		// --sections blog,docs: the parts of the site the repo builds, when only those; none = the whole site.
+		sections: {
+			value: (flags) =>
+				flags.sections === undefined
+					? undefined
+					: flags.sections === "none"
+						? null
+						: String(flags.sections)
+								.split(",")
+								.map((s) => s.trim())
+								.filter(Boolean),
+		},
 	},
 	reset_repo_site: {
 		provider,
@@ -594,7 +606,7 @@ async function repoSites(ctx) {
 		const serving = r.sites.filter((s) => s.verdict === "serves");
 		const lines = serving.map((s) =>
 			s.decidedBy === "member"
-				? `${s.repo}  builds ${s.siteHost}  (set by a member)`
+				? `${s.repo}  builds ${s.siteHost}${s.sections?.length ? ` ${s.sections.map((x) => `/${x}`).join(", ")} only` : ""}  (set by a member)`
 				: `${s.repo}  builds ${s.siteHost}  (${Math.round(s.score * 100)}%: ${s.evidence.signals.join(", ")})`
 		);
 		if (r.failed?.length) lines.push(...r.failed.map((f) => `! ${f.repo}: ${f.error}`));
@@ -603,10 +615,10 @@ async function repoSites(ctx) {
 	return 0;
 }
 
-/** `repo set-site --repo owner/name --site acme.com [--not]`: say which site a repo builds (or doesn't). */
+/** `repo set-site --repo owner/name --site acme.com [--not] [--branch b] [--sections blog,docs|none]`: say which site a repo builds (or doesn't), and which part of it. */
 async function repoSetSite(ctx) {
 	const { client, flags, io } = ctx;
-	refuseUnknownFlags(ctx, {}, ["repo", "owner", "name", "gitlab", "site", "not", "branch"]);
+	refuseUnknownFlags(ctx, {}, ["repo", "owner", "name", "gitlab", "site", "not", "branch", "sections"]);
 	const result = await client.callTool("set_repo_site", argsFromFlags(ARGS.set_repo_site, flags));
 	ok(ctx, result.message);
 	printResult(io, flags, result.site);

package/package.json

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