@letterstory/cli 0.69.0 → 0.70.1

package/README.md

@@ -161,6 +161,7 @@ publishing, targets, measurement) that produces and publishes posts on a cadence
 
 ```bash
 letterstory collection list                                     # public_id = the HTTP door's address
+letterstory collection overview                                 # site, state, posts, in Google, AI reads per collection
 letterstory collection new --name "Launches" --config-file cfg.json
 letterstory collection config <id>                              # print the one file
 letterstory collection config <id> --config '{"targets":{"enabled":true,"tier":"ramping"}}'   # patch it

package/lib/cli.mjs

@@ -56,7 +56,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.69.0";
+export const VERSION = "0.70.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.
@@ -201,6 +201,7 @@ Auth:
 
 Collections (the content engine as a primitive — one door, 'collection run'):
   collection list                                      Your collections (public_id = the HTTP door's address)
+  collection overview                                  Each collection's site, state, posts, posts in Google, AI reads
   collection new --name <n> [--description <t>] [--config '<json>'|--config-file cfg.json]
   collection config <id> [--config '<json>'|--config-file cfg.json]
                                                        Print the ONE FILE (identity, content, cadence,
@@ -825,13 +826,15 @@ Sequences (multi-step cold email sent from your mailers; approving or enrolling
   sequences get <sequence-id>                          Flow, enrollments, who replied at each step
   sequences create --name <n> (--flow '<json>'|--flow-file <path>) [--mailer <mailer-id>]...
            [--[no-]opt-out-footer] [--[no-]postal-address-footer] [--[no-]unsubscribe-links] [--[no-]detect-reply-opt-outs]
-           [--[no-]test-mode] [--send-window-start <HH:MM>] [--send-window-end <HH:MM>] [--send-window-timezone <IANA tz>]
+           [--[no-]test-mode] [--default-lede <fallback opener line>]
+           [--send-window-start <HH:MM>] [--send-window-end <HH:MM>] [--send-window-timezone <IANA tz>]
                                                        New draft sequence (nothing sends yet; rails default on, opt-out line off;
                                                        sends 9:00-17:00 in each recipient's inferred timezone, else the sender's)
   sequences update <sequence-id> [--name <n>] [--flow '<json>'|--flow-file <path>]
            [--status draft|active|paused|archived] [--mailer <mailer-id>]...
            [--[no-]opt-out-footer] [--[no-]postal-address-footer] [--[no-]unsubscribe-links] [--[no-]detect-reply-opt-outs]
-           [--[no-]test-mode] [--send-window-start <HH:MM>] [--send-window-end <HH:MM>] [--send-window-timezone <IANA tz>]
+           [--[no-]test-mode] [--default-lede <fallback opener line>]
+           [--send-window-start <HH:MM>] [--send-window-end <HH:MM>] [--send-window-timezone <IANA tz>]
                                                        --test-mode (internal accounts only): walks as live, sends nothing
   sequences pause|resume <sequence-id>                 Stop / restart sending
   sequences enroll <sequence-id> (--list <list-id> | --email <addr>... | --recipients '<json>'|--recipients-file <path>)

package/lib/commands/admin.mjs

@@ -445,6 +445,8 @@ async function cmdAdminTuningContext(ctx) {
  *   admin tuning picks <comparison-id>                         the blind queue (next pairs)
  *   admin tuning pick <comparison-id> --cell <key> --pick left|right|tie   record a blind pick
  *   admin tuning reading-list <comparison-id> [--n 10]          your next blind pairs as links, to read off the screen
+ *   admin tuning archive <comparison-id> [--undo]               take a read comparison out of the working list (or back); the record stays
+ *   admin tuning comparisons [--archived only|all]              the list; archived ones only when asked
  *   admin tuning pair <comparison-id> --cell <key>             one pair named: live and candidate, both texts, the measures per arm
  *   admin tuning side-by-side <id>,<id>[,…] [--cell <key>]     several comparisons as one board: each writer's measures against live, and one input's texts
  *   admin tuning candidates --kernels Hazel,Aspen|all --patch '{…}' [--base N] [--note "…"]   the same changes as a candidate of each kernel
@@ -653,8 +655,18 @@ async function cmdAdminTuning(ctx) {
 			);
 			return json ? printResult(io, flags, r) : io.log(`comparison ${r.comparison?.id ?? r.id ?? ""} started`);
 		}
-		case "comparisons":
-			return printResult(io, { ...flags, json: true }, await staffRequest(ctx, "GET", `${T}/comparisons`));
+		case "comparisons": {
+			const archived = flagStr(flags.archived);
+			const qs = archived ? `?${new URLSearchParams({ archived })}` : "";
+			return printResult(io, { ...flags, json: true }, await staffRequest(ctx, "GET", `${T}/comparisons${qs}`));
+		}
+		case "archive": {
+			if (!id) throw new CliError("Usage: admin tuning archive <comparison-id> [--undo]");
+			const r = await staffRequest(ctx, "POST", `${T}/comparisons/${id}/archive`, { archived: !flags.undo });
+			return json
+				? printResult(io, flags, r)
+				: io.log(`comparison ${id} ${flags.undo ? "back in the list" : "archived"}`);
+		}
 		case "comparison":
 			if (!id) throw new CliError("Usage: admin tuning comparison <id>");
 			return printResult(io, { ...flags, json: true }, await staffRequest(ctx, "GET", `${T}/comparisons/${id}`));

package/lib/commands/collection.mjs

@@ -54,6 +54,7 @@ const TERMINAL = new Set(["published", "failed", "skipped", "cancelled"]);
  */
 export const ARGS = {
 	list_collections: {},
+	get_collections_overview: {},
 	create_collection: {
 		name: { flag: "name", required: true },
 		description: "description",
@@ -153,11 +154,13 @@ export async function cmdCollection(ctx) {
 			return collectionCancel(rest);
 		case "inventory":
 			return collectionInventory(rest);
+		case "overview":
+			return collectionOverview(rest);
 		case "links":
 			return collectionLinks(rest);
 		default:
 			throw new CliError(
-				`Unknown collection subcommand: ${sub ?? "(none)"}. Try: list, new, config, delete, run, run-status, runs, approve, cancel, inventory, links`
+				`Unknown collection subcommand: ${sub ?? "(none)"}. Try: list, overview, new, config, delete, run, run-status, runs, approve, cancel, inventory, links`
 			);
 	}
 }
@@ -168,6 +171,16 @@ async function collectionList(ctx) {
 	return 0;
 }
 
+// `collection overview` — each collection's site, state, posts, posts in Google and AI reads.
+async function collectionOverview(ctx) {
+	const result = await ctx.client.callTool(
+		"get_collections_overview",
+		argsFromFlags(ARGS.get_collections_overview, ctx.flags)
+	);
+	printResult(ctx.io, ctx.flags, result);
+	return 0;
+}
+
 async function collectionCreate(ctx) {
 	const result = await ctx.client.callTool(
 		"create_collection",

package/lib/commands/outbound.mjs

@@ -61,6 +61,8 @@ const SEQUENCE_RAIL_ARGS = {
 	detect_reply_opt_outs: { flag: "detect-reply-opt-outs", type: "bool", negate: "no-detect-reply-opt-outs" },
 	// Staff-only to turn on (the server refuses it for anyone else): walks as live, sends nothing.
 	test_mode: { flag: "test-mode", type: "bool", negate: "no-test-mode" },
+	// The fallback opener line for recipients with no opener (blank clears it on update).
+	default_lede: "default-lede",
 };
 
 // A send-window edge from --<flag> HH:MM (or a raw minute of day) → the

package/package.json

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