@letterstory/cli 0.177.1 → 0.177.3

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.177.1";
+export const VERSION = "0.177.3";
 
 /** 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;
@@ -96,6 +96,8 @@ export const EXIT_PAYMENT_REQUIRED = 3;
 // can't accidentally swallow the id as --json's value. Every `type: "bool"` flag (and its
 // `negate` spelling) in a command's ARGS map must be listed; boolean-flags.test.ts enforces it.
 export const BOOLEAN_FLAGS = new Set([
+	// collection onboard: connect without drafting or scheduling.
+	"connect-only",
 	// admin demo ideas: every live recipe, not only the Ideas that fit.
 	"library",
 	// admin targets check: check every target again, checked or not.

package/lib/commands/admin.mjs

@@ -5263,8 +5263,9 @@ 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 SUGGESTION_REVIEW = "/api/superadmin/suggestion-review";
 const ENGINE_USAGE =
-	"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] | ideas <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] | ideas <org-id> [--site host] | suggestions fix|idea [--day YYYY-MM-DD] [--type key [--org id]] [--all-orgs] | suggestions flag fix|idea <type-key> [--org id --item item-id] [--note …] | suggestions clear <flag-id> | 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) {
@@ -5751,6 +5752,71 @@ async function cmdAdminLetterpress(ctx) {
 			);
 			return 0;
 		}
+		case "suggestions": {
+			// get_suggestion_types (last night's Fix or Ideas rows across the fleet, by type) or, with --type,
+			// list_suggestion_sightings (the rows behind one type, with why each was surfaced); flag_suggestion and
+			// clear_suggestion_flag.
+			const sub = positionals[1];
+			if (sub === "flag") {
+				const tab = positionals[2];
+				const typeKey = positionals[3];
+				if (!["fix", "idea"].includes(tab) || !typeKey) throw new CliError(ENGINE_USAGE);
+				const r = await staffPost(
+					ctx,
+					SUGGESTION_REVIEW,
+					compact({
+						tab,
+						type_key: typeKey,
+						org_id: flagStr(flags.org),
+						item_id: flagStr(flags.item),
+						note: flagStr(flags.note),
+					})
+				);
+				printResult(
+					io,
+					flags,
+					r,
+					(x) =>
+						`Flagged ${x.flag.type_key}${x.flag.org_id ? ` for ${x.flag.org_name ?? x.flag.org_id}` : ""}: ${x.flag.id}`
+				);
+				return 0;
+			}
+			if (sub === "clear") {
+				const id = positionals[2];
+				if (!id) throw new CliError(ENGINE_USAGE);
+				const r = await staffRequest(ctx, "DELETE", `${SUGGESTION_REVIEW}?id=${encodeURIComponent(id)}`);
+				printResult(io, flags, r, () => `Cleared ${id}`);
+				return 0;
+			}
+			if (!["fix", "idea"].includes(sub)) throw new CliError(ENGINE_USAGE);
+			const q = new URLSearchParams({ tab: sub });
+			if (flags.day) q.set("day", String(flags.day));
+			if (flags.type) q.set("type_key", String(flags.type));
+			if (flags.org) q.set("org_id", String(flags.org));
+			if (flagBool(flags["all-orgs"])) q.set("customers", "0");
+			const r = await staffRequest(ctx, "GET", `${SUGGESTION_REVIEW}?${q}`);
+			printResult(io, flags, r, (x) =>
+				flags.type
+					? x.sightings.length
+						? x.sightings
+								.map(
+									(s) =>
+										`${(s.org_name ?? s.org_id).padEnd(22)} ${s.status.padEnd(8)} ${s.new ? "new " : "    "}${s.title}\n    ${s.line}${s.why?.fit ? `\n    fit: ${s.why.fit.verdict}, ${s.why.fit.why}` : ""}${s.flags.length ? `\n    flagged: ${s.flags.map((f) => f.note || "no note").join("; ")}` : ""}\n    item ${s.item_id}`
+								)
+								.join("\n")
+						: "No rows."
+					: x.day
+						? [
+								`${sub === "fix" ? "Fix" : "Ideas"}, the night of ${x.day}${x.previous_day ? ` (against ${x.previous_day})` : ""}${x.customer_only ? ", customers only" : ""}: ${x.totals.types} types, ${x.totals.rows} rows (${x.totals.new_rows} new) across ${x.totals.companies} companies; ${x.totals.new_types} new types, ${x.totals.gone_types} gone; ${x.totals.flagged} flagged`,
+								...x.types.map(
+									(t) =>
+										`${String(t.companies).padStart(4)} cos ${String(t.rows).padStart(5)} rows ${String(t.new_rows).padStart(4)} new  ${t.label} [${t.type_key}, ${t.source}]${t.new_type ? " NEW" : ""}${t.flags.length || t.flagged_rows ? " FLAGGED" : ""}  ${t.examples[0] ?? ""}`
+								),
+							].join("\n")
+						: "Nothing read yet: the fleet's suggestions are read every night."
+			);
+			return 0;
+		}
 		case "facts": {
 			// list_account_facts: what the verdicts rest on.
 			const org = positionals[1];

package/lib/commands/onboard.mjs

@@ -92,6 +92,7 @@ export const ARGS = {
 		// Start what the blog writes once it is read in (the starter automations, every draft for
 		// review), the one accept apply_starter_automations makes. Not with --enable-planner.
 		start_writing: { flag: "start-writing", type: "bool" },
+		connect_only: { flag: "connect-only", type: "bool" },
 	},
 	get_collection_onboard_status: {
 		job_id: { internal: "the job id onboard_collection just returned" },
@@ -414,6 +415,13 @@ function overridesFromFlags(flags) {
 // Final readback of a collection-onboarding job — the counts the engine PERSISTED.
 function formatCollectionStatus(s) {
 	const r = s.result ?? {};
+	if (s.connect_only)
+		return [
+			`Connection ${s.status}`,
+			`  collection: ${s.collection_id}`,
+			...(r.publishing ? [`  publishing: ${r.publishing.destination}`] : []),
+			...(s.error ? [`  error: ${s.error}`] : []),
+		].join("\n");
 	const lines = [
 		`Onboarding ${s.status} at stage "${s.stage}"`,
 		`  collection:  ${s.collection_id}`,

package/package.json

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