@letterstory/cli 0.176.79 → 0.176.81

package/lib/cli.mjs

@@ -85,7 +85,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.79";
+export const VERSION = "0.176.81";
 
 /** 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;
@@ -274,9 +274,9 @@ export const BOOLEAN_FLAGS = new Set([
 	"resolve",
 	"reopen",
 	"skip",
-	// `phantom-onboard domain` / `admin create-org --onboard` switches.
+	// `phantom-onboard domain` / `admin create-org --onboard` switches. (`--status` is a switch only on
+	// phantom-onboard, SWITCH_FLAGS_BY_COMMAND: everywhere else it takes a value, `--status parked`.)
 	"watch",
-	"status",
 	"no-phantom",
 	"no-visuals",
 	"no-enhance",
@@ -424,6 +424,13 @@ export const BOOLEAN_FLAGS = new Set([
  */
 const VALUE_FLAGS_BY_COMMAND = { automations: new Set(["on"]) };
 
+/**
+ * Flags that are switches on one command and take a value everywhere else. `--status` is "show me the job" on
+ * phantom-onboard (onboard.mjs), and a value on every other (`admin recipes save --status parked`, `admin crm
+ * prospect-orgs --status ready`): as a global switch, `--status parked` dropped "parked" (2026-11-09).
+ */
+export const SWITCH_FLAGS_BY_COMMAND = { "phantom-onboard": new Set(["status"]), onboard: new Set(["status"]) };
+
 /**
  * @param {string[]} argv
  * @returns {{ positionals: string[], flags: Record<string, string | boolean | string[]> }}
@@ -432,6 +439,7 @@ export function parseArgs(argv) {
 	const positionals = [];
 	const flags = {};
 	const valueFlags = VALUE_FLAGS_BY_COMMAND[argv[0]] ?? new Set();
+	const switchFlags = SWITCH_FLAGS_BY_COMMAND[argv[0]] ?? new Set();
 	const setFlag = (name, value) => {
 		if (Object.prototype.hasOwnProperty.call(flags, name)) {
 			flags[name] = [].concat(flags[name], value);
@@ -452,7 +460,12 @@ export function parseArgs(argv) {
 		}
 		const name = tok.slice(2);
 		const next = argv[i + 1];
-		if ((BOOLEAN_FLAGS.has(name) && !valueFlags.has(name)) || next === undefined || next.startsWith("--")) {
+		if (
+			(BOOLEAN_FLAGS.has(name) && !valueFlags.has(name)) ||
+			switchFlags.has(name) ||
+			next === undefined ||
+			next.startsWith("--")
+		) {
 			flags[name] = true;
 		} else {
 			setFlag(name, next);
@@ -671,6 +684,12 @@ Reviewers:
   automate send <event-name> --title <what happened> [--key <id>] [--url <u>] [--fact k=v ...]
                 [--email <e>] [--person <name>] [--company <c>]
                                                        Send an event from your own systems
+  automate findings [--state new|acted|dismissed|expired] [--automation <id>] [--site <host>] [--page <url>]
+                   [--limit <n>] [--cursor <t>]
+                                                       What the automations noticed: evidence, what it's about,
+                                                       the button that acts on it, and how it ended
+  automate act <finding-id>                            Make the call a finding stores, as you
+  automate dismiss <finding-id> [--reason <why>]       Set a finding aside
   automate remove <automation-id>
   reviewers invite <article-id> --email <e> [--name <n>]
                                                        Invite a guest to review one post

package/lib/commands/automate.mjs

@@ -1,6 +1,6 @@
 // `automate` — Letterpress → Automations (docs/architecture/event-automations.md): an event, read
 // against your filter (--instruction), then done by Letterpress as your prompt (--prompt) says.
-// options / list / show / add / set / try / runs / approve / reject / send / remove, through the
+// options / list / show / add / set / try / runs / approve / reject / send / findings / act / dismiss / remove, through the
 // same tools the app uses. (A letterbase's writing automations are made and paced with `automations`.) `list` also
 // shows the jobs Letter runs for the account (source "letter": internal links, the blog's sync, the site's re-audit,
 // Fix autopilot, add-your-name suggestions, Auto-Plan, and each letterbase's writing automations), each with its
@@ -34,6 +34,7 @@ const TEMPLATES = [
 ];
 const UNITS = ["hours", "days", "weeks", "months"];
 const STATUSES = ["pending", "proposed", "acting", "acted", "answered", "skipped", "failed", "rejected"];
+const FINDING_STATES = ["new", "acted", "dismissed", "expired"];
 
 const triggerParams = {
 	object: {
@@ -164,6 +165,29 @@ export const ARGS = {
 		decision: { internal: "approve or reject, from the subcommand" },
 		reason: { flag: "reason" },
 	},
+	// What the automations noticed (docs/architecture/automation-findings.md): read, act on, dismiss.
+	list_findings: {
+		automation_id: { flag: "automation" },
+		state: { flag: "state", enum: FINDING_STATES },
+		about: {
+			object: {
+				host: { flag: "site" },
+				page_url: { flag: "page" },
+				collection_id: { flag: "letterbase" },
+				question: { flag: "question" },
+				target_id: { flag: "target" },
+			},
+		},
+		limit: { flag: "limit", type: "num" },
+		cursor: { flag: "cursor" },
+	},
+	act_on_finding: {
+		finding_id: { positional: 0, label: "finding-id", required: true },
+	},
+	dismiss_finding: {
+		finding_id: { positional: 0, label: "finding-id", required: true },
+		reason: { flag: "reason" },
+	},
 	send_automation_event: {
 		event: { positional: 0, label: "event-name", required: true },
 		key: { flag: "key" },
@@ -207,12 +231,18 @@ export async function cmdAutomate(ctx) {
 			return run(rest, "decide_automation_run", "Rejected.", { decision: "reject" });
 		case "send":
 			return run(rest, "send_automation_event");
+		case "findings":
+			return run(rest, "list_findings");
+		case "act":
+			return run(rest, "act_on_finding", "Done.");
+		case "dismiss":
+			return run(rest, "dismiss_finding", "Dismissed.");
 		case "remove":
 		case "rm":
 			return run(rest, "delete_event_automation", "Removed.");
 		default:
 			throw new CliError(
-				`Unknown automate subcommand: ${sub ?? "(none)"}. Try: options, list, show, add, set, try, runs, approve, reject, send, remove`
+				`Unknown automate subcommand: ${sub ?? "(none)"}. Try: options, list, show, add, set, try, runs, approve, reject, send, findings, act, dismiss, remove`
 			);
 	}
 }

package/package.json

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