@letterstory/cli 0.121.5 → 0.121.6

package/lib/cli.mjs

@@ -19,6 +19,7 @@ import {
 	cmdPosts,
 	cmdPublished,
 	cmdReviewers,
+	cmdAutomations,
 	cmdCollections,
 	cmdAuthors,
 	cmdFlows,
@@ -60,7 +61,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.121.5";
+export const VERSION = "0.121.6";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value. Every `type: "bool"` flag (and its
@@ -190,6 +191,9 @@ export const BOOLEAN_FLAGS = new Set([
 	"restore",
 	// `posts list --mine`: only your posts.
 	"mine",
+	// `automations set --pause | --resume`.
+	"pause",
+	"resume",
 	// `collection add "<headline>" --collection <id> --queue`.
 	"queue",
 	// Bool flags from command ARGS maps that were missing here.
@@ -417,6 +421,12 @@ Reviewers:
                                                          finished draft (no email sent now)
   reviewers standing remove <reviewer-id>              Stop future auto-invites
   reviewers assigned                                   Posts waiting on your review, across letterbases
+  automations list --collection <id>                   What a letterbase writes, how often, and why
+  automations show <automation-id> --collection <id>  What it covers, its queued posts, its next ideas
+  automations add topic|series|signal|best --collection <id> [--topic <id>] [--goal <target-id>]
+                  [--seer <id>] [--pace <n>]           Add one (refused if it says the same as another)
+  automations set <automation-id> --collection <id> [--pace <n>] [--pause | --resume] [--goal <id>]
+  automations remove <automation-id> --collection <id>
   reviewers invite <article-id> --email <e> [--name <n>]
                                                        Invite a guest to review one post
                                                          (emails them a link and a PIN)
@@ -1372,6 +1382,7 @@ const CLIENT_COMMANDS = {
 	posts: cmdPosts,
 	published: cmdPublished,
 	reviewers: cmdReviewers,
+	automations: cmdAutomations,
 	collections: cmdCollections,
 	authors: cmdAuthors,
 	flows: cmdFlows,

package/lib/commands/automations.mjs

@@ -0,0 +1,68 @@
+// `automations` — a letterbase's automations (docs/architecture/automations.md): what it writes,
+// how often, and why. list / show / add / set / remove, through the same tools the app uses.
+// Same flag/positional/io conventions as posts.mjs — no commander, no color.
+
+import { CliError } from "../client.mjs";
+import { printResult, ok, argsFromFlags, refuseUnknownFlags } from "./shared.mjs";
+
+/** See `argsFromFlags` in shared.mjs; `scripts/parity-check.ts` diffs these keys against the tool. */
+export const ARGS = {
+	list_automations: {
+		collection_id: { flag: "collection", required: true },
+	},
+	get_automation: {
+		collection_id: { flag: "collection", required: true },
+		automation_id: { positional: 0, label: "automation-id", required: true },
+	},
+	create_automation: {
+		collection_id: { flag: "collection", required: true },
+		kind: { positional: 0, label: "kind", required: true, enum: ["topic", "series", "signal", "best"] },
+		cluster_id: { flag: "topic" },
+		target_id: { flag: "goal" },
+		seer_id: { flag: "seer" },
+		pace_per_week: { flag: "pace", type: "num" },
+	},
+	update_automation: {
+		collection_id: { flag: "collection", required: true },
+		automation_id: { positional: 0, label: "automation-id", required: true },
+		pace_per_week: { flag: "pace", type: "num" },
+		paused: {
+			value: (flags) => (flags.pause === true ? true : flags.resume === true ? false : undefined),
+		},
+		target_id: { flag: "goal" },
+	},
+	delete_automation: {
+		collection_id: { flag: "collection", required: true },
+		automation_id: { positional: 0, label: "automation-id", required: true },
+	},
+};
+
+export async function cmdAutomations(ctx) {
+	const sub = ctx.positionals[0];
+	const rest = { ...ctx, positionals: ctx.positionals.slice(1) };
+	switch (sub) {
+		case "list":
+		case "ls":
+			return run(rest, "list_automations");
+		case "show":
+			return run(rest, "get_automation");
+		case "add":
+			return run(rest, "create_automation", "Added.");
+		case "set":
+			refuseUnknownFlags(rest, ARGS.update_automation, ["pause", "resume"]);
+			return run(rest, "update_automation", "Changed.");
+		case "remove":
+		case "rm":
+			return run(rest, "delete_automation", "Removed.");
+		default:
+			throw new CliError(`Unknown automations subcommand: ${sub ?? "(none)"}. Try: list, show, add, set, remove`);
+	}
+}
+
+async function run(ctx, tool, said) {
+	const { client, flags, io } = ctx;
+	const result = await client.callTool(tool, argsFromFlags(ARGS[tool], flags, ctx.positionals));
+	if (said) ok(ctx, said);
+	printResult(io, flags, result);
+	return 0;
+}

package/lib/commands.mjs

@@ -11,6 +11,7 @@ export * from "./commands/phantom.mjs";
 export * from "./commands/mcp.mjs";
 export * from "./commands/posts.mjs";
 export * from "./commands/reviewers.mjs";
+export * from "./commands/automations.mjs";
 export * from "./commands/collections.mjs";
 export * from "./commands/authors.mjs";
 export * from "./commands/flows.mjs";

package/package.json

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