@letterstory/cli 0.108.1 → 0.108.4

package/lib/cli.mjs

@@ -60,7 +60,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.108.1";
+export const VERSION = "0.108.4";
 
 // 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
@@ -623,7 +623,8 @@ Propose lane (the Fleet wizard's Plan and Name screens; persists nothing, spends
 What does this org still need? (the router — reads only, decides nothing):
   ${bin === "phantom" ? "onboard" : "phantom-onboard"} primitives [<domain>] [--retry]  The primitives that fit a domain (default:
                                                        yours), each with the exact call that sets
-                                                       it up — the plan Instances shows
+                                                       it up — the plan Instances shows;
+                                                       --primitives kernel,phantom keeps only those
   ${bin === "phantom" ? "onboard" : "phantom-onboard"} plan                         Every onboarding step (context, main blog,
                                                        Planner, CMS, phantom) with its status:
                                                        done / running / ready / blocked, and what
@@ -1160,7 +1161,7 @@ The Site (one model of your whole marketing site, keyed by host and path):
   site refresh <host> [--force-map] [--force-audit] [--skip-observe]
                                                        Run the daily loop now: re-map, re-audit, signals, Jev
   site unmap <host>                                    Remove a host and everything hanging off it
-  site tree <host> [path] [--depth <n>] [--unfold] [--since <iso>]
+  site tree <host> [path] [--depth <n>] [--unfold] [--since <iso>] [--focus-size <n|all>]
                                                        The tree one folder at a time; --since adds +N/-N per folder
   site page <host> <path>                              One page: facts, bindings, raw URLs, open items
   site observations <host> [path] [--state open|dismissed|resolved] [--tone risk|warn|info] [--key <k>] [--since <iso>] [--min-reach <0..1>]

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|record-churn|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|undo-churn|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)
@@ -3325,6 +3325,24 @@ async function cmdAdminCrm(ctx) {
 				].join("\n")
 			);
 		}
+		case "revenue": {
+			// admin crm revenue — monthly NRR/GRR since 2026-08-10, the bridge, spend per client (docs/architecture/retention.md).
+			const pct = (x) => (x == null ? "—" : `${(x * 100).toFixed(1)}%`);
+			const usd = (cents) => `$${Math.round(cents / 100).toLocaleString("en-US")}`;
+			return out(await staffRequest(ctx, "GET", `${CRM}/revenue`), (r) =>
+				[
+					r.headline
+						? `${r.headline.month}: NRR ${pct(r.headline.nrr)} · GRR ${pct(r.headline.grr)} · expansion ${usd(r.headline.expansionCents)} · avg ${r.headline.avgCents == null ? "—" : usd(r.headline.avgCents)}/client`
+						: "No complete month yet.",
+					`Clients counted: ${r.coverage.counted} (${r.coverage.stripe} Stripe, ${r.coverage.deal} deal) · comp ${r.coverage.comp} · ${usd(r.coverage.countedCents)}/mo`,
+					"",
+					...r.periods.map(
+						(p) =>
+							`${p.month}${p.partial ? " (partial)" : ""}${p.estimated ? " ~" : ""}  ${usd(p.startCents)} → ${usd(p.endCents)}  NRR ${pct(p.nrr)}  +new ${usd(p.moves.new)} +back ${usd(p.moves.reactivated)} +exp ${usd(p.moves.expansion)} −con ${usd(p.moves.contraction)} −churn ${usd(p.moves.churn)} ±reclassified ${usd(p.moves.reclassified)}`
+					),
+				].join("\n")
+			);
+		}
 		case "record-churn": {
 			// admin crm record-churn <account-id> <reason> [--note "…"] [--at ISO] [--mrr-cents N]
 			if (!id || !action) {

package/lib/commands/onboard.mjs

@@ -179,6 +179,8 @@ export const ARGS = {
 	propose_primitive_plan: {
 		domain: { positional: 0, label: "domain" },
 		retry: { flag: "retry", type: "bool" },
+		// Only these primitives, as a plan recipe allows: kernel,phantom,mailer,sequence.
+		primitives: { flag: "primitives", type: "list" },
 	},
 	propose_phantom_plan: {
 		client_domain: { positional: 0, label: "client-domain" },

package/lib/commands/site.mjs

@@ -58,6 +58,14 @@ const ARGS = {
 		unfold: { flag: "unfold", type: "bool" },
 		subtree: { flag: "subtree", type: "bool" },
 		since: { flag: "since" },
+		// The ranking's top n, or "all", instead of the attention policy's short list.
+		focus_size: {
+			value: (flags) => {
+				const raw = flags["focus-size"];
+				if (raw === undefined || raw === true) return undefined;
+				return raw === "all" ? "all" : Number(raw);
+			},
+		},
 	},
 	list_competitor_sites: {
 		since: { flag: "since" },

package/package.json

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