@letterstory/cli 0.176.103 → 0.176.105

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.103";
+export const VERSION = "0.176.105";
 
 /** 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;
@@ -679,6 +679,7 @@ Reviewers:
                [--prompt <what Letterpress does with each event>] [--slack-channel <C…>] [--instruction <which events>]
                [--event <name>] [--kind post|landing] [--competitor <host>] [--site <host>]
                [--every <n> --unit hours|days|weeks|months] [--facts <a,b>] [--recipe <id>]
+               [--fit-run <run-id> --publication-host <site>]
                [--hot-leads-only] [--per-day <n>] [--backfill all|<YYYY-MM-DD>] [--off]
                                                        Make one (a template fills what you leave out): it starts
                                                        from now (--backfill also runs it on past events, oldest

package/lib/commands/admin.mjs

@@ -5264,7 +5264,7 @@ 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] | 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>";
+	"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>";
 
 /** One number of the settings from a dotted path and a value: the PUT body save_engine_settings reads. */
 function engineSettingsPatch(path, value) {
@@ -5731,6 +5731,26 @@ async function cmdAdminLetterpress(ctx) {
 			);
 			return 0;
 		}
+		case "ideas": {
+			// list_company_ideas: the rows the company's Ideas tab lists, with the recipe behind each.
+			const org = positionals[1];
+			if (!org) throw new CliError(ENGINE_USAGE);
+			const q = new URLSearchParams({ org_id: org });
+			if (flags.site) q.set("domain", String(flags.site));
+			const r = await staffRequest(ctx, "GET", `${LETTERPRESS}-companies/ideas?${q}`);
+			printResult(io, flags, r, (x) =>
+				x.ideas.length
+					? [
+							`${x.host}: ${x.ideas.length} idea${x.ideas.length === 1 ? "" : "s"}${x.status === "ready" ? "" : ` (${x.status})`}`,
+							...x.ideas.map(
+								(i, n) =>
+									`${String(n + 1).padStart(2)}. ${i.title}${i.recipe ? `  [${i.recipe}]` : ""}${i.badge ? `  (${i.badge.label})` : ""}\n    ${i.detail ?? i.why}`
+							),
+						].join("\n")
+					: x.message
+			);
+			return 0;
+		}
 		case "facts": {
 			// list_account_facts: what the verdicts rest on.
 			const org = positionals[1];

package/lib/commands/automate.mjs

@@ -132,6 +132,15 @@ export const ARGS = {
 		scope,
 		// --recipe <id>: make the automation a Plan recipe carries (the Plan row's own call).
 		recipe: { flag: "recipe" },
+		publication: {
+			value: (flags) => {
+				const run = flagStr(flags["fit-run"]);
+				const host = flagStr(flags["publication-host"]);
+				if (Boolean(run) !== Boolean(host))
+					throw new CliError("Pass --fit-run and --publication-host together.");
+				return run ? { run_id: run, host } : undefined;
+			},
+		},
 		name: { flag: "name" },
 		trigger: { flag: "trigger", enum: TRIGGERS },
 		trigger_params: triggerParams,

package/package.json

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