@letterstory/cli 0.177.38 → 0.177.40

package/lib/cli.mjs

@@ -88,7 +88,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.38";
+export const VERSION = "0.177.40";
 
 /** 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;

package/lib/commands/admin.mjs

@@ -5179,12 +5179,14 @@ const RECIPE_FILE_FIELDS = [
 	"immediate",
 	// Whether its row must name what it acts on (2026-11-11); left out here, an export would drop it.
 	"names_subject",
+	// Where its row shows: ideas or fix (a deficit, 2026-11-13); left out here, an export would drop it.
+	"shows_in",
 	"status",
 	"needs",
 	"variations",
 ];
 const RECIPES_USAGE =
-	"Usage: admin recipes list [--kind recipe|known_issue] [--status live|parked] [--approach seo|geo|agent_conviction|inbound_conversion|outbound|other] | show <id|name> | runs <id|name> [--days 1..90] [--limit n] | vocab | stats | export [--out <file>] | import <file> [--dry-run] | refit [--org <id>,…] [--recipe <id|name>] [--limit n] | save [<id>] [--file <recipe.json>] [--kind recipe|known_issue] [--name …] [--description …] [--recipe …] [--when-to-use …] [--when-not-to-use …] [--weight 1..10] [--approaches seo,geo,…] [--reads llms_txt,github,…] [--runs <catalog action id>] [--primitives-access true|false] [--immediate true|false] [--names-subject true|false] [--status live|parked] [--needs <what a parked recipe is missing>] | delete <id> --yes";
+	"Usage: admin recipes list [--kind recipe|known_issue] [--status live|parked] [--approach seo|geo|agent_conviction|inbound_conversion|outbound|other] | show <id|name> | runs <id|name> [--days 1..90] [--limit n] | vocab | stats | export [--out <file>] | import <file> [--dry-run] | refit [--org <id>,…] [--recipe <id|name>] [--limit n] | save [<id>] [--file <recipe.json>] [--kind recipe|known_issue] [--name …] [--description …] [--recipe …] [--when-to-use …] [--when-not-to-use …] [--weight 1..10] [--approaches seo,geo,…] [--reads llms_txt,github,…] [--runs <catalog action id>] [--primitives-access true|false] [--immediate true|false] [--names-subject true|false] [--shows-in ideas|fix] [--status live|parked] [--needs <what a parked recipe is missing>] | delete <id> --yes";
 
 const recipeForFile = (r) => Object.fromEntries(RECIPE_FILE_FIELDS.map((k) => [k, r[k]]));
 
@@ -5235,6 +5237,7 @@ function recipeDetail(r) {
 				? ["  letter's tools:   its build may read the account through them (primitives_access)"]
 				: []),
 		...(r.names_subject ? ["  title:            names what it acts on, or it is a no (names_subject)"] : []),
+		...(r.shows_in === "fix" ? ["  shows in:         Fix, as a deficit (shows_in)"] : []),
 		...(variations.length > 1
 			? variations.flatMap((v, i) => [`  variation ${i + 1}: ${v.name}`, ...fields(v, "    ")])
 			: fields(r, "  ")),
@@ -5291,6 +5294,8 @@ function recipeFromFlags(flags) {
 		immediate: flags.immediate === undefined ? undefined : String(flags.immediate) === "true",
 		// --names-subject true: its row names what it acts on, or is a no; false: it may keep its general name.
 		names_subject: flags["names-subject"] === undefined ? undefined : String(flags["names-subject"]) === "true",
+		// --shows-in fix: its row is a deficit, in Fix's Deficits; ideas (the default): a thing to build, on Ideas.
+		shows_in: flagStr(flags["shows-in"]),
 		// --reads llms_txt,github declares the facts its conditions rest on; --reads "" clears them.
 		reads: flagStr(flags.reads)
 			?.split(",")
@@ -6355,7 +6360,9 @@ const FREE_USAGE = `Usage: admin billing free exposure [--json]               wh
        admin billing free grant <org-id|name> <tokens> --why "…" [--key k]   give an org free tokens (a Lago org: a one-off wallet); the same key is one grant
        admin billing free grants [--org <org-id>] [--limit n]   staff grants, newest first, live and revoked
        admin billing free revoke <org-id> <ref> --why "…"   take a staff grant back (ref from the list: grant:<id> or wallet:staff_…)
-       admin billing free preflight [--json]               who the paywall stops the moment it is enforced, and whether it is ready`;
+       admin billing free preflight [--json]               who the paywall stops the moment it is enforced, and whether it is ready
+       admin billing free pool <org-id|name>... --why "…"   link orgs on free tokens so they spend from one balance
+       admin billing free unpool <org-id|name> --why "…"    take an org out of its shared balance`;
 
 const EXPOSURE_WORDS = {
 	needs_legacy: "pay today: need a legacy mark (admin billing legacy mark --all)",
@@ -6457,6 +6464,28 @@ async function cmdAdminBillingFree(ctx) {
 		});
 		return 0;
 	}
+	if (positionals[1] === "pool" || positionals[1] === "unpool") {
+		const pool = positionals[1] === "pool";
+		const args = positionals.slice(2);
+		if (pool ? args.length < 2 : args.length !== 1) throw new CliError(FREE_USAGE);
+		const why = flagStr(flags.why);
+		if (!why) throw new CliError(`Say why (--why "…"): it is kept with the change.\n${FREE_USAGE}`);
+		const orgIds = [];
+		for (const a of args) orgIds.push((await resolveBillingOrg(ctx, a)).orgId);
+		const r = pool
+			? await staffPost(ctx, "/api/superadmin/billing/token-pools", { orgIds, why })
+			: await staffRequest(ctx, "DELETE", "/api/superadmin/billing/token-pools", { orgId: orgIds[0], why });
+		printResult(io, flags, r, (x) =>
+			pool
+				? `Sharing one token balance (${x.poolId}):\n${x.orgs.map((o) => `  ${o.name}  ${o.orgId}`).join("\n")}`
+				: !x.changed
+					? `${orgIds[0]} is in no pool; nothing changed.`
+					: x.left.length
+						? `Taken out. Still sharing: ${x.left.map((o) => o.name).join(", ")}.`
+						: "Taken out. The pool had one org left, so it ended."
+		);
+		return 0;
+	}
 	if (positionals[1] === "grant") {
 		const [orgArg, tokensArg] = [positionals[2], positionals[3]];
 		const tokens = Number(String(tokensArg ?? "").replace(/[,_]/g, ""));

package/lib/commands/automate.mjs

@@ -26,6 +26,7 @@ const TEMPLATES = [
 	"competitor_pages",
 	"competitor_takes",
 	"competitor_changes",
+	"competitor_flags",
 	"icp_visitors",
 	"vc_visitors",
 	"plan_updates",

package/package.json

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