@letterstory/cli 0.133.0 → 0.134.0

package/lib/cli.mjs

@@ -62,7 +62,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.133.0";
+export const VERSION = "0.134.0";
 
 // 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
@@ -449,6 +449,10 @@ Reviewers:
   automations show <automation-id> --collection <id>  What it covers, its queued posts, its next ideas
   automations ideas --collection <id>                  The ideas waiting, grouped by the automation that owns each
   automations suggest --collection <id>                What it could add: topics, series formats, signals
+  automations starter --collection <id>                The first automations, from its evidence, with the
+                                                       calls that accept them (steps)
+  automations ground --collection <id>                 Its ground: strengths, near wins and gaps, with the numbers
+  automations works --collection <id>                  What works: each post and automation against its peers
   automations preview topic|series --collection <id> [--name <name>|--topic <id>] [--brief <text>]
                                                        What it would write, before adding it
   automations more --collection <id>                   New topics it doesn't cover yet

package/lib/commands/automations.mjs

@@ -1,5 +1,5 @@
 // `automations` — a letterbase's automations (docs/architecture/automations.md): what it writes,
-// how often, and why. list / show / ideas / suggest / preview / more / add / set / dismiss / remove, through the same tools the app uses.
+// how often, and why. list / show / ideas / suggest / starter / ground / works / preview / more / add / set / dismiss / 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";
@@ -16,6 +16,15 @@ export const ARGS = {
 	suggest_automations: {
 		collection_id: { flag: "collection", required: true },
 	},
+	suggest_starter_automations: {
+		collection_id: { flag: "collection", required: true },
+	},
+	get_ground_measures: {
+		collection_id: { flag: "collection", required: true },
+	},
+	get_what_works: {
+		collection_id: { flag: "collection", required: true },
+	},
 	get_automation: {
 		collection_id: { flag: "collection", required: true },
 		automation_id: { positional: 0, label: "automation-id", required: true },
@@ -61,6 +70,7 @@ export const ARGS = {
 	dismiss_subject: {
 		collection_id: { flag: "collection", required: true },
 		topic_id: { positional: 0, label: "topic-id", required: true },
+		reason: { flag: "reason" },
 	},
 	delete_automation: {
 		collection_id: { flag: "collection", required: true },
@@ -81,6 +91,12 @@ export async function cmdAutomations(ctx) {
 			return run(rest, "list_automation_ideas");
 		case "suggest":
 			return run(rest, "suggest_automations");
+		case "starter":
+			return run(rest, "suggest_starter_automations");
+		case "ground":
+			return run(rest, "get_ground_measures");
+		case "works":
+			return run(rest, "get_what_works");
 		case "preview":
 			return run(rest, "preview_automation");
 		case "more":
@@ -97,7 +113,7 @@ export async function cmdAutomations(ctx) {
 			return run(rest, "delete_automation", "Removed.");
 		default:
 			throw new CliError(
-				`Unknown automations subcommand: ${sub ?? "(none)"}. Try: list, show, ideas, suggest, preview, more, add, set, dismiss, remove`
+				`Unknown automations subcommand: ${sub ?? "(none)"}. Try: list, show, ideas, suggest, starter, ground, works, preview, more, add, set, dismiss, remove`
 			);
 	}
 }

package/lib/commands/probes.mjs

@@ -103,9 +103,11 @@ export async function cmdSuggestions(ctx) {
 			return suggestionsDecide(rest, "dismiss");
 		case "snooze":
 			return suggestionsDecide(rest, "snooze");
+		case "undo":
+			return suggestionsDecide(rest, "undo");
 		default:
 			throw new CliError(
-				"Usage: suggestions <list <collection_id>|approve|dismiss|snooze <verdict|proposal> <id>>"
+				"Usage: suggestions <list <collection_id>|approve|dismiss|snooze|undo <verdict|proposal> <id>>"
 			);
 	}
 }
@@ -117,7 +119,9 @@ function formatSuggestionLine(s) {
 				? `snoozed→${s.snoozed_until.slice(0, 10)}`
 				: `auto→${(s.auto_apply_at ?? "").slice(0, 10)}`
 			: "hold";
-	return `${s.kind} ${s.id}  [${when}]  ${s.cluster_name ?? "site"}: ${s.title}`;
+	const line = `${s.kind} ${s.id}  [${when}]  ${s.cluster_name ?? "site"}: ${s.title}`;
+	// A change to the automations' week: the week after, and why.
+	return s.week ? `${line}\n    ${s.week.line}\n    ${s.reason ?? ""}` : line;
 }
 
 async function suggestionsList(ctx) {

package/package.json

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