@letterstory/cli 0.137.0 → 0.138.0

package/lib/cli.mjs

@@ -63,7 +63,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.137.0";
+export const VERSION = "0.138.0";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value. Every `type: "bool"` flag (and its
@@ -1329,6 +1329,7 @@ Insights:
   insights reads [--period …] [--site all|own|phantoms|<key>]... [--path <path>] [--engine <operator>]
                                                        Measure → Reads: AI engines and people reading your sites, counted one way
   insights questions [--period 14d|30d|90d]            Measure → Questions: every question we ask, named / share / change / cited
+  insights pages [--period 14d|30d|90d] [--site own|phantoms|<key>]  Measure → Pages: your pages AI answers cited, won questions first
   insights competitors [--period 14d|30d|90d]          GEO → Competitors: share of mentions per brand, is it moving, by engine/question
   insights question <key> [--period 14d|30d|90d] [--filter all|named_you|rival_not_you|no_one] [--limit n]
                                                        One By-question row: the wordings asked and the AI answers
@@ -1401,6 +1402,9 @@ Repo changes (Claude Code edits your repo in a sandbox; the Letterstory GitHub A
   repo install-letterprove --repo <owner/name> [--branch <base>] [--action build|build_pr|build_merge|slack|linear] [--wait]
                                                        One PR adding Letterprove's script and identify calls
                                                        (pick the repo where users sign in)
+  repo install-visitors [--site <id>] [--repo <owner/name>] [--branch <base>] [--action build|build_pr|build_merge|slack|linear] [--wait]
+                                                       One PR adding the Visitors script tag to the repo that
+                                                       builds the site (--repo: another repo)
   repo sites [--detect [--force]]                      Which website each repo builds, and the evidence
   repo set-site --repo <owner/name> --site <host> [--not] [--branch <name>|none]
                                                        Say which site a repo builds (--not: correct a wrong label)
@@ -1414,7 +1418,7 @@ Repo changes (Claude Code edits your repo in a sandbox; the Letterstory GitHub A
   repo status <run-id>                                 Phase, spend, PR link and Claude's summary
   repo activity <run-id> [--follow]                    What the sandbox is doing, line by line (--follow: until it stops)
   repo list [--status running|succeeded|no_changes|failed|cancelled] [--limit n] [--audit <id>]
-             [--source site_audit_issue|site_quick_check|letterprove_install]
+             [--source site_audit_issue|site_quick_check|letterprove_install|visitors_install]
   repo publish <run-id>                                Make PR on a preview in review
   repo revise <run-id> --instructions <text>|--instructions-file <path|->
                                                        Ask for more on a preview; it takes over the preview's link

package/lib/commands/insights.mjs

@@ -2,7 +2,7 @@
 // network, single-post, and top-posts levels (ported from phantomstory-cli's
 // insights.ts); plus Measure's Overview (`summary`), GEO → Competitors
 // (`competitors`), AI Visibility Bank (`bank`) and phantom Page Access (`access`);
-// Measure → Reads (`reads`) and Questions (`questions`), and the live feed of what
+// Measure → Reads (`reads`), Questions (`questions`) and Pages (`pages`), and the live feed of what
 // is reading the phantom sites (`activity`) — the same reads the web app renders.
 
 import { CliError } from "../client.mjs";
@@ -38,6 +38,10 @@ export const ARGS = {
 	list_measure_questions: {
 		period: { flag: "period", enum: PERIODS },
 	},
+	list_cited_pages: {
+		period: { flag: "period", enum: PERIODS },
+		sites: { flag: "site", type: "list" },
+	},
 	get_recent_activity: {
 		phantom_id: { flag: "phantom" },
 		limit: { flag: "limit", type: "num" },
@@ -76,11 +80,13 @@ export async function cmdInsights(ctx) {
 			return call(rest, "get_reads");
 		case "questions":
 			return call(rest, "list_measure_questions");
+		case "pages":
+			return call(rest, "list_cited_pages");
 		case "activity":
 			return call(rest, "get_recent_activity");
 		default:
 			throw new CliError(
-				`Unknown insights subcommand: ${sub ?? "(none)"}. Try: summary, reads, questions, competitors, question, detection, activity, site, post, top, bank, access`
+				`Unknown insights subcommand: ${sub ?? "(none)"}. Try: summary, reads, questions, pages, competitors, question, detection, activity, site, post, top, bank, access`
 			);
 	}
 }

package/lib/commands/repo.mjs

@@ -8,6 +8,7 @@
 //   repo repos   → list_github_app_repos  repo branches → list_repo_branches
 //   repo prs     → list_open_pull_requests (every open PR, whoever opened it)
 //   repo install-letterprove → letterprove_open_install_pr
+//   repo install-visitors → visitors_open_install_pr
 //   repo secrets → list_repo_preview_secrets  repo set-secret → set_repo_preview_secret
 //   repo delete-secret → delete_repo_preview_secret
 //   repo suggestions → list_suggested_fixes
@@ -117,6 +118,13 @@ const ARGS = {
 		base_branch: "branch",
 		action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack", "linear"] },
 	},
+	visitors_open_install_pr: {
+		site_id: "site",
+		repo_owner: { value: (flags) => splitRepo(flags).owner },
+		repo_name: { value: (flags) => splitRepo(flags).name },
+		base_branch: "branch",
+		action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack", "linear"] },
+	},
 	get_repo_change_settings: {},
 	list_suggested_fixes: {},
 	list_slack_fix_targets: {},
@@ -187,7 +195,13 @@ const ARGS = {
 		audit_id: "audit",
 		source_kind: {
 			flag: "source",
-			enum: ["site_audit_issue", "site_quick_check", "letterprove_install", "collection_publish"],
+			enum: [
+				"site_audit_issue",
+				"site_quick_check",
+				"letterprove_install",
+				"visitors_install",
+				"collection_publish",
+			],
 		},
 		site_host: "site",
 	},
@@ -247,6 +261,8 @@ export async function cmdRepo(ctx) {
 			return repoFixAudit(rest);
 		case "install-letterprove":
 			return repoInstallLetterprove(rest);
+		case "install-visitors":
+			return repoInstallVisitors(rest);
 		case "sites":
 			return repoSites(rest);
 		case "set-site":
@@ -283,7 +299,7 @@ export async function cmdRepo(ctx) {
 			return repoSlackTest(rest);
 		default:
 			throw new CliError(
-				`Unknown repo subcommand: ${sub ?? "(none)"}. Try: start, fix-audit, install-letterprove, sites, set-site, reset-site, secrets, set-secret, delete-secret, status, list, publish, cancel, repos, branches, prs, settings, suggestions, slack-targets, slack-test`
+				`Unknown repo subcommand: ${sub ?? "(none)"}. Try: start, fix-audit, install-letterprove, install-visitors, sites, set-site, reset-site, secrets, set-secret, delete-secret, status, list, publish, cancel, repos, branches, prs, settings, suggestions, slack-targets, slack-test`
 			);
 	}
 }
@@ -434,6 +450,22 @@ async function repoInstallLetterprove(ctx) {
 	return followRun(ctx, result.run);
 }
 
+/** `repo install-visitors [--site id] [--repo owner/name] [--branch b] [--wait]`: the Visitors script tag → one PR. */
+async function repoInstallVisitors(ctx) {
+	const { client, flags, io } = ctx;
+	refuseUnknownFlags(ctx, {}, ["site", "repo", "owner", "name", "branch", "action", "wait"]);
+	const result = await client.callTool(
+		"visitors_open_install_pr",
+		argsFromFlags(ARGS.visitors_open_install_pr, flags, ctx.positionals)
+	);
+	ok(ctx, result.message);
+	if (!flags.wait) {
+		printResult(io, flags, result.run, describe);
+		return 0;
+	}
+	return followRun(ctx, result.run);
+}
+
 /** `repo sites [--detect] [--force]`: which website each repo builds, and why. */
 async function repoSites(ctx) {
 	const { client, flags, io } = ctx;

package/package.json

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