@letterstory/cli 0.108.0 → 0.108.2

package/lib/cli.mjs

@@ -60,7 +60,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.108.0";
+export const VERSION = "0.108.2";
 
 // 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
@@ -1160,7 +1160,8 @@ 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]     The tree one folder at a time, one item per node
+  site tree <host> [path] [--depth <n>] [--unfold] [--since <iso>]
+                                                       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>]
   site observe <host> [path] [--max-pages <n>]         Jev pass: meta accuracy, title, outdated
@@ -1172,6 +1173,8 @@ The Site (one model of your whole marketing site, keyed by host and path):
   site propose <host> [path] --tool <tool> --input '<json>'|--input-file <p> --label <text> [--why <text>]
                      [--observation <id>]...           Propose a registry tool call; input is validated now
   site decide <proposal-id> --decision accept|dismiss [--reason <why>]
+  site competitors [--since <iso>] [--limit <n>]       Tracked competitors' sites: new and removed pages, by folder
+  site watch-competitors [domain]                      Map competitors' sitemaps (every unmapped one, or one now)
 
 Repo changes (Claude Code edits your repo in a sandbox; the Letterstory GitHub App opens a PR):
   repo repos                                           Repos the Letterstory GitHub App can reach

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/site.mjs

@@ -7,6 +7,7 @@
 //   site families <host>     → list_site_families       site decide-family <id>    → decide_site_family
 //   site proposals <host>    → list_site_proposals      site propose <host>        → create_site_proposal
 //   site decide <proposal>   → decide_site_proposal    site fix <host> <id>…     → fix_site_observations
+//   site competitors         → list_competitor_sites    site watch-competitors [d] → watch_competitor_sites
 
 import { CliError } from "../client.mjs";
 import { argsFromFlags, flagList, flagStr, ok, printResult, readTextInput, refuseUnknownFlags } from "./shared.mjs";
@@ -56,7 +57,13 @@ const ARGS = {
 		depth: { flag: "depth", type: "num" },
 		unfold: { flag: "unfold", type: "bool" },
 		subtree: { flag: "subtree", type: "bool" },
+		since: { flag: "since" },
 	},
+	list_competitor_sites: {
+		since: { flag: "since" },
+		limit: { flag: "limit", type: "num" },
+	},
+	watch_competitor_sites: { domain: { positional: 0, label: "domain" } },
 	get_site_page: {
 		host: { positional: 0, required: true, label: "host" },
 		path: { positional: 1, required: true, label: "path" },
@@ -166,9 +173,13 @@ export async function cmdSite(ctx) {
 			return siteDecide(rest);
 		case "fix":
 			return siteFix(rest);
+		case "competitors":
+			return siteCompetitors(rest);
+		case "watch-competitors":
+			return siteWatchCompetitors(rest);
 		default:
 			throw new CliError(
-				`Unknown site subcommand: ${sub ?? "(none)"}. Try: list, map, refresh, unmap, tree, page, observations, observe, dismiss, families, decide-family, proposals, propose, decide, fix`
+				`Unknown site subcommand: ${sub ?? "(none)"}. Try: list, map, refresh, unmap, tree, page, observations, observe, dismiss, families, decide-family, proposals, propose, decide, fix, competitors, watch-competitors`
 			);
 	}
 }
@@ -180,7 +191,8 @@ function describeNode(node, indent = "") {
 	const line = node.item
 		? `${node.item.summary}${node.more ? ` and ${node.more} more` : ""}${node.item.action ? ` → ${node.item.action.label}` : ""}`
 		: "";
-	const counts = node.hasChildren ? ` (${node.rollup.pages} pages)` : "";
+	const changed = `${node.rollup.added ? ` +${node.rollup.added}` : ""}${node.rollup.removed ? ` -${node.rollup.removed}` : ""}`;
+	const counts = node.hasChildren ? ` (${node.rollup.pages} pages${changed})` : node.page?.added ? " (new)" : "";
 	const out = [`${indent}${glyph.padEnd(2)} ${node.name}${counts}${line ? `  ${line}` : ""}`];
 	for (const child of node.children ?? []) out.push(describeNode(child, `${indent}  `));
 	return out.join("\n");
@@ -203,6 +215,43 @@ async function siteList(ctx) {
 	return 0;
 }
 
+async function siteCompetitors(ctx) {
+	const { client, flags, io } = ctx;
+	refuseUnknownFlags(ctx, ARGS.list_competitor_sites);
+	const result = await client.callTool(
+		"list_competitor_sites",
+		argsFromFlags(ARGS.list_competitor_sites, flags, ctx.positionals)
+	);
+	printResult(io, flags, result, (r) => {
+		const lines = [`Since ${r.since.slice(0, 10)}:`];
+		for (const c of r.competitors) {
+			if (!c.changes) {
+				lines.push(`  ${c.name}  ${c.domain}  not mapped (letterstory site watch-competitors ${c.domain})`);
+				continue;
+			}
+			const folders = c.changes.folders.map((f) => `${f.path} +${f.added}${f.removed ? ` -${f.removed}` : ""}`);
+			lines.push(
+				`  ${c.name}  ${c.host}  ${c.changes.pages} pages  +${c.changes.added} -${c.changes.removed}${folders.length ? `  ${folders.join(", ")}` : ""}`
+			);
+			for (const p of c.changes.addedPages.slice(0, 5)) lines.push(`    + ${p.path}  ${p.at.slice(0, 10)}`);
+		}
+		return r.competitors.length ? lines.join("\n") : "No competitors tracked yet.";
+	});
+	return 0;
+}
+
+async function siteWatchCompetitors(ctx) {
+	const { client, flags, io } = ctx;
+	refuseUnknownFlags(ctx, ARGS.watch_competitor_sites);
+	const result = await client.callTool(
+		"watch_competitor_sites",
+		argsFromFlags(ARGS.watch_competitor_sites, flags, ctx.positionals)
+	);
+	ok(ctx, result.message);
+	printResult(io, flags, result, () => "");
+	return 0;
+}
+
 async function siteMap(ctx) {
 	const { client, flags, io } = ctx;
 	refuseUnknownFlags(ctx, ARGS.map_site);

package/package.json

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