@letterstory/cli 0.176.51 → 0.176.52

package/lib/cli.mjs

@@ -85,7 +85,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.51";
+export const VERSION = "0.176.52";
 
 /** 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;
@@ -177,6 +177,8 @@ export const BOOLEAN_FLAGS = new Set([
 	"no-modifiers",
 	// site map: do not start an audit for a host that has none.
 	"no-audit",
+	// admin deployments: answer from our rows alone, without reading the host.
+	"no-host",
 	// site metrics: skip the previous window (no deltas, no revamp indicator).
 	"no-compare",
 	// site refresh / observe: the loop's switches.
@@ -1005,6 +1007,10 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
                                                        read-only SQL across every org; --sql prints
                                                        the queries behind the answer. Needs the
                                                        fleet:query capability on the staff key.
+  admin deployments [--health down|failing|…] [--org <id>] [--q <text>] [--archived] [--test] [--no-host] [--json]
+                                                       Every site Letter built and hosts, across every org,
+                                                       worst first: health, the problem, and what the host
+                                                       has that no app names. Needs fleet:read.
   admin recipes list | show <id|name> | vocab | stats  Recipes: Letter's one library of direction for
                                                        Letterpress on Plan, Build and Fix (/superadmin/recipes),
                                                        each a name, a description, the recipe (what Letterpress

package/lib/commands/admin.mjs

@@ -23,6 +23,7 @@
 //   admin letterpress beyond [--limit N] [--before ISO]  (what members asked that went past the library)
 //   admin letterpress settings|flip|set …                                             (recipes:read / recipes:write)
 //   admin demo guide|list|show|set|reset|check …                                                 (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)
 //   admin models runs|run|star|unstar|scoreboard|requests|request|sampling …       (models:read / models:write)
 //   admin replays [--org <id>] [--target <id>] [--status …] [--limit n]                (fleet:read)
 //   admin replay --org <id> [<response-id> | --target <id>] [--surface …]           (fleet:replay)
@@ -6960,11 +6961,59 @@ export async function cmdAdmin(ctx) {
 	if (sub === "recipes") return cmdAdminRecipes({ ...ctx, positionals: ctx.positionals.slice(1) });
 	if (sub === "letterpress") return cmdAdminLetterpress({ ...ctx, positionals: ctx.positionals.slice(1) });
 	if (sub === "demo") return cmdAdminDemo({ ...ctx, positionals: ctx.positionals.slice(1) });
+	if (sub === "deployments" || sub === "deploys")
+		return cmdAdminDeployments({ ...ctx, positionals: ctx.positionals.slice(1) });
 	throw new CliError(
-		'Usage: admin recipes … | admin letterpress … | admin demo … | admin republish … | admin create-org --domain <bare-domain> [--onboard] … | admin ask "<question>" | admin patterns … | admin experiments … | admin fleet-experiments … | admin crm … | admin spend … | admin evals … | admin brand-detection … | admin tuning … | admin tuning-context | admin replays … (see --help)'
+		'Usage: admin recipes … | admin letterpress … | admin demo … | admin deployments … | admin republish … | admin create-org --domain <bare-domain> [--onboard] … | admin ask "<question>" | admin patterns … | admin experiments … | admin fleet-experiments … | admin crm … | admin spend … | admin evals … | admin brand-detection … | admin tuning … | admin tuning-context | admin replays … (see --help)'
 	);
 }
 
+const MANAGED_HEALTH = ["down", "failing", "blocked", "setting_up", "live", "paused", "archived"];
+
+// `admin deployments` — every site Letter built and hosts, across every organization
+// (docs/architecture/deployments.md, "Every managed site"): worst first, each with its org, domain,
+// health and the problem in one sentence, then what the host has that no app of ours names. The
+// same read as Super Admin → Deployments and the staff-only `list_managed_deployments` tool.
+async function cmdAdminDeployments(ctx) {
+	const { flags, io } = ctx;
+	const health = flagStr(flags.health);
+	if (health !== undefined && !MANAGED_HEALTH.includes(health))
+		throw new CliError(`--health is one of ${MANAGED_HEALTH.join(", ")}.`);
+	const params = new URLSearchParams();
+	if (health) params.set("health", health);
+	if (flagStr(flags.org)) params.set("org_id", flagStr(flags.org));
+	if (flagStr(flags.q)) params.set("q", flagStr(flags.q));
+	if (flagBool(flags.archived)) params.set("include_archived", "1");
+	if (flagBool(flags.test)) params.set("include_test", "1");
+	if (flagBool(flags["no-host"])) params.set("check_host", "0");
+	const qs = params.toString();
+	const result = await staffRequest(ctx, "GET", `/api/superadmin/deployments${qs ? `?${qs}` : ""}`);
+	printResult(io, flags, result, (r) => {
+		const c = r.counts;
+		const lines = [
+			`${c.total} managed site${c.total === 1 ? "" : "s"} across ${c.orgs} org${c.orgs === 1 ? "" : "s"}: ` +
+				MANAGED_HEALTH.filter((h) => c[h] > 0)
+					.map((h) => `${c[h]} ${h.replace("_", " ")}`)
+					.join(", "),
+		];
+		if (!r.apps.length) lines.push("  (none match)");
+		for (const a of r.apps) {
+			lines.push(
+				`${a.id}  ${a.health.padEnd(10)} ${a.name.slice(0, 26).padEnd(26)} ${(a.org.name ?? a.org.id).slice(0, 22).padEnd(22)} ${a.url ?? a.domain ?? "no domain yet"}`
+			);
+			if (a.problem) lines.push(`    ${a.problem}`);
+			else if (a.health === "setting_up" && a.stage_note) lines.push(`    ${a.stage}: ${a.stage_note}`);
+		}
+		if (r.host.read) {
+			lines.push("", `Host: ${r.host.apps} app${r.host.apps === 1 ? "" : "s"} on our account.`);
+			for (const u of r.host.untracked)
+				lines.push(`  untracked ${u.name} (${u.status}) ${u.url ?? ""}`.trimEnd());
+		} else lines.push("", `Host not read: ${r.host.note}`);
+		return lines.join("\n");
+	});
+	return 0;
+}
+
 // `admin brand-detection <org-id>` — how the client's brand is detected in AI answers;
 // with --term / --exact / --exclude it SETS the exact set (replacing the inferred one),
 // --clear goes back to inferred (recorded as a decision, with --note as the why). Every

package/package.json

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