@letterstory/cli 0.176.94 → 0.176.96

package/lib/cli.mjs

@@ -86,7 +86,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.94";
+export const VERSION = "0.176.96";
 
 /** 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;
@@ -101,6 +101,8 @@ export const BOOLEAN_FLAGS = new Set([
 	"advance",
 	// build list: only what the Plan started.
 	"from-plan",
+	// domains plan: scores only, no model call.
+	"no-write",
 	// build: a website or app of its own (deploy create's path). deploy create: hold until its build starts.
 	"new-site",
 	"wait",
@@ -563,6 +565,7 @@ Collections (the content engine as a primitive — one door, 'collection run'):
   collection run-status <run-id>                       Status, steps, constraints, verification
   collection runs [--collection <id>] [--status <s>] [--limit <n>]
   collection approve <run-id> [--now]                  Answer the gate (--now publishes immediately)
+  collection start <run-id>                            Start a scheduled slot's writing now (it goes live at its slot)
   collection move <run-id> --date YYYY-MM-DD           Move a slot not yet written, or an approved written post, to another day
   collection cancel <run-id>
   collection inventory <id>                            Where every piece is; each finished draft's publish-on-its-own time
@@ -1970,10 +1973,10 @@ Domains (the domains you hold, and free ones that match what people search):
                                                        Free .com/.org domains on what people search in your
                                                        space (brainstormed, or the phrases given), ranked
   domains buy <domain> --dry-run | --yes               The price and whose account pays; --yes buys it
-  domains plan <domain> [--phrase "<search>"] [--searches <n>]
+  domains plan <domain> [--phrase "<search>"] [--searches <n>] [--version <version>] [--no-write]
                                                        The most strategic site for the domain, every version
                                                        scored, and whether it can launch; spends nothing
-  domains launch <domain> [--phrase …] [--searches …] [--words "<plan words>"] --yes
+  domains launch <domain> [--phrase …] [--searches …] [--version <version>] [--words "<plan words>"] --yes
                                                        Build and Launch Site: buys the domain if needed, builds
                                                        the plan and puts it live
 

package/lib/commands/collection.mjs

@@ -134,6 +134,9 @@ export const ARGS = {
 	cancel_collection_run: {
 		run_id: { positional: 0, label: "run-id", required: true },
 	},
+	start_collection_run: {
+		run_id: { positional: 0, label: "run-id", required: true },
+	},
 	reschedule_collection_run: {
 		run_id: { positional: 0, label: "run-id", required: true },
 		date: { flag: "date", required: true },
@@ -184,6 +187,8 @@ export async function cmdCollection(ctx) {
 			return collectionApprove(rest);
 		case "cancel":
 			return collectionCancel(rest);
+		case "start":
+			return collectionStart(rest);
 		case "move":
 		case "reschedule":
 			return collectionMove(rest);
@@ -197,7 +202,7 @@ export async function cmdCollection(ctx) {
 			return collectionMentions(rest);
 		default:
 			throw new CliError(
-				`Unknown collection subcommand: ${sub ?? "(none)"}. Try: list, overview, new, config, delete, run, add, queue, headline, run-status, runs, approve, move, cancel, inventory, links, mentions`
+				`Unknown collection subcommand: ${sub ?? "(none)"}. Try: list, overview, new, config, delete, run, add, queue, headline, run-status, runs, approve, start, move, cancel, inventory, links, mentions`
 			);
 	}
 }
@@ -395,6 +400,18 @@ async function collectionCancel(ctx) {
 	return 0;
 }
 
+// `collection start <run-id>` — a slot on the calendar starts writing now; it still goes live at its slot
+// (start_collection_run, the way a letterbase's writing automation starts its slot).
+async function collectionStart(ctx) {
+	const result = await ctx.client.callTool(
+		"start_collection_run",
+		argsFromFlags(ARGS.start_collection_run, ctx.flags, ctx.positionals)
+	);
+	ok(ctx, toolField(result, "started") ? "Started: it is being written." : "Not started yet: see its step.");
+	printResult(ctx.io, ctx.flags, result);
+	return 0;
+}
+
 // `collection move <run-id> --date YYYY-MM-DD` — a slot not yet written, or a written post
 // already approved, onto another day (reschedule_collection_run).
 async function collectionMove(ctx) {

package/lib/commands/domains.mjs

@@ -7,9 +7,10 @@
 //   letterstory domains scan "nano banana pro" ["ai headshots" …] [--tld com,org,ai] [--expand none|searches|space]
 //   letterstory domains buy nanobananaprofree.com --dry-run     the price and whose account pays; buys nothing
 //   letterstory domains buy nanobananaprofree.com --yes          buys it (spends money; domains:write)
-//   letterstory domains plan bestaidatalabs.com [--phrase "best ai data labs"] [--searches 880]
+//   letterstory domains plan bestaidatalabs.com [--phrase "best ai data labs"] [--searches 880] [--version comparison]
+//                                                [--no-write]
 //                                                                 the most strategic site for it; spends nothing
-//   letterstory domains launch bestaidatalabs.com [--phrase …] [--searches …] --yes
+//   letterstory domains launch bestaidatalabs.com [--phrase …] [--searches …] [--version …] --yes
 //                                                                 Build and Launch Site: buys it if needed, builds the
 //                                                                 plan and puts it live (spends money; domains:write)
 
@@ -42,11 +43,16 @@ export const ARGS = {
 		domain: { value: (flags, positionals) => stripScheme(requirePositional(positionals, 0, "domain")) },
 		phrase: { flag: "phrase" },
 		monthly_searches: { flag: "searches", type: "num" },
+		// A version other than the top score (ranked_list, comparison, directory, free_tool, templates, guide).
+		version: { flag: "version" },
+		// The scores and whether it can launch, at once: the version's own plan, no model call.
+		write: { flag: "no-write", type: "bool", invert: true },
 	},
 	launch_domain_site: {
 		domain: { value: (flags, positionals) => stripScheme(requirePositional(positionals, 0, "domain")) },
 		phrase: { flag: "phrase" },
 		monthly_searches: { flag: "searches", type: "num" },
+		version: { flag: "version" },
 		// The words of a plan already read (`domains plan … --json`'s plan.words): that plan is built as it was.
 		words: { flag: "words" },
 	},

package/package.json

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