@letterstory/cli 0.133.0 → 0.134.1

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.1";
 
 // 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
@@ -923,6 +927,7 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
                      [--save-result …] [--draft]
           | renewals [--days 90]
           | reach-outs [--day YYYY-MM-DD] [--fresh]   the day's reach-outs, N of 5 (#crm-reminders' count)
+          | replies [--days 14]               replies nobody has answered yet, newest first
           | track-record [--since YYYY-MM-DD] | at-risk | expansion-signals
           | weekly-note                       the Monday retention note for the last full week
           | collections [--org-ids a,b | --account-stages won,active]

package/lib/commands/admin.mjs

@@ -14,7 +14,7 @@
 //      The old names — evals, eval-add, eval-set, proposals, propose-eval, capture-eval, reject-eval — still work.)
 //   admin evals scoreboard|cases|runs|run|triage|guard|retire …                      (fleet:read / tuning:experiment)
 //   admin fleet-experiments list|articles|clients|mark|unmark|new|assign|assign-eligible|assign-orgs|spin-up|apply|start|stop|decide …  (fleet:read / fleet:experiment)
-//   admin crm import|capture|outreach|signals|record|signal|accounts|account|score|slack-channels|link-slack|white-glove|set-white-glove|churn|revenue|reach-outs|record-churn|draft-churn-reason|undo-churn|outcomes|record-outcome|renewals|track-record|weekly-note|at-risk|expansion-signals|collections|delivery-flags|pulse|case|onboard|onboarding|retry-onboarding|onboard-plan|payment-link …  (crm:read / crm:write)
+//   admin crm import|capture|outreach|signals|record|signal|accounts|account|score|slack-channels|link-slack|white-glove|set-white-glove|churn|revenue|reach-outs|replies|record-churn|draft-churn-reason|undo-churn|outcomes|record-outcome|renewals|track-record|weekly-note|at-risk|expansion-signals|collections|delivery-flags|pulse|case|onboard|onboarding|retry-onboarding|onboard-plan|payment-link …  (crm:read / crm:write)
 //   admin spend summary|reconcile|pnl|margin|pricing|entries|add|import|usage|remove|reference|stripe-sync|services|service …  (spend:read / spend:write)
 //   admin brand-detection <org-id>                                                   (fleet:read)
 //   admin brand-detection <org-id> [--term t]... [--exact t]... [--exclude p]... [--note "…"] | --clear [--note "…"]   (fleet:instrument)
@@ -3399,6 +3399,16 @@ async function cmdAdminCrm(ctx) {
 				].join("\n")
 			);
 		}
+		case "replies": {
+			// admin crm replies [--days 14] — companies that answered us and that nobody has
+			// reached since, newest first (src/lib/crm/replies-waiting.ts).
+			const params = new URLSearchParams(compact({ days: flagStr(flags.days) }));
+			return out(await staffRequest(ctx, "GET", `${CRM}/replies?${params}`), (r) =>
+				r.replies.length === 0
+					? "No replies waiting."
+					: r.replies.map((x) => `${x.at.slice(0, 10)}  ${x.name}  ${x.title ?? ""}`.trimEnd()).join("\n")
+			);
+		}
 		case "reach-outs": {
 			// admin crm reach-outs [--day YYYY-MM-DD] [--fresh] — the day's reach-out count toward
 			// the target, the same number #crm-reminders posts (src/lib/crm/reach-out-day.ts).
@@ -3732,7 +3742,7 @@ async function cmdAdminCrm(ctx) {
 		}
 		default:
 			throw new CliError(
-				"Usage: admin crm import|capture|outreach|signals|record|signal|accounts|account|score|slack-channels|link-slack|white-glove|set-white-glove|churn|revenue|reach-outs|record-churn|draft-churn-reason|undo-churn|outcomes|record-outcome|renewals|track-record|weekly-note|at-risk|expansion-signals|collections|delivery-flags|pulse|case|onboard|onboarding|retry-onboarding|onboard-plan|payment-link … (see --help)"
+				"Usage: admin crm import|capture|outreach|signals|record|signal|accounts|account|score|slack-channels|link-slack|white-glove|set-white-glove|churn|revenue|reach-outs|replies|record-churn|draft-churn-reason|undo-churn|outcomes|record-outcome|renewals|track-record|weekly-note|at-risk|expansion-signals|collections|delivery-flags|pulse|case|onboard|onboarding|retry-onboarding|onboard-plan|payment-link … (see --help)"
 			);
 	}
 }

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.1",
 	"description": "Spin up and manage Letterstory phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",