@letterstory/cli 0.115.0 → 0.117.0

package/lib/cli.mjs

@@ -60,7 +60,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.115.0";
+export const VERSION = "0.117.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
@@ -98,6 +98,8 @@ export const BOOLEAN_FLAGS = new Set([
 	"verbose",
 	"no-color",
 	"dry-run",
+	// admin crm record-outcome --draft
+	"draft",
 	"prune",
 	// org git sync --force
 	"force",
@@ -786,7 +788,13 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
           | slack-channels [--all] | link-slack <account-id> <channel-id|none>
           | white-glove [--suggested] | set-white-glove <account-id> on|off [--note "…"]
           | churn [--months 12] | record-churn <account-id> <reason> [--note "…"] [--at ISO]
-            [--mrr-cents N] | undo-churn <account-id> | draft-churn-reason <account-id>
+            [--mrr-cents N] [--cause voluntary|involuntary|unknown] [--notice-at ISO] | undo-churn <account-id> | draft-churn-reason <account-id>
+          | outcomes [--account <id>] [--kind churn|contraction|expansion|reactivation|save]
+                     [--status draft|confirmed|discarded] [--since ISO] [--until ISO] [--limit N]
+          | record-outcome <account-id> <kind> [--reason code] [--also a,b] [--cause …] [--notice-at ISO]
+                     [--at ISO] [--mrr-before N] [--mrr-after N] [--note "…"] [--save-offer …]
+                     [--save-result …] [--draft]
+          | renewals [--days 90]
           | onboard <account-id> --domain acme.com [--name "Acme"] [--site "<direction>"]… [--sites N]
                    [--slack a@acme.com,b@acme.com] [--invite a@acme.com[:admin]]… [--no-checklist]
           | onboarding <account-id> | retry-onboarding <onboarding-id>
@@ -800,11 +808,18 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
                                                        White glove is a person's decision: the
                                                        desk only suggests ($1K+/mo post-sales).
                                                        Churn: 30/90-day logo + revenue rates, who
-                                                       churned and why; Stripe cancellations are
-                                                       only suggestions until a person records one.
+                                                       churned and why, split voluntary /
+                                                       involuntary, and payments failing now;
+                                                       Stripe cancellations are only suggestions
+                                                       until a person records one.
                                                        draft-churn-reason drafts a reason from
                                                        what the CRM kept; a person confirms it in
                                                        the proposals queue.
+                                                       Outcomes keep every churn, contraction,
+                                                       expansion, reactivation and save with its
+                                                       reason; a key records drafts a person
+                                                       confirms. Renewals: contracts renewing
+                                                       within N days, and Stripe cancels scheduled.
                                                        Onboard runs org → link → phantom sites →
                                                        Slack channel → checklist → app invites →
                                                        stage in one call (--site "" = infer the

package/lib/commands/admin.mjs

@@ -14,7 +14,7 @@
 //      The old names — evals, eval-add, eval-set, proposals, propose-eval, capture-eval, reject-eval — still work.)
 //   admin evals scoreboard|cases|runs|run|triage|guard|retire …                      (fleet:read / tuning:experiment)
 //   admin fleet-experiments list|articles|clients|mark|unmark|new|assign|assign-eligible|assign-orgs|spin-up|apply|start|stop|decide …  (fleet:read / fleet:experiment)
-//   admin crm import|capture|outreach|signals|record|signal|accounts|account|score|slack-channels|link-slack|white-glove|set-white-glove|churn|revenue|record-churn|draft-churn-reason|undo-churn|onboard|onboarding|retry-onboarding|onboard-plan|payment-link …  (crm:read / crm:write)
+//   admin crm import|capture|outreach|signals|record|signal|accounts|account|score|slack-channels|link-slack|white-glove|set-white-glove|churn|revenue|record-churn|draft-churn-reason|undo-churn|outcomes|record-outcome|renewals|onboard|onboarding|retry-onboarding|onboard-plan|payment-link …  (crm:read / crm:write)
 //   admin spend summary|reconcile|pnl|entries|add|import|usage|remove|reference|stripe-sync|services|service …  (spend:read / spend:write)
 //   admin brand-detection <org-id>                                                   (fleet:read)
 //   admin brand-detection <org-id> [--term t]... [--exact t]... [--exclude p]... [--note "…"] | --clear [--note "…"]   (fleet:instrument)
@@ -2562,6 +2562,16 @@ function signalLine(s) {
 	return `${s.id}  [${s.status} · ${s.intent}]  ${s.occurredAt.slice(0, 10)}  ${s.source}/${s.kind}  ${s.title}${who ? `\n    ${who}` : ""}`;
 }
 
+/** One outcome on a line: when, kind, status, reason, MRR move, id. */
+function outcomeLine(o) {
+	const usd = (c) => (c == null ? "?" : `$${Math.round(c / 100).toLocaleString("en-US")}`);
+	const mrr =
+		o.mrrBeforeCents != null || o.mrrAfterCents != null
+			? `  ${usd(o.mrrBeforeCents)} → ${usd(o.mrrAfterCents)}/mo`
+			: "";
+	return `${o.effectiveAt.slice(0, 10)}  ${o.kind}  ${o.status}  ${o.primaryReason ?? "no reason"}${mrr}${o.note ? `  — ${o.note}` : ""}  ${o.id}`;
+}
+
 function accountLine(a) {
 	const score = a.likelihood == null ? "—" : a.likelihood.toFixed(2);
 	return `${a.id}  [${a.stage}]  ${score}  ${a.name}${a.domain ? ` (${a.domain})` : ""}${a.isYc ? " · YC" : ""}`;
@@ -3322,12 +3332,23 @@ async function cmdAdminCrm(ctx) {
 			return out(r, () => (action === "on" ? "moved to white glove" : "left white glove"));
 		}
 		case "churn": {
-			// admin crm churn [--months 12] — the 30/90-day rates, who churned and why, likely churns.
+			// admin crm churn [--months 12] — the 30/90-day rates split voluntary / involuntary,
+			// who churned and why, likely churns, and payments failing now.
 			const params = new URLSearchParams(compact({ months: flagStr(flags.months) }));
 			const pct = (x) => (x == null ? "—" : `${(x * 100).toFixed(1)}%`);
 			const usd = (cents) => `$${Math.round(cents / 100).toLocaleString("en-US")}`;
+			const split = (b) =>
+				b
+					? `    voluntary ${b.voluntary.churned} · ${usd(b.voluntary.mrrLostCents)}/mo  involuntary ${b.involuntary.churned} · ${usd(b.involuntary.mrrLostCents)}/mo  unknown ${b.unknown.churned} · ${usd(b.unknown.mrrLostCents)}/mo`
+					: null;
 			const win = (label, w) =>
-				`${label}: ${w.churned}/${w.customersAtStart} customers (${pct(w.rate)}) · ${usd(w.mrrLostCents)}/mo lost (${pct(w.revenueRate)} of MRR)`;
+				[
+					`${label}: ${w.churned}/${w.customersAtStart} customers (${pct(w.rate)}) · ${usd(w.mrrLostCents)}/mo lost (${pct(w.revenueRate)} of MRR)`,
+					split(w.byCause),
+				]
+					.filter(Boolean)
+					.join("\n");
+			const cause = (x) => (x.cause ? `  [${x.cause}${x.causeSignal ? `: ${x.causeSignal}` : ""}]` : "");
 			return out(await staffRequest(ctx, "GET", `${CRM}/churn?${params}`), (r) =>
 				[
 					win("30d", r.window.days30),
@@ -3337,14 +3358,24 @@ async function cmdAdminCrm(ctx) {
 					...(r.churned.length
 						? r.churned.map(
 								(c) =>
-									`  ${c.churnedAt.slice(0, 10)}${c.churnedAtSource === "undated" ? "?" : ""}  ${c.account.name}  ${c.reason ?? "unrecorded"}  ${usd(c.mrrLostCents)}/mo${c.note ? `  — ${c.note}` : ""}`
+									`  ${c.churnedAt.slice(0, 10)}${c.churnedAtSource === "undated" ? "?" : ""}  ${c.account.name}  ${c.reason ?? "unrecorded"}  ${usd(c.mrrLostCents)}/mo${cause(c)}${c.note ? `  — ${c.note}` : ""}`
 							)
 						: ["  (none)"]),
 					"",
 					"Likely churned (not recorded):",
 					...(r.likely.length
-						? r.likely.map((l) => `  ${accountLine(l.account)}\n    ${l.signal}`)
+						? r.likely.map((l) => `  ${accountLine(l.account)}${cause(l)}\n    ${l.signal}`)
 						: ["  (none)"]),
+					"",
+					"Payments failing now:",
+					...(r.failing == null
+						? ["  (unavailable: the billing read failed, so this is not an all-clear)"]
+						: r.failing.length
+							? r.failing.map(
+									(f) =>
+										`  ${f.name}  ${f.amountCents == null ? "amount unknown" : usd(f.amountCents)}${f.since ? `  since ${f.since.slice(0, 10)}` : ""}${f.attempts != null ? `  ${f.attempts} attempt${f.attempts === 1 ? "" : "s"}` : ""}  → ${f.action ?? (f.nudgeInHours != null ? `wait ${f.nudgeInHours}h (Stripe retrying)` : "none")}  (${f.accountId ?? "no account"})\n    ${f.reason}`
+								)
+							: ["  (none)"]),
 				].join("\n")
 			);
 		}
@@ -3381,6 +3412,8 @@ async function cmdAdminCrm(ctx) {
 					note: flagStr(flags.note),
 					churned_at: flagStr(flags.at),
 					mrr_cents: flagNum(flags["mrr-cents"]),
+					cause: flagStr(flags.cause),
+					notice_at: flagStr(flags["notice-at"]),
 				})
 			);
 			return out(
@@ -3406,6 +3439,69 @@ async function cmdAdminCrm(ctx) {
 					: `${x.status.replaceAll("_", " ")}${x.detail ? ` (${x.detail.replaceAll("_", " ")})` : ""}`
 			);
 		}
+		case "outcomes": {
+			// admin crm outcomes [--account id] [--kind …] [--status …] [--since ISO] [--until ISO] [--limit N]
+			const params = new URLSearchParams(
+				compact({
+					account_id: flagStr(flags.account),
+					kind: flagStr(flags.kind),
+					status: flagStr(flags.status),
+					since: flagStr(flags.since),
+					until: flagStr(flags.until),
+					limit: flagStr(flags.limit),
+				})
+			);
+			return out(await staffRequest(ctx, "GET", `${CRM}/outcomes?${params}`), (r) =>
+				r.outcomes.length ? r.outcomes.map(outcomeLine).join("\n") : "(no outcomes)"
+			);
+		}
+		case "record-outcome": {
+			// admin crm record-outcome <account-id> <kind> [--reason code] [--also a,b] … [--draft]
+			if (!id || !action) {
+				throw new CliError(
+					'Usage: admin crm record-outcome <account-id> <churn|contraction|expansion|reactivation|save> [--reason code] [--also a,b] [--cause voluntary|involuntary|unknown] [--notice-at ISO] [--at ISO] [--mrr-before N] [--mrr-after N] [--note "…"] [--save-offer discount|pause|downgrade|fix|other] [--save-result kept|lost|pending] [--draft]'
+				);
+			}
+			const also = flagStr(flags.also);
+			const r = await staffPost(
+				ctx,
+				`${CRM}/outcomes`,
+				compact({
+					account_id: id,
+					kind: action,
+					status: flagBool(flags.draft) ? "draft" : undefined,
+					primary_reason: flagStr(flags.reason),
+					contributing_reasons: also ? also.split(",").map((x) => x.trim()) : undefined,
+					cause: flagStr(flags.cause),
+					notice_at: flagStr(flags["notice-at"]),
+					effective_at: flagStr(flags.at),
+					mrr_before_cents: flagNum(flags["mrr-before"]),
+					mrr_after_cents: flagNum(flags["mrr-after"]),
+					note: flagStr(flags.note),
+					save_offer: flagStr(flags["save-offer"]),
+					save_result: flagStr(flags["save-result"]),
+				})
+			);
+			return out(
+				r,
+				(x) =>
+					`${x.outcome.status === "draft" ? "drafted (a person confirms it)" : "recorded"}: ${outcomeLine(x.outcome)}`
+			);
+		}
+		case "renewals": {
+			// admin crm renewals [--days 90] — contracts renewing soon, and Stripe cancels scheduled.
+			const params = new URLSearchParams(compact({ days: flagStr(flags.days) }));
+			return out(await staffRequest(ctx, "GET", `${CRM}/renewals?${params}`), (r) =>
+				r.renewals.length
+					? r.renewals
+							.map(
+								(x) =>
+									`${x.daysLeft == null ? "  ?" : String(x.daysLeft).padStart(3)}d  ${x.name}  ${x.renewsAt ? `renews ${x.renewsAt}${x.noticeBy ? ` (notice by ${x.noticeBy})` : ""}` : ""}${x.cancelScheduledAt ? `  cancel scheduled${x.cancelsAt ? `, ends ${x.cancelsAt.slice(0, 10)}` : ""}` : ""}  ${x.accountId}`
+							)
+							.join("\n")
+					: `(nothing in the next ${r.days} days)`
+			);
+		}
 		case "undo-churn": {
 			// admin crm undo-churn <account-id> — clear the churn and move back to active.
 			if (!id) throw new CliError("Usage: admin crm undo-churn <account-id>");
@@ -3460,7 +3556,7 @@ async function cmdAdminCrm(ctx) {
 		}
 		default:
 			throw new CliError(
-				"Usage: admin crm import|capture|outreach|signals|record|signal|accounts|account|score|slack-channels|link-slack|white-glove|set-white-glove|churn|record-churn|draft-churn-reason|undo-churn|onboard|onboarding|retry-onboarding|onboard-plan|payment-link … (see --help)"
+				"Usage: admin crm import|capture|outreach|signals|record|signal|accounts|account|score|slack-channels|link-slack|white-glove|set-white-glove|churn|record-churn|draft-churn-reason|undo-churn|outcomes|record-outcome|renewals|onboard|onboarding|retry-onboarding|onboard-plan|payment-link … (see --help)"
 			);
 	}
 }

package/package.json

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