@letterstory/cli 0.176.24 → 0.176.26

package/lib/cli.mjs

@@ -82,7 +82,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.24";
+export const VERSION = "0.176.26";
 
 /** 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;
@@ -1088,12 +1088,14 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
                                                        domain typed into Set-up maps and reads it all afresh.
   admin demo domains                                   The farm domains a new demo org could take (live
                                                        phantoms; the phantom is kept). Needs demo:read.
-  admin demo new <domain> [--name <n>] [--brief <t>] [--full] [--no-wait]
+  admin demo new <domain> [--name <n>] [--brief <t>] [--full] [--host vercel|pages] [--no-wait]
                                                        A new demo org on a farm phantom's domain: a made-up
                                                        company, a one-page site in the demo GitHub org served by
                                                        Pages, the domain moved off its phantom (kept), the org
-                                                       enrolled and shown as blank. Takes minutes; calls again
-                                                       until done (--no-wait: once). Auto-Plan stays off.
+                                                       enrolled and shown as blank. Served from Vercel (a project
+                                                       linked to the repo: a merged PR redeploys it); --host pages
+                                                       for GitHub Pages, and --host vercel on an org that has a Pages
+                                                       site moves it. Calls again until done (--no-wait: once).
   admin demo teardown <org-id> [--keep-repo]           Put the site back: the domain to its phantom, the repo gone.
   admin demo check <org-id>                            Is it ready to show? Competitors, targets, answers, the
                                                        Plan's rows, the issues open, no PR open, GitHub, the
@@ -1668,6 +1670,8 @@ Insights:
                                                        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 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 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]
@@ -1801,8 +1805,10 @@ Repo changes (Claude Code edits your repo in a sandbox; the Letter GitHub App op
   repo publish <run-id>                                Make PR on a preview in review
   repo merge <run-id>                                  Merge its open PR (a squash; the repo's branch rules decide)
   repo revise <run-id> --instructions <text>|--instructions-file <path|->  [--copy-edits-file <path|->]
+             [--attach <path>]… [--attach-ref <path>]… [--attach-url name=url]… [--attach-url-ref name=url]…
                                                        Ask for more on a preview (it takes over the preview's link) or an
-                                                       open PR (one more commit); copy edits: JSON [{ path, before, after }]
+                                                       open PR (one more commit); copy edits: JSON [{ path, before, after }];
+                                                       files as repo start takes them (--attach-ref: read, never committed)
   repo cancel <run-id> [--force]                       Stop it and delete the sandbox; no PR (Discard a preview)
 
 Feedback (tell us what's broken, missing, unclear, or wanted):

package/lib/commands/admin.mjs

@@ -6518,7 +6518,7 @@ const DEMO_ITEM_FLAGS = [
 	"setup",
 ];
 const DEMO_USAGE =
-	"Usage: admin demo guide | list [--enrollable] | show <org-id> [--moves] | set <org-id> [--enroll] [--unenroll] [--file <state.json>] [--phantom parked|shown] [--main-blog …] [--visitors …] [--probes not_run|shown] [--cms hidden|shown] [--publish-target …] [--search-console …] [--github …] [--domain …] [--setup fresh|finished] [--domain-cap n] [--inject <key>]... [--hide <key>]... [--save-as <name>] [--baseline <owner/repo>[@sha] | --clear-baseline] [--copy-from <org-id> [--copy-scenarios a,b] [--overwrite]] [--auto-reset <scenario>|off] [--every <minutes>] [--release] | domains | new <domain> [--name <n>] [--brief <t>] [--full] [--no-wait] | teardown <org-id> [--keep-repo] | bootstrap <org-id>... --from <org-id> [--scenarios a,b] [--overwrite] | reset <org-id> <scenario> [--clean-slate] [--close-prs since_applied|all_open|none] [--hold <minutes>] [--restore-repo revert|force] [--rebuild] [--reread-company] [--forget-company] [--forget-site] | check <org-id>";
+	"Usage: admin demo guide | list [--enrollable] | show <org-id> [--moves] | set <org-id> [--enroll] [--unenroll] [--file <state.json>] [--phantom parked|shown] [--main-blog …] [--visitors …] [--probes not_run|shown] [--cms hidden|shown] [--publish-target …] [--search-console …] [--github …] [--domain …] [--setup fresh|finished] [--domain-cap n] [--inject <key>]... [--hide <key>]... [--save-as <name>] [--baseline <owner/repo>[@sha] | --clear-baseline] [--copy-from <org-id> [--copy-scenarios a,b] [--overwrite]] [--auto-reset <scenario>|off] [--every <minutes>] [--release] | domains | new <domain> [--name <n>] [--brief <t>] [--full] [--host vercel|pages] [--no-wait] | teardown <org-id> [--keep-repo] | bootstrap <org-id>... --from <org-id> [--scenarios a,b] [--overwrite] | reset <org-id> <scenario> [--clean-slate] [--close-prs since_applied|all_open|none] [--hold <minutes>] [--restore-repo revert|force] [--rebuild] [--reread-company] [--forget-company] [--forget-site] | check <org-id>";
 
 const readinessLines = (r) =>
 	r
@@ -6668,6 +6668,7 @@ async function cmdAdminDemo(ctx) {
 				name: flagStr(flags.name),
 				brief: flagStr(flags.brief),
 				full: flagBool(flags.full) || undefined,
+				host: flagStr(flags.host),
 			});
 			for (let attempt = 0; ; attempt++) {
 				const r = await staffPost(ctx, `${DEMO}/orgs`, body);

package/lib/commands/build.mjs

@@ -32,6 +32,8 @@ const ARGS = {
 		delivery: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack", "linear"] },
 		notify_slack: { flag: "notify-slack", type: "bool" },
 		harness: { flag: "harness", enum: ["letterpress-1", "claude-code", "codex"] },
+		// --branch <name>: where its changes start and its pull requests go; omitted, the branch that builds the site.
+		base_branch: "branch",
 		// --effort low|medium|high|xhigh: how hard the coding agent works on each change; omitted, its own default.
 		effort: { flag: "effort", enum: ["low", "medium", "high", "xhigh"] },
 		again: { flag: "again", type: "bool" },
@@ -59,6 +61,8 @@ const ARGS = {
 		conversation_id: "conversation",
 		build_id: "build",
 		domain: "site",
+		// --branch <name>: where a build this message starts works from.
+		base_branch: "branch",
 		subjects: { flag: "subject", type: "list" },
 		// --recipe <id>: the recipe the words carry out (a Plan row's), recorded on the build it starts.
 		recipe: "recipe",
@@ -189,6 +193,7 @@ async function buildStart(ctx) {
 		"again",
 		"plan-only",
 		"plan-file",
+		"branch",
 		...FILE_FLAGS,
 	]);
 	const files = await attachedFiles(ctx);
@@ -220,6 +225,7 @@ async function buildTalk(ctx) {
 		"subject",
 		"harness",
 		"repo",
+		"branch",
 		"action",
 		"intent",
 		...FILE_FLAGS,

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`), Questions (`questions`), Pages (`pages`) and the posts naming you (`mentions`), and the live feed of what
+// Measure → Reads (`reads`), Questions (`questions`), Pages (`pages`, one page's answers `page`) and the posts naming you (`mentions`), and the live feed of what
 // is reading the phantom sites (`activity`) — the same reads the web app renders.
 
 import { CliError } from "../client.mjs";
@@ -42,6 +42,13 @@ export const ARGS = {
 		period: { flag: "period", enum: PERIODS },
 		sites: { flag: "site", type: "list" },
 	},
+	get_cited_page_answers: {
+		page: { positional: 0, label: "page", required: true },
+		period: { flag: "period", enum: PERIODS },
+		prompt_id: { flag: "question" },
+		filter: { flag: "filter", enum: ["all", "won"] },
+		limit: { flag: "limit", type: "num" },
+	},
 	list_site_mentions: {
 		sites: { flag: "site", type: "list" },
 	},
@@ -85,13 +92,15 @@ export async function cmdInsights(ctx) {
 			return call(rest, "list_measure_questions");
 		case "pages":
 			return call(rest, "list_cited_pages");
+		case "page":
+			return call(rest, "get_cited_page_answers");
 		case "mentions":
 			return call(rest, "list_site_mentions");
 		case "activity":
 			return call(rest, "get_recent_activity");
 		default:
 			throw new CliError(
-				`Unknown insights subcommand: ${sub ?? "(none)"}. Try: summary, reads, questions, pages, mentions, competitors, question, detection, activity, site, post, top, bank, access`
+				`Unknown insights subcommand: ${sub ?? "(none)"}. Try: summary, reads, questions, pages, page, mentions, competitors, question, detection, activity, site, post, top, bank, access`
 			);
 	}
 }

package/lib/commands/repo.mjs

@@ -257,6 +257,7 @@ const ARGS = {
 		run_id: { positional: 0, required: true, label: "run-id" },
 		instructions: { value: (flags) => readTextInput(flags, "instructions", "instructions-file") },
 		copy_edits: { value: (flags) => copyEdits(flags) },
+		files: { value: (_flags, _positionals, extra) => (extra.files?.length ? extra.files : undefined) },
 	},
 	list_repo_changes: {
 		status: { flag: "status", enum: ["running", "succeeded", "no_changes", "failed", "cancelled", "sent"] },
@@ -437,6 +438,19 @@ export async function uploadAttachments(ctx, paths) {
 	return uploads.map((slot) => ({ name: slot.name, upload_path: slot.path }));
 }
 
+/** --attach / --attach-ref (uploaded) and --attach-url / --attach-url-ref, as a change's `files`. */
+async function attachedFiles(ctx) {
+	const { flags } = ctx;
+	// One upload for every file (names must be unique across both), then the references marked.
+	const place = flagList(flags.attach);
+	const uploaded = await uploadAttachments(ctx, [...place, ...flagList(flags["attach-ref"])]);
+	return [
+		...uploaded.map((f, i) => (i < place.length ? f : { ...f, reference: true })),
+		...attachmentUrls(flagList(flags["attach-url"])),
+		...attachmentUrls(flagList(flags["attach-url-ref"])).map((f) => ({ ...f, reference: true })),
+	];
+}
+
 async function repoStart(ctx) {
 	const { client, flags, io } = ctx;
 	refuseUnknownFlags(ctx, {}, [
@@ -460,15 +474,7 @@ async function repoStart(ctx) {
 		"page",
 		"wait",
 	]);
-	// One upload for every file (names must be unique across both), then the references marked.
-	const place = flagList(flags.attach);
-	const uploaded = await uploadAttachments(ctx, [...place, ...flagList(flags["attach-ref"])]);
-	const files = [
-		...uploaded.map((f, i) => (i < place.length ? f : { ...f, reference: true })),
-		...attachmentUrls(flagList(flags["attach-url"])),
-		...attachmentUrls(flagList(flags["attach-url-ref"])).map((f) => ({ ...f, reference: true })),
-	];
-	const args = argsFromFlags(ARGS.start_repo_change, flags, ctx.positionals, { files });
+	const args = argsFromFlags(ARGS.start_repo_change, flags, ctx.positionals, { files: await attachedFiles(ctx) });
 	if (!args.repo_owner || !args.repo_name) throw new CliError("Missing --repo owner/name");
 	if (!args.instructions) throw new CliError("Missing --instructions (or --instructions-file <path|->)");
 
@@ -795,10 +801,13 @@ function copyEdits(flags) {
 	return list;
 }
 
-/** `repo revise <run-id> --instructions <text> [--copy-edits-file <path|->]`: a follow-up, built on top of the change. */
+/**
+ * `repo revise <run-id> --instructions <text> [--copy-edits-file <path|->] [--attach-ref <path>]…`: a follow-up,
+ * built on top of the change, with any files it needs (a screenshot to read, an image to place) as `repo start` takes them.
+ */
 async function repoRevise(ctx) {
 	const { client, flags, io } = ctx;
-	const args = argsFromFlags(ARGS.revise_repo_change, flags, ctx.positionals);
+	const args = argsFromFlags(ARGS.revise_repo_change, flags, ctx.positionals, { files: await attachedFiles(ctx) });
 	if (!args.instructions && !args.copy_edits) {
 		throw new CliError("Missing --instructions (or --instructions-file <path|->), or --copy-edits-file <path|->");
 	}

package/package.json

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