@letterstory/cli 0.177.26 → 0.177.28

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.28";
 
 /** 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;
@@ -241,6 +241,7 @@ export const BOOLEAN_FLAGS = new Set([
 	// ask --more: every row that fits, not only the top ones.
 	"more",
 	"preview",
+	"keep-preview",
 	"with-preview",
 	// repo …: the repo is a GitLab project (--repo group/subgroup/project).
 	"gitlab",
@@ -710,7 +711,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 +2013,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>]
@@ -2119,16 +2120,17 @@ Bench (Benches: open-source benchmarks on their own domains, kept running; @lett
   bench replicate <id>                                 REPLICATE.md: how an agent reproduces the results
 
 Replicate (the Replicator: a website rebuilt as a native Next.js repo, page for page; free, within fair-use limits):
-  replicate <https://site> [--max-pages <n>] [--refine-budget <usd>] [--repo-name <r>] [--repo-owner <o>]
+  replicate <https://site> [--max-pages <n>] [--path <p>]… [--refine-budget <usd>] [--repo-name <r>] [--repo-owner <o>]
                                                        Capture every page, rebuild it, compare it pixel by pixel
   replicate [list]                                     Your replications: stage, how closely each matches, preview link;
                                                        the limits (in progress, pages this month, preview days)
   replicate show <id> [--failing]                      Pages with their routes and pixel match; collections; events
   replicate attach <id> <repo-name> [--repo-owner <o>] The repo to commit it into (yours; Letter never creates it)
-  replicate advance <id> [--retry] [--again] [--preview] [--extend-preview <days>]
+  replicate advance <id> [--retry] [--again] [--preview] [--extend-preview <days>] [--keep-preview]
                                                        Move it on now; --retry once blocked_on is done (checks the tag or TXT record);
                                                        --again replicates from the start; --preview deploys its staging link again;
                                                        --extend-preview keeps the preview up longer (Letter's team only)
+                                                       --keep-preview keeps it up with no expiry (Letter's team only)
   replicate archive <id>                               Stop it and take its preview down; the project stays in storage and in the repo
   replicate forms [<id>] [--form <f>] [--limit <n>] [--before <iso>]
                                                        What people sent through the replicated sites' forms, newest first;

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

@@ -6,11 +6,11 @@
 // attach_replication_repo, advance_replication, archive_replication, list_form_submissions), the
 // same lib functions the app calls.
 //
-//   letterstory replicate https://example.com [--max-pages 300] [--refine-budget 25] [--repo-name example-site] [--repo-owner <account>]
+//   letterstory replicate https://example.com [--max-pages 300] [--path /pricing --path /about] [--refine-budget 25] [--repo-name example-site] [--repo-owner <account>]
 //   letterstory replicate list
 //   letterstory replicate show <id> [--failing]
 //   letterstory replicate attach <id> <repo-name> [--repo-owner <account>]
-//   letterstory replicate advance <id> [--retry] [--again] [--preview] [--extend-preview <days>]
+//   letterstory replicate advance <id> [--retry] [--again] [--preview] [--extend-preview <days>] [--keep-preview]
 //   letterstory replicate archive <id>
 //   letterstory replicate forms [<id>] [--form <form>] [--limit <n>] [--before <iso>]
 //   letterstory replicate forms <id> --show-key  (admins: LETTER_FORMS_URL and LETTER_FORMS_KEY to host it yourself)
@@ -24,6 +24,7 @@ export const ARGS = {
 	create_replication: {
 		url: { positional: 0, label: "url", required: true },
 		max_pages: { flag: "max-pages", type: "num" },
+		paths: { flag: "path", type: "list" },
 		refine_budget_usd: { flag: "refine-budget", type: "num" },
 		repo_name: "repo-name",
 		repo_owner: "repo-owner",
@@ -44,6 +45,7 @@ export const ARGS = {
 		again: { flag: "again", type: "bool" },
 		preview: { flag: "preview", type: "bool" },
 		extend_preview_days: { flag: "extend-preview", type: "num" },
+		keep_preview: { flag: "keep-preview", type: "bool" },
 	},
 	archive_replication: { replication_id: replicationId },
 	get_replication_forms_key: { replication_id: replicationId },

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