@letterstory/cli 0.128.3 → 0.129.2

package/lib/cli.mjs

@@ -62,7 +62,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.128.3";
+export const VERSION = "0.129.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
@@ -923,8 +923,10 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
           | renewals [--days 90]
           | reach-outs [--day YYYY-MM-DD] [--fresh]   the day's reach-outs, N of 5 (#crm-reminders' count)
           | track-record [--since YYYY-MM-DD] | at-risk | expansion-signals
+          | weekly-note                       the Monday retention note for the last full week
           | collections [--org-ids a,b | --account-stages won,active]
-          | delivery-flags [--org-ids a,b | --account-stages won,active] [--include collections]
+          | delivery-flags [--org-ids a,b | --account-stages won,active] [--include collections] [--since 2026-10-19T20:00:00Z]
+          | pulse [--ids a,b] [--since 2026-10-19T20:00:00Z]   how each client is doing, worst churn risk first
           | 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]
@@ -955,6 +957,8 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
                                                        next-product rule was right (rates show once
                                                        15 outcomes and 90 days exist). At-risk and
                                                        expansion signals show the closest past case.
+                                                       Weekly note: the note #crm-opportunities
+                                                       gets on Mondays (reads only).
                                                        Onboard runs org → link → phantom sites →
                                                        Slack channel → checklist → app invites →
                                                        stage in one call (--site "" = infer the
@@ -1333,6 +1337,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 fix <host> <observation-id>... [--action build|build_pr|build_merge|slack|linear|handoff] [--with-preview]
+                                                       One change for N observations; handoff prints the prompt, slack/linear need no repo
   site competitors [--since <iso> | --days <n>] [--limit <n>]  Tracked competitors' sites: new and removed pages, by folder
   site watch-competitors [domain] [--limit <n>]        Map competitors' sitemaps (the next few unmapped, or one now)
   site highlight <domain> [--off]                      Highlight a competitor; its changes lead the top changes

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|reach-outs|record-churn|draft-churn-reason|undo-churn|outcomes|record-outcome|renewals|track-record|at-risk|expansion-signals|collections|delivery-flags|case|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|reach-outs|record-churn|draft-churn-reason|undo-churn|outcomes|record-outcome|renewals|track-record|weekly-note|at-risk|expansion-signals|collections|delivery-flags|pulse|case|onboard|onboarding|retry-onboarding|onboard-plan|payment-link …  (crm:read / crm:write)
 //   admin spend summary|reconcile|pnl|margin|pricing|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)
@@ -3523,6 +3523,13 @@ async function cmdAdminCrm(ctx) {
 					: `(nothing in the next ${r.days} days)`
 			);
 		}
+		case "weekly-note": {
+			// admin crm weekly-note — the Monday retention note for the last full ISO week (reads only; never posts).
+			return out(
+				await staffRequest(ctx, "GET", `${CRM}/weekly-note`),
+				(r) => `${r.week.key} (${r.week.from} to ${r.week.to})\n\n${r.text}`
+			);
+		}
 		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)}%`);
@@ -3589,27 +3596,62 @@ async function cmdAdminCrm(ctx) {
 			);
 		}
 		case "delivery-flags": {
-			// admin crm delivery-flags [--org-ids a,b | --account-stages won,active] [--include collections]
+			// admin crm delivery-flags [--org-ids a,b | --account-stages won,active] [--include collections] [--since <ISO time, e.g. 2026-10-19T20:00:00Z>]
 			// — does what we spend on a client match what they pay? Findings per org, worst first.
+			// The post-sales stages come from a snapshot (~10 min); --since skips one older than that.
 			const params = new URLSearchParams(
 				compact({
 					org_ids: flagStr(flags["org-ids"]),
 					account_stages: flagStr(flags["account-stages"]),
 					include: flagStr(flags.include),
+					since: flagStr(flags.since),
 				})
 			);
 			return out(await staffRequest(ctx, "GET", `${CRM}/delivery-flags?${params}`), (r) => {
 				if (!r.accounts)
 					return "Billing cannot say who pays yet, so there are no flags (collections are in --json).";
 				const flagged = r.accounts.filter((a) => a.findings.length);
-				return flagged.length
-					? flagged
-							.map(
-								(a) =>
-									`${a.owedDelivery ? "owed  " : a.notPaying ? "unpaid" : "      "}  ${a.orgName}  ${a.findings.map((f) => f.message).join("; ")}  ${a.orgId}`
-							)
-							.join("\n")
-					: `(${r.accounts.length} org${r.accounts.length === 1 ? "" : "s"}, nothing flagged)`;
+				const asOf = r.snapshot
+					? `(as of ${r.snapshot.computedAt}${r.snapshot.stale ? ", STALE: the refresh is failing" : ""})\n`
+					: "";
+				return (
+					asOf +
+					(flagged.length
+						? flagged
+								.map(
+									(a) =>
+										`${a.owedDelivery ? "owed  " : a.notPaying ? "unpaid" : "      "}  ${a.orgName}  ${a.findings.map((f) => f.message).join("; ")}  ${a.orgId}`
+								)
+								.join("\n")
+						: `(${r.accounts.length} org${r.accounts.length === 1 ? "" : "s"}, nothing flagged)`)
+				);
+			});
+		}
+		case "pulse": {
+			// admin crm pulse [--ids a,b] [--since <ISO time, e.g. 2026-10-19T20:00:00Z>]
+			// — how is each client doing? One line per account, worst churn risk first.
+			// The default scope comes from a snapshot (~10 min); --since skips one older than that.
+			const params = new URLSearchParams(compact({ ids: flagStr(flags.ids), since: flagStr(flags.since) }));
+			return out(await staffRequest(ctx, "GET", `${CRM}/pulse?${params}`), (r) => {
+				const rank = { high: 0, watch: 1, ok: 2 };
+				const rows = Object.entries(r.pulses).sort(
+					([, a], [, b]) =>
+						rank[a.churnRisk.level] - rank[b.churnRisk.level] || b.churnRisk.score - a.churnRisk.score
+				);
+				const asOf = r.snapshot
+					? `(as of ${r.snapshot.computedAt}${r.snapshot.stale ? ", STALE: the refresh is failing" : ""})\n`
+					: "";
+				return (
+					asOf +
+					(rows.length
+						? rows
+								.map(
+									([id, p]) =>
+										`${p.churnRisk.level.padEnd(5)}  ${p.phantomPostsLast30d} phantom posts in 30d${p.clicksTrend === null ? "" : ` · clicks ${p.clicksTrend >= 0 ? "+" : ""}${Math.round(p.clicksTrend * 100)}%`}${p.slackWaiting ? ` · ${p.slackWaiting} waiting in Slack` : ""}${p.nextProduct ? ` · next: ${p.nextProduct}` : ""}${p.churnRisk.reasons.length ? `  ${p.churnRisk.reasons.join("; ")}` : ""}  ${id}`
+								)
+								.join("\n")
+						: "(no accounts in that scope)")
+				);
 			});
 		}
 		case "case": {
@@ -3690,7 +3732,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|revenue|reach-outs|record-churn|draft-churn-reason|undo-churn|outcomes|record-outcome|renewals|track-record|at-risk|expansion-signals|collections|delivery-flags|case|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|revenue|reach-outs|record-churn|draft-churn-reason|undo-churn|outcomes|record-outcome|renewals|track-record|weekly-note|at-risk|expansion-signals|collections|delivery-flags|pulse|case|onboard|onboarding|retry-onboarding|onboard-plan|payment-link … (see --help)"
 			);
 	}
 }

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", "linear"] },
+		action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack", "linear", "handoff"] },
 		// --with-preview: the PR opens straight away and a preview of the fix stays up next to it.
 		with_preview: { flag: "with-preview", type: "bool" },
 	},
@@ -557,9 +557,19 @@ async function siteFix(ctx) {
 	const result = await client.callTool("fix_site_observations", args);
 	ok(ctx, result.message);
 	printResult(io, flags, result, (r) => {
-		const lines = [`${r.run.id}  ${r.run.repo}  [${r.run.status}]${r.reused ? "  (already running)" : ""}`];
+		// Handed off (action handoff, or slack / linear with no repo): no run; the prompt itself, or where it went.
+		const lines = r.run
+			? [`${r.run.id}  ${r.run.repo}  [${r.run.status}]${r.reused ? "  (already running)" : ""}`]
+			: r.handoff?.kind === "slack"
+				? [`sent to Slack${r.handoff.permalink ? `  ${r.handoff.permalink}` : ""}`]
+				: r.handoff?.kind === "linear"
+					? [
+							`filed in Linear${r.handoff.issue ? `  ${r.handoff.issue.identifier}  ${r.handoff.issue.url}` : ""}`,
+						]
+					: [];
 		for (const id of r.fixing) lines.push(`  fixing  ${id}`);
 		for (const s of r.skipped) lines.push(`  skipped ${s.id}  ${s.reason}`);
+		if (r.handoff?.kind === "prompt") lines.push("", r.handoff.instructions);
 		return lines.join("\n");
 	});
 	return 0;

package/package.json

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