@letterstory/cli 0.176.84 → 0.176.86

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.84";
+export const VERSION = "0.176.86";
 
 /** 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;
@@ -1841,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
@@ -1981,6 +1983,7 @@ Deploy (websites and apps Letter builds from your words and hosts on their own d
   deploy update <id> [--name <n>] [--domain <d>]       The domain only before it is built
   deploy pause <id> | deploy resume <id> | deploy archive <id>
   deploy advance <id> [--retry]                        Move it on now; --retry once blocked_on is done
+  deploy page <id>                                     Add a landing page to it now (Letter adds one a week)
   deploy source <id>                                   A link to download its source, as Letter keeps it
   deploy connect <id> <owner/name>                     Move its source to your GitHub repo (empty); it's
                                                        pushed once the Letter GitHub App can reach it

package/lib/commands/deploy.mjs

@@ -1,7 +1,7 @@
 // `deploy` — Deployments from a terminal (docs/architecture/deployments.md): websites and apps Letter
 // builds from your words and hosts on their own domains, with your phantoms and benches in the list.
 // Thin wrappers over the deployment tools (create_deployment, list_deployments, get_deployment,
-// update_deployment, advance_deployment), the same lib functions the app calls.
+// update_deployment, advance_deployment, add_deployment_page), the same lib functions the app calls.
 //
 //   letterstory deploy create "Build me a website for HVAC contractors to collect leads" [--name <n>] [--domain <d>] [--ref <visual-ref-id>] [--wait]
 //   letterstory deploy list [--kind app|phantom|bench]
@@ -9,6 +9,7 @@
 //   letterstory deploy update <id> [--name <n>] [--domain <d>]
 //   letterstory deploy pause <id> | resume <id> | archive <id>
 //   letterstory deploy advance <id> [--retry]
+//   letterstory deploy page <id>
 
 import { CliError } from "../client.mjs";
 import { argsFromFlags, flagStr, printResult, refuseUnknownFlags } from "./shared.mjs";
@@ -41,6 +42,7 @@ export const ARGS = {
 		status: { flag: "status", enum: ["live", "paused", "archived"] },
 	},
 	advance_deployment: { id: appId, retry: { flag: "retry", type: "bool" } },
+	add_deployment_page: { id: appId },
 	connect_deployment_repo: {
 		id: appId,
 		repo_owner: { value: (_flags, positionals) => repoPart(positionals[1], 0) },
@@ -83,6 +85,9 @@ export async function cmdDeploy(ctx) {
 		case "advance":
 			refuseUnknownFlags(rest, ARGS.advance_deployment, []);
 			return deployShow(rest, await call(rest, "advance_deployment"));
+		case "page":
+			refuseUnknownFlags(rest, ARGS.add_deployment_page, []);
+			return deployShow(rest, await call(rest, "add_deployment_page"));
 		case "connect":
 			return deployShow(rest, await call(rest, "connect_deployment_repo"));
 		case "source": {
@@ -96,7 +101,9 @@ export async function cmdDeploy(ctx) {
 			return 0;
 		}
 		default:
-			throw new CliError("Usage: deploy [list|create|show|update|pause|resume|archive|advance|connect|source]");
+			throw new CliError(
+				"Usage: deploy [list|create|show|update|pause|resume|archive|advance|page|connect|source]"
+			);
 	}
 }
 
@@ -135,6 +142,15 @@ function deployShow(ctx, result) {
 			...(a.source?.pending
 				? [`  Moving to ${a.source.pending.repo}: ${a.source.pending.note ?? "trying now"}`]
 				: []),
+			...(a.writing?.state === "on"
+				? [
+						`  Writing posts at /blog from letterbase ${a.writing.collection_id} (automations list --collection ${a.writing.collection_id}), a landing page a week (deploy page ${a.id} adds one now)`,
+					]
+				: a.writing?.state === "failed"
+					? [`  Writing not set up: ${a.writing.note ?? "no reason given"} (deploy advance ${a.id} --retry)`]
+					: a.writing?.state === "pending"
+						? ["  Writing starts once the site is live: posts at /blog and a landing page a week"]
+						: []),
 		];
 		if (a.dns?.to_set?.length) {
 			lines.push("", `Set these where ${a.domain}'s DNS is:`);

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