@letterstory/cli 0.107.0 → 0.108.1

package/lib/cli.mjs

@@ -60,7 +60,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.107.0";
+export const VERSION = "0.108.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
@@ -1160,7 +1160,8 @@ The Site (one model of your whole marketing site, keyed by host and path):
   site refresh <host> [--force-map] [--force-audit] [--skip-observe]
                                                        Run the daily loop now: re-map, re-audit, signals, Jev
   site unmap <host>                                    Remove a host and everything hanging off it
-  site tree <host> [path] [--depth <n>] [--unfold]     The tree one folder at a time, one item per node
+  site tree <host> [path] [--depth <n>] [--unfold] [--since <iso>]
+                                                       The tree one folder at a time; --since adds +N/-N per folder
   site page <host> <path>                              One page: facts, bindings, raw URLs, open items
   site observations <host> [path] [--state open|dismissed|resolved] [--tone risk|warn|info] [--key <k>] [--since <iso>] [--min-reach <0..1>]
   site observe <host> [path] [--max-pages <n>]         Jev pass: meta accuracy, title, outdated
@@ -1172,6 +1173,8 @@ 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)
 
 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
@@ -1198,7 +1201,7 @@ Repo changes (Claude Code edits your repo in a sandbox; the Letterstory GitHub A
                                                        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
-  repo set-site --repo <owner/name> --site <host> [--not]
+  repo set-site --repo <owner/name> --site <host> [--not] [--branch <name>|none]
                                                        Say which site a repo builds (--not: correct a wrong label)
   repo reset-site --repo <owner/name> --site <host>    Back to automatic detection
   repo status <run-id>                                 Phase, spend, PR link and Claude's summary

package/lib/commands/repo.mjs

@@ -60,6 +60,8 @@ const ARGS = {
 		repo_name: { value: (flags) => splitRepo(flags).name },
 		site_host: { flag: "site", required: true },
 		builds: { flag: "not", type: "bool", invert: true },
+		// --branch <name>: the branch that deploys the site (one repo, a site per branch); none = default.
+		branch: { value: (flags) => (flags.branch === "none" ? null : flagStr(flags.branch)) },
 	},
 	reset_repo_site: {
 		repo_owner: { value: (flags) => splitRepo(flags).owner },
@@ -345,7 +347,7 @@ async function repoSites(ctx) {
 /** `repo set-site --repo owner/name --site acme.com [--not]`: say which site a repo builds (or doesn't). */
 async function repoSetSite(ctx) {
 	const { client, flags, io } = ctx;
-	refuseUnknownFlags(ctx, {}, ["repo", "owner", "name", "site", "not"]);
+	refuseUnknownFlags(ctx, {}, ["repo", "owner", "name", "site", "not", "branch"]);
 	const result = await client.callTool("set_repo_site", argsFromFlags(ARGS.set_repo_site, flags));
 	ok(ctx, result.message);
 	printResult(io, flags, result.site);

package/lib/commands/site.mjs

@@ -7,6 +7,7 @@
 //   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
 
 import { CliError } from "../client.mjs";
 import { argsFromFlags, flagList, flagStr, ok, printResult, readTextInput, refuseUnknownFlags } from "./shared.mjs";
@@ -56,7 +57,13 @@ const ARGS = {
 		depth: { flag: "depth", type: "num" },
 		unfold: { flag: "unfold", type: "bool" },
 		subtree: { flag: "subtree", type: "bool" },
+		since: { flag: "since" },
 	},
+	list_competitor_sites: {
+		since: { flag: "since" },
+		limit: { flag: "limit", type: "num" },
+	},
+	watch_competitor_sites: { domain: { positional: 0, label: "domain" } },
 	get_site_page: {
 		host: { positional: 0, required: true, label: "host" },
 		path: { positional: 1, required: true, label: "path" },
@@ -166,9 +173,13 @@ export async function cmdSite(ctx) {
 			return siteDecide(rest);
 		case "fix":
 			return siteFix(rest);
+		case "competitors":
+			return siteCompetitors(rest);
+		case "watch-competitors":
+			return siteWatchCompetitors(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`
+				`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`
 			);
 	}
 }
@@ -180,7 +191,8 @@ function describeNode(node, indent = "") {
 	const line = node.item
 		? `${node.item.summary}${node.more ? ` and ${node.more} more` : ""}${node.item.action ? ` → ${node.item.action.label}` : ""}`
 		: "";
-	const counts = node.hasChildren ? ` (${node.rollup.pages} pages)` : "";
+	const changed = `${node.rollup.added ? ` +${node.rollup.added}` : ""}${node.rollup.removed ? ` -${node.rollup.removed}` : ""}`;
+	const counts = node.hasChildren ? ` (${node.rollup.pages} pages${changed})` : node.page?.added ? " (new)" : "";
 	const out = [`${indent}${glyph.padEnd(2)} ${node.name}${counts}${line ? `  ${line}` : ""}`];
 	for (const child of node.children ?? []) out.push(describeNode(child, `${indent}  `));
 	return out.join("\n");
@@ -203,6 +215,43 @@ async function siteList(ctx) {
 	return 0;
 }
 
+async function siteCompetitors(ctx) {
+	const { client, flags, io } = ctx;
+	refuseUnknownFlags(ctx, ARGS.list_competitor_sites);
+	const result = await client.callTool(
+		"list_competitor_sites",
+		argsFromFlags(ARGS.list_competitor_sites, flags, ctx.positionals)
+	);
+	printResult(io, flags, result, (r) => {
+		const lines = [`Since ${r.since.slice(0, 10)}:`];
+		for (const c of r.competitors) {
+			if (!c.changes) {
+				lines.push(`  ${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(", ")}` : ""}`
+			);
+			for (const p of c.changes.addedPages.slice(0, 5)) lines.push(`    + ${p.path}  ${p.at.slice(0, 10)}`);
+		}
+		return r.competitors.length ? lines.join("\n") : "No competitors tracked yet.";
+	});
+	return 0;
+}
+
+async function siteWatchCompetitors(ctx) {
+	const { client, flags, io } = ctx;
+	refuseUnknownFlags(ctx, ARGS.watch_competitor_sites);
+	const result = await client.callTool(
+		"watch_competitor_sites",
+		argsFromFlags(ARGS.watch_competitor_sites, flags, ctx.positionals)
+	);
+	ok(ctx, result.message);
+	printResult(io, flags, result, () => "");
+	return 0;
+}
+
 async function siteMap(ctx) {
 	const { client, flags, io } = ctx;
 	refuseUnknownFlags(ctx, ARGS.map_site);

package/package.json

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