@letterstory/cli 0.148.2 → 0.148.4

package/README.md

@@ -1,7 +1,7 @@
 # `@letterstory/cli`
 
-Spin up and manage Letterstory **phantom blogs** from your terminal. The CLI is a thin
-client over the Letterstory MCP endpoint (`POST /api/mcp`) — it wraps the same tool
+Spin up and manage Letter **phantom blogs** from your terminal. The CLI is a thin
+client over the Letter MCP endpoint (`POST /api/mcp`) — it wraps the same tool
 manifest an agent sees, so it never drifts from the API.
 
 ## Install
@@ -79,7 +79,7 @@ refresh automatically. Run `letterstory logout` to revoke the session and forget
 
 **Or use a static API key** (for CI/automation, or when you want scoped-down access):
 
-You need a Letterstory API key (starts with `ls_`; legacy `lb_` keys still work) with the `phantom:read` and
+You need a Letter API key (starts with `ls_`; legacy `lb_` keys still work) with the `phantom:read` and
 `phantom:write` capabilities — mint one in the app under **Settings → API keys**
 (<https://app.letterstory.com/settings?tab=api-keys>).
 Add `phantom:domain` too if you plan to buy custom domains.
@@ -96,7 +96,7 @@ Run `letterstory whoami` (alias `status`) any time to confirm which key/url (or
 resolved and see your company profile. Run `letterstory config` to see the resolved url and
 credential source without making a network call.
 
-## Phantomstory — a collection Letterstory hosts as an independent publication
+## Phantomstory — a collection Letter hosts as an independent publication
 
 A phantom is a site we host that renders one of your collections; it never carries your
 company's name. Phantoms are metered in SITES live at once (`phantom balance`), not posts.
@@ -129,7 +129,7 @@ letterstory phantom delete <phantom-id> --yes
 Pass `--no-wait` to return immediately and poll later with `phantom get`, `--no-configure`
 for a bare site, or `--dry-run` to see the plan without provisioning anything.
 
-Publishing to the site is a **collection run** on its collection (below). Letterstory's own
+Publishing to the site is a **collection run** on its collection (below). Letter's own
 launch recipe from a client domain — positioning inferred, a masthead proposed, the first
 posts seeded — is `phantom-onboard` (see "Propose, then onboard a phantom").
 
@@ -603,7 +603,7 @@ letterstory arena role set reviewsite.com --role context
 letterstory arena role set rival.com --role company --company "Rival" --rival
 letterstory arena role reset rival.com                 # hand it back to research
 
-# Arenas are callable endpoints with one-file defaults (the org's default arena is "Letterstory"):
+# Arenas are callable endpoints with one-file defaults (the org's default arena is "Letter"):
 letterstory arena list
 letterstory arena endpoint create --name "Docs research" --defaults '{"depth":"barebones"}'
 letterstory arena endpoint config <arena-id> [--file cfg.json]
@@ -913,7 +913,7 @@ app; `letterstory mail connections` shows what is connected.
 
 ## Anything else
 
-Every Letterstory tool is reachable, not just the ones with a dedicated command group:
+Every Letter tool is reachable, not just the ones with a dedicated command group:
 
 ```bash
 letterstory whoami                                 # or: status — verify your key + who it's for

package/lib/cli.mjs

@@ -1,4 +1,4 @@
-// Argument parsing, help, and command routing for the Letterstory CLI. `run(argv)`
+// Argument parsing, help, and command routing for the Letter CLI. `run(argv)`
 // is the single entry the bin and the tests both call; it returns an exit code and
 // never throws for user-facing problems (those become a printed CliError + code 1).
 
@@ -66,7 +66,7 @@ import {
 
 // Matches cli/package.json; publish-cli.yml rewrites both to the published version.
 // Matches cli/package.json; publish-cli.yml rewrites both to the published version.
-export const VERSION = "0.148.2";
+export const VERSION = "0.148.4";
 
 // 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
@@ -76,6 +76,8 @@ export const BOOLEAN_FLAGS = new Set([
 	"again",
 	"notify-slack",
 	"remap",
+	// site observations: each kind noticed, not the observations (keys_only).
+	"keys",
 	// login: one-link device sign-in instead of the loopback browser flow.
 	"device",
 	"json",
@@ -132,6 +134,12 @@ export const BOOLEAN_FLAGS = new Set([
 	"verbose",
 	"no-color",
 	"dry-run",
+	// admin demo list --enrollable, show --moves, set --enroll|--unenroll
+	"enrollable",
+	"moves",
+	"enroll",
+	"unenroll",
+	"clean-slate",
 	// admin recipes list --enabled-only, save --enable|--disable, import --retire-missing
 	"enabled-only",
 	"enable",
@@ -365,7 +373,7 @@ function buildHelp(bin) {
 	const heading =
 		bin === "phantom"
 			? "👻 phantom — deploy and manage Phantomstory blogs from your terminal"
-			: "letterstory — spin up and manage Letterstory phantom blogs from your terminal";
+			: "letterstory — spin up and manage Letter phantom blogs from your terminal";
 	return `${heading}
 
 Usage:
@@ -410,7 +418,7 @@ Collections (the content engine as a primitive — one door, 'collection run'):
   collection links <id> [--refresh]                    Internal-link refresh: on/off, posts due (--refresh runs the next batch now)
   collection delete <id> --yes
 
-Phantomstory (a collection Letterstory hosts as an independent publication):
+Phantomstory (a collection Letter hosts as an independent publication):
   phantom list                                         Your phantoms (metered in SITES live at once)
   phantom new --name <n> [--description <t>] [--theme <t>] [--collection <id>] [--customer-ref <r>]
               [--no-configure] [--config '<json>'] [--client-domain <d>] [--dry-run] [--no-wait]
@@ -771,7 +779,7 @@ What does this org still need? (the router — reads only, decides nothing):
                                                        Planner, CMS, phantom) with its status:
                                                        done / running / ready / blocked, and what
                                                        a blocked step is waiting on.
-  ${bin === "phantom" ? "onboard" : "phantom-onboard"} next                         The first ready step Letterstory recommends,
+  ${bin === "phantom" ? "onboard" : "phantom-onboard"} next                         The first ready step Letter recommends,
                                                        as the exact command to run next. Optional
                                                        steps are listed, never chosen.
 
@@ -834,7 +842,7 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
                                                        the queries behind the answer. Needs the
                                                        fleet:query capability on the staff key.
   admin recipes list [--enabled-only] | show <id|name> | vocab [--json]
-                                                       Plan recipes: Letterstory's one global library behind
+                                                       Plan recipes: Letter's one global library behind
                                                        every account's Plan (/superadmin/plan-recipes). vocab
                                                        says what a recipe can say (fields, goals, company
                                                        types, primitives). Needs recipes:read.
@@ -848,6 +856,19 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
                      [--primitives a,b|none] [--goals a,b|none] [--company-types a,b|none] [--enable|--disable] [--position n]
                                                        Create one (no id) or change one. Needs recipes:write.
   admin recipes delete <id> --yes                      Delete for good (save --disable retires and keeps it).
+  admin demo guide                                     How to run a demo, step by step, and what every knob and
+                                                       seed shows on screen. Read it first.
+  admin demo list [--enrollable] | show <org-id> [--moves]
+                                                       Demo orgs (/superadmin/demo): what each shows beside
+                                                       what it really has. Needs demo:read.
+  admin demo set <org-id> [--enroll] [--phantom parked] [--search-console hidden] [--inject <key>]... [--save-as n]
+                                                       Set what a demo org shows (merged); 'shown' puts a thing
+                                                       back. --file takes a scenario as JSON. Needs demo:write.
+  admin demo reset <org-id> <scenario> [--clean-slate] [--close-prs since_applied|all_open|none]
+                                                       Undo the last take (its PRs closed, builds archived), then
+                                                       show a scenario: real, fresh_geo, fresh_seo, after_approve
+                                                       or a saved one. --clean-slate closes every open PR and
+                                                       archives every build.
   admin suggestion-recipes list|export [--out f.json]|import <f.json> [--dry-run] [--retire-missing]|stats
                                                        Build's suggestion recipes: plain-language ways
                                                        Letterpress finds what a site should build (look at,
@@ -1152,7 +1173,7 @@ no endpoint, no run. Applied on phantom create --composition '{"key":"..."}'):
   compositions resolve <composition-key>                Preview what create_phantom would
                                                        merge in — read-only, costs nothing.
 
-Shredder (diversify content produced outside Letterstory; structure preserved):
+Shredder (diversify content produced outside Letter; structure preserved):
   shredder list                                        Your shredder endpoints + run counts
   shredder create --name <n>                           New endpoint (returns a callable public id)
   shredder delete <endpoint-id> --yes
@@ -1357,7 +1378,7 @@ Mail:
   mail postal-address "<address>"                      Set the org's CAN-SPAM mailing address (email footers)
   mail vercel-key set (--token <t> | --token-file <path|->) [--team <team_id>]
                                                        Buy and own mail domains on your Vercel account / team
-  mail vercel-key remove --yes                         Future purchases go back to Letterstory's account
+  mail vercel-key remove --yes                         Future purchases go back to Letter's account
   mail registrant --first-name <f> --last-name <l> --email <e> --phone "(415) 555-1234"
            --address <a> [--address2 <a>] --city <c> --state <s> --zip <z> --country "United States" [--company <c>]
                                                        WHOIS registrant for purchases on your Vercel key
@@ -1403,7 +1424,7 @@ The Site (one model of your whole marketing site, keyed by host and path):
   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 observations <host> [path] [--state open|dismissed|resolved] [--tone risk|warn|info] [--key <k>] [--since <iso>] [--min-reach <0..1>] [--keys]
   site observe <host> [path] [--max-pages <n>]         Jev pass: meta accuracy, title, outdated
   site dismiss <host> <observation-id> --reason <why> [--kind not_relevant|already_handled|wrong|later] [--decision dismiss|reopen]
   site families <host> [path] [--state suggested|tracked|dismissed]
@@ -1420,8 +1441,8 @@ The Site (one model of your whole marketing site, keyed by host and path):
   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 changes (Claude Code edits your repo in a sandbox; the Letter GitHub App opens a PR):
+  repo repos                                           Repos the Letter 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

package/lib/client.mjs

@@ -1,4 +1,4 @@
-// The Letterstory CLI's transport: a thin JSON-RPC client over the MCP endpoint
+// The Letter CLI's transport: a thin JSON-RPC client over the MCP endpoint
 // (POST /api/mcp), plus config resolution. The CLI wraps the same tool manifest an
 // agent sees, so it stays in sync with the server by construction — there is no
 // second copy of the surface here, only ergonomic wrappers around tools/call.

package/lib/commands/admin.mjs

@@ -19,6 +19,7 @@
 //   admin brand-detection <org-id>                                                   (fleet:read)
 //   admin brand-detection <org-id> [--term t]... [--exact t]... [--exclude p]... [--note "…"] | --clear [--note "…"]   (fleet:instrument)
 //   admin recipes list|show|vocab|export|import|save|delete …                        (recipes:read / recipes:write)
+//   admin demo guide|list|show|set|reset …                                                 (demo:read / demo:write)
 //   admin models runs|run|star|unstar|scoreboard|requests|request|sampling …       (models:read / models:write)
 //   admin replays [--org <id>] [--target <id>] [--status …] [--limit n]                (fleet:read)
 //   admin replay --org <id> [<response-id> | --target <id>] [--surface …]           (fleet:replay)
@@ -5097,7 +5098,7 @@ function recipeFromFlags(flags) {
 }
 
 /**
- * `admin recipes …` — the Plan recipes page (/superadmin/plan-recipes) for an agent: Letterstory's
+ * `admin recipes …` — the Plan recipes page (/superadmin/plan-recipes) for an agent: Letter's
  * one global library of recipes behind every account's Plan. The loop for building it out is
  * `vocab` (what a recipe can say) → `export --out recipes.json` → edit → `import recipes.json
  * --dry-run` → `import recipes.json`. Reads need recipes:read on the staff key, writes
@@ -5207,7 +5208,7 @@ const LAGO = "/api/superadmin/billing/lago";
 const LAGO_USAGE = `Usage: admin billing lago <command>
   catalog [--apply] [--include-drafts]   what the plan catalog would change in Lago; --apply makes it so
   provision <org-id> --plan starter [--ratio 4] [--why "…" above 4x] [--complimentary 20000] [--stripe-customer cus_…] [--start 2026-11-02T00:00:00Z] [--review 2027-05-01]
-  reconcile [--org <org-id>]             Lago's tokens this period against what we rated and forwarded
+  reconcile [--org <org-id>]             Lago's tokens this period and last invoice against what we forwarded
   forward                                forward billable usage to Lago now (the cron's pass)
   payments [--org <org-id>] [--open]     failed payments and what the retry loop did about each
   payments retry <lago-invoice-id>       charge one failed invoice again now
@@ -5266,7 +5267,10 @@ async function cmdAdminBilling(ctx) {
 		case "reconcile": {
 			const params = new URLSearchParams(compact({ orgId: flagStr(flags.org) }));
 			const result = await staffRequest(ctx, "GET", `${LAGO}/reconcile${params.size ? `?${params}` : ""}`);
-			ok(ctx, result.ok ? "Lago agrees with us." : "Lago and we disagree: see the orgs below.");
+			ok(
+				ctx,
+				result.summary ?? (result.ok ? "Lago agrees with us." : "Lago and we disagree: see the orgs below.")
+			);
 			printResult(io, flags, result);
 			return result.ok ? 0 : 1;
 		}
@@ -5274,7 +5278,9 @@ async function cmdAdminBilling(ctx) {
 			const result = await staffPost(ctx, `${LAGO}/forward`, {});
 			ok(
 				ctx,
-				`Sent ${result.sent}, already there ${result.duplicates}, held ${result.held}, refused ${result.refused}.`
+				`Sent ${result.sent}, already there ${result.duplicates}, held ${result.held}, refused ${result.refused}` +
+					`${result.swept ? `, ${result.swept} found behind the cursor` : ""}` +
+					`${result.late ? `, ${result.late} for a closed period (billed only if its invoice was not out yet)` : ""}.`
 			);
 			printResult(io, flags, result);
 			return 0;
@@ -5380,6 +5386,134 @@ async function cmdAdminBilling(ctx) {
 	}
 }
 
+// `admin demo` — demo control (docs/architecture/demo-control.md): what each demo org shows,
+// set, rehearsed and reset. The staff routes behind /superadmin/demo, the same functions and
+// schema as list_demo_orgs / get_demo_state / set_demo_state / reset_demo_state.
+const DEMO = "/api/superadmin/demo";
+const DEMO_ITEM_FLAGS = [
+	"phantom",
+	"main-blog",
+	"visitors",
+	"probes",
+	"cms",
+	"publish-target",
+	"search-console",
+	"github",
+	"domain",
+	"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>] | reset <org-id> <scenario> [--clean-slate] [--close-prs since_applied|all_open|none]";
+
+async function cmdAdminDemo(ctx) {
+	const { flags, positionals, io } = ctx;
+	const sub = positionals[0];
+	switch (sub) {
+		case "guide": {
+			const guide = await staffRequest(ctx, "GET", `${DEMO}/guide`);
+			printResult(io, flags, guide, (g) =>
+				[
+					"How to run a demo",
+					...g.steps.map(
+						(s) => `\n${s.title}\n  ${s.do}\n  page: ${s.page}\n  cli:  ${s.cli}\n  -> ${s.result}`
+					),
+					"\nWhat each knob and seed shows",
+					...g.entries.map(
+						(e) =>
+							`\n${e.label} (${e.values})\n  ${e.what}\n${e.shows_as.map((x) => `  · ${x}`).join("\n")}${
+								e.on_camera ? `\n  on camera: ${e.on_camera}` : ""
+							}${e.mind.length ? `\n${e.mind.map((m) => `  ! ${m}`).join("\n")}` : ""}`
+					),
+				].join("\n")
+			);
+			return 0;
+		}
+		case "list": {
+			const result = await staffRequest(
+				ctx,
+				"GET",
+				`${DEMO}${flagBool(flags.enrollable) ? "?candidates=1" : ""}`
+			);
+			printResult(io, flags, result, (r) =>
+				r.orgs.length
+					? r.orgs
+							.map(
+								(o) =>
+									`${o.enrolled ? "demo" : "test"}  ${o.name}  ${o.domain ?? "—"}  ${o.scenario ?? ""}${
+										o.differs?.length ? `  [${o.differs.join(", ")}]` : ""
+									}  ${o.org_id}`
+							)
+							.join("\n")
+					: "No demo orgs yet."
+			);
+			return 0;
+		}
+		case "show": {
+			const orgId = requirePositional(positionals, 1, "org-id");
+			const result = await staffRequest(
+				ctx,
+				"GET",
+				`${DEMO}/${encodeURIComponent(orgId)}${flagBool(flags.moves) ? "?moves=1" : ""}`
+			);
+			printResult(io, flags, result, (r) =>
+				[
+					`${r.org.name}  ${r.org.domain ?? "no domain"}  scenario ${r.state.scenario ?? "—"}`,
+					...r.knobs.map((k) => `  ${k.item.padEnd(16)} real: ${k.real}  ·  shown: ${k.shown}  (${k.how})`),
+					`  observations open: ${r.observations.open.map((o) => `${o.key}${o.injected ? " (demo)" : ""}`).join(", ") || "none"}`,
+					`  answers: ${r.answers.map((q) => `${q.named}/${q.answers} ${q.text}`).join("; ") || "never probed"}`,
+				].join("\n")
+			);
+			return 0;
+		}
+		case "set": {
+			const orgId = requirePositional(positionals, 1, "org-id");
+			const file = flagStr(flags.file);
+			const state = file ? JSON.parse(readFileSync(file, "utf8")) : {};
+			for (const flag of DEMO_ITEM_FLAGS) {
+				const value = flagStr(flags[flag]);
+				if (value) state[flag.replace(/-/g, "_")] = value;
+			}
+			const cap = flagNum(flags["domain-cap"]);
+			if (cap !== undefined && cap !== null) state.domain_cap = cap;
+			const inject = flagList(flags.inject);
+			const hide = flagList(flags.hide);
+			if (inject.length || hide.length)
+				state.observations = {
+					...state.observations,
+					...(inject.length ? { inject } : {}),
+					...(hide.length ? { hide } : {}),
+				};
+			const body = compact({
+				...(Object.keys(state).length ? { state } : {}),
+				enroll: flagBool(flags.enroll) || undefined,
+				unenroll: flagBool(flags.unenroll) || undefined,
+				save_as: flagStr(flags["save-as"]),
+			});
+			if (!Object.keys(body).length) throw new CliError(DEMO_USAGE);
+			const result = await staffRequest(ctx, "PATCH", `${DEMO}/${encodeURIComponent(orgId)}`, body);
+			printResult(io, flags, result, (r) => r.notes.join("\n") || "No change.");
+			return 0;
+		}
+		case "reset": {
+			const orgId = requirePositional(positionals, 1, "org-id");
+			const scenario = requirePositional(positionals, 2, "scenario");
+			const result = await staffPost(
+				ctx,
+				`${DEMO}/${encodeURIComponent(orgId)}/reset`,
+				compact({
+					scenario,
+					close_prs: flagStr(flags["close-prs"]),
+					clean_slate: flagBool(flags["clean-slate"]) || undefined,
+				})
+			);
+			printResult(io, flags, result, (r) => r.notes.join("\n"));
+			return 0;
+		}
+		default:
+			throw new CliError(DEMO_USAGE);
+	}
+}
+
 export async function cmdAdmin(ctx) {
 	const sub = ctx.positionals[0];
 	if (sub === "replays" || sub === "replay")
@@ -5400,10 +5534,11 @@ export async function cmdAdmin(ctx) {
 	if (sub === "brand-detection") return cmdAdminBrandDetection({ ...ctx, positionals: ctx.positionals.slice(1) });
 	if (sub === "republish") return cmdAdminRepublish({ ...ctx, positionals: ctx.positionals.slice(1) });
 	if (sub === "recipes") return cmdAdminRecipes({ ...ctx, positionals: ctx.positionals.slice(1) });
+	if (sub === "demo") return cmdAdminDemo({ ...ctx, positionals: ctx.positionals.slice(1) });
 	if (sub === "suggestion-recipes")
 		return cmdAdminSuggestionRecipes({ ...ctx, positionals: ctx.positionals.slice(1) });
 	throw new CliError(
-		'Usage: admin recipes … | admin suggestion-recipes … | admin republish … | admin create-org --domain <bare-domain> [--onboard] … | admin ask "<question>" | admin patterns … | admin experiments … | admin fleet-experiments … | admin crm … | admin spend … | admin evals … | admin brand-detection … | admin tuning … | admin tuning-context | admin replays … (see --help)'
+		'Usage: admin recipes … | admin demo … | admin suggestion-recipes … | admin republish … | admin create-org --domain <bare-domain> [--onboard] … | admin ask "<question>" | admin patterns … | admin experiments … | admin fleet-experiments … | admin crm … | admin spend … | admin evals … | admin brand-detection … | admin tuning … | admin tuning-context | admin replays … (see --help)'
 	);
 }
 

package/lib/commands/auth.mjs

@@ -18,7 +18,7 @@ export async function cmdLogin(ctx) {
 	if (key) {
 		if (!key.startsWith("ls_") && !key.startsWith("lb_")) {
 			io.error(
-				"Warning: Letterstory API keys usually start with 'ls_' (legacy keys start with 'lb_'). Saving anyway."
+				"Warning: Letter API keys usually start with 'ls_' (legacy keys start with 'lb_'). Saving anyway."
 			);
 		}
 		const saved = { key, ...(flagStr(flags.url) ? { url } : {}) };

package/lib/commands/collection.mjs

@@ -2,7 +2,7 @@
 //
 // A collection is a publication with a one-file configuration that produces and publishes
 // posts on a cadence; `collection run` produces ONE post on it (sourced, written, gated,
-// published, and — when Letterstory hosts the site — rebuilt). Runs are 20–60 minutes, so
+// published, and — when Letter hosts the site — rebuilt). Runs are 20–60 minutes, so
 // `collection run` submits and then follows the run unless you tell it not to
 // (`--no-wait`); `collection run-status` picks it up later. A direct run spends the
 // collection's weekly cadence budget (its posts_per_week); the planner's own slots are the

package/lib/commands/feedback.mjs

@@ -1,4 +1,4 @@
-// `feedback` — submit product feedback about Letterstory itself: a bug, something
+// `feedback` — submit product feedback about Letter itself: a bug, something
 // missing, something unclear, a feature request, or praise. One subcommand, one tool
 // (submit_feedback) — there is no read/list surface yet, staff triage this table directly.
 

package/lib/commands/mcp.mjs

@@ -1,4 +1,4 @@
-// `mcp` — print ready-to-paste configuration for wiring the Letterstory MCP server
+// `mcp` — print ready-to-paste configuration for wiring the Letter MCP server
 // into an agent (Claude Code, Claude Desktop, Cursor, …). Same endpoint/auth header
 // the CLI itself uses (see client.mjs's `mcpEndpoint` / `x-integrations-key`), just
 // packaged for copy-paste instead of for this process's own requests.
@@ -30,7 +30,7 @@ export function cmdMcp(ctx) {
 
 	const masked = config.key ? `${config.key.slice(0, 6)}…${config.key.slice(-4)}` : undefined;
 
-	io.log(`Letterstory MCP`);
+	io.log(`Letter MCP`);
 	io.log(`  endpoint:  ${endpoint}`);
 	io.log(`  transport: streamable-http`);
 	io.log(`  auth:      ${header}: ${masked ?? "(no key found — run `" + ctx.bin + " login` first)"}`);

package/lib/commands/onboard.mjs

@@ -760,7 +760,7 @@ async function cmdOnboardNext(ctx) {
 	return 0;
 }
 
-// `onboard primitives [<domain>]` — what Letterstory would stand up for this company: one
+// `onboard primitives [<domain>]` — what Letter would stand up for this company: one
 // read of propose_primitive_plan, printed item by item with the org-config record each one
 // stands for. Nothing runs; the plan is applied with `org apply`.
 // A first read crawls the site; `pending` means one is already in flight, so wait and ask.

package/lib/commands/outbound.mjs

@@ -810,7 +810,7 @@ export async function cmdMail(ctx) {
 			if (action === "remove") {
 				if (!inner.flags.yes) {
 					ctx.io.error(
-						`Removing the key sends future purchases back to Letterstory's account and drops the registrant contact. Re-run with --yes to confirm: ${ctx.bin} mail vercel-key remove --yes`
+						`Removing the key sends future purchases back to Letter's account and drops the registrant contact. Re-run with --yes to confirm: ${ctx.bin} mail vercel-key remove --yes`
 					);
 					return 1;
 				}

package/lib/commands/phantom.mjs

@@ -1,4 +1,4 @@
-// `phantom` — Phantomstory: a collection Letterstory hosts as an independent publication.
+// `phantom` — Phantomstory: a collection Letter hosts as an independent publication.
 //
 // Hosting only: the site, its identity and theme, its domain, its rebuilds, its balance.
 // Publishing a post to it is `collection run --collection <its collection_id>`; its

package/lib/commands/repo.mjs

@@ -1,5 +1,5 @@
 // `repo` — changes to the org's own repos, made by Claude Code in a sandbox and opened as a
-// pull request by the Letterstory GitHub App (src/lib/repo-changes). One subcommand per tool:
+// pull request by the Letter GitHub App (src/lib/repo-changes). One subcommand per tool:
 //   repo start   → start_repo_change     repo status → get_repo_change
 //   repo activity → get_repo_change_activity (what the sandbox is doing; --follow polls)
 //   repo list    → list_repo_changes     repo cancel → cancel_repo_change
@@ -711,7 +711,7 @@ async function repoRepos(ctx) {
 	return 0;
 }
 
-/** `repo prs [--repo owner/name]`: every open PR, longest-idle first, and which Letterstory opened. */
+/** `repo prs [--repo owner/name]`: every open PR, longest-idle first, and which Letter opened. */
 async function repoPrs(ctx) {
 	const { client, flags, io } = ctx;
 	refuseUnknownFlags(ctx, {}, ["repo"]);
@@ -722,7 +722,7 @@ async function repoPrs(ctx) {
 			: r.pullRequests
 					.map(
 						(p) =>
-							`${p.repo}#${p.number}  ${p.title}  (${p.daysSinceUpdate}d idle${p.draft ? ", draft" : ""}${p.letterRun ? `, Letterstory run ${p.letterRun.status}` : ""})\n  ${p.url}`
+							`${p.repo}#${p.number}  ${p.title}  (${p.daysSinceUpdate}d idle${p.draft ? ", draft" : ""}${p.letterRun ? `, Letter run ${p.letterRun.status}` : ""})\n  ${p.url}`
 					)
 					.join("\n")
 	);

package/lib/commands/shredder.mjs

@@ -1,4 +1,4 @@
-// `shredder` — create shredder endpoints and run content produced OUTSIDE Letterstory
+// `shredder` — create shredder endpoints and run content produced OUTSIDE Letter
 // through the cross-provider shredder. A shred rewrites each sentence across multiple
 // LLM providers to diversify, leaving structure (headings, lists, tables) untouched, and
 // logs every call to telemetry against the org's shred balance.

package/lib/commands/sim.mjs

@@ -6,7 +6,7 @@
 //   letterstory sim create --name "Attio API" --spec-url https://api.attio.com/openapi/api
 //   letterstory sim show <id>
 //   letterstory sim rule <id> /v2/webhooks sink --note "never call real endpoints"
-//   letterstory sim create --name "Letterstory" --tools-file tools.json --tool-route "/api/integrations/tools/{name}"
+//   letterstory sim create --name "Letter" --tools-file tools.json --tool-route "/api/integrations/tools/{name}"
 //   letterstory sim key <id> --agent our-ci --goal "nightly integration test"
 //   letterstory sim seed <id> --prompt "a 3-person content team with two blogs" --activate
 //   letterstory sim seed <id> --use <seed-id|none>

package/lib/commands/site.mjs

@@ -133,6 +133,7 @@ const ARGS = {
 		since: "since",
 		min_reach: { flag: "min-reach", type: "num" },
 		limit: { flag: "limit", type: "num" },
+		keys_only: { flag: "keys", type: "bool" },
 	},
 	observe_site: {
 		host: { positional: 0, required: true, label: "host" },

package/lib/oauth.mjs

@@ -1,5 +1,5 @@
 // Browser-based OAuth 2.1 login (RFC 8252 loopback redirect + PKCE) for the
-// Letterstory CLI. This talks to the app's own /api/oauth/* endpoints — see
+// Letter CLI. This talks to the app's own /api/oauth/* endpoints — see
 // src/lib/oauth/core.ts on the server side for the matching implementation.
 
 import { randomBytes, createHash } from "node:crypto";
@@ -38,12 +38,12 @@ function openBrowser(url) {
 	}
 }
 
-const CALLBACK_HTML_OK = `<!doctype html><html><head><title>Letterstory CLI</title></head>
+const CALLBACK_HTML_OK = `<!doctype html><html><head><title>Letter CLI</title></head>
 <body style="font-family: system-ui, sans-serif; max-width: 28rem; margin: 4rem auto; text-align: center;">
 <h2>You're signed in.</h2><p>You can close this tab and return to your terminal.</p>
 </body></html>`;
 
-const CALLBACK_HTML_ERROR = `<!doctype html><html><head><title>Letterstory CLI</title></head>
+const CALLBACK_HTML_ERROR = `<!doctype html><html><head><title>Letter CLI</title></head>
 <body style="font-family: system-ui, sans-serif; max-width: 28rem; margin: 4rem auto; text-align: center;">
 <h2>Sign-in failed.</h2><p>Return to your terminal for details.</p>
 </body></html>`;

package/package.json

@@ -1,10 +1,10 @@
 {
 	"name": "@letterstory/cli",
-	"version": "0.148.2",
-	"description": "Spin up and manage Letterstory phantom blogs from your terminal.",
+	"version": "0.148.4",
+	"description": "Spin up and manage Letter phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",
-	"author": "Letterstory",
+	"author": "Letter",
 	"homepage": "https://github.com/letterstory/letterstory/tree/main/cli#readme",
 	"repository": {
 		"type": "git",