@letterstory/cli 0.60.1 → 0.61.1

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.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.
@@ -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
@@ -796,10 +807,13 @@ 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]
-                                                       New draft sequence (nothing sends yet; rails default on, opt-out line off)
+           [--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]
+           [--send-window-start <HH:MM>] [--send-window-end <HH:MM>] [--send-window-timezone <IANA tz>]
   sequences pause|resume <sequence-id>                 Stop / restart sending
   sequences enroll <sequence-id> (--list <list-id> | --email <addr>... | --recipients '<json>'|--recipients-file <path>)
   sequences stop <sequence-id> <enrollment-id>         Stop one recipient

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/lib/commands/outbound.mjs

@@ -60,6 +60,31 @@ const SEQUENCE_RAIL_ARGS = {
 	unsubscribe_links: { flag: "unsubscribe-links", type: "bool", negate: "no-unsubscribe-links" },
 	detect_reply_opt_outs: { flag: "detect-reply-opt-outs", type: "bool", negate: "no-detect-reply-opt-outs" },
 };
+
+// A send-window edge from --<flag> HH:MM (or a raw minute of day) → the
+// schema's minute-of-day number.
+function windowMinute(flag) {
+	return (flags) => {
+		const raw = flagStr(flags[flag]);
+		if (raw === undefined) return undefined;
+		if (/^\d+$/.test(raw)) return Number(raw);
+		const match = /^(\d{1,2}):(\d{2})$/.exec(raw);
+		if (!match || Number(match[1]) > 23 || Number(match[2]) > 59) {
+			throw new CliError(`--${flag} takes HH:MM or a minute of day 0–1439 (got ${raw})`);
+		}
+		return Number(match[1]) * 60 + Number(match[2]);
+	};
+}
+
+// The send window, shared by create and update: when emails may go out
+// (default 9:00–17:00), in each recipient's inferred timezone, falling back to
+// the sender's --send-window-timezone when the location is unknown. Equal
+// start and end turns the window off.
+const SEQUENCE_WINDOW_ARGS = {
+	send_window_start_minute: { value: windowMinute("send-window-start") },
+	send_window_end_minute: { value: windowMinute("send-window-end") },
+	send_window_timezone: "send-window-timezone",
+};
 const PROSPECT_STATUSES = ["new", "contacted", "replied", "unsubscribed", "archived"];
 const mailerIds = {
 	value: (flags) => {
@@ -101,6 +126,7 @@ export const ARGS = {
 		},
 		mailer_ids: mailerIds,
 		...SEQUENCE_RAIL_ARGS,
+		...SEQUENCE_WINDOW_ARGS,
 	},
 	update_sequence: {
 		sequence_id: { positional: 0, label: "sequence-id", required: true },
@@ -109,6 +135,7 @@ export const ARGS = {
 		status: { flag: "status", enum: SEQUENCE_STATUSES },
 		mailer_ids: mailerIds,
 		...SEQUENCE_RAIL_ARGS,
+		...SEQUENCE_WINDOW_ARGS,
 	},
 	enroll_in_sequence: {
 		sequence_id: { positional: 0, label: "sequence-id", required: true },
@@ -260,8 +287,8 @@ export const ARGS = {
 
 // Flags the computed `value` sources read (refuseUnknownFlags can't see them).
 const VALUE_FLAGS = {
-	create_sequence: ["flow", "flow-file", "mailer"],
-	update_sequence: ["flow", "flow-file", "mailer"],
+	create_sequence: ["flow", "flow-file", "mailer", "send-window-start", "send-window-end"],
+	update_sequence: ["flow", "flow-file", "mailer", "send-window-start", "send-window-end"],
 	enroll_in_sequence: ["recipients", "recipients-file", "email"],
 	update_review_item: ["body", "file"],
 	import_prospects_csv: ["csv", "csv-file"],

package/package.json

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