@letterstory/cli 0.128.2 → 0.129.0

package/lib/cli.mjs

@@ -62,7 +62,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.128.2";
+export const VERSION = "0.129.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
@@ -923,6 +923,7 @@ 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]
           | case <account-id> [--outcome <outcome-id>]
@@ -955,6 +956,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

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|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)}%`);
@@ -3690,7 +3697,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|case|onboard|onboarding|retry-onboarding|onboard-plan|payment-link … (see --help)"
 			);
 	}
 }

package/lib/commands/visits.mjs

@@ -97,7 +97,12 @@ async function visitsList(ctx) {
 	const { flags, io } = ctx;
 	const result = await call(ctx, "visitors_get_agent_visits");
 	printResult(io, flags, result, (r) => {
-		const lines = [`${r.total} agent visits since ${r.since} (${r.verified} verified)`];
+		const verified = r.verified !== null && r.verified !== undefined ? ` (${r.verified} verified)` : "";
+		const lines = [`${r.total} agent visits since ${r.since}${verified}`];
+		if (r.source === "visitors" && r.baseline)
+			lines.push(
+				`Counted from ${r.baseline}, the site's move to its current traffic source${r.lettervisit_verified !== null ? `; LetterVisit verified ${r.lettervisit_verified} since then` : ""}.`
+			);
 		const why = Object.entries(r.by_purpose ?? {})
 			.filter(([, n]) => n > 0)
 			.map(([p, n]) => `${PURPOSE_LABELS[p] ?? p} ${n}`);
@@ -105,7 +110,9 @@ async function visitsList(ctx) {
 		if (r.agents?.length) {
 			lines.push("", "Agents:");
 			for (const a of r.agents)
-				lines.push(`  ${a.agent.padEnd(14)} ${String(a.total).padStart(6)}  (${a.verified} verified)`);
+				lines.push(
+					`  ${a.agent.padEnd(22)} ${String(a.total).padStart(6)}${a.verified !== null && a.verified !== undefined ? `  (${a.verified} verified)` : ""}`
+				);
 		}
 		if (r.top_paths?.length) {
 			lines.push("", "Most read:");

package/package.json

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