@letterstory/cli 0.117.0 → 0.120.1

package/lib/cli.mjs

@@ -60,7 +60,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.117.0";
+export const VERSION = "0.120.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
@@ -769,7 +769,7 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
           | import <file.csv> [--vendor Concentrate] [--area A] [--ledger-key K] [--dry-run]
           | import <file.csv> [--vendor Concentrate] [--area A] [--keep-ledger-key] [--dry-run]
           | usage <events.json>                       per-call costs as kernels/lettertrace push them
-          | remove <entry-id> | services | service <slug> [--owner …] [--monthly N|none] [--renewal D]
+          | remove <entry-id> | services | service <slug> [--owner …] [--monthly N|none] [--renewal D] [--units N|none]
                                                        Where Letter's money goes (spending.letter.dev):
                                                        totals, run rate, area/vendor/provider/model/
                                                        key/operation/org breakdowns, every number's
@@ -795,6 +795,8 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
                      [--at ISO] [--mrr-before N] [--mrr-after N] [--note "…"] [--save-offer …]
                      [--save-result …] [--draft]
           | renewals [--days 90]
+          | track-record [--since YYYY-MM-DD] | at-risk | expansion-signals
+          | case <account-id> [--outcome <outcome-id>]
           | 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>
@@ -820,6 +822,10 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
                                                        reason; a key records drafts a person
                                                        confirms. Renewals: contracts renewing
                                                        within N days, and Stripe cancels scheduled.
+                                                       Track record: how often each churn-risk and
+                                                       next-product rule was right (rates show once
+                                                       15 outcomes and 90 days exist). At-risk and
+                                                       expansion signals show the closest past case.
                                                        Onboard runs org → link → phantom sites →
                                                        Slack channel → checklist → app invites →
                                                        stage in one call (--site "" = infer the
@@ -914,6 +920,8 @@ 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 linear [teams [--team <id|key>] | set --team <id|key> [--project <id>|none] | disconnect]
+                                                       Where Letter files Linear issues (connect in Settings)
   org diff <file|dir>                                  What applying a bundle would change (reads only)
   org apply <file|dir> [--dry-run] [--prune --yes]     Make the org match a bundle (adds/updates; --prune deletes)
                 [--allow spends,sends,destroys,access --yes]  Also apply gated changes (admins; without --yes it only previews)
@@ -1203,7 +1211,7 @@ Repo changes (Claude Code edits your repo in a sandbox; the Letterstory GitHub A
   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
-  repo settings [--action build|build_pr|build_merge|slack] [--branch <name>|none] [--slack-agent <name|U…>|none]
+  repo settings [--action build|build_pr|build_merge|slack|linear] [--branch <name>|none] [--slack-agent <name|U…>|none]
                 [--slack-channel <C…>|none] [--slack-reports off|as_found|daily] [--reports-channel <C…>|none] [--autopilot-channel <C…>|none] [--listen <C…,C…>|none] [--autopilot on|off] [--autopilot-weekly <1-20>]
                 [--autopilot-severity critical|warning]
                                                        The org's defaults for every fix: build (preview first),
@@ -1213,13 +1221,13 @@ Repo changes (Claude Code edits your repo in a sandbox; the Letterstory GitHub A
   repo slack-test                                      Post a test into the Send to Slack channel
   repo start --repo <owner/name> --instructions <text>|--instructions-file <path|->
              [--branch <base>] [--attach <path>]... [--attach-url <name>=<https url>]...
-             [--action build|build_pr|build_merge|slack] [--wait]
+             [--action build|build_pr|build_merge|slack|linear] [--wait]
                                                        Start a change (attached files go to the sandbox);
                                                        --wait follows it to the PR
-  repo fix-audit --issue <issue-type>... [--audit <id>] [--branch <base>] [--action build|build_pr|build_merge|slack] [--wait]
+  repo fix-audit --issue <issue-type>... [--audit <id>] [--branch <base>] [--action build|build_pr|build_merge|slack|linear] [--wait]
                                                        One PR fixing site-audit issues (repeat --issue to bundle) on every affected page,
                                                        in the repo verified to build the site
-  repo install-letterprove --repo <owner/name> [--branch <base>] [--action build|build_pr|build_merge|slack] [--wait]
+  repo install-letterprove --repo <owner/name> [--branch <base>] [--action build|build_pr|build_merge|slack|linear] [--wait]
                                                        One PR adding Letterprove's script and identify calls
                                                        (pick the repo where users sign in)
   repo sites [--detect [--force]]                      Which website each repo builds, and the evidence

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|outcomes|record-outcome|renewals|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|track-record|at-risk|expansion-signals|case|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)
@@ -3502,6 +3502,79 @@ async function cmdAdminCrm(ctx) {
 					: `(nothing in the next ${r.days} days)`
 			);
 		}
+		case "track-record": {
+			// admin crm track-record [--since YYYY-MM-DD] — how often each risk and next-product rule was right.
+			const pct = (x) => (x == null ? "—" : `${Math.round(x * 100)}%`);
+			const params = new URLSearchParams(compact({ since: flagStr(flags.since) }));
+			return out(await staffRequest(ctx, "GET", `${CRM}/track-record?${params}`), (r) =>
+				[
+					`Since ${r.since ?? "—"} · confirmed: ${r.outcomes.churn} churn, ${r.outcomes.contraction} contraction, ${r.outcomes.expansion} expansion · rates show at ${r.minOutcomes} outcomes and ${r.windowDays} days`,
+					`Base rate: loss ${pct(r.base.loss.rate)} · expansion ${pct(r.base.expansion.rate)}`,
+					"",
+					...r.predictors.map(
+						(p) =>
+							`${p.key.padEnd(40)} flagged ${String(p.flagged).padStart(3)}  matured ${String(p.matured).padStart(3)}  hits ${String(p.hits).padStart(3)}  missed ${String(p.missed).padStart(3)}  rate ${pct(p.maturedRate.rate)}  acted ${pct(p.acted.rate)} / not ${pct(p.notActed.rate)}${p.mature ? "" : `  (not mature: ${p.notMatureBecause})`}`
+					),
+				].join("\n")
+			);
+		}
+		case "at-risk": {
+			// admin crm at-risk — customers at watch or high, with the closest past churn.
+			const caseLine = (c) =>
+				c
+					? `\n    like ${c.name} (${c.kind} ${c.on}${c.primaryReason ? `, ${c.primaryReason}` : ""}): ${c.matched}/5 matched — ${c.features
+							.filter((f) => f.matched)
+							.map((f) => `${f.feature} ${f.now}`)
+							.join(", ")}`
+					: "\n    no past case matches 3 of 5";
+			return out(await staffRequest(ctx, "GET", `${CRM}/at-risk`), (r) =>
+				r.accounts.length
+					? r.accounts
+							.map(
+								(a) =>
+									`${a.level.padEnd(5)} ${a.score.toFixed(2)}  ${a.name}  ${a.reasons.join("; ")}  ${a.accountId}${caseLine(a.closestCase)}`
+							)
+							.join("\n")
+					: "(nobody at watch or high)"
+			);
+		}
+		case "expansion-signals": {
+			// admin crm expansion-signals — next-product verdicts on the latest snapshot.
+			return out(await staffRequest(ctx, "GET", `${CRM}/expansion-signals`), (r) =>
+				r.signals.length
+					? r.signals
+							.map(
+								(x) =>
+									`${x.score.toFixed(2)}  ${x.name} → ${x.product} (${x.rule})  ${x.reasons.join("; ")}  ${x.accountId}${x.beforePastExpansions.length ? `\n    before past expansions: ${x.beforePastExpansions.map((p) => `${p.name} ${p.on}`).join(", ")}` : ""}`
+							)
+							.join("\n")
+					: "(no next-product verdicts)"
+			);
+		}
+		case "case": {
+			// admin crm case <account-id> [--outcome <id>] — the 90 days before an outcome, or before today.
+			if (!id) throw new CliError("Usage: admin crm case <account-id> [--outcome <outcome-id>]");
+			const params = new URLSearchParams(compact({ outcomeId: flagStr(flags.outcome) }));
+			const usd = (c) => `$${Math.round(c / 100).toLocaleString("en-US")}`;
+			return out(await staffRequest(ctx, "GET", `${CRM}/accounts/${id}/case?${params}`), (r) =>
+				[
+					`${r.name}  ${r.from} → ${r.until}${r.outcome ? `  ${outcomeLine(r.outcome)}` : ""}`,
+					r.signalsBefore.length
+						? `Signals before: ${r.signalsBefore.map((x) => `${x.rule} from ${x.firstFiredOn} (${x.days}d)`).join(", ")}`
+						: "Signals before: none",
+					"",
+					...r.series.map(
+						(p) =>
+							`${p.on}  ${usd(p.revenueCents)}  posts ${p.phantomPosts30d}  clicks ${p.clicks28d ?? "—"}  cites ${p.aiCitations28d ?? "—"}  waiting ${p.slackWaiting}  quiet ${p.quietDays ?? "—"}  ${p.riskLevel}`
+					),
+					"",
+					...r.events.map(
+						(e) =>
+							`${e.at.slice(0, 10)}  ${e.kind}  ${e.title}${e.detail ? `\n    ${e.detail}` : ""}${e.quotes.map((q) => `\n    "${q}"`).join("")}`
+					),
+				].join("\n")
+			);
+		}
 		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>");
@@ -3556,7 +3629,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|outcomes|record-outcome|renewals|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|track-record|at-risk|expansion-signals|case|onboard|onboarding|retry-onboarding|onboard-plan|payment-link … (see --help)"
 			);
 	}
 }
@@ -4083,11 +4156,14 @@ async function cmdAdminSpend(ctx) {
 				renewal_date: flagStr(flags.renewal),
 				notes: flagStr(flags.notes),
 				billing_source: oneOf(flags, "billing", ["api", "invoice", "unknown"]),
+				units_purchased: flags.units === "none" ? undefined : flagNum(flags.units),
+				unit_label: flagStr(flags["unit-label"]),
 			});
 			if (flags.monthly === "none") update.monthly_cost_usd = null;
+			if (flags.units === "none") update.units_purchased = null;
 			if (!slug || Object.keys(update).length === 0) {
 				throw new CliError(
-					'Usage: admin spend service <slug> [--owner "Steve"] [--plan "Pro"] [--monthly 20|none] [--renewal 2026-11-01] [--notes "…"] [--billing api|invoice|unknown]'
+					'Usage: admin spend service <slug> [--owner "Steve"] [--plan "Pro"] [--monthly 20|none] [--renewal 2026-11-01] [--notes "…"] [--billing api|invoice|unknown] [--units 30|none] [--unit-label "mailbox slots"]'
 				);
 			}
 			const result = await staffRequest(ctx, "PATCH", `${SPEND}/services/${encodeURIComponent(slug)}`, update);

package/lib/commands/org.mjs

@@ -27,6 +27,13 @@ export const ARGS = {
 	},
 	get_org_config_source: {},
 	list_integrations: {},
+	get_linear_connection: {},
+	list_linear_targets: { team_id: { flag: "team" } },
+	set_linear_target: {
+		team_id: { flag: "team", required: true, label: "team" },
+		project_id: { value: (flags) => (flags.project === "none" ? null : flagStr(flags.project)) },
+	},
+	disconnect_linear: {},
 	connect_org_config_source: {
 		repo: { positional: 0, label: "owner/name" },
 		branch: { flag: "branch" },
@@ -56,9 +63,11 @@ export async function cmdOrg(ctx) {
 			return orgGit(rest);
 		case "integrations":
 			return orgIntegrations(rest);
+		case "linear":
+			return orgLinear(rest);
 		default:
 			throw new CliError(
-				`Unknown org subcommand: ${sub ?? "(none)"}. Try: export, join, diff, apply, git, integrations`
+				`Unknown org subcommand: ${sub ?? "(none)"}. Try: export, join, diff, apply, git, integrations, linear`
 			);
 	}
 }
@@ -75,6 +84,53 @@ async function orgIntegrations(ctx) {
 	return 0;
 }
 
+/**
+ * `org linear` — where Letter files Linear issues (connecting is OAuth, in Settings):
+ *   org linear                                   the connection (get_linear_connection)
+ *   org linear teams [--team <id|key>]           teams, and a team's projects (list_linear_targets)
+ *   org linear set --team <id|key> [--project <id>|none]   (set_linear_target)
+ *   org linear disconnect                        (disconnect_linear)
+ */
+async function orgLinear(ctx) {
+	const { client, flags, io } = ctx;
+	const sub = ctx.positionals[0] ?? "show";
+	const call = async (tool, allowed) => {
+		refuseUnknownFlags(ctx, {}, allowed);
+		const result = await client.callTool(tool, argsFromFlags(ARGS[tool], flags, ctx.positionals.slice(1)));
+		ok(ctx, result.message);
+		return result;
+	};
+	switch (sub) {
+		case "show": {
+			const result = await call("get_linear_connection", []);
+			printResult(io, flags, result, (r) => r.message);
+			return 0;
+		}
+		case "teams": {
+			const result = await call("list_linear_targets", ["team"]);
+			printResult(io, flags, result, (r) =>
+				[
+					...r.teams.map((t) => `${t.id === r.team_id ? "●" : "○"} ${t.key}  ${t.name}  (${t.id})`),
+					...(r.projects.length ? ["", "Projects:", ...r.projects.map((p) => `  ${p.name}  (${p.id})`)] : []),
+				].join("\n")
+			);
+			return 0;
+		}
+		case "set": {
+			const result = await call("set_linear_target", ["team", "project"]);
+			printResult(io, flags, result, (r) => r.message);
+			return 0;
+		}
+		case "disconnect": {
+			const result = await call("disconnect_linear", []);
+			printResult(io, flags, result, (r) => r.message);
+			return 0;
+		}
+		default:
+			throw new CliError(`Unknown org linear subcommand: ${sub}. Try: teams, set, disconnect`);
+	}
+}
+
 const ROOT_FILE = "organization.json";
 
 function slug(name) {

package/lib/commands/repo.mjs

@@ -49,7 +49,7 @@ const ARGS = {
 		instructions: { value: (flags) => readTextInput(flags, "instructions", "instructions-file") },
 		// --attach <path> (uploaded first) and --attach-url <name>=<https url>, both repeatable.
 		files: { value: (_flags, _positionals, extra) => (extra.files?.length ? extra.files : undefined) },
-		action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack"] },
+		action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack", "linear"] },
 		preview: { flag: "preview", type: "bool" },
 	},
 	create_repo_change_upload: { file_names: { internal: "the basenames of the --attach files" } },
@@ -74,21 +74,21 @@ const ARGS = {
 		issue_types: { value: (flags) => (issueList(flags).length > 1 ? issueList(flags) : undefined) },
 		audit_id: "audit",
 		base_branch: "branch",
-		action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack"] },
+		action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack", "linear"] },
 		preview: { flag: "preview", type: "bool" },
 	},
 	letterprove_open_install_pr: {
 		repo_owner: { value: (flags) => splitRepo(flags).owner },
 		repo_name: { value: (flags) => splitRepo(flags).name },
 		base_branch: "branch",
-		action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack"] },
+		action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack", "linear"] },
 	},
 	get_repo_change_settings: {},
 	list_suggested_fixes: {},
 	list_slack_fix_targets: {},
 	send_slack_test_message: {},
 	set_repo_change_settings: {
-		default_action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack"] },
+		default_action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack", "linear"] },
 		// --branch <name>, or --branch none for each repo's own default.
 		default_branch: { value: (flags) => (flags.branch === "none" ? null : flagStr(flags.branch)) },
 		// --slack-agent Devin (or a U… member id), or --slack-agent none to tag nobody.
@@ -115,6 +115,8 @@ const ARGS = {
 								.map((c) => c.trim())
 								.filter(Boolean),
 		},
+		// --linear-reports off|as_found: file each new finding as a Linear issue
+		linear_reports: { flag: "linear-reports", enum: ["off", "as_found"] },
 		// --listen-all on|off: answer messages meant for Letter in every channel it's in
 		slack_listen_all: {
 			value: (flags) =>

package/lib/commands/site.mjs

@@ -177,7 +177,7 @@ const ARGS = {
 		},
 		base_branch: { flag: "base-branch" },
 		preview: { flag: "preview", type: "bool" },
-		action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack"] },
+		action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack", "linear"] },
 	},
 };
 

package/package.json

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