@letterstory/cli 0.176.41 → 0.176.42

package/lib/cli.mjs

@@ -83,7 +83,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.41";
+export const VERSION = "0.176.42";
 
 /** 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;
@@ -1680,6 +1680,8 @@ Insights:
                                                        them (--goal: one goal's strategies, else any); each pick waits --veto-hours for a veto. Settings shown when none given.
   plan pending [--site host]                           What Auto-Plan picked and is waiting to build
   plan veto <proposal-id>                              Veto one: it is never built
+  plan start <proposal-id>                             Start one now (a Needs you pick, or one waiting out its review window)
+  plan preview [--site host]                           What Auto-Plan would do first, before it is on
   plan later <action-id> [--outcome geo|…] [--site host]  Queue a Plan row for later: Auto-Plan starts it once it's ready
   plan later remove <queued-id>                        Take a queued row back off
   plan strategies [--site host] [--archived]           The goals typed on the Plan, each a strategy

package/lib/commands/plan.mjs

@@ -6,6 +6,8 @@
 //             [--slack-channel <C…>|none]  → set_auto_plan
 //   plan pending                               → list_auto_plan_proposals (status pending)
 //   plan veto <proposal-id>                    → veto_auto_plan_proposal
+//   plan start <proposal-id>                   → start_auto_plan_proposal (a Needs you pick, or one waiting out its review window)
+//   plan preview                               → preview_auto_plan (what Auto-Plan would do first)
 //   plan later <action-id> [--outcome geo|…]   → queue_plan_action (Auto-Plan starts it once it's ready)
 //   plan later remove <queued-id>              → unqueue_plan_action
 //   plan strategies [--archived]               → list_plan_strategies (the goals typed on the Plan)
@@ -78,6 +80,8 @@ export const ARGS = {
 	},
 	unqueue_plan_action: { id: { positional: 0, required: true, label: "queued-id" } },
 	veto_auto_plan_proposal: { id: { positional: 0, required: true, label: "proposal-id" } },
+	start_auto_plan_proposal: { id: { positional: 0, required: true, label: "proposal-id" } },
+	preview_auto_plan: { domain: "site" },
 	list_plan_strategies: { domain: "site", archived: { flag: "archived", type: "bool" } },
 	create_plan_strategy: {
 		domain: "site",
@@ -143,6 +147,25 @@ export async function cmdPlan(ctx) {
 		);
 		return 0;
 	}
+	if (sub === "start") {
+		refuseUnknownFlags(ctx, {}, []);
+		const result = await client.callTool(
+			"start_auto_plan_proposal",
+			argsFromFlags(ARGS.start_auto_plan_proposal, flags, rest)
+		);
+		printResult(io, flags, result, (r) => r.message);
+		return 0;
+	}
+	if (sub === "preview") {
+		refuseUnknownFlags(ctx, {}, ["site"]);
+		const result = await client.callTool("preview_auto_plan", argsFromFlags(ARGS.preview_auto_plan, flags, rest));
+		printResult(io, flags, result, (r) =>
+			[r.message, ...r.picks.map((p) => `  ${p.kind === "pr" ? "opens a PR " : "needs you  "} ${p.title}`)].join(
+				"\n"
+			)
+		);
+		return 0;
+	}
 	if (sub === "veto") {
 		refuseUnknownFlags(ctx, {}, []);
 		const result = await client.callTool(
@@ -187,6 +210,6 @@ export async function cmdPlan(ctx) {
 		throw new CliError('Usage: plan strategy add "<words…>" | plan strategy archive <strategy-id> [--restore]');
 	}
 	throw new CliError(
-		"Usage: plan auto [settings…] | plan pending | plan veto <proposal-id> | plan later <action-id> | plan later remove <id> | plan strategies | plan strategy add|archive"
+		"Usage: plan auto [settings…] | plan pending | plan veto <proposal-id> | plan start <proposal-id> | plan preview | plan later <action-id> | plan later remove <id> | plan strategies | plan strategy add|archive"
 	);
 }

package/package.json

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