@letterstory/cli 0.177.24 → 0.177.26

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.24";
+export const VERSION = "0.177.26";
 
 /** 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;
@@ -97,6 +97,9 @@ export const EXIT_PAYMENT_REQUIRED = 3;
 // can't accidentally swallow the id as --json's value. Every `type: "bool"` flag (and its
 // `negate` spelling) in a command's ARGS map must be listed; boolean-flags.test.ts enforces it.
 export const BOOLEAN_FLAGS = new Set([
+	// visits export: only the people or companies who fit the ICP, or only those who don't.
+	"icp",
+	"not-icp",
 	// org mcp add: the server signs in with OAuth instead of a header value.
 	"sign-in",
 	// collection onboard: connect without drafting or scheduling.
@@ -1358,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,
@@ -2005,6 +2008,8 @@ Visits (Visitors: AI agents reading your site, and AI answers sending people to
   visits [--agent <a>] [--since 7d] [--path '/docs/*'] [--purpose live|index|training|automated_browser] [--kind page|agent_file|site_file|asset] [--paths <n>] [--site <id>]
                                                        Agent visits: per agent, why they came, most-read paths by kind
   visits citations [--since 30d] [--site <id>]         Visits that clicked through from ChatGPT, Claude, Perplexity…
+  visits who [--icp|--not-icp] [--category <group>] [--path <p>] [--since 30d] [--limit <n>]
+                                                       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]

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

@@ -9,6 +9,7 @@
 //   letterstory visits compare chatgpt claude --path '/docs/*' --since 7d
 //   letterstory visits citations --since 30d
 //   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 sites
 //   letterstory visits domain composal.com [--site <id>]   move the site to a new domain, keeping its key
@@ -43,6 +44,14 @@ export const ARGS = {
 	},
 	visitors_get_citations: { site_id: "site", days },
 	visitors_get_human_visits: { site_id: "site", days, path: "path" },
+	visitors_get_people: {
+		site_id: "site",
+		days,
+		path: "path",
+		category: "category",
+		limit: { flag: "limit", type: "num" },
+		icp: { flag: "icp", type: "bool", negate: "not-icp" },
+	},
 	visitors_admin_coverage: { site_id: "site" },
 	visitors_add_connector: {
 		site_id: "site",
@@ -99,6 +108,8 @@ export async function cmdVisits(ctx) {
 			return visitsCitations(rest);
 		case "people":
 			return visitsPeople(rest);
+		case "who":
+			return visitsWho(rest);
 		case "compare":
 			return visitsCompare(rest);
 		case "export":
@@ -119,7 +130,7 @@ export async function cmdVisits(ctx) {
 			return visitsDisconnect(rest);
 		default:
 			throw new CliError(
-				"Usage: visits [list|citations|people|compare|export|sites|domain|pages|health|connect|connectors|disconnect]"
+				"Usage: visits [list|citations|people|who|compare|export|sites|domain|pages|health|connect|connectors|disconnect]"
 			);
 	}
 }
@@ -311,6 +322,25 @@ async function visitsPeople(ctx) {
 	return 0;
 }
 
+async function visitsWho(ctx) {
+	const { flags, io } = ctx;
+	const result = await call(ctx, "visitors_get_people");
+	printResult(io, flags, result, (r) => {
+		if (!r.enabled) return "Identification is off for this site.";
+		const lines = [];
+		if (r.icp) lines.push(`ICP: ${r.icp} (${r.icp_total} fit)`);
+		else if (r.icp_filter !== null) lines.push("No ICP set. Set it in Memory → General.");
+		lines.push(`${r.total} identified in the last ${r.window_days} days`);
+		for (const v of r.visitors) {
+			const fit = v.icp_fit === true ? `  ICP: ${v.icp_reason ?? "fits"}` : "";
+			const where = [v.title, v.company ?? v.company_domain].filter(Boolean).join(", ");
+			lines.push(`  ${v.name ?? "Unknown"}${where ? ` (${where})` : ""}  ${v.category ?? "Others"}${fit}`);
+		}
+		return lines.join("\n");
+	});
+	return 0;
+}
+
 async function visitsCompare(ctx) {
 	const { flags, io } = ctx;
 	const result = await call(ctx, "visitors_compare_agents");

package/package.json

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