@letterstory/cli 0.177.26 → 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.26";
+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
@@ -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/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.26",
+	"version": "0.177.27",
 	"description": "Spin up and manage Letter phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",