@letterstory/cli 0.176.76 → 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.76";
+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

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/package.json

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