@letterstory/cli 0.87.0 → 0.87.1

package/lib/cli.mjs

@@ -57,7 +57,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.87.0";
+export const VERSION = "0.87.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
@@ -68,6 +68,8 @@ export const BOOLEAN_FLAGS = new Set([
 	"confirm-missing-target",
 	"no-wait",
 	"no-checklist",
+	"no-control",
+	"own-beat",
 	"refresh",
 	"accept",
 	"help",
@@ -347,7 +349,7 @@ Collections:
       preferred sites — dry, nothing written. Proposals are judged by fit.
   collections preferred-preview <id>
       Step 2: the proposals ranked, what the ceiling chooses, and the 1-in-N.
-  collections cite-preferred <id>
+  collections cite-preferred <id> [--exclude <article-id> …]
       Step 3: apply exactly the chosen sentences, then republish.
 
 Authors (the per-collection author bank — recurring bylines):

package/lib/commands/admin.mjs

@@ -12,7 +12,7 @@
 //     (feedback-add --fix "…" files the reader's rewrite; the diff is classified and a disposition suggested.
 //      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|mark|unmark|new|assign|assign-eligible|assign-orgs|apply|start|stop|decide …  (fleet:read / fleet: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 spend summary|reconcile|pnl|entries|add|import|usage|remove|reference|stripe-sync|services|service …  (spend:read / spend:write)
 //   admin replays [--org <id>] [--target <id>] [--status …] [--limit n]                (fleet:read)
@@ -3466,7 +3466,7 @@ async function cmdAdminFleetExperiments(ctx) {
 			const specFile = flagStr(flags["spec-file"]);
 			if (!template && !specFile)
 				throw new CliError(
-					"Usage: admin fleet-experiments new --template sponsor_disclosure_v1|sponsor_disclosure_clients_v1|article_disclosure_v1|mention_degree_v1|citation_shape_v1 | --spec-file spec.json"
+					"Usage: admin fleet-experiments new --template sponsor_disclosure_v1|sponsor_disclosure_clients_v1|sponsor_disclosure_fresh_v1|article_disclosure_v1|mention_degree_v1|citation_shape_v1 | --spec-file spec.json"
 				);
 			const body = template
 				? { action: "create_template", template }
@@ -3500,6 +3500,37 @@ async function cmdAdminFleetExperiments(ctx) {
 				return lines.join("\n") || "ok";
 			});
 		}
+		case "clients":
+			return out(await staffRequest(ctx, "GET", `${FLEET_EXPERIMENTS}/clients`), (r) =>
+				r.clients.length
+					? r.clients
+							.map((c) => `${c.name}  ${c.domain}  ${c.sites} site${c.sites === 1 ? "" : "s"}`)
+							.join("\n")
+					: "(no clients)"
+			);
+		case "spin-up": {
+			const org = rest.find(Boolean);
+			if (!id || !org)
+				throw new CliError(
+					"Usage: admin fleet-experiments spin-up <experiment-id> <org-domain-or-id> [--no-control] [--own-beat] [--posts n]"
+				);
+			const body = {
+				action: "spin_up",
+				experiment_id: id,
+				org,
+				control: !flagBool(flags["no-control"]),
+				match: flagBool(flags["own-beat"]) ? "own_beat" : "twin",
+				...(flagStr(flags.posts) ? { posts_to_seed: Number(flagStr(flags.posts)) } : {}),
+			};
+			return out(await action(body), (r) =>
+				[
+					r.twins
+						? `launching twins for ${r.org.name} on "${r.sites[0]?.beat}":`
+						: `launching for ${r.org.name}:`,
+					...r.sites.map((s) => `  ${s.arm}: ${s.name ?? s.beat}  (onboarding ${s.jobId})`),
+				].join("\n")
+			);
+		}
 		case "start":
 		case "stop":
 			if (!id) throw new CliError(`Usage: admin fleet-experiments ${sub} <experiment-id>`);
@@ -3512,7 +3543,7 @@ async function cmdAdminFleetExperiments(ctx) {
 		}
 		default:
 			throw new CliError(
-				'Usage: admin fleet-experiments list | articles [--experiment <id>] [--org <id>] [--filter all|assigned|unassigned] [--arm <arm>] [--q …] [--limit n] [--offset n] | mark <experiment-id> <article-id…> --arm <arm> | unmark <experiment-id> <article-id…> | new --template <key> | start|stop <experiment-id> | decide <experiment-id> --decision "…"'
+				'Usage: admin fleet-experiments list | articles [--experiment <id>] [--org <id>] [--filter all|assigned|unassigned] [--arm <arm>] [--q …] [--limit n] [--offset n] | mark <experiment-id> <article-id…> --arm <arm> | unmark <experiment-id> <article-id…> | new --template <key> | clients | spin-up <experiment-id> <org> [--no-control] [--own-beat] | start|stop <experiment-id> | decide <experiment-id> --decision "…"'
 			);
 	}
 }

package/lib/commands/collections.mjs

@@ -55,6 +55,8 @@ export const ARGS = {
 	},
 	cite_preferred_sources: {
 		collection_id: { positional: 0, label: "collection-id", required: true },
+		// Chosen posts a reviewer decided against.
+		exclude_article_ids: { flag: "exclude", type: "list" },
 	},
 	update_auto_pen_config: {
 		collection_id: { positional: 0, label: "collection-id", required: true },

package/package.json

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