@letterstory/cli 0.72.2 → 0.73.0

package/README.md

@@ -368,6 +368,8 @@ letterstory admin tuning bank-judge <eval-id> --prompt-file judge.md --mode scor
 letterstory admin tuning bank-score <eval-id> --version 2         # score it over the pool; prints agreement on held-out labels
 letterstory admin tuning bank-try <eval-id> --version 2           # the judge as a trial rule in candidates, and a comparison against live
 letterstory admin tuning invite --email editor@example.com        # invite an editor (Pick and Eval bank only); `people`, `revoke <id>`
+letterstory admin tuning assign --pick <comparison-id> --instructions "Read for the opening"   # a task for every editor (--to <email> for one)
+letterstory admin tuning assign --label bank-draft-x-not-y --target 50                      # editors cut or keep 50 of this eval's sentences
 letterstory admin tuning side-by-side <id>,<id>,<id> [--cell <key>]   # several writers as one board: each one's measures against live; with --cell, every writer's text on that input
 letterstory admin tuning candidates --kernels all --patch '{"writer":"echo/echo"}' --note "Echo"   # the same change as a candidate of each kernel
 letterstory admin tuning session-new --title "Echo round 1" --kernel Hazel --input-file brief.md --kind outline [--version 22] [--versions 23,29]   # --versions: saved candidates, a trial each

package/lib/cli.mjs

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

@@ -473,6 +473,8 @@ async function cmdAdminTuningContext(ctx) {
  *   admin tuning bank-score <eval-id> --version N             score a judge version over the pool (call again for more than 600)
  *   admin tuning bank-try <eval-id> --version N [--kernels Hazel,Aspen]   the judge as a trial rule in candidates, and a comparison against live
  *   admin tuning people | invite --email e [--note "…"] | revoke <id>   who an admin invited into the console as an editor
+ *   admin tuning assignments | assign --pick <comparison-id>|--label <eval-id> [--to e] [--instructions "…"] [--target N] | unassign <id>   what editors are asked to do
+ *   admin tuning tasks                                         your own open tasks, with progress
  *   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
  *   admin tuning promote <experiment-id> --versions <service-kernel-id>:<version>,…   promote from a "ship" decision
@@ -1187,6 +1189,48 @@ async function cmdAdminTuning(ctx) {
 				`${ctx.client.url}/superadmin/tuning?${new URLSearchParams({ tab: "compare", comparison: r.comparison_id })}`
 			);
 		}
+		case "assignments": {
+			const r = await staffRequest(ctx, "GET", `${T}/assignments${flagBool(flags.closed) ? "?closed=1" : ""}`);
+			if (json) return printResult(io, flags, r);
+			for (const a of r.assignments)
+				io.log(
+					`${a.id} ${a.kind} "${a.title}" → ${a.assignee_email ?? "every editor"}${a.target ? `, ${a.target} asked` : ""}${a.closed_at ? " (closed)" : ""}`
+				);
+			return;
+		}
+		case "assign": {
+			const pick = flagStr(flags.pick);
+			const label = flagStr(flags.label);
+			if (!pick === !label)
+				throw new CliError(
+					'Usage: admin tuning assign --pick <comparison-id> | --label <eval-id> [--to email] [--instructions "…"] [--title "…"] [--target N]'
+				);
+			const body = compact({
+				...(pick ? { kind: "pick", comparison_id: pick } : { kind: "label", eval_id: label }),
+				assignee_email: flagStr(flags.to),
+				instructions: flagStr(flags.instructions),
+				title: flagStr(flags.title),
+				target: flagNum(flags.target),
+			});
+			const r = await staffRequest(ctx, "POST", `${T}/assignments`, body);
+			if (json) return printResult(io, flags, r);
+			return io.log(
+				`assigned ${r.assignment.kind} task "${r.assignment.title}" to ${r.assignment.assignee_email ?? "every editor"} (${r.assignment.id})`
+			);
+		}
+		case "unassign": {
+			if (!id) throw new CliError("Usage: admin tuning unassign <assignment-id>");
+			return printResult(io, flags, await staffRequest(ctx, "DELETE", `${T}/assignments/${id}`));
+		}
+		case "tasks": {
+			const r = await staffRequest(ctx, "GET", `${T}/editor/tasks`);
+			if (json) return printResult(io, flags, r);
+			for (const t of r.tasks)
+				io.log(
+					`${t.id} ${t.kind} "${t.title}": ${t.done} done, ${t.remaining} left${t.complete ? " (complete)" : ""}`
+				);
+			return;
+		}
 		case "people": {
 			const r = await staffRequest(ctx, "GET", `${T}/people`);
 			if (json) return printResult(io, flags, r);
@@ -2144,7 +2188,7 @@ async function cmdAdminTuning(ctx) {
 		}
 		default:
 			throw new CliError(
-				"Usage: admin tuning kernels|kernel|candidate|compare|comparisons|comparison|picks|pick|loop|ledger|evals|eval-add|eval-set|proposals|propose-eval|capture-eval|reject-eval|reading-list|finalists|finalists-queue|pair|bank|bank-eval|bank-draft|bank-shape|bank-pool|bank-judge|bank-score|bank-try|people|invite|revoke|side-by-side|candidates|base-kernels|base-versions|sessions|session|session-new|propose|trial-add|trial-run|trial-save|promote|arenas|arena|arena-candidate|arena-dials|comparison-extend|research-compare|research-inputs|research-split|research-standing|promote-arena|shred-compare|shred-inputs|shred-split|shred-standing|shredders|shredder|shredder-candidate|promote-shredder|enhance-compare|enhance-inputs|enhance-split|enhance-standing|enhancers|enhancer|enhancer-candidate|promote-enhancer (see --help)"
+				"Usage: admin tuning kernels|kernel|candidate|compare|comparisons|comparison|picks|pick|loop|ledger|evals|eval-add|eval-set|proposals|propose-eval|capture-eval|reject-eval|reading-list|finalists|finalists-queue|pair|bank|bank-eval|bank-draft|bank-shape|bank-pool|bank-judge|bank-score|bank-try|people|invite|revoke|assignments|assign|unassign|tasks|side-by-side|candidates|base-kernels|base-versions|sessions|session|session-new|propose|trial-add|trial-run|trial-save|promote|arenas|arena|arena-candidate|arena-dials|comparison-extend|research-compare|research-inputs|research-split|research-standing|promote-arena|shred-compare|shred-inputs|shred-split|shred-standing|shredders|shredder|shredder-candidate|promote-shredder|enhance-compare|enhance-inputs|enhance-split|enhance-standing|enhancers|enhancer|enhancer-candidate|promote-enhancer (see --help)"
 			);
 	}
 }

package/package.json

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