@letterstory/cli 0.176.97 → 0.176.99

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.99";
 
 /** 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;
@@ -119,6 +119,8 @@ export const BOOLEAN_FLAGS = new Set([
 	"no-disclosure",
 	// replicate show: list only the pages below the bar.
 	"failing",
+	// replicate forms: read the site's forms key (admins) instead of its submissions.
+	"show-key",
 	// sim create / resample / sample-key: keep the customer's sample key, or delete it now.
 	"keep-key",
 	"delete-key",
@@ -131,7 +133,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",
@@ -2067,6 +2071,9 @@ Replicate (the Replicator: a website rebuilt as a native Next.js repo, page for
                                                        --again replicates from the start; --preview deploys its staging link again;
                                                        --extend-preview keeps the preview up longer (Letter's team only)
   replicate archive <id>                               Stop it and take its preview down; the project stays in storage and in the repo
+  replicate forms [<id>] [--form <f>] [--limit <n>] [--before <iso>]
+                                                       What people sent through the replicated sites' forms, newest first;
+                                                       --show-key (admins): LETTER_FORMS_URL and LETTER_FORMS_KEY to host it yourself
 
 Evals (how the pipeline is doing on your posts, and the regression cases captured from them):
   evals scoreboard [--collection <id>] [--days N]      Every measure by stage: posts, failing, rate

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/lib/commands/replicate.mjs

@@ -3,8 +3,8 @@
 // Who may use it is one switch in the app (lib/replicator/access.ts): until it opens, the tools answer
 // only a key an @letterstory.com person made. Free, within fair-use limits. Thin wrappers over the
 // replicator tools (create_replication, list_replications, get_replication,
-// attach_replication_repo, advance_replication, archive_replication), the same lib functions the
-// app calls.
+// attach_replication_repo, advance_replication, archive_replication, list_form_submissions), the
+// same lib functions the app calls.
 //
 //   letterstory replicate https://example.com [--max-pages 300] [--refine-budget 25] [--repo-name example-site] [--repo-owner <account>]
 //   letterstory replicate list
@@ -12,6 +12,8 @@
 //   letterstory replicate attach <id> <repo-name> [--repo-owner <account>]
 //   letterstory replicate advance <id> [--retry] [--again] [--preview] [--extend-preview <days>]
 //   letterstory replicate archive <id>
+//   letterstory replicate forms [<id>] [--form <form>] [--limit <n>] [--before <iso>]
+//   letterstory replicate forms <id> --show-key  (admins: LETTER_FORMS_URL and LETTER_FORMS_KEY to host it yourself)
 
 import { CliError } from "../client.mjs";
 import { argsFromFlags, printResult, refuseUnknownFlags } from "./shared.mjs";
@@ -44,6 +46,13 @@ export const ARGS = {
 		extend_preview_days: { flag: "extend-preview", type: "num" },
 	},
 	archive_replication: { replication_id: replicationId },
+	get_replication_forms_key: { replication_id: replicationId },
+	list_form_submissions: {
+		replication_id: { positional: 0, label: "replication-id" },
+		form: "form",
+		limit: { flag: "limit", type: "num" },
+		before: "before",
+	},
 };
 
 function call(ctx, tool) {
@@ -75,8 +84,15 @@ export async function cmdReplicate(ctx) {
 			return replicationShow(rest, await call(rest, "advance_replication"));
 		case "archive":
 			return replicationShow(rest, await call(rest, "archive_replication"));
+		case "forms":
+			if (rest.flags["show-key"] === true) {
+				refuseUnknownFlags(rest, ARGS.get_replication_forms_key, ["show-key"]);
+				return formsKey(rest, await call(rest, "get_replication_forms_key"));
+			}
+			refuseUnknownFlags(rest, ARGS.list_form_submissions, []);
+			return formSubmissions(rest, await call(rest, "list_form_submissions"));
 		default:
-			throw new CliError("Usage: replicate <https://site> | replicate [list|show|attach|advance|archive]");
+			throw new CliError("Usage: replicate <https://site> | replicate [list|show|attach|advance|archive|forms]");
 	}
 }
 
@@ -201,6 +217,37 @@ function previewLines(x) {
 	return [];
 }
 
+// The two values the site's forms send to Letter with, to set where it is hosted (never in its repo).
+function formsKey(ctx, result) {
+	printResult(ctx.io, ctx.flags, result, (r) =>
+		[
+			`LETTER_FORMS_URL=${r.url}`,
+			`LETTER_FORMS_KEY=${r.secret_key}`,
+			"",
+			"Set these where the site is hosted, the key as a secret. Never commit the key.",
+		].join("\n")
+	);
+	return 0;
+}
+
+// What people sent through the replicated sites' forms (Letter's default destination), newest first.
+function formSubmissions(ctx, result) {
+	printResult(ctx.io, ctx.flags, result, (r) => {
+		if (!r.submissions?.length) return "No form submissions yet.";
+		const lines = [];
+		for (const s of r.submissions) {
+			lines.push(
+				`${s.received_at}  ${s.host}${s.page ?? ""}  ${s.form_name ?? s.form}${s.notified ? "" : `  (not emailed${s.notify_error ? `: ${s.notify_error}` : ""})`}`
+			);
+			for (const [name, value] of Object.entries(s.fields))
+				lines.push(`    ${name}: ${Array.isArray(value) ? value.join(", ") : value}`);
+		}
+		if (r.next_before) lines.push("", `More: replicate forms --before ${r.next_before}`);
+		return lines.join("\n");
+	});
+	return 0;
+}
+
 function replicationShow(ctx, result) {
 	printResult(ctx.io, ctx.flags, result, (r) =>
 		[...headline(r.replication), ...(r.notice ? [`  Note    ${r.notice}`] : []), ...limitsLines(r.limits)].join(

package/package.json

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