@letterstory/cli 0.98.4 → 0.99.0

package/lib/cli.mjs

@@ -59,7 +59,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.98.4";
+export const VERSION = "0.99.0";
 
 // 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
@@ -93,6 +93,7 @@ export const BOOLEAN_FLAGS = new Set([
 	"stdin",
 	// `authors generate <id> --with-bios`.
 	"with-bios",
+	"all-live",
 	// `admin tuning climb-new … --no-run`; `rung-propose --accept --with-replay` / `rung-accept --with-replay`
 	// (not `--replay`: `evals` takes `--replay <stage>`).
 	"no-run",
@@ -213,6 +214,12 @@ export const BOOLEAN_FLAGS = new Set([
 	"suggested",
 	"sync",
 	"texts",
+	// admin crm outreach (launch-day list)
+	"archive",
+	"lookup",
+	"not-reached",
+	"reached",
+	"todo",
 ]);
 
 // Tiny argv parser: `--flag value`, `--flag=value`, boolean `--flag`, and positionals.
@@ -653,6 +660,11 @@ Domain onboarding (ONE SHOT: a bare domain in, a fully-configured organization o
 
 Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org exists):
   admin ask "<question>" [--sql] [--json]              Ask the whole fleet a question in English.
+  admin republish [<deployment-id>…] [--domains a.com,b.com] [--all-live] [--dry-run] [--json]
+                                                       Rebuild live phantom sites (no content regenerated), 12 per
+                                                       request; prints each failure's reason and exits 1 if any
+                                                       failed. Needs a staff key with fleet:rebuild (+ fleet:read
+                                                       to resolve --domains / --all-live).
                                                        Answered from the live database with
                                                        read-only SQL across every org; --sql prints
                                                        the queries behind the answer. Needs the
@@ -691,13 +703,17 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
                                                        Posts on independent sites that name the client,
                                                        with the paragraphs that name it and the live URL.
           | mark <experiment-id> <article-id…> --arm <arm> | unmark <experiment-id> <article-id…>
-          | new --template sponsor_disclosure_v1|sponsor_disclosure_clients_v1|article_disclosure_v1|mention_degree_v1|citation_shape_v1
+          | new --template sponsor_disclosure_v1|sponsor_disclosure_clients_v1|sponsor_disclosure_fresh_v1|article_disclosure_v1|article_disclosure_fresh_v1|mention_degree_v1|citation_shape_v1
           | new --spec-file spec.json                  A custom experiment ({key, hypothesis, unit, arms, response_var}).
           | assign <experiment-id> <unit-id…> | assign-eligible <experiment-id> | apply <experiment-id>
           | assign-orgs <experiment-id> <org-domain-or-id…>
                                                        Site/collection arms (safe mode: our own sites, or one
                                                        site per named client). A running experiment applies
                                                        each new unit's arm at once; start applies them all.
+          | post-sites | spin-up-posts <experiment-id> <collection-id> [--pairs 1-5]
+                                                       Fresh-post experiment: pairs of new posts on sibling
+                                                       topics of one site, both naming the client once, one
+                                                       born disclosed. Written and published on autopilot.
           | start|stop <experiment-id> | decide <experiment-id> --decision "…"
                                                        Reads need fleet:read; writes fleet:experiment.
   admin experiments list [--q colons] [--status proposed] [--primitive write] [--stage rarity] | show <id>

package/lib/commands/admin.mjs

@@ -14,7 +14,7 @@
 //      The old names — evals, eval-add, eval-set, proposals, propose-eval, capture-eval, reject-eval — still work.)
 //   admin evals scoreboard|cases|runs|run|triage|guard|retire …                      (fleet:read / tuning:experiment)
 //   admin fleet-experiments list|articles|clients|mark|unmark|new|assign|assign-eligible|assign-orgs|spin-up|apply|start|stop|decide …  (fleet:read / fleet:experiment)
-//   admin crm import|capture|signals|record|signal|accounts|account|score|slack-channels|link-slack|white-glove|set-white-glove|churn|record-churn|undo-churn|onboard|onboarding|retry-onboarding|onboard-plan|payment-link …  (crm:read / crm:write)
+//   admin crm import|capture|outreach|signals|record|signal|accounts|account|score|slack-channels|link-slack|white-glove|set-white-glove|churn|record-churn|undo-churn|onboard|onboarding|retry-onboarding|onboard-plan|payment-link …  (crm:read / crm:write)
 //   admin spend summary|reconcile|pnl|entries|add|import|usage|remove|reference|stripe-sync|services|service …  (spend:read / spend:write)
 //   admin brand-detection <org-id>                                                   (fleet:read)
 //   admin brand-detection <org-id> [--term t]... [--exact t]... [--exclude p]... [--note "…"] | --clear [--note "…"]   (fleet:instrument)
@@ -543,7 +543,7 @@ async function cmdAdminTuningContext(ctx) {
  *   admin tuning kernels                                       every catalog kernel, live version, writer, candidates
  *   admin tuning kernel <service-kernel-id> [--version N|live]  one version's file (JSON)
  *   admin tuning candidate <service-kernel-id> --file f.json [--note "…"]   save a file as a candidate version
- *   admin tuning compare --title "…" --candidates Hazel:21,Aspen:20 [--experiment <id>] [--pairs 20]   start a comparison (--pairs caps it: breadth at 10–20, depth at the full 66)
+ *   admin tuning compare --title "…" --candidates Hazel:21,Aspen:20 [--experiment <id>] [--pairs 20]   start a comparison (default 10 pairs; --pairs caps it: 20 for breadth, 66 for depth; comparison-extend adds more)
  *                        (Hazel:23@22 reads v23 against the test version v22 instead of live; it cannot promote)
  *   admin tuning comparisons | comparison <id>                list / read one (per-measure verdicts)
  *   admin tuning picks <comparison-id> [--criterion opening]   the blind queue (next pairs); with a criterion, the pairs not yet read for it (Eye Test mode)
@@ -656,7 +656,7 @@ async function cmdAdminTuningContext(ctx) {
  *   admin tuning research-compare --title "…" --candidates <version-id>,… | --patches '[{…},{…}]'   several
  *                            candidates against ONE control arm (k + 1 runs per input, not 2k)
  *   admin tuning arena-dials                                   every arena setting: help, default, evidence, live's value
- *   admin tuning comparison-extend <comparison-id> --keys k1,k2 | --all   add inputs to a comparison on fixed inputs
+ *   admin tuning comparison-extend <comparison-id> --pairs N | --keys k1 --keys k2 | --all   add the next N pairs to a Write comparison, or inputs to one on fixed inputs
  *   admin tuning research-inputs [--set v1]                    research's fixed inputs
  *   admin tuning research-split [--since-hours 72] [--at <iso>,…]   what each deploy did to research in production
  *   admin tuning research-standing                             live's level on the fixed inputs, week by week
@@ -845,7 +845,7 @@ async function cmdAdminTuning(ctx) {
 			const list = flagList(flags.candidates);
 			if (!title || !list?.length)
 				throw new CliError(
-					'Usage: admin tuning compare --title "…" --candidates Hazel:21,Aspen:20 [--experiment <id>] [--pairs 20]'
+					'Usage: admin tuning compare --title "…" --candidates Hazel:21,Aspen:20 [--experiment <id>] [--pairs 20]  (default 10 pairs)'
 				);
 			// kernel:version, or kernel:version@control to read it against a test version instead of live.
 			const candidates = list.map((item) => {
@@ -2238,14 +2238,25 @@ async function cmdAdminTuning(ctx) {
 			return io.log(lines.join("\n"));
 		}
 		case "comparison-extend": {
+			// A Write comparison grows by the next N pairs; one on fixed inputs by named keys or all.
+			const pairs = flagNum(flags.pairs);
 			const keys = flagBool(flags.all) ? "all" : flagList(flags.keys);
-			if (!id || !keys?.length)
-				throw new CliError("Usage: admin tuning comparison-extend <comparison-id> --keys k1,k2 | --all");
-			const r = await staffRequest(ctx, "POST", `${T}/comparisons/${id}/extend`, { keys });
+			const usage =
+				"Usage: admin tuning comparison-extend <comparison-id> --pairs N | --keys k1 --keys k2 | --all";
+			if (!id || (pairs === undefined && !keys?.length) || (pairs !== undefined && keys?.length))
+				throw new CliError(usage);
+			if (pairs !== undefined && (!Number.isInteger(pairs) || pairs < 1))
+				throw new CliError("--pairs must be a whole number, 1 or more");
+			const r = await staffRequest(
+				ctx,
+				"POST",
+				`${T}/comparisons/${id}/extend`,
+				pairs !== undefined ? { pairs } : { keys }
+			);
 			return json
 				? printResult(io, flags, r)
 				: io.log(
-						`comparison ${r.comparison.id}: ${r.comparison.added.length} input(s) added, ${r.comparison.pairs} in all`
+						`comparison ${r.comparison.id}: ${r.comparison.added.length} ${pairs !== undefined ? "pair" : "input"}(s) added, ${r.comparison.pairs} in all`
 					);
 		}
 		case "research-inputs": {
@@ -2819,6 +2830,133 @@ async function cmdAdminCrmCapture(ctx, paths) {
 	}
 }
 
+/**
+ * `admin crm outreach …` — the launch-day list (or `--list <key>`), the same operations the
+ * CRM's Launch day tab calls (src/lib/crm/outreach.ts, /api/superadmin/crm/outreach):
+ *
+ *   outreach [list] [--owner Neha] [--todo]           who is on it; --todo = not reached yet
+ *   outreach add "Jane Doe" [--company …] [--owner …] [--channel x] [--relationship …]
+ *                [--ask …] [--linkedin …] [--email …] [--lookup]
+ *   outreach lookup "Jane Doe from Acme" [shot.png …]  prefilled from the web; writes nothing
+ *   outreach set <id> [--reached|--not-reached] [--response "…" --tone positive]
+ *                [--owner-id <uuid>] [--channel …] [--ask …] [--draft "…"] [--archive|--restore]
+ */
+async function cmdAdminCrmOutreach(ctx, args) {
+	const { flags, io } = ctx;
+	const [sub = "list", ...rest] = args;
+	const list = flagStr(flags.list);
+	const json = flagBool(flags.json);
+	const line = (p) =>
+		[
+			p.reachedAt ? "✓" : "·",
+			p.name,
+			p.company ? `(${p.company})` : null,
+			p.ownerName ? `— ${p.ownerName}` : "— unowned",
+			p.channel ? `via ${p.channel}` : null,
+			p.response ? `“${p.response}”` : null,
+			`  ${p.id}`,
+		]
+			.filter(Boolean)
+			.join(" ");
+	switch (sub) {
+		case "list": {
+			const r = await staffRequest(
+				ctx,
+				"GET",
+				`${CRM}/outreach${list ? `?list=${encodeURIComponent(list)}` : ""}`
+			);
+			const owner = flagStr(flags.owner)?.toLowerCase();
+			const people = r.people
+				.filter((p) => !owner || (p.ownerName ?? "").toLowerCase().includes(owner))
+				.filter((p) => !flagBool(flags.todo) || !p.reachedAt);
+			if (json) return printResult(io, flags, { ...r, people });
+			const reached = r.people.filter((p) => p.reachedAt).length;
+			io.log(`${r.list}: ${r.people.length} people, ${reached} reached`);
+			return io.log(people.length ? people.map(line).join("\n") : "(nobody)");
+		}
+		case "add": {
+			const name = rest.join(" ").trim();
+			if (!name)
+				throw new CliError('Usage: admin crm outreach add "Jane Doe" [--company …] [--owner …] [--lookup]');
+			const r = await staffPost(
+				ctx,
+				`${CRM}/outreach`,
+				compact({
+					list,
+					source: "api",
+					lookup: flagBool(flags.lookup) || undefined,
+					people: [
+						compact({
+							name,
+							company: flagStr(flags.company),
+							title: flagStr(flags.title),
+							owner: flagStr(flags.owner),
+							channel: flagStr(flags.channel),
+							relationship: flagStr(flags.relationship),
+							ask: flagStr(flags.ask),
+							linkedinUrl: flagStr(flags.linkedin),
+							email: flagStr(flags.email),
+							notes: flagStr(flags.notes),
+						}),
+					],
+				})
+			);
+			if (json) return printResult(io, flags, r);
+			for (const p of r.created) io.log(`added ${line(p)}`);
+			for (const d of r.duplicates)
+				io.log(`already on the list: ${d.existingName} (matched on ${d.matchedOn})  ${d.existingId}`);
+			return;
+		}
+		case "lookup": {
+			const images = rest
+				.filter((a) => CRM_CAPTURE_TYPES[a.split(".").pop()?.toLowerCase() ?? ""])
+				.map((path) => ({
+					media_type: CRM_CAPTURE_TYPES[path.split(".").pop().toLowerCase()],
+					data: readFileSync(path).toString("base64"),
+				}));
+			const text = rest
+				.filter((a) => !CRM_CAPTURE_TYPES[a.split(".").pop()?.toLowerCase() ?? ""])
+				.join(" ")
+				.trim();
+			if (!text && !images.length)
+				throw new CliError('Usage: admin crm outreach lookup "Jane Doe from Acme" [shot.png …]');
+			const r = await staffPost(
+				ctx,
+				`${CRM}/outreach/lookup`,
+				compact({ text: text || undefined, images: images.length ? images : undefined })
+			);
+			if (json) return printResult(io, flags, r);
+			for (const p of r.people)
+				io.log(
+					`${p.name}${p.title ? `, ${p.title}` : ""}${p.company ? ` @ ${p.company}` : ""}${p.fundingStage ? ` · ${p.fundingStage}` : ""}${p.ycBatch ? ` · YC ${p.ycBatch}` : ""}${p.lookup ? `  [${p.lookup.confidence}: ${p.lookup.why}]` : ""}`
+				);
+			if (r.notes) io.log(`notes: ${r.notes}`);
+			return;
+		}
+		case "set": {
+			const [id] = rest;
+			if (!id)
+				throw new CliError('Usage: admin crm outreach set <id> [--reached|--not-reached] [--response "…"] …');
+			const body = compact({
+				reached: flagBool(flags.reached) ? true : flagBool(flags["not-reached"]) ? false : undefined,
+				response: flagStr(flags.response),
+				responseTone: flagStr(flags.tone),
+				ownerId: flagStr(flags["owner-id"]),
+				channel: flagStr(flags.channel),
+				ask: flagStr(flags.ask),
+				relationship: flagStr(flags.relationship),
+				draftMessage: flagStr(flags.draft),
+				notes: flagStr(flags.notes),
+				archived: flagBool(flags.archive) ? true : flagBool(flags.restore) ? false : undefined,
+			});
+			const r = await staffRequest(ctx, "PATCH", `${CRM}/outreach/${id}`, body);
+			return json ? printResult(io, flags, r) : io.log(line(r));
+		}
+		default:
+			throw new CliError("Usage: admin crm outreach [list|add|lookup|set] … (see --help)");
+	}
+}
+
 /**
  * `admin crm …` — the headless half of the staff CRM, so a background agent can watch the
  * pipeline and record the signals that have no webhook (Bookface, tweet likes, DMs).
@@ -2835,6 +2973,8 @@ async function cmdAdminCrm(ctx) {
 			return cmdAdminCrmImport(ctx, id);
 		case "capture":
 			return cmdAdminCrmCapture(ctx, ctx.positionals.slice(1));
+		case "outreach":
+			return cmdAdminCrmOutreach(ctx, ctx.positionals.slice(1));
 		case "signals": {
 			const params = new URLSearchParams(
 				compact({
@@ -3076,7 +3216,7 @@ async function cmdAdminCrm(ctx) {
 		}
 		default:
 			throw new CliError(
-				"Usage: admin crm import|capture|signals|record|signal|accounts|account|score|slack-channels|link-slack|white-glove|set-white-glove|churn|record-churn|undo-churn|onboard|onboarding|retry-onboarding|onboard-plan|payment-link … (see --help)"
+				"Usage: admin crm import|capture|outreach|signals|record|signal|accounts|account|score|slack-channels|link-slack|white-glove|set-white-glove|churn|record-churn|undo-churn|onboard|onboarding|retry-onboarding|onboard-plan|payment-link … (see --help)"
 			);
 	}
 }
@@ -3847,6 +3987,42 @@ async function cmdAdminFleetExperiments(ctx) {
 				].join("\n")
 			);
 		}
+		case "post-sites": {
+			const result = await staffRequest(ctx, "GET", `${FLEET_EXPERIMENTS}/post-sites`);
+			return out(result, (r) =>
+				r.sites.length
+					? r.sites
+							.map(
+								(s) =>
+									`${s.collectionId}  ${s.orgName} · ${s.siteName}  ${s.notEligible ? `(can't: ${s.notEligible})` : `up to ${s.pairsAvailable} pair${s.pairsAvailable === 1 ? "" : "s"}`}`
+							)
+							.join("\n")
+					: "(no sites)"
+			);
+		}
+		case "spin-up-posts": {
+			const collectionId = rest.find(Boolean);
+			if (!id || !collectionId)
+				throw new CliError(
+					"Usage: admin fleet-experiments spin-up-posts <experiment-id> <collection-id> [--pairs n]   (see post-sites)"
+				);
+			const body = {
+				action: "spin_up_posts",
+				experiment_id: id,
+				collection_id: collectionId,
+				...(flagStr(flags.pairs) ? { pairs: Number(flagStr(flags.pairs)) } : {}),
+			};
+			return out(await action(body), (r) =>
+				[
+					`launching ${r.launched.length} pair${r.launched.length === 1 ? "" : "s"} on ${r.site}:`,
+					...r.launched.map(
+						(p) =>
+							`  ${p.pair}: ${p.posts.map((x) => `${x.arm} "${x.topic ?? x.topicId}" (run ${x.runId})`).join(" vs ")}`
+					),
+					...r.failed.map((f) => `  not launched (${f.pair}): ${f.message}`),
+				].join("\n")
+			);
+		}
 		case "start":
 		case "stop":
 			if (!id) throw new CliError(`Usage: admin fleet-experiments ${sub} <experiment-id>`);
@@ -3864,6 +4040,69 @@ async function cmdAdminFleetExperiments(ctx) {
 	}
 }
 
+const REPUBLISH = "/api/superadmin/deployments/republish";
+/** Sites per POST — the same chunk the Fleet dialog sends. */
+const REPUBLISH_BATCH = 12;
+
+/**
+ * `admin republish`: the Fleet "Republish sites" action for an agent. Pick sites by
+ * id, by --domains, or --all-live (every live, unpaused site); rebuild them in
+ * batches; print every failure with its reason. Exit 1 when any site failed, so a
+ * scheduled agent can tell a partial run from a clean one.
+ */
+async function cmdAdminRepublish(ctx) {
+	const { flags, io } = ctx;
+	const domains = flagList(flags.domains)
+		.flatMap((d) => d.split(","))
+		.map((d) =>
+			d
+				.trim()
+				.toLowerCase()
+				.replace(/^www\./, "")
+		)
+		.filter(Boolean);
+	const allLive = flagBool(flags["all-live"]);
+	let ids = ctx.positionals.filter(Boolean);
+	let names = new Map();
+	if (allLive || domains.length) {
+		const { sites = [] } = await staffRequest(ctx, "GET", REPUBLISH);
+		names = new Map(sites.map((s) => [s.id, s.domain ?? s.subdomain ?? s.name]));
+		const picked = allLive
+			? sites
+			: sites.filter((s) => domains.includes((s.domain ?? "").toLowerCase().replace(/^www\./, "")));
+		if (domains.length) {
+			const found = new Set(picked.map((s) => (s.domain ?? "").toLowerCase().replace(/^www\./, "")));
+			const missing = domains.filter((d) => !found.has(d));
+			if (missing.length) io.error(`! Not a live, unpaused site: ${missing.join(", ")}`);
+		}
+		ids = [...new Set([...ids, ...picked.map((s) => s.id)])];
+	}
+	if (ids.length === 0) {
+		throw new CliError(
+			"Usage: admin republish [<deployment-id>…] [--domains a.com,b.com] [--all-live] [--dry-run]"
+		);
+	}
+	if (flagBool(flags["dry-run"])) {
+		io.log(`Would republish ${ids.length} site(s):`);
+		for (const id of ids) io.log(`  ${names.get(id) ?? id}  ${id}`);
+		return 0;
+	}
+	const results = [];
+	for (let i = 0; i < ids.length; i += REPUBLISH_BATCH) {
+		const res = await staffPost(ctx, REPUBLISH, { deployment_ids: ids.slice(i, i + REPUBLISH_BATCH) });
+		results.push(...(res.results ?? []));
+		if (!flags.json) io.error(`… ${Math.min(i + REPUBLISH_BATCH, ids.length)}/${ids.length}`);
+	}
+	const failed = results.filter((r) => !r.ok);
+	printResult(io, flags, { rebuilt: results.length - failed.length, failed: failed.length, results }, () =>
+		[
+			`Rebuilt ${results.length - failed.length} site(s), ${failed.length} failed. Live pages refresh once each build finishes (~1–2 min).`,
+			...failed.map((r) => `  ✗ ${r.name ?? names.get(r.id) ?? r.id} → ${r.error ?? "unknown error"}`),
+		].join("\n")
+	);
+	return failed.length ? 1 : 0;
+}
+
 export async function cmdAdmin(ctx) {
 	const sub = ctx.positionals[0];
 	if (sub === "replays" || sub === "replay")
@@ -3880,8 +4119,9 @@ export async function cmdAdmin(ctx) {
 	if (sub === "tuning") return cmdAdminTuning({ ...ctx, positionals: ctx.positionals.slice(1) });
 	if (sub === "evals") return cmdAdminEvals({ ...ctx, positionals: ctx.positionals.slice(1) });
 	if (sub === "brand-detection") return cmdAdminBrandDetection({ ...ctx, positionals: ctx.positionals.slice(1) });
+	if (sub === "republish") return cmdAdminRepublish({ ...ctx, positionals: ctx.positionals.slice(1) });
 	throw new CliError(
-		'Usage: 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 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/package.json

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