@letterstory/cli 0.177.25 → 0.177.27

package/lib/cli.mjs

@@ -88,7 +88,7 @@ import {
 import { fetchParkedSections, withoutParked } from "./parked.mjs";
 
 // Matches cli/package.json; publish-cli.yml rewrites both to the published version.
-export const VERSION = "0.177.25";
+export const VERSION = "0.177.27";
 
 /** The exit code for a gate refusal (CARD_REQUIRED, PAYMENT_FAILED, OUT_OF_TOKENS): 1 is a plain error. */
 export const EXIT_PAYMENT_REQUIRED = 3;
@@ -710,7 +710,7 @@ Reviewers:
                [--event <name>] [--kind post|landing] [--competitor <host>] [--site <host>]
                [--every <n> --unit hours|days|weeks|months] [--facts <a,b>] [--recipe <id>]
                [--fit-run <run-id> --publication-host <site>]
-               [--hot-leads-only] [--per-day <n>] [--backfill all|<YYYY-MM-DD>] [--off]
+               [--hot-leads-only] [--icp] [--per-day <n>] [--backfill all|<YYYY-MM-DD>] [--off]
                                                        Make one (a template fills what you leave out): it starts
                                                        from now (--backfill also runs it on past events, oldest
                                                        first), acts on its own, and posts each event it acts on
@@ -1361,7 +1361,7 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
           | payments [--org <org-id>] [--open] | payments retry <lago-invoice-id> | payments run [--dry]
           | signups [--status open|card_saved|provisioned|paid|abandoned|canceled]
           | cap <org-id> <dollars|off> [--why "…"] | cancel <org-id> --why "…" --yes
-          | move <org-id> --plan starter|growth|scale [--ratio N [--why "…"]] [--reason "…"] [--stripe-subscription sub_…] [--dry]
+          | move <org-id> --plan starter|growth|scale [--ratio N [--why "…"]] [--reason "…"] [--stripe-subscription sub_…] [--now] [--dry]
           | changes [--org <org-id>] | changes cancel <org-id>
                                                        Usage billing on Lago: the plan catalog, an org's
                                                        plan and gifted ratio, Lago's tokens against ours,
@@ -2012,7 +2012,7 @@ Visits (Visitors: AI agents reading your site, and AI answers sending people to
                                                        Who was identified, and who fits your ICP
   visits compare <agent-a> <agent-b> [--since 7d] [--path '/docs/*'] [--purpose <p>]
                                                        Pages one agent read that the other didn't
-  visits export [--since 30d] [--format json|csv] [--table agent_visits|citations]
+  visits export [--since 30d] [--format json|csv] [--table agent_visits|citations] [--include agents|people|companies] [--icp|--not-icp]
   visits sites                                         Your Visitors sites and their install checks
   visits domain <domain> [--site <id>] [--name <n>]    Move a site to a new domain, keeping its key
   visits pages [--since 28d] [--path '/docs/*'] [--agent <id>] [--limit <n>] [--site <id>]

package/lib/commands/admin.mjs

@@ -6254,8 +6254,8 @@ const LAGO_USAGE = `Usage: admin billing desk [--json]       the Billing desk: s
   signups end <org-id> --why "…"         end an org's signup in flight (not yet provisioned), so one on other terms can open
   cap <org-id> <dollars|off> [--why "…"]  set an account's monthly spend cap on overage (off: no cap)
   cancel <org-id> --why "…" --yes          end an account's Lago plan now (its plan fee refunded in its first month, once per org)
-  move <org-id> --plan starter [--ratio 4] [--why "…" above 4x] [--reason "…"] [--complimentary 20000] [--review 2027-05-01] [--stripe-subscription sub_…] [--dry]
-                                         move an existing customer from Stripe to Lago at their renewal
+  move <org-id> --plan starter [--ratio 4] [--why "…" above 4x] [--reason "…"] [--complimentary 20000] [--review 2027-05-01] [--stripe-subscription sub_…] [--now] [--dry]
+                                         move an existing customer from Stripe to Lago at their renewal (--now: today, the first invoice credited)
   changes [--org <org-id>]               term changes waiting to take effect (moves, cheaper plans, new ratios)
   changes cancel <org-id>                take back an org's scheduled change before it takes effect`;
 
@@ -6893,13 +6893,17 @@ async function cmdAdminBilling(ctx) {
 					complimentaryTokens: flagNum(flags.complimentary),
 					reviewAt: flagStr(flags.review),
 					stripeSubscriptionId: flagStr(flags["stripe-subscription"]),
+					startNow: flags.now ? true : undefined,
 					dryRun: flags.dry ? true : undefined,
 				})
 			);
 			const p = result.plan;
+			const credit = p.to.firstInvoiceCreditCents ?? 0;
 			ok(
 				ctx,
-				`${result.dryRun ? "Would move" : "Moving"} ${p.orgId} from Stripe ${p.from.stripeSubscriptionId} (${p.from.product ?? "subscription"}) to Lago ${p.to.plan} at its renewal ${p.from.renewsAt}: Stripe stops then, Lago charges $${(p.to.amountCents / 100).toFixed(2)} then (${p.to.includedTokens} tokens included, overage $${p.to.overageUsdPerToken} a token). Bonus when it takes effect: ${(p.to.bonusTokens ?? 0).toLocaleString("en-US")} tokens (signup × ${p.to.ratio}x), once.`
+				p.to.startsAt && p.to.startsAt !== p.from.renewsAt
+					? `${result.dryRun ? "Would move" : "Moving"} ${p.orgId} from Stripe ${p.from.stripeSubscriptionId} (${p.from.product ?? "subscription"}) to Lago ${p.to.plan} now: ${p.to.includedTokens} tokens from today, the first invoice $${((p.to.amountCents - credit) / 100).toFixed(2)} after $${(credit / 100).toFixed(2)} Stripe already took. Stripe stops at ${p.from.renewsAt}, when Lago charges $${(p.to.amountCents / 100).toFixed(2)} next.`
+					: `${result.dryRun ? "Would move" : "Moving"} ${p.orgId} from Stripe ${p.from.stripeSubscriptionId} (${p.from.product ?? "subscription"}) to Lago ${p.to.plan} at its renewal ${p.from.renewsAt}: Stripe stops then, Lago charges $${(p.to.amountCents / 100).toFixed(2)} then (${p.to.includedTokens} tokens included, overage $${p.to.overageUsdPerToken} a token). Bonus when it takes effect: ${(p.to.bonusTokens ?? 0).toLocaleString("en-US")} tokens (signup × ${p.to.ratio}x), once.`
 			);
 			printResult(io, flags, result);
 			return 0;

package/lib/commands/automate.mjs

@@ -48,6 +48,8 @@ const triggerParams = {
 		competitors: { flag: "competitor", type: "list" },
 		hosts: { flag: "site", type: "list" },
 		hot_leads_only: { flag: "hot-leads-only", type: "bool" },
+		// --icp: only people who fit the company's ICP (visitor_identified), checked against their stored fit.
+		icp: { flag: "icp", type: "bool" },
 		event: { flag: "event" },
 		per_day: { flag: "per-day", type: "num" },
 		// --trigger schedule --every 2 --unit weeks: a recurring automation, on the calendar (Monday, the 1st).

package/lib/commands/visits.mjs

@@ -11,6 +11,7 @@
 //   letterstory visits people --since 30d [--path /pricing]   people who read the site, and how many were identified
 //   letterstory visits who --icp [--category Investors] [--path /pricing]   who was identified (--icp: who fits your ICP)
 //   letterstory visits export --since 30d --format csv
+//   letterstory visits export --include people --icp > icp.csv   the people who fit your ICP, as Humans shows them
 //   letterstory visits sites
 //   letterstory visits domain composal.com [--site <id>]   move the site to a new domain, keeping its key
 //   letterstory visits pages --since 28d [--path '/docs/*'] [--agent openai-crawler]
@@ -77,7 +78,15 @@ export const ARGS = {
 		path: "path",
 		purpose: { flag: "purpose", enum: PURPOSES },
 	},
-	visitors_export: { site_id: "site", days, format: { flag: "format", enum: ["json", "csv"] } },
+	visitors_export: {
+		site_id: "site",
+		days,
+		format: { flag: "format", enum: ["json", "csv"] },
+		include: { flag: "include", enum: ["agents", "people", "companies"] },
+		icp: { flag: "icp", type: "bool", negate: "not-icp" },
+		category: "category",
+		path: "path",
+	},
 };
 
 /** `7d`, `7`, `2w` → days (1-90). Absent → undefined (the tool's default, 30). */
@@ -362,6 +371,12 @@ async function visitsCompare(ctx) {
 async function visitsExport(ctx) {
 	const { flags, io } = ctx;
 	const result = await call(ctx, "visitors_export");
+	// People or companies: the CSV, as the Humans or Companies tab exports it (pipe to a file).
+	if (result.include === "people" || result.include === "companies") {
+		if (flags.json) io.log(JSON.stringify(result, null, 2));
+		else io.log(result.include === "people" ? result.csv_people : result.csv_companies);
+		return 0;
+	}
 	if (flagStr(flags.format) === "csv" && !flags.json && result.csv) {
 		// --table picks one; default is agent visits (pipe to a file).
 		const table = flagStr(flags.table) ?? "agent_visits";

package/package.json

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