@letterstory/cli 0.60.1 → 0.61.0

package/lib/cli.mjs

@@ -55,7 +55,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.60.1";
+export const VERSION = "0.61.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.
@@ -604,6 +604,7 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
           | cases [--org <uuid>] [--status s] [--stage s] | runs [--limit N] [--mode record|full]
           | run [--mode record|full] [--keys a,b] [--org <uuid>] [--baseline latest|<id>]
           | triage [--owner research|kernel|links|mentions|accuracy|pipeline] [--overdue]
+                  [--eval <key> [--org <id>|fleet] --assign <owner> | --dismiss "…"]   patterns (measure × org)
           | guard <case-key> [--sha <commit>] [--fix-pr #N] | retire <case-key> --reason "…"
                                                        The fleet-wide eval surface: scoreboard,
                                                        every org's cases and suite runs, the
@@ -613,6 +614,16 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
   admin tuning-context [--q "<question>"]              The experiment agent's context pack (JSON):
                                                        the pipeline as deployed, levers, measures,
                                                        goals, related history.
+  admin tuning desk                                    What waits on a person: comparisons to read
+                                                       blind, questions to decide, versions to
+                                                       promote, open corpus flags, overdue patterns.
+  admin tuning <sub> …                                 The console's loop over a staff key: kernels,
+                                                       candidate, compare, comparisons, picks, pick,
+                                                       reading-list, pair, side-by-side, promote,
+                                                       sessions, session-new, propose, trial-add,
+                                                       trial-run, trial-save, and the arena, shredder
+                                                       and enhancer twins (every flag is listed in
+                                                       cli/lib/commands/admin.mjs).
   admin create-org --domain <bare-domain> [--name "Acme"] [--test] [--no-key]
           [--key-name N] [--capabilities a,b] [--onboard] [--watch] [+ the onboard domain flags]
                                                        The key exchange: create the client org from

package/lib/commands/admin.mjs

@@ -420,6 +420,7 @@ async function cmdAdminTuningContext(ctx) {
  * and promotion from the ledger (docs/architecture/tuning-foundation.md): the headless half of the
  * tuning console's Write › Kernels and Compare tabs. Needs `tuning:experiment` on the key.
  *
+ *   admin tuning desk                                          what waits on a person: comparisons to read blind, questions to decide, versions to promote, open flags, overdue findings
  *   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
@@ -529,6 +530,20 @@ async function cmdAdminTuning(ctx) {
 	const json = flagBool(flags.json);
 	const T = "/api/superadmin/tuning";
 	switch (sub) {
+		case "desk": {
+			const d = await staffRequest(ctx, "GET", `${T}/desk`);
+			if (json) return printResult(io, flags, d);
+			const lines = [];
+			for (const c of d.to_read)
+				lines.push(`read blind   ${c.read}/${c.target}  ${c.primitive.padEnd(8)} ${c.title}  ${c.id}`);
+			for (const e of d.to_decide) lines.push(`decide       ${e.status.padEnd(9)} ${e.question}  ${e.id}`);
+			for (const e of d.to_promote) lines.push(`promote      ship      ${e.question}  ${e.id}`);
+			if (d.flags_open) lines.push(`flags        ${d.flags_open} corpus flags open`);
+			if (d.findings_overdue)
+				lines.push(`triage       ${d.findings_overdue} shipped patterns past their due date`);
+			for (const err of d.errors ?? []) lines.push(`(could not read: ${err})`);
+			return io.log(lines.join("\n") || "Nothing waits on a person.");
+		}
 		case "kernels": {
 			const r = await staffRequest(ctx, "GET", `${T}/kernel-files`);
 			if (json) return printResult(io, flags, r);
@@ -1801,14 +1816,40 @@ async function cmdAdminEvals(ctx) {
 			return r.run?.verdict === "fail" ? 1 : 0;
 		}
 		case "triage": {
-			const q = query({ owner: flagStr(flags.owner), overdue: flagBool(flags.overdue) ? "true" : undefined });
+			// A decision names its pattern: --eval <key> and --org <id> (omitted = the fleet-wide one).
+			const assign = flagStr(flags.assign);
+			const dismiss = flagStr(flags.dismiss);
+			if (assign || dismiss) {
+				const evalKey = flagStr(flags.eval);
+				if (!evalKey)
+					throw new CliError(
+						'Usage: admin evals triage --eval <key> [--org <id>] --assign <owner> | --dismiss "…"'
+					);
+				if (assign && dismiss) throw new CliError("Send --assign or --dismiss, not both.");
+				const orgFlag = flagStr(flags.org);
+				const body = {
+					eval_key: evalKey,
+					org_id: orgFlag && orgFlag !== "fleet" ? orgFlag : null,
+					...(assign ? { owner: assign } : { reason: dismiss }),
+				};
+				return out(
+					await staffRequest(ctx, "PATCH", `${EVALS}/triage`, body),
+					(r) =>
+						`${r.affected ?? 0} finding(s) ${r.action === "assign" ? `handed to ${assign}` : "dismissed"} in ${evalKey} × ${body.org_id ?? "fleet"}`
+				);
+			}
+			const q = query({
+				owner: flagStr(flags.owner),
+				overdue: flagBool(flags.overdue) ? "true" : undefined,
+				limit: flagStr(flags.limit),
+			});
 			return out(await staffRequest(ctx, "GET", `${EVALS}/triage${q}`), (r) =>
 				[
-					...(r.findings ?? []).map(
-						(f) =>
-							`${f.id}  ${(f.owner ?? "unassigned").padEnd(10)} ${f.evalKey.padEnd(36)} ${f.overdue ? "OVERDUE " : ""}${f.title ?? f.summary ?? ""}`
+					...(r.patterns ?? []).map(
+						(p) =>
+							`${p.eval_key.padEnd(36)} ${(p.org_name ?? p.org_id ?? "fleet").padEnd(24)} ${(p.owner ?? "unassigned").padEnd(10)} ${String(p.count).padStart(5)}  ${p.overdue ? "OVERDUE " : "due "}${p.sla_due_at ? p.sla_due_at.slice(0, 10) : "—"}`
 					),
-					`${r.total ?? 0} open, ${r.overdue ?? 0} overdue`,
+					`${r.total ?? 0} patterns (${r.findings ?? 0} findings), ${r.overdue ?? 0} overdue`,
 				].join("\n")
 			);
 		}

package/package.json

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