@letterstory/cli 0.177.15 → 0.177.17

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.15";
+export const VERSION = "0.177.17";
 
 /** 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

@@ -5141,12 +5141,14 @@ const RECIPE_FILE_FIELDS = [
 	"tool_access",
 	"primitives_access",
 	"immediate",
+	// Whether its row must name what it acts on (2026-11-11); left out here, an export would drop it.
+	"names_subject",
 	"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] [--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] [--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]]));
 
@@ -5196,6 +5198,7 @@ function recipeDetail(r) {
 			: r.primitives_access
 				? ["  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)"] : []),
 		...(variations.length > 1
 			? variations.flatMap((v, i) => [`  variation ${i + 1}: ${v.name}`, ...fields(v, "    ")])
 			: fields(r, "  ")),
@@ -5250,6 +5253,8 @@ function recipeFromFlags(flags) {
 			flags["primitives-access"] === undefined ? undefined : String(flags["primitives-access"]) === "true",
 		// --immediate is accepted for old scripts and read by nothing: a quick row is one whose runs is empty.
 		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",
 		// --reads llms_txt,github declares the facts its conditions rest on; --reads "" clears them.
 		reads: flagStr(flags.reads)
 			?.split(",")

package/lib/commands/deploy.mjs

@@ -123,9 +123,20 @@ export async function cmdDeploy(ctx) {
 		case "advance":
 			refuseUnknownFlags(rest, ARGS.advance_deployment, []);
 			return deployShow(rest, await call(rest, "advance_deployment"));
-		case "page":
+		case "page": {
 			refuseUnknownFlags(rest, ARGS.add_deployment_page, []);
-			return deployShow(rest, await call(rest, "add_deployment_page"));
+			const result = await call(rest, "add_deployment_page");
+			if (result?.app) return deployShow(rest, result);
+			// A phantom moved to code answers with the phantom, not an app.
+			printResult(
+				rest.io,
+				rest.flags,
+				result,
+				(r) =>
+					`${r.phantom?.name ?? "The site"}: adding a landing page\n  Run     ${r.run_id} (repo show ${r.run_id})`
+			);
+			return 0;
+		}
 		case "connect":
 			return deployShow(rest, await call(rest, "connect_deployment_repo"));
 		case "source": {

package/package.json

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