@letterstory/cli 0.176.94 → 0.176.95

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.95";
 
 /** 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;
@@ -563,6 +563,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

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/package.json

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