@letterstory/cli 0.112.0 → 0.113.1

package/lib/cli.mjs

@@ -60,7 +60,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.112.0";
+export const VERSION = "0.113.1";
 
 // 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
@@ -72,6 +72,8 @@ export const BOOLEAN_FLAGS = new Set([
 	"subtree",
 	// site map: do not start an audit for a host that has none.
 	"no-audit",
+	// site metrics: skip the previous window (no deltas, no revamp indicator).
+	"no-compare",
 	// site refresh / observe: the loop's switches.
 	"force-map",
 	"force-audit",
@@ -1174,15 +1176,16 @@ The Site (one model of your whole marketing site, keyed by host and path):
   site propose <host> [path] --tool <tool> --input '<json>'|--input-file <p> --label <text> [--why <text>]
                      [--observation <id>]...           Propose a registry tool call; input is validated now
   site decide <proposal-id> --decision accept|dismiss [--reason <why>]
-  site competitors [--since <iso>] [--limit <n>]       Tracked competitors' sites: new and removed pages, by folder
-  site watch-competitors [domain]                      Map competitors' sitemaps (every unmapped one, or one now)
+  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
 
 Repo changes (Claude Code edits your repo in a sandbox; the Letterstory GitHub App opens a PR):
   repo repos                                           Repos the Letterstory GitHub App can reach
   repo branches --repo owner/name                      Branches a change can start from (default first)
   repo prs [--repo owner/name]                         Every open PR (whoever opened it), longest-idle first
   repo suggestions                                     Fixes found and not acted on yet, and how to start each
-  repo settings [--action build|build_pr|slack] [--branch <name>|none] [--slack-agent <name|U…>|none]
+  repo settings [--action build|build_pr|build_merge|slack] [--branch <name>|none] [--slack-agent <name|U…>|none]
                 [--slack-channel <C…>|none] [--slack-reports off|as_found|daily] [--reports-channel <C…>|none] [--autopilot-channel <C…>|none] [--listen <C…,C…>|none] [--autopilot on|off] [--autopilot-weekly <1-20>]
                 [--autopilot-severity critical|warning]
                                                        The org's defaults for every fix: build (preview first),
@@ -1192,13 +1195,13 @@ Repo changes (Claude Code edits your repo in a sandbox; the Letterstory GitHub A
   repo slack-test                                      Post a test into the Send to Slack channel
   repo start --repo <owner/name> --instructions <text>|--instructions-file <path|->
              [--branch <base>] [--attach <path>]... [--attach-url <name>=<https url>]...
-             [--action build|build_pr|slack] [--wait]
+             [--action build|build_pr|build_merge|slack] [--wait]
                                                        Start a change (attached files go to the sandbox);
                                                        --wait follows it to the PR
-  repo fix-audit --issue <issue-type>... [--audit <id>] [--branch <base>] [--action build|build_pr|slack] [--wait]
+  repo fix-audit --issue <issue-type>... [--audit <id>] [--branch <base>] [--action build|build_pr|build_merge|slack] [--wait]
                                                        One PR fixing site-audit issues (repeat --issue to bundle) on every affected page,
                                                        in the repo verified to build the site
-  repo install-letterprove --repo <owner/name> [--branch <base>] [--action build|build_pr|slack] [--wait]
+  repo install-letterprove --repo <owner/name> [--branch <base>] [--action build|build_pr|build_merge|slack] [--wait]
                                                        One PR adding Letterprove's script and identify calls
                                                        (pick the repo where users sign in)
   repo sites [--detect [--force]]                      Which website each repo builds, and the evidence

package/lib/commands/repo.mjs

@@ -49,7 +49,7 @@ const ARGS = {
 		instructions: { value: (flags) => readTextInput(flags, "instructions", "instructions-file") },
 		// --attach <path> (uploaded first) and --attach-url <name>=<https url>, both repeatable.
 		files: { value: (_flags, _positionals, extra) => (extra.files?.length ? extra.files : undefined) },
-		action: { flag: "action", enum: ["build", "build_pr", "slack"] },
+		action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack"] },
 		preview: { flag: "preview", type: "bool" },
 	},
 	create_repo_change_upload: { file_names: { internal: "the basenames of the --attach files" } },
@@ -74,21 +74,21 @@ const ARGS = {
 		issue_types: { value: (flags) => (issueList(flags).length > 1 ? issueList(flags) : undefined) },
 		audit_id: "audit",
 		base_branch: "branch",
-		action: { flag: "action", enum: ["build", "build_pr", "slack"] },
+		action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack"] },
 		preview: { flag: "preview", type: "bool" },
 	},
 	letterprove_open_install_pr: {
 		repo_owner: { value: (flags) => splitRepo(flags).owner },
 		repo_name: { value: (flags) => splitRepo(flags).name },
 		base_branch: "branch",
-		action: { flag: "action", enum: ["build", "build_pr", "slack"] },
+		action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack"] },
 	},
 	get_repo_change_settings: {},
 	list_suggested_fixes: {},
 	list_slack_fix_targets: {},
 	send_slack_test_message: {},
 	set_repo_change_settings: {
-		default_action: { flag: "action", enum: ["build", "build_pr", "slack"] },
+		default_action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack"] },
 		// --branch <name>, or --branch none for each repo's own default.
 		default_branch: { value: (flags) => (flags.branch === "none" ? null : flagStr(flags.branch)) },
 		// --slack-agent Devin (or a U… member id), or --slack-agent none to tag nobody.
@@ -115,6 +115,13 @@ const ARGS = {
 								.map((c) => c.trim())
 								.filter(Boolean),
 		},
+		// --listen-all on|off: answer messages meant for Letter in every channel it's in
+		slack_listen_all: {
+			value: (flags) =>
+				flags["listen-all"] === undefined
+					? undefined
+					: ["on", "true", "1"].includes(String(flags["listen-all"])),
+		},
 		autopilot_channel: {
 			value: (flags) => (flags["autopilot-channel"] === "none" ? null : flagStr(flags["autopilot-channel"])),
 		},

package/lib/commands/site.mjs

@@ -2,15 +2,26 @@
 // (src/lib/site). One subcommand per tool:
 //   site list                → list_sites               site map <host>            → map_site
 //   site tree <host> [path]  → get_site_tree            site page <host> <path>    → get_site_page
+//   site metrics <host> [path] → get_site_metrics  (--window 7d|28d|90d, --page <path>…, --no-compare)
 //   site observations <host> → list_site_observations   site observe <host>        → observe_site
 //   site dismiss <host> <id> → dismiss_site_observation
 //   site families <host>     → list_site_families       site decide-family <id>    → decide_site_family
 //   site proposals <host>    → list_site_proposals      site propose <host>        → create_site_proposal
 //   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
 
 import { CliError } from "../client.mjs";
-import { argsFromFlags, flagList, flagStr, ok, printResult, readTextInput, refuseUnknownFlags } from "./shared.mjs";
+import {
+	argsFromFlags,
+	flagList,
+	flagNum,
+	flagStr,
+	ok,
+	printResult,
+	readTextInput,
+	refuseUnknownFlags,
+} from "./shared.mjs";
 
 /** --include <path>… / --exclude <path>… (+ --reason) → decide_site_family members. */
 function familyMembers(flags) {
@@ -67,11 +78,34 @@ const ARGS = {
 			},
 		},
 	},
+	get_site_metrics: {
+		host: { positional: 0, required: true, label: "host" },
+		path: { positional: 1, label: "path" },
+		paths: { flag: "page", type: "list" },
+		window: { flag: "window", enum: ["7d", "28d", "90d"] },
+		compare: { flag: "no-compare", type: "bool", invert: true },
+	},
 	list_competitor_sites: {
-		since: { flag: "since" },
+		// --since <iso>, or --days <n> as shorthand for "the last n days" (--days 1 is the last 24 hours).
+		since: {
+			value: (flags) => {
+				const since = flagStr(flags.since);
+				if (since !== undefined) return since;
+				const days = flagNum(flags.days);
+				return days === undefined ? undefined : new Date(Date.now() - days * 86_400_000).toISOString();
+			},
+		},
 		limit: { flag: "limit", type: "num" },
 	},
-	watch_competitor_sites: { domain: { positional: 0, label: "domain" } },
+	watch_competitor_sites: {
+		domain: { positional: 0, label: "domain" },
+		limit: { flag: "limit", type: "num" },
+	},
+	set_competitor_highlight: {
+		domain: { positional: 0, required: true, label: "domain" },
+		// Highlighted unless --off.
+		highlighted: { value: (flags) => flags.off !== true },
+	},
 	get_site_page: {
 		host: { positional: 0, required: true, label: "host" },
 		path: { positional: 1, required: true, label: "path" },
@@ -143,7 +177,7 @@ const ARGS = {
 		},
 		base_branch: { flag: "base-branch" },
 		preview: { flag: "preview", type: "bool" },
-		action: { flag: "action", enum: ["build", "build_pr", "slack"] },
+		action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack"] },
 	},
 };
 
@@ -161,6 +195,8 @@ export async function cmdSite(ctx) {
 			return siteUnmap(rest);
 		case "tree":
 			return siteTree(rest);
+		case "metrics":
+			return siteMetrics(rest);
 		case "page":
 			return sitePage(rest);
 		case "observations":
@@ -185,9 +221,11 @@ export async function cmdSite(ctx) {
 			return siteCompetitors(rest);
 		case "watch-competitors":
 			return siteWatchCompetitors(rest);
+		case "highlight":
+			return siteHighlight(rest);
 		default:
 			throw new CliError(
-				`Unknown site subcommand: ${sub ?? "(none)"}. Try: list, map, refresh, unmap, tree, page, observations, observe, dismiss, families, decide-family, proposals, propose, decide, fix, competitors, watch-competitors`
+				`Unknown site subcommand: ${sub ?? "(none)"}. Try: list, map, refresh, unmap, tree, metrics, page, observations, observe, dismiss, families, decide-family, proposals, propose, decide, fix, competitors, watch-competitors, highlight`
 			);
 	}
 }
@@ -212,11 +250,12 @@ async function siteList(ctx) {
 	printResult(io, flags, result, (r) => {
 		const lines = r.sites.map(
 			(s) =>
-				`${s.host}  ${s.mapStatus}  ${s.pagesTotal} pages${s.mapTruncated ? " (truncated)" : ""}${s.mappedAt ? `  mapped ${s.mappedAt.slice(0, 10)}` : ""}`
+				`${s.host}${s.kind && s.kind !== "site" ? ` [${s.kind}]` : ""}  ${s.mapStatus}  ${s.pagesTotal} pages${s.mapTruncated ? " (truncated)" : ""}${s.mappedAt ? `  mapped ${s.mappedAt.slice(0, 10)}` : ""}`
 		);
 		if (r.suggestions.length) {
 			lines.push("Not yet mapped:");
-			for (const s of r.suggestions) lines.push(`  ${s.host}  (${s.from.join(", ")})`);
+			for (const s of r.suggestions)
+				lines.push(`  ${s.host}${s.kind && s.kind !== "site" ? ` [${s.kind}]` : ""}  (${s.from.join(", ")})`);
 		}
 		return lines.join("\n") || "No sites yet. Map one with: letterstory site map <host>";
 	});
@@ -233,16 +272,24 @@ async function siteCompetitors(ctx) {
 	printResult(io, flags, result, (r) => {
 		const lines = [`Since ${r.since.slice(0, 10)}:`];
 		for (const c of r.competitors) {
+			const star = c.highlighted ? "* " : "  ";
 			if (!c.changes) {
-				lines.push(`  ${c.name}  ${c.domain}  not mapped (letterstory site watch-competitors ${c.domain})`);
+				lines.push(
+					`${star}${c.name}  ${c.domain}  not mapped (letterstory site watch-competitors ${c.domain})`
+				);
 				continue;
 			}
 			const folders = c.changes.folders.map((f) => `${f.path} +${f.added}${f.removed ? ` -${f.removed}` : ""}`);
 			lines.push(
-				`  ${c.name}  ${c.host}  ${c.changes.pages} pages  +${c.changes.added} -${c.changes.removed}${folders.length ? `  ${folders.join(", ")}` : ""}`
+				`${star}${c.name}  ${c.host}  ${c.changes.pages} pages  +${c.changes.added} -${c.changes.removed}${folders.length ? `  ${folders.join(", ")}` : ""}`
 			);
 			for (const p of c.changes.addedPages.slice(0, 5)) lines.push(`    + ${p.path}  ${p.at.slice(0, 10)}`);
 		}
+		const top = r.topChanges ?? [];
+		if (top.length) {
+			lines.push(r.competitors.some((c) => c.highlighted) ? "Top changes (highlighted):" : "Top changes:");
+			for (const t of top) lines.push(`  ${t.summary}  ${t.at.slice(0, 10)}`);
+		}
 		return r.competitors.length ? lines.join("\n") : "No competitors tracked yet.";
 	});
 	return 0;
@@ -260,6 +307,18 @@ async function siteWatchCompetitors(ctx) {
 	return 0;
 }
 
+async function siteHighlight(ctx) {
+	const { client, flags, io } = ctx;
+	refuseUnknownFlags(ctx, ARGS.set_competitor_highlight, ["off"]);
+	const result = await client.callTool(
+		"set_competitor_highlight",
+		argsFromFlags(ARGS.set_competitor_highlight, flags, ctx.positionals)
+	);
+	ok(ctx, result.message);
+	printResult(io, flags, result, (r) => (r.highlighted.length ? `Highlighted: ${r.highlighted.join(", ")}` : ""));
+	return 0;
+}
+
 async function siteMap(ctx) {
 	const { client, flags, io } = ctx;
 	refuseUnknownFlags(ctx, ARGS.map_site);
@@ -303,6 +362,32 @@ async function siteTree(ctx) {
 	return 0;
 }
 
+async function siteMetrics(ctx) {
+	const { client, flags, io } = ctx;
+	refuseUnknownFlags(ctx, ARGS.get_site_metrics);
+	const result = await client.callTool(
+		"get_site_metrics",
+		argsFromFlags(ARGS.get_site_metrics, flags, ctx.positionals)
+	);
+	printResult(io, flags, result, (r) => {
+		const lines = [`${r.host}  ${r.window} (${r.range.start} to ${r.range.end})  source: ${r.source}`];
+		if (r.source !== "lettervisit") lines.push(`  ${r.message}`);
+		for (const p of r.pages) {
+			const value = r.source === "lettervisit" ? p.accesses?.total : p.clicks;
+			const delta = r.source === "lettervisit" ? p.accesses_delta_pct : p.clicks_delta_pct;
+			const split = p.accesses
+				? `  (AI ${p.accesses.ai_agents}, crawlers ${p.accesses.search_crawlers}, people ${p.accesses.humans})`
+				: "";
+			const marks = p.indicators.map((i) => i.label).join(", ");
+			lines.push(
+				`  ${p.path}  ${value ?? "-"} ${r.unit ?? ""}${delta !== null ? ` ${delta > 0 ? "+" : ""}${delta}%` : ""}${split}${marks ? `  [${marks}]` : ""}`
+			);
+		}
+		return lines.join("\n");
+	});
+	return 0;
+}
+
 async function sitePage(ctx) {
 	const { client, flags, io } = ctx;
 	refuseUnknownFlags(ctx, ARGS.get_site_page);

package/package.json

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