@letterstory/cli 0.52.0 → 0.53.0

package/README.md

@@ -358,6 +358,7 @@ letterstory admin tuning candidate <service-kernel-id> --file hazel.json --note
 letterstory admin tuning compare --title "Echo vs live" --candidates Hazel:21,Aspen:20
 letterstory admin tuning comparison <id>               # per-measure verdicts (better / worse / within noise / refused)
 letterstory admin tuning picks <id>                    # the blind queue; then: admin tuning pick <id> --cell <key> --pick left|right|tie
+letterstory admin tuning reading-list <id> --n 10      # your next blind pairs as links (Text A / Text B), to read off the screen; pick in the console
 letterstory admin tuning promote <experiment-id> --versions <service-kernel-id>:21   # from a concluded "ship" decision
 letterstory admin experiments list --q colons          # what we've tried
 letterstory admin experiments new "We use too many colons" --as "claude-code"

package/lib/cli.mjs

@@ -54,7 +54,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.52.0";
+export const VERSION = "0.53.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.

package/lib/commands/admin.mjs

@@ -427,6 +427,7 @@ async function cmdAdminTuningContext(ctx) {
  *   admin tuning comparisons | comparison <id>                list / read one (per-measure verdicts)
  *   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 promote <experiment-id> --versions <service-kernel-id>:<version>,…   promote from a "ship" decision
  */
 async function cmdAdminTuning(ctx) {
@@ -523,6 +524,16 @@ async function cmdAdminTuning(ctx) {
 				await staffRequest(ctx, "POST", `${T}/comparisons/${id}/picks`, { cell_key: cell, outcome: pick })
 			);
 		}
+		case "reading-list": {
+			if (!id) throw new CliError("Usage: admin tuning reading-list <comparison-id> [--n 10]");
+			const n = flagStr(flags.n);
+			const r = await staffRequest(
+				ctx,
+				"GET",
+				`${T}/comparisons/${id}/reading-list${n ? `?${new URLSearchParams({ n })}` : ""}`
+			);
+			return json ? printResult(io, flags, r) : io.log(r.text);
+		}
 		case "promote": {
 			const list = flagList(flags.versions);
 			if (!id || !list?.length)
@@ -546,7 +557,7 @@ async function cmdAdminTuning(ctx) {
 		}
 		default:
 			throw new CliError(
-				"Usage: admin tuning kernels|kernel|candidate|compare|comparisons|comparison|picks|pick|promote (see --help)"
+				"Usage: admin tuning kernels|kernel|candidate|compare|comparisons|comparison|picks|pick|reading-list|promote (see --help)"
 			);
 	}
 }

package/package.json

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