@letterstory/cli 0.176.83 → 0.176.85

package/lib/cli.mjs

@@ -85,7 +85,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.176.83";
+export const VERSION = "0.176.85";
 
 /** 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;
@@ -656,7 +656,7 @@ Reviewers:
   automate show <automation-id>
   automate add [--template post_new_issues|recommended_actions|competitor_pages|competitor_takes|
                            competitor_changes|icp_visitors|vc_visitors|plan_updates|weekly_release_notes|monthly_page_refresh|
-                           relink_posts|mention_revisions|fix_autopilot|auto_plan] [--letterbase <id>|--host <site>]
+                           relink_posts|mention_revisions|fix_autopilot|auto_plan|ai_portrayal] [--letterbase <id>|--host <site>]
                [--name <n>] [--trigger competitor_page|competitor_change|visitor_identified|issue_found|build_suggestion|plan_update|custom|
                            schedule]
                [--prompt <what Letterpress does with each event>] [--slack-channel <C…>] [--instruction <which events>]
@@ -1764,6 +1764,9 @@ Insights:
   insights page <page> [--period 14d|30d|90d] [--question <prompt-id>] [--filter all|won] [--limit n]
                                                        One cited page: the AI answers that linked it, word for word
   insights mentions [--site phantoms|<key>]...         Measure → Pages → Naming you: which posts on your phantom sites name you
+  insights portrayal [--period 14d|30d|90d]            How AI answers describe you, what they get wrong
+  insights claims [--period …] [--verdict true|outdated|wrong|unknown|unchecked] [--entity self|<rival>] [--limit n]
+                                                       The claims AI answers make about you, each checked against your facts
   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
@@ -1838,6 +1841,8 @@ The Site (one model of your whole marketing site, keyed by host and path):
   site competitors [--since <iso> | --days <n>] [--limit <n>]  Tracked competitors' sites: new and removed pages, by folder
   site watch-competitors [domain] [--limit <n>]        Map competitors' sitemaps (the next few unmapped, or one now)
   site highlight <domain> [--off]                      Highlight a competitor; its changes lead the top changes
+  site prospect <url> [--pages <n>] [--max-pages <n>] [--depth <n>]
+                                                       Staff: any company's site, no account: what Fix would list, each PR
 
 Repo changes (Claude Code edits your repo in a sandbox; the Letter GitHub App opens a PR):
   repo repos [--gitlab [--search <text>] [--page n]]   Repos the Letter GitHub App can reach (--gitlab: the GitLab

package/lib/commands/automate.mjs

@@ -36,6 +36,7 @@ const TEMPLATES = [
 	"mention_revisions",
 	"fix_autopilot",
 	"auto_plan",
+	"ai_portrayal",
 ];
 const UNITS = ["hours", "days", "weeks", "months"];
 const STATUSES = ["pending", "proposed", "acting", "acted", "answered", "skipped", "failed", "rejected"];

package/lib/commands/insights.mjs

@@ -2,7 +2,8 @@
 // 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`), Questions (`questions`), Pages (`pages`, one page's answers `page`) and the posts naming you (`mentions`), and the live feed of what
+// Measure → Reads (`reads`), Questions (`questions`), Pages (`pages`, one page's answers `page`), the posts naming you (`mentions`)
+// and Portrayal (`portrayal`, its claims `claims`: how AI answers describe you), and the live feed of what
 // is reading the phantom sites (`activity`) — the same reads the web app renders. Search Console's
 // property: which ones the connected Google account can read (`properties`) and the one tracked (`property`).
 
@@ -53,6 +54,15 @@ export const ARGS = {
 	list_site_mentions: {
 		sites: { flag: "site", type: "list" },
 	},
+	get_ai_portrayal: {
+		period: { flag: "period", enum: PERIODS },
+	},
+	list_answer_claims: {
+		period: { flag: "period", enum: PERIODS },
+		verdict: { flag: "verdict", enum: ["true", "outdated", "wrong", "unknown", "unchecked"] },
+		entity: { flag: "entity" },
+		limit: { flag: "limit", type: "num" },
+	},
 	get_recent_activity: {
 		phantom_id: { flag: "phantom" },
 		limit: { flag: "limit", type: "num" },
@@ -101,6 +111,10 @@ export async function cmdInsights(ctx) {
 			return call(rest, "get_cited_page_answers");
 		case "mentions":
 			return call(rest, "list_site_mentions");
+		case "portrayal":
+			return call(rest, "get_ai_portrayal");
+		case "claims":
+			return call(rest, "list_answer_claims");
 		case "activity":
 			return call(rest, "get_recent_activity");
 		case "properties":
@@ -109,7 +123,7 @@ export async function cmdInsights(ctx) {
 			return call(rest, "select_gsc_property");
 		default:
 			throw new CliError(
-				`Unknown insights subcommand: ${sub ?? "(none)"}. Try: summary, reads, questions, pages, page, mentions, competitors, question, detection, activity, site, post, top, bank, access, properties, property`
+				`Unknown insights subcommand: ${sub ?? "(none)"}. Try: summary, reads, questions, pages, page, mentions, portrayal, claims, competitors, question, detection, activity, site, post, top, bank, access, properties, property`
 			);
 	}
 }

package/lib/commands/replicate.mjs

@@ -203,8 +203,19 @@ function replicationDetail(ctx, result) {
 		}
 		if (r.dropped?.length)
 			lines.push("", `The site's own code left out (needs its builder's runtime): ${r.dropped.length}`);
-		if (r.events?.length)
-			lines.push("", "Recent:", ...r.events.slice(0, 8).map((e) => `  ${e.created_at}  ${e.message}`));
+		// The runs as get_replication words them (lib/replicator/activity.ts): the latest in full, older ones in a line.
+		const runs = r.activity ?? [];
+		if (runs.length) {
+			lines.push("", "Activity:");
+			runs.forEach((run, i) => {
+				lines.push(`  ${run.headline}`);
+				if (i > 0) return;
+				for (const e of run.events)
+					lines.push(
+						`    ${e.at}  ${e.title}${e.count > 1 ? ` (x${e.count})` : ""}${e.link ? `  ${e.link.href}` : ""}`
+					);
+			});
+		}
 		return lines.join("\n");
 	});
 	return 0;

package/lib/commands/site.mjs

@@ -14,6 +14,7 @@
 //   site decide <proposal>   → decide_site_proposal    site fix <host> <id>…     → fix_site_observations
 //   site competitors         → list_competitor_sites    site watch-competitors [d] → watch_competitor_sites
 //   site highlight <domain> [--off] → set_competitor_highlight
+//   site prospect <url>      → read_prospect_site (staff: any company's site, no account, nothing stored)
 
 import { writeFileSync } from "node:fs";
 
@@ -69,6 +70,12 @@ const ARGS = {
 		skip_suggest: { flag: "skip-suggest", type: "bool" },
 	},
 	unmap_site: { host: { positional: 0, required: true, label: "host" } },
+	read_prospect_site: {
+		url: { positional: 0, required: true, label: "url" },
+		pages: { flag: "pages", type: "num" },
+		max_pages: { flag: "max-pages", type: "num" },
+		depth: { flag: "depth", type: "num" },
+	},
 	get_llms_txt: { host: { positional: 0, required: true, label: "host" } },
 	get_site_tree: {
 		host: { positional: 0, required: true, label: "host" },
@@ -255,9 +262,11 @@ export async function cmdSite(ctx) {
 			return siteWatchCompetitors(rest);
 		case "highlight":
 			return siteHighlight(rest);
+		case "prospect":
+			return siteProspect(rest);
 		default:
 			throw new CliError(
-				`Unknown site subcommand: ${sub ?? "(none)"}. Try: list, map, refresh, unmap, tree, builds, metrics, page, observations, observe, dismiss, families, decide-family, proposals, propose, decide, fix, competitors, watch-competitors, highlight`
+				`Unknown site subcommand: ${sub ?? "(none)"}. Try: list, map, refresh, unmap, tree, builds, metrics, page, observations, observe, dismiss, families, decide-family, proposals, propose, decide, fix, competitors, watch-competitors, highlight, prospect`
 			);
 	}
 }
@@ -387,6 +396,29 @@ async function siteMap(ctx) {
 	return 0;
 }
 
+/** Any company's site read as the Site and Fix read a customer's: what Fix would list, and each pull request. */
+async function siteProspect(ctx) {
+	const { client, flags, io } = ctx;
+	refuseUnknownFlags(ctx, ARGS.read_prospect_site);
+	const read = await client.callTool(
+		"read_prospect_site",
+		argsFromFlags(ARGS.read_prospect_site, flags, ctx.positionals)
+	);
+	printResult(io, flags, read, (r) => {
+		const fixFor = new Map(r.fixes.map((f) => [f.itemId, f]));
+		const head = [
+			`${r.host}${r.platform ? ` (built with ${r.platform.name})` : ""}: ${r.map.pages} pages mapped${r.map.truncated ? ` of ${r.map.listed} listed` : ""}, ${r.read.answered} of ${r.read.pages} read, ${r.open.total} open issues`,
+			...(r.note ? [r.note] : []),
+		];
+		const rows = r.issues.map((i) => {
+			const fix = fixFor.get(i.id);
+			return `  ${GLYPH[i.tone] ?? "·"} ${i.summary} ${i.path}${fix ? `\n      PR: ${fix.title} (${fix.branch})` : ""}`;
+		});
+		return [...head, ...rows].join("\n");
+	});
+	return 0;
+}
+
 async function siteRefresh(ctx) {
 	const { client, flags, io } = ctx;
 	refuseUnknownFlags(ctx, ARGS.refresh_site);

package/package.json

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