@letterstory/cli 0.177.14 → 0.177.15

package/lib/cli.mjs

@@ -88,7 +88,7 @@ import {
 import { fetchParkedSections, withoutParked } from "./parked.mjs";
 
 // Matches cli/package.json; publish-cli.yml rewrites both to the published version.
-export const VERSION = "0.177.14";
+export const VERSION = "0.177.15";
 
 /** The exit code for a gate refusal (CARD_REQUIRED, PAYMENT_FAILED, OUT_OF_TOKENS): 1 is a plain error. */
 export const EXIT_PAYMENT_REQUIRED = 3;
@@ -114,6 +114,9 @@ export const BOOLEAN_FLAGS = new Set([
 	"from-plan",
 	// domains plan: scores only, no model call.
 	"no-write",
+	// admin letterpress endings: no model reading; write the proposed eval cases locally.
+	"no-model",
+	"write-cases",
 	// build: a website or app of its own (deploy create's path). deploy create: hold until its build starts.
 	"new-site",
 	"wait",

package/lib/commands/admin.mjs

@@ -21,6 +21,7 @@
 //   admin recipes list|show|runs|vocab|export|import|save|delete|refit …                  (recipes:read / recipes:write)
 //   admin letterpress companies | company <org-id> | facts <org-id>  (the standing fit, per company)
 //   admin letterpress beyond [--limit N] [--before ISO]  (what members asked that went past the library)
+//   admin letterpress endings [--days N] [--write-cases]  (how turns and repo changes ended when not done, by owner)
 //   admin letterpress settings|flip|set …                                             (recipes:read / recipes:write)
 //   admin demo guide|list|show|set|reset|check|ideas …                                           (demo:read / demo:write)
 //   admin deployments [--health down|failing|blocked|setting_up|live|paused|archived] [--org <id>] [--q <text>] [--archived] [--test] [--no-host]   (fleet:read)
@@ -5264,8 +5265,9 @@ const PULL_REQUESTS = "/api/superadmin/pull-requests";
 const PLATFORM_USAGE = "/api/superadmin/usage/platform";
 const BUILD_FAILURES = "/api/superadmin/build-failures";
 const SUGGESTION_REVIEW = "/api/superadmin/suggestion-review";
+const TURN_ENDINGS = "/api/superadmin/turn-endings";
 const ENGINE_USAGE =
-	"Usage: admin letterpress status | gaps | telemetry [--days N] [--harness h] [--all-orgs] | tokens [--days N] [--so-far] [--all-orgs] | prs [--days N | --from YYYY-MM-DD [--to YYYY-MM-DD] | --all-time] [--day YYYY-MM-DD] [--org id] [--state merged|open|closed] [--top N] [--tz zone] [--all-orgs] | failures [--days N | --from YYYY-MM-DD [--to YYYY-MM-DD] | --all-time] [--day YYYY-MM-DD] [--org id] [--failure ours|agent|setup|undelivered] [--cause c] [--stopped-at step] [--repo owner/name] [--slow] [--tz zone] [--all-orgs] | blocked [--days N] [--org id] [--all-orgs] | unblock <org-id> <host> <subject> | decisions <org-id> [--site host] [--surface plan|fix|build|site] | undo <org-id> <host> <decision-id> | runs [--status s] [--error-code c] [--first-review-cause agent|context|setup|unknown] [--pr merged|closed|open|none] [--harness h] [--days N] | beyond [--limit N] [--before ISO] | companies | company <org-id> [--site host] | ideas <org-id> [--site host] | suggestions fix|idea [--day YYYY-MM-DD] [--type key [--org id]] [--all-orgs] | suggestions flag fix|idea <type-key> [--org id --item item-id] [--note …] | suggestions clear <flag-id> | facts <org-id> [--site host] | fits [--recipe id] [--org id] [--site host] [--fits yes|no|unknown|waiting] [--limit N] | replay <run-id> | mark <run-id> <item-id> <right|weak|wrong|lead|gap|recipe|clear> [--note …] | settings | set <weights.<ask>.<reading>|lenses.<lens>.bar.<reading>|lenses.<lens>.bar|lenses.<lens>.research.turns|lenses.<lens>.research.ms|asks.<lens>.ask|asks.<lens>.guidance|dismissals.block_days|preflight.off|explore.ask|explore.research.turns|explore.research.ms|explore.every_days> <value>";
+	"Usage: admin letterpress status | gaps | telemetry [--days N] [--harness h] [--all-orgs] | tokens [--days N] [--so-far] [--all-orgs] | prs [--days N | --from YYYY-MM-DD [--to YYYY-MM-DD] | --all-time] [--day YYYY-MM-DD] [--org id] [--state merged|open|closed] [--top N] [--tz zone] [--all-orgs] | failures [--days N | --from YYYY-MM-DD [--to YYYY-MM-DD] | --all-time] [--day YYYY-MM-DD] [--org id] [--failure ours|agent|setup|undelivered] [--cause c] [--stopped-at step] [--repo owner/name] [--slow] [--tz zone] [--all-orgs] | blocked [--days N] [--org id] [--all-orgs] | endings [--days N | --since ISO] [--org id,id] [--no-model] [--top N] [--write-cases [--dir evals/letterpress]] | unblock <org-id> <host> <subject> | decisions <org-id> [--site host] [--surface plan|fix|build|site] | undo <org-id> <host> <decision-id> | runs [--status s] [--error-code c] [--first-review-cause agent|context|setup|unknown] [--pr merged|closed|open|none] [--harness h] [--days N] | beyond [--limit N] [--before ISO] | companies | company <org-id> [--site host] | ideas <org-id> [--site host] | suggestions fix|idea [--day YYYY-MM-DD] [--type key [--org id]] [--all-orgs] | suggestions flag fix|idea <type-key> [--org id --item item-id] [--note …] | suggestions clear <flag-id> | facts <org-id> [--site host] | fits [--recipe id] [--org id] [--site host] [--fits yes|no|unknown|waiting] [--limit N] | replay <run-id> | mark <run-id> <item-id> <right|weak|wrong|lead|gap|recipe|clear> [--note …] | settings | set <weights.<ask>.<reading>|lenses.<lens>.bar.<reading>|lenses.<lens>.bar|lenses.<lens>.research.turns|lenses.<lens>.research.ms|asks.<lens>.ask|asks.<lens>.guidance|dismissals.block_days|preflight.off|explore.ask|explore.research.turns|explore.research.ms|explore.every_days> <value>";
 
 /** One number of the settings from a dotted path and a value: the PUT body save_engine_settings reads. */
 function engineSettingsPatch(path, value) {
@@ -5354,6 +5356,26 @@ function engineSettingsText(r) {
 	].join("\n");
 }
 
+/**
+ * Writes list_turn_endings' proposed eval cases into evals/letterpress (or --dir). A case already there keeps its status
+ * (a proposed case written again from the fixed library passes, and the gate says to flip it); only its inputs move.
+ */
+function writeEndingCases(cases, dir = "evals/letterpress") {
+	const out = [];
+	for (const { key, case: c } of cases ?? []) {
+		const file = `${dir}/${key}.json`;
+		let status = c.status;
+		try {
+			status = JSON.parse(readFileSync(file, "utf8")).status ?? status;
+		} catch {
+			// a new case
+		}
+		writeFileSync(file, `${JSON.stringify({ ...c, status }, null, "\t")}\n`);
+		out.push(file);
+	}
+	return out;
+}
+
 /**
  * `admin letterpress …` — what steers Letterpress beside the recipes (get_engine_settings,
  * save_engine_settings): the one judgement's weights per ask and, per lens, its mode: off,
@@ -5459,6 +5481,39 @@ async function cmdAdminLetterpress(ctx) {
 			);
 			return 0;
 		}
+		case "endings": {
+			// list_turn_endings: how Letterpress's turns and repo changes ended when not done, clustered by owner
+			// (docs/architecture/turn-endings.md). --write-cases writes the proposed eval cases here, never on the server.
+			const q = new URLSearchParams();
+			if (flags.since) q.set("since", String(flags.since));
+			else q.set("days", String(flags.days ?? 1));
+			if (flags.org) q.set("org_ids", String(flags.org));
+			if (flagBool(flags["no-model"])) q.set("model", "0");
+			if (flags.top) q.set("top", String(flags.top));
+			const r = await staffRequest(ctx, "GET", `${TURN_ENDINGS}?${q}`);
+			const written = flagBool(flags["write-cases"]) ? writeEndingCases(r.cases, flagStr(flags.dir)) : [];
+			printResult(io, flags, r, (x) =>
+				[
+					`Since ${x.since}: ${x.endings} endings from ${x.turns} turns and ${x.runs} repo changes${x.model === "used" ? "" : ` (model ${x.model}: code's rules only)`}`,
+					...x.clusters.map((c) =>
+						[
+							`${String(c.count).padStart(3)}  ${(c.owner ?? "unplaced").padEnd(7)} ${c.by.padEnd(5)} ${c.recipe ? c.recipe.name : (c.kind ?? "")}: ${c.why}`,
+							...(c.line ? [`       line: ${c.line}`] : []),
+							`       e.g. ${c.examples.map((e) => e.build_id ?? `run ${e.run_id}`).join(", ")}`,
+						].join("\n")
+					),
+					...(x.cases.length
+						? [
+								"",
+								written.length
+									? `Wrote ${written.length} proposed case${written.length === 1 ? "" : "s"}: ${written.join(", ")}`
+									: `${x.cases.length} proposed case${x.cases.length === 1 ? "" : "s"} (--write-cases writes them): ${x.cases.map((c) => c.key).join(", ")}`,
+							]
+						: []),
+				].join("\n")
+			);
+			return 0;
+		}
 		case "unblock": {
 			// clear_blocker: "Show anyway" on one withheld item.
 			const [orgId, host, subject] = positionals.slice(1);

package/package.json

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