@letterstory/cli 0.115.0 → 0.120.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.120.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,15 @@ 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]
+          | 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>
@@ -800,11 +810,22 @@ 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.
+                                                       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
@@ -899,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)
@@ -1188,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),
@@ -1198,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|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)
@@ -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,142 @@ 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 "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>");
@@ -3460,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|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)"
 			);
 	}
 }

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.115.0",
+	"version": "0.120.0",
 	"description": "Spin up and manage Letterstory phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",