@letterstory/cli 0.177.24 → 0.177.25

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.25";
 
 /** 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.
@@ -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/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.25",
 	"description": "Spin up and manage Letter phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",