@letterstory/cli 0.176.97 → 0.176.98

package/lib/cli.mjs

@@ -87,7 +87,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.97";
+export const VERSION = "0.176.98";
 
 /** 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;
@@ -131,7 +131,9 @@ export const BOOLEAN_FLAGS = new Set([
 	"start",
 	// site research-builds: run now even when the stored pass is under an hour old.
 	"fresh",
-	// admin letterpress telemetry | prs: every org, test and demo orgs included.
+	// admin letterpress tokens: today so far against yesterday and a week ago.
+	"so-far",
+	// admin letterpress telemetry | prs | tokens: every org, test and demo orgs included.
 	"all-orgs",
 	// admin letterpress prs | failures: since the first PR or build (all_time).
 	"all-time",

package/lib/commands/admin.mjs

@@ -5261,9 +5261,10 @@ 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 PLATFORM_USAGE = "/api/superadmin/usage/platform";
 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] | 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>";
+	"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] | 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) {
@@ -5506,6 +5507,30 @@ async function cmdAdminLetterpress(ctx) {
 			);
 			return 0;
 		}
+		case "tokens": {
+			// get_platform_usage: every customer's tokens day by day, Letterpress's on its own (Letterpress → Today).
+			const q = new URLSearchParams({ days: String(flags.days ?? 30) });
+			if (flagBool(flags["all-orgs"])) q.set("customers", "0");
+			if (flagBool(flags["so-far"])) q.set("so_far", "1");
+			const r = await staffRequest(ctx, "GET", `${PLATFORM_USAGE}?${q}`);
+			const n = (v) => Math.round(v).toLocaleString("en-US");
+			printResult(io, flags, r, (x) =>
+				[
+					`Tokens, ${x.since_day} to ${x.until_day} (${x.tz})${x.customer_only ? ", customers only" : ""}: ${n(x.totals.tokens)}, Letterpress ${n(x.totals.letterpress)}`,
+					`by product: ${x.categories.map((c) => `${c.label} ${n(x.totals.by_category[c.key] ?? 0)}`).join(", ") || "—"}`,
+					...x.series.map(
+						(d) =>
+							`${d.day}  ${n(d.tokens).padStart(10)} tokens  ${n(d.letterpress).padStart(8)} Letterpress`
+					),
+					...(x.so_far
+						? [
+								`today so far ${n(x.so_far.today)}; by this time yesterday ${n(x.so_far.yesterday)}, a week ago ${n(x.so_far.week_ago)}`,
+							]
+						: []),
+				].join("\n")
+			);
+			return 0;
+		}
 		case "prs": {
 			// get_pull_requests (the days) or, with --day / --org / --state, list_pull_requests (the PRs behind them).
 			const listing = flags.day || flags.org || flags.state;

package/package.json

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