@letterstory/cli 0.176.36 → 0.176.38

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.36";
+export const VERSION = "0.176.38";
 
 /** 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.
@@ -1691,6 +1693,9 @@ Insights:
   insights question <key> [--period 14d|30d|90d] [--filter all|named_you|rival_not_you|no_one] [--limit n]
                                                        One By-question row: the wordings asked and the AI answers
   insights detection                                   How your brand is detected in AI answers (terms, who set them)
+  insights properties                                  Search Console properties the connected Google account can read, the
+                                                       unverified ones, and the one tracked
+  insights property <site-url>                         Pick the Search Console property to track (a key minted by an admin)
   insights site [--period 14d|30d|90d] [--collection <uuid>]
   insights post <article-id> [--period 14d|30d|90d]
   insights top [--period 14d|30d|90d] [--collection <uuid>] [--limit <n>] [--sort clicks|impressions]

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/insights.mjs

@@ -3,7 +3,8 @@
 // insights.ts); plus Measure's Overview (`summary`), GEO → Competitors
 // (`competitors`), AI Visibility Bank (`bank`) and phantom Page Access (`access`);
 // Measure → Reads (`reads`), Questions (`questions`), Pages (`pages`, one page's answers `page`) and the posts naming you (`mentions`), and the live feed of what
-// is reading the phantom sites (`activity`) — the same reads the web app renders.
+// is reading the phantom sites (`activity`) — the same reads the web app renders. Search Console's
+// property: which ones the connected Google account can read (`properties`) and the one tracked (`property`).
 
 import { CliError } from "../client.mjs";
 import { flagStr, flagNum, requirePositional, printResult, compact, argsFromFlags } from "./shared.mjs";
@@ -56,6 +57,10 @@ export const ARGS = {
 		phantom_id: { flag: "phantom" },
 		limit: { flag: "limit", type: "num" },
 	},
+	list_gsc_properties: {},
+	select_gsc_property: {
+		site_url: { positional: 0, label: "site-url", required: true },
+	},
 	get_share_of_voice_question: {
 		question_key: { positional: 0, label: "question-key", required: true },
 		period: { flag: "period", enum: PERIODS },
@@ -98,9 +103,13 @@ export async function cmdInsights(ctx) {
 			return call(rest, "list_site_mentions");
 		case "activity":
 			return call(rest, "get_recent_activity");
+		case "properties":
+			return call(rest, "list_gsc_properties");
+		case "property":
+			return call(rest, "select_gsc_property");
 		default:
 			throw new CliError(
-				`Unknown insights subcommand: ${sub ?? "(none)"}. Try: summary, reads, questions, pages, page, mentions, competitors, question, detection, activity, site, post, top, bank, access`
+				`Unknown insights subcommand: ${sub ?? "(none)"}. Try: summary, reads, questions, pages, page, mentions, competitors, question, detection, activity, site, post, top, bank, access, properties, property`
 			);
 	}
 }

package/package.json

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