@letterstory/cli 0.176.37 → 0.176.39

package/lib/cli.mjs

@@ -83,7 +83,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.176.37";
+export const VERSION = "0.176.39";
 
 /** 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;
@@ -121,8 +121,10 @@ export const BOOLEAN_FLAGS = new Set([
 	"fresh",
 	// admin letterpress telemetry | prs: every org, test and demo orgs included.
 	"all-orgs",
-	// admin letterpress prs: since the first PR (all_time).
+	// admin letterpress prs | failures: since the first PR or build (all_time).
 	"all-time",
+	// admin letterpress failures: the builds that took far longer than usual.
+	"slow",
 	// admin letterpress status | gaps: the customers' reading (no test or demo orgs).
 	"customers",
 	// build: repeat an open build's ask; post its progress in the org's Slack channel.
@@ -1669,9 +1671,10 @@ Insights:
                                                        first), what to build (--lens build), or your own words. Nothing asked:
                                                        each list's head. The same answer as the console and Slack.
   plan auto [activate|disable] [--site host] [--veto-hours <1-168>|off] [--auto-merge on|off]
-            [--aggression low|medium|high|xhigh] [--slack-channel <C…>|none]
+            [--aggression low|medium|high|xhigh] [--goal geo|seo|agent_conviction|inbound_conversion|any]
+            [--slack-channel <C…>|none]
                                                        Auto-Plan on a site: Letterpress picks its strategies and builds
-                                                       them; each pick waits --veto-hours for a veto. Settings shown when none given.
+                                                       them (--goal: one goal's strategies, else any); each pick waits --veto-hours for a veto. Settings shown when none given.
   plan pending [--site host]                           What Auto-Plan picked and is waiting to build
   plan veto <proposal-id>                              Veto one: it is never built
   plan later <action-id> [--outcome geo|…] [--site host]  Queue a Plan row for later: Auto-Plan starts it once it's ready

package/lib/commands/admin.mjs

@@ -5241,8 +5241,9 @@ const ENGINE = "/api/superadmin/engine-settings";
 const LETTERPRESS = "/api/superadmin/letterpress";
 const CODING_TELEMETRY = "/api/superadmin/coding-telemetry";
 const PULL_REQUESTS = "/api/superadmin/pull-requests";
+const BUILD_FAILURES = "/api/superadmin/build-failures";
 const ENGINE_USAGE =
-	"Usage: admin letterpress status | gaps | telemetry [--days N] [--harness h] [--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] | 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] | 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] | 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] | 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) {
@@ -5527,6 +5528,73 @@ async function cmdAdminLetterpress(ctx) {
 			);
 			return 0;
 		}
+		case "failures": {
+			// get_build_failures (the days, causes, steps, odd cases, slow builds) or, with a filter,
+			// list_build_failures (the builds behind them).
+			const filters = [
+				["day", "day"],
+				["org", "org_id"],
+				["failure", "failure"],
+				["cause", "cause"],
+				["stopped-at", "stopped_at"],
+				["repo", "repo"],
+			];
+			const slow = flagBool(flags.slow);
+			const listing = slow || filters.some(([flag]) => flags[flag]);
+			const q = new URLSearchParams({
+				...(listing ? { view: "list" } : {}),
+				days: String(flags.days ?? 30),
+			});
+			for (const [flag, key] of [...filters, ["from", "from"], ["to", "to"], ["tz", "tz"], ["limit", "limit"]])
+				if (flags[flag]) q.set(key, String(flags[flag]));
+			if (slow) q.set("slow", "1");
+			if (flagBool(flags["all-orgs"])) q.set("customers", "0");
+			if (flagBool(flags["all-time"])) q.set("all_time", "1");
+			const r = await staffRequest(ctx, "GET", `${BUILD_FAILURES}?${q}`);
+			const pct = (v) => (v == null ? "—" : `${Math.round(100 * v)}%`);
+			const mins = (ms) =>
+				ms == null ? "—" : ms >= 3_600_000 ? `${(ms / 3_600_000).toFixed(1)}h` : `${Math.round(ms / 60_000)}m`;
+			printResult(io, flags, r, (x) =>
+				listing
+					? x.builds.length
+						? x.builds
+								.map(
+									(b) =>
+										`${b.day}  ${(b.failure ?? "delivered").padEnd(11)} ${(b.cause_label ?? "").padEnd(28)} ${b.door_label.padEnd(9)} ${(b.org_name ?? b.org_id).padEnd(20)} ${mins(b.work_ms)}${b.typical_ms ? ` (usually ${mins(b.typical_ms)})` : ""}  ${b.line ?? ""}  ${b.run_id}`
+								)
+								.join("\n")
+						: "No builds match."
+					: [
+							`Builds failed, ${x.since_day} to ${x.until_day} (${x.days} days, ${x.tz})${x.customer_only ? ", customers only" : ""}: ${x.totals.failed} of ${x.totals.builds} (${pct(x.totals.rate)}; ${x.previous.failed} of ${x.previous.builds} the period before); ours ${x.totals.ours}, the agent's ${x.totals.agent}, customer's setup ${x.totals.setup}, didn't deliver ${x.totals.undelivered}`,
+							...x.series
+								.filter((d) => d.builds)
+								.map(
+									(d) =>
+										`${d.day}  ${String(d.builds).padStart(3)} builds  ${String(d.ours + d.agent + d.setup + d.undelivered).padStart(3)} failed  (ours ${d.ours}, agent ${d.agent}, setup ${d.setup}, undelivered ${d.undelivered})`
+								),
+							"why:",
+							...x.causes.map(
+								(c) =>
+									`  ${String(c.count).padStart(3)}  ${c.label} [${c.cause}, ${c.kind}] ${c.previous} before  ${c.lines[0]?.line ?? ""}`
+							),
+							`where they stop: ${
+								x.steps
+									.filter((s) => s.stopped)
+									.map((s) => `${s.label} ${s.stopped}`)
+									.join(", ") || "—"
+							}; delivered ${x.delivered}`,
+							`odd cases: rare ${x.odd.rare.length}, new ${x.odd.new.length}, one customer ${x.odd.one_customer.length}, keeps failing ${x.odd.keeps_failing.length}`,
+							`took longer than usual: ${x.slow.slow_count}`,
+							...x.slow.runs
+								.slice(0, 10)
+								.map(
+									(b) =>
+										`  ${mins(b.work_ms)} (usually ${mins(b.typical_ms)}, ${b.ratio?.toFixed(1)}×)  ${b.door_label}  ${b.org_name ?? b.org_id}  ${b.run_id}`
+								),
+						].join("\n")
+			);
+			return 0;
+		}
 		case "runs": {
 			// list_coding_runs with fleet.
 			const q = new URLSearchParams({

package/lib/commands/plan.mjs

@@ -2,7 +2,8 @@
 // organization's own domain). The same calls as the Plan's modal and its sidebar's Pending rows.
 //   plan auto                                  → get_auto_plan
 //   plan auto [activate|disable] [--veto-hours <1-168>|off] [--auto-merge on|off]
-//             [--aggression low|medium|high|xhigh] [--slack-channel <C…>|none]  → set_auto_plan
+//             [--aggression low|medium|high|xhigh] [--goal geo|seo|agent_conviction|inbound_conversion|any]
+//             [--slack-channel <C…>|none]  → set_auto_plan
 //   plan pending                               → list_auto_plan_proposals (status pending)
 //   plan veto <proposal-id>                    → veto_auto_plan_proposal
 //   plan later <action-id> [--outcome geo|…]   → queue_plan_action (Auto-Plan starts it once it's ready)
@@ -44,6 +45,17 @@ export const ARGS = {
 		},
 		merge: { value: onOff("auto-merge") },
 		aggression: { flag: "aggression", enum: ["low", "medium", "high", "xhigh"] },
+		// --goal geo picks strategies for that goal only; --goal any (the default) reads every strategy.
+		goal: {
+			value: (flags) => {
+				const v = flagStr(flags.goal);
+				if (v === undefined) return undefined;
+				if (v === "any") return null;
+				if (!["agent_conviction", "geo", "seo", "inbound_conversion"].includes(v))
+					throw new CliError("--goal takes agent_conviction, geo, seo, inbound_conversion, or any.");
+				return v;
+			},
+		},
 		slack_channel: {
 			value: (flags) => {
 				const v = flagStr(flags["slack-channel"]);
@@ -75,7 +87,7 @@ export const ARGS = {
 	},
 };
 
-const SETTING_FLAGS = ["veto-hours", "auto-merge", "aggression", "slack-channel"];
+const SETTING_FLAGS = ["veto-hours", "auto-merge", "aggression", "goal", "slack-channel"];
 
 export async function cmdPlan(ctx) {
 	const { client, flags, io } = ctx;

package/package.json

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